kaos.policy.management
Interface PolicyAnalyzes

All Known Subinterfaces:

DirectoryService

All Known Implementing Classes:

CorbaAgentDirectoryServiceProxy, CougaarAgentDirectoryServiceProxy, DirectoryServiceProxy, GridAgentDirectoryServiceProxy, GridDirectoryServicePolicyCert, KAoSAgentDirectoryServiceProxy, KAoSDirectoryService, TCPAgentDirectoryServiceProxy, TunnelClient

public interface PolicyAnalyzes

Provides methods enabling analyzes of policies.

Author:

KAoS Team $Revision: 1.4 $

Nested Class Summary

static class

PolicyAnalyzes.PriorityConditionNotMet

Method Summary

java.util.List<java.lang.String>	findConflictingPolicies(java.lang.String policyId) Method find all the policies conflicting with the specified policy
java.util.List<java.lang.String>	findPoliciesMadeRedundant(java.lang.String policyId) Method find all the policies with higher priority making the specified policy redundant
java.util.List<java.lang.String>	findPoliciesMakingRedundant(java.lang.String policyId) Method find all the policies with higher priority making the specified policy redundant
boolean	isFullyOverlappedBySecondPolicy(java.lang.String firstPolicyId, java.lang.String secondPolicyId) Method finds out if the specified policy is fully overlapped by the second specified policy, the necessary condition is that the two policies have the same modality
boolean	isFullyOverlappedByUnionOfPolicies(java.lang.String firstPolicyId, java.util.List<java.lang.String> listOfPolicies) Method finds out if the specified policy is fully overlapped by the union of specified policies, the necessary condition is that the all policies have the same modality
boolean	isMadeFullyRedundantByPolicyUnion(java.lang.String firstPolicyId, java.util.List<java.lang.String> listOfPolicies) Method finds out if the specified policy is being made redundant (fully covered) by the union of specified policies with higher priority in the repository
boolean	isMadeFullyRedundantBySecond(java.lang.String firstPolicyId, java.lang.String secondPolicyId) Method finds out if the specified policy is being made redundant (fully covered) by the second specified policy with higher priority in the repository
boolean	isMadeParitallyRedundantBySecond(java.lang.String firstPolicyId, java.lang.String secondPolicyId) Method finds out if the specified policy is being made partially redundant (partially covered) by the second specified policy with higher priority in the repository
boolean	isPartiallyOverlappedBySecondPolicy(java.lang.String firstPolicyId, java.lang.String secondPolicyId) Method finds out if the specified policy is partially overlapped by the second specified policy, the necessary condition is that the two policies have the same modality
boolean	isPolicyInConflict(java.lang.String policyId)
boolean	isPolicyMakingRedundantSomeOtherPolicy(java.lang.String policyId) Method finds out if the specified policy makes redundant (fully or partially) some policies with lower priority in the repository
boolean	isPolicyRedundant(java.lang.String policyId) Method finds out if the specified policy is being made redundant (fully or partially) by some policies with higher priority in the repository

Method Detail

isPolicyInConflict

boolean isPolicyInConflict(java.lang.String policyId)
                           throws DirectoryFailure

Throws:

DirectoryFailure

findConflictingPolicies

java.util.List<java.lang.String> findConflictingPolicies(java.lang.String policyId)
                                                         throws DirectoryFailure

Method find all the policies conflicting with the specified policy

Parameters:

policyId - id of the policy

Returns:

List of Policy Ids

Throws:

DirectoryFailure

isFullyOverlappedBySecondPolicy

boolean isFullyOverlappedBySecondPolicy(java.lang.String firstPolicyId,
                                        java.lang.String secondPolicyId)
                                        throws PolicyAnalyzes.PriorityConditionNotMet,
                                               DirectoryFailure

Method finds out if the specified policy is fully overlapped by the second specified policy, the necessary condition is that the two policies have the same modality

Parameters:

firstPolicyId - id of the policy

secondPolicyId - id of the policy

Returns:

true if fully covered, false is not

Throws:

PolicyAnalyzes.PriorityConditionNotMet

DirectoryFailure

isPartiallyOverlappedBySecondPolicy

boolean isPartiallyOverlappedBySecondPolicy(java.lang.String firstPolicyId,
                                            java.lang.String secondPolicyId)
                                            throws PolicyAnalyzes.PriorityConditionNotMet,
                                                   DirectoryFailure

