org.infinispan.config
Class GlobalConfiguration

java.lang.Object
  extended by org.infinispan.config.AbstractConfigurationBean
      extended by org.infinispan.config.GlobalConfiguration
All Implemented Interfaces:
Serializable, Cloneable, CloneableConfigurationComponent, JAXBUnmarshallable

public class GlobalConfiguration
extends AbstractConfigurationBean

Configuration component that encapsulates the global configuration.

A default instance of this bean takes default values for each attribute. Please see the individual setters for details of what these defaults are.

Since:
4.0
Author:
Manik Surtani, Vladimir Blagojevic, Mircea.Markus@jboss.com, Galder ZamarreƱo
See Also:
Configuration reference, Serialized Form

Nested Class Summary
static class GlobalConfiguration.ExecutorFactoryType
           
static class GlobalConfiguration.FactoryClassWithPropertiesType
           
static class GlobalConfiguration.GlobalJmxStatisticsType
          This element specifies whether global statistics are gathered and reported via JMX for all caches under this cache manager.
static class GlobalConfiguration.ScheduledExecutorFactoryType
           
static class GlobalConfiguration.SerializationType
          Serialization and marshalling settings.
static class GlobalConfiguration.ShutdownHookBehavior
          Behavior of the JVM shutdown hook registered by the cache
static class GlobalConfiguration.ShutdownType
          This element specifies behavior when the JVM running the cache instance shuts down.
static class GlobalConfiguration.TransportType
          This element configures the transport used for network communications across the cluster.
 
Field Summary
static short DEFAULT_MARSHALL_VERSION
          Default replication version, from Version.getVersionShort().
 
Fields inherited from class org.infinispan.config.AbstractConfigurationBean
EMPTY_PROPERTIES, log, overriddenConfigurationElements
 
Constructor Summary
GlobalConfiguration()
           
 
Method Summary
 void accept(ConfigurationBeanVisitor v)
           
 GlobalConfiguration clone()
           
 boolean equals(Object o)
           
 String getAsyncListenerExecutorFactoryClass()
           
 Properties getAsyncListenerExecutorProperties()
           
 String getAsyncTransportExecutorFactoryClass()
           
 Properties getAsyncTransportExecutorProperties()
           
 String getCacheManagerName()
           
static GlobalConfiguration getClusteredDefault()
          Helper method that gets you a default constructed GlobalConfiguration, preconfigured to use the default clustering stack.
 String getClusterName()
           
 long getDistributedSyncTimeout()
           
 String getEvictionScheduledExecutorFactoryClass()
           
 Properties getEvictionScheduledExecutorProperties()
           
 String getJmxDomain()
           
 String getMachineId()
           
 String getMarshallerClass()
           
 short getMarshallVersion()
           
 String getMarshallVersionString()
           
 String getMBeanServerLookup()
           
 MBeanServerLookup getMBeanServerLookupInstance()
           
 Properties getMBeanServerProperties()
           
static GlobalConfiguration getNonClusteredDefault()
          Helper method that gets you a default constructed GlobalConfiguration, preconfigured for use in LOCAL mode
 String getRackId()
           
 String getReplicationQueueScheduledExecutorFactoryClass()
           
 Properties getReplicationQueueScheduledExecutorProperties()
           
 GlobalConfiguration.ShutdownHookBehavior getShutdownHookBehavior()
           
 String getSiteId()
           
 String getTransportClass()
           
 String getTransportNodeName()
           
 Properties getTransportProperties()
           
