ActionPolicy (Oracle® Coherence Java API Reference)

All Known Implementing Classes:

CompositeActionPolicy, ConfigurableQuorumPolicy, ConfigurableQuorumPolicy.ClusterQuorumPolicy, ConfigurableQuorumPolicy.MembershipQuorumPolicy, ConfigurableQuorumPolicy.PartitionedCacheQuorumPolicy, ConfigurableQuorumPolicy.ProxyQuorumPolicy, FailoverAccessPolicy, NullImplementation.NullActionPolicy
```
public interface ActionPolicy
```
ActionPolicy defines which aspects of a Service's behavior are currently allowed. Action policy implementations may be used to dynamically restrict aspects of the associated service, for example based on the dynamic state of the service or cluster membership.
For example, ActionPolicy could be used to define a quorum-based policy to prevent distribution from occurring before a certain fraction (a quorum) of the expected service members are present.
ActionPolicy implementations must exercise extreme caution since any delay or unhandled exception will cause a delay or complete shutdown of the corresponding service. ActionPolicy implementations must be thread-safe as the isAllowed(com.tangosol.net.Service, com.tangosol.net.Action) method may be invoked on a service's worker threads.

Since:

Coherence 3.6

Author:

rhl 2009.05.07

Method Summary

All Methods Instance Methods Abstract Methods
Modifier and Type	Method	Description
`void`	`init(Service service)`	Called when the specified service loads and configures this policy.
`boolean`	`isAllowed(Service service, Action action)`	Evaluate if the specified action is currently allowed by this policy.
`String`	`toString()`	Return a human-readable String representation of this ActionPolicy.

- Method Detail
  - init
```
void init(Service service)
```
    Called when the specified service loads and configures this policy.
    Note: A policy could be applied to multiple services.
    
    Parameters:
    
    service - the service that this policy applies to
  - isAllowed
```
boolean isAllowed(Service service,
                  Action action)
```
    Evaluate if the specified action is currently allowed by this policy.
    Note: for forward compatibility, implementations should generally return true for actions that are not recognized.
    
    Parameters:
    
    service - the service that is performing the action
    
    action - the action that is being performed
    
    Returns:
    
    true iff the specified action is currently allowed by this policy
  - toString
```
String toString()
```
    Return a human-readable String representation of this ActionPolicy.
    Note: this method may be used to provide information about this ActionPolicy to management interfaces.
    
    Overrides:
    
    toString in class Object