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

java.lang.Object
  org.apache.axis.client.Service
      org.globus.ogsa.impl.core.service.ServiceLocator

All Implemented Interfaces:

GridLocator, Referenceable, 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

URL	getEndpoint()
GSR	getGSR() gets the GSR that was last resolved
Object	getLocal(HandleType targetService)
Object	getLocal(String path)
Object	getServicePort(HandleType handle) creates a proxy for a particular handle (which is inspected and resolved into a GSR)
Object	getServicePort(LocatorType locator) creates a proxy using an OGSI LocatorType (the return parameter of an OGSI Factory createService call).
Object	getServicePort(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(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 Object getServicePort(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 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 Object getLocal(HandleType targetService)
                throws GridServiceException

Throws:

GridServiceException

getLocal

public Object getLocal(String path)
                throws GridServiceException

Throws:

GridServiceException

getServicePort

public 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 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(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