Package name.matthewgreet.strutscommons.policy

Class StringCSVConverter

java.lang.Object

name.matthewgreet.strutscommons.policy.AbstractPolicySupport<StringCSVConversion>

name.matthewgreet.strutscommons.policy.AbstractValidatorSupport<StringCSVConversion>

name.matthewgreet.strutscommons.policy.AbstractCollectionConverterSupport<StringCSVConversion,String>

name.matthewgreet.strutscommons.policy.StringCSVConverter

All Implemented Interfaces:

CollectionConverter<StringCSVConversion,String>, Policy<StringCSVConversion>, Validator<StringCSVConversion>

public class StringCSVConverter
extends AbstractCollectionConverterSupport<StringCSVConversion,String>

Constructor Summary

Constructors

Constructor	Description
StringCSVConverter()

Method Summary

Modifier and Type	Method	Description
ConversionResult<String>	convert(String formValue, Class<?> recipientFieldClass, Class<? extends String> recipientClass)	Returns result of conversion of form field.
String	format(Collection<String> unformattedValues)	Returns collection-based 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 CollectionConverter.convert(java.lang.String, java.lang.Class<?>, java.lang.Class<? extends T>) converts empty string value, and CollectionConverter.format(java.util.Collection<T>) formats null value or empty collection.
Class<String>	getRecipientClass()	Returns item types of recipient collection 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 class name.matthewgreet.strutscommons.policy.AbstractCollectionConverterSupport

makeCollectionForRecipient

Methods inherited from class name.matthewgreet.strutscommons.policy.AbstractPolicySupport

getAnnotation, setAnnotation

Methods inherited from class java.lang.Object

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

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

getAnnotation, setAnnotation

Constructor Details

StringCSVConverter

public StringCSVConverter()

Method Details

format

public String format(Collection<String> unformattedValues)
              throws Exception

Description copied from interface: CollectionConverter

Returns collection-based field value formatted for display in a form field. Not called if the unformatted value is null or empty collection, unless CollectionConverter.getProcessNoValue() returns true.

Throws:

Exception

getRecipientClass

public Class<String> getRecipientClass()

Description copied from interface: CollectionConverter

Returns item types of recipient collection fields that can receive converted form value. Not to be confused with collection type.

getMessageType

public Required.MessageType getMessageType()

Description copied from interface: Validator

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

getMessage

public String getMessage()

Description copied from interface: Validator

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

getMessageKey

public String getMessageKey()

Description copied from interface: Validator

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

getRecipientFieldName

public String getRecipientFieldName()

Description copied from interface: CollectionConverter

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

convert

public ConversionResult<String> convert(String formValue,
 Class<?> recipientFieldClass,
 Class<? extends String> recipientClass)
                                 throws Exception

Description copied from interface: CollectionConverter

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

Throws:

Exception

getProcessNoValue

public boolean getProcessNoValue()

Description copied from interface: CollectionConverter

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