build(bindings/java): prepare for automatically multiple platform deploy

.github/workflows/bindings_java.yml

@@ -27,6 +27,7 @@ on:
     branches:
       - main
     paths:
+      - "core/**"
       - "bindings/java/**"
       - ".github/workflows/bindings_java.yml"
   workflow_dispatch:
@@ -43,11 +44,11 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v3
-      - name: Set up JDK 11
+      - name: Set up JDK 8
         uses: actions/setup-java@v3
         with:
           distribution: 'temurin'
-          java-version: '11'
+          java-version: '8'
           cache: 'maven'
       - name: Build and test
         working-directory: bindings/java

bindings/java/README.md

@@ -1,13 +1,38 @@
 # OpenDAL Java Bindings
 
+## Usage
+
+You can use the package by adding the dependency as following:
+
+```xml
+<dependencies>
+  <dependency>
+    <groupId>org.apache.opendal</groupId>
+    <artifactId>opendal-java</artifactId>
+    <version>0.1.0-SNAPSHOT</version>
+    <classifier>${os.detected.classifier}</classifier>
+  </dependency>
+</dependencies>
+
+<build>
+    <extensions>
+        <extension>
+            <groupId>kr.motd.maven</groupId>
+            <artifactId>os-maven-plugin</artifactId>
+            <version>1.7.0</version>
+        </extension>
+    </extensions>
+</build>
+```
+
 ## Build
 
 This project provides OpenDAL Java bindings with artifact name `opendal-java`. It depends on JDK 8 or later.
 
