GlassFish RESTful managementSeptember 24, 2012

HASUNUMA KenjiVice president, GlassFish Users Group Japan

E-mail: k.hasunuma@miracle.ocn.ne.jpTwitter: @btnrouge

© U.S.Navy : http://www.navy.mil/viewGallery.asp

GlassFishの管理ツール

1.管理コンソール (Web UI)

2.asadmin

3.REST管理チャネル

What’s REST?

© U.S.Navyhttp://www.navy.mil/viewGallery.asp

RESTの3原則•リソース•メソッド (リソースの操作)•URI (リソースの識別)

RESTなもの(RESTful)の例

• Amazon.co.jp

• facebook

• Movable Type

→RESTの3原則=メソッドの使い分け

RESTでないものの例

• Apache Struts

• JavaServer Faces

• SOAPベースのWebサービスすべて

→何でもかんでもPOSTで処理

REST管理チャネルのリソース(URI):

http://localhost:4848 /management/domain

リソース(URI): JDBCコネクションプール

/management/domain /resources /jdbc-connection-pool /DerbyPool /__TimerPool

リソース(URI): list-jvm-options

※コマンド: それ自身は情報を持たない(GETメソッドによるアクション実行)

/management/domain /list-jvm-options

GETメソッド

•リソース(URI)の状態を取得する•子リソースへのアクセス手段を得る(有効なメソッド、データ形式)

POSTメソッド

•リソースの状態を変更する•設定変更 & 子リソースの作成(方法→事前にGETで調べておく)

PUTメソッド

•リソース(URI)を作成する•基本的に使用しない→親リソースへのPOSTで代用する

DELETEメソッド

•リソース(URI)を削除する•サーバーリソース(JDBCコネクションプール等)の削除に用いる

How to use it?

© U.S.Navyhttp://www.navy.mil/viewGallery.asp

必要なもの: HTTPクライアント

•Webブラウザ

• HTTPクライアントアプリケーション(有償でも良いものを選択すること!)

• HTTPクライアントライブラリ(Jersey Client API、JAX-RS 2.0 等)

REST管理チャネルの入出力

• HTML … Webブラウザ用

• XML … DOM、StAX、JAXB等

• JSON … JavaScript、JSR 353等

messageメッセージがあれば設定(通常は空文字列)

exit_code 通常は “SUCCESS”

extraProperties取得・設定するキー/値※ ”methods”リスト

childResources子リソースのリスト(存在する場合)

commandPOSTメソッド識別用の値(最上位entry要素のキー)

HTML フォームを含むHTML(Webブラウザからの操作が前提)

XML

<entry> : key, value 属性<map> : <entry> <map> の集合

<list> : <map> の配列※トップレベル要素は <map>

JSON 全体が object ( { ... } ) で構成される、一般的なJSON形式

REST管理チャネルの用途

•独自の管理/監視ソリューション• GlassFish管理の自動化•アプリケーションからの設定変更

GlassFish RESTful managementHASUNUMA Kenjik.hasunuma@miracle.ocn.ne.jp

© U.S.Navyhttp://www.navy.mil/viewGallery.asp