Public Member Functions | |
ComponentStateManager | getComponentStateManager () |
org.omg.CORBA.Object | getComponent (String componentUrl) throws AcsJContainerServicesEx |
org.omg.CORBA.Object | getComponentNonSticky (String curl) throws AcsJContainerServicesEx |
org.omg.CORBA.Object | getDefaultComponent (String componentIDLType) throws AcsJContainerServicesEx |
org.omg.CORBA.Object | getCollocatedComponent (String compUrl, String targetCompUrl) throws AcsJContainerServicesEx |
org.omg.CORBA.Object | getCollocatedComponent (ComponentQueryDescriptor compSpec, boolean markAsDefaul, String targetCompUrl) throws AcsJContainerServicesEx |
org.omg.CORBA.Object | getDynamicComponent (ComponentQueryDescriptor compSpec, boolean markAsDefault) throws AcsJContainerServicesEx |
org.omg.CORBA.Object | getDynamicComponent (ComponentSpec compSpec, boolean markAsDefault) throws AcsJContainerServicesEx |
String[] | findComponents (String curlWildcard, String typeWildcard) throws AcsJContainerServicesEx |
ComponentDescriptor | getComponentDescriptor (String componentUrl) throws AcsJContainerServicesEx |
void | releaseComponent (String componentUrl) |
void | registerComponentListener (ComponentListener listener) |
org.omg.CORBA.Object | getReferenceWithCustomClientSideTimeout (org.omg.CORBA.Object originalCorbaRef, double timeoutSeconds) throws AcsJContainerServicesEx |
void | assignUniqueEntityId (EntityT entity) throws AcsJContainerServicesEx |
Package Functions | |
public< T > T | getTransparentXmlComponent (Class< T > transparentXmlIF, org.omg.CORBA.Object componentReference, Class flatXmlIF) throws AcsJContainerServicesEx |
ContainerServices
is different from the other services that the container provides without the component implementation knowing about it. It can be thought of as a callback handle or a library.
Currently, methods are added to this interface as the functionality becomes available. At some point we will have to declutter the interface by introducing 2nd-level interfaces that harbor cohesive functionality. For example, instead of calling myContainerServices.getComponent(...)
, the new call will then be something like myContainerServices.communication().getComponent(...)
.
created on Oct 24, 2002 12:56:36 PM
|
Creates a unique id and sets it on the given (binding class) entity object. The id will be redundantly stored in an encrypted format so that later it can be verified that the id is indeed the one originally assigned.
Implemented in alma::acs::container::ContainerServicesImpl.
|
|
Finds components by their instance name (curl) and/or by their type. Wildcards can be used for the curl and type. This method returns a possibly empty array of component curls; for each curl, you may then call getComponent to obtain the reference.
Implemented in alma::acs::container::ContainerServicesImpl.
|
|
Dynamic version of getCollocatedComponent(String, String).
Implemented in alma::acs::container::ContainerServicesImpl.
|
|
Gets a component that will run collocated with a given component.
Implemented in alma::acs::container::ContainerServicesImpl.
|
|
Gets a component specified by its instance name. Delegates to get_component.
Implemented in alma::acs::container::ContainerServicesImpl.
|
|
Gets the component descriptor which contains meta data for the component. (Not to be confused with a component descriptor in the EJB sense.)
To be used primarily after retrieval of a component with getDefaultComponent or getDynamicComponent, when some data like the instance name is not known. The idea behind having this method separately is that in many cases, components are not interested in this information, and are happier to get back from these methods directly the remote reference to another component, instead of always dealing with a
Implemented in alma::acs::container::ContainerServicesImpl.
|
|
Gets a non-sticky reference to a component. This is typically used by "weak clients" such as graphical user interfaces that only want to observe the running system without interfering with its functioning. A non-sticky reference does not bind the Manager to keep alive the Component, and the Client requesting a non-sticky reference is not considered when checking for reference counts. The non-sticky reference should not be released, as that call will fail. The Manager can deactivate Components independently of any non-sticky reference. Since a non-sticky reference is not considered in reference counting, it will also not activate the component if it is not already active. As a consequence, asking for a non-sticky reference to a not-active Component throws an exception. The client represented by id (the handle) must have adequate access rights to access the component.
Implemented in alma::acs::container::ContainerServicesImpl.
|
|
Delivers the
The component needs to access the
Implemented in alma::acs::container::ContainerServicesImpl.
|
|
Gets the default component specified by the component type. The type is the IDL type, such as A default instance for the given type must have been declared beforehand (either statically in the CDB config files, or dynamically), otherwise an exception is thrown. To get more information on the returned component, call getComponentDescriptor with the instance name that you can get from the component using alma.ACS.ACSComponentOperations#name. Delegates to si.ijs.maci.ManagerOperations#get_default_component.
Implemented in alma::acs::container::ContainerServicesImpl.
|
|
More powerful and thus more dangerous version of getDynamicComponent(ComponentQueryDescriptor, boolean) which exposes a CORBA struct directly.
Implemented in alma::acs::container::ContainerServicesImpl.
|
|
Gets a component whose instance is not registered in the CDB at deployment time.
The fields of To get more information on the returned component, call getComponentDescriptor with the instance name that you've specified or that you can get from the component in case it was assigned (see alma.ACS.ACSComponentOperations#name()). Delegates to si.ijs.maci.ManagerOperations#get_dynamic_component.
Implemented in alma::acs::container::ContainerServicesImpl.
|
|
Wraps a component reference (or offshoot reference etc) such that the given timeout is applied on the client side of calls to this (possibly remote) object. If the total call, including de-/serialization and network travel, takes longer than the given timeout, an This allows us to override the general timeout given at the system level (e.g. orb.properties file in case of jacorb) and the container-level timeout given in the CDB container configuration. It is possible to set the timeout to values that are shorter or longer than the default timeout. You should chose a timeout value that matches the expected response time, with a large safety margin of Note that calls to which the specified timeout should apply must be made on the object reference returned from this method, and not on the original object that gets passed to this method! Some corba implementations may apply the timeout to both objects though, or return the original object.
Implemented in alma::acs::container::ContainerServicesImpl.
|
|
Converts a "flat-XML" component interface (as obtained from the various The container can fulfill this request in two different ways:
Object implements the transparentXmlIF interface. The client component that calls this method should only cast to that interface, and does not need to know which of the two transport mechanisms are being used.
Implemented in alma::acs::container::ContainerServicesImpl.
|
|
Allows a client to register a callback object that gets notified when some component(s) in use by the client (= components the client requested previously) dies or comes back to life (with
If the client wants to get notified even for components that it does not hold a reference to, then
Implemented in alma::acs::container::ContainerServicesImpl.
|
|
Releases the specified component. This involves notification of the manager, as well as calling This method will return only when the component has actually been released, which may take some time in case there are still active requests being processed.
Implemented in alma::acs::container::ContainerServicesImpl.
|