@@ -23,6 +23,64 @@ However, we **strongly recommend upgrading to Java 11 or higher** to ensure comp
2323🔁 ** If you’re using Fluss with Apache Flink** :
2424Please also upgrade your Flink deployment to ** Java 11 or above** . All Flink versions currently supported by Fluss are fully compatible with Java 11.
2525
26+ ## Java client: Package and GroupId Migration
27+
28+ 🔧 ** Action Required** : All Java client users must update their dependencies and import statements to continue using Fluss.
29+
30+ ### What Changed
31+
32+ | Aspect | Fluss v0.7 | Fluss v0.8 |
33+ | -------------| ------------------------------| ----------------------------|
34+ | ** GroupId** | ` com.alibaba.fluss ` | ` org.apache.fluss ` |
35+ | ** Package** | ` com.alibaba.fluss ` | ` org.apache.fluss ` |
36+
37+ ** Note** : This change does not affect the Fluss client API.
38+
39+ ### Impact Assessment
40+
41+ ** All Java client users** will need to update their dependencies and import statements:
42+
43+ 1 . ** Build Dependencies** : Update your Maven/Gradle dependencies to use the new groupId
44+ 2 . ** Import Statements** : Update all import statements from ` com.alibaba.fluss.* ` to ` org.apache.fluss.* `
45+
46+ ### Migration Steps
47+
48+ 1 . ** Update Maven Dependencies** :
49+ ``` xml
50+ <!-- Old dependency -->
51+ <dependency >
52+ <groupId >com.alibaba.fluss</groupId >
53+ <artifactId >fluss-client</artifactId >
54+ <version >0.7.x</version >
55+ </dependency >
56+
57+ <!-- New dependency -->
58+ <dependency >
59+ <groupId >org.apache.fluss</groupId >
60+ <artifactId >fluss-client</artifactId >
61+ <version >0.8.0</version >
62+ </dependency >
63+ ```
64+
65+ 2 . ** Update Import Statements** :
66+ ``` java
67+ // Old imports
68+ import com.alibaba.fluss.client.Connection ;
69+ import com.alibaba.fluss.client.ConnectionFactory ;
70+
71+ // New imports
72+ import org.apache.fluss.client.Connection ;
73+ import org.apache.fluss.client.ConnectionFactory ;
74+ ```
75+
76+ ### Why This Change Was Made
77+
78+ This change represents an important milestone in Fluss's journey to becoming an Apache project. The migration to ` org.apache.fluss ` :
79+
80+ - Aligns with the Apache Software Foundation's naming conventions
81+ - Establishes a clear, independent identity for the project
82+ - Ensures long-term stability and governance under the Apache umbrella
83+
2684## Metrics Updates
2785
2886We have updated the report level for some metrics and also removed some metrics, this greatly reduces the metrics amount and improves the performance.
0 commit comments