net.bluemind.addressbook.service.internal

Class AddressBookService

java.lang.Object

net.bluemind.addressbook.service.internal.AddressBookService

All Implemented Interfaces:

IAddressBook, IInCoreAddressBook, IChangelogSupport

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
void	create(java.lang.String uid, VCard card) Creates a new VCard entry.
void	createById(long id, VCard card)
void	delete(java.lang.String uid) Delete vcard entry
void	deletePhoto(java.lang.String uid)
java.util.List<java.lang.String>	findByEmail(java.lang.String email)
ItemValue<VCard>	getComplete(java.lang.String uid) Fetch a VCard from its unique 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
java.util.List<ItemValue<VCard>>	multipleGet(java.util.List<java.lang.String> uids) Fetch multiple VCards from theirs uniques uids
void	reset()
ListResult<ItemValue<VCardInfo>>	search(VCardQuery query) ElasticSearch based vcard search
void	setPhoto(java.lang.String uid, byte[] photo)
ContainerChangeset<java.lang.String>	sync(java.lang.Long since, VCardChanges changes) CLIENT_WIN style
void	update(java.lang.String uid, VCard card) Modifies an existing VCard entry.
ContainerUpdatesResult	updates(VCardChanges changes) Updates multiples entries at once (should be transactional: if one operation fail, nothing is written)

Methods inherited from class java.lang.Object

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

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()
                                         throws ServerFault

Description copied from interface: IAddressBook

List all items from container

Specified by:

allUids in interface IAddressBook

Returns:

Throws:

ServerFault

create

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

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

Throws:

ServerFault

createById

public void createById(long id,
                       VCard card)
                throws ServerFault

Specified by:

createById in interface IAddressBook

Throws:

ServerFault

update

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

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

Throws:

ServerFault

getComplete

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

Description copied from interface: IAddressBook

Fetch a VCard from its unique uid

Specified by:

getComplete in interface IAddressBook

Returns:

ItemValue

Throws:

ServerFault

multipleGet

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

Description copied from interface: IAddressBook

Fetch multiple VCards from theirs uniques uids

Specified by:

multipleGet in interface IAddressBook

Returns:

List>

Throws:

ServerFault

getInfo

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

Description copied from interface: IAddressBook

Fetch a VCardInfo from its unique uid

Specified by:

getInfo in interface IAddressBook

Returns:

Throws:

ServerFault

search

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

Description copied from interface: IAddressBook

ElasticSearch based vcard search

Specified by:

search in interface IAddressBook

Returns:

Throws:

ServerFault

delete

public void delete(java.lang.String uid)
            throws ServerFault

Description copied from interface: IAddressBook

Delete vcard entry

Specified by:

delete in interface IAddressBook

Throws:

ServerFault

containerChangelog

public ContainerChangelog containerChangelog(java.lang.Long since)
                                      throws ServerFault

Specified by:

containerChangelog in interface IChangelogSupport

Returns:

if successful, return a ContainerChangelog

Throws:

ServerFault

itemChangelog

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

Specified by:

itemChangelog in interface IChangelogSupport

Returns:

if successful, return a ContainerChangelog

Throws:

ServerFault

changeset

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

Specified by:

changeset in interface IChangelogSupport

Returns:

if successful, return a ContainerChangeset

Throws:

ServerFault

changesetById

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

Specified by:

changesetById in interface IChangelogSupport

Returns:

if successful, return a ContainerChangeset with internal numeric ids

Throws:

ServerFault

updates

public ContainerUpdatesResult updates(VCardChanges changes)
                               throws ServerFault

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

Throws:

ServerFault

sync

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

Description copied from interface: IAddressBook

CLIENT_WIN style

Specified by:

sync in interface IAddressBook

Returns:

Throws:

ServerFault

copy

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

Description copied from interface: IAddressBook

Copy entries from one AddressBook to another one

Specified by:

copy in interface IAddressBook

Throws:

ServerFault

move

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

Description copied from interface: IAddressBook

Move entries from one AddressBook to another one

Specified by:

move in interface IAddressBook

Throws:

ServerFault

all

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

Throws:

ServerFault

setPhoto

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

Specified by:

setPhoto in interface IAddressBook

Throws:

ServerFault

deletePhoto

public void deletePhoto(java.lang.String uid)
                 throws ServerFault

Specified by:

deletePhoto in interface IAddressBook

Throws:

ServerFault

getPhoto

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

Specified by:

getPhoto in interface IAddressBook

Throws:

ServerFault

getIcon

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

Description copied from interface: IAddressBook

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

Specified by:

getIcon in interface IAddressBook

Returns:

Throws:

ServerFault

findByEmail

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

Specified by:

findByEmail in interface IInCoreAddressBook

Throws:

ServerFault

reset

public void reset()
           throws ServerFault

Specified by:

reset in interface IAddressBook

Throws:

ServerFault

getVersion

public long getVersion()
                throws ServerFault

Specified by:

getVersion in interface IChangelogSupport

Throws:

ServerFault