![ミドルウェア適用
afterミドルウェアなので定義は逆順。
namespace AppHttp;
use IlluminateFoundationHttpKernel as HttpKernel;
class Kernel extends HttpKernel {
protected $middlewareGroups = [
'web' => [
/**/
AppHttpMiddlewareApplyView::class, // ビュー適用が先
AppHttpMiddlewareValidation::class, // バリデーションが後
],
]
}](https://image.slidesharecdn.com/laravel-190508113613/85/-34-320.jpg)
![テスト駆動開発（TDD）
[DO03] 50 分でわかるテスト駆動開発
/decode2017/do03-50/9](https://image.slidesharecdn.com/laravel-190508113613/85/-36-320.jpg)
![目標「ガチャAPIが存在する」
// ApiTest.php
class ApiTest extends TestCase {
/** @test */
public function gatcha() {
$this->post('/api/gatcha', [])->assertStatus(200);
}
}](https://image.slidesharecdn.com/laravel-190508113613/85/-42-320.jpg)
![次の目標「返却はcardIdsというプロ
パティを持つ」
gatcha:
+ type: "object"
+ properties:
+ cardIds:
class ApiController {
public function gatcha() {
+ return [
+ 'cardIds' => null,
+ ];
}
}](https://image.slidesharecdn.com/laravel-190508113613/85/-44-320.jpg)
![次の目標「cardIdsは配列」
gatcha:
type: "object"
properties:
cardIds:
+ type: "array"
class ApiController {
public function gatcha() {
return [
- 'cardIds' => null,
+ 'cardIds' => [],
];
}
}](https://image.slidesharecdn.com/laravel-190508113613/85/-45-320.jpg)
![class ApiController {
public function gatcha() {
return [
- 'cardIds' => [],
+ 'cardIds' => [1000, 1001, 1002],
];
}
}](https://image.slidesharecdn.com/laravel-190508113613/85/-47-320.jpg)
![{
"title": "Example Schema",
"type": "object",
"properties": {
"firstName": {
"type": "string"
},
"lastName": {
"type": "string"
},
"age": {
"description": "Age in years",
"type": "integer",
"minimum": 0
},
"hairColor": {
"enum": ["black", "brown", "blue"],
"type": "string"
}
},
"additionalProperties": false,](https://image.slidesharecdn.com/laravel-190508113613/85/-54-320.jpg)
![namespace generated
{
using System;
using com.cvent.country.entities;
using generated;
using System.Collections.Generic;
using Cvent.SchemaToPoco.Core.ValidationAttributes;
using System.ComponentModel.DataAnnotations;
// A nation with its own government, occupying a particular
public class Country
{
// Used as the symbol or emblem of a country
public Flag Flag { get; set; }
// A large town
public HashSet<City> Cities { get; set; }
// The number of people inhabiting this country
[Required()]
[MinValue(1000)]](https://image.slidesharecdn.com/laravel-190508113613/85/-58-320.jpg)
バリデーション駆動開発（仮称）で プロジェクトメンバー全員を幸せにした話
- 3. 自己紹介 @KentarouTakeda サーバサイド php / node.js / TypeScript Laravel / express / AWS Lambda PostgreSQL / MySQL インフラ RHEL / CentOS / AmazonLinux / Chef / Ansible フロントエンド TypeScript Angular / jQuery / Hexo
- 4. 心がけていること 担当業務の範囲にとらわれず、 幅広い視野で全体の効率アップを図りたい。 API / ネットワーク/ インターフェース 人/ 部署/ 会社
- 12. 今回はどこに问题があったのか？
- 15. 可能性を溃す
- 18. 信頼できない値
- 20. JSON Schema https://json-schema.org/ JSONへの型定義 JSONが特定の型を満たしているか検証 JSON Schema is a vocabulary that allows you to annotate and validate JSON documents. “ “
- 21. ガチャAPI gatcha: # ガチャAPIは type: "object" # オブジェクトを返却する properties: cardIds: # cardIds プロパティは type: "array" # 配列型を取り items: type: "integer" # それぞれの値は整数 minimum: 1000 # 最小値は1000 maximum: 2999 # 最大値は2999 minItems: 1 # 配列の要素数は最小で1個 minItems: 3 # 最大で3個（1～3個のカードが出てくるガチャ） bonusId: # bonusId というプロパティは type: "integer" # 整数を取り minimum: 3000 # 3000以上 maximum: 4999 # 4999以下 required: # 必須プロパティは - "cardIds" # cardIds のみ（ボーナスは無い時もある） additionalProperties: false # 上記で定義された以外のプロパティは存在
- 22. PHP での実装 $ composer require justinrainbow/json-schema $validator = new Validator(); $validator->validate($response, $schema, $options); if(true !== $validator->isValid()) { throw new Exception("サーバ側のバグ！"); } echo json_encode($response); status=200 であれば必ず安全 安全でない場合必ず必ずstatus=500
- 23. 可能性を一つ溃した
- 25. バグ報告 プロフィールに「氏名」を登録した状態でマイページ にアクセスすると以下のエラーが表示されます。 ErrorException (E_ERROR) Undefined variable: firstName (View: /var/www/resources/views/mypage/index.blade.php)
- 26. 考えられる原因 テンプレート側のtypo 正しくは$ rst_name だった コントローラー側のバグ $ rstName の初期化漏れ
- 27. 今回はどこに问题があったのか？
- 30. ビューに渡す値を検証 class MypageController extends Controller { public function index(Request $request) { /* ビューに渡す値を準備する */ /* ここでバリデーション？ */ return view('mypage.index', $data); } } 何の保証にもならない。 （仕組み化して一括で防ぎたい）
- 31. コントローラーではオブジェクトを返 却するのみ class MypageController extends Controller { public function index(Request $request) { /* ビューに渡す値を準備する */ return $data; } }
- 32. ビュー適用 class ApplyViewMiddleware { public function handle($request, Closure $next) { $response = $next($request); /* 実際は abort() や RedirectResponse の際の処理が必要 */ $name = Route::currentRouteName(); // ビュー名 ＝ ルート名 $response = new Response(view($name, $content)); return $response; } }
- 33. バリデーション class ValidationMiddleware { public function handle($request, Closure $next) { $response = $next($request); $name = Route::currentRouteName(); // バリデーション名 ＝ ルート $isValid = $this->valication($response,$this->getSchema($nam if($isValid) { abort(500, "コントローラー側のバグ！") } else { return $response; } }
- 34. ミドルウェア適用 afterミドルウェアなので定義は逆順。 namespace AppHttp; use IlluminateFoundationHttpKernel as HttpKernel; class Kernel extends HttpKernel { protected $middlewareGroups = [ 'web' => [ /**/ AppHttpMiddlewareApplyView::class, // ビュー適用が先 AppHttpMiddlewareValidation::class, // バリデーションが後 ], ] }
- 35. バリデーションとテスト
- 37. TDDのサイクル 1. 次の目標を考える 2. その目標を示すテストを書く 3. そのテストを実行して失敗させる（Red） 4. 目的のコードを書く 5. 2.で書いたテストを成功させる（Green） 6. テストが通るままでリファクタリングを行う （Refactor） 7. 1～6を繰り返す
- 39. 出力の検証＝テスト
- 40. バリデーション駆動開発 1. 次の目標を考える 2. その目標を示すテストバリデーションを書く 3. そのテストバリデーションを実行して失敗させる 4. 目的のコードを書く 5. 2.で書いたテストバリデーションを成功させる 6. テストが通るままでリファクタリングを行う 7. 1～6を繰り返す
- 41. 「ガチャ础笔滨」
- 42. 目標「ガチャAPIが存在する」 // ApiTest.php class ApiTest extends TestCase { /** @test */ public function gatcha() { $this->post('/api/gatcha', [])->assertStatus(200); } }
- 43. テストをパスする最小限のコード # api.schema.yml gatcha: // ApiController.php class ApiController { public function gatcha() { } }
- 44. 次の目標「返却はcardIdsというプロ パティを持つ」 gatcha: + type: "object" + properties: + cardIds: class ApiController { public function gatcha() { + return [ + 'cardIds' => null, + ]; } }
- 45. 次の目標「cardIdsは配列」 gatcha: type: "object" properties: cardIds: + type: "array" class ApiController { public function gatcha() { return [ - 'cardIds' => null, + 'cardIds' => [], ]; } }
- 46. 次の目標「cardIdsの各要素（略）」 gatcha: type: "object" properties: cardIds: type: "array" + items: + type: "integer" + minimum: 1000 + maximum: 2999 + minItems: 1 + minItems: 3
- 47. class ApiController { public function gatcha() { return [ - 'cardIds' => [], + 'cardIds' => [1000, 1001, 1002], ]; } }
- 48. 開発体験 最小限のテストコード Red -> Green -> Refactor 仕様?実装?テストが同時に出来上がっていく 共有可能な成果物
- 49. 「ガチャ础笔滨」
- 50. 今回はどこに问题があったのか？
- 54. { "title": "Example Schema", "type": "object", "properties": { "firstName": { "type": "string" }, "lastName": { "type": "string" }, "age": { "description": "Age in years", "type": "integer", "minimum": 0 }, "hairColor": { "enum": ["black", "brown", "blue"], "type": "string" } }, "additionalProperties": false,
- 55. export interface ExampleSchema { firstName: string; lastName: string; /** * Age in years */ age?: number; hairColor?: "black" | "brown" | "blue"; }
- 57. { "$schema": "http://json-schema.org/draft-03/schema#", "title": "Country", "description": "A nation with its own government, occupying a "type": "object", "properties": { "flag": { "$ref": "flag.json" }, "cities": { "type": "array", "description": "A large town", "items": { "$ref": "city.json" }, "uniqueItems": true }, "population": { "type": "integer", "description": "The number of people inhabiting this count "minimum": 1000,
- 58. namespace generated { using System; using com.cvent.country.entities; using generated; using System.Collections.Generic; using Cvent.SchemaToPoco.Core.ValidationAttributes; using System.ComponentModel.DataAnnotations; // A nation with its own government, occupying a particular public class Country { // Used as the symbol or emblem of a country public Flag Flag { get; set; } // A large town public HashSet<City> Cities { get; set; } // The number of people inhabiting this country [Required()] [MinValue(1000)]
- 60. 心がけていること 担当業務の範囲にとらわれず、 幅広い視野で全体の効率アップを図りたい。 API / ネットワーク/ インターフェース 業務/ 人/ 部署/ 会社 仕組み化で解決。 サーバサイドは仕組み化に取り組みやすい立ち位置。