Deprecated API


Contents
Deprecated Classes
eu.etaxonomy.cdm.persistence.dao.hibernate.AlternativeSpellingSuggestionParser
          Use current methods for alternative spelling suggestions. This class is no longer supported after migration to hibernate 4.x. 
eu.etaxonomy.cdm.remote.json.processor.CdmBeanProcessingRegistry
          class is not beeing used but kept as reference 
eu.etaxonomy.cdm.remote.controller.interceptor.DatasourceContextHandlerInterceptor
           
eu.etaxonomy.cdm.remote.controller.PolytomousKeyPortalController
           
eu.etaxonomy.cdm.hibernate.search.StripHtmlBridge
          use HTMLStripStandardTokenizerFactory instead 
eu.etaxonomy.cdm.database.UpdatableRoutingDataSource
           
 

Deprecated Enums
eu.etaxonomy.cdm.model.common.VocabularyEnum
          A static list of vocabularies is not the right way to do this. We will use a service method that will return vocabularies by term type (once that is implemented) 
 

Deprecated Fields
eu.etaxonomy.cdm.config.Configuration.luceneVersion
           
 

Deprecated Methods
eu.etaxonomy.cdm.model.common.IMultiLanguageText.add(LanguageString)
          should follow the put semantic of maps, this method will be removed in v4.0 Use the put method instead 
eu.etaxonomy.cdm.model.common.MultilanguageText.add(LanguageString)
           
eu.etaxonomy.cdm.model.common.PersistentMultiLanguageText.add(LanguageString)
           
eu.etaxonomy.cdm.model.occurrence.SpecimenOrObservationBase.addDefinition(LanguageString)
          should follow the put semantic of maps, this method will be removed in v4.0 Use the putDefinition method instead 
eu.etaxonomy.cdm.model.occurrence.SpecimenOrObservationBase.addDefinition(String, Language)
          should follow the put semantic of maps, this method will be removed in v4.0 Use the putDefinition method instead 
eu.etaxonomy.cdm.model.description.TaxonInteraction.addDescription(LanguageString)
          should follow the put semantic of maps, this method will be removed in v4.0 Use the putDescription method instead 
eu.etaxonomy.cdm.model.description.IndividualsAssociation.addDescription(LanguageString)
          should follow the put semantic of maps, this method will be removed in v4.0 Use the putDescription method instead 
eu.etaxonomy.cdm.model.description.TaxonInteraction.addDescription(String, Language)
          should follow the put semantic of maps, this method will be removed in v4.0 Use the putDescription method instead 
eu.etaxonomy.cdm.model.description.IndividualsAssociation.addDescription(String, Language)
          should follow the put semantic of maps, this method will be removed in v4.0 Use the putDescription method instead 
eu.etaxonomy.cdm.model.description.DescriptionBase.addDescriptionSource(Reference)
           
eu.etaxonomy.cdm.api.service.UserService.addGroupAuthority(String, GrantedAuthority)
           
eu.etaxonomy.cdm.api.utility.ImagesUtility.addImagePart(DescriptionElementBase)
          not used by EDITor anymore 
eu.etaxonomy.cdm.model.description.PolytomousKeyNode.addModifyingText(LanguageString)
          should follow the put semantic of maps, this method will be removed in v4.0 Use the putModifyingText method instead 
eu.etaxonomy.cdm.model.description.StateData.addModifyingText(LanguageString)
          should follow the put semantic of maps, this method will be removed in v4.0 Use the putModifyingText method instead 
eu.etaxonomy.cdm.model.description.DescriptionElementBase.addModifyingText(LanguageString)
          should follow the put semantic of maps, this method will be removed in v4.0 Use the putModifyingText method 
eu.etaxonomy.cdm.model.description.PolytomousKeyNode.addModifyingText(String, Language)
          should follow the put semantic of maps, this method will be removed in v4.0 Use the putModifyingText method instead 
eu.etaxonomy.cdm.model.description.StateData.addModifyingText(String, Language)
          should follow the put semantic of maps, this method will be removed in v4.0 Use the putModifyingText method instead 
