[jboss-cvs] JBossAS SVN: r97007 - in projects/docs/enterprise/5.0/Hibernate/Hibernate_Validator: de-DE and 5 other directories.
jboss-cvs-commits at lists.jboss.org
jboss-cvs-commits at lists.jboss.org
Thu Nov 26 00:06:46 EST 2009
Author: xhuang at jboss.com
Date: 2009-11-26 00:06:44 -0500 (Thu, 26 Nov 2009)
New Revision: 97007
Added:
projects/docs/enterprise/5.0/Hibernate/Hibernate_Validator/de-DE/
projects/docs/enterprise/5.0/Hibernate/Hibernate_Validator/de-DE/Author_Group.po
projects/docs/enterprise/5.0/Hibernate/Hibernate_Validator/de-DE/Book_Info.po
projects/docs/enterprise/5.0/Hibernate/Hibernate_Validator/de-DE/Hibernate_Validator_Reference_Guide.po
projects/docs/enterprise/5.0/Hibernate/Hibernate_Validator/de-DE/Preface.po
projects/docs/enterprise/5.0/Hibernate/Hibernate_Validator/de-DE/Revision_History.po
projects/docs/enterprise/5.0/Hibernate/Hibernate_Validator/de-DE/checkconstraints.po
projects/docs/enterprise/5.0/Hibernate/Hibernate_Validator/de-DE/defineconstraints.po
projects/docs/enterprise/5.0/Hibernate/Hibernate_Validator/es-ES/
projects/docs/enterprise/5.0/Hibernate/Hibernate_Validator/es-ES/Author_Group.po
projects/docs/enterprise/5.0/Hibernate/Hibernate_Validator/es-ES/Book_Info.po
projects/docs/enterprise/5.0/Hibernate/Hibernate_Validator/es-ES/Hibernate_Validator_Reference_Guide.po
projects/docs/enterprise/5.0/Hibernate/Hibernate_Validator/es-ES/Preface.po
projects/docs/enterprise/5.0/Hibernate/Hibernate_Validator/es-ES/Revision_History.po
projects/docs/enterprise/5.0/Hibernate/Hibernate_Validator/es-ES/checkconstraints.po
projects/docs/enterprise/5.0/Hibernate/Hibernate_Validator/es-ES/defineconstraints.po
projects/docs/enterprise/5.0/Hibernate/Hibernate_Validator/fr-FR/
projects/docs/enterprise/5.0/Hibernate/Hibernate_Validator/fr-FR/Author_Group.po
projects/docs/enterprise/5.0/Hibernate/Hibernate_Validator/fr-FR/Book_Info.po
projects/docs/enterprise/5.0/Hibernate/Hibernate_Validator/fr-FR/Hibernate_Validator_Reference_Guide.po
projects/docs/enterprise/5.0/Hibernate/Hibernate_Validator/fr-FR/Preface.po
projects/docs/enterprise/5.0/Hibernate/Hibernate_Validator/fr-FR/Revision_History.po
projects/docs/enterprise/5.0/Hibernate/Hibernate_Validator/fr-FR/checkconstraints.po
projects/docs/enterprise/5.0/Hibernate/Hibernate_Validator/fr-FR/defineconstraints.po
projects/docs/enterprise/5.0/Hibernate/Hibernate_Validator/ja-JP/
projects/docs/enterprise/5.0/Hibernate/Hibernate_Validator/ja-JP/Author_Group.po
projects/docs/enterprise/5.0/Hibernate/Hibernate_Validator/ja-JP/Book_Info.po
projects/docs/enterprise/5.0/Hibernate/Hibernate_Validator/ja-JP/Hibernate_Validator_Reference_Guide.po
projects/docs/enterprise/5.0/Hibernate/Hibernate_Validator/ja-JP/Preface.po
projects/docs/enterprise/5.0/Hibernate/Hibernate_Validator/ja-JP/Revision_History.po
projects/docs/enterprise/5.0/Hibernate/Hibernate_Validator/ja-JP/checkconstraints.po
projects/docs/enterprise/5.0/Hibernate/Hibernate_Validator/ja-JP/defineconstraints.po
projects/docs/enterprise/5.0/Hibernate/Hibernate_Validator/pt-BR/
projects/docs/enterprise/5.0/Hibernate/Hibernate_Validator/pt-BR/Author_Group.po
projects/docs/enterprise/5.0/Hibernate/Hibernate_Validator/pt-BR/Book_Info.po
projects/docs/enterprise/5.0/Hibernate/Hibernate_Validator/pt-BR/Hibernate_Validator_Reference_Guide.po
projects/docs/enterprise/5.0/Hibernate/Hibernate_Validator/pt-BR/Preface.po
projects/docs/enterprise/5.0/Hibernate/Hibernate_Validator/pt-BR/Revision_History.po
projects/docs/enterprise/5.0/Hibernate/Hibernate_Validator/pt-BR/checkconstraints.po
projects/docs/enterprise/5.0/Hibernate/Hibernate_Validator/pt-BR/defineconstraints.po
projects/docs/enterprise/5.0/Hibernate/Hibernate_Validator/zh-CN/
projects/docs/enterprise/5.0/Hibernate/Hibernate_Validator/zh-CN/Author_Group.po
projects/docs/enterprise/5.0/Hibernate/Hibernate_Validator/zh-CN/Book_Info.po
projects/docs/enterprise/5.0/Hibernate/Hibernate_Validator/zh-CN/Hibernate_Validator_Reference_Guide.po
projects/docs/enterprise/5.0/Hibernate/Hibernate_Validator/zh-CN/Preface.po
projects/docs/enterprise/5.0/Hibernate/Hibernate_Validator/zh-CN/Revision_History.po
projects/docs/enterprise/5.0/Hibernate/Hibernate_Validator/zh-CN/checkconstraints.po
projects/docs/enterprise/5.0/Hibernate/Hibernate_Validator/zh-CN/defineconstraints.po
Log:
generate PO
Added: projects/docs/enterprise/5.0/Hibernate/Hibernate_Validator/de-DE/Author_Group.po
===================================================================
--- projects/docs/enterprise/5.0/Hibernate/Hibernate_Validator/de-DE/Author_Group.po (rev 0)
+++ projects/docs/enterprise/5.0/Hibernate/Hibernate_Validator/de-DE/Author_Group.po 2009-11-26 05:06:44 UTC (rev 97007)
@@ -0,0 +1,5 @@
+#. Tag: author
+#: Author_Group.xml:6
+#, no-c-format
+msgid "<firstname>Red Hat Documentation Group</firstname> <surname></surname>"
+msgstr ""
Added: projects/docs/enterprise/5.0/Hibernate/Hibernate_Validator/de-DE/Book_Info.po
===================================================================
--- projects/docs/enterprise/5.0/Hibernate/Hibernate_Validator/de-DE/Book_Info.po (rev 0)
+++ projects/docs/enterprise/5.0/Hibernate/Hibernate_Validator/de-DE/Book_Info.po 2009-11-26 05:06:44 UTC (rev 97007)
@@ -0,0 +1,25 @@
+#. Tag: title
+#: Book_Info.xml:6
+#, no-c-format
+msgid "Hibernate Validator Reference Guide"
+msgstr ""
+
+#. Tag: subtitle
+#: Book_Info.xml:7
+#, no-c-format
+msgid "for Use with JBoss Enterprise Application Platform 5.0"
+msgstr ""
+
+#. Tag: para
+#: Book_Info.xml:14
+#, no-c-format
+msgid ""
+"The JBoss Enterprise Application Platform Edition of the Hibernate Validator "
+"Reference Guide"
+msgstr ""
+
+#. Tag: holder
+#: Book_Info.xml:25
+#, no-c-format
+msgid "&HOLDER;"
+msgstr ""
Added: projects/docs/enterprise/5.0/Hibernate/Hibernate_Validator/de-DE/Hibernate_Validator_Reference_Guide.po
===================================================================
Added: projects/docs/enterprise/5.0/Hibernate/Hibernate_Validator/de-DE/Preface.po
===================================================================
--- projects/docs/enterprise/5.0/Hibernate/Hibernate_Validator/de-DE/Preface.po (rev 0)
+++ projects/docs/enterprise/5.0/Hibernate/Hibernate_Validator/de-DE/Preface.po 2009-11-26 05:06:44 UTC (rev 97007)
@@ -0,0 +1,56 @@
+#. Tag: title
+#: Preface.xml:7
+#, no-c-format
+msgid "Preface"
+msgstr ""
+
+#. Tag: para
+#: Preface.xml:9
+#, no-c-format
+msgid ""
+"Annotations are a very convenient and elegant way to specify invariant "
+"constraints for a domain model. You can, for example, express that a "
+"property should never be null, that the account balance should be strictly "
+"positive, etc. These domain model constraints are declared in the bean "
+"itself by annotating its properties. A validator can then read them and "
+"check for constraint violations. The validation mechanism can be executed in "
+"different layers in your application without having to duplicate any of "
+"these rules (presentation layer, data access layer). Following the DRY "
+"principle, Hibernate Validator has been designed for that purpose."
+msgstr ""
+
+#. Tag: para
+#: Preface.xml:20
+#, no-c-format
+msgid ""
+"Hibernate Validator works at two levels. First, it is able to check in-"
+"memory instances of a class for constraint violations. Second, it can apply "
+"the constraints to the Hibernate metamodel and incorporate them into the "
+"generated database schema."
+msgstr ""
+
+#. Tag: para
+#: Preface.xml:25
+#, no-c-format
+msgid ""
+"Each constraint annotation is associated to a validator implementation "
+"responsible for checking the constraint on the entity instance. A validator "
+"can also (optionally) apply the constraint to the Hibernate metamodel, "
+"allowing Hibernate to generate DDL that expresses the constraint. With the "
+"appropriate event listener, you can execute the checking operation on "
+"inserts and updates done by Hibernate. Hibernate Validator is not limited to "
+"use with Hibernate. You can easily use it anywhere in your application as "
+"well as with any Java Persistence provider (entity listener provided)."
+msgstr ""
+
+#. Tag: para
+#: Preface.xml:35
+#, no-c-format
+msgid ""
+"When checking instances at runtime, Hibernate Validator returns information "
+"about constraint violations in an array of <classname>InvalidValue</"
+"classname> s. Among other information, the <classname>InvalidValue</"
+"classname> contains an error description message that can embed the "
+"parameter values bundle with the annotation (eg. length limit), and message "
+"strings that may be externalized to a <classname>ResourceBundle</classname> ."
+msgstr ""
Added: projects/docs/enterprise/5.0/Hibernate/Hibernate_Validator/de-DE/Revision_History.po
===================================================================
--- projects/docs/enterprise/5.0/Hibernate/Hibernate_Validator/de-DE/Revision_History.po (rev 0)
+++ projects/docs/enterprise/5.0/Hibernate/Hibernate_Validator/de-DE/Revision_History.po 2009-11-26 05:06:44 UTC (rev 97007)
@@ -0,0 +1,11 @@
+#. Tag: title
+#: Revision_History.xml:6
+#, no-c-format
+msgid "Revision History"
+msgstr ""
+
+#. Tag: author
+#: Revision_History.xml:12
+#, no-c-format
+msgid "<firstname></firstname> <surname></surname> <email></email>"
+msgstr ""
Added: projects/docs/enterprise/5.0/Hibernate/Hibernate_Validator/de-DE/checkconstraints.po
===================================================================
--- projects/docs/enterprise/5.0/Hibernate/Hibernate_Validator/de-DE/checkconstraints.po (rev 0)
+++ projects/docs/enterprise/5.0/Hibernate/Hibernate_Validator/de-DE/checkconstraints.po 2009-11-26 05:06:44 UTC (rev 97007)
@@ -0,0 +1,370 @@
+#. Tag: title
+#: checkconstraints.xml:3
+#, no-c-format
+msgid "Using the Validator framework"
+msgstr ""
+
+#. Tag: para
+#: checkconstraints.xml:5
+#, no-c-format
+msgid ""
+"Hibernate Validator is intended to be used to implement multi-layered data "
+"validation, where constraints are expressed in a single place (the annotated "
+"domain model) and checked in various different layers of the application."
+msgstr ""
+
+#. Tag: para
+#: checkconstraints.xml:10
+#, no-c-format
+msgid "This chapter will cover Hibernate Validator usage for different layers"
+msgstr ""
+
+#. Tag: title
+#: checkconstraints.xml:14
+#, no-c-format
+msgid "Database schema-level validation"
+msgstr ""
+
+#. Tag: para
+#: checkconstraints.xml:16
+#, no-c-format
+msgid ""
+"Out of the box, Hibernate Annotations will translate the constraints you "
+"have defined for your entities into mapping metadata. For example, if a "
+"property of your entity is annotated <literal>@NotNull</literal>, its "
+"columns will be declared as <literal>not null</literal> in the DDL schema "
+"generated by Hibernate."
+msgstr ""
+
+#. Tag: para
+#: checkconstraints.xml:22
+#, no-c-format
+msgid ""
+"Using hbm2ddl, domain model constraints will be expressed into the database "
+"schema."
+msgstr ""
+
+#. Tag: para
+#: checkconstraints.xml:25
+#, no-c-format
+msgid ""
+"If, for some reason, the feature needs to be disabled, set "
+"<literal>hibernate.validator.apply_to_ddl</literal> to <literal>false</"
+"literal>."
+msgstr ""
+
+#. Tag: title
+#: checkconstraints.xml:31
+#, no-c-format
+msgid "ORM integration"
+msgstr ""
+
+#. Tag: para
+#: checkconstraints.xml:33
+#, no-c-format
+msgid ""
+"Hibernate Validator integrates with both Hibernate and all pure Java "
+"Persistence providers"
+msgstr ""
+
+#. Tag: title
+#: checkconstraints.xml:37
+#, no-c-format
+msgid "Hibernate event-based validation"
+msgstr ""
+
+#. Tag: para
+#: checkconstraints.xml:39
+#, no-c-format
+msgid ""
+"Hibernate Validator has two built-in Hibernate event listeners. Whenever a "
+"<literal>PreInsertEvent</literal> or <literal>PreUpdateEvent</literal> "
+"occurs, the listeners will verify all constraints of the entity instance and "
+"throw an exception if any constraint is violated. Basically, objects will be "
+"checked before any inserts and before any updates made by Hibernate. This "
+"includes changes applied by cascade! This is the most convenient and the "
+"easiest way to activate the validation process. On constraint violation, the "
+"event will raise a runtime <classname>InvalidStateException</classname> "
+"which contains an array of <literal>InvalidValue</literal>s describing each "
+"failure."
+msgstr ""
+
+#. Tag: para
+#: checkconstraints.xml:51
+#, no-c-format
+msgid ""
+"If Hibernate Validator is present in the classpath, Hibernate Annotations "
+"(or Hibernate EntityManager) will use it transparently. If, for some reason, "
+"you want to disable this integration, set <literal>hibernate.validator."
+"autoregister_listeners</literal> to false"
+msgstr ""
+
+#. Tag: para
+#: checkconstraints.xml:58
+#, no-c-format
+msgid ""
+"If the beans are not annotated with validation annotations, there is no "
+"runtime performance cost."
+msgstr ""
+
+#. Tag: para
+#: checkconstraints.xml:62
+#, no-c-format
+msgid ""
+"In case you need to manually set the event listeners for Hibernate Core, use "
+"the following configuration in <literal>hibernate.cfg.xml</literal>:"
+msgstr ""
+
+#. Tag: programlisting
+#: checkconstraints.xml:66
+#, no-c-format
+msgid ""
+"<hibernate-configuration>\n"
+" ...\n"
+" <event type=\"pre-update\">\n"
+" <listener \n"
+" class=\"org.hibernate.validator.event.ValidateEventListener\"/"
+">\n"
+" </event>\n"
+" <event type=\"pre-insert\">\n"
+" <listener \n"
+" class=\"org.hibernate.validator.event.ValidateEventListener\"/"
+">\n"
+" </event>\n"
+"</hibernate-configuration>"
+msgstr ""
+
+#. Tag: title
+#: checkconstraints.xml:70
+#, no-c-format
+msgid "Java Persistence event-based validation"
+msgstr ""
+
+#. Tag: para
+#: checkconstraints.xml:72
+#, no-c-format
+msgid ""
+"Hibernate Validator is not tied to Hibernate for event based validation: a "
+"Java Persistence entity listener is available. Whenever an listened entity "
+"is persisted or updated, Hibernate Validator will verify all constraints of "
+"the entity instance and throw an exception if any constraint is violated. "
+"Basically, objects will be checked before any inserts and before any updates "
+"made by the Java Persistence provider. This includes changes applied by "
+"cascade! On constraint violation, the event will raise a runtime "
+"<classname>InvalidStateException</classname> which contains an array of "
+"<literal>InvalidValue</literal>s describing each failure."
+msgstr ""
+
+#. Tag: para
+#: checkconstraints.xml:83
+#, no-c-format
+msgid "Here is how to make a class validatable:"
+msgstr ""
+
+#. Tag: programlisting
+#: checkconstraints.xml:85
+#, no-c-format
+msgid ""
+"@Entity\n"
+"@EntityListeners( JPAValidateListener.class )\n"
+"public class Submarine {\n"
+" ...\n"
+"}"
+msgstr ""
+
+#. Tag: para
+#: checkconstraints.xml:88
+#, no-c-format
+msgid ""
+"Compared to the Hibernate event, the Java Persistence listener has two "
+"drawbacks. You need to define the entity listener on every validatable "
+"entity. The DDL generated by your provider will not reflect the constraints."
+msgstr ""
+
+#. Tag: title
+#: checkconstraints.xml:97
+#, no-c-format
+msgid "Application-level validation"
+msgstr ""
+
+#. Tag: para
+#: checkconstraints.xml:99
+#, no-c-format
+msgid "Hibernate Validator can be applied anywhere in your application code."
+msgstr ""
+
+#. Tag: programlisting
+#: checkconstraints.xml:102
+#, no-c-format
+msgid ""
+"ClassValidator personValidator = new ClassValidator( Person.class );\n"
+"ClassValidator addressValidator = new ClassValidator( Address.class, "
+"ResourceBundle.getBundle(\"messages\", Locale.ENGLISH) );\n"
+"\n"
+"InvalidValue[] validationMessages = addressValidator.getInvalidValues"
+"(address);"
+msgstr ""
+
+#. Tag: para
+#: checkconstraints.xml:104
+#, no-c-format
+msgid ""
+"The first two lines prepare the Hibernate Validator for class checking. The "
+"first one relies upon the error messages embedded in Hibernate Validator "
+"(see <xref linkend=\"validator-defineconstraints-error\"/>), the second one "
+"uses a resource bundle for these messages. It is considered a good practice "
+"to execute these lines once and cache the validator instances."
+msgstr ""
+
+#. Tag: para
+#: checkconstraints.xml:111
+#, no-c-format
+msgid ""
+"The third line actually validates the <literal>Address</literal> instance "
+"and returns an array of <literal>InvalidValue</literal>s. Your application "
+"logic will then be able to react to the failure."
+msgstr ""
+
+#. Tag: para
+#: checkconstraints.xml:115
+#, no-c-format
+msgid ""
+"You can also check a particular property instead of the whole bean. This "
+"might be useful for property per property user interaction"
+msgstr ""
+
+#. Tag: programlisting
+#: checkconstraints.xml:118
+#, no-c-format
+msgid ""
+"ClassValidator addressValidator = new ClassValidator( Address.class, "
+"ResourceBundle.getBundle(\"messages\", Locale.ENGLISH) );\n"
+"\n"
+"//only get city property invalid values\n"
+"InvalidValue[] validationMessages = addressValidator.getInvalidValues"
+"(address, \"city\");\n"
+"\n"
+"//only get potential city property invalid values\n"
+"InvalidValue[] validationMessages = addressValidator."
+"getPotentialInvalidValues(\"city\", \"Paris\")"
+msgstr ""
+
+#. Tag: title
+#: checkconstraints.xml:122
+#, no-c-format
+msgid "Presentation layer validation"
+msgstr ""
+
+#. Tag: para
+#: checkconstraints.xml:124
+#, no-c-format
+msgid ""
+"When working with JSF and <productname>JBoss Seam</productname>, one can "
+"triggers the validation process at the presentation layer using Seam's JSF "
+"tags <literal><s:validate></literal> and <literal><s:validateAll/"
+"></literal>, letting the constraints be expressed on the model, and the "
+"violations presented in the view"
+msgstr ""
+
+#. Tag: programlisting
+#: checkconstraints.xml:130
+#, no-c-format
+msgid ""
+"<h:form>\n"
+" <div>\n"
+" <h:messages/>\n"
+" </div>\n"
+" <emphasis role=\"bold\"><s:validateAll></emphasis>\n"
+" <div>\n"
+" Country:\n"
+" <h:inputText value=\"#{location.country}\" required=\"true\"/"
+">\n"
+" </div>\n"
+" <div>\n"
+" Zip code:\n"
+" <h:inputText value=\"#{location.zip}\" required=\"true\"/"
+">\n"
+" </div>\n"
+" <div>\n"
+" <h:commandButton/>\n"
+" </div>\n"
+" <emphasis role=\"bold\"></s:validateAll></emphasis>\n"
+"</h:form>"
+msgstr ""
+
+#. Tag: para
+#: checkconstraints.xml:132
+#, no-c-format
+msgid ""
+"Going even further, and adding <productname>Ajax4JSF</productname> to the "
+"loop will bring client side validation with just a couple of additional JSF "
+"tags, again without validation definition duplication."
+msgstr ""
+
+#. Tag: para
+#: checkconstraints.xml:137
+#, no-c-format
+msgid ""
+"Check the <ulink url=\"http://www.jboss.com/products/seam\">JBoss Seam</"
+"ulink> documentation for more information."
+msgstr ""
+
+#. Tag: title
+#: checkconstraints.xml:142
+#, no-c-format
+msgid "Validation informations"
+msgstr ""
+
+#. Tag: para
+#: checkconstraints.xml:144
+#, no-c-format
+msgid ""
+"As a validation information carrier, hibernate provide an array of "
+"<classname>InvalidValue</classname>. Each <literal>InvalidValue</literal> "
+"has a buch of methods describing the individual issues."
+msgstr ""
+
+#. Tag: para
+#: checkconstraints.xml:148
+#, no-c-format
+msgid "<methodname>getBeanClass()</methodname> retrieves the failing bean type"
+msgstr ""
+
+#. Tag: para
+#: checkconstraints.xml:151
+#, no-c-format
+msgid ""
+"<methodname>getBean()</methodname>retrieves the failing instance (if any ie "
+"not when using <methodname>getPotentianInvalidValues()</methodname>)"
+msgstr ""
+
+#. Tag: para
+#: checkconstraints.xml:155
+#, no-c-format
+msgid "<methodname>getValue()</methodname> retrieves the failing value"
+msgstr ""
+
+#. Tag: para
+#: checkconstraints.xml:158
+#, no-c-format
+msgid ""
+"<methodname>getMessage()</methodname> retrieves the proper internationalized "
+"error message"
+msgstr ""
+
+#. Tag: para
+#: checkconstraints.xml:161
+#, no-c-format
+msgid ""
+"<methodname>getRootBean()</methodname> retrieves the root bean instance "
+"generating the issue (useful in conjunction with <literal>@Valid</literal>), "
+"is null if getPotentianInvalidValues() is used."
+msgstr ""
+
+#. Tag: para
+#: checkconstraints.xml:166
+#, no-c-format
+msgid ""
+"<literal>getPropertyPath()</literal> retrieves the dotted path of the "
+"failing property starting from the root bean"
+msgstr ""
Added: projects/docs/enterprise/5.0/Hibernate/Hibernate_Validator/de-DE/defineconstraints.po
===================================================================
--- projects/docs/enterprise/5.0/Hibernate/Hibernate_Validator/de-DE/defineconstraints.po (rev 0)
+++ projects/docs/enterprise/5.0/Hibernate/Hibernate_Validator/de-DE/defineconstraints.po 2009-11-26 05:06:44 UTC (rev 97007)
@@ -0,0 +1,718 @@
+#. Tag: title
+#: defineconstraints.xml:3
+#, no-c-format
+msgid "Defining constraints"
+msgstr ""
+
+#. Tag: title
+#: defineconstraints.xml:6
+#, no-c-format
+msgid "What is a constraint?"
+msgstr ""
+
+#. Tag: para
+#: defineconstraints.xml:8
+#, no-c-format
+msgid ""
+"A constraint is a rule that a given element (field, property or bean) has to "
+"comply to. The rule semantic is expressed by an annotation. A constraint "
+"usually has some attributes used to parameterize the constraints limits. The "
+"constraint applies to the annotated element."
+msgstr ""
+
+#. Tag: title
+#: defineconstraints.xml:16
+#, no-c-format
+msgid "Built in constraints"
+msgstr ""
+
+#. Tag: para
+#: defineconstraints.xml:18
+#, no-c-format
+msgid ""
+"Hibernate Validator comes with some built-in constraints, which covers most "
+"basic data checks. As we'll see later, you're not limited to them, you can "
+"literally in a minute write your own constraints."
+msgstr ""
+
+#. Tag: title
+#: defineconstraints.xml:23
+#, no-c-format
+msgid "Built-in constraints"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:30
+#, no-c-format
+msgid "Annotation"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:32
+#, no-c-format
+msgid "Apply on"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:34
+#, no-c-format
+msgid "Runtime checking"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:36
+#, no-c-format
+msgid "Hibernate Metadata impact"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:42
+#, no-c-format
+msgid "@Length(min=, max=)"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:44 defineconstraints.xml:188
+#: defineconstraints.xml:199
+#, no-c-format
+msgid "property (String)"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:46
+#, no-c-format
+msgid "check if the string length match the range"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:48
+#, no-c-format
+msgid "Column length will be set to max"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:52
+#, no-c-format
+msgid "@Max(value=)"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:54 defineconstraints.xml:65 defineconstraints.xml:130
+#: defineconstraints.xml:210
+#, no-c-format
+msgid "property (numeric or string representation of a numeric)"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:57
+#, no-c-format
+msgid "check if the value is less than or equals to max"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:59 defineconstraints.xml:70 defineconstraints.xml:101
+#: defineconstraints.xml:136
+#, no-c-format
+msgid "Add a check constraint on the column"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:63
+#, no-c-format
+msgid "@Min(value=)"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:68
+#, no-c-format
+msgid "check if the value is more than or equals to min"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:74
+#, no-c-format
+msgid "@NotNull"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:76 defineconstraints.xml:86 defineconstraints.xml:153
+#: defineconstraints.xml:164
+#, no-c-format
+msgid "property"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:78
+#, no-c-format
+msgid "check if the value is not null"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:80
+#, no-c-format
+msgid "Column(s) are not null"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:84
+#, no-c-format
+msgid "@NotEmpty"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:88
+#, no-c-format
+msgid ""
+"check if the string is not null nor empty. Check if the connection is not "
+"null nor empty"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:91
+#, no-c-format
+msgid "Column(s) are not null (for String)"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:95
+#, no-c-format
+msgid "@Past"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:97 defineconstraints.xml:107
+#, no-c-format
+msgid "property (date or calendar)"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:99
+#, no-c-format
+msgid "check if the date is in the past"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:105
+#, no-c-format
+msgid "@Future"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:109
+#, no-c-format
+msgid "check if the date is in the future"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:111 defineconstraints.xml:124
+#: defineconstraints.xml:147 defineconstraints.xml:158
+#: defineconstraints.xml:169 defineconstraints.xml:182
+#: defineconstraints.xml:193 defineconstraints.xml:204
+#: defineconstraints.xml:228
+#, no-c-format
+msgid "none"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:115
+#, no-c-format
+msgid "@Pattern(regex=\"regexp\", flag=) or @Patterns( {@Pattern(...)} )"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:118 defineconstraints.xml:223
+#, no-c-format
+msgid "property (string)"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:120
+#, no-c-format
+msgid ""
+"check if the property match the regular expression given a match flag (see "
+"<classname>java.util.regex.Pattern </classname> )"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:128
+#, no-c-format
+msgid "@Range(min=, max=)"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:133
+#, no-c-format
+msgid "check if the value is between min and max (included)"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:140
+#, no-c-format
+msgid "@Size(min=, max=)"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:142
+#, no-c-format
+msgid "property (array, collection, map)"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:144
+#, no-c-format
+msgid "check if the element size is between min and max (included)"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:151
+#, no-c-format
+msgid "@AssertFalse"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:155
+#, no-c-format
+msgid ""
+"check that the method evaluates to false (useful for constraints expressed "
+"in code rather than annotations)"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:162
+#, no-c-format
+msgid "@AssertTrue"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:166
+#, no-c-format
+msgid ""
+"check that the method evaluates to true (useful for constraints expressed in "
+"code rather than annotations)"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:173
+#, no-c-format
+msgid "@Valid"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:175
+#, no-c-format
+msgid "property (object)"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:177
+#, no-c-format
+msgid ""
+"perform validation recursively on the associated object. If the object is a "
+"Collection or an array, the elements are validated recursively. If the "
+"object is a Map, the value elements are validated recursively."
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:186
+#, no-c-format
+msgid "@Email"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:190
+#, no-c-format
+msgid "check whether the string is conform to the email address specification"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:197
+#, no-c-format
+msgid "@CreditCardNumber"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:201
+#, no-c-format
+msgid ""
+"check whether the string is a well formated credit card number (derivative "
+"of the Luhn algorithm)"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:208
+#, no-c-format
+msgid "@Digits"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:213
+#, no-c-format
+msgid ""
+"check whether the property is a number having up to <literal>integerDigits</"
+"literal> integer digits and <literal>fractionalDigits</literal> fractonal "
+"digits"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:217
+#, no-c-format
+msgid "define column precision and scale"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:221
+#, no-c-format
+msgid "@EAN"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:225
+#, no-c-format
+msgid "check whether the string is a properly formated EAN or UPC-A code"
+msgstr ""
+
+#. Tag: title
+#: defineconstraints.xml:236
+#, no-c-format
+msgid "Error messages"
+msgstr ""
+
+#. Tag: para
+#: defineconstraints.xml:238
+#, no-c-format
+msgid ""
+"Hibernate Validator comes with a default set of error messages translated in "
+"about ten languages (if yours is not part of it, please sent us a patch). "
+"You can override those messages by creating a <filename>ValidatorMessages."
+"properties</filename> or ( <filename>ValidatorMessages_loc.properties</"
+"filename> ) and override the needed keys. You can even add your own "
+"additional set of messages while writing your validator annotations. If "
+"Hibernate Validator cannot resolve a key from your resourceBundle nor from "
+"ValidatorMessage, it falls back to the default built-in values."
+msgstr ""
+
+#. Tag: para
+#: defineconstraints.xml:248
+#, no-c-format
+msgid ""
+"Alternatively you can provide a <classname>ResourceBundle</classname> while "
+"checking programmatically the validation rules on a bean or if you want a "
+"completly different interpolation mechanism, you can provide an "
+"implementation of <literal>org.hibernate.validator.MessageInterpolator</"
+"literal> (check the JavaDoc for more informations)."
+msgstr ""
+
+#. Tag: title
+#: defineconstraints.xml:257
+#, no-c-format
+msgid "Writing your own constraints"
+msgstr ""
+
+#. Tag: para
+#: defineconstraints.xml:259
+#, no-c-format
+msgid ""
+"Extending the set of built-in constraints is extremely easy. Any constraint "
+"consists of two pieces: the constraint <emphasis>descriptor</emphasis> (the "
+"annotation) and the constraint <emphasis>validator</emphasis> (the "
+"implementation class). Here is a simple user-defined descriptor:"
+msgstr ""
+
+#. Tag: programlisting
+#: defineconstraints.xml:265
+#, no-c-format
+msgid ""
+"@ValidatorClass(CapitalizedValidator.class)\n"
+"@Target(METHOD)\n"
+"@Retention(RUNTIME)\n"
+"@Documented\n"
+"public @interface Capitalized {\n"
+" CapitalizeType type() default Capitalize.FIRST;\n"
+" String message() default \"has incorrect capitalization\"\n"
+"}"
+msgstr ""
+
+#. Tag: para
+#: defineconstraints.xml:267
+#, no-c-format
+msgid ""
+"<literal>type</literal> is a parameter describing how the property should to "
+"be capitalized. This is a user parameter fully dependant on the annotation "
+"business."
+msgstr ""
+
+#. Tag: para
+#: defineconstraints.xml:271
+#, no-c-format
+msgid ""
+"<literal>message</literal> is the default string used to describe the "
+"constraint violation and is mandatory. You can hard code the string or you "
+"can externalize part/all of it through the Java ResourceBundle mechanism. "
+"Parameters values are going to be injected inside the message when the "
+"<literal>{parameter}</literal> string is found (in our example "
+"<literal>Capitalization is not {type}</literal> would generate "
+"<literal>Capitalization is not FIRST</literal> ), externalizing the whole "
+"string in <filename>ValidatorMessages.properties</filename> is considered "
+"good practice. See <xref linkend=\"validator-defineconstraints-error\"/> ."
+msgstr ""
+
+#. Tag: programlisting
+#: defineconstraints.xml:282
+#, no-c-format
+msgid ""
+"@ValidatorClass(CapitalizedValidator.class)\n"
+"@Target(METHOD)\n"
+"@Retention(RUNTIME)\n"
+"@Documented\n"
+"public @interface Capitalized {\n"
+" CapitalizeType type() default Capitalize.FIRST;\n"
+" String message() default \"{validator.capitalized}\";\n"
+"}\n"
+"\n"
+"\n"
+"#in ValidatorMessages.properties\n"
+"validator.capitalized = <literal>Capitalization is not {type}</literal>"
+msgstr ""
+
+#. Tag: para
+#: defineconstraints.xml:284
+#, no-c-format
+msgid "As you can see the {} notation is recursive."
+msgstr ""
+
+#. Tag: para
+#: defineconstraints.xml:286
+#, no-c-format
+msgid ""
+"To link a descriptor to its validator implementation, we use the "
+"<literal>@ValidatorClass</literal> meta-annotation. The validator class "
+"parameter must name a class which implements <literal>Validator<"
+"ConstraintAnnotation></literal> ."
+msgstr ""
+
+#. Tag: para
+#: defineconstraints.xml:291
+#, no-c-format
+msgid ""
+"We now have to implement the validator (ie. the rule checking "
+"implementation). A validation implementation can check the value of the a "
+"property (by implementing <literal>PropertyConstraint</literal> ) and/or can "
+"modify the hibernate mapping metadata to express the constraint at the "
+"database level (by implementing <literal>PersistentClassConstraint</"
+"literal> )"
+msgstr ""
+
+#. Tag: programlisting
+#: defineconstraints.xml:298
+#, no-c-format
+msgid ""
+"public class CapitalizedValidator\n"
+" implements Validator<Capitalized>, PropertyConstraint {\n"
+" private CapitalizeType type;\n"
+"\n"
+" //part of the Validator<Annotation> contract,\n"
+" //allows to get and use the annotation values\n"
+" public void initialize(Capitalized parameters) {\n"
+" type = parameters.type();\n"
+" }\n"
+"\n"
+" //part of the property constraint contract\n"
+" public boolean isValid(Object value) {\n"
+" if (value==null) return true;\n"
+" if ( !(value instanceof String) ) return false;\n"
+" String string = (String) value;\n"
+" if (type == CapitalizeType.ALL) {\n"
+" return string.equals( string.toUpperCase() );\n"
+" }\n"
+" else {\n"
+" String first = string.substring(0,1);\n"
+" return first.equals( first.toUpperCase();\n"
+" }\n"
+" }\n"
+"}"
+msgstr ""
+
+#. Tag: para
+#: defineconstraints.xml:300
+#, no-c-format
+msgid ""
+"The <literal>isValid()</literal> method should return false if the "
+"constraint has been violated. For more examples, refer to the built-in "
+"validator implementations."
+msgstr ""
+
+#. Tag: para
+#: defineconstraints.xml:304
+#, no-c-format
+msgid ""
+"We only have seen property level validation, but you can write a Bean level "
+"validation annotation. Instead of receiving the return instance of a "
+"property, the bean itself will be passed to the validator. To activate the "
+"validation checking, just annotated the bean itself instead. A small sample "
+"can be found in the unit test suite."
+msgstr ""
+
+#. Tag: para
+#: defineconstraints.xml:310
+#, no-c-format
+msgid ""
+"If your constraint can be applied multiple times (with different parameters) "
+"on the same property or type, you can use the following annotation form:"
+msgstr ""
+
+#. Tag: programlisting
+#: defineconstraints.xml:314
+#, no-c-format
+msgid ""
+"@Target(METHOD)\n"
+"@Retention(RUNTIME)\n"
+"@Documented\n"
+"<emphasis role=\"bold\">public @interface Patterns {</emphasis>\n"
+" Pattern[] value();\n"
+"}\n"
+"\n"
+"@Target(METHOD)\n"
+"@Retention(RUNTIME)\n"
+"@Documented\n"
+"@ValidatorClass(PatternValidator.class)\n"
+"public @interface Pattern {\n"
+" String regexp();\n"
+"}"
+msgstr ""
+
+#. Tag: para
+#: defineconstraints.xml:316
+#, no-c-format
+msgid ""
+"Basically an annotation containing the value attribute as an array of "
+"validator annotations."
+msgstr ""
+
+#. Tag: title
+#: defineconstraints.xml:321
+#, no-c-format
+msgid "Annotating your domain model"
+msgstr ""
+
+#. Tag: para
+#: defineconstraints.xml:323
+#, no-c-format
+msgid ""
+"Since you are already familiar with annotations now, the syntax should be "
+"very familiar"
+msgstr ""
+
+#. Tag: programlisting
+#: defineconstraints.xml:326
+#, no-c-format
+msgid ""
+"public class Address {\n"
+" private String line1;\n"
+" private String line2;\n"
+" private String zip;\n"
+" private String state;\n"
+" private String country;\n"
+" private long id;\n"
+"\n"
+" // a not null string of 20 characters maximum\n"
+" @Length(max=20)\n"
+" @NotNull\n"
+" public String getCountry() {\n"
+" return country;\n"
+" }\n"
+"\n"
+" // a non null string\n"
+" @NotNull\n"
+" public String getLine1() {\n"
+" return line1;\n"
+" }\n"
+"\n"
+" //no constraint\n"
+" public String getLine2() {\n"
+" return line2;\n"
+" }\n"
+"\n"
+" // a not null string of 3 characters maximum\n"
+" @Length(max=3) @NotNull\n"
+" public String getState() {\n"
+" return state;\n"
+" }\n"
+"\n"
+" // a not null numeric string of 5 characters maximum\n"
+" // if the string is longer, the message will\n"
+" //be searched in the resource bundle at key 'long'\n"
+" @Length(max=5, message=\"{long}\")\n"
+" @Pattern(regex=\"[0-9]+\")\n"
+" @NotNull\n"
+" public String getZip() {\n"
+" return zip;\n"
+" }\n"
+"\n"
+" // should always be true\n"
+" @AssertTrue\n"
+" public boolean isValid() {\n"
+" return true;\n"
+" }\n"
+"\n"
+" // a numeric between 1 and 2000\n"
+" @Id @Min(1)\n"
+" @Range(max=2000)\n"
+" public long getId() {\n"
+" return id;\n"
+" }\n"
+"}"
+msgstr ""
+
+#. Tag: para
+#: defineconstraints.xml:328
+#, no-c-format
+msgid ""
+"While the example only shows public property validation, you can also "
+"annotate fields of any kind of visibility"
+msgstr ""
+
+#. Tag: programlisting
+#: defineconstraints.xml:331
+#, no-c-format
+msgid ""
+"@MyBeanConstraint(max=45\n"
+"public class Dog {\n"
+" @AssertTrue private boolean isMale;\n"
+" @NotNull protected String getName() { ... };\n"
+" ...\n"
+"}"
+msgstr ""
+
+#. Tag: para
+#: defineconstraints.xml:333
+#, no-c-format
+msgid ""
+"You can also annotate interfaces. Hibernate Validator will check all "
+"superclasses and interfaces extended or implemented by a given bean to read "
+"the appropriate validator annotations."
+msgstr ""
+
+#. Tag: programlisting
+#: defineconstraints.xml:337
+#, no-c-format
+msgid ""
+"public interface Named {\n"
+" @NotNull String getName();\n"
+" ...\n"
+"}\n"
+"\n"
+"public class Dog implements Named {\n"
+"\n"
+" @AssertTrue private boolean isMale;\n"
+"\n"
+" public String getName() { ... };\n"
+"\n"
+"}"
+msgstr ""
+
+#. Tag: para
+#: defineconstraints.xml:339
+#, no-c-format
+msgid ""
+"The name property will be checked for nullity when the Dog bean is validated."
+msgstr ""
Added: projects/docs/enterprise/5.0/Hibernate/Hibernate_Validator/es-ES/Author_Group.po
===================================================================
--- projects/docs/enterprise/5.0/Hibernate/Hibernate_Validator/es-ES/Author_Group.po (rev 0)
+++ projects/docs/enterprise/5.0/Hibernate/Hibernate_Validator/es-ES/Author_Group.po 2009-11-26 05:06:44 UTC (rev 97007)
@@ -0,0 +1,5 @@
+#. Tag: author
+#: Author_Group.xml:6
+#, no-c-format
+msgid "<firstname>Red Hat Documentation Group</firstname> <surname></surname>"
+msgstr ""
Added: projects/docs/enterprise/5.0/Hibernate/Hibernate_Validator/es-ES/Book_Info.po
===================================================================
--- projects/docs/enterprise/5.0/Hibernate/Hibernate_Validator/es-ES/Book_Info.po (rev 0)
+++ projects/docs/enterprise/5.0/Hibernate/Hibernate_Validator/es-ES/Book_Info.po 2009-11-26 05:06:44 UTC (rev 97007)
@@ -0,0 +1,25 @@
+#. Tag: title
+#: Book_Info.xml:6
+#, no-c-format
+msgid "Hibernate Validator Reference Guide"
+msgstr ""
+
+#. Tag: subtitle
+#: Book_Info.xml:7
+#, no-c-format
+msgid "for Use with JBoss Enterprise Application Platform 5.0"
+msgstr ""
+
+#. Tag: para
+#: Book_Info.xml:14
+#, no-c-format
+msgid ""
+"The JBoss Enterprise Application Platform Edition of the Hibernate Validator "
+"Reference Guide"
+msgstr ""
+
+#. Tag: holder
+#: Book_Info.xml:25
+#, no-c-format
+msgid "&HOLDER;"
+msgstr ""
Added: projects/docs/enterprise/5.0/Hibernate/Hibernate_Validator/es-ES/Hibernate_Validator_Reference_Guide.po
===================================================================
Added: projects/docs/enterprise/5.0/Hibernate/Hibernate_Validator/es-ES/Preface.po
===================================================================
--- projects/docs/enterprise/5.0/Hibernate/Hibernate_Validator/es-ES/Preface.po (rev 0)
+++ projects/docs/enterprise/5.0/Hibernate/Hibernate_Validator/es-ES/Preface.po 2009-11-26 05:06:44 UTC (rev 97007)
@@ -0,0 +1,56 @@
+#. Tag: title
+#: Preface.xml:7
+#, no-c-format
+msgid "Preface"
+msgstr ""
+
+#. Tag: para
+#: Preface.xml:9
+#, no-c-format
+msgid ""
+"Annotations are a very convenient and elegant way to specify invariant "
+"constraints for a domain model. You can, for example, express that a "
+"property should never be null, that the account balance should be strictly "
+"positive, etc. These domain model constraints are declared in the bean "
+"itself by annotating its properties. A validator can then read them and "
+"check for constraint violations. The validation mechanism can be executed in "
+"different layers in your application without having to duplicate any of "
+"these rules (presentation layer, data access layer). Following the DRY "
+"principle, Hibernate Validator has been designed for that purpose."
+msgstr ""
+
+#. Tag: para
+#: Preface.xml:20
+#, no-c-format
+msgid ""
+"Hibernate Validator works at two levels. First, it is able to check in-"
+"memory instances of a class for constraint violations. Second, it can apply "
+"the constraints to the Hibernate metamodel and incorporate them into the "
+"generated database schema."
+msgstr ""
+
+#. Tag: para
+#: Preface.xml:25
+#, no-c-format
+msgid ""
+"Each constraint annotation is associated to a validator implementation "
+"responsible for checking the constraint on the entity instance. A validator "
+"can also (optionally) apply the constraint to the Hibernate metamodel, "
+"allowing Hibernate to generate DDL that expresses the constraint. With the "
+"appropriate event listener, you can execute the checking operation on "
+"inserts and updates done by Hibernate. Hibernate Validator is not limited to "
+"use with Hibernate. You can easily use it anywhere in your application as "
+"well as with any Java Persistence provider (entity listener provided)."
+msgstr ""
+
+#. Tag: para
+#: Preface.xml:35
+#, no-c-format
+msgid ""
+"When checking instances at runtime, Hibernate Validator returns information "
+"about constraint violations in an array of <classname>InvalidValue</"
+"classname> s. Among other information, the <classname>InvalidValue</"
+"classname> contains an error description message that can embed the "
+"parameter values bundle with the annotation (eg. length limit), and message "
+"strings that may be externalized to a <classname>ResourceBundle</classname> ."
+msgstr ""
Added: projects/docs/enterprise/5.0/Hibernate/Hibernate_Validator/es-ES/Revision_History.po
===================================================================
--- projects/docs/enterprise/5.0/Hibernate/Hibernate_Validator/es-ES/Revision_History.po (rev 0)
+++ projects/docs/enterprise/5.0/Hibernate/Hibernate_Validator/es-ES/Revision_History.po 2009-11-26 05:06:44 UTC (rev 97007)
@@ -0,0 +1,11 @@
+#. Tag: title
+#: Revision_History.xml:6
+#, no-c-format
+msgid "Revision History"
+msgstr ""
+
+#. Tag: author
+#: Revision_History.xml:12
+#, no-c-format
+msgid "<firstname></firstname> <surname></surname> <email></email>"
+msgstr ""
Added: projects/docs/enterprise/5.0/Hibernate/Hibernate_Validator/es-ES/checkconstraints.po
===================================================================
--- projects/docs/enterprise/5.0/Hibernate/Hibernate_Validator/es-ES/checkconstraints.po (rev 0)
+++ projects/docs/enterprise/5.0/Hibernate/Hibernate_Validator/es-ES/checkconstraints.po 2009-11-26 05:06:44 UTC (rev 97007)
@@ -0,0 +1,370 @@
+#. Tag: title
+#: checkconstraints.xml:3
+#, no-c-format
+msgid "Using the Validator framework"
+msgstr ""
+
+#. Tag: para
+#: checkconstraints.xml:5
+#, no-c-format
+msgid ""
+"Hibernate Validator is intended to be used to implement multi-layered data "
+"validation, where constraints are expressed in a single place (the annotated "
+"domain model) and checked in various different layers of the application."
+msgstr ""
+
+#. Tag: para
+#: checkconstraints.xml:10
+#, no-c-format
+msgid "This chapter will cover Hibernate Validator usage for different layers"
+msgstr ""
+
+#. Tag: title
+#: checkconstraints.xml:14
+#, no-c-format
+msgid "Database schema-level validation"
+msgstr ""
+
+#. Tag: para
+#: checkconstraints.xml:16
+#, no-c-format
+msgid ""
+"Out of the box, Hibernate Annotations will translate the constraints you "
+"have defined for your entities into mapping metadata. For example, if a "
+"property of your entity is annotated <literal>@NotNull</literal>, its "
+"columns will be declared as <literal>not null</literal> in the DDL schema "
+"generated by Hibernate."
+msgstr ""
+
+#. Tag: para
+#: checkconstraints.xml:22
+#, no-c-format
+msgid ""
+"Using hbm2ddl, domain model constraints will be expressed into the database "
+"schema."
+msgstr ""
+
+#. Tag: para
+#: checkconstraints.xml:25
+#, no-c-format
+msgid ""
+"If, for some reason, the feature needs to be disabled, set "
+"<literal>hibernate.validator.apply_to_ddl</literal> to <literal>false</"
+"literal>."
+msgstr ""
+
+#. Tag: title
+#: checkconstraints.xml:31
+#, no-c-format
+msgid "ORM integration"
+msgstr ""
+
+#. Tag: para
+#: checkconstraints.xml:33
+#, no-c-format
+msgid ""
+"Hibernate Validator integrates with both Hibernate and all pure Java "
+"Persistence providers"
+msgstr ""
+
+#. Tag: title
+#: checkconstraints.xml:37
+#, no-c-format
+msgid "Hibernate event-based validation"
+msgstr ""
+
+#. Tag: para
+#: checkconstraints.xml:39
+#, no-c-format
+msgid ""
+"Hibernate Validator has two built-in Hibernate event listeners. Whenever a "
+"<literal>PreInsertEvent</literal> or <literal>PreUpdateEvent</literal> "
+"occurs, the listeners will verify all constraints of the entity instance and "
+"throw an exception if any constraint is violated. Basically, objects will be "
+"checked before any inserts and before any updates made by Hibernate. This "
+"includes changes applied by cascade! This is the most convenient and the "
+"easiest way to activate the validation process. On constraint violation, the "
+"event will raise a runtime <classname>InvalidStateException</classname> "
+"which contains an array of <literal>InvalidValue</literal>s describing each "
+"failure."
+msgstr ""
+
+#. Tag: para
+#: checkconstraints.xml:51
+#, no-c-format
+msgid ""
+"If Hibernate Validator is present in the classpath, Hibernate Annotations "
+"(or Hibernate EntityManager) will use it transparently. If, for some reason, "
+"you want to disable this integration, set <literal>hibernate.validator."
+"autoregister_listeners</literal> to false"
+msgstr ""
+
+#. Tag: para
+#: checkconstraints.xml:58
+#, no-c-format
+msgid ""
+"If the beans are not annotated with validation annotations, there is no "
+"runtime performance cost."
+msgstr ""
+
+#. Tag: para
+#: checkconstraints.xml:62
+#, no-c-format
+msgid ""
+"In case you need to manually set the event listeners for Hibernate Core, use "
+"the following configuration in <literal>hibernate.cfg.xml</literal>:"
+msgstr ""
+
+#. Tag: programlisting
+#: checkconstraints.xml:66
+#, no-c-format
+msgid ""
+"<hibernate-configuration>\n"
+" ...\n"
+" <event type=\"pre-update\">\n"
+" <listener \n"
+" class=\"org.hibernate.validator.event.ValidateEventListener\"/"
+">\n"
+" </event>\n"
+" <event type=\"pre-insert\">\n"
+" <listener \n"
+" class=\"org.hibernate.validator.event.ValidateEventListener\"/"
+">\n"
+" </event>\n"
+"</hibernate-configuration>"
+msgstr ""
+
+#. Tag: title
+#: checkconstraints.xml:70
+#, no-c-format
+msgid "Java Persistence event-based validation"
+msgstr ""
+
+#. Tag: para
+#: checkconstraints.xml:72
+#, no-c-format
+msgid ""
+"Hibernate Validator is not tied to Hibernate for event based validation: a "
+"Java Persistence entity listener is available. Whenever an listened entity "
+"is persisted or updated, Hibernate Validator will verify all constraints of "
+"the entity instance and throw an exception if any constraint is violated. "
+"Basically, objects will be checked before any inserts and before any updates "
+"made by the Java Persistence provider. This includes changes applied by "
+"cascade! On constraint violation, the event will raise a runtime "
+"<classname>InvalidStateException</classname> which contains an array of "
+"<literal>InvalidValue</literal>s describing each failure."
+msgstr ""
+
+#. Tag: para
+#: checkconstraints.xml:83
+#, no-c-format
+msgid "Here is how to make a class validatable:"
+msgstr ""
+
+#. Tag: programlisting
+#: checkconstraints.xml:85
+#, no-c-format
+msgid ""
+"@Entity\n"
+"@EntityListeners( JPAValidateListener.class )\n"
+"public class Submarine {\n"
+" ...\n"
+"}"
+msgstr ""
+
+#. Tag: para
+#: checkconstraints.xml:88
+#, no-c-format
+msgid ""
+"Compared to the Hibernate event, the Java Persistence listener has two "
+"drawbacks. You need to define the entity listener on every validatable "
+"entity. The DDL generated by your provider will not reflect the constraints."
+msgstr ""
+
+#. Tag: title
+#: checkconstraints.xml:97
+#, no-c-format
+msgid "Application-level validation"
+msgstr ""
+
+#. Tag: para
+#: checkconstraints.xml:99
+#, no-c-format
+msgid "Hibernate Validator can be applied anywhere in your application code."
+msgstr ""
+
+#. Tag: programlisting
+#: checkconstraints.xml:102
+#, no-c-format
+msgid ""
+"ClassValidator personValidator = new ClassValidator( Person.class );\n"
+"ClassValidator addressValidator = new ClassValidator( Address.class, "
+"ResourceBundle.getBundle(\"messages\", Locale.ENGLISH) );\n"
+"\n"
+"InvalidValue[] validationMessages = addressValidator.getInvalidValues"
+"(address);"
+msgstr ""
+
+#. Tag: para
+#: checkconstraints.xml:104
+#, no-c-format
+msgid ""
+"The first two lines prepare the Hibernate Validator for class checking. The "
+"first one relies upon the error messages embedded in Hibernate Validator "
+"(see <xref linkend=\"validator-defineconstraints-error\"/>), the second one "
+"uses a resource bundle for these messages. It is considered a good practice "
+"to execute these lines once and cache the validator instances."
+msgstr ""
+
+#. Tag: para
+#: checkconstraints.xml:111
+#, no-c-format
+msgid ""
+"The third line actually validates the <literal>Address</literal> instance "
+"and returns an array of <literal>InvalidValue</literal>s. Your application "
+"logic will then be able to react to the failure."
+msgstr ""
+
+#. Tag: para
+#: checkconstraints.xml:115
+#, no-c-format
+msgid ""
+"You can also check a particular property instead of the whole bean. This "
+"might be useful for property per property user interaction"
+msgstr ""
+
+#. Tag: programlisting
+#: checkconstraints.xml:118
+#, no-c-format
+msgid ""
+"ClassValidator addressValidator = new ClassValidator( Address.class, "
+"ResourceBundle.getBundle(\"messages\", Locale.ENGLISH) );\n"
+"\n"
+"//only get city property invalid values\n"
+"InvalidValue[] validationMessages = addressValidator.getInvalidValues"
+"(address, \"city\");\n"
+"\n"
+"//only get potential city property invalid values\n"
+"InvalidValue[] validationMessages = addressValidator."
+"getPotentialInvalidValues(\"city\", \"Paris\")"
+msgstr ""
+
+#. Tag: title
+#: checkconstraints.xml:122
+#, no-c-format
+msgid "Presentation layer validation"
+msgstr ""
+
+#. Tag: para
+#: checkconstraints.xml:124
+#, no-c-format
+msgid ""
+"When working with JSF and <productname>JBoss Seam</productname>, one can "
+"triggers the validation process at the presentation layer using Seam's JSF "
+"tags <literal><s:validate></literal> and <literal><s:validateAll/"
+"></literal>, letting the constraints be expressed on the model, and the "
+"violations presented in the view"
+msgstr ""
+
+#. Tag: programlisting
+#: checkconstraints.xml:130
+#, no-c-format
+msgid ""
+"<h:form>\n"
+" <div>\n"
+" <h:messages/>\n"
+" </div>\n"
+" <emphasis role=\"bold\"><s:validateAll></emphasis>\n"
+" <div>\n"
+" Country:\n"
+" <h:inputText value=\"#{location.country}\" required=\"true\"/"
+">\n"
+" </div>\n"
+" <div>\n"
+" Zip code:\n"
+" <h:inputText value=\"#{location.zip}\" required=\"true\"/"
+">\n"
+" </div>\n"
+" <div>\n"
+" <h:commandButton/>\n"
+" </div>\n"
+" <emphasis role=\"bold\"></s:validateAll></emphasis>\n"
+"</h:form>"
+msgstr ""
+
+#. Tag: para
+#: checkconstraints.xml:132
+#, no-c-format
+msgid ""
+"Going even further, and adding <productname>Ajax4JSF</productname> to the "
+"loop will bring client side validation with just a couple of additional JSF "
+"tags, again without validation definition duplication."
+msgstr ""
+
+#. Tag: para
+#: checkconstraints.xml:137
+#, no-c-format
+msgid ""
+"Check the <ulink url=\"http://www.jboss.com/products/seam\">JBoss Seam</"
+"ulink> documentation for more information."
+msgstr ""
+
+#. Tag: title
+#: checkconstraints.xml:142
+#, no-c-format
+msgid "Validation informations"
+msgstr ""
+
+#. Tag: para
+#: checkconstraints.xml:144
+#, no-c-format
+msgid ""
+"As a validation information carrier, hibernate provide an array of "
+"<classname>InvalidValue</classname>. Each <literal>InvalidValue</literal> "
+"has a buch of methods describing the individual issues."
+msgstr ""
+
+#. Tag: para
+#: checkconstraints.xml:148
+#, no-c-format
+msgid "<methodname>getBeanClass()</methodname> retrieves the failing bean type"
+msgstr ""
+
+#. Tag: para
+#: checkconstraints.xml:151
+#, no-c-format
+msgid ""
+"<methodname>getBean()</methodname>retrieves the failing instance (if any ie "
+"not when using <methodname>getPotentianInvalidValues()</methodname>)"
+msgstr ""
+
+#. Tag: para
+#: checkconstraints.xml:155
+#, no-c-format
+msgid "<methodname>getValue()</methodname> retrieves the failing value"
+msgstr ""
+
+#. Tag: para
+#: checkconstraints.xml:158
+#, no-c-format
+msgid ""
+"<methodname>getMessage()</methodname> retrieves the proper internationalized "
+"error message"
+msgstr ""
+
+#. Tag: para
+#: checkconstraints.xml:161
+#, no-c-format
+msgid ""
+"<methodname>getRootBean()</methodname> retrieves the root bean instance "
+"generating the issue (useful in conjunction with <literal>@Valid</literal>), "
+"is null if getPotentianInvalidValues() is used."
+msgstr ""
+
+#. Tag: para
+#: checkconstraints.xml:166
+#, no-c-format
+msgid ""
+"<literal>getPropertyPath()</literal> retrieves the dotted path of the "
+"failing property starting from the root bean"
+msgstr ""
Added: projects/docs/enterprise/5.0/Hibernate/Hibernate_Validator/es-ES/defineconstraints.po
===================================================================
--- projects/docs/enterprise/5.0/Hibernate/Hibernate_Validator/es-ES/defineconstraints.po (rev 0)
+++ projects/docs/enterprise/5.0/Hibernate/Hibernate_Validator/es-ES/defineconstraints.po 2009-11-26 05:06:44 UTC (rev 97007)
@@ -0,0 +1,718 @@
+#. Tag: title
+#: defineconstraints.xml:3
+#, no-c-format
+msgid "Defining constraints"
+msgstr ""
+
+#. Tag: title
+#: defineconstraints.xml:6
+#, no-c-format
+msgid "What is a constraint?"
+msgstr ""
+
+#. Tag: para
+#: defineconstraints.xml:8
+#, no-c-format
+msgid ""
+"A constraint is a rule that a given element (field, property or bean) has to "
+"comply to. The rule semantic is expressed by an annotation. A constraint "
+"usually has some attributes used to parameterize the constraints limits. The "
+"constraint applies to the annotated element."
+msgstr ""
+
+#. Tag: title
+#: defineconstraints.xml:16
+#, no-c-format
+msgid "Built in constraints"
+msgstr ""
+
+#. Tag: para
+#: defineconstraints.xml:18
+#, no-c-format
+msgid ""
+"Hibernate Validator comes with some built-in constraints, which covers most "
+"basic data checks. As we'll see later, you're not limited to them, you can "
+"literally in a minute write your own constraints."
+msgstr ""
+
+#. Tag: title
+#: defineconstraints.xml:23
+#, no-c-format
+msgid "Built-in constraints"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:30
+#, no-c-format
+msgid "Annotation"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:32
+#, no-c-format
+msgid "Apply on"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:34
+#, no-c-format
+msgid "Runtime checking"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:36
+#, no-c-format
+msgid "Hibernate Metadata impact"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:42
+#, no-c-format
+msgid "@Length(min=, max=)"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:44 defineconstraints.xml:188
+#: defineconstraints.xml:199
+#, no-c-format
+msgid "property (String)"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:46
+#, no-c-format
+msgid "check if the string length match the range"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:48
+#, no-c-format
+msgid "Column length will be set to max"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:52
+#, no-c-format
+msgid "@Max(value=)"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:54 defineconstraints.xml:65 defineconstraints.xml:130
+#: defineconstraints.xml:210
+#, no-c-format
+msgid "property (numeric or string representation of a numeric)"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:57
+#, no-c-format
+msgid "check if the value is less than or equals to max"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:59 defineconstraints.xml:70 defineconstraints.xml:101
+#: defineconstraints.xml:136
+#, no-c-format
+msgid "Add a check constraint on the column"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:63
+#, no-c-format
+msgid "@Min(value=)"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:68
+#, no-c-format
+msgid "check if the value is more than or equals to min"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:74
+#, no-c-format
+msgid "@NotNull"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:76 defineconstraints.xml:86 defineconstraints.xml:153
+#: defineconstraints.xml:164
+#, no-c-format
+msgid "property"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:78
+#, no-c-format
+msgid "check if the value is not null"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:80
+#, no-c-format
+msgid "Column(s) are not null"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:84
+#, no-c-format
+msgid "@NotEmpty"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:88
+#, no-c-format
+msgid ""
+"check if the string is not null nor empty. Check if the connection is not "
+"null nor empty"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:91
+#, no-c-format
+msgid "Column(s) are not null (for String)"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:95
+#, no-c-format
+msgid "@Past"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:97 defineconstraints.xml:107
+#, no-c-format
+msgid "property (date or calendar)"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:99
+#, no-c-format
+msgid "check if the date is in the past"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:105
+#, no-c-format
+msgid "@Future"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:109
+#, no-c-format
+msgid "check if the date is in the future"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:111 defineconstraints.xml:124
+#: defineconstraints.xml:147 defineconstraints.xml:158
+#: defineconstraints.xml:169 defineconstraints.xml:182
+#: defineconstraints.xml:193 defineconstraints.xml:204
+#: defineconstraints.xml:228
+#, no-c-format
+msgid "none"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:115
+#, no-c-format
+msgid "@Pattern(regex=\"regexp\", flag=) or @Patterns( {@Pattern(...)} )"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:118 defineconstraints.xml:223
+#, no-c-format
+msgid "property (string)"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:120
+#, no-c-format
+msgid ""
+"check if the property match the regular expression given a match flag (see "
+"<classname>java.util.regex.Pattern </classname> )"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:128
+#, no-c-format
+msgid "@Range(min=, max=)"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:133
+#, no-c-format
+msgid "check if the value is between min and max (included)"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:140
+#, no-c-format
+msgid "@Size(min=, max=)"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:142
+#, no-c-format
+msgid "property (array, collection, map)"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:144
+#, no-c-format
+msgid "check if the element size is between min and max (included)"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:151
+#, no-c-format
+msgid "@AssertFalse"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:155
+#, no-c-format
+msgid ""
+"check that the method evaluates to false (useful for constraints expressed "
+"in code rather than annotations)"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:162
+#, no-c-format
+msgid "@AssertTrue"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:166
+#, no-c-format
+msgid ""
+"check that the method evaluates to true (useful for constraints expressed in "
+"code rather than annotations)"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:173
+#, no-c-format
+msgid "@Valid"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:175
+#, no-c-format
+msgid "property (object)"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:177
+#, no-c-format
+msgid ""
+"perform validation recursively on the associated object. If the object is a "
+"Collection or an array, the elements are validated recursively. If the "
+"object is a Map, the value elements are validated recursively."
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:186
+#, no-c-format
+msgid "@Email"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:190
+#, no-c-format
+msgid "check whether the string is conform to the email address specification"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:197
+#, no-c-format
+msgid "@CreditCardNumber"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:201
+#, no-c-format
+msgid ""
+"check whether the string is a well formated credit card number (derivative "
+"of the Luhn algorithm)"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:208
+#, no-c-format
+msgid "@Digits"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:213
+#, no-c-format
+msgid ""
+"check whether the property is a number having up to <literal>integerDigits</"
+"literal> integer digits and <literal>fractionalDigits</literal> fractonal "
+"digits"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:217
+#, no-c-format
+msgid "define column precision and scale"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:221
+#, no-c-format
+msgid "@EAN"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:225
+#, no-c-format
+msgid "check whether the string is a properly formated EAN or UPC-A code"
+msgstr ""
+
+#. Tag: title
+#: defineconstraints.xml:236
+#, no-c-format
+msgid "Error messages"
+msgstr ""
+
+#. Tag: para
+#: defineconstraints.xml:238
+#, no-c-format
+msgid ""
+"Hibernate Validator comes with a default set of error messages translated in "
+"about ten languages (if yours is not part of it, please sent us a patch). "
+"You can override those messages by creating a <filename>ValidatorMessages."
+"properties</filename> or ( <filename>ValidatorMessages_loc.properties</"
+"filename> ) and override the needed keys. You can even add your own "
+"additional set of messages while writing your validator annotations. If "
+"Hibernate Validator cannot resolve a key from your resourceBundle nor from "
+"ValidatorMessage, it falls back to the default built-in values."
+msgstr ""
+
+#. Tag: para
+#: defineconstraints.xml:248
+#, no-c-format
+msgid ""
+"Alternatively you can provide a <classname>ResourceBundle</classname> while "
+"checking programmatically the validation rules on a bean or if you want a "
+"completly different interpolation mechanism, you can provide an "
+"implementation of <literal>org.hibernate.validator.MessageInterpolator</"
+"literal> (check the JavaDoc for more informations)."
+msgstr ""
+
+#. Tag: title
+#: defineconstraints.xml:257
+#, no-c-format
+msgid "Writing your own constraints"
+msgstr ""
+
+#. Tag: para
+#: defineconstraints.xml:259
+#, no-c-format
+msgid ""
+"Extending the set of built-in constraints is extremely easy. Any constraint "
+"consists of two pieces: the constraint <emphasis>descriptor</emphasis> (the "
+"annotation) and the constraint <emphasis>validator</emphasis> (the "
+"implementation class). Here is a simple user-defined descriptor:"
+msgstr ""
+
+#. Tag: programlisting
+#: defineconstraints.xml:265
+#, no-c-format
+msgid ""
+"@ValidatorClass(CapitalizedValidator.class)\n"
+"@Target(METHOD)\n"
+"@Retention(RUNTIME)\n"
+"@Documented\n"
+"public @interface Capitalized {\n"
+" CapitalizeType type() default Capitalize.FIRST;\n"
+" String message() default \"has incorrect capitalization\"\n"
+"}"
+msgstr ""
+
+#. Tag: para
+#: defineconstraints.xml:267
+#, no-c-format
+msgid ""
+"<literal>type</literal> is a parameter describing how the property should to "
+"be capitalized. This is a user parameter fully dependant on the annotation "
+"business."
+msgstr ""
+
+#. Tag: para
+#: defineconstraints.xml:271
+#, no-c-format
+msgid ""
+"<literal>message</literal> is the default string used to describe the "
+"constraint violation and is mandatory. You can hard code the string or you "
+"can externalize part/all of it through the Java ResourceBundle mechanism. "
+"Parameters values are going to be injected inside the message when the "
+"<literal>{parameter}</literal> string is found (in our example "
+"<literal>Capitalization is not {type}</literal> would generate "
+"<literal>Capitalization is not FIRST</literal> ), externalizing the whole "
+"string in <filename>ValidatorMessages.properties</filename> is considered "
+"good practice. See <xref linkend=\"validator-defineconstraints-error\"/> ."
+msgstr ""
+
+#. Tag: programlisting
+#: defineconstraints.xml:282
+#, no-c-format
+msgid ""
+"@ValidatorClass(CapitalizedValidator.class)\n"
+"@Target(METHOD)\n"
+"@Retention(RUNTIME)\n"
+"@Documented\n"
+"public @interface Capitalized {\n"
+" CapitalizeType type() default Capitalize.FIRST;\n"
+" String message() default \"{validator.capitalized}\";\n"
+"}\n"
+"\n"
+"\n"
+"#in ValidatorMessages.properties\n"
+"validator.capitalized = <literal>Capitalization is not {type}</literal>"
+msgstr ""
+
+#. Tag: para
+#: defineconstraints.xml:284
+#, no-c-format
+msgid "As you can see the {} notation is recursive."
+msgstr ""
+
+#. Tag: para
+#: defineconstraints.xml:286
+#, no-c-format
+msgid ""
+"To link a descriptor to its validator implementation, we use the "
+"<literal>@ValidatorClass</literal> meta-annotation. The validator class "
+"parameter must name a class which implements <literal>Validator<"
+"ConstraintAnnotation></literal> ."
+msgstr ""
+
+#. Tag: para
+#: defineconstraints.xml:291
+#, no-c-format
+msgid ""
+"We now have to implement the validator (ie. the rule checking "
+"implementation). A validation implementation can check the value of the a "
+"property (by implementing <literal>PropertyConstraint</literal> ) and/or can "
+"modify the hibernate mapping metadata to express the constraint at the "
+"database level (by implementing <literal>PersistentClassConstraint</"
+"literal> )"
+msgstr ""
+
+#. Tag: programlisting
+#: defineconstraints.xml:298
+#, no-c-format
+msgid ""
+"public class CapitalizedValidator\n"
+" implements Validator<Capitalized>, PropertyConstraint {\n"
+" private CapitalizeType type;\n"
+"\n"
+" //part of the Validator<Annotation> contract,\n"
+" //allows to get and use the annotation values\n"
+" public void initialize(Capitalized parameters) {\n"
+" type = parameters.type();\n"
+" }\n"
+"\n"
+" //part of the property constraint contract\n"
+" public boolean isValid(Object value) {\n"
+" if (value==null) return true;\n"
+" if ( !(value instanceof String) ) return false;\n"
+" String string = (String) value;\n"
+" if (type == CapitalizeType.ALL) {\n"
+" return string.equals( string.toUpperCase() );\n"
+" }\n"
+" else {\n"
+" String first = string.substring(0,1);\n"
+" return first.equals( first.toUpperCase();\n"
+" }\n"
+" }\n"
+"}"
+msgstr ""
+
+#. Tag: para
+#: defineconstraints.xml:300
+#, no-c-format
+msgid ""
+"The <literal>isValid()</literal> method should return false if the "
+"constraint has been violated. For more examples, refer to the built-in "
+"validator implementations."
+msgstr ""
+
+#. Tag: para
+#: defineconstraints.xml:304
+#, no-c-format
+msgid ""
+"We only have seen property level validation, but you can write a Bean level "
+"validation annotation. Instead of receiving the return instance of a "
+"property, the bean itself will be passed to the validator. To activate the "
+"validation checking, just annotated the bean itself instead. A small sample "
+"can be found in the unit test suite."
+msgstr ""
+
+#. Tag: para
+#: defineconstraints.xml:310
+#, no-c-format
+msgid ""
+"If your constraint can be applied multiple times (with different parameters) "
+"on the same property or type, you can use the following annotation form:"
+msgstr ""
+
+#. Tag: programlisting
+#: defineconstraints.xml:314
+#, no-c-format
+msgid ""
+"@Target(METHOD)\n"
+"@Retention(RUNTIME)\n"
+"@Documented\n"
+"<emphasis role=\"bold\">public @interface Patterns {</emphasis>\n"
+" Pattern[] value();\n"
+"}\n"
+"\n"
+"@Target(METHOD)\n"
+"@Retention(RUNTIME)\n"
+"@Documented\n"
+"@ValidatorClass(PatternValidator.class)\n"
+"public @interface Pattern {\n"
+" String regexp();\n"
+"}"
+msgstr ""
+
+#. Tag: para
+#: defineconstraints.xml:316
+#, no-c-format
+msgid ""
+"Basically an annotation containing the value attribute as an array of "
+"validator annotations."
+msgstr ""
+
+#. Tag: title
+#: defineconstraints.xml:321
+#, no-c-format
+msgid "Annotating your domain model"
+msgstr ""
+
+#. Tag: para
+#: defineconstraints.xml:323
+#, no-c-format
+msgid ""
+"Since you are already familiar with annotations now, the syntax should be "
+"very familiar"
+msgstr ""
+
+#. Tag: programlisting
+#: defineconstraints.xml:326
+#, no-c-format
+msgid ""
+"public class Address {\n"
+" private String line1;\n"
+" private String line2;\n"
+" private String zip;\n"
+" private String state;\n"
+" private String country;\n"
+" private long id;\n"
+"\n"
+" // a not null string of 20 characters maximum\n"
+" @Length(max=20)\n"
+" @NotNull\n"
+" public String getCountry() {\n"
+" return country;\n"
+" }\n"
+"\n"
+" // a non null string\n"
+" @NotNull\n"
+" public String getLine1() {\n"
+" return line1;\n"
+" }\n"
+"\n"
+" //no constraint\n"
+" public String getLine2() {\n"
+" return line2;\n"
+" }\n"
+"\n"
+" // a not null string of 3 characters maximum\n"
+" @Length(max=3) @NotNull\n"
+" public String getState() {\n"
+" return state;\n"
+" }\n"
+"\n"
+" // a not null numeric string of 5 characters maximum\n"
+" // if the string is longer, the message will\n"
+" //be searched in the resource bundle at key 'long'\n"
+" @Length(max=5, message=\"{long}\")\n"
+" @Pattern(regex=\"[0-9]+\")\n"
+" @NotNull\n"
+" public String getZip() {\n"
+" return zip;\n"
+" }\n"
+"\n"
+" // should always be true\n"
+" @AssertTrue\n"
+" public boolean isValid() {\n"
+" return true;\n"
+" }\n"
+"\n"
+" // a numeric between 1 and 2000\n"
+" @Id @Min(1)\n"
+" @Range(max=2000)\n"
+" public long getId() {\n"
+" return id;\n"
+" }\n"
+"}"
+msgstr ""
+
+#. Tag: para
+#: defineconstraints.xml:328
+#, no-c-format
+msgid ""
+"While the example only shows public property validation, you can also "
+"annotate fields of any kind of visibility"
+msgstr ""
+
+#. Tag: programlisting
+#: defineconstraints.xml:331
+#, no-c-format
+msgid ""
+"@MyBeanConstraint(max=45\n"
+"public class Dog {\n"
+" @AssertTrue private boolean isMale;\n"
+" @NotNull protected String getName() { ... };\n"
+" ...\n"
+"}"
+msgstr ""
+
+#. Tag: para
+#: defineconstraints.xml:333
+#, no-c-format
+msgid ""
+"You can also annotate interfaces. Hibernate Validator will check all "
+"superclasses and interfaces extended or implemented by a given bean to read "
+"the appropriate validator annotations."
+msgstr ""
+
+#. Tag: programlisting
+#: defineconstraints.xml:337
+#, no-c-format
+msgid ""
+"public interface Named {\n"
+" @NotNull String getName();\n"
+" ...\n"
+"}\n"
+"\n"
+"public class Dog implements Named {\n"
+"\n"
+" @AssertTrue private boolean isMale;\n"
+"\n"
+" public String getName() { ... };\n"
+"\n"
+"}"
+msgstr ""
+
+#. Tag: para
+#: defineconstraints.xml:339
+#, no-c-format
+msgid ""
+"The name property will be checked for nullity when the Dog bean is validated."
+msgstr ""
Added: projects/docs/enterprise/5.0/Hibernate/Hibernate_Validator/fr-FR/Author_Group.po
===================================================================
--- projects/docs/enterprise/5.0/Hibernate/Hibernate_Validator/fr-FR/Author_Group.po (rev 0)
+++ projects/docs/enterprise/5.0/Hibernate/Hibernate_Validator/fr-FR/Author_Group.po 2009-11-26 05:06:44 UTC (rev 97007)
@@ -0,0 +1,24 @@
+# translation of Introduction.po to French
+# Language fr-FR translations for Hibernate_Validator package.
+#
+# Automatically generated, 2009.
+# Corina Roe <croe at redhat.com>, 2009.
+msgid ""
+msgstr ""
+"Project-Id-Version: Introduction\n"
+"Report-Msgid-Bugs-To: http://bugs.kde.org\n"
+"POT-Creation-Date: 2009-09-16 23:26+0000\n"
+"PO-Revision-Date: 2009-07-16 11:27+1000\n"
+"Last-Translator: Corina Roe <croe at redhat.com>\n"
+"Language-Team: French <i18 at redhat.com>\n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+"X-Generator: KBabel 1.11.4\n"
+
+#. Tag: author
+#: Author_Group.xml:6
+#, fuzzy, no-c-format
+msgid "<firstname>Red Hat Documentation Group</firstname> <surname></surname>"
+msgstr ""
+"<firstname>Equipe Développement Hibernate</firstname> <surname></surname>"
Added: projects/docs/enterprise/5.0/Hibernate/Hibernate_Validator/fr-FR/Book_Info.po
===================================================================
--- projects/docs/enterprise/5.0/Hibernate/Hibernate_Validator/fr-FR/Book_Info.po (rev 0)
+++ projects/docs/enterprise/5.0/Hibernate/Hibernate_Validator/fr-FR/Book_Info.po 2009-11-26 05:06:44 UTC (rev 97007)
@@ -0,0 +1,45 @@
+# translation of Introduction.po to French
+# Language fr-FR translations for Hibernate_Validator package.
+#
+# Automatically generated, 2009.
+# Corina Roe <croe at redhat.com>, 2009.
+msgid ""
+msgstr ""
+"Project-Id-Version: Introduction\n"
+"Report-Msgid-Bugs-To: http://bugs.kde.org\n"
+"POT-Creation-Date: 2009-09-16 23:26+0000\n"
+"PO-Revision-Date: 2009-07-16 11:27+1000\n"
+"Last-Translator: Corina Roe <croe at redhat.com>\n"
+"Language-Team: French <i18 at redhat.com>\n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+"X-Generator: KBabel 1.11.4\n"
+
+#. Tag: title
+#: Book_Info.xml:6
+#, fuzzy, no-c-format
+msgid "Hibernate Validator Reference Guide"
+msgstr "Hibernate Validator Reference Guide CP04 FP01"
+
+#. Tag: subtitle
+#: Book_Info.xml:7
+#, fuzzy, no-c-format
+msgid "for Use with JBoss Enterprise Application Platform 5.0"
+msgstr ""
+"A utiliser avec JBoss Enterprise Application Platform 4.3.0 Cumulative Patch "
+"4 Feature Pack 1"
+
+#. Tag: para
+#: Book_Info.xml:14
+#, no-c-format
+msgid ""
+"The JBoss Enterprise Application Platform Edition of the Hibernate Validator "
+"Reference Guide"
+msgstr ""
+
+#. Tag: holder
+#: Book_Info.xml:25
+#, no-c-format
+msgid "&HOLDER;"
+msgstr "&HOLDER;"
Added: projects/docs/enterprise/5.0/Hibernate/Hibernate_Validator/fr-FR/Hibernate_Validator_Reference_Guide.po
===================================================================
Added: projects/docs/enterprise/5.0/Hibernate/Hibernate_Validator/fr-FR/Preface.po
===================================================================
--- projects/docs/enterprise/5.0/Hibernate/Hibernate_Validator/fr-FR/Preface.po (rev 0)
+++ projects/docs/enterprise/5.0/Hibernate/Hibernate_Validator/fr-FR/Preface.po 2009-11-26 05:06:44 UTC (rev 97007)
@@ -0,0 +1,106 @@
+# translation of Introduction.po to French
+# Language fr-FR translations for Hibernate_Validator package.
+#
+# Automatically generated, 2009.
+# Corina Roe <croe at redhat.com>, 2009.
+msgid ""
+msgstr ""
+"Project-Id-Version: Introduction\n"
+"Report-Msgid-Bugs-To: http://bugs.kde.org\n"
+"POT-Creation-Date: 2009-09-16 23:26+0000\n"
+"PO-Revision-Date: 2009-07-16 11:27+1000\n"
+"Last-Translator: Corina Roe <croe at redhat.com>\n"
+"Language-Team: French <i18 at redhat.com>\n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+"X-Generator: KBabel 1.11.4\n"
+
+#. Tag: title
+#: Preface.xml:7
+#, no-c-format
+msgid "Preface"
+msgstr "Préface"
+
+#. Tag: para
+#: Preface.xml:9
+#, no-c-format
+msgid ""
+"Annotations are a very convenient and elegant way to specify invariant "
+"constraints for a domain model. You can, for example, express that a "
+"property should never be null, that the account balance should be strictly "
+"positive, etc. These domain model constraints are declared in the bean "
+"itself by annotating its properties. A validator can then read them and "
+"check for constraint violations. The validation mechanism can be executed in "
+"different layers in your application without having to duplicate any of "
+"these rules (presentation layer, data access layer). Following the DRY "
+"principle, Hibernate Validator has been designed for that purpose."
+msgstr ""
+"Les annotations représentent une façon pratique et élégante à la fois de "
+"préciser les contraintes constantes d'un modèle de domaine. Vous pourrez, "
+"ainsi, indiquer qu'une propriété ne doit jamais être nulle, ou que le solde "
+"du compte devra toujours être créditeur, etc... Ces contraintes de modèles "
+"de domaines se déclarent dans le bean lui-même en annotant ses propriétés. "
+"Un validateur pourra alors les lire et vérifier les violations de "
+"contraintes. Le mécanisme de validation pourra être exécuté à plusieurs "
+"niveaux dans votre application, sans pour autant à avoir à dupliquer aucune "
+"règle (niveau présentation, niveau d'accès aux données). En suivant le "
+"principe DRY, Hibernate Validator a été conçu dans ce but."
+
+#. Tag: para
+#: Preface.xml:20
+#, no-c-format
+msgid ""
+"Hibernate Validator works at two levels. First, it is able to check in-"
+"memory instances of a class for constraint violations. Second, it can apply "
+"the constraints to the Hibernate metamodel and incorporate them into the "
+"generated database schema."
+msgstr ""
+"Hibernate Validator opère à deux niveaux. Tout d'abord, il peut vérifier les "
+"instances de mémoire d'une classe au niveau des violations de contraintes. "
+"Ensuite, il peut appliquer ces contraintes au métamodèle Hibernate et les "
+"incorporer dans le schéma de la base de données qui est générée."
+
+#. Tag: para
+#: Preface.xml:25
+#, no-c-format
+msgid ""
+"Each constraint annotation is associated to a validator implementation "
+"responsible for checking the constraint on the entity instance. A validator "
+"can also (optionally) apply the constraint to the Hibernate metamodel, "
+"allowing Hibernate to generate DDL that expresses the constraint. With the "
+"appropriate event listener, you can execute the checking operation on "
+"inserts and updates done by Hibernate. Hibernate Validator is not limited to "
+"use with Hibernate. You can easily use it anywhere in your application as "
+"well as with any Java Persistence provider (entity listener provided)."
+msgstr ""
+"Chaque annotation de contrainte est associée à une implémentation de "
+"validateur qui est chargée de vérifier la contrainte dans l'instance de "
+"l'entité. Un validateur peut également (optionnel) faire appliquer la "
+"contrainte au métamodèle Hibernate, permettant ainsi à Hibernate de générer "
+"DDL qui exprime la contrainte. A l'aide d'une listener d'événement qui "
+"convient, vous pouvez exécuter l'opération de vérification sur les "
+"insertions et les mises à jour effectuées par Hibernate. Hibernate Validator "
+"n'est pas limité à Hibernate. Vous pouvez facilement l'utiliser n'importe où "
+"dans votre application, ou bien avec n'importe quel fournisseur de Java "
+"Persistence (listener d'entités fourni)."
+
+#. Tag: para
+#: Preface.xml:35
+#, no-c-format
+msgid ""
+"When checking instances at runtime, Hibernate Validator returns information "
+"about constraint violations in an array of <classname>InvalidValue</"
+"classname> s. Among other information, the <classname>InvalidValue</"
+"classname> contains an error description message that can embed the "
+"parameter values bundle with the annotation (eg. length limit), and message "
+"strings that may be externalized to a <classname>ResourceBundle</classname> ."
+msgstr ""
+"Lors de la vérification des instances en cours d'exécution, Hibernate "
+"Validator renvoie d'information sur les violations de contraintes sous la "
+"forme d'un ensemble d'<classname>InvalidValue</classname>. Entre autres "
+"informations, <classname>InvalidValue</classname> contient un message de "
+"description d'erreurs susceptible de comprendre les valeurs de paramètres "
+"associées à des annotations (par ex. limite de longueur), et des strings de "
+"messages qui pourraient être externalisés dans un <classname>ResourceBundle</"
+"classname>."
Added: projects/docs/enterprise/5.0/Hibernate/Hibernate_Validator/fr-FR/Revision_History.po
===================================================================
--- projects/docs/enterprise/5.0/Hibernate/Hibernate_Validator/fr-FR/Revision_History.po (rev 0)
+++ projects/docs/enterprise/5.0/Hibernate/Hibernate_Validator/fr-FR/Revision_History.po 2009-11-26 05:06:44 UTC (rev 97007)
@@ -0,0 +1,30 @@
+# translation of Introduction.po to French
+# Language fr-FR translations for Hibernate_Validator package.
+#
+# Automatically generated, 2009.
+# Corina Roe <croe at redhat.com>, 2009.
+msgid ""
+msgstr ""
+"Project-Id-Version: Introduction\n"
+"Report-Msgid-Bugs-To: http://bugs.kde.org\n"
+"POT-Creation-Date: 2009-09-16 23:26+0000\n"
+"PO-Revision-Date: 2009-07-16 11:27+1000\n"
+"Last-Translator: Corina Roe <croe at redhat.com>\n"
+"Language-Team: French <i18 at redhat.com>\n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+"X-Generator: KBabel 1.11.4\n"
+
+#. Tag: title
+#: Revision_History.xml:6
+#, no-c-format
+msgid "Revision History"
+msgstr "Historique de révision"
+
+#. Tag: author
+#: Revision_History.xml:12
+#, fuzzy, no-c-format
+msgid "<firstname></firstname> <surname></surname> <email></email>"
+msgstr ""
+"<firstname>Danielle</firstname> <surname>Coulson</surname> <email></email>"
Added: projects/docs/enterprise/5.0/Hibernate/Hibernate_Validator/fr-FR/checkconstraints.po
===================================================================
--- projects/docs/enterprise/5.0/Hibernate/Hibernate_Validator/fr-FR/checkconstraints.po (rev 0)
+++ projects/docs/enterprise/5.0/Hibernate/Hibernate_Validator/fr-FR/checkconstraints.po 2009-11-26 05:06:44 UTC (rev 97007)
@@ -0,0 +1,483 @@
+# translation of Introduction.po to French
+# Language fr-FR translations for Hibernate_Validator package.
+#
+# Automatically generated, 2009.
+# Corina Roe <croe at redhat.com>, 2009.
+msgid ""
+msgstr ""
+"Project-Id-Version: Introduction\n"
+"Report-Msgid-Bugs-To: http://bugs.kde.org\n"
+"POT-Creation-Date: 2009-09-16 23:26+0000\n"
+"PO-Revision-Date: 2009-07-16 11:27+1000\n"
+"Last-Translator: Corina Roe <croe at redhat.com>\n"
+"Language-Team: French <i18 at redhat.com>\n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+"X-Generator: KBabel 1.11.4\n"
+
+#. Tag: title
+#: checkconstraints.xml:3
+#, no-c-format
+msgid "Using the Validator framework"
+msgstr "Utilisation du programme de validation Hibernate Validator"
+
+#. Tag: para
+#: checkconstraints.xml:5
+#, no-c-format
+msgid ""
+"Hibernate Validator is intended to be used to implement multi-layered data "
+"validation, where constraints are expressed in a single place (the annotated "
+"domain model) and checked in various different layers of the application."
+msgstr ""
+"Hibernate Validator est conçu pour être utilisé pour l'implémentation de la "
+"validation de données sur plusieurs niveaux, quand les contraintes sont "
+"exprimées dans un seul endroit (le modèle de domaine annoté) et quand elles "
+"sont vérifiées à plusieurs niveaux de l'application."
+
+#. Tag: para
+#: checkconstraints.xml:10
+#, no-c-format
+msgid "This chapter will cover Hibernate Validator usage for different layers"
+msgstr ""
+"Ce chapitre va couvrir l'utilisation d'Hibernate Validator à plusieurs "
+"niveaux"
+
+#. Tag: title
+#: checkconstraints.xml:14
+#, no-c-format
+msgid "Database schema-level validation"
+msgstr "Validation niveau-schéma de la base de données"
+
+#. Tag: para
+#: checkconstraints.xml:16
+#, no-c-format
+msgid ""
+"Out of the box, Hibernate Annotations will translate the constraints you "
+"have defined for your entities into mapping metadata. For example, if a "
+"property of your entity is annotated <literal>@NotNull</literal>, its "
+"columns will be declared as <literal>not null</literal> in the DDL schema "
+"generated by Hibernate."
+msgstr ""
+"Prêt à l'emploi, Hibernate Annotations traduira les contraintes que vous "
+"aurez définies pour vos entités en métadonnées de mappage. Ainsi, si une "
+"propriété de votre entité est annotée <literal>@NotNull</literal>, ses "
+"colonnes seront déclarées comme <literal>not null</literal> (non nulles) "
+"dans le schéma DDL généré par Hibernate."
+
+#. Tag: para
+#: checkconstraints.xml:22
+#, no-c-format
+msgid ""
+"Using hbm2ddl, domain model constraints will be expressed into the database "
+"schema."
+msgstr ""
+"Avec hbm2ddl, les contraintes de modèle de domaine seront exprimées dans le "
+"schéma de la base de données."
+
+#. Tag: para
+#: checkconstraints.xml:25
+#, no-c-format
+msgid ""
+"If, for some reason, the feature needs to be disabled, set "
+"<literal>hibernate.validator.apply_to_ddl</literal> to <literal>false</"
+"literal>."
+msgstr ""
+"Si, pour une raison quelconque, la fonctionnalité devait être désactivée, "
+"configurez <literal>hibernate.validator.apply_to_ddl</literal> à "
+"<literal>false</literal>."
+
+#. Tag: title
+#: checkconstraints.xml:31
+#, no-c-format
+msgid "ORM integration"
+msgstr "Intégration ORM"
+
+#. Tag: para
+#: checkconstraints.xml:33
+#, no-c-format
+msgid ""
+"Hibernate Validator integrates with both Hibernate and all pure Java "
+"Persistence providers"
+msgstr ""
+"Hibernate Validator intègre à la fois Hibernate et tous les fournisseurs de "
+"Java Persistence purs."
+
+#. Tag: title
+#: checkconstraints.xml:37
+#, no-c-format
+msgid "Hibernate event-based validation"
+msgstr "Validation basée-événement Hibernate"
+
+#. Tag: para
+#: checkconstraints.xml:39
+#, fuzzy, no-c-format
+msgid ""
+"Hibernate Validator has two built-in Hibernate event listeners. Whenever a "
+"<literal>PreInsertEvent</literal> or <literal>PreUpdateEvent</literal> "
+"occurs, the listeners will verify all constraints of the entity instance and "
+"throw an exception if any constraint is violated. Basically, objects will be "
+"checked before any inserts and before any updates made by Hibernate. This "
+"includes changes applied by cascade! This is the most convenient and the "
+"easiest way to activate the validation process. On constraint violation, the "
+"event will raise a runtime <classname>InvalidStateException</classname> "
+"which contains an array of <literal>InvalidValue</literal>s describing each "
+"failure."
+msgstr ""
+"Hibernate Validator contient deux listeners d'événements Hibernate intégrés. "
+"A chaque <literal>PreInsertEvent</literal> ou bien <literal>PreUpdateEvent</"
+"literal>, les listeners iront vérifier toutes les contraintes de l'instance "
+"d'entité et lanceront une exception si une contrainte est violée. Les objets "
+"seront vérifiés avant toute insertion ou mise à jour d'Hibernate. Cela "
+"comprend les changements appliqués par cascade. Il s'agit de la manière la "
+"plus pratique et la plus facile d'activer le processus de validation. En cas "
+"de violation de contrainte, l'événement lancera une exception d'exécution "
+"<classname>InvalidStateException</classname>, qui comprendra un ensemble d' "
+"<literal>InvalidValue</literal> pour décrire chaque défaillance."
+
+#. Tag: para
+#: checkconstraints.xml:51
+#, fuzzy, no-c-format
+msgid ""
+"If Hibernate Validator is present in the classpath, Hibernate Annotations "
+"(or Hibernate EntityManager) will use it transparently. If, for some reason, "
+"you want to disable this integration, set <literal>hibernate.validator."
+"autoregister_listeners</literal> to false"
+msgstr ""
+"Si Hibernate Validator est présent dans le chemin de classe, Hibernate "
+"Annotations (ou Hibernate EntityManager) l'utilisera de façon transparente. "
+"Si, pour une raison quelconque, vous souhaitez désactiver cette intégration, "
+"configurez <literal>hibernate.validator.autoregister_listeners</literal> à "
+"faux."
+
+#. Tag: para
+#: checkconstraints.xml:58
+#, no-c-format
+msgid ""
+"If the beans are not annotated with validation annotations, there is no "
+"runtime performance cost."
+msgstr ""
+"Si les beans ne sont pas annotés par des annotations de validation, il n'y "
+"aura pas de coût de performance d'exécution."
+
+#. Tag: para
+#: checkconstraints.xml:62
+#, no-c-format
+msgid ""
+"In case you need to manually set the event listeners for Hibernate Core, use "
+"the following configuration in <literal>hibernate.cfg.xml</literal>:"
+msgstr ""
+"Dans le cas où vous ayez besoin de configurer les listeners d'événements "
+"manuellement pour Hibernate Core, utiliser la configuration suivante dans "
+"<literal>hibernate.cfg.xml</literal> :"
+
+#. Tag: programlisting
+#: checkconstraints.xml:66
+#, no-c-format
+msgid ""
+"<hibernate-configuration>\n"
+" ...\n"
+" <event type=\"pre-update\">\n"
+" <listener \n"
+" class=\"org.hibernate.validator.event.ValidateEventListener\"/"
+">\n"
+" </event>\n"
+" <event type=\"pre-insert\">\n"
+" <listener \n"
+" class=\"org.hibernate.validator.event.ValidateEventListener\"/"
+">\n"
+" </event>\n"
+"</hibernate-configuration>"
+msgstr ""
+
+#. Tag: title
+#: checkconstraints.xml:70
+#, no-c-format
+msgid "Java Persistence event-based validation"
+msgstr "Validation basée-événement de Java Persistence"
+
+#. Tag: para
+#: checkconstraints.xml:72
+#, no-c-format
+msgid ""
+"Hibernate Validator is not tied to Hibernate for event based validation: a "
+"Java Persistence entity listener is available. Whenever an listened entity "
+"is persisted or updated, Hibernate Validator will verify all constraints of "
+"the entity instance and throw an exception if any constraint is violated. "
+"Basically, objects will be checked before any inserts and before any updates "
+"made by the Java Persistence provider. This includes changes applied by "
+"cascade! On constraint violation, the event will raise a runtime "
+"<classname>InvalidStateException</classname> which contains an array of "
+"<literal>InvalidValue</literal>s describing each failure."
+msgstr ""
+"Hibernate Validator n'est pas lié à Hibernate pour la validation basée "
+"événement : un listener d'entités de Persistence Java est disponible. A "
+"chaque fois qu'une entité écoutée (listened) est peristée ou bien mise à "
+"jour, Hibernate Validator ira vérifier toutes les contraintes de l'instance "
+"d'entité et ira lancer une exception si une contrainte est violée. En fait, "
+"les objets seront vérifiés avant toute insertion et avant toute mise à jour "
+"de la part du fournisseur Java Persistence. Cela comprend les changements "
+"éffectués par cascade! En cas de violation de contrainte, l'événement "
+"lancera une exception d'exécution <classname>InvalidStateException</"
+"classname> qui contient un ensemble d'<literal>InvalidValue</literal> "
+"décrivant chaque défaillance."
+
+#. Tag: para
+#: checkconstraints.xml:83
+#, no-c-format
+msgid "Here is how to make a class validatable:"
+msgstr "Voici comment rendre une classe validable : "
+
+#. Tag: programlisting
+#: checkconstraints.xml:85
+#, no-c-format
+msgid ""
+"@Entity\n"
+"@EntityListeners( JPAValidateListener.class )\n"
+"public class Submarine {\n"
+" ...\n"
+"}"
+msgstr ""
+
+#. Tag: para
+#: checkconstraints.xml:88
+#, no-c-format
+msgid ""
+"Compared to the Hibernate event, the Java Persistence listener has two "
+"drawbacks. You need to define the entity listener on every validatable "
+"entity. The DDL generated by your provider will not reflect the constraints."
+msgstr ""
+"Par rapport à l'événement Hibernate, le listener de Java Persistence a deux "
+"inconvénients. Vous aurez besoin de déterminer le listener d'entité pour "
+"chaque entité validable. Le DDL généré par votre fournisseur ne reflètera "
+"pas les contraintes."
+
+#. Tag: title
+#: checkconstraints.xml:97
+#, no-c-format
+msgid "Application-level validation"
+msgstr "Validation au niveau-application"
+
+#. Tag: para
+#: checkconstraints.xml:99
+#, no-c-format
+msgid "Hibernate Validator can be applied anywhere in your application code."
+msgstr ""
+"Hibernate Validator peut s'appliquer n'importe où dans votre code "
+"d'application."
+
+#. Tag: programlisting
+#: checkconstraints.xml:102
+#, no-c-format
+msgid ""
+"ClassValidator personValidator = new ClassValidator( Person.class );\n"
+"ClassValidator addressValidator = new ClassValidator( Address.class, "
+"ResourceBundle.getBundle(\"messages\", Locale.ENGLISH) );\n"
+"\n"
+"InvalidValue[] validationMessages = addressValidator.getInvalidValues"
+"(address);"
+msgstr ""
+
+#. Tag: para
+#: checkconstraints.xml:104
+#, fuzzy, no-c-format
+msgid ""
+"The first two lines prepare the Hibernate Validator for class checking. The "
+"first one relies upon the error messages embedded in Hibernate Validator "
+"(see <xref linkend=\"validator-defineconstraints-error\"/>), the second one "
+"uses a resource bundle for these messages. It is considered a good practice "
+"to execute these lines once and cache the validator instances."
+msgstr ""
+"Les deux premières lignes préparent Hibernate Validator pour la vérification "
+"des classes. Le premier se base sur les messages d'erreur contenus dans "
+"Hibernate Validator (voir <xref linkend=\"Hibernate_Validator-"
+"Defineconstraints-error\"/>), le deuxième utilise un ensemble de ressources "
+"pour ces messages. Il est de bonne pratique d'exécuter ces lignes une fois, "
+"puis de cacher les instances du programme de validation."
+
+#. Tag: para
+#: checkconstraints.xml:111
+#, no-c-format
+msgid ""
+"The third line actually validates the <literal>Address</literal> instance "
+"and returns an array of <literal>InvalidValue</literal>s. Your application "
+"logic will then be able to react to the failure."
+msgstr ""
+"La troisième ligne valide en fait l'instance d'<literal>Address</literal> et "
+"retourne un ensemble d'<literal>InvalidValue</literal>. La logique de votre "
+"application sera alors en mesure de réagir par rapport à cette défaillance."
+
+#. Tag: para
+#: checkconstraints.xml:115
+#, no-c-format
+msgid ""
+"You can also check a particular property instead of the whole bean. This "
+"might be useful for property per property user interaction"
+msgstr ""
+"Vous pourrez également vérifier une propriété plus particulièrement, à la "
+"place du bean dans son ensemble. Cela pourrait être utile pour l'interaction "
+"d'utilisateur d'une propriété à l'autre."
+
+#. Tag: programlisting
+#: checkconstraints.xml:118
+#, no-c-format
+msgid ""
+"ClassValidator addressValidator = new ClassValidator( Address.class, "
+"ResourceBundle.getBundle(\"messages\", Locale.ENGLISH) );\n"
+"\n"
+"//only get city property invalid values\n"
+"InvalidValue[] validationMessages = addressValidator.getInvalidValues"
+"(address, \"city\");\n"
+"\n"
+"//only get potential city property invalid values\n"
+"InvalidValue[] validationMessages = addressValidator."
+"getPotentialInvalidValues(\"city\", \"Paris\")"
+msgstr ""
+
+#. Tag: title
+#: checkconstraints.xml:122
+#, no-c-format
+msgid "Presentation layer validation"
+msgstr "Validation au niveau présentation"
+
+#. Tag: para
+#: checkconstraints.xml:124
+#, fuzzy, no-c-format
+msgid ""
+"When working with JSF and <productname>JBoss Seam</productname>, one can "
+"triggers the validation process at the presentation layer using Seam's JSF "
+"tags <literal><s:validate></literal> and <literal><s:validateAll/"
+"></literal>, letting the constraints be expressed on the model, and the "
+"violations presented in the view"
+msgstr ""
+"Quand on travaille avec JSF et <productname>JBoss Seam</productname>, on "
+"peut déclencher le processus de validation au niveau présentation en "
+"utilisant les étiquettes JSF de Seam <literal><s:validate></literal> "
+"et <literal><s:validateAll/></literal>, permettant aux contraintes "
+"d'être exprimées sur le modèle, et aux violations d'être présentées sur "
+"l'écran."
+
+#. Tag: programlisting
+#: checkconstraints.xml:130
+#, no-c-format
+msgid ""
+"<h:form>\n"
+" <div>\n"
+" <h:messages/>\n"
+" </div>\n"
+" <emphasis role=\"bold\"><s:validateAll></emphasis>\n"
+" <div>\n"
+" Country:\n"
+" <h:inputText value=\"#{location.country}\" required=\"true\"/"
+">\n"
+" </div>\n"
+" <div>\n"
+" Zip code:\n"
+" <h:inputText value=\"#{location.zip}\" required=\"true\"/"
+">\n"
+" </div>\n"
+" <div>\n"
+" <h:commandButton/>\n"
+" </div>\n"
+" <emphasis role=\"bold\"></s:validateAll></emphasis>\n"
+"</h:form>"
+msgstr ""
+
+#. Tag: para
+#: checkconstraints.xml:132
+#, no-c-format
+msgid ""
+"Going even further, and adding <productname>Ajax4JSF</productname> to the "
+"loop will bring client side validation with just a couple of additional JSF "
+"tags, again without validation definition duplication."
+msgstr ""
+"Pour aller encore plus loin, en ajoutant <productname>Ajax4JSF</productname> "
+"à la boucle apportera juste quelques étiquettes JSF supplémentaires pour la "
+"validation coté client, à nouveau, sans duplication de définition de "
+"validation."
+
+#. Tag: para
+#: checkconstraints.xml:137
+#, no-c-format
+msgid ""
+"Check the <ulink url=\"http://www.jboss.com/products/seam\">JBoss Seam</"
+"ulink> documentation for more information."
+msgstr ""
+"Vérifier la documentation<ulink url=\"http://www.jboss.com/products/seam"
+"\">Jboss Seam</ulink> pour davantage d'informations."
+
+#. Tag: title
+#: checkconstraints.xml:142
+#, fuzzy, no-c-format
+msgid "Validation informations"
+msgstr "Information de validation"
+
+#. Tag: para
+#: checkconstraints.xml:144
+#, fuzzy, no-c-format
+msgid ""
+"As a validation information carrier, hibernate provide an array of "
+"<classname>InvalidValue</classname>. Each <literal>InvalidValue</literal> "
+"has a buch of methods describing the individual issues."
+msgstr ""
+"En tant que fournisseur d'information de validation, Hibernate procure un "
+"ensemble d' <classname>InvalidValue</classname>. Chaque "
+"<literal>InvalidValue</literal> comprend un ensemble de méthodes pour "
+"décrire les problèmes particuliers."
+
+#. Tag: para
+#: checkconstraints.xml:148
+#, no-c-format
+msgid "<methodname>getBeanClass()</methodname> retrieves the failing bean type"
+msgstr ""
+"<methodname>getBeanClass()</methodname> retire le type de bean qui est "
+"défaillant"
+
+#. Tag: para
+#: checkconstraints.xml:151
+#, fuzzy, no-c-format
+msgid ""
+"<methodname>getBean()</methodname>retrieves the failing instance (if any ie "
+"not when using <methodname>getPotentianInvalidValues()</methodname>)"
+msgstr ""
+"<methodname>getBean()</methodname>retire l'instance défaillante (si "
+"possible, c'est à dire sans utiliser <methodname>getPotentianInvalidValues()"
+"</methodname>)"
+
+#. Tag: para
+#: checkconstraints.xml:155
+#, no-c-format
+msgid "<methodname>getValue()</methodname> retrieves the failing value"
+msgstr "<methodname>getValue()</methodname> retire la valeur défaillante"
+
+#. Tag: para
+#: checkconstraints.xml:158
+#, no-c-format
+msgid ""
+"<methodname>getMessage()</methodname> retrieves the proper internationalized "
+"error message"
+msgstr ""
+"<methodname>getMessage()</methodname> retire le message d'erreur "
+"internationalisé qui convient"
+
+#. Tag: para
+#: checkconstraints.xml:161
+#, no-c-format
+msgid ""
+"<methodname>getRootBean()</methodname> retrieves the root bean instance "
+"generating the issue (useful in conjunction with <literal>@Valid</literal>), "
+"is null if getPotentianInvalidValues() is used."
+msgstr ""
+"<methodname>getRootBean()</methodname> retire l'instance de bean root qui "
+"génère le problème (utile en conjonction à <literal>@Valid</literal>); est "
+"null quand getPotentianInvalidValues() est utilisé."
+
+#. Tag: para
+#: checkconstraints.xml:166
+#, no-c-format
+msgid ""
+"<literal>getPropertyPath()</literal> retrieves the dotted path of the "
+"failing property starting from the root bean"
+msgstr ""
+"<literal>getPropertyPath()</literal> retire le chemin en pointillés de la "
+"propriété défaillante à partir du root bean"
Added: projects/docs/enterprise/5.0/Hibernate/Hibernate_Validator/fr-FR/defineconstraints.po
===================================================================
--- projects/docs/enterprise/5.0/Hibernate/Hibernate_Validator/fr-FR/defineconstraints.po (rev 0)
+++ projects/docs/enterprise/5.0/Hibernate/Hibernate_Validator/fr-FR/defineconstraints.po 2009-11-26 05:06:44 UTC (rev 97007)
@@ -0,0 +1,838 @@
+# translation of Introduction.po to French
+# Language fr-FR translations for Hibernate_Validator package.
+#
+# Automatically generated, 2009.
+# Corina Roe <croe at redhat.com>, 2009.
+msgid ""
+msgstr ""
+"Project-Id-Version: Introduction\n"
+"Report-Msgid-Bugs-To: http://bugs.kde.org\n"
+"POT-Creation-Date: 2009-09-16 23:26+0000\n"
+"PO-Revision-Date: 2009-07-16 11:27+1000\n"
+"Last-Translator: Corina Roe <croe at redhat.com>\n"
+"Language-Team: French <i18 at redhat.com>\n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+"X-Generator: KBabel 1.11.4\n"
+
+#. Tag: title
+#: defineconstraints.xml:3
+#, no-c-format
+msgid "Defining constraints"
+msgstr "Déterminer les contraintes"
+
+#. Tag: title
+#: defineconstraints.xml:6
+#, no-c-format
+msgid "What is a constraint?"
+msgstr "Qu'est-ce qu'une contrainte ?"
+
+#. Tag: para
+#: defineconstraints.xml:8
+#, no-c-format
+msgid ""
+"A constraint is a rule that a given element (field, property or bean) has to "
+"comply to. The rule semantic is expressed by an annotation. A constraint "
+"usually has some attributes used to parameterize the constraints limits. The "
+"constraint applies to the annotated element."
+msgstr ""
+"Une contrainte est une règle à laquelle un élément donné (un champ, une "
+"propriété ou un bean) doit se conformer. La sémantique de cette règle est "
+"exprimée sous forme d'annotation. Une contrainte possède normalement des "
+"attributs qui sont utilisés pour paramétrer les limites des contraintes. La "
+"contrainte s'applique à l'élément qui est annoté."
+
+#. Tag: title
+#: defineconstraints.xml:16
+#, no-c-format
+msgid "Built in constraints"
+msgstr "Contraintes intégrées"
+
+#. Tag: para
+#: defineconstraints.xml:18
+#, no-c-format
+msgid ""
+"Hibernate Validator comes with some built-in constraints, which covers most "
+"basic data checks. As we'll see later, you're not limited to them, you can "
+"literally in a minute write your own constraints."
+msgstr ""
+"Hibernate Validator possède des contraintes intégrées, qui couvrent la "
+"plupart des vérifications de données de base. Comme nous le verrons plus "
+"tard, elles ne sont pas limitatives, vous pouvez rapidement rédiger vos "
+"propres contraintes en quelques minutes."
+
+#. Tag: title
+#: defineconstraints.xml:23
+#, no-c-format
+msgid "Built-in constraints"
+msgstr "Contraintes intégrées"
+
+#. Tag: entry
+#: defineconstraints.xml:30
+#, no-c-format
+msgid "Annotation"
+msgstr "Annotation"
+
+#. Tag: entry
+#: defineconstraints.xml:32
+#, no-c-format
+msgid "Apply on"
+msgstr "A appliquer"
+
+#. Tag: entry
+#: defineconstraints.xml:34
+#, no-c-format
+msgid "Runtime checking"
+msgstr "Vérification du runtime"
+
+#. Tag: entry
+#: defineconstraints.xml:36
+#, no-c-format
+msgid "Hibernate Metadata impact"
+msgstr "Impact d'Hibernate Metadata"
+
+#. Tag: entry
+#: defineconstraints.xml:42
+#, no-c-format
+msgid "@Length(min=, max=)"
+msgstr "@Length(min=, max=)"
+
+#. Tag: entry
+#: defineconstraints.xml:44 defineconstraints.xml:188
+#: defineconstraints.xml:199
+#, no-c-format
+msgid "property (String)"
+msgstr "propriété (String)"
+
+#. Tag: entry
+#: defineconstraints.xml:46
+#, no-c-format
+msgid "check if the string length match the range"
+msgstr "vérifier si la longueur du string est dans la limite de sa portée"
+
+#. Tag: entry
+#: defineconstraints.xml:48
+#, no-c-format
+msgid "Column length will be set to max"
+msgstr "La longueur de la colonne sera fixée au maximum"
+
+#. Tag: entry
+#: defineconstraints.xml:52
+#, no-c-format
+msgid "@Max(value=)"
+msgstr "@Max(value=)"
+
+#. Tag: entry
+#: defineconstraints.xml:54 defineconstraints.xml:65 defineconstraints.xml:130
+#: defineconstraints.xml:210
+#, no-c-format
+msgid "property (numeric or string representation of a numeric)"
+msgstr "propriété (numérique ou représentation par string d'un numérique)"
+
+#. Tag: entry
+#: defineconstraints.xml:57
+#, no-c-format
+msgid "check if the value is less than or equals to max"
+msgstr "vérifier si la valeur est inférieure ou égale au max"
+
+#. Tag: entry
+#: defineconstraints.xml:59 defineconstraints.xml:70 defineconstraints.xml:101
+#: defineconstraints.xml:136
+#, no-c-format
+msgid "Add a check constraint on the column"
+msgstr "Ajouter une contrainte de vérification sur la colonne"
+
+#. Tag: entry
+#: defineconstraints.xml:63
+#, no-c-format
+msgid "@Min(value=)"
+msgstr "@Min(value=)"
+
+#. Tag: entry
+#: defineconstraints.xml:68
+#, no-c-format
+msgid "check if the value is more than or equals to min"
+msgstr "vérifier si la valeur est supérieure ou égale au min"
+
+#. Tag: entry
+#: defineconstraints.xml:74
+#, no-c-format
+msgid "@NotNull"
+msgstr "@NotNull"
+
+#. Tag: entry
+#: defineconstraints.xml:76 defineconstraints.xml:86 defineconstraints.xml:153
+#: defineconstraints.xml:164
+#, no-c-format
+msgid "property"
+msgstr "propriété"
+
+#. Tag: entry
+#: defineconstraints.xml:78
+#, no-c-format
+msgid "check if the value is not null"
+msgstr "vérifier si la valeur n'est pas nulle"
+
+#. Tag: entry
+#: defineconstraints.xml:80
+#, no-c-format
+msgid "Column(s) are not null"
+msgstr "Colonne(s) non nulles"
+
+#. Tag: entry
+#: defineconstraints.xml:84
+#, no-c-format
+msgid "@NotEmpty"
+msgstr "@NotEmpty"
+
+#. Tag: entry
+#: defineconstraints.xml:88
+#, no-c-format
+msgid ""
+"check if the string is not null nor empty. Check if the connection is not "
+"null nor empty"
+msgstr ""
+"vérifier si le string n'est ni nul, ni vide. Vérifier si la connexion n'est "
+"ni nulle, ni vide"
+
+#. Tag: entry
+#: defineconstraints.xml:91
+#, no-c-format
+msgid "Column(s) are not null (for String)"
+msgstr "Colonne(s) non nulles (pour le String)"
+
+#. Tag: entry
+#: defineconstraints.xml:95
+#, no-c-format
+msgid "@Past"
+msgstr "@Past"
+
+#. Tag: entry
+#: defineconstraints.xml:97 defineconstraints.xml:107
+#, no-c-format
+msgid "property (date or calendar)"
+msgstr "propriété (date ou calendrier)"
+
+#. Tag: entry
+#: defineconstraints.xml:99
+#, no-c-format
+msgid "check if the date is in the past"
+msgstr "vérifier si la date est dans le passé"
+
+#. Tag: entry
+#: defineconstraints.xml:105
+#, no-c-format
+msgid "@Future"
+msgstr "@Future"
+
+#. Tag: entry
+#: defineconstraints.xml:109
+#, no-c-format
+msgid "check if the date is in the future"
+msgstr "vérifier si la date est dans le futur"
+
+#. Tag: entry
+#: defineconstraints.xml:111 defineconstraints.xml:124
+#: defineconstraints.xml:147 defineconstraints.xml:158
+#: defineconstraints.xml:169 defineconstraints.xml:182
+#: defineconstraints.xml:193 defineconstraints.xml:204
+#: defineconstraints.xml:228
+#, no-c-format
+msgid "none"
+msgstr "aucun(e)"
+
+#. Tag: entry
+#: defineconstraints.xml:115
+#, no-c-format
+msgid "@Pattern(regex=\"regexp\", flag=) or @Patterns( {@Pattern(...)} )"
+msgstr "@Pattern(regex=\"regexp\", flag=) or @Patterns( {@Pattern(...)} )"
+
+#. Tag: entry
+#: defineconstraints.xml:118 defineconstraints.xml:223
+#, no-c-format
+msgid "property (string)"
+msgstr "propriété (string)"
+
+#. Tag: entry
+#: defineconstraints.xml:120
+#, no-c-format
+msgid ""
+"check if the property match the regular expression given a match flag (see "
+"<classname>java.util.regex.Pattern </classname> )"
+msgstr ""
+"vérifier si la propriété correspond à l'expression usuelle associée au "
+"drapeau de correspondance (voir <classname>java.util.regex.Pattern </"
+"classname> )"
+
+#. Tag: entry
+#: defineconstraints.xml:128
+#, no-c-format
+msgid "@Range(min=, max=)"
+msgstr "@Range(min=, max=)"
+
+#. Tag: entry
+#: defineconstraints.xml:133
+#, no-c-format
+msgid "check if the value is between min and max (included)"
+msgstr ""
+"vérifier si la valeur est bien comprise entre le min et le max (compris)"
+
+#. Tag: entry
+#: defineconstraints.xml:140
+#, no-c-format
+msgid "@Size(min=, max=)"
+msgstr "@Size(min=, max=)"
+
+#. Tag: entry
+#: defineconstraints.xml:142
+#, no-c-format
+msgid "property (array, collection, map)"
+msgstr "propriété (array, collection, map)"
+
+#. Tag: entry
+#: defineconstraints.xml:144
+#, no-c-format
+msgid "check if the element size is between min and max (included)"
+msgstr ""
+"vérifier si la taille de l'élément est comprise entre le min et le max "
+"(compris)"
+
+#. Tag: entry
+#: defineconstraints.xml:151
+#, no-c-format
+msgid "@AssertFalse"
+msgstr "@AssertFalse"
+
+#. Tag: entry
+#: defineconstraints.xml:155
+#, no-c-format
+msgid ""
+"check that the method evaluates to false (useful for constraints expressed "
+"in code rather than annotations)"
+msgstr ""
+"vérifier si la méthode évalue à false (faux) (ce qui est utile pour les "
+"contraintes exprimées en code, et non pas en annotations)"
+
+#. Tag: entry
+#: defineconstraints.xml:162
+#, no-c-format
+msgid "@AssertTrue"
+msgstr "@AssertTrue"
+
+#. Tag: entry
+#: defineconstraints.xml:166
+#, no-c-format
+msgid ""
+"check that the method evaluates to true (useful for constraints expressed in "
+"code rather than annotations)"
+msgstr ""
+"vérifier que la méthode évalue à true (vrai) (ce qui est utile pour les "
+"contraintes exprimées en code, et non pas en annotations)"
+
+#. Tag: entry
+#: defineconstraints.xml:173
+#, no-c-format
+msgid "@Valid"
+msgstr "@Valid"
+
+#. Tag: entry
+#: defineconstraints.xml:175
+#, no-c-format
+msgid "property (object)"
+msgstr "propriété (objet)"
+
+#. Tag: entry
+#: defineconstraints.xml:177
+#, no-c-format
+msgid ""
+"perform validation recursively on the associated object. If the object is a "
+"Collection or an array, the elements are validated recursively. If the "
+"object is a Map, the value elements are validated recursively."
+msgstr ""
+"applique une validation récursive sur l'objet associé. Si l'objet est une "
+"Collection ou une Array (tableau), les éléments sont validés récursivement. "
+"Si l'objet est une Map (carte), les éléments de valeur sont validés "
+"récursivement."
+
+#. Tag: entry
+#: defineconstraints.xml:186
+#, no-c-format
+msgid "@Email"
+msgstr "@Email"
+
+#. Tag: entry
+#: defineconstraints.xml:190
+#, no-c-format
+msgid "check whether the string is conform to the email address specification"
+msgstr "vérifier si le string est conforme aux spécifications d'adresse email."
+
+#. Tag: entry
+#: defineconstraints.xml:197
+#, no-c-format
+msgid "@CreditCardNumber"
+msgstr "@CreditCardNumber"
+
+#. Tag: entry
+#: defineconstraints.xml:201
+#, no-c-format
+msgid ""
+"check whether the string is a well formated credit card number (derivative "
+"of the Luhn algorithm)"
+msgstr ""
+"vérifier si le string correspond à un numéro de carte de crédit "
+"convenablement formaté (dérivé d'un algorithme Luhn)"
+
+#. Tag: entry
+#: defineconstraints.xml:208
+#, no-c-format
+msgid "@Digits"
+msgstr "@Digits"
+
+#. Tag: entry
+#: defineconstraints.xml:213
+#, no-c-format
+msgid ""
+"check whether the property is a number having up to <literal>integerDigits</"
+"literal> integer digits and <literal>fractionalDigits</literal> fractonal "
+"digits"
+msgstr ""
+"vérifier si la propriété est un nombre qui comporte des entiers relatifs "
+"<literal>integerDigits</literal> ou des fractions <literal>fractionalDigits</"
+"literal>"
+
+#. Tag: entry
+#: defineconstraints.xml:217
+#, no-c-format
+msgid "define column precision and scale"
+msgstr "déterminer l'échelle et la précision de la colonne"
+
+#. Tag: entry
+#: defineconstraints.xml:221
+#, no-c-format
+msgid "@EAN"
+msgstr "@EAN"
+
+#. Tag: entry
+#: defineconstraints.xml:225
+#, no-c-format
+msgid "check whether the string is a properly formated EAN or UPC-A code"
+msgstr ""
+"vérifier si le string correspond à une propriété qui est formatée par le "
+"code EAN ou UPC-A"
+
+#. Tag: title
+#: defineconstraints.xml:236
+#, no-c-format
+msgid "Error messages"
+msgstr "Message d'erreur"
+
+#. Tag: para
+#: defineconstraints.xml:238
+#, no-c-format
+msgid ""
+"Hibernate Validator comes with a default set of error messages translated in "
+"about ten languages (if yours is not part of it, please sent us a patch). "
+"You can override those messages by creating a <filename>ValidatorMessages."
+"properties</filename> or ( <filename>ValidatorMessages_loc.properties</"
+"filename> ) and override the needed keys. You can even add your own "
+"additional set of messages while writing your validator annotations. If "
+"Hibernate Validator cannot resolve a key from your resourceBundle nor from "
+"ValidatorMessage, it falls back to the default built-in values."
+msgstr ""
+"Hibernate Validator est présenté avec un ensemble de messages d'erreurs qui "
+"se traduisent en une dizaine de langues (si la vôtre n'en faisait pas "
+"partie, veuillez nous envoyer un patch). Vous pouvez surcharger ces messages "
+"en créant un <filename>ValidatorMessages.properties</filename> ou un "
+"( <filename>ValidatorMessages_loc.properties</filename> ) et en surchargeant "
+"les clés nécessaires. Vous pourrez même ajouter votre propre ensemble de "
+"messages supplémentaires, tout en rédigeant vos annotations de validateur. "
+"Si Hibernate Validator ne peut pas résoudre une clé de votre resourceBundle, "
+"ni de votre ValidatorMessage, on retombe sur les valeurs intégrées par "
+"défaut."
+
+#. Tag: para
+#: defineconstraints.xml:248
+#, no-c-format
+msgid ""
+"Alternatively you can provide a <classname>ResourceBundle</classname> while "
+"checking programmatically the validation rules on a bean or if you want a "
+"completly different interpolation mechanism, you can provide an "
+"implementation of <literal>org.hibernate.validator.MessageInterpolator</"
+"literal> (check the JavaDoc for more informations)."
+msgstr ""
+"Sinon, vous pouvez fournir un <classname>ResourceBundle</classname> tout en "
+"vérifiant les règles de validation sur un bean de façon programmatique, ou "
+"encore, si vous souhaitez un mécanisme d'interpolation complètement "
+"différent, vous pourrez procurer une implémentation de <literal>org."
+"hibernate.validator.MessageInterpolator</literal> (vérifier JavaDoc pour "
+"davantage d'informations)."
+
+#. Tag: title
+#: defineconstraints.xml:257
+#, no-c-format
+msgid "Writing your own constraints"
+msgstr "Rédiger ses propres contraintes"
+
+#. Tag: para
+#: defineconstraints.xml:259
+#, no-c-format
+msgid ""
+"Extending the set of built-in constraints is extremely easy. Any constraint "
+"consists of two pieces: the constraint <emphasis>descriptor</emphasis> (the "
+"annotation) and the constraint <emphasis>validator</emphasis> (the "
+"implementation class). Here is a simple user-defined descriptor:"
+msgstr ""
+"Augmenter l'ensemble des contraintes intégrées est vraiment très facile. "
+"Toute contrainte consiste en deux parties : la contrainte "
+"<emphasis>descriptor</emphasis> (l'annotation) et la contrainte "
+"<emphasis>validator</emphasis> (la classe d'implémentation). Voici un "
+"descripteur simple défini par l'utilisateur :"
+
+#. Tag: programlisting
+#: defineconstraints.xml:265
+#, no-c-format
+msgid ""
+"@ValidatorClass(CapitalizedValidator.class)\n"
+"@Target(METHOD)\n"
+"@Retention(RUNTIME)\n"
+"@Documented\n"
+"public @interface Capitalized {\n"
+" CapitalizeType type() default Capitalize.FIRST;\n"
+" String message() default \"has incorrect capitalization\"\n"
+"}"
+msgstr ""
+
+#. Tag: para
+#: defineconstraints.xml:267
+#, no-c-format
+msgid ""
+"<literal>type</literal> is a parameter describing how the property should to "
+"be capitalized. This is a user parameter fully dependant on the annotation "
+"business."
+msgstr ""
+"<literal>type</literal> est un paramètre qui décrit comment la propriété "
+"doit être capitalisée. Il s'agit d'un paramètre d'utilisateur qui dépend "
+"entièrement du système d'annotations."
+
+#. Tag: para
+#: defineconstraints.xml:271
+#, fuzzy, no-c-format
+msgid ""
+"<literal>message</literal> is the default string used to describe the "
+"constraint violation and is mandatory. You can hard code the string or you "
+"can externalize part/all of it through the Java ResourceBundle mechanism. "
+"Parameters values are going to be injected inside the message when the "
+"<literal>{parameter}</literal> string is found (in our example "
+"<literal>Capitalization is not {type}</literal> would generate "
+"<literal>Capitalization is not FIRST</literal> ), externalizing the whole "
+"string in <filename>ValidatorMessages.properties</filename> is considered "
+"good practice. See <xref linkend=\"validator-defineconstraints-error\"/> ."
+msgstr ""
+"<literal>message</literal> est le string par défaut qui est utilisé pour "
+"décrire la violation de contrainte et qui est obligatoire. Vous pouvez créer "
+"le string en code fixe (hard code) ou vous pourrez en externaliser tout/ou "
+"partie par le mécanisme de Java ResourceBundle. Le s valeurs des paramètres "
+"seront injectées dans le message quand le string <literal>{parameter}</"
+"literal> est trouvé (dans l'exemple qui nous intéresse "
+"<literal>Capitalization is not {type}</literal> générerait "
+"<literal>Capitalization is not FIRST</literal> ), externalisant ainsi tout "
+"le string dans <filename>ValidatorMessages.properties</filename>, ce qui est "
+"considéré une bonne pratique. Voir <xref linkend=\"Hibernate_Validator-"
+"Defineconstraints-error\"/> ."
+
+#. Tag: programlisting
+#: defineconstraints.xml:282
+#, no-c-format
+msgid ""
+"@ValidatorClass(CapitalizedValidator.class)\n"
+"@Target(METHOD)\n"
+"@Retention(RUNTIME)\n"
+"@Documented\n"
+"public @interface Capitalized {\n"
+" CapitalizeType type() default Capitalize.FIRST;\n"
+" String message() default \"{validator.capitalized}\";\n"
+"}\n"
+"\n"
+"\n"
+"#in ValidatorMessages.properties\n"
+"validator.capitalized = <literal>Capitalization is not {type}</literal>"
+msgstr ""
+
+#. Tag: para
+#: defineconstraints.xml:284
+#, no-c-format
+msgid "As you can see the {} notation is recursive."
+msgstr "Comme vous pouvez l'observer, la notation {} est récursive."
+
+#. Tag: para
+#: defineconstraints.xml:286
+#, no-c-format
+msgid ""
+"To link a descriptor to its validator implementation, we use the "
+"<literal>@ValidatorClass</literal> meta-annotation. The validator class "
+"parameter must name a class which implements <literal>Validator<"
+"ConstraintAnnotation></literal> ."
+msgstr ""
+"Pour lier un descripteur à son implémentation de validateur, nous utilisons "
+"la méta-annotation <literal>@ValidatorClass</literal>. Le paramètre de "
+"classe de validation devra nommer une classe qui implémente "
+"<literal>Validator<ConstraintAnnotation></literal> ."
+
+#. Tag: para
+#: defineconstraints.xml:291
+#, no-c-format
+msgid ""
+"We now have to implement the validator (ie. the rule checking "
+"implementation). A validation implementation can check the value of the a "
+"property (by implementing <literal>PropertyConstraint</literal> ) and/or can "
+"modify the hibernate mapping metadata to express the constraint at the "
+"database level (by implementing <literal>PersistentClassConstraint</"
+"literal> )"
+msgstr ""
+"Nous devons maintenant implémenter le validateur (c'est à dire "
+"l'implémentation de la vérification des règles). Une implémentation de "
+"validation pourra vérifier la valeur d'une propriété (en implémentant "
+"<literal>PropertyConstraint</literal> ) et/ou pourra modifier les "
+"métadonnées du mappage d'hibernate pour pouvoir exprimer la contrainte au "
+"niveau de la base de données (en implémentant "
+"<literal>PersistentClassConstraint</literal> )"
+
+#. Tag: programlisting
+#: defineconstraints.xml:298
+#, no-c-format
+msgid ""
+"public class CapitalizedValidator\n"
+" implements Validator<Capitalized>, PropertyConstraint {\n"
+" private CapitalizeType type;\n"
+"\n"
+" //part of the Validator<Annotation> contract,\n"
+" //allows to get and use the annotation values\n"
+" public void initialize(Capitalized parameters) {\n"
+" type = parameters.type();\n"
+" }\n"
+"\n"
+" //part of the property constraint contract\n"
+" public boolean isValid(Object value) {\n"
+" if (value==null) return true;\n"
+" if ( !(value instanceof String) ) return false;\n"
+" String string = (String) value;\n"
+" if (type == CapitalizeType.ALL) {\n"
+" return string.equals( string.toUpperCase() );\n"
+" }\n"
+" else {\n"
+" String first = string.substring(0,1);\n"
+" return first.equals( first.toUpperCase();\n"
+" }\n"
+" }\n"
+"}"
+msgstr ""
+
+#. Tag: para
+#: defineconstraints.xml:300
+#, no-c-format
+msgid ""
+"The <literal>isValid()</literal> method should return false if the "
+"constraint has been violated. For more examples, refer to the built-in "
+"validator implementations."
+msgstr ""
+"La méthode <literal>isValid()</literal> devra retourner un false (faux) si "
+"la contrainte a été violée. Pour des exemples supplémentaires, reportez-vous "
+"aux implémentations du validateur intégré."
+
+#. Tag: para
+#: defineconstraints.xml:304
+#, no-c-format
+msgid ""
+"We only have seen property level validation, but you can write a Bean level "
+"validation annotation. Instead of receiving the return instance of a "
+"property, the bean itself will be passed to the validator. To activate the "
+"validation checking, just annotated the bean itself instead. A small sample "
+"can be found in the unit test suite."
+msgstr ""
+"Nous n'avons abordé que la validation au niveau de la propriété, mais vous "
+"pouvez rédiger une annotation de validation au niveau Bean. Au lieu de "
+"recevoir une instance de retour d'une propriété, le bean lui-même sera passé "
+"au validateur. Pour activer la vérification de validation, il suffit "
+"d'annoter le bean lui-même à la place. On peut en trouver un petit exemple "
+"dans la unit test suite."
+
+#. Tag: para
+#: defineconstraints.xml:310
+#, no-c-format
+msgid ""
+"If your constraint can be applied multiple times (with different parameters) "
+"on the same property or type, you can use the following annotation form:"
+msgstr ""
+"Si votre contrainte peut s'appliquer à plusieurs reprises (avec différents "
+"paramètres) sur la même propriété ou sur le même type, vous pouvez utiliser "
+"la forme d'annotation suivante :"
+
+#. Tag: programlisting
+#: defineconstraints.xml:314
+#, no-c-format
+msgid ""
+"@Target(METHOD)\n"
+"@Retention(RUNTIME)\n"
+"@Documented\n"
+"<emphasis role=\"bold\">public @interface Patterns {</emphasis>\n"
+" Pattern[] value();\n"
+"}\n"
+"\n"
+"@Target(METHOD)\n"
+"@Retention(RUNTIME)\n"
+"@Documented\n"
+"@ValidatorClass(PatternValidator.class)\n"
+"public @interface Pattern {\n"
+" String regexp();\n"
+"}"
+msgstr ""
+
+#. Tag: para
+#: defineconstraints.xml:316
+#, no-c-format
+msgid ""
+"Basically an annotation containing the value attribute as an array of "
+"validator annotations."
+msgstr ""
+"En fait, il s'agit d'une annotation qui contient l'attribut de valeur sous "
+"la forme d'un ensemble d'annnotations de validateur."
+
+#. Tag: title
+#: defineconstraints.xml:321
+#, no-c-format
+msgid "Annotating your domain model"
+msgstr "Annoter votre modèle de domaine"
+
+#. Tag: para
+#: defineconstraints.xml:323
+#, fuzzy, no-c-format
+msgid ""
+"Since you are already familiar with annotations now, the syntax should be "
+"very familiar"
+msgstr ""
+"Comme vous êtes maintenant familiarisés avec les annotations, la syntaxe va "
+"vous paraître facile."
+
+#. Tag: programlisting
+#: defineconstraints.xml:326
+#, no-c-format
+msgid ""
+"public class Address {\n"
+" private String line1;\n"
+" private String line2;\n"
+" private String zip;\n"
+" private String state;\n"
+" private String country;\n"
+" private long id;\n"
+"\n"
+" // a not null string of 20 characters maximum\n"
+" @Length(max=20)\n"
+" @NotNull\n"
+" public String getCountry() {\n"
+" return country;\n"
+" }\n"
+"\n"
+" // a non null string\n"
+" @NotNull\n"
+" public String getLine1() {\n"
+" return line1;\n"
+" }\n"
+"\n"
+" //no constraint\n"
+" public String getLine2() {\n"
+" return line2;\n"
+" }\n"
+"\n"
+" // a not null string of 3 characters maximum\n"
+" @Length(max=3) @NotNull\n"
+" public String getState() {\n"
+" return state;\n"
+" }\n"
+"\n"
+" // a not null numeric string of 5 characters maximum\n"
+" // if the string is longer, the message will\n"
+" //be searched in the resource bundle at key 'long'\n"
+" @Length(max=5, message=\"{long}\")\n"
+" @Pattern(regex=\"[0-9]+\")\n"
+" @NotNull\n"
+" public String getZip() {\n"
+" return zip;\n"
+" }\n"
+"\n"
+" // should always be true\n"
+" @AssertTrue\n"
+" public boolean isValid() {\n"
+" return true;\n"
+" }\n"
+"\n"
+" // a numeric between 1 and 2000\n"
+" @Id @Min(1)\n"
+" @Range(max=2000)\n"
+" public long getId() {\n"
+" return id;\n"
+" }\n"
+"}"
+msgstr ""
+
+#. Tag: para
+#: defineconstraints.xml:328
+#, fuzzy, no-c-format
+msgid ""
+"While the example only shows public property validation, you can also "
+"annotate fields of any kind of visibility"
+msgstr ""
+"Malgré que l'exemple ne montre que la validation publique, vous pouvez "
+"également annoter des champs par toute sorte de visibilité."
+
+#. Tag: programlisting
+#: defineconstraints.xml:331
+#, no-c-format
+msgid ""
+"@MyBeanConstraint(max=45\n"
+"public class Dog {\n"
+" @AssertTrue private boolean isMale;\n"
+" @NotNull protected String getName() { ... };\n"
+" ...\n"
+"}"
+msgstr ""
+
+#. Tag: para
+#: defineconstraints.xml:333
+#, no-c-format
+msgid ""
+"You can also annotate interfaces. Hibernate Validator will check all "
+"superclasses and interfaces extended or implemented by a given bean to read "
+"the appropriate validator annotations."
+msgstr ""
+"Vous pouvez également annoter des interfaces. Hibernate Validator va "
+"vérifier toutes les superclasses et toutes les interfaces qui auront été "
+"étendues ou implémentées par un bean donné pour pouvoir lire les annotations "
+"du validateur comme il convient."
+
+#. Tag: programlisting
+#: defineconstraints.xml:337
+#, no-c-format
+msgid ""
+"public interface Named {\n"
+" @NotNull String getName();\n"
+" ...\n"
+"}\n"
+"\n"
+"public class Dog implements Named {\n"
+"\n"
+" @AssertTrue private boolean isMale;\n"
+"\n"
+" public String getName() { ... };\n"
+"\n"
+"}"
+msgstr ""
+
+#. Tag: para
+#: defineconstraints.xml:339
+#, no-c-format
+msgid ""
+"The name property will be checked for nullity when the Dog bean is validated."
+msgstr ""
+"Le nom de la propriété sera vérifié au niveau de sa nullité quand le bean "
+"Dog sera validé."
Added: projects/docs/enterprise/5.0/Hibernate/Hibernate_Validator/ja-JP/Author_Group.po
===================================================================
--- projects/docs/enterprise/5.0/Hibernate/Hibernate_Validator/ja-JP/Author_Group.po (rev 0)
+++ projects/docs/enterprise/5.0/Hibernate/Hibernate_Validator/ja-JP/Author_Group.po 2009-11-26 05:06:44 UTC (rev 97007)
@@ -0,0 +1,5 @@
+#. Tag: author
+#: Author_Group.xml:6
+#, no-c-format
+msgid "<firstname>Red Hat Documentation Group</firstname> <surname></surname>"
+msgstr ""
Added: projects/docs/enterprise/5.0/Hibernate/Hibernate_Validator/ja-JP/Book_Info.po
===================================================================
--- projects/docs/enterprise/5.0/Hibernate/Hibernate_Validator/ja-JP/Book_Info.po (rev 0)
+++ projects/docs/enterprise/5.0/Hibernate/Hibernate_Validator/ja-JP/Book_Info.po 2009-11-26 05:06:44 UTC (rev 97007)
@@ -0,0 +1,25 @@
+#. Tag: title
+#: Book_Info.xml:6
+#, no-c-format
+msgid "Hibernate Validator Reference Guide"
+msgstr ""
+
+#. Tag: subtitle
+#: Book_Info.xml:7
+#, no-c-format
+msgid "for Use with JBoss Enterprise Application Platform 5.0"
+msgstr ""
+
+#. Tag: para
+#: Book_Info.xml:14
+#, no-c-format
+msgid ""
+"The JBoss Enterprise Application Platform Edition of the Hibernate Validator "
+"Reference Guide"
+msgstr ""
+
+#. Tag: holder
+#: Book_Info.xml:25
+#, no-c-format
+msgid "&HOLDER;"
+msgstr ""
Added: projects/docs/enterprise/5.0/Hibernate/Hibernate_Validator/ja-JP/Hibernate_Validator_Reference_Guide.po
===================================================================
Added: projects/docs/enterprise/5.0/Hibernate/Hibernate_Validator/ja-JP/Preface.po
===================================================================
--- projects/docs/enterprise/5.0/Hibernate/Hibernate_Validator/ja-JP/Preface.po (rev 0)
+++ projects/docs/enterprise/5.0/Hibernate/Hibernate_Validator/ja-JP/Preface.po 2009-11-26 05:06:44 UTC (rev 97007)
@@ -0,0 +1,56 @@
+#. Tag: title
+#: Preface.xml:7
+#, no-c-format
+msgid "Preface"
+msgstr ""
+
+#. Tag: para
+#: Preface.xml:9
+#, no-c-format
+msgid ""
+"Annotations are a very convenient and elegant way to specify invariant "
+"constraints for a domain model. You can, for example, express that a "
+"property should never be null, that the account balance should be strictly "
+"positive, etc. These domain model constraints are declared in the bean "
+"itself by annotating its properties. A validator can then read them and "
+"check for constraint violations. The validation mechanism can be executed in "
+"different layers in your application without having to duplicate any of "
+"these rules (presentation layer, data access layer). Following the DRY "
+"principle, Hibernate Validator has been designed for that purpose."
+msgstr ""
+
+#. Tag: para
+#: Preface.xml:20
+#, no-c-format
+msgid ""
+"Hibernate Validator works at two levels. First, it is able to check in-"
+"memory instances of a class for constraint violations. Second, it can apply "
+"the constraints to the Hibernate metamodel and incorporate them into the "
+"generated database schema."
+msgstr ""
+
+#. Tag: para
+#: Preface.xml:25
+#, no-c-format
+msgid ""
+"Each constraint annotation is associated to a validator implementation "
+"responsible for checking the constraint on the entity instance. A validator "
+"can also (optionally) apply the constraint to the Hibernate metamodel, "
+"allowing Hibernate to generate DDL that expresses the constraint. With the "
+"appropriate event listener, you can execute the checking operation on "
+"inserts and updates done by Hibernate. Hibernate Validator is not limited to "
+"use with Hibernate. You can easily use it anywhere in your application as "
+"well as with any Java Persistence provider (entity listener provided)."
+msgstr ""
+
+#. Tag: para
+#: Preface.xml:35
+#, no-c-format
+msgid ""
+"When checking instances at runtime, Hibernate Validator returns information "
+"about constraint violations in an array of <classname>InvalidValue</"
+"classname> s. Among other information, the <classname>InvalidValue</"
+"classname> contains an error description message that can embed the "
+"parameter values bundle with the annotation (eg. length limit), and message "
+"strings that may be externalized to a <classname>ResourceBundle</classname> ."
+msgstr ""
Added: projects/docs/enterprise/5.0/Hibernate/Hibernate_Validator/ja-JP/Revision_History.po
===================================================================
--- projects/docs/enterprise/5.0/Hibernate/Hibernate_Validator/ja-JP/Revision_History.po (rev 0)
+++ projects/docs/enterprise/5.0/Hibernate/Hibernate_Validator/ja-JP/Revision_History.po 2009-11-26 05:06:44 UTC (rev 97007)
@@ -0,0 +1,11 @@
+#. Tag: title
+#: Revision_History.xml:6
+#, no-c-format
+msgid "Revision History"
+msgstr ""
+
+#. Tag: author
+#: Revision_History.xml:12
+#, no-c-format
+msgid "<firstname></firstname> <surname></surname> <email></email>"
+msgstr ""
Added: projects/docs/enterprise/5.0/Hibernate/Hibernate_Validator/ja-JP/checkconstraints.po
===================================================================
--- projects/docs/enterprise/5.0/Hibernate/Hibernate_Validator/ja-JP/checkconstraints.po (rev 0)
+++ projects/docs/enterprise/5.0/Hibernate/Hibernate_Validator/ja-JP/checkconstraints.po 2009-11-26 05:06:44 UTC (rev 97007)
@@ -0,0 +1,370 @@
+#. Tag: title
+#: checkconstraints.xml:3
+#, no-c-format
+msgid "Using the Validator framework"
+msgstr ""
+
+#. Tag: para
+#: checkconstraints.xml:5
+#, no-c-format
+msgid ""
+"Hibernate Validator is intended to be used to implement multi-layered data "
+"validation, where constraints are expressed in a single place (the annotated "
+"domain model) and checked in various different layers of the application."
+msgstr ""
+
+#. Tag: para
+#: checkconstraints.xml:10
+#, no-c-format
+msgid "This chapter will cover Hibernate Validator usage for different layers"
+msgstr ""
+
+#. Tag: title
+#: checkconstraints.xml:14
+#, no-c-format
+msgid "Database schema-level validation"
+msgstr ""
+
+#. Tag: para
+#: checkconstraints.xml:16
+#, no-c-format
+msgid ""
+"Out of the box, Hibernate Annotations will translate the constraints you "
+"have defined for your entities into mapping metadata. For example, if a "
+"property of your entity is annotated <literal>@NotNull</literal>, its "
+"columns will be declared as <literal>not null</literal> in the DDL schema "
+"generated by Hibernate."
+msgstr ""
+
+#. Tag: para
+#: checkconstraints.xml:22
+#, no-c-format
+msgid ""
+"Using hbm2ddl, domain model constraints will be expressed into the database "
+"schema."
+msgstr ""
+
+#. Tag: para
+#: checkconstraints.xml:25
+#, no-c-format
+msgid ""
+"If, for some reason, the feature needs to be disabled, set "
+"<literal>hibernate.validator.apply_to_ddl</literal> to <literal>false</"
+"literal>."
+msgstr ""
+
+#. Tag: title
+#: checkconstraints.xml:31
+#, no-c-format
+msgid "ORM integration"
+msgstr ""
+
+#. Tag: para
+#: checkconstraints.xml:33
+#, no-c-format
+msgid ""
+"Hibernate Validator integrates with both Hibernate and all pure Java "
+"Persistence providers"
+msgstr ""
+
+#. Tag: title
+#: checkconstraints.xml:37
+#, no-c-format
+msgid "Hibernate event-based validation"
+msgstr ""
+
+#. Tag: para
+#: checkconstraints.xml:39
+#, no-c-format
+msgid ""
+"Hibernate Validator has two built-in Hibernate event listeners. Whenever a "
+"<literal>PreInsertEvent</literal> or <literal>PreUpdateEvent</literal> "
+"occurs, the listeners will verify all constraints of the entity instance and "
+"throw an exception if any constraint is violated. Basically, objects will be "
+"checked before any inserts and before any updates made by Hibernate. This "
+"includes changes applied by cascade! This is the most convenient and the "
+"easiest way to activate the validation process. On constraint violation, the "
+"event will raise a runtime <classname>InvalidStateException</classname> "
+"which contains an array of <literal>InvalidValue</literal>s describing each "
+"failure."
+msgstr ""
+
+#. Tag: para
+#: checkconstraints.xml:51
+#, no-c-format
+msgid ""
+"If Hibernate Validator is present in the classpath, Hibernate Annotations "
+"(or Hibernate EntityManager) will use it transparently. If, for some reason, "
+"you want to disable this integration, set <literal>hibernate.validator."
+"autoregister_listeners</literal> to false"
+msgstr ""
+
+#. Tag: para
+#: checkconstraints.xml:58
+#, no-c-format
+msgid ""
+"If the beans are not annotated with validation annotations, there is no "
+"runtime performance cost."
+msgstr ""
+
+#. Tag: para
+#: checkconstraints.xml:62
+#, no-c-format
+msgid ""
+"In case you need to manually set the event listeners for Hibernate Core, use "
+"the following configuration in <literal>hibernate.cfg.xml</literal>:"
+msgstr ""
+
+#. Tag: programlisting
+#: checkconstraints.xml:66
+#, no-c-format
+msgid ""
+"<hibernate-configuration>\n"
+" ...\n"
+" <event type=\"pre-update\">\n"
+" <listener \n"
+" class=\"org.hibernate.validator.event.ValidateEventListener\"/"
+">\n"
+" </event>\n"
+" <event type=\"pre-insert\">\n"
+" <listener \n"
+" class=\"org.hibernate.validator.event.ValidateEventListener\"/"
+">\n"
+" </event>\n"
+"</hibernate-configuration>"
+msgstr ""
+
+#. Tag: title
+#: checkconstraints.xml:70
+#, no-c-format
+msgid "Java Persistence event-based validation"
+msgstr ""
+
+#. Tag: para
+#: checkconstraints.xml:72
+#, no-c-format
+msgid ""
+"Hibernate Validator is not tied to Hibernate for event based validation: a "
+"Java Persistence entity listener is available. Whenever an listened entity "
+"is persisted or updated, Hibernate Validator will verify all constraints of "
+"the entity instance and throw an exception if any constraint is violated. "
+"Basically, objects will be checked before any inserts and before any updates "
+"made by the Java Persistence provider. This includes changes applied by "
+"cascade! On constraint violation, the event will raise a runtime "
+"<classname>InvalidStateException</classname> which contains an array of "
+"<literal>InvalidValue</literal>s describing each failure."
+msgstr ""
+
+#. Tag: para
+#: checkconstraints.xml:83
+#, no-c-format
+msgid "Here is how to make a class validatable:"
+msgstr ""
+
+#. Tag: programlisting
+#: checkconstraints.xml:85
+#, no-c-format
+msgid ""
+"@Entity\n"
+"@EntityListeners( JPAValidateListener.class )\n"
+"public class Submarine {\n"
+" ...\n"
+"}"
+msgstr ""
+
+#. Tag: para
+#: checkconstraints.xml:88
+#, no-c-format
+msgid ""
+"Compared to the Hibernate event, the Java Persistence listener has two "
+"drawbacks. You need to define the entity listener on every validatable "
+"entity. The DDL generated by your provider will not reflect the constraints."
+msgstr ""
+
+#. Tag: title
+#: checkconstraints.xml:97
+#, no-c-format
+msgid "Application-level validation"
+msgstr ""
+
+#. Tag: para
+#: checkconstraints.xml:99
+#, no-c-format
+msgid "Hibernate Validator can be applied anywhere in your application code."
+msgstr ""
+
+#. Tag: programlisting
+#: checkconstraints.xml:102
+#, no-c-format
+msgid ""
+"ClassValidator personValidator = new ClassValidator( Person.class );\n"
+"ClassValidator addressValidator = new ClassValidator( Address.class, "
+"ResourceBundle.getBundle(\"messages\", Locale.ENGLISH) );\n"
+"\n"
+"InvalidValue[] validationMessages = addressValidator.getInvalidValues"
+"(address);"
+msgstr ""
+
+#. Tag: para
+#: checkconstraints.xml:104
+#, no-c-format
+msgid ""
+"The first two lines prepare the Hibernate Validator for class checking. The "
+"first one relies upon the error messages embedded in Hibernate Validator "
+"(see <xref linkend=\"validator-defineconstraints-error\"/>), the second one "
+"uses a resource bundle for these messages. It is considered a good practice "
+"to execute these lines once and cache the validator instances."
+msgstr ""
+
+#. Tag: para
+#: checkconstraints.xml:111
+#, no-c-format
+msgid ""
+"The third line actually validates the <literal>Address</literal> instance "
+"and returns an array of <literal>InvalidValue</literal>s. Your application "
+"logic will then be able to react to the failure."
+msgstr ""
+
+#. Tag: para
+#: checkconstraints.xml:115
+#, no-c-format
+msgid ""
+"You can also check a particular property instead of the whole bean. This "
+"might be useful for property per property user interaction"
+msgstr ""
+
+#. Tag: programlisting
+#: checkconstraints.xml:118
+#, no-c-format
+msgid ""
+"ClassValidator addressValidator = new ClassValidator( Address.class, "
+"ResourceBundle.getBundle(\"messages\", Locale.ENGLISH) );\n"
+"\n"
+"//only get city property invalid values\n"
+"InvalidValue[] validationMessages = addressValidator.getInvalidValues"
+"(address, \"city\");\n"
+"\n"
+"//only get potential city property invalid values\n"
+"InvalidValue[] validationMessages = addressValidator."
+"getPotentialInvalidValues(\"city\", \"Paris\")"
+msgstr ""
+
+#. Tag: title
+#: checkconstraints.xml:122
+#, no-c-format
+msgid "Presentation layer validation"
+msgstr ""
+
+#. Tag: para
+#: checkconstraints.xml:124
+#, no-c-format
+msgid ""
+"When working with JSF and <productname>JBoss Seam</productname>, one can "
+"triggers the validation process at the presentation layer using Seam's JSF "
+"tags <literal><s:validate></literal> and <literal><s:validateAll/"
+"></literal>, letting the constraints be expressed on the model, and the "
+"violations presented in the view"
+msgstr ""
+
+#. Tag: programlisting
+#: checkconstraints.xml:130
+#, no-c-format
+msgid ""
+"<h:form>\n"
+" <div>\n"
+" <h:messages/>\n"
+" </div>\n"
+" <emphasis role=\"bold\"><s:validateAll></emphasis>\n"
+" <div>\n"
+" Country:\n"
+" <h:inputText value=\"#{location.country}\" required=\"true\"/"
+">\n"
+" </div>\n"
+" <div>\n"
+" Zip code:\n"
+" <h:inputText value=\"#{location.zip}\" required=\"true\"/"
+">\n"
+" </div>\n"
+" <div>\n"
+" <h:commandButton/>\n"
+" </div>\n"
+" <emphasis role=\"bold\"></s:validateAll></emphasis>\n"
+"</h:form>"
+msgstr ""
+
+#. Tag: para
+#: checkconstraints.xml:132
+#, no-c-format
+msgid ""
+"Going even further, and adding <productname>Ajax4JSF</productname> to the "
+"loop will bring client side validation with just a couple of additional JSF "
+"tags, again without validation definition duplication."
+msgstr ""
+
+#. Tag: para
+#: checkconstraints.xml:137
+#, no-c-format
+msgid ""
+"Check the <ulink url=\"http://www.jboss.com/products/seam\">JBoss Seam</"
+"ulink> documentation for more information."
+msgstr ""
+
+#. Tag: title
+#: checkconstraints.xml:142
+#, no-c-format
+msgid "Validation informations"
+msgstr ""
+
+#. Tag: para
+#: checkconstraints.xml:144
+#, no-c-format
+msgid ""
+"As a validation information carrier, hibernate provide an array of "
+"<classname>InvalidValue</classname>. Each <literal>InvalidValue</literal> "
+"has a buch of methods describing the individual issues."
+msgstr ""
+
+#. Tag: para
+#: checkconstraints.xml:148
+#, no-c-format
+msgid "<methodname>getBeanClass()</methodname> retrieves the failing bean type"
+msgstr ""
+
+#. Tag: para
+#: checkconstraints.xml:151
+#, no-c-format
+msgid ""
+"<methodname>getBean()</methodname>retrieves the failing instance (if any ie "
+"not when using <methodname>getPotentianInvalidValues()</methodname>)"
+msgstr ""
+
+#. Tag: para
+#: checkconstraints.xml:155
+#, no-c-format
+msgid "<methodname>getValue()</methodname> retrieves the failing value"
+msgstr ""
+
+#. Tag: para
+#: checkconstraints.xml:158
+#, no-c-format
+msgid ""
+"<methodname>getMessage()</methodname> retrieves the proper internationalized "
+"error message"
+msgstr ""
+
+#. Tag: para
+#: checkconstraints.xml:161
+#, no-c-format
+msgid ""
+"<methodname>getRootBean()</methodname> retrieves the root bean instance "
+"generating the issue (useful in conjunction with <literal>@Valid</literal>), "
+"is null if getPotentianInvalidValues() is used."
+msgstr ""
+
+#. Tag: para
+#: checkconstraints.xml:166
+#, no-c-format
+msgid ""
+"<literal>getPropertyPath()</literal> retrieves the dotted path of the "
+"failing property starting from the root bean"
+msgstr ""
Added: projects/docs/enterprise/5.0/Hibernate/Hibernate_Validator/ja-JP/defineconstraints.po
===================================================================
--- projects/docs/enterprise/5.0/Hibernate/Hibernate_Validator/ja-JP/defineconstraints.po (rev 0)
+++ projects/docs/enterprise/5.0/Hibernate/Hibernate_Validator/ja-JP/defineconstraints.po 2009-11-26 05:06:44 UTC (rev 97007)
@@ -0,0 +1,718 @@
+#. Tag: title
+#: defineconstraints.xml:3
+#, no-c-format
+msgid "Defining constraints"
+msgstr ""
+
+#. Tag: title
+#: defineconstraints.xml:6
+#, no-c-format
+msgid "What is a constraint?"
+msgstr ""
+
+#. Tag: para
+#: defineconstraints.xml:8
+#, no-c-format
+msgid ""
+"A constraint is a rule that a given element (field, property or bean) has to "
+"comply to. The rule semantic is expressed by an annotation. A constraint "
+"usually has some attributes used to parameterize the constraints limits. The "
+"constraint applies to the annotated element."
+msgstr ""
+
+#. Tag: title
+#: defineconstraints.xml:16
+#, no-c-format
+msgid "Built in constraints"
+msgstr ""
+
+#. Tag: para
+#: defineconstraints.xml:18
+#, no-c-format
+msgid ""
+"Hibernate Validator comes with some built-in constraints, which covers most "
+"basic data checks. As we'll see later, you're not limited to them, you can "
+"literally in a minute write your own constraints."
+msgstr ""
+
+#. Tag: title
+#: defineconstraints.xml:23
+#, no-c-format
+msgid "Built-in constraints"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:30
+#, no-c-format
+msgid "Annotation"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:32
+#, no-c-format
+msgid "Apply on"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:34
+#, no-c-format
+msgid "Runtime checking"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:36
+#, no-c-format
+msgid "Hibernate Metadata impact"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:42
+#, no-c-format
+msgid "@Length(min=, max=)"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:44 defineconstraints.xml:188
+#: defineconstraints.xml:199
+#, no-c-format
+msgid "property (String)"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:46
+#, no-c-format
+msgid "check if the string length match the range"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:48
+#, no-c-format
+msgid "Column length will be set to max"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:52
+#, no-c-format
+msgid "@Max(value=)"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:54 defineconstraints.xml:65 defineconstraints.xml:130
+#: defineconstraints.xml:210
+#, no-c-format
+msgid "property (numeric or string representation of a numeric)"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:57
+#, no-c-format
+msgid "check if the value is less than or equals to max"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:59 defineconstraints.xml:70 defineconstraints.xml:101
+#: defineconstraints.xml:136
+#, no-c-format
+msgid "Add a check constraint on the column"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:63
+#, no-c-format
+msgid "@Min(value=)"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:68
+#, no-c-format
+msgid "check if the value is more than or equals to min"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:74
+#, no-c-format
+msgid "@NotNull"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:76 defineconstraints.xml:86 defineconstraints.xml:153
+#: defineconstraints.xml:164
+#, no-c-format
+msgid "property"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:78
+#, no-c-format
+msgid "check if the value is not null"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:80
+#, no-c-format
+msgid "Column(s) are not null"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:84
+#, no-c-format
+msgid "@NotEmpty"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:88
+#, no-c-format
+msgid ""
+"check if the string is not null nor empty. Check if the connection is not "
+"null nor empty"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:91
+#, no-c-format
+msgid "Column(s) are not null (for String)"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:95
+#, no-c-format
+msgid "@Past"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:97 defineconstraints.xml:107
+#, no-c-format
+msgid "property (date or calendar)"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:99
+#, no-c-format
+msgid "check if the date is in the past"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:105
+#, no-c-format
+msgid "@Future"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:109
+#, no-c-format
+msgid "check if the date is in the future"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:111 defineconstraints.xml:124
+#: defineconstraints.xml:147 defineconstraints.xml:158
+#: defineconstraints.xml:169 defineconstraints.xml:182
+#: defineconstraints.xml:193 defineconstraints.xml:204
+#: defineconstraints.xml:228
+#, no-c-format
+msgid "none"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:115
+#, no-c-format
+msgid "@Pattern(regex=\"regexp\", flag=) or @Patterns( {@Pattern(...)} )"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:118 defineconstraints.xml:223
+#, no-c-format
+msgid "property (string)"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:120
+#, no-c-format
+msgid ""
+"check if the property match the regular expression given a match flag (see "
+"<classname>java.util.regex.Pattern </classname> )"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:128
+#, no-c-format
+msgid "@Range(min=, max=)"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:133
+#, no-c-format
+msgid "check if the value is between min and max (included)"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:140
+#, no-c-format
+msgid "@Size(min=, max=)"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:142
+#, no-c-format
+msgid "property (array, collection, map)"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:144
+#, no-c-format
+msgid "check if the element size is between min and max (included)"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:151
+#, no-c-format
+msgid "@AssertFalse"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:155
+#, no-c-format
+msgid ""
+"check that the method evaluates to false (useful for constraints expressed "
+"in code rather than annotations)"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:162
+#, no-c-format
+msgid "@AssertTrue"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:166
+#, no-c-format
+msgid ""
+"check that the method evaluates to true (useful for constraints expressed in "
+"code rather than annotations)"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:173
+#, no-c-format
+msgid "@Valid"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:175
+#, no-c-format
+msgid "property (object)"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:177
+#, no-c-format
+msgid ""
+"perform validation recursively on the associated object. If the object is a "
+"Collection or an array, the elements are validated recursively. If the "
+"object is a Map, the value elements are validated recursively."
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:186
+#, no-c-format
+msgid "@Email"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:190
+#, no-c-format
+msgid "check whether the string is conform to the email address specification"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:197
+#, no-c-format
+msgid "@CreditCardNumber"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:201
+#, no-c-format
+msgid ""
+"check whether the string is a well formated credit card number (derivative "
+"of the Luhn algorithm)"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:208
+#, no-c-format
+msgid "@Digits"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:213
+#, no-c-format
+msgid ""
+"check whether the property is a number having up to <literal>integerDigits</"
+"literal> integer digits and <literal>fractionalDigits</literal> fractonal "
+"digits"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:217
+#, no-c-format
+msgid "define column precision and scale"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:221
+#, no-c-format
+msgid "@EAN"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:225
+#, no-c-format
+msgid "check whether the string is a properly formated EAN or UPC-A code"
+msgstr ""
+
+#. Tag: title
+#: defineconstraints.xml:236
+#, no-c-format
+msgid "Error messages"
+msgstr ""
+
+#. Tag: para
+#: defineconstraints.xml:238
+#, no-c-format
+msgid ""
+"Hibernate Validator comes with a default set of error messages translated in "
+"about ten languages (if yours is not part of it, please sent us a patch). "
+"You can override those messages by creating a <filename>ValidatorMessages."
+"properties</filename> or ( <filename>ValidatorMessages_loc.properties</"
+"filename> ) and override the needed keys. You can even add your own "
+"additional set of messages while writing your validator annotations. If "
+"Hibernate Validator cannot resolve a key from your resourceBundle nor from "
+"ValidatorMessage, it falls back to the default built-in values."
+msgstr ""
+
+#. Tag: para
+#: defineconstraints.xml:248
+#, no-c-format
+msgid ""
+"Alternatively you can provide a <classname>ResourceBundle</classname> while "
+"checking programmatically the validation rules on a bean or if you want a "
+"completly different interpolation mechanism, you can provide an "
+"implementation of <literal>org.hibernate.validator.MessageInterpolator</"
+"literal> (check the JavaDoc for more informations)."
+msgstr ""
+
+#. Tag: title
+#: defineconstraints.xml:257
+#, no-c-format
+msgid "Writing your own constraints"
+msgstr ""
+
+#. Tag: para
+#: defineconstraints.xml:259
+#, no-c-format
+msgid ""
+"Extending the set of built-in constraints is extremely easy. Any constraint "
+"consists of two pieces: the constraint <emphasis>descriptor</emphasis> (the "
+"annotation) and the constraint <emphasis>validator</emphasis> (the "
+"implementation class). Here is a simple user-defined descriptor:"
+msgstr ""
+
+#. Tag: programlisting
+#: defineconstraints.xml:265
+#, no-c-format
+msgid ""
+"@ValidatorClass(CapitalizedValidator.class)\n"
+"@Target(METHOD)\n"
+"@Retention(RUNTIME)\n"
+"@Documented\n"
+"public @interface Capitalized {\n"
+" CapitalizeType type() default Capitalize.FIRST;\n"
+" String message() default \"has incorrect capitalization\"\n"
+"}"
+msgstr ""
+
+#. Tag: para
+#: defineconstraints.xml:267
+#, no-c-format
+msgid ""
+"<literal>type</literal> is a parameter describing how the property should to "
+"be capitalized. This is a user parameter fully dependant on the annotation "
+"business."
+msgstr ""
+
+#. Tag: para
+#: defineconstraints.xml:271
+#, no-c-format
+msgid ""
+"<literal>message</literal> is the default string used to describe the "
+"constraint violation and is mandatory. You can hard code the string or you "
+"can externalize part/all of it through the Java ResourceBundle mechanism. "
+"Parameters values are going to be injected inside the message when the "
+"<literal>{parameter}</literal> string is found (in our example "
+"<literal>Capitalization is not {type}</literal> would generate "
+"<literal>Capitalization is not FIRST</literal> ), externalizing the whole "
+"string in <filename>ValidatorMessages.properties</filename> is considered "
+"good practice. See <xref linkend=\"validator-defineconstraints-error\"/> ."
+msgstr ""
+
+#. Tag: programlisting
+#: defineconstraints.xml:282
+#, no-c-format
+msgid ""
+"@ValidatorClass(CapitalizedValidator.class)\n"
+"@Target(METHOD)\n"
+"@Retention(RUNTIME)\n"
+"@Documented\n"
+"public @interface Capitalized {\n"
+" CapitalizeType type() default Capitalize.FIRST;\n"
+" String message() default \"{validator.capitalized}\";\n"
+"}\n"
+"\n"
+"\n"
+"#in ValidatorMessages.properties\n"
+"validator.capitalized = <literal>Capitalization is not {type}</literal>"
+msgstr ""
+
+#. Tag: para
+#: defineconstraints.xml:284
+#, no-c-format
+msgid "As you can see the {} notation is recursive."
+msgstr ""
+
+#. Tag: para
+#: defineconstraints.xml:286
+#, no-c-format
+msgid ""
+"To link a descriptor to its validator implementation, we use the "
+"<literal>@ValidatorClass</literal> meta-annotation. The validator class "
+"parameter must name a class which implements <literal>Validator<"
+"ConstraintAnnotation></literal> ."
+msgstr ""
+
+#. Tag: para
+#: defineconstraints.xml:291
+#, no-c-format
+msgid ""
+"We now have to implement the validator (ie. the rule checking "
+"implementation). A validation implementation can check the value of the a "
+"property (by implementing <literal>PropertyConstraint</literal> ) and/or can "
+"modify the hibernate mapping metadata to express the constraint at the "
+"database level (by implementing <literal>PersistentClassConstraint</"
+"literal> )"
+msgstr ""
+
+#. Tag: programlisting
+#: defineconstraints.xml:298
+#, no-c-format
+msgid ""
+"public class CapitalizedValidator\n"
+" implements Validator<Capitalized>, PropertyConstraint {\n"
+" private CapitalizeType type;\n"
+"\n"
+" //part of the Validator<Annotation> contract,\n"
+" //allows to get and use the annotation values\n"
+" public void initialize(Capitalized parameters) {\n"
+" type = parameters.type();\n"
+" }\n"
+"\n"
+" //part of the property constraint contract\n"
+" public boolean isValid(Object value) {\n"
+" if (value==null) return true;\n"
+" if ( !(value instanceof String) ) return false;\n"
+" String string = (String) value;\n"
+" if (type == CapitalizeType.ALL) {\n"
+" return string.equals( string.toUpperCase() );\n"
+" }\n"
+" else {\n"
+" String first = string.substring(0,1);\n"
+" return first.equals( first.toUpperCase();\n"
+" }\n"
+" }\n"
+"}"
+msgstr ""
+
+#. Tag: para
+#: defineconstraints.xml:300
+#, no-c-format
+msgid ""
+"The <literal>isValid()</literal> method should return false if the "
+"constraint has been violated. For more examples, refer to the built-in "
+"validator implementations."
+msgstr ""
+
+#. Tag: para
+#: defineconstraints.xml:304
+#, no-c-format
+msgid ""
+"We only have seen property level validation, but you can write a Bean level "
+"validation annotation. Instead of receiving the return instance of a "
+"property, the bean itself will be passed to the validator. To activate the "
+"validation checking, just annotated the bean itself instead. A small sample "
+"can be found in the unit test suite."
+msgstr ""
+
+#. Tag: para
+#: defineconstraints.xml:310
+#, no-c-format
+msgid ""
+"If your constraint can be applied multiple times (with different parameters) "
+"on the same property or type, you can use the following annotation form:"
+msgstr ""
+
+#. Tag: programlisting
+#: defineconstraints.xml:314
+#, no-c-format
+msgid ""
+"@Target(METHOD)\n"
+"@Retention(RUNTIME)\n"
+"@Documented\n"
+"<emphasis role=\"bold\">public @interface Patterns {</emphasis>\n"
+" Pattern[] value();\n"
+"}\n"
+"\n"
+"@Target(METHOD)\n"
+"@Retention(RUNTIME)\n"
+"@Documented\n"
+"@ValidatorClass(PatternValidator.class)\n"
+"public @interface Pattern {\n"
+" String regexp();\n"
+"}"
+msgstr ""
+
+#. Tag: para
+#: defineconstraints.xml:316
+#, no-c-format
+msgid ""
+"Basically an annotation containing the value attribute as an array of "
+"validator annotations."
+msgstr ""
+
+#. Tag: title
+#: defineconstraints.xml:321
+#, no-c-format
+msgid "Annotating your domain model"
+msgstr ""
+
+#. Tag: para
+#: defineconstraints.xml:323
+#, no-c-format
+msgid ""
+"Since you are already familiar with annotations now, the syntax should be "
+"very familiar"
+msgstr ""
+
+#. Tag: programlisting
+#: defineconstraints.xml:326
+#, no-c-format
+msgid ""
+"public class Address {\n"
+" private String line1;\n"
+" private String line2;\n"
+" private String zip;\n"
+" private String state;\n"
+" private String country;\n"
+" private long id;\n"
+"\n"
+" // a not null string of 20 characters maximum\n"
+" @Length(max=20)\n"
+" @NotNull\n"
+" public String getCountry() {\n"
+" return country;\n"
+" }\n"
+"\n"
+" // a non null string\n"
+" @NotNull\n"
+" public String getLine1() {\n"
+" return line1;\n"
+" }\n"
+"\n"
+" //no constraint\n"
+" public String getLine2() {\n"
+" return line2;\n"
+" }\n"
+"\n"
+" // a not null string of 3 characters maximum\n"
+" @Length(max=3) @NotNull\n"
+" public String getState() {\n"
+" return state;\n"
+" }\n"
+"\n"
+" // a not null numeric string of 5 characters maximum\n"
+" // if the string is longer, the message will\n"
+" //be searched in the resource bundle at key 'long'\n"
+" @Length(max=5, message=\"{long}\")\n"
+" @Pattern(regex=\"[0-9]+\")\n"
+" @NotNull\n"
+" public String getZip() {\n"
+" return zip;\n"
+" }\n"
+"\n"
+" // should always be true\n"
+" @AssertTrue\n"
+" public boolean isValid() {\n"
+" return true;\n"
+" }\n"
+"\n"
+" // a numeric between 1 and 2000\n"
+" @Id @Min(1)\n"
+" @Range(max=2000)\n"
+" public long getId() {\n"
+" return id;\n"
+" }\n"
+"}"
+msgstr ""
+
+#. Tag: para
+#: defineconstraints.xml:328
+#, no-c-format
+msgid ""
+"While the example only shows public property validation, you can also "
+"annotate fields of any kind of visibility"
+msgstr ""
+
+#. Tag: programlisting
+#: defineconstraints.xml:331
+#, no-c-format
+msgid ""
+"@MyBeanConstraint(max=45\n"
+"public class Dog {\n"
+" @AssertTrue private boolean isMale;\n"
+" @NotNull protected String getName() { ... };\n"
+" ...\n"
+"}"
+msgstr ""
+
+#. Tag: para
+#: defineconstraints.xml:333
+#, no-c-format
+msgid ""
+"You can also annotate interfaces. Hibernate Validator will check all "
+"superclasses and interfaces extended or implemented by a given bean to read "
+"the appropriate validator annotations."
+msgstr ""
+
+#. Tag: programlisting
+#: defineconstraints.xml:337
+#, no-c-format
+msgid ""
+"public interface Named {\n"
+" @NotNull String getName();\n"
+" ...\n"
+"}\n"
+"\n"
+"public class Dog implements Named {\n"
+"\n"
+" @AssertTrue private boolean isMale;\n"
+"\n"
+" public String getName() { ... };\n"
+"\n"
+"}"
+msgstr ""
+
+#. Tag: para
+#: defineconstraints.xml:339
+#, no-c-format
+msgid ""
+"The name property will be checked for nullity when the Dog bean is validated."
+msgstr ""
Added: projects/docs/enterprise/5.0/Hibernate/Hibernate_Validator/pt-BR/Author_Group.po
===================================================================
--- projects/docs/enterprise/5.0/Hibernate/Hibernate_Validator/pt-BR/Author_Group.po (rev 0)
+++ projects/docs/enterprise/5.0/Hibernate/Hibernate_Validator/pt-BR/Author_Group.po 2009-11-26 05:06:44 UTC (rev 97007)
@@ -0,0 +1,5 @@
+#. Tag: author
+#: Author_Group.xml:6
+#, no-c-format
+msgid "<firstname>Red Hat Documentation Group</firstname> <surname></surname>"
+msgstr ""
Added: projects/docs/enterprise/5.0/Hibernate/Hibernate_Validator/pt-BR/Book_Info.po
===================================================================
--- projects/docs/enterprise/5.0/Hibernate/Hibernate_Validator/pt-BR/Book_Info.po (rev 0)
+++ projects/docs/enterprise/5.0/Hibernate/Hibernate_Validator/pt-BR/Book_Info.po 2009-11-26 05:06:44 UTC (rev 97007)
@@ -0,0 +1,25 @@
+#. Tag: title
+#: Book_Info.xml:6
+#, no-c-format
+msgid "Hibernate Validator Reference Guide"
+msgstr ""
+
+#. Tag: subtitle
+#: Book_Info.xml:7
+#, no-c-format
+msgid "for Use with JBoss Enterprise Application Platform 5.0"
+msgstr ""
+
+#. Tag: para
+#: Book_Info.xml:14
+#, no-c-format
+msgid ""
+"The JBoss Enterprise Application Platform Edition of the Hibernate Validator "
+"Reference Guide"
+msgstr ""
+
+#. Tag: holder
+#: Book_Info.xml:25
+#, no-c-format
+msgid "&HOLDER;"
+msgstr ""
Added: projects/docs/enterprise/5.0/Hibernate/Hibernate_Validator/pt-BR/Hibernate_Validator_Reference_Guide.po
===================================================================
Added: projects/docs/enterprise/5.0/Hibernate/Hibernate_Validator/pt-BR/Preface.po
===================================================================
--- projects/docs/enterprise/5.0/Hibernate/Hibernate_Validator/pt-BR/Preface.po (rev 0)
+++ projects/docs/enterprise/5.0/Hibernate/Hibernate_Validator/pt-BR/Preface.po 2009-11-26 05:06:44 UTC (rev 97007)
@@ -0,0 +1,56 @@
+#. Tag: title
+#: Preface.xml:7
+#, no-c-format
+msgid "Preface"
+msgstr ""
+
+#. Tag: para
+#: Preface.xml:9
+#, no-c-format
+msgid ""
+"Annotations are a very convenient and elegant way to specify invariant "
+"constraints for a domain model. You can, for example, express that a "
+"property should never be null, that the account balance should be strictly "
+"positive, etc. These domain model constraints are declared in the bean "
+"itself by annotating its properties. A validator can then read them and "
+"check for constraint violations. The validation mechanism can be executed in "
+"different layers in your application without having to duplicate any of "
+"these rules (presentation layer, data access layer). Following the DRY "
+"principle, Hibernate Validator has been designed for that purpose."
+msgstr ""
+
+#. Tag: para
+#: Preface.xml:20
+#, no-c-format
+msgid ""
+"Hibernate Validator works at two levels. First, it is able to check in-"
+"memory instances of a class for constraint violations. Second, it can apply "
+"the constraints to the Hibernate metamodel and incorporate them into the "
+"generated database schema."
+msgstr ""
+
+#. Tag: para
+#: Preface.xml:25
+#, no-c-format
+msgid ""
+"Each constraint annotation is associated to a validator implementation "
+"responsible for checking the constraint on the entity instance. A validator "
+"can also (optionally) apply the constraint to the Hibernate metamodel, "
+"allowing Hibernate to generate DDL that expresses the constraint. With the "
+"appropriate event listener, you can execute the checking operation on "
+"inserts and updates done by Hibernate. Hibernate Validator is not limited to "
+"use with Hibernate. You can easily use it anywhere in your application as "
+"well as with any Java Persistence provider (entity listener provided)."
+msgstr ""
+
+#. Tag: para
+#: Preface.xml:35
+#, no-c-format
+msgid ""
+"When checking instances at runtime, Hibernate Validator returns information "
+"about constraint violations in an array of <classname>InvalidValue</"
+"classname> s. Among other information, the <classname>InvalidValue</"
+"classname> contains an error description message that can embed the "
+"parameter values bundle with the annotation (eg. length limit), and message "
+"strings that may be externalized to a <classname>ResourceBundle</classname> ."
+msgstr ""
Added: projects/docs/enterprise/5.0/Hibernate/Hibernate_Validator/pt-BR/Revision_History.po
===================================================================
--- projects/docs/enterprise/5.0/Hibernate/Hibernate_Validator/pt-BR/Revision_History.po (rev 0)
+++ projects/docs/enterprise/5.0/Hibernate/Hibernate_Validator/pt-BR/Revision_History.po 2009-11-26 05:06:44 UTC (rev 97007)
@@ -0,0 +1,11 @@
+#. Tag: title
+#: Revision_History.xml:6
+#, no-c-format
+msgid "Revision History"
+msgstr ""
+
+#. Tag: author
+#: Revision_History.xml:12
+#, no-c-format
+msgid "<firstname></firstname> <surname></surname> <email></email>"
+msgstr ""
Added: projects/docs/enterprise/5.0/Hibernate/Hibernate_Validator/pt-BR/checkconstraints.po
===================================================================
--- projects/docs/enterprise/5.0/Hibernate/Hibernate_Validator/pt-BR/checkconstraints.po (rev 0)
+++ projects/docs/enterprise/5.0/Hibernate/Hibernate_Validator/pt-BR/checkconstraints.po 2009-11-26 05:06:44 UTC (rev 97007)
@@ -0,0 +1,370 @@
+#. Tag: title
+#: checkconstraints.xml:3
+#, no-c-format
+msgid "Using the Validator framework"
+msgstr ""
+
+#. Tag: para
+#: checkconstraints.xml:5
+#, no-c-format
+msgid ""
+"Hibernate Validator is intended to be used to implement multi-layered data "
+"validation, where constraints are expressed in a single place (the annotated "
+"domain model) and checked in various different layers of the application."
+msgstr ""
+
+#. Tag: para
+#: checkconstraints.xml:10
+#, no-c-format
+msgid "This chapter will cover Hibernate Validator usage for different layers"
+msgstr ""
+
+#. Tag: title
+#: checkconstraints.xml:14
+#, no-c-format
+msgid "Database schema-level validation"
+msgstr ""
+
+#. Tag: para
+#: checkconstraints.xml:16
+#, no-c-format
+msgid ""
+"Out of the box, Hibernate Annotations will translate the constraints you "
+"have defined for your entities into mapping metadata. For example, if a "
+"property of your entity is annotated <literal>@NotNull</literal>, its "
+"columns will be declared as <literal>not null</literal> in the DDL schema "
+"generated by Hibernate."
+msgstr ""
+
+#. Tag: para
+#: checkconstraints.xml:22
+#, no-c-format
+msgid ""
+"Using hbm2ddl, domain model constraints will be expressed into the database "
+"schema."
+msgstr ""
+
+#. Tag: para
+#: checkconstraints.xml:25
+#, no-c-format
+msgid ""
+"If, for some reason, the feature needs to be disabled, set "
+"<literal>hibernate.validator.apply_to_ddl</literal> to <literal>false</"
+"literal>."
+msgstr ""
+
+#. Tag: title
+#: checkconstraints.xml:31
+#, no-c-format
+msgid "ORM integration"
+msgstr ""
+
+#. Tag: para
+#: checkconstraints.xml:33
+#, no-c-format
+msgid ""
+"Hibernate Validator integrates with both Hibernate and all pure Java "
+"Persistence providers"
+msgstr ""
+
+#. Tag: title
+#: checkconstraints.xml:37
+#, no-c-format
+msgid "Hibernate event-based validation"
+msgstr ""
+
+#. Tag: para
+#: checkconstraints.xml:39
+#, no-c-format
+msgid ""
+"Hibernate Validator has two built-in Hibernate event listeners. Whenever a "
+"<literal>PreInsertEvent</literal> or <literal>PreUpdateEvent</literal> "
+"occurs, the listeners will verify all constraints of the entity instance and "
+"throw an exception if any constraint is violated. Basically, objects will be "
+"checked before any inserts and before any updates made by Hibernate. This "
+"includes changes applied by cascade! This is the most convenient and the "
+"easiest way to activate the validation process. On constraint violation, the "
+"event will raise a runtime <classname>InvalidStateException</classname> "
+"which contains an array of <literal>InvalidValue</literal>s describing each "
+"failure."
+msgstr ""
+
+#. Tag: para
+#: checkconstraints.xml:51
+#, no-c-format
+msgid ""
+"If Hibernate Validator is present in the classpath, Hibernate Annotations "
+"(or Hibernate EntityManager) will use it transparently. If, for some reason, "
+"you want to disable this integration, set <literal>hibernate.validator."
+"autoregister_listeners</literal> to false"
+msgstr ""
+
+#. Tag: para
+#: checkconstraints.xml:58
+#, no-c-format
+msgid ""
+"If the beans are not annotated with validation annotations, there is no "
+"runtime performance cost."
+msgstr ""
+
+#. Tag: para
+#: checkconstraints.xml:62
+#, no-c-format
+msgid ""
+"In case you need to manually set the event listeners for Hibernate Core, use "
+"the following configuration in <literal>hibernate.cfg.xml</literal>:"
+msgstr ""
+
+#. Tag: programlisting
+#: checkconstraints.xml:66
+#, no-c-format
+msgid ""
+"<hibernate-configuration>\n"
+" ...\n"
+" <event type=\"pre-update\">\n"
+" <listener \n"
+" class=\"org.hibernate.validator.event.ValidateEventListener\"/"
+">\n"
+" </event>\n"
+" <event type=\"pre-insert\">\n"
+" <listener \n"
+" class=\"org.hibernate.validator.event.ValidateEventListener\"/"
+">\n"
+" </event>\n"
+"</hibernate-configuration>"
+msgstr ""
+
+#. Tag: title
+#: checkconstraints.xml:70
+#, no-c-format
+msgid "Java Persistence event-based validation"
+msgstr ""
+
+#. Tag: para
+#: checkconstraints.xml:72
+#, no-c-format
+msgid ""
+"Hibernate Validator is not tied to Hibernate for event based validation: a "
+"Java Persistence entity listener is available. Whenever an listened entity "
+"is persisted or updated, Hibernate Validator will verify all constraints of "
+"the entity instance and throw an exception if any constraint is violated. "
+"Basically, objects will be checked before any inserts and before any updates "
+"made by the Java Persistence provider. This includes changes applied by "
+"cascade! On constraint violation, the event will raise a runtime "
+"<classname>InvalidStateException</classname> which contains an array of "
+"<literal>InvalidValue</literal>s describing each failure."
+msgstr ""
+
+#. Tag: para
+#: checkconstraints.xml:83
+#, no-c-format
+msgid "Here is how to make a class validatable:"
+msgstr ""
+
+#. Tag: programlisting
+#: checkconstraints.xml:85
+#, no-c-format
+msgid ""
+"@Entity\n"
+"@EntityListeners( JPAValidateListener.class )\n"
+"public class Submarine {\n"
+" ...\n"
+"}"
+msgstr ""
+
+#. Tag: para
+#: checkconstraints.xml:88
+#, no-c-format
+msgid ""
+"Compared to the Hibernate event, the Java Persistence listener has two "
+"drawbacks. You need to define the entity listener on every validatable "
+"entity. The DDL generated by your provider will not reflect the constraints."
+msgstr ""
+
+#. Tag: title
+#: checkconstraints.xml:97
+#, no-c-format
+msgid "Application-level validation"
+msgstr ""
+
+#. Tag: para
+#: checkconstraints.xml:99
+#, no-c-format
+msgid "Hibernate Validator can be applied anywhere in your application code."
+msgstr ""
+
+#. Tag: programlisting
+#: checkconstraints.xml:102
+#, no-c-format
+msgid ""
+"ClassValidator personValidator = new ClassValidator( Person.class );\n"
+"ClassValidator addressValidator = new ClassValidator( Address.class, "
+"ResourceBundle.getBundle(\"messages\", Locale.ENGLISH) );\n"
+"\n"
+"InvalidValue[] validationMessages = addressValidator.getInvalidValues"
+"(address);"
+msgstr ""
+
+#. Tag: para
+#: checkconstraints.xml:104
+#, no-c-format
+msgid ""
+"The first two lines prepare the Hibernate Validator for class checking. The "
+"first one relies upon the error messages embedded in Hibernate Validator "
+"(see <xref linkend=\"validator-defineconstraints-error\"/>), the second one "
+"uses a resource bundle for these messages. It is considered a good practice "
+"to execute these lines once and cache the validator instances."
+msgstr ""
+
+#. Tag: para
+#: checkconstraints.xml:111
+#, no-c-format
+msgid ""
+"The third line actually validates the <literal>Address</literal> instance "
+"and returns an array of <literal>InvalidValue</literal>s. Your application "
+"logic will then be able to react to the failure."
+msgstr ""
+
+#. Tag: para
+#: checkconstraints.xml:115
+#, no-c-format
+msgid ""
+"You can also check a particular property instead of the whole bean. This "
+"might be useful for property per property user interaction"
+msgstr ""
+
+#. Tag: programlisting
+#: checkconstraints.xml:118
+#, no-c-format
+msgid ""
+"ClassValidator addressValidator = new ClassValidator( Address.class, "
+"ResourceBundle.getBundle(\"messages\", Locale.ENGLISH) );\n"
+"\n"
+"//only get city property invalid values\n"
+"InvalidValue[] validationMessages = addressValidator.getInvalidValues"
+"(address, \"city\");\n"
+"\n"
+"//only get potential city property invalid values\n"
+"InvalidValue[] validationMessages = addressValidator."
+"getPotentialInvalidValues(\"city\", \"Paris\")"
+msgstr ""
+
+#. Tag: title
+#: checkconstraints.xml:122
+#, no-c-format
+msgid "Presentation layer validation"
+msgstr ""
+
+#. Tag: para
+#: checkconstraints.xml:124
+#, no-c-format
+msgid ""
+"When working with JSF and <productname>JBoss Seam</productname>, one can "
+"triggers the validation process at the presentation layer using Seam's JSF "
+"tags <literal><s:validate></literal> and <literal><s:validateAll/"
+"></literal>, letting the constraints be expressed on the model, and the "
+"violations presented in the view"
+msgstr ""
+
+#. Tag: programlisting
+#: checkconstraints.xml:130
+#, no-c-format
+msgid ""
+"<h:form>\n"
+" <div>\n"
+" <h:messages/>\n"
+" </div>\n"
+" <emphasis role=\"bold\"><s:validateAll></emphasis>\n"
+" <div>\n"
+" Country:\n"
+" <h:inputText value=\"#{location.country}\" required=\"true\"/"
+">\n"
+" </div>\n"
+" <div>\n"
+" Zip code:\n"
+" <h:inputText value=\"#{location.zip}\" required=\"true\"/"
+">\n"
+" </div>\n"
+" <div>\n"
+" <h:commandButton/>\n"
+" </div>\n"
+" <emphasis role=\"bold\"></s:validateAll></emphasis>\n"
+"</h:form>"
+msgstr ""
+
+#. Tag: para
+#: checkconstraints.xml:132
+#, no-c-format
+msgid ""
+"Going even further, and adding <productname>Ajax4JSF</productname> to the "
+"loop will bring client side validation with just a couple of additional JSF "
+"tags, again without validation definition duplication."
+msgstr ""
+
+#. Tag: para
+#: checkconstraints.xml:137
+#, no-c-format
+msgid ""
+"Check the <ulink url=\"http://www.jboss.com/products/seam\">JBoss Seam</"
+"ulink> documentation for more information."
+msgstr ""
+
+#. Tag: title
+#: checkconstraints.xml:142
+#, no-c-format
+msgid "Validation informations"
+msgstr ""
+
+#. Tag: para
+#: checkconstraints.xml:144
+#, no-c-format
+msgid ""
+"As a validation information carrier, hibernate provide an array of "
+"<classname>InvalidValue</classname>. Each <literal>InvalidValue</literal> "
+"has a buch of methods describing the individual issues."
+msgstr ""
+
+#. Tag: para
+#: checkconstraints.xml:148
+#, no-c-format
+msgid "<methodname>getBeanClass()</methodname> retrieves the failing bean type"
+msgstr ""
+
+#. Tag: para
+#: checkconstraints.xml:151
+#, no-c-format
+msgid ""
+"<methodname>getBean()</methodname>retrieves the failing instance (if any ie "
+"not when using <methodname>getPotentianInvalidValues()</methodname>)"
+msgstr ""
+
+#. Tag: para
+#: checkconstraints.xml:155
+#, no-c-format
+msgid "<methodname>getValue()</methodname> retrieves the failing value"
+msgstr ""
+
+#. Tag: para
+#: checkconstraints.xml:158
+#, no-c-format
+msgid ""
+"<methodname>getMessage()</methodname> retrieves the proper internationalized "
+"error message"
+msgstr ""
+
+#. Tag: para
+#: checkconstraints.xml:161
+#, no-c-format
+msgid ""
+"<methodname>getRootBean()</methodname> retrieves the root bean instance "
+"generating the issue (useful in conjunction with <literal>@Valid</literal>), "
+"is null if getPotentianInvalidValues() is used."
+msgstr ""
+
+#. Tag: para
+#: checkconstraints.xml:166
+#, no-c-format
+msgid ""
+"<literal>getPropertyPath()</literal> retrieves the dotted path of the "
+"failing property starting from the root bean"
+msgstr ""
Added: projects/docs/enterprise/5.0/Hibernate/Hibernate_Validator/pt-BR/defineconstraints.po
===================================================================
--- projects/docs/enterprise/5.0/Hibernate/Hibernate_Validator/pt-BR/defineconstraints.po (rev 0)
+++ projects/docs/enterprise/5.0/Hibernate/Hibernate_Validator/pt-BR/defineconstraints.po 2009-11-26 05:06:44 UTC (rev 97007)
@@ -0,0 +1,718 @@
+#. Tag: title
+#: defineconstraints.xml:3
+#, no-c-format
+msgid "Defining constraints"
+msgstr ""
+
+#. Tag: title
+#: defineconstraints.xml:6
+#, no-c-format
+msgid "What is a constraint?"
+msgstr ""
+
+#. Tag: para
+#: defineconstraints.xml:8
+#, no-c-format
+msgid ""
+"A constraint is a rule that a given element (field, property or bean) has to "
+"comply to. The rule semantic is expressed by an annotation. A constraint "
+"usually has some attributes used to parameterize the constraints limits. The "
+"constraint applies to the annotated element."
+msgstr ""
+
+#. Tag: title
+#: defineconstraints.xml:16
+#, no-c-format
+msgid "Built in constraints"
+msgstr ""
+
+#. Tag: para
+#: defineconstraints.xml:18
+#, no-c-format
+msgid ""
+"Hibernate Validator comes with some built-in constraints, which covers most "
+"basic data checks. As we'll see later, you're not limited to them, you can "
+"literally in a minute write your own constraints."
+msgstr ""
+
+#. Tag: title
+#: defineconstraints.xml:23
+#, no-c-format
+msgid "Built-in constraints"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:30
+#, no-c-format
+msgid "Annotation"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:32
+#, no-c-format
+msgid "Apply on"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:34
+#, no-c-format
+msgid "Runtime checking"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:36
+#, no-c-format
+msgid "Hibernate Metadata impact"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:42
+#, no-c-format
+msgid "@Length(min=, max=)"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:44 defineconstraints.xml:188
+#: defineconstraints.xml:199
+#, no-c-format
+msgid "property (String)"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:46
+#, no-c-format
+msgid "check if the string length match the range"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:48
+#, no-c-format
+msgid "Column length will be set to max"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:52
+#, no-c-format
+msgid "@Max(value=)"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:54 defineconstraints.xml:65 defineconstraints.xml:130
+#: defineconstraints.xml:210
+#, no-c-format
+msgid "property (numeric or string representation of a numeric)"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:57
+#, no-c-format
+msgid "check if the value is less than or equals to max"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:59 defineconstraints.xml:70 defineconstraints.xml:101
+#: defineconstraints.xml:136
+#, no-c-format
+msgid "Add a check constraint on the column"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:63
+#, no-c-format
+msgid "@Min(value=)"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:68
+#, no-c-format
+msgid "check if the value is more than or equals to min"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:74
+#, no-c-format
+msgid "@NotNull"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:76 defineconstraints.xml:86 defineconstraints.xml:153
+#: defineconstraints.xml:164
+#, no-c-format
+msgid "property"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:78
+#, no-c-format
+msgid "check if the value is not null"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:80
+#, no-c-format
+msgid "Column(s) are not null"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:84
+#, no-c-format
+msgid "@NotEmpty"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:88
+#, no-c-format
+msgid ""
+"check if the string is not null nor empty. Check if the connection is not "
+"null nor empty"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:91
+#, no-c-format
+msgid "Column(s) are not null (for String)"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:95
+#, no-c-format
+msgid "@Past"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:97 defineconstraints.xml:107
+#, no-c-format
+msgid "property (date or calendar)"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:99
+#, no-c-format
+msgid "check if the date is in the past"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:105
+#, no-c-format
+msgid "@Future"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:109
+#, no-c-format
+msgid "check if the date is in the future"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:111 defineconstraints.xml:124
+#: defineconstraints.xml:147 defineconstraints.xml:158
+#: defineconstraints.xml:169 defineconstraints.xml:182
+#: defineconstraints.xml:193 defineconstraints.xml:204
+#: defineconstraints.xml:228
+#, no-c-format
+msgid "none"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:115
+#, no-c-format
+msgid "@Pattern(regex=\"regexp\", flag=) or @Patterns( {@Pattern(...)} )"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:118 defineconstraints.xml:223
+#, no-c-format
+msgid "property (string)"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:120
+#, no-c-format
+msgid ""
+"check if the property match the regular expression given a match flag (see "
+"<classname>java.util.regex.Pattern </classname> )"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:128
+#, no-c-format
+msgid "@Range(min=, max=)"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:133
+#, no-c-format
+msgid "check if the value is between min and max (included)"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:140
+#, no-c-format
+msgid "@Size(min=, max=)"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:142
+#, no-c-format
+msgid "property (array, collection, map)"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:144
+#, no-c-format
+msgid "check if the element size is between min and max (included)"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:151
+#, no-c-format
+msgid "@AssertFalse"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:155
+#, no-c-format
+msgid ""
+"check that the method evaluates to false (useful for constraints expressed "
+"in code rather than annotations)"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:162
+#, no-c-format
+msgid "@AssertTrue"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:166
+#, no-c-format
+msgid ""
+"check that the method evaluates to true (useful for constraints expressed in "
+"code rather than annotations)"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:173
+#, no-c-format
+msgid "@Valid"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:175
+#, no-c-format
+msgid "property (object)"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:177
+#, no-c-format
+msgid ""
+"perform validation recursively on the associated object. If the object is a "
+"Collection or an array, the elements are validated recursively. If the "
+"object is a Map, the value elements are validated recursively."
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:186
+#, no-c-format
+msgid "@Email"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:190
+#, no-c-format
+msgid "check whether the string is conform to the email address specification"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:197
+#, no-c-format
+msgid "@CreditCardNumber"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:201
+#, no-c-format
+msgid ""
+"check whether the string is a well formated credit card number (derivative "
+"of the Luhn algorithm)"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:208
+#, no-c-format
+msgid "@Digits"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:213
+#, no-c-format
+msgid ""
+"check whether the property is a number having up to <literal>integerDigits</"
+"literal> integer digits and <literal>fractionalDigits</literal> fractonal "
+"digits"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:217
+#, no-c-format
+msgid "define column precision and scale"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:221
+#, no-c-format
+msgid "@EAN"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:225
+#, no-c-format
+msgid "check whether the string is a properly formated EAN or UPC-A code"
+msgstr ""
+
+#. Tag: title
+#: defineconstraints.xml:236
+#, no-c-format
+msgid "Error messages"
+msgstr ""
+
+#. Tag: para
+#: defineconstraints.xml:238
+#, no-c-format
+msgid ""
+"Hibernate Validator comes with a default set of error messages translated in "
+"about ten languages (if yours is not part of it, please sent us a patch). "
+"You can override those messages by creating a <filename>ValidatorMessages."
+"properties</filename> or ( <filename>ValidatorMessages_loc.properties</"
+"filename> ) and override the needed keys. You can even add your own "
+"additional set of messages while writing your validator annotations. If "
+"Hibernate Validator cannot resolve a key from your resourceBundle nor from "
+"ValidatorMessage, it falls back to the default built-in values."
+msgstr ""
+
+#. Tag: para
+#: defineconstraints.xml:248
+#, no-c-format
+msgid ""
+"Alternatively you can provide a <classname>ResourceBundle</classname> while "
+"checking programmatically the validation rules on a bean or if you want a "
+"completly different interpolation mechanism, you can provide an "
+"implementation of <literal>org.hibernate.validator.MessageInterpolator</"
+"literal> (check the JavaDoc for more informations)."
+msgstr ""
+
+#. Tag: title
+#: defineconstraints.xml:257
+#, no-c-format
+msgid "Writing your own constraints"
+msgstr ""
+
+#. Tag: para
+#: defineconstraints.xml:259
+#, no-c-format
+msgid ""
+"Extending the set of built-in constraints is extremely easy. Any constraint "
+"consists of two pieces: the constraint <emphasis>descriptor</emphasis> (the "
+"annotation) and the constraint <emphasis>validator</emphasis> (the "
+"implementation class). Here is a simple user-defined descriptor:"
+msgstr ""
+
+#. Tag: programlisting
+#: defineconstraints.xml:265
+#, no-c-format
+msgid ""
+"@ValidatorClass(CapitalizedValidator.class)\n"
+"@Target(METHOD)\n"
+"@Retention(RUNTIME)\n"
+"@Documented\n"
+"public @interface Capitalized {\n"
+" CapitalizeType type() default Capitalize.FIRST;\n"
+" String message() default \"has incorrect capitalization\"\n"
+"}"
+msgstr ""
+
+#. Tag: para
+#: defineconstraints.xml:267
+#, no-c-format
+msgid ""
+"<literal>type</literal> is a parameter describing how the property should to "
+"be capitalized. This is a user parameter fully dependant on the annotation "
+"business."
+msgstr ""
+
+#. Tag: para
+#: defineconstraints.xml:271
+#, no-c-format
+msgid ""
+"<literal>message</literal> is the default string used to describe the "
+"constraint violation and is mandatory. You can hard code the string or you "
+"can externalize part/all of it through the Java ResourceBundle mechanism. "
+"Parameters values are going to be injected inside the message when the "
+"<literal>{parameter}</literal> string is found (in our example "
+"<literal>Capitalization is not {type}</literal> would generate "
+"<literal>Capitalization is not FIRST</literal> ), externalizing the whole "
+"string in <filename>ValidatorMessages.properties</filename> is considered "
+"good practice. See <xref linkend=\"validator-defineconstraints-error\"/> ."
+msgstr ""
+
+#. Tag: programlisting
+#: defineconstraints.xml:282
+#, no-c-format
+msgid ""
+"@ValidatorClass(CapitalizedValidator.class)\n"
+"@Target(METHOD)\n"
+"@Retention(RUNTIME)\n"
+"@Documented\n"
+"public @interface Capitalized {\n"
+" CapitalizeType type() default Capitalize.FIRST;\n"
+" String message() default \"{validator.capitalized}\";\n"
+"}\n"
+"\n"
+"\n"
+"#in ValidatorMessages.properties\n"
+"validator.capitalized = <literal>Capitalization is not {type}</literal>"
+msgstr ""
+
+#. Tag: para
+#: defineconstraints.xml:284
+#, no-c-format
+msgid "As you can see the {} notation is recursive."
+msgstr ""
+
+#. Tag: para
+#: defineconstraints.xml:286
+#, no-c-format
+msgid ""
+"To link a descriptor to its validator implementation, we use the "
+"<literal>@ValidatorClass</literal> meta-annotation. The validator class "
+"parameter must name a class which implements <literal>Validator<"
+"ConstraintAnnotation></literal> ."
+msgstr ""
+
+#. Tag: para
+#: defineconstraints.xml:291
+#, no-c-format
+msgid ""
+"We now have to implement the validator (ie. the rule checking "
+"implementation). A validation implementation can check the value of the a "
+"property (by implementing <literal>PropertyConstraint</literal> ) and/or can "
+"modify the hibernate mapping metadata to express the constraint at the "
+"database level (by implementing <literal>PersistentClassConstraint</"
+"literal> )"
+msgstr ""
+
+#. Tag: programlisting
+#: defineconstraints.xml:298
+#, no-c-format
+msgid ""
+"public class CapitalizedValidator\n"
+" implements Validator<Capitalized>, PropertyConstraint {\n"
+" private CapitalizeType type;\n"
+"\n"
+" //part of the Validator<Annotation> contract,\n"
+" //allows to get and use the annotation values\n"
+" public void initialize(Capitalized parameters) {\n"
+" type = parameters.type();\n"
+" }\n"
+"\n"
+" //part of the property constraint contract\n"
+" public boolean isValid(Object value) {\n"
+" if (value==null) return true;\n"
+" if ( !(value instanceof String) ) return false;\n"
+" String string = (String) value;\n"
+" if (type == CapitalizeType.ALL) {\n"
+" return string.equals( string.toUpperCase() );\n"
+" }\n"
+" else {\n"
+" String first = string.substring(0,1);\n"
+" return first.equals( first.toUpperCase();\n"
+" }\n"
+" }\n"
+"}"
+msgstr ""
+
+#. Tag: para
+#: defineconstraints.xml:300
+#, no-c-format
+msgid ""
+"The <literal>isValid()</literal> method should return false if the "
+"constraint has been violated. For more examples, refer to the built-in "
+"validator implementations."
+msgstr ""
+
+#. Tag: para
+#: defineconstraints.xml:304
+#, no-c-format
+msgid ""
+"We only have seen property level validation, but you can write a Bean level "
+"validation annotation. Instead of receiving the return instance of a "
+"property, the bean itself will be passed to the validator. To activate the "
+"validation checking, just annotated the bean itself instead. A small sample "
+"can be found in the unit test suite."
+msgstr ""
+
+#. Tag: para
+#: defineconstraints.xml:310
+#, no-c-format
+msgid ""
+"If your constraint can be applied multiple times (with different parameters) "
+"on the same property or type, you can use the following annotation form:"
+msgstr ""
+
+#. Tag: programlisting
+#: defineconstraints.xml:314
+#, no-c-format
+msgid ""
+"@Target(METHOD)\n"
+"@Retention(RUNTIME)\n"
+"@Documented\n"
+"<emphasis role=\"bold\">public @interface Patterns {</emphasis>\n"
+" Pattern[] value();\n"
+"}\n"
+"\n"
+"@Target(METHOD)\n"
+"@Retention(RUNTIME)\n"
+"@Documented\n"
+"@ValidatorClass(PatternValidator.class)\n"
+"public @interface Pattern {\n"
+" String regexp();\n"
+"}"
+msgstr ""
+
+#. Tag: para
+#: defineconstraints.xml:316
+#, no-c-format
+msgid ""
+"Basically an annotation containing the value attribute as an array of "
+"validator annotations."
+msgstr ""
+
+#. Tag: title
+#: defineconstraints.xml:321
+#, no-c-format
+msgid "Annotating your domain model"
+msgstr ""
+
+#. Tag: para
+#: defineconstraints.xml:323
+#, no-c-format
+msgid ""
+"Since you are already familiar with annotations now, the syntax should be "
+"very familiar"
+msgstr ""
+
+#. Tag: programlisting
+#: defineconstraints.xml:326
+#, no-c-format
+msgid ""
+"public class Address {\n"
+" private String line1;\n"
+" private String line2;\n"
+" private String zip;\n"
+" private String state;\n"
+" private String country;\n"
+" private long id;\n"
+"\n"
+" // a not null string of 20 characters maximum\n"
+" @Length(max=20)\n"
+" @NotNull\n"
+" public String getCountry() {\n"
+" return country;\n"
+" }\n"
+"\n"
+" // a non null string\n"
+" @NotNull\n"
+" public String getLine1() {\n"
+" return line1;\n"
+" }\n"
+"\n"
+" //no constraint\n"
+" public String getLine2() {\n"
+" return line2;\n"
+" }\n"
+"\n"
+" // a not null string of 3 characters maximum\n"
+" @Length(max=3) @NotNull\n"
+" public String getState() {\n"
+" return state;\n"
+" }\n"
+"\n"
+" // a not null numeric string of 5 characters maximum\n"
+" // if the string is longer, the message will\n"
+" //be searched in the resource bundle at key 'long'\n"
+" @Length(max=5, message=\"{long}\")\n"
+" @Pattern(regex=\"[0-9]+\")\n"
+" @NotNull\n"
+" public String getZip() {\n"
+" return zip;\n"
+" }\n"
+"\n"
+" // should always be true\n"
+" @AssertTrue\n"
+" public boolean isValid() {\n"
+" return true;\n"
+" }\n"
+"\n"
+" // a numeric between 1 and 2000\n"
+" @Id @Min(1)\n"
+" @Range(max=2000)\n"
+" public long getId() {\n"
+" return id;\n"
+" }\n"
+"}"
+msgstr ""
+
+#. Tag: para
+#: defineconstraints.xml:328
+#, no-c-format
+msgid ""
+"While the example only shows public property validation, you can also "
+"annotate fields of any kind of visibility"
+msgstr ""
+
+#. Tag: programlisting
+#: defineconstraints.xml:331
+#, no-c-format
+msgid ""
+"@MyBeanConstraint(max=45\n"
+"public class Dog {\n"
+" @AssertTrue private boolean isMale;\n"
+" @NotNull protected String getName() { ... };\n"
+" ...\n"
+"}"
+msgstr ""
+
+#. Tag: para
+#: defineconstraints.xml:333
+#, no-c-format
+msgid ""
+"You can also annotate interfaces. Hibernate Validator will check all "
+"superclasses and interfaces extended or implemented by a given bean to read "
+"the appropriate validator annotations."
+msgstr ""
+
+#. Tag: programlisting
+#: defineconstraints.xml:337
+#, no-c-format
+msgid ""
+"public interface Named {\n"
+" @NotNull String getName();\n"
+" ...\n"
+"}\n"
+"\n"
+"public class Dog implements Named {\n"
+"\n"
+" @AssertTrue private boolean isMale;\n"
+"\n"
+" public String getName() { ... };\n"
+"\n"
+"}"
+msgstr ""
+
+#. Tag: para
+#: defineconstraints.xml:339
+#, no-c-format
+msgid ""
+"The name property will be checked for nullity when the Dog bean is validated."
+msgstr ""
Added: projects/docs/enterprise/5.0/Hibernate/Hibernate_Validator/zh-CN/Author_Group.po
===================================================================
--- projects/docs/enterprise/5.0/Hibernate/Hibernate_Validator/zh-CN/Author_Group.po (rev 0)
+++ projects/docs/enterprise/5.0/Hibernate/Hibernate_Validator/zh-CN/Author_Group.po 2009-11-26 05:06:44 UTC (rev 97007)
@@ -0,0 +1,5 @@
+#. Tag: author
+#: Author_Group.xml:6
+#, no-c-format
+msgid "<firstname>Red Hat Documentation Group</firstname> <surname></surname>"
+msgstr ""
Added: projects/docs/enterprise/5.0/Hibernate/Hibernate_Validator/zh-CN/Book_Info.po
===================================================================
--- projects/docs/enterprise/5.0/Hibernate/Hibernate_Validator/zh-CN/Book_Info.po (rev 0)
+++ projects/docs/enterprise/5.0/Hibernate/Hibernate_Validator/zh-CN/Book_Info.po 2009-11-26 05:06:44 UTC (rev 97007)
@@ -0,0 +1,25 @@
+#. Tag: title
+#: Book_Info.xml:6
+#, no-c-format
+msgid "Hibernate Validator Reference Guide"
+msgstr ""
+
+#. Tag: subtitle
+#: Book_Info.xml:7
+#, no-c-format
+msgid "for Use with JBoss Enterprise Application Platform 5.0"
+msgstr ""
+
+#. Tag: para
+#: Book_Info.xml:14
+#, no-c-format
+msgid ""
+"The JBoss Enterprise Application Platform Edition of the Hibernate Validator "
+"Reference Guide"
+msgstr ""
+
+#. Tag: holder
+#: Book_Info.xml:25
+#, no-c-format
+msgid "&HOLDER;"
+msgstr ""
Added: projects/docs/enterprise/5.0/Hibernate/Hibernate_Validator/zh-CN/Hibernate_Validator_Reference_Guide.po
===================================================================
Added: projects/docs/enterprise/5.0/Hibernate/Hibernate_Validator/zh-CN/Preface.po
===================================================================
--- projects/docs/enterprise/5.0/Hibernate/Hibernate_Validator/zh-CN/Preface.po (rev 0)
+++ projects/docs/enterprise/5.0/Hibernate/Hibernate_Validator/zh-CN/Preface.po 2009-11-26 05:06:44 UTC (rev 97007)
@@ -0,0 +1,56 @@
+#. Tag: title
+#: Preface.xml:7
+#, no-c-format
+msgid "Preface"
+msgstr ""
+
+#. Tag: para
+#: Preface.xml:9
+#, no-c-format
+msgid ""
+"Annotations are a very convenient and elegant way to specify invariant "
+"constraints for a domain model. You can, for example, express that a "
+"property should never be null, that the account balance should be strictly "
+"positive, etc. These domain model constraints are declared in the bean "
+"itself by annotating its properties. A validator can then read them and "
+"check for constraint violations. The validation mechanism can be executed in "
+"different layers in your application without having to duplicate any of "
+"these rules (presentation layer, data access layer). Following the DRY "
+"principle, Hibernate Validator has been designed for that purpose."
+msgstr ""
+
+#. Tag: para
+#: Preface.xml:20
+#, no-c-format
+msgid ""
+"Hibernate Validator works at two levels. First, it is able to check in-"
+"memory instances of a class for constraint violations. Second, it can apply "
+"the constraints to the Hibernate metamodel and incorporate them into the "
+"generated database schema."
+msgstr ""
+
+#. Tag: para
+#: Preface.xml:25
+#, no-c-format
+msgid ""
+"Each constraint annotation is associated to a validator implementation "
+"responsible for checking the constraint on the entity instance. A validator "
+"can also (optionally) apply the constraint to the Hibernate metamodel, "
+"allowing Hibernate to generate DDL that expresses the constraint. With the "
+"appropriate event listener, you can execute the checking operation on "
+"inserts and updates done by Hibernate. Hibernate Validator is not limited to "
+"use with Hibernate. You can easily use it anywhere in your application as "
+"well as with any Java Persistence provider (entity listener provided)."
+msgstr ""
+
+#. Tag: para
+#: Preface.xml:35
+#, no-c-format
+msgid ""
+"When checking instances at runtime, Hibernate Validator returns information "
+"about constraint violations in an array of <classname>InvalidValue</"
+"classname> s. Among other information, the <classname>InvalidValue</"
+"classname> contains an error description message that can embed the "
+"parameter values bundle with the annotation (eg. length limit), and message "
+"strings that may be externalized to a <classname>ResourceBundle</classname> ."
+msgstr ""
Added: projects/docs/enterprise/5.0/Hibernate/Hibernate_Validator/zh-CN/Revision_History.po
===================================================================
--- projects/docs/enterprise/5.0/Hibernate/Hibernate_Validator/zh-CN/Revision_History.po (rev 0)
+++ projects/docs/enterprise/5.0/Hibernate/Hibernate_Validator/zh-CN/Revision_History.po 2009-11-26 05:06:44 UTC (rev 97007)
@@ -0,0 +1,11 @@
+#. Tag: title
+#: Revision_History.xml:6
+#, no-c-format
+msgid "Revision History"
+msgstr ""
+
+#. Tag: author
+#: Revision_History.xml:12
+#, no-c-format
+msgid "<firstname></firstname> <surname></surname> <email></email>"
+msgstr ""
Added: projects/docs/enterprise/5.0/Hibernate/Hibernate_Validator/zh-CN/checkconstraints.po
===================================================================
--- projects/docs/enterprise/5.0/Hibernate/Hibernate_Validator/zh-CN/checkconstraints.po (rev 0)
+++ projects/docs/enterprise/5.0/Hibernate/Hibernate_Validator/zh-CN/checkconstraints.po 2009-11-26 05:06:44 UTC (rev 97007)
@@ -0,0 +1,370 @@
+#. Tag: title
+#: checkconstraints.xml:3
+#, no-c-format
+msgid "Using the Validator framework"
+msgstr ""
+
+#. Tag: para
+#: checkconstraints.xml:5
+#, no-c-format
+msgid ""
+"Hibernate Validator is intended to be used to implement multi-layered data "
+"validation, where constraints are expressed in a single place (the annotated "
+"domain model) and checked in various different layers of the application."
+msgstr ""
+
+#. Tag: para
+#: checkconstraints.xml:10
+#, no-c-format
+msgid "This chapter will cover Hibernate Validator usage for different layers"
+msgstr ""
+
+#. Tag: title
+#: checkconstraints.xml:14
+#, no-c-format
+msgid "Database schema-level validation"
+msgstr ""
+
+#. Tag: para
+#: checkconstraints.xml:16
+#, no-c-format
+msgid ""
+"Out of the box, Hibernate Annotations will translate the constraints you "
+"have defined for your entities into mapping metadata. For example, if a "
+"property of your entity is annotated <literal>@NotNull</literal>, its "
+"columns will be declared as <literal>not null</literal> in the DDL schema "
+"generated by Hibernate."
+msgstr ""
+
+#. Tag: para
+#: checkconstraints.xml:22
+#, no-c-format
+msgid ""
+"Using hbm2ddl, domain model constraints will be expressed into the database "
+"schema."
+msgstr ""
+
+#. Tag: para
+#: checkconstraints.xml:25
+#, no-c-format
+msgid ""
+"If, for some reason, the feature needs to be disabled, set "
+"<literal>hibernate.validator.apply_to_ddl</literal> to <literal>false</"
+"literal>."
+msgstr ""
+
+#. Tag: title
+#: checkconstraints.xml:31
+#, no-c-format
+msgid "ORM integration"
+msgstr ""
+
+#. Tag: para
+#: checkconstraints.xml:33
+#, no-c-format
+msgid ""
+"Hibernate Validator integrates with both Hibernate and all pure Java "
+"Persistence providers"
+msgstr ""
+
+#. Tag: title
+#: checkconstraints.xml:37
+#, no-c-format
+msgid "Hibernate event-based validation"
+msgstr ""
+
+#. Tag: para
+#: checkconstraints.xml:39
+#, no-c-format
+msgid ""
+"Hibernate Validator has two built-in Hibernate event listeners. Whenever a "
+"<literal>PreInsertEvent</literal> or <literal>PreUpdateEvent</literal> "
+"occurs, the listeners will verify all constraints of the entity instance and "
+"throw an exception if any constraint is violated. Basically, objects will be "
+"checked before any inserts and before any updates made by Hibernate. This "
+"includes changes applied by cascade! This is the most convenient and the "
+"easiest way to activate the validation process. On constraint violation, the "
+"event will raise a runtime <classname>InvalidStateException</classname> "
+"which contains an array of <literal>InvalidValue</literal>s describing each "
+"failure."
+msgstr ""
+
+#. Tag: para
+#: checkconstraints.xml:51
+#, no-c-format
+msgid ""
+"If Hibernate Validator is present in the classpath, Hibernate Annotations "
+"(or Hibernate EntityManager) will use it transparently. If, for some reason, "
+"you want to disable this integration, set <literal>hibernate.validator."
+"autoregister_listeners</literal> to false"
+msgstr ""
+
+#. Tag: para
+#: checkconstraints.xml:58
+#, no-c-format
+msgid ""
+"If the beans are not annotated with validation annotations, there is no "
+"runtime performance cost."
+msgstr ""
+
+#. Tag: para
+#: checkconstraints.xml:62
+#, no-c-format
+msgid ""
+"In case you need to manually set the event listeners for Hibernate Core, use "
+"the following configuration in <literal>hibernate.cfg.xml</literal>:"
+msgstr ""
+
+#. Tag: programlisting
+#: checkconstraints.xml:66
+#, no-c-format
+msgid ""
+"<hibernate-configuration>\n"
+" ...\n"
+" <event type=\"pre-update\">\n"
+" <listener \n"
+" class=\"org.hibernate.validator.event.ValidateEventListener\"/"
+">\n"
+" </event>\n"
+" <event type=\"pre-insert\">\n"
+" <listener \n"
+" class=\"org.hibernate.validator.event.ValidateEventListener\"/"
+">\n"
+" </event>\n"
+"</hibernate-configuration>"
+msgstr ""
+
+#. Tag: title
+#: checkconstraints.xml:70
+#, no-c-format
+msgid "Java Persistence event-based validation"
+msgstr ""
+
+#. Tag: para
+#: checkconstraints.xml:72
+#, no-c-format
+msgid ""
+"Hibernate Validator is not tied to Hibernate for event based validation: a "
+"Java Persistence entity listener is available. Whenever an listened entity "
+"is persisted or updated, Hibernate Validator will verify all constraints of "
+"the entity instance and throw an exception if any constraint is violated. "
+"Basically, objects will be checked before any inserts and before any updates "
+"made by the Java Persistence provider. This includes changes applied by "
+"cascade! On constraint violation, the event will raise a runtime "
+"<classname>InvalidStateException</classname> which contains an array of "
+"<literal>InvalidValue</literal>s describing each failure."
+msgstr ""
+
+#. Tag: para
+#: checkconstraints.xml:83
+#, no-c-format
+msgid "Here is how to make a class validatable:"
+msgstr ""
+
+#. Tag: programlisting
+#: checkconstraints.xml:85
+#, no-c-format
+msgid ""
+"@Entity\n"
+"@EntityListeners( JPAValidateListener.class )\n"
+"public class Submarine {\n"
+" ...\n"
+"}"
+msgstr ""
+
+#. Tag: para
+#: checkconstraints.xml:88
+#, no-c-format
+msgid ""
+"Compared to the Hibernate event, the Java Persistence listener has two "
+"drawbacks. You need to define the entity listener on every validatable "
+"entity. The DDL generated by your provider will not reflect the constraints."
+msgstr ""
+
+#. Tag: title
+#: checkconstraints.xml:97
+#, no-c-format
+msgid "Application-level validation"
+msgstr ""
+
+#. Tag: para
+#: checkconstraints.xml:99
+#, no-c-format
+msgid "Hibernate Validator can be applied anywhere in your application code."
+msgstr ""
+
+#. Tag: programlisting
+#: checkconstraints.xml:102
+#, no-c-format
+msgid ""
+"ClassValidator personValidator = new ClassValidator( Person.class );\n"
+"ClassValidator addressValidator = new ClassValidator( Address.class, "
+"ResourceBundle.getBundle(\"messages\", Locale.ENGLISH) );\n"
+"\n"
+"InvalidValue[] validationMessages = addressValidator.getInvalidValues"
+"(address);"
+msgstr ""
+
+#. Tag: para
+#: checkconstraints.xml:104
+#, no-c-format
+msgid ""
+"The first two lines prepare the Hibernate Validator for class checking. The "
+"first one relies upon the error messages embedded in Hibernate Validator "
+"(see <xref linkend=\"validator-defineconstraints-error\"/>), the second one "
+"uses a resource bundle for these messages. It is considered a good practice "
+"to execute these lines once and cache the validator instances."
+msgstr ""
+
+#. Tag: para
+#: checkconstraints.xml:111
+#, no-c-format
+msgid ""
+"The third line actually validates the <literal>Address</literal> instance "
+"and returns an array of <literal>InvalidValue</literal>s. Your application "
+"logic will then be able to react to the failure."
+msgstr ""
+
+#. Tag: para
+#: checkconstraints.xml:115
+#, no-c-format
+msgid ""
+"You can also check a particular property instead of the whole bean. This "
+"might be useful for property per property user interaction"
+msgstr ""
+
+#. Tag: programlisting
+#: checkconstraints.xml:118
+#, no-c-format
+msgid ""
+"ClassValidator addressValidator = new ClassValidator( Address.class, "
+"ResourceBundle.getBundle(\"messages\", Locale.ENGLISH) );\n"
+"\n"
+"//only get city property invalid values\n"
+"InvalidValue[] validationMessages = addressValidator.getInvalidValues"
+"(address, \"city\");\n"
+"\n"
+"//only get potential city property invalid values\n"
+"InvalidValue[] validationMessages = addressValidator."
+"getPotentialInvalidValues(\"city\", \"Paris\")"
+msgstr ""
+
+#. Tag: title
+#: checkconstraints.xml:122
+#, no-c-format
+msgid "Presentation layer validation"
+msgstr ""
+
+#. Tag: para
+#: checkconstraints.xml:124
+#, no-c-format
+msgid ""
+"When working with JSF and <productname>JBoss Seam</productname>, one can "
+"triggers the validation process at the presentation layer using Seam's JSF "
+"tags <literal><s:validate></literal> and <literal><s:validateAll/"
+"></literal>, letting the constraints be expressed on the model, and the "
+"violations presented in the view"
+msgstr ""
+
+#. Tag: programlisting
+#: checkconstraints.xml:130
+#, no-c-format
+msgid ""
+"<h:form>\n"
+" <div>\n"
+" <h:messages/>\n"
+" </div>\n"
+" <emphasis role=\"bold\"><s:validateAll></emphasis>\n"
+" <div>\n"
+" Country:\n"
+" <h:inputText value=\"#{location.country}\" required=\"true\"/"
+">\n"
+" </div>\n"
+" <div>\n"
+" Zip code:\n"
+" <h:inputText value=\"#{location.zip}\" required=\"true\"/"
+">\n"
+" </div>\n"
+" <div>\n"
+" <h:commandButton/>\n"
+" </div>\n"
+" <emphasis role=\"bold\"></s:validateAll></emphasis>\n"
+"</h:form>"
+msgstr ""
+
+#. Tag: para
+#: checkconstraints.xml:132
+#, no-c-format
+msgid ""
+"Going even further, and adding <productname>Ajax4JSF</productname> to the "
+"loop will bring client side validation with just a couple of additional JSF "
+"tags, again without validation definition duplication."
+msgstr ""
+
+#. Tag: para
+#: checkconstraints.xml:137
+#, no-c-format
+msgid ""
+"Check the <ulink url=\"http://www.jboss.com/products/seam\">JBoss Seam</"
+"ulink> documentation for more information."
+msgstr ""
+
+#. Tag: title
+#: checkconstraints.xml:142
+#, no-c-format
+msgid "Validation informations"
+msgstr ""
+
+#. Tag: para
+#: checkconstraints.xml:144
+#, no-c-format
+msgid ""
+"As a validation information carrier, hibernate provide an array of "
+"<classname>InvalidValue</classname>. Each <literal>InvalidValue</literal> "
+"has a buch of methods describing the individual issues."
+msgstr ""
+
+#. Tag: para
+#: checkconstraints.xml:148
+#, no-c-format
+msgid "<methodname>getBeanClass()</methodname> retrieves the failing bean type"
+msgstr ""
+
+#. Tag: para
+#: checkconstraints.xml:151
+#, no-c-format
+msgid ""
+"<methodname>getBean()</methodname>retrieves the failing instance (if any ie "
+"not when using <methodname>getPotentianInvalidValues()</methodname>)"
+msgstr ""
+
+#. Tag: para
+#: checkconstraints.xml:155
+#, no-c-format
+msgid "<methodname>getValue()</methodname> retrieves the failing value"
+msgstr ""
+
+#. Tag: para
+#: checkconstraints.xml:158
+#, no-c-format
+msgid ""
+"<methodname>getMessage()</methodname> retrieves the proper internationalized "
+"error message"
+msgstr ""
+
+#. Tag: para
+#: checkconstraints.xml:161
+#, no-c-format
+msgid ""
+"<methodname>getRootBean()</methodname> retrieves the root bean instance "
+"generating the issue (useful in conjunction with <literal>@Valid</literal>), "
+"is null if getPotentianInvalidValues() is used."
+msgstr ""
+
+#. Tag: para
+#: checkconstraints.xml:166
+#, no-c-format
+msgid ""
+"<literal>getPropertyPath()</literal> retrieves the dotted path of the "
+"failing property starting from the root bean"
+msgstr ""
Added: projects/docs/enterprise/5.0/Hibernate/Hibernate_Validator/zh-CN/defineconstraints.po
===================================================================
--- projects/docs/enterprise/5.0/Hibernate/Hibernate_Validator/zh-CN/defineconstraints.po (rev 0)
+++ projects/docs/enterprise/5.0/Hibernate/Hibernate_Validator/zh-CN/defineconstraints.po 2009-11-26 05:06:44 UTC (rev 97007)
@@ -0,0 +1,718 @@
+#. Tag: title
+#: defineconstraints.xml:3
+#, no-c-format
+msgid "Defining constraints"
+msgstr ""
+
+#. Tag: title
+#: defineconstraints.xml:6
+#, no-c-format
+msgid "What is a constraint?"
+msgstr ""
+
+#. Tag: para
+#: defineconstraints.xml:8
+#, no-c-format
+msgid ""
+"A constraint is a rule that a given element (field, property or bean) has to "
+"comply to. The rule semantic is expressed by an annotation. A constraint "
+"usually has some attributes used to parameterize the constraints limits. The "
+"constraint applies to the annotated element."
+msgstr ""
+
+#. Tag: title
+#: defineconstraints.xml:16
+#, no-c-format
+msgid "Built in constraints"
+msgstr ""
+
+#. Tag: para
+#: defineconstraints.xml:18
+#, no-c-format
+msgid ""
+"Hibernate Validator comes with some built-in constraints, which covers most "
+"basic data checks. As we'll see later, you're not limited to them, you can "
+"literally in a minute write your own constraints."
+msgstr ""
+
+#. Tag: title
+#: defineconstraints.xml:23
+#, no-c-format
+msgid "Built-in constraints"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:30
+#, no-c-format
+msgid "Annotation"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:32
+#, no-c-format
+msgid "Apply on"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:34
+#, no-c-format
+msgid "Runtime checking"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:36
+#, no-c-format
+msgid "Hibernate Metadata impact"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:42
+#, no-c-format
+msgid "@Length(min=, max=)"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:44 defineconstraints.xml:188
+#: defineconstraints.xml:199
+#, no-c-format
+msgid "property (String)"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:46
+#, no-c-format
+msgid "check if the string length match the range"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:48
+#, no-c-format
+msgid "Column length will be set to max"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:52
+#, no-c-format
+msgid "@Max(value=)"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:54 defineconstraints.xml:65 defineconstraints.xml:130
+#: defineconstraints.xml:210
+#, no-c-format
+msgid "property (numeric or string representation of a numeric)"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:57
+#, no-c-format
+msgid "check if the value is less than or equals to max"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:59 defineconstraints.xml:70 defineconstraints.xml:101
+#: defineconstraints.xml:136
+#, no-c-format
+msgid "Add a check constraint on the column"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:63
+#, no-c-format
+msgid "@Min(value=)"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:68
+#, no-c-format
+msgid "check if the value is more than or equals to min"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:74
+#, no-c-format
+msgid "@NotNull"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:76 defineconstraints.xml:86 defineconstraints.xml:153
+#: defineconstraints.xml:164
+#, no-c-format
+msgid "property"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:78
+#, no-c-format
+msgid "check if the value is not null"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:80
+#, no-c-format
+msgid "Column(s) are not null"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:84
+#, no-c-format
+msgid "@NotEmpty"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:88
+#, no-c-format
+msgid ""
+"check if the string is not null nor empty. Check if the connection is not "
+"null nor empty"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:91
+#, no-c-format
+msgid "Column(s) are not null (for String)"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:95
+#, no-c-format
+msgid "@Past"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:97 defineconstraints.xml:107
+#, no-c-format
+msgid "property (date or calendar)"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:99
+#, no-c-format
+msgid "check if the date is in the past"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:105
+#, no-c-format
+msgid "@Future"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:109
+#, no-c-format
+msgid "check if the date is in the future"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:111 defineconstraints.xml:124
+#: defineconstraints.xml:147 defineconstraints.xml:158
+#: defineconstraints.xml:169 defineconstraints.xml:182
+#: defineconstraints.xml:193 defineconstraints.xml:204
+#: defineconstraints.xml:228
+#, no-c-format
+msgid "none"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:115
+#, no-c-format
+msgid "@Pattern(regex=\"regexp\", flag=) or @Patterns( {@Pattern(...)} )"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:118 defineconstraints.xml:223
+#, no-c-format
+msgid "property (string)"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:120
+#, no-c-format
+msgid ""
+"check if the property match the regular expression given a match flag (see "
+"<classname>java.util.regex.Pattern </classname> )"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:128
+#, no-c-format
+msgid "@Range(min=, max=)"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:133
+#, no-c-format
+msgid "check if the value is between min and max (included)"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:140
+#, no-c-format
+msgid "@Size(min=, max=)"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:142
+#, no-c-format
+msgid "property (array, collection, map)"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:144
+#, no-c-format
+msgid "check if the element size is between min and max (included)"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:151
+#, no-c-format
+msgid "@AssertFalse"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:155
+#, no-c-format
+msgid ""
+"check that the method evaluates to false (useful for constraints expressed "
+"in code rather than annotations)"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:162
+#, no-c-format
+msgid "@AssertTrue"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:166
+#, no-c-format
+msgid ""
+"check that the method evaluates to true (useful for constraints expressed in "
+"code rather than annotations)"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:173
+#, no-c-format
+msgid "@Valid"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:175
+#, no-c-format
+msgid "property (object)"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:177
+#, no-c-format
+msgid ""
+"perform validation recursively on the associated object. If the object is a "
+"Collection or an array, the elements are validated recursively. If the "
+"object is a Map, the value elements are validated recursively."
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:186
+#, no-c-format
+msgid "@Email"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:190
+#, no-c-format
+msgid "check whether the string is conform to the email address specification"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:197
+#, no-c-format
+msgid "@CreditCardNumber"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:201
+#, no-c-format
+msgid ""
+"check whether the string is a well formated credit card number (derivative "
+"of the Luhn algorithm)"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:208
+#, no-c-format
+msgid "@Digits"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:213
+#, no-c-format
+msgid ""
+"check whether the property is a number having up to <literal>integerDigits</"
+"literal> integer digits and <literal>fractionalDigits</literal> fractonal "
+"digits"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:217
+#, no-c-format
+msgid "define column precision and scale"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:221
+#, no-c-format
+msgid "@EAN"
+msgstr ""
+
+#. Tag: entry
+#: defineconstraints.xml:225
+#, no-c-format
+msgid "check whether the string is a properly formated EAN or UPC-A code"
+msgstr ""
+
+#. Tag: title
+#: defineconstraints.xml:236
+#, no-c-format
+msgid "Error messages"
+msgstr ""
+
+#. Tag: para
+#: defineconstraints.xml:238
+#, no-c-format
+msgid ""
+"Hibernate Validator comes with a default set of error messages translated in "
+"about ten languages (if yours is not part of it, please sent us a patch). "
+"You can override those messages by creating a <filename>ValidatorMessages."
+"properties</filename> or ( <filename>ValidatorMessages_loc.properties</"
+"filename> ) and override the needed keys. You can even add your own "
+"additional set of messages while writing your validator annotations. If "
+"Hibernate Validator cannot resolve a key from your resourceBundle nor from "
+"ValidatorMessage, it falls back to the default built-in values."
+msgstr ""
+
+#. Tag: para
+#: defineconstraints.xml:248
+#, no-c-format
+msgid ""
+"Alternatively you can provide a <classname>ResourceBundle</classname> while "
+"checking programmatically the validation rules on a bean or if you want a "
+"completly different interpolation mechanism, you can provide an "
+"implementation of <literal>org.hibernate.validator.MessageInterpolator</"
+"literal> (check the JavaDoc for more informations)."
+msgstr ""
+
+#. Tag: title
+#: defineconstraints.xml:257
+#, no-c-format
+msgid "Writing your own constraints"
+msgstr ""
+
+#. Tag: para
+#: defineconstraints.xml:259
+#, no-c-format
+msgid ""
+"Extending the set of built-in constraints is extremely easy. Any constraint "
+"consists of two pieces: the constraint <emphasis>descriptor</emphasis> (the "
+"annotation) and the constraint <emphasis>validator</emphasis> (the "
+"implementation class). Here is a simple user-defined descriptor:"
+msgstr ""
+
+#. Tag: programlisting
+#: defineconstraints.xml:265
+#, no-c-format
+msgid ""
+"@ValidatorClass(CapitalizedValidator.class)\n"
+"@Target(METHOD)\n"
+"@Retention(RUNTIME)\n"
+"@Documented\n"
+"public @interface Capitalized {\n"
+" CapitalizeType type() default Capitalize.FIRST;\n"
+" String message() default \"has incorrect capitalization\"\n"
+"}"
+msgstr ""
+
+#. Tag: para
+#: defineconstraints.xml:267
+#, no-c-format
+msgid ""
+"<literal>type</literal> is a parameter describing how the property should to "
+"be capitalized. This is a user parameter fully dependant on the annotation "
+"business."
+msgstr ""
+
+#. Tag: para
+#: defineconstraints.xml:271
+#, no-c-format
+msgid ""
+"<literal>message</literal> is the default string used to describe the "
+"constraint violation and is mandatory. You can hard code the string or you "
+"can externalize part/all of it through the Java ResourceBundle mechanism. "
+"Parameters values are going to be injected inside the message when the "
+"<literal>{parameter}</literal> string is found (in our example "
+"<literal>Capitalization is not {type}</literal> would generate "
+"<literal>Capitalization is not FIRST</literal> ), externalizing the whole "
+"string in <filename>ValidatorMessages.properties</filename> is considered "
+"good practice. See <xref linkend=\"validator-defineconstraints-error\"/> ."
+msgstr ""
+
+#. Tag: programlisting
+#: defineconstraints.xml:282
+#, no-c-format
+msgid ""
+"@ValidatorClass(CapitalizedValidator.class)\n"
+"@Target(METHOD)\n"
+"@Retention(RUNTIME)\n"
+"@Documented\n"
+"public @interface Capitalized {\n"
+" CapitalizeType type() default Capitalize.FIRST;\n"
+" String message() default \"{validator.capitalized}\";\n"
+"}\n"
+"\n"
+"\n"
+"#in ValidatorMessages.properties\n"
+"validator.capitalized = <literal>Capitalization is not {type}</literal>"
+msgstr ""
+
+#. Tag: para
+#: defineconstraints.xml:284
+#, no-c-format
+msgid "As you can see the {} notation is recursive."
+msgstr ""
+
+#. Tag: para
+#: defineconstraints.xml:286
+#, no-c-format
+msgid ""
+"To link a descriptor to its validator implementation, we use the "
+"<literal>@ValidatorClass</literal> meta-annotation. The validator class "
+"parameter must name a class which implements <literal>Validator<"
+"ConstraintAnnotation></literal> ."
+msgstr ""
+
+#. Tag: para
+#: defineconstraints.xml:291
+#, no-c-format
+msgid ""
+"We now have to implement the validator (ie. the rule checking "
+"implementation). A validation implementation can check the value of the a "
+"property (by implementing <literal>PropertyConstraint</literal> ) and/or can "
+"modify the hibernate mapping metadata to express the constraint at the "
+"database level (by implementing <literal>PersistentClassConstraint</"
+"literal> )"
+msgstr ""
+
+#. Tag: programlisting
+#: defineconstraints.xml:298
+#, no-c-format
+msgid ""
+"public class CapitalizedValidator\n"
+" implements Validator<Capitalized>, PropertyConstraint {\n"
+" private CapitalizeType type;\n"
+"\n"
+" //part of the Validator<Annotation> contract,\n"
+" //allows to get and use the annotation values\n"
+" public void initialize(Capitalized parameters) {\n"
+" type = parameters.type();\n"
+" }\n"
+"\n"
+" //part of the property constraint contract\n"
+" public boolean isValid(Object value) {\n"
+" if (value==null) return true;\n"
+" if ( !(value instanceof String) ) return false;\n"
+" String string = (String) value;\n"
+" if (type == CapitalizeType.ALL) {\n"
+" return string.equals( string.toUpperCase() );\n"
+" }\n"
+" else {\n"
+" String first = string.substring(0,1);\n"
+" return first.equals( first.toUpperCase();\n"
+" }\n"
+" }\n"
+"}"
+msgstr ""
+
+#. Tag: para
+#: defineconstraints.xml:300
+#, no-c-format
+msgid ""
+"The <literal>isValid()</literal> method should return false if the "
+"constraint has been violated. For more examples, refer to the built-in "
+"validator implementations."
+msgstr ""
+
+#. Tag: para
+#: defineconstraints.xml:304
+#, no-c-format
+msgid ""
+"We only have seen property level validation, but you can write a Bean level "
+"validation annotation. Instead of receiving the return instance of a "
+"property, the bean itself will be passed to the validator. To activate the "
+"validation checking, just annotated the bean itself instead. A small sample "
+"can be found in the unit test suite."
+msgstr ""
+
+#. Tag: para
+#: defineconstraints.xml:310
+#, no-c-format
+msgid ""
+"If your constraint can be applied multiple times (with different parameters) "
+"on the same property or type, you can use the following annotation form:"
+msgstr ""
+
+#. Tag: programlisting
+#: defineconstraints.xml:314
+#, no-c-format
+msgid ""
+"@Target(METHOD)\n"
+"@Retention(RUNTIME)\n"
+"@Documented\n"
+"<emphasis role=\"bold\">public @interface Patterns {</emphasis>\n"
+" Pattern[] value();\n"
+"}\n"
+"\n"
+"@Target(METHOD)\n"
+"@Retention(RUNTIME)\n"
+"@Documented\n"
+"@ValidatorClass(PatternValidator.class)\n"
+"public @interface Pattern {\n"
+" String regexp();\n"
+"}"
+msgstr ""
+
+#. Tag: para
+#: defineconstraints.xml:316
+#, no-c-format
+msgid ""
+"Basically an annotation containing the value attribute as an array of "
+"validator annotations."
+msgstr ""
+
+#. Tag: title
+#: defineconstraints.xml:321
+#, no-c-format
+msgid "Annotating your domain model"
+msgstr ""
+
+#. Tag: para
+#: defineconstraints.xml:323
+#, no-c-format
+msgid ""
+"Since you are already familiar with annotations now, the syntax should be "
+"very familiar"
+msgstr ""
+
+#. Tag: programlisting
+#: defineconstraints.xml:326
+#, no-c-format
+msgid ""
+"public class Address {\n"
+" private String line1;\n"
+" private String line2;\n"
+" private String zip;\n"
+" private String state;\n"
+" private String country;\n"
+" private long id;\n"
+"\n"
+" // a not null string of 20 characters maximum\n"
+" @Length(max=20)\n"
+" @NotNull\n"
+" public String getCountry() {\n"
+" return country;\n"
+" }\n"
+"\n"
+" // a non null string\n"
+" @NotNull\n"
+" public String getLine1() {\n"
+" return line1;\n"
+" }\n"
+"\n"
+" //no constraint\n"
+" public String getLine2() {\n"
+" return line2;\n"
+" }\n"
+"\n"
+" // a not null string of 3 characters maximum\n"
+" @Length(max=3) @NotNull\n"
+" public String getState() {\n"
+" return state;\n"
+" }\n"
+"\n"
+" // a not null numeric string of 5 characters maximum\n"
+" // if the string is longer, the message will\n"
+" //be searched in the resource bundle at key 'long'\n"
+" @Length(max=5, message=\"{long}\")\n"
+" @Pattern(regex=\"[0-9]+\")\n"
+" @NotNull\n"
+" public String getZip() {\n"
+" return zip;\n"
+" }\n"
+"\n"
+" // should always be true\n"
+" @AssertTrue\n"
+" public boolean isValid() {\n"
+" return true;\n"
+" }\n"
+"\n"
+" // a numeric between 1 and 2000\n"
+" @Id @Min(1)\n"
+" @Range(max=2000)\n"
+" public long getId() {\n"
+" return id;\n"
+" }\n"
+"}"
+msgstr ""
+
+#. Tag: para
+#: defineconstraints.xml:328
+#, no-c-format
+msgid ""
+"While the example only shows public property validation, you can also "
+"annotate fields of any kind of visibility"
+msgstr ""
+
+#. Tag: programlisting
+#: defineconstraints.xml:331
+#, no-c-format
+msgid ""
+"@MyBeanConstraint(max=45\n"
+"public class Dog {\n"
+" @AssertTrue private boolean isMale;\n"
+" @NotNull protected String getName() { ... };\n"
+" ...\n"
+"}"
+msgstr ""
+
+#. Tag: para
+#: defineconstraints.xml:333
+#, no-c-format
+msgid ""
+"You can also annotate interfaces. Hibernate Validator will check all "
+"superclasses and interfaces extended or implemented by a given bean to read "
+"the appropriate validator annotations."
+msgstr ""
+
+#. Tag: programlisting
+#: defineconstraints.xml:337
+#, no-c-format
+msgid ""
+"public interface Named {\n"
+" @NotNull String getName();\n"
+" ...\n"
+"}\n"
+"\n"
+"public class Dog implements Named {\n"
+"\n"
+" @AssertTrue private boolean isMale;\n"
+"\n"
+" public String getName() { ... };\n"
+"\n"
+"}"
+msgstr ""
+
+#. Tag: para
+#: defineconstraints.xml:339
+#, no-c-format
+msgid ""
+"The name property will be checked for nullity when the Dog bean is validated."
+msgstr ""
More information about the jboss-cvs-commits
mailing list