issuedonbehalfof.java

一个完整的XACML工程,学习XACML技术的好例子!

/*
* Copyright (c) 2006, University of Kent
* All rights reserved.
*
* Redistribution and use in source and binary forms, with or without 
* modification, are permitted provided that the following conditions are met:
*
* Redistributions of source code must retain the above copyright notice, this 
* list of conditions and the following disclaimer.
* 
* Redistributions in binary form must reproduce the above copyright notice, 
* this list of conditions and the following disclaimer in the documentation 
* and/or other materials provided with the distribution. 
*
* 1. Neither the name of the University of Kent nor the names of its 
* contributors may be used to endorse or promote products derived from this 
* software without specific prior written permission. 
*
* 2. THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS  
* IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
* THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR 
* PURPOSE ARE DISCLAIMED. 
*
* 3. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE 
* LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR 
* CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF 
* SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS 
* INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN 
* CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) 
* ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
* POSSIBILITY OF SUCH DAMAGE.
*
* 4. YOU AGREE THAT THE EXCLUSIONS IN PARAGRAPHS 2 AND 3 ABOVE ARE REASONABLE
* IN THE CIRCUMSTANCES.  IN PARTICULAR, YOU ACKNOWLEDGE (1) THAT THIS
* SOFTWARE HAS BEEN MADE AVAILABLE TO YOU FREE OF CHARGE, (2) THAT THIS
* SOFTWARE IS NOT "PRODUCT" QUALITY, BUT HAS BEEN PRODUCED BY A RESEARCH
* GROUP WHO DESIRE TO MAKE THIS SOFTWARE FREELY AVAILABLE TO PEOPLE WHO WISH
* TO USE IT, AND (3) THAT BECAUSE THIS SOFTWARE IS NOT OF "PRODUCT" QUALITY
* IT IS INEVITABLE THAT THERE WILL BE BUGS AND ERRORS, AND POSSIBLY MORE
* SERIOUS FAULTS, IN THIS SOFTWARE.
*
* 5. This license is governed, except to the extent that local laws
* necessarily apply, by the laws of England and Wales.
*/

package issrg.ac.attributes;
import iaik.asn1.*;
import iaik.asn1.structures.*;
import iaik.utils.RFC2253NameParser;
import iaik.utils.RFC2253NameParserException;
import issrg.utils.RFC2253ParsingException;


/**
 *
 * @author  anhnt
 */
public class IssuedOnBehalfOf extends issrg.ac.Extension implements Cloneable {

    /**
     *The string stores the standard OID for the IssuedOnBehalfOf extension: 2.5.29.64
     */
    
    public static final String ISSUED_ON_BEHALF_OF_OID = "2.5.29.64"; 
    private GeneralName iobo;
    private String issuerDN;
    
    /**
   * This method registers this extension as an extension with a specific
   * OID. After it has been registered, Extensions can recognise 
   * the extension with this OID.
   */
    
    public static void registerMe() {
        issrg.ac.Extensions.registerExtension(ISSUED_ON_BEHALF_OF_OID, IssuedOnBehalfOf.class);
    }
    
  
    /** Creates a new instance of IssuedOnBehalfOf based on an 
     *existing IssuedOnBehalfOf extension
     *
     *@param e is an existing IssuedOnBehalfOf extension
     */
    
    public IssuedOnBehalfOf(IssuedOnBehalfOf e) throws iaik.asn1.CodingException {
      super(ISSUED_ON_BEHALF_OF_OID, e.isCritical(), e.getExtensionValue());
    }
    
    /** Creates a new instance of IssuedOnBehalfOf based on paramters.
     *
     *@param critical is a boolean value. It is a flag of the extension that tells
     *the criticality of the extension.
     *@param iobo is a GeneralName object that stores the ID of the requester.
     *@return an IssuedOnBehalfOf object.
     *
     */
    
    public IssuedOnBehalfOf (boolean critical, iaik.asn1.structures.GeneralName iobo) {
      super(ISSUED_ON_BEHALF_OF_OID, critical);
      setIssuedOnBehalfOf(iobo);
    }    
    
    public Object clone(){
        try {
            return new IssuedOnBehalfOf(this);
        } catch (iaik.asn1.CodingException ce) {
            return null;
        }
    }
    
    /**
     * This method constructs an IssuedOnBehalfOf extension based on an ASN1Object object
     *@param ao is the ASN1Object object that is used to construct the IssuedOnBehalfOf object.
     */
    
  public IssuedOnBehalfOf(ASN1Object ao) throws CodingException{
    super(ao);
  }
  
  /**
   * This method encodes the extension value of the IssuedOnBehalfOf object 
   *to an ASN1Object.
   *
   *@return an ASN1Object.
   */

  public ASN1Object encodeValue() throws CodingException{
    return iobo.toASN1Object();
      
  }

  /**
   *This methods decodes an ASN1Object to get an extension value of 
   *the IssuedOnBehalfOf object.
   *
   *@param ao is an ASN1Object to be decoded.
   */

  public void decodeValue(ASN1Object ao) throws CodingException {
    setIssuedOnBehalfOf(new GeneralName(ao));
  }

  
  /**
   *This method is used for setting the GeneralName of the requester.
   *
   *@param gn is the GeneralName of the requester. 
   */
  public void setIssuedOnBehalfOf(GeneralName gn){
    iobo=gn;
    issuerDN=((Name)iobo.getName()).getName();
  }
  
  /**
   *This method set the requester's DN. It also creates a GeneralName object
   *according to this DN.
   *@param dn is a string that represents the requester's DN.
   */

  public void setIssuerDN(String dn) throws iaik.utils.RFC2253NameParserException{
    issuerDN=dn;
    iobo=new GeneralName(GeneralName.directoryName, new iaik.utils.RFC2253NameParser(dn).parse());
  }
  
  /**
   *This method returns the requestor's DN
   *@return a string that represents the requestor's DN
   */
  
  public String getIssuerDN() {
      return issuerDN;
  }
  
  /**
   *This method returns a GeneralName object that represents the requestor
   *@return a GeneralName object
   */

  public GeneralName getIssuedOnBehalfOf(){
    return iobo;
  }
  
  /**
   *This method returns a string that represents the requestor's DN in the form: "IssuedOnBehalfOf" + requestor's DN
   *This method is used for debuging purposes
   *@return a string that represents the requestor's DN 
   */
  
  public String extensionValueToString(String indent){
    return "IssuedOnBehalfOf "+issuerDN;
  }
}