org.xwiki.livedata

Interface LiveDataEntryStore

@Role
 @Unstable
public interface LiveDataEntryStore

The interface used to store and retrieve live data entries.

Since:

12.10

Version:

$Id: ae9784bafd03add4791db624c79dbe9cf2cf7c63 $

Method Summary

Modifier and Type	Method and Description
LiveData	get(LiveDataQuery query) Executes a query on the live data.
Optional<Map<String,Object>>	get(Object entryId)
default Optional<Object>	get(Object entryId, String property)
default Optional<Map<String,Object>>	remove(Object entryId) Removes an existing entry.
default Optional<Object>	save(Map<String,Object> entry) Creates a new entry or updates an existing one.
default Optional<Object>	update(Object entryId, String property, Object value) Updates a property of a live data entry.

Method Detail

get

Optional<Map<String,Object>> get(Object entryId)
                          throws LiveDataException

Parameters:

entryId - identifies the entry to return

Returns:

the specified entry

Throws:

LiveDataException - if retrieving the specified entry fails

get

default Optional<Object> get(Object entryId,
                             String property)
                      throws LiveDataException

Parameters:

entryId - identifies the entry whose property value to return

property - the property whose value to return

Returns:

the value of the specified property from the specified live data entry

Throws:

LiveDataException - if retrieving the specified property fails

get

LiveData get(LiveDataQuery query)
      throws LiveDataException

Executes a query on the live data.

Parameters:

query - the query used to filter and sort the live data entries

Returns:

the live data entries that match the given query

Throws:

LiveDataException - if the live data query execution fails

save

default Optional<Object> save(Map<String,Object> entry)
                       throws LiveDataException

Creates a new entry or updates an existing one.

Parameters:

entry - the entry to save

Returns:

the identifier of the saved entry

Throws:

LiveDataException - if saving the given entry fails

Since:

12.10.4, 13.0

update

default Optional<Object> update(Object entryId,
                                String property,
                                Object value)
                         throws LiveDataException

Updates a property of a live data entry.

Parameters:

entryId - the entry to update

property - the property to update

value - the new property value

Returns:

the previous property value

Throws:

LiveDataException - if updating the specified property fails

remove

default Optional<Map<String,Object>> remove(Object entryId)
                                     throws LiveDataException

Removes an existing entry.

Parameters:

entryId - identifies the entry to remove

Returns:

true if the entry was removed, false otherwise

Throws:

LiveDataException - if removing the specified entry fails