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

import java.util.HashMap;

import java.util.List;

import java.util.Map;

import java.util.UUID;

import javax.persistence.Entity;

import javax.persistence.Transient;

import javax.xml.bind.annotation.XmlAccessType;

import javax.xml.bind.annotation.XmlAccessorType;

import javax.xml.bind.annotation.XmlType;

import org.apache.log4j.Logger;

import org.hibernate.envers.Audited;

import org.hibernate.search.annotations.Indexed;

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

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

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

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

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

import eu.etaxonomy.cdm.strategy.exceptions.UnknownCdmTypeException;

/**

 * The class representing categories of nomenclatural status (like "invalid",

 * "conserved" or "novum") to qualify the use of a particular taxon name string

 * depending on its {@link eu.etaxonomy.cdm.model.reference.INomenclaturalReference nomenclatural reference} (original publication),

 * on its {@link NomenclaturalCode nomenclatural code} and on possible decisions of the corresponding

 * competent authorities. Unfortunately the ICBN and the ICZN use sometimes

 * different words for the same meaning or the same word for different meanings

 * (for instance "valid" and "legitimate").

 * <P>

 * A standard (ordered) list of nomenclatural status type instances will be

 * automatically created as the project starts. But this class allows to extend

 * this standard list by creating new instances of additional nomenclatural

 * status types if needed. The present standard list follows the ICBN

 * terminology.

 * <P>

 * This class corresponds more or less to: <ul>

 * <li> NomenclaturalNoteTypeTerm according to the TDWG ontology

 * <li> NomenclaturalNoteType  according to the TCS

 * </ul>

 * 

 * @author a.mueller

 * @created 10.07.2008

 * @version 1.0

 */

@XmlAccessorType(XmlAccessType.FIELD)

@XmlType(name = "NomenclaturalStatusType")

@Entity

@Indexed(index = "eu.etaxonomy.cdm.model.common.DefinedTermBase")

@Audited

public class NomenclaturalStatusType extends OrderedTermBase<NomenclaturalStatusType> {

	private static final long serialVersionUID = 1337101678484153972L;

	private static Logger logger = Logger.getLogger(NomenclaturalStatusType.class);

	private static final UUID uuidAmbiguous = UUID.fromString("90f5012b-705b-4488-b4c6-002d2bc5198e");

	private static final UUID uuidDoubtful = UUID.fromString("0ffeb39e-872e-4c0f-85ba-a4150d9f9e7d");

	private static final UUID uuidConfusum = UUID.fromString("24955174-aa5c-4e71-a2fd-3efc79e885db");

	private static final UUID uuidIllegitimate = UUID.fromString("b7c544cf-a375-4145-9d3e-4b97f3f18108");

	private static final UUID uuidSuperfluous = UUID.fromString("6890483a-c6ba-4ae1-9ab1-9fbaa5736ce9");

	private static final UUID uuidRejected = UUID.fromString("48107cc8-7a5b-482e-b438-efbba050b851");

	private static final UUID uuidUtiqueRejected = UUID.fromString("04338fdd-c12a-402f-a1ca-68b4bf0be042");

	private static final UUID uuidConservedProp = UUID.fromString("82bab006-5aed-4301-93ec-980deb30cbb1");

	private static final UUID uuidOrthographyConservedProp = UUID.fromString("02f82bc5-1066-454b-a023-11967cba9092");

	private static final UUID uuidLegitimate = UUID.fromString("51a3613c-b53b-4561-b0cd-9163d91c15aa");

	private static final UUID uuidAlternative = UUID.fromString("3b8a8519-420f-4dfa-b050-b410cc257961");

	private static final UUID uuidNovum = UUID.fromString("05fcb68f-af60-4851-b912-892512058897");

	private static final UUID uuidUtiqueRejectedProp = UUID.fromString("643ee07f-026c-426c-b838-c778c8613383");

	private static final UUID uuidOrthographyConserved = UUID.fromString("34a7d383-988b-4117-b8c0-52b947f8c711");

	private static final UUID uuidRejectedProp = UUID.fromString("248e44c2-5436-4526-a352-f7467ecebd56");

	private static final UUID uuidConserved = UUID.fromString("6330f719-e2bc-485f-892b-9f882058a966");

	private static final UUID uuidSanctioned = UUID.fromString("1afe55c4-76aa-46c0-afce-4dc07f512733");

	private static final UUID uuidInvalid = UUID.fromString("b09d4f51-8a77-442a-bbce-e7832aaf46b7");

	private static final UUID uuidNudum = UUID.fromString("e0d733a8-7777-4b27-99a3-05ab50e9f312");

	private static final UUID uuidCombinationInvalid = UUID.fromString("f858e619-7b7f-4225-913b-880a2143ec83");

	private static final UUID uuidCombinationIllegitimate = UUID.fromString("d901d455-4e01-45cb-b653-01a840b97eed");

	private static final UUID uuidProvisional = UUID.fromString("a277507e-ad93-4978-9419-077eb889c951");

	private static final UUID uuidValid = UUID.fromString("bd036217-5499-4ccd-8f4c-72e06158db93");

	private static final UUID uuidOpusUtiqueOppr = UUID.fromString("a5055d80-dbba-4660-b091-a1835d59fe7c");

	private static final UUID uuidSubnudum = UUID.fromString("92a76bd0-6ea8-493f-98e0-4be0b98c092f");

	private static Map<String, UUID> abbrevMap = null;

	private static Map<String, UUID> labelMap = null;

