Attachment #149314 for bug #183055

View | Details | Raw Unified | Return to bug 183055 | Differences between

and this patch




 *
 * Contributors:
 *     IBM Corporation - initial API and implementation
 *     Ovidio Mallo - bug 183055
 *******************************************************************************/

package org.eclipse.core.internal.databinding.conversion;

				.getErrorIndex() : position.getIndex();

		if (errorIndex < value.length()) {
			return BindingMessages.getFormattedString(BindingMessages.VALIDATE_NUMBER_PARSE_ERROR,
					new Object[] { value, new Integer(errorIndex + 1),
							new Character(value.charAt(errorIndex)) });
		}
		return BindingMessages.getFormattedString(BindingMessages.VALIDATE_NUMBER_PARSE_ERROR_NO_CHARACTER,
				new Object[] { value, new Integer(errorIndex + 1) });
	}


	 */
	public static String createOutOfRangeMessage(Number minValue,
			Number maxValue, NumberFormat numberFormat) {
		return createOutOfRangeMessage(
				BindingMessages.getString(BindingMessages.VALIDATE_NUMBER_OUT_OF_RANGE_ERROR), minValue, maxValue, numberFormat);
	}

	/**
	 * Formats an appropriate message for an out of range error.
	 * 
	 * @param message
	 * @param minValue
	 * @param maxValue
	 * @param numberFormat
	 *            when accessed method synchronizes on instance
	 * @return message
	 */
	public static String createOutOfRangeMessage(String message,
			Number minValue, Number maxValue, NumberFormat numberFormat) {
		String min = null;
		String max = null;


			max = numberFormat.format(maxValue);
		}

		return BindingMessages.formatMessage(message, new Object[] { min,
				max });
	}

	/**




 * Contributors:
 *     db4objects - Initial API and implementation
 *     Tom Schindl<tom.schindl@bestsolution.at> - bugfix for 217940
 *     Ovidio Mallo - bug 183055
 */
package org.eclipse.core.internal.databinding.conversion;


 * StringToBooleanPrimitiveConverter.
 */
public class StringToBooleanPrimitiveConverter implements IConverter {
	private static final String[] trueValues;

	private static final String[] DEFAULT_TRUE_VALUES;
	private static final String[] DEFAULT_FALSE_VALUES;

	static {
		String delimiter = BindingMessages.getString(BindingMessages.VALUE_DELIMITER);
		String values = BindingMessages.getString(BindingMessages.TRUE_STRING_VALUES);
		DEFAULT_TRUE_VALUES = valuesToSortedArray(delimiter, values);

		values = BindingMessages.getString(BindingMessages.FALSE_STRING_VALUES);
		DEFAULT_FALSE_VALUES = valuesToSortedArray(delimiter, values);
	}

	private String[] trueValues = DEFAULT_TRUE_VALUES;
	private String[] falseValues = DEFAULT_FALSE_VALUES;

	/**
	 * Returns a sorted array with all values converted to upper case.
	 *

		return array;
	}

	/**
	 * Sets the string values which are considered to represent a
	 * <code>true</code> and <code>false</code> value, respectively.
	 * 
	 * <p>
	 * Note that the capitalization of the provided strings is ignored.
	 * </p>
	 * 
	 * @param trueValues
	 *            The set of strings representing a <code>true</code> value.
	 * @param falseValues
	 *            The set of strings representing a <code>false</code> value.
	 */
	public final void setSourceStrings(String[] trueValues, String[] falseValues) {
		this.trueValues = new String[trueValues.length];
		for (int i = 0; i < trueValues.length; i++) {
			this.trueValues[i] = trueValues[i].toUpperCase();
		}
		Arrays.sort(this.trueValues); // for binary search

		this.falseValues = new String[falseValues.length];
		for (int i = 0; i < falseValues.length; i++) {
			this.falseValues[i] = falseValues[i].toUpperCase();
		}
		Arrays.sort(this.falseValues); // for binary search
	}

	/*
	 * (non-Javadoc)
	 *




 *     db4objects - Initial API and implementation
 *     Tom Schindl<tom.schindl@bestsolution.at> - bugfix for 217940
 *     Matthew Hall - bug 121110
 *     Ovidio Mallo - bug 183055
 ******************************************************************************/
package org.eclipse.core.internal.databinding.conversion;


	};

	/**
	 * Sets the {@link DateFormat}s to be used for parsing/formatting dates. Any
	 * of the supplied formats will be used for {@link #parse(String) parsing} a
	 * date from a string while the first format in the array will be used for
	 * {@link #format(Date) formatting} a date as a string.
	 * 
	 * @param formatters
	 *            The {@link DateFormat}s to be used for parsing/formatting
	 *            dates.
	 */
	public final void setFormatters(DateFormat[] formatters) {
		this.formatters = formatters;
	}

	/**
	 * Tries all available formatters to parse the given string according to the
	 * default locale or as a raw millisecond value and returns the result of the
	 * first successful run.

Lines 1-4 Link Here

(-).settings/org.eclipse.jdt.ui.prefs (-2 / +2 lines)
1	#Tue Feb 10 16:05:48 MST 2009	1	#Mon Sep 21 22:46:47 CEST 2009
2	cleanup.add_default_serial_version_id=true	2	cleanup.add_default_serial_version_id=true
3	cleanup.add_generated_serial_version_id=false	3	cleanup.add_generated_serial_version_id=false
4	cleanup.add_missing_annotations=true	4	cleanup.add_missing_annotations=true
Lines 78-84 Link Here
78	sp_cleanup.always_use_this_for_non_static_method_access=false	78	sp_cleanup.always_use_this_for_non_static_method_access=false
79	sp_cleanup.convert_to_enhanced_for_loop=false	79	sp_cleanup.convert_to_enhanced_for_loop=false
80	sp_cleanup.correct_indentation=false	80	sp_cleanup.correct_indentation=false
81	sp_cleanup.format_source_code=true	81	sp_cleanup.format_source_code=false
82	sp_cleanup.format_source_code_changes_only=false	82	sp_cleanup.format_source_code_changes_only=false
83	sp_cleanup.make_local_variable_final=false	83	sp_cleanup.make_local_variable_final=false
84	sp_cleanup.make_parameters_final=false	84	sp_cleanup.make_parameters_final=false




 *     IBM Corporation - initial API and implementation
 *     Matt Carter - bug 180392
 *                 - bug 197679 (Character support completed)
 *     Ovidio Mallo - bug 183055
 *******************************************************************************/

package org.eclipse.core.databinding;

import org.eclipse.core.databinding.util.Policy;
import org.eclipse.core.internal.databinding.ClassLookupSupport;
import org.eclipse.core.internal.databinding.Pair;
import org.eclipse.core.internal.databinding.conversion.BooleanToStringConverter;
import org.eclipse.core.internal.databinding.conversion.CharacterToStringConverter;
import org.eclipse.core.internal.databinding.conversion.IdentityConverter;
import org.eclipse.core.internal.databinding.conversion.IntegerToStringConverter;

import org.eclipse.core.internal.databinding.conversion.NumberToIntegerConverter;
import org.eclipse.core.internal.databinding.conversion.NumberToLongConverter;
import org.eclipse.core.internal.databinding.conversion.NumberToShortConverter;
import org.eclipse.core.internal.databinding.conversion.ObjectToStringConverter;
import org.eclipse.core.internal.databinding.conversion.StringToByteConverter;
import org.eclipse.core.internal.databinding.conversion.StringToCharacterConverter;
import org.eclipse.core.internal.databinding.conversion.StringToShortConverter;

							new Pair(BOOLEAN_CLASS, "java.lang.Boolean"), new IdentityConverter(Boolean.class, Boolean.class)); //$NON-NLS-1$
			converterMap
					.put(
							new Pair(BOOLEAN_CLASS, "java.lang.String"), new BooleanToStringConverter(Boolean.class)); //$NON-NLS-1$
			converterMap
					.put(
							new Pair(BOOLEAN_CLASS, "java.lang.Object"), new IdentityConverter(Boolean.class, Object.class)); //$NON-NLS-1$

Lines 8-13 Link Here

(-)src/org/eclipse/core/internal/databinding/validation/StringToDateValidator.java (-8 / +24 lines)
8	* Contributors:	8	* Contributors:
9	* IBM Corporation - initial API and implementation	9	* IBM Corporation - initial API and implementation
10	* Tom Schindl<tom.schindl@bestsolution.at> - bugfix for 217940	10	* Tom Schindl<tom.schindl@bestsolution.at> - bugfix for 217940
		11	* Ovidio Mallo - bug 183055
11	*******************************************************************************/	12	*******************************************************************************/
12		13
13	package org.eclipse.core.internal.databinding.validation;	14	package org.eclipse.core.internal.databinding.validation;
Lines 28-33 Link Here
28	public class StringToDateValidator implements IValidator {	29	public class StringToDateValidator implements IValidator {
29	private final StringToDateConverter converter;	30	private final StringToDateConverter converter;
30		31
		32	private String parseErrorMessage = null;
		33
31	/**	34	/**
32	* @param converter	35	* @param converter
33	*/	36	*/
Lines 35-40 Link Here
35	this.converter = converter;	38	this.converter = converter;
36	}	39	}
37		40
		41	/**
		42	* Sets the validation message to be used in case the source string does not
		43	* represent a valid date.
		44	*
		45	* @param message
		46	* The validation message to be used in case the source string
		47	* does not represent a valid date.
		48	*/
		49	public final void setParseErrorMessage(String message) {
		50	this.parseErrorMessage = message;
		51	}
		52
38	/*	53	/*
39	* (non-Javadoc)	54	* (non-Javadoc)
40	*	55	*
Lines 47-64 Link Here
47	Object convertedValue = converter.convert(value);	62	Object convertedValue = converter.convert(value);
48	//The StringToDateConverter returns null if it can't parse the date.	63	//The StringToDateConverter returns null if it can't parse the date.
49	if (convertedValue == null) {	64	if (convertedValue == null) {
50	return ValidationStatus.error(getErrorMessage());	65	return ValidationStatus.error(getParseErrorMessage());
51	}	66	}
52		67
53	return Status.OK_STATUS;	68	return Status.OK_STATUS;
54	}	69	}
55		70
56	/*	71	private String getParseErrorMessage() {
57	* (non-Javadoc)	72	if (parseErrorMessage != null) {
58	*	73	return parseErrorMessage;
59	* @see org.eclipse.core.internal.databinding.validation.WrappedConverterValidator#getErrorMessage()	74	}
60	*/	75
61	protected String getErrorMessage() {
62	Date sampleDate = new Date();	76	Date sampleDate = new Date();
63		77
64	// FIXME We need to use the information from the	78	// FIXME We need to use the information from the
Lines 73-79 Link Here
73	samples.append('\'');	87	samples.append('\'');
74	samples.append(util.format(sampleDate, 0));	88	samples.append(util.format(sampleDate, 0));
75	samples.append('\'');	89	samples.append('\'');
76	return BindingMessages.getString(BindingMessages.EXAMPLES) + ": " + samples + ",..."; //$NON-NLS-1$//$NON-NLS-2$	90	parseErrorMessage = BindingMessages.getString(BindingMessages.EXAMPLES) + ": " + samples + ",..."; //$NON-NLS-1$//$NON-NLS-2$
		91
		92	return parseErrorMessage;
77	}	93	}
78		94
79	private static class FormatUtil extends DateConversionSupport {	95	private static class FormatUtil extends DateConversionSupport {

Lines 7-18 Link Here

(-)src/org/eclipse/core/internal/databinding/validation/AbstractStringToNumberValidator.java (-9 / +56 lines)
7	*	7	*
8	* Contributors:	8	* Contributors:
9	* IBM Corporation - initial API and implementation	9	* IBM Corporation - initial API and implementation
		10	* Ovidio Mallo - bug 183055
10	******************************************************************************/	11	******************************************************************************/
11		12
12	package org.eclipse.core.internal.databinding.validation;	13	package org.eclipse.core.internal.databinding.validation;
13		14
		15	import java.text.ParsePosition;
		16
14	import org.eclipse.core.databinding.validation.IValidator;	17	import org.eclipse.core.databinding.validation.IValidator;
15	import org.eclipse.core.databinding.validation.ValidationStatus;	18	import org.eclipse.core.databinding.validation.ValidationStatus;
		19	import org.eclipse.core.internal.databinding.BindingMessages;
16	import org.eclipse.core.internal.databinding.conversion.StringToNumberParser;	20	import org.eclipse.core.internal.databinding.conversion.StringToNumberParser;
17	import org.eclipse.core.internal.databinding.conversion.StringToNumberParser.ParseResult;	21	import org.eclipse.core.internal.databinding.conversion.StringToNumberParser.ParseResult;
18	import org.eclipse.core.runtime.IStatus;	22	import org.eclipse.core.runtime.IStatus;
Lines 31-37 Link Here
31	private final Number min;	35	private final Number min;
32	private final Number max;	36	private final Number max;
33		37
34	private String outOfRangeMessage;	38	private String parseErrorMessage;
		39
		40	private String outOfRangeMessage = BindingMessages.getString(BindingMessages.VALIDATE_NUMBER_OUT_OF_RANGE_ERROR);
		41	private String formattedOutOfRangeMessage;
35		42
36	/**	43	/**
37	* Constructs a new instance.	44	* Constructs a new instance.
Lines 55-60 Link Here
55	}	62	}
56		63
57	/**	64	/**
		65	* Sets the validation message pattern to be used in case the source string
		66	* does not represent a valid number.
		67	*
		68	* @param message
		69	* The validation message pattern to be used in case the source
		70	* string does not represent a valid number.
		71	*/
		72	public final void setParseErrorMessage(String message) {
		73	this.parseErrorMessage = message;
		74	}
		75
		76	/**
		77	* Sets the validation message pattern to be used in case the parsed number
		78	* lies outside the value range supported by the number type associated to
		79	* this validator.
		80	*
		81	* @param message
		82	* The validation message pattern to be used in case the parsed
		83	* number lies outside the supported value range. Can be
		84	* parameterized by the <code>Integer.MIN_VALUE</code> and
		85	* <code>Integer.MAX_VALUE</code> values.
		86	*/
		87	public final void setOutOfRangeMessage(String message) {
		88	this.outOfRangeMessage = message;
		89	this.formattedOutOfRangeMessage = null;
		90	}
		91
		92	/**
58	* Validates the provided <code>value</code>. An error status is returned if:	93	* Validates the provided <code>value</code>. An error status is returned if:
59	* <ul>	94	* <ul>
60	* <li>The value cannot be parsed.</li>	95	* <li>The value cannot be parsed.</li>
Lines 69-84 Link Here
69		104
70	if (result.getNumber() != null) {	105	if (result.getNumber() != null) {
71	if (!isInRange(result.getNumber())) {	106	if (!isInRange(result.getNumber())) {
72	if (outOfRangeMessage == null) {	107	return ValidationStatus.error(getFormattedOutOfRangeMessage());
73	outOfRangeMessage = StringToNumberParser
74	.createOutOfRangeMessage(min, max, converter
75	.getNumberFormat());
76	}
77
78	return ValidationStatus.error(outOfRangeMessage);
79	}	108	}
80	} else if (result.getPosition() != null) {	109	} else if (result.getPosition() != null) {
81	String parseErrorMessage = StringToNumberParser.createParseErrorMessage(	110	String parseErrorMessage = createParseErrorMessage(
82	(String) value, result.getPosition());	111	(String) value, result.getPosition());
83		112
84	return ValidationStatus.error(parseErrorMessage);	113	return ValidationStatus.error(parseErrorMessage);
Lines 94-97 Link Here
94	* @return <code>true</code> if in range	123	* @return <code>true</code> if in range
95	*/	124	*/
96	protected abstract boolean isInRange(Number number);	125	protected abstract boolean isInRange(Number number);
		126
		127	private String createParseErrorMessage(String input,
		128	ParsePosition parsePosition) {
		129	if (parseErrorMessage == null) {
		130	return StringToNumberParser.createParseErrorMessage(input,
		131	parsePosition);
		132	}
		133	return parseErrorMessage;
		134	}
		135
		136	private String getFormattedOutOfRangeMessage() {
		137	if (formattedOutOfRangeMessage == null) {
		138	formattedOutOfRangeMessage = StringToNumberParser
		139	.createOutOfRangeMessage(outOfRangeMessage, min, max,
		140	converter.getNumberFormat());
		141	}
		142	return formattedOutOfRangeMessage;
		143	}
97	}	144	}

Lines 8-14 Link Here

(-)META-INF/MANIFEST.MF (+2 lines)
8	Bundle-Localization: plugin	8	Bundle-Localization: plugin
9	Export-Package: org.eclipse.core.databinding,	9	Export-Package: org.eclipse.core.databinding,
10	org.eclipse.core.databinding.conversion;x-internal:=false,	10	org.eclipse.core.databinding.conversion;x-internal:=false,
		11	org.eclipse.core.databinding.editing,
11	org.eclipse.core.databinding.validation;x-internal:=false,	12	org.eclipse.core.databinding.validation;x-internal:=false,
		13	org.eclipse.core.databinding.validation.constraint,
12	org.eclipse.core.internal.databinding;x-friends:="org.eclipse.core.databinding.beans",	14	org.eclipse.core.internal.databinding;x-friends:="org.eclipse.core.databinding.beans",
13	org.eclipse.core.internal.databinding.conversion;x-friends:="org.eclipse.jface.tests.databinding",	15	org.eclipse.core.internal.databinding.conversion;x-friends:="org.eclipse.jface.tests.databinding",
14	org.eclipse.core.internal.databinding.validation;x-friends:="org.eclipse.jface.tests.databinding"	16	org.eclipse.core.internal.databinding.validation;x-friends:="org.eclipse.jface.tests.databinding"

Lines 8-13 Link Here

(-)src/org/eclipse/core/internal/databinding/BindingMessages.java (-4 / +111 lines)
8	* Contributors:	8	* Contributors:
9	* IBM Corporation - initial API and implementation	9	* IBM Corporation - initial API and implementation
10	* Tom Schindl<tom.schindl@bestsolution.at> - bugfix for 217940	10	* Tom Schindl<tom.schindl@bestsolution.at> - bugfix for 217940
		11	* Ovidio Mallo - bug 183055
11	*******************************************************************************/	12	*******************************************************************************/
12	package org.eclipse.core.internal.databinding;	13	package org.eclipse.core.internal.databinding;
13		14
Lines 69-74 Link Here
69	public static final String FALSE_STRING_VALUES = "FalseStringValues"; //$NON-NLS-1$	70	public static final String FALSE_STRING_VALUES = "FalseStringValues"; //$NON-NLS-1$
70		71
71	/**	72	/**
		73	* Key to be used for a "Validate_InvalidBooleanString" message
		74	*/
		75	public static final String VALIDATE_INVALID_BOOLEAN_STRING = "Validate_InvalidBooleanString"; //$NON-NLS-1$
		76
		77	/**
72	* Key to be used for a "Validate_NumberOutOfRangeError" message	78	* Key to be used for a "Validate_NumberOutOfRangeError" message
73	*/	79	*/
74	public static final String VALIDATE_NUMBER_OUT_OF_RANGE_ERROR = "Validate_NumberOutOfRangeError"; //$NON-NLS-1$	80	public static final String VALIDATE_NUMBER_OUT_OF_RANGE_ERROR = "Validate_NumberOutOfRangeError"; //$NON-NLS-1$
Lines 109-118 Link Here
109	public static final String VALIDATE_NUMBER_PARSE_ERROR_NO_CHARACTER = "Validate_NumberParseErrorNoCharacter"; //$NON-NLS-1$	115	public static final String VALIDATE_NUMBER_PARSE_ERROR_NO_CHARACTER = "Validate_NumberParseErrorNoCharacter"; //$NON-NLS-1$
110		116
111	/**	117	/**
		118	* Key to be used for a "Validate_NonNull" message
		119	*/
		120	public static final String VALIDATE_NON_NULL = "Validate_NonNull"; //$NON-NLS-1$
		121
		122	/**
		123	* Key to be used for a "Validate_NonEmptyString" message
		124	*/
		125	public static final String VALIDATE_NON_EMPTY_STRING = "Validate_NonEmptyString"; //$NON-NLS-1$
		126
		127	/**
		128	* Key to be used for a "Validate_NonStringRegex" message
		129	*/
		130	public static final String VALIDATE_STRING_REGEX = "Validate_NonStringRegex"; //$NON-NLS-1$
		131
		132	/**
		133	* Key to be used for a "Validate_NumberRangeGreater" message
		134	*/
		135	public static final String VALIDATE_NUMBER_RANGE_GREATER = "Validate_NumberRangeGreater"; //$NON-NLS-1$
		136
		137	/**
		138	* Key to be used for a "Validate_NumberRangeGreaterEqual" message
		139	*/
		140	public static final String VALIDATE_NUMBER_RANGE_GREATER_EQUAL = "Validate_NumberRangeGreaterEqual"; //$NON-NLS-1$
		141
		142	/**
		143	* Key to be used for a "Validate_NumberRangeLess" message
		144	*/
		145	public static final String VALIDATE_NUMBER_RANGE_LESS = "Validate_NumberRangeLess"; //$NON-NLS-1$
		146
		147	/**
		148	* Key to be used for a "Validate_NumberRangeLessEqual" message
		149	*/
		150	public static final String VALIDATE_NUMBER_RANGE_LESS_EQUAL = "Validate_NumberRangeLessEqual"; //$NON-NLS-1$
		151
		152	/**
		153	* Key to be used for a "Validate_NumberRangeWithinRange" message
		154	*/
		155	public static final String VALIDATE_NUMBER_RANGE_WITHIN_RANGE = "Validate_NumberRangeWithinRange"; //$NON-NLS-1$
		156
		157	/**
		158	* Key to be used for a "Validate_NumberRangePositive" message
		159	*/
		160	public static final String VALIDATE_NUMBER_RANGE_POSITIVE = "Validate_NumberRangePositive"; //$NON-NLS-1$
		161
		162	/**
		163	* Key to be used for a "Validate_NumberRangeNonNegative" message
		164	*/
		165	public static final String VALIDATE_NUMBER_RANGE_NON_NEGATIVE = "Validate_NumberRangeNonNegative"; //$NON-NLS-1$
		166
		167	/**
		168	* Key to be used for a "Validate_DateRangeAfter" message
		169	*/
		170	public static final String VALIDATE_DATE_RANGE_AFTER = "Validate_DateRangeAfter"; //$NON-NLS-1$
		171
		172	/**
		173	* Key to be used for a "Validate_DateRangeAfterEqual" message
		174	*/
		175	public static final String VALIDATE_DATE_RANGE_AFTER_EQUAL = "Validate_DateRangeAfterEqual"; //$NON-NLS-1$
		176
		177	/**
		178	* Key to be used for a "Validate_DateRangeBefore" message
		179	*/
		180	public static final String VALIDATE_DATE_RANGE_BEFORE = "Validate_DateRangeBefore"; //$NON-NLS-1$
		181
182	/**
183	* Key to be used for a "Validate_DateRangeBeforeEqual" message
184	*/
185	public static final String VALIDATE_DATE_RANGE_BEFORE_EQUAL = "Validate_DateRangeBeforeEqual"; //$NON-NLS-1$
186
187	/**
188	* Key to be used for a "Validate_DateRangeWithinRange" message
189	*/
190	public static final String VALIDATE_DATE_RANGE_WITHIN_RANGE = "Validate_DateRangeWithinRange"; //$NON-NLS-1$
191
192	/**
193	* Key to be used for a "Validate_StringLengthMin" message
194	*/
195	public static final String VALIDATE_STRING_LENGTH_MIN = "Validate_StringLengthMin"; //$NON-NLS-1$
196
197	/**
198	* Key to be used for a "Validate_StringLengthMax" message
199	*/
200	public static final String VALIDATE_STRING_LENGTH_MAX = "Validate_StringLengthMax"; //$NON-NLS-1$
201
202	/**
203	* Key to be used for a "Validate_StringLengthRange" message
204	*/
205	public static final String VALIDATE_STRING_LENGTH_RANGE = "Validate_StringLengthRange"; //$NON-NLS-1$
206
207	/**
112	* Returns the resource object with the given key in the resource bundle for	208	* Returns the resource object with the given key in the resource bundle for
113	* JFace Data Binding. If there isn't any value under the given key, the key	209	* JFace Data Binding. If there isn't any value under the given key, the key
114	* is returned.	210	* is returned.
115	*	211	*
116	* @param key	212	* @param key
117	* the resource name	213	* the resource name
118	* @return the string	214	* @return the string
Lines 128-143 Link Here
128	/**	224	/**
129	* Returns a formatted string with the given key in the resource bundle for	225	* Returns a formatted string with the given key in the resource bundle for
130	* JFace Data Binding.	226	* JFace Data Binding.
131	*	227	*
132	* @param key	228	* @param key
133	* @param arguments	229	* @param arguments
134	* @return formatted string, the key if the key is invalid	230	* @return formatted string, the key if the key is invalid
135	*/	231	*/
136	public static String formatString(String key, Object[] arguments) {	232	public static String getFormattedString(String key, Object[] arguments) {
137	try {	233	try {
138	return MessageFormat.format(bundle.getString(key), arguments);	234	return formatMessage(getString(key), arguments);
139	} catch (MissingResourceException e) {	235	} catch (MissingResourceException e) {
140	return key;	236	return key;
141	}	237	}
142	}	238	}
		239
		240	/**
		241	* Formats the given message pattern with the provided arguments.
		242	*
		243	* @param pattern
		244	* @param arguments
		245	* @return formatted string
		246	*/
		247	public static String formatMessage(String pattern, Object[] arguments) {
		248	return MessageFormat.format(pattern, arguments);
		249	}
143	}	250	}

Lines 43-48 Link Here

(-)src/org/eclipse/core/internal/databinding/messages.properties (+32 lines)
43	TrueStringValues=yes,true	43	TrueStringValues=yes,true
44	FalseStringValues=no,false	44	FalseStringValues=no,false
45		45
		46	Validate_InvalidBooleanString=The boolean string is invalid.
		47
46	Validate_NumberOutOfRangeError=Please enter a value between [{0}] and [{1}] and with a similar format.	48	Validate_NumberOutOfRangeError=Please enter a value between [{0}] and [{1}] and with a similar format.
47	Validate_NumberParseError=Invalid character for value [{0}] at position [{1}] character [{2}].	49	Validate_NumberParseError=Invalid character for value [{0}] at position [{1}] character [{2}].
48	Validate_NumberParseErrorNoCharacter=Missing character for value [{0}] at position [{1}].	50	Validate_NumberParseErrorNoCharacter=Missing character for value [{0}] at position [{1}].
Lines 53-56 Link Here
53	Validate_NoChangeAllowedHelp=Changes are not allowed in this field	55	Validate_NoChangeAllowedHelp=Changes are not allowed in this field
54	Validate_CharacterHelp=Please type a character	56	Validate_CharacterHelp=Please type a character
55		57
		58	#NonNullValidator
		59	Validate_NonNull=The value must not be empty.
		60
		61	#NonEmptyStringValidator
		62	Validate_NonEmptyString=The string must not be empty.
		63
		64	#StringRegexValidator
		65	Validate_NonStringRegex=The string must match the following pattern: {0}.
		66
		67	#NumberRangeValidator
		68	Validate_NumberRangeGreater=The value must be greater than {0}.
		69	Validate_NumberRangeGreaterEqual=The value must be greater than or equal to {0}.
		70	Validate_NumberRangeLess=The value must be less than {0}.
		71	Validate_NumberRangeLessEqual=The value must be less than or equal to {0}.
		72	Validate_NumberRangeWithinRange=The value must lie between {0} and {1}.
		73	Validate_NumberRangePositive=The value must be positive.
		74	Validate_NumberRangeNonNegative=The value must not be negative.
		75
		76	#DateRangeValidator
		77	Validate_DateRangeAfter=The date must be after {0}.
		78	Validate_DateRangeAfterEqual=The date must be after or on {0}.
		79	Validate_DateRangeBefore=The date must be before {0}.
		80	Validate_DateRangeBeforeEqual=The date must be before or on {0}.
		81	Validate_DateRangeWithinRange=The date must lie between {0} and {1}.
		82
		83	#StringLengthValidator
		84	Validate_StringLengthMin=The string must have at least {0} characters.
		85	Validate_StringLengthMax=The string must not have more than {0} characters.
		86	Validate_StringLengthRange=The string must have between {0} and {1} characters.
		87
56	Examples=Examples	88	Examples=Examples




/*******************************************************************************
 * Copyright (c) 2009 Ovidio Mallo and others.
 * All rights reserved. This program and the accompanying materials
 * are made available under the terms of the Eclipse Public License v1.0
 * which accompanies this distribution, and is available at
 * http://www.eclipse.org/legal/epl-v10.html
 *
 * Contributors:
 *     Ovidio Mallo - initial API and implementation (bug 183055)
 ******************************************************************************/

package org.eclipse.core.internal.databinding.validation;

import com.ibm.icu.text.NumberFormat;

/**
 * Provides validations for integers which must lie within an open/closed range.
 * 
 * @since 1.4
 */
public class IntegerRangeValidator extends NumberRangeValidator {

	private static final Integer ZERO = new Integer(0);
	private static final Integer ONE = new Integer(1);

	/**
	 * Single constructor which supports the individual integer range types.
	 * 
	 * @param min
	 *            The min integer of the range or <code>null</code> in case no
	 *            lower bound is defined.
	 * @param max
	 *            The max integer of the range or <code>null</code> in case no
	 *            upper bound is defined.
	 * @param minConstraint
	 *            The type of constraint imposed by the lower bound of the
	 *            range.
	 * @param maxConstraint
	 *            The type of constraint imposed by the upper bound of the
	 *            range.
	 * @param validationMessage
	 *            The validation message pattern to use. Can be parameterized by
	 *            the lower and upper bound of the range, if defined.
	 * @param format
	 *            The integer format to use for formatting integers in the
	 *            validation message.
	 */
	private IntegerRangeValidator(Number min, Number max, int minConstraint,
			int maxConstraint, String validationMessage, NumberFormat format) {
		super(min, max, minConstraint, maxConstraint, validationMessage, format);
	}

