cdmlib-services/src/main/java/eu/etaxonomy/cdm/api/service/IPolytomousKeyService.java

   1 /**
   2 * Copyright (C) 2009 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.api.service;
  11
  12 import java.util.List;
  13 import java.util.UUID;
  14
  15 import eu.etaxonomy.cdm.api.service.pager.Pager;
  16 import eu.etaxonomy.cdm.model.description.IIdentificationKey;
  17 import eu.etaxonomy.cdm.model.description.PolytomousKey;
  18 import eu.etaxonomy.cdm.model.taxon.TaxonBase;
  19
  20 public interface IPolytomousKeyService extends IIdentifiableEntityService<PolytomousKey> {
  21
  22         /**
  23          * Loads a polytomous key including all of its nodes (all the way down to the tips of the tree).
  24          * Because this method automatically adds key nodes recursively, adding "root" to property paths
  25          * is superfluous - the propertyPaths argument should be used to initialize property paths <i>in addition</i>
  26          * to the key nodes. The nodePaths argument is applied to each node in turn, so again, adding "children"
  27          * is also superfluous. The nodePaths argument should be used to specify additional properties of the
  28          * key node to initialize.
  29          *
  30          */
  31         public PolytomousKey loadWithNodes(UUID uuid, List<String> propertyPaths, List<String> nodePaths);
  32
  33         public Pager<PolytomousKey> findByTaxonomicScope(TaxonBase taxon, Integer pageSize,
  34                         Integer pageNumber, List<String> propertyPaths);
  35
  36 }