eu.etaxonomy.cdm.model.description.DescriptionElementBase.addModifyingText(String, Language)
          should follow the put semantic of maps, this method will be removed in v4.0 Use the putModifyingText method 
eu.etaxonomy.cdm.model.taxon.Taxon.addRelationship(RelationshipBase)
           
eu.etaxonomy.cdm.model.name.NonViralName.addRelationship(RelationshipBase)
          to be used by RelationshipBase only 
eu.etaxonomy.cdm.api.utility.ImagesUtility.addTaxonImage(Taxon, DescriptionBase, ImageFile)
          not used by EDITor anymore 
eu.etaxonomy.cdm.model.taxon.Taxon.addTaxonomicChild(Taxon, Reference, String)
           
eu.etaxonomy.cdm.model.media.Media.addTitle(LanguageString)
          should follow the put semantic of maps, this method will be removed in v4.0 Use the putTitle method instead 
eu.etaxonomy.cdm.model.media.Media.addTitle(String, Language)
          should follow the put semantic of maps, this method will be removed in v4.0 Use the putTitle method instead 
eu.etaxonomy.cdm.model.name.TypeDesignationBase.addTypifiedName(TaxonNameBase)
          for bidirectional use only 
eu.etaxonomy.cdm.api.service.UserService.addUserToGroup(String, String)
           
eu.etaxonomy.cdm.api.service.UserService.createGroup(String, List)
           
eu.etaxonomy.cdm.api.utility.ImagesUtility.createImageElement(ImageFile)
          not used by EDITor anymore 
eu.etaxonomy.cdm.model.common.OrderedTermBase.decreaseIndex(OrderedTermVocabulary)
          To be used only by OrderedTermVocabulary 
eu.etaxonomy.cdm.api.service.TermServiceImpl.delete(DefinedTermBase)
          use TermServiceImpl.delete(DefinedTermBase, TermDeletionConfigurator) instead to allow DeleteResult return type 
eu.etaxonomy.cdm.api.service.UserService.deleteGroup(String)
           
eu.etaxonomy.cdm.remote.controller.TaxonPortalController.doGetNameTypeDesignations(UUID, HttpServletRequest, HttpServletResponse)
           
eu.etaxonomy.cdm.remote.controller.PolytomousKeyPortalController.doLoadWithNodes(UUID, HttpServletRequest, HttpServletResponse)
           
eu.etaxonomy.cdm.api.service.UserService.findAllGroups()
           
eu.etaxonomy.cdm.api.service.UserService.findGroupAuthorities(String)
           
eu.etaxonomy.cdm.api.utility.ImagesUtility.findImageElement(ImageFile, Taxon)
          not used by EDITor anymore 
eu.etaxonomy.cdm.api.service.NameServiceImpl.findNameByUuid(UUID, List)
          To be removed for harmonization see http://dev.e-taxonomy.eu/trac/wiki/CdmLibraryConventions Replace by load(UUID, propertyPaths) 
eu.etaxonomy.cdm.api.service.NameServiceImpl.findNamesByTitle(String)
          To be removed for harmonization see http://dev.e-taxonomy.eu/trac/wiki/CdmLibraryConventions duplicate of findByTitle(clazz, queryString, matchmode, criteria, pageSize, pageNumber, orderHints, propertyPaths) 
eu.etaxonomy.cdm.api.service.NameServiceImpl.findNamesByTitle(String, CdmBase)
          To be removed for harmonization see http://dev.e-taxonomy.eu/trac/wiki/CdmLibraryConventions duplicate of findByTitle() 
eu.etaxonomy.cdm.api.service.UserService.findUsersInGroup(String)
           
eu.etaxonomy.cdm.api.service.ILocationService.getAbsenceTermVocabulary()
          use TermService#getVocabulary(VocabularyType) instead 
eu.etaxonomy.cdm.api.service.ITaxonService.getAllMedia(Taxon, int, int, int, String[])
          use #listMedia(Taxon, Set, boolean, boolean, List) instead 
eu.etaxonomy.cdm.api.service.IClassificationService.getAllMediaForChildNodes(Taxon, Classification, List, int, int, int, String[])
          use getAllMediaForChildNodes(TaxonNode taxonNode, ...) instead if you have a classification and a taxon that is in it, you should also have the according taxonNode 
