Package net.bluemind.todolist.api

Interface ITodoList

All Superinterfaces:

IChangelogSupport, ICountingSupport, ICrudByIdSupport<VTodo>, IReadByIdSupport<VTodo>, IRestoreCrudSupport<VTodo>, IRestoreItemCrudSupport<VTodo>, IRestoreSupport<VTodo>, ISortingSupport

@Path("/todolist/{containerUid}")
public interface ITodoList
extends IChangelogSupport, ICountingSupport, ICrudByIdSupport<VTodo>, ISortingSupport, IRestoreItemCrudSupport<VTodo>

Todolist API. All methods work on Todos in a specific container identified by a unique UID, see ITodoUids. Use IContainers.all(net.bluemind.core.container.api.ContainerQuery) to lookup all containers of specific type.

Method Summary

Modifier and Type	Method	Description
List<ItemValue<VTodo>>	all()	List all Tasks of a Todolist container
List<String>	allUids()	Retrieve all VTodo UIDs of this Todolist
void	copy(List<String> uids, String descContainerUid)	Copy VTodos to another Todolist
void	create(String uid, VTodo todo)	Creates a new VTodo entry.
void	delete(String uid)	Delete a VTodo
List<ItemValue<VTodo>>	getByIcsUid(String uid)	Returns all VTodo matching the given ICS unique identifier.
ItemValue<VTodo>	getComplete(String uid)	Fetch a VTodo by its unique UID
void	move(List<String> uids, String descContainerUid)	Move VTodos to another Todolist
List<ItemValue<VTodo>>	multipleGet(List<String> uids)	Fetch multiple VTodos by their unique UIDs
void	reset()	Delete all VTodos of this Todolist
ListResult<ItemValue<VTodo>>	search(VTodoQuery query)	Search VTodo's by VTodoQuery
ContainerChangeset<String>	sync(Long since, VTodoChanges changes)	Client/Server synchronization of VTodos.
void	update(String uid, VTodo todo)	Modifies an existing VTodo.
ContainerUpdatesResult	updates(VTodoChanges changes)	Updates multiple VTodos.

Methods inherited from interface net.bluemind.core.container.api.IChangelogSupport

allIds, changeset, changesetById, filteredChangesetById, getVersion, itemChangelog

Methods inherited from interface net.bluemind.core.container.api.ICountingSupport

count

Methods inherited from interface net.bluemind.core.container.api.ICrudByIdSupport

createById, deleteById, multipleDeleteById, updateById

Methods inherited from interface net.bluemind.core.container.api.IReadByIdSupport

getCompleteById, multipleGetById

Methods inherited from interface net.bluemind.core.container.api.IRestoreSupport

get, itemValueExists, restore

Methods inherited from interface net.bluemind.core.container.api.ISortingSupport

sortedIds

Method Details

all

@GET
List<ItemValue<VTodo>> all()
                    throws ServerFault

List all Tasks of a Todolist container

Returns:

All VTodo of the container

Throws:

ServerFault - common error object

create

@PUT
@Path("{uid}")
void create(@PathParam("uid")
 String uid,
 VTodo todo)
     throws ServerFault

Creates a new VTodo entry.

Parameters:

uid - Unique entry UID

todo - VTodo values

Throws:

ServerFault - common error object

update

@POST
@Path("{uid}")
void update(@PathParam("uid")
 String uid,
 VTodo todo)
     throws ServerFault

Modifies an existing VTodo.

Parameters:

uid - Unique entry UID

todo - VTodo values

Throws:

ServerFault - common error object

getComplete

@GET
@Path("{uid}/complete")
ItemValue<VTodo> getComplete(@PathParam("uid")
 String uid)
                      throws ServerFault

Fetch a VTodo by its unique UID

Specified by:

getComplete in interface IRestoreItemCrudSupport<VTodo>

Parameters:

uid - Unique entry UID

Returns:

ItemValue containing a VTodo

Throws:

ServerFault - common error object

multipleGet

@POST
@Path("_mget")
List<ItemValue<VTodo>> multipleGet(List<String> uids)
                            throws ServerFault

Fetch multiple VTodos by their unique UIDs

Parameters:

uids - list of unique UIDs

Returns:

list of ItemValues containing VTodos

Throws:

ServerFault - common error object

delete

@DELETE
@Path("{uid}")
void delete(@PathParam("uid")
 String uid)
     throws ServerFault

Delete a VTodo

Specified by:

delete in interface IRestoreCrudSupport<VTodo>

Parameters:

uid - unique UID

Throws:

ServerFault - common error object

search

@POST
@Path("_search")
ListResult<ItemValue<VTodo>> search(VTodoQuery query)
                             throws ServerFault

Search VTodo's by VTodoQuery

Parameters:

query - VTodoQuery

Returns:

ListResult of the matching ItemValues containing a VTodo

Throws:

ServerFault - common error object

updates

@PUT
@Path("_mupdates")
ContainerUpdatesResult updates(VTodoChanges changes)
                        throws ServerFault

Updates multiple VTodos.

Parameters:

changes - VTodoChanges containing the requested updates

Returns:

ContainerUpdatesResult

Throws:

ServerFault - common error object

sync

@POST
@Path("_sync")
ContainerChangeset<String> sync(@QueryParam("since")
 Long since,
 VTodoChanges changes)
                         throws ServerFault

Client/Server synchronization of VTodos. Applies client changes and returns server updates happened since since parameter.

Parameters:

since - timestamp of the requested server updates

changes - client updates

Returns:

ContainerChangeset containing the server updates

Throws:

ServerFault - common error object

copy

@POST
@Path("_copy/{destContainerUid}")
void copy(List<String> uids,
 @PathParam("destContainerUid")
 String descContainerUid)
   throws ServerFault

Copy VTodos to another Todolist

Parameters:

uids - list of unique UIDs

descContainerUid - the destination Todolist container UID

Throws:

ServerFault - common error object

move

@POST
@Path("_move/{destContainerUid}")
void move(List<String> uids,
 @PathParam("destContainerUid")
 String descContainerUid)
   throws ServerFault

Move VTodos to another Todolist

Parameters:

uids - list of unique UIDs

descContainerUid - the destination Todolist container UID

Throws:

ServerFault - common error object

reset

@POST
@Path("_reset")
void reset()
    throws ServerFault

Delete all VTodos of this Todolist

Throws:

ServerFault - common error object

allUids

@GET
@Path("_all")
List<String> allUids()
              throws ServerFault

Retrieve all VTodo UIDs of this Todolist

Returns:

List of UIDs

Throws:

ServerFault - common error object

getByIcsUid

@GET
@Path("_icsuid/{uid}")
List<ItemValue<VTodo>> getByIcsUid(@PathParam("uid")
 String uid)
                            throws ServerFault

Returns all VTodo matching the given ICS unique identifier.

Parameters:

uid - the ICS unique identifier

Returns:

the list of matching VTodo

Throws:

ServerFault