http://www.projectzero.org/sMash/1.1.x/docs/zero.devguide.doc/zero.cli.tasks/ExtendingCli.html

カスタムzeroコマンドを利用するには、大きく分けて2つの手順が必要です。
1. カスタムzeroコマンドを実装するsMashアプリの作成・公開
2. sMash本体への依存性追加・解決

●1. カスタムzeroコマンドを実装するsMashアプリの作成・公開

まず、アプリケーションを作成します。ここでは、MyCommandsという名前とします。この名前はコマンド名とは無関係です（リポジトリー内のパッケージ名となります）。最終的にsMashのリポジトリーに取り込まれるため、作成する場所はどこでも構いません。
zero create MyCommands

次に、MyCommandsアプリケーションの/config/zero.configを編集します。ここには、コマンド名と、そのコマンドを処理するイベント・ハンドラーを記述します。例えば、”zero mytask”コマンドを作成する場合は、以下のように記述します。

# MyTask
/config/handlers += [{
"events": "cliTask",
"handler" : "cliTask.groovy",
"conditions" : "/event/task =~ mytask"
}]

/config/handlersは、イベント・ハンドラーを登録するためのグローバル・コンテキストのキーです。ここには、3つの値をJSON形式で記述します。
http://www.projectzero.org/sMash/1.1.x/docs/zero.devguide.doc/zero.core/Config.html#Event_handler_registration

• events : イベント名。コマンドの場合は”cliTask”という名前を指定しなければなりません。
• handler : イベント・ハンドラーの名前。パスを指定しない場合は、/app/scripts内のファイルとして扱われます。
• conditions : 実行中の間、有効な値。/event/taskに指定した値がコマンド名になります。また、/event/subTaskに指定した値が、コマンドのサブタスク名になります。

ちなみに、他のポート番号などは、コマンド実行時には全く影響しません。

次に、zero.configで指定したイベント・ハンドラーを実装します。/app/scriptsディレクトリーに、cliTask.groovyを作成し、以下のように記述します。

def onCliTask() {
def task = zget(”/event/task”)
System.out.println(”task name is ” + task)
zget(”/event/args”).each{System.out.println(”arg is ” + it)}
}

このコードでは、onCliTask()メソッドを定義し、タスク名を”task name is XXXX”と出力します。また、その後に引数があった場合には、その数だけ”arg is YYYY”と出力します。
これで、カスタムコマンドの実装は完了です。このアプリケーションをリポジトリに公開します。MyCommandsディレクトリに戻り、zero packageコマンドと、zero publishコマンドを実行してください。

mytaskコマンドのpublish

以上で、アプリケーション側の操作は完了です。最後に、sMashにこのアプリケーションの依存性を追加します。

●2. sMash本体への依存性追加・解決

sMash本体のディレクトリーを開き、config/ivy.xmlファイルを開き、以下の1行を<dependencys>内に追加します。

<dependency name=”MyCommands” org=”zero” rev=”[1.0.0.0,)"/>

これにより、通常のCLIに加え、先ほど作成したコマンドがsMashで使えるようになります。ivy.xmlを保存して終了した後、zero resolveを実行してください。zero resolveが失敗する場合は、アプリケーションの公開に失敗していますので、リポジトリーを確認してください。
今回作成したコマンドの実行例は以下の通りです。

mytaskコマンド実行例

このカスタムコマンドの実行のためにsMashのアプリケーションを起動しておく必要は全くありません。通常のzeroコマンドと同様に利用できます。

●設定手順

eclipseは導入済みという前提で紹介しますので、eclipseが必要な方はeclipseをダウンロードしてください。バージョンは3.2以上のものを使用して下さい。また、PHPの開発環境の構築するにはeclipseのPHP用のプラグインであるPDTが必要です。PDT導入済みのeclipseを手に入れるには、PDＴ all in one packageをダウンロードする方法が便利です。

1. V1.0の環境からのマイグレーションの場合は、以前のバージョンのプラグインをアンインストールします。
   ・Eclipse 3.4の場合 : Help > Software Updates > Installed Software
   ・Eclipse 3.2の場合 : Help > Software Updates > Manage Configuration
2. Project Zero公式サイトから、sMash V1.1.1.1をダウンロードします。
3. zipファイルを解凍し、解凍してできたzeroフォルダを任意の場所に配置します。
4. zeroフォルダに移動し、zeroコマンドを実行します。例えば、Windowsの場合はコマンドプロンプトを立ち上げ、以下のコマンドを実行します(<zero_root>はzeroディレクトリを配置した先のzeroディレクトリ内を示す)。
   cd <zero_root>
   ./zero