	/**
	 * Creates a validator which checks that an input integer is greater than
	 * the given number.
	 * 
	 * @param number
	 *            The reference number of the greater constraint.
	 * @param validationMessage
	 *            The validation message pattern to use. Can be parameterized
	 *            with the given reference number.
	 * @param format
	 *            The display format to use for formatting integers in the
	 *            validation message.
	 * @return The validator instance.
	 */
	public static IntegerRangeValidator greater(int number,
			String validationMessage, NumberFormat format) {
		return new IntegerRangeValidator(new Integer(number), null, GREATER,
				UNDEFINED, defaultIfNull(validationMessage, GREATER_MESSAGE),
				format);
	}

	/**
	 * Creates a validator which checks that an input integer is greater than or
	 * equal to the given number.
	 * 
	 * @param number
	 *            The reference number of the greater-equal constraint.
	 * @param validationMessage
	 *            The validation message pattern to use. Can be parameterized
	 *            with the given reference number.
	 * @param format
	 *            The display format to use for formatting integers in the
	 *            validation message.
	 * @return The validator instance.
	 */
	public static IntegerRangeValidator greaterEqual(int number,
			String validationMessage, NumberFormat format) {
		return new IntegerRangeValidator(new Integer(number), null,
				GREATER_EQUAL, UNDEFINED, defaultIfNull(validationMessage,
						GREATER_EQUAL_MESSAGE), format);
	}

	/**
	 * Creates a validator which checks that an input integer is less than the
	 * given number.
	 * 
	 * @param number
	 *            The reference number of the less constraint.
	 * @param validationMessage
	 *            The validation message pattern to use. Can be parameterized
	 *            with the given reference number.
	 * @param format
	 *            The display format to use for formatting integers in the
	 *            validation message.
	 * @return The validator instance.
	 */
	public static IntegerRangeValidator less(int number,
			String validationMessage, NumberFormat format) {
		return new IntegerRangeValidator(null, new Integer(number), UNDEFINED,
				LESS, defaultIfNull(validationMessage, LESS_MESSAGE), format);
	}

	/**
	 * Creates a validator which checks that an input integer is less than or
	 * equal to the given number.
	 * 
	 * @param number
	 *            The reference number of the less-equal constraint.
	 * @param validationMessage
	 *            The validation message pattern to use. Can be parameterized
	 *            with the given reference number.
	 * @param format
	 *            The display format to use for formatting integers in the
	 *            validation message.
	 * @return The validator instance.
	 */
	public static IntegerRangeValidator lessEqual(int number,
			String validationMessage, NumberFormat format) {
		return new IntegerRangeValidator(null, new Integer(number), UNDEFINED,
				LESS_EQUAL,
				defaultIfNull(validationMessage, LESS_EQUAL_MESSAGE), format);
	}

	/**
	 * Creates a validator which checks that an input integer is within the
	 * given range.
	 * 
	 * @param min
	 *            The lower bound of the range (inclusive).
	 * @param max
	 *            The upper bound of the range (inclusive).
	 * @param validationMessage
	 *            The validation message pattern to use. Can be parameterized
	 *            with the range's lower and upper bound.
	 * @param format
	 *            The display format to use for formatting integers in the
	 *            validation message.
	 * @return The validator instance.
	 */
	public static IntegerRangeValidator range(int min, int max,
			String validationMessage, NumberFormat format) {
		return new IntegerRangeValidator(new Integer(min), new Integer(max),
				GREATER_EQUAL, LESS_EQUAL, defaultIfNull(validationMessage,
						WITHIN_RANGE_MESSAGE), format);
	}

	/**
	 * Creates a validator which checks that an input integer is positive.
	 * 
	 * @param validationMessage
	 *            The validation message to use.
	 * @param format
	 *            The display format to use for formatting integers in the
	 *            validation message.
	 * @return The validator instance.
	 */
	public static IntegerRangeValidator positive(String validationMessage,
			NumberFormat format) {
		return new IntegerRangeValidator(ONE, null, GREATER_EQUAL, UNDEFINED,
				defaultIfNull(validationMessage, POSITIVE_MESSAGE), format);
	}

	/**
	 * Creates a validator which checks that an input integer is non-negative.
	 * 
	 * @param validationMessage
	 *            The validation message to use.
	 * @param format
	 *            The display format to use for formatting integers in the
	 *            validation message.
	 * @return The validator instance.
	 */
	public static IntegerRangeValidator nonNegative(String validationMessage,
			NumberFormat format) {
		return new IntegerRangeValidator(ZERO, null, GREATER_EQUAL, UNDEFINED,
				defaultIfNull(validationMessage, NON_NEGATIVE_MESSAGE), format);
	}

	protected int compare(Number number1, Number number2) {
		Integer integer1 = (Integer) number1;
		Integer integer2 = (Integer) number2;
		return integer1.compareTo(integer2);
	}

	private static String defaultIfNull(String string, String defaultString) {
		return (string != null) ? string : defaultString;
	}
}




/*******************************************************************************
 * Copyright (c) 2009 Ovidio Mallo and others.
 * All rights reserved. This program and the accompanying materials
 * are made available under the terms of the Eclipse Public License v1.0
 * which accompanies this distribution, and is available at
 * http://www.eclipse.org/legal/epl-v10.html
 *
 * Contributors:
 *     Ovidio Mallo - initial API and implementation (bug 183055)
 ******************************************************************************/

package org.eclipse.core.databinding.editing;

import org.eclipse.core.databinding.conversion.IConverter;
import org.eclipse.core.databinding.validation.constraint.Constraints;
import org.eclipse.core.databinding.validation.constraint.StringConstraints;
import org.eclipse.core.internal.databinding.conversion.StringStripConverter;
import org.eclipse.core.internal.databinding.conversion.StringTrimConverter;

/**
 * @since 1.4
 */
public final class StringEditing extends Editing {

	private StringEditing(IConverter targetConverter) {
		setTargetConverter(targetConverter);
	}

	/**
	 * Creates a new editing object for strings which performs no validation or
	 * conversion.
	 * 
	 * @return The new editing object which performs no validation or
	 *         conversion.
	 */
	public static StringEditing withDefaults() {
		return new StringEditing(null);
	}

	/**
	 * Creates a new editing object which strips whitespace from both ends of
	 * the input string.
	 * 
	 * @param stripToNull
	 *            Whether to convert the input string to <code>null</code> in
	 *            case stripping the input string results in an empty string.
	 * @return The new editing object which strips whitespace from both ends of
	 *         the input string.
	 * 
	 * @see Character#isWhitespace(char)
	 */
	public static StringEditing stripped(boolean stripToNull) {
		return new StringEditing(new StringStripConverter(stripToNull));
	}

	/**
	 * Creates a new editing object which {@link String#trim()}s the input
	 * string.
	 * 
	 * @param trimToNull
	 *            Whether to convert the input string to <code>null</code> in
	 *            case trimming the input string results in an empty string.
	 * @return The new editing object which trims whitespace from both ends of
	 *         the input string.
	 * 
	 * @see String#trim()
	 */
	public static StringEditing trimmed(boolean trimToNull) {
		return new StringEditing(new StringTrimConverter(trimToNull));
	}

	/**
	 * Returns the target constraints to apply.
	 * 
	 * <p>
	 * This method provides a typesafe access to the {@link StringConstraints
	 * string target constraints} of this editing object and is equivalent to
	 * {@code (StringConstraints) targetConstraints()}.
	 * </p>
	 * 
	 * @return The target constraints to apply.
	 * 
	 * @see #targetConstraints()
	 * @see StringConstraints
	 */
	public StringConstraints targetStringConstraints() {
		return (StringConstraints) targetConstraints();
	}

	/**
	 * Returns the model constraints to apply.
	 * 
	 * <p>
	 * This method provides a typesafe access to the {@link StringConstraints
	 * string model constraints} of this editing object and is equivalent to
	 * {@code (StringConstraints) modelConstraints()}.
	 * </p>
	 * 
	 * @return The target constraints to apply.
	 * 
	 * @see #modelConstraints()
	 * @see StringConstraints
	 */
	public StringConstraints modelStringConstraints() {
		return (StringConstraints) modelConstraints();
	}

	/**
	 * Returns the before-set model constraints to apply.
	 * 
	 * <p>
	 * This method provides a typesafe access to the {@link StringConstraints
	 * string before-set model constraints} of this editing object and is
	 * equivalent to {@code (StringConstraints) beforeSetModelConstraints()}.
	 * </p>
	 * 
	 * @return The target constraints to apply.
	 * 
	 * @see #beforeSetModelConstraints()
	 * @see StringConstraints
	 */
	public StringConstraints beforeSetModelStringConstraints() {
		return (StringConstraints) beforeSetModelConstraints();
	}

	protected Constraints createTargetConstraints() {
		return new StringConstraints();
	}

	protected Constraints createModelConstraints() {
		return new StringConstraints();
	}

	protected Constraints createBeforeSetModelConstraints() {
		return new StringConstraints();
	}

	/**
	 * Convenience method which adds a {@link StringConstraints#required()
	 * required constraint} to the set of {@link #modelStringConstraints()}.
	 * 
	 * @return This editing instance for method chaining.
	 * 
	 * @see StringConstraints#required()
	 * @see #modelStringConstraints()
	 */
	public StringEditing required() {
		modelStringConstraints().required();
		return this;
	}

	/**
	 * Convenience method which adds a {@link StringConstraints#nonEmpty()
	 * non-empty constraint} to the set of {@link #modelStringConstraints()}.
	 * 
	 * @return This editing instance for method chaining.
	 * 
	 * @see StringConstraints#nonEmpty()
	 * @see #modelStringConstraints()
	 */
	public StringEditing nonEmpty() {
		modelStringConstraints().nonEmpty();
		return this;
	}

	/**
	 * Convenience method which adds a {@link StringConstraints#minLength(int)
	 * min-length constraint} to the set of {@link #modelStringConstraints()}.
	 * 
	 * @param minLength
	 *            The min length of the min-length constraint.
	 * @return This editing instance for method chaining.
	 * 
	 * @see StringConstraints#minLength(int)
	 * @see #modelStringConstraints()
	 */
	public StringEditing minLength(int minLength) {
		modelStringConstraints().minLength(minLength);
		return this;
	}

	/**
	 * Convenience method which adds a {@link StringConstraints#maxLength(int)
	 * max-length constraint} to the set of {@link #modelStringConstraints()}.
	 * 
	 * @param maxLength
	 *            The max length of the max-length constraint.
	 * @return This editing instance for method chaining.
	 * 
	 * @see StringConstraints#maxLength(int)
	 * @see #modelStringConstraints()
	 */
	public StringEditing maxLength(int maxLength) {
		modelStringConstraints().maxLength(maxLength);
		return this;
	}

	/**
	 * Convenience method which adds a
	 * {@link StringConstraints#lengthRange(int, int) length-range constraint}
	 * to the set of {@link #modelStringConstraints()}.
	 * 
	 * @param minLength
	 *            The min length of the length-range constraint.
	 * @param maxLength
	 *            The max length of the length-range constraint.
	 * @return This editing instance for method chaining.
	 * 
	 * @see StringConstraints#lengthRange(int, int)
	 * @see #modelStringConstraints()
	 */
	public StringEditing lengthRange(int minLength, int maxLength) {
		modelStringConstraints().lengthRange(minLength, maxLength);
		return this;
	}

	/**
	 * Convenience method which adds a {@link StringConstraints#matches(String)
	 * matches constraint} to the set of {@link #modelStringConstraints()}.
	 * 
	 * @param regex
	 *            The regular expression of the matches constraint.
	 * @return This editing instance for method chaining.
	 * 
	 * @see StringConstraints#matches(String)
	 * @see #modelStringConstraints()
	 */
	public StringEditing matches(String regex) {
		modelStringConstraints().matches(regex);
		return this;
	}
}




/*******************************************************************************
 * Copyright (c) 2009 Ovidio Mallo and others.
 * All rights reserved. This program and the accompanying materials
 * are made available under the terms of the Eclipse Public License v1.0
 * which accompanies this distribution, and is available at
 * http://www.eclipse.org/legal/epl-v10.html
 *
 * Contributors:
 *     Ovidio Mallo - initial API and implementation (bug 183055)
 ******************************************************************************/

package org.eclipse.core.internal.databinding.validation;

import java.text.MessageFormat;

import org.eclipse.core.databinding.validation.IValidator;
import org.eclipse.core.databinding.validation.ValidationStatus;
import org.eclipse.core.internal.databinding.BindingMessages;
import org.eclipse.core.runtime.IStatus;

import com.ibm.icu.text.NumberFormat;

/**
 * Provides validations for numbers which must lie within an open/closed range.
 * 
 * @since 1.4
 */
public abstract class NumberRangeValidator implements IValidator {

	// The set of constraint types for the lower/upper bound of the date range.
	protected static final int UNDEFINED = -1;
	protected static final int GREATER = 0;
	protected static final int GREATER_EQUAL = 1;
	protected static final int LESS = 2;
	protected static final int LESS_EQUAL = 3;

	// The default validation messages.
	protected static final String GREATER_MESSAGE = BindingMessages.getString(BindingMessages.VALIDATE_NUMBER_RANGE_GREATER);
	protected static final String GREATER_EQUAL_MESSAGE = BindingMessages.getString(BindingMessages.VALIDATE_NUMBER_RANGE_GREATER_EQUAL);
	protected static final String LESS_MESSAGE = BindingMessages.getString(BindingMessages.VALIDATE_NUMBER_RANGE_LESS);
	protected static final String LESS_EQUAL_MESSAGE = BindingMessages.getString(BindingMessages.VALIDATE_NUMBER_RANGE_LESS_EQUAL);
	protected static final String WITHIN_RANGE_MESSAGE = BindingMessages.getString(BindingMessages.VALIDATE_NUMBER_RANGE_WITHIN_RANGE);
	protected static final String POSITIVE_MESSAGE = BindingMessages.getString(BindingMessages.VALIDATE_NUMBER_RANGE_POSITIVE);
	protected static final String NON_NEGATIVE_MESSAGE = BindingMessages.getString(BindingMessages.VALIDATE_NUMBER_RANGE_NON_NEGATIVE);

	private final Number min;
	private final Number max;
	private final int minConstraint;
	private final int maxConstraint;
	private final String validationMessage;
	private String formattedValidationMessage;
	private final NumberFormat format;

	/**
	 * Single constructor which supports the individual number range types.
	 * 
	 * @param min
	 *            The min number of the range or <code>null</code> in case no
	 *            lower bound is defined.
	 * @param max
	 *            The max number of the range or <code>null</code> in case no
	 *            upper bound is defined.
	 * @param minConstraint
	 *            The type of constraint imposed by the lower bound of the
	 *            range.
	 * @param maxConstraint
	 *            The type of constraint imposed by the upper bound of the
	 *            range.
	 * @param validationMessage
	 *            The validation message pattern to use. Can be parameterized by
	 *            the lower and upper bound of the range, if defined.
	 * @param format
	 *            The integer format to use for formatting numbers in the
	 *            validation message.
	 */
	protected NumberRangeValidator(Number min, Number max, int minConstraint,
			int maxConstraint, String validationMessage, NumberFormat format) {
		this.min = min;
		this.max = max;
		this.minConstraint = minConstraint;
		this.maxConstraint = maxConstraint;
		this.validationMessage = validationMessage;
		this.format = format;
	}

	public IStatus validate(Object value) {
		if (value != null) {
			Number number = (Number) value;
			if ((min != null && !fulfillsConstraint(number, min, minConstraint))
					|| (max != null && !fulfillsConstraint(number, max,
							maxConstraint))) {
				return ValidationStatus.error(getFormattedValidationMessage());
			}
		}
		return ValidationStatus.ok();
	}

	private boolean fulfillsConstraint(Number number1, Number number2,
			int constraint) {
		int compareResult = compare(number1, number2);
		switch (constraint) {
		case GREATER:
			return compareResult > 0;
		case GREATER_EQUAL:
			return compareResult >= 0;
		case LESS:
			return compareResult < 0;
		case LESS_EQUAL:
			return compareResult <= 0;
		case UNDEFINED:
		default:
			throw new IllegalArgumentException(
					"Unsupported constraint: " + constraint); //$NON-NLS-1$
		}
	}

	/**
	 * Comparator method to be implemented by subclasses in order to compare two
	 * instances of the concrete number type.
	 * 
	 * @param number1
	 *            The first number to compare.
	 * @param number2
	 *            The second number to compare.
	 * @return A negative number, zero, or a positive number in case the first
	 *         number is smaller than, equal to, or greater than the second
	 *         number, respectively.
	 */
	protected abstract int compare(Number number1, Number number2);

	private synchronized String getFormattedValidationMessage() {
		if (formattedValidationMessage == null) {
			formattedValidationMessage = MessageFormat.format(
					validationMessage, getValidationMessageArguments());
		}
		return formattedValidationMessage;
	}

	private String[] getValidationMessageArguments() {
		synchronized (format) {
			if (min == null) {
				return new String[] { format.format(max) };
			} else if (max == null) {
				return new String[] { format.format(min) };
			}
			return new String[] { format.format(min), format.format(max) };
		}
	}
}




/*******************************************************************************
 * Copyright (c) 2009 Ovidio Mallo and others.
 * All rights reserved. This program and the accompanying materials
 * are made available under the terms of the Eclipse Public License v1.0
 * which accompanies this distribution, and is available at
 * http://www.eclipse.org/legal/epl-v10.html
 *
 * Contributors:
 *     Ovidio Mallo - initial API and implementation (bug 183055)
 ******************************************************************************/

package org.eclipse.core.internal.databinding.validation;

import java.text.MessageFormat;
import java.util.Date;

import org.eclipse.core.databinding.validation.IValidator;
import org.eclipse.core.databinding.validation.ValidationStatus;
import org.eclipse.core.internal.databinding.BindingMessages;
import org.eclipse.core.runtime.IStatus;

import com.ibm.icu.text.DateFormat;

/**
 * Provides validations for date which must lie within an open/closed range.
 * 
 * @since 1.4
 */
public class DateRangeValidator implements IValidator {

	// The set of constraint types for the lower/upper bound of the date range.
	private static final int UNDEFINED = -1;
	private static final int AFTER = 0;
	private static final int AFTER_EQUAL = 1;
	private static final int BEFORE = 2;
	private static final int BEFORE_EQUAL = 3;

	// The default validation messages.
	private static final String AFTER_MESSAGE = BindingMessages.getString(BindingMessages.VALIDATE_DATE_RANGE_AFTER);
	private static final String AFTER_EQUAL_MESSAGE = BindingMessages.getString(BindingMessages.VALIDATE_DATE_RANGE_AFTER_EQUAL);
	private static final String BEFORE_MESSAGE = BindingMessages.getString(BindingMessages.VALIDATE_DATE_RANGE_BEFORE);
	private static final String BEFORE_EQUAL_MESSAGE = BindingMessages.getString(BindingMessages.VALIDATE_DATE_RANGE_BEFORE_EQUAL);
	private static final String WITHIN_RANGE_MESSAGE = BindingMessages.getString(BindingMessages.VALIDATE_DATE_RANGE_WITHIN_RANGE);

	private final Date min;
	private final Date max;
	private final int minConstraint;
	private final int maxConstraint;
	private final String validationMessage;
	private String formattedValidationMessage;
	private final DateFormat format;

	/**
	 * Single constructor which supports the individual date range types.
	 * 
	 * @param min
	 *            The min date of the range or <code>null</code> in case no
	 *            lower bound is defined.
	 * @param max
	 *            The max date of the range or <code>null</code> in case no
	 *            upper bound is defined.
	 * @param minConstraint
	 *            The type of constraint imposed by the lower bound of the
	 *            range.
	 * @param maxConstraint
	 *            The type of constraint imposed by the upper bound of the
	 *            range.
	 * @param validationMessage
	 *            The validation message pattern to use. Can be parameterized by
	 *            the lower and upper bound of the range, if defined.
	 * @param format
	 *            The date format to use for formatting dates in the validation
	 *            message.
	 */
	private DateRangeValidator(Date min, Date max, int minConstraint,
			int maxConstraint, String validationMessage, DateFormat format) {
		this.min = min;
		this.max = max;
		this.minConstraint = minConstraint;
		this.maxConstraint = maxConstraint;
		this.validationMessage = validationMessage;
		this.format = format;
	}

	/**
	 * Creates a validator which checks that an input date is after the given
	 * date.
	 * 
	 * @param date
	 *            The reference date of the after constraint.
	 * @param validationMessage
	 *            The validation message pattern to use. Can be parameterized
	 *            with the given reference date.
	 * @param format
	 *            The display format to use for formatting dates in the
	 *            validation message.
	 * @return The validator instance.
	 */
	public static DateRangeValidator after(Date date, String validationMessage,
			DateFormat format) {
		return new DateRangeValidator(date, null, AFTER, UNDEFINED,
				defaultIfNull(validationMessage, AFTER_MESSAGE), format);
	}

	/**
	 * Creates a validator which checks that an input date is after or on the
	 * given date.
	 * 
	 * @param date
	 *            The reference date of the after-equal constraint.
	 * @param validationMessage
	 *            The validation message pattern to use. Can be parameterized
	 *            with the given reference date.
	 * @param format
	 *            The display format to use for formatting dates in the
	 *            validation message.
	 * @return The validator instance.
	 */
	public static DateRangeValidator afterEqual(Date date,
			String validationMessage, DateFormat format) {
		return new DateRangeValidator(date, null, AFTER_EQUAL, UNDEFINED,
				defaultIfNull(validationMessage, AFTER_EQUAL_MESSAGE), format);
	}

	/**
	 * Creates a validator which checks that an input date is before the given
	 * date.
	 * 
	 * @param date
	 *            The reference date of the before constraint.
	 * @param validationMessage
	 *            The validation message pattern to use. Can be parameterized
	 *            with the given reference date.
	 * @param format
	 *            The display format to use for formatting dates in the
	 *            validation message.
	 * @return The validator instance.
	 */
	public static DateRangeValidator before(Date date, String validationMessage,
			DateFormat format) {
		return new DateRangeValidator(null, date, UNDEFINED, BEFORE,
				defaultIfNull(validationMessage, BEFORE_MESSAGE), format);
	}

	/**
	 * Creates a validator which checks that an input date is before or on the
	 * given date.
	 * 
	 * @param date
	 *            The reference date of the before-equal constraint.
	 * @param validationMessage
	 *            The validation message pattern to use. Can be parameterized
	 *            with the given reference date.
	 * @param format
	 *            The display format to use for formatting dates in the
	 *            validation message.
	 * @return The validator instance.
	 */
	public static DateRangeValidator beforeEqual(Date date,
			String validationMessage, DateFormat format) {
		return new DateRangeValidator(null, date, UNDEFINED, BEFORE_EQUAL,
				defaultIfNull(validationMessage, BEFORE_EQUAL_MESSAGE), format);
	}

	/**
	 * Creates a validator which checks that an input date is within the given
	 * range.
	 * 
	 * @param min
	 *            The lower bound of the range (inclusive).
	 * @param max
	 *            The upper bound of the range (inclusive).
	 * @param validationMessage
	 *            The validation message pattern to use. Can be parameterized
	 *            with the range's lower and upper bound.
	 * @param format
	 *            The display format to use for formatting dates in the
	 *            validation message.
	 * @return The validator instance.
	 */
	public static DateRangeValidator range(Date min, Date max,
			String validationMessage, DateFormat format) {
		return new DateRangeValidator(min, max, AFTER_EQUAL, BEFORE_EQUAL,
				defaultIfNull(validationMessage, WITHIN_RANGE_MESSAGE), format);
	}

	public IStatus validate(Object value) {
		if (value != null) {
			Date date = (Date) value;
			if ((min != null && !fulfillsConstraint(date, min, minConstraint))
					|| (max != null && !fulfillsConstraint(date, max,
							maxConstraint))) {
				return ValidationStatus.error(getFormattedValidationMessage());
			}
		}
		return ValidationStatus.ok();
	}

	private boolean fulfillsConstraint(Date date1, Date date2, int constraint) {
		switch (constraint) {
		case AFTER:
			return date1.after(date2);
		case AFTER_EQUAL:
			return date1.after(date2) || date1.equals(date2);
		case BEFORE:
			return date1.before(date2);
		case BEFORE_EQUAL:
			return date1.before(date2) || date1.equals(date2);
		case UNDEFINED:
		default:
			throw new IllegalArgumentException(
					"Unsupported constraint: " + constraint); //$NON-NLS-1$
		}
	}

	private synchronized String getFormattedValidationMessage() {
		if (formattedValidationMessage == null) {
			formattedValidationMessage = MessageFormat.format(
					validationMessage, getValidationMessageArguments());
		}
		return formattedValidationMessage;
	}

	private String[] getValidationMessageArguments() {
		synchronized (format) {
			if (min == null) {
				return new String[] { format.format(max) };
			} else if (max == null) {
				return new String[] { format.format(min) };
			}
			return new String[] { format.format(min), format.format(max) };
		}
	}

	private static String defaultIfNull(String string, String defaultString) {
		return (string != null) ? string : defaultString;
	}
}




/*******************************************************************************
 * Copyright (c) 2009 Ovidio Mallo and others.
 * All rights reserved. This program and the accompanying materials
 * are made available under the terms of the Eclipse Public License v1.0
 * which accompanies this distribution, and is available at
 * http://www.eclipse.org/legal/epl-v10.html
 *
 * Contributors:
 *     Ovidio Mallo - initial API and implementation (bug 183055)
 ******************************************************************************/

package org.eclipse.core.internal.databinding.validation;

import java.text.MessageFormat;

import org.eclipse.core.databinding.validation.IValidator;
import org.eclipse.core.databinding.validation.ValidationStatus;
import org.eclipse.core.internal.databinding.BindingMessages;
import org.eclipse.core.runtime.IStatus;

import com.ibm.icu.text.NumberFormat;

/**
 * Provides validations for strings which must have a specified length.
 * 
 * @since 1.4
 */
public class StringLengthValidator implements IValidator {

	// The default validation messages.
	private static final String MIN_LENGTH_MESSAGE = BindingMessages.getString(BindingMessages.VALIDATE_STRING_LENGTH_MIN);
	private static final String MAX_LENGTH_MESSAGE = BindingMessages.getString(BindingMessages.VALIDATE_STRING_LENGTH_MAX);
	private static final String LENGTH_RANGE_MESSAGE = BindingMessages.getString(BindingMessages.VALIDATE_STRING_LENGTH_RANGE);

	private final Integer minLength;
	private final Integer maxLength;
	private final String validationMessage;
	private String formattedValidationMessage;
	private final NumberFormat format;

	/**
	 * Creates a string length validator defining a minimum and/or maximum
	 * length for a string.
	 * 
	 * @param minLength
	 *            The minimum length of the string or <code>null</code> in case
	 *            no minimum length is defined.
	 * @param maxLength
	 *            The maximum length of the string or <code>null</code> in case
	 *            no maximum length is defined.
	 * @param validationMessage
	 *            The validation message pattern to use. Can be parameterized by
	 *            the lower and upper bound of the range, if defined.
	 * @param format
	 *            The number format to use for formatting integers (the length
	 *            bounds) in the validation message.
	 */
	private StringLengthValidator(Integer minLength, Integer maxLength,
			String validationMessage, NumberFormat format) {
		this.minLength = minLength;
		this.maxLength = maxLength;
		this.validationMessage = validationMessage;
		this.format = format;
	}

	/**
	 * Creates a validator which checks that an input string has the given
	 * minimum length.
	 * 
	 * @param minLength
	 *            The minimum length which the input string must have.
	 * @param validationMessage
	 *            The validation message pattern to use. Can be parameterized
	 *            with the given minimum length.
	 * @param format
	 *            The display format to use for formatting integers (the minimum
	 *            length) in the validation message.
	 * @return The validator instance.
	 */
	public static StringLengthValidator minLength(int minLength,
			String validationMessage, NumberFormat format) {
		return new StringLengthValidator(new Integer(minLength), null,
				defaultIfNull(validationMessage, MIN_LENGTH_MESSAGE), format);
	}

	/**
	 * Creates a validator which checks that an input string has the given
	 * maximum length.
	 * 
	 * @param maxLength
	 *            The maximum length which the input string must have.
	 * @param validationMessage
	 *            The validation message pattern to use. Can be parameterized
	 *            with the given maximum length.
	 * @param format
	 *            The display format to use for formatting integers (the maximum
	 *            length) in the validation message.
	 * @return The validator instance.
	 */
	public static StringLengthValidator maxLength(int maxLength,
			String validationMessage, NumberFormat format) {
		return new StringLengthValidator(null, new Integer(maxLength),
				defaultIfNull(validationMessage, MAX_LENGTH_MESSAGE), format);
	}

	/**
	 * Creates a validator which checks that the length of an input string lies
	 * in the given range.
	 * 
	 * @param minLength
	 *            The minimum length which the input string must have.
	 * @param maxLength
	 *            The maximum length which the input string must have.
	 * @param validationMessage
	 *            The validation message pattern to use. Can be parameterized
	 *            with the given minimum and maximum lengths.
	 * @param format
	 *            The display format to use for formatting integers (the
	 *            minimum/maximum length) in the validation message.
	 * @return The validator instance.
	 */
	public static StringLengthValidator lengthRange(int minLength,
			int maxLength, String validationMessage, NumberFormat format) {
		return new StringLengthValidator(new Integer(minLength), new Integer(
				maxLength), defaultIfNull(validationMessage,
				LENGTH_RANGE_MESSAGE), format);
	}

	public IStatus validate(Object value) {
		String input = (String) value;
		if (input != null) {
			int inputLength = input.length();
			if ((minLength != null && inputLength < minLength.intValue())
					|| maxLength != null && inputLength > maxLength.intValue()) {
				return ValidationStatus.error(getFormattedValidationMessage());
			}
		}
		return ValidationStatus.ok();
	}

