Konzept HttpInvoker

Spring HTTP Invoker ist ein leichtgewichtiges Protokoll, das transparente Service-Aufrufe zwischen Java-Anwendungen ermöglicht. Es verwendet hauptsächlich die Standardmechanismen von Java zur Serialisierung und stellt Services über HTTP bereit.

Dieses Dokument konzentriert sich auf die konzeptionellen Aspekte der Verwendung von HTTP Invoker. Es sorgt dafür, dass Services in allen IT-Systemen gleichartig umgesetzt werden und grundlegende Anforderungen an die Erstellung und Nutzung von Services eingehalten werden.

Das Dokument richtet sich vor allem an Software-Architekten und beschreibt, wie ein IT-System mit einer Service-Schnittstelle basierend auf HTTP Invoker versehen wird, oder solche Schnittstellen aufruft. Dabei vertieft es die Grundlagen, die im Detailkonzept Komponente Service beschrieben werden und wendet sie auf das Service-Framework HTTP Invoker an.

Das Dokument erläutert im Kapitel Kommunikation mit HTTP Invoker zunächst die Grundlagen, Rahmenbedingungen und Beschränkungen des Einsatzes von HTTP Invoker. Danach beleuchtet das Kapitel Aufbau der Servicelogik, wie die Komponente Service architektonisch mit HTTP Invoker aufgebaut ist. Im Kapitel Auslieferung einer Service-Schnittstelle geht es darum, wie HTTP Invoker Schnittstellen ausgeliefert werden und was dabei zu beachten ist. Schließlich zeigt das Dokument noch Vorgaben zu den Themen Versionierung und Namenskonventionen auf.

IT-Systeme können HTTP Invoker zur Kommunikation mit anderen IT-Systemen innerhalb der Systemlandschaft einsetzen. Das aufgerufene IT-System exportiert seine Service-Schnittstellen in Form von HTTP Invoker Schnittstellen und das aufrufende IT-System ruft diese direkt auf. Da HTTP Invoker auf serialisierten Java-Objekten basiert, können ausschließlich Java-basierte IT-Systeme miteinander kommunizieren. Die Kommunikation mit HTTP Invoker verläuft außerdem synchron. Asynchrone Kommunikation ist von HTTP Invoker nicht vorgesehen und wird im Weiteren auch nicht beschrieben.

Um eine möglichst lose Kopplung der IT-Systeme zu erreichen, werden folgende Festlegungen getroffen:

IT-Systeme definieren für ihre HTTP Invoker Schnittstellen u. a. das Remote-Bean, alle direkt und indirekt verwendeten Transportobjekte sowie alle über die Schnittstelle transportierten Exceptions. Es stellt diesen Teil der HTTP Invoker Schnittstelle als Bibliothek anderen IT-Systemen zur Verfügung, sodass diese die Schnittstelle aufrufen können. Es ergibt sich so folgendes Szenario für einen Aufruf einer HTTP Invoker Schnittstelle (siehe Abbildung 1).

Der Baustein Http Invoker ergänzt die Servicelogik um ein Remote-Bean. Der Aufbau der Servicelogik ist in Abbildung 2 dargestellt.

Im Wesentlichen besteht die Servicelogik also aus drei Klassen, die im Folgenden näher beleuchtet werden.

Das Remote-Bean wird mit allen direkt oder indirekt verwendeten Transportobjekten in einer eigenständigen Bibliothek paketiert, damit IT-Systeme die Schnittstellendefinitionen direkt mit ihren Aufrufern austauschen können. Die Bibliothek enthält:

Diese Klassen werden üblicherweise in einer Bibliothek pro Service bereitgestellt. Die Maven-Koordinaten der Bibliothek sehen wie folgt aus:

Die Bibliothek wird abweichend von anderen Software-Artefakten versioniert. Die ersten beiden Teile der Versionsnummer (Major und Minor Version) sind Teil der Artefakt-ID, um mehrere Versionen einer Schnittstelle gleichzeitig einbinden zu können. Der dritte Teil der Versionsnummer (Patch Version) bildet die Maven-Versionsnummer des Artefakts.

Durch diese enge Kopplung zwischen mehreren IT-Systemen spielt die Java-Version, mit der die Schnittstellen-Bibliotheken kompiliert wurden, eine zentrale Rolle. Sie darf nicht neuer sein als die Java-Version aller beteiligter IT-Systeme. Es wird daher empfohlen, Schnittstellen mit der ältesten Java-Version zu kompilieren und auszuliefern, die für IT-Systeme verwendet werden darf.

Eine HTTP Invoker Schnittstelle vereint mehrere Service-Methoden in einem Remote-Bean. Für die Versionierung bedeutet das, dass stets die komplette Remote-Bean-Schnittstelle versioniert wird und nicht die einzelnen Methoden der Remote-Bean-Schnittstelle.

Die Service-URLs der HTTP Invoker Schnittstellen müssen einheitlich nach folgendem Schema aufgebaut sein.