YAVI (pronounced jɑ-vάɪ) is a lambda based type safe validation for Java.
YAVI sounds as same as a Japanese slang "YABAI" that means awesome or awful depending on the context.
The concepts are
- No more reflection!
- No more annotation!
- No more Java Beans!
- Zero dependency!
If you are not a fan of Bean Validation, YAVI will be an awesome alternative.
For the migration from Bean Validation, refer the doc.
Add the following dependency in your pom.xml
<dependency>
<groupId>am.ik.yavi</groupId>
<artifactId>yavi</artifactId>
<version>0.0.23</version>
</dependency>
If you want to try a snapshot version, add the following repository:
<repository>
<id>sonatype-snapshots</id>
<name>Sonatype Snapshots</name>
<url>https://oss.sonatype.org/content/repositories/snapshots</url>
<snapshots>
<enabled>true</enabled>
</snapshots>
</repository>
Validator<User> validator = Validator.<User> builder() // or Validator.builder(User.class)
.constraint(User::getName, "name", c -> c.notNull() //
.lessThanOrEqual(20)) //
.constraint(User::getEmail, "email", c -> c.notNull() //
.greaterThanOrEqual(5) //
.lessThanOrEqual(50) //
.email()) //
.constraint(User::getAge, "age", c -> c.notNull() //
.greaterThanOrEqual(0) //
.lessThanOrEqual(200))
.build();
ConstraintViolations violations = validator.validate(user);
violations.isValid(); // true or false
violations.forEach(x -> System.out.println(x.message()));
If you are using Kotlin, you can write a bit shorter
val validator: Validator<User> = Validator.builder<User>()
.constraint(User::name) {
notNull() //
.lessThanOrEqual(20)
} //
.constraint(User::email) {
notNull() //
.greaterThanOrEqual(5) //
.lessThanOrEqual(50) //
.email()
} //
.constraint(User::age) {
notNull() //
.greaterThanOrEqual(0) //
.lessThanOrEqual(200)
}
.build()
Validator<Country> countryValidator = Validator.<Country> builder() //
.nest(Country::getName, "name", c -> c.notBlank() //
.lessThanOrEqual(20))
.build();
Validator<City> cityValidator = Validator.<City> builder() //
.nest(City::getName, "name", c -> c.notBlank() //
.lessThanOrEqual(100))
.build();
Validator<Address> validator = Validator.<Address> builder() //
.nest(Address::getCountry, "country", countryValidator) //
.nest(Address::getCity, "city", cityValidator)
.build();
or
Validator<Address> validator = Validator.<Address> builder() //
.nest(Address::getCountry, "country", //
b -> b.constraint(Country::getName, "name", c -> c.notBlank() //
.lessThanOrEqual(20))) //
.nest(Address::getCity, "city", //
b -> b.constraint(City::getName, "name", c -> c.notBlank() //
.lessThanOrEqual(100))) //
.build();
Validator<User> validator = Validator.<User> builder() //
.constraint(User::getName, "name", c -> c.notNull().message("name is required!") //
.greaterThanOrEqual(1).message("name is too small!") //
.lessThanOrEqual(20).message("name is too large!")) //
.build()
public enum IsbnConstraint implements CustomConstraint<String> {
SINGLETON;
@Override
public boolean test(String s) {
return ISBNValidator.isISBN13(s);
}
@Override
public String messageKey() {
return "custom.isbn13";
}
@Override
public String defaultMessageFormat() {
return "\"{0}\" must be ISBN13 format";
}
}
Validator<Book> book = Validator.<Book> builder() //
.constraint(Book::getTitle, "title", c -> c.notBlank() //
.lessThanOrEqual(64)) //
.constraint(Book::getIsbn, "isbn", c -> c.notBlank()//
.predicate(IsbnConstraint.SINGLETON))
.build(); //
Validator<Range> validator = Validator.<Range> builder() //
.constraint(range::getFrom, "from", c -> c.greaterThan(0)) //
.constraint(range::getTo, "to", c -> c.greaterThan(0)) //
.constraintOnTarget(range -> range.to > range.from, "to", "to.isGreaterThanFrom", "\"to\" must be greater than \"from\".") //
.build();
Either<ConstraintViolations, User> either = validator.validateToEither(user);
Optional<ConstraintViolations> violations = either.left();
Optional<User> user = either.right();
HttpStatus status = either.fold(v -> HttpStatus.BAD_REQUEST, u -> HttpStatus.OK);
You can impose a condition on constraints with ConstraintCondition
interface:
Validator<User> validator = Validator.builder(User.class) //
.constraintOnCondition((user, constraintGroup) -> !user.getName().isEmpty(), //
b -> b.constraint(User::getEmail, "email",
c -> c.email().notEmpty())) // <- this constraint on email is active only when name is not empty
.build();
You can group the constraint as a part of ConstraintCondition
with ConstraintGroup
aas well:
enum Group implements ConstraintGroup {
CREATE, UPDATE, DELETE
}
Validator<User> validator = Validator.builder(User.class) //
.constraintOnCondition(Group.UPDATE.toCondition(), //
b -> b.constraint(User::getEmail, "email", c -> c.email().notEmpty()))
.build();
The group to validate is specified in validate
method:
validator.validate(user, Group.UPDATE);
Note that all constraints without conditions will be validated for any constraint group.
By default, some Emojis are not counted as you expect.
For example,
Validator<Message> validator = Validator.<Message> builder() //
.constraint(Message::getText, "text", c -> c.notBlank() //
.lessThanOrEqual(3)) //
.build(); //
validator.validate(new Message("I❤️☕️")).isValid(); // false
If you want to count as you see (3, in this case), use emoji()
.
Validator<Message> validator = Validator.<Message> builder() //
.constraint(Message::getText, "text", c -> c.notBlank() //
.emoji().lessThanOrEqual(3)) //
.build(); //
validator.validate(new Message("I❤️☕️")).isValid(); // true
For the safety (such as storing into a database), you can also check the size as byte arrays
Validator<Message> validator = Validator.<Message> builder() //
.constraint(Message::getText, "text", c -> c.notBlank() //
.emoji().lessThanOrEqual(3)
.asByteArray().lessThanOrEqual(16)) //
.build(); //
validator.validate(new Message("I❤️☕️")).isValid(); // true
validator.validate(new Message("❤️️❤️️❤️️")).isValid(); // false
YAVI will be a great fit for Spring WebFlux.fn
static RouterFunction<ServerResponse> routes() {
return route(POST("/"), req -> req.bodyToMono(User.class) //
.flatMap(body -> validator.validateToEither(body) //
.leftMap(violations -> {
Map<String, Object> error = new LinkedHashMap<>();
error.put("message", "Invalid request body");
error.put("details", violations.details());
return error;
})
.fold(error -> badRequest().syncBody(error), //
user -> ok().syncBody(user))));
}
@PostMapping("users")
public String createUser(Model model, UserForm userForm, BindingResult bindingResult) {
ConstraintViolations violations = validator.validate(userForm);
if (!violations.isValid()) {
violations.apply(BindingResult::rejectValue);
return "userForm";
}
// ...
return "redirect:/";
}
or
@PostMapping("users")
public String createUser(Model model, UserForm userForm, BindingResult bindingResult) {
return validator.validateToEither(userForm)
.fold(violations -> {
violations.apply(BindingResult::rejectValue);
return "userForm";
}, form -> {
// ...
return "redirect:/";
});
}
package com.example
import Validator
import org.springframework.fu.kofu.application
import org.springframework.fu.kofu.web.jackson
import org.springframework.fu.kofu.web.server
val app = application {
server {
port = if (profiles.contains("test")) 8181 else 8080
codecs { jackson() }
router {
POST("/") { req ->
req.bodyToMono(Message::class.java)
.flatMap { message ->
Message.validator.validateToEither(message)
.leftMap { mapOf("details" to it.details()) }
.fold(badRequest()::syncBody, ok()::syncBody)
}
}
}
}
}
data class Message(
val text: String
) {
companion object {
val validator = Validator.builder<Message>()
.constraint(Message::text) {
notBlank().lessThanOrEqual(3)
}
.build()
}
}
fun main(args: Array<String>) = app.run()
package com.example
import Validator
import am.ik.yavi.core.constraint
import am.ik.yavi.core.nest
import io.ktor.application.Application
import io.ktor.application.call
import io.ktor.application.install
import io.ktor.features.ContentNegotiation
import io.ktor.gson.gson
import io.ktor.http.HttpStatusCode
import io.ktor.request.receive
import io.ktor.response.respond
import io.ktor.routing.get
import io.ktor.routing.post
import io.ktor.routing.routing
import java.util.*
fun main(args: Array<String>): Unit = io.ktor.server.netty.EngineMain.main(args)
data class Snippet(val text: String)
data class PostSnippet(val snippet: PostSnippet.Text) {
data class Text(val text: String)
companion object {
val validator = Validator.builder<PostSnippet>()
.nest(PostSnippet::snippet) {
constraint(Text::text) {
notEmpty().lessThanOrEqual(3)
}
}
.build()
}
}
val snippets = Collections.synchronizedList(
mutableListOf(
Snippet("hello"),
Snippet("world")
)
)
@Suppress("unused") // Referenced in application.conf
@kotlin.jvm.JvmOverloads
fun Application.module(testing: Boolean = false) {
install(ContentNegotiation) {
gson {
}
}
routing {
get("/snippets") {
call.respond(mapOf("snippets" to synchronized(snippets) { snippets.toList() }))
}
post("/snippets") {
val post = call.receive<PostSnippet>()
val violations = PostSnippet.validator.validate(post)
if (!violations.isValid) {
call.respond(HttpStatusCode.BadRequest, mapOf("details" to violations.details()))
} else {
snippets += Snippet(post.snippet.text)
call.respond(mapOf("OK" to true))
}
}
}
}
- Java 8+
Licensed under the Apache License, Version 2.0.