	private synchronized String getFormattedValidationMessage() {
		if (formattedValidationMessage == null) {
			formattedValidationMessage = MessageFormat.format(
					validationMessage, getValidationMessageArguments());
		}
		return formattedValidationMessage;
	}

	private String[] getValidationMessageArguments() {
		synchronized (format) {
			if (minLength == null) {
				return new String[] { format.format(maxLength) };
			} else if (maxLength == null) {
				return new String[] { format.format(minLength) };
			}
			return new String[] { format.format(minLength),
					format.format(maxLength) };
		}
	}

	private static String defaultIfNull(String string, String defaultString) {
		return (string != null) ? string : defaultString;
	}
}




/*******************************************************************************
 * Copyright (c) 2009 Ovidio Mallo and others.
 * All rights reserved. This program and the accompanying materials
 * are made available under the terms of the Eclipse Public License v1.0
 * which accompanies this distribution, and is available at
 * http://www.eclipse.org/legal/epl-v10.html
 *
 * Contributors:
 *     Ovidio Mallo - initial API and implementation (bug 183055)
 ******************************************************************************/

package org.eclipse.core.databinding.validation.constraint;

import java.util.Date;

import org.eclipse.core.internal.databinding.validation.DateRangeValidator;
import org.eclipse.core.internal.databinding.validation.NonNullValidator;

import com.ibm.icu.text.DateFormat;

/**
 * @since 1.4
 */
public final class DateConstraints extends Constraints {

	private DateFormat displayFormat = DateFormat.getDateInstance();

	private String requiredMessage = null;

	private String afterMessage = null;

	private String afterEqualMessage = null;

	private String beforeMessage = null;

	private String beforeEqualMessage = null;

	private String rangeMessage = null;

	/**
	 * Sets the format to use when formatting a date to be included in any of
	 * the validation messages.
	 * 
	 * <p>
	 * This date format will be used for any subsequent constraints which are
	 * applied.
	 * </p>
	 * 
	 * @param format
	 *            The format to use for displaying dates in validation messages.
	 * @return This constraints instance for method chaining.
	 */
	public DateConstraints displayFormat(DateFormat format) {
		this.displayFormat = format;
		return this;
	}

	/**
	 * Adds a validator ensuring that the parsed date is not <code>null</code>.
	 * Uses the current {@link #requiredMessage(String) validation message}.
	 * 
	 * @return This constraints instance for method chaining.
	 */
	public DateConstraints required() {
		addValidator(new NonNullValidator(requiredMessage));
		return this;
	}

	/**
	 * Sets the validation message for the {@link #required()} constraint.
	 * 
	 * @param message
	 *            The validation message for the {@link #required()} constraint.
	 * @return This constraints instance for method chaining.
	 * 
	 * @see #required()
	 */
	public DateConstraints requiredMessage(String message) {
		this.requiredMessage = message;
		return this;
	}

	/**
	 * Adds a validator ensuring that the parsed date is after the given date.
	 * Uses the current {@link #afterMessage(String) validation message}.
	 * 
	 * @param date
	 *            The date which the parsed date must be after.
	 * @return This constraints instance for method chaining.
	 * 
	 * @see Date#after(Date)
	 */
	public DateConstraints after(Date date) {
		addValidator(DateRangeValidator
				.after(date, afterMessage, displayFormat));
		return this;
	}

	/**
	 * Sets the validation message pattern for the {@link #after(Date)}
	 * constraint.
	 * 
	 * @param message
	 *            The validation message pattern for the {@link #after(Date)}
	 *            constraint. Can be parameterized with the date which the
	 *            parsed date must be after.
	 * @return This constraints instance for method chaining.
	 * 
	 * @see #after(Date)
	 */
	public DateConstraints afterMessage(String message) {
		this.afterMessage = message;
		return this;
	}

	/**
	 * Adds a validator ensuring that the parsed date is after or on the given
	 * date. Uses the current {@link #afterEqualMessage(String) validation
	 * message}.
	 * 
	 * @param date
	 *            The date which the parsed date must be after or on.
	 * @return This constraints instance for method chaining.
	 * 
	 * @see Date#after(Date)
	 * @see Date#equals(Object)
	 */
	public DateConstraints afterEqual(Date date) {
		addValidator(DateRangeValidator.afterEqual(date, afterEqualMessage,
				displayFormat));
		return this;
	}

	/**
	 * Sets the validation message pattern for the {@link #afterEqual(Date)}
	 * constraint.
	 * 
	 * @param message
	 *            The validation message pattern for the
	 *            {@link #afterEqual(Date)} constraint. Can be parameterized
	 *            with the date which the parsed date must be after or on.
	 * @return This constraints instance for method chaining.
	 * 
	 * @see #afterEqual(Date)
	 */
	public DateConstraints afterEqualMessage(String message) {
		this.afterEqualMessage = message;
		return this;
	}

	/**
	 * Adds a validator ensuring that the parsed date is before the given date.
	 * Uses the current {@link #beforeMessage(String) validation message}.
	 * 
	 * @param date
	 *            The date which the parsed date must be before
	 * @return This constraints instance for method chaining.
	 * 
	 * @see Date#before(Date)
	 */
	public DateConstraints before(Date date) {
		addValidator(DateRangeValidator.before(date, beforeMessage,
				displayFormat));
		return this;
	}

	/**
	 * Sets the validation message pattern for the {@link #before(Date)}
	 * constraint.
	 * 
	 * @param message
	 *            The validation message pattern for the {@link #before(Date)}
	 *            constraint. Can be parameterized with the date which the
	 *            parsed date must be before.
	 * @return This constraints instance for method chaining.
	 * 
	 * @see #before(Date)
	 */
	public DateConstraints beforeMessage(String message) {
		this.beforeMessage = message;
		return this;
	}

	/**
	 * Adds a validator ensuring that the parsed date is before or on the given
	 * date. Uses the current {@link #beforeEqualMessage(String) validation
	 * message}.
	 * 
	 * @param date
	 *            The date which the parsed date must be before or on.
	 * @return This constraints instance for method chaining.
	 * 
	 * @see Date#before(Date)
	 * @see Date#equals(Object)
	 */
	public DateConstraints beforeEqual(Date date) {
		addValidator(DateRangeValidator.beforeEqual(date, beforeEqualMessage,
				displayFormat));
		return this;
	}

	/**
	 * Sets the validation message pattern for the {@link #beforeEqual(Date)}
	 * constraint.
	 * 
	 * @param message
	 *            The validation message pattern for the
	 *            {@link #beforeEqual(Date)} constraint. Can be parameterized
	 *            with the date which the parsed date must be before or on.
	 * @return This constraints instance for method chaining.
	 * 
	 * @see #beforeEqual(Date)
	 */
	public DateConstraints beforeEqualMessage(String message) {
		this.beforeEqualMessage = message;
		return this;
	}

	/**
	 * Adds a validator ensuring that the parsed date is within the given range.
	 * Uses the current {@link #rangeMessage(String) validation message}.
	 * 
	 * @param minDate
	 *            The lower bound of the range (inclusive).
	 * @param maxDate
	 *            The upper bound of the range (inclusive).
	 * @return This constraints instance for method chaining.
	 */
	public DateConstraints range(Date minDate, Date maxDate) {
		addValidator(DateRangeValidator.range(minDate, maxDate, rangeMessage,
				displayFormat));
		return this;
	}

	/**
	 * Sets the validation message pattern for the {@link #range(Date, Date)}
	 * constraint.
	 * 
	 * @param message
	 *            The validation message pattern for the
	 *            {@link #range(Date, Date)} constraint. Can be parameterized
	 *            with the min and max dates of the range in which the parsed
	 *            date must lie.
	 * @return This constraints instance for method chaining.
	 * 
	 * @see #range(Date, Date)
	 */
	public DateConstraints rangeMessage(String message) {
		this.rangeMessage = message;
		return this;
	}
}




/*******************************************************************************
 * Copyright (c) 2009 Ovidio Mallo and others.
 * All rights reserved. This program and the accompanying materials
 * are made available under the terms of the Eclipse Public License v1.0
 * which accompanies this distribution, and is available at
 * http://www.eclipse.org/legal/epl-v10.html
 *
 * Contributors:
 *     Ovidio Mallo - initial API and implementation (bug 183055)
 ******************************************************************************/

package org.eclipse.core.internal.databinding.conversion;

import org.eclipse.core.databinding.conversion.Converter;

/**
 * @since 1.4
 */
public class StringTrimConverter extends Converter {

	private final boolean trimToNull;

	/**
	 * 
	 * @param trimToNull
	 */
	public StringTrimConverter(boolean trimToNull) {
		super(String.class, String.class);
		this.trimToNull = trimToNull;
	}

	public Object convert(Object fromObject) {
		String string = (String) fromObject;

		if (string != null) {
			string = string.trim();

			if (trimToNull && string.length() == 0) {
				string = null;
			}
		}

		return string;
	}
}




/*******************************************************************************
 * Copyright (c) 2009 Ovidio Mallo and others.
 * All rights reserved. This program and the accompanying materials
 * are made available under the terms of the Eclipse Public License v1.0
 * which accompanies this distribution, and is available at
 * http://www.eclipse.org/legal/epl-v10.html
 *
 * Contributors:
 *     Ovidio Mallo - initial API and implementation (bug 183055)
 ******************************************************************************/

package org.eclipse.core.databinding.editing;

import org.eclipse.core.databinding.validation.constraint.BooleanConstraints;
import org.eclipse.core.databinding.validation.constraint.Constraints;
import org.eclipse.core.databinding.validation.constraint.StringConstraints;
import org.eclipse.core.internal.databinding.conversion.BooleanToStringConverter;
import org.eclipse.core.internal.databinding.conversion.StringToBooleanConverter;
import org.eclipse.core.internal.databinding.validation.StringToBooleanValidator;

/**
 * @since 1.4
 */
public final class BooleanEditing extends Editing {

	private BooleanEditing(String[] trueValues, String[] falseValues,
			String parseErrorMessage) {
		StringToBooleanConverter targetConverter = new StringToBooleanConverter();
		BooleanToStringConverter modelConverter = new BooleanToStringConverter(
				Boolean.class);

		StringToBooleanValidator targetValidator = new StringToBooleanValidator();
		if (parseErrorMessage != null) {
			targetValidator.setParseErrorMessage(parseErrorMessage);
		}

		if (trueValues != null && falseValues != null) {
			targetValidator.setSourceStrings(trueValues, falseValues);
			targetConverter.setSourceStrings(trueValues, falseValues);
			modelConverter.setTargetStrings(trueValues[0], falseValues[0]);
		}

		setTargetConverter(targetConverter);
		setModelConverter(modelConverter);
		targetConstraints().addValidator(targetValidator);
	}

	/**
	 * Creates a new editing object which uses the default set of string
	 * representations for boolean values for parsing and displaying.
	 * 
	 * @return The new editing object for the default set of string
	 *         representations for boolean values.
	 */
	public static BooleanEditing withDefaults() {
		return new BooleanEditing(null, null, null);
	}

	/**
	 * Creates a new editing object which uses the default set of string
	 * representations for boolean values for parsing and displaying. Uses the
	 * specified custom validation message.
	 * 
	 * @param parseErrorMessage
	 *            The validation message issued in case the input string cannot
	 *            be parsed to an boolean.
	 * @return The new editing object for the default set of string
	 *         representations for boolean values.
	 */
	public static BooleanEditing withDefaults(String parseErrorMessage) {
		return new BooleanEditing(null, null, parseErrorMessage);
	}

	/**
	 * Creates a new editing object which uses the given set of string
	 * representations for boolean values for parsing and displaying.
	 * 
	 * <p>
	 * For parsing, the given string values will be considered valid
	 * representations of {@code true} and {@code false}, respectively. For
	 * displaying, the first element of the respective array will be used for
	 * representing the corresponding boolean value.
	 * </p>
	 * 
	 * @param trueValues
	 *            The set of strings representing a <code>true</code> value.
	 * @param falseValues
	 *            The set of strings representing a <code>false</code> value.
	 * @return The new editing object for the given set of string
	 *         representations for boolean values.
	 */
	public static BooleanEditing forStringValues(String[] trueValues,
			String[] falseValues) {
		return new BooleanEditing(trueValues, falseValues, null);
	}

	/**
	 * Creates a new editing object which uses the given set of string
	 * representations for boolean values for parsing and displaying. Uses the
	 * specified custom validation message.
	 * 
	 * <p>
	 * For parsing, the given string values will be considered valid
	 * representations of {@code true} and {@code false}, respectively. For
	 * displaying, the first element of the respective array will be used for
	 * representing the corresponding boolean value.
	 * </p>
	 * 
	 * @param trueValues
	 *            The set of strings representing a <code>true</code> value.
	 * @param falseValues
	 *            The set of strings representing a <code>false</code> value.
	 * @param parseErrorMessage
	 *            The validation message issued in case the input string cannot
	 *            be parsed to an boolean.
	 * @return The new editing object for the given set of string
	 *         representations for boolean values.
	 */
	public static BooleanEditing forStringValues(String[] trueValues,
			String[] falseValues, String parseErrorMessage) {
		return new BooleanEditing(trueValues, falseValues, parseErrorMessage);
	}

	/**
	 * Returns the target constraints to apply.
	 * 
	 * <p>
	 * This method provides a typesafe access to the {@link StringConstraints
	 * string target constraints} of this editing object and is equivalent to
	 * {@code (StringConstraints) targetConstraints()}.
	 * </p>
	 * 
	 * @return The target constraints to apply.
	 * 
	 * @see #targetConstraints()
	 * @see StringConstraints
	 */
	public StringConstraints targetStringConstraints() {
		return (StringConstraints) targetConstraints();
	}

	/**
	 * Returns the model constraints to apply.
	 * 
	 * <p>
	 * This method provides a typesafe access to the {@link BooleanConstraints
	 * bool model constraints} of this editing object and is equivalent to
	 * {@code (BooleanConstraints) modelConstraints()}.
	 * </p>
	 * 
	 * @return The target constraints to apply.
	 * 
	 * @see #modelConstraints()
	 * @see BooleanConstraints
	 */
	public BooleanConstraints modelBooleanConstraints() {
		return (BooleanConstraints) modelConstraints();
	}

	/**
	 * Returns the before-set model constraints to apply.
	 * 
	 * <p>
	 * This method provides a typesafe access to the {@link BooleanConstraints
	 * bool before-set model constraints} of this editing object and is
	 * equivalent to {@code (BooleanConstraints) beforeSetModelConstraints()}.
	 * </p>
	 * 
	 * @return The target constraints to apply.
	 * 
	 * @see #beforeSetModelConstraints()
	 * @see BooleanConstraints
	 */
	public BooleanConstraints beforeSetModelBooleanConstraints() {
		return (BooleanConstraints) beforeSetModelConstraints();
	}

	protected Constraints createTargetConstraints() {
		return new StringConstraints();
	}

	protected Constraints createModelConstraints() {
		return new BooleanConstraints();
	}

	protected Constraints createBeforeSetModelConstraints() {
		return new BooleanConstraints();
	}

	/**
	 * Convenience method which adds a {@link BooleanConstraints#required()
	 * required constraint} to the set of {@link #modelBooleanConstraints()}.
	 * 
	 * @return This editing instance for method chaining.
	 * 
	 * @see BooleanConstraints#required()
	 * @see #modelBooleanConstraints()
	 */
	public BooleanEditing required() {
		modelBooleanConstraints().required();
		return this;
	}
}




/*******************************************************************************
 * Copyright (c) 2009 Ovidio Mallo and others.
 * All rights reserved. This program and the accompanying materials
 * are made available under the terms of the Eclipse Public License v1.0
 * which accompanies this distribution, and is available at
 * http://www.eclipse.org/legal/epl-v10.html
 *
 * Contributors:
 *     Ovidio Mallo - initial API and implementation (bug 183055)
 ******************************************************************************/

package org.eclipse.core.internal.databinding.validation;

import org.eclipse.core.databinding.validation.IValidator;
import org.eclipse.core.databinding.validation.ValidationStatus;
import org.eclipse.core.internal.databinding.BindingMessages;
import org.eclipse.core.runtime.IStatus;

/**
 * @since 1.4
 */
public class NonNullValidator implements IValidator {

	private static final String NON_NULL_VALIDATION_MESSAGE = BindingMessages.getString(BindingMessages.VALIDATE_NON_NULL);

	private final String validationMessage;

	/**
	 * @param validationMessage
	 */
	public NonNullValidator(String validationMessage) {
		this.validationMessage = validationMessage != null ? validationMessage
				: NON_NULL_VALIDATION_MESSAGE;
	}

	public IStatus validate(Object value) {
		if (value == null) {
			return ValidationStatus.error(validationMessage);
		}
		return ValidationStatus.ok();
	}
}




/*******************************************************************************
 * Copyright (c) 2009 Ovidio Mallo and others.
 * All rights reserved. This program and the accompanying materials
 * are made available under the terms of the Eclipse Public License v1.0
 * which accompanies this distribution, and is available at
 * http://www.eclipse.org/legal/epl-v10.html
 *
 * Contributors:
 *     Ovidio Mallo - initial API and implementation (bug 183055)
 ******************************************************************************/

package org.eclipse.core.databinding.validation.constraint;

import org.eclipse.core.internal.databinding.validation.NonNullValidator;

/**
 * @since 1.4
 */
public final class BooleanConstraints extends Constraints {

	private String requiredMessage = null;

	/**
	 * Adds a validator ensuring that the boolean value is not <code>null</code>
	 * . Uses the current {@link #requiredMessage(String) validation message}.
	 * 
	 * @return This constraints instance for method chaining.
	 */
	public BooleanConstraints required() {
		addValidator(new NonNullValidator(requiredMessage));
		return this;
	}

	/**
	 * Sets the validation message for the {@link #required()} constraint.
	 * 
	 * @param message
	 *            The validation message for the {@link #required()} constraint.
	 * @return This constraints instance for method chaining.
	 * 
	 * @see #required()
	 */
	public BooleanConstraints requiredMessage(String message) {
		this.requiredMessage = message;
		return this;
	}
}




/*******************************************************************************
 * Copyright (c) 2009 Ovidio Mallo and others.
 * All rights reserved. This program and the accompanying materials
 * are made available under the terms of the Eclipse Public License v1.0
 * which accompanies this distribution, and is available at
 * http://www.eclipse.org/legal/epl-v10.html
 *
 * Contributors:
 *     Ovidio Mallo - initial API and implementation (bug 183055)
 ******************************************************************************/

package org.eclipse.core.internal.databinding.conversion;

import org.eclipse.core.databinding.conversion.Converter;

/**
 * @since 1.4
 */
public class BooleanToStringConverter extends Converter {

	// Those are the defaults used up to now in UpdateStrategy where a simple
	// ObjectToStringConverter was used for converting booleans to strings.
	// FIXME: Should/may we change this to convert to a localized string?
	private String trueValue = Boolean.TRUE.toString();
	private String falseValue = Boolean.FALSE.toString();

	/**
	 * Creates a new converter which converts a boolean to its default string
	 * representation.
	 * 
	 * @param booleanType
	 *            The boolean type. Must be one of {@code Boolean.TYPE} or
	 *            {@code Boolean.class}.
	 */
	public BooleanToStringConverter(Class booleanType) {
		super(booleanType, String.class);
	}

	/**
	 * Sets the string values to which a <code>true</code> and
	 * <code>false</code> value should be converted.
	 * 
	 * @param trueValue
	 *            The string to which to convert a <code>true</code> value.
	 * @param falseValue
	 *            The string to which to convert a <code>false</code> value.
	 */
	public final void setTargetStrings(String trueValue, String falseValue) {
		this.trueValue = trueValue;
		this.falseValue = falseValue;
	}

	public Object convert(Object source) {
		Boolean value = (Boolean) source;
		if (value != null) {
			return value.booleanValue() ? trueValue : falseValue;
		}
		return ""; //$NON-NLS-1$
	}
}




/*******************************************************************************
 * Copyright (c) 2009 Ovidio Mallo and others.
 * All rights reserved. This program and the accompanying materials
 * are made available under the terms of the Eclipse Public License v1.0
 * which accompanies this distribution, and is available at
 * http://www.eclipse.org/legal/epl-v10.html
 *
 * Contributors:
 *     Ovidio Mallo - initial API and implementation (bug 183055)
 ******************************************************************************/

package org.eclipse.core.internal.databinding.validation;

import java.util.Arrays;
import java.util.LinkedList;
import java.util.List;
import java.util.StringTokenizer;

import org.eclipse.core.databinding.validation.IValidator;
import org.eclipse.core.databinding.validation.ValidationStatus;
import org.eclipse.core.internal.databinding.BindingMessages;
import org.eclipse.core.runtime.IStatus;

/**
 * @since 1.4
 */
public class StringToBooleanValidator implements IValidator {

	// TODO: Some of this code is duplicated from StringToBooleanPrimitiveConverter!
	private static final String[] DEFAULT_TRUE_VALUES;
	private static final String[] DEFAULT_FALSE_VALUES;

	static {
		String delimiter = BindingMessages.getString(BindingMessages.VALUE_DELIMITER);
		String values = BindingMessages.getString(BindingMessages.TRUE_STRING_VALUES);
		DEFAULT_TRUE_VALUES = valuesToSortedArray(delimiter, values);

		values = BindingMessages.getString(BindingMessages.FALSE_STRING_VALUES);
		DEFAULT_FALSE_VALUES = valuesToSortedArray(delimiter, values);
	}

	private String[] trueValues = DEFAULT_TRUE_VALUES;
	private String[] falseValues = DEFAULT_FALSE_VALUES;

	private String parseErrorMessage = BindingMessages.getString(BindingMessages.VALIDATE_INVALID_BOOLEAN_STRING);

	/**
	 * Returns a sorted array with all values converted to upper case.
	 *
	 * @param delimiter
	 * @param values
	 * @return sorted array of values
	 */
	private static String[] valuesToSortedArray(String delimiter, String values) {
		List list = new LinkedList();
		StringTokenizer tokenizer = new StringTokenizer(values, delimiter);
		while (tokenizer.hasMoreTokens()) {
			list.add(tokenizer.nextToken().toUpperCase());
		}

		String[] array = (String[]) list.toArray(new String[list.size()]);
		Arrays.sort(array);

		return array;
	}

	/**
	 * Sets the validation message to be used in case the source string does not
	 * represent a valid boolean value.
	 * 
	 * @param message
	 *            The validation message to be used in case the source string
	 *            does not represent a valid boolean value.
	 */
	public final void setParseErrorMessage(String message) {
		this.parseErrorMessage = message;
	}

	/**
	 * Sets the string values which are considered to represent a
	 * <code>true</code> and <code>false</code> value, respectively.
	 * 
	 * <p>
	 * Note that the capitalization of the provided strings is ignored.
	 * </p>
	 * 
	 * @param trueValues
	 *            The set of strings representing a <code>true</code> value.
	 * @param falseValues
	 *            The set of strings representing a <code>false</code> value.
	 */
	public final void setSourceStrings(String[] trueValues, String[] falseValues) {
		this.trueValues = new String[trueValues.length];
		for (int i = 0; i < trueValues.length; i++) {
			this.trueValues[i] = trueValues[i].toUpperCase();
		}
		Arrays.sort(this.trueValues); // for binary search

		this.falseValues = new String[falseValues.length];
		for (int i = 0; i < falseValues.length; i++) {
			this.falseValues[i] = falseValues[i].toUpperCase();
		}
		Arrays.sort(this.falseValues); // for binary search
	}

	public IStatus validate(Object value) {
		String source = (String) value;
		if (source != null && source.length() != 0) {
			source = source.toUpperCase();
			if (Arrays.binarySearch(trueValues, source) < 0
					&& Arrays.binarySearch(falseValues, source) < 0) {
				return ValidationStatus.error(parseErrorMessage);
			}
		}
		return ValidationStatus.ok();
	}
}




/*******************************************************************************
 * Copyright (c) 2009 Ovidio Mallo and others.
 * All rights reserved. This program and the accompanying materials
 * are made available under the terms of the Eclipse Public License v1.0
 * which accompanies this distribution, and is available at
 * http://www.eclipse.org/legal/epl-v10.html
 *
 * Contributors:
 *     Ovidio Mallo - initial API and implementation (bug 183055)
 ******************************************************************************/

package org.eclipse.core.databinding.validation.constraint;

import java.util.ArrayList;
import java.util.Iterator;
import java.util.List;

import org.eclipse.core.databinding.util.Policy;
import org.eclipse.core.databinding.validation.IValidator;
import org.eclipse.core.internal.databinding.BindingMessages;
import org.eclipse.core.runtime.IStatus;
import org.eclipse.core.runtime.MultiStatus;
import org.eclipse.core.runtime.Status;

/**
 * @since 1.4
 */
public class Constraints {

	/**
	 * Constant denoting an aggregation strategy that merges multiple non-OK
	 * status objects in a {@link MultiStatus}. Returns an OK status result if
	 * all statuses from the set of validators to apply are an OK status.
	 * Returns a single status if there is only one non-OK status.
	 * 
	 * @see #aggregationPolicy(int)
	 */
	public static final int AGGREGATION_MERGED = 1;

	/**
	 * Constant denoting an aggregation strategy that always returns the most
	 * severe status from the set of validators to apply. If there is more than
	 * one status at the same severity level, it picks the first one it
	 * encounters.
	 * 
	 * @see #aggregationPolicy(int)
	 */
	public static final int AGGREGATION_MAX_SEVERITY = 2;

	// Will be initialized lazily.
	private List validators = null;

	private IValidator cachedValidator = null;

	private int aggregationPolicy = AGGREGATION_MAX_SEVERITY;

	/**
	 * Adds a custom validator to the set of constraints to apply.
	 * 
	 * @param validator
	 *            The custom validator to add to the set of constraints.
	 * @return This constraints instance for method chaining.
	 */
	public final Constraints addValidator(IValidator validator) {
		if (validators == null) {
			validators = new ArrayList(2);
		}
		validators.add(validator);
		cachedValidator = null;
		return this;
	}

	/**
	 * Sets the aggregation policy to apply to the individual validations which
	 * constitute this set of constraints.
	 * 
	 * @param policy
	 *            The validation aggregation policy to set. Must be one of
	 *            {@link #AGGREGATION_MERGED} or
	 *            {@link #AGGREGATION_MAX_SEVERITY}.
	 * @return This constraints instance for method chaining.
	 * 
	 * @see #AGGREGATION_MERGED
	 * @see #AGGREGATION_MAX_SEVERITY
	 */
	public final Constraints aggregationPolicy(int policy) {
		this.aggregationPolicy = policy;
		cachedValidator = null;
		return this;
	}

	/**
	 * Creates a validator which enforces the current set of constraints.
	 * 
	 * <p>
	 * Note that this method will return <code>null</code> in case the set of
	 * constraints to apply is empty.
	 * </p>
	 * 
	 * @return A validator which enforces the current set of constraints. May be
	 *         <code>null</code>.
	 */
	public final IValidator createValidator() {
		if (validators != null && !validators.isEmpty()) {
			if (cachedValidator == null) {
				if (validators.size() == 1) {
					cachedValidator = (IValidator) validators.get(0);
				} else {
					IValidator[] currentValidators = (IValidator[]) validators
							.toArray(new IValidator[validators.size()]);
					cachedValidator = new ConstraintsValidator(
							currentValidators, aggregationPolicy);
				}
			}
			return cachedValidator;
		}
		return null;
	}

	private static final class ConstraintsValidator implements IValidator {

		private final IValidator[] validators;

		private final int aggregationPolicy;

		public ConstraintsValidator(IValidator[] validators,
				int aggregationPolicy) {
			this.validators = validators;
			this.aggregationPolicy = aggregationPolicy;
		}

		public IStatus validate(Object value) {
			return (aggregationPolicy == AGGREGATION_MERGED) ? validateMerged(value)
					: validateMaxSeverity(value);
		}

		private IStatus validateMerged(Object value) {
			List statuses = new ArrayList();
			for (int i = 0; i < validators.length; i++) {
				IValidator validator = validators[i];
				IStatus status = validator.validate(value);
				if (!status.isOK()) {
					statuses.add(status);
				}
			}

			if (statuses.size() == 1) {
				return (IStatus) statuses.get(0);
			}

			if (!statuses.isEmpty()) {
				MultiStatus result = new MultiStatus(Policy.JFACE_DATABINDING,
						0, BindingMessages
								.getString(BindingMessages.MULTIPLE_PROBLEMS),
						null);
				for (Iterator it = statuses.iterator(); it.hasNext();) {
					IStatus status = (IStatus) it.next();
					result.merge(status);
				}
				return result;
			}

			return Status.OK_STATUS;
		}

		private IStatus validateMaxSeverity(Object value) {
			int maxSeverity = IStatus.OK;
			IStatus maxStatus = Status.OK_STATUS;
			for (int i = 0; i < validators.length; i++) {
				IValidator validator = validators[i];
				IStatus status = validator.validate(value);
				if (status.getSeverity() > maxSeverity) {
					maxSeverity = status.getSeverity();
					maxStatus = status;
				}
			}
			return maxStatus;
		}
	}
}




/*******************************************************************************
 * Copyright (c) 2009 Ovidio Mallo and others.
 * All rights reserved. This program and the accompanying materials
 * are made available under the terms of the Eclipse Public License v1.0
 * which accompanies this distribution, and is available at
 * http://www.eclipse.org/legal/epl-v10.html
 *
 * Contributors:
 *     Ovidio Mallo - initial API and implementation (bug 183055)
 ******************************************************************************/

package org.eclipse.core.databinding.validation.constraint;

import java.util.regex.Pattern;

import org.eclipse.core.internal.databinding.validation.NonEmptyStringValidator;
import org.eclipse.core.internal.databinding.validation.NonNullValidator;
import org.eclipse.core.internal.databinding.validation.StringLengthValidator;
import org.eclipse.core.internal.databinding.validation.StringRegexValidator;

import com.ibm.icu.text.NumberFormat;

