scenic3は t2 frameworkのようなPageクラスをslim3で実現するslim3の拡張ライブラリです。

scenic3

ページ作るの便利なんで。

そのPageクラスを作るときにアノテーションとか忘れそうになるんでメモしておきます。

@Page リクエストパスの1個目？を指定する
@ActionPath = リクエストパスの2個目以降を指定する

手が覚えるまで迷うのがこれら。

@Var = リクエストパスの中に引数を指定した場合に書く

私にとってコレが簡単に出来る事がscenic3を使う理由のひとつ。

@RequestParam = リクエストパラメータ（GET引数）を引数にする場合に書く

勿論メソッド内で request.getParameter(“xxx”) とも書けるけど、明示的にメソッドの引数にも出来るってこと。

自然語でメモするとなんかややこしい・・・。

簡単なPageクラスはこんな感じになる。

@Page("/path")
public class PathPage extends ScenicPage
{

	@ActionPath("to/{id}")
	public Navigation list_json(
			@Var("id") String id
			, @RequestParam("limit") Integer limit
			, @RequestParam("offset") Integer offset
	)
	{
		// POSTの場合はコッチ
		String hoge = (String) request.getAttribute("hoge");

		....
		return forward("/path/to/page.vm");
	}

}

AppUrl.java への追加も忘れずに。

public AppUrls()
{
	excludes("/_ah/*");
	excludes("/remote_api");
	add(PathPageMatcher.get());
}

バッチとかならcron で何とかなるもんだからいままで曖昧にしてきた訳ですが、そろそろ TaskQueue を弄っていこうと思います。

知らんかった事その1

タスクとははURLを持ったただのサーブレット

使い方というか、Queueの登録の仕方はコチラは大いに参考にさせて頂いています。これ以上説明することがありません。
Task Queueの最新情報！【設定ファイル例付き】

知らんかった事その2

TaskQueue用のサーブレットってSlim3のControllerでもいけるし、素のServletでもいけるけど、戻り値はnullじゃないと延々とリトライされる。
（Exceptionをthrowしてもリトライされる。逆に言うとExceptionをcatchしてしまうとリトライされない）

それもあるから、Datastoreに書いたりするならべき等に実装しなきゃいかん。

知らんかった事その3

リトライに関してはqueue.xml でかなり細かく設定できる。

今は昔のkonjak翻訳 φ(・ω・? )…: Java Task Queue Configuration

色々出来そうですね。
がんばってみます。

個人的には .countDownMills(long) が便利だと思う。

5秒後に実行ならcountDownMills(5000L)。

Taskは（ある程度）細かいほどパフォーマンスいいみたい。
例えばどうしてもループの中にDatastore操作が入っちゃうみたいな場合は、TaskQueueの出番かな。

私が知らないだけかもしれませんがちょっと残念なのは、TaskのChainが作れない事です。
Aタスクを実行後Bタスクとかする場合は、Aタスクの中でBタスクを呼び出す様にネストせな仕方ないか。

Twitterボットでも作ってみようかな。

slim3.GlobalTransaction
と
slim3.Lock

というEntityが出来ていました。とくにslim3.Lockがいっぱい。

Slim3のGlobalTransactionが失敗した形跡があるんで、その残骸なんでしょうか。
暫くしたら消そう。

slim3 の Datastore.beginGlobalTransaction() とか deprecated になってます。
やはりフツーのDatastore.beginTransaction() を使えと言う事ですね。

で、Cross-Group Transactions なんですけど、やはり今のところ 5 entity groups までしか対応していないようです。

確かに複数Entityでも、今までの様に「can’t operate on multiple entity groups in a single transaction.」とか怒られる事が無くなったんですが、いっぱいEntityをぶっこむ（Entity Group が5つ以上）と、「java.lang.IllegalArgumentException: operating on too many entity groups in a single transaction.」とか怒られてしまいます。

沢山のEntity Group を含むトランザクションを扱うシチュエーションでは引き続き slim3 の GlobalTransaction を使う事になりますね。

Slim3 Eclipse Pluginで横着してたんで、気がつきませんでした。

ソフトウェアの更新で出現しないんですけど、勝手にjarを入替えちゃってもいいんですかね。

というかPluginで入れても、更新は手作業なのかな。 （後日ちゃんとslim3pluginのアップデートが配信されました (2011/11/09 追記)）

やってみた。いけた。

Slim3 1.0.14から、appengine SDK 1.5.5のリリースを受けて、グローバルトランザクション周りが変わっているようです。

Datastore.beginGlobalTransaction() じゃなく、フツーのDatastore.beginTransaction() で、Cross-Group Transactionsに対応しているとか。

5 entity groupsまでなら、複数Entity Groupをぶっこんでも、問題なく更新とかできる様になっている筈。

今までは複数のEntity Groupをトランザクションに含めると「IllegalArgumentException：can’t operate on multiple entity groups in a single transaction.」とか怒られたんですが、今回からは 5 Entity Group 以上を含んだ場合出るのかな。

また今度ちゃんと試します。

試しました (2011/11/09 追記)

・・・おそらく GTXの実装には苦労された事と思うんですが、ひがさんの心中や如何に。

とある事情で、

appengine (for java)パスが/hogehoge/ではじまる場合だけ、拡張子が.htmlなURLをstatic fileでなくresourceとして扱いたい、という事がありました。

appengine-web.xmlを

<static-files>
    <include path="**.html" />
    <exclude path="/hogehoge/**.html" />
</static-files>

 

こんな風に書いてみましたがうまくいきません。

slim3 を使っている場合、これではダメの様です。

Slim3では拡張子付きのURLは動的リクエストとして扱いません。
したがって、AppRouterでisStaticをオーバーライドする必要があります。

