僕が考えた最強のAPIドキュメント生成 - 銀の人のメモ帳
2023 追記 2023 年現在では、以下の文章では採用を見送っている OpenAPI を使えば OK という雰囲気です。 Web APIの設計 作者:Arnaud Lauret翔泳社Amazon TL; DR ドキュメント生成にはkevinrenskers/raml2htmlを使った ドキュメントはRAML - RESTful API modeling languageで書いた RAMLにはJSON SchemaとJSONを記載できる APIで返ってくるJSONはRailsアプリのrequest specでJSON Schemaを使ってテストした JSON Schemaはr7kamura/json_worldで生成した ドキュメントに載せる例示のJSONもJSON Schemaからgin0606/screijiを使って生成した 上記の方法だとリクエストパラメタとドキュメントの整合性を担保
Web APIにはJSONベースのフォーマットを使おう - Qiita
{ "response": { "id": 3342124, "message": "Hi!", "user": { "id": 3456, "name": "Taro Yamada", "image_url": "/images/taro.png" } } } など、どの構造がいいでしょうか？ もっと違う構造も考えられます。 JSONはシンプルですが、構造に制約がなさすぎます。適切な設計を行うには適切な制約が必要です。 そこで、plain JSONに少し制約を加えたJSONベースのフォーマットを使うことをおすすめします。 もしあなたが、JSONレスポンスをどのようなフォーマットにするかをチームで議論したことがあるなら、JSON APIは『自転車置き場の議論』に対抗する武器となる。 共有された規約に従うことで、生産性が向上し、汎用的なツールを利用でき、アプリケーションという重要なものに集中
The JSON1 Extension | SQLite
1. Overview By default, SQLite supports sixteen functions and two operators for dealing with JSON values. There are also two table-valued functions that can be used to decompose a JSON string. There are 15 scalar functions and operators: json(json) json_array(value1,value2,...) json_array_length(json) json_array_length(json,path) json_error_position(json) json_extract(json,path,...) json -> path j
JSONICとJacksonのメモ - Qiita
JavaでJSONをエンコード、デコードするために使われるライブラリのうち、JSONICとJacksonについてのメモです。 Java SE 8とJAX-RSを使ったRESTful Webアプリケーションの開発をターゲットとして、ライブラリをJSONICからJacksonへ変更した際のポイントをまとめました。 ただし本エントリは、JSONICからJacksonへの移行を推奨するものではありません。 リファレンス どちらも基本的にアノテーションを使って出力方法をカスタマイズします。 JSONICの場合、アノテーションは org.arnx.jsonic パッケージにあり、Jacksonの場合アノテーションは com.fasterxml.jackson.annotation パッケージにあります。 特定のフィールドを除外する
JSONICを使ってJavaオブジェクトをJSONに変換(JSON encode)したり、JSONをJavaオブジェクトに変換する(decode)サンプル - 感謝のプログラミング
JSONICのダウンロード 以下のURL先からjsonicのjarをダウンロードして、ビルドパスに追加する。 http://sourceforge.jp/projects/jsonic/ 「jsonic-1.2.11.zip 」 net.arnx.jsonic.JSONは、JSON形式のエンコードやデコードを行うためのstaticメソッドを提供するユーティリティクラスである。 基本的な変換は、このクラスのメソッドを呼び出すことで簡単に実現できる。 POJOからJSONへエンコードする(JavaオブジェクトをJSONに変換する) JSONICを使って、JavaオブジェクトをJSONに変換するサンプル(example)は以下の通り。 package samples; import net.arnx.jsonic.JSON; public class JsonicSample { public
JSONIC - simple json encoder/decoder for java
2018/7/1 重要なお知らせ JSONIC はリポジトリを GitHub に移動させるとともに、今後機能強化が行われることがないメンテナンスモードに移行します。Java 新バージョンで動作できなくなった場合への対応は要望があれば考えますが、可能であれば、機能、パフォーマンス共に優れた jackson への移行をおすすめいたします。 JSONICとは JSONICは、Java用のシンプルかつ高機能なJSONエンコーダー/デコーダーライブラリです。 Java用のJSONライブラリはすでに多数存在しますが、JSONICはRFC 7159に従った正式なJSON形式でのデコード/エンコードを行いながらも、プログラミング言語に依存する情報をJSON内に含めることなくPOJO(Plain Old Java Object)と自然な変換を行える点に特徴があります。 使い方も非常に簡単です。 import
JSON Schema: first Java implementation available! | Nicolas Vahlas's Blog
Java source code available on gitorious Yesterday night, I published a first version of the source code on Gitorious. It is released under the Apache V2.0 License. This implementation covers nearly all of the “Core Schema Definition” corresponding to the paragraph 5 of the specification. The “missing” items (mainly, 5.21, 5.22 and 5.25) concern points of the specifications that need to be clarifi
JSON(Volley)+ListViewでページング。くるくる付き。 - Qiita
sqlite版を作り、JSON版もほぼ同じに作りたかったけど、経験と能力不足で挫折。とりあえず動くコードをメモ。 やりたいこと ・WebAPI（PHP）からJSONを取得し、ページング表示。移動（待ち）時間には「くるくる」を表示。 ・データの最後まできたら「これ以上データはない」的なメッセージを出す。 作ったファイル MyActivity.java （説明なし） Member.java（取り扱うデータ） MemberAdapter.java（カスタムアダプター） MyData.java（データを非同期で取得するクラス） footer.xml（フッター用レイアウト） row.xml（ListViewの1行ずつのレイアウト） 課題・考察 sqliteを使う場合と統合ができなかった。。。それは後日の課題とする。 最初の読み込み時だけは、処理を変えたかったけど、可読性重視で特に何もしてない。 （デ
JSONから取得したurlで画像をlistviweに表示する（Volley） - Qiita
やりたいこと JSONから情報を取得しListViewに表示。そのとき、JSONと画像はVolleyで取ってくる。 必要なファイル（クラス） MyActivity.java メイン。 Member.java ListViewで表示するデータ。ArrayListで使う。 MemberAdapter.java カスタムアダプター（肝）。 MyLruCache.java キャッシュクラス。ImageLoaderの引数に必要（まるまるコピペ） 追記：JsonObjectRequestの第三引数を(String)null,と型指定しました。 コード setAdapter(adapter)の後にリクエスト。 public class MyActivity extends Activity { ListView myListView; RequestQueue queue; @Override prot
VolleyでのJSON処理 その２ - Qiita
{ "status":"OK", "members":[ {"name":"hoge","age":"56"}, {"name":"foo","age":"34"} ] } android側 追記 なお、最新環境で下記のコードを実行すると「JsonObjectRequestの参照はあいまいです」的なエラーが出ます。 以前より、引数の型が厳しくなったようです（以下は修正済）。 new JsonObjectRequest(Method.GET, url, null, のところを、 new JsonObjectRequest(Method.GET, url, (String)null, とすることで回避できます。 public class MyActivity extends Activity { @Override protected void onCreate(Bundle savedIns
Android/ScalaでJSONパース - jackson-databind編 - Qiita
ScalaのJSONライブラリにはこちらのスレッドによると、ざっと下の選択肢がある。多い... parsing.json.JSON - 標準ライブラリ spray-json Jerkson - JacksonのScala用ラッパ sjson lift-json json4s - lift-json系 Argonaut - Scalaz系 play-json Jackson - Javaライブラリ 今回は、とっつきやすそうで、pull型(Streaming)パースをサポートしていて、Java界で実績がありそうなJacksonを試すことにした。環境はsbt-androidで、とりあえずJSONをScalaのオブジェクトとして取得(データバインド）してみることにした。 1. 依存関係の追加 build.sbtに jackson-core, jackson-databind を追加。 librar
Jacksonを使ったJsonConverterクラス - Qiita
よく使っているJacksonを使ったJSON⇔Object相互変換クラスです。 pomのdependency設定 <dependency> <groupId>com.fasterxml.jackson.core</groupId> <artifactId>jackson-databind</artifactId> <version>2.7.4</version> </dependency> <dependency> <groupId>com.fasterxml.jackson.core</groupId> <artifactId>jackson-annotations</artifactId> <version>2.7.4</version> </dependency> import java.io.IOException; import java.security.InvalidPara
Jackson でオブジェクトを JSON に変換 - エンジニアになりたい
Jackson Java JSON-processor を使ってみます。 1. jar の取得 取得するのは jackson-annotations-2.x.x.jar jackson-core-2.x.x.jar jackson-databind-2.x.x.jar ※今回は2.2.3 http://wiki.fasterxml.com/JacksonDownload ここからダウンロード 2. 取得した jar をクラスパスに追加 3. こんな感じで使えます // JSONの文字列に変換するオブジェクト Person person = new Person("ジャクソン", 28, children); // 変換 ObjectMapper objectMapper = new ObjectMapper(); String json = objectMapper.writeValueA
Jackson Databindを使ってみる - CLOVER🍀
これまで、JSONといえばJSONICを使っていたのですが、ちょっとしたことからJacksonを使ってみたので、これを機に書いておくことにしました。 FasterXML/Jackson https://github.com/FasterXML/jackson JSON関連では相当有名なライブラリですが、仕事ではSeasar2を使うことが多いのでその組み合わせでJSONICを使っていたんですよね。 今回は速度を求めたいので、Jacksonというわけです。 まずは使ってみる Jacksonを使う時には、StreamingとDatabindがあるようですが、今回はDatabindを使用します。 Jackson Databind https://github.com/FasterXML/jackson-databind Maven依存関係。 <dependency> <groupId>com.fa
Jackson使い方メモ - Qiita
package sample.jackson; public class Hoge { public int id; public String name; @Override public String toString() { return "Hoge [id=" + id + ", name=" + name + "]"; } } package sample.jackson; import com.fasterxml.jackson.core.JsonProcessingException; import com.fasterxml.jackson.databind.ObjectMapper; public class Main { public static void main(String[] args) throws JsonProcessingException { Hog
JsonPullParser_ja
JsonPullParserについて (for v1.0) JsonPullParserは、JSONを逐次解釈するPullParser 本体 と APT を組み合わせたライブラリです。 Annotationと組み合わせることで、簡単にJSONとJavaのクラスをマッピングすることができます。 小さなライブラリ 実行時に必要なのは、JsonPullParser本体を含む jsonpullparser-core-X.X.jar のみです。 JSONの逐次解釈 JSON全体を読み終わる前に、読み終わった部分のインスタンスを受け取ることができます。 複数のプラットフォームで動きます Androidとappengineで動作しています。 入手先 maven を参照 もしくは Maven Central Repository からjarファイルをダウンロード jsonpullparser-apt js
Gsonメモ(Hishidama's Gson Memo)
概要 Gsonは、GoogleのJSONライブラリー。 JavaのオブジェクトをJSON形式で保存・復元（シリアライズ・デシリアライズと同様）するのに便利。 必要なライブラリーはGsonのjarファイルのみ（バージョン2.2.2の場合はgson-2.2.2.jar）で、他に依存するjarファイルが無いのも利点。 例 ExampleBeanクラスを保存・復元する例。 ExampleBean.java： public class ExampleBean { private String text; private int value; public ExampleBean(String s, int n) { this.text = s; this.value = n; } @Override public String toString() { return String.format("E
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
GitHub - java-json-tools/json-schema-validator: A JSON Schema validation implementation in pure Java, which aims for correctness and performance, in that order
GitHub - FasterXML/jackson-databind: General data-binding package for Jackson (2.x): works on streaming API (core) implementation(s)
GitHub - vvakame/JsonPullParser: compiler time JSON-POJO Mapper for Java