	protected static Map<UUID, NomenclaturalStatusType> termMap = null;		

	protected static NomenclaturalStatusType getTermByUuid(UUID uuid){

		if (termMap == null){

//			DefaultTermInitializer vocabularyStore = new DefaultTermInitializer();

//			vocabularyStore.initialize();

			return null;

		}

		return (NomenclaturalStatusType)termMap.get(uuid);

	}

// ************* CONSTRUCTORS *************/	

	/** 

	 * Class constructor: creates a new empty nomenclatural status type instance.

	 * 

	 * @see 	#NomenclaturalStatusType(String, String, String)

	 * @see 	#readCsvLine(List, Language)

	 * @see 	#readCsvLine(List)

	 */

	public NomenclaturalStatusType() {

	}

	/** 

	 * Class constructor: creates an additional nomenclatural status type

	 * instance with a description (in the {@link eu.etaxonomy.cdm.model.common.Language#DEFAULT() default language}), a label

	 * and a label abbreviation.

	 * 

	 * @param	term  		 the string (in the default language) describing the

	 * 						 new nomenclatural status type to be created 

	 * @param	label  		 the string identifying the new nomenclatural status

	 * 						 type to be created

	 * @param	labelAbbrev  the string identifying (in abbreviated form) the

	 * 						 new nomenclatural status type to be created

	 * @see 				 #NomenclaturalStatusType()

	 * @see 				 #readCsvLine(List, Language)

	 * @see 				 #readCsvLine(List)

	 */

	public NomenclaturalStatusType(String term, String label, String labelAbbrev) {

		super(term, label, labelAbbrev);

	}

//********* METHODS **************************************

	/* (non-Javadoc)

	 * @see eu.etaxonomy.cdm.model.common.DefinedTermBase#resetTerms()

	 */

	@Override

	public void resetTerms(){

		termMap = null;

	}

	/**

	 * Returns the boolean value indicating whether <i>this</i> nomenclatural status

	 * type is itself "invalid" or a kind of "invalid" (true) or not (false) - 

	 * this corresponds to "not available" for {@link ZoologicalName zoological names} -.

	 * Returns false if <i>this</i> nomenclatural status type is null. The use

	 * of "invalid" {@link TaxonNameBase taxon names} should be avoided.<BR>

	 * A taxon name is "invalid" if it is not "valid"; this means that

	 * the taxon name:<ul>

	 * <li>has not been effectively published or

	 * <li>has a form which does not comply with the rules of the

	 * 	   {@link NomenclaturalCode nomenclature code} or

	 * <li>is not accompanied by a description or diagnosis or by a reference to

	 * 	   such a previously published description or diagnosis

	 * </ul>

	 *

	 * @see  #VALID()

	 * @see  #isIllegitimateType()

	 * @see  eu.etaxonomy.cdm.model.common.DefinedTermBase#getKindOf()

	 */

	@Transient

	public boolean isInvalidType(){

		if (this.equals(INVALID())

			|| this.equals(NUDUM())

			|| 	this.equals(PROVISIONAL())

			|| 	this.equals(COMBINATION_INVALID())

			|| 	this.equals(OPUS_UTIQUE_OPPR())

			){

			return true;

		}else{

			return false;

		}

	}

	/**

	 * Returns the boolean value indicating whether <i>this</i> nomenclatural status

	 * type is itself "legitimate" or a kind of "legitimate" (true)

	 * or not (false). - this corresponds to "valid" for {@link ZoologicalName zoological names} -.

	 * Returns false if <i>this</i> nomenclatural status type is null.<BR>

	 * A "valid" ("available") {@link TaxonNameBase taxon name}, unless "rejected",

	 * is "legitimate" if it was not "superfluous" when published

	 * or has been later "conserved".<BR>

	 *

	 * @see  #isInvalidType()

	 * @see  #isIllegitimateType()

	 * @see  eu.etaxonomy.cdm.model.common.DefinedTermBase#getKindOf()

	 */

	@Transient

	public boolean isLegitimateType(){

		if (this.equals(LEGITIMATE()) ||

				this.equals(NOVUM()) ||

				this.equals(ALTERNATIVE()) ||

				this.equals(CONSERVED()) ||

				this.equals(ORTHOGRAPHY_CONSERVED()) ||

				this.equals(REJECTED_PROP()) ||

				this.equals(UTIQUE_REJECTED_PROP())

			){

			return true;

		}else{

			return false;

		}

	}

	/**

	 * Returns the boolean value indicating whether <i>this</i> nomenclatural status

	 * type is itself "illegitimate" or a kind of "illegitimate" (true)

	 * or not (false) - this corresponds to "invalid" for {@link ZoologicalName zoological names} -.

	 * Returns false if <i>this</i> nomenclatural status type is null.<BR>

	 * A "valid" ("available") {@link TaxonNameBase taxon name}, unless "conserved" or

	 * "sanctioned", is "illegitimate" if it was "superfluous" when published

	 * or has been later "rejected".

	 *

	 * @see  #VALID()

	 * @see  #isInvalidType()

	 * @see  #ILLEGITIMATE()

	 * @see  #CONSERVED()

	 * @see  #SANCTIONED()

	 * @see  eu.etaxonomy.cdm.model.common.DefinedTermBase#getKindOf()

	 */

	@Transient

	public boolean isIllegitimateType(){

		if (this.equals(ILLEGITIMATE()) ||

				this.equals(SUPERFLUOUS()) ||

				this.equals(REJECTED()) ||

				this.equals(UTIQUE_REJECTED()) ||

				this.equals(CONSERVED_PROP()) ||

				this.equals(ORTHOGRAPHY_CONSERVED_PROP())

			){

			return true;

		}else{

			return false;

		}

	}

