Merge branch 'develop' of ssh://dev.e-taxonomy.eu/var/git/cdmlib into develop
[cdmlib.git] / cdmlib-services / src / main / java / eu / etaxonomy / cdm / api / service / IFeatureTreeService.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.Collection;
13 import java.util.List;
14 import java.util.Map;
15 import java.util.UUID;
16
17 import eu.etaxonomy.cdm.model.term.TermNode;
18 import eu.etaxonomy.cdm.model.term.TermTree;
19 import eu.etaxonomy.cdm.model.term.TermType;
20 import eu.etaxonomy.cdm.persistence.dto.UuidAndTitleCache;
21
22 /**
23 * @deprecated use {@link ITermTreeService} instead
24 */
25 @Deprecated
26 public interface IFeatureTreeService extends IIdentifiableEntityService<TermTree> {
27
28 /**
29 * @deprecated use {@link ITermTreeService#list(Class, Integer, Integer, List, List)} instead
30 */
31 @Deprecated
32 public List<TermNode> getFeatureNodesAll();
33
34 /**
35 * Loads a feature tree including all of its nodes (all the way down to the tips of the tree).
36 * Because this method automatically adds feature nodes recursively, adding "root" to property paths
37 * is supurfluous - the propertyPaths argument should be used to initialize property paths <i>in addition</i>
38 * to the feature nodes. The nodePaths argument is applied to each node in turn, so again, adding "children"
39 * is also supurfluous. The nodePaths argument should be used to specify additional propertys of the featureNode
40 * to initialize (e.g. feature).
41 *
42 */
43 public TermTree loadWithNodes(UUID uuid, List<String> propertyPaths, List<String> nodePaths);
44
45 public Map<UUID, TermNode> saveFeatureNodesAll(Collection<TermNode> featureNodeCollection);
46
47 public Map<UUID, TermNode> saveOrUpdateFeatureNodesAll(Collection<TermNode> featureNodeCollection);
48
49 public TermTree createTransientDefaultFeatureTree();
50
51 public <S extends TermTree> List<UuidAndTitleCache<S>> getUuidAndTitleCacheByTermType(Class<S> clazz, TermType termType, Integer limit,
52 String pattern);
53 }