|
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. 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ätConstraints können mittels Annotations (beispielsweise Constraints werden entweder direkt beim Aufruf von Methoden geprüft (Vor- und Nachbedingungen, Constraints auf Argumente von Methoden, Invarianten) oder mittels 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] BeispielDeklaration: // 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(""); // 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.
GeschichteOVal 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] AlternativenValidierungsframeworks:
Literatur
WeblinksEinzelnachweise
|
||||||||||||||||||||||
Portal di Ensiklopedia Dunia