	/**

	 * Returns the nomenclatural status type "ambiguous". A "valid"

	 * ("available") {@link TaxonNameBase taxon name} is "ambiguous" if it has been used so long

	 * by different authors in different senses (other than the originally

	 * intended) that it has become a persistent cause of error and confusion.<BR>

	 * An "ambiguous" taxon name is treated as if "rejected" and is therefore

	 * also "illegitimate" ("invalid" for {@link ZoologicalName zoological names}).

	 *

	 * @see  #VALID()

	 * @see  #REJECTED()

	 * @see  #isIllegitimateType()

	 */

	public static final NomenclaturalStatusType AMBIGUOUS(){

		return getTermByUuid(uuidAmbiguous);

	}

	/**

	 * Returns the nomenclatural status type "doubtful" (dubious). A "valid"

	 * ("available") {@link TaxonNameBase taxon name} is "doubtful" if its

	 * application is uncertain; the confusion being derived from an incomplete

	 * or confusing description.<BR>

	 * A "doubtful" taxon name is treated as if "rejected" and is therefore

	 * also "illegitimate" (("invalid" for {@link ZoologicalName zoological names}).

	 *

	 * @see  #VALID()

	 * @see  #REJECTED()

	 * @see  #isIllegitimateType()

	 */

	public static final NomenclaturalStatusType DOUBTFUL(){

		return getTermByUuid(uuidDoubtful);

	}

	/**

	 * Returns the nomenclatural status type "confusum". A "valid" ("available")

	 * {@link TaxonNameBase taxon name} is "confusum" if it has been widely

	 * and persistently used for a taxon or taxa not including its type.<BR>

	 * A "confusum" taxon name is treated as if "rejected" and is therefore

	 * also "illegitimate" ("invalid" for {@link ZoologicalName zoological names}).

	 *

	 * @see  #VALID()

	 * @see  #REJECTED()

	 * @see  #isIllegitimateType()

	 */

	public static final NomenclaturalStatusType CONFUSUM(){

		return getTermByUuid(uuidConfusum);

	}

	/**

	 * Returns the nomenclatural status type "illegitimate" ("invalid" for

	 * {@link ZoologicalName zoological names}). A "valid" ("available")

	 * {@link TaxonNameBase taxon name}, unless "conserved" or "sanctioned", is "illegitimate"

	 * if it was "superfluous" when published or has been later "rejected".<BR>

	 *

	 * @see  #VALID()

	 * @see  #SUPERFLUOUS()

	 * @see  #REJECTED()

	 */

	public static final NomenclaturalStatusType ILLEGITIMATE(){

		return getTermByUuid(uuidIllegitimate);

	}

	/**

	 * Returns the nomenclatural status type "superfluous". A "valid"

	 * ("available") {@link TaxonNameBase taxon name} is "superfluous" if, when published,

	 * the taxon to which it was applied, as circumscribed by its {@link NonViralName#getCombinationAuthorTeam() author},

	 * definitely included the type of a name which ought to have been adopted,

	 * or of which the epithet ought to have been adopted, under the rules of

	 * the {@link NomenclaturalCode nomenclature code}, and if it has not been later declared

	 * "conserved" or "sanctioned" by the competent authorities.<BR>

	 * A "superfluous" taxon name is therefore also "illegitimate" ("invalid" for

	 * {@link ZoologicalName zoological names}).

	 *

	 * @see  #VALID()

	 * @see  #CONSERVED()

	 * @see  #SANCTIONED()

	 * @see  #isIllegitimateType()

	 */

	public static final NomenclaturalStatusType SUPERFLUOUS(){

		return getTermByUuid(uuidSuperfluous);

	}

	/**

	 * Returns the nomenclatural status type "rejected". A "valid" ("available")

	 * {@link TaxonNameBase taxon name} is "rejected" if, even though by the strict

	 * application of the rules of the {@link NomenclaturalCode nomenclature code}, and especially

	 * of the principle of priority, it should be "legitimate" ("valid" for

	 * {@link ZoologicalName zoological names}), competent authorities decided to handle

	 * it as "illegitimate".<BR>

	 * A "rejected" taxon name is therefore also "illegitimate" ("invalid" for

	 * zoological names). A "rejected" taxon name is always rejected in favour

	 * of a "conserved" taxon name.

	 *

	 * @see  #VALID()

	 * @see  #isLegitimateType()

	 * @see  #isIllegitimateType()

	 * @see  #CONSERVED()

	 * @see  NameRelationshipType#CONSERVED_AGAINST()

	 */

	public static final NomenclaturalStatusType REJECTED(){

		return getTermByUuid(uuidRejected);

	}

	/**

	 * Returns the nomenclatural status type "utique rejected". A "valid"

	 * ("available") {@link TaxonNameBase taxon name} is "utique rejected" if it is rejected

	 * outright (without being rejected in favour of a "conserved" taxon name).<BR>

	 * An "utique rejected" taxon name is therefore also "illegitimate"

	 * ("invalid" for zoological names).

	 *

	 * @see  #REJECTED()

	 * @see  #VALID()

	 * @see  #isIllegitimateType()

	 * @see  #CONSERVED()

	 */

	public static final NomenclaturalStatusType UTIQUE_REJECTED(){

		return getTermByUuid(uuidUtiqueRejected);

	}

