permisrole.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.
*/

/*
* Copyright (c) 2000-2005, University of Salford
* 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. 
*
* Neither the name of the University of Salford nor the names of its 
* contributors may be used to endorse or promote products derived from this 
* software without specific prior written permission. 
*
* 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. 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.
*/

package issrg.ac.attributes;

import issrg.ac.*;
import iaik.asn1.*;
import iaik.asn1.structures.*;

/**
 * This is a class for ASN.1 representation of the Permis Role value (singular). 
 * Note that the Attribute implementation will deal with multiple values and
 * instantiate an appropriate value object for each of those.
 *
 * <p>This Attribute cannot
 * be registered just with one OID, because it represents the whole class of 
 * attributes that are
 * just printable strings.
 */

public class PermisRole extends DistinctAttribute {
  /**
   * This is the string Name of the role of the given type
   */
  protected String roleValue = "";

  /**
   * Returns the Role Value.
   */
  public String getRoleValue(){
    return roleValue;
  }

  /**
   * Sets the Role Value.
   *
   * @param role - the role value
   */
  public void setRoleValue(String role){
    roleValue=role;
  }

  protected PermisRole() {
  }

  /**
   * This constructor builds a single PermisRole, given an ASN1Object of its
   * single value.
   *
   * @param ao - the ASN1Object representing a single value
   */
  public PermisRole(ASN1Object ao) throws CodingException{
    decode(ao);
  }

  /**
   * This constructor builds a PermisRole given a parsed AttributeValue.
   *
   * @param av - the AttributeValue that represents PermisRole
   */
  public PermisRole(issrg.ac.AttributeValue av) throws CodingException{
    decode(av.getRawAttribute());
  }

  /**
   * This constructor copies a given PermisRole.
   *
   * @param pr - the PermisRole to copy
   */
  public PermisRole(PermisRole pr){
    roleValue = pr.roleValue;
  }

  /**
   * This constructor creates a PermisRole given its String value.
   *
   * @param roleValue - the role value
   */
  public PermisRole(String roleValue){
    this.roleValue=roleValue;
  }

  /**
   * This method returns the ASN1Object representing PermisRole attribute value.
   *
   * @return PrintableString with the role value
   */
  public ASN1Object toASN1Object() throws CodingException{
    return new PrintableString(roleValue);
  }


  /**
   * This method decodes a given ASN1Object and upon successful decoding sets
   * the role value as contained in the ASN1Object.
   *
   * @param ao - ASN1Object to decode; must be a PrintableString
   */
  public void decode(ASN1Object ao) throws CodingException{
    super.decode(ao); // this will invoke the inherited decode method, which will set the fields required for this attribute to be handled as a usual AttributeValue
    if (!ao.isA(ASN.PrintableString)){
      throw new CodingException("RoleValue PrintableString was expected");
    }
    roleValue = (String)ao.getValue();
  }

  public String toString(String indent){
    return "roleValue = "+roleValue;
  }


  public Object clone(){
    return new PermisRole(this);
  }

  /**
   * This method registers PermisRole as a value of attributes with a specific
   * OID. After PermisRole has been registered, Attribute can recognise 
   * the attributes with this OID and use PermisRole to parse the individual 
   * values of that attribute.
   *
   * @param oid - the dotted form of the OID of the attribute that represents
   *   a PermisRole
   */  
  public static void registerMe(String oid){
    issrg.ac.Attribute.registerAttribute(oid, PermisRole.class);
  }
}