org.openmrs.obs.handler

Class ImageHandler

java.lang.Object

org.openmrs.obs.handler.AbstractHandler

org.openmrs.obs.handler.ImageHandler

All Implemented Interfaces:

ComplexObsHandler

public class ImageHandler
extends AbstractHandler
implements ComplexObsHandler

Handler for storing basic images for complex obs to the file system. The image mime type used is taken from the image name. if the .* image name suffix matches ImageIO.getWriterFormatNames() then that mime type will be used to save the image. Images are stored in the location specified by the global property: "obs.complex_obs_dir"

Since:

1.5

See Also:

OpenmrsConstants.GLOBAL_PROPERTY_COMPLEX_OBS_DIR

Field Summary

Fields inherited from class org.openmrs.obs.handler.AbstractHandler

nf

Fields inherited from interface org.openmrs.obs.ComplexObsHandler

HTML_VIEW, PREVIEW_VIEW, RAW_VIEW, TEXT_VIEW, TITLE_VIEW, URI_VIEW

Constructor Summary

Constructors

Constructor and Description
ImageHandler() Constructor initializes formats for alternative file names to protect from unintentionally overwriting existing files.

Method Summary

Modifier and Type	Method and Description
Obs	getObs(Obs obs, String view) Currently supports all views and puts the Image file data into the ComplexData object
String[]	getSupportedViews() Supported views getter
Obs	saveObs(Obs obs) Save a complex obs.

Methods inherited from class org.openmrs.obs.handler.AbstractHandler

getComplexDataFile, getExtension, getOutputFileToWrite, purgeComplexData, supportsView

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.openmrs.obs.ComplexObsHandler

purgeComplexData, supportsView

Constructor Detail

ImageHandler

public ImageHandler()

Constructor initializes formats for alternative file names to protect from unintentionally overwriting existing files.

Method Detail

getObs

public Obs getObs(Obs obs,
                  String view)

Currently supports all views and puts the Image file data into the ComplexData object

Specified by:

getObs in interface ComplexObsHandler

Overrides:

getObs in class AbstractHandler

Parameters:

obs - an obs without complex data filled in

view - nullable view type. This is defined by the ui and view/handler

Returns:

the obs with complex data filled in

See Also:

ComplexObsHandler.getObs(org.openmrs.Obs, java.lang.String)

getSupportedViews

public String[] getSupportedViews()

Description copied from interface: ComplexObsHandler

Supported views getter

Specified by:

getSupportedViews in interface ComplexObsHandler

Overrides:

getSupportedViews in class AbstractHandler

Returns:

all views supported by this handler

See Also:

ComplexObsHandler.getSupportedViews()

saveObs

public Obs saveObs(Obs obs)
            throws APIException

Description copied from interface: ComplexObsHandler

Save a complex obs. This extracts the ComplexData from an Obs, stores it to a location determined by the handler, and returns the Obs with the ComplexData nullified.

Specified by:

saveObs in interface ComplexObsHandler

Returns:

the Obs with the ComplexData nullified

Throws:

APIException

See Also:

ComplexObsHandler.saveObs(org.openmrs.Obs)