org.opensaml.saml1.core.Assertion Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of opensaml Show documentation
The OpenSAML-J library provides tools to support developers working with the Security Assertion Markup Language (SAML).
The newest version!
/*
 * Licensed to the University Corporation for Advanced Internet Development, 
 * Inc. (UCAID) under one or more contributor license agreements.  See the 
 * NOTICE file distributed with this work for additional information regarding
 * copyright ownership. The UCAID licenses this file to You under the Apache 
 * License, Version 2.0 (the "License"); you may not use this file except in 
 * compliance with the License.  You may obtain a copy of the License at
 *
 *    http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

package org.opensaml.saml1.core;

import java.util.List;

import javax.xml.namespace.QName;

import org.joda.time.DateTime;
import org.opensaml.common.SAMLVersion;
import org.opensaml.common.SignableSAMLObject;
import org.opensaml.common.xml.SAMLConstants;

/**
 * This interface defines how the object representing a SAML 1  Assertion  element behaves.
 */
public interface Assertion extends SignableSAMLObject, Evidentiary {

    /** Element name, no namespace. */
    public final static String DEFAULT_ELEMENT_LOCAL_NAME = "Assertion";
    
    /** Default element name */
    public final static QName DEFAULT_ELEMENT_NAME = new QName(SAMLConstants.SAML1_NS, DEFAULT_ELEMENT_LOCAL_NAME, SAMLConstants.SAML1_PREFIX);
    
    /** Local name of the XSI type */
    public final static String TYPE_LOCAL_NAME = "AssertionType"; 
        
    /** QName of the XSI type */
    public final static QName TYPE_NAME = new QName(SAMLConstants.SAML1_NS, TYPE_LOCAL_NAME, SAMLConstants.SAML1_PREFIX);

    /** Name for the attribute which defines Major Version (attribute's value must be 1) */
    public final static String MAJORVERSION_ATTRIB_NAME = "MajorVersion";

    /** Name for the attribute which defines Minor Version. */
    public final static String MINORVERSION_ATTRIB_NAME = "MinorVersion";

    /** Name for the attribute which defines Assertion ID */
    public final static String ASSERTIONID_ATTRIB_NAME = "AssertionID";

    /** Name for the attribute which defines Issuer */
    public final static String ISSUER_ATTRIB_NAME = "Issuer";

    /** Name for the attribute which defines the issue instant */
    public final static String ISSUEINSTANT_ATTRIB_NAME = "IssueInstant";

    /** Name for the attribute which defines the Issue Instant. */
    public final static String ID_ATTRIB_NAME = "AssertionID";

    /* attributes */

    /**
     * Get the MajorVersion attribute.
     * 
     * @return The stored MajorVersion
     */
    public int getMajorVersion();
    
    /**
     * Get the MinorVersion attribute.
     * 
     * @return The stored MinorVersion
     */
    public int getMinorVersion();
    
    /**
     * Sets the SAML version of this assertion.
     * 
     * @param version the SAML version of this assertion
     */
    public void setVersion(SAMLVersion version);

    /**
     * Get the Issuer (which is an attribute) .
     * 
     * @return the Issuer
     */
    public String getIssuer();

    /**
     * Set the Issuer (attribute).
     * 
     * @param Issuer the value to set
     */
    public void setIssuer(String Issuer);

    /**
     * Get the IssueInstant (attribute).
     * 
     * @return the Issue Instant (as a Date)
     */
    public DateTime getIssueInstant();

    /** Set the ID */
    public String getID();
    
    /** Get the ID */
    public void setID(String id);
    
    /**
     * Set the IssueInstance (attribute).
     * 
     * @param issueInstant the issue instant value to set
     */
    public void setIssueInstant(DateTime issueInstant);

    /* Singleton Elements */

    /**
     * Return the (singleton) Object, representing the  Conditions  sub element.
     * 
     * @return the Conditions object.
     */
    public Conditions getConditions();

    /**
     * Set the Object representing the  Conditions  Sub element.
     * 
     * @param conditions the condition to List
     * 
     * @throws IllegalArgumentException if the condition has already been set into another object
     */
    public void setConditions(Conditions conditions) throws IllegalArgumentException;

    /**
     * advice is a (singleton) Object, representing the  Advice  sub element
     * 
     * @return the advice object in this assertion
     */
    public Advice getAdvice();

    /**
     * Set the Object representing the  Advice  sub element.
     * 
     * @param advice the object to set
     * 
     * @throws IllegalArgumentException if the object has already been put into another SAMLObject
     */
    public void setAdvice(Advice advice) throws IllegalArgumentException;

    /* Multiple Elements */

    /**
     * Return the List representing all the  Statement  sub elements.
     * 
     * @return the List representing all the statements
     */
    public List getStatements();

    /**
     * Return the List representing all the  Statement  sub elements with a given schema type or element name.
     * 
     * @param typeOrName the schema type or element name
     * 
     * @return the List representing all the statements
     */
    public List getStatements(QName typeOrName);

    /**
     * Return the List representing all the  SubjectStatement  sub elements.
     * 
     * @return all the SubjectStatements
     */
    public List getSubjectStatements();

    /**
     * Return the List representing all the  AuthenticationStatement  sub elements.
     * 
     * @return all the AuthenticationStatements
     */
    public List getAuthenticationStatements();

    /**
     * Return the List representing all the  AuthorizationStatement  sub elements.
     * 
     * @return all the authorizationDecisionStatements.
     */
    public List getAuthorizationDecisionStatements();

    /**
     * Return all the  AttributeStatement  elements
     * 
     * @return all the attributeStatements
     */
    public List getAttributeStatements();
}