Package name.matthewgreet.strutscommons.policy

Interface Converter<A extends Annotation,T>

All Superinterfaces:

Policy<A>

All Known Implementing Classes:

AbstractConverterSupport, AbstractCustomConverterSupport, AbstractCustomFormatterSupport, BigDecimalConverter, BooleanConverter, ByteConverter, CharacterConverter, DateConverter, DoubleConverter, EnumConverter, FloatConverter, IntegerConverter, LongConverter, ShortConverter

public interface Converter<A extends Annotation,T>
extends Policy<A>

Interface for form field validators used by AnnotationValidationInterceptor and AnnotationValidationInterceptor2 that convert from string values to single values and vice versa.

Method Summary

Modifier and Type	Method	Description
ConversionResult<T>	convert(String fieldValue, Class<? extends T> recipientClass)	Returns result of conversion of form field.
String	format(T unformattedValue)	Returns single field value formatted for display in a form field.
String	getMessage()	Returns message set by annotation.
String	getMessageKey()	Returns message key set by annotation, which is used to retrieve message from Action's TextProvider if it's not empty string.
Required.MessageType	getMessageType()	Returns whether to write any error message to action errors, field errors, or action messages.
boolean	getProcessNoValue()	Returns whether convert(java.lang.String, java.lang.Class<? extends T>) converts empty string value, and format(T) formats null value.
Class<T>	getRecipientClass()	Returns type of recipient fields that can receive converted form value.
String	getRecipientFieldName()	Returns name of field to receive converted form value, which can be empty string to use default.

Methods inherited from interface name.matthewgreet.strutscommons.policy.Policy

getAnnotation, setAnnotation

Method Details

convert

ConversionResult<T> convert(String fieldValue,
 Class<? extends T> recipientClass)
                     throws Exception

Returns result of conversion of form field. This is not called if the form value is empty string or null, unless getProcessNoValue() returns true.

Throws:

Exception

format

String format(T unformattedValue)
       throws Exception

Returns single field value formatted for display in a form field. Only applies single value recipients. Not called if the unformatted value is null, unless getProcessNoValue() returns true..

Throws:

Exception

getMessageType

Required.MessageType getMessageType()

Returns whether to write any error message to action errors, field errors, or action messages.

getMessage

String getMessage()

Returns message set by annotation. Used if getMessageKey() is empty string or it fails to find a message.

getMessageKey

String getMessageKey()

Returns message key set by annotation, which is used to retrieve message from Action's TextProvider if it's not empty string.

getRecipientClass

Class<T> getRecipientClass()

Returns type of recipient fields that can receive converted form value.

getRecipientFieldName

String getRecipientFieldName()

Returns name of field to receive converted form value, which can be empty string to use default.

getProcessNoValue

boolean getProcessNoValue()

Returns whether convert(java.lang.String, java.lang.Class<? extends T>) converts empty string value, and format(T) formats null value.