public class AppRouter extends RouterImpl {
    @Override
    public boolean isStatic(String path) throws NullPointerException {
        return false;
    }
}

ここでは全てのリクエストをstaticとして扱っています。
Scenic3の設定でまとめて静的ファイルのパスを設定する、もしくはAppRouterで適切に静的ファイルを判定してください。
順序としては、先にAppRouterのisStaticで判定され、その後にScenic3のAppUrlsで判定されます。

Slim3 に Scenic3 と PirkaEngineを使う方法 - やさしいデスマーチ

参考サイトの例では全てのリクエストをstaticとして扱っています。

/hogehoge/はリソース固定、それ以外はよきに計らうと言う意味で、こんな感じですかね。

public class AppRouter extends RouterImpl {
    @Override
    public boolean isStatic(String path) throws NullPointerException {
        if (path == null) {
            throw new NullPointerException("The path parameter is null.");
        }
        if (path.startsWith("/hogehoge/")) {
            return false;
        } else {
            return super.isStatic(path);
        }
    }
}

 

これで想定どおりになりました。

私は手で作っちゃう事も結構ありますけど、大量に書くときはやはりeclipseです。

で、久しぶりにやろうと思ったら、なんかOutlineが真っ白です。
eclipse(Gallileo)の調子が悪いのかな。そういえばAndroidのプラグインとか入れてエミュレータを動かしたとき、エミュレータを終了できなくなっちゃったり、最近怪しいです。
日本語化とかするんじゃなかった。
とか思いながら、この際だからとHeliosに入れなおしました。
今回は日本語化もせず、プラグインとかも最低限にしました。

で、slim3のブランクプロジェクトを作って、build.xmlを開いたんですが、やっぱりアウトラインは真っ白です。

原因は全然別にあって、[Preferences] – [General] – [Editors] – [File Associations]で、*.xmlがJavaエディタとかに関連づけられてたからでした。
Ant Editorをデフォルトにすると治りました。

冷静に考えれば判ったはずですが、最初はググっても情報なくて焦りました。

1. eclipseを起動
2. プロジェクトを右クリック
3. [実行(R)] – [実行の構成(N)] をクリック
4. 実行構成の左ペインより[Web アプリケーション] – [プロジェクト名]をクリック
5. [(x)=引数]タブをクリック
6. - [プログラムの引数]に[--address=0.0.0.0 ]を追記する
• BEFORE
  –port=8888 C:\path\to\workspace\yourproject\war
• AFTER
  –port=8888 –address=0.0.0.0 C:\path\to\\workspace\yourproject\war

実際の手順は、Slim3 日本語サイト(非公式)などを良く確認して行ってください。

ダウンロード

slim3プロジェクト から、slim3の最新版( 2011年3月2日現在 slim3-blank-1.0.8.zip ) をダウンロードして解凍する。

jarファイルを置換

slim3を置換
下記のファイルをを削除し

	yourproject/war/WEB-INF/lib/slim3-1.0.7.jar

解凍したslim3のものをプロジェクト内のディレクトリにペーストする

	yourproject/war/WEB-INF/lib/slim3-1.0.8.jar

slim3-genを置換
下記のファイルをを削除し

	yourproject/lib/slim3-gen-1.0.7.jar

解凍したslim3のものをプロジェクト内のディレクトリにペーストする

	yourproject/lib/slim3-gen-1.0.8.jar

slim3-*-sourceを置換
下記のファイルをを削除し

	yourproject/libsrc/slim3-1.0.7-sources.jar
	yourproject/libsrc/slim3-gen-1.0.7-sources.jar

解凍したslim3のものをプロジェクト内のディレクトリにペーストする

	yourproject/libsrc/slim3-1.0.8-sources.jar
	yourproject/libsrc/slim3-gen-1.0.8-sources.jar

ビルドパスの変更

eclipseを起動し、yourprojectプロジェクトを右クリック – [ビルド・パス(B)] – [ビルド・パスの構成(C)]をクリック

プロジェクトのプロパティー [Java のビルド・パス]が開くので、[ライブラリー(L)]タブを選択

下記を選択し[除去(R)]をクリック

	war/WEB-INF/lib/slim3-1.0.7.jar

左ペインの yourprojectプロジェクト の下記を右クリック

	war/WEB-INF/lib/slim3-1.0.8.jar

[ビルド・パス(B)] – [ビルド・パスに追加(A)]をクリック

アノテーション処理のファクトリパスを変更

パッケージ・エクスプローラにてyourprojectプロジェクトを選択する

[プロジェクト(P)] – [プロパティー(P)]をクリックする

[Javaコンパイラー] – [注釈処理] – [ファクトリーパス]をクリックする

[JAR の追加(J)]をクリックする

[JARの選択]ダイアログにて、[yourproject] – [lib] – [slim3-gen-1.0.8.jar]を選択し、[適用(A)]をクリックする

[OK]をクリックする

EtupirkaCMS 0.1.0 リリース – やさしいデスマーチ

EtupirkaCMS(日本語)

何が凄いって、eclipse も appengine SDKも使わずに、ローカルでテストしてデプロイ出来るんです。感動しました。
コレならフリーランスなWEBデザイナ・コーダにも勧められますし、一人教えておきました。

WYSIWYGエディタも使える。本気で使える。素晴らしい。

とりあえずテストで投稿してみました

Google Webマスターツール と Google Analytics はIDとかを入れるだけ。
必ず使うんで、最初から機能として入っているのはイイですね。
欲を言えばTrackbackが送れるといいナァ。

ちょっと前、Google App Engine/Java で動くCMSを探したけど、満足いくものが無かったんで仕方なく ホスティングサーバ + wordpress で当ブログ初めたんですけど、最初からコレが有れば使ってたかも。