org.ifeth.sehr.core.handler

Class ContactItemObjectHandler

java.lang.Object

org.ifeth.sehr.core.handler.ContactItemObjectHandler

All Implemented Interfaces:

ObjectItemAdapterInterface

public class ContactItemObjectHandler
extends java.lang.Object
implements ObjectItemAdapterInterface

This handler manages ContactItem objects.

Notes:
In a wide range we're using ORM which has (currently) some problems to handle firebird BLOBs. So some proprietary methods are coded here to store/receive BLOBs
ContactItems are stored by convention as an object in the table USR_CONTACT but they can be stored/exported/imported as XML files, vCards or local streams also.

Field Summary

Fields inherited from interface org.ifeth.sehr.core.lib.ObjectItemAdapterInterface

typeASCII, typeCSV, typeFile, typeStore, typeXML

Constructor Summary

Constructors

Constructor and Description
ContactItemObjectHandler()
ContactItemObjectHandler(javax.persistence.EntityManager em, boolean isJTA)
ContactItemObjectHandler(SEHRDataSource ds)

Method Summary

Modifier and Type	Method and Description
boolean	addXMLContactElement(ContactItem item, org.jdom.Document xmldoc) Add the item as formatted XML element to given XML document object
void	close() Used to close (terminate) the object in the current context
ContactItem	convertAdrMain(org.ifeth.sehr.intrasec.entities.AdrMain entity)
boolean	createVCard(ContactItem item, java.io.OutputStream out) Creates a VCARD from given ContactItem object to given output stream.
void	createVCard(java.io.OutputStream out) Creates a VCARD from current ContactItem object to given output stream.
void	delete() Used to delete the current object
void	display() Used to display the content
boolean	forward(java.lang.Object receiver) In this context to send a ContactItem as VCard by mail
ContactItem	getItem() Get the currently handled item based on the db record object.
java.util.List<org.ifeth.sehr.intrasec.entities.AdrMain>	listContactsByUsrID(int usrid) This method returns a list of UsrContact entities assigned to a given user (a patient, an administrator or resposible person of a module).
boolean	loadfrom(int type, java.lang.Object obj, java.lang.Object source) Used to import an object to an from input stream
void	move(java.lang.Object from, java.lang.Object to) Move content of object to another parent or leaf.
void	print() Print content of object...
void	read(int itemid) Used to read/load the object of given unique itemid from a storage
ContactItem	readContactItemByAdrID(int adrid)
void	reply(boolean object) Reply a received object or send receive notification.
boolean	save() Used to save the object using the context of the model how to save...
boolean	save(ContactItem contact) Save / Create given ContactItem as DB record at USR_CONTACT.
boolean	saveas(int type, java.lang.Object obj1, java.lang.Object out) Save given contact item object as type to given output stream.
void	send(java.lang.Object receiver) Send current object to given receiver.
void	setItem(ContactItem item) This setter is also a helper method for handling ContactItem objects as entity objects of the ORM/DAO.
void	setSEHRConfiguration(SEHRConfiguration cfg)
boolean	update() Internal method to update current item object.
boolean	update(ContactItem item) Update given ContactItem.

Methods inherited from class java.lang.Object

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

Constructor Detail

ContactItemObjectHandler

public ContactItemObjectHandler()

ContactItemObjectHandler

public ContactItemObjectHandler(SEHRDataSource ds)

ContactItemObjectHandler

public ContactItemObjectHandler(javax.persistence.EntityManager em,
                                boolean isJTA)

Method Detail

createVCard

public boolean createVCard(ContactItem item,
                           java.io.OutputStream out)

Creates a VCARD from given ContactItem object to given output stream.

No DB connection required.

Parameters:

item -

out -

Returns:

'true' if vCard was created...

createVCard

public void createVCard(java.io.OutputStream out)
                 throws ObjectHandlerException

Creates a VCARD from current ContactItem object to given output stream.

Parameters:

out -

Throws:

ObjectHandlerException

listContactsByUsrID

public java.util.List<org.ifeth.sehr.intrasec.entities.AdrMain> listContactsByUsrID(int usrid)

This method returns a list of UsrContact entities assigned to a given user (a patient, an administrator or resposible person of a module).

The BLOB with the contact item is not read to improve the performance.
After selection use readContactItemByAdrID(int) to get item object for editing or handling.

N.B.: A DB connection is required. Use a suitable constructor.

Parameters:

