org.squashtest.csp.tm.internal.service.bugtracker
Class BugTrackersLocalServiceImpl

java.lang.Object
  org.squashtest.csp.tm.internal.service.bugtracker.BugTrackersLocalServiceImpl

All Implemented Interfaces:

BugTrackersLocalService

@Service(value="squashtest.tm.service.BugTrackersLocalService")
@Transactional
public class BugTrackersLocalServiceImpl
extends Object
implements BugTrackersLocalService

Constructor Summary

BugTrackersLocalServiceImpl()

Method Summary

void	attachIssue(IssueDetector bugged, String remoteIssueKey) Will attach an existing issue to the issue detector
BugTrackerStatus	checkBugTrackerStatus(Long projectId) same as BugTrackersLocalService.checkBugTrackerStatus(Project), using the id of the project instead.
BugTrackerStatus	checkBugTrackerStatus(Project project) tests if the bugtracker is ready for use
org.squashtest.csp.core.bugtracker.domain.BTIssue	createIssue(IssueDetector entity, org.squashtest.csp.core.bugtracker.domain.BTIssue btIssue) adds a new Issue to the entity.
org.squashtest.csp.core.bugtracker.domain.BTProject	findRemoteProject(String name, org.squashtest.csp.core.bugtracker.domain.BugTracker bugTracker) returns an instance of the remote project.
FilteredCollectionHolder<List<IssueOwnership<org.squashtest.csp.core.bugtracker.domain.BTIssue>>>	findSortedIssueOwnershipForIteration(Long iterId, CollectionSorting sorter) Given an Iteration, returns a list of linked BTIssue (not Issue).
FilteredCollectionHolder<List<IssueOwnership<org.squashtest.csp.core.bugtracker.domain.BTIssue>>>	findSortedIssueOwnershipForTestCase(Long tcId, CollectionSorting sorter) Given a TestCase, returns a list of linked BTIssue (not Issue).
FilteredCollectionHolder<List<IssueOwnership<org.squashtest.csp.core.bugtracker.domain.BTIssue>>>	findSortedIssueOwnershipsForCampaigns(Long campId, CollectionSorting sorter) Given an Campaign, returns a list of linked BTIssue (not Issue) To keep track of which IssueDetector owns which issue, the data are wrapped in a IssueOwnership (that just pair the informations together).
FilteredCollectionHolder<List<IssueOwnership<org.squashtest.csp.core.bugtracker.domain.BTIssue>>>	findSortedIssueOwnershipsforExecution(Long execId, CollectionSorting sorter) Given an Execution, returns a list of linked BTIssue (not Issue).
FilteredCollectionHolder<List<IssueOwnership<org.squashtest.csp.core.bugtracker.domain.BTIssue>>>	findSortedIssueOwnerShipsForExecutionStep(Long stepId, CollectionSorting sorter) Given an ExecutionStep, returns a list of linked BTIssue (not Issue).
FilteredCollectionHolder<List<IssueOwnership<org.squashtest.csp.core.bugtracker.domain.BTIssue>>>	findSortedIssueOwnershipsForTestSuite(Long testSuiteId, CollectionSorting sorter) Given a TestSuite, returns a list of linked BTIssue (not Issue).
org.squashtest.csp.core.bugtracker.spi.BugTrackerInterfaceDescriptor	getInterfaceDescriptor(org.squashtest.csp.core.bugtracker.domain.BugTracker bugTracker) An InterfaceDescriptor contains informations relevant to the generation of a view/GUI.
org.squashtest.csp.core.bugtracker.domain.BTIssue	getIssue(String issueKey, org.squashtest.csp.core.bugtracker.domain.BugTracker bugTracker) returns a remote issue using its key
List<org.squashtest.csp.core.bugtracker.domain.BTIssue>	getIssues(List<String> issueKeyList, org.squashtest.csp.core.bugtracker.domain.BugTracker bugTracker) returns a list of BTIssu corresponding to the given string keys
URL	getIssueUrl(String btIssueId, org.squashtest.csp.core.bugtracker.domain.BugTracker bugTracker) Gets the url of a remote Issue given its Id
Set<String>	getProviderKinds()
List<org.squashtest.csp.core.bugtracker.domain.Priority>	getRemotePriorities(org.squashtest.csp.core.bugtracker.domain.BugTracker bugTracker) returns the list of priorities .
void	setCredentials(String username, String password, org.squashtest.csp.core.bugtracker.domain.BugTracker bugTracker) sets the credentials of an user for authentication bugtracker-side.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

