org.openmrs

Class PersonAttribute

java.lang.Object

org.openmrs.BaseOpenmrsObject

org.openmrs.BaseOpenmrsData

org.openmrs.PersonAttribute

All Implemented Interfaces:

java.io.Serializable, java.lang.Comparable<PersonAttribute>, Auditable, OpenmrsData, OpenmrsObject, Voidable

public class PersonAttribute
extends BaseOpenmrsData
implements java.io.Serializable, java.lang.Comparable<PersonAttribute>

A PersonAttribute is meant as way for implementations to add arbitrary information about a user/patient to their database. PersonAttributes are essentially just key-value pairs. However, the PersonAttributeType can be defined in such a way that the value portion of this PersonAttribute is a foreign key to another database table (like to the location table, or concept table). This gives a PersonAttribute the ability to link to any other part of the database A Person can have zero to n PersonAttribute(s).

See Also:

PersonAttributeType, Attributable, Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
static long	serialVersionUID

Fields inherited from class org.openmrs.BaseOpenmrsData

creator

Constructor Summary

Constructors

Constructor and Description
PersonAttribute() default constructor
PersonAttribute(java.lang.Integer personAttributeId)
PersonAttribute(PersonAttributeType type, java.lang.String value) Constructor for creating a basic attribute

Method Summary

Modifier and Type	Method and Description
int	compareTo(PersonAttribute other)
PersonAttribute	copy() Shallow copy of this PersonAttribute.
protected PersonAttribute	copyHelper(PersonAttribute target) The purpose of this method is to allow subclasses of PersonAttribute to delegate a portion of their copy() method back to the superclass, in case the base class implementation changes.
boolean	equalsContent(PersonAttribute otherAttribute) Compares this PersonAttribute object to the given otherAttribute.
PersonAttributeType	getAttributeType()
java.lang.Object	getHydratedObject() Will try to create an object of class 'PersonAttributeType.format'.
java.lang.Integer	getId()
Person	getPerson()
java.lang.Integer	getPersonAttributeId()
java.lang.String	getValue()
void	setAttributeType(PersonAttributeType attributeType)
void	setId(java.lang.Integer id)
void	setPerson(Person person)
void	setPersonAttributeId(java.lang.Integer personAttributeId)
void	setValue(java.lang.String value)
java.lang.String	toString() Returns a string consisting of the name of the class of which the object is an instance and the uuid field surrounded by [ and ].
void	voidAttribute(java.lang.String reason) Convenience method for voiding this attribute

Methods inherited from class org.openmrs.BaseOpenmrsData

getChangedBy, getCreator, getDateChanged, getDateCreated, getDateVoided, getVoided, getVoidedBy, getVoidReason, isVoided, setChangedBy, setCreator, setDateChanged, setDateCreated, setDateVoided, setVoided, setVoidedBy, setVoidReason

Methods inherited from class org.openmrs.BaseOpenmrsObject

equals, getUuid, hashCode, setUuid

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface org.openmrs.OpenmrsObject

getUuid, setUuid

Field Detail

serialVersionUID

public static final long serialVersionUID

See Also:

Constant Field Values

Constructor Detail

PersonAttribute

public PersonAttribute()

default constructor

PersonAttribute

public PersonAttribute(java.lang.Integer personAttributeId)

PersonAttribute

public PersonAttribute(PersonAttributeType type,
                       java.lang.String value)

Constructor for creating a basic attribute

Parameters:

type - PersonAttributeType

value - String

Method Detail

copy

public PersonAttribute copy()

Shallow copy of this PersonAttribute. Does NOT copy personAttributeId

Returns:

a shallows copy of this

copyHelper

protected PersonAttribute copyHelper(PersonAttribute target)

The purpose of this method is to allow subclasses of PersonAttribute to delegate a portion of their copy() method back to the superclass, in case the base class implementation changes.

Parameters:

target - a PersonAttribute that will have the state of this copied into it

Returns:

Returns the PersonAttribute that was passed in, with state copied into it

equalsContent

public boolean equalsContent(PersonAttribute otherAttribute)

Compares this PersonAttribute object to the given otherAttribute. This method differs from BaseOpenmrsObject.equals(Object) in that this method compares the inner fields of each attribute for equality. Note: Null/empty fields on otherAttribute /will not/ cause a false value to be returned

Parameters:

otherAttribute - PersonAttribute with which to compare

Returns:

boolean true/false whether or not they are the same attributes

getPerson

public Person getPerson()

Returns:

Returns the person.

setPerson

public void setPerson(Person person)

Parameters:

person - The person to set.

getAttributeType

public PersonAttributeType getAttributeType()

Returns:

the attributeType

setAttributeType

public void setAttributeType(PersonAttributeType attributeType)

Parameters:

attributeType - the attributeType to set

getValue

public java.lang.String getValue()

Returns:

the value

setValue

public void setValue(java.lang.String value)

Parameters:

value - the value to set

toString

public java.lang.String toString()

Description copied from class: BaseOpenmrsObject

Returns a string consisting of the name of the class of which the object is an instance and the uuid field surrounded by [ and ]. In other words, this method returns a string equal to the value of:

 getClass().getName() + '[' + uuid + ']'
 

If the uuid field is null, it delegates to Object.toString()

Overrides:

toString in class BaseOpenmrsObject

See Also:

Object.toString()

getPersonAttributeId

public java.lang.Integer getPersonAttributeId()

Returns:

the personAttributeId

setPersonAttributeId

public void setPersonAttributeId(java.lang.Integer personAttributeId)

Parameters:

personAttributeId - the personAttributeId to set

getHydratedObject

public java.lang.Object getHydratedObject()

Will try to create an object of class 'PersonAttributeType.format'. If that implements Attributable, hydrate(value) is called. Defaults to just returning getValue()

Returns:

hydrated object or getValue()

voidAttribute

public void voidAttribute(java.lang.String reason)

Convenience method for voiding this attribute

Parameters:

reason -

compareTo

public int compareTo(PersonAttribute other)

Specified by:

compareTo in interface java.lang.Comparable<PersonAttribute>

See Also:

Comparable.compareTo(java.lang.Object)

getId

public java.lang.Integer getId()

Specified by:

getId in interface OpenmrsObject

Returns:

id - The unique Identifier for the object

Since:

1.5

See Also:

OpenmrsObject.getId()

setId

public void setId(java.lang.Integer id)

Specified by:

setId in interface OpenmrsObject

Parameters:

id - - The unique Identifier for the object

Since:

1.5

See Also:

OpenmrsObject.setId(java.lang.Integer)