org.jboss.modcluster.container.tomcat

Class ModClusterListener

java.lang.Object

org.jboss.modcluster.config.impl.ModClusterConfig

org.jboss.modcluster.container.tomcat.ModClusterListener

All Implemented Interfaces:

org.apache.catalina.LifecycleListener, AdvertiseConfiguration, BalancerConfiguration, MCMPHandlerConfiguration, NodeConfiguration, SSLConfiguration, TomcatConnectorConfiguration, org.jboss.modcluster.load.LoadBalanceFactorProviderFactory, ModClusterServiceMBean

Direct Known Subclasses:

ModClusterListener

public class ModClusterListener
extends ModClusterConfig
implements TomcatConnectorConfiguration, org.apache.catalina.LifecycleListener, org.jboss.modcluster.load.LoadBalanceFactorProviderFactory, ModClusterServiceMBean

Mod_cluster lifecycle listener for use in Tomcat.

Author:

Paul Ferraro

Field Summary

Fields inherited from interface org.jboss.modcluster.config.AdvertiseConfiguration

DEFAULT_SOCKET_ADDRESS

Constructor Summary

Constructors

Modifier	Constructor and Description
	ModClusterListener()
protected	ModClusterListener(ModClusterServiceMBean mbean, org.apache.catalina.LifecycleListener listener)

Method Summary