BugTrackersLocalServiceImpl

public BugTrackersLocalServiceImpl()

Method Detail

getInterfaceDescriptor

public org.squashtest.csp.core.bugtracker.spi.BugTrackerInterfaceDescriptor getInterfaceDescriptor(org.squashtest.csp.core.bugtracker.domain.BugTracker bugTracker)

Description copied from interface: BugTrackersLocalService

An InterfaceDescriptor contains informations relevant to the generation of a view/GUI. See the class for more details.

Specified by:

getInterfaceDescriptor in interface BugTrackersLocalService

Parameters:

bugTracker - the concerned BugTracker

Returns:

an InterfaceDescriptor.

checkBugTrackerStatus

@PreAuthorize(value="hasPermission(#entity, \'EXECUTE\') or hasRole(\'ROLE_ADMIN\')")
public BugTrackerStatus checkBugTrackerStatus(Project project)

Description copied from interface: BugTrackersLocalService

tests if the bugtracker is ready for use

Specified by:

checkBugTrackerStatus in interface BugTrackersLocalService

Parameters:

project - : the concerned Project

Returns:

the status of the bugtracker

checkBugTrackerStatus

public BugTrackerStatus checkBugTrackerStatus(Long projectId)

Description copied from interface: BugTrackersLocalService

same as BugTrackersLocalService.checkBugTrackerStatus(Project), using the id of the project instead.

Specified by:

checkBugTrackerStatus in interface BugTrackersLocalService

Returns:

createIssue

public org.squashtest.csp.core.bugtracker.domain.BTIssue createIssue(IssueDetector entity,
                                                                     org.squashtest.csp.core.bugtracker.domain.BTIssue btIssue)

Description copied from interface: BugTrackersLocalService

adds a new Issue to the entity. The entity must implement IssueDetector.

Specified by:

createIssue in interface BugTrackersLocalService

btIssue - : the issue to add

Returns:

the BTIssue corresponding to the bug remotely created

getIssue

public org.squashtest.csp.core.bugtracker.domain.BTIssue getIssue(String issueKey,
                                                                  org.squashtest.csp.core.bugtracker.domain.BugTracker bugTracker)

Description copied from interface: BugTrackersLocalService

returns a remote issue using its key

Specified by:

getIssue in interface BugTrackersLocalService

bugTracker - : the concerned BugTracker

Returns:

a remote issue

getIssues

public List<org.squashtest.csp.core.bugtracker.domain.BTIssue> getIssues(List<String> issueKeyList,
                                                                         org.squashtest.csp.core.bugtracker.domain.BugTracker bugTracker)

Description copied from interface: BugTrackersLocalService

returns a list of BTIssu corresponding to the given string keys

Specified by:

getIssues in interface BugTrackersLocalService

Parameters:

issueKeyList - the remote issue key list

bugTracker - : the concerned BugTracker

Returns:

a BTIssue list

findRemoteProject

public org.squashtest.csp.core.bugtracker.domain.BTProject findRemoteProject(String name,
                                                                             org.squashtest.csp.core.bugtracker.domain.BugTracker bugTracker)

Description copied from interface: BugTrackersLocalService

returns an instance of the remote project.

Specified by:

findRemoteProject in interface BugTrackersLocalService

Parameters:

name - : the name of the project.

bugTracker - : the concerned BugTracker

Returns:

the project filled with users and versions if found.

getRemotePriorities

public List<org.squashtest.csp.core.bugtracker.domain.Priority> getRemotePriorities(org.squashtest.csp.core.bugtracker.domain.BugTracker bugTracker)

