kaos.policy.management
Interface PolicyDirectory

All Known Subinterfaces:

DirectoryService, PolicyManager, SAFEPolicyManager

All Known Implementing Classes:

GridDirectoryServicePolicyCert, KAoSDirectoryService, TunnelClient

public interface PolicyDirectory

$Revision: 1.9 $

Method Summary

void	addPolicies(java.util.Vector policies) Each element of the Vector is an instance of a Msg class specifying an individual policy fields
void	addPolicy(Msg policy)
void	changePolicies(java.util.Vector policies)
void	changePolicy(Msg policy)
java.util.Vector	getApplicablePoliciesForEntity(java.lang.String entityId) Obtain the set of policies directly and indirectly applicable to a specified entity.
java.util.Vector	getConditionalPolicies()
java.util.List	getPolicies() Obtain an List over all policies.
java.util.Map	getPoliciesByEntities() Obtain a table of all original policies (pre-deconfliction and OWL->XML conversion) in the system, indexed by the id(s) of the entity(s) to which they apply
java.util.Vector	getPoliciesForEntity(java.lang.String entityId) Obtain the original (pre-deconfliction and OWL->XML conversion) policies directly applicable to the specified entity This method does not return all policies applicable to the entity (e.g., if you specified the id of an agent, it would only return policies for that agent, *not* including policies for the agent container, exec env, host, domain, which apply to the agent)
Msg	getPolicy(java.lang.String policyId)
void	removePolicies(java.util.List policies)
void	removePolicy(Msg policy)
void	setConditionalPolicies(java.util.Vector condPols)
void	updatePolicies(java.util.List addedPolicies, java.util.List changedPolicies, java.util.List removedPolicies)

Method Detail

addPolicy

void addPolicy(Msg policy)
               throws OntologyPolicyIncorrect,
                      PoliciesHarmonizedException,
                      PrecedenceUndeterminedException,
                      DirectoryFailure

Throws:

OntologyPolicyIncorrect

PoliciesHarmonizedException

PrecedenceUndeterminedException

DirectoryFailure

addPolicies

void addPolicies(java.util.Vector policies)
                 throws OntologyPolicyIncorrect,
                        PoliciesHarmonizedException,
                        PrecedenceUndeterminedException,
                        DirectoryFailure

Each element of the Vector is an instance of a Msg class specifying an individual policy fields

Parameters:

policies - The Vector of policies to be added to the collection of all policies.

Throws:

OntologyPolicyIncorrect

PoliciesHarmonizedException

PrecedenceUndeterminedException

DirectoryFailure

removePolicy

void removePolicy(Msg policy)
                  throws OntologyPolicyIncorrect,
                         PoliciesHarmonizedException,
                         PrecedenceUndeterminedException,
                         DirectoryFailure

Throws:

OntologyPolicyIncorrect

PoliciesHarmonizedException

PrecedenceUndeterminedException

DirectoryFailure

removePolicies

void removePolicies(java.util.List policies)
                    throws OntologyPolicyIncorrect,
                           PoliciesHarmonizedException,
                           PrecedenceUndeterminedException,
                           DirectoryFailure

Throws:

OntologyPolicyIncorrect

PoliciesHarmonizedException

PrecedenceUndeterminedException

DirectoryFailure

changePolicy

void changePolicy(Msg policy)
                  throws OntologyPolicyIncorrect,
                         PoliciesHarmonizedException,
                         PrecedenceUndeterminedException,
                         DirectoryFailure

Throws:

OntologyPolicyIncorrect

PoliciesHarmonizedException

PrecedenceUndeterminedException

DirectoryFailure

changePolicies

void changePolicies(java.util.Vector policies)
                    throws OntologyPolicyIncorrect,
                           PoliciesHarmonizedException,
                           PrecedenceUndeterminedException,
                           DirectoryFailure

Throws:

OntologyPolicyIncorrect

PoliciesHarmonizedException

PrecedenceUndeterminedException

DirectoryFailure

updatePolicies

void updatePolicies(java.util.List addedPolicies,
                    java.util.List changedPolicies,
                    java.util.List removedPolicies)
                    throws OntologyPolicyIncorrect,
                           PoliciesHarmonizedException,
                           PrecedenceUndeterminedException,
                           DirectoryFailure

Throws:

OntologyPolicyIncorrect

PoliciesHarmonizedException

PrecedenceUndeterminedException

DirectoryFailure

getPolicies

java.util.List getPolicies()
                           throws DirectoryFailure

Obtain an List over all policies. Each element of the List is an instance of a Msg class specifying an individual policy fields.

Returns:

List of policy Msgs.

Throws:

DirectoryFailure

getPolicy

Msg getPolicy(java.lang.String policyId)
              throws DirectoryFailure

Throws:

DirectoryFailure

getPoliciesForEntity

java.util.Vector getPoliciesForEntity(java.lang.String entityId)
                                      throws DirectoryFailure

Obtain the original (pre-deconfliction and OWL->XML conversion) policies directly applicable to the specified entity This method does not return all policies applicable to the entity (e.g., if you specified the id of an agent, it would only return policies for that agent, *not* including policies for the agent container, exec env, host, domain, which apply to the agent)

Parameters:

entityId - id of the entity

Returns:

Vector of PolicyMsg

Throws:

DirectoryFailure

getPoliciesByEntities

java.util.Map getPoliciesByEntities()
                                    throws DirectoryFailure

Obtain a table of all original policies (pre-deconfliction and OWL->XML conversion) in the system, indexed by the id(s) of the entity(s) to which they apply

Returns:

Map of Map of policies key = String representing entity id value = Map of policies that are directly applicable to the entity (see comments for getPoliciesForEntity for the meaning of "directly applicable") key = String representing policy id value = PolicyMsg

Throws:

DirectoryFailure

getApplicablePoliciesForEntity

java.util.Vector getApplicablePoliciesForEntity(java.lang.String entityId)
                                                throws DirectoryFailure

Obtain the set of policies directly and indirectly applicable to a specified entity. This method returns all policies applicable to the entity (e.g., if you specified the id of an agent, it would return the policies for the agent, plus policies for the agent container, exec env, host, domain, which apply to the agent), also not in force now.

Parameters:

entityId - id of the entity

Returns:

Vector of PolicyMsg

Throws:

DirectoryFailure

getConditionalPolicies

java.util.Vector getConditionalPolicies()
                                        throws DirectoryFailure

Throws:

DirectoryFailure

setConditionalPolicies

void setConditionalPolicies(java.util.Vector condPols)
                            throws DirectoryFailure

Throws:

DirectoryFailure