com.atlassian.bamboo.author
Interface AuthorDao

All Superinterfaces:
BambooObjectDao<ExtendedAuthor>
All Known Implementing Classes:
AuthorHibernateDao

public interface AuthorDao
extends BambooObjectDao<ExtendedAuthor>


Method Summary
 java.util.Collection<? extends ExtendedAuthor> findAll()
          Get all ExtendedAuthor entities
 java.util.List<Author> findAuthorsByLinkedUser(java.lang.String userSearchString)
          Performs a case insensitive search for authors by their linkedUserName.
 java.util.List<Author> findAuthorsByName(java.lang.String authorSearchString)
          Performs a case insensitive search for authors by their author name.
 java.util.List<Author> findAuthorsThatStartWith(java.lang.String authorSearchString, boolean unlinkedOnly)
          Performs a case insensitive search for authors by their author name.
 ExtendedAuthor findById(long id)
          Find an ExtendedAuthor object of a given id.
 java.util.Set<ExtendedAuthor> getAllUnlinkedAuthors()
           
 ExtendedAuthor getAuthorByName(java.lang.String name)
           
 java.util.List<ResultsSummary> getBuildResultsBrokenByAuthor(ExtendedAuthor author, int maxResultCount)
           
 java.util.List<ResultsSummary> getBuildResultsFailedByAuthor(ExtendedAuthor author, int maxResultCount)
           
 java.util.List<ResultsSummary> getBuildResultsFixedByAuthor(ExtendedAuthor author, int maxResultCount)
           
 java.util.List<ResultsSummary> getBuildResultsSuccessfulByAuthor(ExtendedAuthor author, int maxResultCount)
           
 java.util.List<ResultsSummary> getBuildResultsTriggeredByAuthor(ExtendedAuthor author, int maxResultCount)
           
 java.util.List<ExtendedAuthor> getLinkedAuthorsForUser(com.atlassian.user.User user)
           
 int getNumberOfBuildBrokenByAuthor(ExtendedAuthor author)
           
 int getNumberOfBuildFixedByAuthor(ExtendedAuthor author)
           
 int getNumberOfBuildsTriggeredByAuthor(ExtendedAuthor author)
           
 int getNumberOfFailedBuildsByAuthor(ExtendedAuthor author)
           
 int getNumberOfSuccessfulBuildsByAuthor(ExtendedAuthor author)
           
 java.util.List<ResultsSummary> getRecentResultsTriggeredByAuthors(java.util.List<ExtendedAuthor> author, int maxDays)
          Retrieve all build results triggered by the author in the last X days
 void unlinkLinkedAuthors(com.atlassian.user.User user)
          Removes the link between User and all Author entities, User was linked to
 void updateLinkedAuthors(com.atlassian.user.User user, java.util.List<java.lang.Long> authorIds)
          Updates list of Authors linked to a User.
 
Methods inherited from interface com.atlassian.bamboo.persistence3.BambooObjectDao
delete, deleteAll, executeReturnLong, findAll, findById, save, saveAll
 

Method Detail

findById

@Nullable
ExtendedAuthor findById(long id)
Find an ExtendedAuthor object of a given id.

Parameters:
id - id of Author to be found
Returns:
ExtendedAuthor object or null if not found

findAll

@NotNull
java.util.Collection<? extends ExtendedAuthor> findAll()
Get all ExtendedAuthor entities

Returns:
Collection of ExtendedAuthor

getAuthorByName

ExtendedAuthor getAuthorByName(java.lang.String name)
Parameters:
name -
Returns:
a ExtendedAuthor object given an author name

getBuildResultsTriggeredByAuthor

@NotNull
java.util.List<ResultsSummary> getBuildResultsTriggeredByAuthor(ExtendedAuthor author,
                                                                        int maxResultCount)
Parameters:
author -
maxResultCount -
Returns:
List of BuildResultsSummary triggered by author

getBuildResultsFailedByAuthor

@NotNull
java.util.List<ResultsSummary> getBuildResultsFailedByAuthor(ExtendedAuthor author,
                                                                     int maxResultCount)
Parameters:
author -
maxResultCount -
Returns:
List of BuildResultsSummary triggered by author and failed

getBuildResultsSuccessfulByAuthor

