You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@wicket.apache.org by sv...@apache.org on 2012/08/01 23:45:14 UTC

git commit: javadoc hint to use a converter for non-String type

Updated Branches:
  refs/heads/master e64451443 -> 26fcc60fd


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/26fcc60f
Tree: http://git-wip-us.apache.org/repos/asf/wicket/tree/26fcc60f
Diff: http://git-wip-us.apache.org/repos/asf/wicket/diff/26fcc60f

Branch: refs/heads/master
Commit: 26fcc60fd486a122f2d425cf9179cce01d5351f4
Parents: e644514
Author: svenmeier <sv...@apache.org>
Authored: Wed Aug 1 23:44:48 2012 +0200
Committer: svenmeier <sv...@apache.org>
Committed: Wed Aug 1 23:44:48 2012 +0200

----------------------------------------------------------------------
 .../html/autocomplete/AutoCompleteTextField.java   |   14 ++++++++++----
 1 files changed, 10 insertions(+), 4 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/wicket/blob/26fcc60f/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 2fd0f1b..d554bdc 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,14 +18,20 @@ 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}.
- * 
+ * <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.
  * 
@@ -265,8 +271,8 @@ public abstract class AutoCompleteTextField<T> extends TextField<T>
 	protected abstract Iterator<T> getChoices(String input);
 
 	/**
-	 * @return The {@link IAutoCompleteRenderer} used to generate
-	 *      html output for the {@link AutoCompleteBehavior}.
+	 * @return The {@link IAutoCompleteRenderer} used to generate html output for the
+	 *         {@link AutoCompleteBehavior}.
 	 */
 	public final IAutoCompleteRenderer<T> getChoiceRenderer()
 	{