Antプログラミング（１） - プラグイン

Antプログラミング（１） - プラグイン
2015/11/20 Javaツール勉強会資料
QTS / ISIT 神戸隆行（かんどたかゆき）

自己紹介 - 全般
2015/11/20Javaツール勉強会2
 九州先端科学技術研究所（ISIT）の方から来ました
 職場はそこだけど所属はQuoliarc Technology Solutions Ltd.
 チーフソフトウェアエンジニア（…といっても従業員は1人、院の指導教官
がCTO）
 数学ソフトウェア（数値解析、数式処理）、プログラム最適化、動的再構
成可能プロセッサ向けコンパイラと来て今はPTaaSを作っています
 連絡先：
 Twitter: @ChihiroShiiji
 Facebook: takayuki_kando
 mail: kando@nerimadors.or.jp
 趣味プロジェクト： TRPGオンラインセッションツールの開発
 趣味：イラスト描き、コスプレ？

自己紹介 - Antとの関わり
 普段のビルドにも使っていますが…
 PTaaS （Platform for TaaS）
 開発ツールをネットワークのサービスとして提供する（Tool as
a Service）ためのプラットフォーム
 技術的には「XMPPベースのマルチユーザ遠隔分散ビルド」
システム
 ビルドスクリプトを解釈し、ツールを起動する核の部分にAntを使って
います

LAN
実マシン
ビルド~遠隔分散ビルド・ミドルウェア
クラウド
仮想マシン
開発ツール
仮想マシン
開発ツール
仮想マシン
分散ビルド・
ミドルウェア
実マシン
開発ツール
実マシン
開発ツール
実マシン
分散ビル
ド・ツール
実マシン
クライア
ント
ビルド手順
記述
ビルド手順
記述
開発ツールビルド・
ツール
ビルド手順
記述
通常のビルド・ツール分散ビルド・ツール
遠隔分散ビルド・ミドルウェア（遠隔＋分散ビルド＋VM制御）
リモート実行：
ユーザ認証
ファイル同期
時刻同期
ツール入出力の中
継
暗号化
仮想マシン管理
隔離
負荷分散
make
ANT
etc...
4
（構築ホスト）
（開始ホスト）

サーバVM
凡例：
VMM-VM
遠隔分散ビルド型PTaaSの実験実装
"Trebuchet"の構成の詳細（制御構造）
ユーザーの計算機
IDE
ワーカーVM
プロジェクトVM
XMPPサーバ
クライア
ント・プラ
グイン
管理用の計算機
管理用
XMPPクライ
アント
ワーカーVM
ワーカーVM
プロジェクト・
ファイルサーバ
ワーカー
ワーカー
ワーカー
プロジェクト
ローカル・
ストレージ
XMPP接続
（ビルド制御、状態情報用）
CloudOS
APIによる管理
プロジェクト・ビルダ
ビルド・
ツール
クラウド
VMMコンポーネント
仮想マシ
ン・プール
Cloud OS
API
開発ツール
A
開発ツール
B
開発ツール
C
5
CI
ツール
クライア
ント・プラ
グイン
※ サーバ以外はアウトバウンド
のXMPP接続になっている
DMZ

復習 - Antの構造
 ターゲット(target要素)の依存関係でビルドのプロセスを
編成
 プロパティ（property要素）を環境や処理の過程を記述
する「変数」として利用できる
 ターゲット内の個々の処理を表すタスク（処理毎の名の
ついた要素）
 良く使われる処理は予め豊富に準備
 exec、apply、javac、java、jar、zip、unzip、ftp、get(http)、mkdir、
copy…
 タスクが利用するビルドに便利なデータ型も準備されている
 fileset、pathset、filelist、patternset…

復習 - Antの特長…今となっては歴史？
（Ant以前、makeと比較）
 Javaで書かれていて主だった処理はAnt内で閉じている
 makeでは依存関係ルール、拡張子ルールでコマンドを実行
する機能しかない
 osのコマンド、特にshに多くを依存していた
 複雑な処理や変数はmakefileにシェルスクリプトの断片で書く
 OSの違いから大きく影響を受ける
 依存関係の明示
 makeでは依存関係はファイルの読み取り条件として間接的
