-
- /**
- *
- * @return
- * @deprecated use TermService#getVocabulary(VocabularyType) instead
- */
- public TermVocabulary<Feature> getDefaultFeatureVocabulary();
-
- /**
- * @deprecated use TermService#getVocabulary(VocabularyType) instead
- */
- public TermVocabulary<Feature> getFeatureVocabulary(UUID uuid);
-
- /**
- * Gets a DescriptionElementBase instance matching the supplied uuid
- *
- * @param uuid the uuid of the DescriptionElement of interest
- * @return a DescriptionElement, or null if the DescriptionElement does not exist
- */
- public DescriptionElementBase getDescriptionElementByUuid(UUID uuid);
-
- /**
- * Loads and existing DescriptionElementBase instance matching the supplied uuid,
- * and recursively initializes all bean properties given in the
- * <code>propertyPaths</code> parameter.
- * <p>
- * For detailed description and examples <b>please refer to:</b>
- * {@link BeanInitializer#initialize(Object, List)}
- *
- * @param uuid the uuid of the DescriptionElement of interest
- * @return a DescriptionElement, or null if the DescriptionElement does not exist
- */
- public DescriptionElementBase loadDescriptionElement(UUID uuid,List<String> propertyPaths);
-
- /**
- * Persists a <code>DescriptionElementBase</code>
- * @param descriptionElement
- * @return
- */
- public UUID saveDescriptionElement(DescriptionElementBase descriptionElement);
-
- /**
- * Persists a collection of <code>DescriptionElementBase</code>
- * @param descriptionElements
- * @return
- */
- public Map<UUID, DescriptionElementBase> saveDescriptionElement(Collection<DescriptionElementBase> descriptionElements);
-
- /**
- * Delete an existing description element
- *
- * @param descriptionElement the description element to be deleted
- * @return the unique identifier of the deleted entity
- */
- public UUID deleteDescriptionElement(DescriptionElementBase descriptionElement);
-
- /**
- * List the descriptions of type <T>, filtered using the following parameters
- *
- * @param type The type of description returned (Taxon, TaxonName, or Specimen)
- * @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)
- * @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)
- * @param feature Restrict the description to those <i>elements</i> which are scoped by one of the Features passed (can be null or empty)
- * @param pageSize The maximum number of descriptions returned (can be null for all descriptions)
- * @param pageNumber The offset (in pageSize chunks) from the start of the result set (0 - based)
- * @param orderHints may be null
- * @param propertyPaths properties to initialize - see {@link BeanInitializer#initialize(Object, List)}
- * @return a Pager containing DescriptionBase instances
- */
- 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);
-
- /**
- * Count the descriptions of type <TYPE>, filtered using the following parameters
- *
- * @param type The type of description returned (Taxon, TaxonName, or Specimen)
- * @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)
- * @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)
- * @param feature Restrict the description to those <i>elements</i> which are scoped by one of the Features passed (can be null or empty)
- * @return a count of DescriptionBase instances
- */
- public int count(Class<? extends DescriptionBase> type, Boolean hasImages, Boolean hasText, Set<Feature> feature);
-
- /**
- * Returns description elements of type <TYPE>, belonging to a given description, optionally filtered by one or more features
- *
- * @param description The description which these description elements belong to (can be null to count all description elements)
- * @param features Restrict the results to those description elements which are scoped by one of the Features passed (can be null or empty)
- * @param type The type of description
- * @param class
- * @param pageSize The maximum number of description elements returned (can be null for all description elements)
- * @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
- */
- public Pager<DescriptionElementBase> getDescriptionElements(DescriptionBase description,Set<Feature> features, Class<? extends DescriptionElementBase> type, Integer pageSize, Integer pageNumber, List<String> propertyPaths);
-
- /**
- * Returns description elements of type <TYPE>, belonging to a given description, optionally filtered by one or more features
- *
- * @param description The description which these description elements belong to (can be null to count all description elements)
- * @param features Restrict the results to those description elements which are scoped by one of the Features passed (can be null or empty)
- * @param type The type of description
- * @param class
- * @param pageSize The maximum number of description elements returned (can be null for all description elements)
- * @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 List containing DescriptionElementBase instances
- */
- public List<DescriptionElementBase> listDescriptionElements(DescriptionBase description,Set<Feature> features, Class<? extends DescriptionElementBase> type, Integer pageSize, Integer pageNumber, List<String> propertyPaths);
-
- /**
- * Return a Pager containing Annotation entities belonging to the DescriptionElementBase instance supplied, optionally filtered by MarkerType
+
+ /**
+ *
+ * @return
+ * @deprecated use TermService#getVocabulary(VocabularyType) instead
+ */
+ @Deprecated
+ public TermVocabulary<Feature> getDefaultFeatureVocabulary();
+
+ /**
+ * @deprecated use TermService#getVocabulary(VocabularyType) instead
+ */
+ @Deprecated
+ public TermVocabulary<Feature> getFeatureVocabulary(UUID uuid);
+
+ /**
+ * Gets a DescriptionElementBase instance matching the supplied uuid
+ *
+ * @param uuid the uuid of the DescriptionElement of interest
+ * @return a DescriptionElement, or null if the DescriptionElement does not exist
+ */
+ public DescriptionElementBase getDescriptionElementByUuid(UUID uuid);
+
+ /**
+ * Loads and existing DescriptionElementBase instance matching the supplied uuid,
+ * and recursively initializes all bean properties given in the
+ * <code>propertyPaths</code> parameter.
+ * <p>
+ * For detailed description and examples <b>please refer to:</b>
+ * {@link IBeanInitializer#initialize(Object, List)}
+ *
+ * @param uuid the uuid of the DescriptionElement of interest
+ * @return a DescriptionElement, or null if the DescriptionElement does not exist
+ */
+ public DescriptionElementBase loadDescriptionElement(UUID uuid,List<String> propertyPaths);
+
+ /**
+ * Persists a <code>DescriptionElementBase</code>
+ * @param descriptionElement
+ * @return
+ */
+ public UUID saveDescriptionElement(DescriptionElementBase descriptionElement);
+
+ /**
+ * Persists a collection of <code>DescriptionElementBase</code>
+ * @param descriptionElements
+ * @return
+ */
+ public Map<UUID, DescriptionElementBase> saveDescriptionElement(Collection<DescriptionElementBase> descriptionElements);
+
+ /**
+ * Delete an existing description element
+ *
+ * @param descriptionElement the description element to be deleted
+ * @return the unique identifier of the deleted entity
+ */
+ public UUID deleteDescriptionElement(DescriptionElementBase descriptionElement);
+
+ /**
+ * List the descriptions of type <T>, filtered using the following parameters
+ *
+ * @param type The type of description returned (Taxon, TaxonName, or Specimen)
+ * @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)
+ * @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)
+ * @param feature Restrict the description to those <i>elements</i> which are scoped by one of the Features passed (can be null or empty)
+ * @param pageSize The maximum number of descriptions returned (can be null for all descriptions)
+ * @param pageNumber The offset (in pageSize chunks) from the start of the result set (0 - based)
+ * @param orderHints may be null
+ * @param propertyPaths properties to initialize - see {@link IBeanInitializer#initialize(Object, List)}
+ * @return a Pager containing DescriptionBase instances
+ */
+ 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);
+
+ /**
+ * Count the descriptions of type <TYPE>, filtered using the following parameters
+ *
+ * @param type The type of description returned (Taxon, TaxonName, or Specimen)
+ * @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)
+ * @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)
+ * @param feature Restrict the description to those <i>elements</i> which are scoped by one of the Features passed (can be null or empty)
+ * @return a count of DescriptionBase instances
+ */
+ public int count(Class<? extends DescriptionBase> type, Boolean hasImages, Boolean hasText, Set<Feature> feature);
+
+ /**
+ * Returns description elements of type <TYPE>, belonging to a given
+ * description, optionally filtered by one or more features
+ *
+ * @param description
+ * The description which these description elements belong to
+ * (can be null to count all description elements)
+ * @param descriptionType
+ * A filter DescriptionElements which belong to of a specific
+ * class of Descriptions
+ * @param features
+ * Restrict the results to those description elements which are
+ * scoped by one of the Features passed (can be null or empty)
+ * @param type
+ * A filter for DescriptionElements of a specific class
+ * @param pageSize
+ * The maximum number of description elements returned (can be
+ * null for all description elements)
+ * @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 IBeanInitializer#initialize(Object, List)}
+ * @return a Pager containing DescriptionElementBase instances
+
+ * @deprecated use
+ * {@link #pageDescriptionElements(DescriptionBase, Set, Class, Integer, Integer, List)}
+ * instead
+ */
+ @Deprecated
+ public Pager<DescriptionElementBase> getDescriptionElements(DescriptionBase description,Set<Feature> features, Class<? extends DescriptionElementBase> type, Integer pageSize, Integer pageNumber, List<String> propertyPaths);
+
+
+ /**
+ * Returns description elements of type <TYPE>, belonging to a given
+ * description, optionally filtered by one or more features
+ *
+ * @param description
+ * The description which these description elements belong to
+ * (can be null to count all description elements)
+ * @param descriptionType
+ * A filter DescriptionElements which belong to of a specific
+ * class of Descriptions
+ * @param features
+ * Restrict the results to those description elements which are
+ * scoped by one of the Features passed (can be null or empty)
+ * @param type
+ * A filter for DescriptionElements of a specific class
+ * @param pageSize
+ * The maximum number of description elements returned (can be
+ * null for all description elements)
+ * @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 IBeanInitializer#initialize(Object, List)}
+ *
+ * @return a Pager containing DescriptionElementBase instances
+ */
+ public Pager<DescriptionElementBase> pageDescriptionElements(DescriptionBase description, Class<? extends DescriptionBase> descriptionType, Set<Feature> features, Class<? extends DescriptionElementBase> type, Integer pageSize, Integer pageNumber, List<String> propertyPaths);
+
+ /**
+ * Returns description elements of type <TYPE>, belonging to a given
+ * description, optionally filtered by one or more features
+ *
+ * @param description
+ * The description which these description elements belong to
+ * (can be null to count all description elements)
+ * @param features
+ * Restrict the results to those description elements which are
+ * scoped by one of the Features passed (can be null or empty)
+ * @param type
+ * A filter for DescriptionElements of a specific class
+ * @param pageSize
+ * The maximum number of description elements returned (can be
+ * null for all description elements)
+ * @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 IBeanInitializer#initialize(Object, List)}
+ * @return a List of DescriptionElementBase instances
+ * @deprecated use {@link #listDescriptionElements(DescriptionBase, Class, Set, Class, Integer, Integer, List)} instead
+ */
+ @Deprecated
+ public List<DescriptionElementBase> listDescriptionElements(DescriptionBase description,Set<Feature> features, Class<? extends DescriptionElementBase> type, Integer pageSize, Integer pageNumber, List<String> propertyPaths);
+
+ /**
+ * Returns description elements of type <TYPE>, belonging to a given
+ * description, optionally filtered by one or more features
+ *
+ * @param description
+ * The description which these description elements belong to
+ * (can be null to count all description elements)
+ * @param features
+ * Restrict the results to those description elements which are
+ * scoped by one of the Features passed (can be null or empty)
+ * @param type
+ * A filter DescriptionElements of a for specific class
+ * @param pageSize
+ * The maximum number of description elements returned (can be
+ * null for all description elements)
+ * @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 IBeanInitializer#initialize(Object, List)}
+ * @return a List of DescriptionElementBase instances
+ */
+ public List<DescriptionElementBase> listDescriptionElements(DescriptionBase description, Class<? extends DescriptionBase> descriptionType, Set<Feature> features, Class<? extends DescriptionElementBase> type, Integer pageSize, Integer pageNumber, List<String> propertyPaths);
+
+ /**
+ * Return a Pager containing Annotation entities belonging to the DescriptionElementBase instance supplied, optionally filtered by MarkerType