Package com.j_spaces.map

Class CacheFinder

java.lang.Object
com.j_spaces.core.client.SpaceFinder
com.j_spaces.map.CacheFinder
@Deprecated public class CacheFinder extends SpaceFinder
Deprecated.
Use MapConfigurer instead.
  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:

  • Method Details

    • 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.