decisionrecord.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.pba.rbac;

import issrg.pba.PbaException;
import issrg.pba.rbac.*;
import issrg.pba.Credentials;
import java.io.*;
import java.util.*;

/**
 * This is the class for holding a granted decision record. It will be put 
 * into the retained ADI. 
 * it contains 6 fields: userID, creds, action, target, contextInstance, 
 * dateTime. 
 *
 * @author W. Xu
 * @version 0.1
 */

public class DecisionRecord {
  public DecisionRecord(){}

  /**
   * This constructor builds the object out of userID, creds, action, target, 
   * contextInstance, dateTime.
   *
   * @params userID is the userID
   * @params creds is the user Credentials
   * @params action is the user action
   * @params target is the requested target
   * @params contextInstance is the context name which the access request 
   *   belong to
   * @params dateTime is the time and date of the access request.
   */
  public DecisionRecord(String userID, Credentials creds,
            String action, String target, String contextInstance,
            Date dateTime){
      this.userID = userID;
      this.creds = creds;
      this.action = action;
      this.target = target;
      this.contextInstance = contextInstance;
      this.dateTime = dateTime; 
  }

  /**
   * This method returns the userDI.
   */
  public String getUserID(){
      return userID;
  }

  /**
   * This method returns the Credentials.
   */
  public Credentials getCreds() {
      return creds;
  }

  /**
   * This method returns the Action.
   */
  public String getAction(){
      return action;
  }

  /**
   * This method returns the Target.
   */
  public String getTarget(){
      return target;
  }

  /**
   * This method returns the context instance in String format.
   */
  public String getContextInstance(){ 
      return contextInstance;
  }

  /**
   * This method returns the DateTime as a Date class.
   */
  public Date getDateTime(){
      return dateTime;
  }

  /**
   * This method returns a string of contextInstance, userID, target, action. 
   */
  public String toString(){
      return " " + contextInstance + " " + userID + " " + target + " " + action;
  }

  public String userID;
  public Credentials creds;
  public String action, target;
  public String contextInstance;
  public Date dateTime; 

}