org.nuiton.jredmine.service

Class DefaultRedmineService

java.lang.Object

org.nuiton.jredmine.service.AbstractRedmineService

org.nuiton.jredmine.service.DefaultRedmineService

All Implemented Interfaces:

RedmineAnonymousService, RedmineLogguedService, RedmineService

public class DefaultRedmineService
extends AbstractRedmineService
implements RedmineService

Default implementation of the RedmineService.

Since:

1.5

Author:

Tony Chemit - chemit@codelutin.com

Plexus component:

role: "org.nuiton.jredmine.service.RedmineService" role-hint: "default"

Field Summary

Fields

Modifier and Type	Field and Description
protected DateFormat	DATE_FORMAT

Fields inherited from interface org.nuiton.jredmine.service.RedmineService

ROLE

Constructor Summary

Constructors

Constructor and Description
DefaultRedmineService()

Method Summary

Modifier and Type	Method and Description
Attachment	addAttachment(String projectName, String versionName, Attachment attachment) Add a attachment for a given version of a given project.
TimeEntry	addIssueTimeEntry(String projectName, String issueId, TimeEntry timeEntry) Add a new time entry to the given issue for the given project and return the updated time entry.
News	addNews(String projectName, News news) Add a news for a given project.
Version	addVersion(String projectName, Version version) Add a version for a given project.
Attachment[]	getAttachments(String projectName, String versionName) Obtain all attachments for a specific version on a given project.
Issue[]	getClosedIssues(String projectName) Obtain all closed issues for a given project.
User	getCurrentUser() Obtain the redmine user from the credentials given in the service configuration.
IssueCategory[]	getIssueCategories(String projectName) Obtain all categories defined on issues for a given project.
IssuePriority[]	getIssuePriorities() Obtain all the priorities defined on a Issue.
Issue[]	getIssues(String projectName) Obtain all issues for a given project.
Issue[]	getIssues(String projectName, String versionName) Obtain all issues for a specific version on a given project.
IssueStatus[]	getIssueStatuses() Obtain all the statuses defined on a Issue.
TimeEntry[]	getIssueTimeEntries(String projectName, String issueId) Obtain for a given issue of a given project all the time entries.
Version	getLastestClosedVersion(String projectName) Obtain the lastest closed version for a given project.
News[]	getNews(String projectName) Obtain all news defined on a given project.
Issue[]	getOpenedIssues(String projectName) Obtain all opened issues for a given project.
Project	getProject(String projectName) Obtain a project given his name.
User[]	getProjectMembers(String projectName) Obtain all users defined on a given project.
Project[]	getProjects() Obtain all accessible projects.
Tracker[]	getTrackers(String projectName) Obtain all trackers defined on a given project.
Project[]	getUserProjects() Obtain for the loggued user, all projets where he belongs.
Version	getVersion(String projectName, String versionName) Obtain a specific version for a given project.
protected String	getVersionEffectiveDate(Version version)
Version[]	getVersions(String projectName) Obtain all versions defined on a given project.
protected String	getVersionStatus(Version version)
void	init(RedmineServiceConfiguration configuration) Initialize the service.
Version	nextVersion(String projectName, String oldVersionName, Version version) Prepare a new version (create it or update it).
Version	updateVersion(String projectName, Version version) Update a version for a given project.

Methods inherited from class org.nuiton.jredmine.service.AbstractRedmineService

checkInit, checkLoggued, checkSessionConfigurationNotNull, checkSessionNotNull, destroy, executeRequestAndReturnData, executeRequestAndReturnDatas, getClient, isInit

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.nuiton.jredmine.service.RedmineAnonymousService

destroy, isInit

Field Detail

DATE_FORMAT

protected final DateFormat DATE_FORMAT

Constructor Detail

DefaultRedmineService

public DefaultRedmineService()

Method Detail

init

public void init(RedmineServiceConfiguration configuration)
          throws RedmineServiceException

Description copied from interface: RedmineAnonymousService

Initialize the service.

Specified by:

init in interface RedmineAnonymousService

Overrides:

init in class AbstractRedmineService

Parameters:

configuration - the configuration to be used to init the internal redmine client

Throws:

RedmineServiceException - if any pb

getIssueStatuses

public IssueStatus[] getIssueStatuses()
                               throws RedmineServiceException

Description copied from interface: RedmineAnonymousService

Obtain all the statuses defined on a Issue. Note : The statuses are common for all projects.

Specified by:

getIssueStatuses in interface RedmineAnonymousService

Returns:

all the issue statuses

Throws:

RedmineServiceException - if any pb while retriving datas

See Also:

IssueStatus

getIssuePriorities

public IssuePriority[] getIssuePriorities()
                                   throws RedmineServiceException

Description copied from interface: RedmineAnonymousService

Obtain all the priorities defined on a Issue. Note : The priorities are common for all projects.

Specified by:

getIssuePriorities in interface RedmineAnonymousService

Returns:

all the issue properties

Throws:

RedmineServiceException - if any pb while retriving datas

See Also:

IssuePriority

getProjects

public Project[] getProjects()
                      throws RedmineServiceException

