tinystruct 開発パターン
tinystruct Java フレームワークを使用してモジュールをビルドするためのアーキテクチャと実装パターン。CLIとHTTPが等しく扱われる軽量なシステムです。
使用するタイミング
AbstractApplicationを拡張して新しいApplicationモジュールを作成するとき。@Actionを使用してルートとコマンドラインアクションを定義するとき。Contextを通じてリクエストごとの状態を処理するとき。- ネイティブの
Builderコンポーネントを使用してJSONシリアライゼーションを行うとき。 application.propertiesでデータベース接続またはシステム設定を構成するとき。ApplicationManager.init()を通じて標準的なbin/dispatcherエントリポイントを生成または再生成するとき。- ルーティング競合(Action)またはCLI引数解析のデバッグを行うとき。
動作の仕組み
tinystruct フレームワークは、@Action でアノテーションされたメソッドをターミナルとWeb環境の両方でルーティング可能なエンドポイントとして扱います。アプリケーションは AbstractApplication を拡張することで作成され、init() などのコアライフサイクルフックとリクエスト Context へのアクセスが提供されます。
ルーティングは ActionRegistry によって処理され、パスセグメントをメソッド引数に自動的にマッピングして依存関係を注入します。データのみのサービスでは、ゼロ依存のフットプリントを維持するために、JSONシリアライゼーションにネイティブの Builder コンポーネントを使用すべきです。フレームワークには ApplicationManager のユーティリティも含まれており、bin/dispatcher スクリプトを生成することでプロジェクトの実行環境をブートストラップします。
例
基本アプリケーション(MyService)
public class MyService extends AbstractApplication {
@Override
public void init() {
this.setTemplateRequired(false); // データ/APIアプリの .view 参照を無効化
}
@Override public String version() { return "1.…