Feature/init cosys integration

refarch-integrations/README.md

@@ -8,6 +8,8 @@ Collection of different integration which can be used as is in RefArch projects.
   in other integrations.
 - [email-integration](./refarch-email-integration/README.md): For sending text and html emails with attachments. Uses
   s3-integration for file handling.
+- [cosys-integration](./refarch-cosys-integration/README.md): For creating documents with cosys. Uses
+  s3-integration for file handling.
 
 ## Naming conventions
 

refarch-integrations/pom.xml

@@ -1,12 +1,13 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
+<project xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://maven.apache.org/POM/4.0.0"
+         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
     <modelVersion>4.0.0</modelVersion>
 
     <parent>
         <groupId>org.springframework.boot</groupId>
         <artifactId>spring-boot-starter-parent</artifactId>
         <version>3.3.3</version>
-        <relativePath />
+        <relativePath/>
     </parent>
 
     <groupId>de.muenchen.refarch</groupId>
@@ -19,6 +20,7 @@
     <modules>
         <module>refarch-s3-integration</module>
         <module>refarch-email-integration</module>
+        <module>refarch-cosys-integration</module>
     </modules>
 
     <properties>
@@ -232,8 +234,8 @@
                         <eclipse>
                             <file>itm-java-codeformat/java_codestyle_formatter.xml</file>
                         </eclipse>
-                        <trimTrailingWhitespace />
-                        <endWithNewline />
+                        <trimTrailingWhitespace/>
+                        <endWithNewline/>
                     </java>
                 </configuration>
                 <executions>

refarch-integrations/refarch-cosys-integration/README.md