eu.etaxonomy.cdm.api.service.NameServiceImpl.getAllRelationships(int, int)
           
eu.etaxonomy.cdm.api.service.INameService.getAllRelationships(int, int)
           
eu.etaxonomy.cdm.io.common.ResultSetProxy.getBigDecimal(int, int)
           
eu.etaxonomy.cdm.model.name.NonViralName.getChildRelationships()
          use NonViralName.getHybridChildRelations() instead. Will be removed in higher versions. 
eu.etaxonomy.cdm.model.occurrence.DerivedUnitBase.getCollectorsNumber()
           
eu.etaxonomy.cdm.api.service.IDescriptionService.getDefaultFeatureVocabulary()
          use TermService#getVocabulary(VocabularyType) instead 
eu.etaxonomy.cdm.model.description.DescriptionBase.getDescriptionSources()
           
eu.etaxonomy.cdm.ext.geo.EditGeoService.getDistributionServiceRequestParameterString(TaxonDescription, Map, Color>, int, int, String, String, List)
           
eu.etaxonomy.cdm.ext.geo.IEditGeoService.getDistributionServiceRequestParameterString(TaxonDescription, Map, Color>, int, int, String, String, List)
          use IEditGeoService.getDistributionServiceRequestParameterString(List, Map, int, int, String, String, List) instead 
eu.etaxonomy.cdm.api.service.IDescriptionService.getFeatureVocabulary(UUID)
          use TermService#getVocabulary(VocabularyType) instead 
eu.etaxonomy.cdm.model.name.TypeDesignationBase.getHomotypicalGroup()
          homotypical group can not be set and always seems to be null. Probably it is a relict of an old version. 
eu.etaxonomy.cdm.api.utility.ImagesUtility.getImage(DescriptionElementBase)
          not used by EDITor anymore 
eu.etaxonomy.cdm.api.utility.ImagesUtility.getImages(TaxonDescription)
          not used by EDITor anymore 
eu.etaxonomy.cdm.api.service.ILocationService.getNamedAreaLevelVocabulary()
          use TermService#getVocabulary(VocabularyType) instead 
eu.etaxonomy.cdm.api.service.ILocationService.getNamedAreaTypeVocabulary()
          use TermService#getVocabulary(VocabularyType) instead 
eu.etaxonomy.cdm.api.service.ILocationService.getNamedAreaVocabulary(ILocationService.NamedAreaVocabularyType)
          use TermService#getVocabulary(VocabularyType) instead 
eu.etaxonomy.cdm.api.service.INameService.getNameRelationshipTypeVocabulary()
          use VocabularyService#getVocabulary(VocabularyEnum) instead 
eu.etaxonomy.cdm.api.service.NameServiceImpl.getNamesByName(String)
          To be removed for harmonization see http://dev.e-taxonomy.eu/trac/wiki/CdmLibraryConventions duplicate of findByName 
eu.etaxonomy.cdm.api.utility.ImagesUtility.getOrderedImages(DescriptionElementBase)
          not used by EDITor anymore 
eu.etaxonomy.cdm.model.name.NonViralName.getParentRelationships()
          use NonViralName.getHybridParentRelations() instead. Will be removed in higher versions. 
eu.etaxonomy.cdm.model.location.NamedArea.getPartOfWorkaround()
           
eu.etaxonomy.cdm.api.service.ILocationService.getPresenceTermVocabulary()
          use TermService#getVocabulary(VocabularyType) instead 
eu.etaxonomy.cdm.model.common.IParsable.getProblemEnds()
          This method will be removed by a more sophisticated method in future versions, therefore it is deprecated.
 
eu.etaxonomy.cdm.model.common.IParsable.getProblemStarts()
          This method will be removed by a more sophisticated method in future versions, therefore it is deprecated.
 
eu.etaxonomy.cdm.api.service.INameService.getRankVocabulary()
          use VocabularyService#getVocabulary(VocabularyEnum) instead, this is not possible since VocabularyService#getVocabulary(VocabularyEnum) is not returning a OrderedTermVocabulary !!! see also http://dev.e-taxonomy.eu/trac/ticket/3327 