	/**

	 * Returns the nomenclatural status type "proposed to be conserved". A

	 * "valid" ("available") {@link TaxonNameBase taxon name} is "proposed to be conserved"

	 * if, even though by the strict application of the rules of

	 * the {@link NomenclaturalCode nomenclature code}, and especially of the principle of priority,

	 * it is "illegitimate" ("invalid" for {@link ZoologicalName zoological names}),

	 * it has been submitted to competent authorities in order to decide whether

	 * it should be handled as "legitimate".<BR>

	 * A "proposed to be conserved" taxon name is therefore still "illegitimate"

	 * ("invalid" for zoological names).

	 *

	 * @see  #VALID()

	 * @see  #isIllegitimateType()

	 * @see  #isLegitimateType()

	 * @see  #CONSERVED()

	 * @see  NameRelationshipType#CONSERVED_AGAINST()

	 */

	public static final NomenclaturalStatusType CONSERVED_PROP(){

		return getTermByUuid(uuidConservedProp);

	}

	/**

	 * Returns the nomenclatural status type "proposed to be conserved

	 * (orthography)". A {@link TaxonNameBase taxon name} is "proposed to be conserved

	 * (orthography)" if, even though originally published with another

	 * spelling, it has been submitted to competent authorities in order to

	 * decide whether the proposed alternative spelling should be "conserved".<BR>

	 * A "proposed to be conserved (orthography)" taxon name is therefore still

	 * "illegitimate" ("invalid" for {@link ZoologicalName zoological names}).

	 *

	 * @see  #isIllegitimateType()

	 * @see  #CONSERVED_PROP()

	 * @see  #CONSERVED()

	 * @see  NameRelationshipType#ORTHOGRAPHIC_VARIANT()

	 * @see  NameRelationshipType#CONSERVED_AGAINST()

	 */

	public static final NomenclaturalStatusType ORTHOGRAPHY_CONSERVED_PROP(){

		return getTermByUuid(uuidOrthographyConservedProp);

	}

	/**

	 * Returns the nomenclatural status type "legitimate" ("valid" for

	 * {@link ZoologicalName zoological names}). A "valid" ("available")

	 * {@link TaxonNameBase taxon name}, unless "rejected", is "legitimate" if it was not

	 * "superfluous" when published or has been later "conserved".<BR>

	 *

	 * @see  #VALID()

	 * @see  #SUPERFLUOUS()

	 * @see  #CONSERVED()

	 */

	public static final NomenclaturalStatusType LEGITIMATE(){

		return getTermByUuid(uuidLegitimate);

	}

	/**

	 * Returns the nomenclatural status type "alternative". A family

	 * {@link BotanicalName botanical name} is "alternative" if it is a classical name

	 * long in use, in some cases even before 1753, and is considered as

	 * {@link NomenclaturalStatusType#VALID() "valid"} although it does not follow the rules for

	 * family names (see Article 18 of the ICBN).<BR>

	 * An "alternative" taxon name is treated as if "conserved" and is therefore

	 * also "legitimate".

	 *

	 * @see  #VALID()

	 * @see  #CONSERVED()

	 * @see  #isLegitimateType()

	 * @see  NameRelationshipType#ALTERNATIVE_NAME()

	 */

	public static final NomenclaturalStatusType ALTERNATIVE(){

		return getTermByUuid(uuidAlternative);

	}

	/**

	 * Returns the nomenclatural status type "novum". A "valid"

	 * ("available") {@link TaxonNameBase taxon name} is "novum" if it has been created

	 * in order either to replace an earlier name that is "illegitimate" or to

	 * avoid the building of a "later homonym".<BR>

	 * A "novum" taxon name is therefore also "legitimate" ("valid" for

	 * {@link ZoologicalName zoological names}).

	 *

	 * @see  #VALID()

	 * @see  #isIllegitimateType()

	 * @see  NameRelationshipType#REPLACED_SYNONYM()

	 * @see  NameRelationshipType#BLOCKING_NAME_FOR()

	 */

	public static final NomenclaturalStatusType NOVUM(){

		return getTermByUuid(uuidNovum);

	}

	/**

	 * Returns the nomenclatural status type "proposed to be utique rejected". A

	 * "valid" ("available") {@link TaxonNameBase taxon name} is "proposed to be utique rejected"

	 * if, even though by the strict application of the rules of

	 * the {@link NomenclaturalCode nomenclature code}, and especially of the principle of priority,

	 * it is "legitimate" ("valid" for {@link ZoologicalName zoological names}),

	 * it has been submitted to competent authorities in order to decide whether

	 * it should be handled as "illegitimate" (without to be rejected in favour

	 * of a "conserved" taxon name).<BR>

	 * A "proposed to be utique rejected" taxon name is therefore still "legitimate"

	 * ("valid" for zoological names).

	 *

	 * @see  #VALID()

	 * @see  #isLegitimateType()

	 * @see  #isIllegitimateType()

	 * @see  #REJECTED()

	 * @see  #REJECTED_PROP()

	 */

	public static final NomenclaturalStatusType UTIQUE_REJECTED_PROP(){

		return getTermByUuid(uuidUtiqueRejectedProp);

	}

	/**

	 * Returns the nomenclatural status type "conserved (orthography)". A

	 * {@link TaxonNameBase taxon name} is "conserved (orthography)" if competent authorities

	 * decided to conserve a different spelling to the one published originally.<BR>

	 * A "conserved (orthography)" taxon name is "conserved" and hence

	 * "legitimate" ("valid" for {@link ZoologicalName zoological names}).

	 *

	 * @see  #isLegitimateType()

	 * @see  #CONSERVED()

	 * @see  #ORTHOGRAPHY_CONSERVED_PROP()

	 * @see  NameRelationshipType#ORTHOGRAPHIC_VARIANT()

	 * @see  NameRelationshipType#CONSERVED_AGAINST()

	 */

