Hibernate Validator Plus

🌍 选择语言/Select Language:

• 中文
• English

Hibernate Validator Plus is an enhanced validation framework based on Hibernate Validator, providing rich validation annotations, flexible group validations, and unified validation utilities.

📦 Features: - Built-in commonly used validation annotations (account, password, ID card, IPv4, etc.) - Multiple built-in validation group schemes - International i18n, supports Chinese, English, Japanese, Chinese, Russian, French, Spanish, etc.. - Built-in allowable null judgment - It remains fully compatible with the Hibernate Validator native framework and can directly use all its built-in validation functions. - There are fewer dependencies, the architecture is more lightweight, and there is no forced dependence on other frameworks (such as spring). - Supports the direct introduction of Spring MVC and Spring Boot projects, can automatically verify, and provides manual calling of tool classes. - Support jdk8 or jdk8 or above version

📌 Versions

versions_en.md

📘 Annotation Overview

Location: annotation

Supports verification of amount formats of numbers, strings or BigDecimal types | | @CMacAddress | Mac Address Validation | Mac Address Validation |

📂 Validation Groups

Location: groups

🔧 CValid Utility Class

CValid provides multiple validation capabilities, including standard validation(Full Check), fast-fail validation, property-level validation, and group-based validation.

Exception Class：ValidationException

validate(Object object, Class<?>... groups) | Fast-Fail ⚡ | Throws Exception ❗ | void | | tryValidate(Object object)

tryValidate(Object object, Class<?>... groups) | Full Check | No Exception | List | | tryFastValidate(Object object)

tryFastValidate(Object object, Class<?>... groups) | Fast-Fail ⚡ | No Exception | String | | validateProperty(Object object, String propertyName, Class<?>... groups) | Fast-Fail ⚡ | Throws Exception ❗ | void | | tryValidateProperty(Object object, String propertyName, Class<?>... groups) | Full Check | No Exception | List | | tryFastValidateProperty(Object object, String propertyName, Class<?>... groups) | Fast-Fail ⚡ | No Exception | String |

🛠 Usage Example

Demo Spring Boot project:
🔗 https://github.com/carpcap/hibernate-validator-plus-demo

1. Maven Dependency

<dependency>
    <groupId>com.carpcap</groupId>
    <artifactId>hibernate-validator-plus</artifactId>
    <version>1.2.2</version>
</dependency>

Validate according to different groups

Declare validation groups:

Automatic validation through Spring MVC:

Manual validation using the provided utility class. Validation failures will throw ValidationException:

📜 License

This project is released under the Apache License 2.0.

You can find the full license text in the project's root directory (LICENSE), or visit:

https://www.apache.org/licenses/LICENSE-2.0