@@ -0,0 +1,37 @@
+# RefArch CoSys integration
+
+Integration for creating documents with cosys. Uses s3-integration for file handling.
+
+## Usage
+
+```xml
+
+<dependencies>
+    <dependency>
+        <groupId>de.muenchen.refarch</groupId>
+        <artifactId>refarch-cosys-integration-starter</artifactId>
+        <version>...</version>
+    </dependency>
+</dependencies>
+```
+
+and a [s3-integration starter](../refarch-s3-integration/README.md#usage).
+
+## Configuration
+
+Following are the properties to configure the different modules. Some of them are custom defined and others are synonyms
+for spring package properties.
+Whether a property is an alias can be checked in the corresponding `application.yml` of each module.
+
+### refarch-cosys-integration-starter
+
+| Property                             | Description                                                                   |
+|--------------------------------------|-------------------------------------------------------------------------------|
+| `refarch.cosys.url`                  | Url of the CoSys service                                                      |
+| `refarch.cosys.merge.datafile`       |                                                                               |
+| `refarch.cosys.merge.inputLanguage`  | incoming language                                                             |
+| `refarch.cosys.merge.outputLanguage` | outgoing language                                                             |
+| `refarch.cosys.merge.keepFields`     |                                                                               |
+| `SSO_COSYS_ISSUER_URL`               | Issuer url of oAuth2 service to use for authentication against cosys service. |
+| `SSO_COSYS_CLIENT_ID`                | Client id to be used for authentication against cosys.                        |
+| `SSO_COSYS_CLIENT_SECRET`            | Client secret to be used for gathering client service account token.          |

refarch-integrations/refarch-cosys-integration/pom.xml

@@ -0,0 +1,34 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+         xmlns="http://maven.apache.org/POM/4.0.0"
+         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
+    <modelVersion>4.0.0</modelVersion>
+
+    <parent>
+        <groupId>de.muenchen.refarch</groupId>
+        <artifactId>refarch-integrations</artifactId>
+        <version>1.1.0-SNAPSHOT</version>
+    </parent>
+
+    <artifactId>refarch-cosys-integration</artifactId>
+    <description>CoSys integration</description>
+    <packaging>pom</packaging>
+
+    <modules>
+        <module>refarch-cosys-integration-client</module>
+        <module>refarch-cosys-integration-core</module>
+        <module>refarch-cosys-integration-starter</module>
+        <module>refarch-cosys-integration-example</module>
+    </modules>
+
+    <dependencyManagement>
+        <dependencies>
+            <dependency>
+                <groupId>de.muenchen.refarch</groupId>
+                <artifactId>refarch-s3-integration-client-core</artifactId>
+                <version>${project.version}</version>
+            </dependency>
+        </dependencies>
+    </dependencyManagement>
+
+</project>

refarch-integrations/refarch-cosys-integration/refarch-cosys-integration-client/pom.xml

@@ -0,0 +1,94 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://maven.apache.org/POM/4.0.0"
+         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">
+    <modelVersion>4.0.0</modelVersion>
+    <parent>
+        <groupId>de.muenchen.refarch</groupId>
+        <artifactId>refarch-cosys-integration</artifactId>
+        <version>1.1.0-SNAPSHOT</version>
+    </parent>
+
+    <artifactId>refarch-cosys-integration-client</artifactId>
+
+    <properties>
+        <openapi-generator-maven-plugin.version>7.8.0</openapi-generator-maven-plugin.version>
+
+        <jackson-databind-nullable.version>0.2.6</jackson-databind-nullable.version>
+    </properties>
+
+    <dependencies>
+        <!-- Spring -->
+        <dependency>
+            <groupId>org.springframework</groupId>
+            <artifactId>spring-webflux</artifactId>
+        </dependency>
+        <dependency>
+            <groupId>org.springframework.boot</groupId>
+            <artifactId>spring-boot-starter-logging</artifactId>
+        </dependency>
+        <dependency>
+            <groupId>org.springframework.boot</groupId>
+            <artifactId>spring-boot-starter-validation</artifactId>
+        </dependency>
+
+        <!-- openApi -->
+        <dependency>
+            <groupId>org.springdoc</groupId>
+            <artifactId>springdoc-openapi-starter-webflux-ui</artifactId>
+        </dependency>
+        <dependency>
+            <groupId>org.openapitools</groupId>
+            <artifactId>jackson-databind-nullable</artifactId>
+            <version>${jackson-databind-nullable.version}</version>
+        </dependency>
+        <dependency>
+            <groupId>com.fasterxml.jackson.datatype</groupId>
+            <artifactId>jackson-datatype-jsr310</artifactId>
+        </dependency>
+    </dependencies>
+
+    <build>
+        <plugins>
+            <plugin>
+                <groupId>org.openapitools</groupId>
+                <artifactId>openapi-generator-maven-plugin</artifactId>
+                <version>${openapi-generator-maven-plugin.version}</version>
+                <executions>
+                    <execution>
+                        <id>cosys-api</id>
+                        <goals>
+                            <goal>generate</goal>
+                        </goals>
+                        <configuration>
+                            <inputSpec>${project.basedir}/src/main/api/api-docs.json</inputSpec>
+                            <library>webclient</library>
+                            <generatorName>java</generatorName>
+
+                            <apiPackage>de.muenchen.refarch.integration.cosys.api</apiPackage>
+                            <modelPackage>de.muenchen.refarch.integration.cosys.model</modelPackage>
+                            <invokerPackage>de.muenchen.refarch.integration.cosys</invokerPackage>
+
+                            <generateApiTests>false</generateApiTests>
+                            <generateModelTests>false</generateModelTests>
+                            <generateApiDocumentation>false</generateApiDocumentation>
+                            <generateModelDocumentation>false</generateModelDocumentation>
+                            <generateSupportingFiles>true</generateSupportingFiles>
+                            <configOptions>
+                                <hideGenerationTimestamp>true</hideGenerationTimestamp>
+                                <useJakartaEe>true</useJakartaEe>
+                            </configOptions>
+
+                            <globalProperties>
+                                <supportingFiles>
+                                    ApiClient.java,JavaTimeFormatter.java,Authentication.java,OAuth.java,ApiKeyAuth.java,HttpBasicAuth.java,HttpBearerAuth.java,RFC3339DateFormat.java
+                                </supportingFiles>
+                            </globalProperties>
+
+                        </configuration>
+                    </execution>
+                </executions>
+            </plugin>
+        </plugins>
+    </build>
+
+</project>