	public static final NomenclaturalStatusType ORTHOGRAPHY_CONSERVED(){

		return getTermByUuid(uuidOrthographyConserved);

	}

	/**

	 * Returns the nomenclatural status type "proposed to be rejected". A

	 * "valid" ("available") {@link TaxonNameBase taxon name} is "proposed to be rejected"

	 * if, even though by the strict application of the rules of

	 * the {@link NomenclaturalCode nomenclature code}, and especially of the principle of priority,

	 * it should be "legitimate" ("valid" for {@link ZoologicalName zoological names}),

	 * it has been submitted to competent authorities in order to decide whether

	 * it should be handled as "illegitimate".<BR>

	 * A "proposed to be rejected" taxon name is therefore still "legitimate"

	 * ("valid" for zoological names). A "proposed to be rejected" taxon name is always

	 * to be rejected in favour of a "proposed to be conserved" taxon name.

	 *

	 * @see  #VALID()

	 * @see  #isLegitimateType()

	 * @see  #isIllegitimateType()

	 * @see  #REJECTED()

	 * @see  #CONSERVED_PROP()

	 * @see  NameRelationshipType#CONSERVED_AGAINST()

	 */

	public static final NomenclaturalStatusType REJECTED_PROP(){

		return getTermByUuid(uuidRejectedProp);

	}

	/**

	 * Returns the nomenclatural status type "conserved". A "valid"

	 * ("available") {@link TaxonNameBase taxon name} is "conserved" if, even though by the strict

	 * application of the rules of the {@link NomenclaturalCode nomenclature code}, and especially of

	 * the principle of priority, it should be "illegitimate" ("invalid" for

	 * {@link ZoologicalName zoological names}), competent authorities decided to handle

	 * it as "legitimate".<BR>

	 * A "conserved" taxon name is therefore also "legitimate" ("valid" for

	 * zoological names).

	 *

	 * @see  #VALID()

	 * @see  #isIllegitimateType()

	 * @see  #isLegitimateType()

	 * @see  NameRelationshipType#CONSERVED_AGAINST()

	 */

	public static final NomenclaturalStatusType CONSERVED(){

		return getTermByUuid(uuidConserved);

	}

	/**

	 * Returns the nomenclatural status type "sanctioned". {@link BotanicalName Botanical names}

	 * for fungi are "sanctioned" if they were published in the opera mentioned

	 * in Article 13.1d of the {@link NomenclaturalCode#ICBN() ICBN}.<BR>

	 * A "sanctioned" taxon name is treated as if "conserved" and is therefore

	 * also "legitimate".

	 *

	 * @see  #VALID()

	 * @see  #CONSERVED()

	 * @see  #isLegitimateType()

	 */

	public static final NomenclaturalStatusType SANCTIONED(){

		return getTermByUuid(uuidSanctioned);

	}

	/**

	 * Returns the nomenclatural status type "invalid" (this corresponds to 

	 * "not available" for {@link ZoologicalName zoological names}). The use of "invalid"

	 * {@link TaxonNameBase taxon names} should be avoided.<BR>

	 * A taxon name is "invalid" if it is not "valid"; this means that

	 * the taxon name:<ul>

	 * <li>has not been effectively published or

	 * <li>has a form which does not comply with the rules of the

	 * 	   {@link NomenclaturalCode nomenclature code} or

	 * <li>is not accompanied by a description or diagnosis or by a reference to

	 * 	   such a previously published description or diagnosis

	 * </ul>

	 *

	 * @see  #VALID()

	 * @see  #isInvalidType()

	 * @see  #ILLEGITIMATE()

	 */

	public static final NomenclaturalStatusType INVALID(){

		return getTermByUuid(uuidInvalid);

	}

	/**

	 * Returns the nomenclatural status type "nudum". A {@link TaxonNameBase taxon name} is "nudum"

	 * if its publication is not accompanied by a description or diagnosis or

	 * by a reference to such a previously published description or diagnosis.<BR>

	 * A "nudum" taxon name is therefore also "invalid" ("not available" for

	 * {@link ZoologicalName zoological names}).

	 *

	 * @see  #isInvalidType()

	 */

	public static final NomenclaturalStatusType NUDUM(){

		return getTermByUuid(uuidNudum);

	}

	/**

	 * Returns the nomenclatural status type "invalid combination". A

	 * {@link TaxonNameBase bi- or trinomial} is an "invalid combination" if its

	 * {@link NonViralName#getCombinationAuthorTeam() author} did not definitely associate the final

	 * epithet with the name of the genus or species, or with its abbreviation.<BR>

	 * An "invalid combination" taxon name is therefore also "invalid"

	 * ("not available" for {@link ZoologicalName zoological names}).

	 *

	 * @see  #isInvalidType()

	 */

	public static final NomenclaturalStatusType COMBINATION_INVALID(){

		return getTermByUuid(uuidCombinationInvalid);

	}

	/**

	 * Returns the nomenclatural status type "illegitimate combination". 

	 * TODO explanation

	 *

	 * @see  #isInvalidType()

	 */

	public static final NomenclaturalStatusType COMBINATION_ILLEGITIMATE(){

		return getTermByUuid(uuidCombinationIllegitimate);

	}

