public class StringArrayPropertyEditor
extends java.beans.PropertyEditorSupport
PropertyEditor for String arrays.
Strings must be in CSV format, with a customizable separator. By default values in the result are trimmed of whitespace.
StringUtils.delimitedListToStringArray(java.lang.String, java.lang.String),
StringUtils.arrayToDelimitedString(java.lang.Object[], java.lang.String)| Modifier and Type | Field and Description |
|---|---|
static java.lang.String |
DEFAULT_SEPARATOR
Default separator for splitting a String: a comma (",")
|
| Constructor and Description |
|---|
StringArrayPropertyEditor()
Create a new StringArrayPropertyEditor with the default separator
(a comma).
|
StringArrayPropertyEditor(java.lang.String separator)
Create a new StringArrayPropertyEditor with the given separator.
|
StringArrayPropertyEditor(java.lang.String separator,
boolean emptyArrayAsNull)
Create a new StringArrayPropertyEditor with the given separator.
|
StringArrayPropertyEditor(java.lang.String separator,
boolean emptyArrayAsNull,
boolean trimValues)
Create a new StringArrayPropertyEditor with the given separator.
|
StringArrayPropertyEditor(java.lang.String separator,
java.lang.String charsToDelete,
boolean emptyArrayAsNull)
Create a new StringArrayPropertyEditor with the given separator.
|
StringArrayPropertyEditor(java.lang.String separator,
java.lang.String charsToDelete,
boolean emptyArrayAsNull,
boolean trimValues)
Create a new StringArrayPropertyEditor with the given separator.
|
| Modifier and Type | Method and Description |
|---|---|
java.lang.String |
getAsText() |
void |
setAsText(java.lang.String text) |
public static final java.lang.String DEFAULT_SEPARATOR
public StringArrayPropertyEditor()
An empty text (without elements) will be turned into an empty array.
public StringArrayPropertyEditor(java.lang.String separator)
An empty text (without elements) will be turned into an empty array.
separator - the separator to use for splitting a Stringpublic StringArrayPropertyEditor(java.lang.String separator,
boolean emptyArrayAsNull)
separator - the separator to use for splitting a StringemptyArrayAsNull - true if an empty String array
is to be transformed into nullpublic StringArrayPropertyEditor(java.lang.String separator,
boolean emptyArrayAsNull,
boolean trimValues)
separator - the separator to use for splitting a StringemptyArrayAsNull - true if an empty String array
is to be transformed into nulltrimValues - true if the values in the parsed arrays
are to be trimmed of whitespace (default is true).public StringArrayPropertyEditor(java.lang.String separator,
java.lang.String charsToDelete,
boolean emptyArrayAsNull)
separator - the separator to use for splitting a StringcharsToDelete - a set of characters to delete, in addition to
trimming an input String. Useful for deleting unwanted line breaks:
e.g. "\r\n\f" will delete all new lines and line feeds in a String.emptyArrayAsNull - true if an empty String array
is to be transformed into nullpublic StringArrayPropertyEditor(java.lang.String separator,
java.lang.String charsToDelete,
boolean emptyArrayAsNull,
boolean trimValues)
separator - the separator to use for splitting a StringcharsToDelete - a set of characters to delete, in addition to
trimming an input String. Useful for deleting unwanted line breaks:
e.g. "\r\n\f" will delete all new lines and line feeds in a String.emptyArrayAsNull - true if an empty String array
is to be transformed into nulltrimValues - true if the values in the parsed arrays
are to be trimmed of whitespace (default is true).public void setAsText(java.lang.String text)
throws java.lang.IllegalArgumentException
setAsText in interface java.beans.PropertyEditorsetAsText in class java.beans.PropertyEditorSupportjava.lang.IllegalArgumentExceptionpublic java.lang.String getAsText()
getAsText in interface java.beans.PropertyEditorgetAsText in class java.beans.PropertyEditorSupport