JBoss AS 7 / EAP 6 modules and class loading

JBoss AS 7 / EAP 6
modules and class loading

Takayoshi Kimura
Senior Software Maintenance Engineer
Global Support Services, Red Hat

The Class Path is Dead.

2

Agenda
● クラスローディングの基本
● JBoss Modules と MSC
● JBoss 6 のクラスローディング
● ユースケース別クラスローディング設定
● まとめ

4

クラスローディングの基本

5

クラスパス

● 特定のクラスローダがクラスをロードす
るパスを示す用語
● 大抵「システムクラスパス」を指す
● System Class Loader で利用される
-classpath オプション値
● ごくまれにアプリケーションクラスパス

6

クラスローダ種別

● Bootstrap Class Loader
● コア API
● Extension Class Loader
● Extension Mechanism
● System Class Loader
● -classpath
● Application Class Loader
● ユーザレベルクラスローダ
7

状況によるクラスローダの呼び名

● Initiating Class Loader
● Foo.class.getClassLoader()
● Parent Class Loader
● classLoader.getParent()
● Thread Context Class Loader
● Thread.currentThread().
getContextClassLoader()

8

システムクラスローダ

Bootstrap

Extension

System

9

クラスローダの確認
public class Test {
public static void main(String... args) {

// System Class Loader
System.out.println(Test.class.getClassLoader());

// System Class Loader
System.out.println(ClassLoader.getSystemClassLoader());

// Extention Class Loader
System.out.println(Test.class.getClassLoader().getParent());

// null == Bootstrap Class Loader
System.out.println(ClassLoader.class.getClassLoader());
}
}

10


● モノリシック
● 理解が簡単

11


● 同一ライブラリの異なるバージョンが扱
えない
● 見えてはいけないクラスやリソースが見
えてしまう
● クラスローダの作りなおしによるクラス
の再ロードができない

12

Java EE の階層型クラスローダ

System

Container

EAR EAR

WAR WAR

13


● 異なるバージョンを扱える
● アプリケーション毎のクラスローダ再作
成によるクラス再ロード可能

14


● 複雑
● クラス検索が遅い
● 重複配置
● ロード順によるデッドロック
● クラス共有
● 問題を回避するための仕組みがさらに複
雑度を増してしまう悪循環

15

モジュールクラスローダ

B1 B2

A C E

F D

19

モジュールクラスローダ
● モジュールひとつに対して一つのクラス
ローダ
● 各モジュールはランタイムで必要とする
依存モジュールを定義
● 階層型ではなくグラフ構造
● 「クラスパス」は存在しない

20

JBoss Modules
● モジュールクラスローダ環境
● モジュールを定義するための API や設定
ファイル
● シンプル
● 超高速

21

モジュール
● クラスロードするときのひとまとまりの
単位
● 通常は jar ひとつ
● 複数の jar や、プロパティファイルなどの
リソースを含む場合も

22

モジュールの配置
● ローカルモジュールディレクトリ
● $JBOSS_HOME/modules
● 階層化されたモジュール名と一致する
ディレクトリ構造
● Maven のリポジトリと類似
● モジュールのリソース (jar ファイルなど )
と、ディスクリプタ module.xml を配置

23

モジュールディスクリプタ
module.xml
<module xmlns="urn:jboss:module:1.1" name="org.jboss.remoting3">
<resources>
<resource-root path="jboss-remoting-3.2.8.GA-redhat-1.jar"/>
</resources>

<dependencies>
<module name="javax.api"/>
<module name="org.jboss.logging"/>
<module name="org.jboss.marshalling" export="true"/>
<module name="org.jboss.sasl" services="import"/>
<module name="org.jboss.xnio" export="true"/>
<module name="org.jboss.xnio.nio" services="import"/>
</dependencies>
</module>

24

import と export

A B C

export

A B (+ C) C

25

JBoss MSC

● Modular Service Container
● JBoss Modules 上にサービス層を提供
● API
● ServiceContainer
● Service
● ServiceController
● サービスの追加、削除、依存関係の管
理、インストール、ステート管理
26

JBoss EAP 6 の
クラスローディング

27

JBoss EAP 6 のクラスローディング

● デプロイされたものもモジュールとなる
● deployment.mywar.war
● deployment.myear.ear.mywar.war
● ローカルモジュールに対し、サービスモ
ジュールと呼ばれる
● デプロイされたアプリケーションに応じ
て必要な依存モジュールが自動 import
● EJB が含まれていれば EJB 関連の API

28

JBoss EAP 6 のクラスローディング

● WAR は一つのモジュール扱い
● WEB-INF/classes, WEB-INF/lib 内の jar は同
じモジュールクラスローダでロードされる
● EAR
● EAR/lib は一つのモジュールとなる
● サブデプロイメント同士もデフォルトで参
照可能
● EE 仕様には反しているが、仕様が微妙

29

デプロイメントとモジュール

EAR EAR/lib

EJB1.jar

EJB2.jar

