feat(sdk): setup gradle project structure

.github/dependabot.yml

@@ -0,0 +1,6 @@
+version: 2
+updates:
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "daily"

.github/workflows/ci.yaml

@@ -0,0 +1,38 @@
+name: CI
+
+on:
+  pull_request:
+  workflow_dispatch:
+  push:
+    branches: ["main"]
+
+jobs:
+  main:
+    name: CI
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        version: [11, 17, 21]
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Install java
+        uses: actions/setup-java@v4
+        with:
+          distribution: 'temurin'
+          java-version: '${{ matrix.version }}'
+          cache: 'gradle'
+
+      - name: Check code format
+        run: ./gradlew spotlessCheck
+
+      - name: Test
+        run: make test
+
+      - name: Build
+        run: make build
+
+      - name: Publish to local maven repo
+        run: make install
+

.gitignore

@@ -38,4 +38,9 @@ gradle-app.setting
 # Eclipse Core
 .project
 # JDT-specific (Eclipse Java Development Tools)
-.classpath
+.classpath
+
+*.iws
+*.iml
+*.ipr
+.idea

Makefile

@@ -0,0 +1,11 @@
+build:
+	@./gradlew build
+
+fmt:
+	@./gradlew spotlessApply
+
+test:
+	@./gradlew test
+
+install:
+	@./gradlew publishToMavenLocal

README.md

