Skip navigation links

Oracle Fusion Middleware Java API Reference for Oracle Web Services Manager
11g (11.1.1)

E10689-01


oracle.wsm.policymanager.client
Class UpdateServiceDelegate

java.lang.Object
  extended by oracle.wsm.policymanager.client.UpdateServiceDelegate

All Implemented Interfaces:
IUpdateService

public class UpdateServiceDelegate
extends Object
implements IUpdateService

Constructor Summary
UpdateServiceDelegate(IStringUpdateService strUpdateService)
           

 

Method Summary
 IPolicySubjectAttachmentResult addAttachmentEntries(IPolicySubject polSubject, List<IPolicyReference> polRefs)
          Given a policy subject - represented by a resource pattern and a list of policy references for the policy subject - add attachments - if the referenced Policy does not exist - then that entry will be ignored (will not thrown an exception) and processing will continue Duplicate policy references are handled automatically as well as duplicate calls for the same resource pattern.
 List<IPolicyAttachmentResult> addAttachmentEntries(String resourcePattern, List<IPolicyReference> polRefs)
          
 void addAttachmentEntry(IPolicy policy, List<String> resourcePatterns)
          
 boolean areTransactionsSupported()
          This methods lets you know if transactionality is supported by the backed datastore used by the policymanager.
 IAssertionTemplate createAssertionTemplate(IAssertionTemplate assertionTemplate)
          Adds a new Assertion template to the backend datastore
 IPolicy createPolicy(IPolicy policy)
          Adds a new policy to the backend datastore
 List<IPolicy> createPolicy(List<IPolicy> polList)
          Bulk creation of policies
 void deleteAllAssertionTemplates()
          PERMENENTLY deletes ALL assertion templates from the datastore Assertion templates once deleted cannot be retrived
 void deleteAllAttachments()
          Deletes all policy attachments from data store
 void deleteAllPolicies()
          PERMENENTLY deletes ALL policies from the datastore Policies once deleted cannot be retrived
 void deleteAssertionTemplate(IAssertionTemplate assertionTemplate)
          Delete an Assertion template from backend datastore
 void deleteAssertionTemplate(String templateName)
          Delete an Assertion template from backend datastore
 void deleteAssertionTemplates(List<String> assertionTemplateNames)
          Delete all the policies corresponding to the policy names passed
 void deleteAssertionTemplateVersions(String assertionTemplateName, List<Long> versionNumbers)
          Delete all the specified versions of an assertion template
 IPolicySubjectAttachmentResult deleteAttachmentEntries(IPolicySubject polSubject, List<IPolicyReference> polRefs)
          Disassociate a policy subject, represented by a resource pattern, with all policies pointed to by the passed policy reference list Given a policy subject - represented by a resource pattern and a list of policy references for the policy subject - deletes all the attachment entries for the corresponding combination of <resource pattern, IPolicyReference>.
 void deleteAttachmentEntries(List<String> policySubject)
          Disassociate a policy subject, represented by a resource pattern, with all policies that it may be associated with.
 void deleteAttachmentEntries(String resourcePattern)
          Disassociate a policy subject, represented by a resource pattern, with all policies that it may be associated with.
 List<IPolicyAttachmentResult> deleteAttachmentEntries(String resourcePattern, List<IPolicyReference> polRefs)
          
 void deletePolicies(List<String> polNameList)
          Delete all the policies corresponding to the policy names passed
 void deletePolicy(IPolicy policy)
          Deletes a policy to the backend datastore
 void deletePolicy(String policyName)
          Deletes a policy to the backend datastore
 void deletePolicyVersions(String policyName, List<Long> versionNumbers)
          Delete all the specified versions of a policy
 Subject getSubject()
           
 IAssertionTemplate promoteAssertionTemplateToTip(String assertionTemplateName, long version)
          Promote a previous policy version to the latest.
 IPolicy promotePolicyToTip(String policyName, long version)
          Promote a previous policy version to the latest.
 void removeAttachmentEntry(IPolicy policy, List<String> resourcePatterns)
          
 void setSubject(Subject subject)
           
 IAssertionTemplate updateAssertionTemplate(IAssertionTemplate assertionTemplate)
          Update an existing Assertion Template
 IPolicySubjectAttachmentResult updateAttachmentEntries(IPolicySubject polSubject, List<IPolicyReference> polRefs)
          This API is equivalent to calling deleteAttachmentEntries(String resourcePattern) and calling addAttachmentEntries(String resourcePattern, List<IPolicyReference> polRefs)
 IPolicySubjectAttachmentResult updateAttachmentEntries(IPolicySubject polSubject, List<IPolicyReference> polRefs, boolean runSubjVal)
          This method is similar to @see IUpdateService#updateAttachmentEntries(IPolicySubject, List) The variation of this method is it performs Policy subject validation
 List<IPolicyAttachmentResult> updateAttachmentEntries(String resourcePattern, List<IPolicyReference> polRefs)
          
 List<IPolicy> updatePolicies(List<IPolicy> policies)
          Updates policies to the backend datastore
 IPolicy updatePolicy(IPolicy policy)
          Updates a policy to the backend datastore

 

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

 

