Java SE 8からJava SE 11までの主要な変更点 ================================================================================ .. only:: html .. contents:: 目次 :depth: 3 :local: 本章では、Java SE 8からJava SE 11にマイグレーションする開発者に向け、本ガイドラインで解説している機能に関連のある主要な変更点を解説する。 詳細は、各章を参照されたい。 なお、本章は\ `Oracle JDK Migration Guide `_\に基づいて執筆している。より理解を深めるため、こちらも一読されたい。 Java SE 9から非推奨となったJava EE関連モジュールの削除 -------------------------------------------------------------------------------- Java SE 11では、Java SE 9から非推奨であったJava EE関連のモジュールが削除された。 詳細については、\ `Oracle JDK Migration GuideのRemoval of Java EE and CORBA Modules `_\を参照されたい。 これにより、本ガイドラインで解説している機能のいくつかを正常に動作させるには、これらの代替となる依存ライブラリを追加することが必要となる。 以下に、本ガイドラインで記載のあるモジュールを紹介する。 なお、以下で解説する依存ライブラリの追加はあくまで検証の一結果に過ぎず、アプリケーションの実装(依存しているライブラリの種類)と動作環境により異なる対応が必要な場合があることに留意されたい。 .. _remove-jaxb-from-java11: JAXBの削除 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Java SE 11でJAXBを利用する場合、jaxb-core及びjaxb-implが必要となる。 アプリケーションの依存ライブラリやAPサーバから提供されるライブラリにjaxb-core及びjaxb-implがない場合は、下記のようにpom.xmlに依存関係を追加すること。 .. code-block:: xml com.sun.xml.bind jaxb-core ${jaxb-core.version} com.sun.xml.bind jaxb-impl ${jaxb-impl.version} .. tabularcolumns:: |p{0.10\linewidth}|p{0.90\linewidth}| .. list-table:: :header-rows: 1 :widths: 10 90 * - 項番 - 説明 * - | (1) - | Jakarta EE 8に準拠した任意のバージョンを指定する。 なお、上記ではJAXBを動作させるための実装ライブラリを追加している。JAXBのAPIを利用するソースコードがある場合、コンパイルのためAPIライブラリが必要となる。 .. _remove-jax-ws-from-java11: JAX-WSの削除 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Java SE 11でJAX-WSを利用する場合、以下のようにjakarta.xml.ws-api及びjakarta.jws-apiを依存関係に追加する必要がある。 .. code-block:: xml jakarta.xml.ws jakarta.xml.ws-api jakarta.jws jakarta.jws-api ${jakarta.jws-api.version} .. tabularcolumns:: |p{0.10\linewidth}|p{0.90\linewidth}| .. list-table:: :header-rows: 1 :widths: 10 90 * - 項番 - 説明 * - | (1) - | jaxws-apiのバージョンはterasoluna-gfw-parentが依存している\ `Spring Boot `_\ で管理されているため、pom.xmlでのバージョンの指定は不要である。 * - | (2) - | Jakarta EE 8に準拠した任意のバージョンを指定する。 なお、JAX-WSを動作させるための実装は各APサーバまたはApache CXFによって提供される想定であり、上記ではアプリケーションのコンパイルに必要となるAPIのみを追加している。 jaxws-riはjakarta.xml.ws-api及びjakarta.jws-apiを含むJAX-WS実装をカバーするライブラリだが、Jakarta EE(Java EE)サーバやApache CXFのJAX-WS実装に干渉し、Java SE 8での実行と異なる挙動を示す場合があるため、jaxws-riの利用は推奨していない。 例として、jaxws-riを利用した場合、Apache CXFのタイムアウト値として認識されるプロパティが変わってしまう事象を確認している。 .. _remove-common-annotations-from-java11: Common Annotationsの削除 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Java SE 11でCommon Annotationsを利用する場合、以下のようにjakarta.annotation-apiを依存関係に追加する必要がある。 .. code-block:: xml jakarta.annotation jakarta.annotation-api .. tabularcolumns:: |p{0.10\linewidth}|p{0.90\linewidth}| .. list-table:: :header-rows: 1 :widths: 10 90 * - 項番 - 説明 * - | (1) - | jakarta.annotation-apiのバージョンはterasoluna-gfw-parentが依存している\ `Spring Boot `_\ で管理されているため、pom.xmlでのバージョンの指定は不要である。 なお、Common Annotationsを動作させるための実装は各APサーバによって提供される想定であり、上記ではアプリケーションのコンパイルに必要となるAPIのみを追加している。 .. _conflict-deprecated-modules-from-java11: 推移的に解決されるJava EE関連モジュールの競合 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Java SE 11以降での開発を円滑に行うため、 いくつかのOSSライブラリはこれまでに説明したJava SE 11で削除されたJava EE関連モジュールを依存ライブラリとして推移的に解決してくれるよう改善されている。 **不幸にも、実行環境によってはこれが原因となりアプリケーションが起動しない、処理に問題が生じるといったケースがあるため、留意されたい。** 具体的には、本来アプリケーションサーバのモジュールを参照していたところを部分的にアプリケーションの依存ライブラリを参照してしまい、 バージョン不整合によるリンケージエラーや\ ``NoSuchMethodException``\ が発生する、エラーにはならないが期待した挙動と異なるといった不具合が発生する。 この場合は、アプリケーションのビルド時にアプリケーションサーバから提供されるモジュールを除外する、 アプリケーションサーバのクラスローダ設定によりアプリケーションの依存ライブラリを優先するといった対策が有効である。 \ `WebLogic 12cを利用する際の注意点 `_\ や\ `JBoss EAP 7を利用する際の注意点 `_\ も併せて参照されたい。 .. _change-default-locale--data-from-java9: デフォルトで使用されるロケール・データの変更 -------------------------------------------------------------------------------- Java SE 9以降では、Unicodeコンソーシアムの共通ロケール・データ・リポジトリ(CLDR)データがデフォルトのロケール・データとして有効化されている。 これにより、Java SE 9以降では、Java SE 8以前とは日付、時間、数値などの書式で文字列を出力した場合に結果が変わる可能性がある。 Java SE 11の標準の設定値から変更してJava SE 8以前と同じ書式で出力したい場合は、システム・プロパティ\ ``java.locale.providers``\のCLDRの前にCOMPATを設定する必要がある。(例:\ ``java.locale.providers=COMPAT,CLDR,SPI``\) 詳細については、\ `Oracle JDK Migration GuideのUse CLDR Locale Data by Default `_\を参照されたい。 .. _support-tls1.3-by-default-from-java11: HTTP通信におけるTLS(Transport Layer Security) v1.3のサポート -------------------------------------------------------------------------------- Java SE 11より、TLS(Transport Layer Security) バージョン1.3がサポートされ、デフォルトで1.3が使用されるようになった。 しかし、2019年現在ではOSやミドルウェアがTLS 1.3に対応していないものも多いのが現状であり、まだしばらくはTLS 1.2が利用されると考えられる。 これに対応するため、Java SE 11ではJVMレベルで利用するTLSのバージョンを変更することが可能である。 クライアントで使用するバージョンは、JVMのシステム・プロパティ\ ``jdk.tls.client.protocols``\を設定することで変更可能である。 APサーバを介さずに公開するサーバで使用するバージョンは、同様にシステム・プロパティ\ ``jdk.tls.server.protocols``\を設定することで変更可能である。 詳細は\ `JDK 11 Release Notes `_\ を参照されたい。 .. note:: LinuxのSSL通信を制御するopenssl はバージョン1.1.1でTLS 1.3に対応するが、コンパイル済みのパッケージは頒布されておらず、開発者が自らコンパイルして組み込む必要がある。 Tomcat等のミドルウェアはopensslを利用してHTTPS通信を行なうが、ミドルウェアが内包するopensslをアップデートするためには、ミドルウェア自体も再コンパイルする必要がある。 同様に、opensslをアップデートすることによりOSの機能が正常に動作しなくなる可能性がある。 このため、独自にopensslをコンパイルしてアップデートすることは、一般的な開発者には推奨しない。 TLS 1.3に対応したopensslを内包したOSにアップデートして、環境を構築しなおすべきである。 .. _performance-differences-between-java: Java SE 8とJava SE 11のパフォーマンスの違い -------------------------------------------------------------------------------- Java SE 8とJava SE 11でCPUやメモリ使用率の傾向が異なる場合があることを確認している。 同一環境、同一アプリケーションでも、Java SE 11を使用することでパフォーマンスが劣化する可能性があるため、性能試験を実施してパフォーマンスを確認されたい。 また、Java SE 9よりデフォルトで使用されるGC(Garbage Collection)がParallel GCからG1 GCに変更され、CMS(Concurrent Mark Sweep) GCが非推奨となった。 CMS GCを使用していた場合は、プロジェクトの要件から新たに使用するGCを検討し、移行することを推奨する。 .. raw:: latex \newpage