Deprecated API


Contents
Deprecated Interfaces
com.atlassian.jira.issue.search.CustomFieldSortable
          Please use SortableCustomFieldSearcher instead. 
com.atlassian.jira.ofbiz.OfBizEntityCreator
          Use OfBizDelegator instead 
 

Deprecated Classes
com.atlassian.jira.issue.comparator.ComponentComparator
          use ProjectComponent instead of GenericValue and compare through ProjectComponentComparator 
com.atlassian.jira.issue.search.parameters.lucene.DateParameter
          You should now use AbsoluteDateRangeParameter which is much more efficient 
com.atlassian.jira.workflow.condition.FilterCurrentStepCondition
          Use DisallowIfInStepCondition instead. 
com.atlassian.jira.workflow.function.misc.FlushCachesFunction
          This class is here for legacy reasons - it may be contained in other people's 
com.atlassian.jira.event.listeners.mail.MailSender
          get an instance of the com.atlassian.mail.server.MailServerManager object and send mail through that class. 
com.atlassian.jira.issue.search.parameters.lucene.PeriodParameter
          since JIRA 3.3 Should now use RelativeDateRangeParameter 
com.atlassian.jira.workflow.validator.UserPermissionValidator
          Use PermissionValidator instead. 
 

Deprecated Exceptions
com.atlassian.jira.exception.StoreException
          Please use DataAccessException instead. 
 

Deprecated Methods
com.atlassian.jira.web.bean.BulkEditBean._setSelectedIssueGVsForTesting(List)
            
com.atlassian.jira.service.util.handler.AbstractMessageHandler.addErrorAndReturnFalse(String)
          Please use AbstractMessageHandler.addError(String) and return your own false :-) 
com.atlassian.jira.service.util.handler.AbstractMessageHandler.addErrorAndReturnFalse(String, Exception)
          Please use AbstractMessageHandler.addError(String) and return your own false :-) 
com.atlassian.jira.scheme.AbstractSchemeManager.addSchemeToProject(GenericValue, GenericValue)
          should use addSchemeToProject(Project, Scheme) instead 
com.atlassian.jira.util.IOUtil.bufferedCopy(InputStream, OutputStream)
          Buffering streams is actively harmful! See the class description as to why. Use IOUtil.copy(InputStream, OutputStream) instead. 
com.atlassian.jira.bc.project.component.ProjectComponentManager.convertToGenericValue(ProjectComponent)
          don't use GenericValue use the ProjectComponent instead. 
com.atlassian.jira.bc.project.component.ProjectComponentManager.convertToGenericValues(Collection)
          don't use GenericValue use the ProjectComponent instead. 
com.atlassian.jira.project.version.VersionManager.createVersion(String, Date, String, GenericValue, Long)
          now use #createVersion with projectId instead of generic value 
com.atlassian.jira.issue.IssueManager.execute(SearchRequest, User)
          Please use SearchProvider.search(SearchRequest, com.opensymphony.user.User, com.atlassian.jira.web.bean.PagerFilter) instead, which returns Issues. 
com.atlassian.jira.issue.managers.DefaultIssueManager.execute(SearchRequest, User)
          Please use SearchProvider.search(SearchRequest, com.opensymphony.user.User, com.atlassian.jira.web.bean.PagerFilter) instead, which returns Issues. 
com.atlassian.jira.web.util.OutlookDate.format(Date, Locale)
          Please use OutlookDate.format(java.util.Date) instead. 
com.atlassian.jira.service.JiraServiceContainerImpl.getAcceptedParams()
            
com.atlassian.jira.web.action.issue.CreateIssue.getAssignee()
            
com.atlassian.jira.issue.fields.DefaultFieldManager.getColumnLayoutManager()
          Declare your dependency and let PicoContainer resolve it instead 
com.atlassian.jira.issue.fields.FieldManager.getColumnLayoutManager()
          Declare your dependency and let PicoContainer resolve it instead 
com.atlassian.jira.project.CachingProjectManager.getComponent(GenericValue, String)
          use ProjectComponentManager and ProjectComponent 
com.atlassian.jira.project.DefaultProjectManager.getComponent(GenericValue, String)
          use ProjectComponentManager instead 
com.atlassian.jira.project.CachingProjectManager.getComponent(Long)
          use ProjectComponentManager and ProjectComponent 
com.atlassian.jira.project.DefaultProjectManager.getComponent(Long)
          use ProjectComponentManager instead 
com.atlassian.jira.project.CachingProjectManager.getComponents(GenericValue)
          use ProjectComponentManager and ProjectComponent 
com.atlassian.jira.project.DefaultProjectManager.getComponents(GenericValue)
          use ProjectComponentManager instead 
com.atlassian.jira.issue.fields.FieldManager.getCustomFieldManager()
          Declare your dependency and let PicoContainer resolve it instead 