Constructor Detail

UpdateServiceDelegate

public UpdateServiceDelegate(IStringUpdateService strUpdateService)

Method Detail

createPolicy

public IPolicy createPolicy(IPolicy policy)
                     throws PolicyManagerException
Adds a new policy to the backend datastore
Specified by:
createPolicy in interface IUpdateService
Parameters:
policy - object to add
Returns:
The newly created policy object
Throws:
PolicyManagerException

createPolicy

public List<IPolicy> createPolicy(List<IPolicy> polList)
                           throws PolicyManagerException
Bulk creation of policies
Specified by:
createPolicy in interface IUpdateService
Parameters:
polList - A list of IPolicy objects representing the polices to be created
Throws:
PolicyManagerException

updatePolicy

public IPolicy updatePolicy(IPolicy policy)
                     throws PolicyManagerException
Updates a policy to the backend datastore
Specified by:
updatePolicy in interface IUpdateService
Returns:
The modified policy objects
Throws:
PolicyManagerException

updatePolicies

public List<IPolicy> updatePolicies(List<IPolicy> policies)
                             throws PolicyManagerException
Updates policies to the backend datastore
Specified by:
updatePolicies in interface IUpdateService
Returns:
List of the modified policy objects
Throws:
PolicyManagerException

deletePolicy

public void deletePolicy(IPolicy policy)
                  throws PolicyManagerException
Deletes a policy to the backend datastore
Specified by:
deletePolicy in interface IUpdateService
Parameters:
policy - object
Throws:
PolicyManagerException

deletePolicy

public void deletePolicy(String policyName)
                  throws PolicyManagerException
Deletes a policy to the backend datastore
Specified by:
deletePolicy in interface IUpdateService
Throws:
PolicyManagerException

createAssertionTemplate

public IAssertionTemplate createAssertionTemplate(IAssertionTemplate assertionTemplate)
                                           throws PolicyManagerException
Adds a new Assertion template to the backend datastore
Specified by:
createAssertionTemplate in interface IUpdateService
Parameters:
assertionTemplate - The AssertionTemplate object to add
Throws:
PolicyManagerException

deleteAssertionTemplate

public void deleteAssertionTemplate(IAssertionTemplate assertionTemplate)
                             throws PolicyManagerException
Delete an Assertion template from backend datastore
Specified by:
deleteAssertionTemplate in interface IUpdateService
Parameters:
assertionTemplate - The assertion Template object to be deleted
Throws:
PolicyManagerException

deleteAssertionTemplate

public void deleteAssertionTemplate(String templateName)
                             throws PolicyManagerException
Delete an Assertion template from backend datastore
Specified by:
deleteAssertionTemplate in interface IUpdateService
Parameters:
templateName - Name of the assertion template to be deleted
Throws:
PolicyManagerException

updateAssertionTemplate

public IAssertionTemplate updateAssertionTemplate(IAssertionTemplate assertionTemplate)
                                           throws PolicyManagerException
Update an existing Assertion Template
Specified by:
updateAssertionTemplate in interface IUpdateService
Parameters:
assertionTemplate - The Assertion template object to be modified
Throws:
PolicyManagerException

promotePolicyToTip

public IPolicy promotePolicyToTip(String policyName,
                                  long version)
                           throws PolicyManagerException
Promote a previous policy version to the latest.
Specified by:
promotePolicyToTip in interface IUpdateService
Parameters:
policyName - Name the of policy to be updated
version - The version to be promoted to the tip
Returns:
Latest (promoted) version of the policy
Throws:
PolicyManagerException

deletePolicyVersions

public void deletePolicyVersions(String policyName,
                                 List<Long> versionNumbers)
                          throws PolicyManagerException
Delete all the specified versions of a policy
Specified by:
deletePolicyVersions in interface IUpdateService
Parameters:
policyName - Name of the policy whose versions are to be deleted
Throws:
PolicyManagerException