Method finds out if the specified policy is partially overlapped by the second specified policy, the necessary condition is that the two policies have the same modality

Parameters:

firstPolicyId - id of the policy

secondPolicyId - id of the policy

Returns:

true if fully covered, false is not

Throws:

PolicyAnalyzes.PriorityConditionNotMet

DirectoryFailure

isFullyOverlappedByUnionOfPolicies

boolean isFullyOverlappedByUnionOfPolicies(java.lang.String firstPolicyId,
                                           java.util.List<java.lang.String> listOfPolicies)
                                           throws PolicyAnalyzes.PriorityConditionNotMet,
                                                  DirectoryFailure

Method finds out if the specified policy is fully overlapped by the union of specified policies, the necessary condition is that the all policies have the same modality

Parameters:

firstPolicyId - id of the policy

listOfPolicies - list of policies

Returns:

true if fully covered, false is not

Throws:

PolicyAnalyzes.PriorityConditionNotMet

DirectoryFailure

isPolicyRedundant

boolean isPolicyRedundant(java.lang.String policyId)
                          throws DirectoryFailure

Method finds out if the specified policy is being made redundant (fully or partially) by some policies with higher priority in the repository

Parameters:

policyId - id of the policy

Returns:

true if redundant, false is not

Throws:

DirectoryFailure

findPoliciesMakingRedundant

java.util.List<java.lang.String> findPoliciesMakingRedundant(java.lang.String policyId)
                                                             throws DirectoryFailure

Method find all the policies with higher priority making the specified policy redundant

Parameters:

policyId - id of the policy

Returns:

List of Policy Ids

Throws:

DirectoryFailure

isPolicyMakingRedundantSomeOtherPolicy

boolean isPolicyMakingRedundantSomeOtherPolicy(java.lang.String policyId)
                                               throws DirectoryFailure

Method finds out if the specified policy makes redundant (fully or partially) some policies with lower priority in the repository

Parameters:

policyId - id of the policy

Returns:

true if redundant, false is not

Throws:

DirectoryFailure

findPoliciesMadeRedundant

java.util.List<java.lang.String> findPoliciesMadeRedundant(java.lang.String policyId)
                                                           throws DirectoryFailure

Method find all the policies with higher priority making the specified policy redundant

Parameters:

policyId - id of the policy

Returns:

List of Policy Ids

Throws:

DirectoryFailure

isMadeFullyRedundantBySecond

boolean isMadeFullyRedundantBySecond(java.lang.String firstPolicyId,
                                     java.lang.String secondPolicyId)
                                     throws PolicyAnalyzes.PriorityConditionNotMet,
                                            DirectoryFailure

Method finds out if the specified policy is being made redundant (fully covered) by the second specified policy with higher priority in the repository

Parameters:

firstPolicyId - id of the policy

secondPolicyId - id of the policy

Returns:

true if redundant, false is not

Throws:

PolicyAnalyzes.PriorityConditionNotMet

DirectoryFailure

isMadeParitallyRedundantBySecond

boolean isMadeParitallyRedundantBySecond(java.lang.String firstPolicyId,
                                         java.lang.String secondPolicyId)
                                         throws PolicyAnalyzes.PriorityConditionNotMet,
                                                DirectoryFailure

Method finds out if the specified policy is being made partially redundant (partially covered) by the second specified policy with higher priority in the repository

Parameters:

firstPolicyId - id of the policy

secondPolicyId - id of the policy

Returns:

true if redundant, false is not

Throws:

PolicyAnalyzes.PriorityConditionNotMet

DirectoryFailure

isMadeFullyRedundantByPolicyUnion

boolean isMadeFullyRedundantByPolicyUnion(java.lang.String firstPolicyId,
                                          java.util.List<java.lang.String> listOfPolicies)
                                          throws PolicyAnalyzes.PriorityConditionNotMet,
                                                 DirectoryFailure

Method finds out if the specified policy is being made redundant (fully covered) by the union of specified policies with higher priority in the repository

Parameters:

firstPolicyId - id of the policy

listOfPolicies - list of policies

Returns:

true if redundant, false is not

Throws:

PolicyAnalyzes.PriorityConditionNotMet

DirectoryFailure