From baece734102f089428dd217d543e77b95f9ea8db Mon Sep 17 00:00:00 2001 From: gregor Date: Tue, 24 May 2005 07:07:57 +0000 Subject: =?UTF-8?q?Kapitel=20=C3=BCber=20API=20(3)=20hinzugef=C3=BCgt.?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit git-svn-id: https://joinup.ec.europa.eu/svn/moa-idspss/trunk@329 d688527b-c9ab-4aba-bd8d-4036d912da1d --- spss.handbook/handbook/usage/usage.html | 26 +++++++++++++++++++++----- 1 file changed, 21 insertions(+), 5 deletions(-) diff --git a/spss.handbook/handbook/usage/usage.html b/spss.handbook/handbook/usage/usage.html index f355a5676..09424955e 100644 --- a/spss.handbook/handbook/usage/usage.html +++ b/spss.handbook/handbook/usage/usage.html @@ -61,10 +61,10 @@
  • Verwendung der Klassenbibliothek
      -
    1. Voraussetzungen
      2. -
    2. Aufbau der API
      3. -
    3. Erstellen einer XML-Signatur
      4. -
    4. Prüfen einer XML-Signatur
      5. +
    5. Vorbereitung
      6. +
    6. Allgemeines
      7. +
    7. Beispiele
      8. +
    8. API-Dokumentation
    • @@ -1151,7 +1151,23 @@ Ich habe weiters ein eigenens ID-Attribut bekommen.</doc:Paragraph>

    Die gegenüber Abschnitt 2.2.3 zusätzlich notwendige Konfiguration von JSSE (Speicher für das SSL-Client-Zertifikat sowie den dazugehörigen privaten Schlüssel, Typ dieses Speichers, Passwort für diesen Speicher) wird mittels zusätzlicher Parameter in der in Abschnitt 2.2.2 besprochenen Java-Properties-Datei vorgenommen. Genaue Infos zu diesen Konfigurationsparametern entnehmen Sie bitte der Quellcodedokumentation von HTTPSClientAuth.java. http.properties enthält eine auf dieses Handbuch abgestimmte Konfiguration.

    Beachten Sie bitte auch den Hinweis zum JSSE Logging aus Abschnitt 2.2.3.

    3 Verwendung der Klassenbibliothek

    -

    abschnitt aus alter doc übernehmen

    +

    Neben dem Betrieb von MOA SP/SS als Webservice ist als Alternative auch die Verwendung von MOA SP/SS als Klassenbibliothek möglich, also die direkte Einbindung in ein Java-Programm unter Verwendung des Application Programmers Interface (API) von MOA SP/SS.

    +

    3.1 Vorbereitung

    +

    Um das API von MOA SP/SS verwenden zu können, müssen einerseits die MOA-Bibliotheken selbst, andererseits eine Reihe von unterstützenden Bibliotheken in den Klassenpfad aufgenommen werden. Eine Übersicht dazu finden Sie im Installationshandbuch im Abschnitt 3. +

    3.2 Allgemeines

    +

    Der strukturelle Aufbau der API entspricht weitgehend der Struktur eines MOA-XML-Requests. Es werden daher in diesem Abschnitt nur zwei grundlegende Beispiele gebracht; für komplexere Aufgaben können die XML-Beispiele aus Abschnitt 2.1 als Vorlage verwendet und einfach in die "API-Welt" übertragen werden. +

    3.3 Beispiele

    +

    Dieses Handbuch enthält zwei Beispiele für die Verwendung der API von MOA SP/SS: +

      +
    1. CreateXMLSignature.java: Erstellung einer einfachen XML-Signatur; dieses Beispiel entspricht dem MOA-XML-Request aus Abschnitt 2.1.1.1.
      + Die Konfiguration der API erfolgt über Kommandozeilenparameter (Lage der Konfigurationsdatei für MOA SP/SS, Lage der Konfigurationsdatei für das Logging mit Log4j). Detaillierte Informationen dazu finden Sie in der Quellcodedokumentation des Beispiels.
      2. +
    2. VerifyXMLSignature.java: Prüfung einer einfachen XML-Signatur; dieses Beispiel entspricht dem MOA-XML-Request aus Abschnitt 2.1.3.1.
      + Die Konfiguration der API erfolgt über Kommandozeilenparameter (Lage der Konfigurationsdatei für MOA SP/SS, Lage der Konfigurationsdatei für das Logging mit Log4j). Detaillierte Informationen dazu finden Sie in der Quellcodedokumentation des Beispiels.
      + Die Auswahl der zu prüfenden Signatur erfolgt ebenfalls per Kommandozeilenparameter. Detaillierte Informationen dazu finden Sie ebenfalls in der Quellcodedokumentation des Beispiels.
      3. +
    +

    3.4 API-Dokumentation

    +

    Für die vollständige Dokumentation des API von MOA SP/SS sei auf die Java Doc der API verwiesen. +

    A Referenzierte Software

    Auf folgende Software-Pakete wird in diesem Handbuch verwiesen:

    -- cgit v1.2.3