Deprecated API

Contents

• Deprecated Interfaces
• Deprecated Classes
• Deprecated Fields
• Deprecated Methods
• Deprecated Constructors

Deprecated Interfaces

com.atlassian.jira.util.Predicate
use Guava predicates and functions

Deprecated Classes

com.atlassian.jira.util.collect.CollectionBuilder
use google quava eg. ImmutableList.builder()

com.atlassian.jira.webtests.JIRAWebTest
This is a legacy class that evolved as a result of a 'stuff every util into the base class' approach. It is probably one of the fattest classes in the JIRA code base. It has been replaced by FuncTestCase that attempts to separate its various responsibilities into multiple helper classes. Always use FuncTestCase for new func tests and attempt to migrate old tests to use it whenever possible.

com.atlassian.jira.util.dbc.Null
Use Assertions.notNull(String,Object) instead. Since v6.0.

com.atlassian.jira.util.Predicates
use Guava predicates and functions

Deprecated Fields

com.atlassian.jira.functest.framework.FuncTestCase.oldway_consider_porting
think about why you need use the old ways

Deprecated Methods

com.atlassian.jira.webtests.JIRAWebTest.activateIssueLinking()
Use IssueLinking.enable() instead.

com.atlassian.jira.webtests.JIRAWebTest.activateSubTasks()
Enables sub-tasks. Use Subtasks.enable() instead.

com.atlassian.jira.functest.framework.Administration.activateSubTasks()
use Subtasks.enable() instead.

com.atlassian.jira.webtests.JIRAWebTest.activateTimeTracking()
Use TimeTracking.enable(com.atlassian.jira.functest.framework.admin.TimeTracking.Mode) instead.

com.atlassian.jira.webtests.JIRAWebTest.addCommentOnCurrentIssue(String)
Use IssueNavigation.addComment(String, String) instead.

com.atlassian.jira.webtests.JIRAWebTest.addCommentOnCurrentIssue(String, String)
Use IssueNavigation.addComment(String, String, String) instead.

com.atlassian.jira.webtests.JIRAWebTest.addIssue(String, String, String, String)
please use IssueNavigation.createIssue(String, String, String)

com.atlassian.jira.webtests.JIRAWebTest.addProject(String, String, String)
Use Project.addProject(String, String, String) instead.

com.atlassian.jira.webtests.JIRAWebTest.addSubTaskToIssue(String, String, String, String)
please use IssueNavigation.createSubTask(String, String, String, String)

com.atlassian.jira.webtests.JIRAWebTest.addTransition(String, String, String, String, String, String)
Use WorkflowSteps.addTransition(String, String, String, String, String) instead.

com.atlassian.jira.webtests.JIRAWebTest.addUser(String)
Use UsersAndGroups.addUser(String) instead.

com.atlassian.jira.webtests.JIRAWebTest.addUser(String, String, String, String)
Use UsersAndGroups.addUser(String, String, String, String) instead.

com.atlassian.jira.webtests.JIRAWebTest.addUserToGroup(String, String)
Use UsersAndGroups.addUserToGroup(String, String) instead.

com.atlassian.jira.webtests.JIRAWebTest.assertLastChangeHistoryIs(String, String, String, String)
please use Assertions.assertLastChangeHistoryRecords(String, com.atlassian.jira.webtests.ztests.workflow.ExpectedChangeHistoryRecord)

com.atlassian.jira.webtests.AbstractAtlassianWebTestCase.assertLinkWithNameExists(String, String)

com.atlassian.jira.webtests.AbstractAtlassianWebTestCase.assertLinkWithNameNotPresent(String, String)

com.atlassian.jira.webtests.JIRAWebTest.assertLinkWithTextUrlEndsWith(String, String)
please use LinkAssertions.assertLinkLocationEndsWith(String, String)

com.atlassian.jira.webtests.WebTestCaseWrapper.assertOptionValueNotPresent(String, String)
Use WebTester.assertRadioOptionValueNotPresent(String, String)

com.atlassian.jira.webtests.JIRAWebTest.assertTableCellHasText(String, int, int, String)
please use TableAssertions.assertTableCellHasText(com.meterware.httpunit.WebTable, int, int, String)

com.atlassian.jira.webtests.JIRAWebTest.assertTableHasMatchingRow(WebTable, Object[])
please use TableAssertions.assertTableContainsRow(com.meterware.httpunit.WebTable, String[])

com.atlassian.jira.webtests.JIRAWebTest.assertTableRowEquals(WebTable, int, Object[])
please use TableAssertions.assertTableRowEquals(com.meterware.httpunit.WebTable, int, Object[])

