org.globus.ogsa.impl.core.service
Class ServiceLocator

java.lang.Object
  extended byorg.apache.axis.client.Service
      extended byorg.globus.ogsa.impl.core.service.ServiceLocator
All Implemented Interfaces:
GridLocator, javax.naming.Referenceable, java.io.Serializable, javax.xml.rpc.Service
Direct Known Subclasses:
AdminServiceGridLocator, AnyServiceGridLocator, ArraySampleServiceGridLocator, ChatServiceGridLocator, CounterServiceGridLocator, EncodedCounterServiceGridLocator, ExceptionServiceGridLocator, FactoryServiceGroupServiceGridLocator, GenerateCounterServiceGridLocator, GoogleSearchServiceGridLocator, JMSAdapterServiceGridLocator, NotificationCounterServiceGridLocator, NotificationFactoryServiceGridLocator, OGSIAllServiceGridLocator, OgsiLoggingServiceGridLocator, OgsiManagementServiceGridLocator, OGSINotificationServiceGridLocator, OGSIServiceGridLocator, OGSIServiceGroupServiceGridLocator, PingServiceGridLocator, RoutableCounterServiceGridLocator, SecureContextEstablishmentServiceGridLocator, ServiceDataServiceGridLocator, ServiceGroupRegistrationServiceGridLocator, SinkListenerServiceGridLocator, TemperatureServiceGridLocator, TopServiceGridLocator, WeatherServiceGridLocator

public class ServiceLocator
extends org.apache.axis.client.Service
implements GridLocator

extends client side Axis service with GSI and SOAP Extensibility elements

See Also:
Serialized Form

Nested Class Summary
 
Nested classes inherited from class org.apache.axis.client.Service
org.apache.axis.client.Service.HandlerRegistryImpl
 
Constructor Summary
ServiceLocator()
           
ServiceLocator(org.apache.axis.EngineConfiguration config)
           
 
Method Summary
 java.net.URL getEndpoint()
           
 GSR getGSR()
          gets the GSR that was last resolved
 java.lang.Object getLocal(HandleType targetService)
           
 java.lang.Object getLocal(java.lang.String path)
           
 java.lang.Object getServicePort(HandleType handle)
          creates a proxy for a particular handle (which is inspected and resolved into a GSR)
 java.lang.Object getServicePort(LocatorType locator)
          creates a proxy using an OGSI LocatorType (the return parameter of an OGSI Factory createService call).
 java.lang.Object getServicePort(java.net.URL endpointAddress)
          creates a proxy for a particular endpoint URL
 void setEnableCacheGSR(boolean enableCacheGSR)
          determines whether all stubs created by this locator should be associated with the same reference.
 void setStubClass(java.lang.Class stubClass)
          sets the stub class to be created, typically done by generated typed locators
 
Methods inherited from class org.apache.axis.client.Service
createCall, createCall, createCall, createCall, getAxisClient, getCacheWSDL, getCall, getCalls, getEngine, getEngineConfiguration, getHandlerRegistry, getMaintainSession, getPort, getPort, getPort, getPorts, getReference, getServiceName, getTypeMappingRegistry, getWSDLDocumentLocation, getWSDLParser, getWSDLService, setCacheWSDL, setEngine, setEngineConfiguration, setMaintainSession, setTypeMappingRegistry
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 
Methods inherited from interface javax.xml.rpc.Service
createCall, createCall, createCall, createCall, getCalls, getHandlerRegistry, getPort, getPort, getPorts, getServiceName, getTypeMappingRegistry, getWSDLDocumentLocation
 
Methods inherited from interface javax.naming.Referenceable
getReference
 

Constructor Detail

ServiceLocator

public ServiceLocator()

ServiceLocator

public ServiceLocator(org.apache.axis.EngineConfiguration config)
Method Detail

setEnableCacheGSR

public void setEnableCacheGSR(boolean enableCacheGSR)
Description copied from interface: GridLocator
determines whether all stubs created by this locator should be associated with the same reference. It can be used to do lazy initialization of a proxy.

Specified by:
setEnableCacheGSR in interface GridLocator
Parameters:
enableCacheGSR - if set to true (false is default) the locator will cache resolved GSRs

getServicePort

public java.lang.Object getServicePort(java.net.URL endpointAddress)
                                throws GridServiceException
Description copied from interface: GridLocator
creates a proxy for a particular endpoint URL

Specified by:
getServicePort in interface GridLocator
Parameters:
endpointAddress - endpoint URL that will be used to send messages invoked on the proxy created by this method
Returns:
JAX-RPC compliant client stub (only service interface is typically exposed)
Throws:
GridServiceException

getServicePort

public java.lang.Object getServicePort(HandleType handle)
                                throws FaultType,
                                       GridServiceException
Description copied from interface: GridLocator
creates a proxy for a particular handle (which is inspected and resolved into a GSR)

Specified by:
getServicePort in interface GridLocator
Parameters:
handle - the handle to resolve and create a stub for
Returns:
JAX-RPC compliant client stub (only service interface is typically exposed)
Throws:
FaultType - if a something went wrong during remote handle resolution
GridServiceException - if a local exception occurred internally in the framework

getLocal

public java.lang.Object getLocal(HandleType targetService)
                          throws GridServiceException
Throws:
GridServiceException

getLocal

public java.lang.Object getLocal(java.lang.String path)
                          throws GridServiceException
Throws:
GridServiceException

getServicePort

public java.lang.Object getServicePort(LocatorType locator)
                                throws FaultType,
                                       GridServiceException
Description copied from interface: GridLocator
creates a proxy using an OGSI LocatorType (the return parameter of an OGSI Factory createService call). If the locator does not contain a reference its handle will be resolved.

Specified by:
getServicePort in interface GridLocator
Parameters:
locator - the OGSI locator to (potentially) resolve and create a stub for
Returns:
JAX-RPC compliant client stub (only service interface is typically exposed)
Throws:
FaultType - if a something went wrong during remote handle resolution
GridServiceException - if a local exception occurred internally in the framework

getEndpoint

public java.net.URL getEndpoint()

getGSR

public GSR getGSR()
Description copied from interface: GridLocator
gets the GSR that was last resolved

Specified by:
getGSR in interface GridLocator

setStubClass

public void setStubClass(java.lang.Class stubClass)
Description copied from interface: GridLocator
sets the stub class to be created, typically done by generated typed locators

Specified by:
setStubClass in interface GridLocator


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