	/**

	 * Returns the nomenclatural status type "provisional". A {@link TaxonNameBase taxon name} is

	 * "provisional" if it has not been yet effectively published.<BR>

	 * A "provisional" taxon name is therefore also "invalid"

	 * ("not available" for {@link ZoologicalName zoological names}).

	 *

	 * @see  #isInvalidType()

	 */

	public static final NomenclaturalStatusType PROVISIONAL(){

		return getTermByUuid(uuidProvisional);

	}

	/**

	 * Returns the nomenclatural status type "valid" (this corresponds to 

	 * "available" for {@link ZoologicalName zoological names}).<BR>

	 * A {@link TaxonNameBase taxon name} is "valid" if it:<ul>

	 * <li>has been effectively published and

	 * <li>has a form which complies with the rules of the

	 * 	   {@link NomenclaturalCode nomenclature code} and

	 * <li>is accompanied by a description or diagnosis or by a reference to

	 * 	   such a previously published description or diagnosis

	 * </ul>

	 *

	 * @see  #INVALID()

	 * @see  #LEGITIMATE()

	 */

	public static final NomenclaturalStatusType VALID(){

		return getTermByUuid(uuidValid);

	}

	/**

	 * Returns the nomenclatural status type "subnudum". This type is not

	 * covered by {@link NomenclaturalCode nomenclature codes}. It appears sometimes in literature and

	 * represents the opinion of the author who considers the {@link TaxonNameBase taxon name} to be

	 * unusable for an unambiguous taxonomic use.

	 * 

	 * @see  #AMBIGUOUS()

	 * @see  #CONFUSUM()

	 * 

	 */

	public static final NomenclaturalStatusType SUBNUDUM(){

		return getTermByUuid(uuidSubnudum);

	}

	/**

	 * Returns the nomenclatural status type "opus utique oppressum". This type

	 * relates to article 32.7 (old ICBN) and article 32.9 as well as App. 6

	 * (new {@link NomenclaturalCode#ICBN() ICBN}). This is a reference list of botanical opera, in which all

	 * {@link BotanicalName taxon names} (or names of a certain rank) are oppressed. Such a name has the

	 * status "invalid" but in contrary to "rejected" not a single name

	 * is rejected by the commission but an opus with regard to the validity of

	 * all taxon names occurring in it.<BR>

	 * An "opus utique oppressum" taxon name is therefore also "invalid"

	 * ("not available" for {@link ZoologicalName zoological names}).

	 *

	 * @see  #isInvalidType()

	 */

	public static final NomenclaturalStatusType OPUS_UTIQUE_OPPR(){

		return getTermByUuid(uuidOpusUtiqueOppr);

	}

//TODO Soraya

//	orth. var.: orthographic variant

//	pro syn.: pro synonymo

	// TODO

	// Preliminary implementation for BotanicalNameParser.

	// not yet complete

	/**

	 * Returns the nomenclatural status type identified through its label

	 * abbreviation. Preliminary implementation for BotanicalNameParser.

	 * 

	 * @param	statusAbbreviation	the label abbreviation

	 * @return  					the nomenclatural status type

	 * 					

	 */

