EDIT

/**

* Copyright (C) 2007 EDIT

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

*/

package eu.etaxonomy.cdm.model.occurrence;

import javax.persistence.Entity;

import javax.persistence.FetchType;

import javax.persistence.Inheritance;

import javax.persistence.InheritanceType;

import javax.persistence.ManyToOne;

import javax.persistence.Transient;

import javax.xml.bind.annotation.XmlAccessType;

import javax.xml.bind.annotation.XmlAccessorType;

import javax.xml.bind.annotation.XmlElement;

import javax.xml.bind.annotation.XmlIDREF;

import javax.xml.bind.annotation.XmlRootElement;

import javax.xml.bind.annotation.XmlSchemaType;

import javax.xml.bind.annotation.XmlType;

import org.apache.log4j.Logger;

import org.hibernate.envers.Audited;

import org.hibernate.search.annotations.IndexedEmbedded;

import eu.etaxonomy.cdm.model.common.EventBase;

import eu.etaxonomy.cdm.model.molecular.Cloning;

import eu.etaxonomy.cdm.model.term.TermType;

import eu.etaxonomy.cdm.model.term.TermVocabulary;

/**

 * A material or method event handles data on materials or methods used for handling specimen or derived units

 * in general. It stores information on what material or method was used, who used it and when it was used.

 * For reusable data on materials or methods it is best practice to define these first as {@link DefinedTerm

 * are also handled via {@link EventBase} fields.

 * This class may be extended by more specific classes which require structured handling of additional parameters.

 * In general material or method data is not considered to be CDM core data. Therefore the decision was made to handle

 * in the underlying databases.

 */

@XmlAccessorType(XmlAccessType.FIELD)

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

@XmlRootElement(name = "MaterialOrMethod")

@Entity

@Inheritance(strategy=InheritanceType.SINGLE_TABLE)

@Audited

public class MaterialOrMethodEvent extends EventBase implements Cloneable{

	private static final long serialVersionUID = -4799205199942053585L;

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

    @XmlSchemaType(name = "IDREF")

    @ManyToOne(fetch=FetchType.LAZY)

    @IndexedEmbedded // no depth for terms

// ******************** FACTORY METHOD ******************/

    	return new MaterialOrMethodEvent();

    }

    	return new MaterialOrMethodEvent(definedMaterialOrMethod, methodText);

    	this.definedMaterialOrMethod = definedMaterialOrMethod;

    }

	 * The {@link #getDescription()} method is inherited from {@link EventBase}.

	 * In this class it is used as freetext describing the material or method used

	 */

    @Override

	public String getDescription() {

		return super.getDescription();

	}

	 * @see #getDescription()

	 * @see #setMaterialMethodText(String)

	 */

    @Override

	public void setDescription(String materialMethodText) {

		super.setDescription(materialMethodText);

	}

	 * A freetext describing the material or method or if

	 */

	@Transient

    public String getMaterialMethodText() {

		return this.getDescription();

	}

	/**

	 * @see #getMaterialMethodText()

	 */

	public void setMaterialMethodText(String materialMethodText) {

		this.setDescription(materialMethodText);

	}

	 * the {@link #getDescription() description} should primarily focus on describing

	 * deviation from this method rather then repeating it.

	 * @see #getMaterialMethodText()

	 * @return the material or method term

	 */

		return definedMaterialOrMethod;

	/**

	 */

		this.definedMaterialOrMethod = definedMaterialOrMethod;

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

	 * modifying only some of the attributes.<BR><BR>

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

	 */

	@Override

	public Object clone()  {

		try{

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

			return result;

		}catch (CloneNotSupportedException e) {

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

			e.printStackTrace();

			return null;

		}

	}

}