protected  boolean hasComponentStarted()
          Tests whether the component this configuration bean intents to configure has already started.
 int hashCode()
           
 boolean hasTopologyInfo()
           
 boolean isAllowDuplicateDomains()
           
 boolean isExposeGlobalJmxStatistics()
           
 boolean isStrictPeerToPeer()
           
 void setAllowDuplicateDomains(boolean allowDuplicateDomains)
          If true, multiple cache manager instances could be configured under the same configured JMX domain.
 void setAsyncListenerExecutorFactoryClass(String asyncListenerExecutorFactoryClass)
           
 void setAsyncListenerExecutorProperties(Properties asyncListenerExecutorProperties)
           
 void setAsyncListenerExecutorProperties(String asyncListenerExecutorPropertiesString)
           
 void setAsyncTransportExecutorFactoryClass(String asyncTransportExecutorFactoryClass)
           
 void setAsyncTransportExecutorProperties(Properties asyncTransportExecutorProperties)
           
 void setAsyncTransportExecutorProperties(String asyncSerializationExecutorPropertiesString)
           
 void setCacheManagerName(String cacheManagerName)
          If JMX statistics are enabled, this property represents the name of this cache manager.
 void setClusterName(String clusterName)
          Defines the name of the cluster.
 void setDistributedSyncTimeout(long distributedSyncTimeout)
           
 void setEvictionScheduledExecutorFactoryClass(String evictionScheduledExecutorFactoryClass)
           
 void setEvictionScheduledExecutorProperties(Properties evictionScheduledExecutorProperties)
           
 void setEvictionScheduledExecutorProperties(String evictionScheduledExecutorPropertiesString)
           
 void setExposeGlobalJmxStatistics(boolean exposeGlobalJmxStatistics)
          Toggle to enable/disable global statistics being exported via JMX
 void setJmxDomain(String jmxObjectName)
          If JMX statistics are enabled then all 'published' JMX objects will appear under this name.
 void setMachineId(String machineId)
          The id of the machine where this node runs.
 void setMarshallerClass(String marshallerClass)
          Fully qualified name of the marshaller to use.
 void setMarshallVersion(short marshallVersion)
          Largest allowable version to use when marshalling internal state.
 void setMarshallVersion(String marshallVersion)
          Largest allowable version to use when marshalling internal state.
 void setMBeanServerLookup(MBeanServerLookup mBeanServerLookup)
          Deprecated. Use setMBeanServerLookupInstance(org.infinispan.jmx.MBeanServerLookup) instead.
 void setMBeanServerLookup(String mBeanServerLookupClass)
          Fully qualified name of class that will attempt to locate a JMX MBean server to bind to
 void setMBeanServerLookupInstance(MBeanServerLookup mBeanServerLookupInstance)
          Sets the instance of the MBeanServerLookup class to be used to bound JMX MBeans to.
 void setMBeanServerProperties(Properties properties)
          Sets properties which are then passed to the MBean Server Lookup implementation specified.
 void setRackId(String rackId)
          The id of the rack where this node runs.
 void setReplicationQueueScheduledExecutorFactoryClass(String replicationQueueScheduledExecutorFactoryClass)
           
 void setReplicationQueueScheduledExecutorProperties(Properties replicationQueueScheduledExecutorProperties)
           
 void setReplicationQueueScheduledExecutorProperties(String replicationQueueScheduledExecutorPropertiesString)
           
 void setShutdownHookBehavior(GlobalConfiguration.ShutdownHookBehavior shutdownHookBehavior)
          Behavior of the JVM shutdown hook registered by the cache.
 void setShutdownHookBehavior(String shutdownHookBehavior)
           
 void setSiteId(String siteId)
          The id of the site where this node runs.
 void setStrictPeerToPeer(boolean strictPeerToPeer)
          If set to true, RPC operations will fail if the named cache does not exist on remote nodes with a NamedCacheNotFoundException.
 void setTransportClass(String transportClass)
          Fully qualified name of a class that represents a network transport.
 void setTransportNodeName(String nodeName)
          Name of the current node.
 void setTransportProperties(Properties transportProperties)
           
 void setTransportProperties(String transportPropertiesString)
           
 
Methods inherited from class org.infinispan.config.AbstractConfigurationBean
testImmutability, toTypedProperties, toTypedProperties, uc, willUnmarshall
 
Methods inherited from class java.lang.Object
finalize, getClass, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

DEFAULT_MARSHALL_VERSION

public static final short DEFAULT_MARSHALL_VERSION
Default replication version, from Version.getVersionShort().

Constructor Detail

GlobalConfiguration

public GlobalConfiguration()
Method Detail

isExposeGlobalJmxStatistics

public boolean isExposeGlobalJmxStatistics()

setExposeGlobalJmxStatistics

public void setExposeGlobalJmxStatistics(boolean exposeGlobalJmxStatistics)
Toggle to enable/disable global statistics being exported via JMX

Parameters:
exposeGlobalJmxStatistics -

setJmxDomain

public void setJmxDomain(String jmxObjectName)
If JMX statistics are enabled then all 'published' JMX objects will appear under this name. This is optional, if not specified an object name will be created for you by default.

Parameters:
jmxObjectName -

getJmxDomain

public String getJmxDomain()
See Also:
setJmxDomain(String)

getMBeanServerLookup

public String getMBeanServerLookup()

getMBeanServerProperties

public Properties getMBeanServerProperties()

setMBeanServerProperties

public void setMBeanServerProperties(Properties properties)
Sets properties which are then passed to the MBean Server Lookup implementation specified.

Parameters:
properties - properties to pass to the MBean Server Lookup

setMBeanServerLookup

public void setMBeanServerLookup(String mBeanServerLookupClass)
Fully qualified name of class that will attempt to locate a JMX MBean server to bind to

