3 * Copyright (C) 2007 EDIT
4 * European Distributed Institute of Taxonomy
5 * http://www.e-taxonomy.eu
7 * The contents of this file are subject to the Mozilla Public License Version 1.1
8 * See LICENSE.TXT at the top of this package for the full license terms.
11 package eu
.etaxonomy
.cdm
.api
.service
;
13 import java
.util
.Collection
;
14 import java
.util
.List
;
17 import java
.util
.UUID
;
19 import eu
.etaxonomy
.cdm
.api
.service
.pager
.Pager
;
20 import eu
.etaxonomy
.cdm
.api
.utility
.DescriptionUtility
;
21 import eu
.etaxonomy
.cdm
.model
.common
.Annotation
;
22 import eu
.etaxonomy
.cdm
.model
.common
.DefinedTerm
;
23 import eu
.etaxonomy
.cdm
.model
.common
.Language
;
24 import eu
.etaxonomy
.cdm
.model
.common
.Marker
;
25 import eu
.etaxonomy
.cdm
.model
.common
.MarkerType
;
26 import eu
.etaxonomy
.cdm
.model
.common
.TermVocabulary
;
27 import eu
.etaxonomy
.cdm
.model
.description
.DescriptionBase
;
28 import eu
.etaxonomy
.cdm
.model
.description
.DescriptionElementBase
;
29 import eu
.etaxonomy
.cdm
.model
.description
.Distribution
;
30 import eu
.etaxonomy
.cdm
.model
.description
.Feature
;
31 import eu
.etaxonomy
.cdm
.model
.description
.FeatureTree
;
32 import eu
.etaxonomy
.cdm
.model
.description
.PresenceAbsenceTerm
;
33 import eu
.etaxonomy
.cdm
.model
.description
.TaxonDescription
;
34 import eu
.etaxonomy
.cdm
.model
.description
.TaxonNameDescription
;
35 import eu
.etaxonomy
.cdm
.model
.location
.NamedArea
;
36 import eu
.etaxonomy
.cdm
.model
.location
.NamedAreaLevel
;
37 import eu
.etaxonomy
.cdm
.model
.media
.Media
;
38 import eu
.etaxonomy
.cdm
.model
.name
.TaxonNameBase
;
39 import eu
.etaxonomy
.cdm
.model
.taxon
.Taxon
;
40 import eu
.etaxonomy
.cdm
.persistence
.dao
.initializer
.IBeanInitializer
;
41 import eu
.etaxonomy
.cdm
.persistence
.dto
.TermDto
;
42 import eu
.etaxonomy
.cdm
.persistence
.query
.OrderHint
;
44 public interface IDescriptionService
extends IIdentifiableEntityService
<DescriptionBase
> {
49 * @deprecated use TermService#getVocabulary(VocabularyType) instead
52 public TermVocabulary
<Feature
> getDefaultFeatureVocabulary();
55 * @deprecated use TermService#getVocabulary(VocabularyType) instead
58 public TermVocabulary
<Feature
> getFeatureVocabulary(UUID uuid
);
61 * Gets a DescriptionElementBase instance matching the supplied uuid
63 * @param uuid the uuid of the DescriptionElement of interest
64 * @return a DescriptionElement, or null if the DescriptionElement does not exist
66 public DescriptionElementBase
getDescriptionElementByUuid(UUID uuid
);
69 * Loads and existing DescriptionElementBase instance matching the supplied uuid,
70 * and recursively initializes all bean properties given in the
71 * <code>propertyPaths</code> parameter.
73 * For detailed description and examples <b>please refer to:</b>
74 * {@link IBeanInitializer#initialize(Object, List)}
76 * @param uuid the uuid of the DescriptionElement of interest
77 * @return a DescriptionElement, or null if the DescriptionElement does not exist
79 public DescriptionElementBase
loadDescriptionElement(UUID uuid
,List
<String
> propertyPaths
);
82 * Persists a <code>DescriptionElementBase</code>
83 * @param descriptionElement
86 public UUID
saveDescriptionElement(DescriptionElementBase descriptionElement
);
89 * Persists a collection of <code>DescriptionElementBase</code>
90 * @param descriptionElements
93 public Map
<UUID
, DescriptionElementBase
> saveDescriptionElement(Collection
<DescriptionElementBase
> descriptionElements
);
96 * Delete an existing description element
98 * @param descriptionElement the description element to be deleted
99 * @return the unique identifier of the deleted entity
101 public UUID
deleteDescriptionElement(DescriptionElementBase descriptionElement
);
103 public UUID
deleteDescriptionElement(UUID descriptionElementUuid
);
106 * List the descriptions of type <T>, filtered using the following parameters
108 * @param type The type of description returned (Taxon, TaxonName, or Specimen)
109 * @param hasMedia Restrict the description to those that do (true) or don't (false) contain <i>elements</i> that have one or more media (can be null)
110 * @param hasText Restrict the description to those that do (true) or don't (false) contain TextData <i>elements</i> that have some textual content (can be null)
111 * @param feature Restrict the description to those <i>elements</i> which are scoped by one of the Features passed (can be null or empty)
112 * @param pageSize The maximum number of descriptions returned (can be null for all descriptions)
113 * @param pageNumber The offset (in pageSize chunks) from the start of the result set (0 - based)
114 * @param orderHints may be null
115 * @param propertyPaths properties to initialize - see {@link IBeanInitializer#initialize(Object, List)}
116 * @return a Pager containing DescriptionBase instances
118 public Pager
<DescriptionBase
> page(Class
<?
extends DescriptionBase
> type
, Boolean hasMedia
, Boolean hasText
, Set
<Feature
> feature
, Integer pageSize
, Integer pageNumber
, List
<OrderHint
> orderHints
, List
<String
> propertyPaths
);
121 * Count the descriptions of type <TYPE>, filtered using the following parameters
123 * @param type The type of description returned (Taxon, TaxonName, or Specimen)
124 * @param hasMedia Restrict the description to those that do (true) or don't (false) contain <i>elements</i> that have one or more media (can be null)
125 * @param hasText Restrict the description to those that do (true) or don't (false) contain TextData <i>elements</i> that have some textual content (can be null)
126 * @param feature Restrict the description to those <i>elements</i> which are scoped by one of the Features passed (can be null or empty)
127 * @return a count of DescriptionBase instances
129 public int count(Class
<?
extends DescriptionBase
> type
, Boolean hasImages
, Boolean hasText
, Set
<Feature
> feature
);
132 * Returns description elements of type <TYPE>, belonging to a given
133 * description, optionally filtered by one or more features
136 * The description which these description elements belong to
137 * (can be null to count all description elements)
138 * @param descriptionType
139 * A filter DescriptionElements which belong to of a specific
140 * class of Descriptions
142 * Restrict the results to those description elements which are
143 * scoped by one of the Features passed (can be null or empty)
145 * A filter for DescriptionElements of a specific class
147 * The maximum number of description elements returned (can be
148 * null for all description elements)
150 * The offset (in pageSize chunks) from the start of the result
152 * @param propertyPaths
153 * Properties to initialize in the returned entities, following
154 * the syntax described in
155 * {@link IBeanInitializer#initialize(Object, List)}
156 * @return a Pager containing DescriptionElementBase instances
159 * {@link #pageDescriptionElements(DescriptionBase, Set, Class, Integer, Integer, List)}
163 public Pager
<DescriptionElementBase
> getDescriptionElements(DescriptionBase description
,Set
<Feature
> features
, Class
<?
extends DescriptionElementBase
> type
, Integer pageSize
, Integer pageNumber
, List
<String
> propertyPaths
);
167 * Returns description elements of type <TYPE>, belonging to a given
168 * description, optionally filtered by one or more features
171 * The description which these description elements belong to
172 * (can be null to count all description elements)
173 * @param descriptionType
174 * A filter DescriptionElements which belong to of a specific
175 * class of Descriptions
177 * Restrict the results to those description elements which are
178 * scoped by one of the Features passed (can be null or empty)
180 * A filter for DescriptionElements of a specific class
182 * The maximum number of description elements returned (can be
183 * null for all description elements)
185 * The offset (in pageSize chunks) from the start of the result
187 * @param propertyPaths
188 * Properties to initialize in the returned entities, following
189 * the syntax described in
190 * {@link IBeanInitializer#initialize(Object, List)}
192 * @return a Pager containing DescriptionElementBase instances
194 public Pager
<DescriptionElementBase
> pageDescriptionElements(DescriptionBase description
, Class
<?
extends DescriptionBase
> descriptionType
, Set
<Feature
> features
, Class
<?
extends DescriptionElementBase
> type
, Integer pageSize
, Integer pageNumber
, List
<String
> propertyPaths
);
197 * Returns description elements of type <TYPE>, belonging to a given
198 * description, optionally filtered by one or more features
201 * The description which these description elements belong to
202 * (can be null to count all description elements)
204 * Restrict the results to those description elements which are
205 * scoped by one of the Features passed (can be null or empty)
207 * A filter for DescriptionElements of a specific class
209 * The maximum number of description elements returned (can be
210 * null for all description elements)
212 * The offset (in pageSize chunks) from the start of the result
214 * @param propertyPaths
215 * Properties to initialize in the returned entities, following
216 * the syntax described in
217 * {@link IBeanInitializer#initialize(Object, List)}
218 * @return a List of DescriptionElementBase instances
219 * @deprecated use {@link #listDescriptionElements(DescriptionBase, Class, Set, Class, Integer, Integer, List)} instead
222 public List
<DescriptionElementBase
> listDescriptionElements(DescriptionBase description
,Set
<Feature
> features
, Class
<?
extends DescriptionElementBase
> type
, Integer pageSize
, Integer pageNumber
, List
<String
> propertyPaths
);
225 * Returns description elements of type <TYPE>, belonging to a given
226 * description, optionally filtered by one or more features
229 * The description which these description elements belong to
230 * (can be null to count all description elements)
232 * Restrict the results to those description elements which are
233 * scoped by one of the Features passed (can be null or empty)
235 * A filter DescriptionElements of a for specific class
237 * The maximum number of description elements returned (can be
238 * null for all description elements)
240 * The offset (in pageSize chunks) from the start of the result
242 * @param propertyPaths
243 * Properties to initialize in the returned entities, following
244 * the syntax described in
245 * {@link IBeanInitializer#initialize(Object, List)}
246 * @return a List of DescriptionElementBase instances
248 public List
<DescriptionElementBase
> listDescriptionElements(DescriptionBase description
, Class
<?
extends DescriptionBase
> descriptionType
, Set
<Feature
> features
, Class
<?
extends DescriptionElementBase
> type
, Integer pageSize
, Integer pageNumber
, List
<String
> propertyPaths
);
251 * Return a Pager containing Annotation entities belonging to the DescriptionElementBase instance supplied, optionally filtered by MarkerType
252 * @param annotatedObj The object that "owns" the annotations returned
253 * @param status Only return annotations which are marked with a Marker of this type (can be null to return all annotations)
254 * @param pageSize The maximum number of terms returned (can be null for all annotations)
255 * @param pageNumber The offset (in pageSize chunks) from the start of the result set (0 - based)
256 * @param orderHints may be null
257 * @param propertyPaths properties to initialize - see {@link IBeanInitializer#initialize(Object, List)}
258 * @return a Pager of Annotation entities
260 public Pager
<Annotation
> getDescriptionElementAnnotations(DescriptionElementBase annotatedObj
, MarkerType status
, Integer pageSize
, Integer pageNumber
, List
<OrderHint
> orderHints
, List
<String
> propertyPaths
);
264 * Returns a List of TaxonDescription instances, optionally filtered by parameters passed to this method
266 * @param taxon The taxon which the description refers to (can be null for all TaxonDescription instances)
267 * @param scopes Restrict the results to those descriptions which are scoped by one of the Scope instances passed (can be null or empty)
268 * @param geographicalScope Restrict the results to those descriptions which have a geographical scope that overlaps with the NamedArea instances passed (can be null or empty)
269 * @param pageSize The maximum number of descriptions returned (can be null for all descriptions)
270 * @param pageNumber The offset (in pageSize chunks) from the start of the result set (0 - based)
271 * @param propertyPaths Properties to initialize in the returned entities, following the syntax described in {@link IBeanInitializer#initialize(Object, List)}
272 * @return a Pager containing TaxonDescription instances
274 * @see #pageMarkedTaxonDescriptions(Taxon, Set, Set, Set, Integer, Integer, List)
276 public Pager
<TaxonDescription
> pageTaxonDescriptions(Taxon taxon
, Set
<DefinedTerm
> scopes
, Set
<NamedArea
> geographicalScope
, Integer pageSize
, Integer pageNumber
, List
<String
> propertyPaths
);
279 * Returns a List of TaxonDescription instances, optionally filtered by parameters passed to this method
281 * @param taxon The taxon which the description refers to (can be null for all TaxonDescription instances)
282 * @param scopes Restrict the results to those descriptions which are scoped by one of the Scope instances passed (can be null or empty)
283 * @param geographicalScope Restrict the results to those descriptions which have a geographical scope that overlaps with the NamedArea instances passed (can be null or empty)
284 * @param markerType Restrict the results to those descriptions which are marked as true by one of the given marker types (can be null or empty)
285 * @param pageSize The maximum number of descriptions returned (can be null for all descriptions)
286 * @param pageNumber The offset (in pageSize chunks) from the start of the result set (0 - based)
287 * @param propertyPaths Properties to initialize in the returned entities, following the syntax described in {@link IBeanInitializer#initialize(Object, List)}
288 * @return a Pager containing TaxonDescription instances
290 public Pager
<TaxonDescription
> pageTaxonDescriptions(Taxon taxon
, Set
<DefinedTerm
> scopes
, Set
<NamedArea
> geographicalScope
, Set
<MarkerType
> markerTypes
, Integer pageSize
, Integer pageNumber
, List
<String
> propertyPaths
);
293 * @see {@link #pageTaxonDescriptions(Taxon, Set, Set, Integer, Integer, List)}
297 * @param geographicalScope
300 * @param propertyPaths
303 public List
<TaxonDescription
> listTaxonDescriptions(Taxon taxon
, Set
<DefinedTerm
> scopes
, Set
<NamedArea
> geographicalScope
, Integer pageSize
, Integer pageNumber
, List
<String
> propertyPaths
);
308 * @see {@link #pageMarkedTaxonDescriptions(Taxon, Set, Set, Set, Integer, Integer, List)}
312 * @param geographicalScope
315 * @param propertyPaths
318 public List
<TaxonDescription
> listTaxonDescriptions(Taxon taxon
, Set
<DefinedTerm
> scopes
, Set
<NamedArea
> geographicalScope
, Set
<MarkerType
> markerTypes
, Integer pageSize
, Integer pageNumber
, List
<String
> propertyPaths
);
321 * Returns all {@link Media} attached to a taxon via TaxonDescription.elements.media.
322 * @param taxonUuid the taxons uuid, if null media for all taxa are returned
323 * @param limitToGalleries if true only media in TaxonDescriptions with imageGallery flag=true are returned
324 * @param markerTypes only media for TaxonDescriptions with marker of type markerType and marker.flag=true are returned, one matching marker type is sufficient
327 * @param propertyPaths Properties to initialize in the returned entities, following the syntax described in {@link IBeanInitializer#initialize(Object, List)}
330 public List
<Media
> listTaxonDescriptionMedia(UUID taxonUuid
, boolean limitToGalleries
, Set
<MarkerType
> markerTypes
, Integer pageSize
, Integer pageNumber
, List
<String
> propertyPaths
);
333 * Returns count for all {@link Media} attached to a taxon via TaxonDescription.elements.media.
334 * @param taxonUuid the taxons uuid, if null media for all taxa are returned
335 * @param limitToGalleries if true only media in TaxonDescriptions with imageGallery flag=true are returned
336 * @param markerTypes only media for TaxonDescriptions with marker of type markerType and marker.flag=true are returned, one matching marker type is sufficient
339 public int countTaxonDescriptionMedia(UUID taxonUuid
, boolean limitToGalleries
, Set
<MarkerType
> markerTypes
);
344 * Returns a List of TaxonNameDescription instances, optionally filtered by the name which they refer to
346 * @param name Restrict the results to those descriptions that refer to a specific name (can be null for all TaxonNameDescription instances)
347 * @param pageSize The maximum number of descriptions returned (can be null for all descriptions)
348 * @param pageNumber The offset (in pageSize chunks) from the start of the result set (0 - based)
349 * @param propertyPaths Properties to initialize in the returned entities, following the syntax described in {@link IBeanInitializer#initialize(Object, List)}
350 * @return a Pager containing TaxonNameBase instances
352 * FIXME candidate for harmonization - rename to pageTaxonNameDescriptions
354 public Pager
<TaxonNameDescription
> getTaxonNameDescriptions(TaxonNameBase name
, Integer pageSize
, Integer pageNumber
, List
<String
> propertyPaths
);
358 * Returns a List of distinct TaxonDescription instances which have Distribution elements that refer to one of the NamedArea instances passed (optionally
359 * filtered by a type of PresenceAbsenceTerm e.g. PRESENT / ABSENT / NATIVE / CULTIVATED etc)
361 * @param namedAreas The set of NamedArea instances
362 * @param presence Restrict the descriptions to those which have Distribution elements are of this status (can be null)
363 * @param pageSize The maximum number of descriptions returned (can be null for all descriptions)
364 * @param pageNumber The offset (in pageSize chunks) from the start of the result set (0 - based)
365 * @param pageNumber The offset (in pageSize chunks) from the start of the result set (0 - based)
366 * @param propertyPaths Properties to initialize in the returned entities, following the syntax described in {@link IBeanInitializer#initialize(Object, List)}
367 * @return a Pager containing TaxonDescription instances
369 public Pager
<TaxonDescription
> searchDescriptionByDistribution(Set
<NamedArea
> namedAreas
, PresenceAbsenceTerm presence
, Integer pageSize
, Integer pageNumber
, List
<OrderHint
> orderHints
, List
<String
> propertyPaths
);
372 * Returns a Paged List of DescriptionElementBase instances where the default field matches the String queryString (as interpreted by the Lucene QueryParser)
374 * @param clazz filter the results by class (or pass null to return all DescriptionElementBase instances)
376 * @param pageSize The maximum number of descriptionElements returned (can be null for all matching descriptionElements)
377 * @param pageNumber The offset (in pageSize chunks) from the start of the result set (0 - based)
379 * Supports path like <code>orderHints.propertyNames</code> which
380 * include *-to-one properties like createdBy.username or
381 * authorTeam.persistentTitleCache
382 * @param propertyPaths properties to be initialized
383 * @return a Pager DescriptionElementBase instances
384 * @see <a href="http://lucene.apache.org/java/2_4_0/queryparsersyntax.html">Apache Lucene - Query Parser Syntax</a>
386 public Pager
<DescriptionElementBase
> searchElements(Class
<?
extends DescriptionElementBase
> clazz
, String queryString
, Integer pageSize
, Integer pageNumber
, List
<OrderHint
> orderHints
, List
<String
> propertyPaths
);
389 * Returns a List of Media that are associated with a given description element
391 * @param descriptionElement the description element associated with these media
392 * @param pageSize The maximum number of media returned (can be null for all related media)
393 * @param pageNumber The offset (in pageSize chunks) from the start of the result set (0 - based)
394 * @param propertyPaths properties to initialize - see {@link IBeanInitializer#initialize(Object, List)}
395 * @return a Pager containing media instances
397 * FIXME candidate for harmonization - rename to pageMedia
399 public Pager
<Media
> getMedia(DescriptionElementBase descriptionElement
, Integer pageSize
, Integer pageNumber
, List
<String
> propertyPaths
);
402 * Provides access to all DescriptionElements associated with the given Taxon
403 * via a TaxonDescrition.
406 * The Taxon to return Description elements for
408 * Restrict the results to those description elements which are
409 * scoped by one of the Features passed (can be null or empty)
411 * A filter for DescriptionElements of a specific class
413 * The maximum number of description elements returned (can be
414 * null for all description elements)
416 * The offset (in pageSize chunks) from the start of the result
418 * @param propertyPaths
419 * Properties to initialize in the returned entities, following
420 * the syntax described in
421 * {@link IBeanInitializer#initialize(Object, List)}
422 * @return a List containing all matching DescriptionElementBase instances
424 * @deprecated use {@link #listDescriptionElementsForTaxon(Taxon, Set, Class, Integer, Integer, List)} instead
427 public <T
extends DescriptionElementBase
> List
<T
> getDescriptionElementsForTaxon(Taxon taxon
, Set
<Feature
> features
, Class
<T
> type
, Integer pageSize
, Integer pageNumber
, List
<String
> propertyPaths
);
430 * Provides access to all DescriptionElements associated with the given Taxon
431 * via a TaxonDescrition.
434 * The Taxon to return Description elements for
436 * Restrict the results to those description elements which are
437 * scoped by one of the Features passed (can be null or empty)
439 * A filter for DescriptionElements of a specific class
441 * The maximum number of description elements returned (can be
442 * null for all description elements)
444 * The offset (in pageSize chunks) from the start of the result
446 * @param propertyPaths
447 * Properties to initialize in the returned entities, following
448 * the syntax described in
449 * {@link IBeanInitializer#initialize(Object, List)}
450 * @return a List containing all matching DescriptionElementBase instances
453 public <T
extends DescriptionElementBase
> List
<T
> listDescriptionElementsForTaxon(Taxon taxon
, Set
<Feature
> features
, Class
<T
> type
, Integer pageSize
, Integer pageNumber
, List
<String
> propertyPaths
);
456 * Provides access to all DescriptionElements associated with the given Taxon
457 * via a TaxonDescrition.
460 * The Taxon to return Description elements for
462 * Restrict the results to those description elements which are
463 * scoped by one of the Features passed (can be null or empty)
465 * A filter for DescriptionElements of a specific class
467 * The maximum number of description elements returned
469 * The offset (in pageSize chunks) from the start of the result
471 * @param propertyPaths
472 * Properties to initialize in the returned entities, following
473 * the syntax described in
474 * {@link IBeanInitializer#initialize(Object, List)}
475 * @return a Pager for all matching DescriptionElementBase instances
478 public <T
extends DescriptionElementBase
> Pager
<T
> pageDescriptionElementsForTaxon(Taxon taxon
, Set
<Feature
> features
, Class
<T
> type
, Integer pageSize
, Integer pageNumber
, List
<String
> propertyPaths
);
482 * @param taxonDescriptions
483 * @param subAreaPreference
484 * enables the <b>Sub area preference rule</b> if set to true,
485 * see {@link DescriptionUtility#filterDistributions(Collection,
488 * @param statusOrderPreference
489 * enables the <b>Status order preference rule</b> if set to
491 * DescriptionUtility#filterDistributions(Collection, boolean,
493 * @param hideMarkedAreas
494 * distributions where the area has a {@link Marker} with one of
495 * the specified {@link MarkerType}s will be skipped, see
496 * {@link DescriptionUtility#filterDistributions(Collection, boolean, boolean, Set)}
498 * A Set NamedArea levels to omit - optional
499 * @param propertyPaths
500 * the initialization strategy
503 * @deprecated use {@link IEditGeoService#composeDistributionInfoFor()} instead
506 public DistributionTree
getOrderedDistributions(
507 Set
<TaxonDescription
> taxonDescriptions
,
508 boolean subAreaPreference
,
509 boolean statusOrderPreference
,
510 Set
<MarkerType
> hideMarkedAreas
,
511 Set
<NamedAreaLevel
> omitLevels
, List
<String
> propertyPaths
);
514 * Generate a string representation of the structured <code>description</code> supplied in natural language
515 * The <code>featureTree</code> will be used to structure the NaturalLanguageDescription.
516 * This method does not require a initialization strategy so there is no <code>propertyPaths</code> parameter.
519 * @param preferredLanguages
523 public String
generateNaturalLanguageDescription(FeatureTree featureTree
,TaxonDescription description
, List
<Language
> preferredLanguages
, String separator
);
526 * Preliminary method to test whether a description contains structured data.
527 * @deprecated The means of determining this fact may change soon, so this method is
528 annotated as being deprecated.
533 public boolean hasStructuredData(DescriptionBase
<?
> description
);
536 * Add the collection of {@link DescriptionElementBase description elements} to the <code>targetDescription</code>.
537 * Remove the description elements from the description they are currently associated with.
539 * @param descriptionElements
540 * @param targetDescription
541 * @param isPaste if true, the elements are only copied (cloned) and not removed from the
544 public void moveDescriptionElementsToDescription(Collection
<DescriptionElementBase
> descriptionElements
, DescriptionBase targetDescription
, boolean isPaste
);
547 * Pager method to get all {@link NamedAreas} instances which are currently used
548 * by {@link Distribution} elements.
551 * The maximum number of description elements returned
553 * The offset (in pageSize chunks) from the start of the result
555 * @param propertyPaths
556 * Properties to initialize in the returned entities, following
557 * the syntax described in
558 * {@link IBeanInitializer#initialize(Object, List)}
559 * @return a Pager for all NamedAreas instances which are currently in use.
562 public Pager
<TermDto
> pageNamedAreasInUse(boolean includeAllParents
, Integer pageSize
,
565 public DeleteResult
deleteDescription(DescriptionBase description
);
567 public DeleteResult
deleteDescription(UUID descriptionUuid
);
574 public UpdateResult
moveTaxonDescriptions(Taxon sourceTaxon
, Taxon targetTaxon
);
577 * @param sourceTaxonUuid
578 * @param targetTaxonUuid
581 public UpdateResult
moveTaxonDescriptions(UUID sourceTaxonUuid
, UUID targetTaxonUuid
);