eu.etaxonomy.cdm.api.service.ITaxonService.getRootTaxa(Rank, Reference, boolean, boolean, List)
          obsolete when using classification 
eu.etaxonomy.cdm.persistence.dao.taxon.ITaxonDao.getRootTaxa(Rank, Reference, CdmFetch, Boolean, Boolean, List)
          obsolete when using classification 
eu.etaxonomy.cdm.persistence.dao.taxon.ITaxonDao.getRootTaxa(Reference)
          obsolete when using classification 
eu.etaxonomy.cdm.api.service.ITaxonService.getRootTaxa(Reference, CdmFetch, boolean)
          obsolete when using classification 
eu.etaxonomy.cdm.persistence.dao.taxon.ITaxonDao.getRootTaxa(Reference, CdmFetch, Boolean, Boolean)
          obsolete when using classification 
eu.etaxonomy.cdm.api.service.INameService.getSpecimenTypeDesignationStatusVocabulary()
          use VocabularyService#getVocabulary(VocabularyEnum) instead 
eu.etaxonomy.cdm.api.service.INameService.getSpecimenTypeDesignationVocabulary()
          use VocabularyService#getVocabulary(VocabularyEnum) instead 
eu.etaxonomy.cdm.api.service.INameService.getStatusTypeVocabulary()
          use VocabularyService#getVocabulary(VocabularyEnum) instead 
eu.etaxonomy.cdm.model.name.HomotypicalGroup.getSynonymsInGroup(Reference)
          synonyms should not depend on the sec. Therefore this method will be removed in version 3.1 or higher. Use Taxon#getSynonymsInGroup(HomotypicalGroup) instead. But be aware that the semantics is slightly different. 
eu.etaxonomy.cdm.api.service.ITaxonNodeService.getTaxonNodeByUuid(UUID)
           
eu.etaxonomy.cdm.model.taxon.Taxon.getTaxonomicChildren()
           
eu.etaxonomy.cdm.model.taxon.Taxon.getTaxonomicChildrenCount()
           
eu.etaxonomy.cdm.model.taxon.Taxon.getTaxonomicParent()
           
eu.etaxonomy.cdm.api.service.TaxonServiceImpl.getTaxonRelationshipTypeVocabulary()
           
eu.etaxonomy.cdm.api.service.ITaxonService.getTaxonRelationshipTypeVocabulary()
          use TermService#getVocabulary(VocabularyType) instead 
eu.etaxonomy.cdm.persistence.dao.name.ITaxonNameDao.getTypeDesignations(TaxonNameBase, TypeDesignationStatusBase, Integer, Integer, List)
          use ITaxonNameDao.getTypeDesignations(TaxonNameBase, Class, TypeDesignationStatusBase, Integer, Integer, List) instead 
eu.etaxonomy.cdm.io.common.ResultSetProxy.getUnicodeStream(int)
           
eu.etaxonomy.cdm.io.common.ResultSetProxy.getUnicodeStream(String)
           
eu.etaxonomy.cdm.api.service.IDescriptionService.hasStructuredData(DescriptionBase)
          The means of determining this fact may change soon, so this method is annotated as being deprecated. 
eu.etaxonomy.cdm.model.taxon.Taxon.hasTaxonomicChildren()
           
eu.etaxonomy.cdm.model.common.OrderedTermBase.incrementIndex(OrderedTermVocabulary)
          To be used only by OrderedTermVocabulary 
eu.etaxonomy.cdm.common.CdmUtils.isEmpty(String)
          use CdmUtils.isBlank(String) instead 
eu.etaxonomy.cdm.common.CdmUtils.isNotEmpty(String)
          use CdmUtils.isNotBlank(String) instead 
eu.etaxonomy.cdm.api.service.INameService.listFromNameRelationships(TaxonNameBase, NameRelationshipType, Integer, Integer, List, List)
          use INameService.listNameRelationships(TaxonNameBase, eu.etaxonomy.cdm.model.common.RelationshipBase.Direction, NameRelationshipType, Integer, Integer, List, List) instead 