Description copied from interface: BugTrackersLocalService

returns the list of priorities .

Specified by:

getRemotePriorities in interface BugTrackersLocalService

Parameters:

bugTracker - : the concerned BugTracker

Returns:

the list of priorities. An empty list is returned if none are found.

setCredentials

public void setCredentials(String username,
                           String password,
                           org.squashtest.csp.core.bugtracker.domain.BugTracker bugTracker)

Description copied from interface: BugTrackersLocalService

sets the credentials of an user for authentication bugtracker-side.

Specified by:

setCredentials in interface BugTrackersLocalService

bugTracker - : the concerned BugTracker

getIssueUrl

public URL getIssueUrl(String btIssueId,
                       org.squashtest.csp.core.bugtracker.domain.BugTracker bugTracker)

Description copied from interface: BugTrackersLocalService

Gets the url of a remote Issue given its Id

Specified by:

getIssueUrl in interface BugTrackersLocalService

Parameters:

btIssueId - the id of that issue

bugTracker - : the concerned BugTracker

Returns:

the URL where you may find that issue.

attachIssue

@PreAuthorize(value="hasPermission(#bugged, \'EXECUTE\') or hasRole(\'ROLE_ADMIN\')")
public void attachIssue(IssueDetector bugged,
                                     String remoteIssueKey)

Description copied from interface: BugTrackersLocalService

Will attach an existing issue to the issue detector

Specified by:

attachIssue in interface BugTrackersLocalService

Parameters:

bugged - : the furure issue holder

remoteIssueKey - : the identificator of the issue in the BT

findSortedIssueOwnerShipsForExecutionStep

@PreAuthorize(value="hasPermission(#stepId, \'org.squashtest.csp.tm.domain.execution.ExecutionStep\', \'READ\') or hasRole(\'ROLE_ADMIN\')")
public FilteredCollectionHolder<List<IssueOwnership<org.squashtest.csp.core.bugtracker.domain.BTIssue>>> findSortedIssueOwnerShipsForExecutionStep(Long stepId,
                                                                                                                                                                CollectionSorting sorter)

Description copied from interface: BugTrackersLocalService

Given an ExecutionStep, returns a list of linked BTIssue (not Issue).

To keep track of which IssueDetector owns which issue, the data are wrapped in a IssueOwnership (that just pair the informations together).

Specified by:

findSortedIssueOwnerShipsForExecutionStep in interface BugTrackersLocalService

Parameters:

stepId - of which we need to get the issues,

sorter - that tells us how we should sort and filter the data

Returns:

a FilteredCollectionHolder containing a non-null but possibly empty list of IssueOwnership, sorted and filtered according to the CollectionSorting.

findSortedIssueOwnershipsforExecution

@PreAuthorize(value="hasPermission(#execId, \'org.squashtest.csp.tm.domain.execution.Execution\', \'READ\') or hasRole(\'ROLE_ADMIN\')")
public FilteredCollectionHolder<List<IssueOwnership<org.squashtest.csp.core.bugtracker.domain.BTIssue>>> findSortedIssueOwnershipsforExecution(Long execId,
                                                                                                                                                            CollectionSorting sorter)

Description copied from interface: BugTrackersLocalService

Given an Execution, returns a list of linked BTIssue (not Issue).

To keep track of which IssueDetector owns which issue, the data are wrapped in a IssueOwnership (that just pair the informations together).

Specified by:

findSortedIssueOwnershipsforExecution in interface BugTrackersLocalService

Parameters:

execId - of which we need to get the issues,

sorter - that tells us how we should sort and filter the data

Returns:

a FilteredCollectionHolder containing a non-null but possibly empty list of IssueOwnership, sorted and filtered according to the CollectionSorting.

findSortedIssueOwnershipForIteration

@PreAuthorize(value="hasPermission(#iterId, \'org.squashtest.csp.tm.domain.campaign.Iteration\', \'READ\') or hasRole(\'ROLE_ADMIN\')")
public FilteredCollectionHolder<List<IssueOwnership<org.squashtest.csp.core.bugtracker.domain.BTIssue>>> findSortedIssueOwnershipForIteration(Long iterId,
                                                                                                                                                           CollectionSorting sorter)