@NotNull
java.util.List<ResultsSummary> getBuildResultsSuccessfulByAuthor(ExtendedAuthor author,
                                                                         int maxResultCount)
Parameters:
author -
maxResultCount -
Returns:
List of BuildResultsSummary triggered by author and succesful

getBuildResultsBrokenByAuthor

@NotNull
java.util.List<ResultsSummary> getBuildResultsBrokenByAuthor(ExtendedAuthor author,
                                                                     int maxResultCount)
Parameters:
author -
maxResultCount -
Returns:
List of BuildResultsSummary broken by author

getBuildResultsFixedByAuthor

@NotNull
java.util.List<ResultsSummary> getBuildResultsFixedByAuthor(ExtendedAuthor author,
                                                                    int maxResultCount)
Parameters:
author -
maxResultCount -
Returns:
List of BuildResultsSummary fixed by author

getNumberOfBuildsTriggeredByAuthor

int getNumberOfBuildsTriggeredByAuthor(ExtendedAuthor author)
Parameters:
author -
Returns:
int

getNumberOfFailedBuildsByAuthor

int getNumberOfFailedBuildsByAuthor(ExtendedAuthor author)
Parameters:
author -
Returns:
int

getNumberOfSuccessfulBuildsByAuthor

int getNumberOfSuccessfulBuildsByAuthor(ExtendedAuthor author)
Parameters:
author -
Returns:
int

getNumberOfBuildFixedByAuthor

int getNumberOfBuildFixedByAuthor(ExtendedAuthor author)
Parameters:
author -
Returns:
int

getNumberOfBuildBrokenByAuthor

int getNumberOfBuildBrokenByAuthor(ExtendedAuthor author)
Parameters:
author -
Returns:
int

getAllUnlinkedAuthors

@NotNull
java.util.Set<ExtendedAuthor> getAllUnlinkedAuthors()
Returns:
Set of ExtendedAuthor which are not yet linked to any user.

getLinkedAuthorsForUser

@NotNull
java.util.List<ExtendedAuthor> getLinkedAuthorsForUser(com.atlassian.user.User user)
Parameters:
user -
Returns:
List of ExtendedAuthor which are linked to a given user.

getRecentResultsTriggeredByAuthors

java.util.List<ResultsSummary> getRecentResultsTriggeredByAuthors(java.util.List<ExtendedAuthor> author,
                                                                  int maxDays)
Retrieve all build results triggered by the author in the last X days

Parameters:
author - the builds will be triggered by
maxDays - number of days to look back in history
Returns:
all build results triggered by the author in the last X days

unlinkLinkedAuthors

void unlinkLinkedAuthors(@NotNull
                         com.atlassian.user.User user)
Removes the link between User and all Author entities, User was linked to

Parameters:
user - user

updateLinkedAuthors

void updateLinkedAuthors(@NotNull
                         com.atlassian.user.User user,
                         @NotNull
                         java.util.List<java.lang.Long> authorIds)
Updates list of Authors linked to a User. As a result of this operation only Authors with id listed in authorIds will be linked to user

Parameters:
user - user
authorIds - list of Author id that should be linked to user

findAuthorsByName

@NotNull
java.util.List<Author> findAuthorsByName(@NotNull
                                                 java.lang.String authorSearchString)
Performs a case insensitive search for authors by their author name. AuthorSearchString can appear anywhere in the authors name.

Parameters:
authorSearchString - string to search for
Returns:
any authors who's author name match the given string.

findAuthorsThatStartWith

@NotNull
java.util.List<Author> findAuthorsThatStartWith(java.lang.String authorSearchString,
                                                        boolean unlinkedOnly)
Performs a case insensitive search for authors by their author name.

Parameters:
authorSearchString - string to search for
unlinkedOnly - if true will only return users which have not been linked with a user already
Returns:
any authors who's author name match the given string.

findAuthorsByLinkedUser

@NotNull
java.util.List<Author> findAuthorsByLinkedUser(@NotNull
                                                       java.lang.String userSearchString)
Performs a case insensitive search for authors by their linkedUserName. userSearchString can appear anywhere in the linked user name.

Parameters:
userSearchString - string to search for
Returns:
any authors who's linkedusername match the given string.


Copyright © 2012 Atlassian. All Rights Reserved.