eu.etaxonomy.cdm.api.service.ITaxonService.listTaxonDescriptionMedia(Taxon, Set, boolean, List)
          use #listMedia(Taxon, Set, boolean, boolean, List) instead 
eu.etaxonomy.cdm.api.service.INameService.listToNameRelationships(TaxonNameBase, NameRelationshipType, Integer, Integer, List, List)
          use INameService.listNameRelationships(TaxonNameBase, eu.etaxonomy.cdm.model.common.RelationshipBase.Direction, NameRelationshipType, Integer, Integer, List, List) instead 
eu.etaxonomy.cdm.api.service.IClassificationService.loadChildNodesOfTaxonNode(TaxonNode, List)
          move to TaxonNodeService 
eu.etaxonomy.cdm.api.service.ClassificationServiceImpl.loadRankSpecificRootNodes(Classification, Rank, Integer, Integer, List)
           
eu.etaxonomy.cdm.api.service.IClassificationService.loadRankSpecificRootNodes(Classification, Rank, Integer, Integer, List)
          use IClassificationService.listRankSpecificRootNodes(Classification, Rank, Integer, Integer, List) instead 
eu.etaxonomy.cdm.api.service.ClassificationServiceImpl.loadTaxonNode(TaxonNode, List)
           
eu.etaxonomy.cdm.api.service.IClassificationService.loadTaxonNode(TaxonNode, List)
          use TaxonNodeService instead 
eu.etaxonomy.cdm.api.service.IClassificationService.loadTaxonNodeByTaxon(Taxon, UUID, List)
          use loadTaxonNode(TaxonNode taxonNode, ...) instead if you have a classification and a taxon that is in it, you should also have the according taxonNode 
eu.etaxonomy.cdm.api.utility.ImagesUtility.moveImage(DescriptionElementBase, ImageFile, int)
          not used by EDITor anymore 
eu.etaxonomy.cdm.model.occurrence.DerivationEvent.NewInstance()
          Use DerivationEvent.NewInstance(DerivationEventType) or any other factory method instead to make sure, the derivation event type is always set. 
eu.etaxonomy.cdm.io.common.mapping.DbImportExtensionMapper.NewInstance(String, UUID, String, String, String)
           
eu.etaxonomy.cdm.model.taxon.Taxon.nullifyTaxonomicParent()
           
eu.etaxonomy.cdm.api.service.INameService.pageFromNameRelationships(TaxonNameBase, NameRelationshipType, Integer, Integer, List, List)
          use INameService.pageNameRelationships(TaxonNameBase, eu.etaxonomy.cdm.model.common.RelationshipBase.Direction, NameRelationshipType, Integer, Integer, List, List) instead 
eu.etaxonomy.cdm.api.service.INameService.pageToNameRelationships(TaxonNameBase, NameRelationshipType, Integer, Integer, List, List)
          use INameService.pageNameRelationships(TaxonNameBase, eu.etaxonomy.cdm.model.common.RelationshipBase.Direction, NameRelationshipType, Integer, Integer, List, List) instead 
eu.etaxonomy.cdm.model.description.KeyStatement.putLabel(String, Language)
          should follow the put semantic of maps, this method will be removed in v4.0 Use the putLabel method 
eu.etaxonomy.cdm.model.description.KeyStatement.putText(LanguageString)
          This method will be removed in v4.0 Use the putLabel method instead 
eu.etaxonomy.cdm.model.description.TextData.putText(String, Language)
          should follow the put semantic of maps, this method will be removed in v4.0 Use the putText method instead 
eu.etaxonomy.cdm.model.description.DescriptionBase.removeDescriptionSource(Reference)
           
eu.etaxonomy.cdm.api.service.UserService.removeGroupAuthority(String, GrantedAuthority)
           
eu.etaxonomy.cdm.api.utility.ImagesUtility.removeImage(DescriptionElementBase, ImageFile)
          not used by EDITor anymore 
eu.etaxonomy.cdm.api.utility.ImagesUtility.removeTaxonImage(Taxon, DescriptionBase, ImageFile)
          not used by EDITor anymore 
