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.model.description.PolytomousKey;
  16
  17 public interface IPolytomousKeyService extends IIdentifiableEntityService<PolytomousKey> {
  18
  19         /**
  20          * Loads a polytomous key including all of its nodes (all the way down to the tips of the tree).
  21          * Because this method automatically adds key nodes recursively, adding "root" to property paths
  22          * is superfluous - the propertyPaths argument should be used to initialize property paths <i>in addition</i>
  23          * to the key nodes. The nodePaths argument is applied to each node in turn, so again, adding "children"
  24          * is also superfluous. The nodePaths argument should be used to specify additional properties of the
  25          * key node to initialize.
  26          *
  27          */
  28         public PolytomousKey loadWithNodes(UUID uuid, List<String> propertyPaths, List<String> nodePaths);
  29
  30 }