summaryrefslogtreecommitdiffstats
path: root/documentation/articles/UsingBeanValidationToValidateInput.asciidoc
blob: 4ee3ad7e717910428b4808b0a9a5e072af29211e (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
---
title: Using Bean Validation To Validate Input
order: 45
layout: page
---

[[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