eu.etaxonomy.cdm.api.service.IClassificationService.removeTaxonNode(TaxonNode)
          use TaxonNodeService instead 
eu.etaxonomy.cdm.model.taxon.Taxon.removeTaxonomicChild(Taxon)
           
eu.etaxonomy.cdm.model.description.KeyStatement.removeText(Language)
          This method will be removed in v4.0 Use the KeyStatement.removeLabel(Language) method instead 
eu.etaxonomy.cdm.model.name.TypeDesignationBase.removeTypifiedName(TaxonNameBase)
          for bidirectional use only 
eu.etaxonomy.cdm.api.service.UserService.removeUserFromGroup(String, String)
           
eu.etaxonomy.cdm.api.service.UserService.renameGroup(String, String)
           
eu.etaxonomy.cdm.api.service.UserService.saveGroup(Group)
           
eu.etaxonomy.cdm.api.service.IClassificationService.saveTaxonNode(TaxonNode)
          use TaxonNodeService instead 
eu.etaxonomy.cdm.api.service.IClassificationService.saveTaxonNodeAll(Collection)
          use TaxonNodeService instead 
eu.etaxonomy.cdm.model.common.Annotation.setAnnotatedObj(AnnotatableEntity)
          should not be used, is only public for internal reasons 
eu.etaxonomy.cdm.model.occurrence.DerivedUnitBase.setCollectorsNumber(String)
           
eu.etaxonomy.cdm.model.description.Distribution.setFeature(Feature)
          Deprecated because feature should always be DISTRIBUTION for all distribution instances and therefore it should not be changed. 
eu.etaxonomy.cdm.model.description.CommonTaxonName.setFeature(Feature)
          Deprecated because feature should always be COMMON_NAME for all common name instances. 
eu.etaxonomy.cdm.remote.json.JsonConfigFactoryBean.setIgnoreJPATransient(boolean)
          Setting this property to false will cause LazyLoadingExceptions and will thus completely break the JSON serialization!!
In the cdm model all getters returning cdm entity or product of cdm entities which are not directly returning a HibernateProxy are annotated as @Transient. In order to serialize these properties you have to do two things:
  1. Explicitly serialize the property by overriding AbstractCdmBeanProcessor#processBeanSecondStep(eu.etaxonomy.cdm.model.common.CdmBase, net.sf.json.JSONObject, JsonConfig) in the according {AbstractCdmBeanProcessor} implementation. If there is no matching {AbstractCdmBeanProcessor} implementation you would have to create one. for example:
     
eu.etaxonomy.cdm.model.media.MediaRepresentation.setMedia(Media)
          for internal (bidirectional) use only 
eu.etaxonomy.cdm.model.media.MediaRepresentationPart.setMediaRepresentation(MediaRepresentation)
          for internal (bidirectional) use only 
eu.etaxonomy.cdm.model.common.IParsable.setProblemEnds(int)
          This method will be removed by a more sophisticated method in future versions, therefore it is deprecated.
 
eu.etaxonomy.cdm.model.common.IParsable.setProblemStarts(int)
          This method will be removed by a more sophisticated method in future versions, therefore it is deprecated.
 
eu.etaxonomy.cdm.model.taxon.Taxon.setTaxonomicChildrenCount(int)
           
eu.etaxonomy.cdm.model.taxon.Taxon.setTaxonomicParent(Taxon, Reference, String)
           
eu.etaxonomy.cdm.model.taxon.TaxonRelationshipType.TAXONOMICALLY_INCLUDED_IN()
          will be removed in version 3.0 
eu.etaxonomy.cdm.io.berlinModel.in.validation.BerlinModelReferenceImportValidator.validate(BerlinModelImportState)
           
 

Deprecated Constructors
eu.etaxonomy.cdm.model.common.ExtensionType()
           
eu.etaxonomy.cdm.model.name.NameTypeDesignationStatus()
           
eu.etaxonomy.cdm.model.taxon.Taxon()
           
eu.etaxonomy.cdm.model.taxon.TaxonNode(Taxon, Classification)
          setting of classification is handled in the addTaxonNode() method, use TaxonNode(taxon) instead 
 



Copyright © 2007-2013 EDIT. All Rights Reserved.