Updated Branches:
  refs/heads/wicket-1.5.x 2e93f06a5 -> d4ba2690a

javadoc hint to use a converter for non-String type


Project: http://git-wip-us.apache.org/repos/asf/wicket/repo
Commit: http://git-wip-us.apache.org/repos/asf/wicket/commit/d4ba2690
Tree: http://git-wip-us.apache.org/repos/asf/wicket/tree/d4ba2690
Diff: http://git-wip-us.apache.org/repos/asf/wicket/diff/d4ba2690

Branch: refs/heads/wicket-1.5.x
Commit: d4ba2690a42c1f783cb349136b8c21d9b71f3ba4
Parents: 2e93f06
Author: svenmeier <[email protected]>
Authored: Wed Aug 1 23:44:14 2012 +0200
Committer: svenmeier <[email protected]>
Committed: Wed Aug 1 23:44:14 2012 +0200

----------------------------------------------------------------------
 .../html/autocomplete/AutoCompleteTextField.java   |   16 ++++++++++----
 1 files changed, 11 insertions(+), 5 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/wicket/blob/d4ba2690/wicket-extensions/src/main/java/org/apache/wicket/extensions/ajax/markup/html/autocomplete/AutoCompleteTextField.java
----------------------------------------------------------------------
diff --git 
a/wicket-extensions/src/main/java/org/apache/wicket/extensions/ajax/markup/html/autocomplete/AutoCompleteTextField.java
 
b/wicket-extensions/src/main/java/org/apache/wicket/extensions/ajax/markup/html/autocomplete/AutoCompleteTextField.java
index 5c9b058..38761a8 100644
--- 
a/wicket-extensions/src/main/java/org/apache/wicket/extensions/ajax/markup/html/autocomplete/AutoCompleteTextField.java
+++ 
b/wicket-extensions/src/main/java/org/apache/wicket/extensions/ajax/markup/html/autocomplete/AutoCompleteTextField.java
@@ -18,18 +18,24 @@ package 
org.apache.wicket.extensions.ajax.markup.html.autocomplete;
 
 import java.util.Iterator;
 
+import org.apache.wicket.ConverterLocator;
 import org.apache.wicket.markup.ComponentTag;
 import org.apache.wicket.markup.html.form.TextField;
 import org.apache.wicket.model.IModel;
-
+import org.apache.wicket.util.convert.IConverter;
 
 /**
  * An implementation of a textfield with the autoassist ajax behavior {@link 
AutoCompleteBehavior}.
- * 
- * FIXME javadoc - constructors need proper descriptions
- * 
+ * <p>
+ * An {@link IAutoCompleteRenderer} is used for rendering of choices. To 
convert input back into a
+ * non-String type you will have to provide a custom {@link IConverter}, 
either by overriding
+ * {@link #getConverter(Class)} or by setting a suitable {@link IConverter} on 
the application's
+ * {@link ConverterLocator}.
+ * <p>
  * Note that you must add your own CSS to make the suggestion display 
properly, see
  * {@link DefaultCssAutoCompleteTextField} for an example.
+ * <p>
+ * FIXME javadoc - constructors need proper descriptions
  * 
  * @see DefaultCssAutoCompleteTextField
  * @see AutoCompleteBehavior
@@ -40,7 +46,7 @@ import org.apache.wicket.model.IModel;
  * @author Igor Vaynberg (ivaynberg)
  * 
  * @param <T>
- *            The model object type
+ *            The model object type, see {@link #getConverter(Class)} for 
non-String types
  */
 public abstract class AutoCompleteTextField<T> extends TextField<T>
 {

Reply via email to