EDIT

/**

* Copyright (C) 2007 EDIT

* European Distributed Institute of Taxonomy 

* http://www.e-taxonomy.eu

* 

* The contents of this file are subject to the Mozilla Public License Version 1.1

* See LICENSE.TXT at the top of this package for the full license terms.

*/

package eu.etaxonomy.cdm.model.description;

import javax.xml.bind.annotation.XmlAccessorType;

import javax.xml.bind.annotation.XmlElement;

import javax.xml.bind.annotation.XmlElementWrapper;

import javax.xml.bind.annotation.XmlRootElement;

import javax.xml.bind.annotation.XmlType;

import org.hibernate.annotations.Cascade;

import org.hibernate.annotations.CascadeType;

 * {@link SpecimenDescription specimen descriptions} may contain categorical data.<BR>

 * {@link State state terms} such as "blue" or "white". If the color of petals of a

 * particular tree is described as "mostly blue" and "exceptionally white" two

 * {@link StateData state data} instances must be assigned to an instance of the

 * present class: the first one with the state "blue" and the {@link Modifier modifier}

 * Whenever more than one state data belongs to a categorical data they should be

 * interpreted as being related by the inclusive disjunction "or".  

 * This class corresponds partially to CodedDescriptionType according to

 * the SDD schema.

 * 

 * @version 1.0

 * @created 08-Nov-2007 13:06:15

 */

@XmlType(name = "CategoricalData", propOrder = {

    "orderRelevant",

    "states"

})

@XmlRootElement(name = "CategoricalData")

	private static final Logger logger = Logger.getLogger(CategoricalData.class);

	@XmlElementWrapper(name = "States")

	@XmlElement(name = "State")

	@IndexedEmbedded(depth = 2)

	 * Class constructor: creates a new empty categorical data instance.

	protected CategoricalData() {

	 * Creates a new empty categorical data instance.

	 */

	public static CategoricalData NewInstance(){

	}

	/** 

	 * Returns the (ordered) list of {@link State states} describing the {@link Feature feature}

	 * corresponding to <i>this</i> categorical data.

	 */

	}

	protected void setStates(List<StateData> states){

		this.states = states;

	}

	 * Adds a {@link State state} to the list of {@link #getStates() states}

	 * describing the {@link Feature feature} corresponding to <i>this</i> categorical data.

	 * 

	 * @param state	the state to be added to <i>this</i> categorical data

	 * @see    	   	#getStates()

	 */

	}

	 * Removes one element from the set of {@link #getStates() states}

	 * describing the {@link Feature feature} corresponding to <i>this</i> categorical data.

	 *

	 * @param  state	the state which should be removed

	 * @see     		#getStates()

	 * @see     		#addState(State)

	 */

	}

	 * {@link StateData state data} belonging to <i>this</i> categorical data is intentional

	 * (true) and therefore relevant for interpretation or analysis or not (false).

	 * The use of this flag depends mostly on the {@link Feature feature} of <i>this</i> categorical data.

	 * @return  the boolean value of the orderRelevant flag

	 */

		return this.orderRelevant;

	}

	 * @see	#getOrderRelevant() 

	 */

		this.orderRelevant = orderRelevant;

	}

//*********************************** CLONE *****************************************/

	/** 

	 * Clones <i>this</i> categorical data. This is a shortcut that enables to create

	 * a new instance that differs only slightly from <i>this</i> categorical data by

	 * modifying only some of the attributes.

	 * 

	 * @see eu.etaxonomy.cdm.model.description.DescriptionElementBase#clone()

	 * @see java.lang.Object#clone()

	 */

	@Override

	public Object clone() {

		try {

			CategoricalData result = (CategoricalData)super.clone();

			//states

			result.states = new ArrayList<StateData>();

			for (StateData stateData : getStates()){

				//StateData newState = (StateData)stateData.clone();

				result.states.add(stateData);

			return result;

			//no changes to: orderRelevant

		} catch (CloneNotSupportedException e) {

			logger.warn("Object does not implement cloneable");

			e.printStackTrace();

			return null;

		}

	}	

}