に指定され更新日付で実行が制御されていた
 ファイルの読み書きをしないタスクはダミーのファイルを作ってtouch
コマンドを実行したりしていた
 拡張可能であり、拡張はJavaで記述できる
 makeを拡張する手段は基本的に存在しない

概要
 Antをプログラミングする話
 Antの拡張…プラグイン・プログラミング
 本日の主題
 参考：「Ant」第2版、Steve Holzner 著、長瀬嘉秀監訳、オライリー
ジャパン、2005年11月
 Antをプログラムに組み込んで使う
 時間の都合で今日は省略
 いつか機会があれば
 PTaaSでは両方使っています
 ツールを遠隔実行するTRExec、TRApplyタスクの追加
 ProjectsエージェントはAntスクリプトを解釈実行するため内
部にAntを組み込んでいます

タスク
 タスクの追加が恐らくプラグインの中心
 一応リソースやフィルタなども追加できます
 taskdef要素で追加したいタスクを実装したJavaクラスを
指定する
 組みこんでしまう方法もあるがtaskdefの方がお手軽
 タスクの動作を指定するクラスの最低必要な条件は
public void execute()メソッドがあること
 例：
 sample.Greetingクラス
 build_greeting.xml

タスクのライフサイクル
1. 無引数のコンストラクタで作成
2. project、locationフィールドの設定
3. プロジェクトへのタスクid（あれば）登録
4. targetフィールドの設定
5. init()メソッドによる初期化
6. 全子要素の追加
7. 全アトリビュートの設定
8. 全子要素の全アトリビュート設定
9. 文字データの追加
10. execute()の実行

Taskクラスの利用
 一般にはTaskクラスを拡張して利用
 Antとのインターフェースに便利なメソッドが色々ある
 例えば既定義のプロパティへのアクセス
 this.getProject().getProperties()などによる
 タスクのアトリビュートはセッターsetXXXX()を定義して
おくと渡してくれる
 サポートされる型： boolean、char、int、short、File、String、
org.apache.tools.ant.types.Path（パス文字列）、
org.apache.tools.ant.types.EnumuratedAttributes（列挙）、
String1引数のコンストラクタを有する任意のクラス
 例：
 sample. DumpPropertiesクラス
 build_prop.xml

中断とログ出力
 中断にはexecute()内からBuildExceptionを投げる
 例：
 sample. Failureクラス
 build_failure.xml
 ロギングはlog()メソッドを利用
 例：
 sample. Logクラス
 build_log.xml

タスクのテキスト・コンテンツ
 テキスト
 addText()メソッドをオーバーライド
 例（前述のlog出力と同じ例）：
 build_log.xml

子要素
 カスタムな子要素
 createXXXX()メソッドを定義
 子要素の子要素、テキストコンテンツやアトリビュートはタスクと同様
の方法で受け取れる
 例：
 sample. Nestクラス
 build_nest.xml
 タスクがファイルセットをサポートする場合の子要素
 TaskではなくMatchingTaskを拡張して利用する
 例：
 sample. Dirクラス
 build_dir.xml

外部コマンドの実行
 org.apache.tools.ant.types.Commandlineと既定義の
タスクorg.apache.tools.ant.taskdefs.Executeを利用す
れば簡単
 自分で作成するとストリームの準備やエラー処理など色々大
変
 例（前述のlog出力と同じ例）：
 build_log.xml

まとめ
 Antをプログラミングする話（その1）
 Antの拡張…プラグイン・プログラミング
 タスクの追加方法
 アトリビュートの受け取り
 ログ出力
 中断
 テキストコンテンツの受け取り
 子要素
 カスタムな子要素
 FileSetの子要素
 外部コマンド実行
 簡単でしたね！
ソースコードはGistに：
https://gist.github.com/TakayukiKando/340aca3925007c0
0ee73

Antプログラミング（１） - プラグイン

Recommended

Recommended

More Related Content

What's hot

What's hot (20)

Similar to Antプログラミング（１） - プラグイン

Similar to Antプログラミング（１） - プラグイン (20)

More from 隆行神戸

More from 隆行神戸 (6)