Aztec® Programming Language
Version 1.1 Alpha 2

Copyright © 2010-2017, Aztec Development Group, All Rights Reserved

Download Aztec

Search        Contact Us

And there'll be time enough for thinkin'...

Come tomorrow.

- Harry Chapin

 

aztec.system.ExceptionEvent

public abstract class ExceptionEvent from<Event>

Base

Event

ExceptionEvent

ExceptionEvent is an abstract class which provides a framework for all Aztec exception classes. Exceptions are special events which are handled using the exceptions/handle/cleanup construct. Being events, they can also be handled using standard event handling techniques. The Thread class supports adding an event handler for exceptions (filtered or not), and if registered from a thread other than the thread where the exception is fired, the processing of the exception by the registered handler can take place in parallel with the exceptions/handle processing within the thread where the exception was fired.

ExceptionEvent Methods

ExceptionEvent() Constructor for the ExceptionEvent class
Fire() Fires the exception which causes exceptions/handle processing to take place within the thread
Thread() Reference to the Thread object where the exception was fired
Module() Reference to the Module metadata object associated with the code where the exception was fired
ModuleLine() Line number within the module where the exception was fired
Method() Reference to the Method metadata object associated with the code where the exception was fired

Derived Classes

See Also

  


ExceptionEvent()

public method ExceptionEvent()

Parameters

None

Return Value

None

Description

Constructor for the ExceptionEvent class.

 

ExceptionEvent Class


Fire()

public method Fire()

Parameters

None

Return Value

None

Description

This method initiates Aztec exception handling at the point where this method. The VM searches for an exceptions/handle block for a match with the type of exception being fired. If found, control is transferred to that construct (per standard Aztec exception handling rules). If not found, then an unhandled exception run-time error occurs.

 

In addition, if one or more Exception handlers are registered with the thread where the exception was fired, then standard Aztec event handling can proceed using the exception event object (if it passes the "filter"). If the thread which registered the handler is different than the thread where it was fired, the event will be processed by that thread at the same time that this thread processes the exceptions/handle construct.

 

ExceptionEvent Class


Thread()

public method<Thread> Thread()

Parameters

None

Return Value

Thread object where exception was fired

Description

This method returns a reference to the Thread object where the exception was actually fired..

 

ExceptionEvent Class


Module()

public method<Module> Module()

Parameters

None

Return Value

Module metadata where exception was fired

Description

This method returns a reference to the Module metadata object that is associated with the code where the exception was fired.

 

ExceptionEvent Class


ModuleLine()

public method<int> ModuleLine()

Parameters

None

Return Value

Module line where exception was fired

Description

This method returns the line number within the module where the exception was fired.

 

ExceptionEvent Class


Method()

public method<Method> Method()

Parameters

None

Return Value

Method metadata where exception was fired

Description

This method returns a reference to the Method metadata object that is associated with the code where the exception was fired. Note that this Method metadata value can be null if the exception occurs during initialization of global data.

 

ExceptionEvent Class

 

Copyright © 2010-2017

Aztec Development Group

All Rights Reserved

Download Aztec