com.atlassian.jira.issue.managers.DefaultCustomFieldManager.getCustomFieldObjects(GenericValue)
          Use DefaultCustomFieldManager.getCustomFieldObjects(com.atlassian.jira.issue.Issue) 
com.atlassian.jira.ComponentManager.getCvsRepositoryUtil()
            
com.atlassian.jira.issue.link.IssueLink.getDestination()
          Use IssueLink.getDestinationObject() instead. 
com.atlassian.jira.issue.IssueManager.getEntitiesByIssue(String, GenericValue)
          Use IssueManager.getEntitiesByIssueObject(String, Issue) instead. 
com.atlassian.jira.issue.fields.DefaultFieldManager.getFieldLayoutManager()
          Declare your dependency and let PicoContainer resolve it instead 
com.atlassian.jira.issue.fields.FieldManager.getFieldLayoutManager()
          Declare your dependency and let PicoContainer resolve it instead 
com.atlassian.jira.issue.fields.CustomFieldImpl.getFirstRelevantConfig(GenericValue, List)
            
com.atlassian.jira.issue.fields.CustomField.getFirstRelevantConfig(GenericValue, List)
            
com.atlassian.jira.bc.project.component.ProjectComponentImpl.getGenericValue()
          use this object instead 
com.atlassian.jira.bc.project.component.ProjectComponent.getGenericValue()
          use this object instead of the stinky GenericValue! 
com.atlassian.jira.project.Project.getGenericValue()
          only use this if you need to utilize an older API method 
com.atlassian.jira.issue.fields.CustomFieldImpl.getGenericValue()
            
com.atlassian.jira.issue.fields.CustomField.getGenericValue()
            
com.atlassian.jira.portal.PortletConfiguration.getGenericValue()
          Please avoid using this method and manipulating the GenericValue directly. Use the setters on this interface to manipulate a PortletConfiguration. 
com.atlassian.jira.security.util.GroupSelectorUtils.getGroupDisplayName(Group)
          since v3.8 this is a very short term method as it will not work with external User/Group management. 
com.atlassian.jira.security.util.GroupSelectorUtils.getGroupsFromDisplayName(String)
          since v3.8 this is a very short term method as it will not work with external User/Group management. 
com.atlassian.jira.issue.IssueManager.getIssue(Long)
          Use IssueManager.getIssueObject(Long) instead. 
com.atlassian.jira.issue.IssueManager.getIssue(String)
          Use IssueManager.getIssueObject(String) instead. 
com.atlassian.jira.web.component.SimpleColumnLayoutItem.getIssueObject(GenericValue)
            
com.atlassian.jira.issue.IssueImpl.getIssueObject(GenericValue)
          You should construct this yourself if at all possible, or use IssueFactory.getIssue(org.ofbiz.core.entity.GenericValue) instead 
com.atlassian.jira.config.ConstantsManager.getIssueType(String)
          Use ConstantsManager.getIssueTypeObject(String) instead 
com.atlassian.jira.config.ConstantsManager.getIssueTypes()
          Use ConstantsManager.getRegularIssueTypeObjects() instead. 
com.atlassian.jira.issue.fields.config.manager.IssueTypeSchemeManager.getIssueTypesForProject(GenericValue)
          Use of GenericValue is discouraged. Deprecated since: 3.9. Use IssueTypeSchemeManager.getIssueTypesForProject(Project) instead. 
com.atlassian.jira.issue.IssueManager.getIssueWatchers(GenericValue)
          Use IssueManager.getIssueWatchers(Issue) instead 
com.atlassian.jira.issue.Issue.getParent()
          Use Issue.getParentObject() instead. 
com.atlassian.jira.issue.AbstractIssue.getParent()
          Use AbstractIssue.getParentObject() instead. 
com.atlassian.jira.ComponentManager.getPluginManager()
          will be removed with plugin manager 
com.atlassian.jira.config.ConstantsManager.getPriorities()
          Use ConstantsManager.getPriorityObjects() instead 
com.atlassian.jira.config.ConstantsManager.getPriority(String)
          Use ConstantsManager.getPriorityObject(String) instead. 
com.atlassian.jira.issue.Issue.getProject()
          please use getProjectObject (this still implicitly relies on the GV), but it is a start! 
com.atlassian.jira.issue.search.SearchRequest.getProject()
          since 3.5 (for removal in 3.8).

To retrieve the projects that are being searched by a search request check for the existance of ProjectParameter:

    SearchParameter projParam = searchRequest.getParam(DocumentConstants.PROJECT_ID)
 
If the projParam is null then all projects are being searched. (TODO Check that this is indeed true).

If the param is not null, to retrieve the project ids that are being searched, call:

 Collection searchedProjectIds = projParam.getValues();
 
searchedProjectIds should be a Collection of Longs.
 