/**
 * @since 1.4
 */
public final class StringConstraints extends Constraints {

	private NumberFormat integerDisplayFormat = NumberFormat
			.getIntegerInstance();

	private String requiredMessage = null;

	private String nonEmptyMessage = null;

	private String minLengthMessage = null;

	private String maxLengthMessage = null;

	private String lengthRangeMessage = null;

	private String matchesMessage = null;

	/**
	 * Sets the format to use when formatting an integer to be included in any
	 * of the validation messages.
	 * 
	 * <p>
	 * This integer format will be used for any subsequent constraints which are
	 * applied.
	 * </p>
	 * 
	 * @param format
	 *            The format to use for displaying integers in validation
	 *            messages.
	 * @return This constraints instance for method chaining.
	 * 
	 * @see #minLength(int)
	 * @see #maxLength(int)
	 * @see #lengthRange(int, int)
	 */
	public StringConstraints integerDisplayFormat(NumberFormat format) {
		this.integerDisplayFormat = format;
		return this;
	}

	/**
	 * Adds a validator ensuring that the parsed integer is not
	 * <code>null</code>. Uses the current {@link #requiredMessage(String)
	 * validation message}.
	 * 
	 * @return This constraints instance for method chaining.
	 */
	public StringConstraints required() {
		addValidator(new NonNullValidator(requiredMessage));
		return this;
	}

	/**
	 * Sets the validation message for the {@link #required()} constraint.
	 * 
	 * @param message
	 *            The validation message for the {@link #required()} constraint.
	 * @return This constraints instance for method chaining.
	 * 
	 * @see #required()
	 */
	public StringConstraints requiredMessage(String message) {
		this.requiredMessage = message;
		return this;
	}

	/**
	 * Adds a validator ensuring that the parsed integer is not empty. Uses the
	 * current {@link #nonEmptyMessage(String) validation message}.
	 * 
	 * @return This constraints instance for method chaining.
	 */
	public StringConstraints nonEmpty() {
		addValidator(new NonEmptyStringValidator(nonEmptyMessage));
		return this;
	}

	/**
	 * Sets the validation message for the {@link #nonEmpty()} constraint.
	 * 
	 * @param message
	 *            The validation message for the {@link #nonEmpty()} constraint.
	 * @return This constraints instance for method chaining.
	 * 
	 * @see #nonEmpty()
	 */
	public StringConstraints nonEmptyMessage(String message) {
		this.nonEmptyMessage = message;
		return this;
	}

	/**
	 * Adds a validator ensuring that the input string has at least the
	 * specified amount of characters. Uses the current
	 * {@link #minLengthMessage(String) validation message}.
	 * 
	 * @param minLength
	 *            The minimal length to be enforced on the input string.
	 * @return This constraints instance for method chaining.
	 */
	public StringConstraints minLength(int minLength) {
		addValidator(StringLengthValidator.minLength(minLength,
				minLengthMessage, integerDisplayFormat));
		return this;
	}

	/**
	 * Sets the validation message pattern for the {@link #minLength(int)}
	 * constraint.
	 * 
	 * @param message
	 *            The validation message pattern for the {@link #minLength(int)}
	 *            constraint. Can be parameterized with the minimum string
	 *            length.
	 * @return This constraints instance for method chaining.
	 * 
	 * @see #minLength(int)
	 */
	public StringConstraints minLengthMessage(String message) {
		this.minLengthMessage = message;
		return this;
	}

	/**
	 * Adds a validator ensuring that the input string has not more than the
	 * specified amount of characters. Uses the current
	 * {@link #maxLengthMessage(String) validation message}.
	 * 
	 * @param maxLength
	 *            The maximum length to be enforced on the input string.
	 * @return This constraints instance for method chaining.
	 */
	public StringConstraints maxLength(int maxLength) {
		addValidator(StringLengthValidator.maxLength(maxLength,
				maxLengthMessage, integerDisplayFormat));
		return this;
	}

	/**
	 * Sets the validation message pattern for the {@link #maxLength(int)}
	 * constraint.
	 * 
	 * @param message
	 *            The validation message pattern for the {@link #maxLength(int)}
	 *            constraint. Can be parameterized with the maximum string
	 *            length.
	 * @return This constraints instance for method chaining.
	 * 
	 * @see #maxLength(int)
	 */
	public StringConstraints maxLengthMessage(String message) {
		this.maxLengthMessage = message;
		return this;
	}

	/**
	 * Adds a validator ensuring that the length of the input string is between
	 * the given bounds. Uses the current {@link #lengthRangeMessage(String)
	 * validation message}.
	 * 
	 * @param minLength
	 *            The minimal length to be enforced on the input string.
	 * @param maxLength
	 *            The maximum length to be enforced on the input string.
	 * @return This constraints instance for method chaining.
	 */
	public StringConstraints lengthRange(int minLength, int maxLength) {
		addValidator(StringLengthValidator.lengthRange(minLength, maxLength,
				lengthRangeMessage, integerDisplayFormat));
		return this;
	}

	/**
	 * Sets the validation message pattern for the
	 * {@link #lengthRange(int, int)} constraint.
	 * 
	 * @param message
	 *            The validation message pattern for the
	 *            {@link #lengthRange(int, int)} constraint. Can be
	 *            parameterized with the minimum and maximum string lengths.
	 * @return This constraints instance for method chaining.
	 * 
	 * @see #lengthRange(int, int)
	 */
	public StringConstraints lengthRangeMessage(String message) {
		this.lengthRangeMessage = message;
		return this;
	}

	/**
	 * Adds a validator ensuring that the input string
	 * {@link Pattern#matches(String, CharSequence) matches} the given regular
	 * expression. Uses the current {@link #matchesMessage(String) validation
	 * message}.
	 * 
	 * @param regex
	 *            The regular expression which the input string must match.
	 * @return This constraints instance for method chaining.
	 * 
	 * @see Pattern#matches(String, CharSequence)
	 */
	public StringConstraints matches(String regex) {
		addValidator(new StringRegexValidator(regex, matchesMessage));
		return this;
	}

	/**
	 * Sets the validation message pattern for the {@link #matches(String)}
	 * constraint.
	 * 
	 * @param message
	 *            The validation message pattern for the
	 *            {@link #matches(String)} constraint. Can be parameterized with
	 *            the pattern string which the parsed integer must match.
	 * @return This constraints instance for method chaining.
	 * 
	 * @see #matches(String)
	 */
	public StringConstraints matchesMessage(String message) {
		this.matchesMessage = message;
		return this;
	}
}




/*******************************************************************************
 * Copyright (c) 2009 Ovidio Mallo and others.
 * All rights reserved. This program and the accompanying materials
 * are made available under the terms of the Eclipse Public License v1.0
 * which accompanies this distribution, and is available at
 * http://www.eclipse.org/legal/epl-v10.html
 *
 * Contributors:
 *     Ovidio Mallo - initial API and implementation (bug 183055)
 ******************************************************************************/

package org.eclipse.core.databinding.editing;

import org.eclipse.core.databinding.Binding;
import org.eclipse.core.databinding.DataBindingContext;
import org.eclipse.core.databinding.UpdateListStrategy;
import org.eclipse.core.databinding.UpdateSetStrategy;
import org.eclipse.core.databinding.UpdateValueStrategy;
import org.eclipse.core.databinding.conversion.IConverter;
import org.eclipse.core.databinding.observable.list.IObservableList;
import org.eclipse.core.databinding.observable.set.IObservableSet;
import org.eclipse.core.databinding.observable.value.IObservableValue;
import org.eclipse.core.databinding.validation.IValidator;
import org.eclipse.core.databinding.validation.constraint.Constraints;
import org.eclipse.core.runtime.IStatus;
import org.eclipse.core.runtime.MultiStatus;

/**
 * @since 1.4
 */
public class Editing {

	private Constraints targetConstraints;

	private Constraints modelConstraints;

	private Constraints beforeSetModelConstraints;

	private IConverter targetConverter;

	private IConverter modelConverter;

	/**
	 * Default constructor which creates an unconfigured editing instance.
	 */
	protected Editing() {
		// empty editing instance
	}

	/**
	 * Creates an unconfigured editing instance.
	 * 
	 * @return A new, unconfigured editing instance.
	 */
	public static Editing create() {
		return new Editing();
	}

	/**
	 * Creates an editing instance with the given target-to-model and
	 * model-to-target converters.
	 * 
	 * @param t2mConverter
	 *            The target-to-model converter to set. May be <code>null</code>
	 *            .
	 * @param m2tConverter
	 *            The model-to-target converter to set. May be <code>null</code>
	 *            .
	 * @return A new editing instance with the given target-to-model and
	 *         model-to-target converters.
	 */
	public static Editing withConverters(IConverter t2mConverter,
			IConverter m2tConverter) {
		Editing editing = new Editing();
		editing.setTargetConverter(t2mConverter);
		editing.setModelConverter(m2tConverter);
		return editing;
	}

	/**
	 * Returns the target constraints to apply.
	 * 
	 * @return The target constraints to apply.
	 * 
	 * @see #createTargetConstraints()
	 */
	public final Constraints targetConstraints() {
		if (targetConstraints == null) {
			targetConstraints = createTargetConstraints();
		}
		return targetConstraints;
	}

	/**
	 * Returns the model constraints to apply.
	 * 
	 * @return The model constraints to apply.
	 * 
	 * @see #createModelConstraints()
	 */
	public final Constraints modelConstraints() {
		if (modelConstraints == null) {
			modelConstraints = createModelConstraints();
		}
		return modelConstraints;
	}

	/**
	 * Returns the before-set model constraints to apply.
	 * 
	 * @return The before-set model constraints to apply.
	 * 
	 * @see #createBeforeSetModelConstraints()
	 */
	public final Constraints beforeSetModelConstraints() {
		if (beforeSetModelConstraints == null) {
			beforeSetModelConstraints = createBeforeSetModelConstraints();
		}
		return beforeSetModelConstraints;
	}

	/**
	 * Creates the target constraints to apply.
	 * 
	 * <p>
	 * The constraints object created by this method will be exposed as the
	 * {@link #targetConstraints()} of this editing object. By default, this
	 * method returns a plain {@link Constraints} object.
	 * </p>
	 * 
	 * <p>
	 * This method will be called lazily the first time the target constraints
	 * are accessed. Subclasses may overwrite this method in order to create a
	 * custom constraints object which will then be typically exposed in the
	 * subclass as API in order to allow for a typesafe access.
	 * </p>
	 * 
	 * @return The target constraints to apply.
	 * 
	 * @see #targetConstraints()
	 */
	protected Constraints createTargetConstraints() {
		return new Constraints();
	}

	/**
	 * Creates the model constraints to apply.
	 * 
	 * <p>
	 * The constraints object created by this method will be exposed as the
	 * {@link #modelConstraints()} of this editing object. By default, this
	 * method returns a plain {@link Constraints} object.
	 * </p>
	 * 
	 * <p>
	 * This method will be called lazily the first time the model constraints
	 * are accessed. Subclasses may overwrite this method in order to create a
	 * custom constraints object which will then be typically exposed in the
	 * subclass as API in order to allow for a typesafe access.
	 * </p>
	 * 
	 * @return The model constraints to apply.
	 * 
	 * @see #modelConstraints()
	 */
	protected Constraints createModelConstraints() {
		return new Constraints();
	}

	/**
	 * Creates the before-set model constraints to apply.
	 * 
	 * <p>
	 * The constraints object created by this method will be exposed as the
	 * {@link #beforeSetModelConstraints()} of this editing object. By default,
	 * this method returns a plain {@link Constraints} object.
	 * </p>
	 * 
	 * <p>
	 * This method will be called lazily the first time the before-set model
	 * constraints are accessed. Subclasses may overwrite this method in order
	 * to create a custom constraints object which will then be typically
	 * exposed in the subclass as API in order to allow for a typesafe access.
	 * </p>
	 * 
	 * @return The before-set model constraints to apply.
	 * 
	 * @see #beforeSetModelConstraints()
	 */
	protected Constraints createBeforeSetModelConstraints() {
		return new Constraints();
	}

	/**
	 * Convenience method which {@link Constraints#addValidator(IValidator)
	 * adds} the given validator to the set of {@link #targetConstraints()}.
	 * 
	 * @param validator
	 *            The validator to add to the target constraints.
	 * @return This editing instance for method chaining.
	 * 
	 * @see Constraints#addValidator(IValidator)
	 * @see #targetConstraints()
	 */
	public final Editing addTargetValidator(IValidator validator) {
		targetConstraints().addValidator(validator);
		return this;
	}

	/**
	 * Convenience method which {@link Constraints#addValidator(IValidator)
	 * adds} the given validator to the set of {@link #modelConstraints()}.
	 * 
	 * @param validator
	 *            The validator to add to the model constraints.
	 * @return This editing instance for method chaining.
	 * 
	 * @see Constraints#addValidator(IValidator)
	 * @see #modelConstraints()
	 */
	public final Editing addModelValidator(IValidator validator) {
		modelConstraints().addValidator(validator);
		return this;
	}

	/**
	 * Convenience method which {@link Constraints#addValidator(IValidator)
	 * adds} the given validator to the set of
	 * {@link #beforeSetModelConstraints()}.
	 * 
	 * @param validator
	 *            The validator to add to the before-set model constraints.
	 * @return This editing instance for method chaining.
	 * 
	 * @see Constraints#addValidator(IValidator)
	 * @see #beforeSetModelConstraints
	 */
	public final Editing addBeforeSetModelValidator(IValidator validator) {
		beforeSetModelConstraints().addValidator(validator);
		return this;
	}

	/**
	 * Sets the target-to-model converter for this editing instance.
	 * 
	 * @param converter
	 *            The target-to-model converter to set.
	 */
	protected final void setTargetConverter(IConverter converter) {
		this.targetConverter = converter;
	}

	/**
	 * Sets the model-to-target converter for this editing instance.
	 * 
	 * @param converter
	 *            The model-to-target converter to set.
	 */
	protected final void setModelConverter(IConverter converter) {
		this.modelConverter = converter;
	}

	/**
	 * Creates a new target-to-model {@link UpdateValueStrategy} with a default
	 * update policy configured by the current state of this editing object.
	 * 
	 * @return A new target-to-model {@link UpdateValueStrategy} configured by
	 *         the current state of this editing object.
	 * 
	 * @see UpdateValueStrategy#UpdateValueStrategy()
	 * @see #applyToT2MValueStrategy(UpdateValueStrategy)
	 */
	public final UpdateValueStrategy createT2MValueStrategy() {
		return applyToT2MValueStrategy(new UpdateValueStrategy());
	}

	/**
	 * Creates a new target-to-model {@link UpdateValueStrategy} with the given
	 * update policy configured by the current state of this editing object.
	 * 
	 * @param updatePolicy
	 *            The update policy to use.
	 * @return A new target-to-model {@link UpdateValueStrategy} configured by
	 *         the current state of this editing object.
	 * 
	 * @see UpdateValueStrategy#UpdateValueStrategy(int)
	 * @see #applyToT2MValueStrategy(UpdateValueStrategy)
	 */
	public final UpdateValueStrategy createT2MValueStrategy(int updatePolicy) {
		return applyToT2MValueStrategy(new UpdateValueStrategy(updatePolicy));
	}

	/**
	 * Creates a new model-to-target {@link UpdateValueStrategy} with a default
	 * update policy configured by the current state of this editing object.
	 * 
	 * @return A new model-to-target {@link UpdateValueStrategy} configured by
	 *         the current state of this editing object.
	 * 
	 * @see UpdateValueStrategy#UpdateValueStrategy()
	 * @see #applyToM2TValueStrategy(UpdateValueStrategy)
	 */
	public final UpdateValueStrategy createM2TValueStrategy() {
		return applyToM2TValueStrategy(new UpdateValueStrategy());
	}

	/**
	 * Creates a new model-to-target {@link UpdateValueStrategy} with the given
	 * update policy configured by the current state of this editing object.
	 * 
	 * @param updatePolicy
	 *            The update policy to use.
	 * @return A new model-to-target {@link UpdateValueStrategy} configured by
	 *         the current state of this editing object.
	 * 
	 * @see UpdateValueStrategy#UpdateValueStrategy(int)
	 * @see #applyToM2TValueStrategy(UpdateValueStrategy)
	 */
	public final UpdateValueStrategy createM2TValueStrategy(int updatePolicy) {
		return applyToM2TValueStrategy(new UpdateValueStrategy(updatePolicy));
	}

	/**
	 * Creates a new target-to-model {@link UpdateListStrategy} with a default
	 * update policy configured by the current state of this editing object.
	 * 
	 * @return A new target-to-model {@link UpdateListStrategy} configured by
	 *         the current state of this editing object.
	 * 
	 * @see UpdateListStrategy#UpdateListStrategy()
	 * @see #applyToT2MListStrategy(UpdateListStrategy)
	 */
	public final UpdateListStrategy createT2MListStrategy() {
		return applyToT2MListStrategy(new UpdateListStrategy());
	}

	/**
	 * Creates a new target-to-model {@link UpdateListStrategy} with the given
	 * update policy configured by the current state of this editing object.
	 * 
	 * @param updatePolicy
	 *            The update policy to use.
	 * @return A new target-to-model {@link UpdateListStrategy} configured by
	 *         the current state of this editing object.
	 * 
	 * @see UpdateListStrategy#UpdateListStrategy(int)
	 * @see #applyToT2MListStrategy(UpdateListStrategy)
	 */
	public final UpdateListStrategy createT2MListStrategy(int updatePolicy) {
		return applyToT2MListStrategy(new UpdateListStrategy(updatePolicy));
	}

	/**
	 * Creates a new model-to-target {@link UpdateListStrategy} with a default
	 * update policy configured by the current state of this editing object.
	 * 
	 * @return A new model-to-target {@link UpdateListStrategy} configured by
	 *         the current state of this editing object.
	 * 
	 * @see UpdateListStrategy#UpdateListStrategy()
	 * @see #applyToM2TListStrategy(UpdateListStrategy)
	 */
	public final UpdateListStrategy createM2TListStrategy() {
		return applyToM2TListStrategy(new UpdateListStrategy());
	}

	/**
	 * Creates a new model-to-target {@link UpdateListStrategy} with the given
	 * update policy configured by the current state of this editing object.
	 * 
	 * @param updatePolicy
	 *            The update policy to use.
	 * @return A new model-to-target {@link UpdateListStrategy} configured by
	 *         the current state of this editing object.
	 * 
	 * @see UpdateListStrategy#UpdateListStrategy(int)
	 * @see #applyToM2TListStrategy(UpdateListStrategy)
	 */
	public final UpdateListStrategy createM2TListStrategy(int updatePolicy) {
		return applyToM2TListStrategy(new UpdateListStrategy(updatePolicy));
	}

	/**
	 * Creates a new target-to-model {@link UpdateSetStrategy} with a default
	 * update policy configured by the current state of this editing object.
	 * 
	 * @return A new target-to-model {@link UpdateSetStrategy} configured by the
	 *         current state of this editing object.
	 * 
	 * @see UpdateListStrategy#UpdateListStrategy()
	 * @see #applyToT2MSetStrategy(UpdateSetStrategy)
	 */
	public final UpdateSetStrategy createT2MSetStrategy() {
		return applyToT2MSetStrategy(new UpdateSetStrategy());
	}

	/**
	 * Creates a new target-to-model {@link UpdateListStrategy} with the given
	 * update policy configured by the current state of this editing object.
	 * 
	 * @param updatePolicy
	 *            The update policy to use.
	 * @return A new target-to-model {@link UpdateListStrategy} configured by
	 *         the current state of this editing object.
	 * 
	 * @see UpdateSetStrategy#UpdateSetStrategy(int)
	 * @see #applyToT2MSetStrategy(UpdateSetStrategy)
	 */
	public final UpdateSetStrategy createT2MSetStrategy(int updatePolicy) {
		return applyToT2MSetStrategy(new UpdateSetStrategy(updatePolicy));
	}

	/**
	 * Creates a new model-to-target {@link UpdateSetStrategy} with a default
	 * update policy configured by the current state of this editing object.
	 * 
	 * @return A new model-to-target {@link UpdateSetStrategy} configured by the
	 *         current state of this editing object.
	 * 
	 * @see UpdateSetStrategy#UpdateSetStrategy()
	 * @see #applyToM2TSetStrategy(UpdateSetStrategy)
	 */
	public final UpdateSetStrategy createM2TSetStrategy() {
		return applyToM2TSetStrategy(new UpdateSetStrategy());
	}

	/**
	 * Creates a new model-to-target {@link UpdateSetStrategy} with the given
	 * update policy configured by the current state of this editing object.
	 * 
	 * @param updatePolicy
	 *            The update policy to use.
	 * @return A new model-to-target {@link UpdateSetStrategy} configured by the
	 *         current state of this editing object.
	 * 
	 * @see UpdateSetStrategy#UpdateSetStrategy(int)
	 * @see #applyToM2TSetStrategy(UpdateSetStrategy)
	 */
	public final UpdateSetStrategy createM2TSetStrategy(int updatePolicy) {
		return applyToM2TSetStrategy(new UpdateSetStrategy(updatePolicy));
	}

	/**
	 * Configures an existing target-to-model {@link UpdateValueStrategy} with
	 * the current state of this editing object.
	 * 
	 * <p>
	 * The configuration is done as follows:
	 * <ul>
	 * <li>
	 * The {@link Constraints#createValidator() validator} of the
	 * {@link #targetConstraints() target constraints} is set as the
	 * {@link UpdateValueStrategy#setAfterGetValidator(IValidator) after-get
	 * validator} of the update strategy.</li>
	 * <li>The {@link #setTargetConverter(IConverter) target converter} is set
	 * as the {@link UpdateValueStrategy#setConverter(IConverter) converter} of
	 * the update strategy.</li>
	 * <li>
	 * The {@link Constraints#createValidator() validator} of the
	 * {@link #modelConstraints() model constraints} is set as the
	 * {@link UpdateValueStrategy#setAfterConvertValidator(IValidator)
	 * after-convert validator} of the update strategy.</li>
	 * <li>The {@link Constraints#createValidator() validator} of the
	 * {@link #beforeSetModelConstraints() before-set model constraints} is set
	 * as the {@link UpdateValueStrategy#setBeforeSetValidator(IValidator)
	 * before-set validator} of the update strategy.</li>
	 * </ul>
	 * </p>
	 * 
	 * @param updateStrategy
	 *            The {@link UpdateValueStrategy} to configure.
	 * @return The passed-in, configured target-to-model
	 *         {@link UpdateValueStrategy}.
	 * 
	 * @see UpdateValueStrategy#setAfterGetValidator(IValidator)
	 * @see UpdateValueStrategy#setConverter(IConverter)
	 * @see UpdateValueStrategy#setAfterConvertValidator(IValidator)
	 * @see UpdateValueStrategy#setBeforeSetValidator(IValidator)
	 */
	public final UpdateValueStrategy applyToT2MValueStrategy(
			UpdateValueStrategy updateStrategy) {
		updateStrategy.setAfterGetValidator(createValidator(targetConstraints));
		updateStrategy.setConverter(targetConverter);
		updateStrategy
				.setAfterConvertValidator(createValidator(modelConstraints));
		updateStrategy
				.setBeforeSetValidator(createValidator(beforeSetModelConstraints));
		return updateStrategy;
	}

	/**
	 * Configures an existing model-to-target {@link UpdateValueStrategy} with
	 * the current state of this editing object by setting the
	 * {@link #setModelConverter(IConverter) model converter} as the
	 * {@link UpdateValueStrategy#setConverter(IConverter) converter} of the
	 * update strategy.
	 * 
	 * @param updateStrategy
	 *            The {@link UpdateValueStrategy} to configure.
	 * @return The passed-in, configured model-to-target
	 *         {@link UpdateValueStrategy}.
	 * 
	 * @see UpdateValueStrategy#setConverter(IConverter)
	 */
	public final UpdateValueStrategy applyToM2TValueStrategy(
			UpdateValueStrategy updateStrategy) {
		updateStrategy.setConverter(modelConverter);
		return updateStrategy;
	}

	/**
	 * Configures an existing target-to-model {@link UpdateListStrategy} with
	 * the current state of this editing object by setting the
	 * {@link #setTargetConverter(IConverter) target converter} as the
	 * {@link UpdateListStrategy#setConverter(IConverter) converter} of the
	 * update strategy.
	 * 
	 * @param updateStrategy
	 *            The {@link UpdateListStrategy} to configure.
	 * @return The passed-in, configured target-to-model
	 *         {@link UpdateListStrategy}.
	 * 
	 * @see UpdateListStrategy#setConverter(IConverter)
	 */
	public final UpdateListStrategy applyToT2MListStrategy(
			UpdateListStrategy updateStrategy) {
		updateStrategy.setConverter(targetConverter);
		return updateStrategy;
	}

	/**
	 * Configures an existing model-to-target {@link UpdateListStrategy} with
	 * the current state of this editing object by setting the
	 * {@link #setModelConverter(IConverter) model converter} as the
	 * {@link UpdateListStrategy#setConverter(IConverter) converter} of the
	 * update strategy.
	 * 
	 * @param updateStrategy
	 *            The {@link UpdateListStrategy} to configure.
	 * @return The passed-in, configured model-to-target
	 *         {@link UpdateListStrategy}.
	 * 
	 * @see UpdateListStrategy#setConverter(IConverter)
	 */
	public final UpdateListStrategy applyToM2TListStrategy(
			UpdateListStrategy updateStrategy) {
		updateStrategy.setConverter(modelConverter);
		return updateStrategy;
	}

	/**
	 * Configures an existing target-to-model {@link UpdateListStrategy} with
	 * the current state of this editing object by setting the
	 * {@link #setTargetConverter(IConverter) target converter} as the
	 * {@link UpdateSetStrategy#setConverter(IConverter) converter} of the
	 * update strategy.
	 * 
	 * @param updateStrategy
	 *            The {@link UpdateSetStrategy} to configure.
	 * @return The passed-in, configured target-to-model
	 *         {@link UpdateSetStrategy}.
	 * 
	 * @see UpdateSetStrategy#setConverter(IConverter)
	 */
	public final UpdateSetStrategy applyToT2MSetStrategy(
			UpdateSetStrategy updateStrategy) {
		updateStrategy.setConverter(targetConverter);
		return updateStrategy;
	}

	/**
	 * Configures an existing model-to-target {@link UpdateSetStrategy} with the
	 * current state of this editing object by setting the
	 * {@link #setModelConverter(IConverter) model converter} as the
	 * {@link UpdateSetStrategy#setConverter(IConverter) converter} of the
	 * update strategy.
	 * 
	 * @param updateStrategy
	 *            The {@link UpdateSetStrategy} to configure.
	 * @return The passed-in, configured model-to-target
	 *         {@link UpdateSetStrategy}.
	 * 
	 * @see UpdateSetStrategy#setConverter(IConverter)
	 */
	public final UpdateSetStrategy applyToM2TSetStrategy(
			UpdateSetStrategy updateStrategy) {
		updateStrategy.setConverter(modelConverter);
		return updateStrategy;
	}

	/**
	 * Converts a target value to a model value by performing the following
	 * steps:
	 * <ul>
	 * <li>
	 * Applying all the {@link #targetConstraints() target constraints} to the
	 * given target value.</li>
	 * <li>
	 * {@link #setTargetConverter(IConverter) Converting} the target value to
	 * the model value.</li>
	 * <li>
	 * Applying all the {@link #modelConstraints() model constraints} to the
	 * converted model value.</li>
	 * <li>
	 * Applying all the {@link #beforeSetModelConstraints() before-set model
	 * constraints} to the converted model value.</li>
	 * </ul>
	 * 
	 * <p>
	 * The conversion process will be aborted by returning <code>null</code>
	 * whenever any of the applied validators produces a {@link IStatus
	 * validation status} having {@link IStatus#getSeverity() severity}
	 * <code>IStatus.ERROR</code> or <code>IStatus.CANCEL</code>. During the
	 * conversion process, any validation status whose severity is different
	 * from <code>IStatus.OK</code> will be {@link MultiStatus#merge(IStatus)
	 * aggregated} on the given <code>validationStatus</code>.
	 * </p>
	 * 
	 * @param targetValue
	 *            The target value to be converted to a model value.
	 * @param validationStatus
	 *            Aggregate validation status to which to add the validations
	 *            produced during the conversion process.
	 * @return The converted model value or <code>null</code> in case the
	 *         conversion has been aborted due to a validation error.
	 */
	public final Object convertToModel(Object targetValue,
			MultiStatus validationStatus) {
		IValidator targetValidator = createValidator(targetConstraints);
		if (!applyValidator(targetValidator, targetValue, validationStatus)) {
			return null;
		}

		Object modelValue = (targetConverter != null) ? targetConverter
				.convert(targetValue) : targetValue;

		IValidator modelValidator = createValidator(modelConstraints);
		if (!applyValidator(modelValidator, modelValue, validationStatus)) {
			return null;
		}

		IValidator beforeSetModelValidator = createValidator(beforeSetModelConstraints);
		if (!applyValidator(beforeSetModelValidator, modelValue,
				validationStatus)) {
			return null;
		}

		return modelValue;
	}

	/**
	 * {@link #setModelConverter(IConverter) Converts} a model value to a target
	 * value.
	 * 
	 * @param modelValue
	 *            The model value to be converted to a target value.
	 * @return The converted target value.
	 */
	public final Object convertToTarget(Object modelValue) {
		return (modelConverter != null) ? modelConverter.convert(modelValue)
				: modelValue;
	}

