jetbrains.buildServer.responsibility
Interface TestNameResponsibilityFacade

All Known Subinterfaces:
STestNameResponsibilityFacade

public interface TestNameResponsibilityFacade

Provides the interface to access and modify the responsibility on a test name. Thread-safe.

Since:
5.0
Author:
Maxim Podkolzine (maxim.podkolzine@jetbrains.com)

Method Summary
 ResponsibilityEntry findTestNameResponsibility(TestName testName, java.lang.String projectId)
          Returns the responsibility entry for a test name in a project, or null if it does not exist.
 java.util.List<TestNameResponsibilityEntry> getUserTestNameResponsibilities(User user, java.lang.String projectId)
          Returns the list of entries associated with the user (if specified) in a specified project.
 void removeTestNameResponsibility(TestName testName, java.lang.String projectId)
          Removes the responsibility entry associated with the test name.
 void setTestNameResponsibility(java.util.Collection<TestName> testNames, java.lang.String projectId, ResponsibilityEntry entry)
          Sets the responsibility for several tests at once in a specified project.
 void setTestNameResponsibility(TestName testName, java.lang.String projectId, ResponsibilityEntry entry)
          Sets the responsibility entry for the test name in a specified project.
 

Method Detail

findTestNameResponsibility

@Nullable
ResponsibilityEntry findTestNameResponsibility(@NotNull
                                                        TestName testName,
                                                        @NotNull
                                                        java.lang.String projectId)
Returns the responsibility entry for a test name in a project, or null if it does not exist.

Parameters:
testName - the test name
projectId - project id
Returns:
responsibility entry, or null

getUserTestNameResponsibilities

@NotNull
java.util.List<TestNameResponsibilityEntry> getUserTestNameResponsibilities(@Nullable
                                                                                    User user,
                                                                                    @Nullable
                                                                                    java.lang.String projectId)
Returns the list of entries associated with the user (if specified) in a specified project.

Parameters:
user - the responsible user; null means all users
projectId - the project id; null means all projects
Returns:
list of responsibilities
Since:
projectId is nullable since TeamCity 7.0

setTestNameResponsibility

void setTestNameResponsibility(@NotNull
                               TestName testName,
                               @NotNull
                               java.lang.String projectId,
                               @NotNull
                               ResponsibilityEntry entry)
Sets the responsibility entry for the test name in a specified project.

Note: if new reporter user isn't set (entry.getReporterUser() == null), it is not overwritten.

Parameters:
testName - the test name
projectId - the project id
entry - responsibility entry

setTestNameResponsibility

void setTestNameResponsibility(@NotNull
                               java.util.Collection<TestName> testNames,
                               @NotNull
                               java.lang.String projectId,
                               @NotNull
                               ResponsibilityEntry entry)
Sets the responsibility for several tests at once in a specified project.

Parameters:
testNames - collection of test names
projectId - the project id
entry - new responsibility entry
Since:
6.0
See Also:
setTestNameResponsibility(TestName, String, ResponsibilityEntry)

removeTestNameResponsibility

void removeTestNameResponsibility(@NotNull
                                  TestName testName,
                                  @NotNull
                                  java.lang.String projectId)
Removes the responsibility entry associated with the test name.

Parameters:
testName - the test name
projectId - the project id