tinystruct-patterns

Topics in the source

• tinystruct 開発パターン
• コア原則
• 主要な開発ツール：bin/dispatcher
• bin/dispatcher と bin/dispatcher.cmd の生成
• 使用するタイミング
• 使用する場面
• 動作の仕組み
• 例

tinystruct Java フレームワークを使用してモジュールをビルドするためのアーキテクチャと実装パターン。CLI と HTTP を等しく扱う軽量・高性能なフレームワークで、main() メソッドを必要とせず、最小限の設定で動作します。 CLI と HTTP は等しい市民（equal citizens）です。 トランスポート中立な @Action は Mode.DEFAULT を使用するか mode を省略し、HTTP専用の依存関係を持たないものです。このようなアクションはターミナルとWebブラウザの両方から実行できます。Mode.DEFAULT はトランスポートの制限をなくすだけで、HTTPに依存するメソッドをCLI対応にするものではありません。Request と Response の引数はHTTPコンテキスト属性から供給されるため、通常のCLI呼び出しのようにその属性がなければ null のままです。共有ロジックはHTTPオブジェクト、セッション、アップロードに依存させず、必要に応じてトランスポート固有のエントリポイントから呼び出してください。この「デュアルモード」対応能力が tinystruct のコア設計思想です。トランスポート固有のモード（Mode.CLI、Mode.HTTPGET、Mode.HTTPPOST など）を持つアクションは意図的にそのトランスポートに限定されており、もう一方から呼び出すとフレームワークは "The action is not allowed to be executed." で拒否します。 bin/dispatcher は tinystruct アプリケーションを開発・実行・テスト・デバッグするためのデフォルトかつ最優先のツールです — IDE の実行構成、手書きの main()、curl、ブラウザよりも先にこれを使ってください。 トランスポート中立な @Action メソッドは設計上デュアルモードであるため、bin/dispatcher を使うことでサーバーやブラウザを必要とせず、ターミナルから直接ルーティング・引数バインディング・ビジネスロジックを、最速のフィードバックループで検証できます。HTTPメソッドに限定されたアクション（Mode.HTTPPOST、Mode.HTTPGET など）は bin/dispatcher からは呼び出せないため、起動中のサーバーに対してHTTPクライアントでテストしてください。 このワークフローをデフォルトにしてください：トランスポート中立な @Action を実装したら、bin/dispatcher ですぐに実行して CLI モードで正しく動作することを確認し、Web向けのパス（例：mode = Mode.HTTPPOST、セッション、ファイルアップロードなど）を検証する必要

This is an excerpt. Refer to the complete source and its current requirements.