|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object | +--com.beasys.BEAWrapper.Callbacks
Supplies a set of methods that provide similar functionality as the ones provided by the C++ wrappers. These routines provide a POA like functionality in terms of defining the LifeSpan policies of object references created by the provided methods.
Constructor Summary | |
Callbacks()
Returns a reference to the Callbacks interface. |
|
Callbacks(org.omg.CORBA.ORB init_orb)
Returns a reference to the Callbacks interface. |
Method Summary | |
java.lang.String |
get_string_oid()
Returns the string version of the object ID of the current request. |
org.omg.CORBA.Object |
restart_persistent_systemid(org.omg.CORBA.portable.ObjectImpl servant,
java.lang.String rep_id,
java.lang.String stroid)
Performs the following actions: |
org.omg.CORBA.Object |
start_persistent_systemid(org.omg.CORBA.portable.ObjectImpl servant,
java.lang.String rep_id,
org.omg.CORBA.StringHolder stroid)
Performs the following actions: |
org.omg.CORBA.Object |
start_persistent_userid(org.omg.CORBA.portable.ObjectImpl servant,
java.lang.String rep_id,
java.lang.String stroid)
Performs the following actions: |
org.omg.CORBA.Object |
start_transient(org.omg.CORBA.portable.ObjectImpl servant,
java.lang.String rep_id)
Performs the following actions: |
void |
stop_all_objects()
Tells the ORB to stop accepting requests on all servants, if any, that have been set up in this Java VM. |
void |
stop_object(org.omg.CORBA.portable.ObjectImpl servant)
Tells the ORB to stop accepting requests on the given servant. |
Methods inherited from class java.lang.Object |
equals,
getClass,
hashCode,
notify,
notifyAll,
toString,
wait,
wait,
wait |
Constructor Detail |
public Callbacks()
init_orb
- Is the orb to be used for all further operations.
public Callbacks(org.omg.CORBA.ORB init_orb)
init_orb
- The orb to be used for all further operations.
Method Detail |
public org.omg.CORBA.Object start_transient(org.omg.CORBA.portable.ObjectImpl servant, java.lang.String rep_id) throws ServantAlreadyActive
rep_id
, using an object ID generated by the system.
stop_object
method; after that, invocations on that object
reference are no long valid and can never be made valid.
servant
- An instance of the Java implementation class for the interface.
rep_id
- The repository id of the interface.
rep_id
provided by the user. The object reference
will need to be converted to a specific object type by invoking the _narrow() operation defined
for the specific object.public org.omg.CORBA.Object start_persistent_systemid(org.omg.CORBA.portable.ObjectImpl servant, java.lang.String rep_id, org.omg.CORBA.StringHolder stroid) throws ServantAlreadyActive
type rep_id
,
using an object ID generated by the system.
stroid
to the stringified version of an object ID assigned
by the system.
rep_id
and for the same object ID, the servant
accepts requests made on that same object reference.
servant
- Is an instance of the JAVA implementation class for the interface.
rep_id
- Is the repository id of the interface.
stroid
- Is set by the system and is opaque to the user. The client uses it when the client
reactivates the object at a later time (using the restart_persistent_systemid method), most likely
after the client process has terminated and restarted. If an exception occurs, the value returned
is invalid and is set to a null string.
public org.omg.CORBA.Object restart_persistent_systemid(org.omg.CORBA.portable.ObjectImpl servant, java.lang.String rep_id, java.lang.String stroid) throws ServantAlreadyActive, ObjectAlreadyActive
servant
- Is an instance of the Java implementation class for the interface.
rep_id
- Is the repository id of the interface.
stroid
- Is the stringified version of the object ID provided by the user to be set in the object
reference being created. This argument must have been returned from a previous invocation to the
start_persistent_systemid method.
stroid
and the
rep_id provided by the user. The object reference will need to be converted to a specific object type
by invoking the _narrow() operation defined for the specific object. The caller is responsible for
initializing object state and saving to persistent store, if necessary, when it is finished execution.
public org.omg.CORBA.Object start_persistent_userid(org.omg.CORBA.portable.ObjectImpl servant, java.lang.String rep_id, java.lang.String stroid) throws ServantAlreadyActive, ObjectAlreadyActive
rep_id
,
using the object ID stroid.
servant
- Is an instance of the Java implementation class for the interface.
rep_id
- Is the repository id of the interface.
stroid
- Is the stringified version of an object ID provided by the user to be set
in the object reference being created. The stroid
holds application-specific data and is
opaque to the ORB.stroid
and the
rep_id
provided by the user. The object reference will need to be converted to a
specific object type by invoking the _narrow() operation defined for the specific object. The
caller is responsible for initializing object state and saving to persistent store, if necessary,
when the object is finished execution.stop_object
operation tells the
system to stop using the servant for its original object ID.
stop_object
method with the servant currently in use.
public void stop_object(org.omg.CORBA.portable.ObjectImpl servant)
Note: If you do an invocation on a callback object after you call the stop_object operation, the OBJECT_NOT_EXIST exception is returned to the caller. This is because the stop_object operation, in effect, deletes the object.
Servant
- Is an instance of the Java implementation class for the interface. The association
between this servant and its object ID will be removed from the Active Object Map.public java.lang.String get_string_oid() throws NotInRequest
start_transient
and start_persistent_systemid
methods were created by the
ORB and have no relationship to the user application.)public void stop_all_objects()
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |