cdmlib-model/src/main/java/eu/etaxonomy/cdm/model/name/TypeDesignationStatusBase.java

   1 /**
   2 * Copyright (C) 2007 EDIT
   3 * European Distributed Institute of Taxonomy
   4 * http://www.e-taxonomy.eu
   5 *
   6 * The contents of this file are subject to the Mozilla Public License Version 1.1
   7 * See LICENSE.TXT at the top of this package for the full license terms.
   8 */
   9
  10 package eu.etaxonomy.cdm.model.name;
  11
  12 import javax.persistence.Entity;
  13 import javax.xml.bind.annotation.XmlAccessType;
  14 import javax.xml.bind.annotation.XmlAccessorType;
  15 import javax.xml.bind.annotation.XmlSeeAlso;
  16 import javax.xml.bind.annotation.XmlType;
  17
  18 import org.apache.log4j.Logger;
  19 import org.hibernate.envers.Audited;
  20
  21 import eu.etaxonomy.cdm.model.common.OrderedTermBase;
  22
  23 /**
  24  * The class representing status (categories) of {@link SpecimenTypeDesignation specimen type designations}
  25  * for a {@link TaxonNameBase taxon name} or a set of them. Within this set {@link NameRelationshipType#BASIONYM() basionyms}
  26  * or {@link NameRelationshipType#REPLACED_SYNONYM() replaced synonyms}, in case of reclassifications,
  27  * will be here referred as "type-bringing" taxon names.
  28  * <P>
  29  * The different status indicate whether the {@link eu.etaxonomy.cdm.model.occurrence.Specimen specimens} used as types
  30  * in a designation are duplicates, replacements, related specimens etc.
  31  * <P>
  32  * A standard (ordered) list of type designation status instances will be
  33  * automatically created as the project starts. But this class allows to extend
  34  * this standard list by creating new instances of additional type designation
  35  * status if needed.
  36  * <P>
  37  * This class corresponds to: <ul>
  38  * <li> NomencalturalTypeTypeTerm according to the TDWG ontology
  39  * <li> NomenclaturalTypeStatusOfUnitsEnum according to the TCS
  40  * </ul>
  41  *
  42  * @author m.doering
  43  * @version 1.0
  44  * @created 08-Nov-2007 13:07:00
  45  */
  46 @XmlAccessorType(XmlAccessType.FIELD)
  47 @XmlType(name = "TypeDesignationStatusBase")
  48 @XmlSeeAlso({
  49         NameTypeDesignationStatus.class,
  50         SpecimenTypeDesignationStatus.class
  51 })
  52 @Entity
  53 @Audited
  54 public abstract class TypeDesignationStatusBase<T extends TypeDesignationStatusBase<?>> extends OrderedTermBase<T> {
  55         static Logger logger = Logger.getLogger(TypeDesignationStatusBase.class);
  56
  57         // ************* CONSTRUCTORS *************/
  58         /**
  59          * Class constructor: creates a new empty type designation status instance.
  60          *
  61          * @see         #NameTypeDesignationStatus(String, String, String)
  62          * @see         #SpecimenTypeDesignationStatus(String, String, String)
  63          */
  64         public TypeDesignationStatusBase() {
  65         }
  66
  67
  68         /**
  69          * Class constructor: creates an additional type designation status instance
  70          * with a description (in the {@link eu.etaxonomy.cdm.model.common.Language#DEFAULT() default language}), a label
  71          * and a label abbreviation.
  72          *
  73          * @param       term             the string (in the default language) describing the
  74          *                                               new type designation status to be created
  75          * @param       label            the string identifying the new type designation
  76          *                                               status to be created
  77          * @param       labelAbbrev  the string identifying (in abbreviated form) the
  78          *                                               new type designation status to be created
  79          * @see                                  #SnameTypeDesignationStatus()
  80          * @see                                  #SpecimenTypeDesignationStatus()
  81          */
  82         public TypeDesignationStatusBase(String term, String label, String labelAbbrev) {
  83                 super(term, label, labelAbbrev);
  84         }
  85 }