Parameters:
mBeanServerLookupClass - fully qualified class name of the MBean Server Lookup class implementation

setMBeanServerLookup

@Deprecated
public void setMBeanServerLookup(MBeanServerLookup mBeanServerLookup)
Deprecated. Use setMBeanServerLookupInstance(org.infinispan.jmx.MBeanServerLookup) instead.


setMBeanServerLookupInstance

public void setMBeanServerLookupInstance(MBeanServerLookup mBeanServerLookupInstance)
Sets the instance of the MBeanServerLookup class to be used to bound JMX MBeans to.

Parameters:
mBeanServerLookupInstance - An instance of MBeanServerLookup

getMBeanServerLookupInstance

public MBeanServerLookup getMBeanServerLookupInstance()

isAllowDuplicateDomains

public boolean isAllowDuplicateDomains()

setAllowDuplicateDomains

public void setAllowDuplicateDomains(boolean allowDuplicateDomains)
If true, multiple cache manager instances could be configured under the same configured JMX domain. Each cache manager will in practice use a different JMX domain that has been calculated based on the configured one by adding an incrementing index to it.

Parameters:
allowDuplicateDomains -

getCacheManagerName

public String getCacheManagerName()

setCacheManagerName

public void setCacheManagerName(String cacheManagerName)
If JMX statistics are enabled, this property represents the name of this cache manager. It offers the possibility for clients to provide a user-defined name to the cache manager which later can be used to identify the cache manager within a JMX based management tool amongst other cache managers that might be running under the same JVM.

Parameters:
cacheManagerName -

isStrictPeerToPeer

public boolean isStrictPeerToPeer()

setStrictPeerToPeer

public void setStrictPeerToPeer(boolean strictPeerToPeer)
If set to true, RPC operations will fail if the named cache does not exist on remote nodes with a NamedCacheNotFoundException. Otherwise, operations will succeed but it will be logged on the caller that the RPC did not succeed on certain nodes due to the named cache not being available.

Parameters:
strictPeerToPeer - flag controlling this behavior

hasTopologyInfo

public boolean hasTopologyInfo()

hasComponentStarted

protected boolean hasComponentStarted()
Description copied from class: AbstractConfigurationBean
Tests whether the component this configuration bean intents to configure has already started.

Specified by:
hasComponentStarted in class AbstractConfigurationBean
Returns:
true if the component has started; false otherwise.

getAsyncListenerExecutorFactoryClass

public String getAsyncListenerExecutorFactoryClass()

setAsyncListenerExecutorFactoryClass

public void setAsyncListenerExecutorFactoryClass(String asyncListenerExecutorFactoryClass)

getAsyncTransportExecutorFactoryClass

public String getAsyncTransportExecutorFactoryClass()

setAsyncTransportExecutorFactoryClass

public void setAsyncTransportExecutorFactoryClass(String asyncTransportExecutorFactoryClass)

getEvictionScheduledExecutorFactoryClass

public String getEvictionScheduledExecutorFactoryClass()

setEvictionScheduledExecutorFactoryClass

public void setEvictionScheduledExecutorFactoryClass(String evictionScheduledExecutorFactoryClass)

getReplicationQueueScheduledExecutorFactoryClass

public String getReplicationQueueScheduledExecutorFactoryClass()

setReplicationQueueScheduledExecutorFactoryClass

public void setReplicationQueueScheduledExecutorFactoryClass(String replicationQueueScheduledExecutorFactoryClass)

getMarshallerClass

public String getMarshallerClass()

setMarshallerClass

public void setMarshallerClass(String marshallerClass)
Fully qualified name of the marshaller to use. It must implement org.infinispan.marshall.StreamingMarshaller

Parameters:
marshallerClass -

getTransportNodeName

public String getTransportNodeName()

setTransportNodeName

public void setTransportNodeName(String nodeName)
Name of the current node. This is a friendly name to make logs, etc. make more sense. Defaults to a combination of host name and a random number (to differentiate multiple nodes on the same host)

Parameters:
nodeName -

getTransportClass

public String getTransportClass()

setTransportClass

public void setTransportClass(String transportClass)
Fully qualified name of a class that represents a network transport. Must implement org.infinispan.remoting.transport.Transport

Parameters:
transportClass -

getTransportProperties

public Properties getTransportProperties()

setTransportProperties

public void setTransportProperties(Properties transportProperties)

setTransportProperties

public void setTransportProperties(String transportPropertiesString)

getClusterName

public String getClusterName()

setClusterName

public void setClusterName(String clusterName)
Defines the name of the cluster. Nodes only connect to clusters sharing the same name.

