タグ

restに関するyukimori_726のブックマーク (25)

  • REST Assured を使ったREST API テスト - Qiita

    はじめに REST APIの自動テストを行うためのツールを探していたところ、クラスメソッドさんの記事を見つけたのですが、若干バージョンが古かったので 2017/01/23 時点での最新バージョンで改めて試してみました。 REST Assuredとは 今回使用するライブラリはREST Assuredというもので、JavaでDSL風にREST APIのテストを記述することができます。 ライブラリを追加することでJSON/XMLのテストを簡単に書くこともできます。 使い方 ここでは、単純なJSONを返すREST APIのテストを書くための使い方を説明していきます。 依存関係の追加 お約束の依存関係追加です。 pom.xmlに以下の依存関係を追加します。 <dependency> <groupId>io.rest-assured</groupId> <artifactId>rest-assured

    REST Assured を使ったREST API テスト - Qiita
  • Pythonで作ったデーモンにREST APIをつける話 - Qiita

    目的 Pythonで24時間走らせ続けるデーモンを書いています。稼働状況の確認や設定を動的に変更をするためにREST APIを追加することにしました。メインルーチンに大きな変更を加えることなく、最小の手間で実装する方法を模索しました。 FlaskとFlask-API REST APIを提供するにはなんらかのウェブサーバが必要です。外部に公開するものではないのでFlaskが同梱している開発用のウェブサーバを使います。開発用ですがスレッドで同時アクセスにも対応していますので、十分実用に耐えます。 REST APIは手軽に実装できてテスト用のUIまで用意されているFlask-APIを使うことにしました。 以下の実験ではFlask-APIのサンプルを使います。コピペしてexample.pyというファイルで保存します。 http://www.flaskapi.org/#example マルチスレッド

    Pythonで作ったデーモンにREST APIをつける話 - Qiita
  • REST APIの設計で消耗している感じたときのgRPC入門 - Qiita

    REST APIによる設計 最近のシステムは様々なデバイスやスケーラビリティを重視するため、各システムを分割し軽量なAPIで連携するマイクロサービス的なアーキテクチャスタイルが増えてきています。 そして、そのAPI連携で広く採用されているのが、REST APIです。 しかし、こうした設計を行っていくには、適切に考慮、選択しなければならないことも多くあります。 URL、パラメータ、エラーなどの設計 各言語ごとのライブラリや、サーバ、クライアントの選定、設計 認証、認可 ドキュメント管理 ユニットテスト、インテグレーションテスト、モック、Consumer-Driven Contracts 開発用ツール 絶対的スタンダードがない状況下で、こういった問題はシステムやメンバーが増えるにつれ複雑化していき、設計や管理、その仕組み作りに時間を取られ、来の目的となるべき機能開発の時間を失っていくことにな

    REST APIの設計で消耗している感じたときのgRPC入門 - Qiita
  • Casablancaのインストール - のんびりしているエンジニアの日記

    皆さんこんにちは お元気ですか。私は燃え尽きました。 今日はCasablancaのインストール記事を記載します。 Casablancaとは マイクロソフトのC++ REST SDKで、クラウドベースのクライアント・サーバーの APIデザインだそうな。 C++ REST SDK (codename "Casablanca") - Home 内容にはHTTP Client/Server, JSON, URL ,Asynchronus Stream,WebSockets,OAuthが搭載されているそうな。 因みにマイクロソフトだからといって、WindowsだけでなくLinuxMacでも使えます。 因みに僕はMacOSです。 Install 必要なもの brew install cmake git openssl boost 必要なものがインストールされているのを確認してから git clone

    Casablancaのインストール - のんびりしているエンジニアの日記
  • How to implement a REST API Server?

  • reSTおよびSphinxで文章を書く際のtips - そこはかとなく書くよ。

    Sphinxを使って論文っぽい文章を書くときのtipsをまとめておきます。 追記: この内容は Sphinx逆引き辞典により詳細にして載っています。 用語を書く際はreplaceを使う .. |hoge| replace:: ほげらこう定義しておくと次からは |hoge| とするだけで、ほげらと自動的に展開してくれます。つまり、あとからこの用語名を変えたいな、と思ったときにはこの定義のところだけを変えれば勝手に全部入れ替えてくれる、というわけです。 ただし、複数のrstファイルに分けている場合には使えないので、別のファイル(例えばdefinition.txt)に replace を書いておき、 .. include:: definition.txtと各rstファイルの先頭に書いておきます。この時、.rstではなく.txtなど他の拡張子のファイルに書いていることに注意してください。そうしない

    reSTおよびSphinxで文章を書く際のtips - そこはかとなく書くよ。
  • いまさら聞けないRESTの基礎知識、JAX-RSを使ったREST APIの作り方と使い方

    いまさら聞けないRESTの基礎知識、JAX-RSを使ったREST APIの作り方と使い方:3つのフレームワークで学ぶエンタープライズJava開発入門(3)(1/3 ページ) 新規のエンタープライズJava開発において現在有力視される3つのフレームの違いについて解説する連載。前回から複数回に分けて、MVCのViewとControllerにフォーカスして各要素を紹介しています。今回はJava EEのJAX-RSについて。JAX-RSの基的な設計方針であるRESTについて解説し、Struts 1、JSFとの違いやJAX-RSの使いどころを紹介します。 新規のエンタープライズJava開発において現在有力視される3つのフレームワーク、Java EE、Spring Framework、Play Framework。連載「3つのフレームワークで学ぶエンタープライズJava開発入門」では、3つの違いに

    いまさら聞けないRESTの基礎知識、JAX-RSを使ったREST APIの作り方と使い方
  • Swaggerを使ってインタラクティブなWeb APIドキュメントをつくる - Qiita

    この記事は、微妙に以下の記事の延長線上です。わかりにくければ、こちらから読んでいただいた方がいいかもしれません。 LittleBitsを使ったIoTをつくり、家の室温変化のグラフをインターネットから見る(前編) - Qiita 「インタラクティブなWeb APIドキュメント」とはどういうものか Swaggerというツールを使います。Web APIYAMLで書いておいて、Swaggerでサーバを立てると、読むだけのドキュメントではなくて、以下のようにパラメータを指定して実際にHTTPリクエストを送ることができるWebページが生成されます。 以下が返ってきたレスポンスです。 以下は実物です。ご自由に動かしてみて下さい。 インタラクティブなWeb APIドキュメント まだちょっと分かりにくいという方のために、アノテーションからドキュメントを作れるswaggerの使い方 - gong023の日記

    Swaggerを使ってインタラクティブなWeb APIドキュメントをつくる - Qiita
  • [Java]rest-assuredでREST APIのテストをする | DevelopersIO

    REST APIのテストをする 近頃はREST APIを作成することが多くなってきましたが、みなさんはどのようにテストをしているでしょうか。 昔はCactusとか使ってたけど、(とっくに開発終了してた・・・) なんか簡単にテストできるライブラリないかなあと思って探していたら、よさそうなものを見つけたので紹介します。 rest-assuredとは rest-assuredとは、RESTサービスを簡単にテストするためのJava DSLとのことです。 メソッドを組み合わせてREST APIへのリクエストとレスポンスの検証が可能で、シンプルな記述で使うことができます。 //rest-urlのレスポンスを検証 get("/rest-url") .then().body("something.json.param", equalTo("anyvalue")); rest-assuredを使ってみる セ

    [Java]rest-assuredでREST APIのテストをする | DevelopersIO
  • 【環境ごとまるっと提供】JavaによるRest入門(Jersey2編) - Qiita

    環境ごとまるっと提供とは webアプリ(特にJava)構築の勉強を始めようとした場合、書籍やサイトを参考にしながら実際にやってみるというのは、非常に有効な手段です。 一方で、参考にした情報だけではうまく動作させることができないケースが多い気がします(たとえば前提としてeclipseのtomcatプラグインが必要だとかで)。 そういった前提条件を調べているうちに、よくわからないエラーにハマり、結局挫折してしまうなんてことも多いのではないでしょうか??もちろんそういうエラーを解決するのは、トラブルシューティングなども見据えると非常に力になって良いことだと思うのですが、挫折してしまって何もしなくなるのは末転倒です。 各個人に芽生えた学習意欲が、「動かないから断念」という理由で消えてしまうのは非常にもったいないことだと思います。そういった意欲がなくなってしまうことを少しでも防げるように、稿では

    【環境ごとまるっと提供】JavaによるRest入門(Jersey2編) - Qiita
  • RESTFul(リソース指向アーキテクチャ)について - In urban breeze

    2014-05-06 RESTFul(リソース指向アーキテクチャ)について アーキテクチャ ROA(Resource Oriented Architecture)について。 次のを参考に勉強してみた。参考図書 RESTful Webサービス ROAの基 アプリケーションを動作と名詞(リソース)で考える。 リソースは特定のデータ、データの演算結果、状態、ユーザーアカウントなどである。 URIに動詞を含めてはならない。 リソースはHTTPメソッドを使用してのみ操作できる。 アドレス可能性 リソースはアドレス(URI)で一意に表現する。 1つのURIが複数のリソースを示してはいけない。 リソースを特定の言語や特定のフォーマットで取得したい場合は「Accept-Language」や「Accept」、または「Media-Type」を使用する。このようにリソースの表現方法が複数あ

  • REST clientのPostmanが便利だった - 偏った言語信者の垂れ流し

    PostmanChrome拡張のREST client。 Postman | Supercharge your API workflow ChromeWebStoreからインストールできる。 リクエストの履歴が保持されて再利用できるので、気軽に複数種類のリクエストを叩けるのが楽。 また、リクエスト内容をCollectionにまとめておけば、Import/Exportできるので、チームの他の人と共有するのが簡単なのも良い。 開発やら試験がはかどる。

    REST clientのPostmanが便利だった - 偏った言語信者の垂れ流し
  • 拡張可能なWeb APIの設計原則と、バージョン番号を使う理由について

    APIのバージョニングは限局分岐でやるのが良い - Hidden in Plain Sightにはブコメしたのですが、Rebuild: 35: You Don't Need API Version 2 (Kenn Ejima)でも件に言及があったようなので、少し一般論を書いておきたいと思います。 ■Web APIの設計原則について そもそも、良いAPIとはどのような特性をもつものでしょうか? 一般的に、以下の2点が挙げられると思います。 拡張が容易である 拡張時に後方互換性を破壊しない ウェブの場合は、これに加え、 スケーラブルである HTTPに起因する問題に上手に対処できる ことが求められます。 前2者はウェブに限らない要件です。これを満たす設計手法としては、 リクエストおよびレスポンスのパラメータを拡張可能に 互換性を壊す拡張が必要な場合は、関数名を変える 古い関数は従来と同じ機能を

  • JSON文字列を受信(サーブレット→javascript): 大学生の見習いプログラマBlog

    サーブレットからjavascriptへJSON文字列を送って受信する方法です。 prototype.jsのAjax.Updaterも使ってweb2.0の世界へ。 (id="content"の部分にJSON文字列を出力するjavascript) function ajaxUpdate(){ file="//サーブレットへのURL"; new Ajax.Updater( 'content', filen, {method: 'get', asynchronous:true, onSuccess:function(request){ var json; eval("json="+request.responseText); }, ) } (サーブレット) //JSON形式は文字コードをUTF-8にする response.setContentType("application/json; char

  • 【PHP】CakePHPでRESTのJSON APIを作成する

    ちょっと次のアプリの為にこちらでAPIを作成する必要が出てきました。 ので、APIの作成をAWSで行うことにしました。 サーバサイドはPHPPerlしか書けないし、 frameworkはcakeしか使えないというダメエンジニアの為、 cakeでREST APIを作成する事にいたしました。 その作成手順をご紹介 まず、RESTとはなにか…とは私も良くわかりませんのでググってください。 HTTP通信のGET/POST/PUT/DELETEによって返す内容を変えるって事と理解しています。 ちなみに、cakeのREST APIは マニュアル»CakePHPによる作業の定石»REST»単純なセットアップ ここで解説されております。 まずはroutes.phpの設定 Router::mapResources('controller_name'); Router::parseExtensions();

  • Railsにおける RESTfulなURL設計 勉強会

    6. URL設計で 相談したいこと ✤ RESTfulにする事によってユーザが得られるメリットに ついて知りたいです。あとREST APIを作る時のURL設 計方法、ベストプラクティスとか。 ✤ resourcesの入れ子はどれくらいが許容範囲ですか? ✤ 認証周りのURL設計。みんなどんな点に悩んでるのかが 知りたい

    Railsにおける RESTfulなURL設計 勉強会
  • Rest 2 - ウィザシステム - Witha System Ltd.

    HepCat Dev and Test Blogクライアント『BlogWrite』の開発&テスト&アップデート情報をメインに、ブログやWebにまつわる技術的トレンドなどを扱う開発ブログです。 [ Atom/REST ] RESTfullなAPIにおいてのエラーハンドリングについては重要なのですが、今まで(特に日では知っている限り)あまり言及されたことがなさそうなのと、オライリー系のサイトでたまたま今日良い記事 RESTful Error Handling を見つけたので、ココで紹介したいと思います。 (2003年12月の記事ですが何故か見落としていました) この記事では、REPSfullなWebアプリケーションにおいて、エラーが発生した時の動作は(調査した所)一般的にいって4っつの方法が利用されているとしています。 1.HTTPステータスコードのみ 例えば、 http://www.exa

  • 「Java による RESTful システム構築」 が超勉強になる!! - 宇宙行きたい

    JavaによるRESTfulシステム構築 作者: Bill Burke,arton,菅野良二出版社/メーカー: オライリージャパン発売日: 2010/08/23メディア: 大型購入: 28人 クリック: 804回この商品を含むブログ (40件) を見る これ,当にタイトル勿体無いなぁって思うでした. いや,タイトルに偽りは無いんだけど,これだと REST に興味無い人は手に取らないだろうなぁと思って,それは凄く勿体無い内容なので,ホントみんな読むと良いと思う. 簡単に説明すると,Java で REST を扱うために JAX-RS という API があるんだけど( JSR311 ),そのエキスパートグループの一人であり,さらにその実装である RESTEasy の作者が書いているです. で,この人は元々 SOAP とかのどちらかというと Fat な仕様大好きっこだったので,このには色

    「Java による RESTful システム構築」 が超勉強になる!! - 宇宙行きたい
  • javaで、simplexml, restサーバ - メランコリック

    JAVAで、simplexml、restサーバを作るのに特化したフレームワークってあるのだろうか? できれば、tomcat上で動くフレームワークがよい。 以前、調べたときにあまりしっくりくるものがなかったので、アノテーションの勉強のつもりで、作ってみました。 XMLの生成には、JAXBを利用しています。 ソースを以下に公開していますので、興味がございましたら、触っていただければと思います。 ■elazyrest http://sourceforge.jp/projects/elazyrest/wiki/FrontPage jdk1.5以降が必要になります。 ■elazyrestを使ったサンプル"twitter proxy" twitterのfriends_timeline.xmlをキャッシュして返すAPI http://twitter.com/statuses/friends_timeli

    javaで、simplexml, restサーバ - メランコリック
  • 手作りでSOAPしますか? | L'eclat des jours(2009-12-13)

    _ 手作りでSOAPしますか? O'REILLYにJava Seb Services: Up and Runningというがある。 Java Web Services: Up and Running(Kalin, Martin) オライリーの動物クォリティーだけあって、良いだ。 では、万人にお勧めできる、あるいは千人がこぞって買うか? と訊かれると悲観的な感じになる。 おもに2つの観点からだ。 このは特にJAX-WSに焦点を当てたSOAPベースのWebサービスについて書かれている。 もし、SOAベースのシステムでSOAP連携を前提にアーキテクチャを考えるとなったら、このは必携……となるはずだが、おれにはそうは考えられない。 つまり1つ目の観点は、JAX-WSというミドルェアを直接利用した連携にどれほどの需要があるか、ということだ。おれがこの観点から否定的なのは、IBMやMS(をイン