APIを持っていることがどのプロジェクトにも適していることは周知の事実です。 しかし、多くの場合、システムアーキテクチャにエラーがあるか、完成したプロジェクトに追加すると、サポートとテストのオーバーヘッドに多くの時間がかかります。
コードを複製せず、既存のビジネスロジックへの最小限の変更で、RESTfulアーキテクチャの実装をコミュニティに紹介したいと思います。 または、5分でAPIをプロジェクトに追加する方法は？
このアプローチを実装する
ために、Yii Frameworkの拡張機能を作成しましたが、アプローチ自体はどのMVCアーキテクチャでも使用できます。
メソッドを持つ
RestUserControllerコントローラーがあると想像してみましょう：
actionIndexユーザーリストactionViewユーザーを表示actionCreateユーザーを作成するactionUpdateユーザー更新actionDeleteユーザーを削除する
また、
ActvieRecord rest_usersテーブルである
RestUserモデルもあります。
新しい
RestUserユーザーを作成することをタスクとする
actionCreateメソッドを検討します。
class RestUserController extends Controller { ... public function actionCreate() { $model = new RestUser(); if (isset($_POST) && ($data = $_POST)) {
ここではすべてが明確です-
/restUser/createリクエストするだけで、新しいユーザーを追加するためのhtmlフォームが表示されます。このアドレスに
POSTリクエストを送信すると、ロジックを検証して追加し、ユーザーを表示するか、htmlフォームを表示しますc間違い。
ここで、インターフェイスから新しいユーザーを作成できるモバイルアプリケーションを作成するとします。 正しい方法は、サーバーAPIを作成することです。
なぜなら RESTfulスタイルについて説明しているため、
curlを介したサンプルリクエストを使用したサーバーとモバイルアプリケーションの相互作用は次のようになります。
リクエスト
curl http://test.local/api/users \ -u demo:demo \ -d email="user@test.local" \ -d password="passwd"
答え
< HTTP/1.1 201 Created < Content-Type: application/json < WWW-Authenticate: Basic realm="App" < Location: http://test.local/api/users/TEST_ID { "object":"rest_user", "id":"TEST_ID", "email":"user@test.local", "name":"Test REST User" }
ここでは、デモパスワードを使用し
たデモログインの
HTTP基本認証によって承認が行われ、必要なパラメーターの電子メールとパスワードが送信され、それに応じて、すべてが正しい場合、新しいユーザーのJSONオブジェクトを取得します。
私たちのアプローチの全体的なアイデアは、
redirectおよび
renderメソッドを変更し、モデルレンダリングルールを追加
renderことによってのみ、APIリクエストに正しく応答
する機能に
アクションを追加
することです。
もちろん、APIクライアントへの正しい応答のために、モデル自体の作成時のエラーだけでなく、アプリケーションのエラーとアクションのインターセプトも実装する必要がありますが、コントローラーのアクションのビジネスロジックを変更する必要はありません。
拡張機能では、
onException onErrorと
onErrorインターセプトすることで、提案されたアプローチを実装しました。また、
CControllerを使用してベース
CActiveRecordモデルと
CController追加機能を追加しました。
その結果、APIを介して要求するときに目的の応答を返すコード、および通常の要求を含むhtmlフォームは次のようになります。
class RestUserController extends Controller { ... public function actionCreate() { $model = new RestUser(); if ($this->isPost() && ($data = $_POST)) {
新しいコードと以前のコードの重要な違いは、
$model->idではなく、
$modelオブジェクトの
idパラメーターとして
redirectメソッドに転送されることです。これにより、作成されたオブジェクトがクライアントに返されます。 また、3番目のパラメーターに応答コード201が追加されました。これは、標準に準拠するために必要です。 応答とともに、作成されたオブジェクトのアドレスを含む
Locationヘッダーが送信されます。 3xx HTTPコードは応答で許可されていません。
もう1つの違いは、
renderメソッドに追加された4番目のパラメーターです。これには、クライアントへの応答で送信される
$data配列のフィールドの列挙が含まれます。 パラメータが
null場合、
$data配列全体が返されます。
現在、リクエストが正しくない場合、通常htmlフォームに表示されるデータは次の形式で返されます。
リクエスト
curl http://test.local/api/users \ -u demo:demo \ -d email="user@test.local"
答え
< HTTP/1.1 400 Bad Request < Content-Type: application/json < WWW-Authenticate: Basic realm="App" { "error":{ "params":[ { "code":"required", "message":"Password cannot be blank.", "name":"password" } ], "type":"invalid_param_error", "message":"Invalid data parameters" } }
さて、今度は何らかの方法で機密モデルデータを保護する必要があります
RestUserこの
passwordフィールドがあります。 これを行うには、ルールで返されるフィールドのリストを定義します。
モデルの表示ルールは
rulesメソッドになり
rules class RestUser extends CModel { public function rules() { return array( ... array('id, email, name', 'safe', 'on' => 'render'), ); } }
このルールは、モデルに追加される
getRenderAttributesメソッドで考慮されます。このメソッドは、表示に使用できるすべての属性の配列を返し、ルールで指定されている場合、オブジェクトの関係を再帰的に通過します。
結論として、認証と表示機能について少しお話ししたいと思います。
拡張コアは、コンポーネント（サービス）
\rest\Service中心に構築され、イベントのメイン処理とデータの正しい表示に関与します。 このサービスには、
authと
renderer 2つのアダプターグループがあり
renderer 。
authは認証アダプターがあります-デフォルトの
HTTP基本認証アダプターが使用可能です。
rendererは、データを表示するアダプターが含まれています-デフォルトでは、2つの
JSONおよび
XMLアダプターが使用可能です。
延長
簡単な設定
main.php構成ファイルの例
YiiBase::setPathOfAlias('rest', realpath(__DIR__ . '/../extensions/yii-rest-api/library/rest')); return array( 'basePath' => dirname(__FILE__) . DIRECTORY_SEPARATOR . '..', 'name' => 'My Web Application', 'preload' => array('restService'), 'import' => array( 'application.models.*', 'application.components.*', ), 'components' => array( 'restService' => array( 'class' => '\rest\Service', 'enable' =>strpos($_SERVER['REQUEST_URI'], '/api/') !== false,
コントローラーに動作を追加し、メソッドを再定義する
class RestUserController extends Controller { public function behaviors() { return array( 'restAPI' => array('class' => '\rest\controller\Behavior') ); }
これらのメソッドはすべて、各コントローラーに個別に実装されないように、親コントローラーに追加できます。
モデルに動作を追加して、レンダリングルールが機能するようにします
class RestUser extends CActiveRecord { public function behaviors() { return array( 'renderModel' => array('class' => '\rest\model\Behavior') ); } }
参照資料
GitHubリポジトリ
-github.com/paysio/yii-rest-apiインストールとセットアップの説明
-github.com/paysio/yii-rest-api#installation上記のコードはすべて
github.com/paysio/yii-rest-api/tree/master/demoです