Skip navigation links

Oracle® Coherence Java API Reference
Release 3.7.0.0

E18683-01


com.tangosol.net
Interface ActionPolicy

All Known Implementing Classes:
ConfigurableQuorumPolicy, ConfigurableQuorumPolicy.ClusterQuorumPolicy, ConfigurableQuorumPolicy.MembershipQuorumPolicy, ConfigurableQuorumPolicy.PartitionedCacheQuorumPolicy, ConfigurableQuorumPolicy.ProxyQuorumPolicy, ConfigurableQuorumPolicy.WrapperQuorumPolicy, 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 occuring 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
 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.
 java.lang.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

java.lang.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.


Skip navigation links

Oracle® Coherence Java API Reference
Release 3.7.0.0

E18683-01


Copyright © 2000, 2011, Oracle and/or its affiliates. All rights reserved.