org.openmrs.api.handler

Class RetireSaveHandler

java.lang.Object

org.openmrs.api.handler.RetireSaveHandler

All Implemented Interfaces:

RequiredDataHandler<Retireable>, SaveHandler<Retireable>

@Handler(supports=Retireable.class)
public class RetireSaveHandler
extends Object
implements SaveHandler<Retireable>

This handler makes sure the when a retired object is saved with the retired bit set to true, the other required values (like dateRetired and retiredBy) are filled in. It also makes sure the retired attributes are cleared out if the retired bit is set to false.

The RequiredDataAdvice class uses AOP around each method in every service to check to see if its a save* method. If it is a save* method, and the object being saved implements Retireable, this class is called to handle setting the Retireable.setRetiredBy(User), and Retireable.setDateRetired(Date) if not set already.

Note: The RequiredDataAdvice class will loop over child collections on this Retireable that are themselves a Retireable and retiredBy/dateRetired are set, but ONLY IF the retired bit was set on them as well. Using the associated retire* method in the service on the parent instance is preferred so that all child objects are indeed retired.

Since:

1.5

See Also:

RequiredDataAdvice, SaveHandler, RequiredDataAdvice

Constructor Summary

Constructors

Constructor and Description
RetireSaveHandler()

Method Summary

Modifier and Type	Method and Description
void	handle(Retireable retireableObject, User currentUser, Date currentDate, String notUsed) This method does not set "retired" to true, but rather only sets the retiredBy/dateRetired if they are null and retired==true.

Methods inherited from class java.lang.Object

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

Constructor Detail

RetireSaveHandler

public RetireSaveHandler()

Method Detail

handle

public void handle(Retireable retireableObject,
                   User currentUser,
                   Date currentDate,
                   String notUsed)

This method does not set "retired" to true, but rather only sets the retiredBy/dateRetired if they are null and retired==true.

If retired is set to false, the retired attributes are cleared nullified.

Specified by:

handle in interface RequiredDataHandler<Retireable>

Specified by:

handle in interface SaveHandler<Retireable>

Parameters:

retireableObject - an OpenmrsObject that needs to have some required data set

currentUser - the user who is saving this object

currentDate - the datetime this object is being saved

notUsed - (optional) would be the second argument in the save method, if exists

See Also:

Should not set the retired bit Should not set the retireReason Should set retired by Should not set retired by if non null Should set dateRetired Should not set dateRetired if non null Should not set the dateRetired if retired is false Should set retireReason to null if retired is true Should set dateRetired to null if retired is true Should set retiredBy to null if retired is true