org.globus.ogsa.impl.ogsi
Class ServiceGroupRegistrationProvider

java.lang.Object
  extended byorg.globus.ogsa.impl.ogsi.ServiceGroupRegistrationProvider
All Implemented Interfaces:
GridServiceCallback, LazyCreationCallback, OperationProvider

public class ServiceGroupRegistrationProvider
extends java.lang.Object
implements OperationProvider, GridServiceCallback, LazyCreationCallback

Implements the ogsi service group registration operations


Constructor Summary
ServiceGroupRegistrationProvider()
           
 
Method Summary
 void activate(GridContext context)
          Called when a service becomes active after having been deactivated.
 TerminationTimeType add(LocatorTypeHolder serviceLocator, ExtensibilityType content, TerminationTimeType terminationTime)
           
 void deactivate(GridContext context)
          Called just before a service gets deactivated.
 javax.xml.namespace.QName[] getOperations()
          Called during initialization when the Grid service needs to find out what operations are supported by this provider.
 void initialize(GridServiceBase serviceBase)
          Called when the operation provider is added to a grid service.
 boolean lazyCreate(HandleType handle)
          called when a service could not be located in the internal registry and a callback reference was found in the parent service
protected  void postAdd(EntryType entry)
           
 void postCreate(GridContext context)
          Called when a service has been created and all of its configuration has been set up.
protected  void postRemove(EntryType entry)
           
protected  void preAdd(LocatorTypeHolder serviceLocator, ExtensibilityType content, TerminationTimeType terminationTime)
           
 void preCreate(GridServiceBase base)
          Called when a service object is created.
 void preDestroy(GridContext context)
          Called just before a service gets destroyed.
protected  void preRemove(EntryType entry)
           
 void remove(ExtensibilityType matchExpression)
           
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

ServiceGroupRegistrationProvider

public ServiceGroupRegistrationProvider()
Method Detail

preAdd

protected void preAdd(LocatorTypeHolder serviceLocator,
                      ExtensibilityType content,
                      TerminationTimeType terminationTime)
               throws GridServiceException
Throws:
GridServiceException

postAdd

protected void postAdd(EntryType entry)

preRemove

protected void preRemove(EntryType entry)
                  throws GridServiceException
Throws:
GridServiceException

postRemove

protected void postRemove(EntryType entry)

getOperations

public javax.xml.namespace.QName[] getOperations()
Description copied from interface: OperationProvider
Called during initialization when the Grid service needs to find out what operations are supported by this provider.

Specified by:
getOperations in interface OperationProvider
Returns:
an array of operation qnames as defined in WSDL. An OperationProvider can use the empty string "" to denote that all operations with a certain local name are implemented. Similarly the wildcard "*" can be used in the local part of the qname to denote that all operations within a certain namespace are implemented. Combining these two approaches and returning: new QName[] {new QName("","*")}, will result in all incoming operations being redirected to this provider (apart from the OGSI defined GridService interface operations provided by the GridServiceBase implementation. Note that individual operations in the OGSI namespace could still be overridded with this approach, but not using the 'all namespaces and all operation' wildcard.

lazyCreate

public boolean lazyCreate(HandleType handle)
                   throws java.rmi.RemoteException,
                          FaultType
Description copied from interface: LazyCreationCallback
called when a service could not be located in the internal registry and a callback reference was found in the parent service

Specified by:
lazyCreate in interface LazyCreationCallback
Parameters:
handle - the handle of the service that is to be created
Returns:
true if the service was successfully created, false otherwise
Throws:
java.rmi.RemoteException - if exception occured when trying to create this service, for example when trying to call out to remote object system or database
FaultType - if grid service fault occured when trying to create this service, for example when trying to call out to a remote grid service system

initialize

public void initialize(GridServiceBase serviceBase)
                throws GridServiceException
Description copied from interface: OperationProvider
Called when the operation provider is added to a grid service.

Specified by:
initialize in interface OperationProvider
Parameters:
serviceBase - the service this provider is being associated with
Throws:
GridServiceException - if the initialization (and service creation is to be aborted)

remove

public void remove(ExtensibilityType matchExpression)
            throws java.rmi.RemoteException,
                   FaultType,
                   RemoveFailedFaultType,
                   MatchFailedFaultType,
                   ExtensibilityNotSupportedFaultType,
                   ExtensibilityTypeFaultType
Throws:
java.rmi.RemoteException
FaultType
RemoveFailedFaultType
MatchFailedFaultType
ExtensibilityNotSupportedFaultType
ExtensibilityTypeFaultType

add

public TerminationTimeType add(LocatorTypeHolder serviceLocator,
                               ExtensibilityType content,
                               TerminationTimeType terminationTime)
                        throws java.rmi.RemoteException,
                               FaultType,
                               ContentCreationFailedFaultType,
                               UnsupportedMemberInterfaceFaultType,
                               AddRefusedFaultType,
                               ExtensibilityNotSupportedFaultType,
                               ExtensibilityTypeFaultType
Throws:
java.rmi.RemoteException
FaultType
ContentCreationFailedFaultType
UnsupportedMemberInterfaceFaultType
AddRefusedFaultType
ExtensibilityNotSupportedFaultType
ExtensibilityTypeFaultType

preCreate

public void preCreate(GridServiceBase base)
               throws GridServiceException
Description copied from interface: GridServiceCallback
Called when a service object is created.

Specified by:
preCreate in interface GridServiceCallback
Parameters:
base - the Grid service that is in the process of creating this service object, or if this is a persistent Grid service it points to the service to be created.
Throws:
GridServiceException - if the service should not be created

postCreate

public void postCreate(GridContext context)
                throws GridServiceException
Description copied from interface: GridServiceCallback
Called when a service has been created and all of its configuration has been set up.

Specified by:
postCreate in interface GridServiceCallback
Parameters:
context - state information currently associated with the service that was created.
Throws:
GridServiceException - if the service creation should be aborted

activate

public void activate(GridContext context)
              throws GridServiceException
Description copied from interface: GridServiceCallback
Called when a service becomes active after having been deactivated. A service is always activated before any methods can be called on it.

Specified by:
activate in interface GridServiceCallback
Parameters:
context - state information currently associated with the service
Throws:
GridServiceException - if the service activation should be aborted

deactivate

public void deactivate(GridContext context)
                throws GridServiceException
Description copied from interface: GridServiceCallback
Called just before a service gets deactivated. When a service is deactivated it is subject to garbage collection, so if state is to be survive deactivation it has to be checkpointed into persistent storage. A deactivated service is however still discoverable by clients.

Specified by:
deactivate in interface GridServiceCallback
Parameters:
context - state information currently associated with the service
Throws:
GridServiceException - if the service deactivation failed

preDestroy

public void preDestroy(GridContext context)
                throws GridServiceException
Description copied from interface: GridServiceCallback
Called just before a service gets destroyed. After this call is made the framework removes all knowledge about the service, so it is a good place to clean up service resources. Note that this call can be triggered both by a client initiated destroy call, as well as a framework initiated softstate timeout.

Specified by:
preDestroy in interface GridServiceCallback
Parameters:
context - state information currently associated with the service
Throws:
GridServiceException - if the destruction failed (will be reported to clients in the case of explicit destroy calls)


Copyright ? 1999 University of Chicago and The University of Southern California. All Rights Reserved.