[hibernate-commits] Hibernate SVN: r17499 - validator/trunk/hibernate-validator/src/main/docbook/en-US/modules.
hibernate-commits at lists.jboss.org
hibernate-commits at lists.jboss.org
Wed Sep 9 10:26:24 EDT 2009
Author: hardy.ferentschik
Date: 2009-09-09 10:26:23 -0400 (Wed, 09 Sep 2009)
New Revision: 17499
Modified:
validator/trunk/hibernate-validator/src/main/docbook/en-US/modules/bootstrapping.xml
validator/trunk/hibernate-validator/src/main/docbook/en-US/modules/customconstraints.xml
validator/trunk/hibernate-validator/src/main/docbook/en-US/modules/defineconstraints.xml
validator/trunk/hibernate-validator/src/main/docbook/en-US/modules/integration.xml
validator/trunk/hibernate-validator/src/main/docbook/en-US/modules/introduction.xml
validator/trunk/hibernate-validator/src/main/docbook/en-US/modules/usingvalidator.xml
validator/trunk/hibernate-validator/src/main/docbook/en-US/modules/xmlconfiguration.xml
Log:
HV-220
Modified: validator/trunk/hibernate-validator/src/main/docbook/en-US/modules/bootstrapping.xml
===================================================================
--- validator/trunk/hibernate-validator/src/main/docbook/en-US/modules/bootstrapping.xml 2009-09-09 14:24:30 UTC (rev 17498)
+++ validator/trunk/hibernate-validator/src/main/docbook/en-US/modules/bootstrapping.xml 2009-09-09 14:26:23 UTC (rev 17499)
@@ -1,4 +1,5 @@
<?xml version="1.0" encoding="UTF-8"?>
+<!-- $Id$ -->
<!--
~ Hibernate, Relational Persistence for Idiomatic Java
~
@@ -30,11 +31,39 @@
<para>We already discussed in <xref linkend="section-validator-instance" />
how to create a <classname>Validator</classname> instance using the
different methods in <classname>javax.validation.Validation</classname>. In
- this chapter we will discuss the underlying mechanisms and have a closer
- look at the different configuration possibilties available via the
- <classname>Configuration</classname> object.</para>
+ this chapter we have a closer look and discuss the different configuration
+ possibilties available via the <classname>Configuration</classname>
+ object.</para>
+ <para>One requirement of the Bean Validation framework is that each
+ implementation (including Hibernate Validator) must be able to bootstrap any
+ other Bean Validation implementation on the classpath. The available
+ providers are discovered by the <ulink
+ url="http://java.sun.com/j2se/1.3/docs/guide/jar/jar.html#Service%20Provider">Java
+ Service Provider</ulink> mechanism. A Bean Validation implementation
+ includes the file
+ <filename>javax.validation.spi.ValidationProvider</filename> in
+ <filename>META-INF/services</filename>. This file contains the fully
+ qualified classname of the <classname>ValidationProvider</classname> of the
+ implementation. In the case of Hibernate Validator this is
+ <classname>org.hibernate.validator.HibernateValidator</classname>.</para>
+
+ <para><note>
+ <para>If there are more than one Bean Validation implementation
+ providers in the classpath and
+ <methodname>Validation.buildDefaultValidatorFactory()</methodname> is
+ used, there is no guarantee which provider will be chosen. To enforce
+ the provider <methodname>Validation.byProvider()</methodname> should be
+ used. </para>
+ </note></para>
+
<section>
+ <title><classname>ValidationProviderResolver</classname></title>
+
+ <para>The </para>
+ </section>
+
+ <section>
<title><classname>MessageInterpolator</classname></title>
<para>The message interpolator is provided to the ValidatorFactory at
@@ -44,7 +73,7 @@
implementations delegate final interpolation to the Bean Validation
default MessageInterpolator to ensure standard Bean Validation
interpolation rules are followed. The default implementation is accessible
- through Configuration.getDefaultMessageInterpolator(). </para>
+ through Configuration.getDefaultMessageInterpolator().</para>
</section>
<section>
@@ -53,7 +82,7 @@
<para>The Bean Validation provider must not access the state of a
property, nor validate its constraints if the property is not traversable.
A property is traversable if TraversableResolver returns true for this
- property. </para>
+ property.</para>
</section>
<section>
@@ -68,6 +97,6 @@
(dependency injection, no no-arg constructor and so on) are not considered
portable, hence great care should be given before walking that path.
ConstraintValidatorFactory should not cache instances as the state of each
- instance can be altered in the ini- tialize method. </para>
+ instance can be altered in the ini- tialize method.</para>
</section>
</chapter>
Property changes on: validator/trunk/hibernate-validator/src/main/docbook/en-US/modules/bootstrapping.xml
___________________________________________________________________
Name: svn:keywords
+ Id
Modified: validator/trunk/hibernate-validator/src/main/docbook/en-US/modules/customconstraints.xml
===================================================================
--- validator/trunk/hibernate-validator/src/main/docbook/en-US/modules/customconstraints.xml 2009-09-09 14:24:30 UTC (rev 17498)
+++ validator/trunk/hibernate-validator/src/main/docbook/en-US/modules/customconstraints.xml 2009-09-09 14:26:23 UTC (rev 17499)
@@ -1,4 +1,5 @@
<?xml version="1.0" encoding="UTF-8"?>
+<!-- $Id$ -->
<!--
~ Hibernate, Relational Persistence for Idiomatic Java
~
Modified: validator/trunk/hibernate-validator/src/main/docbook/en-US/modules/defineconstraints.xml
===================================================================
--- validator/trunk/hibernate-validator/src/main/docbook/en-US/modules/defineconstraints.xml 2009-09-09 14:24:30 UTC (rev 17498)
+++ validator/trunk/hibernate-validator/src/main/docbook/en-US/modules/defineconstraints.xml 2009-09-09 14:26:23 UTC (rev 17499)
@@ -1,4 +1,5 @@
<?xml version="1.0" encoding="UTF-8"?>
+<!-- $Id$ -->
<!--
~ Hibernate, Relational Persistence for Idiomatic Java
~
Modified: validator/trunk/hibernate-validator/src/main/docbook/en-US/modules/integration.xml
===================================================================
--- validator/trunk/hibernate-validator/src/main/docbook/en-US/modules/integration.xml 2009-09-09 14:24:30 UTC (rev 17498)
+++ validator/trunk/hibernate-validator/src/main/docbook/en-US/modules/integration.xml 2009-09-09 14:26:23 UTC (rev 17499)
@@ -1,4 +1,5 @@
<?xml version="1.0" encoding="UTF-8"?>
+<!-- $Id$ -->
<!--
~ Hibernate, Relational Persistence for Idiomatic Java
~
Modified: validator/trunk/hibernate-validator/src/main/docbook/en-US/modules/introduction.xml
===================================================================
--- validator/trunk/hibernate-validator/src/main/docbook/en-US/modules/introduction.xml 2009-09-09 14:24:30 UTC (rev 17498)
+++ validator/trunk/hibernate-validator/src/main/docbook/en-US/modules/introduction.xml 2009-09-09 14:26:23 UTC (rev 17499)
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="UTF-8"?>
-
+<!-- $Id$ -->
<!--
~ Hibernate, Relational Persistence for Idiomatic Java
~
Modified: validator/trunk/hibernate-validator/src/main/docbook/en-US/modules/usingvalidator.xml
===================================================================
--- validator/trunk/hibernate-validator/src/main/docbook/en-US/modules/usingvalidator.xml 2009-09-09 14:24:30 UTC (rev 17498)
+++ validator/trunk/hibernate-validator/src/main/docbook/en-US/modules/usingvalidator.xml 2009-09-09 14:26:23 UTC (rev 17499)
@@ -1,4 +1,5 @@
<?xml version="1.0" encoding="UTF-8"?>
+<!-- $Id$ -->
<!--
~ Hibernate, Relational Persistence for Idiomatic Java
~
Modified: validator/trunk/hibernate-validator/src/main/docbook/en-US/modules/xmlconfiguration.xml
===================================================================
--- validator/trunk/hibernate-validator/src/main/docbook/en-US/modules/xmlconfiguration.xml 2009-09-09 14:24:30 UTC (rev 17498)
+++ validator/trunk/hibernate-validator/src/main/docbook/en-US/modules/xmlconfiguration.xml 2009-09-09 14:26:23 UTC (rev 17499)
@@ -1,4 +1,5 @@
<?xml version="1.0" encoding="UTF-8"?>
+<!-- $Id$ -->
<!--
~ Hibernate, Relational Persistence for Idiomatic Java
~
More information about the hibernate-commits
mailing list