kaos.policy.information
Interface PolicyDBManagerForwarder

All Known Subinterfaces:

GuardMgmtRequestsForwarder

public interface PolicyDBManagerForwarder

This interface defines methods to manage policy database of a given PolicyDBManager.

Method Summary

java.lang.String	addPolicy(PolicyInformation policy, java.lang.String policyDBManagerID) Ask the specified PolicyDBManager to add the given policy object to this database.
java.lang.String	getAllPolicies(java.lang.String policyDBManagerID) Ask the specified PolicyDBManager to get all policy objects contained in this database.
java.lang.String	getPolicyInformation(java.lang.String policyID, java.lang.String policyDBManagerID) Ask the specified PolicyDBManager to get the policy for the given policy id.
java.lang.String	refreshAllPoliciesComplete(java.lang.String policyDBManagerID) Ask the specified PolicyDBManager to refresh all cached property values for all policies in this database.
java.lang.String	refreshAllPoliciesPartial(java.util.Vector properties, java.lang.String policyDBManagerID) Ask the specified PolicyDBManager to refresh cached values of only those properties that are specified for all the policies in this database.
java.lang.String	refreshPolicyComplete(java.lang.String policyID, java.lang.String policyDBManagerID) Ask the specified PolicyDBManager to refresh all cached property values for the given policy.
java.lang.String	refreshPolicyPartial(java.lang.String policyID, java.util.Vector properties, java.lang.String policyDBManagerID) Ask the specified PolicyDBManager to refresh cached values of only those properties that are specified for the given policy.
java.lang.String	refreshSpecifiedPoliciesComplete(java.util.Vector policyIDs, java.lang.String policyDBManagerID) Ask the specified PolicyDBManager to refresh cached values of all properties of the specified policies.
java.lang.String	refreshSpecifiedPoliciesPartial(java.util.Vector policyIDs, java.util.Vector properties, java.lang.String policyDBManagerID) Ask the specified PolicyDBManager to refresh cached values of only those properties that are specified for only specified policies.
java.lang.String	removeAllPolicies(java.lang.String policyDBManagerID) Ask the specified PolicyDBManager to to remove all policy objects contained in this database.
java.lang.String	removePolicyInformation(java.lang.String policyID, java.lang.String policyDBManagerID) Ask the specified PolicyDBManager to remove from this database the policy object for the given policy id.
java.lang.String	setPolicy(java.lang.String policyID, PolicyInformation policy, java.lang.String policyDBManagerID) Ask the specified PolicyDBManager to set the policy object for the given policy id.

Method Detail

getPolicyInformation

java.lang.String getPolicyInformation(java.lang.String policyID,
                                      java.lang.String policyDBManagerID)
                                      throws java.lang.Exception

Ask the specified PolicyDBManager to get the policy for the given policy id.

Parameters:

policyID - A String indicating the policy id.

policyDBManagerID - A String identifying the specific PolicyDBManager to forward this request to.

Returns:

String uniquely identifying the forwarded request.

Throws:

java.lang.Exception

removePolicyInformation

java.lang.String removePolicyInformation(java.lang.String policyID,
                                         java.lang.String policyDBManagerID)
                                         throws java.lang.Exception

Ask the specified PolicyDBManager to remove from this database the policy object for the given policy id.

Parameters:

policyID - A String indicating the policy id.

policyDBManagerID - A String identifying the specific PolicyDBManager to forward this request to.

Returns:

String uniquely identifying the forwarded request.

Throws:

java.lang.Exception

setPolicy

java.lang.String setPolicy(java.lang.String policyID,
                           PolicyInformation policy,
                           java.lang.String policyDBManagerID)
                           throws java.lang.Exception

Ask the specified PolicyDBManager to set the policy object for the given policy id.

Parameters:

policyID - A String indicating the policy id.

policy - The policy object to be set for the given id.

policyDBManagerID - A String identifying the specific PolicyDBManager to forward this request to.

Returns:

String uniquely identifying the forwarded request.

Throws:

java.lang.Exception

addPolicy

java.lang.String addPolicy(PolicyInformation policy,
                           java.lang.String policyDBManagerID)
                           throws java.lang.Exception

Ask the specified PolicyDBManager to add the given policy object to this database. If the policy for the policy id contained in this object already exists, it will be replaced by this object. If not, a new entry will be created.