5. eclipseを起動し、アップデートサイトの追加ダイアログを表示させます。
   ・Eclipse 3.5の場合 : Help > Software Updates > “Add site”
   ・Eclipse 3.4の場合 : Help > Software Updates > Installed Software > “Search for new features to install” > Next > “New Remote Site”
   ・Eclipse 3.2の場合 : Help > Software Updates > Manage Configuration > “Search for new features to install” > Next> “New Remote Site”
   ※マイグレーションの場合は、以前の更新サイトの設定をクリックし、Removeボタンをクリックして設定を削除します。
6. sMash pluginのアップデートサイトを入力します。現在の最新のアップデートサイトのURLは以下のとおりです。
   http://www.projectzero.org/zero/monza.dev/latest/update/zero.eclipse
7. PHP開発環境も同時に構築する場合には、もう一度ダイアログを表示し、URLに以下のものを指定し、OKをクリックします。ただし、eclipse 3.5の場合は、一度に導入できませんので、インストール後に再度、上記URLを入力してください。
   http://www.projectzero.org/zero/monza.dev/latest/update/zero.eclipse.php
8. Finishをクリックします。
9. Update Managerが起動し、Updateの一覧が表示されます。必要なものにチェックを入れ、”Next”をクリックします。すべてにチェックを入れても問題ありませんが、PHPのpluginを入れた場合には、PDTのバージョンに該当するものを入れてください。

   

   インストールするフィーチャーの選択

10. プログラム使用条件を確認し、”I accept the terms in the license agreements”を選択し、”Next”をクリックします。
11. インストール先の指定を確認し、変更する場合は”Change Location”から設定を行います(通常変更する必要はありません)。最後に、”Finish”をクリックします。
12. Update Managerが起動し、プラグインのインストール作業が行われます。途中、Verificationのウィンドウが表示されます。確認し、”Install”ボタンをクリックして下さい。
13. インストール完了後、再起動の確認ダイアログが表示されますので、”Yes”をクリックします。
14. 再起動後、Window > Preferences… をクリックします。
15. メニューの”WebSphere sMash”を選択し、以下の設定を行います。
    ・”Zero home”には、手順3で配置したzeroディレクトリーを指定します。
    ・”Module Group”にはstableを選択します。
    ・Automatic responce to dependency changes in the workspaceには、依存性変更時に自動で行われる動作を設定します。stableモジュールグループを使用している場合には、Run updateを選択しないようにします。
    設定が終わったらOKを押します。

    

    CLIのディレクトリとモジュール・グループの指定

16. V1.0からマイグレーションを行った場合に、以下のディレクトリが存在する場合、削除して下さい。
    <workspace_directory>\.metadata\.plugins\zero.cli.api\AppRoot\.zero\private\MG
17. V1.0からマイグレーションを行った場合には、必要に応じて、各プロジェクトをUpdateして下さい(右クリックメニューからWebSphere sMash Tools > Update)。
18. 環境をUTF-8に統一するため、eclipse.iniを開き、以下の１行を追加するか、eclipse.exeのショートカットを作成して、下記のオプション値を利用するように設定してください。
    -Dfile.encoding=UTF-8

以上で設定は完了です。これで最新の環境とモジュールが利用可能になりました。

先日の記事では、Apache POIを利用して、Excelのデータを取得する方法を書きました。今回は、WordとPowerPointのテキストを取得してみましょう。この機能を利用すれば、WordやPowerPointファイルの中身までキーワード検索したり、特定の禁止用語などが含まれていないかチェックすることが可能です。

まず、Wordのテキストを取得するコードは、このようになります。

java.io.FileInputStream fs = new java.io.FileInputStream(file_path);
WordExtractor we = new WordExtractor(fs);
String text = we.getText();

file_pathには、ファイルのパスを入力してください。これで、変数textに、Wordに書かれたテキストが全て格納されます。

次に、PowerPointのテキストを取得するコードです。

java.io.FileInputStream fs = new java.io.FileInputStream(file_path);
HSLFSlideShow hsss = new HSLFSlideShow(fs);
SlideShow ss= new SlideShow(hsss);
Slide[] slides = ss.getSlides();
String text = "";
for (int i = 0; i < slides.length; i++) {
TextRun[] textruns = slides[i].getTextRuns(); 
for (int j = 0; j < textruns.length; j++) {
text += textruns[j].getRawText();
}
}

これで、全てのテキストを変数textに格納することができます。また、Slideクラスの配列の数字が、ページ番号に対応しますので、何ページにその単語があるのかを調べることも簡単に行えます。

●概要

