com.taskadapter.redmineapi.internal

Class Transport

java.lang.Object

com.taskadapter.redmineapi.internal.Transport

public final class Transport
extends java.lang.Object

Constructor Summary

Constructors

Constructor and Description
Transport(URIConfigurator configurator, org.apache.http.client.HttpClient client)

Method Summary

Methods

Modifier and Type	Method and Description
<T> T	addChildEntry(java.lang.Class<?> parentClass, java.lang.String parentId, T object, org.apache.http.NameValuePair... params) Performs an "add child object" request.
<T> T	addObject(T object, org.apache.http.NameValuePair... params) Performs an "add object" request.
void	addUserToGroup(int userId, int groupId)
void	addWatcherToIssue(int watcherId, int issueId)
<T> void	deleteChildId(java.lang.Class<?> parentClass, java.lang.String parentId, T object, java.lang.Integer value) Performs an "delete child Id" request.
<T extends Identifiable> void	deleteObject(java.lang.Class<T> classs, java.lang.String id) Deletes an object.
<R> R	download(java.lang.String uri, ContentHandler<BasicHttpResponse,R> handler) Downloads a redmine content.
<T> java.util.List<T>	getChildEntries(java.lang.Class<?> parentClass, java.lang.String parentId, java.lang.Class<T> classs) Delivers a list of a child entries.
<T> T	getChildEntry(java.lang.Class<?> parentClass, java.lang.String parentId, java.lang.Class<T> classs, java.lang.String childId, org.apache.http.NameValuePair... params) Delivers a single child entry by its identifier.
User	getCurrentUser(org.apache.http.NameValuePair... params)
<T> T	getObject(java.lang.Class<T> classs, java.lang.Integer key, org.apache.http.NameValuePair... args)
<T> T	getObject(java.lang.Class<T> classs, java.lang.String key, org.apache.http.NameValuePair... args)
<T> java.util.List<T>	getObjectsList(java.lang.Class<T> objectClass, java.util.Collection<? extends org.apache.http.NameValuePair> params) Returns an object list.
<T> java.util.List<T>	getObjectsList(java.lang.Class<T> objectClass, org.apache.http.NameValuePair... params)
int	getObjectsPerPage() This number of objects (tasks, projects, users) will be requested from Redmine server in 1 request.
void	setCredentials(java.lang.String login, java.lang.String password)
void	setLogin(java.lang.String login)
void	setObjectsPerPage(int pageSize) This number of objects (tasks, projects, users) will be requested from Redmine server in 1 request.
void	setPassword(java.lang.String password)
<T extends Identifiable> void	updateObject(T obj, org.apache.http.NameValuePair... params)
java.lang.String	upload(java.io.InputStream content) UPloads content on a server.

Methods inherited from class java.lang.Object

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

Constructor Detail

Transport

public Transport(URIConfigurator configurator,
         org.apache.http.client.HttpClient client)

Method Detail

getCurrentUser

public User getCurrentUser(org.apache.http.NameValuePair... params)
                    throws RedmineException

Throws:

RedmineException

addObject

public <T> T addObject(T object,
              org.apache.http.NameValuePair... params)
            throws RedmineException

Performs an "add object" request.

Parameters:

object - object to use.

params - name params.

Returns:

object to use.

Throws:

RedmineException - if something goes wrong.

addChildEntry

public <T> T addChildEntry(java.lang.Class<?> parentClass,
                  java.lang.String parentId,
                  T object,
                  org.apache.http.NameValuePair... params)
                throws RedmineException

Performs an "add child object" request.

Parameters:

parentClass - parent object id.

object - object to use.

params - name params.

Returns:

object to use.

Throws:

RedmineException - if something goes wrong.

updateObject

public <T extends Identifiable> void updateObject(T obj,
                                         org.apache.http.NameValuePair... params)
                  throws RedmineException

Throws:

RedmineException

deleteChildId

public <T> void deleteChildId(java.lang.Class<?> parentClass,
                     java.lang.String parentId,
                     T object,
                     java.lang.Integer value)
                   throws RedmineException

Performs an "delete child Id" request.

Parameters:

parentClass - parent object id.

object - object to use.

value - child object id.

Throws:

RedmineException - if something goes wrong.

deleteObject

public <T extends Identifiable> void deleteObject(java.lang.Class<T> classs,
                                         java.lang.String id)
                  throws RedmineException

Deletes an object.

Parameters:

classs - object class.

id - object id.

Throws:

RedmineException - if something goes wrong.

getObject

public <T> T getObject(java.lang.Class<T> classs,
              java.lang.String key,
              org.apache.http.NameValuePair... args)
            throws RedmineException

Parameters:

classs - target class

key - item key

args - extra arguments.

Throws:

RedmineAuthenticationException - invalid or no API access key is used with the server, which requires authorization. Check the constructor arguments.

NotFoundException - the object with the given key is not found

RedmineException

download

public <R> R download(java.lang.String uri,
             ContentHandler<BasicHttpResponse,R> handler)
           throws RedmineException

Downloads a redmine content.

Parameters:

uri - target uri.

handler - content handler.

Returns:

handler result.

Throws:

RedmineException - if something goes wrong.

upload

public java.lang.String upload(java.io.InputStream content)
                        throws RedmineException

UPloads content on a server.

Parameters:

content - content stream.

Returns:

uploaded item token.

Throws:

RedmineException - if something goes wrong.

getObject

public <T> T getObject(java.lang.Class<T> classs,
              java.lang.Integer key,
              org.apache.http.NameValuePair... args)
            throws RedmineException

Parameters:

classs - target class

key - item key

args - extra arguments.

Throws:

RedmineAuthenticationException - invalid or no API access key is used with the server, which requires authorization. Check the constructor arguments.

NotFoundException - the object with the given key is not found

RedmineException

getObjectsList

public <T> java.util.List<T> getObjectsList(java.lang.Class<T> objectClass,
                                   org.apache.http.NameValuePair... params)
                                 throws RedmineException

Throws:

RedmineException

getObjectsList

public <T> java.util.List<T> getObjectsList(java.lang.Class<T> objectClass,
                                   java.util.Collection<? extends org.apache.http.NameValuePair> params)
                                 throws RedmineException

Returns an object list.

Returns:

objects list, never NULL

Throws:

RedmineException

getObjectsPerPage

public int getObjectsPerPage()

This number of objects (tasks, projects, users) will be requested from Redmine server in 1 request.

getChildEntries

public <T> java.util.List<T> getChildEntries(java.lang.Class<?> parentClass,
                                    java.lang.String parentId,
                                    java.lang.Class<T> classs)
                                  throws RedmineException

Delivers a list of a child entries.

Parameters:

classs - target class.

Throws:

RedmineException

getChildEntry

public <T> T getChildEntry(java.lang.Class<?> parentClass,
                  java.lang.String parentId,
                  java.lang.Class<T> classs,
                  java.lang.String childId,
                  org.apache.http.NameValuePair... params)
                throws RedmineException

Delivers a single child entry by its identifier.

Throws:

RedmineException

setObjectsPerPage

public void setObjectsPerPage(int pageSize)

This number of objects (tasks, projects, users) will be requested from Redmine server in 1 request.

addUserToGroup

public void addUserToGroup(int userId,
                  int groupId)
                    throws RedmineException

Throws:

RedmineException

addWatcherToIssue

public void addWatcherToIssue(int watcherId,
                     int issueId)
                       throws RedmineException

Throws:

RedmineException

setCredentials

public void setCredentials(java.lang.String login,
                  java.lang.String password)

setPassword

public void setPassword(java.lang.String password)

setLogin

public void setLogin(java.lang.String login)