Modifier and Type	Method and Description
void	addProxy(String host, int port)
org.jboss.modcluster.load.LoadBalanceFactorProvider	createLoadBalanceFactorProvider()
boolean	disable()
boolean	disableContext(String hostName, String contextPath)
boolean	enable()
boolean	enableContext(String hostName, String contextPath)
String	getAdvertiseGroupAddress()
int	getAdvertisePort()
String	getConnectorAddress() Returns optional connector address.
Integer	getConnectorPort() Returns optional connector port.
String	getExcludedContexts()
int	getInitialLoad()
Class<? extends JvmRouteFactory>	getJvmRouteFactoryClass()
float	getLoadDecayFactor() Returns the factor by which the contribution of historical load values to the load factor calculation should exponentially decay.
int	getLoadHistory() Returns the number of historic load values used when calculating the load factor.
double	getLoadMetricCapacity()
String	getLoadMetricClass() Returns the class name of the configured load metric.
Map<InetSocketAddress,String>	getProxyConfiguration()
String	getProxyConfigurationString()
Map<InetSocketAddress,String>	getProxyInfo()
String	getProxyInfoString()
String	getProxyList()
void	lifecycleEvent(org.apache.catalina.LifecycleEvent event)
Map<InetSocketAddress,String>	ping()
Map<InetSocketAddress,String>	ping(String jvmRoute)
Map<InetSocketAddress,String>	ping(String scheme, String host, int port)
void	refresh()
void	removeProxy(String host, int port)
void	reset()
void	setAdvertiseGroupAddress(String advertiseGroupAddress)
void	setAdvertiseInterface(String advertiseInterface)
void	setAdvertisePort(int advertisePort)
void	setConnectorAddress(String connectorAddress)
void	setConnectorPort(int connectorPort)
void	setExcludedContexts(String contexts)
void	setInitialLoad(int initialLoad)
void	setJvmRouteFactoryClass(Class<? extends JvmRouteFactory> factoryClass)
void	setLoadDecayFactor(float decayFactor) Sets the factor by which the contribution of historical load values to the load factor calculation should exponentially decay.
void	setLoadDecayFactor(String decayFactor) String-based variant of setLoadDecayFactor(float) to set float decay factor used by Tomcat modeler.
void	setLoadHistory(int history) Sets the number of historic load values used when calculating the load factor.
void	setLoadMetricCapacity(String capacity) Sets the capacity (i.e.
void	setLoadMetricClass(String loadMetricClass) Sets the class of the desired load metric
void	setProxyList(String addresses)
void	setSessionDrainingStrategy(String sessionDrainingStrategy)
boolean	stop(long timeout)
boolean	stop(long timeout, TimeUnit unit)
boolean	stopContext(String host, String path, long timeout)
boolean	stopContext(String host, String path, long timeout, TimeUnit unit)

Methods inherited from class org.jboss.modcluster.config.impl.ModClusterConfig

getAdvertise, getAdvertiseInterface, getAdvertiseSecurityKey, getAdvertiseSocketAddress, getAdvertiseThreadFactory, getBalancer, getExcludedContextsPerHost, getFlushPackets, getFlushWait, getJvmRouteFactory, getLoadBalancingGroup, getMaxAttempts, getNodeTimeout, getPing, getProxies, getProxyConfigurations, getProxyURL, getSessionDrainingStrategy, getSmax, getSocketFactory, getSocketTimeout, getSslCertificateEncodingAlgorithm, getSslCiphers, getSslCrlFile, getSslKeyAlias, getSslKeyStore, getSslKeyStorePassword, getSslKeyStoreProvider, getSslKeyStoreType, getSslProtocol, getSslTrustAlgorithm, getSslTrustMaxCertLength, getSslTrustStore, getSslTrustStorePassword, getSslTrustStoreProvider, getSslTrustStoreType, getStickySession, getStickySessionForce, getStickySessionRemove, getStopContextTimeout, getStopContextTimeoutUnit, getTtl, getWorkerTimeout, isAutoEnableContexts, isSsl, setAdvertise, setAdvertiseInterface, setAdvertiseSecurityKey, setAdvertiseSocketAddress, setAdvertiseThreadFactory, setAutoEnableContexts, setBalancer, setExcludedContextsPerHost, setFlushPackets, setFlushWait, setJvmRouteFactory, setLoadBalancingGroup, setMaxAttempts, setNodeTimeout, setPing, setProxies, setProxyConfigurations, setProxyURL, setSessionDrainingStrategy, setSmax, setSocketTimeout, setSsl, setSslCertificateEncodingAlgorithm, setSslCiphers, setSslCrlFile, setSslKeyAlias, setSslKeyStore, setSslKeyStorePassword, setSslKeyStoreProvider, setSslKeyStoreType, setSslProtocol, setSslTrustAlgorithm, setSslTrustMaxCertLength, setSslTrustStore, setSslTrustStorePassword, setSslTrustStoreProvider, setSslTrustStoreType, setStickySession, setStickySessionForce, setStickySessionRemove, setStopContextTimeout, setStopContextTimeoutUnit, setTtl, setWorkerTimeout

Methods inherited from class java.lang.Object

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

Constructor Detail

ModClusterListener

public ModClusterListener()

ModClusterListener

protected ModClusterListener(ModClusterServiceMBean mbean,
                             org.apache.catalina.LifecycleListener listener)

Method Detail

createLoadBalanceFactorProvider

public org.jboss.modcluster.load.LoadBalanceFactorProvider createLoadBalanceFactorProvider()

Specified by:

createLoadBalanceFactorProvider in interface org.jboss.modcluster.load.LoadBalanceFactorProviderFactory

lifecycleEvent

public void lifecycleEvent(org.apache.catalina.LifecycleEvent event)

Specified by:

lifecycleEvent in interface org.apache.catalina.LifecycleListener

getJvmRouteFactoryClass

public Class<? extends JvmRouteFactory> getJvmRouteFactoryClass()

setJvmRouteFactoryClass

public void setJvmRouteFactoryClass(Class<? extends JvmRouteFactory> factoryClass)

getLoadMetricClass

public String getLoadMetricClass()

Returns the class name of the configured load metric.

Returns:

the name of a class implementing LoadMetric

setLoadMetricClass

public void setLoadMetricClass(String loadMetricClass)

Sets the class of the desired load metric

Parameters:

loadMetricClass - a class implementing LoadMetric

Throws:

IllegalArgumentException - if metric class could not be loaded

getLoadDecayFactor

public float getLoadDecayFactor()

Returns the factor by which the contribution of historical load values to the load factor calculation should exponentially decay.

Returns:

the configured load decay factor

setLoadDecayFactor

public void setLoadDecayFactor(float decayFactor)

Sets the factor by which the contribution of historical load values to the load factor calculation should exponentially decay.

Parameters:

decayFactor - a positive number

setLoadDecayFactor

public void setLoadDecayFactor(String decayFactor)

String-based variant of setLoadDecayFactor(float) to set float decay factor used by Tomcat modeler.

Parameters:

decayFactor - a positive number

getLoadHistory

public int getLoadHistory()

Returns the number of historic load values used when calculating the load factor.

Returns:

the configured load history

setLoadHistory

public void setLoadHistory(int history)

Sets the number of historic load values used when calculating the load factor.

Parameters:

history -

getLoadMetricCapacity

public double getLoadMetricCapacity()

setLoadMetricCapacity

public void setLoadMetricCapacity(String capacity)

Sets the capacity (i.e. maximum expected value) of the load values returned by the load metric specified by getLoadMetricClass()

Parameters:

capacity - a load capacity

getInitialLoad

public int getInitialLoad()

setInitialLoad

public void setInitialLoad(int initialLoad)

addProxy

public void addProxy(String host,
                     int port)

Specified by:

addProxy in interface ModClusterServiceMBean

disable

public boolean disable()

Specified by:

disable in interface ModClusterServiceMBean

disableContext

public boolean disableContext(String hostName,
                              String contextPath)

Specified by:

disableContext in interface ModClusterServiceMBean

ping

public Map<InetSocketAddress,String> ping()

Specified by:

ping in interface ModClusterServiceMBean

ping

public Map<InetSocketAddress,String> ping(String jvmRoute)

Specified by:

ping in interface ModClusterServiceMBean

ping

public Map<InetSocketAddress,String> ping(String scheme,
                                          String host,
                                          int port)

Specified by:

ping in interface ModClusterServiceMBean

enable

public boolean enable()

Specified by:

enable in interface ModClusterServiceMBean

enableContext

public boolean enableContext(String hostName,
                             String contextPath)

Specified by:

enableContext in interface ModClusterServiceMBean

getProxyConfiguration

public Map<InetSocketAddress,String> getProxyConfiguration()

Specified by:

getProxyConfiguration in interface ModClusterServiceMBean

getProxyInfo

public Map<InetSocketAddress,String> getProxyInfo()

Specified by:

getProxyInfo in interface ModClusterServiceMBean

refresh

public void refresh()

Specified by:

refresh in interface ModClusterServiceMBean

removeProxy

public void removeProxy(String host,
                        int port)

Specified by:

removeProxy in interface ModClusterServiceMBean

reset

public void reset()

Specified by:

reset in interface ModClusterServiceMBean

stop

public boolean stop(long timeout,
                    TimeUnit unit)

Specified by:

stop in interface ModClusterServiceMBean

stopContext

public boolean stopContext(String host,
                           String path,
                           long timeout,
                           TimeUnit unit)

Specified by:

stopContext in interface ModClusterServiceMBean

getProxyConfigurationString

public String getProxyConfigurationString()

getProxyInfoString

public String getProxyInfoString()

stop

public boolean stop(long timeout)

stopContext

public boolean stopContext(String host,
                           String path,
                           long timeout)

getConnectorAddress

public String getConnectorAddress()

Description copied from interface: TomcatConnectorConfiguration

Returns optional connector address.

Specified by:

getConnectorAddress in interface TomcatConnectorConfiguration

Returns:

connector address

setConnectorAddress

public void setConnectorAddress(String connectorAddress)

getConnectorPort

public Integer getConnectorPort()

Description copied from interface: TomcatConnectorConfiguration

Returns optional connector port.

Specified by:

getConnectorPort in interface TomcatConnectorConfiguration

Returns:

connector port

setConnectorPort

public void setConnectorPort(int connectorPort)

getAdvertiseGroupAddress

public String getAdvertiseGroupAddress()

setAdvertiseGroupAddress

public void setAdvertiseGroupAddress(String advertiseGroupAddress)

getAdvertisePort

public int getAdvertisePort()

setAdvertisePort

public void setAdvertisePort(int advertisePort)

setAdvertiseInterface

public void setAdvertiseInterface(String advertiseInterface)

setProxyList

public void setProxyList(String addresses)

getProxyList

public String getProxyList()

setExcludedContexts

public void setExcludedContexts(String contexts)

getExcludedContexts

public String getExcludedContexts()

setSessionDrainingStrategy

public void setSessionDrainingStrategy(String sessionDrainingStrategy)