@@ -15,11 +15,25 @@ This repository contains the STACKIT SDKs for Java.
 
 If you encounter any issues or have suggestions for improvements, please open an issue in the repository or create a ticket in the [STACKIT Help Center](https://support.stackit.cloud/).
 
+## Development
+
+Building the STACKIT Java SDK requires:
+1. Java SDK (version 11 to 21 should be supported) installed on your system
+
+In case you want to open the project in your preferred IDE, run `./gradlew idea` or `./gradlew eclipse` beforehand.
+
+## Installation
+
+To install the API client library to your local Maven repository, simply execute:
+
+```bash
+./gradlew publishToMavenLocal
+```
 
 ## Release creation
 
 See the [release documentation](./RELEASE.md) for further information.
 
 ## License
 
-Apache 2.0
+Apache 2.0

build.gradle

@@ -0,0 +1,142 @@
+plugins {
+	id 'java'
+	id 'maven-publish'
+	id 'idea'
+	id 'eclipse'
+
+	id 'com.diffplug.spotless' version '6.21.0'
+}
+
+
+allprojects {
+	apply plugin: 'com.diffplug.spotless'
+
+	repositories {
+		mavenCentral()
+	}
+
+	javadoc {
+		options.tags = [
+			"http.response.details:a:Http Response Details"
+		]
+	}
+
+	sourceCompatibility = JavaVersion.VERSION_1_8
+	targetCompatibility = JavaVersion.VERSION_1_8
+
+	tasks.withType(JavaCompile) {
+		options.encoding = 'UTF-8'
+	}
+
+	spotless {
+		groovyGradle {
+			greclipse()
+
+			trimTrailingWhitespace()
+			indentWithTabs()
+			endWithNewline()
+		}
+		format 'misc', {
+			target '.gitattributes', '.gitignore'
+
+			trimTrailingWhitespace()
+			indentWithTabs()
+			endWithNewline()
+		}
+		java {
+			googleJavaFormat().aosp()
+
+			removeUnusedImports()
+			importOrder()
+			formatAnnotations()
+			trimTrailingWhitespace()
+			indentWithTabs()
+			endWithNewline()
+		}
+	}
+}
+
+subprojects {
+	apply plugin: 'java'
+	apply plugin: 'maven-publish'
+	apply plugin: 'idea'
+	apply plugin: 'eclipse'
+
+	group = 'cloud.stackit'
+	version = 'SNAPSHOT'
+
+	afterEvaluate { project ->
+		// only apply to service sub-projects and core
+		if (project.path.startsWith(':services:') || project.name == "core" ) {
+
+			// override the version of each service with the ones obtained from the VERSION files
+			def versionFile = project.file("VERSION")
+			if (versionFile.exists()) {
+				try {
+					version = versionFile.text.trim()
+				} catch (IOException e) {
+					logger.error("Could not read VERSION file for project '${project.name}': ${e.message}")
+				}
+			} else {
+				logger.warn("VERSION file not found in project '${project.name}'. Skipping version setting.")
+			}
+
+
+			publishing {
+				publications {
+					maven(MavenPublication) {
+						artifactId = "stackit-sdk-${project.name}"
+						from components.java
+
+						pom {
+							name.set(project.name)
+							description.set("STACKIT Java SDK for the ${project.name} service")
+							url.set("https://github.com/stackitcloud/stackit-sdk-java/tree/main/services/${rootProject.name}")
+							licenses {
+								license {
+									name.set("Apache License, Version 2.0")
+									url.set("https://www.apache.org/licenses/LICENSE-2.0.txt")
+								}
+							}
+							developers {
+								developer {
+									id.set("stackitcloud") // TODO: not clear which value must be placed here, check this when setting up publishment to Maven Central
+									name.set("STACKIT Developer Tools")
+									email.set("[email protected]")
+								}
+							}
+							scm {
+								connection.set("scm:git:git://github.com/stackitcloud/${rootProject.name}.git")
+								developerConnection.set("scm:git:ssh://github.com/stackitcloud/${rootProject.name}.git")
+								url.set("https://github.com/stackitcloud/${rootProject.name}")
+							}
+						}
+					}
+				}
+				repositories {
+					mavenLocal()
+				}
+			}
+		}
+	}
+
+	tasks.withType(Test) {
+		// Enable JUnit 5 (Gradle 4.6+).
+		useJUnitPlatform()
+
+		// Always run tests, even when nothing changed.
+		dependsOn 'cleanTest'
+
+		// Show test results.
+		testLogging {
+			events "passed", "skipped", "failed"
+		}
+	}
+
+	dependencies {
+		if (project.path != ':core') {
+			// prevent circular dependency
+			implementation project(':core')
+		}
+	}
+}

core/VERSION

@@ -0,0 +1 @@
+0.0.1-SNAPSHOT

core/build.gradle

@@ -0,0 +1 @@
+

core/src/main/java/cloud/stackit/sdk/core/CoreDummy.java

@@ -0,0 +1,3 @@
+package cloud.stackit.sdk.core;
+
+public class CoreDummy {}

examples/resourcemanager/build.gradle

@@ -0,0 +1,3 @@
+dependencies {
+	implementation project (':services:resourcemanager')
+}

examples/resourcemanager/src/main/java/cloud/stackit/sdk/resourcemanager/examples/ResourcemanagerExample.java

@@ -0,0 +1,39 @@
+package cloud.stackit.sdk.resourcemanager.examples;
+
+import cloud.stackit.sdk.resourcemanager.ApiClient;
+import cloud.stackit.sdk.resourcemanager.ApiException;
+import cloud.stackit.sdk.resourcemanager.api.DefaultApi;
+import cloud.stackit.sdk.resourcemanager.model.CreateFolderPayload;
+import cloud.stackit.sdk.resourcemanager.model.CreateProjectPayload;
+import cloud.stackit.sdk.resourcemanager.model.FolderResponse;
+import cloud.stackit.sdk.resourcemanager.model.Project;
+import java.util.Map;
+import java.util.UUID;
+
+class ResourcemanagerExample {
+	public static void main(String[] args) {
+		ApiClient apiClient = new ApiClient();
+		DefaultApi resourceManagerApi = new DefaultApi(apiClient);
+
+		// replace this with something useful for real use
+		UUID containerParentId = UUID.randomUUID();
+
+		try {
+			/* create a project */
+			Project project =
+					resourceManagerApi.createProject(
+							new CreateProjectPayload()
+									.containerParentId(containerParentId.toString())
+									.labels(Map.ofEntries(Map.entry("foo", "bar"))));
+
+			/* create a folder */
+			FolderResponse folder =
+					resourceManagerApi.createFolder(
+							new CreateFolderPayload()
+									.containerParentId(containerParentId.toString())
+									.labels(Map.ofEntries(Map.entry("foo", "bar"))));
+		} catch (ApiException e) {
+			throw new RuntimeException(e);
+		}
+	}
+}

services/resourcemanager/README.md

@@ -34,7 +34,7 @@ This package is part of the STACKIT Java SDK. For additional information, please
 ## Requirements
 
 Building the API client library requires:
-1. Java 1.8+
+1. Java SDK (version 11 to 21 should be supported) installed on your system
 
 ## Installation
 

services/resourcemanager/VERSION

@@ -0,0 +1 @@
+0.0.1-SNAPSHOT