annotation.wiki

1. summary アノテーション

Table of Contents 導入 詳細 @aspect アスペクトアノテーション @required 必須項目アノテーション @optional オプションアノテーション

導入

phpdoc形式のコメントで、リソースメソッドのメタ情報を記述することができます。現在サポートしているのはAOPプログラミングの@aspect、必須項目を記述する@requiredの2つです。

詳細

@aspect アスペクトアノテーション

@aspectで指定します。詳しくは[aop]をご覧ください。 リソースクラスのonCreate, onRead, onUpdate, onDeleteメソッドでのみ指定できます。

@required 必須項目アノテーション

連想配列で引数を1つだけ受け取る場合、必須なキーを指定します。 例）

この例ではcreate操作のためには$values['name']と$values['email']が必要です。この条件を満たさないとBEAR::CODE_BAD_REQUEST(400)コードのリソースオブジェクト(Ro)が返されます。

@optional オプションアノテーション

現在未実装ですが、将来の互換性のためにつける事を勧めます。オプションで指定できる引数のキーを指定します。@requiredと違い必須項目ではなくオプションで指定できるキーです。