newest changes for INameService.delete

[cdmlib.git] / cdmlib-services / src / main / java / eu / etaxonomy / cdm / api / service / IDescriptionService.java

diff --git a/cdmlib-services/src/main/java/eu/etaxonomy/cdm/api/service/IDescriptionService.java b/cdmlib-services/src/main/java/eu/etaxonomy/cdm/api/service/IDescriptionService.java
index ef9ea5f3bcaedcd46f0a94eec82beecacd572c2c..aee1ee08e25a767cbd399b39c7d03eb139937d5c 100644 (file)
--- a/cdmlib-services/src/main/java/eu/etaxonomy/cdm/api/service/IDescriptionService.java
+++ b/cdmlib-services/src/main/java/eu/etaxonomy/cdm/api/service/IDescriptionService.java
@@ -131,6 +131,8 @@ public interface IDescriptionService extends IIdentifiableEntityService<Descript
         * @param pageNumber The offset (in pageSize chunks) from the start of the result set (0 - based)
         * @param propertyPaths Properties to initialize in the returned entities, following the syntax described in {@link BeanInitializer#initialize(Object, List)}
         * @return a Pager containing DescriptionElementBase instances
+        * 
+        * FIXME candidate for harmonization - rename to pageDescriptionElements
         */
        public Pager<DescriptionElementBase> getDescriptionElements(DescriptionBase description,Set<Feature> features, Class<? extends DescriptionElementBase> type, Integer pageSize, Integer pageNumber, List<String> propertyPaths);
        
@@ -171,6 +173,8 @@ public interface IDescriptionService extends IIdentifiableEntityService<Descript
         * @param pageNumber The offset (in pageSize chunks) from the start of the result set (0 - based)
         * @param propertyPaths Properties to initialize in the returned entities, following the syntax described in {@link BeanInitializer#initialize(Object, List)}
         * @return a Pager containing TaxonDescription instances
+        * 
+        * FIXME candidate for harmonization - rename to pageTaxonDescriptions
         */
        public Pager<TaxonDescription> getTaxonDescriptions(Taxon taxon, Set<Scope> scopes, Set<NamedArea> geographicalScope, Integer pageSize, Integer pageNumber, List<String> propertyPaths);
        
@@ -195,6 +199,8 @@ public interface IDescriptionService extends IIdentifiableEntityService<Descript
         * @param pageNumber The offset (in pageSize chunks) from the start of the result set (0 - based)
         * @param propertyPaths Properties to initialize in the returned entities, following the syntax described in {@link BeanInitializer#initialize(Object, List)}
         * @return a Pager containing TaxonNameBase instances
+        * 
+        * FIXME candidate for harmonization - rename to pageTaxonNameDescriptions
         */
        public Pager<TaxonNameDescription> getTaxonNameDescriptions(TaxonNameBase name, Integer pageSize, Integer pageNumber, List<String> propertyPaths);
        
@@ -237,10 +243,12 @@ public interface IDescriptionService extends IIdentifiableEntityService<Descript
         * @param pageNumber The offset (in pageSize chunks) from the start of the result set (0 - based)
         * @param propertyPaths properties to initialize - see {@link BeanInitializer#initialize(Object, List)}
      * @return a Pager containing media instances
+     * 
+     * FIXME candidate for harmonization - rename to pageMedia
      */
     public Pager<Media> getMedia(DescriptionElementBase descriptionElement, Integer pageSize, Integer pageNumber, List<String> propertyPaths);
     
-    public List<DescriptionElementBase> getDescriptionElementsForTaxon(Taxon taxon, Set<Feature> features, Class<? extends DescriptionElementBase> type, Integer pageSize, Integer pageNumber, List<String> propertyPaths);
+    public <T extends DescriptionElementBase> List<T>  getDescriptionElementsForTaxon(Taxon taxon, Set<Feature> features, Class<? extends T> type, Integer pageSize, Integer pageNumber, List<String> propertyPaths);
 
        public DistributionTree getOrderedDistributions(Set<TaxonDescription> taxonDescriptions, Set<NamedAreaLevel> levels, List<String> propertyPaths);
 
@@ -258,10 +266,22 @@ public interface IDescriptionService extends IIdentifiableEntityService<Descript
 
        /**
         * Preliminary method to test whether a description contains structured data. 
-        * @deprecated The means of determining this fact may change soon, so this method is annotated a beeing deprecated.
+        * @deprecated The means of determining this fact may change soon, so this method is
+                                       annotated as being deprecated.
         * @param description
         * @return
         */
        @Deprecated
        public boolean hasStructuredData(DescriptionBase<?> description);
+       
+       /**
+        * Add the collection of {@link DescriptionElementBase description elements} to the <code>targetDescription</code>.
+        * Remove the description elements from the description they are currently associated with. 
+        * 
+        * @param descriptionElements
+        * @param targetDescription
+        * @param isPaste if true, the elements are only copied (cloned) and not removed from the
+        *      old description
+        */
+       public void moveDescriptionElementsToDescription(Collection<DescriptionElementBase> descriptionElements, DescriptionBase targetDescription, boolean isPaste);
 }
\ No newline at end of file