Description copied from interface: BugTrackersLocalService

Given an Iteration, returns a list of linked BTIssue (not Issue).

To keep track of which IssueDetector owns which issue, the data are wrapped in a IssueOwnership (that just pair the informations together).

Specified by:

findSortedIssueOwnershipForIteration in interface BugTrackersLocalService

Parameters:

iterId - of which we need to get the issues,

sorter - that tells us how we should sort and filter the data

Returns:

a FilteredCollectionHolder containing a non-null but possibly empty list of IssueOwnership, sorted and filtered according to the CollectionSorting.

findSortedIssueOwnershipsForCampaigns

@PreAuthorize(value="hasPermission(#campId, \'org.squashtest.csp.tm.domain.campaign.Campaign\' ,\'READ\') or hasRole(\'ROLE_ADMIN\')")
public FilteredCollectionHolder<List<IssueOwnership<org.squashtest.csp.core.bugtracker.domain.BTIssue>>> findSortedIssueOwnershipsForCampaigns(Long campId,
                                                                                                                                                            CollectionSorting sorter)

Description copied from interface: BugTrackersLocalService

Given an Campaign, returns a list of linked BTIssue (not Issue)

To keep track of which IssueDetector owns which issue, the data are wrapped in a IssueOwnership (that just pair the informations together).

Specified by:

findSortedIssueOwnershipsForCampaigns in interface BugTrackersLocalService

Parameters:

campId - of which we need to get the issues,

sorter - that tells us how we should sort and filter the data

Returns:

a FilteredCollectionHolder containing a non-null but possibly empty list of IssueOwnership, sorted and filtered according to the CollectionSorting.

findSortedIssueOwnershipsForTestSuite

@PreAuthorize(value="hasPermission(#testSuiteId, \'org.squashtest.csp.tm.domain.campaign.TestSuite\', \'READ\') or hasRole(\'ROLE_ADMIN\')")
public FilteredCollectionHolder<List<IssueOwnership<org.squashtest.csp.core.bugtracker.domain.BTIssue>>> findSortedIssueOwnershipsForTestSuite(Long testSuiteId,
                                                                                                                                                            CollectionSorting sorter)

Description copied from interface: BugTrackersLocalService

Given a TestSuite, returns a list of linked BTIssue (not Issue).

To keep track of which IssueDetector owns which issue, the data are wrapped in a IssueOwnership (that just pair the informations together).

Specified by:

findSortedIssueOwnershipsForTestSuite in interface BugTrackersLocalService

Parameters:

testSuiteId - for which we need to get the issues,

sorter - that tells us how we should sort and filter the data

Returns:

a FilteredCollectionHolder containing a non-null but possibly empty list of IssueOwnership, sorted and filtered according to the CollectionSorting.

findSortedIssueOwnershipForTestCase

@PreAuthorize(value="hasPermission(#tcId, \'org.squashtest.csp.tm.domain.testcase.TestCase\', \'READ\') or hasRole(\'ROLE_ADMIN\')")
public FilteredCollectionHolder<List<IssueOwnership<org.squashtest.csp.core.bugtracker.domain.BTIssue>>> findSortedIssueOwnershipForTestCase(Long tcId,
                                                                                                                                                          CollectionSorting sorter)

Description copied from interface: BugTrackersLocalService

Given a TestCase, returns a list of linked BTIssue (not Issue).

To keep track of which IssueDetector owns which issue, the data are wrapped in a IssueOwnership (that just pair the informations together).

Specified by:

findSortedIssueOwnershipForTestCase in interface BugTrackersLocalService

sorter - that tells us how we should sort and filter the data

Returns:

a FilteredCollectionHolder containing a non-null but possibly empty list of IssueOwnership, sorted and filtered according to the CollectionSorting.

getProviderKinds

public Set<String> getProviderKinds()

Specified by:

getProviderKinds in interface BugTrackersLocalService

Returns:

the list of all bugtracker kinds available