Class EnumTypeConverter

  extended by ognl.DefaultTypeConverter
      extended by com.opensymphony.xwork2.util.EnumTypeConverter
All Implemented Interfaces:

public class EnumTypeConverter
extends ognl.DefaultTypeConverter

EnumTypeConverter This class converts java 5 enums to String and from String[] to enum.

One of Java 5's improvements is providing enumeration facility. Up to now, there existed no enumerations. The only way to simulate was the so-called int Enum pattern: {code} public static final int SEASON_WINTER = 0; public static final int SEASON_SPRING = 1; public static final int SEASON_SUMMER = 2; public static final int SEASON_FALL = 3; {code}

Java 5.0 now provides the following construct: {code} public static enum Season { WINTER, SPRING, SUMMER, FALL }; {code} h3. Implementing Java 5 Enumeration Type Conversion


Place a in the path of your Action. Add the following entry to the properties-file: {code} nameOfYourField=fullyClassifiedNameOfYourConverter {code}  

2.* Your action contains the _enumeration_: {code} public enum Criticality {DEBUG, INFO, WARNING, ERROR, FATAL} {code}   * Your action contains the _private field_: {code} private myEnum myFieldForEnum; {code}   Your action contains _getters and setters_ for your field: {code} public myEnum getCriticality() { return myFieldForEnum; } public void setCriticality(myEnum myFieldForEnum) { this.myFieldForEnum= myFieldForEnum; } {code}

3. JSP*

    In your jsp you can access an enumeration value just normal by using the known -Tag: {code} {code}

$Id: 1050 2006-06-26 21:46:27 +0200 (Mon, 26 Jun 2006) rainerh $
Tamara Cattivelli, Rainer Hermanns

Constructor Summary
Method Summary
 Enum convertFromString(String value, Class toClass)
          Converts one or more String values to the specified class.
 Object convertValue(Map context, Object o, Class toClass)
          Converts the given object to a given type.
Methods inherited from class ognl.DefaultTypeConverter
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail


public EnumTypeConverter()
Method Detail


public Object convertValue(Map context,
                           Object o,
                           Class toClass)
Converts the given object to a given type. How this is to be done is implemented in toClass. The OGNL context, o and toClass are given. This method should be able to handle conversion in general without any context or object specified.

convertValue in class ognl.DefaultTypeConverter
context - - OGNL context under which the conversion is being done
o - - the object to be converted
toClass - - the class that contains the code to convert to enumeration
Converted value of type declared in toClass or TypeConverter.NoConversionPossible to indicate that the conversion was not possible.


public Enum convertFromString(String value,
                              Class toClass)
Converts one or more String values to the specified class.

value - - the String values to be converted, such as those submitted from an HTML form
toClass - - the class to convert to
the converted object

Copyright © 2000-2008 Apache Software Foundation. All Rights Reserved.