com.atlassian.jira.webtests.AbstractAtlassianWebTestCase.assertTextPresent(String, int)
please use TextAssertions.assertTextPresentNumOccurences(String, String, int)

com.atlassian.jira.webtests.JIRAWebTest.assignIssue(String, String, String)
please use IssueNavigation.assignIssue(String, String, String)

com.atlassian.jira.webtests.JIRAWebTest.associateWorkFlowSchemeToProject(String, String)
Use Project.associateWorkflowScheme(String, String) instead.

com.atlassian.jira.webtests.JIRAWebTest.checkCommentVisibility(String, String, Iterable, Iterable)

com.atlassian.jira.webtests.JIRAWebTest.clickOnAdminPanel(String, String)
Use Navigation.gotoAdminSection(String) passing the linkId of the admin page you want to go to.

com.atlassian.jira.webtests.JIRAWebTest.clickOnNext()
please use Navigation.clickOnNext()

com.atlassian.jira.webtests.JIRAWebTest.copyWorkFlow(String, String, String)
Use ViewWorkflows.copyWorkflow(String, String, String) instead.

com.atlassian.jira.webtests.JIRAWebTest.createGroup(String)
Use UsersAndGroups.addGroup(String) instead.

com.atlassian.jira.webtests.JIRAWebTest.createSubTaskType(String, String)
Use Subtasks.addSubTaskType(String, String) instead.

com.atlassian.jira.webtests.JIRAWebTest.deactivateIssueLinking()
Use IssueLinking.disable() instead.

com.atlassian.jira.webtests.JIRAWebTest.deactivateSubTasks()
Use Subtasks.disable() instead.

com.atlassian.jira.webtests.JIRAWebTest.deactivateTimeTracking()
Use TimeTracking.disable() instead.

com.atlassian.jira.webtests.JIRAWebTest.deleteIssue(String)
Use IssueNavigation.deleteIssue(String) instead.

com.atlassian.jira.webtests.JIRAWebTest.deleteSubTaskType(String)
Use Subtasks.deleteSubTaskType(String) instead.

com.atlassian.jira.webtests.JIRAWebTest.disableIssueLinks()
Use IssueLinking.disable() instead

com.atlassian.jira.webtests.JIRAWebTest.displayAllIssues()
use IssueNavigatorNavigation.displayAllIssues()

com.atlassian.jira.functest.framework.assertions.Assertions.dumpResponse(TestCase, WebTester, Throwable)
not strictly deprecated but shouldn't be used in the code you check into main repo.

com.atlassian.jira.webtests.JIRAWebTest.easyMapBuild(K, V)

com.atlassian.jira.webtests.JIRAWebTest.easyMapBuild(K, V, K, V)

com.atlassian.jira.webtests.JIRAWebTest.easyMapBuild(K, V, K, V, K, V)

com.atlassian.jira.webtests.JIRAWebTest.getBuild()

com.atlassian.jira.webtests.JIRAWebTest.getIssueIdWithIssueKey(String)

com.atlassian.jira.functest.framework.parser.filter.FilterItem.getIssues()
JRADEV-14514 - The issues column has been removed from the filter list, so this always returns 0L, now.

com.atlassian.jira.webtests.util.TenantOverridingEnvironmentData.getJIRAHomeLocation()

com.atlassian.jira.webtests.util.JIRAEnvironmentData.getJIRAHomeLocation()
Please use JIRAEnvironmentData.getWorkingDirectory(). This was renamed to avoid confusion with the "jira-home" functionality. Deprecated since v4.0

com.atlassian.jira.webtests.JIRAWebTest.gotoAdmin()
Use Navigation.gotoAdmin() or even better Navigation.gotoAdminSection(String) instead. If there is a specific method in Navigation to navigate to the admin page you want to go to, this should be the preferred way of navigating to it. e.g Navigation.gotoDashboard()

com.atlassian.jira.webtests.JIRAWebTest.gotoFilterById(long)
please use IssueNavigatorNavigation.loadFilter(long)

com.atlassian.jira.webtests.JIRAWebTest.gotoIssue(String)
Use IssueNavigation.gotoIssue(String) instead.

com.atlassian.jira.webtests.JIRAWebTest.gotoProjectBrowse(String)

com.atlassian.jira.webtests.JIRAWebTest.gotoWorkFlow()
Use ViewWorkflows.goTo() instead.

com.atlassian.jira.webtests.JIRAWebTest.grantGlobalPermission(int, String)
Use Administration.addGlobalPermission(int, String) instead.