	/**
	 * Creates a binding between a target and model observable value on the
	 * given binding context by creating new update strategies which will be
	 * both configured with the state of this editing object before passing them
	 * to the binding.
	 * 
	 * <p>
	 * The target-to-model and model-to-target update strategies for the binding
	 * will be created by the methods {@link #createT2MValueStrategy()} and
	 * {@link #createM2TValueStrategy()}, respectively.
	 * </p>
	 * 
	 * @param dbc
	 *            The binding context on which to create the value binding.
	 * @param targetObservableValue
	 *            The target observable value of the binding.
	 * @param modelObservableValue
	 *            The model observable value of the binding.
	 * @return The new value binding.
	 * 
	 * @see #createT2MValueStrategy()
	 * @see #createM2TValueStrategy()
	 * @see DataBindingContext#bindValue(IObservableValue, IObservableValue,
	 *      UpdateValueStrategy, UpdateValueStrategy)
	 */
	public final Binding bindValue(DataBindingContext dbc,
			IObservableValue targetObservableValue,
			IObservableValue modelObservableValue) {
		return dbc.bindValue(targetObservableValue, modelObservableValue,
				createT2MValueStrategy(), createM2TValueStrategy());
	}

	/**
	 * Creates a binding between a target and model observable value on the
	 * given binding context by creating new update strategies with the provided
	 * update policies which will be both configured with the state of this
	 * editing object before passing them to the binding.
	 * 
	 * @param dbc
	 *            The binding context on which to create the value binding.
	 * @param targetObservableValue
	 *            The target observable value of the binding.
	 * @param modelObservableValue
	 *            The model observable value of the binding.
	 * @param t2mUpdatePolicy
	 *            The update policy for the target-to-model
	 *            {@link UpdateValueStrategy} which is
	 *            {@link #createT2MValueStrategy(int) created} and passed to the
	 *            new binding.
	 * @param m2tUpdatePolicy
	 *            The update policy for the model-to-target
	 *            {@link UpdateValueStrategy} which is
	 *            {@link #createM2TValueStrategy(int) created} and passed to the
	 *            new binding.
	 * @return The new value binding.
	 * 
	 * @see #createT2MValueStrategy(int)
	 * @see #createM2TValueStrategy(int)
	 * @see DataBindingContext#bindValue(IObservableValue, IObservableValue,
	 *      UpdateValueStrategy, UpdateValueStrategy)
	 */
	public final Binding bindValue(DataBindingContext dbc,
			IObservableValue targetObservableValue,
			IObservableValue modelObservableValue, int t2mUpdatePolicy,
			int m2tUpdatePolicy) {
		return dbc.bindValue(targetObservableValue, modelObservableValue,
				createT2MValueStrategy(t2mUpdatePolicy),
				createM2TValueStrategy(m2tUpdatePolicy));
	}

	/**
	 * Creates a binding between a target and model observable value on the
	 * given binding context by using the provided update strategies which will
	 * be both configured with the state of this editing object before passing
	 * them to the binding.
	 * 
	 * @param dbc
	 *            The binding context on which to create the value binding.
	 * @param targetObservableValue
	 *            The target observable value of the binding.
	 * @param modelObservableValue
	 *            The model observable value of the binding.
	 * @param t2mUpdateStrategy
	 *            The target-to-model {@link UpdateValueStrategy} of the binding
	 *            to be {@link #applyToT2MValueStrategy(UpdateValueStrategy)
	 *            configured} with the state of this editing object before
	 *            passing it to the binding.
	 * @param m2tUpdateStrategy
	 *            The model-to-target {@link UpdateValueStrategy} of the binding
	 *            to be {@link #applyToM2TValueStrategy(UpdateValueStrategy)
	 *            configured} with the state of this editing object before
	 *            passing it to the binding.
	 * @return The new value binding.
	 * 
	 * @see #applyToT2MValueStrategy(UpdateValueStrategy)
	 * @see #applyToM2TValueStrategy(UpdateValueStrategy)
	 * @see DataBindingContext#bindValue(IObservableValue, IObservableValue,
	 *      UpdateValueStrategy, UpdateValueStrategy)
	 */
	public final Binding bindValue(DataBindingContext dbc,
			IObservableValue targetObservableValue,
			IObservableValue modelObservableValue,
			UpdateValueStrategy t2mUpdateStrategy,
			UpdateValueStrategy m2tUpdateStrategy) {
		return dbc.bindValue(targetObservableValue, modelObservableValue,
				applyToT2MValueStrategy(t2mUpdateStrategy),
				applyToM2TValueStrategy(m2tUpdateStrategy));
	}

	/**
	 * Creates a binding between a target and model observable list on the given
	 * binding context by creating new update strategies which will be both
	 * configured with the state of this editing object before passing them to
	 * the binding.
	 * 
	 * <p>
	 * The target-to-model and model-to-target update strategies for the binding
	 * will be created by the methods {@link #createT2MListStrategy()} and
	 * {@link #createM2TListStrategy()}, respectively.
	 * </p>
	 * 
	 * @param dbc
	 *            The binding context on which to create the list binding.
	 * @param targetObservableList
	 *            The target observable list of the binding.
	 * @param modelObservableList
	 *            The model observable list of the binding.
	 * @return The new list binding.
	 * 
	 * @see #createT2MListStrategy()
	 * @see #createM2TListStrategy()
	 * @see DataBindingContext#bindList(IObservableList, IObservableList,
	 *      UpdateListStrategy, UpdateListStrategy)
	 */
	public final Binding bindList(DataBindingContext dbc,
			IObservableList targetObservableList,
			IObservableList modelObservableList) {
		return dbc.bindList(targetObservableList, modelObservableList,
				createT2MListStrategy(), createM2TListStrategy());
	}

	/**
	 * Creates a binding between a target and model observable list on the given
	 * binding context by creating new update strategies with the provided
	 * update policies which will be both configured with the state of this
	 * editing object before passing them to the binding.
	 * 
	 * @param dbc
	 *            The binding context on which to create the list binding.
	 * @param targetObservableList
	 *            The target observable list of the binding.
	 * @param modelObservableList
	 *            The model observable list of the binding.
	 * @param t2mUpdatePolicy
	 *            The update policy for the target-to-model
	 *            {@link UpdateListStrategy} which is
	 *            {@link #createT2MListStrategy(int) created} and passed to the
	 *            new binding.
	 * @param m2tUpdatePolicy
	 *            The update policy for the model-to-target
	 *            {@link UpdateListStrategy} which is
	 *            {@link #createM2TListStrategy(int) created} and passed to the
	 *            new binding.
	 * @return The new list binding.
	 * 
	 * @see #createT2MListStrategy(int)
	 * @see #createM2TListStrategy(int)
	 * @see DataBindingContext#bindList(IObservableList, IObservableList,
	 *      UpdateListStrategy, UpdateListStrategy)
	 */
	public final Binding bindList(DataBindingContext dbc,
			IObservableList targetObservableList,
			IObservableList modelObservableList, int t2mUpdatePolicy,
			int m2tUpdatePolicy) {
		return dbc.bindList(targetObservableList, modelObservableList,
				createT2MListStrategy(t2mUpdatePolicy),
				createM2TListStrategy(m2tUpdatePolicy));
	}

	/**
	 * Creates a binding between a target and model observable list on the given
	 * binding context by using the provided update strategies which will be
	 * both configured with the state of this editing object before passing them
	 * to the binding.
	 * 
	 * @param dbc
	 *            The binding context on which to create the list binding.
	 * @param targetObservableList
	 *            The target observable list of the binding.
	 * @param modelObservableList
	 *            The model observable list of the binding.
	 * @param t2mUpdateStrategy
	 *            The target-to-model {@link UpdateListStrategy} of the binding
	 *            to be {@link #applyToT2MListStrategy(UpdateListStrategy)
	 *            configured} with the state of this editing object before
	 *            passing it to the binding.
	 * @param m2tUpdateStrategy
	 *            The model-to-target {@link UpdateListStrategy} of the binding
	 *            to be {@link #applyToM2TListStrategy(UpdateListStrategy)
	 *            configured} with the state of this editing object before
	 *            passing it to the binding.
	 * @return The new list binding.
	 * 
	 * @see #applyToT2MListStrategy(UpdateListStrategy)
	 * @see #applyToM2TListStrategy(UpdateListStrategy)
	 * @see DataBindingContext#bindList(IObservableList, IObservableList,
	 *      UpdateListStrategy, UpdateListStrategy)
	 */
	public final Binding bindList(DataBindingContext dbc,
			IObservableList targetObservableList,
			IObservableList modelObservableList,
			UpdateListStrategy t2mUpdateStrategy,
			UpdateListStrategy m2tUpdateStrategy) {
		return dbc.bindList(targetObservableList, modelObservableList,
				applyToT2MListStrategy(t2mUpdateStrategy),
				applyToM2TListStrategy(m2tUpdateStrategy));
	}

	/**
	 * Creates a binding between a target and model observable set on the given
	 * binding context by creating new update strategies which will be both
	 * configured with the state of this editing object before passing them to
	 * the binding.
	 * 
	 * <p>
	 * The target-to-model and model-to-target update strategies for the binding
	 * will be created by the methods {@link #createT2MSetStrategy()} and
	 * {@link #createM2TSetStrategy()}, respectively.
	 * </p>
	 * 
	 * @param dbc
	 *            The binding context on which to create the set binding.
	 * @param targetObservableSet
	 *            The target observable set of the binding.
	 * @param modelObservableSet
	 *            The model observable set of the binding.
	 * @return The new set binding.
	 * 
	 * @see #createT2MSetStrategy()
	 * @see #createM2TSetStrategy()
	 * @see DataBindingContext#bindSet(IObservableSet, IObservableSet,
	 *      UpdateSetStrategy, UpdateSetStrategy)
	 */
	public final Binding bindSet(DataBindingContext dbc,
			IObservableSet targetObservableSet,
			IObservableSet modelObservableSet) {
		return dbc.bindSet(targetObservableSet, modelObservableSet,
				createT2MSetStrategy(), createM2TSetStrategy());
	}

	/**
	 * Creates a binding between a target and model observable set on the given
	 * binding context by creating new update strategies with the provided
	 * update policies which will be both configured with the state of this
	 * editing object before passing them to the binding.
	 * 
	 * @param dbc
	 *            The binding context on which to create the set binding.
	 * @param targetObservableSet
	 *            The target observable set of the binding.
	 * @param modelObservableSet
	 *            The model observable set of the binding.
	 * @param t2mUpdatePolicy
	 *            The update policy for the target-to-model
	 *            {@link UpdateSetStrategy} which is
	 *            {@link #createT2MSetStrategy(int) created} and passed to the
	 *            new binding.
	 * @param m2tUpdatePolicy
	 *            The update policy for the model-to-target
	 *            {@link UpdateSetStrategy} which is
	 *            {@link #createM2TSetStrategy(int) created} and passed to the
	 *            new binding.
	 * @return The new set binding.
	 * 
	 * @see #createT2MSetStrategy(int)
	 * @see #createM2TSetStrategy(int)
	 * @see DataBindingContext#bindSet(IObservableSet, IObservableSet,
	 *      UpdateSetStrategy, UpdateSetStrategy)
	 */
	public final Binding bindSet(DataBindingContext dbc,
			IObservableSet targetObservableSet,
			IObservableSet modelObservableSet, int t2mUpdatePolicy,
			int m2tUpdatePolicy) {
		return dbc.bindSet(targetObservableSet, modelObservableSet,
				createT2MSetStrategy(t2mUpdatePolicy),
				createM2TSetStrategy(m2tUpdatePolicy));
	}

	/**
	 * Creates a binding between a target and model observable set on the given
	 * binding context by using the provided update strategies which will be
	 * both configured with the state of this editing object before passing them
	 * to the binding.
	 * 
	 * @param dbc
	 *            The binding context on which to create the set binding.
	 * @param targetObservableSet
	 *            The target observable set of the binding.
	 * @param modelObservableSet
	 *            The model observable set of the binding.
	 * @param t2mUpdateStrategy
	 *            The target-to-model {@link UpdateSetStrategy} of the binding
	 *            to be {@link #applyToT2MSetStrategy(UpdateSetStrategy)
	 *            configured} with the state of this editing object before
	 *            passing it to the binding.
	 * @param m2tUpdateStrategy
	 *            The model-to-target {@link UpdateSetStrategy} of the binding
	 *            to be {@link #applyToM2TSetStrategy(UpdateSetStrategy)
	 *            configured} with the state of this editing object before
	 *            passing it to the binding.
	 * @return The new set binding.
	 * 
	 * @see #applyToT2MSetStrategy(UpdateSetStrategy)
	 * @see #applyToM2TSetStrategy(UpdateSetStrategy)
	 * @see DataBindingContext#bindSet(IObservableSet, IObservableSet,
	 *      UpdateSetStrategy, UpdateSetStrategy)
	 */
	public final Binding bindSet(DataBindingContext dbc,
			IObservableSet targetObservableSet,
			IObservableSet modelObservableSet,
			UpdateSetStrategy t2mUpdateStrategy,
			UpdateSetStrategy m2tUpdateStrategy) {
		return dbc.bindSet(targetObservableSet, modelObservableSet,
				applyToT2MSetStrategy(t2mUpdateStrategy),
				applyToM2TSetStrategy(m2tUpdateStrategy));
	}

	private static IValidator createValidator(Constraints constraints) {
		return constraints != null ? constraints.createValidator() : null;
	}

	private static boolean applyValidator(IValidator validator, Object value,
			MultiStatus aggregateStatus) {
		if (validator != null) {
			IStatus validationStatus = validator.validate(value);
			if (!validationStatus.isOK()) {
				aggregateStatus.merge(validationStatus);
			}
			return isValid(validationStatus);
		}
		return true;
	}

	private static boolean isValid(IStatus status) {
		return status.isOK() || status.matches(IStatus.INFO | IStatus.WARNING);
	}
}




/*******************************************************************************
 * Copyright (c) 2009 Ovidio Mallo and others.
 * All rights reserved. This program and the accompanying materials
 * are made available under the terms of the Eclipse Public License v1.0
 * which accompanies this distribution, and is available at
 * http://www.eclipse.org/legal/epl-v10.html
 *
 * Contributors:
 *     Ovidio Mallo - initial API and implementation (bug 183055)
 ******************************************************************************/

package org.eclipse.core.databinding.validation.constraint;

import org.eclipse.core.internal.databinding.validation.IntegerRangeValidator;
import org.eclipse.core.internal.databinding.validation.NonNullValidator;

import com.ibm.icu.text.NumberFormat;

/**
 * @since 1.4
 */
public final class IntegerConstraints extends Constraints {

	private NumberFormat displayFormat = NumberFormat.getIntegerInstance();

	private String requiredMessage = null;

	private String greaterMessage = null;

	private String greaterEqualMessage = null;

	private String lessMessage = null;

	private String lessEqualMessage = null;

	private String rangeMessage = null;

	private String positiveMessage = null;

	private String nonNegativeMessage = null;

	/**
	 * Sets the format to use when formatting an integer to be included in any
	 * of the validation messages.
	 * 
	 * <p>
	 * This integer format will be used for any subsequent constraints which are
	 * applied.
	 * </p>
	 * 
	 * @param format
	 *            The format to use for displaying integers in validation
	 *            messages.
	 * @return This constraints instance for method chaining.
	 */
	public IntegerConstraints displayFormat(NumberFormat format) {
		this.displayFormat = format;
		return this;
	}

	/**
	 * Adds a validator ensuring that the parsed integer is not
	 * <code>null</code>. Uses the current {@link #requiredMessage(String)
	 * validation message}.
	 * 
	 * @return This constraints instance for method chaining.
	 */
	public IntegerConstraints required() {
		addValidator(new NonNullValidator(requiredMessage));
		return this;
	}

	/**
	 * Sets the validation message for the {@link #required()} constraint.
	 * 
	 * @param message
	 *            The validation message for the {@link #required()} constraint.
	 * @return This constraints instance for method chaining.
	 * 
	 * @see #required()
	 */
	public IntegerConstraints requiredMessage(String message) {
		this.requiredMessage = message;
		return this;
	}

	/**
	 * Adds a validator ensuring that the parsed integer is greater than the
	 * given number. Uses the current {@link #greaterMessage(String) validation
	 * message}.
	 * 
	 * @param number
	 *            The number which the parsed integer must be greater than.
	 * @return This constraints instance for method chaining.
	 */
	public IntegerConstraints greater(int number) {
		addValidator(IntegerRangeValidator.greater(number, greaterMessage,
				displayFormat));
		return this;
	}

	/**
	 * Sets the validation message pattern for the {@link #greater(int)}
	 * constraint.
	 * 
	 * @param message
	 *            The validation message pattern for the {@link #greater(int)}
	 *            constraint. Can be parameterized with the number which the
	 *            parsed integer must be greater than.
	 * @return This constraints instance for method chaining.
	 * 
	 * @see #greater(int)
	 */
	public IntegerConstraints greaterMessage(String message) {
		this.greaterMessage = message;
		return this;
	}

	/**
	 * Adds a validator ensuring that the parsed integer is greater than or
	 * equal to the given number. Uses the current
	 * {@link #greaterEqualMessage(String) validation message}.
	 * 
	 * @param number
	 *            The number which the parsed integer must be greater than or
	 *            equal to.
	 * @return This constraints instance for method chaining.
	 */
	public IntegerConstraints greaterEqual(int number) {
		addValidator(IntegerRangeValidator.greaterEqual(number,
				greaterEqualMessage, displayFormat));
		return this;
	}

	/**
	 * Sets the validation message pattern for the {@link #greaterEqual(int)}
	 * constraint.
	 * 
	 * @param message
	 *            The validation message pattern for the
	 *            {@link #greaterEqual(int)} constraint. Can be parameterized
	 *            with the number which the parsed integer must be greater than
	 *            or equal to.
	 * @return This constraints instance for method chaining.
	 * 
	 * @see #greaterEqual(int)
	 */
	public IntegerConstraints greaterEqualMessage(String message) {
		this.greaterEqualMessage = message;
		return this;
	}

	/**
	 * Adds a validator ensuring that the parsed integer is less than the given
	 * number. Uses the current {@link #lessMessage(String) validation message}.
	 * 
	 * @param number
	 *            The number which the parsed integer must be less than.
	 * @return This constraints instance for method chaining.
	 */
	public IntegerConstraints less(int number) {
		addValidator(IntegerRangeValidator.less(number, lessMessage,
				displayFormat));
		return this;
	}

	/**
	 * Sets the validation message pattern for the {@link #less(int)}
	 * constraint.
	 * 
	 * @param message
	 *            The validation message pattern for the {@link #less(int)}
	 *            constraint. Can be parameterized with the number which the
	 *            parsed integer must be less than.
	 * @return This constraints instance for method chaining.
	 * 
	 * @see #less(int)
	 */
	public IntegerConstraints lessMessage(String message) {
		this.lessMessage = message;
		return this;
	}

	/**
	 * Adds a validator ensuring that the parsed integer is less than or equal
	 * to the given number. Uses the current {@link #lessEqualMessage(String)
	 * validation message}.
	 * 
	 * @param number
	 *            The number which the parsed integer must be less than or equal
	 *            to.
	 * @return This constraints instance for method chaining.
	 */
	public IntegerConstraints lessEqual(int number) {
		addValidator(IntegerRangeValidator.greaterEqual(number,
				lessEqualMessage, displayFormat));
		return this;
	}

	/**
	 * Sets the validation message pattern for the {@link #lessEqual(int)}
	 * constraint.
	 * 
	 * @param message
	 *            The validation message pattern for the {@link #lessEqual(int)}
	 *            constraint. Can be parameterized with the number which the
	 *            parsed integer must be less than or equal to.
	 * @return This constraints instance for method chaining.
	 * 
	 * @see #lessEqual(int)
	 */
	public IntegerConstraints lessEqualMessage(String message) {
		this.lessEqualMessage = message;
		return this;
	}

	/**
	 * Adds a validator ensuring that the parsed integer is within the given
	 * range. Uses the current {@link #rangeMessage(String) validation message}.
	 * 
	 * @param min
	 *            The lower bound of the range (inclusive).
	 * @param max
	 *            The upper bound of the range (inclusive).
	 * @return This constraints instance for method chaining.
	 */
	public IntegerConstraints range(int min, int max) {
		addValidator(IntegerRangeValidator.range(min, max, rangeMessage,
				displayFormat));
		return this;
	}

	/**
	 * Sets the validation message pattern for the {@link #range(int, int)}
	 * constraint.
	 * 
	 * @param message
	 *            The validation message pattern for the
	 *            {@link #range(int, int)} constraint. Can be parameterized with
	 *            the min and max values of the range in which the parsed
	 *            integer must lie.
	 * @return This constraints instance for method chaining.
	 * 
	 * @see #range(int, int)
	 */
	public IntegerConstraints rangeMessage(String message) {
		this.rangeMessage = message;
		return this;
	}

	/**
	 * Adds a validator ensuring that the parsed integer is positive. Uses the
	 * current {@link #positiveMessage(String) validation message}.
	 * 
	 * @return This constraints instance for method chaining.
	 */
	public IntegerConstraints positive() {
		addValidator(IntegerRangeValidator.positive(positiveMessage,
				displayFormat));
		return this;
	}

	/**
	 * Sets the validation message pattern for the {@link #positive()}
	 * constraint.
	 * 
	 * @param message
	 *            The validation message pattern for the {@link #positive()}
	 *            constraint.
	 * @return This constraints instance for method chaining.
	 * 
	 * @see #positive()
	 */
	public IntegerConstraints positiveMessage(String message) {
		this.positiveMessage = message;
		return this;
	}

	/**
	 * Adds a validator ensuring that the parsed integer is non-negative. Uses
	 * the current {@link #nonNegativeMessage(String) validation message}.
	 * 
	 * @return This constraints instance for method chaining.
	 */
	public IntegerConstraints nonNegative() {
		addValidator(IntegerRangeValidator.nonNegative(nonNegativeMessage,
				displayFormat));
		return this;
	}

	/**
	 * Sets the validation message pattern for the {@link #nonNegative()}
	 * constraint.
	 * 
	 * @param message
	 *            The validation message pattern for the {@link #nonNegative()}
	 *            constraint.
	 * @return This constraints instance for method chaining.
	 * 
	 * @see #nonNegative()
	 */
	public IntegerConstraints nonNegativeMessage(String message) {
		this.nonNegativeMessage = message;
		return this;
	}
}




/*******************************************************************************
 * Copyright (c) 2009 Ovidio Mallo and others.
 * All rights reserved. This program and the accompanying materials
 * are made available under the terms of the Eclipse Public License v1.0
 * which accompanies this distribution, and is available at
 * http://www.eclipse.org/legal/epl-v10.html
 *
 * Contributors:
 *     Ovidio Mallo - initial API and implementation (bug 183055)
 ******************************************************************************/

package org.eclipse.core.databinding.editing;

import org.eclipse.core.databinding.conversion.NumberToStringConverter;
import org.eclipse.core.databinding.conversion.StringToNumberConverter;
import org.eclipse.core.databinding.validation.constraint.Constraints;
import org.eclipse.core.databinding.validation.constraint.IntegerConstraints;
import org.eclipse.core.databinding.validation.constraint.StringConstraints;
import org.eclipse.core.internal.databinding.validation.StringToIntegerValidator;

import com.ibm.icu.text.NumberFormat;

/**
 * @since 1.4
 */
public final class IntegerEditing extends Editing {

	private final NumberFormat displayFormat;

	private IntegerEditing(NumberFormat format, String parseErrorMessage,
			String outOfRangeMessage) {
		this.displayFormat = format;

		StringToNumberConverter targetConverter = StringToNumberConverter
				.toInteger(format, false);
		NumberToStringConverter modelConverter = NumberToStringConverter
				.fromInteger(format, false);

		StringToIntegerValidator targetValidator = new StringToIntegerValidator(
				targetConverter);
		if (parseErrorMessage != null) {
			targetValidator.setParseErrorMessage(parseErrorMessage);
		}
		if (outOfRangeMessage != null) {
			targetValidator.setOutOfRangeMessage(outOfRangeMessage);
		}

		targetConstraints().addValidator(targetValidator);
		setTargetConverter(targetConverter);
		setModelConverter(modelConverter);
	}

	/**
	 * Creates a new editing object which defaults the validations and
	 * conversions used for editing based on the platform's locale. Uses the
	 * default validation messages.
	 * 
	 * @return The new editing object using the default validations and
	 *         conversions for editing.
	 * 
	 * @see NumberFormat#getIntegerInstance()
	 */
	public static IntegerEditing withDefaults() {
		return withDefaults(null, null);
	}

	/**
	 * Creates a new editing object which defaults the validations and
	 * conversions used for editing based on the platform's locale. Uses the
	 * specified custom validation messages.
	 * 
	 * @param parseErrorMessage
	 *            The validation message issued in case the input string cannot
	 *            be parsed to an integer.
	 * @param outOfRangeMessage
	 *            The validation message issued in case the input string
	 *            represents an integer whose value is out of range. Can be
	 *            parameterized by the <code>Integer.MIN_VALUE</code> and
	 *            <code>Integer.MAX_VALUE</code> values.
	 * @return The new editing object using the default validations and
	 *         conversions for editing.
	 * 
	 * @see NumberFormat#getIntegerInstance()
	 */
	public static IntegerEditing withDefaults(String parseErrorMessage,
			String outOfRangeMessage) {
		return new IntegerEditing(NumberFormat.getIntegerInstance(),
				parseErrorMessage, outOfRangeMessage);
	}

	/**
	 * Creates a new editing object whose validations and conversions used for
	 * editing are based on the given integer format. Uses the default
	 * validation messages.
	 * 
	 * @param format
	 *            The integer format defining the validations and conversions
	 *            used for editing.
	 * @return The new editing object configured by the given integer format.
	 */
	public static IntegerEditing forFormat(NumberFormat format) {
		return forFormat(format, null, null);
	}

	/**
	 * Creates a new editing object whose validations and conversions used for
	 * editing are based on the given integer format. Uses the specified custom
	 * validation messages.
	 * 
	 * @param format
	 *            The integer format defining the validations and conversions
	 *            used for editing.
	 * @param parseErrorMessage
	 *            The validation message issued in case the input string cannot
	 *            be parsed to an integer.
	 * @param outOfRangeMessage
	 *            The validation message issued in case the input string
	 *            represents an integer whose value is out of range. Can be
	 *            parameterized by the <code>Integer.MIN_VALUE</code> and
	 *            <code>Integer.MAX_VALUE</code> values.
	 * @return The new editing object configured by the given integer format.
	 */
	public static IntegerEditing forFormat(NumberFormat format,
			String parseErrorMessage, String outOfRangeMessage) {
		return new IntegerEditing(format, parseErrorMessage, outOfRangeMessage);
	}

	/**
	 * Returns the target constraints to apply.
	 * 
	 * <p>
	 * This method provides a typesafe access to the {@link StringConstraints
	 * string target constraints} of this editing object and is equivalent to
	 * {@code (StringConstraints) targetConstraints()}.
	 * </p>
	 * 
	 * @return The target constraints to apply.
	 * 
	 * @see #targetConstraints()
	 * @see StringConstraints
	 */
	public StringConstraints targetStringConstraints() {
		return (StringConstraints) targetConstraints();
	}

	/**
	 * Returns the model constraints to apply.
	 * 
	 * <p>
	 * This method provides a typesafe access to the {@link IntegerConstraints
	 * integer model constraints} of this editing object and is equivalent to
	 * {@code (IntegerConstraints) modelConstraints()}.
	 * </p>
	 * 
	 * @return The target constraints to apply.
	 * 
	 * @see #modelConstraints()
	 * @see IntegerConstraints
	 */
	public IntegerConstraints modelIntegerConstraints() {
		return (IntegerConstraints) modelConstraints();
	}

	/**
	 * Returns the before-set model constraints to apply.
	 * 
	 * <p>
	 * This method provides a typesafe access to the {@link IntegerConstraints
	 * integer before-set model constraints} of this editing object and is
	 * equivalent to {@code (IntegerConstraints) beforeSetModelConstraints()}.
	 * </p>
	 * 
	 * @return The target constraints to apply.
	 * 
	 * @see #beforeSetModelConstraints()
	 * @see IntegerConstraints
	 */
	public IntegerConstraints beforeSetModelIntegerConstraints() {
		return (IntegerConstraints) beforeSetModelConstraints();
	}

	protected Constraints createTargetConstraints() {
		return new StringConstraints();
	}

	protected Constraints createModelConstraints() {
		return new IntegerConstraints().displayFormat(displayFormat);
	}

	protected Constraints createBeforeSetModelConstraints() {
		return new IntegerConstraints().displayFormat(displayFormat);
	}

	/**
	 * Convenience method which adds a {@link IntegerConstraints#required()
	 * required constraint} to the set of {@link #modelIntegerConstraints()}.
	 * 
	 * @return This editing instance for method chaining.
	 * 
	 * @see IntegerConstraints#required()
	 * @see #modelIntegerConstraints()
	 */
	public IntegerEditing required() {
		modelIntegerConstraints().required();
		return this;
	}

	/**
	 * Convenience method which adds a {@link IntegerConstraints#greater(int)
	 * greater constraint} to the set of {@link #modelIntegerConstraints()}.
	 * 
	 * @param number
	 *            The number of the greater constraint.
	 * @return This editing instance for method chaining.
	 * 
	 * @see IntegerConstraints#greater(int)
	 * @see #modelIntegerConstraints()
	 */
	public IntegerEditing greater(int number) {
		modelIntegerConstraints().greater(number);
		return this;
	}

	/**
	 * Convenience method which adds a
	 * {@link IntegerConstraints#greaterEqual(int) greater-equal constraint} to
	 * the set of {@link #modelIntegerConstraints()}.
	 * 
	 * @param number
	 *            The number of the greater-equal constraint.
	 * @return This editing instance for method chaining.
	 * 
	 * @see IntegerConstraints#greaterEqual(int)
	 * @see #modelIntegerConstraints()
	 */
	public IntegerEditing greaterEqual(int number) {
		modelIntegerConstraints().greaterEqual(number);
		return this;
	}

	/**
	 * Convenience method which adds a {@link IntegerConstraints#less(int) less
	 * constraint} to the set of {@link #modelIntegerConstraints()}.
	 * 
	 * @param number
	 *            The number of the less constraint.
	 * @return This editing instance for method chaining.
	 * 
	 * @see IntegerConstraints#less(int)
	 * @see #modelIntegerConstraints()
	 */
	public IntegerEditing less(int number) {
		modelIntegerConstraints().less(number);
		return this;
	}

