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

import javax.persistence.ManyToOne;

import javax.persistence.Transient;

import javax.xml.bind.annotation.XmlAccessorType;

import javax.xml.bind.annotation.XmlAttribute;

import javax.xml.bind.annotation.XmlElement;

import javax.xml.bind.annotation.XmlType;

import org.apache.log4j.Logger;

import org.hibernate.annotations.Cascade;

import org.hibernate.annotations.CascadeType;

import org.hibernate.annotations.Table;

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

import eu.etaxonomy.cdm.model.media.IdentifyableMediaEntity;

import eu.etaxonomy.cdm.model.taxon.Synonym;

/**

 * direct subclasses {@link StrictReferenceBase StrictReferenceBase} and {@link BibtexReference BibtexReference}

 * allow either on the one side to handle different kind of references with their

 * peculiarities or on the other side to follow the flat BibTeX format

 * (see "http://en.wikipedia.org/wiki/BibTeX").

 * This class corresponds to: <ul>

 * <li> PublicationCitation according to the TDWG ontology

 * <li> Publication according to the TCS

 * <li> Reference according to the ABCD schema

 * </ul>

 * @version 1.0

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

 */

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

	"uri",

	"isNomenclaturallyRelevant",

@XmlRootElement(name = "RelationshipBase")

	//nomenclatural reference in a name this flag should be automatically set

	@XmlElement(name = "AuthorTeam")

	@XmlSchemaType(name = "IDREF")

	 * Returns the {@link agent.TeamOrPersonBase author (team)} who created the

	 * content of <i>this</i> reference.

	 * 

	 * @return  the author (team) of <i>this</i> reference

	 * @see 	agent.TeamOrPersonBase

	 */

	@Cascade({CascadeType.SAVE_UPDATE})

	}

	 * @see #getAuthorTeam()

	 */

	}

	 * Returns the Uniform Resource Identifier (URI) corresponding to <i>this</i>

	 * reference. An URI is a string of characters used to identify a resource

	 * on the Internet.

	 * 

	 * @return  the URI of <i>this</i> reference

	 */

		return this.uri;

	}

	 * @see #getUri()

	 */

		this.uri = uri;

	}

	 * Returns "true" if the isNomenclaturallyRelevant flag is set. This 

	 * indicates that a {@link TaxonNameBase taxon name} has been originally

	 * published in <i>this</i> reference following the rules of a

	 * reference is used as a nomenclatural reference for any taxon name.

	 */

		return this.isNomenclaturallyRelevant;

	}

	/**

	public void setNomenclaturallyRelevant(boolean isNomenclaturallyRelevant){

		this.isNomenclaturallyRelevant = isNomenclaturallyRelevant;

	}

	/**

	 * including authors, corresponding to <i>this</i> reference.

	 * 

	 * @see  #generateTitle()

	@Transient

		return "";

	}

	 * Returns a string containing the date (mostly only the year) of

	 * publication / creation of <i>this</i> reference.

	 */

	public abstract String getYear();

	 * Returns the boolean value of the flag indicating whether the used {@link eu.etaxonomy.cdm.strategy.parser.INonViralNameParser parser} 

	 * method was able to parse the string designating <i>this</i> reference

	 * successfully (false) or not (true).

	 *  

	 * @return  the boolean value of the hasProblem flag

	 * @see     #getCitation()

	 */

		return this.hasProblem;

	}

	 * @see  #getHasProblem()

	 */

		this.hasProblem = hasProblem;

	}

	 * Generates, according to the {@link strategy.cache.reference.IReferenceBaseCacheStrategy cache strategy}

	 * assigned to <i>this</i> reference, a string that identifies <i>this</i>

	 * reference and returns it. This string may be stored in the inherited

	 * {@link common.IdentifiableEntity#getTitleCache() titleCache} attribute.<BR>

	 * This method overrides the generic and inherited

	 * IdentifiableEntity#generateTitle() method.

	 *

	 * @return  the string identifying <i>this</i> reference

	 * @see  	#getCitation()

	 * @see  	common.IdentifiableEntity#getTitleCache()

	 * @see  	common.IdentifiableEntity#generateTitle()

	 * @see  	strategy.cache.common.IIdentifiableEntityCacheStrategy#getTitleCache()

	 */

	public String generateTitle(){

		if (cacheStrategy == null){

			logger.warn("No CacheStrategy defined for ReferenceBase: " + this.getUuid());

			return null;

		}else{

			return cacheStrategy.getTitleCache(this);

		}

	}

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

	/** 

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

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

	 * modifying only some of the attributes.

	 * 

	 * @see media.IdentifyableMediaEntity#clone()

	public Object clone() throws CloneNotSupportedException{

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

		//no changes to: authorTeam, hasProblem, nomenclaturallyRelevant, uri

		return result;

	}