ModCluster (config-api 0.3.17 API)

java.lang.Object
- org.wildfly.swarm.config.undertow.configuration.ModCluster<T>

@Address(value="/subsystem=undertow/configuration=filter/mod-cluster=*")
public class ModCluster<T extends ModCluster<T>>
extends Object

A mod-cluster front end load balancer

Nested Class Summary

Nested Classes
Modifier and Type Class and Description

static class ModCluster.ModClusterResources
Child mutators for ModCluster

Nested Classes
Modifier and Type	Class and Description
`static class`	`ModCluster.ModClusterResources` Child mutators for ModCluster

Constructor Summary

Constructors
Constructor and Description

ModCluster(String key)

Constructors
Constructor and Description
`ModCluster(String key)`

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`void`	`addPropertyChangeListener(PropertyChangeListener listener)` Adds a property change listener
`Integer`	`advertiseFrequency()` The frequency (in milliseconds) that mod-cluster advertises itself on the network
`T`	`advertiseFrequency(Integer value)` The frequency (in milliseconds) that mod-cluster advertises itself on the network
`String`	`advertisePath()` The path that mod-cluster is registered under, defaults to /
`T`	`advertisePath(String value)` The path that mod-cluster is registered under, defaults to /
`String`	`advertiseProtocol()` The protocol that is in use, defaults to HTTP
`T`	`advertiseProtocol(String value)` The protocol that is in use, defaults to HTTP
`String`	`advertiseSocketBinding()` The multicast group that is used to advertise
`T`	`advertiseSocketBinding(String value)` The multicast group that is used to advertise
`T`	`balancer(Balancer value)` Add the Balancer object to the list of subresources
`T`	`balancer(BalancerSupplier supplier)` Install a supplied Balancer object to the list of subresources
`T`	`balancer(String childKey)` Create and configure a Balancer object to the list of subresources
`T`	`balancer(String childKey, BalancerConsumer consumer)` Create and configure a Balancer object to the list of subresources
`T`	`balancers(List<Balancer> value)` Add all Balancer objects to this subresource
`Integer`	`brokenNodeTimeout()` The amount of time that must elapse before a broken node is removed from the table
`T`	`brokenNodeTimeout(Integer value)` The amount of time that must elapse before a broken node is removed from the table
`Integer`	`cachedConnectionsPerThread()` The number of connections that will be kept alive indefinitely
`T`	`cachedConnectionsPerThread(Integer value)` The number of connections that will be kept alive indefinitely
`Integer`	`connectionIdleTimeout()` The amount of time a connection can be idle before it will be closed.
`T`	`connectionIdleTimeout(Integer value)` The amount of time a connection can be idle before it will be closed.
`Integer`	`connectionsPerThread()` The number of connections that will be maintained to backend servers, per IO thread.
`T`	`connectionsPerThread(Integer value)` The number of connections that will be maintained to backend servers, per IO thread.
`String`	`getKey()`
`Integer`	`healthCheckInterval()` The frequency of health check pings to backend nodes
`T`	`healthCheckInterval(Integer value)` The frequency of health check pings to backend nodes
`String`	`managementAccessPredicate()` A predicate that is applied to incoming requests to determine if they can perform mod cluster management commands.
`T`	`managementAccessPredicate(String value)` A predicate that is applied to incoming requests to determine if they can perform mod cluster management commands.
`String`	`managementSocketBinding()` The socket binding of the mod_cluster management port.
`T`	`managementSocketBinding(String value)` The socket binding of the mod_cluster management port.
`Integer`	`maxRequestTime()` The max amount of time that a request to a backend node can take before it is killed
`T`	`maxRequestTime(Integer value)` The max amount of time that a request to a backend node can take before it is killed
`void`	`removePropertyChangeListener(PropertyChangeListener listener)` Removes a property change listener
`Integer`	`requestQueueSize()` The number of requests that can be queued if the connection pool is full before requests are rejected with a 503
`T`	`requestQueueSize(Integer value)` The number of requests that can be queued if the connection pool is full before requests are rejected with a 503
`String`	`securityKey()` The security key that is used for the mod-cluster group.
`T`	`securityKey(String value)` The security key that is used for the mod-cluster group.
`String`	`securityRealm()` The security realm that provides the SSL configuration
`T`	`securityRealm(String value)` The security realm that provides the SSL configuration
`ModCluster.ModClusterResources`	`subresources()`
`Boolean`	`useAlias()` If an alias check is performed
`T`	`useAlias(Boolean value)` If an alias check is performed
`String`	`worker()` The XNIO worker that is used to send the advertise notifications
`T`	`worker(String value)` The XNIO worker that is used to send the advertise notifications

Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Constructor Detail
  - ModCluster
```
public ModCluster(String key)
```
- Method Detail
  - getKey
```
public String getKey()
```
  - addPropertyChangeListener
```
public void addPropertyChangeListener(PropertyChangeListener listener)
```
    Adds a property change listener
  - removePropertyChangeListener
```
public void removePropertyChangeListener(PropertyChangeListener listener)
```
    Removes a property change listener
  - advertiseFrequency
```
@ModelNodeBinding(detypedName="advertise-frequency")
public Integer advertiseFrequency()
```
    The frequency (in milliseconds) that mod-cluster advertises itself on the network
  - advertiseFrequency
```
public T advertiseFrequency(Integer value)
```
    The frequency (in milliseconds) that mod-cluster advertises itself on the network
  - advertisePath
```
@ModelNodeBinding(detypedName="advertise-path")
public String advertisePath()
```
    The path that mod-cluster is registered under, defaults to /
  - advertisePath
```
public T advertisePath(String value)
```
    The path that mod-cluster is registered under, defaults to /
  - advertiseProtocol
```
@ModelNodeBinding(detypedName="advertise-protocol")
public String advertiseProtocol()
```
    The protocol that is in use, defaults to HTTP
  - advertiseProtocol
```
public T advertiseProtocol(String value)
```
    The protocol that is in use, defaults to HTTP
  - advertiseSocketBinding
```
@ModelNodeBinding(detypedName="advertise-socket-binding")
public String advertiseSocketBinding()
```
    The multicast group that is used to advertise
  - advertiseSocketBinding
```
public T advertiseSocketBinding(String value)
```
    The multicast group that is used to advertise
  - brokenNodeTimeout
```
@ModelNodeBinding(detypedName="broken-node-timeout")
public Integer brokenNodeTimeout()
```
    The amount of time that must elapse before a broken node is removed from the table
  - brokenNodeTimeout
```
public T brokenNodeTimeout(Integer value)
```
    The amount of time that must elapse before a broken node is removed from the table
  - cachedConnectionsPerThread
```
@ModelNodeBinding(detypedName="cached-connections-per-thread")
public Integer cachedConnectionsPerThread()
```
    The number of connections that will be kept alive indefinitely
  - cachedConnectionsPerThread
```
public T cachedConnectionsPerThread(Integer value)
```
    The number of connections that will be kept alive indefinitely
  - connectionIdleTimeout
```
@ModelNodeBinding(detypedName="connection-idle-timeout")
public Integer connectionIdleTimeout()
```
    The amount of time a connection can be idle before it will be closed. Connections will not time out once the pool size is down to the configured minimum (as configured by cached-connections-per-thread)
  - connectionIdleTimeout
```
public T connectionIdleTimeout(Integer value)
```
    The amount of time a connection can be idle before it will be closed. Connections will not time out once the pool size is down to the configured minimum (as configured by cached-connections-per-thread)
  - connectionsPerThread
```
@ModelNodeBinding(detypedName="connections-per-thread")
public Integer connectionsPerThread()
```
    The number of connections that will be maintained to backend servers, per IO thread. Defaults to 10.
  - connectionsPerThread
```
public T connectionsPerThread(Integer value)
```
    The number of connections that will be maintained to backend servers, per IO thread. Defaults to 10.
  - healthCheckInterval
```
@ModelNodeBinding(detypedName="health-check-interval")
public Integer healthCheckInterval()
```
    The frequency of health check pings to backend nodes
  - healthCheckInterval
```
public T healthCheckInterval(Integer value)
```
    The frequency of health check pings to backend nodes
  - managementAccessPredicate
```
@ModelNodeBinding(detypedName="management-access-predicate")
public String managementAccessPredicate()
```
    A predicate that is applied to incoming requests to determine if they can perform mod cluster management commands. Provides additional security on top of what is provided by limiting management to requests that originate from the management-socket-binding
  - managementAccessPredicate
```
public T managementAccessPredicate(String value)
```
    A predicate that is applied to incoming requests to determine if they can perform mod cluster management commands. Provides additional security on top of what is provided by limiting management to requests that originate from the management-socket-binding
  - managementSocketBinding
