Die Bibliotheken des enaio® java-api package stellen den Zugriff auf die Funktionalitäten von enaio^® server für Applikationen in der Programmiersprache Java zur Verfügung. Sie ermöglichen den Aufruf beliebiger Jobs, die im Handbuch enaio^® server-api dokumentiert sind.

Die Java API gliedert sich in verschiedene Bibliotheken (JARs), die aufeinander aufbauen:

• enaio-rpc
  Client-seitige Implementierung des Protokolls enaio® RPC zum Aufruf von Jobs und Lauschen auf Benachrichtigungen durch enaio® server.

• enaio-jobs
  Client-seitige Session-Verwaltung (inkl. Benutzeranmeldung), Load-Balancing und Hilfsklassen für einige Jobs, sowie Exceptions für Fehler, die bei der Job-Abarbeitung durch enaio® gemeldet werden können.

• enaio-beans
  Objekt-orientierte Modellierung zentraler Datensätze, insbesondere aus dem Umfeld von enaio®: Dokumente, Ordner, Register und deren Felder. Sowie Unterstützung der Operationen zur Suche nach DMS-Objekten und zum Anlegen, Ändern und Löschen derselben.

Die Bibliotheken setzen Java 1.8 (oder höher) voraus. 

Die Versionierung der Bibliotheken der enaio^® Java API ist losgelöst von der Versionierung von enaio^®. Die Bibliotheken sind im Wesentlichen kompatibel zur Version 9.0 von enaio^® server. Sofern enaio^® server in der Version 9.10 oder höher verwendet wird, müssen die Bibliotheken 'enaio-rpc' und 'enaio-jobs' in den Versionen 2.8 oder höher eingesetzt werden. Diese Version unterstützt TLS/SSL und Unicode.
Sofern enaio^® server so konfiguriert ist, dass in den Clients TLS 1.3 gefordert wird, und Java 1.8 im Einsatz ist, sollte ab enaio^® Version 10.10 die Bibliothek 'enaio-rpc' in der Version 2.9.0 verwendet werden.

Vergleich mit JDL

Bis zur Version 8.10 von enaio^® war die offizielle Schnittstelle für Java-Clients eine andere Familie von Bibliotheken, deren zentrales Element die jdl.jar war. Die Bibliotheken um JDL werden seither nicht mehr gepflegt. Insbesondere unterstützen sie nicht die mit enaio^® 9.10 eingeführte TLS/SSL-Verschlüsselung beim RPC-Protokoll und Änderungen der Parameter diverser Jobs, die wegen der Umstellung auf Unicode notwendig waren. Bestehende Java-Applikationen müssen deshalb von JDL nach enaio-rpc & Co. migriert werden.

Übersicht der alten Bibliotheken und deren neues Pendant:

Die Abdeckung von Jobs in jdl ist erheblich umfangreicher als in enaio-jobs. Allerdings ist es mit den neuen Bibliotheken einfacher, Methoden für weitere Jobs zu implementieren, da die API von enaio-rpc intuitiver als bei AppSrvProxy ist.

Der Funktionsumfang von enaio-beans lässt sich nur bedingt mit objbrdg vergleichen. objbrdg funktioniert weitgehend auch mit den neuen Bibliotheken.

Die neuen Bibliotheken bieten kein Pendant zur alten workflow.jar.