Package org.iscreen

This package contains classes and interfaces that are considered "public" to applications that are using this framework.

See:
Description

Interface Summary

FailureMessage	A failure message is a holding interface for objects that represent failure messages.
ValidationFailure	A validation failure represents a single failure reported by a Validator (Validators can report multiple failures, each represented by a separate instance of this class).
ValidationService	This interface represents the main entry point for performing validations.
Validator	Implementations of this interface are expected to validate a JavaBean's properties.
ValidatorContext	During validation, a Validator is given a reference to the context in which it is validating.
ValidatorMetaData

Class Summary

BaseValidator	This abstract class acts as a base class for custom validators.
DocumentationIterator	For each validation service, a set of documentation may exist (on a per validator basis).
SimpleBean	This is a JavaBean that has a single "value" property that can be used to map a single value for validation.
ValidationFactory	This class represents factories that can generate validation services from configuration files (or however the factory generates them).
ValidationFactoryConfig	This JavaBean is purely for configuration.
ValidationFailureImpl	A validation failure represents a single failure reported by a Validator (Validators can report multiple failures, each represented by a separate instance of this class).
ValidationServiceWrapper	This wrapper around a ValidationService is itself a ValidationService implementation.
ValidationTrace	Instances of this class provide tracing through ValidationService to ValidationService to Validator, etc.

Exception Summary

ConfigurationException	This is an unchecked, runtime exception that is thrown when a programmer's error is detected (such as invalid configuration), etc.
ObjectValidationException	When a validation failure occurs, eventually an ObjectValidationException is thrown to the caller.
ValidationException	When a validation failure occurs, eventually a ValidationException is thrown to the caller.

Package org.iscreen Description

This package contains classes and interfaces that are considered "public" to applications that are using this framework. This means that applications using this framework only need to import this package.

The ValidationService interface defines the primary entry point into the iScreen validation framework. It's validate() and validateObject() methods executes all appropriate validators that are represented by the service. An instance of the service represents a "Validation Set" defined in a configuration file.

The ValidationException (ObjectValidationException) is thrown when a failure is found (or a warning). From it, individual ValidationFailure objects can be retrieved (or just the messages, themselves, as String objects). The ValidationFailure objects contain information about the service, Validator, and context in which a failure occurs.