Das aktuelle Release von JAX-RS bringt einige interessante Neuerungen für API-Entwickler, wie etwa Unterstützung für HTTP PATCH, Server-sent Events oder das neue reaktive Client-API. In Kombination mit JSON-B geht die Implementierung von APIs damit noch leichter von der Hand.
Auch wenn Frameworks wie Spring Boot aktuell sehr beliebt sind und verbreitet eingesetzt werden, gibt es weiterhin zahlreiche Unternehmen und Projekte, die aus den unterschiedlichsten Gründen ihre Anwendungen auf Basis der APIs implementieren, die als Teil des Java-EE-Standards spezifiziert wurden. Natürlich muss deswegen nicht notwendigerweise ein Java EE Application Server für den Betrieb eingesetzt werden, oft genügen leichtgewichtige Webcontainer wie Tomcat oder Jetty. Aber auch unter den Containern, die den kompletten Java-EE-Standard unterstützen, finden sich zunehmend schlanke Varianten. Wer sich länger nicht über den aktuellen technischen Stand der verfügbaren Lösungen informiert hat, sollte das unbedingt nachholen. Viele Entwickler sind überrascht, wie sehr sich die Java-EE-Welt in den vergangenen Jahren gewandelt hat.
Das letzte Release des Enterprise-Standards, das unter altem Namen veröffentlich wurde, ist Java EE 8. Bekanntlich wurde die Plattform in der Zwischenzeit an die Eclipse Foundation übergeben, wo sie unter dem Namen Jakarta EE [1] weiterentwickelt wird. Mit einem ersten Release von Jakarta EE ist im Laufe dieses Jahres zu rechnen. Allgemein wird erwartet, dass die Plattform fortan in raschem Tempo modernisiert und weiterentwickelt wird. Das MicroProfile-Projekt gibt hierzu einen ersten beeindruckenden Vorgeschmack. Derweil wurde Java EE 8 als Release wahrgenommen, das zwar kleinere Verbesserungen bringt, im Wesentlichen jedoch keine große Weiterentwicklung oder Modernisierung bedeutet. Doch speziell für API-Entwickler hat sich tatsächlich einiges getan. Es lohnt daher, einen Blick auf die aktuellen Versionen der relevanten Spezifikationen zu werfen.
JSON-Unterstützung
Die meisten APIs setzen für den Datenaustausch zurzeit auf das JSON-Format. Bislang ist die JSON-Unterstützung der Java-EE-Plattform jedoch recht rudimentär ausgefallen. Mit JSON-P existiert lediglich ein API zum Parsen und Erstellen von JSON-Objekten auf technischem Abstraktionslevel. Was bislang fehlte, war ein Binding-Mechanismus ähnlich zu JAXB aus der XML-Welt, der eine automatische und transparente Umwandlung zwischen JSON-Konstrukten und (fachlichen) Java-Objekten ermöglicht. Daher kamen in der Vergangenheit i. d. R. proprietäre Frameworks zum Einsatz, z. B. Jackson [2]. Seit dem Release von Java EE 8 steht mit JSON-B nun ein standardisierter Binding-Mechanismus bereit. JSON-B definiert zunächst einen Regelsatz und somit ein Defaultverhalten für die automatische Umwandlung zwischen JSON und Java. Im Wesentlichen beruht dieses Verhalten auf dem Vergleich der Namen von JSON-Attributen und Felder in Java-Objekten. Im einfachsten Fall müssen Entwickler also nichts tun und alles funktioniert wie von selbst. Für alle anderen Fälle standardisiert JSON-B darüber hinaus eine Reihe unterschiedlicher Annotationen, die an fachlichen Java-Klassen bzw. DTOs, ihren Feldern oder Methoden angebracht werden können, um vom Standardfall abweichende Regeln zu hinterlegen. So können z. B. abweichende Feldnamen definiert, die Reihenfolge der Felder festgelegt oder Felder bei der Serialisierung ignoriert werden. Weiterhin ist es möglich zu bestimmen, welches Format bei der Umwandlung eines Datums oder einer Uhrzeit angewandt werden soll oder ob Felder mit dem Wert NULL in JSON darzustellen sind oder nicht. Listing 1 zeigt einige Beispiele.
Listing 1
@JsonbPropertyOrder({"name", "created", "id"})
@JsonbTypeAdapter(RegistrationDetailsAdapter.class)
public class RegistrationDetails {
@JsonbTransient
private Long id;
@JsonbDateFormat("dd.MM.yyyy HH:mm:ss")
private ZonedDateTime created;
@NotNull
private String name;
public Long getId() {
return id;
}
public void setId(Long id) {
this.id = id;
}
public ZonedDateTime getCreated() {
return created;
}
public void setCreated(ZonedDateTime created) {
this.created = created;
}
@JsonbProperty(value="registration_name")
public String getName() {
return name;
}
public void setName(String name) {
this.name = name;
}
}In manchen Fällen ist eine 1:1-Abbildung von Feldern nicht ausreichend, etwa wenn eine Klasse Person in Java zwei separate Felder für Vor- und Nachname besitzt, für die Darstellung einer Person in JSON jedoch nur ein Feld für Vor- und Nachname vorgesehen ist. In diesem Fall müsste von zwei Feldern auf ein Feld abgebildet werden oder umgekehrt. Auch für solche Anforderungen hat JSON-B eine Lösung an Bord: Die Implementierung der Schnittstelle JsonbAdapter erlaubt die Implementierung komplexer Abbildungsvorschriften (Listing 2).
Listing 2
public class RegistrationDetailsAdapter implements JsonbAdapter<RegistrationDetails, JsonObject> {
@Override
public JsonObject adaptToJson(RegistrationDetails details) throws Exception {
return Json.createObjectBuilder()
.add("registrationId", details.getId())
.add("registrationName", details.getName())
.build();
}
@Override
public RegistrationDetails adaptFromJson(JsonObject...
