|
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 |
java.lang.Object | +--java.rmi.server.RemoteObject | +--org.jagent.service.util.RMIBasicService | +--com.ibm.able.platform.AbleBasicService | +--com.ibm.able.platform.RMIVerifiableDirectorySystem
A verifiable adapter for AgentDirectoryService. The RMIVerifiableDirectorySystem is a remote object that implements the RMIVerifiableDirectoryService interface. This will be used by the platform to register/update/deregister agent description. It will also be used to search for agent descriptions.
This class also extends RmiAblePlatformService, so it will notify all registered listeners about changes to the AgentDescriptions inside this AgentDirectoryService
Fields inherited from class com.ibm.able.platform.AbleBasicService |
---|
ANS_PRINCIPAL, LOCAL_PRINCIPAL, myAnsPrincipal, myKeyPair, myMsgLog, myPrincipal, mySecSppt, myServiceEventListeners, myServiceProperties, myTrcLog, myTrustLevel, myVerifiableAgentName, myVerifiableNamingService, REQUESTORS_PORT, SOCKET_FACTORY |
Fields inherited from class java.rmi.server.RemoteObject |
---|
ref |
Fields inherited from interface org.jagent.service.RMIService |
---|
RMI, SERVICE_PROTOCOL |
Fields inherited from interface org.jagent.service.IPService |
---|
SERVICE_HOST, SERVICE_PORT |
Constructor Summary | |
---|---|
RMIVerifiableDirectorySystem()
Creates a new RMI-based Verifiable Directory Service. |
|
RMIVerifiableDirectorySystem(javax.agent.service.ServiceProperties env)
Creates a new RMI-based Verifiable Directory Service with the given ServiceProperties. |
Method Summary | |
---|---|
void |
addAblePlatformServiceEventListener(AblePlatformServiceEventListener theListener)
Since this Verifiable Directory Service will be persisting listeners, AbleBasicService's addAblePlatformServiceEventListener method must be overridden to handle the
adding of this service's listeners from persistence. |
javax.agent.service.directory.AgentDescription |
createAgentDescription()
The original createAgentDescription method off of the AgentDirectoryService is still being exposed. |
void |
deregister(javax.agent.service.directory.AgentDescription theAgentDescription)
The original deregister method off of the AgentDirectoryService is still being exposed. |
void |
deregister(javax.agent.service.directory.AgentDescription theAgentDescription,
AbleSecureKey key)
Deregister theAgentDescription from the VerifiableAgentDirectoryService. |
java.lang.String |
getBindingName()
Abstract method from org.jagent.service.util.RMIBasicService. |
void |
modify(javax.agent.service.directory.AgentDescription theAgentDescription)
The original modify method off of the AgentDirectoryService is still being exposed. |
void |
modify(javax.agent.service.directory.AgentDescription theAgentDescription,
AbleSecureKey key)
Modify theAgentDescription in the VerifiableAgentDirectoryService. |
void |
refreshLocalFromPersistence(AblePersistenceSupport thePersistenceSupport,
java.lang.Object[] persistedRecords)
Takes the persisted Objects that are read in, and sets them locally. |
void |
register(javax.agent.service.directory.AgentDescription theAgentDescription)
The original register method off of the AgentDirectoryService is still being exposed. |
void |
register(javax.agent.service.directory.AgentDescription theAgentDescription,
AbleSecureKey key)
Register theAgentDescription to the VerifiableAgentDirectoryService. |
void |
removeAblePlatformServiceEventListener(AblePlatformServiceEventListener theListener)
Since this Verifiable Directory Service will be persisting listeners, AbleBasicService's removeAblePlatformServiceEventListener method must be overridden to handle the
removing of this service's listeners from persistence. |
javax.agent.service.directory.AgentDescription[] |
search(javax.agent.service.directory.AgentDescription theAgentDescription)
The original search method off of the AgentDirectoryService is still being exposed. |
javax.agent.service.directory.AgentDescription[] |
search(javax.agent.service.directory.AgentDescription theAgentDescription,
int maxResults)
The original search method off of the AgentDirectoryService is still being exposed. |
void |
terminateService(AbleSecureKey key)
When this service is terminated, there will be Verifiable Directory specific cleanup that needs to be done. |
Methods inherited from class com.ibm.able.platform.AbleBasicService |
---|
getAblePlatformServiceEventListeners, notifyAblePlatformServiceEventListeners, thenNotifyAblePlatformServiceEventListeners |
Methods inherited from class org.jagent.service.util.RMIBasicService |
---|
bindServiceToRegistry, getServiceProperties, setServiceProperties, shutdown |
Methods inherited from class java.rmi.server.RemoteObject |
---|
equals, getRef, hashCode, toString, toStub |
Methods inherited from class java.lang.Object |
---|
clone, finalize, getClass, notify, notifyAll, wait, wait, wait |
Methods inherited from interface com.ibm.able.platform.RmiAblePlatformServiceEventGenerator |
---|
getAblePlatformServiceEventListeners |
Constructor Detail |
public RMIVerifiableDirectorySystem() throws java.lang.Exception
java.lang.Exception
- On errors looking up other required services.public RMIVerifiableDirectorySystem(javax.agent.service.ServiceProperties env) throws java.lang.Exception
env
- The properties that will help define this Service.
java.lang.Exception
- On errors looking up other required services.Method Detail |
public java.lang.String getBindingName()
getBindingName
in class org.jagent.service.util.RMIBasicService
public void addAblePlatformServiceEventListener(AblePlatformServiceEventListener theListener) throws AbleException
addAblePlatformServiceEventListener
method must be overridden to handle the
adding of this service's listeners from persistence.
addAblePlatformServiceEventListener
in interface RmiAblePlatformServiceEventGenerator
addAblePlatformServiceEventListener
in class AbleBasicService
AbleException
- On any error adding the listener.public void removeAblePlatformServiceEventListener(AblePlatformServiceEventListener theListener) throws AbleException
removeAblePlatformServiceEventListener
method must be overridden to handle the
removing of this service's listeners from persistence.
removeAblePlatformServiceEventListener
in interface RmiAblePlatformServiceEventGenerator
removeAblePlatformServiceEventListener
in class AbleBasicService
AbleException
- On any error adding the listener.public void terminateService(AbleSecureKey key) throws AbleException, javax.agent.service.naming.NamingException
AbleBasicService's
terminateService
method has been overridden to take care of this cleanup.
Since this service is persisting information, it's persistence support Object will do some cleanup when being terminated.
terminateService
in interface RmiAblePlatformService
terminateService
in class AbleBasicService
key
- The key that is used to secure this communication.
AbleException
- If the caller was not authorized to make this call.
javax.agent.service.naming.NamingException
- On all naming errors.public void refreshLocalFromPersistence(AblePersistenceSupport thePersistenceSupport, java.lang.Object[] persistedRecords) throws java.lang.Exception
AblePersistenceSupportProcessor
This method is called one time during the lifetime of this AblePersistenceSupportProcessor Object. This method will be called the first time a successful connection is made to the PlatformPersistenceService and the persisted Objects are read in.
refreshLocalFromPersistence
in interface AblePersistenceSupportProcessor
com.ibm.able.platform.AblePersistenceSupportProcessor
thePersistenceSupport
- the object making the callback so that the processor can
tell which AblePersistenceSupport object is making the call.
persistedRecords
- Object[] containing all of the rows of
the table this Object persists to.
java.lang.Exception
- On any error locally restoring the persisted data.public void register(javax.agent.service.directory.AgentDescription theAgentDescription, AbleSecureKey key) throws java.rmi.RemoteException, javax.agent.service.directory.AlreadyRegisteredException, javax.agent.service.directory.DirectoryFailure
RMIVerifiableDirectoryService
theAgentDescription
to the VerifiableAgentDirectoryService.
If the platform is not secure when this method is called, theAgentDescription
will be passed along to the non-secure register method.
An agent is only allowed to register its own agent description.
If successfully registered, all registered listeners will be notified of this newly registered agent description.
register
in interface RMIVerifiableDirectoryService
com.ibm.able.platform.RMIVerifiableDirectoryService
theAgentDescription
- The agent description to be registered.
key
- The AbleSecureKey used to secure the communication.
java.rmi.RemoteException
- On all remote errors.
javax.agent.service.directory.AlreadyRegisteredException
- If theAgentDescription
is already registered.
javax.agent.service.directory.DirectoryFailure
- If the platform is not running secure.
If the agent description that is to be registered does not belong to the agent trying to register it.
public void deregister(javax.agent.service.directory.AgentDescription theAgentDescription, AbleSecureKey key) throws java.rmi.RemoteException, javax.agent.service.directory.NotRegisteredException, javax.agent.service.directory.DirectoryFailure
RMIVerifiableDirectoryService
theAgentDescription
from the VerifiableAgentDirectoryService.
If the platform is not secure when this method is called, theAgentDescription
will be passed along to the non-secure deregister method.
An agent is only allowed to deregister its own agent description.
If successfully deregistered, all registered listeners will be notified of this deregistered agent description.
deregister
in interface RMIVerifiableDirectoryService
com.ibm.able.platform.RMIVerifiableDirectoryService
theAgentDescription
- The agent description to be deregistered.
key
- The AbleSecureKey used to secure the communication.
java.rmi.RemoteException
- On all remote errors.
javax.agent.service.directory.NotRegisteredException
- If theAgentDescription
is not currently registered.
javax.agent.service.directory.DirectoryFailure
- If the platform is not running secure.
If the agent description that is to be deregistered does not belong to the agent trying to deregister it.
public void modify(javax.agent.service.directory.AgentDescription theAgentDescription, AbleSecureKey key) throws java.rmi.RemoteException, javax.agent.service.directory.NotRegisteredException, javax.agent.service.directory.DirectoryFailure
RMIVerifiableDirectoryService
theAgentDescription
in the VerifiableAgentDirectoryService.
If the platform is not secure when this method is called, theAgentDescription
will be passed along to the non-secure modify method.
An agent is only allowed to modify its own agent description.
If successfully modified, all registered listeners will be notified of this changed agent description.
modify
in interface RMIVerifiableDirectoryService
com.ibm.able.platform.RMIVerifiableDirectoryService
theAgentDescription
- The agent description to be modified.
key
- The AbleSecureKey used to secure the communication.
java.rmi.RemoteException
- On all remote errors.
javax.agent.service.directory.NotRegisteredException
- If theAgentDescription
is not currently registered.
javax.agent.service.directory.DirectoryFailure
- If the platform is not running secure.
If the agent description that is to be modified does not belong to the agent trying to modify it.
public void register(javax.agent.service.directory.AgentDescription theAgentDescription) throws java.rmi.RemoteException, javax.agent.service.directory.AlreadyRegisteredException, javax.agent.service.directory.DirectoryFailure
RMIVerifiableDirectoryService
This will insecurely register theAgentDescription
to the AgentDirectoryService.
register
in interface RMIVerifiableDirectoryService
com.ibm.able.platform.RMIVerifiableDirectoryService
theAgentDescription
- The agent description to be registered.
java.rmi.RemoteException
- On any remote error.
javax.agent.service.directory.AlreadyRegisteredException
- If theAgentDescription
is already registered.
javax.agent.service.directory.DirectoryFailure
- On any error registering the agent description.public void deregister(javax.agent.service.directory.AgentDescription theAgentDescription) throws java.rmi.RemoteException, javax.agent.service.directory.NotRegisteredException, javax.agent.service.directory.DirectoryFailure
RMIVerifiableDirectoryService
This will insecurely deregister theAgentDescription
from the AgentDirectoryService.
Only non-verifiable agent descriptions can be deregistered using this method.
deregister
in interface RMIVerifiableDirectoryService
com.ibm.able.platform.RMIVerifiableDirectoryService
theAgentDescription
- The agent description to be deregistered.
java.rmi.RemoteException
- On any remote error.
javax.agent.service.directory.NotRegisteredException
- If theAgentDescription
is not currently registered.
javax.agent.service.directory.DirectoryFailure
- On any error deregistering the agent description.
If the agent description that is to be deregistered is a verifiable agent description.
public void modify(javax.agent.service.directory.AgentDescription theAgentDescription) throws java.rmi.RemoteException, javax.agent.service.directory.NotRegisteredException, javax.agent.service.directory.DirectoryFailure
RMIVerifiableDirectoryService
This will insecurely modify theAgentDescription
in the AgentDirectoryService.
Only non-verifiable agent descriptions can be modified using this method.
modify
in interface RMIVerifiableDirectoryService
com.ibm.able.platform.RMIVerifiableDirectoryService
theAgentDescription
- The agent description to be modified.
java.rmi.RemoteException
- On any remote error.
javax.agent.service.directory.NotRegisteredException
- If theAgentDescription
is not currently registered.
javax.agent.service.directory.DirectoryFailure
- On any error modifying the agent description.
If the agent description that is to be modified is a verifiable agent description.
public javax.agent.service.directory.AgentDescription[] search(javax.agent.service.directory.AgentDescription theAgentDescription) throws java.rmi.RemoteException, javax.agent.service.directory.SearchException, javax.agent.service.directory.DirectoryFailure
RMIVerifiableDirectoryService
search
in interface RMIVerifiableDirectoryService
com.ibm.able.platform.RMIVerifiableDirectoryService
theAgentDescription
- The AgentDescription to search for.
java.rmi.RemoteException
- On any remote error.
javax.agent.service.directory.SearchException
- On any error searching for theAgentDescription
.
javax.agent.service.directory.DirectoryFailure
- On any error searching for theAgentDescription
.public javax.agent.service.directory.AgentDescription[] search(javax.agent.service.directory.AgentDescription theAgentDescription, int maxResults) throws java.rmi.RemoteException, javax.agent.service.directory.SearchException, javax.agent.service.directory.DirectoryFailure
RMIVerifiableDirectoryService
search
in interface RMIVerifiableDirectoryService
com.ibm.able.platform.RMIVerifiableDirectoryService
theAgentDescription
- The AgentDescription to search for.
maxResults
- The maximum number of matching AgentDescription to return.
java.rmi.RemoteException
- On any remote error.
javax.agent.service.directory.SearchException
- On any error searching for theAgentDescription
.
javax.agent.service.directory.DirectoryFailure
- On any error searching for theAgentDescription
.public javax.agent.service.directory.AgentDescription createAgentDescription() throws java.rmi.RemoteException
RMIVerifiableDirectoryService
createAgentDescription
in interface RMIVerifiableDirectoryService
com.ibm.able.platform.RMIVerifiableDirectoryService
AgentDescription
will be returned.
java.rmi.RemoteException
- On any remote 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 |