org.eclipse.core.databinding.editing,

 org.eclipse.core.databinding.validation.constraint,

 *     Ovidio Mallo - bug 183055

import org.eclipse.core.internal.databinding.conversion.BooleanToStringConverter;

/*******************************************************************************

 * 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.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;

/**

 * @noextend This class is not intended to be subclassed by clients.

 * @since 1.4

 */

public class BooleanEditing extends Editing<String, Boolean> {

	/**

	 * Creates a new editing object for booleans.

	 * 

	 * @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 a boolean.

	 * 

	 * @noreference This constructor is not intended to be referenced by

	 *              clients.

	 */

	protected 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 withDefaults(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 a 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 forStringValues(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 a 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);

	}

	public StringConstraints targetConstraints() {

		return (StringConstraints) super.targetConstraints();

	}

	public BooleanConstraints modelConstraints() {

		return (BooleanConstraints) super.modelConstraints();

	}

	public BooleanConstraints beforeSetModelConstraints() {

		return (BooleanConstraints) super.beforeSetModelConstraints();

	}

	protected StringConstraints createTargetConstraints() {

		return new StringConstraints();

	}

	protected BooleanConstraints createModelConstraints() {

		return new BooleanConstraints();

	}

	protected BooleanConstraints createBeforeSetModelConstraints() {

		return new BooleanConstraints();

	}

}

/*******************************************************************************

 * 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.CharacterConstraints;

import org.eclipse.core.databinding.validation.constraint.StringConstraints;

import org.eclipse.core.internal.databinding.conversion.CharacterToStringConverter;

import org.eclipse.core.internal.databinding.conversion.StringToCharacterConverter;

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

/**

 * @noextend This class is not intended to be subclassed by clients.

 * @since 1.4

 */

public class CharacterEditing extends Editing<String, Character> {

	/**

	 * Creates a new editing object for booleans.

	 * 

	 * @param parseErrorMessage

	 *            The validation message issued in case the input string is not

	 *            a valid character.

	 * 

	 * @noreference This constructor is not intended to be referenced by

	 *              clients.

	 */

	protected CharacterEditing(String parseErrorMessage) {

		StringToCharacterConverter targetConverter = new StringToCharacterConverter(

				false);

		CharacterToStringConverter modelConverter = CharacterToStringConverter

				.fromCharacter(false);

		StringToCharacterValidator targetValidator = new StringToCharacterValidator(

				targetConverter);

		if (parseErrorMessage != null) {

			targetValidator.setParseErrorMessage(parseErrorMessage);

		}

		setTargetConverter(targetConverter);

		setModelConverter(modelConverter);

		targetConstraints().addValidator(targetValidator);

	}

	/**

	 * Creates a new editing object which uses the default validations and

	 * conversions for the editing of characters.

	 * 

	 * @return The new editing object for the default editing of characters.

	 */

	public static CharacterEditing withDefaults() {

		return withDefaults(null);

	}

	/**

	 * Creates a new editing object which uses the default validations and

	 * conversions for the editing of characters. Uses the specified custom

	 * validation message.

	 * 

	 * @param parseErrorMessage

	 *            The validation message issued in case the input string is not

	 *            a valid character.

	 * @return The new editing object for the default editing of characters.

	 */

	public static CharacterEditing withDefaults(String parseErrorMessage) {

		return new CharacterEditing(parseErrorMessage);

	}

	public StringConstraints targetConstraints() {

		return (StringConstraints) super.targetConstraints();

	}

	public CharacterConstraints modelConstraints() {

		return (CharacterConstraints) super.modelConstraints();

	}

	public CharacterConstraints beforeSetModelConstraints() {

		return (CharacterConstraints) super.beforeSetModelConstraints();

	}

	protected StringConstraints createTargetConstraints() {

		return new StringConstraints();

	}

	protected CharacterConstraints createModelConstraints() {

		return new CharacterConstraints();

	}

	protected CharacterConstraints createBeforeSetModelConstraints() {

		return new CharacterConstraints();

	}

}