	/**
	 * Convenience method which adds a {@link IntegerConstraints#lessEqual(int)
	 * less-equal constraint} to the set of {@link #modelIntegerConstraints()}.
	 * 
	 * @param number
	 *            The number of the less-equal constraint.
	 * @return This editing instance for method chaining.
	 * 
	 * @see IntegerConstraints#lessEqual(int)
	 * @see #modelIntegerConstraints()
	 */
	public IntegerEditing lessEqual(int number) {
		modelIntegerConstraints().lessEqual(number);
		return this;
	}

	/**
	 * Convenience method which adds a
	 * {@link IntegerConstraints#range(int, int) range constraint} to the set of
	 * {@link #modelIntegerConstraints()}.
	 * 
	 * @param min
	 *            The min number of the range constraint.
	 * @param max
	 *            The max number of the range constraint.
	 * @return This editing instance for method chaining.
	 * 
	 * @see IntegerConstraints#range(int, int)
	 * @see #modelIntegerConstraints()
	 */
	public IntegerEditing range(int min, int max) {
		modelIntegerConstraints().range(min, max);
		return this;
	}

	/**
	 * Convenience method which adds a {@link IntegerConstraints#positive()
	 * positive constraint} to the set of {@link #modelIntegerConstraints()}.
	 * 
	 * @return This editing instance for method chaining.
	 * 
	 * @see IntegerConstraints#positive()
	 * @see #modelIntegerConstraints()
	 */
	public IntegerEditing positive() {
		modelIntegerConstraints().positive();
		return this;
	}

	/**
	 * Convenience method which adds a {@link IntegerConstraints#nonNegative()
	 * non-negative constraint} to the set of {@link #modelIntegerConstraints()}
	 * .
	 * 
	 * @return This editing instance for method chaining.
	 * 
	 * @see IntegerConstraints#nonNegative()
	 * @see #modelIntegerConstraints()
	 */
	public IntegerEditing nonNegative() {
		modelIntegerConstraints().nonNegative();
		return this;
	}
}




/*******************************************************************************
 * Copyright (c) 2009 Ovidio Mallo and others.
 * All rights reserved. This program and the accompanying materials
 * are made available under the terms of the Eclipse Public License v1.0
 * which accompanies this distribution, and is available at
 * http://www.eclipse.org/legal/epl-v10.html
 *
 * Contributors:
 *     Ovidio Mallo - initial API and implementation (bug 183055)
 ******************************************************************************/

package org.eclipse.core.databinding.editing;

import java.util.Date;

import org.eclipse.core.databinding.validation.constraint.Constraints;
import org.eclipse.core.databinding.validation.constraint.DateConstraints;
import org.eclipse.core.databinding.validation.constraint.StringConstraints;
import org.eclipse.core.internal.databinding.conversion.DateToStringConverter;
import org.eclipse.core.internal.databinding.conversion.StringToDateConverter;
import org.eclipse.core.internal.databinding.validation.StringToDateValidator;

import com.ibm.icu.text.DateFormat;

/**
 * @since 1.4
 */
public final class DateEditing extends Editing {

	private final DateFormat displayFormat;

	private DateEditing(DateFormat[] inputFormats, String parseErrorMessage,
			DateFormat displayFormat) {
		this.displayFormat = displayFormat;

		StringToDateConverter targetConverter = new StringToDateConverter();
		if (inputFormats != null) {
			targetConverter.setFormatters(inputFormats);
		}

		DateToStringConverter modelConverter = new DateToStringConverter();
		if (displayFormat != null) {
			modelConverter.setFormatters(new DateFormat[] { displayFormat });
		}

		StringToDateValidator targetValidator = new StringToDateValidator(
				targetConverter);
		if (parseErrorMessage != null) {
			targetValidator.setParseErrorMessage(parseErrorMessage);
		}

		setTargetConverter(targetConverter);
		setModelConverter(modelConverter);
		targetConstraints().addValidator(targetValidator);
	}

	/**
	 * Creates a new editing object which defaults the validations and
	 * conversions used for editing. Uses the default validation message.
	 * 
	 * @return The new editing object using the default validations and
	 *         conversions for editing.
	 */
	public static DateEditing withDefaults() {
		return withDefaults(null);
	}

	/**
	 * Creates a new editing object which defaults the validations and
	 * conversions used for editing. Uses the specified custom validation
	 * message.
	 * 
	 * @param parseErrorMessage
	 *            The validation message issued in case the input string cannot
	 *            be parsed to a date.
	 * @return The new editing object using the default validations and
	 *         conversions for editing.
	 */
	public static DateEditing withDefaults(String parseErrorMessage) {
		return new DateEditing(null, parseErrorMessage, null);
	}

	/**
	 * Creates a new editing object which supports all the given date input
	 * formats and which uses the specified format for displaying a date. Uses
	 * the default validation message.
	 * 
	 * @param inputFormats
	 *            The date formats supported for reading in dates.
	 * @param displayFormat
	 *            The date format for displaying dates.
	 * @return The new editing object configured by the given date formats.
	 */
	public static DateEditing forFormats(DateFormat[] inputFormats,
			DateFormat displayFormat) {
		return new DateEditing(inputFormats, null, displayFormat);
	}

	/**
	 * Creates a new editing object which supports all the given date input
	 * formats and which uses the specified format for displaying a date. Uses
	 * the specified custom validation message.
	 * 
	 * @param inputFormats
	 *            The date formats supported for reading in dates.
	 * @param parseErrorMessage
	 *            The validation message issued in case the input string cannot
	 *            be parsed to a date.
	 * @param displayFormat
	 *            The date format for displaying dates.
	 * @return The new editing object configured by the given date formats.
	 */
	public static DateEditing forFormats(DateFormat[] inputFormats,
			String parseErrorMessage, DateFormat displayFormat) {
		return new DateEditing(inputFormats, parseErrorMessage, displayFormat);
	}

	/**
	 * Returns the target constraints to apply.
	 * 
	 * <p>
	 * This method provides a typesafe access to the {@link StringConstraints
	 * string target constraints} of this editing object and is equivalent to
	 * {@code (StringConstraints) targetConstraints()}.
	 * </p>
	 * 
	 * @return The target constraints to apply.
	 * 
	 * @see #targetConstraints()
	 * @see StringConstraints
	 */
	public StringConstraints targetStringConstraints() {
		return (StringConstraints) targetConstraints();
	}

	/**
	 * Returns the model constraints to apply.
	 * 
	 * <p>
	 * This method provides a typesafe access to the {@link DateConstraints date
	 * model constraints} of this editing object and is equivalent to {@code
	 * (DateConstraints) modelConstraints()}.
	 * </p>
	 * 
	 * @return The target constraints to apply.
	 * 
	 * @see #modelConstraints()
	 * @see DateConstraints
	 */
	public DateConstraints modelDateConstraints() {
		return (DateConstraints) modelConstraints();
	}

	/**
	 * Returns the before-set model constraints to apply.
	 * 
	 * <p>
	 * This method provides a typesafe access to the {@link DateConstraints date
	 * before-set model constraints} of this editing object and is equivalent to
	 * {@code (DateConstraints) beforeSetModelConstraints()}.
	 * </p>
	 * 
	 * @return The target constraints to apply.
	 * 
	 * @see #beforeSetModelConstraints()
	 * @see DateConstraints
	 */
	public DateConstraints beforeSetModelDateConstraints() {
		return (DateConstraints) beforeSetModelConstraints();
	}

	protected Constraints createTargetConstraints() {
		return new StringConstraints();
	}

	protected Constraints createModelConstraints() {
		return new DateConstraints().displayFormat(displayFormat);
	}

	protected Constraints createBeforeSetModelConstraints() {
		return new DateConstraints().displayFormat(displayFormat);
	}

	/**
	 * Convenience method which adds a {@link DateConstraints#required()
	 * required constraint} to the set of {@link #modelDateConstraints()}.
	 * 
	 * @return This editing instance for method chaining.
	 * 
	 * @see DateConstraints#required()
	 * @see #modelDateConstraints()
	 */
	public DateEditing required() {
		modelDateConstraints().required();
		return this;
	}

	/**
	 * Convenience method which adds a {@link DateConstraints#after(Date) after
	 * constraint} to the set of {@link #modelDateConstraints()}.
	 * 
	 * @param date
	 *            The date of the after constraint.
	 * @return This editing instance for method chaining.
	 * 
	 * @see DateConstraints#after(Date)
	 * @see #modelDateConstraints()
	 */
	public DateEditing after(Date date) {
		modelDateConstraints().after(date);
		return this;
	}

	/**
	 * Convenience method which adds a {@link DateConstraints#afterEqual(Date)
	 * after-equal constraint} to the set of {@link #modelDateConstraints()}.
	 * 
	 * @param date
	 *            The date of the after-equal constraint.
	 * @return This editing instance for method chaining.
	 * 
	 * @see DateConstraints#afterEqual(Date)
	 * @see #modelDateConstraints()
	 */
	public DateEditing afterEqual(Date date) {
		modelDateConstraints().afterEqual(date);
		return this;
	}

	/**
	 * Convenience method which adds a {@link DateConstraints#before(Date)
	 * before constraint} to the set of {@link #modelDateConstraints()}.
	 * 
	 * @param date
	 *            The date of the before constraint.
	 * @return This editing instance for method chaining.
	 * 
	 * @see DateConstraints#before(Date)
	 * @see #modelDateConstraints()
	 */
	public DateEditing before(Date date) {
		modelDateConstraints().before(date);
		return this;
	}

	/**
	 * Convenience method which adds a {@link DateConstraints#beforeEqual(Date)
	 * after-equal constraint} to the set of {@link #modelDateConstraints()}.
	 * 
	 * @param date
	 *            The date of the after-equal constraint.
	 * @return This editing instance for method chaining.
	 * 
	 * @see DateConstraints#afterEqual(Date)
	 * @see #modelDateConstraints()
	 */
	public DateEditing beforeEqual(Date date) {
		modelDateConstraints().beforeEqual(date);
		return this;
	}

	/**
	 * Convenience method which adds a {@link DateConstraints#range(Date, Date)
	 * range constraint} to the set of {@link #modelDateConstraints()}.
	 * 
	 * @param minDate
	 *            The min date of the range constraint.
	 * @param maxDate
	 *            The max date of the range constraint.
	 * @return This editing instance for method chaining.
	 * 
	 * @see DateConstraints#range(Date, Date)
	 * @see #modelDateConstraints()
	 */
	public DateEditing range(Date minDate, Date maxDate) {
		modelDateConstraints().range(minDate, maxDate);
		return this;
	}
}




/*******************************************************************************
 * Copyright (c) 2009 Ovidio Mallo and others.
 * All rights reserved. This program and the accompanying materials
 * are made available under the terms of the Eclipse Public License v1.0
 * which accompanies this distribution, and is available at
 * http://www.eclipse.org/legal/epl-v10.html
 *
 * Contributors:
 *     Ovidio Mallo - initial API and implementation (bug 183055)
 ******************************************************************************/

package org.eclipse.core.internal.databinding.validation;

import org.eclipse.core.databinding.validation.IValidator;
import org.eclipse.core.databinding.validation.ValidationStatus;
import org.eclipse.core.internal.databinding.BindingMessages;
import org.eclipse.core.runtime.IStatus;

/**
 * @since 1.4
 */
public class NonEmptyStringValidator implements IValidator {

	private static final String NON_EMPTY_STRING_VALIDATION_MESSAGE = BindingMessages.getString(BindingMessages.VALIDATE_NON_EMPTY_STRING);

	private final String validationMessage;

	/**
	 * 
	 */
	public NonEmptyStringValidator() {
		this(null);
	}

	/**
	 * @param validationMessage
	 */
	public NonEmptyStringValidator(String validationMessage) {
		this.validationMessage = validationMessage != null ? validationMessage
				: NON_EMPTY_STRING_VALIDATION_MESSAGE;
	}

	public IStatus validate(Object value) {
		String input = (String) value;
		if ("".equals(input)) { //$NON-NLS-1$
			return ValidationStatus.error(validationMessage);
		}
		return ValidationStatus.ok();
	}
}




/*******************************************************************************
 * Copyright (c) 2009 Ovidio Mallo and others.
 * All rights reserved. This program and the accompanying materials
 * are made available under the terms of the Eclipse Public License v1.0
 * which accompanies this distribution, and is available at
 * http://www.eclipse.org/legal/epl-v10.html
 *
 * Contributors:
 *     Ovidio Mallo - initial API and implementation (bug 183055)
 ******************************************************************************/

package org.eclipse.core.internal.databinding.conversion;

import org.eclipse.core.databinding.conversion.Converter;

/**
 * @since 1.4
 */
public class StringStripConverter extends Converter {

	private final boolean stripToNull;

	/**
	 * 
	 * @param stripToNull
	 */
	public StringStripConverter(boolean stripToNull) {
		super(String.class, String.class);
		this.stripToNull = stripToNull;
	}

	public Object convert(Object fromObject) {
		String string = (String) fromObject;

		if (string != null && string.length() != 0) {
			int stripStart = 0;
			while (stripStart < string.length()
					&& Character.isWhitespace(string.charAt(stripStart))) {
				stripStart++;
			}

			int stripEnd = string.length() - 1;
			while (stripEnd >= 0
					&& Character.isWhitespace(string.charAt(stripEnd))) {
				stripEnd--;
			}

			if (stripStart <= stripEnd) {
				string = string.substring(stripStart, stripEnd + 1);
			} else {
				string = ""; //$NON-NLS-1$
			}
		}

		if (stripToNull && string != null && string.length() == 0) {
			string = null;
		}

		return string;
	}
}




/*******************************************************************************
 * Copyright (c) 2009 Ovidio Mallo and others.
 * All rights reserved. This program and the accompanying materials
 * are made available under the terms of the Eclipse Public License v1.0
 * which accompanies this distribution, and is available at
 * http://www.eclipse.org/legal/epl-v10.html
 *
 * Contributors:
 *     Ovidio Mallo - initial API and implementation (bug 183055)
 ******************************************************************************/

package org.eclipse.core.internal.databinding.validation;

import java.text.MessageFormat;
import java.util.regex.Matcher;
import java.util.regex.Pattern;

import org.eclipse.core.databinding.validation.IValidator;
import org.eclipse.core.databinding.validation.ValidationStatus;
import org.eclipse.core.internal.databinding.BindingMessages;
import org.eclipse.core.runtime.IStatus;

/**
 * Provides validations for strings which must match a given regular expression.
 * 
 * @since 1.4
 */
public class StringRegexValidator implements IValidator {

	private static final String REGEX_VALIDATION_MESSAGE = BindingMessages
			.getString(BindingMessages.VALIDATE_STRING_REGEX);

	private final Pattern pattern;
	private final String validationMessage;
	private String formattedValidationMessage;

	/**
	 * Creates a new regex validator.
	 * 
	 * @param regex
	 *            The regular expression which the input string must match.
	 * @param validationMessage
	 *            The validation message pattern to use. Can be parameterized
	 *            with the given regular expression string.
	 */
	public StringRegexValidator(String regex, String validationMessage) {
		this.pattern = Pattern.compile(regex);
		this.validationMessage = validationMessage != null ? validationMessage
				: REGEX_VALIDATION_MESSAGE;
	}

	public IStatus validate(Object value) {
		String input = (String) value;
		if (input != null) {
			Matcher matcher = pattern.matcher(input);
			if (!matcher.matches()) {
				return ValidationStatus.error(getFormattedValidationMessage());
			}
		}
		return ValidationStatus.ok();
	}

	private String getFormattedValidationMessage() {
		if (formattedValidationMessage == null) {
			formattedValidationMessage = MessageFormat.format(
					validationMessage, new String[] { pattern.pattern() });
		}
		return formattedValidationMessage;
	}
}

Lines 1-4 Link Here

(-).settings/org.eclipse.jdt.ui.prefs (-2 / +2 lines)
1	#Tue Feb 10 16:06:02 MST 2009	1	#Mon Sep 21 22:46:54 CEST 2009
2	cleanup.add_default_serial_version_id=true	2	cleanup.add_default_serial_version_id=true
3	cleanup.add_generated_serial_version_id=false	3	cleanup.add_generated_serial_version_id=false
4	cleanup.add_missing_annotations=true	4	cleanup.add_missing_annotations=true
Lines 78-84 Link Here
78	sp_cleanup.always_use_this_for_non_static_method_access=false	78	sp_cleanup.always_use_this_for_non_static_method_access=false
79	sp_cleanup.convert_to_enhanced_for_loop=false	79	sp_cleanup.convert_to_enhanced_for_loop=false
80	sp_cleanup.correct_indentation=false	80	sp_cleanup.correct_indentation=false
81	sp_cleanup.format_source_code=true	81	sp_cleanup.format_source_code=false
82	sp_cleanup.format_source_code_changes_only=false	82	sp_cleanup.format_source_code_changes_only=false
83	sp_cleanup.make_local_variable_final=false	83	sp_cleanup.make_local_variable_final=false
84	sp_cleanup.make_parameters_final=false	84	sp_cleanup.make_parameters_final=false

Lines 17-21 Link Here

(-)META-INF/MANIFEST.MF (-1 / +2 lines)
17	org.eclipse.jface.examples.databinding.mask.internal;x-internal:=true,	17	org.eclipse.jface.examples.databinding.mask.internal;x-internal:=true,
18	org.eclipse.jface.examples.databinding.model;x-internal:=false,	18	org.eclipse.jface.examples.databinding.model;x-internal:=false,
19	org.eclipse.jface.examples.databinding.radioGroup;x-internal:=false	19	org.eclipse.jface.examples.databinding.radioGroup;x-internal:=false
20	Import-Package: com.ibm.icu.text	20	Import-Package: com.ibm.icu.math,
		21	com.ibm.icu.text
21	Bundle-RequiredExecutionEnvironment: J2SE-1.5	22	Bundle-RequiredExecutionEnvironment: J2SE-1.5




/*******************************************************************************
 * Copyright (c) 2009 Ovidio Mallo and others.
 * All rights reserved. This program and the accompanying materials
 * are made available under the terms of the Eclipse Public License v1.0
 * which accompanies this distribution, and is available at
 * http://www.eclipse.org/legal/epl-v10.html
 *
 * Contributors:
 *     Ovidio Mallo - initial API and implementation (bug 183055)
 ******************************************************************************/

package org.eclipse.jface.examples.databinding.util;

import org.eclipse.core.databinding.editing.Editing;
import org.eclipse.core.databinding.observable.map.IObservableMap;
import org.eclipse.core.databinding.util.Policy;
import org.eclipse.core.runtime.IStatus;
import org.eclipse.core.runtime.MultiStatus;
import org.eclipse.jface.dialogs.MessageDialog;
import org.eclipse.jface.viewers.CellEditor;
import org.eclipse.jface.viewers.ColumnViewer;
import org.eclipse.jface.viewers.EditingSupport;
import org.eclipse.jface.viewers.TextCellEditor;
import org.eclipse.swt.widgets.Composite;

/**
 * @since 3.2
 */
public class ObservableMapEditingSupport extends EditingSupport {

	private final IObservableMap attributeMap;

	private final Editing editing;

	private final CellEditor cellEditor;

	public ObservableMapEditingSupport(ColumnViewer viewer, IObservableMap attributeMap, Editing editing) {
		super(viewer);
		this.attributeMap = attributeMap;
		this.editing = editing;
		this.cellEditor = new TextCellEditor((Composite) getViewer().getControl());
	}

	protected boolean canEdit(Object element) {
		return true;
	}

	protected CellEditor getCellEditor(Object element) {
		return cellEditor;
	}

	protected Object getValue(Object element) {
		return editing.convertToTarget(attributeMap.get(element));
	}

	protected void setValue(Object element, Object value) {
		MultiStatus validationStatus = new MultiStatus(Policy.JFACE_DATABINDING, 0, null, null);
		Object modelValue = editing.convertToModel(value, validationStatus);
		if (handleValidation(validationStatus)) {
			attributeMap.put(element, modelValue);
		}
	}

	private boolean handleValidation(IStatus validationStatus) {
		if (validationStatus.matches(IStatus.ERROR | IStatus.CANCEL)) {
			MessageDialog.openError(getViewer().getControl().getShell(), "Validation Error", getValidationMessage(validationStatus));
			return false;
		}
		return true;
	}

	private static String getValidationMessage(IStatus validationStatus) {
		if (!validationStatus.isMultiStatus()) {
			return validationStatus.getMessage();
		}

		MultiStatus multiStatus = (MultiStatus) validationStatus;
		StringBuffer sb = new StringBuffer();
		IStatus[] childStatus = multiStatus.getChildren();
		for (int i = 0; i < childStatus.length; i++) {
			if (i > 0) {
				sb.append('\n');
			}
			sb.append(getValidationMessage(childStatus[i]));
		}
		return sb.toString();
	}
}




/*******************************************************************************
 * Copyright (c) 2006, 2009 Ovidio Mallo and others.
 * All rights reserved. This program and the accompanying materials
 * are made available under the terms of the Eclipse Public License v1.0
 * which accompanies this distribution, and is available at
 * http://www.eclipse.org/legal/epl-v10.html
 *
 * Contributors:
 *     Ovidio Mallo - initial API and implementation (bug 183055)
 ******************************************************************************/

package org.eclipse.jface.examples.databinding.snippets;

import java.util.Calendar;
import java.util.Date;

import org.eclipse.core.databinding.Binding;
import org.eclipse.core.databinding.DataBindingContext;
import org.eclipse.core.databinding.editing.BooleanEditing;
import org.eclipse.core.databinding.editing.DateEditing;
import org.eclipse.core.databinding.editing.Editing;
import org.eclipse.core.databinding.editing.IntegerEditing;
import org.eclipse.core.databinding.observable.Realm;
import org.eclipse.core.databinding.observable.list.WritableList;
import org.eclipse.core.databinding.observable.value.IObservableValue;
import org.eclipse.core.databinding.observable.value.WritableValue;
import org.eclipse.core.runtime.IStatus;
import org.eclipse.jface.databinding.swt.ISWTObservableValue;
import org.eclipse.jface.databinding.swt.SWTObservables;
import org.eclipse.jface.databinding.viewers.ObservableListContentProvider;
import org.eclipse.jface.examples.databinding.util.EditingFactory;
import org.eclipse.jface.internal.databinding.provisional.fieldassist.ControlDecorationSupport;
import org.eclipse.jface.layout.GridDataFactory;
import org.eclipse.jface.layout.GridLayoutFactory;
import org.eclipse.jface.viewers.LabelProvider;
import org.eclipse.jface.viewers.ListViewer;
import org.eclipse.swt.SWT;
import org.eclipse.swt.events.FocusAdapter;
import org.eclipse.swt.events.FocusEvent;
import org.eclipse.swt.events.SelectionAdapter;
import org.eclipse.swt.events.SelectionEvent;
import org.eclipse.swt.layout.GridLayout;
import org.eclipse.swt.widgets.Composite;
import org.eclipse.swt.widgets.Control;
import org.eclipse.swt.widgets.Display;
import org.eclipse.swt.widgets.Group;
import org.eclipse.swt.widgets.Label;
import org.eclipse.swt.widgets.Shell;
import org.eclipse.swt.widgets.Text;

public class Snippet035Editing {

	private DataBindingContext dbc;

	public static void main(String[] args) {
		Display display = new Display();

		Realm.runWithDefault(SWTObservables.getRealm(display), new Runnable() {
			public void run() {
				Shell shell = new Snippet035Editing().createShell();
				Display display = Display.getCurrent();
				while (!shell.isDisposed()) {
					if (!display.readAndDispatch()) {
						display.sleep();
					}
				}
			}
		});
	}

	private Shell createShell() {
		Display display = Display.getCurrent();
		Shell shell = new Shell(display);
		shell.setText("Editing");
		shell.setLayout(new GridLayout(1, false));

		dbc = new DataBindingContext();

		createValueSection(shell);
		createListSection(shell);

		shell.pack();
		shell.open();

		return shell;
	}

	private void createValueSection(Composite parent) {
		Group section = createSectionGroup(parent, "Value bindings", false);

		// Edit an e-mail address.
		Text emailText = createTextField(section, "E-Mail*");
		Editing emailEditing = EditingFactory.forEmailString().required();
		bindTextField(emailText, new WritableValue(), emailEditing);

		// Edit a required, positive integer using the default validation message.
		Text positiveText = createTextField(section, "Positive value*");
		IntegerEditing positiveEditing = EditingFactory.forInteger().required().positive();
		bindTextField(positiveText, new WritableValue(), positiveEditing);

		// Edit an integer within the range [1, 100] using the default
		// validation message.
		Text rangeText = createTextField(section, "Value in [1, 100]");
		IntegerEditing rangeEditing = EditingFactory.forInteger().range(1, 100);
		bindTextField(rangeText, new WritableValue(new Integer(0), null), rangeEditing);

		// Edit a percentage value which must lie within [0, 100] using a custom
		// validation message which indicates that the value actually represents
		// a percentage value.
		Text percentText = createTextField(section, "Value [%]");
		IntegerEditing percentEditing = EditingFactory.forInteger();
		percentEditing.modelIntegerConstraints()
			.rangeMessage("Please specify a percentage value within [{0}, {1}].")
			.range(0, 100);
		bindTextField(percentText, new WritableValue(new Integer(-1), null), percentEditing);

		// Edit a hex integer within the range [0x00, 0xff]. The range validation
		// message will display the range boundaries in hex format as well.
		Text hexText = createTextField(section, "Hex value in [0x00, 0xff]");
		IntegerEditing hexEditing = EditingFactory.forHexInteger(2).range(0x00, 0xff);
		bindTextField(hexText, new WritableValue(new Integer(0), null), hexEditing);

		// Edit a boolean value.
		Text boolText = createTextField(section, "Boolean value");
		BooleanEditing boolEditing = EditingFactory.forBoolean();
		bindTextField(boolText, new WritableValue(Boolean.TRUE, null), boolEditing);
	}

	private void createListSection(Composite parent) {
		Group section = createSectionGroup(parent, "List bindings", true);

		// Our date should be >= 01.01.1990.
		Calendar year1990Calendar = Calendar.getInstance();
		year1990Calendar.clear();
		year1990Calendar.set(1990, 0, 1);
		Date year1990 = year1990Calendar.getTime();

		// Edit a date supporting the default input/display patterns.
		Text dateText = createTextField(section, "Date");
		DateEditing dateEditing = EditingFactory.forDate().afterEqual(year1990);
		final WritableValue dateObservable = new WritableValue();
		final Binding dateBinding = bindTextField(dateText, dateObservable, dateEditing);

		// Create a list to which the dates are added when the user hits ENTER.
		new Label(section, SWT.LEFT);
		ListViewer dateListViewer = new ListViewer(section);
		GridDataFactory.fillDefaults().grab(true, true).hint(150, 200).applyTo(dateListViewer.getList());

		dateListViewer.setContentProvider(new ObservableListContentProvider());
		dateListViewer.setLabelProvider(new LabelProvider());

		// We use the same DateEditing object as for the text field above to
		// create a list binding which maps the entered dates to their string
		// representation which is then set as input on the ListViewer.
		final WritableList targetDateList = new WritableList();
		final WritableList modelDateList = new WritableList();
		dateEditing.bindList(dbc, targetDateList, modelDateList);

		// Set the list containing the string representation of the dates as input.
		dateListViewer.setInput(targetDateList);

		// Add the current date in the text field when the user hits ENTER.
		dateText.addSelectionListener(new SelectionAdapter() {
			public void widgetDefaultSelected(SelectionEvent e) {
				IStatus dateValidationStatus = (IStatus) dateBinding.getValidationStatus().getValue();
				Date date = (Date) dateObservable.getValue();
				if (dateValidationStatus.isOK() && date != null) {
					modelDateList.add(date);
				}
			}
		});
	}

	private Binding bindTextField(Text text, IObservableValue modelValue, Editing editing) {
		// Create the binding using the editing object.
		ISWTObservableValue textObservable = SWTObservables.observeText(text, SWT.Modify);
		Binding binding = editing.bindValue(dbc, textObservable, modelValue);

		// Decorate the control with the validation status.
		ControlDecorationSupport.create(binding, SWT.TOP);

		// Re-format when the text field looses the focus in order to always
		// display the model in the default format in case multiple input formats
		// are supported.
		formatOnFocusOut(text, binding);

		return binding;
	}

	private static void formatOnFocusOut(final Control control, final Binding binding) {
		control.addFocusListener(new FocusAdapter() {
			public void focusLost(FocusEvent e) {
				IStatus dateValidationStatus = (IStatus) binding.getValidationStatus().getValue();
				if (dateValidationStatus.isOK()) {
					binding.updateModelToTarget();
				}
			}
		});
	}

	private static Group createSectionGroup(Composite parent, String groupText, boolean grabVertical) {
		Group section = new Group(parent, SWT.SHADOW_ETCHED_IN);
		section.setText(groupText);
		GridLayoutFactory.fillDefaults()
				.numColumns(2)
				.equalWidth(false)
				.margins(5, 5)
				.spacing(15, 5)
				.applyTo(section);
		GridDataFactory.fillDefaults().grab(true, grabVertical).applyTo(section);
		return section;
	}

	private static Text createTextField(Composite parent, String labelText) {
		Label label = new Label(parent, SWT.LEFT);
		label.setText(labelText);
		GridDataFactory.fillDefaults().align(SWT.LEFT, SWT.CENTER).applyTo(label);

		Text text = new Text(parent, SWT.BORDER);
		GridDataFactory.fillDefaults().grab(true, false).hint(150, SWT.DEFAULT).applyTo(text);

		return text;
	}
}




/*******************************************************************************
 * Copyright (c) 2009 Ovidio Mallo and others.
 * All rights reserved. This program and the accompanying materials
 * are made available under the terms of the Eclipse Public License v1.0
 * which accompanies this distribution, and is available at
 * http://www.eclipse.org/legal/epl-v10.html
 *
 * Contributors:
 *     Ovidio Mallo - initial API and implementation (bug 183055)
 ******************************************************************************/

package org.eclipse.jface.examples.databinding.util;

import java.util.Locale;

import org.eclipse.core.databinding.editing.BooleanEditing;
import org.eclipse.core.databinding.editing.DateEditing;
import org.eclipse.core.databinding.editing.IntegerEditing;
import org.eclipse.core.databinding.editing.StringEditing;

import com.ibm.icu.text.DateFormat;
import com.ibm.icu.text.NumberFormat;

/**
 * @since 3.2
 */
public final class EditingFactory {

	private static final String REQUIRED_MESSAGE = "Please specify a value.";

	private static final String INTEGER_PARSE_ERROR_MESSAGE = "The input is invalid.";

	private static final String INTEGER_OUT_OF_RANGE_MESSAGE = "The value lies outside the supported range.";

	private static final String INTEGER_RANGE_MESSAGE = "The value must lie between {0} and {1}.";

	private static final String[] BOOLEAN_TRUE_VALUES = new String[] {
		"yes", "y", "true", "1"
	};

	private static final String[] BOOLEAN_FALSE_VALUES = new String[] {
		"no", "n", "false", "0"
	};

	private static final String[] DATE_INPUT_PATTERNS = new String[] {
		"yyMMdd",
		"yyyyMMdd"
	};

	private static final String DATE_DISPLAY_PATTERN = "yyyyMMdd";

	private static final String DATE_PARSE_ERROR_MESSAGE = createDateParseErrorMessage(DATE_INPUT_PATTERNS);

	private static final String EMAIL_REGEX = "\\b[A-Za-z0-9._%+-]+@[A-Za-z0-9.-]+\\.[A-Za-z]{2,4}\\b";

	private static final String EMAIL_ERROR_MESSAGE = "Please specify a valid e-mail address.";

	private EditingFactory() {
		// prevent instantiation
	}

	public static StringEditing forString() {
		return StringEditing.stripped(true);
	}

	public static StringEditing forEmailString() {
		StringEditing editing = StringEditing.stripped(true);
		editing.modelStringConstraints()
				.matchesMessage(EMAIL_ERROR_MESSAGE)
				.matches(EMAIL_REGEX);
		return editing;
	}

	public static IntegerEditing forInteger() {
		return forInteger(Locale.getDefault());
	}

	public static IntegerEditing forInteger(Locale locale) {
		IntegerEditing editing = IntegerEditing.forFormat(
				NumberFormat.getIntegerInstance(locale),
				INTEGER_PARSE_ERROR_MESSAGE,
				INTEGER_OUT_OF_RANGE_MESSAGE);
		configure(editing);
		return editing;
	}

	public static IntegerEditing forHexInteger(int digits) {
		IntegerEditing editing = IntegerEditing.forFormat(
				RadixNumberFormat.getHexInstance("0x", digits),
				INTEGER_PARSE_ERROR_MESSAGE,
				INTEGER_OUT_OF_RANGE_MESSAGE);
		configure(editing);
		return editing;
	}

	private static void configure(IntegerEditing editing) {
		editing.modelIntegerConstraints()
				.requiredMessage(REQUIRED_MESSAGE)
				.rangeMessage(INTEGER_RANGE_MESSAGE);
	}

	public static BooleanEditing forBoolean() {
		BooleanEditing editing =
			BooleanEditing.forStringValues(
					BOOLEAN_TRUE_VALUES,
					BOOLEAN_FALSE_VALUES);
		configure(editing);
		return editing;
	}

	private static void configure(BooleanEditing editing) {
		editing.modelBooleanConstraints()
				.requiredMessage(REQUIRED_MESSAGE);
	}

	public static DateEditing forDate() {
		return forDate(Locale.getDefault());
	}

	public static DateEditing forDate(Locale locale) {
		DateEditing editing = DateEditing
				.forFormats(
						createDateFormats(DATE_INPUT_PATTERNS, locale),
						DATE_PARSE_ERROR_MESSAGE,
						DateFormat.getPatternInstance(DATE_DISPLAY_PATTERN, locale));
		editing.modelDateConstraints().requiredMessage(REQUIRED_MESSAGE);
		return editing;
	}

	private static DateFormat[] createDateFormats(String[] datePatterns, Locale locale) {
		DateFormat[] dateFormats = new DateFormat[datePatterns.length];
		for (int i = 0; i < dateFormats.length; i++) {
			dateFormats[i] = DateFormat.getPatternInstance(datePatterns[i], locale);
		}
		return dateFormats;
	}

	private static String createDateParseErrorMessage(String[] datePatterns) {
		StringBuffer messageSb = new StringBuffer();
		messageSb.append("Supported formats: ");
		for (int i = 0; i < datePatterns.length; i++) {
			if (i > 0) {
				messageSb.append(", ");
			}
			messageSb.append(datePatterns[i]);
		}
		return messageSb.toString();
	}
}




/*******************************************************************************
 * Copyright (c) 2009 Ovidio Mallo and others.
 * All rights reserved. This program and the accompanying materials
 * are made available under the terms of the Eclipse Public License v1.0
 * which accompanies this distribution, and is available at
 * http://www.eclipse.org/legal/epl-v10.html
 *
 * Contributors:
 *     Ovidio Mallo - initial API and implementation (bug 183055)
 ******************************************************************************/

package org.eclipse.jface.examples.databinding.util;

import java.math.BigInteger;
import java.text.FieldPosition;
import java.text.ParsePosition;

import com.ibm.icu.math.BigDecimal;
import com.ibm.icu.text.NumberFormat;

/**
 * @since 3.2
 *
 */
public class RadixNumberFormat extends NumberFormat {

	private static final long serialVersionUID = 411884077848863891L;

	private final int radix;

	private final String prefix;

	private final int digits;

	private RadixNumberFormat(int radix, String prefix, int digits) {
		this.radix = radix;
		this.prefix = prefix != null ? prefix : "";
		this.digits = digits;
	}

	public static RadixNumberFormat getHexInstance() {
		return getHexInstance(null, 0);
	}

	public static RadixNumberFormat getHexInstance(String prefix, int digits) {
		return new RadixNumberFormat(16, prefix, digits);
	}

	public StringBuffer format(double number, StringBuffer toAppendTo,
			FieldPosition pos) {
		return format((long) number, toAppendTo, pos);
	}

	public StringBuffer format(long number, StringBuffer toAppendTo,
			FieldPosition pos) {
		return toAppendTo.append(prefix).append(addPadding(Long.toString(number, radix)));
	}

	public StringBuffer format(BigInteger number, StringBuffer toAppendTo,
			FieldPosition pos) {
		return toAppendTo.append(prefix).append(addPadding(number.toString(radix)));
	}

	public StringBuffer format(BigDecimal number, StringBuffer toAppendTo,
			FieldPosition pos) {
		throw new UnsupportedOperationException();
	}

	public Number parse(String text, ParsePosition parsePosition) {
		if (text.length() == 0) {
			return null;
		}

		parsePosition.setIndex(parsePosition.getIndex() + text.length());

		try {
			if (text.startsWith(prefix)) {
				return Integer.parseInt(text.substring(prefix.length()), radix);
			}
			return Integer.parseInt(text, radix);
		} catch (NumberFormatException e) {
			parsePosition.setErrorIndex(0);
			return null;
		}
	}

	private String addPadding(String numberText) {
		if (numberText.length() >= digits) {
			return numberText;
		}

		StringBuffer sb = new StringBuffer();
		for (int i = numberText.length(); i < digits; i++) {
			sb.append('0');
		}
		sb.append(numberText);
		return sb.toString();
	}
}




/*******************************************************************************
 * Copyright (c) 2009 Ovidio Mallo and others.
 * All rights reserved. This program and the accompanying materials
 * are made available under the terms of the Eclipse Public License v1.0
 * which accompanies this distribution, and is available at
 * http://www.eclipse.org/legal/epl-v10.html
 *
 * Contributors:
 *     Ovidio Mallo - initial API and implementation (bug 183055)
 ******************************************************************************/

package org.eclipse.jface.examples.databinding.util;

import org.eclipse.core.databinding.editing.Editing;
import org.eclipse.core.databinding.observable.map.IObservableMap;
import org.eclipse.jface.databinding.viewers.ObservableMapCellLabelProvider;
import org.eclipse.jface.viewers.ViewerCell;

/**
 * @since 3.2
 */
public class ObservableMapEditingCellLabelProvider extends
		ObservableMapCellLabelProvider {

	private final IObservableMap attributeMap;

	private final Editing editing;

	public ObservableMapEditingCellLabelProvider(IObservableMap attributeMap, Editing editing) {
		super(attributeMap);
		this.attributeMap = attributeMap;
		this.editing = editing;
	}

	public void update(ViewerCell cell) {
		Object element = cell.getElement();
		Object attribute = attributeMap.get(element);
		cell.setText((String) editing.convertToTarget(attribute));
	}
}




/*******************************************************************************
 * Copyright (c) 2006, 2009 Ovidio Mallo and others.
 * All rights reserved. This program and the accompanying materials
 * are made available under the terms of the Eclipse Public License v1.0
 * which accompanies this distribution, and is available at
 * http://www.eclipse.org/legal/epl-v10.html
 *
 * Contributors:
 *     Ovidio Mallo - initial API and implementation (bug 183055)
 ******************************************************************************/

package org.eclipse.jface.examples.databinding.snippets;

import java.util.Date;

import org.eclipse.core.databinding.Binding;
import org.eclipse.core.databinding.DataBindingContext;
import org.eclipse.core.databinding.beans.BeansObservables;
import org.eclipse.core.databinding.editing.DateEditing;
import org.eclipse.core.databinding.editing.Editing;
import org.eclipse.core.databinding.editing.IntegerEditing;
import org.eclipse.core.databinding.editing.StringEditing;
import org.eclipse.core.databinding.observable.Realm;
import org.eclipse.core.databinding.observable.list.WritableList;
import org.eclipse.core.databinding.observable.map.IObservableMap;
import org.eclipse.core.databinding.observable.set.IObservableSet;
import org.eclipse.core.databinding.observable.value.IObservableValue;
import org.eclipse.core.runtime.IStatus;
import org.eclipse.jface.databinding.swt.ISWTObservableValue;
import org.eclipse.jface.databinding.swt.SWTObservables;
import org.eclipse.jface.databinding.viewers.ObservableListContentProvider;
import org.eclipse.jface.databinding.viewers.ViewersObservables;
import org.eclipse.jface.examples.databinding.ModelObject;
import org.eclipse.jface.examples.databinding.util.EditingFactory;
import org.eclipse.jface.examples.databinding.util.ObservableMapEditingCellLabelProvider;
import org.eclipse.jface.examples.databinding.util.ObservableMapEditingSupport;
import org.eclipse.jface.internal.databinding.provisional.fieldassist.ControlDecorationSupport;
import org.eclipse.jface.layout.GridDataFactory;
import org.eclipse.jface.layout.GridLayoutFactory;
import org.eclipse.jface.viewers.StructuredSelection;
import org.eclipse.jface.viewers.TableViewer;
import org.eclipse.jface.viewers.TableViewerColumn;
import org.eclipse.swt.SWT;
import org.eclipse.swt.events.FocusAdapter;
import org.eclipse.swt.events.FocusEvent;
import org.eclipse.swt.layout.GridLayout;
import org.eclipse.swt.widgets.Composite;
import org.eclipse.swt.widgets.Control;
import org.eclipse.swt.widgets.Display;
import org.eclipse.swt.widgets.Group;
import org.eclipse.swt.widgets.Label;
import org.eclipse.swt.widgets.Shell;
import org.eclipse.swt.widgets.Text;

public class Snippet036EditingTable {

	private final StringEditing nameEditing = EditingFactory.forString().required();

	private final IntegerEditing ageEditing = EditingFactory.forInteger().required().nonNegative();

	private final DateEditing bdayEditing = EditingFactory.forDate().before(new Date());

	private DataBindingContext dbc;

	private TableViewer tableViewer;

	public static void main(String[] args) {
		Display display = new Display();

		Realm.runWithDefault(SWTObservables.getRealm(display), new Runnable() {
			public void run() {
				Shell shell = new Snippet036EditingTable().createShell();
				Display display = Display.getCurrent();
				while (!shell.isDisposed()) {
					if (!display.readAndDispatch()) {
						display.sleep();
					}
				}
			}
		});
	}

	private Shell createShell() {
		Display display = Display.getCurrent();
		Shell shell = new Shell(display);
		shell.setText("Editing");
		shell.setLayout(new GridLayout(2, false));

		dbc = new DataBindingContext();

		createTableSection(shell);
		createFieldSection(shell);

		shell.pack();
		shell.open();

		return shell;
	}

	private void createTableSection(Composite parent) {
		Group section = createSectionGroup(parent, 1);

		tableViewer = new TableViewer(section, SWT.SINGLE | SWT.H_SCROLL | SWT.V_SCROLL | SWT.BORDER | SWT.FULL_SELECTION);
		GridDataFactory.fillDefaults().grab(true, true).hint(350, 250).applyTo(tableViewer.getTable());
		tableViewer.getTable().setHeaderVisible(true);
		tableViewer.getTable().setLinesVisible(true);

		ObservableListContentProvider contentProvider = new ObservableListContentProvider();
		tableViewer.setContentProvider(contentProvider);
		IObservableSet contentElements = contentProvider.getKnownElements();

		IObservableMap nameMap = BeansObservables.observeMap(contentElements, "name");
		createColumn("Name*", 150, nameMap, nameEditing);

		IObservableMap ageMap = BeansObservables.observeMap(contentElements, "age");
		createColumn("Age*", 50, ageMap, ageEditing);

		IObservableMap bdayMap = BeansObservables.observeMap(contentElements, "birthday");
		createColumn("Birthday", 80, bdayMap, bdayEditing);

		WritableList people = new WritableList();
		people.add(new Person("John Doe", 27));
		people.add(new Person("Steve Northover", 33));
		people.add(new Person("Grant Gayed", 54));
		people.add(new Person("Veronika Irvine", 25));
		people.add(new Person("Mike Wilson", 44));
		people.add(new Person("Christophe Cornu", 37));
		people.add(new Person("Lynne Kues", 65));
		people.add(new Person("Silenio Quarti", 15));

		tableViewer.setInput(people);

		tableViewer.setSelection(new StructuredSelection(people.get(0)));
	}

	private TableViewerColumn createColumn(String text, int width, IObservableMap attributeMap, Editing modelEditing) {
		TableViewerColumn column = new TableViewerColumn(tableViewer, SWT.NONE);
		column.getColumn().setText(text);
		column.getColumn().setWidth(width);
		column.setLabelProvider(new ObservableMapEditingCellLabelProvider(attributeMap, modelEditing));
		column.setEditingSupport(new ObservableMapEditingSupport(tableViewer, attributeMap, modelEditing));
		return column;
	}

	private void createFieldSection(Composite parent) {
		final Group section = createSectionGroup(parent, 2);

		final IObservableValue personObservable = ViewersObservables.observeSingleSelection(tableViewer);

		Text nameText = createTextField(section, "Name*");
		IObservableValue nameObservable = BeansObservables.observeDetailValue(personObservable, "name", null);
		bindTextField(nameText, nameObservable, nameEditing);

		Text ageText = createTextField(section, "Age*");
		IObservableValue ageObservable = BeansObservables.observeDetailValue(personObservable, "age", null);
		bindTextField(ageText, ageObservable, ageEditing);

		Text bdayText = createTextField(section, "Birthday");
		IObservableValue bdayObservable = BeansObservables.observeDetailValue(personObservable, "birthday", null);
		bindTextField(bdayText, bdayObservable, bdayEditing);
	}

	private Binding bindTextField(
			Text text,
			IObservableValue modelValue,
			Editing editing) {
		// Create the binding using the editing object.
		ISWTObservableValue textObservable = SWTObservables.observeText(text, SWT.Modify);
		Binding binding = editing.bindValue(dbc, textObservable, modelValue);

		// Decorate the control with the validation status.
		ControlDecorationSupport.create(binding, SWT.TOP);

		formatOnFocusOut(text, binding);

		return binding;
	}

	private static void formatOnFocusOut(final Control control, final Binding binding) {
		control.addFocusListener(new FocusAdapter() {
			public void focusLost(FocusEvent e) {
				IStatus dateValidationStatus = (IStatus) binding.getValidationStatus().getValue();
				if (dateValidationStatus.isOK()) {
					binding.updateModelToTarget();
				}
			}
		});
	}

	private Group createSectionGroup(Composite parent, int numColumns) {
		Group section = new Group(parent, SWT.SHADOW_ETCHED_IN);
		GridLayoutFactory.fillDefaults().numColumns(numColumns).equalWidth(false).margins(5, 5).spacing(15, 5).applyTo(section);
		GridDataFactory.fillDefaults().grab(true, true).applyTo(section);
		return section;
	}

	private static Text createTextField(Composite parent, String labelText) {
		Label label = new Label(parent, SWT.LEFT);
		label.setText(labelText);
		GridDataFactory.fillDefaults().align(SWT.LEFT, SWT.CENTER).applyTo(label);

		Text text = new Text(parent, SWT.BORDER);
		GridDataFactory.fillDefaults().grab(true, false).hint(200, SWT.DEFAULT).applyTo(text);

		return text;
	}

	public static final class Person extends ModelObject {

		private String name;

		private int age;

		private Date birthday;

		public Person(String name, int age) {
			this.name = name;
			this.age = age;
		}

		public String getName() {
			return name;
		}

		public void setName(String name) {
			firePropertyChange("name", this.name, this.name = name);
		}

		public int getAge() {
			return age;
		}

		public void setAge(int age) {
			firePropertyChange("age", this.age, this.age = age);
		}

		public Date getBirthday() {
			return birthday;
		}

		public void setBirthday(Date birthday) {
			firePropertyChange("birthday", this.birthday, this.birthday = birthday);
		}
	}
}




 *
 * Contributors:
 *     IBM Corporation - initial API and implementation
 *     Ovidio Mallo - bug 183055
 ******************************************************************************/

/**

public class BindingMessagesTest extends TestCase {
	public void testFormatString() throws Exception {
		String key = "Validate_NumberOutOfRangeError";
		String result = BindingMessages.getFormattedString(key, new Object[] {"1", "2"});
		assertFalse("key should not be returned", key.equals(result));
	}
	
	public void testFormatStringForKeyNotFound() throws Exception {
		String key = "key_that_does_not_exist";
		String result = BindingMessages.getFormattedString(key, null);
		assertTrue(key.equals(result));
	}
}

Return to bug 183055

Lines 10-15 Link Here

(-)src/org/eclipse/core/internal/databinding/conversion/DateConversionSupport.java (+15 lines)
10	* db4objects - Initial API and implementation	10	* db4objects - Initial API and implementation
11	* Tom Schindl<tom.schindl@bestsolution.at> - bugfix for 217940	11	* Tom Schindl<tom.schindl@bestsolution.at> - bugfix for 217940
12	* Matthew Hall - bug 121110	12	* Matthew Hall - bug 121110
		13	* Ovidio Mallo - bug 183055
13	******************************************************************************/	14	******************************************************************************/
14	package org.eclipse.core.internal.databinding.conversion;	15	package org.eclipse.core.internal.databinding.conversion;
15		16
Lines 52-57 Link Here
52	};	53	};
53		54
54	/**	55	/**
		56	* Sets the {@link DateFormat}s to be used for parsing/formatting dates. Any
		57	* of the supplied formats will be used for {@link #parse(String) parsing} a
		58	* date from a string while the first format in the array will be used for
		59	* {@link #format(Date) formatting} a date as a string.
		60	*
		61	* @param formatters
		62	* The {@link DateFormat}s to be used for parsing/formatting
		63	* dates.
		64	*/
		65	public final void setFormatters(DateFormat[] formatters) {
		66	this.formatters = formatters;
		67	}
		68
		69	/**
55	* Tries all available formatters to parse the given string according to the	70	* Tries all available formatters to parse the given string according to the
56	* default locale or as a raw millisecond value and returns the result of the	71	* default locale or as a raw millisecond value and returns the result of the
57	* first successful run.	72	* first successful run.

Lines 9-14 Link Here

(-)src/org/eclipse/core/databinding/UpdateStrategy.java (-2 / +3 lines)
9	* IBM Corporation - initial API and implementation	9	* IBM Corporation - initial API and implementation
10	* Matt Carter - bug 180392	10	* Matt Carter - bug 180392
11	* - bug 197679 (Character support completed)	11	* - bug 197679 (Character support completed)
		12	* Ovidio Mallo - bug 183055
12	*******************************************************************************/	13	*******************************************************************************/
13		14
14	package org.eclipse.core.databinding;	15	package org.eclipse.core.databinding;
Lines 24-29 Link Here
24	import org.eclipse.core.databinding.util.Policy;	25	import org.eclipse.core.databinding.util.Policy;
25	import org.eclipse.core.internal.databinding.ClassLookupSupport;	26	import org.eclipse.core.internal.databinding.ClassLookupSupport;
26	import org.eclipse.core.internal.databinding.Pair;	27	import org.eclipse.core.internal.databinding.Pair;
		28	import org.eclipse.core.internal.databinding.conversion.BooleanToStringConverter;
