/**
 *  Generated with Tigerstripe(tm) Tigerstripe Workbench Feature 2.2.0.v20070419-1556-GFEkmUll2-0111E.
 *
 *  Tigerstripe(tm) is a registered trademark of Tigerstripe, Inc.
 *
 *  Plugin  : Sun Microsystems Inc./SunJavaSpecificationPlugin(1.0) (1.0)
 *
 *  DO NOT EDIT THIS CODE WAS AUTOMATICALLY GENERATED
 *
 *  Generated from source Tigerstipe Artifact :
 *        javax.oss.cbe.datatypes.Identification
 *
 *  Using template :
 *        templates/1.3/datatypeInterface.vm
 *
 * Copyright 2002-2007 The Members of the OSS through Java(TM) Initiative.
 * All rights reserved. Use is subject to license terms.
 */
package javax.oss.cbe.datatypes;

import javax.xml.bind.annotation.adapters.XmlJavaTypeAdapter;
import javax.xml.bind.annotation.XmlType;

import ossj.common.cbe.datatypes.IdentificationAdapter;

@XmlType
@XmlJavaTypeAdapter(value=IdentificationAdapter.class)

/**
 *  Public interface definition for Identification.
 *
 * An Identification type.
 * This is an abstract class to represent an object that can be used to identify managed objects of interest.
 * It is a convenient point to attach common semantics to different types of Identities
 * (e.g., a PartyIdentity vs. a ResourceIdentity vs. a ServiceIdentity).
 *
 */
public interface Identification 
	extends java.lang.Cloneable, java.io.Serializable {


    /**
     * Deep copy of this object.
     *
     * @return The cloned object
     */
    public Object clone();


    /**
     *
     * Attribute getter for type.
     *
     *
     * Cahnge the identity type with the given parameter
     *
     * @return the value of the type field.
     *
     */
    public java.lang.String getType( );


    /**
     * Attribute setter for type.
     *
     *
     * Cahnge the identity type with the given parameter
     * @param value - the value to use to set the type attribute.
     * @throws java.lang.IllegalArgumentException
     *         Thrown to report that a bad argument was provided to the method.
     *
     */
    public void setType(java.lang.String value)
        throws
        java.lang.IllegalArgumentException;

    /**
     *
     * Attribute getter for value.
     *
     *
     * Change the value of the identity using the given String
     *
     * @return the value of the value field.
     *
     */
    public java.lang.String getValue( );


    /**
     * Attribute setter for value.
     *
     *
     * Change the value of the identity using the given String
     * @param value - the value to use to set the value attribute.
     * @throws java.lang.IllegalArgumentException
     *         Thrown to report that a bad argument was provided to the method.
     *
     */
    public void setValue(java.lang.String value)
        throws
        java.lang.IllegalArgumentException;

    /**
     *
     * Attribute getter for validFor.
     *
     *
     * Change the scope of this identity
     *
     * @return the value of the validFor field.
     *
     */
    public javax.oss.cbe.datatypes.TimePeriod getValidFor( );

    /**
     *
     * Attribute Type getter for validFor.
     *
     * 
     * @return the valid set of types for the validFor field.
     *
     */
    public String[] attributeTypeForValidFor();

    /**
     * Attribute setter for validFor.
     *
     *
     * Change the scope of this identity
     * @param value - the value to use to set the validFor attribute.
     * @throws java.lang.IllegalArgumentException
     *         Thrown to report that a bad argument was provided to the method.
     *
     */
    public void setValidFor(javax.oss.cbe.datatypes.TimePeriod value)
        throws
        java.lang.IllegalArgumentException;


    /**
     * Factory method for TimePeriod.
     *
     * @param typeToMake - name of the type to be made
     * @return a new instance of TimePeriod
     *
     * @throws java.lang.IllegalArgumentException - if the argument is invalid
     */
    public javax.oss.cbe.datatypes.TimePeriod makeTimePeriod(String typeToMake)
        throws 
        java.lang.IllegalArgumentException;


}
