Package net.bluemind.calendar.api

Interface ICalendar

All Superinterfaces:

IChangelogSupport, ICountingSupport, ICrudByIdSupport<VEventSeries>, IItemChangelogSupport, IReadByIdSupport<VEventSeries>, IRestoreCrudSupport<VEventSeries>, IRestoreItemCrudSupport<VEventSeries>, IRestoreSupport<VEventSeries>, ISortingSupport

All Known Subinterfaces:

IInternalCalendar

@Path("/calendars/{containerUid}")
public interface ICalendar
extends IChangelogSupport, IItemChangelogSupport, ICrudByIdSupport<VEventSeries>, ICountingSupport, ISortingSupport, IRestoreItemCrudSupport<VEventSeries>

Calendar operations.

Method Summary

Modifier and Type	Method	Description
List<String>	all()	Returns all the items uid from the container.
void	create(String uid, VEventSeries event, Boolean sendNotifications)	Creates a VEvent.
void	delete(String uid, Boolean sendNotifications)	Deletes the VEventSeries identified by the given unique identifier.
List<ItemValue<VEventSeries>>	getByIcsUid(String uid)	Returns all VEventSeries matching the given ICS unique identifier.
ItemValue<VEventSeries>	getComplete(String uid)	Returns the VEventSeries identified by the given unique identifier.
boolean	isAutoSyncActivated()	Check the automatic synchronization is activated for this calendar.
ListResult<ItemValue<VEventSeries>>	list()	List all the events of this calendar.
List<ItemValue<VEventSeries>>	multipleGet(List<String> uids)	Fetch multiple VEventSeries identified by the given unique identifiers.
TaskRef	reset()	Remove all events from this calendar.
ListResult<ItemValue<VEventSeries>>	search(VEventQuery query)	Search for events matching the given query.
ListResult<ItemValue<VEventSeries>>	searchPendingCounters()	Search pending counters of the current user
ContainerChangeset<String>	sync(Long since, VEventChanges changes)	Apply the given changes and return the differences since the given time.
void	touch(String uid)	Touch a VEvent.
void	update(String uid, VEventSeries event, Boolean sendNotifications)	Updates a VEventSeries.
ContainerUpdatesResult	updates(VEventChanges changes)	Applies changes (create, update, delete) to a calendar specified by its containerUid.

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

changeset, changesetById, filteredChangesetById, getVersion

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

count

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

createById, deleteById, multipleDeleteById, multipleDeleteById, updateById

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

itemChangelog

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

getCompleteById, multipleGetById

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

delete

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

create

@PUT
@Path("{uid}")
void create(@PathParam("uid")
 String uid,
 VEventSeries event,
 @QueryParam("sendNotifications")
 Boolean sendNotifications)
     throws ServerFault

Creates a VEvent.

Parameters:

uid - the unique identifier for the new event

event - the VEventSeries to store

sendNotifications - if true then notify this event creation on the events bus

Throws:

ServerFault

update

@POST
@Path("{uid}")
void update(@PathParam("uid")
 String uid,
 VEventSeries event,
 @QueryParam("sendNotifications")
 Boolean sendNotifications)
     throws ServerFault

Updates a VEventSeries.

Parameters:

uid - the unique identifier of the event

event - the VEventSeries to update

sendNotifications - if true then notify this event creation on the events bus

Throws:

ServerFault

getComplete

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

Returns the VEventSeries identified by the given unique identifier.

Specified by:

getComplete in interface IRestoreItemCrudSupport<VEventSeries>

Parameters:

uid - the unique identifier of the event

Returns:

a VEventSeries if successful

Throws:

ServerFault

getByIcsUid

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

Returns all VEventSeries matching the given ICS unique identifier.

Parameters:

uid - the ICS unique identifier

Returns:

the list of matching VEventSeries

Throws:

ServerFault

multipleGet

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

Fetch multiple VEventSeries identified by the given unique identifiers.

Parameters:

uids - the list of unique identifiers

Returns:

all matching VEventSeries

Throws:

ServerFault

delete

@DELETE
@Path("{uid}")
void delete(@PathParam("uid")
 String uid,
 @QueryParam("sendNotifications")
 Boolean sendNotifications)
     throws ServerFault

Deletes the VEventSeries identified by the given unique identifier.

Parameters:

uid - the unique identifier of the event

sendNotifications - if true then notify this event deletion on the events bus

Throws:

ServerFault

touch

@POST
@Path("{uid}/_touch")
void touch(@PathParam("uid")
 String uid)
    throws ServerFault

Touch a VEvent.

Parameters:

uid - the unique identifier of the event

Throws:

ServerFault

updates

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

Applies changes (create, update, delete) to a calendar specified by its containerUid.

Parameters:

changes - the changes to apply

Throws:

ServerFault

search

@POST
@Path("_search")
ListResult<ItemValue<VEventSeries>> search(VEventQuery query)
                                    throws ServerFault

Search for events matching the given query.

Parameters:

query - the VEventQuery to match against

Returns:

the matching VEventSeries

Throws:

ServerFault

sync

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

Apply the given changes and return the differences since the given time. CLIENT_WIN style.

Parameters:

since - the time from wich compare changes

changes - the changes to apply

Returns:

the ContainerChangeset of the difSortDescriptorferences

Throws:

ServerFault

list

@GET
@Path("_list")
ListResult<ItemValue<VEventSeries>> list()
                                  throws ServerFault

List all the events of this calendar.

Returns:

all the VEventSeries

Throws:

ServerFault

reset

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

Remove all events from this calendar.

Returns:

the reference to this asynchronous operation

Throws:

ServerFault

all

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

Returns all the items uid from the container.

Returns:

all the items uid from the container.

Throws:

ServerFault

isAutoSyncActivated

@GET
@Path("_isAutoSyncActivated")
boolean isAutoSyncActivated()
                     throws ServerFault

Check the automatic synchronization is activated for this calendar.

Returns:

true if this calendar is automatically synchronized, false otherwise

Throws:

ServerFault

searchPendingCounters

@GET
@Path("_search_counters")
ListResult<ItemValue<VEventSeries>> searchPendingCounters()

Search pending counters of the current user

Returns: