context/impl/ResultImpl.java

a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster/**
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER.
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster *
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster * Copyright (c) 2007 Sun Microsystems Inc. All Rights Reserved
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster *
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster * The contents of this file are subject to the terms
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster * of the Common Development and Distribution License
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster * (the License). You may not use this file except in
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster * compliance with the License.
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster *
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster * You can obtain a copy of the License at
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster * https://opensso.dev.java.net/public/CDDLv1.0.html or
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster * opensso/legal/CDDLv1.0.txt
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster * See the License for the specific language governing
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster * permission and limitations under the License.
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster *
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster * When distributing Covered Code, include this CDDL
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster * Header Notice in each file and include the License file
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster * at opensso/legal/CDDLv1.0.txt.
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster * If applicable, add the following below the CDDL Header,
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster * with the fields enclosed by brackets [] replaced by
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster * your own identifying information:
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster * "Portions Copyrighted [year] [name of copyright owner]"
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster *
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster * $Id: ResultImpl.java,v 1.4 2008/11/10 22:57:05 veiming Exp $
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster *
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster */
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Fosterpackage com.sun.identity.xacml.context.impl;
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Fosterimport com.sun.identity.shared.xml.XMLUtils;
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Fosterimport com.sun.identity.xacml.common.XACMLConstants;
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Fosterimport com.sun.identity.xacml.common.XACMLException;
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Fosterimport com.sun.identity.xacml.common.XACMLSDKUtils;
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Fosterimport com.sun.identity.xacml.context.ContextFactory;
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Fosterimport com.sun.identity.xacml.context.Result;
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Fosterimport com.sun.identity.xacml.context.Decision;
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Fosterimport com.sun.identity.xacml.context.Status;
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Fosterimport com.sun.identity.xacml.policy.Obligations;
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Fosterimport com.sun.identity.xacml.policy.PolicyFactory;
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Fosterimport java.util.ArrayList;
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Fosterimport java.util.Iterator;
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Fosterimport java.util.List;
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Fosterimport org.w3c.dom.Document;
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Fosterimport org.w3c.dom.Element;
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Fosterimport org.w3c.dom.Node;
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Fosterimport org.w3c.dom.NodeList;
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster/**
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster * The <code>Result</code> element contains decision, status and obligations
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster * per resource id
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster *
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster * <p/>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster * schema
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster * <pre>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster *  &lt;xs:complexType name="ResultType">
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster *      &lt;xs:sequence>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster *          &lt;xs:element ref="xacml-context:Decision"/>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster *          &lt;xs:element ref="xacml-context:Status" minOccurs="0"/>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster *          &lt;xs:element ref="xacml:Obligations" minOccurs="0"/>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster *      &lt;xs:sequence>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster *      &lt;xs:attribute name="ResourceId" type="xs:string" use="optional"/>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster *  &lt;xs:complexType>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster *
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster * </pre>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster */
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Fosterpublic class ResultImpl implements Result {
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster    private String resourceId = null; //optional
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster    private Decision decision = null; //required
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster    private Status status = null; //optional
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster    private Obligations obligations = null; //optional
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster    private boolean mutable = true;
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster    /**
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster     * Constructs a <code>Result</code> object
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster     */
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster    public ResultImpl() throws XACMLException {
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster    }
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster    /**
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster     * Constructs a <code>Result</code> object from an XML string
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster     *
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster     * @param xml string representing a <code>Result</code> object
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster     * @throws SAMLException if the XML string could not be processed
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster     */
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster    public ResultImpl(String xml) throws XACMLException {
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster        Document document = XMLUtils.toDOMDocument(xml, XACMLSDKUtils.debug);
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster        if (document != null) {
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster            Element rootElement = document.getDocumentElement();
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster            processElement(rootElement);
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster            makeImmutable();
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster        } else {
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster            XACMLSDKUtils.debug.error(
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster                "ResultImpl.processElement(): invalid XML input");
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster            throw new XACMLException(
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster                XACMLSDKUtils.xacmlResourceBundle.getString(
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster                "errorObtainingElement"));
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster        }
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster    }
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster    /**
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster     * Constructs a <code>Result</code> object from an XML DOM element
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster     *
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster     * @param element XML DOM element representing a <code>Result</code>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster     * object
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster     *
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster     * @throws SAMLException if the DOM element could not be processed
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster     */
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster    public ResultImpl(Element element) throws XACMLException {
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster        processElement(element);
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster        makeImmutable();
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster    }
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster    /**
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster     * Returns <code>resourceId</code> of this object
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster     * @return  <code>resourceId</code> of this object
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster     */
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster    public String getResourceId() {
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster        return resourceId;
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster    }
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster    /**
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster     * Sets <code>resourceId</code> of this object
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster     * @param resourceId <code>resourceId</code> of this object
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster     * @exception XACMLException if the object is immutable
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster     */
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster    public void setResourceId(String resourceId) throws XACMLException {
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster        if (!mutable) {
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster            throw new XACMLException(
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster                XACMLSDKUtils.xacmlResourceBundle.getString("objectImmutable"));
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster        }
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster        this.resourceId = resourceId;
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster    }
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster    /**
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster     * Returns the <code>Decision</code> of this object
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster     *
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster     * @return the <code>Decision</code> of this object
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster     */
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster    public Decision getDecision() {
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster        return decision;
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster    }
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster    /**
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster     * Sets the <code>Decision</code> of this object
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster     *
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster     * @exception XACMLException if the object is immutable
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster     *
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster     */
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster    public void setDecision(Decision decision) throws XACMLException {
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster        if (!mutable) {
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster            throw new XACMLException(
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster                XACMLSDKUtils.xacmlResourceBundle.getString("objectImmutable"));
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster        }
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster        if (decision == null) {
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster            throw new XACMLException(
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster                XACMLSDKUtils.xacmlResourceBundle.getString("null_not_valid"));
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster        }
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster        this.decision = decision;
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster    }
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster    /**
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster     * Returns the <code>Status</code> of this object
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster     *
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster     * @return the <code>Status</code> of this object
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster     */
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster    public Status getStatus() {
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster        return status;
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster    }
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster    /**
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster     * Sets the <code>Status</code> of this object
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster     *
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster     * @exception XACMLException if the object is immutable
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster     */
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster    public void setStatus(Status status) throws XACMLException {
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster        if (!mutable) {
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster            throw new XACMLException(
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster                XACMLSDKUtils.xacmlResourceBundle.getString("objectImmutable"));
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster        }
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster        this.status = status;
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster    }
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster    /**
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster     * Returns the <code>Obligations</code> of this object
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster     *
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster     * @return the <code>Obligations</code> of this object
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster     */
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster    public Obligations getObligations() {
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster        return obligations;
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster    }
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster    /**
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster     * Sets the <code>Obligations</code> of this object
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster     * @param obligations <code>Obligations</code> to set
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster     *
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster     * @exception XACMLException if the object is immutable
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster     */
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster    public void setObligations(Obligations obligations) throws XACMLException {
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster        this.obligations = obligations;
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster    }
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster   /**
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster    * Returns a string representation of this object
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster    *
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster    * @return a string representation of this object
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster    * @exception XACMLException if conversion fails for any reason
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster    */
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster    public String toXMLString() throws XACMLException {
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster        return this.toXMLString(true, false);
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster    }
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster   /**
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster    * Returns a string representation of this object
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster    * @param includeNSPrefix Determines whether or not the namespace qualifier
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster    *        is prepended to the Element when converted
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster    * @param declareNS Determines whether or not the namespace is declared
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster    *        within the Element.
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster    * @return a string representation of this object
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster    * @exception XACMLException if conversion fails for any reason
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster     */
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster    public String toXMLString(boolean includeNSPrefix, boolean declareNS)
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster            throws XACMLException {
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster        StringBuffer sb = new StringBuffer(2000);
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster        String nsDeclaration = "";
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster        String nsPrefix = "";
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster        if (declareNS) {
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster            nsDeclaration = XACMLConstants.CONTEXT_NS_DECLARATION;
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster        }
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster        if (includeNSPrefix) {
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster            nsPrefix = XACMLConstants.CONTEXT_NS_PREFIX + ":";
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster        }
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster        sb.append("<").append(nsPrefix).append(XACMLConstants.RESULT)
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster                .append(nsDeclaration);
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster        sb.append(" ");
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster        if (resourceId != null) {
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster            sb.append(XACMLConstants.RESOURCE_ID)
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster                .append("=")
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster                .append(XACMLSDKUtils.quote(resourceId));
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster        }
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster        sb.append(">\n");
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster        if (decision != null) {
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster            sb.append(decision.toXMLString(includeNSPrefix, false));
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster        }
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster        if (status != null) {
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster            sb.append(status.toXMLString(includeNSPrefix, false));
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster        }
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster        if (obligations != null) {
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster            sb.append(obligations.toXMLString(includeNSPrefix, true));
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster        }
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster        sb.append("</").append(nsPrefix).append(XACMLConstants.RESULT)
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster                .append(">\n");
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster        return sb.toString();
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster    }
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster   /**
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster    * Checks if the object is mutable
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster    *
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster    * @return <code>true</code> if the object is mutable,
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster    *         <code>false</code> otherwise
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster    */
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster    public boolean isMutable() {
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster        return mutable;
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster    }
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster   /**
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster    * Makes the object immutable
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster    */
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster    public void makeImmutable() {
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster        if (mutable) {
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster            if (decision != null) {
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster                decision.makeImmutable();
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster            }
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster            if (status != null) {
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster                status.makeImmutable();
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster            }
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster            mutable = false;
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster        }
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster    }
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster    private void processElement(Element element) throws XACMLException {
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster        if (element == null) {
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster            XACMLSDKUtils.debug.error(
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster                "ResultImpl.processElement(): invalid root element");
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster            throw new XACMLException(
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster                XACMLSDKUtils.xacmlResourceBundle.getString(
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster                "invalid_element"));
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster        }
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster        String elemName = element.getLocalName();
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster        if (elemName == null) {
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster            XACMLSDKUtils.debug.error(
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster                "ResultImpl.processElement(): local name missing");
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster            throw new XACMLException(XACMLSDKUtils.xacmlResourceBundle.getString(
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster                "missing_local_name"));
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster        }
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster        if (!elemName.equals(XACMLConstants.RESULT)) {
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster            XACMLSDKUtils.debug.error(
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster                "ResultImpl.processElement(): invalid local name " + elemName);
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster            throw new XACMLException(XACMLSDKUtils.xacmlResourceBundle.getString(
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster                "invalid_local_name"));
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster        }
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster        String resourceIdValue
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster                = element.getAttribute(XACMLConstants.RESOURCE_ID);
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster        if ((resourceIdValue != null) || (resourceIdValue.length() != 0)) {
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster            resourceId = resourceIdValue;
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster        }
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster        NodeList nodes = element.getChildNodes();
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster        int numOfNodes = nodes.getLength();
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster        List childElements = new ArrayList();
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster        int i = 0;
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster        while (i < numOfNodes) {
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster            Node child = (Node) nodes.item(i);
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster            if (child.getNodeType() == Node.ELEMENT_NODE) {
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster                childElements.add(child);
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster            }
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster           i++;
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster        }
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster        int childCount = childElements.size();
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster        if (childCount < 1) {
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster            XACMLSDKUtils.debug.error(
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster                "ResultImpl.processElement(): invalid child element count: "
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster                        + childCount);
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster            throw new XACMLException(XACMLSDKUtils.xacmlResourceBundle.getString(
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster                "invalid_child_count")); //FIXME: add i18n key
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster        } else if (childCount > 3) {
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster            XACMLSDKUtils.debug.error(
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster                "ResultImpl.processElement(): invalid child element count: "
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster                        + childCount);
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster            throw new XACMLException(XACMLSDKUtils.xacmlResourceBundle.getString(
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster                "invalid_child_count")); //FIXME: add i18n key
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster        }
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster        //process decision element
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster        Element firstChild = (Element)childElements.get(0);
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster        String firstChildName = firstChild.getLocalName();
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster        if (firstChildName.equals(XACMLConstants.DECISION)) {
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster            decision =  ContextFactory.getInstance()
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster                    .createDecision(firstChild);
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster        } else {
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster            XACMLSDKUtils.debug.error(
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster                "ResultImpl.processElement(): invalid first child element: "
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster                        + firstChildName);
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster            throw new XACMLException(XACMLSDKUtils.xacmlResourceBundle.getString(
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster                "invalid_first_child")); //FIXME: add i18n key
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster        }
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster        //process status element
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster        if (childCount > 1) {
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster            Element secondChild = (Element)childElements.get(1);
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster            String secondChildName = secondChild.getLocalName();
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster            if (secondChildName.equals(XACMLConstants.STATUS)) {
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster                status =  ContextFactory.getInstance()
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster                        .createStatus(secondChild);
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster            } else if (secondChildName.equals(XACMLConstants.OBLIGATIONS)) {
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster                obligations =  PolicyFactory.getInstance()
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster                        .createObligations(secondChild);
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster            } else {
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster                XACMLSDKUtils.debug.error(
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster                    "ResultImpl.processElement(): invalid second child element: "
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster                            + secondChildName);
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster                throw new XACMLException(
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster                    XACMLSDKUtils.xacmlResourceBundle.getString(
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster                    "invalid_second_child")); //FIXME: add i18n key
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster            }
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster            if (childCount > 2) {
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster                Element thirdChild = (Element)childElements.get(2);
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster                String thirdChildName = thirdChild.getLocalName();
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster                if (thirdChildName.equals(XACMLConstants.OBLIGATIONS)
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster                        && (obligations == null) ) {
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster                    obligations =  PolicyFactory.getInstance()
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster                            .createObligations(thirdChild);
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster                } else {
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster                    XACMLSDKUtils.debug.error(
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster                        "ResultImpl.processElement(): invalid third child element: "
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster                                + thirdChildName);
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster                    throw new XACMLException(
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster                        XACMLSDKUtils.xacmlResourceBundle.getString(
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster                        "invalid_third_child")); //FIXME: add i18n key
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster                }
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster            }
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster            if (childCount > 3) {
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster                Element thirdChild = (Element)childElements.get(3);
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster                String thirdChildName = thirdChild.getLocalName();
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster                XACMLSDKUtils.debug.error(
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster                    "ResultImpl.processElement(): invalid third child element: "
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster                            + thirdChildName);
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster                throw new XACMLException(
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster                    XACMLSDKUtils.xacmlResourceBundle.getString(
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster                    "invalid_third_child")); //FIXME: add i18n key
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster            }
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster        }
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster    }
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster}