|
JAC project AOPSYS CEDRIC & LIP6 labs |
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
This interface specify the prototypes of the methods that can be notified when an event occurs within the base program.
This can be regarded as the JAC Meta-Object Protocol (MOP).
Field Summary | |
static String |
FOUND_OBJECT
|
Method Summary | |
void |
afterApplicationStarted()
Upcalled after a new application is started on the JAC system. |
void |
afterRunningWrapper(Wrapper wrapper,
String wrappingMethod)
This method is upcalled by JAC after the application of the wrapper. |
void |
afterWrap(Wrappee wrappee,
Wrapper wrapper,
String[] wrapping_methods,
String[][] wrapped_methods)
This method is upcalled after the wrappee is wrapped by the wrapper. |
void |
afterWrappeeInit(Wrappee wrappee)
This method should be called by the GUI system after an object has been created and initialized (tells the other aspects that the object is now regular). |
boolean |
beforeRunningWrapper(Wrapper wrapper,
String wrappingMethod)
This method is upcalled by JAC when a wrapper is going to be applied to a wrappee. |
void |
beforeWrappeeInit(Wrappee wrappee)
This method should be called by the GUI system before an object is being created and initialized (but the process is not finished yet). |
void |
onExit()
This method is upcalled when the system exits. |
void |
whenClone(Wrappee cloned,
Wrappee clone)
This method is upcalled by JAC when a JAC object is cloned. |
void |
whenCloseDisplay(Display display)
Upcalled when a display is closing. |
void |
whenDeleted(Wrappee objet)
Upcalled when an object is deleted. |
Wrappee |
whenDeserialized(SerializedJacObject orgObject,
Wrappee finalObject)
This method is called when a base object is deserialized and can parametrize the deserialization by reading the SerializedJacObject instance to get some extra infos on the aspects. |
void |
whenFree(Wrappee objet)
Upcalled when an object is freed from the memory. |
void |
whenGetObjects(Collection objects,
ClassItem cl)
Calls whenGetObjects on all aspects. |
String |
whenNameObject(Object object,
String name)
Upcalled when the naming aspect names an object. |
void |
whenObjectMiss(String name)
Upcalled when an object is been seeked within the name repository and is not found. |
void |
whenRemoteInstantiation(Wrappee newInstance,
String name)
This method is upcalled by JAC when a new object is instantiated from a remote site. |
Wrappee |
whenSerialized(Wrappee orgObject,
SerializedJacObject finalObject)
This method is called when a JAC object is serialized and can parametrize the serialization by filling the finalObject
parameter. |
void |
whenTopologyChanged()
This method is upcalled when a topological change occurs whithin the distributed application. |
void |
whenUsingNewClass(ClassItem cl)
This method is upcalled by JAC when a static method is called for the first time. |
void |
whenUsingNewInstance(Interaction interaction)
This method is upcalled by JAC when a given instance is used for the first time at construction-time. |
Field Detail |
public static final String FOUND_OBJECT
Method Detail |
public void whenUsingNewInstance(Interaction interaction)
Informations about the called method can be retrieved by
using the CollaborationParticipant
methods.
interaction
- the interaction that triggered the
whenUsingNewInstance event (usually a constructor invocation)CollaborationParticipant
,
whenUsingNewClass(ClassItem)
public void whenUsingNewClass(ClassItem cl)
cl
- the class that is used for the first time.CollaborationParticipant
,
#whenUsingNewInstance()
public void whenRemoteInstantiation(Wrappee newInstance, String name)
The name that is passed is the name of the remote reference that has been used to create the object.
newInstance
- the instance that have been created by a
remote hostpublic void whenClone(Wrappee cloned, Wrappee clone)
cloned
- the object that is being clonedclone
- the new object (the clone of cloned)public Wrappee whenSerialized(Wrappee orgObject, SerializedJacObject finalObject)
finalObject
parameter.
IMPORTANT: this method is upcalled only if the
serialization is done with a
JacObjectOutputStream
. To ensure the correct use of
this class, only use JacObject.serialize()
to
serialize an object.
orgObject
- the object being serializedfinalObject
- the corresponding serialized structure
SerializedJacObject
,
JacObjectOutputStream
public Wrappee whenDeserialized(SerializedJacObject orgObject, Wrappee finalObject)
IMPORTANT: this method is upcalled only if the
deserialization is done with a
JacObjectInputStream
. To ensure the correct use of
this class, only use JacObject.deserialize()
to
deserialize an object.
orgObject
- the corresponding serialized structurefinalObject
- the object being deserialized
SerializedJacObject
,
JacObjectInputStream
public boolean beforeRunningWrapper(Wrapper wrapper, String wrappingMethod)
wrapper
- the wrapper that is going to be runnedwrappingMethod
- the name of the may-be runned wrapping
method
Wrappee
,
Wrapping.wrap(Wrappee,Wrapper,String,AbstractMethodItem)
,
Wrapper
,
Wrapper.proceed(Interaction)
public void afterRunningWrapper(Wrapper wrapper, String wrappingMethod)
wrapper
- the wrapper that has just been runnedwrappingMethod
- the name of the runned wrapping methodWrappee
,
Wrapping.wrap(Wrappee,Wrapper,String,AbstractMethodItem)
,
Wrapper
,
Wrapper.proceed(Interaction)
public void afterWrap(Wrappee wrappee, Wrapper wrapper, String[] wrapping_methods, String[][] wrapped_methods)
Wrapper
,
Wrappee
,
Wrapping.wrap(Wrappee,Wrapper,String,AbstractMethodItem)
public void whenGetObjects(Collection objects, ClassItem cl)
objects
- list of objects already in memorycl
- return only instances of this classpublic String whenNameObject(Object object, String name)
object
- the object to namename
- current name of the object or null
public void whenObjectMiss(String name)
The finally found object is a contextual attribute called FOUND_OBJECT.
name
- the name that has not been foundFOUND_OBJECT
public void whenDeleted(Wrappee objet)
public void whenFree(Wrappee objet)
public void afterApplicationStarted()
public void whenCloseDisplay(Display display)
display
- the closing displaypublic void whenTopologyChanged()
public void onExit()
public void beforeWrappeeInit(Wrappee wrappee)
Then, some aspects should deal differently with this object thant with already created objects (for instance, the GUI aspect should not show the object to other users, or a remote access aspect should disable forwarding.
public void afterWrappeeInit(Wrappee wrappee)
|
Contact JAC development team: Renaud Pawlak Lionel Seinturier Laurent Martelli |
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |