# oval

**Repository Path**: mirrors_andyglick/oval

## Basic Information

- **Project Name**: oval
- **Description**: OVal - the object validation framework for Java
- **Primary Language**: Unknown
- **License**: EPL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2020-09-24
- **Last Updated**: 2026-03-21

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# OVal - the object validation framework for Java

[![Build Status](https://travis-ci.com/sebthom/oval.svg?branch=master)](https://travis-ci.com/sebthom/oval)
[![License](https://img.shields.io/badge/License-Eclipse%20Public%20License%202.0-blue.svg)](LICENSE.txt)
[![Changelog](https://img.shields.io/badge/changelog-blue)](CHANGELOG.md)
[![Download](https://api.bintray.com/packages/sebthom/maven/oval/images/download.svg)](https://bintray.com/sebthom/maven/oval/_latestVersion)

[comment]: # (https://img.shields.io/github/license/sebthom/oval.svg?label=License)

1. [What is it?](#what-is-it)
1. [Java Compatibility](#compatibility)
1. [User Guide](#user-guide)
1. [Articles about OVal](#articles-about-oval)
1. [Projects using OVal](#projects-using-oval)
1. [License](#license)


## <a name="what-is-it"></a>What is it?

![logo](src/site/resources/images/oval-banner.png)

OVal is a pragmatic and extensible validation framework for any kind of Java objects (not only JavaBeans).
Constraints can be declared with annotations (`@NotNull`, `@MaxLength`), [POJOs](https://en.wikipedia.org/wiki/Plain_old_Java_object) or XML.

Custom constraints can be expressed as custom Java classes or by using scripting languages such as [JavaScript](https://github.com/mozilla/rhino), [Groovy](http://groovy-lang.org/),
[BeanShell](http://www.beanshell.org/), [OGNL](https://github.com/jkuhnert/ognl) or [MVEL](https://github.com/mvel/mvel).

Besides field/property validation OVal implements [Programming by Contract](https://en.wikipedia.org/wiki/Design_by_contract) features by utilizing [AspectJ](https://www.eclipse.org/aspectj/doc/next/progguide/starting-aspectj.html) based aspects or via [Spring AOP](https://docs.spring.io/spring/docs/current/spring-framework-reference/core.html). This for example allows runtime validation of constructor/method arguments.


## <a name="compatibility"></a>Java Compatibility

OVal 1.x requires Java 5 or newer.

OVal 2.x requires Java 8 or newer.


## <a name="user-guide"></a>User Guide

The user guide is available [USERGUIDE.md](./USERGUIDE.md)


## <a name="articles-about-oval"></a>Articles about OVal

There exist some articles and blog entries talking about and/or referencing OVal:

- Wikipedia (DE): OVal (Framework) \
 <https://de.wikipedia.org/wiki/OVal_(Framework)> [\[English
    Translation\]](https://translate.google.com/translate?sl=de&tl=en&u=https%3A%2F%2Fde.wikipedia.org%2Fwiki%2FOVal_%28Framework%29)

- An Experimental Evaluation of JavaDesign-by-Contract Extensions (2018) \
  <http://jultika.oulu.fi/Record/nbnfioulu-201812063243>

- GlueCoders' Spring Boot Guide: Validation of Request Models using OVal (2017) \
  <https://github.com/GlueCoders/springboot-guide-docs/blob/master/requestvalidation-oval.md>

- A Constraint-Based Approach to Data Quality in Information Systems (2017) \
  <https://www.research-collection.ethz.ch/bitstream/handle/20.500.11850/198644/1/Thesis-DavidWeber.pdf>

- How to integrate Oval validation with Spring 3 (2013) \
  <http://maheshjq.blogspot.com/2013/08/how-to-integrate-oval-validation-with.html>

- OVal - validate your models quickly and effortlessly (2011) \
  <https://touk.pl/blog/2011/07/14/oval-validate-your-models-quickly-and-effortlessly/>

- A Valid Point (2011) \
  <http://www.grinshpoon.com/pblog/2011/06/29/a-valid-point/>

- Validaciones: Hibernate Validator vs OVal (2010) \
  <https://unpocodejava.com/2010/05/07/validaciones-hibernate-validator-vs-oval/>
 [\[English
    Translation\]](https://translate.google.com/translate?sl=es&tl=en&u=https%3A%2F%2Funpocodejava.com%2F2010%2F05%2F07%2Fvalidaciones-hibernate-validator-vs-oval%2F)

- Enkel validering av Java-objekter med OVal (2010) \
  <http://open.bekk.no/enkel-validering-av-java-objekter-med-oval>

- Oval Validation Framework (2010) \
  <http://vathzala.blogspot.de/2010/03/oval-validation-framework.html>

- OVal - Object Validation With POJO (2009) \
  <https://bitsofwizardry.wordpress.com/2009/04/14/oval-object-validation-with-pojo/>

- Diseño por Contrato con OVal y Spring \[Design by Contract with OVal and Spring\] (2009) \
  <https://dosideas.com/noticias/java/562-diseno-por-contrato-con-oval-y-spring> [\[English
    Translation\]](https://translate.google.com/translate?hl=&sl=es&tl=en&u=https%3A%2F%2Fdosideas.com%2Fnoticias%2Fjava%2F562-diseno-por-contrato-con-oval-y-spring)

- An Aspect-Oriented Infrastructure for Design by Contract in Java \
  <https://www.semanticscholar.org/paper/An-Aspect-Oriented-Infrastructure-for-Design-by-in-Agostinho/0afb0c0a025b3deb6bb8565ce966bc7ef02e01e5>

- OVal Blog Entry Series at the "JEE, BPEL, SOA" blog (2008) \
  - [JSR 303 and OVal Validation
  Framework](https://lukaszbudnik.blogspot.com/2008/12/jsr-303-and-oval-validation-framework.html)
  - [OVal and
    profiles](https://lukaszbudnik.blogspot.com/2008/12/oval-and-profiles.html)
  - [Spring Web Flow 1 piecemeal validation and OVal
    integration](https://lukaszbudnik.blogspot.com/2008/12/springs-piecemeal-validation-and-oval.html)

- Pre and post condition validation with OVal as intruments of software architecture (2008) \
  <https://stigl.wordpress.com/2008/07/19/pre-and-post-condition-validation-with-oval-as-intruments-of-software-architecture/>

- OVal: The simple validation framework for Java (2008) \
  <http://takezoe.blogspot.com/2008/03/oval-simple-validation-framework-for.html>

- Validación Java: OVal, una joya escondida (2007) \
  <http://brigomp.blogspot.com/2007/09/hay-veces-que-los-frameworks-menos.html>

- Die Pro-Pix Homepage - Design by Contract (2007) \
  <http://pro-pix.de/joomla/index.php?option=com_content&task=view&id=39&Itemid=1>

- In pursuit of code quality: Defensive programming with AOP (2007) \
  <http://www.ibm.com/developerworks/library/j-cq01307/>

- OVal e la validazione degli oggetti in Java (2006) \
  <http://www.keepintech.it/2006/12/22/oval-e-la-validazione-degli-oggetti-in-java/>

- Limiting conditional complexity with AOP (2006)\
  <https://nofluffjuststuff.com/blog/paul_duvall/2006/12/limiting_conditional_complexity_with_aop>

## <a name="projects-using-oval"></a>Projects using OVal

- Arena Persistence <http://arena-pers.uqbar.org/>
- Jadira Framework <http://jadira.sourceforge.net/>
- Omniproperties - a lightweight configuration utility <https://github.com/siemens/omniproperties>
- fustewa - A full web stack based on Spring <https://github.com/opensource21/fuwesta>
- eSciDoc <https://www.escidoc.org/>
- SaferJava <http://code.google.com/p/saferjava/>
- JProvocateur <http://www.jprovocateur.org/>
- NexOpen <https://sourceforge.net/projects/nexopen/>
- gdv.xport <https://github.com/oboehm/gdv.xport>
- suz-lab-gae <http://code.google.com/p/suz-lab-gae/>
- Cubby Simple Web Application Framework <http://cubby.seasar.org/20x/cubby-oval/index.html>
- Metawidget <https://github.com/metawidget/metawidget>
- Struts 2 OVal Plug-in <http://cwiki.apache.org/confluence/display/S2PLUGINS/OVal+Plugin>
- Play! Framework 1.x <http://www.playframework.org/>
- Cayenne annotations <http://sourceforge.net/projects/cayannotations/>
- jsfatwork <http://code.google.com/p/jsfatwork/>
- mtn4java <http://www.mvnrepository.com/artifact/org.criticalsection.mtn4java/mtn4java/>
- Polyforms <http://code.google.com/p/polyforms/>
- rsser <http://code.google.com/p/rsser/>
- saetc <http://code.google.com/p/saetc/>
- ultimate-roundtrip <http://code.google.com/p/ultimate-roundtrip/>


## <a name="license"></a>License

All files are released under the [Eclipse Public License 2.0](LICENSE.txt).