	public static NomenclaturalStatusType getNomenclaturalStatusTypeByAbbreviation(String statusAbbreviation) throws UnknownCdmTypeException{

		if (statusAbbreviation == null){ 

			throw new NullPointerException("statusAbbreviation is NULL in getNomenclaturalStatusTypeByAbbreviation");

		}

		NomenclaturalStatusType result = null;

		if (statusAbbreviation == null){ 

			throw new NullPointerException("Abbreviation is NULL in getNomenclaturalStatusTypeByAbbreviation");

		}

		if (abbrevMap == null){

			return null;

		}

		//non unique abbrev

		if (statusAbbreviation.equalsIgnoreCase("nom. alternativ.")){

			return NomenclaturalStatusType.ALTERNATIVE();

		}

		UUID uuid = abbrevMap.get(statusAbbreviation);

		if (uuid != null ){

			result = getTermByUuid(uuid);

		}

		if (result != null){

			return result;

		}else { 

			if (statusAbbreviation == null){

				statusAbbreviation = "(null)";

			}

			throw new UnknownCdmTypeException("Unknown nom. status abbreviation: " + statusAbbreviation);

		}	

//		}else if (statusAbbreviation.equalsIgnoreCase("nom. ambig.")) { return NomenclaturalStatusType.AMBIGUOUS();

//		}else if (statusAbbreviation.equalsIgnoreCase("nom. dub.")) { return NomenclaturalStatusType.DOUBTFUL();

//		}else if (statusAbbreviation.equalsIgnoreCase("nom. confus.")) { return NomenclaturalStatusType.CONFUSUM();

//		}else if (statusAbbreviation.equalsIgnoreCase("nom. illeg.")){return NomenclaturalStatusType.ILLEGITIMATE();

//		}else if (statusAbbreviation.equalsIgnoreCase("nom. superfl.")){ return NomenclaturalStatusType.SUPERFLUOUS();

//		}else if (statusAbbreviation.equalsIgnoreCase("nom. rej.")) { return NomenclaturalStatusType.REJECTED();

//		}else if (statusAbbreviation.equalsIgnoreCase("nom. utique rej.")) { return NomenclaturalStatusType.UTIQUE_REJECTED();

//		}else if (statusAbbreviation.equalsIgnoreCase("nom. cons. prop.")) { return NomenclaturalStatusType.CONSERVED_PROP();

//		}else if (statusAbbreviation.equalsIgnoreCase("nom. orth. cons. prop.")) { return NomenclaturalStatusType.ORTHOGRAPHY_CONSERVED_PROP();

//		}else if (statusAbbreviation.equalsIgnoreCase("nom. legit.")) { return NomenclaturalStatusType.LEGITIMATE();

//		}else if (statusAbbreviation.equalsIgnoreCase("nom. altern.")) { return NomenclaturalStatusType.ALTERNATIVE();

//		}else if (statusAbbreviation.equalsIgnoreCase("nom. alternativ.")) { return NomenclaturalStatusType.ALTERNATIVE();

//		}else if (statusAbbreviation.equalsIgnoreCase("nom. nov.")) { return NomenclaturalStatusType.NOVUM();

//		}else if (statusAbbreviation.equalsIgnoreCase("nom. utique rej. prop.")) { return NomenclaturalStatusType.UTIQUE_REJECTED_PROP();

//		}else if (statusAbbreviation.equalsIgnoreCase("nom. orth. cons.")) { return NomenclaturalStatusType.ORTHOGRAPHY_CONSERVED();

//		}else if (statusAbbreviation.equalsIgnoreCase("nom. rej. prop.")) { return NomenclaturalStatusType.REJECTED_PROP();

//		}else if (statusAbbreviation.equalsIgnoreCase("nom. cons.")) { return NomenclaturalStatusType.CONSERVED();

//		}else if (statusAbbreviation.equalsIgnoreCase("nom. sanct.")) { return NomenclaturalStatusType.SANCTIONED();

//		}else if (statusAbbreviation.equalsIgnoreCase("nom. inval.")) { return NomenclaturalStatusType.INVALID();

//		}else if (statusAbbreviation.equalsIgnoreCase("nom. nud.")){ return NomenclaturalStatusType.NUDUM();

//		}else if (statusAbbreviation.equalsIgnoreCase("comb. inval.")){ return NomenclaturalStatusType.COMBINATION_INVALID();

//		}else if (statusAbbreviation.equalsIgnoreCase("nom. provis.")) { return NomenclaturalStatusType.PROVISIONAL();

//		}else if (statusAbbreviation.equalsIgnoreCase("nom. valid")) { return NomenclaturalStatusType.VALID();

//		}else if (statusAbbreviation.equalsIgnoreCase("opus. utique oppr.")) { return NomenclaturalStatusType.OPUS_UTIQUE_OPPR();

//		}else if (statusAbbreviation.equalsIgnoreCase("nom. subnud.")) { return NomenclaturalStatusType.SUBNUDUM();

//		//TODO make generic, use labels for map

//		}else {

//			if (statusAbbreviation == null){

//				statusAbbreviation = "(null)";

//			}

//			throw new eu.etaxonomy.cdm.strategy.exceptions.UnknownCdmTypeException("Unknown NomenclaturalStatusType abbreviation: " + statusAbbreviation);

//		}

	}

	/**

	 * Returns the nomenclatural status type identified through its label. 

	 * 

	 * @param	statusLabel	the nomenclatural status label

	 * @return  the nomenclatural status type

	 * 					

	 */

	public static NomenclaturalStatusType getNomenclaturalStatusTypeByLabel(String statusLabel) throws UnknownCdmTypeException{

		if (statusLabel == null){ 

			throw new NullPointerException("Status label is NULL in getNomenclaturalStatusTypeBylabel");

		}

		NomenclaturalStatusType result = null;

		if (statusLabel == null){ 

			throw new NullPointerException("Status label is NULL in getNomenclaturalStatusTypeByLabel");

		}

		if (labelMap == null){

			return null;

		}

		statusLabel = statusLabel.toLowerCase();

		UUID uuid = labelMap.get(statusLabel);

		if (uuid != null ){

			result = getTermByUuid(uuid);

		}

		if (result != null){

			return result;

		}else { 

			if (statusLabel == null){

				statusLabel = "(null)";

			}

			throw new UnknownCdmTypeException("Unknown nom. status label: " + statusLabel);

		}

//		if (statusLabel == null){ throw new NullPointerException("statusLabel is 'null' in getNomenclaturalStatusTypeByLabel");

//		}else if (statusLabel.equalsIgnoreCase("Ambiguous")) { return NomenclaturalStatusType.AMBIGUOUS();

//		}else if (statusLabel.equalsIgnoreCase("Doubtful")) { return NomenclaturalStatusType.DOUBTFUL();

//		}else if (statusLabel.equalsIgnoreCase("Confusum")) { return NomenclaturalStatusType.CONFUSUM();

//		}else if (statusLabel.equalsIgnoreCase("Illegitimate")){return NomenclaturalStatusType.ILLEGITIMATE();

//		}else if (statusLabel.equalsIgnoreCase("Superfluous")){ return NomenclaturalStatusType.SUPERFLUOUS();

//		}else if (statusLabel.equalsIgnoreCase("Rejected")) { return NomenclaturalStatusType.REJECTED();

//		}else if (statusLabel.equalsIgnoreCase("Utique Rejected")) { return NomenclaturalStatusType.UTIQUE_REJECTED();

//		}else if (statusLabel.equalsIgnoreCase("Conserved Prop")) { return NomenclaturalStatusType.CONSERVED_PROP();

//		}else if (statusLabel.equalsIgnoreCase("Orthography Conserved Prop")) { return NomenclaturalStatusType.ORTHOGRAPHY_CONSERVED_PROP();

//		}else if (statusLabel.equalsIgnoreCase("Legitimate")) { return NomenclaturalStatusType.LEGITIMATE();

//		}else if (statusLabel.equalsIgnoreCase("Alternative")) { return NomenclaturalStatusType.ALTERNATIVE();

//		}else if (statusLabel.equalsIgnoreCase("Novum")) { return NomenclaturalStatusType.NOVUM();

//		}else if (statusLabel.equalsIgnoreCase("Utique Rejected Prop")) { return NomenclaturalStatusType.UTIQUE_REJECTED_PROP();

//		}else if (statusLabel.equalsIgnoreCase("Orthography Conserved")) { return NomenclaturalStatusType.ORTHOGRAPHY_CONSERVED();

//		}else if (statusLabel.equalsIgnoreCase("Rejected Prop")) { return NomenclaturalStatusType.REJECTED_PROP();

//		}else if (statusLabel.equalsIgnoreCase("Conserved")) { return NomenclaturalStatusType.CONSERVED();

//		}else if (statusLabel.equalsIgnoreCase("Sanctioned")) { return NomenclaturalStatusType.SANCTIONED();

//		}else if (statusLabel.equalsIgnoreCase("Invalid")) { return NomenclaturalStatusType.INVALID();

//		}else if (statusLabel.equalsIgnoreCase("Nudum")){ return NomenclaturalStatusType.NUDUM();

//		}else if (statusLabel.equalsIgnoreCase("Combination Invalid")){ return NomenclaturalStatusType.COMBINATION_INVALID();

//		}else if (statusLabel.equalsIgnoreCase("Provisional")) { return NomenclaturalStatusType.PROVISIONAL();

//		}else if (statusLabel.equalsIgnoreCase("Valid")) { return NomenclaturalStatusType.VALID();

//		}else if (statusLabel.equalsIgnoreCase("Opus Utique Oppr")) { return NomenclaturalStatusType.OPUS_UTIQUE_OPPR();

//		}else if (statusLabel.equalsIgnoreCase("Subnudum")) { return NomenclaturalStatusType.SUBNUDUM();

//		}else {

//			if (statusLabel == null){

//				statusLabel = "(null)";

//			}

//			throw new eu.etaxonomy.cdm.strategy.exceptions.UnknownCdmTypeException("Unknown NomenclaturalStatusType abbreviation: " + statusLabel);

//		}

	}