Description copied from interface: RedmineAnonymousService

Obtain all accessible projects.

Specified by:

getProjects in interface RedmineAnonymousService

Returns:

all the projects

Throws:

RedmineServiceException - if any pb while retriving datas

See Also:

Project

getIssueCategories

public IssueCategory[] getIssueCategories(String projectName)
                                   throws RedmineServiceException

Description copied from interface: RedmineAnonymousService

Obtain all categories defined on issues for a given project.

Specified by:

getIssueCategories in interface RedmineAnonymousService

Parameters:

projectName - the name of the project

Returns:

the categories of issues for the given project.

Throws:

RedmineServiceException - if any pb while retriving datas

See Also:

IssueCategory

getProject

public Project getProject(String projectName)
                   throws RedmineServiceException

Description copied from interface: RedmineAnonymousService

Obtain a project given his name.

Specified by:

getProject in interface RedmineAnonymousService

Parameters:

projectName - the name of the project

Returns:

the project

Throws:

RedmineServiceException - if any pb while retriving datas

See Also:

Project

getTrackers

public Tracker[] getTrackers(String projectName)
                      throws RedmineServiceException

Description copied from interface: RedmineAnonymousService

Obtain all trackers defined on a given project.

Specified by:

getTrackers in interface RedmineAnonymousService

Parameters:

projectName - the name of the project

Returns:

the trackers for the given project.

Throws:

RedmineServiceException - if any pb while retriving datas

See Also:

Tracker

getNews

public News[] getNews(String projectName)
               throws RedmineServiceException

Description copied from interface: RedmineAnonymousService

Obtain all news defined on a given project.

Specified by:

getNews in interface RedmineAnonymousService

Parameters:

projectName - the name of the project

Returns:

the news for the given project.

Throws:

RedmineServiceException - if any pb while retriving datas

See Also:

News

getProjectMembers

public User[] getProjectMembers(String projectName)
                         throws RedmineServiceException

Description copied from interface: RedmineAnonymousService

Obtain all users defined on a given project.

Specified by:

getProjectMembers in interface RedmineAnonymousService

Parameters:

projectName - the name of the project

Returns:

the users for the given project.

Throws:

RedmineServiceException - if any pb while retriving datas

See Also:

User

getVersions

public Version[] getVersions(String projectName)
                      throws RedmineServiceException

Description copied from interface: RedmineAnonymousService

Obtain all versions defined on a given project.

Specified by:

getVersions in interface RedmineAnonymousService

Parameters:

projectName - the name of the project

Returns:

the versions of the given project.

Throws:

RedmineServiceException - if any pb while retriving datas

See Also:

Version

getVersion

public Version getVersion(String projectName,
                          String versionName)
                   throws RedmineServiceException

Description copied from interface: RedmineAnonymousService

Obtain a specific version for a given project.

Specified by:

getVersion in interface RedmineAnonymousService

Parameters:

projectName - the name of the project

versionName - the name of the version

Returns:

the version

Throws:

RedmineServiceException - if any pb while retriving datas

See Also:

Version

getLastestClosedVersion

public Version getLastestClosedVersion(String projectName)
                                throws RedmineServiceException

Description copied from interface: RedmineAnonymousService

Obtain the lastest closed version for a given project.

Specified by:

getLastestClosedVersion in interface RedmineAnonymousService

Parameters:

projectName - the name of the project

Returns:

the version (or null if no version is matching)

Throws:

RedmineServiceException - if any pb while retriving datas

See Also:

Version

getAttachments

public Attachment[] getAttachments(String projectName,
                                   String versionName)
                            throws RedmineServiceException

Description copied from interface: RedmineAnonymousService

Obtain all attachments for a specific version on a given project.

Specified by:

getAttachments in interface RedmineAnonymousService

Parameters:

projectName - the name of the project

versionName - the name of the version

Returns:

the attachments

Throws:

RedmineServiceException - if any pb while retriving datas

See Also:

Attachment

getIssues

public Issue[] getIssues(String projectName,
                         String versionName)
                  throws RedmineServiceException

Description copied from interface: RedmineAnonymousService

Obtain all issues for a specific version on a given project.

Specified by:

getIssues in interface RedmineAnonymousService

Parameters:

projectName - the name of the project

versionName - the name of the version

Returns:

the issues

Throws:

RedmineServiceException - if any pb while retriving datas

See Also:

Issue

getIssueTimeEntries

public TimeEntry[] getIssueTimeEntries(String projectName,
                                       String issueId)
                                throws RedmineServiceException

Description copied from interface: RedmineAnonymousService

Obtain for a given issue of a given project all the time entries.

Specified by:

getIssueTimeEntries in interface RedmineAnonymousService

Parameters:

projectName - the name of the project

issueId - the id of the issue

Returns:

the time entries of the issue

Throws:

RedmineServiceException - if any pb while retrieving time entries of the issue

getIssues

public Issue[] getIssues(String projectName)
                  throws RedmineServiceException

Description copied from interface: RedmineAnonymousService

Obtain all issues for a given project.

Specified by:

getIssues in interface RedmineAnonymousService

