https://github.com/codedust/ocsi-bibliothek-java

https://github.com/codedust/ocsi-bibliothek-java

Last synced: 12 days ago
JSON representation

• Host: GitHub
• URL: https://github.com/codedust/ocsi-bibliothek-java
• Owner: codedust
• License: other
• Created: 2024-04-18T18:16:45.000Z (almost 2 years ago)
• Default Branch: main
• Last Pushed: 2024-04-18T19:06:38.000Z (almost 2 years ago)
• Last Synced: 2025-04-09T08:46:48.356Z (10 months ago)
• Language: HTML
• Size: 11.1 MB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.txt
  • License: LICENSE.txt

Awesome Lists containing this project

README

          
Readme zur OSCI-Bibliothek in der Version 2.4.1

===============================================

Kontakt

-------

| Governikus GmbH & Co. KG

| Hochschulring 4

| 28359 Bremen

| osci@governikus.de

Lizenz

------

Mit der Spezifikation des OSCI 1.2-Protokolls wird ein sicheres,

herstellerunabhängiges und interoperables Datenaustauschformat beschrieben.

Um die Implementierung für Anwender in der öffentlichen Verwaltung sowie der

Fachverfahrenshersteller zu erleichtern, stellen wir im Kontext der Anwendung

Governikus des IT-Planungsrates die OSCI Bibliothek zum Download unter der EUPL-Lizenz

zur Verfügung. Erfolgt die Integration der OSCI Bibliothek in unveränderter Form,

liegt keine Bearbeitung im Sinne der EUPL bzw. des deutschen Urheberrechts vor.

Die Art und Weise der Verlinkung der OSCI Bibliothek innerhalb einer Implementierung

führt insbesondere nicht zur Schaffung eines abgeleiteten Werkes. Die unveränderte

Übernahme der OSCI Bibliothek in eine Fachverfahrens- und/oder Clientsoftware führt

damit nicht dazu, dass dies Fachverfahrens- und/oder Clientsoftware unter den

Bedingungen der EUPL zu lizenzieren ist. Für die Weitergabe der OSCI Bibliothek selbst,

in unveränderter oder bearbeiteter Form, als Quellcode oder ausführbares Programm,

gelten die Lizenzbedingungen der EUPL in unveränderter Weise.

Der mitgelieferte Quellcode wird unter der EUPL v1.2 

bereitgestellt, mit Ausnahme der Bibliotheken BouncyCastle 

und Commons-Logging. Informationen zu den Lizenzen sind der Datei 

LICENSE.txt zu entnehmen.

Inhalt des Archivs

------------------

In diesem Archiv finden Sie die OSCI-Bibliothek in der

Version 2.4.1. Die vorliegende OSCI-Bibliothek setzt die

OSCI-Transport 1.2-Spezifikation um. Die OSCI-Spezifikation wird

durch die Koordinierungsstelle für IT-Standards (KoSIT)

herausgegeben. Die Spezifikationsdokumente finden Sie auf den

Seiten der KoSIT unter

https://www.xoev.de/downloads-2316#Standards

Enthalten ist folgendes:

- die eigentliche Java-Version der OSCI-Bibliothek (/lib)

- die Quellen der OSCI-Bibliothek (/src)

- die API-Dokumentation (/apidoc)

- die Funktionsbeschreibung (Funktionsbeschreibung.pdf)

- die Versionshistorie (OSCI-Bibliothek_Versionshistorie.pdf)

- und Anwendungsbeispiele (/beispielanwendung).

Die vorliegende OSCI-Bibliothek ist in JAVA implementiert. Alle

benötigten JAVA-Archive befinden sich im Verzeichnis /lib.

Dieses Verzeichnis beinhaltet neben der eigentlichen

OSCI-Bibliothek (osci-bibliothek.jar) zusätzliche externe JAVA-Archive

(jar-Dateien), die für den Betrieb der OSCI-Bibliothek notwendig

sind und im Classpath der Anwendung eingetragen sein müssen:

- commons-logging.jar

  Das Archiv commons-logging.jar in der Version 1.2 

  stammt aus dem Apache Commons Project

  (siehe http://commons.apache.org/proper/commons-logging/)

  und ermöglicht die Anbindung verschiedener Logging-APIs.

  Die optionale Konfiguration kann der zugehörigen Dokumentation

  entnommen werden. Mit der Default-Einstellung wird der

  JAVA-eigene Logging-Mechanismus verwendet.

- bcprov-jdk18on.jar

  Das Archiv bcprov-jdk18on.jar in der Version 1.76 entstammt

  ebenfalls einem Open-Source Projekt (Bouncy Castle,

  http://www.bouncycastle.org) und beinhaltet einen JCE

  (Java Cryptography Extension)-Provider.

- javax.servlet-api.jar

  Das Archiv javax.servlet-api.jar in der Version 4.0.1 enthält

  die Java Servlet API (https://javaee.github.io/servlet-spec/)

  und wird ausschließlich für eines der Code-Beispiele benötigt.

Die folgenden Bibliotheken werden ausschließlich für die Verarbeitung des

MessageMetaData-Custom-Headers benötigt:

- xsd-osci-messagemetadata.jar

  Das Archiv enthält die generierten MessageMetaData-v2.0.2-Klassen, die für die programmatische

  Anbindung des Custom-Headers benötigt werden

- jakarta.activation-api.jar und jakarta.activation.jar

  Die Archive in der Version 1.2.2 enthalten die Jakarta-Activation-Bibliothek

  (https://jakarta.ee/specifications/activation/1.2/)

- jakarta.xml.bind-api.jar und jaxb-impl.jar

  Die Archive in den Versionen 2.3.3 (API) und 2.3.7 (Implementierung)

  enthalten die Jakarta-JAXB-API und deren Implementierung (https://javaee.github.io/jaxb-v2/)

- xsd-xoev-basisdatentypen.jar, xsd-ws-addr.jar und xsd-oasis-200401-wss-wssecurity-secext.jar

  Diese Archive enthalten weitere generierte Klassen, die für die Benutzung der

  MessageMetaData-Klassen benötigt werden

Hinweise zum JDK

----------------

Die zur Ausführung benötigte Java-Umgebung (ab JDK 1.8 inkl. JDK 11 und 17)

ist über die Homepage von Oracle zu erhalten.

Bitte beachten Sie die Lizenzen für Drittanbietersoftware.

Für die sogenannte "starke Kryptographie" benötigt die

Java-Laufzeitumgebung die Installation zusätzlicher

"policy files". Diese sind ebenfalls auf der o.g. Java-

Downloadseite (s. "Java Cryptography Extension (JCE)

Unlimited Strength Jurisdiction Policy Files") verfügbar.

Die Quellen der OSCI-Bibliothek befinden sich im Verzeichnis

/src. Um sie zu übersetzen, sind die oben benannten

Voraussetzungen nötig.

Im Verzeichnis /beispielanwendung/de/osci/osci12/samples/

befinden sich mehrere Beispielanwendungen.