promoteAssertionTemplateToTip

public IAssertionTemplate promoteAssertionTemplateToTip(String assertionTemplateName,
                                                        long version)
                                                 throws PolicyManagerException
Promote a previous policy version to the latest.
Specified by:
promoteAssertionTemplateToTip in interface IUpdateService
version - The version to be promoted to the tip
Returns:
Latest (promoted) version of the policy
Throws:
PolicyManagerException

deleteAssertionTemplateVersions

public void deleteAssertionTemplateVersions(String assertionTemplateName,
                                            List<Long> versionNumbers)
                                     throws PolicyManagerException
Delete all the specified versions of an assertion template
Specified by:
deleteAssertionTemplateVersions in interface IUpdateService
Parameters:
assertionTemplateName - Name of the assertion template whose versions are to be deleted
versionNumbers - List of (long) versions numbers to be deleted
Throws:
PolicyManagerException

deleteAllPolicies

public void deleteAllPolicies()
                       throws PolicyManagerException
PERMENENTLY deletes ALL policies from the datastore Policies once deleted cannot be retrived
Specified by:
deleteAllPolicies in interface IUpdateService
Throws:
PolicyManagerException

deletePolicies

public void deletePolicies(List<String> polNameList)
                    throws PolicyManagerException
Delete all the policies corresponding to the policy names passed
Specified by:
deletePolicies in interface IUpdateService
Parameters:
polNameList - List of policy names to be be deleted
Throws:
PolicyManagerException

deleteAllAssertionTemplates

public void deleteAllAssertionTemplates()
                                 throws PolicyManagerException
PERMENENTLY deletes ALL assertion templates from the datastore Assertion templates once deleted cannot be retrived
Specified by:
deleteAllAssertionTemplates in interface IUpdateService
Throws:
PolicyManagerException

deleteAssertionTemplates

public void deleteAssertionTemplates(List<String> assertionTemplateNames)
                              throws PolicyManagerException
Delete all the policies corresponding to the policy names passed
Specified by:
deleteAssertionTemplates in interface IUpdateService
Parameters:
assertionTemplateNames - List of assertion template names to be be deleted
Throws:
PolicyManagerException

addAttachmentEntry

public void addAttachmentEntry(IPolicy policy,
                               List<String> resourcePatterns)
                        throws PolicyManagerException
Throws:
PolicyManagerException

removeAttachmentEntry

public void removeAttachmentEntry(IPolicy policy,
                                  List<String> resourcePatterns)
                           throws PolicyManagerException
Throws:
PolicyManagerException

addAttachmentEntries

public List<IPolicyAttachmentResult> addAttachmentEntries(String resourcePattern,
                                                          List<IPolicyReference> polRefs)
                                                   throws PolicyManagerException
Throws:
PolicyManagerException

addAttachmentEntries

public IPolicySubjectAttachmentResult addAttachmentEntries(IPolicySubject polSubject,
                                                           List<IPolicyReference> polRefs)
                                                    throws PolicyManagerException
Given a policy subject - represented by a resource pattern and a list of policy references for the policy subject - add attachments - if the referenced Policy does not exist - then that entry will be ignored (will not thrown an exception) and processing will continue Duplicate policy references are handled automatically as well as duplicate calls for the same resource pattern. Note: Duplicate policy references in the polRefs list if the Policy Reference is valid will result in a status ATTACHMENT_STATUS_ENUM.success.
Specified by:
addAttachmentEntries in interface IUpdateService
Parameters:
polSubject - policy subject to be added
polRefs - Policy reference the policy subject needs to be associated with
Returns:
IPolicySubjectAttachmentResult IPolicySubjectAttachmentResult.getAttachmentResults() has the following semantics: returns null if polRefs is null returns null if polSubject is null returns null if polSubject.getResourcePattern() is null or empty string List size is 0 if polRefs size is 0
Throws:
PolicyManagerException

deleteAttachmentEntries

public List<IPolicyAttachmentResult> deleteAttachmentEntries(String resourcePattern,
                                                             List<IPolicyReference> polRefs)
                                                      throws PolicyManagerException
Throws:
PolicyManagerException

deleteAttachmentEntries

public IPolicySubjectAttachmentResult deleteAttachmentEntries(IPolicySubject polSubject,
                                                              List<IPolicyReference> polRefs)
                                                       throws PolicyManagerException
