AcknowledgeDocumentsRequest und -Response Typ wieder aufgenommen. Releasenotes ergänzt, ReadMe-Files umbenannt damit einheitlicher, Dokument Versionierung überarbeitet, Korrekturen am VerzeichnisOperationen.xlsx

OMDSServiceDefinition/ReadMe_CodeGen.md

@@ -0,0 +1,42 @@
+# Build mit Maven
+Build mit Maven 3.9.6 auf Java 17
+
+# Maven Goals
+Mit Maven Goal "clean package" kann ein Release als ZIP-File mit XSDs und WSDLs sowie der Dokumentation gebaut werden.
+Mit Maven Goal "clean deploy" wird der Release in das Kap Dion- Maven - OMDS Repository hochgeladen.
+
+# Codegenerierung
+Mit Maven Goal "clean package" und Profil "genJavaFromWsdl_VU" wird der zugehörige Java-Code generiert.
+
+
+# MTOM in Java nach Codegenerierung
+Nach der Code-Generierung müssen einige Schritte von Hand durchgeführt werden, damit MTOM
+enthalten ist:
+
+1) Server (Class: OmdsServicePortImpl)
+
+   Add a class annotation (above the class name):
+   @MTOM(enabled = true, threshold = 1024)
+   
+   Add import:
+      import jakarta.xml.ws.soap.MTOM;
+
+2) Client (Class: OmdsServicePortType_OmdsServicePort_Client)
+
+   Rewrite the OMDSService creation like following:
+   from
+      OmdsService ss = new OmdsService(wsdlURL, SERVICE_NAME);
+      OmdsServicePortType port = ss.getOmdsServicePort();
+   to  
+      OmdsService ss = new OmdsService(wsdlURL, SERVICE_NAME);
+      OmdsServicePortType port = ss.getOmdsServicePort(new MTOMFeature(1024));
+
+   Add import:
+      import jakarta.xml.ws.soap.MTOMFeature;
+
+# Fehlersuche
+* Wenn Bindings-Files fehlen, z.B. nicht im Pom deklariert sind, werden die Klassen zwar generiert,
+  aber der Pfad erscheint falsch, z.B. als _0._1._1
+* Wenn die X-Path-Ausdrücke in den Binding-Files versagen wird im Log nur eine Warnung ausgegeben,
+  die Generierung scheitert aber.
+