com.adobe.flashaccess.sdk.policyupdate
Class PolicyUpdateList

java.lang.Object
  extended by com.adobe.flashaccess.sdk.policyupdate.PolicyUpdateList

public class PolicyUpdateList
extends java.lang.Object

This class contains a read-only list of policies which have been revoked or updated. The list may contain PolicyRevocationEntry items, PolicyUpdateEntry items, or a combination thereof. Entries may be added or removed by creating a new PolicyUpdateList using PolicyUpdateListFactory. This class contains no public constructors. This class may only be instantiated via a PolicyUpdateListFactory.


Method Summary
 byte[] getBytes()
          Serializes and signs the policy update list contents.
 java.lang.String getIssuer()
          Retrieves the name of the entity which signed the policy update list.
 java.util.Date getNextUpdateDate()
          Retrieves the expiration date and time of this policy update list.
 java.util.List getRevocationEntries()
          Retrieves all the revoked entries.
 PolicyRevocationEntry getRevocationEntry(java.lang.String policyID)
          Retrieves the revocation entry for the policy.
 java.util.Date getThisUpdateDate()
          Retrieves the date and time this policy update list was created.
 java.util.List getUpdateEntries()
          Retrieves all the updated entries.
 PolicyUpdateEntry getUpdateEntry(java.lang.String policyID)
          Retrieves the updated policy for the given policy.
 boolean isRevoked(java.lang.String policyID)
          Determines if the given policy identifier is revoked and the revocation date is before the current date.
 boolean isUpdated(java.lang.String policyID)
          Determines if the given policy identifier has an updated policy.
 void verifySignature(java.security.cert.X509Certificate issuerCert)
          Verifies the policy update list was signed by the specified license server certificate.
 
Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Method Detail

getThisUpdateDate

public java.util.Date getThisUpdateDate()
Retrieves the date and time this policy update list was created.

Returns:
The creation date and time of this policy update list.

getNextUpdateDate

public java.util.Date getNextUpdateDate()
Retrieves the expiration date and time of this policy update list. The policy update list is considered invalid after this date. A new policy update list should be issued on or before the next update date.

Returns:
The expiration date and time of this policy update list.

getIssuer

public java.lang.String getIssuer()
Retrieves the name of the entity which signed the policy update list.

Returns:
The name of the entity which signed the policy update list.

isRevoked

public boolean isRevoked(java.lang.String policyID)
Determines if the given policy identifier is revoked and the revocation date is before the current date.

Parameters:
policyID - The identifier of the policy to query (case-sensitive).
Returns:
true if the policy identifier is revoked, false otherwise.
Throws:
ExpiredPolicyUpdateListException - if the Policy Update List has expired

isUpdated

public boolean isUpdated(java.lang.String policyID)
Determines if the given policy identifier has an updated policy.

Parameters:
policyID - The identifier of the policy to query (case-sensitive).
Returns:
true if the policy ID has an updated policy, false otherwise.
Throws:
ExpiredPolicyUpdateListException - if the Policy Update List has expired

getRevocationEntries

public java.util.List getRevocationEntries()
Retrieves all the revoked entries.

Returns:
List<PolicyRevocationEntry> containing all policies which have been revoked.
Throws:
ExpiredPolicyUpdateListException - if the Policy Update List has expired

getUpdateEntries

public java.util.List getUpdateEntries()
Retrieves all the updated entries.

Returns:
List<PolicyUpdateEntry> containing all policies which have been updated.
Throws:
ExpiredPolicyUpdateListException - if the Policy Update List has expired

getRevocationEntry

public PolicyRevocationEntry getRevocationEntry(java.lang.String policyID)
Retrieves the revocation entry for the policy. Returns null if the identifier is not on the list.

Parameters:
policyID - The identifier of the policy to query (case-sensitive).
Returns:
The policy revocation entry of the given policy identifier. If the policy identifier is not found, null is returned.
Throws:
ExpiredPolicyUpdateListException - if the Policy Update List has expired

getUpdateEntry

public PolicyUpdateEntry getUpdateEntry(java.lang.String policyID)
Retrieves the updated policy for the given policy. Returns null if the identifier is not in the list.

Parameters:
policyID - The identifier of the policy to query (case-sensitive).
Returns:
The policy update entry of the given policy identifier. If the policy identifier is not found, null is returned.
Throws:
ExpiredPolicyUpdateListException - if the Policy Update List has expired

getBytes

public byte[] getBytes()
Serializes and signs the policy update list contents.

Returns:
A signed serialized representation of a policy update list containing the revoked and updated policy entries supplied to this object.

verifySignature

public void verifySignature(java.security.cert.X509Certificate issuerCert)
                     throws PolicyUpdateListException
Verifies the policy update list was signed by the specified license server certificate.

Parameters:
issuerCert - The specified license server certificate.
Throws:
PolicyUpdateListException - if the signature is not valid.


[an error occurred while processing this directive] [an error occurred while processing this directive]