Class Reference
IRIS for UNIX 2024.1.2
|
Class Reference
IRIS for UNIX 2024.1.2
|
|
|
Private
Storage
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
This abstract class defines the Projection interface which is implemented
by one of the various subclasses of this class.
A class definition may include one or more Projection definitions; each one
of which refers to a specific Projection class (a subclass of this class).
The Projection interface defines methods that are invoked by the
Class Compiler at certain points within a class compilation. Specifically,
there is a method,
The expected use of a Projection class is to provide a way to automatically
generate associated files (such as those used by the Java Binding)
whenever a class is compiled.
If the projection creates globals or other items that need to be packaged with
this class in the event we wish to move this class in a deployment package then
add these items in the
|
|
|
|
|
|
If true then do not create this projection using the class compiler multicompile jobs but create it in the main process. Used to allow projections that do not function in the multicompile environement to disable this feature.
|
|
Call this helper method to add a component to the class manifest. For example if the projection of a class creates ^gbl(classname) nodes that describe some data about the projected class then you should add 'gbl("classname").gbl' to the manifest so if we create a deployment package of this class we will also include any items in the manifest automatically.
This method is called by the Class Compiler whenever an associated class has finished compiling. classname contains the name of the associated class while parameters contains an array of the projection parameters subscripted by parameter name. Also the special parameter value parameters("%qstruct") contains a merge of the qstruct array this projection is being compiled with. The modified is always blank.
Any errors reported by this method are reported by the Class Compiler but do not effect class compilation in any way.
This is called as close to the end of the compile as possible so it can do cleanup work or more usefully it can avoid doing work multiple times. For example if class User.A would modify MyFile.txt normally in theCreateProjection method and class User.B would normally modify the same file when it is compiled and you compile both these classes together then you may end up generating MyFile.txt twice and so doing duplicate work. By changing this soCreateProjection just adds 'MyFile.txt' to the queue of things to be done and then processing this list in this method, making sure to only do each piece of work once, you can process the fully up to date state of User.A and User.B to create the correct MyFile.txt just once.Note that this method will be called just once per projection subclass, so
CreateProjection may be called multiple times for each class with this projection type, but this method will only be called once at the end of the compile.
This is a helper method for implementors of projection classes. This method provides a mechanism for to make sure additional classes are compiled. Typically these would be new classes created by the projection itself.
You should not directly invoke the Class Compiler from a projection method, instead, invoke this method to request that the class classname be placed in a queue of classes that will be compiled at the end of the current compilation operation.
Called when you remove a projected item to remove this from the manifest.
Can be called to remove a queued class from the queued class list created withQueueClass
This method is called by the Class Compiler whenever an associated class is either a) about to be recompiled, or b) about to be deleted. classname contains the name of the associated class while parameters contains an array of the projection parameters subscripted by parameter name. Also the special parameter value parameters("%qstruct") contains a merge of the qstruct array this projection is being compiled with. recompile is true (1) if the associated class is about to be recompiled. The modified is always blank.
Any errors reported by this method are reported by the Class Compiler but do not effect class compilation in any way.