com.j_spaces.map

Class CacheFinder

java.lang.Object

com.j_spaces.core.client.SpaceFinder

com.j_spaces.map.CacheFinder

Deprecated.

Use MapConfigurer instead.

@Deprecated
public class CacheFinder
extends SpaceFinder

  This utility class provides accessing to cache IMap 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 cache
       jini://myHost/myContinaer/mySpace?uselocalcache

       > create - IMap based space interface
       jini://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
   Or
     jini://mylookuphost/*/myspace?uselocalcache

  3. Looking for a cache using the JINI multicast protocol.
     jini://*/*/containername/myspace?uselocalcache
   Or
     jini://*/*/myspace?uselocalcache
 

Since:

5.0

Version:

1.0

Author:

Guy Korland

See Also:

SpaceURL

Field Summary

Fields inherited from class com.j_spaces.core.client.SpaceFinder

_logger

Method Summary

Modifier and Type	Method and Description
static Object	find(String urls) Deprecated. 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.
protected Object	findService(SpaceURL url, Properties customProperties, LifeCycle lifeCycle, CredentialsProvider credentialsProvider, long timeout, LookupType lookupType) Deprecated. The main method of SpaceFinder to find single Space or Container proxy.

Methods inherited from class com.j_spaces.core.client.SpaceFinder

find, find, find, find, find, find, find, findJiniSpace, findService, findService, findService, main, verifyURL

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

find

public static Object find(String urls)
                   throws FinderException

Deprecated.

  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
 

Parameters:

urls - the space url

Returns:

Returns single cache.

Throws:

FinderException - During finding cache.

findService

protected final Object findService(SpaceURL url,
                                   Properties customProperties,
                                   LifeCycle lifeCycle,
                                   CredentialsProvider credentialsProvider,
                                   long timeout,
                                   LookupType lookupType)
                            throws FinderException

Deprecated.

Description copied from class: SpaceFinder

The main method of SpaceFinder to find single Space or Container proxy. If the proxy is not found throws FinderException.

Overrides:

findService in class SpaceFinder

Parameters:

url - The valid SpaceFinder URL to Container or Space.

credentialsProvider - security credentials to be used for authentication in case of a secured space; may be null.

Returns:

Returns single found proxy.

Throws:

FinderException - Failed to find proxy of desired url.