net.joelinn.asana.tasks

Class TasksClient

java.lang.Object

net.joelinn.asana.AbstractClient

net.joelinn.asana.tasks.TasksClient

public class TasksClient
extends AbstractClient

Joe Linn 11/17/13

See Also:

http://developer.asana.com/documentation/#tasks

Field Summary

Fields inherited from class net.joelinn.asana.AbstractClient

apiKey, BASE_URL, service

Constructor Summary

Constructors

Constructor and Description
TasksClient(String apiKey)
TasksClient(String apiKey, int connectionTimeout, int readTimeout)

Method Summary

Modifier and Type	Method and Description
void	addProject(long taskId, long projectId) Associate the given task with the given project.
void	addProject(long taskId, long projectId, long insertId, boolean insertBefore) Associate the given task with the given project
void	addTag(long taskId, long tagId) Add a tag to a task
Story	createStory(long taskId, String text) Add a story (comment) to a task
Task	createTask(TaskRequestBuilder builder)
void	deleteTask(long taskId)
Projects	getProjects(long taskId) Retrieve the projects with which this task is associated
Stories	getStories(long taskId) Retrieve stories (comments) associated with the given task
Tasks	getSubtasks(long taskId) Retrieve all subtasks associated with the given parent task
Tags	getTags(long taskId) Retrieve all tags associated with the given task
Task	getTask(long taskId)
Tasks	getTasks()
Tasks	getTasks(boolean includeArchived)
void	removeProject(long taskId, long projectId) Remove an association between the given task and project
void	removeTag(long taskId, long tagId) Remove a tag from a task
Task	updateTask(long taskId, TaskRequestBuilder builder)

Methods inherited from class net.joelinn.asana.AbstractClient

delete, get, get, post, put, request, request, request

Methods inherited from class java.lang.Object

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

Constructor Detail

TasksClient

public TasksClient(String apiKey)

TasksClient

public TasksClient(String apiKey,
                   int connectionTimeout,
                   int readTimeout)

Parameters:

apiKey - your Asana API key

connectionTimeout - the connection timeout in MILLISECONDS

readTimeout - the read timeout in MILLISECONDS

Method Detail

createTask

public Task createTask(TaskRequestBuilder builder)

updateTask

public Task updateTask(long taskId,
                       TaskRequestBuilder builder)

deleteTask

public void deleteTask(long taskId)

getTask

public Task getTask(long taskId)

getTasks

public Tasks getTasks()

getTasks

public Tasks getTasks(boolean includeArchived)

getSubtasks

public Tasks getSubtasks(long taskId)

Retrieve all subtasks associated with the given parent task

Parameters:

taskId - id of the parent task for which to retrieve subtasks

Returns:

a list of subtasks

getStories

public Stories getStories(long taskId)

Retrieve stories (comments) associated with the given task

Parameters:

taskId - the id of the task for which to retrieve stories

Returns:

a list of Story objects

createStory

public Story createStory(long taskId,
                         String text)

Add a story (comment) to a task

Parameters:

taskId - the id with which to associate the new story

text - the text content of the story

Returns:

a Story object

getProjects

public Projects getProjects(long taskId)

Retrieve the projects with which this task is associated

Parameters:

taskId - the id of the task for which to retrieve associated projects

Returns:

a list of projects

addProject

public void addProject(long taskId,
                       long projectId,
                       long insertId,
                       boolean insertBefore)

Associate the given task with the given project

Parameters:

taskId - the id of the task

projectId - the id of the project

insertId - the id of the project next to which to insert the project to be added. null for beginning / end of the list

insertBefore - true to insert before insertId or at the end of the list if insertId is null; false to insert after insertId or at the beginning of the list if insertId is null

addProject

public void addProject(long taskId,
                       long projectId)

Associate the given task with the given project. The newly associated project will be added at the end of the task's list of projects.

Parameters:

taskId - the id of the task

projectId - the id of the project

removeProject

public void removeProject(long taskId,
                          long projectId)

Remove an association between the given task and project

Parameters:

taskId - the id of the task

projectId - the id of the project

getTags

public Tags getTags(long taskId)

Retrieve all tags associated with the given task

Parameters:

taskId - the id of the task

Returns:

a list of tags

addTag

public void addTag(long taskId,
                   long tagId)

Add a tag to a task

Parameters:

taskId - the id of the task

tagId - the id of the tag

removeTag

public void removeTag(long taskId,
                      long tagId)

Remove a tag from a task

Parameters:

taskId - the id of the task

tagId - the id of the tag