OVal (Framework)
OVal ist ein Validierungs- und Design-by-Contract-Framework für die Programmiersprache Java. Es ermöglicht die Validierung von Attributen beliebiger Java-Objekte mittels vordefinierter oder selbst geschriebener Constraints. Darüber hinaus erlaubt es auch die Prüfung von Invarianten, Vor- und Nachbedingungen bei Methoden sowie die Validierung von Argumenten von Methoden mittels AspectJ-Aspekten.
| OVal | |
|---|---|
 | |
| Basisdaten | |
| Maintainer | Sebastian Thomschke, Holger Riegel |
| Erscheinungsjahr | 17. August 2005[1] |
| Aktuelle Version | 3.2.0[2] (17. Mai 2021) |
| Betriebssystem | plattformübergreifend |
| Programmiersprache | Java |
| Kategorie | Validierungs- und Design-by-Contract-Framework |
| Lizenz | Eclipse Public License 2.0[3] |
| sebthom.github.io/oval/ | |
Diese Funktionalität und die Tatsache, dass mit OVal beliebige Objekte und nicht nur JavaBeans validiert werden können, hebt OVal von anderen Validierungs- und Design-by-Contract-Frameworks für Java ab.
Funktionalität
Constraints können mittels Annotations (beispielsweise @NotNull, @MaxLength), POJOs oder XML deklariert werden. OVal bietet dafür mehr als 35 eingebaute Constraints an. Eigene Constraints können als Java-Klassen oder mittels Skript-Sprachen wie beispielsweise JavaScript, Groovy, Ruby, BeanShell, OGNL oder MVEL definiert werden. Diese Constraints können nicht nur bei Attributen definiert werden, sondern auch als Vor- oder Nachbedingungen von Methoden bzw. bei Argumenten von Methoden. Da dies in der Java-Syntax derzeit noch nicht vorgesehen ist, verwendet OVal dafür AspectJ-basierte Aspekte. Alternativ dazu können auch Spring-AOP- oder eigene AOP-Implementierungen verwendet werden.
Constraints werden entweder direkt beim Aufruf von Methoden geprüft (Vor- und Nachbedingungen, Constraints auf Argumente von Methoden, Invarianten) oder mittels validator.validate(Object) auf dem gesamten Objekt. Die Prüfung von Vor- und Nachbedingungen sowie die Prüfung der Invarianten kann (beispielsweise aus Performancegründen) global an- und abgestellt werden. Darüber hinaus können Constraint-Profile verwendet werden, um in unterschiedlichen Situationen unterschiedliche Constraints zu prüfen.
OVal selbst ist nur von der Java-Klassenbibliothek abhängig. Weitere Jars müssen nur bei Bedarf zugelinkt werden. (Beispielsweise AspectJ für Design by Contract, XStream, wenn OVal mittels XML konfiguriert wird oder JRuby wenn Constraints mittels Ruby definiert werden.)[4]
Beispiel
Deklaration:
// Die Parameter der Konstruktoren und Setter-Methoden werden mittels AspectJ analog zu den Constraints der Attribute geprüft.
@net.sf.oval.guard.Guarded(applyFieldConstraintsToConstructors=true, applyFieldConstraintsToSetters=true)
public class BusinessObject {
// Das Attribut name darf weder null, noch leer sein und darf maximal 32 Zeichen lang sein.
@NotNull @NotEmpty @Length(max=32)
private String name;
...
// Das Attribut mailingAddress muss entweder gleich der deliveryAddress oder der invoiceAddress sein.
// Dies wird mittels eines Groovy-Skriptes geprüft.
@Assert(expr = "_value ==_this.deliveryAddress || _value == _this.invoiceAddress", lang = "groovy")
private String mailingAddress;
...
// Der Parameter name wird automatisch analog wie das Attribut name geprüft,
// da für die ganze Klasse "applyFieldConstraintsToSetters" gesetzt wurde.
public void setName(String name) {
this.name = name;
}
...
// Vor dem Aufruf der Methode wird mittels eines Groovy-Skriptes sichergestellt, dass this.amount nicht null ist und
// amount2add größer als this.amount ist.
@Pre(expr = "_this.amount!=null && amount2add>_this.amount", lang = "groovy")
public void increase(BigDecimal amount2add) {
amount = amount.add(amount2add);
}
}
Verwendung:
...
BusinessObject bo = new BusinessObject();
bo.setName("" target="_blank" rel="nofollow"); // Wirft eine ConstraintsViolatedException weil der Parameter leer ist.
...
bo.increase(null); // Wirft eine Exception, wenn this.amount noch nicht gesetzt wurde.
...
List<ConstraintViolation> violations = validator.validate(bo); // Liefert die Liste aller Verletzungen.
Geschichte
OVal wurde von Sebastian Thomschke aus der Motivation heraus gestartet, ein Framework zu haben, welches Java um einfache Techniken zur Validierung und Design by Contract – basierend auf denselben Constraints – erweitert. Darüber hinaus wollte er ein Validierungs-Framework haben, welches auf Annotations basiert, damit bei der Refaktorisierung die Validierungen automatisch mit den Attributen und Methoden mitbewegt werden. Diese Features sind auch heute noch Alleinstellungsmerkmale von OVal.
Die erste Version von OVal (0.1alpha) wurde am 17. August 2005 veröffentlicht. Diese Version ermöglichte bereits die Validierung von Argumenten und Rückgabewerten mittels AspectJ. Die Version 1.0 wurde am 22. Juli 2007 veröffentlicht. Sie enthielt unter anderem eine Reihe an weiteren Constraints sowie Unterstützung für das Skripten von eigenen Constraints. Ab Version 1.50 kann OVal die Standard JSR303 Constraints interpretieren und entsprechend validieren. Ab Version 1.60 können Constraints für Methodenargumente bereits auf Interface-Ebene deklariert werden. Ab Version 1.70 kann OVal über das Spring Framework konfiguriert werden. Ab der Version 1.82 wird JSR223 scripting unterstützt. Ab der Version 1.90 Bean Validation 2.0 Constraints.[5]
Verschiedene Frameworks wie Struts 2 OVal Plug-in, Play! Framework oder Apache Cayenne annotations verwenden OVal.[6]
OVal 1 wurde seit 2005 allein von der Sourceforge-Seite mehr als 18.000 Mal heruntergeladen.[7] Üblicherweise werden Open-Source-Java-Frameworks aber über Maven-Repositories bezogen. Oval ist ab Version 2.1.X im JFrog Bintray Repository zu finden.[8]
Mit der Version 1.86 wechselte OVal 2016 von sourceforge auf github.[9] Ab der Version 2.0.0 vom Mai 2019 benötigt OVal mindestens Java 8. Für OVal 1 ist mindestens Java 5 nötig.[10] Die letzte Version von OVal 1 ist 1.90 vom 29. Oktober 2017.[11]
Alternativen
Validierungsframeworks:
- Apache Commons Validator – Apache-Commons-Projekt zur Bean-Validierung
- Hibernate Validator
- Spring Modules Validator – Spring Modules (Erweiterung zu Spring) Projekt zur Bean-Validierung
- JValidate – Beans Validation
- JValidations – Object Validation
- Mit Java 7 wurde das sogenannte Bean Validation Framework (JSR 303) eingeführt, damit ist Bean-Validierung (nicht Objekt- und auch nicht Parameter-Validierung) ein Bestandteil von Java. Die Validierung selbst muss aber an geeigneter Stelle angestoßen werden – beispielsweise beim Speichern von Beans in der Datenbank mittels Hibernate.
- Frameworks zur Umsetzung des Design-by-Contract-Prinzips in Java
- Es gibt eine Reihe von Design-by-Contract-Frameworks für Java, wenige davon, wie z. B. Contracts for Java (Cofoja), scheinen aber noch aktiv zu sein. Eine Auflistung aller Design-by-Contract-Frameworks für Java findet sich unter en:Design by contract#Languages with third-party support in der englischsprachigen Wikipedia.
Literatur
- Andrew Glover: In pursuit of code quality: Defensive programming with AOP. IBM developerworks, 30. Januar 2007 auf
- Eric Lewis: Bean-Validierung mit OVal. In: Java Magazin, 04/2011
- Majid Aghaei: An experimental evaluation of Java Design-by-Contract extensions (Master Thesis) University of Oulu, Finnland, 10. Dezember 2018
Weblinks
Einzelnachweise
- sourceforge.net.
- Release 3.2.0. 17. Mai 2021 (abgerufen am 17. Juni 2021).
- sebthom.github.io.
- OVal Dependencies
- OVal Changelog
- OVal References
- OVal Download Statistics
- https://bintray.com/sebthom/maven/oval
- https://github.com/sebthom/oval/releases
- https://sebthom.github.io/oval/
- https://sourceforge.net/projects/oval/files/oval/