SystemMemberCache (Apache Geode 1.6.0)
Date: 2018-04-23

org.apache.geode.admin

## Interface SystemMemberCache

- Deprecated.
  as of 7.0 use the `management` package instead

      public interface SystemMemberCache

  Administrative interface that represent's the `SystemMember`'s view of its `Cache`.
  Since:
    GemFire 3.5

- - ### Method Summary

    All Methods Instance Methods Abstract Methods Deprecated Methods
    Modifier and Type | Method and Description
    --- | ---
    `SystemMemberCacheServer` | `addCacheServer()` Deprecated. Adds a new, unstarted cache server that will serve the contents of this cache to clients.
    `SystemMemberRegion` | `createRegion(java.lang.String name, RegionAttributes attrs)` Deprecated. Creates a root `Region` in this cache.
    `SystemMemberRegion` | `createVMRegion(java.lang.String name, RegionAttributes attrs)` Deprecated. as of GemFire 5.0, use `createRegion(java.lang.String, org.apache.geode.cache.RegionAttributes)` instead
    `SystemMemberCacheServer[]` | `getCacheServers()` Deprecated. Returns the cache servers that run in this member's VM.
    `int` | `getId()` Deprecated. Value that uniquely identifies an instance of a cache for a given member.
    `int` | `getLockLease()` Deprecated. Gets the length, in seconds, of distributed lock leases obtained by this cache.
    `int` | `getLockTimeout()` Deprecated. Gets the number of seconds a cache operation will wait to obtain a distributed lock lease.
    `java.lang.String` | `getName()` Deprecated. The name of the cache.
    `SystemMemberRegion` | `getRegion(java.lang.String path)` Deprecated. Return the existing region (or subregion) with the specified path that already exists in the cache.
    `java.util.Set` | `getRootRegionNames()` Deprecated. Returns the names of all the root regions currently in this cache.
    `int` | `getSearchTimeout()` Deprecated. Gets the number of seconds a cache `get` operation can spend searching for a value before it times out.
    `Statistic[]` | `getStatistics()` Deprecated. Returns statistics related to this cache's performance.
    `int` | `getUpTime()` Deprecated. Returns number of seconds since this member's cache has been created.
    `boolean` | `isClosed()` Deprecated. Indicates if this cache has been closed.
    `boolean` | `isServer()` Deprecated. Returns whether or not this cache acts as a server.
    `void` | `refresh()` Deprecated. Updates the state of this cache instance.
    `void` | `setLockLease(int seconds)` Deprecated. Sets the length, in seconds, of distributed lock leases obtained by this cache.
    `void` | `setLockTimeout(int seconds)` Deprecated. Sets the number of seconds a cache operation may wait to obtain a distributed lock lease before timing out.
    `void` | `setSearchTimeout(int seconds)` Deprecated. Sets the number of seconds a cache get operation can spend searching for a value.