Parameters:
clusterName -

setMachineId

public void setMachineId(String machineId)
The id of the machine where this node runs. Used for server hinting .


getMachineId

public String getMachineId()
See Also:
setMachineId(String)

setRackId

public void setRackId(String rackId)
The id of the rack where this node runs. Used for server hinting .


getRackId

public String getRackId()
See Also:
setRackId(String)

setSiteId

public void setSiteId(String siteId)
The id of the site where this node runs. Used for server hinting .


getSiteId

public String getSiteId()
See Also:
setSiteId(String)

getShutdownHookBehavior

public GlobalConfiguration.ShutdownHookBehavior getShutdownHookBehavior()

setShutdownHookBehavior

public void setShutdownHookBehavior(GlobalConfiguration.ShutdownHookBehavior shutdownHookBehavior)
Behavior of the JVM shutdown hook registered by the cache. The options available are: DEFAULT - A shutdown hook is registered even if no MBean server (apart from the JDK default) is detected. REGISTER - Forces the cache to register a shutdown hook even if an MBean server is detected. DONT_REGISTER - Forces the cache NOT to register a shutdown hook, even if no MBean server is detected.

Parameters:
shutdownHookBehavior -

setShutdownHookBehavior

public void setShutdownHookBehavior(String shutdownHookBehavior)

getAsyncListenerExecutorProperties

public Properties getAsyncListenerExecutorProperties()

setAsyncListenerExecutorProperties

public void setAsyncListenerExecutorProperties(Properties asyncListenerExecutorProperties)

setAsyncListenerExecutorProperties

public void setAsyncListenerExecutorProperties(String asyncListenerExecutorPropertiesString)

getAsyncTransportExecutorProperties

public Properties getAsyncTransportExecutorProperties()

setAsyncTransportExecutorProperties

public void setAsyncTransportExecutorProperties(Properties asyncTransportExecutorProperties)

setAsyncTransportExecutorProperties

public void setAsyncTransportExecutorProperties(String asyncSerializationExecutorPropertiesString)

getEvictionScheduledExecutorProperties

public Properties getEvictionScheduledExecutorProperties()

setEvictionScheduledExecutorProperties

public void setEvictionScheduledExecutorProperties(Properties evictionScheduledExecutorProperties)

setEvictionScheduledExecutorProperties

public void setEvictionScheduledExecutorProperties(String evictionScheduledExecutorPropertiesString)

getReplicationQueueScheduledExecutorProperties

public Properties getReplicationQueueScheduledExecutorProperties()

setReplicationQueueScheduledExecutorProperties

public void setReplicationQueueScheduledExecutorProperties(Properties replicationQueueScheduledExecutorProperties)

setReplicationQueueScheduledExecutorProperties

public void setReplicationQueueScheduledExecutorProperties(String replicationQueueScheduledExecutorPropertiesString)

getMarshallVersion

public short getMarshallVersion()

getMarshallVersionString

public String getMarshallVersionString()

setMarshallVersion

public void setMarshallVersion(short marshallVersion)
Largest allowable version to use when marshalling internal state. Set this to the lowest version cache instance in your cluster to ensure compatibility of communications. However, setting this too low will mean you lose out on the benefit of improvements in newer versions of the marshaller.

Parameters:
marshallVersion -

setMarshallVersion

public void setMarshallVersion(String marshallVersion)
Largest allowable version to use when marshalling internal state. Set this to the lowest version cache instance in your cluster to ensure compatibility of communications. However, setting this too low will mean you lose out on the benefit of improvements in newer versions of the marshaller.

Parameters:
marshallVersion -

getDistributedSyncTimeout

public long getDistributedSyncTimeout()

setDistributedSyncTimeout

public void setDistributedSyncTimeout(long distributedSyncTimeout)

accept

public void accept(ConfigurationBeanVisitor v)

equals

public boolean equals(Object o)
Overrides:
equals in class Object

hashCode

public int hashCode()
Overrides:
hashCode in class Object

clone

public GlobalConfiguration clone()
Specified by:
clone in interface CloneableConfigurationComponent
Overrides:
clone in class AbstractConfigurationBean

getClusteredDefault

public static GlobalConfiguration getClusteredDefault()
Helper method that gets you a default constructed GlobalConfiguration, preconfigured to use the default clustering stack.

Returns:
a new global configuration

getNonClusteredDefault

public static GlobalConfiguration getNonClusteredDefault()
Helper method that gets you a default constructed GlobalConfiguration, preconfigured for use in LOCAL mode

Returns:
a new global configuration

Google Analytics

Copyright © 2011 JBoss, a division of Red Hat. All Rights Reserved.