net.bluemind.addressbook.service.internal

Class AddressBookService

java.lang.Object

net.bluemind.addressbook.service.internal.AddressBookService

All Implemented Interfaces:

IAddressBook, IInCoreAddressBook, IChangelogSupport, ICountingSupport, ICrudByIdSupport<VCard>, IDataShardSupport, IReadByIdSupport<VCard>, IRestoreCrudSupport<VCard>, IRestoreSupport<VCard>, ISortingSupport

public class AddressBookService
extends java.lang.Object
implements IInCoreAddressBook

Constructor Summary

Constructors

Constructor and Description
AddressBookService(javax.sql.DataSource dataSource, org.elasticsearch.client.Client esearchClient, Container container, BmContext context)

Method Summary

Modifier and Type	Method and Description
java.util.List<ItemValue<VCard>>	all()
java.util.List<java.lang.String>	allUids() List all items from container
ContainerChangeset<java.lang.String>	changeset(java.lang.Long since)
ContainerChangeset<java.lang.Long>	changesetById(java.lang.Long since)
ContainerChangelog	containerChangelog(java.lang.Long since)
void	copy(java.util.List<java.lang.String> uids, java.lang.String descContainerUid) Copy entries from one AddressBook to another one
Count	count(ItemFlagFilter filter) Count items matching an ItemFlagFilter
void	create(java.lang.String uid, VCard card) Creates a new VCard entry.
Ack	createById(long id, VCard card)
void	delete(java.lang.String uid) Delete vcard entry
void	deleteById(long id)
void	deletePhoto(java.lang.String uid)
void	emitNotification()
ContainerChangeset<ItemVersion>	filteredChangesetById(java.lang.Long since, ItemFlagFilter filter)
java.util.List<java.lang.String>	findByEmail(java.lang.String email)
VCard	get(java.lang.String uid)
ItemValue<VCard>	getComplete(java.lang.String uid) Fetch a VCard from its unique uid
ItemValue<VCard>	getCompleteById(long uid)
byte[]	getIcon(java.lang.String uid) A scaled-down (22px x 22px) version of the photo
ItemValue<VCardInfo>	getInfo(java.lang.String uid) Fetch a VCardInfo from its unique uid
byte[]	getPhoto(java.lang.String uid)
long	getVersion()
ItemChangelog	itemChangelog(java.lang.String itemUid, java.lang.Long since)
void	move(java.util.List<java.lang.String> uids, java.lang.String descContainerUid) Move entries from one AddressBook to another one
void	multipleDeleteById(java.util.List<java.lang.Long> ids)
java.util.List<ItemValue<VCard>>	multipleGet(java.util.List<java.lang.String> uids) Fetch multiple VCards from theirs uniques uids
java.util.List<ItemValue<VCard>>	multipleGetById(java.util.List<java.lang.Long> ids) Fetch multiple VCards from theirs uniques ids
void	reset()
void	restore(ItemValue<VCard> cardItem, boolean isCreate)
ListResult<ItemValue<VCardInfo>>	search(VCardQuery query) ElasticSearch based vcard search
void	setPhoto(java.lang.String uid, byte[] photo)
java.util.List<java.lang.Long>	sortedIds(SortDescriptor sorted) Returns all items in a container matching a sort criteria
ContainerChangeset<java.lang.String>	sync(java.lang.Long since, VCardChanges changes) CLIENT_WIN style
void	touch(java.lang.String uid) Touch a VCard.
void	update(java.lang.String uid, VCard card) Modifies an existing VCard entry.
Ack	updateById(long id, VCard card)
ContainerUpdatesResult	updates(VCardChanges changes) Updates multiples entries at once (should be transactional: if one operation fail, nothing is written)
void	xfer(java.lang.String serverUid)

Methods inherited from class java.lang.Object

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

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

allIds

Constructor Detail

AddressBookService

public AddressBookService(javax.sql.DataSource dataSource,
                          org.elasticsearch.client.Client esearchClient,
                          Container container,
                          BmContext context)

Method Detail

allUids

public java.util.List<java.lang.String> allUids()

Description copied from interface: IAddressBook

List all items from container

Specified by:

allUids in interface IAddressBook

Returns:

create

public void create(java.lang.String uid,
                   VCard card)

Description copied from interface: IAddressBook

Creates a new VCard entry.

Specified by:

create in interface IAddressBook

Parameters:

uid - uid of the entry

card - value of the entry

createById

public Ack createById(long id,
                      VCard card)

Specified by:

createById in interface IAddressBook

Specified by:

createById in interface ICrudByIdSupport<VCard>

update

public void update(java.lang.String uid,
                   VCard card)

Description copied from interface: IAddressBook

Modifies an existing VCard entry.

Specified by:

update in interface IAddressBook

Parameters:

uid - uid of the entry

card - value of the entry

updateById

public Ack updateById(long id,
                      VCard card)

Specified by:

updateById in interface IAddressBook

Specified by:

updateById in interface ICrudByIdSupport<VCard>

getComplete

public ItemValue<VCard> getComplete(java.lang.String uid)

Description copied from interface: IAddressBook

Fetch a VCard from its unique uid

Specified by:

getComplete in interface IAddressBook

Returns:

ItemValue

getCompleteById

public ItemValue<VCard> getCompleteById(long uid)

Specified by:

getCompleteById in interface IAddressBook

Specified by:

getCompleteById in interface IReadByIdSupport<VCard>

multipleGet

public java.util.List<ItemValue<VCard>> multipleGet(java.util.List<java.lang.String> uids)

Description copied from interface: IAddressBook

Fetch multiple VCards from theirs uniques uids

Specified by:

multipleGet in interface IAddressBook