Groovy Bridgeの行い方は、基本的にJava Bridgeとほぼ同じで、クラスのインポートを行う関数がjava_importからgroovy_importに変わっただけです。Groovy特有の内容としては、インポート以外にも直接Groovyコードを実行できるgroovy_evalや、クロージャーを作成するgroovy_create_closureといった関数が用意されていることです。クロージャーはPHP5.3で利用可能になる予定ですが、sMashでは現在のところ、PHP5.2.3をベースとしているため、クロージャーを利用するにはこの関数を利用する必要があります。

とりあえず、最初は基本的な手順として、クラスをインポートして、そのクラスのメソッドを実行してみましょう。内容は、こちらのガイドとほぼ同様です。

●インポートするGroovyクラスを作成

まず、javaフォルダにImport.groovyとして、Groovyのクラスを1つ作りましょう。

class Import {
def public FIELD = "こんにちは！";
def public static VALUE = "Staticな値です";
def getMessage() {
return "関数です";
}
def static getStaticMessage() {
return "静的関数です";
}
}

次に、このクラスを利用するPHPスクリプトを書きます。ここでは、public/index.phpとします。
<?php
groovy_import("import.groovy");
//Staticな関数や値を操作する
echo Import::getStaticMessage()."\n";
echo Import::$VALUE."\n";
Import::$VALUE = "代入された値です";
echo Import::$VALUE."\n";
//クラスのインスタンスを生成して操作する
$foo = new Import();
echo $foo->getMessage()."\n";
echo $foo->FIELD."\n";
$foo->FIELD = "代入された値です";
echo $foo->FIELD."\n";
?>

作成できたら、アプリケーションを起動して、index.phpにアクセスしてみて下さい。次のように表示されていれば成功です。

静的関数です
Staticな値です
代入された値です
関数です
こんにちは！
代入された値です

このように、GroovyクラスをPHPから利用することができました。Groovy Bridgeの発表資料はslideshare.netで公開されていますので、ご覧下さい。

fixpack1で修正されたBugのリストは、こちらにあります。

Bug8008やBug8149など日本語関連のBugもいくつか修正されていますので、v1.1をご利用になっていて、phpBBやSugarCRMの日本語版をテストしてみる際は、こちらのfixpackを適用してください。

plug-inのアップデートを行うには、eclipseのメニューから以下の手順を行います。

Help > Software Updates > Available Software タブ > zero.eclipse.phpを展開 > WebSphere sMash for PDT 2.0.x にチェックを入れる > 右上のInstallボタンをクリック

後は画面の指示に従って、Install作業を行います。インストールするフィーチャーを選択する際に、PDT 1.0.xを選択しないように注意して下さい（for PDT 1.0.xと2.0.xを両方インストールしてしまうと、プロジェクト作成時に”sMash PHP application”が2つ表示されてしまいます）。インストールしてしまった場合は、Installed SoftwareからWebSphere sMash PDT Featureを選択し、Uninstallボタンをクリックしてください。

ちなみに、eclipseでの開発環境を0から整える方法は、こちらで紹介しています。PDT all-in-one package自体は、こちらからダウンロードしてください（DebuggerはsMash plug-inに含まれているため、必要ありません）。

この設定を変えるためには、JVMのオプション値 -Duser.language=(ロケール名) を与えて、明示的にロケールを設定する必要があります。例えば、英語でログ・メッセージを表示させたい場合は、-Duser.language=enを与える必要があります。

CLIのロケール設定を変えるには、zero.bat (zero.sh)をエディターで開き、set ZERO_OPTS=-Duser.language=enという行を追加します。eclipseの場合は、起動オプションに上記のオプションを追加します（Run as > Run configurations > (アプリケーション名) > Argumentsタブ > VM arguments > -Duser.language=enを追記）。

●利用するための準備

Apache POIは、zero.office.integrationという名前で提供されています。このモジュールへの依存性を、ivy.xmlに追加します。これで準備は完了です。

●Excelファイルを作ってみる

まず最初に、Excelファイルを生成してみましょう。せっかくですので、ここではPHPでやってみましょう。generate.phpとして、次のファイルをpublicフォルダに作成してください（コピー&ペーストするとダブルクォーテーションが全角になるので注意して下さい）。

<?php
 java_import(”java.io.FileOutputStream”);
 java_import(”org.apache.poi.hssf.usermodel.HSSFWorkbook”);
 java_import(”org.apache.poi.poifs.filesystem.POIFSFileSystem”);
 $filedir = zget(”/config/root”).”\\public\\sMash.xls”;
 try{
  //新規ワークブックを作成する
  $wb = new HSSFWorkbook();
  $fileOut = new FileOutputStream($filedir);

   //新規ワークシートを作成する
  $sheet = $wb->createSheet();
  $wb->setSheetName(0, “シート01″, $wb->ENCODING_UTF_16);

  //A1に日本語を書き込む
  $row = $sheet->createRow(0);
  $cell = $row->createCell(0);
  $cell->setEncoding($wb->ENCODING_UTF_16);
  $cell->setCellValue(”sMashでExcelファイルを作りました！”);

//終了処理
  $wb->write($fileOut);
  $fileOut->close();
  echo(”Excelファイルの作成が完了しました！”);
} catch (Exception $e)　{
echo $e;
echo(”処理が失敗しました”);
}
?>