usrid - or '-1' list all records

Returns:

Vector_ContactItems

convertAdrMain

public ContactItem convertAdrMain(org.ifeth.sehr.intrasec.entities.AdrMain entity)

readContactItemByAdrID

public ContactItem readContactItemByAdrID(int adrid)

save

public boolean save(ContactItem contact)

Save / Create given ContactItem as DB record at USR_CONTACT.

Note: This method modifies the item by storing the ID of the database inside the object before it writes the object to the DB as BLOB

Parameters:

contact -

Returns:

update

public boolean update(ContactItem item)

Update given ContactItem.

Remember that on updates the ContactItem object is identified by the EntryID.

Parameters:

item -

Returns:

update

public boolean update()

Internal method to update current item object.

Specified by:

update in interface ObjectItemAdapterInterface

Returns:

getItem

public ContactItem getItem()

Get the currently handled item based on the db record object.

Returns:

setItem

public void setItem(ContactItem item)

This setter is also a helper method for handling ContactItem objects as entity objects of the ORM/DAO.

This method sets the fields of the USR_CONTACT entity of the given ContactItem object.

Parameters:

item -

addXMLContactElement

public boolean addXMLContactElement(ContactItem item,
                                    org.jdom.Document xmldoc)

Add the item as formatted XML element to given XML document object

Parameters:

item - output stream to be writed to (the user profile)

xmldoc - Ref. SEHRContatctItem specification and DTD for structure

Returns:

save

public boolean save()

Description copied from interface: ObjectItemAdapterInterface

Used to save the object using the context of the model how to save...

Specified by:

save in interface ObjectItemAdapterInterface

Returns:

boolean_result, 'true' if successful

saveas

public boolean saveas(int type,
                      java.lang.Object obj1,
                      java.lang.Object out)

Save given contact item object as type to given output stream.

Specified by:

saveas in interface ObjectItemAdapterInterface

Parameters:

type - e.g. XML

obj1 - e.g. ContactItem

out - e.g. File, String or JDOM Document

Returns:

print

public void print()

Description copied from interface: ObjectItemAdapterInterface

Print content of object...

Specified by:

print in interface ObjectItemAdapterInterface

send

public void send(java.lang.Object receiver)

Description copied from interface: ObjectItemAdapterInterface

Send current object to given receiver.

Receiver may be a single String, a StringArray or List

Specified by:

send in interface ObjectItemAdapterInterface

move

public void move(java.lang.Object from,
                 java.lang.Object to)

Description copied from interface: ObjectItemAdapterInterface

Move content of object to another parent or leaf.

Specified by:

move in interface ObjectItemAdapterInterface

forward

public boolean forward(java.lang.Object receiver)

In this context to send a ContactItem as VCard by mail

Specified by:

forward in interface ObjectItemAdapterInterface

Returns:

reply

public void reply(boolean object)

Description copied from interface: ObjectItemAdapterInterface

Reply a received object or send receive notification.

The address to reply to will be exctracted from the object header. A reply will be send to the originator or sender of the object only due to security aspects.

Specified by:

reply in interface ObjectItemAdapterInterface

Parameters:

object - - If 'true' reply object; otherwise a note only

read

public void read(int itemid)

Description copied from interface: ObjectItemAdapterInterface

Used to read/load the object of given unique itemid from a storage

Specified by:

read in interface ObjectItemAdapterInterface

Parameters:

itemid - Use the unique id for each item to load it

close

public void close()

Description copied from interface: ObjectItemAdapterInterface

Used to close (terminate) the object in the current context

Specified by:

close in interface ObjectItemAdapterInterface

delete

public void delete()

Description copied from interface: ObjectItemAdapterInterface

Used to delete the current object

Specified by:

delete in interface ObjectItemAdapterInterface

display

public void display()

Description copied from interface: ObjectItemAdapterInterface

Used to display the content

Specified by:

display in interface ObjectItemAdapterInterface

loadfrom

public boolean loadfrom(int type,
                        java.lang.Object obj,
                        java.lang.Object source)

Description copied from interface: ObjectItemAdapterInterface

Used to import an object to an from input stream

Specified by:

loadfrom in interface ObjectItemAdapterInterface

Parameters:

type - to use a specific converter

obj - the object to store data in, e.g. ContactItem

source - the source as an input stream object

Returns:

setSEHRConfiguration

public void setSEHRConfiguration(SEHRConfiguration cfg)