Disassociate a policy subject, represented by a resource pattern, with all policies pointed to by the passed policy reference list Given a policy subject - represented by a resource pattern and a list of policy references for the policy subject - deletes all the attachment entries for the corresponding combination of <resource pattern, IPolicyReference>. If the referenced Policy does not exist but a Policy Attachment for the Policy exists, then it will be remove the resource pattern from the corresponding Policy Attachment. The API will not throw an exception if the Policy does not exist. Duplicate policy references are handled automatically. If the polRefs contains duplicate Policy References then the IPolicyAttachmentResult will have status ATTACHMENT_STATUS_ENUM.ignore for all duplicates. The behavior is undefined for duplicate API invocations. Note: Duplicate policy references in the polRefs list if the Policy Reference is valid will result in a status ATTACHMENT_STATUS_ENUM.success.
Specified by:
deleteAttachmentEntries in interface IUpdateService
Parameters:
polSubject - Policy subject to be removed
polRefs - Policies from which the subject is to be detached
Returns:
IPolicySubjectAttachmentResult IPolicySubjectAttachmentResult.getAttachmentResults() has the following semantics: returns null if polRefs is null returns null if polSubject is null returns null if polSubject.getResourcePattern() is null or empty string List size is 0 if polRefs size is 0
Throws:
PolicyManagerException

deleteAttachmentEntries

public void deleteAttachmentEntries(String resourcePattern)
                             throws PolicyManagerException
Disassociate a policy subject, represented by a resource pattern, with all policies that it may be associated with.
Specified by:
deleteAttachmentEntries in interface IUpdateService
Parameters:
resourcePattern - Policy subject to be removed
Throws:
PolicyManagerException

updateAttachmentEntries

public List<IPolicyAttachmentResult> updateAttachmentEntries(String resourcePattern,
                                                             List<IPolicyReference> polRefs)
                                                      throws PolicyManagerException
Throws:
PolicyManagerException

updateAttachmentEntries

public IPolicySubjectAttachmentResult updateAttachmentEntries(IPolicySubject polSubject,
                                                              List<IPolicyReference> polRefs)
                                                       throws PolicyManagerException
This API is equivalent to calling deleteAttachmentEntries(String resourcePattern) and calling addAttachmentEntries(String resourcePattern, List<IPolicyReference> polRefs)
Specified by:
updateAttachmentEntries in interface IUpdateService
Returns:
IPolicySubjectAttachmentResult - IPolicySubjectAttachmentResult.getAttachmentResults() has the following semantics: returns null if polRefs is null returns null if polSubject is null returns null if polSubject.getResourcePattern() is null or empty string List size is 0 if polRefs size is 0
Throws:
PolicyManagerException

updateAttachmentEntries

public IPolicySubjectAttachmentResult updateAttachmentEntries(IPolicySubject polSubject,
                                                              List<IPolicyReference> polRefs,
                                                              boolean runSubjVal)
                                                       throws PolicyManagerException
This method is similar to @see IUpdateService#updateAttachmentEntries(IPolicySubject, List) The variation of this method is it performs Policy subject validation
Specified by:
updateAttachmentEntries in interface IUpdateService
Returns:
Throws:
PolicyManagerException

deleteAllAttachments

public void deleteAllAttachments()
                          throws PolicyManagerException
Deletes all policy attachments from data store
Specified by:
deleteAllAttachments in interface IUpdateService
Throws:
PolicyManagerException

areTransactionsSupported

public boolean areTransactionsSupported()
                                 throws PolicyManagerException
This methods lets you know if transactionality is supported by the backed datastore used by the policymanager. This method should be consulted before making any method calls that call any APIs dealing with bulk operations (create/update/delete)
Specified by:
areTransactionsSupported in interface IUpdateService
Returns:
True if the back end datastore supports transactions, false otherwise
Throws:
PolicyManagerException

deleteAttachmentEntries

public void deleteAttachmentEntries(List<String> policySubject)
                             throws PolicyManagerException
Description copied from interface: IUpdateService
Disassociate a policy subject, represented by a resource pattern, with all policies that it may be associated with.
Specified by:
deleteAttachmentEntries in interface IUpdateService
Parameters:
policySubject - list of Policy subject to be removed
Throws:
PolicyManagerException

getSubject

public Subject getSubject()

setSubject

public void setSubject(Subject subject)

Skip navigation links

Oracle Fusion Middleware Java API Reference for Oracle Web Services Manager
11g (11.1.1)

E10689-01


Copyright © 2007, 2009, Oracle and/or its affiliates. All rights reserved.