Package name.matthewgreet.strutscommons.annotation

Annotation Type CharacterConversion

@Documented @Inherited @Target(FIELD) @Retention(RUNTIME) public @interface CharacterConversion

Defines a form field (whether on a Struts Action or model of ModelDriven Struts Action) should be parsed to a char or Character type and error message to display if this fails. Also, defines a view helper field receives a formatted character value. This is the default converter for char or Character fields.

There are various modes of behaviour for conversion, depending on the type of form field.

Conversion Annotation Usage
Form field type Conversion mode Description
Character or char single value Auto conversion Converts directly from request parameter of the same name
Character or char array or collection Auto conversion Converts each request parameter of the same name and creates and sets array or collection
String single value Pair conversion Converts string field value to Character or char field named by parsedFieldName
String array or collection Pair conversion Converts each string field value, creates and sets Character or char array or collection field named by parsedFieldName

By default, messages are written as Action error messages for form processing Actions and logged as warnings for viewer Actions but this can be overridden by messageType. For viewer Actions, it's recommended they implement LoggingAware (which AbstractViewActionSupport already does).

Message Types
DEFAULT Uses default setting of controlling interceptor or library, which is usually Action error messages for form processing Actions and logged as warnings for view ActionsMessage. Default.
ERROR Message added to Action level error messages.
FIELD Message added to field error messages using same name as field.
IGNORE Message is not shown to user or logged. This is not recommended.
LOG_DEBUG Logged to Action's Log4j2 logger (or controlling interceptor's if not available) at DEBUG level.
LOG_ERROR Logged to Action's Log4j2 logger (or controlling interceptor's if not available) at ERROR level.
LOG_INFO Logged to Action's Log4j2 logger (or controlling interceptor's if not available) at INFO level.
LOG_TRACE Logged to Action's Log4j2 logger (or controlling interceptor's if not available) at TRACE level.
LOG_WARN Logged to Action's Log4j2 logger (or controlling interceptor's if not available) at WARN level.
MESSAGE Message added to Action level info messages.
WARNING Message added to Action level warning messages.

Other parameters

Other Parameters
message If not empty string, text message to display. Used if messageKey is empty string or finds no message.
messageKey If not empty string, message key to retrieve from Action's TextProvider. Uses message if no key provided or no message found.
parsedFieldName If not empty string, name of field to contain parsed value. Defaults to 'parsed' plus capitalised field name, such as 'parsedLimit'. Only applies for pair conversion.

When applied to a view helper field, StrutsMiscellaneousLibrary#updateDisplay formats from a source record field with the same name but only certain combinations are recognised.

Formatting Annotation Usage
Display field type Record field type
String single value char or Character single value
String array or collection char or Character array or collection

  • Element Details

    • message

      String message
      Default:
      ""

    • messageKey

      String messageKey
      Default:
      ""

    • messageType

      Required.MessageType messageType
      Default:
      DEFAULT

    • parsedFieldName

      String parsedFieldName
      Default:
      ""