Parameters:

policy - The policy object to be added.

policyDBManagerID - A String identifying the specific PolicyDBManager to forward this request to.

Returns:

String uniquely identifying the forwarded request

Throws:

java.lang.Exception

getAllPolicies

java.lang.String getAllPolicies(java.lang.String policyDBManagerID)
                                throws java.lang.Exception

Ask the specified PolicyDBManager to get all policy objects contained in this database.

Parameters:

policyDBManagerID - A String identifying the specific PolicyDBManager to forward this request to.

Returns:

String uniquely identifying the forwarded request.

Throws:

java.lang.Exception

removeAllPolicies

java.lang.String removeAllPolicies(java.lang.String policyDBManagerID)
                                   throws java.lang.Exception

Ask the specified PolicyDBManager to to remove all policy objects contained in this database.

Parameters:

policyDBManagerID - A String identifying the specific PolicyDBManager to forward this request to.

Returns:

String uniquely identifying the forwarded request.

Throws:

java.lang.Exception

refreshPolicyComplete

java.lang.String refreshPolicyComplete(java.lang.String policyID,
                                       java.lang.String policyDBManagerID)
                                       throws java.lang.Exception

Ask the specified PolicyDBManager to refresh all cached property values for the given policy.

Parameters:

policyID - A String indicating the policy id.

policyDBManagerID - A String identifying the specific PolicyDBManager to forward this request to.

Returns:

String uniquely identifying the forwarded request.

Throws:

java.lang.Exception

refreshPolicyPartial

java.lang.String refreshPolicyPartial(java.lang.String policyID,
                                      java.util.Vector properties,
                                      java.lang.String policyDBManagerID)
                                      throws java.lang.Exception

Ask the specified PolicyDBManager to refresh cached values of only those properties that are specified for the given policy.

Parameters:

policyID - A String indicating the policy id.

properties - A Vector containing property names whose values are to be refreshed.

policyDBManagerID - A String identifying the specific PolicyDBManager to forward this request to.

Returns:

String uniquely identifying the forwarded request.

Throws:

java.lang.Exception

refreshAllPoliciesComplete

java.lang.String refreshAllPoliciesComplete(java.lang.String policyDBManagerID)
                                            throws java.lang.Exception

Ask the specified PolicyDBManager to refresh all cached property values for all policies in this database.

Parameters:

policyDBManagerID - A String identifying the specific PolicyDBManager to forward this request to.

Returns:

String uniquely identifying the forwarded request.

Throws:

java.lang.Exception

refreshAllPoliciesPartial

java.lang.String refreshAllPoliciesPartial(java.util.Vector properties,
                                           java.lang.String policyDBManagerID)
                                           throws java.lang.Exception

Ask the specified PolicyDBManager to refresh cached values of only those properties that are specified for all the policies in this database.

Parameters:

properties - A Vector containing property names whose values are to be refreshed.

policyDBManagerID - A String identifying the specific PolicyDBManager to forward this request to.

Returns:

String uniquely identifying the forwarded request.

Throws:

java.lang.Exception

refreshSpecifiedPoliciesComplete

java.lang.String refreshSpecifiedPoliciesComplete(java.util.Vector policyIDs,
                                                  java.lang.String policyDBManagerID)
                                                  throws java.lang.Exception

Ask the specified PolicyDBManager to refresh cached values of all properties of the specified policies.

Parameters:

policyIDs - A Vector containing ids of those policies that are to be refreshed.

policyDBManagerID - A String identifying the specific PolicyDBManager to forward this request to.

Returns:

String uniquely identifying the forwarded request.

Throws:

java.lang.Exception

refreshSpecifiedPoliciesPartial

java.lang.String refreshSpecifiedPoliciesPartial(java.util.Vector policyIDs,
                                                 java.util.Vector properties,
                                                 java.lang.String policyDBManagerID)
                                                 throws java.lang.Exception

Ask the specified PolicyDBManager to refresh cached values of only those properties that are specified for only specified policies.

Parameters:

policyIDs - A Vector containing ids of those policies that are to be refreshed.

properties - A Vector containing property names whose values are to be refreshed.

policyDBManagerID - A String identifying the specific PolicyDBManager to forward this request to.

Returns:

String uniquely identifying the forwarded request.

Throws:

java.lang.Exception