com.atlassian.jira.project.ProjectManager.getProject(Long)
          please use ProjectManager.getProjectObj(java.lang.Long) 
com.atlassian.jira.project.ProjectManager.getProjectByKey(String)
          please use the ProjectManager.getProjectObjByKey(java.lang.String) method to return a Project object 
com.atlassian.jira.issue.IssueManager.getProjectIssues(GenericValue)
          only used in test cases, should use a search provider instead. 
com.atlassian.jira.scheme.AbstractSchemeManager.getProjects(GenericValue)
          you should now use getProject(Scheme) 
com.atlassian.jira.config.ConstantsManager.getResolution(String)
          Use ConstantsManager.getResolutionObject(String) instead. 
com.atlassian.jira.config.ConstantsManager.getResolutions()
          Use ConstantsManager.getResolutionObjects() instead. 
com.atlassian.jira.issue.link.IssueLink.getSource()
          Use IssueLink.getSourceObject() instead. 
com.atlassian.jira.issue.Issue.getStatus()
          Use Issue.getStatusObject() instead. 
com.atlassian.jira.bean.SubTask.getSubTaskIssue()
          Use SubTask.getSubTaskIssueObject() instead. 
com.atlassian.jira.issue.Issue.getSubTasks()
          Use Issue.getSubTaskObjects() 
com.atlassian.jira.config.DefaultSubTaskManager.getSubTasks(GenericValue)
          Use DefaultSubTaskManager.getSubTaskObjects(com.atlassian.jira.issue.Issue) instead. 
com.atlassian.jira.config.SubTaskManager.getSubTasks(GenericValue)
          Use SubTaskManager.getSubTaskObjects(com.atlassian.jira.issue.Issue) instead. 
com.atlassian.jira.plugin.JiraResourcedModuleDescriptor.getText(String)
          Please use i18nBean.getText() instead 
com.atlassian.jira.security.JiraAuthenticationContext.getText(String)
          Use getText() method on JiraAuthenticationContext.getI18nBean(). 
com.atlassian.jira.user.util.GlobalUserPreferencesUtilImpl.getUserLocalePreferenceList(String)
          do not use this, it is only for old data and will not work properly once Crowd integration is turned on 
com.atlassian.jira.scheme.AbstractSchemeManager.getUsers(Long, GenericValue)
          Use AbstractSchemeManager.getUsers(Long, com.atlassian.jira.permission.PermissionContext) instead. 
com.atlassian.jira.scheme.SchemeManager.getUsers(Long, GenericValue)
          Use SchemeManager.getUsers(Long, com.atlassian.jira.permission.PermissionContext) instead. 
com.atlassian.jira.issue.customfields.impl.AbstractCustomFieldType.getVelocityParameters(Issue)
          Use the method AbstractCustomFieldType.getVelocityParameters(Issue, CustomField, FieldLayoutItem) instead 
com.atlassian.jira.project.version.VersionManager.getVersion(GenericValue, String)
          Use VersionManager.getVersion(Long, String) instead 
com.atlassian.jira.web.action.issue.ViewIssue.getVersions()
          Use ViewIssue.getAffectedVersions() instead. 
com.atlassian.jira.project.version.VersionManager.getVersions(GenericValue)
          use #getVersions(Long) 
com.atlassian.jira.issue.fields.layout.field.FieldLayout.getVisibleLayoutItems(User, GenericValue, List)
          Use FieldLayout.getVisibleLayoutItems(com.opensymphony.user.User, com.atlassian.jira.project.Project, java.util.List) instead. Since: 3.9. 
com.atlassian.jira.web.action.IssueActionSupport.isCustomFieldHidden(Long, Long, String)
          Use FieldVisibilityBean.isCustomFieldHidden(java.lang.Long, java.lang.Long, java.lang.String) instead. 
com.atlassian.jira.web.action.IssueActionSupport.isFieldHidden(Long, String, String)
          Use FieldVisibilityBean.isFieldHidden(java.lang.Long, java.lang.String, java.lang.String) instead. 
com.atlassian.jira.web.action.IssueActionSupport.isFieldHidden(String)
          Use FieldVisibilityBean.isFieldHidden(com.opensymphony.user.User, java.lang.String) instead 
com.atlassian.jira.web.action.JiraWebActionSupport.isHasPermission(String, GenericValue)
          Please use either JiraWebActionSupport.isHasIssuePermission(String,GenericValue), JiraWebActionSupport.isHasIssuePermission(int,GenericValue) or JiraWebActionSupport.isHasProjectPermission(String,GenericValue), JiraWebActionSupport.isHasProjectPermission(int,GenericValue). 
com.atlassian.jira.event.issue.IssueEventListener.issueAssigned(IssueEvent)
          Please call IssueEventListener.workflowEvent(IssueEvent) 
