jaxx.runtime.validator.swing
Class SwingValidatorUtil

java.lang.Object
  org.nuiton.validator.bean.BeanValidatorUtil
      jaxx.runtime.validator.swing.SwingValidatorUtil

public class SwingValidatorUtil
extends org.nuiton.validator.bean.BeanValidatorUtil

The helper class for swing validation module.

Author:

tchemit

Nested Class Summary

static class

SwingValidatorUtil.DefaultSwingValidatorCreator Default bean validator creator to use in the BeanValidatorFactory.

Field Summary

protected static EnumMap<org.nuiton.validator.NuitonValidatorScope,Color>	colors
protected static EnumMap<org.nuiton.validator.NuitonValidatorScope,ImageIcon>	icons

Constructor Summary

protected

SwingValidatorUtil()

Method Summary

static void	detectValidatorFields(JAXXValidator ui) Detects on a JAXXValidator ui all the validator fields it contains.
static List<String>	detectValidators(JAXXValidator ui) Given a JAXXValidator ui, detects on it all the validators it contains.
static Color	getColor(org.nuiton.validator.NuitonValidatorScope scope)
static EnumMap<org.nuiton.validator.NuitonValidatorScope,Color>	getColors()
static ImageIcon	getErrorIcon()
static SwingValidatorMessageListMouseListener	getErrorListMouseListener(JList list)
static SwingValidatorMessageTableMouseListener	getErrorTableMouseListener(JTable table)
static ImageIcon	getFatalIcon()
static String	getFieldName(SwingValidatorMessage model, String value)
static ImageIcon	getIcon(org.nuiton.validator.NuitonValidatorScope scope)
static EnumMap<org.nuiton.validator.NuitonValidatorScope,ImageIcon>	getIcons()
static ImageIcon	getInfoIcon()
static String	getMessage(SwingValidatorMessage model)
protected static Map<JComponent,ValidatorField>	getValidatorEditors(JAXXValidator ui)
static ImageIcon	getWarningIcon()
static void	installUI(JAXXValidator ui) To install all the stuff for validation on a JAXXValidator ui.
static void	installUI(JTable errorTable, SwingValidatorMessageTableRenderer render) Prepare the ui where to display the validators messages.
static void	listenValidatorContextNameAndRefreshFields(SwingValidator<?> validator, JAXXValidator ui) Method to listen the modification of the context name and at each time reload fields of the ui.
static <O> SwingValidator<O>	newValidator(Class<O> type, String context)
static SwingValidatorMessageListMouseListener	registerErrorListMouseListener(JList list) Register for a given validator list ui a validator mouse listener.
static SwingValidatorMessageTableMouseListener	registerErrorTableMouseListener(JTable table) Register for a given validator table ui a validator mouse listener Note: there is onlt one listener registred for a givne table model, so invokin this method twice or more will have no effect.
static void	setValidatorBean(JAXXObject ui, Object bean, String... excludeIds) Convinient method to attach a bean to all validators of an JAXXObject.
static void	setValidatorChanged(JAXXObject ui, boolean newValue, String... excludeIds) Convinient method to set the changed property to all validators of an JAXXObject.

Methods inherited from class org.nuiton.validator.bean.BeanValidatorUtil

convert, getScopes, getScopesCount

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

icons

protected static EnumMap<org.nuiton.validator.NuitonValidatorScope,ImageIcon> icons

colors

protected static EnumMap<org.nuiton.validator.NuitonValidatorScope,Color> colors

Constructor Detail

SwingValidatorUtil

protected SwingValidatorUtil()

Method Detail

getIcons

public static EnumMap<org.nuiton.validator.NuitonValidatorScope,ImageIcon> getIcons()

getColors

public static EnumMap<org.nuiton.validator.NuitonValidatorScope,Color> getColors()

getColor

public static Color getColor(org.nuiton.validator.NuitonValidatorScope scope)

getIcon

public static ImageIcon getIcon(org.nuiton.validator.NuitonValidatorScope scope)

getFatalIcon

public static ImageIcon getFatalIcon()

getErrorIcon

public static ImageIcon getErrorIcon()

getWarningIcon

public static ImageIcon getWarningIcon()

getInfoIcon

public static ImageIcon getInfoIcon()

newValidator

public static <O> SwingValidator<O> newValidator(Class<O> type,
                                                 String context)

installUI

public static void installUI(JAXXValidator ui)

To install all the stuff for validation on a JAXXValidator ui.

This method is called after validators has beeen detected in the ui (via the method detectValidators(JAXXValidator))..

It will first find and register all validator field via the method JAXXValidator.registerValidatorFields(), then for each validators it will install ui for it (says connect validator to ui via layers) and will reload attached bean to make visible bean validation state on ui.

This method is always inovked by a generated jaxx-validator file at the end of the $completeSetup method.

Parameters:

ui - the validator ui to init.

detectValidators

public static List<String> detectValidators(JAXXValidator ui)

Given a JAXXValidator ui, detects on it all the validators it contains.

A validator is detected from the annotation Validator placed on his field.

This method is always inovked by a generated jaxx-validator file at the end of the $completeSetup method.

Parameters:

ui - the ui where to seek for validators.

Returns:

the list of ids of validators found on the given ui

detectValidatorFields

public static void detectValidatorFields(JAXXValidator ui)

Detects on a JAXXValidator ui all the validator fields it contains.

A validator field is detected via the annotation placed on his field or his getter (in cas of inheritance).

Each field found will be registred to his corresponding validator via the method SwingValidator.setFieldRepresentation(String, JComponent).

By default, this method is invoked in the generated method JAXXValidator.registerValidatorFields() by a generated jaxx-validator file.

Parameters:

ui - the ui to seek

installUI

public static void installUI(JTable errorTable,
                             SwingValidatorMessageTableRenderer render)

Prepare the ui where to display the validators messages.

Parameters:

errorTable - the table where to display validators messages

render - renderer to use

registerErrorListMouseListener

public static SwingValidatorMessageListMouseListener registerErrorListMouseListener(JList list)

Register for a given validator list ui a validator mouse listener.

Note: there is only one listener registred for a given list model, so invoking this method tiwce or more will have no effect.

Parameters:

list - the validation ui list

Returns:

the listener instanciate or found

See Also:

SwingValidatorMessageListMouseListener

registerErrorTableMouseListener

public static SwingValidatorMessageTableMouseListener registerErrorTableMouseListener(JTable table)

Register for a given validator table ui a validator mouse listener

Note: there is onlt one listener registred for a givne table model, so invokin this method twice or more will have no effect.

Parameters:

table - the validator table ui

Returns:

the listener instanciate or found

See Also:

SwingValidatorMessageTableMouseListener

getErrorListMouseListener

public static SwingValidatorMessageListMouseListener getErrorListMouseListener(JList list)

Parameters:

list - the validator list ui

Returns:

the validator list mouse listener, or null if not found

See Also:

SwingValidatorMessageListMouseListener

getErrorTableMouseListener

public static SwingValidatorMessageTableMouseListener getErrorTableMouseListener(JTable table)

Parameters:

table - the validator table ui

Returns:

the validator table mouse listener, or null if not found

See Also:

SwingValidatorMessageTableMouseListener

getMessage

public static String getMessage(SwingValidatorMessage model)

getFieldName

public static String getFieldName(SwingValidatorMessage model,
                                  String value)

listenValidatorContextNameAndRefreshFields

public static void listenValidatorContextNameAndRefreshFields(SwingValidator<?> validator,
                                                              JAXXValidator ui)

Method to listen the modification of the context name and at each time reload fields of the ui.

Parameters:

validator - validator to listen

ui - ui to refresh when context name has changed

Since:

2.2.1

setValidatorBean

public static void setValidatorBean(JAXXObject ui,
                                    Object bean,
                                    String... excludeIds)

Convinient method to attach a bean to all validators of an JAXXObject.

It is possible to exclude some validator to be treated.

Parameters:

ui - the ui containing the validatros to treate

bean - the bean to attach in validators (can be null)

excludeIds - the list of validator id to exclude

setValidatorChanged

public static void setValidatorChanged(JAXXObject ui,
                                       boolean newValue,
                                       String... excludeIds)

Convinient method to set the changed property to all validators of an JAXXObject.

It is possible to exclude some validator to be treated.

Parameters:

ui - the ui containing the validatros to treate

newValue - the new value to set in changed validator property

excludeIds - the list of validator id to exclude

getValidatorEditors

protected static Map<JComponent,ValidatorField> getValidatorEditors(JAXXValidator ui)