|
ABLE 2.0.0 07/02/2003 10:25:01 | ||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
This class specifies the remote interface to ABLE platform infrastructure objects, one of which "lives" inside each agent pool participating in the overall ABLE platform. Each platform support object provides information about the agent pool under its control and about the agents and services running there. A platform support object also helps the Agent Lifecycle Service create agents in its agent pool.
Method Summary | |
---|---|
java.lang.Object |
getNewObject(java.lang.String theClassName,
AbleSecureKey theSecureKey)
Gets a reference to a new instance of the specified class, which is created by calling the class's null argument constructor. |
java.lang.Object |
getNewObject(java.lang.String theClassName,
java.lang.Object[] theConstructorArgs,
AbleSecureKey theSecureKey)
Gets a reference to a new instance of the specified class, which is created by calling the class's constructor that matches the specified arguments. |
java.lang.Object |
getNewObject(java.lang.String theHostName,
java.lang.String thePort,
java.lang.String theClassName,
java.lang.Object[] theConstructorArgs,
AbleSecureKey theSecureKey)
Gets a reference to a new instance of the specified class, which is created in an agent pool on the specified host and port by calling the class's constructor that matches the specified arguments. |
java.util.Hashtable |
getPlatformAgentPools()
Gets a collection of agent pool definitions as specified in the platform preference file. |
java.lang.String |
getPlatformCryptographyAlgorithm()
Gets the platform's cryptography algorithm as specified in the platform preference file. |
java.lang.String |
getPlatformCryptographyProvider()
Gets the platform's cryptography provider as specified in the platform preference file. |
java.lang.String |
getPlatformName()
Gets the platform's name as specified in the platform preference file. |
boolean |
getPlatformSecurity()
Gets the overall ABLE security setting as specified in the ABLE preference file. |
javax.agent.service.Service |
getPlatformService(java.lang.String theRequestorsPort,
java.lang.String theServiceAlias)
Gets the specified platform Service object. |
javax.agent.service.ServiceRoot |
getPlatformServiceRoot(java.lang.String theRequestorsPort)
Gets the platform's service root. |
void |
terminatePlatformSupport(AbleSecureKey theSecureKey)
Terminates this AblePlatformSupport object and the agent pool in which it is running. |
Method Detail |
public java.lang.Object getNewObject(java.lang.String theClassName, AbleSecureKey theSecureKey) throws java.rmi.RemoteException, javax.agent.service.naming.NamingException
theClassName
- The fully qualified class name of the object to be
created. The class name must represent a legitimate
Remote, Serializable object accessible via the
CLASSPATH.
theSecureKey
- When platform security is off, this parameter may be
null; otherwise, this must be a valid security
key from a caller with the proper authority to create
new objects within the ABLE platform.
java.rmi.RemoteException
- On any error.public java.lang.Object getNewObject(java.lang.String theClassName, java.lang.Object[] theConstructorArgs, AbleSecureKey theSecureKey) throws java.rmi.RemoteException, javax.agent.service.naming.NamingException
theClassName
- The fully qualified class name of the object to be
created. The class name must represent a legitimate
Remote, Serializable object accessible via the
CLASSPATH.
theConstructorArgs
- An array of objects that will be passed to the
constructor of the specified class. The order and
data type of each object in the array must match the
signature of a constructor of the specified class.
theSecureKey
- When platform security is off, this parameter may be
null; otherwise, this must be a valid security
key from a caller with the proper authority to create
new objects within the ABLE platform.
java.rmi.RemoteException
- On any error.public java.lang.Object getNewObject(java.lang.String theHostName, java.lang.String thePort, java.lang.String theClassName, java.lang.Object[] theConstructorArgs, AbleSecureKey theSecureKey) throws java.rmi.RemoteException, javax.agent.service.naming.NamingException
theHostName
- The IP address (name or number) of a system that is
running another AblePlatformSupport object in an agent
pool listening at the specified port.
thePort
- The port number at which the above system is listening
for remote AblePlatformSupport requests.
theClassName
- The fully qualified class name of the desired object.
The class name must represent a legitimate Remote,
Serializable object accessible via the CLASSPATH.
theConstructorArgs
- An array of objects that will be passed to the
constructor of the specified class. The order and
data type of each object in the array must match the
signature of a constructor of the specified class.
theSecureKey
- When platform security is off, this parameter may be
null; otherwise, this must be a valid security
key from a caller with the proper authority to create
new objects within the ABLE platform.
java.rmi.RemoteException
- On any error.public java.lang.String getPlatformCryptographyAlgorithm() throws java.rmi.RemoteException
java.rmi.RemoteException
- On any error.public java.lang.String getPlatformCryptographyProvider() throws java.rmi.RemoteException
java.rmi.RemoteException
- On any error.public java.lang.String getPlatformName() throws java.rmi.RemoteException
java.rmi.RemoteException
- On any error.public boolean getPlatformSecurity() throws java.rmi.RemoteException
java.rmi.RemoteException
- On any error.public javax.agent.service.Service getPlatformService(java.lang.String theRequestorsPort, java.lang.String theServiceAlias) throws java.rmi.RemoteException
Note that the ServiceManager is called to find the specified service, and that the ServiceManager will use the specified service's factory to "get" the service. "Getting" the service may be as simple as an RMI look up, or it may involve creating the service from scratch.
theRequestorsPort
- The port, if any (may be null), of the object
requesting the service object. This is used to help
determine whether the requestor is running in the
same agent pool as the specified Service.
theServiceAlias
- The binding name of the service to be
returned.
java.rmi.RemoteException
- On any error.public javax.agent.service.ServiceRoot getPlatformServiceRoot(java.lang.String theRequestorsPort) throws java.rmi.RemoteException
theRequestorsPort
- The port, if any (may be null), of the object
requesting the service root. This is used to help
determine whether the requestor is running in the
same agent pool as any Service that may need to be
constructed.
java.rmi.RemoteException
- On any error.public java.util.Hashtable getPlatformAgentPools() throws java.rmi.RemoteException
java.rmi.RemoteException
- On any error.public void terminatePlatformSupport(AbleSecureKey theSecureKey) throws java.rmi.RemoteException, javax.agent.service.naming.NamingException
The following actions occur:
Please note the following:
theSecureKey
- When platform security is off, this parameter may be
null; otherwise, this must be a valid security
key from a caller with the proper authority to
terminate this platform support object and the agent
pool in which it is running.
java.rmi.RemoteException
- On any error.
|
ABLE 2.0.0 07/02/2003 10:25:01 | ||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |