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.common;

import javax.persistence.Entity;

import javax.persistence.FetchType;

import javax.persistence.Lob;

import javax.persistence.ManyToOne;

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.XmlSchemaType;

import javax.xml.bind.annotation.XmlType;

import org.apache.commons.lang.StringUtils;

import org.apache.log4j.Logger;

import org.hibernate.envers.Audited;

/**

 * This class aims to make available more "attributes" for identifiable entities

 * in a flexible way. Application developers (and even users) can define their own

 * "attributes" as an ExtensionType and add data to Identifiable instances via

 * Extension instances.

 * @author m.doering

 * @version 1.0

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

 */

@XmlAccessorType(XmlAccessType.FIELD)

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

    "value",

    "type"

})

@Entity

@Audited

public class Extension extends VersionableEntity implements Cloneable {

	private static final long serialVersionUID = -857207737641432202L;

	@SuppressWarnings("unused")

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

    @XmlElement(name = "Value")

	@Lob

    private String value;

    @XmlElement(name = "ExtensionType")

    @XmlIDREF

    @XmlSchemaType(name = "IDREF")

    @ManyToOne(fetch = FetchType.LAZY)

    private ExtensionType type;

	public static Extension NewInstance(){

		return new Extension();

	}

	/**

	 * Creates a new extension and adds it to the extended object.

	 * @param extendedObject

	 * @param value

	 * @param extensionType

	 * @return

	 */

	public static Extension NewInstance(IdentifiableEntity<?> extendedObject, String value, ExtensionType extensionType){

		Extension extension = new Extension();

		extension.setValue(value);

		extension.setType(extensionType);

		extendedObject.addExtension(extension);

		return extension;

	}

// *************************** GETTER / SETTER ********************************/

	//type

	public ExtensionType getType(){

		return this.type;

	}

	public void setType(ExtensionType type){

		this.type = type;

	}

	//value

	public String getValue(){

		return this.value;

	}

	public void setValue(String value){

		this.value = value;

	}

//***************************** TO STRING ***********************************

	@Override

	public String toString() {

		if (StringUtils.isNotBlank(this.value)){

			return "Ext.: " + this.value;

		}else{

			return super.toString();

		}

	}

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

	@Override

	public Object clone() throws CloneNotSupportedException{

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

		//no changes to: type, value

		return result;

	}

}