public class StringArrayPropertyEditor extends 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 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(String separator)
Create a new StringArrayPropertyEditor with the given separator.
|
StringArrayPropertyEditor(String separator,
boolean emptyArrayAsNull)
Create a new StringArrayPropertyEditor with the given separator.
|
StringArrayPropertyEditor(String separator,
boolean emptyArrayAsNull,
boolean trimValues)
Create a new StringArrayPropertyEditor with the given separator.
|
StringArrayPropertyEditor(String separator,
String charsToDelete,
boolean emptyArrayAsNull)
Create a new StringArrayPropertyEditor with the given separator.
|
StringArrayPropertyEditor(String separator,
String charsToDelete,
boolean emptyArrayAsNull,
boolean trimValues)
Create a new StringArrayPropertyEditor with the given separator.
|
Modifier and Type | Method and Description |
---|---|
String |
getAsText() |
void |
setAsText(String text) |
addPropertyChangeListener, firePropertyChange, getCustomEditor, getJavaInitializationString, getSource, getTags, getValue, isPaintable, paintValue, removePropertyChangeListener, setSource, setValue, supportsCustomEditor
public static final String DEFAULT_SEPARATOR
public StringArrayPropertyEditor()
An empty text (without elements) will be turned into an empty array.
public StringArrayPropertyEditor(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(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(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 trimmed of whitespace (default is true).public StringArrayPropertyEditor(String separator, @Nullable 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(String separator, @Nullable 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 trimmed of whitespace (default is true).public void setAsText(String text) throws IllegalArgumentException
setAsText
in interface PropertyEditor
setAsText
in class PropertyEditorSupport
IllegalArgumentException
public String getAsText()
getAsText
in interface PropertyEditor
getAsText
in class PropertyEditorSupport