|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object com.j_spaces.core.client.SpaceFinder com.j_spaces.map.CacheFinder
public class CacheFinder
This utility class provides accessing to cacheIMap
API. The CacheFinder is designed to provide a unified interface for finding a cache in each of the mode specified. To provide a unified manager of accessing the cache use a url based interface which will provide the information of the protocol and the address of the cache that should be found. The general format for this URL is as follows:Protocol://[host]:[port]/[container_name]/[space_name]?[query_string]
Protocol: [ rmi | jini | java ] The "java" protocol enables working with an embedded space behind the cache. When choosing so one should specify in the query string one of three operations: > create - to create a new space example of "mySpace" space creation:java://myHost/myContinaer/mySpace?create
> open - To open an existing space in an embedded mode: example of opening "mySpace" space:java://myHost/myContinaer/mySpace?open
> destroy - for destroy an existing space: example of destroying "mySpace" space:java://myHost/myContinaer/mySpace?destroy
Host: The host name. Can be '*', when JINI is used as a protocol, the host value determines whether to use Unicast or Multicast. Port: the registry or lookup port. If the port is not specified, the default port 10098 will be used. Container Name: The name of the container, which holds the space. If the container name is '*' then the container attribute will be ignored and the space will be looked for directly regardless of the container that holds it . Query String: The query_string represents the cache type i.e.: > create - local cachejini://myHost/myContinaer/mySpace?uselocalcache
> create - IMap based space interfacejini://myHost/myContinaer/mySpace
Examples of space url's: 1. looking for a cache in rmi registry in a specific host and container.rmi://my_container_host/my_containername/myspace?uselocalcache
2. Looking for a cache using JINI Unicast protocol.jini://mylookuphost/mycontainername/myspace?uselocalcache
Orjini://mylookuphost/*/myspace?uselocalcache
3. Looking for a cache using the JINI multicast protocol.jini://*/*/containername/myspace?uselocalcache
Orjini://*/*/myspace?uselocalcache
SpaceURL
Method Summary | |
---|---|
static Object |
find(SpaceURL spaceURL,
IJSpace space,
LifeCycle lifeCycle)
Find a cache using the space provided. |
static Object |
find(SpaceURL spaceURL,
IJSpace space,
LifeCycle lifeCycle,
SecurityContext securityContext)
Find a cache using the space provided. |
static Object |
find(String url)
The general format for this URL is as follows: Protocol://[host]:[port]/[container_name]/[space_name]? |
static Object |
find(String[] urls)
CacheFinder.find multiple URL provides ability to define cache search order. |
static Object |
find(String url,
IJSpace space)
Find a cache using the space provided. |
static Object |
find(String url,
Properties customProps)
Find a cache using the custom Properties provided which overwrites the space/container/cluster configurations. |
static void |
main(String[] args)
This main provides the following options: 1. |
Methods inherited from class com.j_spaces.core.client.SpaceFinder |
---|
find, find, find, find, verifyURL |
Methods inherited from class java.lang.Object |
---|
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Method Detail |
---|
public static Object find(String url) throws FinderException
The general format for this URL is as follows: Protocol://[host]:[port]/[container_name]/[space_name]?[query_string] Protocol: [ RMI | JINI | JAVA | WS ] This method also supports multiple urls separate by ";", e.i. rmi://localhost/containerName/SpaceName?uselocalcache; jini://localhost/containerName/SpaceName?uselocalcache; It is useful when Jini URL for locating services on the network is not available. If the first URL is unavailable, CacheFinder will try the next one until a live cache will be found. If all URLs are unavailable this method throws FinderException
url
- the space url
FinderException
- During finding cache.public static Object find(String[] urls) throws FinderException
urls
- Array of CacheFinder urls.
FinderException
- Failed to found proxy.All urls are unavailable.for more information on the URL structre
public static Object find(String url, Properties customProps) throws FinderException
url
- cache URLcustomProps
- Custom Properties object which overwrites the space/container/cluster configurations.
FinderException
- During finding space or container.for more information on the URL structre
public static Object find(String url, IJSpace space) throws FinderException
url
- cache URLspace
- proxy to the space
FinderException
- During finding space or container.for more information on the URL structre
public static Object find(SpaceURL spaceURL, IJSpace space, LifeCycle lifeCycle) throws FinderException
spaceURL
- cache URLspace
- proxy to the space
FinderException
- During finding space or container.for more information on the URL structre
public static Object find(SpaceURL spaceURL, IJSpace space, LifeCycle lifeCycle, SecurityContext securityContext) throws FinderException
spaceURL
- cache URLspace
- proxy to the spacesecurityContext
- the SecurityContext for the generated proxy (null can be passed).
FinderException
- During finding space or container.for more information on the URL structre
public static void main(String[] args) throws FinderException
This main provides the following options: 1. Starts container or container with an embedded space. i.e.java CacheFinder java://localhost:10098/containerName
orjava://localhost:10098/containerName/mySpace
or/./mySpace
(which translates tojava://localhost:10098/containerName/mySpace?schema=default
) or/./mySpace?schema=cache
(which translates tojava://localhost:10098/containerName/mySpace?schema=cache
) For more options see usage printouts. 2. Verify if a Space/Container running. i.e.java SpaceFinder rmi://hostname/containerName/SpaceName
args
- args[0] should be the space url
FinderException
- During finding space or container.
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |