[Myfaces Wiki] Update of "Extensions/Validator/Build" by GerhardPetracek

[Apache Wiki <wi...@apache.org>]

Dear Wiki user,

You have subscribed to a wiki page or wiki category on "Myfaces Wiki" for change notification.

The following page has been changed by GerhardPetracek:
http://wiki.apache.org/myfaces/Extensions/Validator/Build

New page:
= Build ExtVal =

It's quite easy to build/use ExtVal. There are no ExtVal specific steps. So it's straight forward.[[BR]]
You just have to add the required jar files to your project and use the annotations or implement your custom constraints.[[BR]]
(Or any other ExtVal feature.)

'''Yes - it's that easy :)'''

== Version Information ==
ExtVal 1.1.x ... for JSF 1.1.x[[BR]]
ExtVal 1.2.x ... for JSF 1.2.x[[BR]]
ExtVal 2.0.x ... for JSF 2.0.x

== Use ExtVal via Maven Dependency ==

You can see the setup at the existing [http://svn.apache.org/repos/asf/myfaces/extensions/validator/trunk/examples/ examples]

Minimal requirement:
{{{
<dependency>
    <groupId>org.apache.myfaces.extensions.validator</groupId>
    <artifactId>myfaces-extval-core</artifactId>
    <version>[the version you prefer]</version>
    <scope>compile</scope>
</dependency>
}}}
... use the core to create your own validation module with your own concepts. Or use it in combination with existing validation modules.

(Don't forget commons-logging.)

=== Property-Validation-Module ===
{{{
<dependency>
    <groupId>org.apache.myfaces.extensions.validator.validation-modules</groupId>
    <artifactId>myfaces-extval-property-validation</artifactId>
    <version>[use the same version]</version>
    <scope>compile</scope>
</dependency>
}}}

=== Bean-Validation-Module ===
'''Coming soon - depends on the final release of Hibernate Validator v4 - the RI of BV'''[[BR]]
An integration module for JSR 303 - before the third release of ExtVal it's available in the svn for early adaptors.
{{{
<dependency>
    <groupId>org.apache.myfaces.extensions.validator.validation-modules</groupId>
    <artifactId>myfaces-extval-bean-validation</artifactId>
    <version>[have a look at the current version number]</version>
    <scope>compile</scope>
</dependency>
}}}

=== Special Component Lib Support Modules ===

==== MyFaces Trinidad ====
If you are using MyFaces Trinidad, ExtVal provides additional Features.
{{{
<dependency>
    <groupId>org.apache.myfaces.extensions.validator.component-support-modules</groupId>
    <artifactId>myfaces-extval-trinidad-support</artifactId>
    <version>[use the same version]</version>
    <scope>compile</scope>
</dependency>
}}}

==== 3rd Party Component Libs ====
ExtVal provides a generic support module. Some component libs do some tricks behind the scenes - so this module is required for such special libs.[[BR]]
The Wiki as well as os890 provide additional information. Please ask at the mailing list, if there are any questions.

Some libs require:
{{{
<dependency>
    <groupId>org.apache.myfaces.extensions.validator.component-support-modules</groupId>
    <artifactId>myfaces-extval-generic-support</artifactId>
    <version>[use the same version]</version>
    <scope>compile</scope>
</dependency>
}}}

'''OR'''

== Use ExtVal without Maven Dependency ==
You can download the latest release at:
[http://myfaces.apache.org/extensions/validator/download.html http://myfaces.apache.org/extensions/validator/download.html]

Previous releases are available at:
[http://www.apache.org/dist/myfaces/binaries/ dist/binaries]
and
[http://www.apache.org/dist/myfaces/source/ dist/source]

Download your preferred package and add the jar files to your classpath.

'''OR'''

== Build ExtVal from Source Code ==
Checkout your preferred version from the [http://svn.apache.org/repos/asf/myfaces/extensions/validator/ svn] and build it via:
{{{
mvn clean install
}}}

So you can use also unreleased versions of ExtVal or manually build a patched version of a release (if needed).