apache / apache/arrow-java

[Java][CI] Java Support Version Policy

オープン
#237 コメント 2 件 リアクション 0 件 担当者 0 名 GitHub で見る
Component: Documentation Type: enhancement
主要言語
Java
スター
94
フォーク
152
平均マージ
3日 16時間
マージ済み PR(30日)
11

説明

**Current status**

1. Apache Arrow Java is compiled and tested by JDK 8, 11, 17, 18 but packaged with source/target JDK8

**Changes implemented by this PR** [https://github.com/apache/arrow/pull/13072](https://github.com/apache/arrow/pull/13072*)

1. Apache Arrow Java project are continuing compiled and tested by JDK 8, 11, 17, 18 but packaged with source/target JDK8
2. If Apache Arrow Java project is building with JDK11+ validate the project are tested against the module-info.java definitions
3. There are not CI implementation to deliver Jar library with JDK8 & JDK11+ (we need to define what will be our next step for JDK versions)
4. We probably are breaking APIs because we are changing package name to ensure unique package names on the project required by module-info.java
5. We are added a new project that contains Apache Arrow Netty custom implementation needed for
6. There are remaining modules pending to implement modules with module-info.java files. This PR contains modules-info.java for: Format / Memory / Vector

**Next steps**

1. Implement cross-compilation with JDK 11+ and packaging with release=8 (continue offering support for JDK8):
That is not posible, if we compile with --release=8 we will have problems to access sun.misc.Unsafe that is not as exposed/public/documented API for N >= 9: -source N -target N --system .    ()
 
2. We have these options for our next steps:
- {**}Option 1{**}.- Maintain all as it is now, continue packaging with source/target JDK8

- {**}Option 2{**}{**}.-{**} Change/Update/Modify use of sun.misc. classes dependencies to be able to support cross-compilation (-release 8) to packaging with JDK11+ and continue offering support for JDK8 also

{code:java}
jdeps --jdk-internals arrow-memory-unsafe-10.0.0-SNAPSHOT.jar
arrow-memory-unsafe-10.0.0-SNAPSHOT.jar -> jdk.unsupported
   org.apache.arrow.memory.unsafe.UnsafeAllocationManager -> sun.misc.Unsafe                                    JDK internal API (jdk.unsupported)
Warning: JDK internal APIs are unsupported and private to JDK implementation that are
subject to be removed or changed incompatibly and could break your application.
Please modify your code to eliminate dependence on any JDK internal APIs.
For the most recent update on JDK internal API replacements, please check:
https://wiki.openjdk.java.net/display/JDK8/Java+Dependency+Analysis+Tool
JDK Internal API                         Suggested Replacement
----------------                         ---------------------
sun.misc.Unsafe                          See http://openjdk.java.net/jeps/260 {code}
- {**}Option 3{**}.- Drop support for JDK8 and starting offering support to packaging with JDK11+, this will be the right approach, but, this thread does not have an agreement about to drop JDK8 support ([JAVA] JDK Support Policy - )

If you decided to push some of this options please use that [ML\|[https://lists.apache.org/thread/phpgpydtt3yrgnncdyv4qdq1gf02s0yj]] to move on next steps.

**Reporter**: [David Dali Susanibar Arce](https://issues.apache.org/jira/browse/ARROW-18020) / @davisusanibar
#### Subtasks:
- [ ] [[Java][Flight] Implement JPMS (module-info.java) for Flight module](https://github.com/apache/arrow/issues/33224)
- [ ] [[Java][Flight] Define a method to modularize GRPC API/Context dependency](https://github.com/apache/arrow/issues/33225)
- [ ] [[Java] Implement cross-compilation for JDK11 and be able to produce artifacts for JDK8 (--release 8)](https://github.com/apache/arrow/issues/33226)
- [ ] [[Java] Drop JDK8 support](https://github.com/apache/arrow/issues/33227)
#### Related issues:
- [[Java] POC Arrow Modular](https://github.com/apache/arrow/issues/20212) (contains)

**Note**: *This issue was originally created as [ARROW-18020](https://issues.apache.org/jira/browse/ARROW-18020). Please see the [migration documentation](https://github.com/apache/arrow/issues/14542) for further details.*

コントリビューションガイド

コントリビューションガイドを開く

調査の方向性

JPMS、クロスコンパイル、JDK 8 サポートに関して、PR 13072 と記載されているサブタスクを確認する。未解決の選択肢が複数記録されているため、方向性を決める前にリンク先のメーリングリストのスレッドを読むこと。完了とは、合意された JDK サポートポリシーが定まり、選択した実装作業が完了していることを意味する。

索引モデルが issue の本文から書いたものです。

評価

技術スタック
java
領域
build-system, ci-cd
issue の種類
機能追加
難易度
5/5
見積もり時間
1週間以上
活発さ
停滞
明瞭さ
説明が足りない
初心者へのやさしさ
20/100

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。