feat(iaas): initial onboarding

relates to STACKITSDK-209

Author: rubenhoenle

services/iaas/README.md

@@ -0,0 +1,114 @@
+# stackit-sdk-iaas
+
+IaaS-API
+
+- API version: 1
+
+This API allows you to create and modify IaaS resources.
+
+For more information, please visit [https://support.stackit.cloud/servicedesk](https://support.stackit.cloud/servicedesk)
+
+This package is part of the STACKIT Java SDK. For additional information, please visit the [GitHub repository](https://github.com/stackitcloud/stackit-sdk-java) of the SDK.
+
+
+## Requirements
+
+Building the API client library requires:
+1. Java SDK (version 11 to 21 should be supported) installed on your system
+
+## Installation
+
+To install the API client library to your local Maven repository, simply execute:
+
+```shell
+./gradlew publishToMavenLocal
+```
+
+To deploy it to a remote Maven repository instead, configure the settings of the repository and execute:
+
+```shell
+# TODO: follow up story
+# ./gradlew publishToMavenCentral
+```
+
+Refer to the [OSSRH Guide](http://central.sonatype.org/pages/ossrh-guide.html) for more information.
+
+### Maven users
+
+Add this dependency to your project's POM:
+
+```xml
+<dependency>
+  <groupId>cloud.stackit</groupId>
+  <artifactId>stackit-sdk-iaas</artifactId>
+  <version><SDK_VERSION></version>
+  <scope>compile</scope>
+</dependency>
+```
+
+### Gradle users
+
+Add this dependency to your project's build file:
+
+```groovy
+  repositories {
+    mavenCentral()     // Needed if the 'stackit-sdk-iaas' jar has been published to maven central.
+    mavenLocal()       // Needed if the 'stackit-sdk-iaas' jar has been published to the local maven repo.
+  }
+
+  dependencies {
+     implementation "cloud.stackit:stackit-sdk-iaas:<SDK_VERSION>"
+  }
+```
+
+### Others
+
+At first generate the JAR by executing:
+
+```shell
+mvn clean package
+```
+
+Then manually install the following JARs:
+
+- `target/stackit-sdk-iaas-<SDK_VERSION>.jar`
+- `target/lib/*.jar`
+
+## Getting Started
+
+Please follow the [installation](#installation) instruction and execute the following Java code:
+
+```java
+
+import cloud.stackit.sdk.iaas.*;
+import cloud.stackit.sdk.iaas.auth.*;
+import cloud.stackit.sdk.iaas.model.*;
+import cloud.stackit.sdk.iaas.api.DefaultApi;
+
+public class DefaultApiExample {
+
+    public static void main(String[] args) {
+        ApiClient defaultClient = Configuration.getDefaultApiClient();
+        defaultClient.setBasePath("https://iaas.api.eu01.stackit.cloud");
+        
+        DefaultApi apiInstance = new DefaultApi(defaultClient);
+        UUID projectId = UUID.randomUUID(); // UUID | The identifier (ID) of a STACKIT Project.
+        UUID serverId = UUID.randomUUID(); // UUID | The identifier (ID) of a STACKIT Server.
+        UUID networkId = UUID.randomUUID(); // UUID | The identifier (ID) of a STACKIT Network.
+        try {
+            apiInstance.addNetworkToServer(projectId, serverId, networkId);
+        } catch (ApiException e) {
+            System.err.println("Exception when calling DefaultApi#addNetworkToServer");
+            System.err.println("Status code: " + e.getCode());
+            System.err.println("Reason: " + e.getResponseBody());
+            System.err.println("Response headers: " + e.getResponseHeaders());
+            e.printStackTrace();
+        }
+    }
+}
+
+```
+
+## Recommendation
+
+It's recommended to create an instance of `ApiClient` per thread in a multithreaded environment to avoid any potential issues.

services/iaas/build.gradle

@@ -0,0 +1,19 @@
+
+ext {
+	jakarta_annotation_version = "1.3.5"
+}
+
+dependencies {
+	implementation "com.google.code.findbugs:jsr305:3.0.2"
+	implementation 'com.squareup.okhttp3:okhttp:4.12.0'
+	implementation 'com.squareup.okhttp3:logging-interceptor:4.12.0'
+	implementation 'com.google.code.gson:gson:2.9.1'
+	implementation 'io.gsonfire:gson-fire:1.9.0'
+	implementation 'jakarta.ws.rs:jakarta.ws.rs-api:2.1.6'
+	implementation 'org.openapitools:jackson-databind-nullable:0.2.6'
+	implementation group: 'org.apache.commons', name: 'commons-lang3', version: '3.17.0'
+	implementation "jakarta.annotation:jakarta.annotation-api:$jakarta_annotation_version"
+	testImplementation 'org.junit.jupiter:junit-jupiter-api:5.10.3'
+	testImplementation 'org.mockito:mockito-core:3.12.4'
+	testRuntimeOnly 'org.junit.jupiter:junit-jupiter-engine:5.10.3'
+}

services/iaas/settings.gradle

@@ -0,0 +1 @@
+rootProject.name = "stackit-sdk-iaas"

services/iaas/src/main/java/cloud/stackit/sdk/iaas/ApiCallback.java

@@ -0,0 +1,59 @@
+/*
+ * IaaS-API
+ * This API allows you to create and modify IaaS resources.
+ *
+ * The version of the OpenAPI document: 1
+ * Contact: [email protected]
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+
+package cloud.stackit.sdk.iaas;
+
+import java.util.List;
+import java.util.Map;
+
+/**
+ * Callback for asynchronous API call.
+ *
+ * @param <T> The return type
+ */
+public interface ApiCallback<T> {
+	/**
+	 * This is called when the API call fails.
+	 *
+	 * @param e The exception causing the failure
+	 * @param statusCode Status code of the response if available, otherwise it would be 0
+	 * @param responseHeaders Headers of the response if available, otherwise it would be null
+	 */
+	void onFailure(ApiException e, int statusCode, Map<String, List<String>> responseHeaders);
+
+	/**
+	 * This is called when the API call succeeded.
+	 *
+	 * @param result The result deserialized from response
+	 * @param statusCode Status code of the response
+	 * @param responseHeaders Headers of the response
+	 */
+	void onSuccess(T result, int statusCode, Map<String, List<String>> responseHeaders);
+
+	/**
+	 * This is called when the API upload processing.
+	 *
+	 * @param bytesWritten bytes Written
+	 * @param contentLength content length of request body
+	 * @param done write end
+	 */
+	void onUploadProgress(long bytesWritten, long contentLength, boolean done);
+
+	/**
+	 * This is called when the API download processing.
+	 *
+	 * @param bytesRead bytes Read
+	 * @param contentLength content length of the response
+	 * @param done Read end
+	 */
+	void onDownloadProgress(long bytesRead, long contentLength, boolean done);
+}