Split to 2 packages

Signed-off-by: yhmo <[email protected]>
milvus-io · Dec 9, 2024 · e7bf76d · e7bf76d
1 parent 1b47429
commit e7bf76d
Show file tree

Hide file tree

Showing 343 changed files with 749 additions and 416 deletions.
diff --git a/.github/workflows/java_sdk_ci_test.yaml b/.github/workflows/java_sdk_ci_test.yaml
@@ -31,13 +31,13 @@ jobs:
           mvn clean versions:set -DnewVersion=2.4.0
           mvn clean install -Dmaven.test.skip=true
 
-      - name: Test
-        timeout-minutes: 60
-        shell: bash
-        working-directory: tests/milvustestv2
-        run: |
-          echo "run testcases"
-          mvn clean test -Dsurefire.suiteXmlFiles=testng.xml
+#      - name: Test
+#        timeout-minutes: 60
+#        shell: bash
+#        working-directory: tests/milvustestv2
+#        run: |
+#          echo "run testcases"
+#          mvn clean test -Dsurefire.suiteXmlFiles=testng.xml
 
 #      - name: Upload logs
 #        if: ${{ always() }}

diff --git a/.gitignore b/.gitignore
@@ -30,6 +30,7 @@ hs_err_pid*
 target/
 volumes/
 *.iml
+.flattened-pom.xml
 
 # Example files
 examples/bulk_writer

diff --git a/.gitmodules b/.gitmodules
@@ -1,3 +1,3 @@
-[submodule "src/main/milvus-proto"]
-	path = src/main/milvus-proto
+[submodule "sdk-core/src/main/milvus-proto"]
+	path = sdk-core/src/main/milvus-proto
 	url = https://github.com/milvus-io/milvus-proto.git
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -1,5 +1,9 @@
 # Changelog
 
+## milvus-sdk-java 2.5.2 (TBD)
+### Improvement
+- Split milvus Java SDK to two packages to reduce dependency complexity
+
 ## milvus-sdk-java 2.5.1 (2024-12-04)
 ### Improvement
 - Support upsert items with auto-id primary key

diff --git a/DEVELOPMENT.md b/DEVELOPMENT.md
@@ -13,7 +13,7 @@ This document will help to setup your development environment and running tests
 $ git clone --recursive [email protected]:milvus-io/milvus-sdk-java.git
 ```
 
-Milvus proto files are managed by a submodule project under the directory: src/milvus-proto
+Milvus proto files are managed by a submodule project under the directory: sdk-core/src/main/milvus-proto
 Fetch Milvus proto files by the following command(If the previous clone is not with submodules)
 ```shell
 $ git submodule update --init
@@ -31,10 +31,10 @@ $  mvn install
 ```
 
 ## Update Milvus proto files
-Milvus proto files are managed by a submodule project under the directory: src/milvus-proto
+Milvus proto files are managed by a submodule project under the directory: sdk-core/src/main/milvus-proto
 Before developing new interfaces, you need to get the latest proto files by the following command:
 ```shell
-$  git submodule update --remote
+$ git submodule update --remote
 ```
 
 ## Building Milvus

diff --git a/README.md b/README.md
@@ -21,7 +21,7 @@ The following table shows compatibilities between Milvus and Java SDK.
 |    >= 2.2.9    |  2.2.7 ~ 2.2.15  |
 |     2.3.x      |      2.3.11      |
 |     2.4.x      |      2.4.8       |
-|     2.5.x      |      2.5.1       |
+|     2.5.x      |      2.5.2       |
 
 ### Install Java SDK
 
@@ -33,22 +33,47 @@ You can use **Apache Maven** or **Gradle** add Milvus SDK to your project.
         <dependency>
             <groupId>io.milvus</groupId>
             <artifactId>milvus-sdk-java</artifactId>
-            <version>2.5.1</version>
+            <version>2.5.2</version>
         </dependency>
        ```
 
    - Gradle/Groovy
 
         ```groovy
-        implementation 'io.milvus:milvus-sdk-java:2.5.1'
+        implementation 'io.milvus:milvus-sdk-java:2.5.2'
         ```
 
    - Gradle/Kotlin
 
         ```kotlin
-        implementation("io.milvus:milvus-sdk-java:2.5.1")
+        implementation("io.milvus:milvus-sdk-java:2.5.2")
         ```
-        
+
+From v2.5.2, milvus Java SDK is split into two packages: milvus-sdk-java and milvus-sdk-java-bulkwriter, because BulkWriter requires quite a lot of dependencies. If you don't need BulkWriter tool, you can ignore the milvus-sdk-java-bulkwriter package.
+To use BulkWriter, import milvus-sdk-java-bulkwriter to your project.
+
+- Apache Maven
+
+    ```xml
+     <dependency>
+         <groupId>io.milvus</groupId>
+         <artifactId>milvus-sdk-java-bulkwriter</artifactId>
+         <version>2.5.2</version>
+     </dependency>
+    ```
+
+- Gradle/Groovy
+
+     ```groovy
+     implementation 'io.milvus:milvus-sdk-java-bulkwriter:2.5.2'
+     ```
+
+- Gradle/Kotlin
+
+     ```kotlin
+     implementation("io.milvus:milvus-sdk-java-bulkwriter:2.5.2")
+     ```     
+
 ### Examples
 
 Please refer to [examples](https://github.com/milvus-io/milvus-sdk-java/tree/master/examples) folder for Java SDK examples.

diff --git a/examples/pom.xml b/examples/pom.xml
@@ -25,7 +25,7 @@
 
     <groupId>io.milvus</groupId>
     <artifactId>milvus-sdk-java-examples</artifactId>
-    <version>2.5.1</version>
+    <version>2.5.2</version>
 
     <build>
         <plugins>
@@ -64,7 +64,12 @@
         <dependency>
             <groupId>io.milvus</groupId>
             <artifactId>milvus-sdk-java</artifactId>
-            <version>2.5.1</version>
+            <version>2.5.2</version>
+        </dependency>
+        <dependency>
+            <groupId>io.milvus</groupId>
+            <artifactId>milvus-sdk-java-bulkwriter</artifactId>
+            <version>2.5.2</version>
         </dependency>
         <dependency>
             <groupId>org.tensorflow</groupId>