```
@ModelNodeBinding(detypedName="management-socket-binding")
public String managementSocketBinding()
```
    The socket binding of the mod_cluster management port. When using mod_cluster two HTTP listeners should be defined, a public one to handle requests, and one bound to the internal network to handle mod cluster commands. This socket binding should correspond to the internal listener, and should not be publicly accessible
  - managementSocketBinding
```
public T managementSocketBinding(String value)
```
    The socket binding of the mod_cluster management port. When using mod_cluster two HTTP listeners should be defined, a public one to handle requests, and one bound to the internal network to handle mod cluster commands. This socket binding should correspond to the internal listener, and should not be publicly accessible
  - maxRequestTime
```
@ModelNodeBinding(detypedName="max-request-time")
public Integer maxRequestTime()
```
    The max amount of time that a request to a backend node can take before it is killed
  - maxRequestTime
```
public T maxRequestTime(Integer value)
```
    The max amount of time that a request to a backend node can take before it is killed
  - requestQueueSize
```
@ModelNodeBinding(detypedName="request-queue-size")
public Integer requestQueueSize()
```
    The number of requests that can be queued if the connection pool is full before requests are rejected with a 503
  - requestQueueSize
```
public T requestQueueSize(Integer value)
```
    The number of requests that can be queued if the connection pool is full before requests are rejected with a 503
  - securityKey
```
@ModelNodeBinding(detypedName="security-key")
public String securityKey()
```
    The security key that is used for the mod-cluster group. All members must use the same security key.
  - securityKey
```
public T securityKey(String value)
```
    The security key that is used for the mod-cluster group. All members must use the same security key.
  - securityRealm
```
@ModelNodeBinding(detypedName="security-realm")
public String securityRealm()
```
    The security realm that provides the SSL configuration
  - securityRealm
```
public T securityRealm(String value)
```
    The security realm that provides the SSL configuration
  - useAlias
```
@ModelNodeBinding(detypedName="use-alias")
public Boolean useAlias()
```
    If an alias check is performed
  - useAlias
```
public T useAlias(Boolean value)
```
    If an alias check is performed
  - worker
```
@ModelNodeBinding(detypedName="worker")
public String worker()
```
    The XNIO worker that is used to send the advertise notifications
  - worker
```
public T worker(String value)
```
    The XNIO worker that is used to send the advertise notifications
  - subresources
```
public ModCluster.ModClusterResources subresources()
```
  - balancers
```
public T balancers(List<Balancer> value)
```
    Add all Balancer objects to this subresource
    
    Parameters:
    
    value - List of Balancer objects.
    
    Returns:
    
    this
  - balancer
```
public T balancer(Balancer value)
```
    Add the Balancer object to the list of subresources
    
    Parameters:
    
    value - The Balancer to add
    
    Returns:
    
    this
  - balancer
```
public T balancer(String childKey,
                  BalancerConsumer consumer)
```
    Create and configure a Balancer object to the list of subresources
    
    Parameters:
    
    key - The key for the Balancer resource
    
    config - The BalancerConsumer to use
    
    Returns:
    
    this
  - balancer
```
public T balancer(String childKey)
```
    Create and configure a Balancer object to the list of subresources
    
    Parameters:
    
    key - The key for the Balancer resource
    
    Returns:
    
    this
  - balancer
```
public T balancer(BalancerSupplier supplier)
```
    Install a supplied Balancer object to the list of subresources

Class ModCluster<T extends ModCluster<T>>

Nested Class Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

ModCluster

Method Detail

getKey

addPropertyChangeListener

removePropertyChangeListener

advertiseFrequency

advertiseFrequency

advertisePath

advertisePath

advertiseProtocol

advertiseProtocol

advertiseSocketBinding

advertiseSocketBinding

brokenNodeTimeout

brokenNodeTimeout

cachedConnectionsPerThread

cachedConnectionsPerThread

connectionIdleTimeout

connectionIdleTimeout

connectionsPerThread

connectionsPerThread

healthCheckInterval

healthCheckInterval

managementAccessPredicate

managementAccessPredicate

managementSocketBinding

managementSocketBinding

maxRequestTime

maxRequestTime

requestQueueSize

requestQueueSize

securityKey

securityKey

securityRealm

securityRealm

useAlias

useAlias

worker

worker

subresources

balancers

balancer

balancer

balancer

balancer