Migrate UsingBeanValidationToValidateInput

2 files changed, 54 insertions, 0 deletions

diff --git a/documentation/articles/UsingBeanValidationToValidateInput.asciidoc b/documentation/articles/UsingBeanValidationToValidateInput.asciidoc
new file mode 100644
index 0000000000..5071a25a3a
--- /dev/null
+++ b/documentation/articles/UsingBeanValidationToValidateInput.asciidoc
@@ -0,0 +1,53 @@
+[[using-bean-validation-to-validate-input]]
+Using Bean Validation to validate input
+---------------------------------------
+
+Before you get started with Bean Validation you need to download a Bean
+Validation implementation and add it to your project. You can find one
+for instance at http://bval.apache.org/downloads.html. Just add the jars
+from the lib folder to your project.
+
+Bean Validation works as a normal validator. If you have a bean with
+Bean Validation annotations, such as:
+
+[source,java]
+....
+public class Person {
+
+  @Size(min = 5, max = 50)
+  private String name;
+
+  @Min(0)
+  @Max(100)
+  private int age;
+  // + constructor + setters + getters
+}
+....
+
+You can create a field for the name field as you always would:
+
+[source,java]
+....
+Person person = new Person("John", 26);
+BeanItem<Person> item = new BeanItem<Person>(person);
+
+TextField firstName = new TextField("First name",
+        item.getItemProperty("name"));
+firstName.setImmediate(true);
+setContent(firstName);
+....
+
+and add the bean validation as a normal validator:
+
+[source,java]
+....
+firstName.addValidator(new BeanValidator(Person.class, "name"));
+....
+
+Your `firstName` field is now automatically validated based on the
+annotations in your bean class. You can do the same thing for the `age`
+field and you won't be able to set a value outside the valid 0-100
+range.
+
+A Bean Validation tutorial is available here:
+http://docs.oracle.com/javaee/6/tutorial/doc/gircz.html
diff --git a/documentation/articles/contents.asciidoc b/documentation/articles/contents.asciidoc
index 95199c7bb8..2cde97b723 100644
--- a/documentation/articles/contents.asciidoc
+++ b/documentation/articles/contents.asciidoc
@@ -51,4 +51,5 @@ are great, too.
 - link:UsingRPCFromJavaScript.asciidoc[Using RPC from JavaScript]
 - link:IBGettingStartedWithVaadinSpringWithoutSpringBoot.asciidoc[I b - Getting started with Vaadin Spring withoout Spring Boot]
 - link:Vaadin7SpringSecurityBaseAuthentification.asciidoc[Vaadin 7 + Spring Security (base authentication)]
+- link:UsingBeanValidationToValidateInput.asciidoc[Using Bean Validation to validate input]
 - link:CreatingAUIExtension.asciidoc[Creating a UI extension]