Revision 22abd4ac
Added by Andreas Müller over 7 years ago
| cdmlib-services/src/main/java/eu/etaxonomy/cdm/api/service/ITaxonService.java | ||
|---|---|---|
| 35 | 35 |
import eu.etaxonomy.cdm.model.common.DefinedTerm; |
| 36 | 36 |
import eu.etaxonomy.cdm.model.common.IdentifiableEntity; |
| 37 | 37 |
import eu.etaxonomy.cdm.model.common.Language; |
| 38 |
import eu.etaxonomy.cdm.model.common.OrderedTermVocabulary; |
|
| 39 | 38 |
import eu.etaxonomy.cdm.model.common.RelationshipBase; |
| 40 | 39 |
import eu.etaxonomy.cdm.model.common.RelationshipBase.Direction; |
| 41 | 40 |
import eu.etaxonomy.cdm.model.description.DescriptionElementBase; |
| ... | ... | |
| 59 | 58 |
import eu.etaxonomy.cdm.model.taxon.TaxonRelationshipType; |
| 60 | 59 |
import eu.etaxonomy.cdm.persistence.dao.initializer.IBeanInitializer; |
| 61 | 60 |
import eu.etaxonomy.cdm.persistence.dto.UuidAndTitleCache; |
| 62 |
import eu.etaxonomy.cdm.persistence.fetch.CdmFetch; |
|
| 63 | 61 |
import eu.etaxonomy.cdm.persistence.query.MatchMode; |
| 64 | 62 |
import eu.etaxonomy.cdm.persistence.query.OrderHint; |
| 65 | 63 |
|
| 66 | 64 |
|
| 67 | 65 |
public interface ITaxonService extends IIdentifiableEntityService<TaxonBase>{
|
| 68 | 66 |
|
| 69 |
/** |
|
| 70 |
* Computes all Taxon instances that do not have a taxonomic parent. |
|
| 71 |
* @param sec The concept reference that the taxon belongs to |
|
| 72 |
* |
|
| 73 |
* @param onlyWithChildren if true only taxa are returned that have taxonomic children. <Br>Default: true. |
|
| 74 |
* @return The List<Taxon> of root taxa. |
|
| 75 |
* @deprecated obsolete when using classification |
|
| 76 |
*/ |
|
| 77 |
@Deprecated |
|
| 78 |
public List<Taxon> getRootTaxa(Reference sec, CdmFetch cdmFetch, boolean onlyWithChildren); |
|
| 79 |
|
|
| 80 |
/** |
|
| 81 |
* Computes all Taxon instances which name is of a certain Rank. |
|
| 82 |
* @param rank The rank of the taxon name |
|
| 83 |
* @param sec The concept reference that the taxon belongs to |
|
| 84 |
* @param onlyWithChildren if true only taxa are returned that have taxonomic children. <Br>Default: true. |
|
| 85 |
* @param withMisapplications if false taxa that have at least one misapplied name relationship in which they are |
|
| 86 |
* the misapplied name are not returned.<Br>Default: true. |
|
| 87 |
* @param propertyPaths |
|
| 88 |
* properties to be initialized, For detailed description and |
|
| 89 |
* examples <b>please refer to:</b> |
|
| 90 |
* {@link IBeanInitializer#initialize(Object, List)}. <Br>
|
|
| 91 |
* Default: true. |
|
| 92 |
* @return The List<Taxon> of root taxa. |
|
| 93 |
* @deprecated obsolete when using classification |
|
| 94 |
*/ |
|
| 95 |
@Deprecated |
|
| 96 |
public List<Taxon> getRootTaxa(Rank rank, Reference sec, boolean onlyWithChildren, boolean withMisapplications, List<String> propertyPaths); |
|
| 97 |
|
|
| 98 | 67 |
/** |
| 99 | 68 |
* Computes all relationships. |
| 100 | 69 |
* @param limit |
| ... | ... | |
| 104 | 73 |
*/ |
| 105 | 74 |
public List<RelationshipBase> getAllRelationships(int limit, int start); |
| 106 | 75 |
|
| 107 |
/** |
|
| 108 |
* Returns TaxonRelationshipType vocabulary |
|
| 109 |
* @return |
|
| 110 |
* @deprecated use TermService#getVocabulary(VocabularyType) instead |
|
| 111 |
*/ |
|
| 112 |
@Deprecated |
|
| 113 |
public OrderedTermVocabulary<TaxonRelationshipType> getTaxonRelationshipTypeVocabulary(); |
|
| 114 |
|
|
| 115 | 76 |
/** |
| 116 | 77 |
* Returns a list of taxa that matches the name string and the sec reference |
| 117 | 78 |
* @param name the name string to search for |
| ... | ... | |
| 215 | 176 |
public Synonym changeRelatedTaxonToSynonym(Taxon fromTaxon, Taxon toTaxon, |
| 216 | 177 |
TaxonRelationshipType oldRelationshipType, |
| 217 | 178 |
SynonymRelationshipType synonymRelationshipType) throws DataChangeNoRollbackException; |
| 218 |
/** |
|
| 219 |
* Deletes all synonym relationships of a given synonym. If taxon is given |
|
| 220 |
* only those relationships to the taxon are deleted. |
|
| 221 |
* |
|
| 222 |
* @param syn |
|
| 223 |
* the synonym |
|
| 224 |
* @param taxon |
|
| 225 |
* @return |
|
| 226 |
* @deprecated This method must no longer being used since the |
|
| 227 |
* SynonymRelationship is annotated at the {@link Taxon} and at
|
|
| 228 |
* the {@link Synonym} with <code>orphanDelete=true</code>. Just
|
|
| 229 |
* remove the from and to entities from the relationship and |
|
| 230 |
* hibernate will care for the deletion. Using this method can cause |
|
| 231 |
* <code>StaleStateException</code> (see http://dev.e-taxonomy.eu/trac/ticket/3797) |
|
| 232 |
* |
|
| 233 |
*/ |
|
| 234 |
@Deprecated |
|
| 235 |
public long deleteSynonymRelationships(Synonym syn, Taxon taxon); |
|
| 236 |
|
|
| 237 | 179 |
|
| 238 | 180 |
/** |
| 239 | 181 |
* Changes the homotypic group of a synonym into the new homotypic group. |
Also available in: Unified diff
ref #6089 Remove all calls and methods for taxonomicChildrenCount and taxonomicParentCache