	/* (non-Javadoc)

	 * @see eu.etaxonomy.cdm.model.common.DefinedTermBase#readCsvLine(java.util.List)

	 */

	/** 

	 * Fills <i>this</i> nomenclatural status type with contents (uuid, uri, 

	 * description text, label and label abbreviation) coming from a csv line.

	 * The implicit language for the description text is "latin".

	 * This method overrides the method of {@link eu.etaxonomy.cdm.model.common.DefinedTermBase DefinedTermBase}.

	 * 

	 * @param	csvLine 	the (ordered) list of substrings from a csv string

	 * 						to be used to fill <i>this</i> nomenclatural status type

	 * @see					#NomenclaturalStatusType(String, String, String)

	 * @see					#readCsvLine(List, Language)

	 * @see					eu.etaxonomy.cdm.model.common.DefinedTermBase#readCsvLine(List)

	 */

	public NomenclaturalStatusType readCsvLine(Class<NomenclaturalStatusType> termClass, List<String> csvLine, Map<UUID,DefinedTermBase> terms) {   //TODO should be List<String> but makes error for some strange reason

		try {

			NomenclaturalStatusType newInstance = termClass.newInstance();

			DefinedTermBase.readCsvLine(newInstance, csvLine, Language.LATIN());

			return newInstance;

		} catch (Exception e) {

			// TODO Auto-generated catch block

			e.printStackTrace();

		} 

		return null;

	}

	@Override

	protected void setDefaultTerms(TermVocabulary<NomenclaturalStatusType> termVocabulary) {

		termMap = new HashMap<UUID, NomenclaturalStatusType>();

		for (NomenclaturalStatusType term : termVocabulary.getTerms()){

			termMap.put(term.getUuid(), term);

			addStatusType(term);

		}

	}

	/**

	 * Adds the status type to the (abbreviated) label maps

	 * @param term

	 */

	private void addStatusType(NomenclaturalStatusType statusType) {

		if (statusType == null){

			logger.warn("statusType is NULL");

			return;

		}

		Language lang = Language.LATIN();   

		Representation representation = statusType.getRepresentation(lang);

		String abbrevLabel = representation.getAbbreviatedLabel();

		String label = representation.getLabel();

		if (abbrevLabel == null){

			logger.warn("label is NULL");

			return;

		}

		//initialize maps

		if (abbrevMap == null){

			abbrevMap = new HashMap<String, UUID>();

		}

		if (labelMap == null){

			labelMap = new HashMap<String, UUID>();

		}

		//add to map

		abbrevMap.put(abbrevLabel, statusType.getUuid());

		labelMap.put(label.toLowerCase(), statusType.getUuid());	

	}

	/**

	 * NomenclaturalStatusType should always be shown in latin, therefore the only existing representation

	 * is the latin one. In case we pass in another Language to this method it will return a <code>null</code> representation.

	 * 

	 * In case the representation becomes null, we fall back to the latin representation.

	 * 

	 */

	@Override

	public Representation getRepresentation(Language lang) {

		Representation representation = super.getRepresentation(lang);

		if(representation == null){

			representation = super.getRepresentation(Language.LATIN());

		}

		return representation; 

	}

}