com.bitplan.vcard

Class CardDavStore

java.lang.Object

com.bitplan.vcard.CardDavStore

public class CardDavStore
extends Object

manage vcards for a single user in as a store

Author:

wf

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
class	CardDavStore.SyncRef a synchronisation reference

Field Summary

Fields

Modifier and Type	Field and Description
protected static Logger	LOGGER
protected static Map<String,Properties>	propMap

Constructor Summary

Constructors

Constructor and Description
CardDavStore(File vcardPath, String title) read this store from a single VCardFile (or directory)
CardDavStore(String host, String path) create a Card Dav Store

Method Summary

Modifier and Type	Method and Description
void	add(ezvcard.VCard vcard, String uidToUse) add the given vcard
List<ezvcard.VCard>	backup() backup all my vcards
void	diff(CardDavStore other) check the difference between two stores
void	diff(Map<String,ezvcard.VCard> self, Map<String,ezvcard.VCard> other, String thisTitle, String otherTitle)
String	getBackupPath()
void	getBackupPath(String backupPath)
static CardDavStore	getCardDavStore(String user) get the CardDav Store for the given user
String	getHost()
String	getPassword()
String	getPath()
static String	getProperty(String user, String propName) get the given Property for the given user
static File	getPropertyFile(String user) get the property file for the given user
Map<String,com.github.sardine.DavResource>	getResourceMap()
String	getSyncUid(ezvcard.VCard vcard) get the Synchronization uid
String	getTitle()
String	getUid(com.github.sardine.DavResource ref) get the Uid for the given VCard reference
String	getUsername()
ezvcard.VCard	getVCardFromRef(com.github.sardine.DavResource ref) get the VCard for the given ref
void	getVCardRefs() get a map of VCard references from the server if the map is empty
List<ezvcard.VCard>	getVCards(int limit) get the VCards for this store
boolean	isDebug()
void	prepareSync() prepare the synchronization by creating a map of Synchronization References
void	read(File vcardPath)
void	readFromBackup() read me from the backup directory
void	remove(String uid) remove the given vcard
void	setDebug(boolean debug)
void	setHost(String host)
void	setPassword(String password)
void	setPath(String path)
void	setResourceMap(Map<String,com.github.sardine.DavResource> resourceMap)
void	setTitle(String title)
void	setUsername(String username)
void	sync() Synchronize my local store with the server
void	synchronizationStatistics()
void	write(ezvcard.VCard vcard, File vCardFile, com.github.sardine.DavResource ref) write the given vcard to the given vCardFile using the given ref

Methods inherited from class java.lang.Object

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

Field Detail

LOGGER

protected static Logger LOGGER

propMap

protected static Map<String,Properties> propMap

Constructor Detail

CardDavStore

public CardDavStore(String host,
                    String path)

create a Card Dav Store

Parameters:

host -

path -

CardDavStore

public CardDavStore(File vcardPath,
                    String title)
             throws IOException

read this store from a single VCardFile (or directory)

Parameters:

vcardPath -

title - - the title for this Cardfile

Throws:

IOException

Method Detail

getTitle

public String getTitle()

Returns:

the title

setTitle

public void setTitle(String title)

Parameters:

title - the title to set

getBackupPath

public String getBackupPath()

Returns:

the backupPath

getBackupPath

public void getBackupPath(String backupPath)

Parameters:

backupPath - the backupPath to set

getUsername

public String getUsername()

Returns:

the username

setUsername

public void setUsername(String username)

Parameters:

username - the username to set

getPassword

public String getPassword()

Returns:

the password

setPassword

public void setPassword(String password)

Parameters:

password - the password to set

getHost

public String getHost()

Returns:

the host

setHost

public void setHost(String host)

Parameters:

host - the host to set

getPath

public String getPath()

Returns:

the path

setPath

public void setPath(String path)

Parameters:

path - the path to set

isDebug

public boolean isDebug()

Returns:

the debug

setDebug

public void setDebug(boolean debug)

Parameters:

debug - the debug to set

getResourceMap

public Map<String,com.github.sardine.DavResource> getResourceMap()

setResourceMap

public void setResourceMap(Map<String,com.github.sardine.DavResource> resourceMap)

getPropertyFile

public static File getPropertyFile(String user)

get the property file for the given user

Parameters:

user -

Returns:

- the property file

getProperty

public static String getProperty(String user,
                                 String propName)
                          throws FileNotFoundException,
                                 IOException

get the given Property for the given user

Parameters:

user -

propName -

Returns:

the property

Throws:

FileNotFoundException

IOException

getCardDavStore

public static CardDavStore getCardDavStore(String user)
                                    throws Exception

get the CardDav Store for the given user

Parameters:

user -

Returns:

the CardDavStore

Throws:

Exception

add

public void add(ezvcard.VCard vcard,
                String uidToUse)

add the given vcard

Parameters:

vcard -

uidToUse -

read

public void read(File vcardPath)
          throws IOException

Throws:

IOException

getSyncUid

public String getSyncUid(ezvcard.VCard vcard)

get the Synchronization uid

Parameters:

vcard -

Returns:

the uid

getVCardRefs

public void getVCardRefs()
                  throws Exception

get a map of VCard references from the server if the map is empty

Throws:

Exception

prepareSync

public void prepareSync()
                 throws Exception

prepare the synchronization by creating a map of Synchronization References

Throws:

Exception

getVCardFromRef

public ezvcard.VCard getVCardFromRef(com.github.sardine.DavResource ref)
                              throws Exception

get the VCard for the given ref

Parameters:

ref -

Returns:

the VCard

Throws:

Exception

write

public void write(ezvcard.VCard vcard,
                  File vCardFile,
                  com.github.sardine.DavResource ref)
           throws Exception

write the given vcard to the given vCardFile using the given ref

Parameters:

vcard -

vCardFile -

ref -

Throws:

Exception

getUid

public String getUid(com.github.sardine.DavResource ref)

get the Uid for the given VCard reference

Parameters:

ref -

Returns:

- the uid

sync

public void sync()
          throws Exception

Synchronize my local store with the server

Throws:

Exception

synchronizationStatistics

public void synchronizationStatistics()

diff

public void diff(Map<String,ezvcard.VCard> self,
                 Map<String,ezvcard.VCard> other,
                 String thisTitle,
                 String otherTitle)

diff

public void diff(CardDavStore other)

check the difference between two stores

Parameters:

other -

getVCards

public List<ezvcard.VCard> getVCards(int limit)
                              throws Exception

get the VCards for this store

Parameters:

limit - - the maximum number of cards to get

Returns:

- the vcards

Throws:

Exception

backup

public List<ezvcard.VCard> backup()
                           throws Exception

backup all my vcards

Throws:

Exception

readFromBackup

public void readFromBackup()
                    throws IOException

read me from the backup directory

Throws:

IOException

remove

public void remove(String uid)
            throws Exception

remove the given vcard

Parameters:

uid -

Throws:

Exception