2016-11-02 2 views
0

アジャイルな人々はこの種のスタイルをAPIの開発に使用しますか?Given..When..REST APIのユーザーストーリーの例

いい例はありますか?

これまでインターネットで見つかった例は最小限です(「キュウリの本」の第12章にも同じです)。 githubで "Given"という単語を含む.featureファイルをチェックしたが、その結果は多すぎて、私のユースケースとは無関係のものだった。より洗練された方法で検索して目標を達成することはできますか?

+0

RESTful APIの前条件と後条件を定義すると便利であるかどうかはわかりません。 RESTは、基礎となるプロトコルを通じて可能な操作を定義します。ほとんどの場合、これはいくつかの譲渡可能な表現形式(プレーンテキスト、テキスト/ HTML、アプリケーション/ json、アプリケーション/ xmlなど)のHTTP(POST、GET、PUT、DELETE、PATCH、...)です。また、十分に開発されたコンテンツタイプは、さらなるアクション(すなわち、HAL、ATOM、...)を実行してRESTfulクライアントをサポートし、その時のドキュメントを冗長化することができる。 –

+0

@Roman Vottner私はあなたが作る点を理解していない、小人はBDDの方法でAPIを開発するために使用されます。受け入れテストは、「与えられた条件、顧客がこれをしたときに応答がそれである」という意味で書かれます。これは友好的な方法ではありませんか? 編集:「APIを開発する」の代わりに「記述するAPI」を書いたからですか?もしそうなら、私は開発を意味しました。 – Crone

+0

実際の質問は、生産的なコードではなくテストに関連していますか?もしそうなら、あなたの実際の質問を誤解しました。私はあなたがWADL、Swagger、...代替案(基本的なRESTの考え方と矛盾しているので大したファンではない)を求めて、REST APIを自動的に計測すると思っていました。 –

答えて

0

私はあなたの質問を、これを行う方法であると主張できる複雑な例を探しているかのように解釈します。

私の見解から、キュウリの本の12章の例は些細なように思えるかもしれません。しかし、彼らはあまりにも技術的かもしれないと思う。私は、製品の所有者または同様の非技術者が、それらを検証することができるとは確信していません。

私のここでのポイントは、シナリオはできるだけ技術的でなく、したがって、もしあれば、最低限の技術的な詳細が含まれることです。これは、技術者以外が確認できるものになります。技術的な詳細ではなく、ビジネス問題の解決策について話し合うことができます。ビジネスにとって重要であるかもしれないし、重要でないかもしれない細部。 BDDがRESTを使用して実装されているかどうか、または何か他のものが使用されているかどうかを知るために、BDDが頻繁に動作するレベルでは面白くないかもしれません。

あなたが探しているテストであれば、BDDツールよりも他のツールを適用しやすく、使いやすくすることができます。しかし、これらのツールは、最終的に解決するビジネス上の問題を理解しようとするときに、ディスカッションベースを使用するのは簡単ではありません。

+0

私はそれがどのように完了したかを見るために徹底的な例を探しています。それがすべてで終わったならば。 私はユーザーのストーリーが技術的であってはならないことに同意します。私の目標はテストではありません。 TDDとBDDでさえ、テストに基づいていますが、方法を開発しています。しかし、必ずしも厳密なBDDをやりたいとは限りません。これは、APIを構築する新しい方法に似ています。 – Crone