org.nuiton.jredmine
Interface RedmineLogguedService

All Known Subinterfaces:

RedmineService

All Known Implementing Classes:

DefaultRedmineService

public interface RedmineLogguedService

Contract of all redmine operations that needs a login to be performed.

A default implementation is offered in DefaultRedmineService.

Created: 2 janv. 2010

Since:

1.0.3

Version:

$Revision: 66 $

Mise a jour: $Date: 2010-01-03 11:49:37 +0100 (dim., 03 janv. 2010) $ par : $Author: tchemit $

Author:

Tony Chemit Copyright Code Lutin

See Also:

RedmineAnonymousService, RedmineService

Method Summary

Attachment	addAttachment(java.lang.String projectName, java.lang.String versionName, Attachment attachement) Add a attachment for a given version of a given project.
TimeEntry	addIssueTimeEntry(java.lang.String projectName, java.lang.String issueId, TimeEntry entry) Add a new time entry to the given issue for the given project and return the updated time entry.
News	addNews(java.lang.String projectName, News news) Add a news for a given project.
Version	addVersion(java.lang.String projectName, Version version) Add a version for a given project.
Project[]	getUserProjects() Obtain for the loggued user, all projets where he belongs.
Version	nextVersion(java.lang.String projectName, java.lang.String oldVersionName, Version newVersion) Prepare a new version (create it or update it).
Version	updateVersion(java.lang.String projectName, Version version) Update a version for a given project.

Method Detail

getUserProjects

Project[] getUserProjects()
                          throws RedmineServiceException

Obtain for the loggued user, all projets where he belongs.

Note: This method requires to be loggued on redmine server.

Returns:

all the projects belonged by the loggued user

Throws:

RedmineServiceException - if any pb while retriving datas

Since:

1.0.3

See Also:

Project

addVersion

Version addVersion(java.lang.String projectName,
                   Version version)
                   throws RedmineServiceException

Add a version for a given project.

b>Note: This method requires to be loggued on redmine server.

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

Version updateVersion(java.lang.String projectName,
                      Version version)
                      throws RedmineServiceException

Update a version for a given project.

b>Note: This method requires to be loggued on redmine server.

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

Version nextVersion(java.lang.String projectName,
                    java.lang.String oldVersionName,
                    Version newVersion)
                    throws RedmineServiceException

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.

b>Note: This method requires to be loggued on redmine server.

Parameters:

projectName - the name of the project

oldVersionName - the name of the old version (optional)

newVersion - 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

addNews

News addNews(java.lang.String projectName,
             News news)
             throws RedmineServiceException

Add a news for a given project.

b>Note: This method requires to be loggued on redmine server.

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

addAttachment

Attachment addAttachment(java.lang.String projectName,
                         java.lang.String versionName,
                         Attachment attachement)
                         throws RedmineServiceException

Add a attachment for a given version of a given project.

b>Note: This method requires to be loggued on redmine server.

Parameters:

projectName - the name of the project

versionName - the name of the version

attachement - the attachment to add

Returns:

the added attachment

Throws:

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

See Also:

Attachment

addIssueTimeEntry

TimeEntry addIssueTimeEntry(java.lang.String projectName,
                            java.lang.String issueId,
                            TimeEntry entry)
                            throws RedmineServiceException

Add a new time entry to the given issue for the given project and return the updated time entry.

b>Note: This method requires to be loggued on redmine server.

Parameters:

projectName - the name of the project

issueId - the id of the issue to update

entry - time entry to add

Returns:

the created time entry

Throws:

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

Since:

1.0.3

See Also:

Issue, TimeEntry