com.atlassian.jira.event.issue.IssueEventListener.issueClosed(IssueEvent)
          Please call IssueEventListener.workflowEvent(IssueEvent) 
com.atlassian.jira.event.issue.IssueEventListener.issueCommented(IssueEvent)
          Please call IssueEventListener.workflowEvent(IssueEvent) 
com.atlassian.jira.event.issue.IssueEventListener.issueCreated(IssueEvent)
          Please call IssueEventListener.workflowEvent(IssueEvent) 
com.atlassian.jira.event.issue.IssueEventListener.issueDeleted(IssueEvent)
          Please call IssueEventListener.workflowEvent(IssueEvent) 
com.atlassian.jira.event.issue.IssueEventListener.issueGenericEvent(IssueEvent)
          Please call IssueEventListener.workflowEvent(IssueEvent) 
com.atlassian.jira.event.issue.IssueEventListener.issueMoved(IssueEvent)
          Please call IssueEventListener.workflowEvent(IssueEvent) 
com.atlassian.jira.event.issue.IssueEventListener.issueReopened(IssueEvent)
          Please call IssueEventListener.workflowEvent(IssueEvent) 
com.atlassian.jira.event.issue.IssueEventListener.issueResolved(IssueEvent)
          Please call IssueEventListener.workflowEvent(IssueEvent) 
com.atlassian.jira.event.issue.IssueEventListener.issueStarted(IssueEvent)
          Please call IssueEventListener.workflowEvent(IssueEvent) 
com.atlassian.jira.event.issue.IssueEventListener.issueStopped(IssueEvent)
          Please call IssueEventListener.workflowEvent(IssueEvent) 
com.atlassian.jira.event.issue.IssueEventListener.issueUpdated(IssueEvent)
          Please call IssueEventListener.workflowEvent(IssueEvent) 
com.atlassian.jira.event.issue.IssueEventListener.issueWorkLogged(IssueEvent)
          Please call IssueEventListener.workflowEvent(IssueEvent) 
com.atlassian.jira.workflow.WorkflowManager.migrateIssueToWorkflow(GenericValue, JiraWorkflow, GenericValue)
          Please use WorkflowManager.migrateIssueToWorkflow(com.atlassian.jira.issue.MutableIssue, JiraWorkflow, com.atlassian.jira.issue.status.Status). Since: 3.9. 
com.atlassian.jira.scheme.AbstractSchemeManager.removeSchemesFromProject(GenericValue)
          should use removeSchemesFromProject(Project) instead 
com.atlassian.jira.config.SubTaskManager.resetSequences(GenericValue)
          since 3.9 use SubTaskManager.resetSequences(com.atlassian.jira.issue.Issue) 
com.atlassian.jira.issue.search.SearchProvider.search(SearchRequest, User)
          - please use SearchProvider.search(SearchRequest, com.opensymphony.user.User, com.atlassian.jira.web.bean.PagerFilter) instead. 
com.atlassian.jira.issue.search.providers.LuceneSearchProvider.search(SearchRequest, User)
            
com.atlassian.jira.web.action.issue.CreateIssue.setAssignee(String)
            
com.atlassian.jira.bc.project.component.ProjectComponentImpl.setGenericValue(GenericValue)
          temporary 
com.atlassian.jira.util.JiraEntityUtils.updateDependentEntities(GenericValue, Collection, String, String)
          please use JiraEntityUtils.updateDependentEntitiesCheckId(org.ofbiz.core.entity.GenericValue, java.util.Collection, String, String) instead, as it compares ids rather than GenericValues 
com.atlassian.jira.security.util.GroupSelectorUtils.updateGroupName(Group, String, String)
          since v3.8 this is a very short term method as it will not work with external User/Group management. 
com.atlassian.jira.issue.subscription.SubscriptionManager.updateSubscription(User, Long, Map, Trigger)
          Should use the method with an explicit list of fields 
 

Deprecated Constructors
com.atlassian.jira.service.util.handler.AbstractCommentHandler()
          Please use other constructor that explicitly sets dependencies 
com.atlassian.jira.issue.link.IssueLinkType(GenericValue, IssueLinkTypeManager)
          use IssueLinkType(GenericValue) we don't need the ILTM. 
com.atlassian.jira.web.component.issuesummary.IssueSummaryLayoutBean()
            
com.atlassian.jira.portal.PortletConfigurationImpl(GenericValue)
          Please use one of the other constructors instead 
com.atlassian.jira.portal.PortletImpl(JiraAuthenticationContext)
          Use full constructor instead. 
com.atlassian.jira.util.velocity.VelocityRequestContextFactory()
          Please use VelocityRequestContextFactory.VelocityRequestContextFactory(com.atlassian.jira.config.properties.ApplicationProperties) instead 
 



Copyright © 2002-2007 Atlassian. All Rights Reserved.