WAR のみ片方向 import
WAR 以前と同様、 WAR 内の
クラスは他から参照不可

30

デプロイメントに対する
クラスローディング優先順
● システムモジュール
● コンテナが import
● ユーザモジュール
● アプリケーションで import
● ローカルリソース
● デプロイメント内リソース

31

デプロイメントに対する
クラスローディングのカスタマイズ
● META-INF/jboss-deployment-structure.xml
● WAR の場合は WEB-INF
● おすすめ
● グローバルモジュール
● META-INF/MANIFEST.MF
● Dependencies: org.slf4j

32

jboss-deployment-structure.xml
<jboss-deployment-structure xmlns="urn:jboss:deployment-structure:1.0">
<deployment>
<dependencies>
<module name="javax.faces.api" slot="1.2" export="true"/>
<module name="com.sun.jsf-impl" slot="1.2" export="true"/>
</dependencies>
</deployment>
<sub-deployment name="jboss-seam-booking.war">
<exclusions>
<module name="javax.faces.api" slot="main"/>
<module name="com.sun.jsf-impl" slot="main"/>
</exclusions>
<dependencies>
<module name="javax.faces.api" slot="1.2"/>
<module name="com.sun.jsf-impl" slot="1.2"/>
</dependencies>
</sub-deployment>
</jboss-deployment-structure>

33

EE サブシステムの
グローバルモジュール
● 全てのデプロイメントにシステムモ
ジュールとして import
<subsystem xmlns="urn:jboss:domain:ee:1.0">
<global-modules>
<module name="org.apache.commons.logging" />
<module name="org.apache.log4j" />
<module name="org.slf4j" />
</global-modules>
</subsystem>

34

lib/ext ディレクトリ

● $JBOSS_HOME/lib/ext ディレクトリ
● lib ディレクトリ自体にはまったく意味はな
い
● jar を置いても何も起こらない
● Extension Mechanism
● lib/ext ディレクトリに jar を配置
● マニフェストエントリ Extension-List で参照

35

モジュール依存関係のデバッグ

● JMX
● ローカルモジュール
● jboss.modules:type=ModuleLoader,name=Local
ModuleLoader-3 dumpAllModuleInformation
● デプロイメント ( サービスモジュール )
● jboss.modules:type=ModuleLoader,name=Servic
eModuleLoader-5 dumpAllModuleInformation

36

コンテナ側モジュールの利用

● 利用可能
● Java EE 関連 API
● ロギング API
● 拡張ポイント
● 利用不可能
● その他全てのサードパーティモジュール

37

ユースケース別
クラスローディング設定

38

ユースケース別
クラスローディング設定
● プロパティファイル
● 既存の WAR
● 共有ライブラリ
● 他モジュールのアノテーションスキャン

39

プロパティファイル

● 基本は jar にまとめてアプリケーションと
一緒にデプロイ
● アプリケーションの外に置きたい場合は
モジュールにする
mkdir -p $JBOSS_HOME/modules/conf/main/properties/
cat $JBOSS_HOME/modules/conf/main/module.xml
<module xmlns="urn:jboss:module:1.1" name="conf">
<resources>
<resource-root path="properties"/>
</resources>
</module>

40


● グローバルモジュールとして参照

<subsystem xmlns="urn:jboss:domain:ee:1.0">
<global-modules>
<module name="conf" slot="main" />
</global-modules>
</subsystem>

41


● jboss-deployment-structure.xml から参照

<jboss-deployment-structure>
<deployment>
<dependencies>
<module name="conf" />
</dependencies>
</deployment>

42

既存の WAR

● フレームワークやライブラリを利用した
多数の jar ファイルを含むレガシーな
WAR ファイル
● アプリケーション EAR/WAR 内に依存 jar が
全て含まれている
● 基本的にはクラスローディングに関して
は無修正で OK

43

共有ライブラリ

● 既存のアプリケーションが共有ライブラ
リを利用している
● アプリケーション EAR/WAR 内に依存 jar が
全て含まれていない
● 共有ライブラリをモジュール化
● モジュール依存を定義

44

他モジュールを JBoss の
アノテーションスキャン対象にする
● jandex を利用して jar にアノテーションイ
ンデックスを事前に作成
● アノテーションを import
<jboss-deployment-structure>
<deployment>
<dependencies>
<module name="foo.bar" annotations="true"/>
</dependencies>
</deployment>

45

まとめ

● JBoss Modules / JBoss EAP 6 の
クラスローディング
● シンプル
● 高速
● フレキシブル

47

JBoss AS 7 / EAP 6 modules and class loading

Recomendados

Recomendados

Mais conteúdo relacionado

Mais procurados

Mais procurados (20)

Semelhante a JBoss AS 7 / EAP 6 modules and class loading

Semelhante a JBoss AS 7 / EAP 6 modules and class loading (20)

Mais de nekop

Mais de nekop (9)

Último

Último (9)

JBoss AS 7 / EAP 6 modules and class loading