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 |
---|---|
private java.lang.String |
charsToDelete |
static java.lang.String |
DEFAULT_SEPARATOR
Default separator for splitting a String: a comma (",")
|
private boolean |
emptyArrayAsNull |
private java.lang.String |
separator |
private boolean |
trimValues |
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
private final java.lang.String separator
private final java.lang.String charsToDelete
private final boolean emptyArrayAsNull
private final boolean trimValues
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 String
public StringArrayPropertyEditor(java.lang.String separator, boolean emptyArrayAsNull)
separator
- the separator to use for splitting a String
emptyArrayAsNull
- true
if an empty String array
is to be transformed into null
public StringArrayPropertyEditor(java.lang.String separator, boolean emptyArrayAsNull, boolean trimValues)
separator
- the separator to use for splitting a String
emptyArrayAsNull
- true
if an empty String array
is to be transformed into null
trimValues
- true
if the values in the parsed arrays
are to be 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 String
charsToDelete
- 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 null
public StringArrayPropertyEditor(java.lang.String separator, java.lang.String charsToDelete, boolean emptyArrayAsNull, boolean trimValues)
separator
- the separator to use for splitting a String
charsToDelete
- 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 null
trimValues
- true
if the values in the parsed arrays
are to be be trimmed of whitespace (default is true).public void setAsText(java.lang.String text) throws java.lang.IllegalArgumentException
setAsText
in interface java.beans.PropertyEditor
setAsText
in class java.beans.PropertyEditorSupport
java.lang.IllegalArgumentException
public java.lang.String getAsText()
getAsText
in interface java.beans.PropertyEditor
getAsText
in class java.beans.PropertyEditorSupport