From 0f531d314546ba896cd75a7765709e6aa2841215 Mon Sep 17 00:00:00 2001
From: Erik Lumme <erik@vaadin.com>
Date: Tue, 12 Sep 2017 13:11:36 +0300
Subject: [PATCH] Migrate UsingBeanValidationToValidateInput

---
 ...singBeanValidationToValidateInput.asciidoc | 53 +++++++++++++++++++
 documentation/articles/contents.asciidoc      |  1 +
 2 files changed, 54 insertions(+)
 create mode 100644 documentation/articles/UsingBeanValidationToValidateInput.asciidoc

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]
-- 
2.39.5