-Thanks to [rust-maven-plugin](https://github.com/questdb/rust-maven-plugin), we can use Maven to build both Rust dynamic lib and JAR files with one command now:
+You can use Maven to build both Rust dynamic lib and JAR files with one command now:
 
 ```shell
-mvn clean package
+mvn clean package -DskipTests=true
 ```
 
 ## Run tests
@@ -20,74 +45,6 @@ You can run tests with the following command:
 mvn clean verify
 ```
 
-## Deploy snapshots
-
-To deploy snapshots, you need to configure your GPG signing key and loacl Maven settings.
-
-### GPG
-
-1. Download GPG from http://www.gnupg.org/download/ or any other method.
-2. Generate [PGP code signing keys](https://infra.apache.org/release-signing.html#generate).
-
-> **Note**: When doing a release you will be asked for your PGP password multiple times unless you set up the gpg-agent. Mac users have reported trouble getting gpg-agent to work. You can also set your gpg-password in the Maven settings file (see below).
-
-### Maven Settings
-
-Your Maven settings (`$HOME/.m2/settings.xml`) file should have the following:
-
-```xml
-<settings>
-    ...
-    <servers>
-        ...
-        <server>
-            <id>apache.website.svnpub</id>
-            <username>Your Apache Username</username>
-            <privateKey>${user.home}/.ssh/id_rsa</privateKey>
-        </server>
-
-        <server>
-            <id>apache.releases.https</id>
-            <username>Your Apache Username</username>
-            <password>APACHE-PASSWORD-ENCODED</password>
-        </server>
-
-        <server>
-            <id>apache.snapshots.https</id>
-            <username>Your Apache Username</username>
-            <password>APACHE-PASSWORD-ENCODED</password>
-        </server>
-        ...
-    </servers>
-
-    <profiles>
-        <profile>
-            <properties>
-                ...
-    	        <gpg.keyname>id-of-your-pgp-key</gpg.keyname>
-                <gpg.passphrase>your-pgp-password</gpg.passphrase> <!-- use this if gpg-agent doesn't work for you -->
-                ...
-            </properties>
-            ...
-        </profile>
-        ...
-    </profiles>
-    ...
-</settings>
-```
-
-> **Note**: You can store encrypted passwords your settings.xml if you want. Read the details here: http://maven.apache.org/guides/mini/guide-encryption.html
-
-### Deploy
-
-Thanks to the [ASF Parent POM](https://maven.apache.org/pom/asf/), deploy a snapshot version requires only an oneliner:
-
-```shell
-mvn -P apache-release deploy
-```
-
-> **Note**: Please ensure that the project version of `opendal-java` in the `pom.xml` file ends with `-SNAPSHOT`.
-
 ## Todos
 
 - [ ] ReadMe for usage

bindings/java/pom.xml

@@ -48,16 +48,16 @@
     <properties>
         <!-- This value is for Reproducible Builds. It will be updated by Maven Release Plugin during releases. -->
         <project.build.outputTimestamp>10</project.build.outputTimestamp>
-
+        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
         <maven.compiler.source>1.8</maven.compiler.source>
         <maven.compiler.target>1.8</maven.compiler.target>
-        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
 
-        <questdb.version>1.0.0</questdb.version>
+        <!-- Use camelCase instead of separating by dots to workaround PowerShell parsing. -->
+        <jniClassifier>${os.detected.classifier}</jniClassifier>
 
+        <questdb.version>1.0.0</questdb.version>
         <maven-surefire-plugin.version>3.0.0</maven-surefire-plugin.version>
-
-        <build-helper-maven-plugin.version>3.3.0</build-helper-maven-plugin.version>
+        <exec-maven-plugin.version>3.1.0</exec-maven-plugin.version>
     </properties>
 
     <dependencyManagement>
@@ -109,6 +109,12 @@
     </dependencies>
 
     <build>
+        <resources>
+            <resource>
+                <directory>src/main/resources</directory>
+                <filtering>true</filtering>
+            </resource>
+        </resources>
         <testResources>
             <testResource>
                 <directory>src/test/resources</directory>
@@ -126,22 +132,23 @@
 
         <plugins>
             <plugin>
-                <groupId>org.questdb</groupId>
-                <artifactId>rust-maven-plugin</artifactId>
-                <version>${questdb.version}</version>
+                <artifactId>exec-maven-plugin</artifactId>
+                <groupId>org.codehaus.mojo</groupId>
+                <version>${exec-maven-plugin.version}</version>
                 <executions>
                     <execution>
-                        <id>opendal-java</id>
+                        <id>compile-native-code</id>
+                        <phase>compile</phase>
                         <goals>
-                            <goal>build</goal>
+                            <goal>exec</goal>
                         </goals>
                         <configuration>
-                            <path>${project.basedir}</path>
-                            <release>true</release>
-                            <copyTo>${project.build.directory}/classes/native/${os.detected.classifier}</copyTo>
-                            <extraArgs>
-                                <extraArg>--color=always</extraArg>
-                            </extraArgs>
+                            <executable>python3</executable>
+                            <arguments>
+                                <argument>${project.basedir}/tools/build.py</argument>
+                                <argument>--classifier</argument>
+                                <argument>${jniClassifier}</argument>
+                            </arguments>
                         </configuration>
                     </execution>
                 </executions>
@@ -151,46 +158,6 @@
                 <artifactId>maven-surefire-plugin</artifactId>
                 <version>${maven-surefire-plugin.version}</version>
             </plugin>
-            <plugin>
-                <groupId>org.apache.maven.plugins</groupId>
-                <artifactId>maven-resources-plugin</artifactId>
-                <executions>
-                    <execution>
-                        <id>prepare-filtered-java-source</id>
-                        <goals>
-                            <goal>copy-resources</goal>
-                        </goals>
-                        <phase>generate-sources</phase>
-                        <configuration>
-                            <outputDirectory>${project.build.directory}/generated-sources/java</outputDirectory>
-                            <resources>
-                                <resource>
-                                    <directory>src/main/java-filtered</directory>
-                                    <filtering>true</filtering>
-                                </resource>
-                            </resources>
-                        </configuration>
-                    </execution>
-                </executions>
-            </plugin>
-            <plugin>
-                <groupId>org.codehaus.mojo</groupId>
-                <artifactId>build-helper-maven-plugin</artifactId>
-                <version>${build-helper-maven-plugin.version}</version>
-                <executions>
-                    <execution>
-                        <phase>generate-sources</phase>
-                        <goals>
-                            <goal>add-source</goal>
-                        </goals>
-                        <configuration>
-                            <sources>
-                                <source>${project.build.directory}/generated-sources/java</source>
-                            </sources>
-                        </configuration>
-                    </execution>
-                </executions>
-            </plugin>
             <plugin>
                 <groupId>org.apache.maven.plugins</groupId>
                 <artifactId>maven-jar-plugin</artifactId>
@@ -200,6 +167,7 @@
                         <id>default-jar</id>
                         <configuration>
                             <excludes>
+                                <exclude>bindings.properties</exclude>
                                 <exclude>native/**</exclude>
                             </excludes>
                         </configuration>
@@ -211,7 +179,7 @@
                             <goal>jar</goal>
                         </goals>
                         <configuration>
-                            <classifier>${os.detected.classifier}</classifier>
+                            <classifier>${jniClassifier}</classifier>
                         </configuration>
                     </execution>
                 </executions>

bindings/java/src/main/java/org/apache/opendal/Environment.java

@@ -0,0 +1,64 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements.  See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership.  The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance
+ * with the License.  You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+
+package org.apache.opendal;
+
+import java.io.IOException;
+import java.io.InputStream;
+import java.io.UncheckedIOException;
+import java.util.Properties;
+
+public enum Environment {
+    INSTANCE;
+
+    public static final String UNKNOWN = "<unknown>";
+    private String classifier = UNKNOWN;
+    private String projectVersion = UNKNOWN;
+
+    static {
+        ClassLoader classLoader = Environment.class.getClassLoader();
+        try (InputStream is = classLoader.getResourceAsStream("bindings.properties")) {
+            final Properties properties = new Properties();
+            properties.load(is);
+            INSTANCE.classifier = properties.getProperty("jniClassifier", UNKNOWN);
+            INSTANCE.projectVersion = properties.getProperty("project.version", UNKNOWN);
+        } catch (IOException e) {
+            throw new UncheckedIOException("cannot load environment properties file", e);
+        }
+    }
+
+    /**
+     * Returns the classifier of the compiled environment.
+     *
+     * @return The classifier of the compiled environment.
+     */
+    public static String getClassifier() {
+        return INSTANCE.classifier;
+    }
+
+    /**
+     * Returns the version of the code as String.
+     *
+     * @return The project version string.
+     */
+    public static String getVersion() {
+        return INSTANCE.projectVersion;
+    }
+
+}

bindings/java/src/main/java/org/apache/opendal/NativeObject.java

@@ -43,7 +43,11 @@ public static void loadLibrary() {
         }
 
         if (libraryLoaded.compareAndSet(LibraryState.NOT_LOADED, LibraryState.LOADING)) {
-            JarJniLoader.loadLib(NativeObject.class, "/native", "opendal_java", Platform.CLASSIFIER);
+            JarJniLoader.loadLib(
+                NativeObject.class,
+                "/native",
+                "opendal_java",
+                Environment.getClassifier());
             libraryLoaded.set(LibraryState.LOADED);
             return;
         }

bindings/java/src/main/resources/bindings.properties

@@ -0,0 +1,19 @@
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+jniClassifier=${jniClassifier}
+project.version=${project.version}