/*******************************************************************************

 * 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.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;

/**

 * @noextend This class is not intended to be subclassed by clients.

 * @since 1.4

 */

public class DateEditing extends Editing<String, Date> {

	private final DateFormat displayFormat;

	/**

	 * Creates a new editing object for <code>Date</code>s.

	 * 

	 * @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.

	 * 

	 * @noreference This constructor is not intended to be referenced by

	 *              clients.

	 */

	protected 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);

	}

	public StringConstraints targetConstraints() {

		return (StringConstraints) super.targetConstraints();

	}

	public DateConstraints modelConstraints() {

		return (DateConstraints) super.modelConstraints();

	}

	public DateConstraints beforeSetModelConstraints() {

		return (DateConstraints) super.beforeSetModelConstraints();

	}

	protected StringConstraints createTargetConstraints() {

		return new StringConstraints();

	}

	protected DateConstraints createModelConstraints() {

		return new DateConstraints().dateFormat(displayFormat);

	}

	protected DateConstraints createBeforeSetModelConstraints() {

		return new DateConstraints().dateFormat(displayFormat);

	}

}

/*******************************************************************************

 * 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;

/**

 * @param <T>

 * @param <M>

 * 

 * @since 1.4

 */

public class Editing<T, M> {

	private Constraints<T> targetConstraints;

	private Constraints<M> modelConstraints;

	private Constraints<M> 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.

	 * 

	 * @param <MT>

	 * @param <MM>

	 */

	public static <MT, MM> Editing<MT, MM> create() {

		return new Editing<MT, MM>();

	}

	/**

	 * 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.

	 * 

	 * @param <MM>

	 * @param <MT>

	 */

	public static <MT, MM> Editing<MT, MM> withConverters(

			IConverter t2mConverter, IConverter m2tConverter) {

		Editing<MT, MM> editing = new Editing<MT, MM>();

		editing.setTargetConverter(t2mConverter);

		editing.setModelConverter(m2tConverter);

		return editing;

	}

	/**

	 * Returns the target constraints to apply.

	 * 

	 * @return The target constraints to apply.

	 * 

	 * @see #createTargetConstraints()

	 */

	public Constraints<T> targetConstraints() {

		if (targetConstraints == null) {

			targetConstraints = createTargetConstraints();

		}

		return targetConstraints;

	}

	/**

	 * Returns the model constraints to apply.

	 * 

	 * @return The model constraints to apply.

	 * 

	 * @see #createModelConstraints()

	 */

	public Constraints<M> 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 Constraints<M> 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<T> createTargetConstraints() {

		return new Constraints<T>();

	}

	/**

	 * 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<M> createModelConstraints() {

		return new Constraints<M>();

	}

	/**

	 * 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<M> createBeforeSetModelConstraints() {

		return new Constraints<M>();

	}

	/**

	 * 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 #adaptT2MValueStrategy(UpdateValueStrategy)

	 */

	public final UpdateValueStrategy createT2MValueStrategy() {

		return adaptT2MValueStrategy(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 #adaptT2MValueStrategy(UpdateValueStrategy)

	 */

	public final UpdateValueStrategy createT2MValueStrategy(int updatePolicy) {

		return adaptT2MValueStrategy(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 #adaptM2TValueStrategy(UpdateValueStrategy)

	 */

	public final UpdateValueStrategy createM2TValueStrategy() {

		return adaptM2TValueStrategy(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 #adaptM2TValueStrategy(UpdateValueStrategy)

	 */

	public final UpdateValueStrategy createM2TValueStrategy(int updatePolicy) {

		return adaptM2TValueStrategy(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 #adaptT2MListStrategy(UpdateListStrategy)

	 */

	public final UpdateListStrategy createT2MListStrategy() {

		return adaptT2MListStrategy(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 #adaptT2MListStrategy(UpdateListStrategy)

	 */

	public final UpdateListStrategy createT2MListStrategy(int updatePolicy) {

		return adaptT2MListStrategy(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 #adaptM2TListStrategy(UpdateListStrategy)

	 */

	public final UpdateListStrategy createM2TListStrategy() {

		return adaptM2TListStrategy(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 #adaptM2TListStrategy(UpdateListStrategy)

	 */

	public final UpdateListStrategy createM2TListStrategy(int updatePolicy) {

		return adaptM2TListStrategy(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 #adaptT2MSetStrategy(UpdateSetStrategy)

	 */

	public final UpdateSetStrategy createT2MSetStrategy() {

		return adaptT2MSetStrategy(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 #adaptT2MSetStrategy(UpdateSetStrategy)

	 */

	public final UpdateSetStrategy createT2MSetStrategy(int updatePolicy) {

		return adaptT2MSetStrategy(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 #adaptM2TSetStrategy(UpdateSetStrategy)

	 */

	public final UpdateSetStrategy createM2TSetStrategy() {

		return adaptM2TSetStrategy(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 #adaptM2TSetStrategy(UpdateSetStrategy)

	 */

	public final UpdateSetStrategy createM2TSetStrategy(int updatePolicy) {

		return adaptM2TSetStrategy(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 adaptT2MValueStrategy(

			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 adaptM2TValueStrategy(

			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 adaptT2MListStrategy(

			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 adaptM2TListStrategy(

			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 adaptT2MSetStrategy(

			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 adaptM2TSetStrategy(

			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. May be

	 *            <code>null</code>.

	 * @return The converted model value or <code>null</code> in case the

	 *         conversion has been aborted due to a validation error.

	 */

	public final M convertToModel(T targetValue, MultiStatus validationStatus) {

		if (!applyConstraints(targetConstraints, targetValue, validationStatus)) {

			return null;

		}

		@SuppressWarnings("unchecked")

		M modelValue = (M) applyConverter(targetConverter, targetValue);

		if (!applyConstraints(modelConstraints, modelValue, validationStatus)) {

			return null;

		}

		if (!applyConstraints(beforeSetModelConstraints, 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.

	 */

	@SuppressWarnings("unchecked")

	public final T convertToTarget(M modelValue) {

		return (T) applyConverter(modelConverter, 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 #adaptT2MValueStrategy(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 #adaptM2TValueStrategy(UpdateValueStrategy)

	 *            configured} with the state of this editing object before

	 *            passing it to the binding.

	 * @return The new value binding.

	 * 

	 * @see #adaptT2MValueStrategy(UpdateValueStrategy)

	 * @see #adaptM2TValueStrategy(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,

				adaptT2MValueStrategy(t2mUpdateStrategy),

				adaptM2TValueStrategy(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 #adaptT2MListStrategy(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 #adaptM2TListStrategy(UpdateListStrategy)

	 *            configured} with the state of this editing object before

	 *            passing it to the binding.

	 * @return The new list binding.

	 * 

	 * @see #adaptT2MListStrategy(UpdateListStrategy)

	 * @see #adaptM2TListStrategy(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,

				adaptT2MListStrategy(t2mUpdateStrategy),

				adaptM2TListStrategy(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 #adaptT2MSetStrategy(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 #adaptM2TSetStrategy(UpdateSetStrategy)

	 *            configured} with the state of this editing object before

	 *            passing it to the binding.

	 * @return The new set binding.

	 * 

	 * @see #adaptT2MSetStrategy(UpdateSetStrategy)

	 * @see #adaptM2TSetStrategy(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,

				adaptT2MSetStrategy(t2mUpdateStrategy),

				adaptM2TSetStrategy(m2tUpdateStrategy));

	}

	private static IValidator createValidator(Constraints<?> constraints) {

		return constraints != null ? constraints.createValidator() : null;

	}

	private static boolean applyConstraints(Constraints<?> constraints,

			Object value, MultiStatus aggregateStatus) {

		IValidator validator = createValidator(constraints);

		if (validator != null) {

			IStatus validationStatus = validator.validate(value);

			if (aggregateStatus != null && !validationStatus.isOK()) {

				aggregateStatus.merge(validationStatus);

			}

			return isValid(validationStatus);

		}

		return true;

	}

	private static Object applyConverter(IConverter converter, Object value) {

		return converter != null ? converter.convert(value) : value;

	}

	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.editing;

import java.math.BigDecimal;

import java.math.BigInteger;

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

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

import org.eclipse.core.databinding.validation.constraint.NumberConstraints;

import org.eclipse.core.databinding.validation.constraint.StringConstraints;

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

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

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

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

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

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

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

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

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

import com.ibm.icu.text.NumberFormat;

/**

 * @param <N>

 * 

 * @noextend This class is not intended to be subclassed by clients.

 * @since 1.4

 */

public class NumberEditing<N extends Number & Comparable<N>> extends

		Editing<String, N> {

	private final NumberFormat displayFormat;

	private final Class<N> numberType;

	/**

	 * Creates a new editing object for integer numbers.

	 * 

	 * @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.

	 * @param numberType

	 *            The specific integer type for which to set up an editing

	 *            instance.

	 * 

	 * @noreference This constructor is not intended to be referenced by

	 *              clients.

	 */

	protected NumberEditing(NumberFormat format, String parseErrorMessage,

			String outOfRangeMessage, Class<N> numberType) {

		this.displayFormat = format;

		this.numberType = numberType;

		final StringToNumberConverter targetConverter;

		final NumberToStringConverter modelConverter;

		final AbstractStringToNumberValidator targetValidator;

		if (Long.class.equals(numberType)) {

			targetConverter = StringToNumberConverter.toLong(format, false);

			modelConverter = NumberToStringConverter.fromLong(format, false);

			targetValidator = new StringToLongValidator(targetConverter);

		} else if (Integer.class.equals(numberType)) {

			targetConverter = StringToNumberConverter.toInteger(format, false);

			modelConverter = NumberToStringConverter.fromInteger(format, false);

			targetValidator = new StringToIntegerValidator(targetConverter);

		} else if (Short.class.equals(numberType)) {

			targetConverter = StringToNumberConverter.toShort(format, false);

			modelConverter = NumberToStringConverter.fromShort(format, false);

			targetValidator = new StringToShortValidator(targetConverter);

		} else if (Byte.class.equals(numberType)) {

			targetConverter = StringToNumberConverter.toByte(format, false);

			modelConverter = NumberToStringConverter.fromByte(format, false);

			targetValidator = new StringToByteValidator(targetConverter);

		} else if (Double.class.equals(numberType)) {

			targetConverter = StringToNumberConverter.toDouble(format, false);

			modelConverter = NumberToStringConverter.fromDouble(format, false);

			targetValidator = new StringToDoubleValidator(targetConverter);

		} else if (Float.class.equals(numberType)) {

			targetConverter = StringToNumberConverter.toFloat(format, false);

			modelConverter = NumberToStringConverter.fromFloat(format, false);

			targetValidator = new StringToFloatValidator(targetConverter);

		} else if (BigInteger.class.equals(numberType)) {

			targetConverter = StringToNumberConverter.toBigInteger(format);

			modelConverter = NumberToStringConverter.fromBigInteger(format);

			targetValidator = new StringToBigIntegerValidator(targetConverter);

		} else if (BigDecimal.class.equals(numberType)) {

			targetConverter = StringToNumberConverter.toBigDecimal(format);

			modelConverter = NumberToStringConverter.fromBigDecimal(format);

			targetValidator = new StringToBigDecimalValidator(targetConverter);

		} else {

			throw new IllegalArgumentException(

					"Unsupported number type: " + numberType); //$NON-NLS-1$

		}

		if (parseErrorMessage != null) {

			targetValidator.setParseErrorMessage(parseErrorMessage);

		}

		if (outOfRangeMessage != null) {

			targetValidator.setOutOfRangeMessage(outOfRangeMessage);

		}

		setTargetConverter(targetConverter);

		setModelConverter(modelConverter);

		targetConstraints().addValidator(targetValidator);

	}

	/**

	 * Creates a new editing object for {@link Long}s 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 NumberEditing<Long> withLongDefaults() {

		return withLongDefaults(null, null);

	}

	/**

	 * Creates a new editing object for {@link Long}s 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>Long.MIN_VALUE</code> ({0}) and

	 *            <code>Long.MAX_VALUE</code> ({1}) values.

	 * @return The new editing object using the default validations and

	 *         conversions for editing.

	 * 

	 * @see NumberFormat#getIntegerInstance()

	 */

	public static NumberEditing<Long> withLongDefaults(

			String parseErrorMessage, String outOfRangeMessage) {

		return new NumberEditing<Long>(NumberFormat.getIntegerInstance(),

				parseErrorMessage, outOfRangeMessage, Long.class);

	}

	/**

	 * Creates a new editing object for {@link Long}s 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 NumberEditing<Long> forLongFormat(NumberFormat format) {

		return forLongFormat(format, null, null);

	}

	/**

	 * Creates a new editing object for {@link Long}s 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>Long.MIN_VALUE</code> ({0}) and

	 *            <code>Long.MAX_VALUE</code> ({1}) values.

	 * @return The new editing object configured by the given integer format.

	 */

	public static NumberEditing<Long> forLongFormat(NumberFormat format,

			String parseErrorMessage, String outOfRangeMessage) {

		return new NumberEditing<Long>(format, parseErrorMessage,

				outOfRangeMessage, Long.class);

	}

	/**

	 * Creates a new editing object for {@link Integer}s 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 NumberEditing<Integer> withIntegerDefaults() {

		return withIntegerDefaults(null, null);

	}

	/**

	 * Creates a new editing object for {@link Integer}s 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> ({0}) and

	 *            <code>Integer.MAX_VALUE</code> ({1}) values.

	 * @return The new editing object using the default validations and

	 *         conversions for editing.

	 * 

	 * @see NumberFormat#getIntegerInstance()

	 */

	public static NumberEditing<Integer> withIntegerDefaults(

			String parseErrorMessage, String outOfRangeMessage) {

		return new NumberEditing<Integer>(NumberFormat.getIntegerInstance(),

				parseErrorMessage, outOfRangeMessage, Integer.class);

	}

	/**

	 * Creates a new editing object for {@link Integer}s 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 NumberEditing<Integer> forIntegerFormat(NumberFormat format) {

		return forIntegerFormat(format, null, null);

	}

	/**

	 * Creates a new editing object for {@link Integer}s 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> ({0}) and

	 *            <code>Integer.MAX_VALUE</code> ({1}) values.

	 * @return The new editing object configured by the given integer format.

	 */

	public static NumberEditing<Integer> forIntegerFormat(NumberFormat format,

			String parseErrorMessage, String outOfRangeMessage) {

		return new NumberEditing<Integer>(format, parseErrorMessage,

				outOfRangeMessage, Integer.class);

	}

	/**

	 * Creates a new editing object for {@link Short}s 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 NumberEditing<Short> withShortDefaults() {

		return withShortDefaults(null, null);

	}

	/**

	 * Creates a new editing object for {@link Short}s 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>Short.MIN_VALUE</code> ({0}) and

	 *            <code>Short.MAX_VALUE</code> ({1}) values.

	 * @return The new editing object using the default validations and

	 *         conversions for editing.

	 * 

	 * @see NumberFormat#getIntegerInstance()

	 */

	public static NumberEditing<Short> withShortDefaults(

			String parseErrorMessage, String outOfRangeMessage) {

		return new NumberEditing<Short>(NumberFormat.getIntegerInstance(),

				parseErrorMessage, outOfRangeMessage, Short.class);

	}

	/**

	 * Creates a new editing object for {@link Short}s 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 NumberEditing<Short> forShortFormat(NumberFormat format) {

		return forShortFormat(format, null, null);

	}

	/**

	 * Creates a new editing object for {@link Short}s 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>Short.MIN_VALUE</code> ({0}) and

	 *            <code>Short.MAX_VALUE</code> ({1}) values.

	 * @return The new editing object configured by the given integer format.

	 */