GemFire 6.0.1

com.gemstone.gemfire.cache
Interface Declarable

All Known Subinterfaces:
CustomExpiry<K,V>
All Known Implementing Classes:
BridgeClient, BridgeLoader, BridgeWriter

public interface Declarable

An object that can be described in a declarative caching XML file.

Any user-defined object in the declarative caching xml file should implement this interface in order to be constructed.

For example, the user can declare a CacheLoader in a declarative XML file as follows:

        <cache-loader>
          <class-name>com.company.app.DBLoader</class-name>
          <parameter name="URL">
            <string>jdbc://12.34.56.78/mydb</string>
          </parameter>
        </cache-loader>
 

In this case, com.company.app.DBLoader must implement both the CacheLoader and Declarable interfaces. The cache service will construct a com.company.app.DBLoader object by invoking the loader's zero-argument constructor and then calling the init(java.util.Properties) method to pass in the parameters.

See package introduction.

Since:
2.0

Method Summary
 void init(Properties props)
          Initializes a user-defined object using the given properties.
 

Method Detail

init

void init(Properties props)
Initializes a user-defined object using the given properties. Note that any uncaught exception thrown by this method will cause the Cache initialization to fail.

Parameters:
props - Contains the parameters declared in the declarative xml file.
Throws:
IllegalArgumentException - If one of the configuration options in props is illegal or malformed.

GemFire 6.0.1

Copyright © 2002-2009 GemStone Systems, Inc. All Rights Reserved.