org.globus.ogsa
Interface GridLocator

All Superinterfaces:

javax.naming.Referenceable, java.io.Serializable

All Known Implementing Classes:

ServiceLocator

public interface GridLocator

extends java.io.Serializable, javax.naming.Referenceable

The GridLocator interface defines the base class of all type specific ServiceLocators used to create stubs on the client side. It is en extension of the JAX-RPC defined Locator.

Method Summary

GSR	getGSR() gets the GSR that was last resolved
java.lang.Object	getServicePort(java.net.URL url) 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 interface javax.naming.Referenceable

getReference

Method Detail

setEnableCacheGSR

public void setEnableCacheGSR(boolean enableCacheGSR)

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.

Parameters:

enableCacheGSR - if set to true (false is default) the locator will cache resolved GSRs

getGSR

public GSR getGSR()

gets the GSR that was last resolved

setStubClass

public void setStubClass(java.lang.Class stubClass)

sets the stub class to be created, typically done by generated typed locators

getServicePort

public java.lang.Object getServicePort(java.net.URL url)
                                throws GridServiceException

creates a proxy for a particular endpoint URL

Parameters:

url - 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