- - ### Method Detail

    - #### getName

          java.lang.String getName()

      Deprecated.
      The name of the cache.

    - #### getId

          int getId()

      Deprecated.
      Value that uniquely identifies an instance of a cache for a given member.

    - #### isClosed

          boolean isClosed()

      Deprecated.
      Indicates if this cache has been closed.
      Returns:
        true, if this cache is closed; false, otherwise

    - #### getLockTimeout

          int getLockTimeout()

      Deprecated.
      Gets the number of seconds a cache operation will wait to obtain a distributed lock lease.

    - #### setLockTimeout

          void setLockTimeout(int seconds)
                       throws AdminException

      Deprecated.
      Sets the number of seconds a cache operation may wait to obtain a distributed lock lease before timing out.
      Throws:
        `AdminException` - If a problem is encountered while setting the lock timeout
      See Also:
        `Cache.setLockTimeout(int)`

    - #### getLockLease

          int getLockLease()

      Deprecated.
      Gets the length, in seconds, of distributed lock leases obtained by this cache.

    - #### setLockLease

          void setLockLease(int seconds)
                     throws AdminException

      Deprecated.
      Sets the length, in seconds, of distributed lock leases obtained by this cache.
      Throws:
        `AdminException` - If a problem is encountered while setting the lock lease
      See Also:
        `Cache.setLockLease(int)`

    - #### getSearchTimeout

          int getSearchTimeout()

      Deprecated.
      Gets the number of seconds a cache `get` operation can spend searching for a value before it times out. The search includes any time spent loading the object. When the search times out it causes the get to fail by throwing an exception.

    - #### setSearchTimeout

          void setSearchTimeout(int seconds)
                         throws AdminException

      Deprecated.
      Sets the number of seconds a cache get operation can spend searching for a value.
      Throws:
        `AdminException` - If a problem is encountered while setting the search timeout
      See Also:
        `Cache.setSearchTimeout(int)`

    - #### getUpTime

          int getUpTime()

      Deprecated.
      Returns number of seconds since this member's cache has been created. Returns `-1` if this member does not have a cache or its cache has been closed.

    - #### getRootRegionNames

          java.util.Set getRootRegionNames()

      Deprecated.
      Returns the names of all the root regions currently in this cache.

    - #### getStatistics

          Statistic[] getStatistics()

      Deprecated.
      Returns statistics related to this cache's performance.

    - #### getRegion

          SystemMemberRegion getRegion(java.lang.String path)
                                throws AdminException

      Deprecated.
      Return the existing region (or subregion) with the specified path that already exists in the cache. Whether or not the path starts with a forward slash it is interpreted as a full path starting at a root.
      Parameters:
        `path` - the path to the region
      Returns:
        the Region or null if not found
      Throws:
        `java.lang.IllegalArgumentException` - if path is null, the empty string, or "/"
        `AdminException`

    - #### createVMRegion

          @Deprecated
          SystemMemberRegion createVMRegion(java.lang.String name,
                                                        RegionAttributes attrs)
                                                 throws AdminException

      Deprecated. as of GemFire 5.0, use `createRegion(java.lang.String, org.apache.geode.cache.RegionAttributes)` instead
      Creates a VM root `Region` in this cache.
      Parameters:
        `name` - The name of the region to create
        `attrs` - The attributes of the root region
      Throws:
        `AdminException` - If the region cannot be created
      Since:
        GemFire 4.0

    - #### createRegion

          SystemMemberRegion createRegion(java.lang.String name,
                                          RegionAttributes attrs)
                                   throws AdminException

      Deprecated.
      Creates a root `Region` in this cache.
      Parameters:
        `name` - The name of the region to create
        `attrs` - The attributes of the root region
      Throws:
        `AdminException` - If the region cannot be created
      Since:
        GemFire 5.0

    - #### refresh

          void refresh()

      Deprecated.
      Updates the state of this cache instance. Note that once a cache instance is closed refresh will never change the state of that instance.

    - #### addCacheServer

          SystemMemberCacheServer addCacheServer()
                                          throws AdminException

      Deprecated.
      Adds a new, unstarted cache server that will serve the contents of this cache to clients.
      Throws:
        `AdminException`
      Since:
        GemFire 5.7
      See Also:
        `Cache.addCacheServer()`

    - #### getCacheServers

          SystemMemberCacheServer[] getCacheServers()
                                             throws AdminException

      Deprecated.
      Returns the cache servers that run in this member's VM. Note that this list will not be updated until `refresh()` is called.
      Throws:
        `AdminException`
      Since:
        GemFire 5.7
      See Also:
        `Cache.getCacheServers()`

    - #### isServer

          boolean isServer()
                    throws AdminException

      Deprecated.
      Returns whether or not this cache acts as a server. This method will always return `true` for the `SystemMemberCache` obtained from a `CacheServer`. Note that this value will not be updated until `refresh()` is invoked.
      Throws:
        `AdminException`
      Since:
        GemFire 4.0