27	import org.eclipse.core.internal.databinding.conversion.CharacterToStringConverter;	29	import org.eclipse.core.internal.databinding.conversion.CharacterToStringConverter;
28	import org.eclipse.core.internal.databinding.conversion.IdentityConverter;	30	import org.eclipse.core.internal.databinding.conversion.IdentityConverter;
29	import org.eclipse.core.internal.databinding.conversion.IntegerToStringConverter;	31	import org.eclipse.core.internal.databinding.conversion.IntegerToStringConverter;
Lines 35-41 Link Here
35	import org.eclipse.core.internal.databinding.conversion.NumberToIntegerConverter;	37	import org.eclipse.core.internal.databinding.conversion.NumberToIntegerConverter;
36	import org.eclipse.core.internal.databinding.conversion.NumberToLongConverter;	38	import org.eclipse.core.internal.databinding.conversion.NumberToLongConverter;
37	import org.eclipse.core.internal.databinding.conversion.NumberToShortConverter;	39	import org.eclipse.core.internal.databinding.conversion.NumberToShortConverter;
38	import org.eclipse.core.internal.databinding.conversion.ObjectToStringConverter;
39	import org.eclipse.core.internal.databinding.conversion.StringToByteConverter;	40	import org.eclipse.core.internal.databinding.conversion.StringToByteConverter;
40	import org.eclipse.core.internal.databinding.conversion.StringToCharacterConverter;	41	import org.eclipse.core.internal.databinding.conversion.StringToCharacterConverter;
41	import org.eclipse.core.internal.databinding.conversion.StringToShortConverter;	42	import org.eclipse.core.internal.databinding.conversion.StringToShortConverter;
Lines 307-313 Link Here
307	new Pair(BOOLEAN_CLASS, "java.lang.Boolean"), new IdentityConverter(Boolean.class, Boolean.class)); //$NON-NLS-1$	308	new Pair(BOOLEAN_CLASS, "java.lang.Boolean"), new IdentityConverter(Boolean.class, Boolean.class)); //$NON-NLS-1$
308	converterMap	309	converterMap
309	.put(	310	.put(
310	new Pair(BOOLEAN_CLASS, "java.lang.String"), new ObjectToStringConverter(Boolean.class)); //$NON-NLS-1$	311	new Pair(BOOLEAN_CLASS, "java.lang.String"), new BooleanToStringConverter(Boolean.class)); //$NON-NLS-1$
311	converterMap	312	converterMap
312	.put(	313	.put(
313	new Pair(BOOLEAN_CLASS, "java.lang.Object"), new IdentityConverter(Boolean.class, Object.class)); //$NON-NLS-1$	314	new Pair(BOOLEAN_CLASS, "java.lang.Object"), new IdentityConverter(Boolean.class, Object.class)); //$NON-NLS-1$

Added Link Here

(-)src/org/eclipse/core/internal/databinding/validation/IntegerRangeValidator.java (+200 lines)
1	/*******************************************************************************
2	* Copyright (c) 2009 Ovidio Mallo and others.
3	* All rights reserved. This program and the accompanying materials
4	* are made available under the terms of the Eclipse Public License v1.0
5	* which accompanies this distribution, and is available at
6	* http://www.eclipse.org/legal/epl-v10.html
7	*
8	* Contributors:
9	* Ovidio Mallo - initial API and implementation (bug 183055)
10	******************************************************************************/
11
12	package org.eclipse.core.internal.databinding.validation;
13
14	import com.ibm.icu.text.NumberFormat;
15
16	/**
17	* Provides validations for integers which must lie within an open/closed range.
18	*
19	* @since 1.4
20	*/
21	public class IntegerRangeValidator extends NumberRangeValidator {
22
23	private static final Integer ZERO = new Integer(0);
24	private static final Integer ONE = new Integer(1);
25
26	/**
27	* Single constructor which supports the individual integer range types.
28	*
29	* @param min
30	* The min integer of the range or <code>null</code> in case no
31	* lower bound is defined.
32	* @param max
33	* The max integer of the range or <code>null</code> in case no
34	* upper bound is defined.
35	* @param minConstraint
36	* The type of constraint imposed by the lower bound of the
37	* range.
38	* @param maxConstraint
39	* The type of constraint imposed by the upper bound of the
40	* range.
41	* @param validationMessage
42	* The validation message pattern to use. Can be parameterized by
43	* the lower and upper bound of the range, if defined.
44	* @param format
45	* The integer format to use for formatting integers in the
46	* validation message.
47	*/
48	private IntegerRangeValidator(Number min, Number max, int minConstraint,
49	int maxConstraint, String validationMessage, NumberFormat format) {
50	super(min, max, minConstraint, maxConstraint, validationMessage, format);
51	}
52
53	/**
54	* Creates a validator which checks that an input integer is greater than
55	* the given number.
56	*
57	* @param number
58	* The reference number of the greater constraint.
59	* @param validationMessage
60	* The validation message pattern to use. Can be parameterized
61	* with the given reference number.
62	* @param format
63	* The display format to use for formatting integers in the
64	* validation message.
65	* @return The validator instance.
66	*/
67	public static IntegerRangeValidator greater(int number,
68	String validationMessage, NumberFormat format) {
69	return new IntegerRangeValidator(new Integer(number), null, GREATER,
70	UNDEFINED, defaultIfNull(validationMessage, GREATER_MESSAGE),
71	format);
72	}
73
74	/**
75	* Creates a validator which checks that an input integer is greater than or
76	* equal to the given number.
77	*
78	* @param number
79	* The reference number of the greater-equal constraint.
80	* @param validationMessage
81	* The validation message pattern to use. Can be parameterized
82	* with the given reference number.
83	* @param format
84	* The display format to use for formatting integers in the
85	* validation message.
86	* @return The validator instance.
87	*/
88	public static IntegerRangeValidator greaterEqual(int number,
89	String validationMessage, NumberFormat format) {
90	return new IntegerRangeValidator(new Integer(number), null,
91	GREATER_EQUAL, UNDEFINED, defaultIfNull(validationMessage,
92	GREATER_EQUAL_MESSAGE), format);
93	}
94
95	/**
96	* Creates a validator which checks that an input integer is less than the
97	* given number.
98	*
99	* @param number
100	* The reference number of the less constraint.
101	* @param validationMessage
102	* The validation message pattern to use. Can be parameterized
103	* with the given reference number.
104	* @param format
105	* The display format to use for formatting integers in the
106	* validation message.
107	* @return The validator instance.
108	*/
109	public static IntegerRangeValidator less(int number,
110	String validationMessage, NumberFormat format) {
111	return new IntegerRangeValidator(null, new Integer(number), UNDEFINED,
112	LESS, defaultIfNull(validationMessage, LESS_MESSAGE), format);
113	}
114
115	/**
116	* Creates a validator which checks that an input integer is less than or
117	* equal to the given number.
118	*
119	* @param number
120	* The reference number of the less-equal constraint.
121	* @param validationMessage
122	* The validation message pattern to use. Can be parameterized
123	* with the given reference number.
124	* @param format
125	* The display format to use for formatting integers in the
126	* validation message.
127	* @return The validator instance.
128	*/
129	public static IntegerRangeValidator lessEqual(int number,
130	String validationMessage, NumberFormat format) {
131	return new IntegerRangeValidator(null, new Integer(number), UNDEFINED,
132	LESS_EQUAL,
133	defaultIfNull(validationMessage, LESS_EQUAL_MESSAGE), format);
134	}
135
136	/**
137	* Creates a validator which checks that an input integer is within the
138	* given range.
139	*
140	* @param min
141	* The lower bound of the range (inclusive).
142	* @param max
143	* The upper bound of the range (inclusive).
144	* @param validationMessage
145	* The validation message pattern to use. Can be parameterized
146	* with the range's lower and upper bound.
147	* @param format
148	* The display format to use for formatting integers in the
149	* validation message.
150	* @return The validator instance.
151	*/
152	public static IntegerRangeValidator range(int min, int max,
153	String validationMessage, NumberFormat format) {
154	return new IntegerRangeValidator(new Integer(min), new Integer(max),
155	GREATER_EQUAL, LESS_EQUAL, defaultIfNull(validationMessage,
156	WITHIN_RANGE_MESSAGE), format);
157	}
158
159	/**
160	* Creates a validator which checks that an input integer is positive.
161	*
162	* @param validationMessage
163	* The validation message to use.
164	* @param format
165	* The display format to use for formatting integers in the
166	* validation message.
167	* @return The validator instance.
168	*/
169	public static IntegerRangeValidator positive(String validationMessage,
170	NumberFormat format) {
171	return new IntegerRangeValidator(ONE, null, GREATER_EQUAL, UNDEFINED,
172	defaultIfNull(validationMessage, POSITIVE_MESSAGE), format);
173	}
174
175	/**
176	* Creates a validator which checks that an input integer is non-negative.
177	*
178	* @param validationMessage
179	* The validation message to use.
180	* @param format
181	* The display format to use for formatting integers in the
182	* validation message.
183	* @return The validator instance.
184	*/
185	public static IntegerRangeValidator nonNegative(String validationMessage,
186	NumberFormat format) {
187	return new IntegerRangeValidator(ZERO, null, GREATER_EQUAL, UNDEFINED,
188	defaultIfNull(validationMessage, NON_NEGATIVE_MESSAGE), format);
189	}
190
191	protected int compare(Number number1, Number number2) {
192	Integer integer1 = (Integer) number1;
193	Integer integer2 = (Integer) number2;
194	return integer1.compareTo(integer2);
195	}
196
197	private static String defaultIfNull(String string, String defaultString) {
198	return (string != null) ? string : defaultString;
199	}
200	}

Added Link Here

(-)src/org/eclipse/core/databinding/editing/StringEditing.java (+232 lines)
1	/*******************************************************************************
2	* Copyright (c) 2009 Ovidio Mallo and others.
3	* All rights reserved. This program and the accompanying materials
4	* are made available under the terms of the Eclipse Public License v1.0
5	* which accompanies this distribution, and is available at
6	* http://www.eclipse.org/legal/epl-v10.html
7	*
8	* Contributors:
9	* Ovidio Mallo - initial API and implementation (bug 183055)
10	******************************************************************************/
11
12	package org.eclipse.core.databinding.editing;
13
14	import org.eclipse.core.databinding.conversion.IConverter;
15	import org.eclipse.core.databinding.validation.constraint.Constraints;
16	import org.eclipse.core.databinding.validation.constraint.StringConstraints;
17	import org.eclipse.core.internal.databinding.conversion.StringStripConverter;
18	import org.eclipse.core.internal.databinding.conversion.StringTrimConverter;
19
20	/**
21	* @since 1.4
22	*/
23	public final class StringEditing extends Editing {
24
25	private StringEditing(IConverter targetConverter) {
26	setTargetConverter(targetConverter);
27	}
28
29	/**
30	* Creates a new editing object for strings which performs no validation or
31	* conversion.
32	*
33	* @return The new editing object which performs no validation or
34	* conversion.
35	*/
36	public static StringEditing withDefaults() {
37	return new StringEditing(null);
38	}
39
40	/**
41	* Creates a new editing object which strips whitespace from both ends of
42	* the input string.
43	*
44	* @param stripToNull
45	* Whether to convert the input string to <code>null</code> in
46	* case stripping the input string results in an empty string.
47	* @return The new editing object which strips whitespace from both ends of
48	* the input string.
49	*
50	* @see Character#isWhitespace(char)
51	*/
52	public static StringEditing stripped(boolean stripToNull) {
53	return new StringEditing(new StringStripConverter(stripToNull));
54	}
55
56	/**
57	* Creates a new editing object which {@link String#trim()}s the input
58	* string.
59	*
60	* @param trimToNull
61	* Whether to convert the input string to <code>null</code> in
62	* case trimming the input string results in an empty string.
63	* @return The new editing object which trims whitespace from both ends of
64	* the input string.
65	*
66	* @see String#trim()
67	*/
68	public static StringEditing trimmed(boolean trimToNull) {
69	return new StringEditing(new StringTrimConverter(trimToNull));
70	}
71
72	/**
73	* Returns the target constraints to apply.
74	*
75	* <p>
76	* This method provides a typesafe access to the {@link StringConstraints
77	* string target constraints} of this editing object and is equivalent to
78	* {@code (StringConstraints) targetConstraints()}.
79	* </p>
80	*
81	* @return The target constraints to apply.
82	*
83	* @see #targetConstraints()
84	* @see StringConstraints
85	*/
86	public StringConstraints targetStringConstraints() {
87	return (StringConstraints) targetConstraints();
88	}
89
90	/**
91	* Returns the model constraints to apply.
92	*
93	* <p>
94	* This method provides a typesafe access to the {@link StringConstraints
95	* string model constraints} of this editing object and is equivalent to
96	* {@code (StringConstraints) modelConstraints()}.
97	* </p>
98	*
99	* @return The target constraints to apply.
100	*
101	* @see #modelConstraints()
102	* @see StringConstraints
103	*/
104	public StringConstraints modelStringConstraints() {
105	return (StringConstraints) modelConstraints();
106	}
107
108	/**
109	* Returns the before-set model constraints to apply.
110	*
111	* <p>
112	* This method provides a typesafe access to the {@link StringConstraints
113	* string before-set model constraints} of this editing object and is
114	* equivalent to {@code (StringConstraints) beforeSetModelConstraints()}.
115	* </p>
116	*
117	* @return The target constraints to apply.
118	*
119	* @see #beforeSetModelConstraints()
120	* @see StringConstraints
121	*/
122	public StringConstraints beforeSetModelStringConstraints() {
123	return (StringConstraints) beforeSetModelConstraints();
124	}
125
126	protected Constraints createTargetConstraints() {
127	return new StringConstraints();
128	}
129
130	protected Constraints createModelConstraints() {
131	return new StringConstraints();
132	}
133
134	protected Constraints createBeforeSetModelConstraints() {
135	return new StringConstraints();
136	}
137
138	/**
139	* Convenience method which adds a {@link StringConstraints#required()
140	* required constraint} to the set of {@link #modelStringConstraints()}.
141	*
142	* @return This editing instance for method chaining.
143	*
144	* @see StringConstraints#required()
145	* @see #modelStringConstraints()
146	*/
147	public StringEditing required() {
148	modelStringConstraints().required();
149	return this;
150	}
151
152	/**
153	* Convenience method which adds a {@link StringConstraints#nonEmpty()
154	* non-empty constraint} to the set of {@link #modelStringConstraints()}.
155	*
156	* @return This editing instance for method chaining.
157	*
158	* @see StringConstraints#nonEmpty()
159	* @see #modelStringConstraints()
160	*/
161	public StringEditing nonEmpty() {
162	modelStringConstraints().nonEmpty();
163	return this;
164	}
165
166	/**
167	* Convenience method which adds a {@link StringConstraints#minLength(int)
168	* min-length constraint} to the set of {@link #modelStringConstraints()}.
169	*
170	* @param minLength
171	* The min length of the min-length constraint.
172	* @return This editing instance for method chaining.
173	*
174	* @see StringConstraints#minLength(int)
175	* @see #modelStringConstraints()
176	*/
177	public StringEditing minLength(int minLength) {
178	modelStringConstraints().minLength(minLength);
179	return this;
180	}
181
182	/**
183	* Convenience method which adds a {@link StringConstraints#maxLength(int)
184	* max-length constraint} to the set of {@link #modelStringConstraints()}.
185	*
186	* @param maxLength
187	* The max length of the max-length constraint.
188	* @return This editing instance for method chaining.
189	*
190	* @see StringConstraints#maxLength(int)
191	* @see #modelStringConstraints()
192	*/
193	public StringEditing maxLength(int maxLength) {
194	modelStringConstraints().maxLength(maxLength);
195	return this;
196	}
197
198	/**
199	* Convenience method which adds a
200	* {@link StringConstraints#lengthRange(int, int) length-range constraint}
201	* to the set of {@link #modelStringConstraints()}.
202	*
203	* @param minLength
204	* The min length of the length-range constraint.
205	* @param maxLength
206	* The max length of the length-range constraint.
207	* @return This editing instance for method chaining.
208	*
209	* @see StringConstraints#lengthRange(int, int)
210	* @see #modelStringConstraints()
211	*/
212	public StringEditing lengthRange(int minLength, int maxLength) {
213	modelStringConstraints().lengthRange(minLength, maxLength);
214	return this;
215	}
216
217	/**
218	* Convenience method which adds a {@link StringConstraints#matches(String)
219	* matches constraint} to the set of {@link #modelStringConstraints()}.
220	*
221	* @param regex
222	* The regular expression of the matches constraint.
223	* @return This editing instance for method chaining.
224	*
225	* @see StringConstraints#matches(String)
226	* @see #modelStringConstraints()
227	*/
228	public StringEditing matches(String regex) {
229	modelStringConstraints().matches(regex);
230	return this;
231	}
232	}

Added Link Here

(-)src/org/eclipse/core/databinding/validation/constraint/DateConstraints.java (+252 lines)
1	/*******************************************************************************
2	* Copyright (c) 2009 Ovidio Mallo and others.
3	* All rights reserved. This program and the accompanying materials
4	* are made available under the terms of the Eclipse Public License v1.0
5	* which accompanies this distribution, and is available at
6	* http://www.eclipse.org/legal/epl-v10.html
7	*
8	* Contributors:
9	* Ovidio Mallo - initial API and implementation (bug 183055)
10	******************************************************************************/
11
12	package org.eclipse.core.databinding.validation.constraint;
13
14	import java.util.Date;
15
16	import org.eclipse.core.internal.databinding.validation.DateRangeValidator;
17	import org.eclipse.core.internal.databinding.validation.NonNullValidator;
18
19	import com.ibm.icu.text.DateFormat;
20
21	/**
22	* @since 1.4
23	*/
24	public final class DateConstraints extends Constraints {
25
26	private DateFormat displayFormat = DateFormat.getDateInstance();
27
28	private String requiredMessage = null;
29
30	private String afterMessage = null;
31
32	private String afterEqualMessage = null;
33
34	private String beforeMessage = null;
35
36	private String beforeEqualMessage = null;
37
38	private String rangeMessage = null;
39
40	/**
41	* Sets the format to use when formatting a date to be included in any of
42	* the validation messages.
43	*
44	* <p>
45	* This date format will be used for any subsequent constraints which are
46	* applied.
47	* </p>
48	*
49	* @param format
50	* The format to use for displaying dates in validation messages.
51	* @return This constraints instance for method chaining.
52	*/
53	public DateConstraints displayFormat(DateFormat format) {
54	this.displayFormat = format;
55	return this;
56	}
57
58	/**
59	* Adds a validator ensuring that the parsed date is not <code>null</code>.
60	* Uses the current {@link #requiredMessage(String) validation message}.
61	*
62	* @return This constraints instance for method chaining.
63	*/
64	public DateConstraints required() {
65	addValidator(new NonNullValidator(requiredMessage));
66	return this;
67	}
68
69	/**
70	* Sets the validation message for the {@link #required()} constraint.
71	*
72	* @param message
73	* The validation message for the {@link #required()} constraint.
74	* @return This constraints instance for method chaining.
75	*
76	* @see #required()
77	*/
78	public DateConstraints requiredMessage(String message) {
79	this.requiredMessage = message;
80	return this;
81	}
82
83	/**
84	* Adds a validator ensuring that the parsed date is after the given date.
85	* Uses the current {@link #afterMessage(String) validation message}.
86	*
87	* @param date
88	* The date which the parsed date must be after.
89	* @return This constraints instance for method chaining.
90	*
91	* @see Date#after(Date)
92	*/
93	public DateConstraints after(Date date) {
94	addValidator(DateRangeValidator
95	.after(date, afterMessage, displayFormat));
96	return this;
97	}
98
99	/**
100	* Sets the validation message pattern for the {@link #after(Date)}
101	* constraint.
102	*
103	* @param message
104	* The validation message pattern for the {@link #after(Date)}
105	* constraint. Can be parameterized with the date which the
106	* parsed date must be after.
107	* @return This constraints instance for method chaining.
108	*
109	* @see #after(Date)
110	*/
111	public DateConstraints afterMessage(String message) {
112	this.afterMessage = message;
113	return this;
114	}
115
116	/**
117	* Adds a validator ensuring that the parsed date is after or on the given
118	* date. Uses the current {@link #afterEqualMessage(String) validation
119	* message}.
120	*
121	* @param date
122	* The date which the parsed date must be after or on.
123	* @return This constraints instance for method chaining.
124	*
125	* @see Date#after(Date)
126	* @see Date#equals(Object)
127	*/
128	public DateConstraints afterEqual(Date date) {
129	addValidator(DateRangeValidator.afterEqual(date, afterEqualMessage,
130	displayFormat));
131	return this;
132	}
133
134	/**
135	* Sets the validation message pattern for the {@link #afterEqual(Date)}
136	* constraint.
137	*
138	* @param message
139	* The validation message pattern for the
140	* {@link #afterEqual(Date)} constraint. Can be parameterized
141	* with the date which the parsed date must be after or on.
142	* @return This constraints instance for method chaining.
143	*
144	* @see #afterEqual(Date)
145	*/
146	public DateConstraints afterEqualMessage(String message) {
147	this.afterEqualMessage = message;
148	return this;
149	}
150
151	/**
152	* Adds a validator ensuring that the parsed date is before the given date.
153	* Uses the current {@link #beforeMessage(String) validation message}.
154	*
155	* @param date
156	* The date which the parsed date must be before
157	* @return This constraints instance for method chaining.
158	*
159	* @see Date#before(Date)
160	*/
161	public DateConstraints before(Date date) {
162	addValidator(DateRangeValidator.before(date, beforeMessage,
163	displayFormat));
164	return this;
165	}
166
167	/**
168	* Sets the validation message pattern for the {@link #before(Date)}
169	* constraint.
170	*
171	* @param message
172	* The validation message pattern for the {@link #before(Date)}
173	* constraint. Can be parameterized with the date which the
174	* parsed date must be before.
175	* @return This constraints instance for method chaining.
176	*
177	* @see #before(Date)
178	*/
179	public DateConstraints beforeMessage(String message) {
180	this.beforeMessage = message;
181	return this;
182	}
183
184	/**
185	* Adds a validator ensuring that the parsed date is before or on the given
186	* date. Uses the current {@link #beforeEqualMessage(String) validation
187	* message}.
188	*
189	* @param date
190	* The date which the parsed date must be before or on.
191	* @return This constraints instance for method chaining.
192	*
193	* @see Date#before(Date)
194	* @see Date#equals(Object)
195	*/
196	public DateConstraints beforeEqual(Date date) {
197	addValidator(DateRangeValidator.beforeEqual(date, beforeEqualMessage,
198	displayFormat));
199	return this;
200	}
201
202	/**
203	* Sets the validation message pattern for the {@link #beforeEqual(Date)}
204	* constraint.
205	*
206	* @param message
207	* The validation message pattern for the
208	* {@link #beforeEqual(Date)} constraint. Can be parameterized
209	* with the date which the parsed date must be before or on.
210	* @return This constraints instance for method chaining.
211	*
212	* @see #beforeEqual(Date)
213	*/
214	public DateConstraints beforeEqualMessage(String message) {
215	this.beforeEqualMessage = message;
216	return this;
217	}
218
219	/**
220	* Adds a validator ensuring that the parsed date is within the given range.
221	* Uses the current {@link #rangeMessage(String) validation message}.
222	*
223	* @param minDate
224	* The lower bound of the range (inclusive).
225	* @param maxDate
226	* The upper bound of the range (inclusive).
227	* @return This constraints instance for method chaining.
228	*/
229	public DateConstraints range(Date minDate, Date maxDate) {
230	addValidator(DateRangeValidator.range(minDate, maxDate, rangeMessage,
231	displayFormat));
232	return this;
233	}
234
235	/**
236	* Sets the validation message pattern for the {@link #range(Date, Date)}
237	* constraint.
238	*
239	* @param message
240	* The validation message pattern for the
241	* {@link #range(Date, Date)} constraint. Can be parameterized
242	* with the min and max dates of the range in which the parsed
243	* date must lie.
244	* @return This constraints instance for method chaining.
245	*
246	* @see #range(Date, Date)
247	*/
248	public DateConstraints rangeMessage(String message) {
249	this.rangeMessage = message;
250	return this;
251	}
252	}

Added Link Here

(-)src/org/eclipse/jface/examples/databinding/util/ObservableMapEditingSupport.java (+88 lines)
1	/*******************************************************************************
2	* Copyright (c) 2009 Ovidio Mallo and others.
3	* All rights reserved. This program and the accompanying materials
4	* are made available under the terms of the Eclipse Public License v1.0
5	* which accompanies this distribution, and is available at
6	* http://www.eclipse.org/legal/epl-v10.html
7	*
8	* Contributors:
9	* Ovidio Mallo - initial API and implementation (bug 183055)
10	******************************************************************************/
11
12	package org.eclipse.jface.examples.databinding.util;
13
14	import org.eclipse.core.databinding.editing.Editing;
15	import org.eclipse.core.databinding.observable.map.IObservableMap;
16	import org.eclipse.core.databinding.util.Policy;
17	import org.eclipse.core.runtime.IStatus;
18	import org.eclipse.core.runtime.MultiStatus;
19	import org.eclipse.jface.dialogs.MessageDialog;
20	import org.eclipse.jface.viewers.CellEditor;
21	import org.eclipse.jface.viewers.ColumnViewer;
22	import org.eclipse.jface.viewers.EditingSupport;
23	import org.eclipse.jface.viewers.TextCellEditor;
24	import org.eclipse.swt.widgets.Composite;
25
26	/**
27	* @since 3.2
28	*/
29	public class ObservableMapEditingSupport extends EditingSupport {
30
31	private final IObservableMap attributeMap;
32
33	private final Editing editing;
34
35	private final CellEditor cellEditor;
36
37	public ObservableMapEditingSupport(ColumnViewer viewer, IObservableMap attributeMap, Editing editing) {
38	super(viewer);
39	this.attributeMap = attributeMap;
40	this.editing = editing;
41	this.cellEditor = new TextCellEditor((Composite) getViewer().getControl());
42	}
43
44	protected boolean canEdit(Object element) {
45	return true;
46	}
47
48	protected CellEditor getCellEditor(Object element) {
49	return cellEditor;
50	}
51
52	protected Object getValue(Object element) {
53	return editing.convertToTarget(attributeMap.get(element));
54	}
55
56	protected void setValue(Object element, Object value) {
57	MultiStatus validationStatus = new MultiStatus(Policy.JFACE_DATABINDING, 0, null, null);
58	Object modelValue = editing.convertToModel(value, validationStatus);
59	if (handleValidation(validationStatus)) {
60	attributeMap.put(element, modelValue);
61	}
62	}
63
64	private boolean handleValidation(IStatus validationStatus) {
65	if (validationStatus.matches(IStatus.ERROR \| IStatus.CANCEL)) {
66	MessageDialog.openError(getViewer().getControl().getShell(), "Validation Error", getValidationMessage(validationStatus));
67	return false;
68	}
69	return true;
70	}
71
72	private static String getValidationMessage(IStatus validationStatus) {
73	if (!validationStatus.isMultiStatus()) {
74	return validationStatus.getMessage();
75	}
76
77	MultiStatus multiStatus = (MultiStatus) validationStatus;
78	StringBuffer sb = new StringBuffer();
79	IStatus[] childStatus = multiStatus.getChildren();
80	for (int i = 0; i < childStatus.length; i++) {
81	if (i > 0) {
82	sb.append('\n');
83	}
84	sb.append(getValidationMessage(childStatus[i]));
85	}
86	return sb.toString();
87	}
88	}

Added Link Here

(-)src/org/eclipse/jface/examples/databinding/snippets/Snippet035Editing.java (+224 lines)
1	/*******************************************************************************
2	* Copyright (c) 2006, 2009 Ovidio Mallo and others.
3	* All rights reserved. This program and the accompanying materials
4	* are made available under the terms of the Eclipse Public License v1.0
5	* which accompanies this distribution, and is available at
6	* http://www.eclipse.org/legal/epl-v10.html
7	*
8	* Contributors:
9	* Ovidio Mallo - initial API and implementation (bug 183055)
10	******************************************************************************/
11
12	package org.eclipse.jface.examples.databinding.snippets;
13
14	import java.util.Calendar;
15	import java.util.Date;
16
17	import org.eclipse.core.databinding.Binding;
18	import org.eclipse.core.databinding.DataBindingContext;
19	import org.eclipse.core.databinding.editing.BooleanEditing;
20	import org.eclipse.core.databinding.editing.DateEditing;
21	import org.eclipse.core.databinding.editing.Editing;
22	import org.eclipse.core.databinding.editing.IntegerEditing;
23	import org.eclipse.core.databinding.observable.Realm;
24	import org.eclipse.core.databinding.observable.list.WritableList;
25	import org.eclipse.core.databinding.observable.value.IObservableValue;
26	import org.eclipse.core.databinding.observable.value.WritableValue;
27	import org.eclipse.core.runtime.IStatus;
28	import org.eclipse.jface.databinding.swt.ISWTObservableValue;
29	import org.eclipse.jface.databinding.swt.SWTObservables;
30	import org.eclipse.jface.databinding.viewers.ObservableListContentProvider;
31	import org.eclipse.jface.examples.databinding.util.EditingFactory;
32	import org.eclipse.jface.internal.databinding.provisional.fieldassist.ControlDecorationSupport;
33	import org.eclipse.jface.layout.GridDataFactory;
34	import org.eclipse.jface.layout.GridLayoutFactory;
35	import org.eclipse.jface.viewers.LabelProvider;
36	import org.eclipse.jface.viewers.ListViewer;
37	import org.eclipse.swt.SWT;
38	import org.eclipse.swt.events.FocusAdapter;
39	import org.eclipse.swt.events.FocusEvent;
40	import org.eclipse.swt.events.SelectionAdapter;
41	import org.eclipse.swt.events.SelectionEvent;
42	import org.eclipse.swt.layout.GridLayout;
43	import org.eclipse.swt.widgets.Composite;
44	import org.eclipse.swt.widgets.Control;
45	import org.eclipse.swt.widgets.Display;
46	import org.eclipse.swt.widgets.Group;
47	import org.eclipse.swt.widgets.Label;
48	import org.eclipse.swt.widgets.Shell;
49	import org.eclipse.swt.widgets.Text;
50
51	public class Snippet035Editing {
52
53	private DataBindingContext dbc;
54
55	public static void main(String[] args) {
56	Display display = new Display();
57
58	Realm.runWithDefault(SWTObservables.getRealm(display), new Runnable() {
59	public void run() {
60	Shell shell = new Snippet035Editing().createShell();
61	Display display = Display.getCurrent();
62	while (!shell.isDisposed()) {
63	if (!display.readAndDispatch()) {
64	display.sleep();
65	}
66	}
67	}
68	});
69	}
70
71	private Shell createShell() {
72	Display display = Display.getCurrent();
73	Shell shell = new Shell(display);
74	shell.setText("Editing");
75	shell.setLayout(new GridLayout(1, false));
76
77	dbc = new DataBindingContext();
78
79	createValueSection(shell);
80	createListSection(shell);
81
82	shell.pack();
83	shell.open();
84
85	return shell;
86	}
87
88	private void createValueSection(Composite parent) {
89	Group section = createSectionGroup(parent, "Value bindings", false);
90
91	// Edit an e-mail address.
92	Text emailText = createTextField(section, "E-Mail*");
93	Editing emailEditing = EditingFactory.forEmailString().required();
94	bindTextField(emailText, new WritableValue(), emailEditing);
95
96	// Edit a required, positive integer using the default validation message.
97	Text positiveText = createTextField(section, "Positive value*");
98	IntegerEditing positiveEditing = EditingFactory.forInteger().required().positive();
99	bindTextField(positiveText, new WritableValue(), positiveEditing);
100
101	// Edit an integer within the range [1, 100] using the default
102	// validation message.
103	Text rangeText = createTextField(section, "Value in [1, 100]");
104	IntegerEditing rangeEditing = EditingFactory.forInteger().range(1, 100);
105	bindTextField(rangeText, new WritableValue(new Integer(0), null), rangeEditing);
106
107	// Edit a percentage value which must lie within [0, 100] using a custom
108	// validation message which indicates that the value actually represents
109	// a percentage value.
110	Text percentText = createTextField(section, "Value [%]");
111	IntegerEditing percentEditing = EditingFactory.forInteger();
112	percentEditing.modelIntegerConstraints()
113	.rangeMessage("Please specify a percentage value within [{0}, {1}].")
114	.range(0, 100);
115	bindTextField(percentText, new WritableValue(new Integer(-1), null), percentEditing);
116
117	// Edit a hex integer within the range [0x00, 0xff]. The range validation
118	// message will display the range boundaries in hex format as well.
119	Text hexText = createTextField(section, "Hex value in [0x00, 0xff]");
120	IntegerEditing hexEditing = EditingFactory.forHexInteger(2).range(0x00, 0xff);
121	bindTextField(hexText, new WritableValue(new Integer(0), null), hexEditing);
122
123	// Edit a boolean value.
124	Text boolText = createTextField(section, "Boolean value");
125	BooleanEditing boolEditing = EditingFactory.forBoolean();
126	bindTextField(boolText, new WritableValue(Boolean.TRUE, null), boolEditing);
127	}
128
129	private void createListSection(Composite parent) {
130	Group section = createSectionGroup(parent, "List bindings", true);
131
132	// Our date should be >= 01.01.1990.
133	Calendar year1990Calendar = Calendar.getInstance();
134	year1990Calendar.clear();
135	year1990Calendar.set(1990, 0, 1);
136	Date year1990 = year1990Calendar.getTime();
137
138	// Edit a date supporting the default input/display patterns.
139	Text dateText = createTextField(section, "Date");
140	DateEditing dateEditing = EditingFactory.forDate().afterEqual(year1990);
141	final WritableValue dateObservable = new WritableValue();
142	final Binding dateBinding = bindTextField(dateText, dateObservable, dateEditing);
143
144	// Create a list to which the dates are added when the user hits ENTER.
145	new Label(section, SWT.LEFT);
146	ListViewer dateListViewer = new ListViewer(section);
147	GridDataFactory.fillDefaults().grab(true, true).hint(150, 200).applyTo(dateListViewer.getList());
148
149	dateListViewer.setContentProvider(new ObservableListContentProvider());
150	dateListViewer.setLabelProvider(new LabelProvider());
151
152	// We use the same DateEditing object as for the text field above to
153	// create a list binding which maps the entered dates to their string
154	// representation which is then set as input on the ListViewer.
155	final WritableList targetDateList = new WritableList();
156	final WritableList modelDateList = new WritableList();
157	dateEditing.bindList(dbc, targetDateList, modelDateList);
158
159	// Set the list containing the string representation of the dates as input.
160	dateListViewer.setInput(targetDateList);
161
162	// Add the current date in the text field when the user hits ENTER.
163	dateText.addSelectionListener(new SelectionAdapter() {
164	public void widgetDefaultSelected(SelectionEvent e) {
165	IStatus dateValidationStatus = (IStatus) dateBinding.getValidationStatus().getValue();
166	Date date = (Date) dateObservable.getValue();
167	if (dateValidationStatus.isOK() && date != null) {
168	modelDateList.add(date);
169	}
170	}
171	});
172	}
173
174	private Binding bindTextField(Text text, IObservableValue modelValue, Editing editing) {
175	// Create the binding using the editing object.
176	ISWTObservableValue textObservable = SWTObservables.observeText(text, SWT.Modify);
177	Binding binding = editing.bindValue(dbc, textObservable, modelValue);
178
179	// Decorate the control with the validation status.
180	ControlDecorationSupport.create(binding, SWT.TOP);
181
182	// Re-format when the text field looses the focus in order to always
183	// display the model in the default format in case multiple input formats
184	// are supported.
185	formatOnFocusOut(text, binding);
186
187	return binding;
188	}
189
190	private static void formatOnFocusOut(final Control control, final Binding binding) {
191	control.addFocusListener(new FocusAdapter() {
192	public void focusLost(FocusEvent e) {
193	IStatus dateValidationStatus = (IStatus) binding.getValidationStatus().getValue();
194	if (dateValidationStatus.isOK()) {
195	binding.updateModelToTarget();
196	}
197	}
198	});
199	}
200
201	private static Group createSectionGroup(Composite parent, String groupText, boolean grabVertical) {
202	Group section = new Group(parent, SWT.SHADOW_ETCHED_IN);
203	section.setText(groupText);
204	GridLayoutFactory.fillDefaults()
205	.numColumns(2)
206	.equalWidth(false)
207	.margins(5, 5)
208	.spacing(15, 5)
209	.applyTo(section);
210	GridDataFactory.fillDefaults().grab(true, grabVertical).applyTo(section);
211	return section;
212	}
213
214	private static Text createTextField(Composite parent, String labelText) {
215	Label label = new Label(parent, SWT.LEFT);
216	label.setText(labelText);
217	GridDataFactory.fillDefaults().align(SWT.LEFT, SWT.CENTER).applyTo(label);
218
219	Text text = new Text(parent, SWT.BORDER);
220	GridDataFactory.fillDefaults().grab(true, false).hint(150, SWT.DEFAULT).applyTo(text);
221
222	return text;
223	}
224	}

Lines 12-17 Link Here

(-)src/org/eclipse/core/tests/internal/databinding/BindingMessagesTest.java (-2 / +3 lines)
12	*	12	*
13	* Contributors:	13	* Contributors:
14	* IBM Corporation - initial API and implementation	14	* IBM Corporation - initial API and implementation
		15	* Ovidio Mallo - bug 183055
15	******************************************************************************/	16	******************************************************************************/
16		17
17	/**	18	/**
Lines 21-33 Link Here
21	public class BindingMessagesTest extends TestCase {	22	public class BindingMessagesTest extends TestCase {
22	public void testFormatString() throws Exception {	23	public void testFormatString() throws Exception {
23	String key = "Validate_NumberOutOfRangeError";	24	String key = "Validate_NumberOutOfRangeError";
24	String result = BindingMessages.formatString(key, new Object[] {"1", "2"});	25	String result = BindingMessages.getFormattedString(key, new Object[] {"1", "2"});
25	assertFalse("key should not be returned", key.equals(result));	26	assertFalse("key should not be returned", key.equals(result));
26	}	27	}
27		28
28	public void testFormatStringForKeyNotFound() throws Exception {	29	public void testFormatStringForKeyNotFound() throws Exception {
29	String key = "key_that_does_not_exist";	30	String key = "key_that_does_not_exist";
30	String result = BindingMessages.formatString(key, null);	31	String result = BindingMessages.getFormattedString(key, null);
31	assertTrue(key.equals(result));	32	assertTrue(key.equals(result));
32	}	33	}
33	}	34	}