updated java doc for reference interfaces

[cdmlib.git] / cdmlib-model / src / main / java / eu / etaxonomy / cdm / model / reference / Report.java

diff --git a/cdmlib-model/src/main/java/eu/etaxonomy/cdm/model/reference/Report.java b/cdmlib-model/src/main/java/eu/etaxonomy/cdm/model/reference/Report.java
index 4484411b6675b91767e090d2cd1bf853ff099cf5..6413f4ed9d97f3396302f02fa82bc86b4366d96a 100644 (file)
--- a/cdmlib-model/src/main/java/eu/etaxonomy/cdm/model/reference/Report.java
+++ b/cdmlib-model/src/main/java/eu/etaxonomy/cdm/model/reference/Report.java
@@ -11,19 +11,25 @@ package eu.etaxonomy.cdm.model.reference;
 
 
 import javax.persistence.Entity;
-import javax.persistence.ManyToOne;
+import javax.xml.bind.annotation.XmlAccessType;
+import javax.xml.bind.annotation.XmlAccessorType;
+import javax.xml.bind.annotation.XmlRootElement;
+import javax.xml.bind.annotation.XmlType;
 
 import org.apache.log4j.Logger;
-import org.hibernate.annotations.Cascade;
-import org.hibernate.annotations.CascadeType;
+import org.hibernate.envers.Audited;
+import org.hibernate.search.annotations.Indexed;
+import org.springframework.beans.factory.annotation.Configurable;
 
 import eu.etaxonomy.cdm.model.agent.Institution;
+import eu.etaxonomy.cdm.strategy.cache.reference.IReferenceBaseCacheStrategy;
+import eu.etaxonomy.cdm.strategy.cache.reference.ReferenceBaseDefaultCacheStrategy;
 
 /**
  * This class represents reports. A report is a document characterized by 
  * information reflective of inquiry or investigation. Reports often address
  * questions posed by individuals in government or science and are generally
- * elaborated within an {@link agent.Institution institution}.
+ * elaborated within an {@link eu.etaxonomy.cdm.model.agent.Institution institution}.
  * <P>
  * This class corresponds, according to the TDWG ontology, to the publication type
  * term (from PublicationTypeTerm): "Report".
@@ -32,11 +38,35 @@ import eu.etaxonomy.cdm.model.agent.Institution;
  * @version 1.0
  * @created 08-Nov-2007 13:06:49
  */
+@XmlAccessorType(XmlAccessType.FIELD)
+@XmlType(name = "Report", propOrder = {
+//    "institution"
+})
+@XmlRootElement(name = "Report")
 @Entity
-public class Report extends PublicationBase implements Cloneable {
-       static Logger logger = Logger.getLogger(Report.class);
-       private Institution institution;
+@Indexed(index = "eu.etaxonomy.cdm.model.reference.ReferenceBase")
+@Audited
+@Configurable
+@Deprecated
+public class Report extends PublicationBase<IReferenceBaseCacheStrategy<Report>> implements Cloneable {
+       private static final long serialVersionUID = 2224085476416095383L;
+       @SuppressWarnings("unused")
+       private static final Logger logger = Logger.getLogger(Report.class);
+       
+//     @XmlElement(name = "Institution")
+//     @XmlIDREF
+//     @XmlSchemaType(name = "IDREF")
+//     @ManyToOne(fetch = FetchType.LAZY)
+//     @IndexedEmbedded
+//     @Cascade(CascadeType.SAVE_UPDATE)
+//     private Institution institution;
 
+       protected Report() {
+               super();
+               this.type = ReferenceType.Report;
+               this.cacheStrategy = new ReferenceBaseDefaultCacheStrategy<Report>();
+       }
+       
        /** 
         * Creates a new empty report instance
         * 
@@ -48,7 +78,7 @@ public class Report extends PublicationBase implements Cloneable {
        }
        
        /** 
-        * Creates a new report instance with the given {@link agent.Institution institution}.
+        * Creates a new report instance with the given {@link eu.etaxonomy.cdm.model.agent.Institution institution}.
         * 
         * @param       institution             the institution where <i>this</i> report has
         *                                                      been elaborated
@@ -62,49 +92,34 @@ public class Report extends PublicationBase implements Cloneable {
        
        
        /**
-        * Returns the {@link agent.Institution institution} in which <i>this</i>
+        * Returns the {@link eu.etaxonomy.cdm.model.agent.Institution institution} in which <i>this</i>
         * report has been elaborated.
         * 
         * @return  the institution
-        * @see         agent.Institution
+        * @see         eu.etaxonomy.cdm.model.agent.Institution
         */
-       @ManyToOne
-       @Cascade({CascadeType.SAVE_UPDATE})
        public Institution getInstitution(){
                return this.institution;
        }
+       
        /**
         * @see #getInstitution()
         */
        public void setInstitution(Institution institution){
                this.institution = institution;
        }
-
-       /**
-        * Generates, according to the {@link strategy.cache.reference.IReferenceBaseCacheStrategy cache strategy}
-        * assigned to <i>this</i> report, a string that identifies <i>this</i>
-        * report 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
-        * ReferenceBase#generateTitle() method.
-        *
-        * @return  the string identifying <i>this</i> report
-        * @see         ReferenceBase#generateTitle()
-        * @see         common.IdentifiableEntity#getTitleCache()
-        * @see         common.IdentifiableEntity#generateTitle()
-        * @see         strategy.cache.common.IIdentifiableEntityCacheStrategy#getTitleCache()
-        */
        
-       @Override
-       public String generateTitle(){
-               //TODO is this method really needed or is ReferenceBase#generateTitle() enough?
-               logger.warn("generate Title not yet implemented");
-               return "";
-       }
-       
-       /* (non-Javadoc)
-        * @see eu.etaxonomy.cdm.model.reference.PublicationBase#clone()
+       /** 
+        * Clones <i>this</i> report instance. This is a shortcut that enables to
+        * create a new instance that differs only slightly from <i>this</i>
+        * report instance by modifying only some of the attributes.<BR>
+        * This method overrides the clone method from {@link PublicationBase PublicationBase}.
+        * 
+        * @see PublicationBase#clone()
+        * @see eu.etaxonomy.cdm.model.media.IdentifiableMediaEntity#clone()
+        * @see java.lang.Object#clone()
         */
+       @Override
        public Report clone(){
                Report result = (Report)super.clone();
                //no changes to: institution