Returns:

List>

multipleGetById

public java.util.List<ItemValue<VCard>> multipleGetById(java.util.List<java.lang.Long> ids)

Description copied from interface: IAddressBook

Fetch multiple VCards from theirs uniques ids

Specified by:

multipleGetById in interface IAddressBook

Specified by:

multipleGetById in interface IReadByIdSupport<VCard>

Returns:

List>

getInfo

public ItemValue<VCardInfo> getInfo(java.lang.String uid)

Description copied from interface: IAddressBook

Fetch a VCardInfo from its unique uid

Specified by:

getInfo in interface IAddressBook

Returns:

search

public ListResult<ItemValue<VCardInfo>> search(VCardQuery query)

Description copied from interface: IAddressBook

ElasticSearch based vcard search

Specified by:

search in interface IAddressBook

Returns:

delete

public void delete(java.lang.String uid)

Description copied from interface: IAddressBook

Delete vcard entry

Specified by:

delete in interface IAddressBook

Specified by:

delete in interface IRestoreCrudSupport<VCard>

containerChangelog

public ContainerChangelog containerChangelog(java.lang.Long since)

Specified by:

containerChangelog in interface IChangelogSupport

Returns:

if successful, return a ContainerChangelog

itemChangelog

public ItemChangelog itemChangelog(java.lang.String itemUid,
                                   java.lang.Long since)

Specified by:

itemChangelog in interface IChangelogSupport

Returns:

if successful, return a ContainerChangelog

changeset

public ContainerChangeset<java.lang.String> changeset(java.lang.Long since)

Specified by:

changeset in interface IChangelogSupport

Returns:

if successful, return a ContainerChangeset

changesetById

public ContainerChangeset<java.lang.Long> changesetById(java.lang.Long since)

Specified by:

changesetById in interface IChangelogSupport

Returns:

if successful, return a ContainerChangeset with internal numeric ids

filteredChangesetById

public ContainerChangeset<ItemVersion> filteredChangesetById(java.lang.Long since,
                                                             ItemFlagFilter filter)

Specified by:

filteredChangesetById in interface IChangelogSupport

filter - to exclude some items (eg. deleted items)

Returns:

if successful, return a ContainerChangeset with internal numeric ids matching the given filter

updates

public ContainerUpdatesResult updates(VCardChanges changes)

Description copied from interface: IAddressBook

Updates multiples entries at once (should be transactional: if one operation fail, nothing is written)

Specified by:

updates in interface IAddressBook

sync

public ContainerChangeset<java.lang.String> sync(java.lang.Long since,
                                                 VCardChanges changes)

Description copied from interface: IAddressBook

CLIENT_WIN style

Specified by:

sync in interface IAddressBook

Returns:

copy

public void copy(java.util.List<java.lang.String> uids,
                 java.lang.String descContainerUid)

Description copied from interface: IAddressBook

Copy entries from one AddressBook to another one

Specified by:

copy in interface IAddressBook

move

public void move(java.util.List<java.lang.String> uids,
                 java.lang.String descContainerUid)

Description copied from interface: IAddressBook

Move entries from one AddressBook to another one

Specified by:

move in interface IAddressBook

all

public java.util.List<ItemValue<VCard>> all()

setPhoto

public void setPhoto(java.lang.String uid,
                     byte[] photo)

Specified by:

setPhoto in interface IAddressBook

deletePhoto

public void deletePhoto(java.lang.String uid)

Specified by:

deletePhoto in interface IAddressBook

getPhoto

public byte[] getPhoto(java.lang.String uid)

Specified by:

getPhoto in interface IAddressBook

getIcon

public byte[] getIcon(java.lang.String uid)

Description copied from interface: IAddressBook

A scaled-down (22px x 22px) version of the photo

Specified by:

getIcon in interface IAddressBook

Returns:

findByEmail

public java.util.List<java.lang.String> findByEmail(java.lang.String email)

Specified by:

findByEmail in interface IInCoreAddressBook

reset

public void reset()

Specified by:

reset in interface IAddressBook

getVersion

public long getVersion()

Specified by:

getVersion in interface IChangelogSupport

deleteById

public void deleteById(long id)

Specified by:

deleteById in interface IAddressBook

Specified by:

deleteById in interface ICrudByIdSupport<VCard>

count

public Count count(ItemFlagFilter filter)

Description copied from interface: ICountingSupport

Count items matching an ItemFlagFilter

Specified by:

count in interface ICountingSupport

Returns:

the count of items matching the filter

sortedIds

public java.util.List<java.lang.Long> sortedIds(SortDescriptor sorted)

Description copied from interface: ISortingSupport

Returns all items in a container matching a sort criteria

Specified by:

sortedIds in interface IAddressBook

Specified by:

sortedIds in interface ISortingSupport

Parameters:

sorted - sorting criteria

Returns:

a list of ItemValue.internalId sorted

xfer

public void xfer(java.lang.String serverUid)

Specified by:

xfer in interface IDataShardSupport

multipleDeleteById

public void multipleDeleteById(java.util.List<java.lang.Long> ids)

Specified by:

multipleDeleteById in interface ICrudByIdSupport<VCard>

emitNotification

public void emitNotification()

get

public VCard get(java.lang.String uid)

Specified by:

get in interface IRestoreSupport<VCard>

restore

public void restore(ItemValue<VCard> cardItem,
                    boolean isCreate)

Specified by:

restore in interface IRestoreSupport<VCard>

touch

public void touch(java.lang.String uid)

Description copied from interface: IAddressBook

Touch a VCard.

Specified by:

touch in interface IAddressBook

Parameters:

uid - the unique identifier of the vcard