com.atlassian.jira.webtests.JIRAWebTest.grantGroupAllPermissions(String, String)
broken do not use

com.atlassian.jira.webtests.JIRAWebTest.grantGroupPermission(int, String)
Use PermissionSchemes.defaultScheme() and call PermissionSchemes.PermissionScheme.grantPermissionToGroup(int, String) (int, String)} on it.

com.atlassian.jira.functest.framework.admin.FieldConfigurations.FieldConfiguration.hideField(int)
since 4.2. This method is not future-proof; as fields get added to configurations, the 'id' sequence might change for the field you intended to use. Use FieldConfigurations.FieldConfiguration.hideFields(String) instead.

com.atlassian.jira.webtests.JIRAWebTest.isStepOperationDetails()
please use Workflows.assertStepOperationDetails()

com.atlassian.jira.functest.framework.parser.filter.FilterItem.Builder.issueCount(int)
JRADEV-14514 - The issues column has been removed from the filter list

com.atlassian.jira.functest.framework.admin.ViewWorkflows.launchDesigner(String)
Now the edit button always takes you to the workflow designer. Use ViewWorkflows.edit(String) instead

com.atlassian.jira.webtests.JIRAWebTest.login(String)
Use Navigation.login(String) ()} instead.

com.atlassian.jira.webtests.JIRAWebTest.login(String, String)
Use Navigation.login(String, String) instead.

com.atlassian.jira.webtests.JIRAWebTest.logout()
Use Navigation.logout() instead.

com.atlassian.jira.util.dbc.Null.not(String, Object)
Use Assertions.notNull(String,Object) instead. Since v6.0.

com.atlassian.jira.webtests.JIRAWebTest.removeGlobalPermission(int, String)
User Administration.removeGlobalPermission(int, String) instead.

com.atlassian.jira.webtests.JIRAWebTest.removeGroup(String)
Use UsersAndGroups.deleteGroup(String) instead.

com.atlassian.jira.webtests.JIRAWebTest.removeGroupPermission(int, String)
Use PermissionSchemes.defaultScheme() and call PermissionSchemes.PermissionScheme.removePermission(int, String) on it.

com.atlassian.jira.webtests.JIRAWebTest.removeUserFromGroup(String, String)
Use UsersAndGroups.removeUserFromGroup(String, String) instead.

com.atlassian.jira.webtests.JIRAWebTest.restoreBlankInstance()
Since 5.0. Use Backdoor.restoreBlankInstance() instead.

com.atlassian.jira.webtests.JIRAWebTest.restoreData(String)
Use Administration.restoreData(String) instead.

com.atlassian.jira.functest.framework.backdoor.Backdoor.restoreData(String)
use Backdoor.restoreDataFromResource(String, String) instead

com.atlassian.jira.functest.framework.backdoor.Backdoor.restoreData(String, String)

com.atlassian.jira.webtests.JIRAWebTest.setBaseUrl(String)
please use GeneralConfiguration.setBaseUrl(String)

com.atlassian.jira.functest.framework.parser.filter.FilterItem.setIssues(long)
JRADEV-14514 - The issues column has been removed from the filter list

com.atlassian.jira.webtests.JIRAWebTest.setUnassignedIssuesOption(boolean)
Please use GeneralConfigurationImpl.setAllowUnassignedIssues(boolean) instead.

com.atlassian.jira.functest.framework.admin.FieldConfigurations.FieldConfiguration.showField(int)
since 4.2. This method is not future-proof; as fields get added to configurations, the 'id' sequence might change for the field you intended to use. Use FieldConfigurations.FieldConfiguration.showFields(String) instead.

com.atlassian.jira.webtests.JIRAWebTest.startDashboardConfiguration()
use new FuncTestCase way.

com.atlassian.jira.util.collect.MapBuilder.toFastMap()
Use ImmutableMap directly instead. Since v6.1.

com.atlassian.jira.util.collect.MapBuilder.toFastSortedMap()
Use ImmutableSortedMap directly instead. Since v6.1.

com.atlassian.jira.util.collect.MapBuilder.toFastSortedMap(Comparator)
Use ImmutableSortedMap directly instead. Since v6.1.

com.atlassian.jira.util.collect.MapBuilder.toImmutableMap()
use MapBuilder.toMap() instead, or consider using ImmutableMap if if the map does not need to accept nulls.

Deprecated Constructors

com.atlassian.jira.functest.framework.parser.filter.FilterItem(long, String, String, String, long, List, Boolean, long, List, long)
JRADEV-14514 - The issues column has been removed from the filter list