Parameters:

projectName - the name of the project

Returns:

the issues

Throws:

RedmineServiceException - if any pb while retriving datas

See Also:

Issue

getOpenedIssues

public Issue[] getOpenedIssues(String projectName)
                        throws RedmineServiceException

Description copied from interface: RedmineAnonymousService

Obtain all opened issues for a given project.

Specified by:

getOpenedIssues in interface RedmineAnonymousService

Parameters:

projectName - the name of the project

Returns:

the issues

Throws:

RedmineServiceException - if any pb while retriving datas

See Also:

Issue

getClosedIssues

public Issue[] getClosedIssues(String projectName)
                        throws RedmineServiceException

Description copied from interface: RedmineAnonymousService

Obtain all closed issues for a given project.

Specified by:

getClosedIssues in interface RedmineAnonymousService

Parameters:

projectName - the name of the project

Returns:

the issues

Throws:

RedmineServiceException - if any pb while retriving datas

See Also:

Issue

getCurrentUser

public User getCurrentUser()
                    throws RedmineServiceException

Description copied from interface: RedmineLogguedService

Obtain the redmine user from the credentials given in the service configuration.

Specified by:

getCurrentUser in interface RedmineLogguedService

Returns:

the current user using the credentials of the service configuration

Throws:

RedmineServiceException - if any pb

getUserProjects

public Project[] getUserProjects()
                          throws RedmineServiceException

Description copied from interface: RedmineLogguedService

Obtain for the loggued user, all projets where he belongs. Note: This method requires to be loggued on redmine server.

Specified by:

getUserProjects in interface RedmineLogguedService

Returns:

all the projects belonged by the loggued user

Throws:

RedmineServiceException - if any pb while retriving datas

See Also:

Project

addVersion

public Version addVersion(String projectName,
                          Version version)
                   throws RedmineServiceException

Description copied from interface: RedmineLogguedService

Add a version for a given project. Note: This method requires to be loggued on redmine server.

Specified by:

addVersion in interface RedmineLogguedService

Parameters:

projectName - the name of the project

version - the version to add

Returns:

the added version

Throws:

RedmineServiceException - if any pb while sending and retriving datas to redmine server

See Also:

Version

updateVersion

public Version updateVersion(String projectName,
                             Version version)
                      throws RedmineServiceException

Description copied from interface: RedmineLogguedService

Update a version for a given project. Note: This method requires to be loggued on redmine server.

Specified by:

updateVersion in interface RedmineLogguedService

Parameters:

projectName - the name of the project

version - the version to update

Returns:

the updated version

Throws:

RedmineServiceException - if any pb while sending and retriving datas to redmine server

See Also:

Version

nextVersion

public Version nextVersion(String projectName,
                           String oldVersionName,
                           Version version)
                    throws RedmineServiceException

Description copied from interface: RedmineLogguedService

Prepare a new version (create it or update it). If the oldVersionName is given, then all issues unclosed from this old version will be move to the new version. Note: This method requires to be loggued on redmine server.

Specified by:

nextVersion in interface RedmineLogguedService

Parameters:

projectName - the name of the project

oldVersionName - the name of the old version (optional)

version - the newVersion to create or update

Returns:

the created version

Throws:

RedmineServiceException - if any pb while sending and retriving datas to redmine server

See Also:

Version

addAttachment

public Attachment addAttachment(String projectName,
                                String versionName,
                                Attachment attachment)
                         throws RedmineServiceException

Description copied from interface: RedmineLogguedService

Add a attachment for a given version of a given project. Note: This method requires to be loggued on redmine server.

Specified by:

addAttachment in interface RedmineLogguedService

Parameters:

projectName - the name of the project

versionName - the name of the version

attachment - the attachment to add

Returns:

the added attachment

Throws:

RedmineServiceException - if any pb while sending and retriving datas to redmine server

See Also:

Attachment

addNews

public News addNews(String projectName,
                    News news)
             throws RedmineServiceException

Description copied from interface: RedmineLogguedService

Add a news for a given project. Note: This method requires to be loggued on redmine server.

Specified by:

addNews in interface RedmineLogguedService

Parameters:

projectName - the name of the project

news - the news to add

Returns:

the added news.

Throws:

RedmineServiceException - if any pb while sending and retriving datas to redmine server

See Also:

News

addIssueTimeEntry

public TimeEntry addIssueTimeEntry(String projectName,
                                   String issueId,
                                   TimeEntry timeEntry)
                            throws RedmineServiceException

Description copied from interface: RedmineLogguedService

Add a new time entry to the given issue for the given project and return the updated time entry. Note: This method requires to be loggued on redmine server.

Specified by:

addIssueTimeEntry in interface RedmineLogguedService

Parameters:

projectName - the name of the project

issueId - the id of the issue to update

timeEntry - time entry to add

Returns:

the created time entry

Throws:

RedmineServiceException - if any pb while sending or retrieving datas to redmine server

See Also:

Issue, TimeEntry

getVersionStatus

protected String getVersionStatus(Version version)

getVersionEffectiveDate

protected String getVersionEffectiveDate(Version version)