javax.faces.convert
Annotation Type FacesConverter


@Retention(value=RUNTIME)
@Target(value=TYPE)
@Inherited
public @interface FacesConverter

The presence of this annotation on a class automatically registers the class with the runtime as a Converter. The value of the value() attribute is taken to be converter-id, the value of the forClass() attribute is taken to be converter-for-class and the fully qualified class name of the class to which this annotation is attached is taken to be the converter-class. The implementation must guarantee that for each class annotated with FacesConverter, found with the algorithm in section JSF.11.5, the proper variant of Application.addConverter() is called. If converter-id is not the empty string, Application.addConverter(java.lang.String,java.lang.String) is called, passing the derived converter-id as the first argument and the derived converter-class as the second argument. If converter-id is the empty string, Application.addConverter(java.lang.Class,java.lang.String) is called, passing the converter-for-class as the first argument and the derived converter-class as the second argument. The implementation must guarantee that all such calls to addConverter() happen during application startup time and before any requests are serviced.


Optional Element Summary
 java.lang.Class forClass
          

The value of this annotation attribute is taken to be the converter-for-class with which instances of this class of converter can be instantiated by calling Application.createConverter(java.lang.Class).

 java.lang.String value
          

The value of this annotation attribute is taken to be the converter-id with which instances of this class of converter can be instantiated by calling Application.createConverter(java.lang.String).

 

value

public abstract java.lang.String value

The value of this annotation attribute is taken to be the converter-id with which instances of this class of converter can be instantiated by calling Application.createConverter(java.lang.String).

Default:
""

forClass

public abstract java.lang.Class forClass

The value of this annotation attribute is taken to be the converter-for-class with which instances of this class of converter can be instantiated by calling Application.createConverter(java.lang.Class).

Default:
java.lang.Object.class


Submit a bug or feature

Copyright © 2009, 2010, Oracle Corporation and/or its affiliates. All Rights Reserved. Use is subject to license terms.

Generated on 4-June-2010 04:34