作成したら、sMashアプリケーションを起動し、http://localhost:8080/generate.phpにアクセスしてみてください。publicフォルダ内にsMash.xlsファイルが生成されているはずです。

●Excelファイルを読み込んでみる

では、そのExcelファイルを読み込んで、PHPで文字列として表示してみましょう。read.phpとして、次のファイルをpublicフォルダに作成してください（コピー&ペーストするとダブルクォーテーションが全角になるので注意して下さい）。

<?php
 java_import(”java.io.FileInputStream”);
 java_import(”org.apache.poi.hssf.usermodel.HSSFWorkbook”);
 java_import(”org.apache.poi.poifs.filesystem.POIFSFileSystem”);
 $filedir = zget(”/config/root”).”\\public\\sMash.xls”;
 try{
//ファイル読み込み
  $filein = new POIFSFileSystem(new FileInputStream($filedir));

//1つ目のシートの、A1を示すセルのオブジェクトを取得する
$wb = new HSSFWorkbook($filein);
$sheet = $wb->getSheet($wb->getSheetName(0));
  $row = $sheet->getRow(0);
  $cell = $row->getCell(0);

//文字列を取得し、出力
  echo $cell->getStringCellValue();
 }  catch (Exception $e)　{
  echo $e;
  echo(”処理が失敗しました”);
 }
?>

作成したら、sMashアプリケーションを起動し、http://localhost:8080/read.phpにアクセスしてみてください。”sMashでExcelファイルを作りました！”と表示されていれば成功です。

●参考情報

他にもApache POIでは、計算式を読み込んだり、セルにコメントを追加したり、そのコメントを読み込んだり、様々なAPIが提供されています。詳細については、Apache POIのWebサイトをご参照下さい。http://poi.apache.org/

Forumを検索すると、以下のスレッドがヒットします。
https://www.projectzero.org/forum/viewtopic.php?f=4&t=984&p=4125
どうやら、普通にmultipart/form-dataでPOSTすれば、勝手にmultipartがdecodeされ、ファイル実体への参照はグローバルコンテキスト(/request/files)に格納されるようです。

HTMLの方はこんな感じ。

[public/testUpload.gt]

<html>
<head>
<style type=”text/css”>
@import “<%= getRelativeUri(”/dijit/themes/tundra/tundra.css”) %>”;
</style>
<script type=”text/javascript”
src=”<%= getRelativeUri(”/dojo/dojo.js”) %>”
djConfig=”parseOnLoad: true”></script>
<script type=”text/javascript”>
dojo.require(”dijit.form.Form”);
dojo.require(”dijit.form.TextBox”);
dojo.require(”dijit.form.Button”);
</script>
</head>
<body class=”tundra”>
<form dojoType=”dijit.form.Form” id=”myForm” name=”myform1″
encType=”multipart/form-data” action=”testUpload.groovy” method=”POST” onSubmit=”">
<input dojoType=”dijit.form.TextBox” name=”file1″ type=”file”><br/>
<input dojoType=”dijit.form.TextBox” name=”file1″ type=”file”><br/>
<input dojoType=”dijit.form.TextBox” name=”file1″ type=”file”><br/>
<button dojoType=”dijit.form.Button” type=”submit”>送信</button>
</form>
</body>
</html>

サーバー側のコードはこんな感じです。

[public/testUpload.groovy]

def onPOST() {
def files = request.files
def filelist = files['file1']

logger.INFO{ “Uploaded Files: ” + filelist.size().toString() }
logger.INFO{ “Information: ${filelist.toString()}” }

filelist.each{ file ->
def src = new File(file['path'])
new File(”${config.root[]}/tmp/${file['filename']}”).withOutputStream{ out ->
src.eachByte{ out.write(it) }
}
}

println “<h2>File Received</h2>”
}

グローバルコンテキスト /request/files には、「ファイル情報のMapの配列のMap」が格納されています。ちょっとわかりづらいですが、上の例で言うと

def filelist = files['file1']

のところで、Formで定義されているfile要素のうち、nameが’file1′のものを取り出しています。同じnameを持つfile要素が複数ある可能性があるので、Mapの配列になっているわけです。

あとは、それぞれのMapに格納されているファイル名やファイルパスを参照すればOKです。簡単でしょう？