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 org.apache.log4j.Logger;

import javax.xml.bind.annotation.XmlAccessorType;

import javax.xml.bind.annotation.XmlElement;

import javax.xml.bind.annotation.XmlElementWrapper;

import javax.xml.bind.annotation.XmlIDREF;

import javax.xml.bind.annotation.XmlRootElement;

import javax.xml.bind.annotation.XmlSchemaType;

/**

 * decision keys (as opposed to {@link FeatureTree multiple-access keys}) used to identify

 * {@link SpecimenOrObservationBase specimens or observations} (this means to assign {@link Taxon taxa} to).

 * The determination process is based on the tree structure of the key and on

 * the statements of its leads.

 * @author m.doering 

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

 */

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

    "taxonomicScope",

    "geoScopes"

@XmlRootElement(name = "IdentificationKey")

	@SuppressWarnings("unused")

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

     * FIXME - shouldn't this be @ManyToMany - i.e. many keys can refer to the

	 * same taxon and some taxa will be covered by multiple keys?

	 */

	@XmlElement(name = "CoveredTaxon")

	@XmlIDREF

	@XmlSchemaType(name = "IDREF")

	@XmlElement( name = "GeoScope")

	@XmlSchemaType(name = "IDREF")

	@XmlElementWrapper(name = "TaxonomicScope")

	@XmlElement(name = "Taxon")

	@XmlIDREF

	@XmlSchemaType(name = "IDREF")

	@JoinTable(

	        name="IdentificationKey_Taxon",

	        joinColumns=@JoinColumn(name="identificationKey_fk"),

	        inverseJoinColumns=@JoinColumn(name="taxon_fk")

	)

	 * Class constructor: creates a new empty identification key instance.

	 */

		super();

	}

	/** 

	 * Creates a new empty identification key instance.

	 */

	public static IdentificationKey NewInstance(){

		return new IdentificationKey();

	}

	 * Returns the set of possible {@link Taxon taxa} corresponding to

	 * <i>this</i> identification key.

	 */

		return coveredTaxa;

	}

	 * @see	#getCoveredTaxa() 

	 */

		this.coveredTaxa = coveredTaxa;

	}

	 * Adds a {@link Taxon taxa} to the set of {@link #getCoveredTaxa() covered taxa}

	 * corresponding to <i>this</i> identification key.

	 * 

	 * @param	taxon	the taxon to be added to <i>this</i> identification key

	 * @see    	   		#getCoveredTaxa()

	 */

		this.coveredTaxa.add(taxon);

	}

	 * Removes one element from the set of {@link #getCoveredTaxa() covered taxa}

	 * corresponding to <i>this</i> identification key.

	 *

	 * @param	taxon	the taxon which should be removed

	 * @see     		#getCoveredTaxa()

	 * @see     		#addCoveredTaxon(Taxon)

	 */

		this.coveredTaxa.remove(taxon);

	}

	 * Returns the set of {@link NamedArea named areas} indicating the geospatial

	 * data where <i>this</i> identification key is valid.

	 */

	public Set<NamedArea> getGeoScopes() {

		return geoScopes;

	}

	/**

	 * Adds a {@link NamedArea geoScope} to the set of {@link #getGeoScopes() geogspatial scopes}

	 * corresponding to <i>this</i> identification key.

	 * 

	 * @param	geoScope	the named area to be added to <i>this</i> identification key

	 * @see    	   		 	#getGeoScopes()

	 */

	public void addGeoScope(NamedArea geoScope) {

		this.geoScopes.add(geoScope);

	}

	/** 

	 * Removes one element from the set of {@link #getGeoScopes() geogspatial scopes}

	 * corresponding to <i>this</i> identification key.

	 *

	 * @param	geoScope	the named area which should be removed

	 * @see     			#getGeoScopes()

	 * @see     			#addGeoScope(NamedArea)

	 */

	public void removeGeoScope(NamedArea geoScope) {

		this.geoScopes.remove(geoScope);

	}

	/** 

	 * Returns the set of {@link Taxon taxa} that define the taxonomic

	 * scope of <i>this</i> identification key 

	 */

	public Set<Taxon> getTaxonomicScope() {

		return taxonomicScope;

	}

	/**

	 * Adds a {@link Taxon taxa} to the set of {@link #getTaxonomicScope() taxonomic scopes}

	 * corresponding to <i>this</i> identification key.

	 * 

	 * @param	taxon	the taxon to be added to <i>this</i> identification key

	 * @see    	   		#getTaxonomicScope()

	 */

	public void addTaxonomicScope(Taxon taxon) {

		this.taxonomicScope.add(taxon);

	}

	/** 

	 * Removes one element from the set of {@link #getTaxonomicScope() taxonomic scopes}

	 * corresponding to <i>this</i> identification key.

	 *

	 * @param	taxon	the taxon which should be removed

	 * @see     		#getTaxonomicScope()

	 * @see     		#addTaxonomicScope(Taxon)

	 */

	public void removeTaxonomicScope(Taxon taxon) {

		this.taxonomicScope.remove(taxon);

	}