Json-simple-quick-guide
JSON.simple-概要
特徴
- 仕様準拠-JSON.simpleはJSON仕様-RFC4627に完全に準拠しています。
- 軽量-クラスは非常に少なく、エンコード/デコードやjsonのエスケープなどの必要な機能を提供します。
- コレクションの再利用-操作のほとんどは、Map/Listインターフェイスを使用して行われ、再利用性が向上しています。
- ストリーミングのサポート-JSON出力テキストのストリーミングをサポートします。
- * SAXのようなコンテンツハンドラ*-大量のJSONデータをストリーミングするためのSAXのようなインターフェイスを提供します。
- 高性能-ヒープベースのパーサーが使用され、高性能を提供します。
- 依存関係なし-外部ライブラリの依存関係なし。 独立して含めることができます。
- * JDK1.2互換*-ソースコードとバイナリはJDK1.2互換です
JSON.simple-環境設定
ローカル環境のセットアップ
JSON.simpleはJavaのライブラリなので、最初の要件はマシンにJDKをインストールすることです。
システム要件
JDK | Memory | Disk Space | Operating System |
---|---|---|---|
1.5 or above. | No minimum requirement. | No minimum requirement. | No minimum requirement. |
ステップ1:マシンでのJavaインストールの検証
まず、コンソールを開き、作業しているオペレーティングシステムに基づいてjavaコマンドを実行します。
OS | Task | Command |
---|---|---|
Windows | Open Command Console | c:\> java -version |
Linux | Open Command Terminal | $ java -version |
Mac | Open Terminal | machine:< joseph$ java -version |
すべてのオペレーティングシステムの出力を確認しましょう-
OS | Output |
---|---|
Windows |
java version "1.8.0_101" Java(TM)SEランタイム環境(ビルド1.8.0_101) |
Linux |
java version "1.8.0_101" Java(TM)SEランタイム環境(ビルド1.8.0_101) |
Mac |
java version "1.8.0_101" Java(TM)SEランタイム環境(ビルド1.8.0_101) |
システムにJavaがインストールされていない場合は、次のリンクからJavaソフトウェア開発キット(SDK)をダウンロードしてください。https://www.oracle.com/technetwork/java/javase/downloads/indexl[www.oracle.com ]。 このチュートリアルのインストールバージョンとしてJava 1.8.0_101を想定しています。
ステップ2:JAVA環境を設定する
OS | Output |
---|---|
Windows | Set the environment variable JAVA_HOME to C:\Program Files\Java\jdk1.8.0_101 |
Linux | export JAVA_HOME =/usr/local/java-current |
Mac | export JAVA_HOME =/Library/Java/Home |
Javaコンパイラの場所をシステムパスに追加します。
OS | Output |
---|---|
Windows | Append the string C:\Program Files\Java\jdk1.8.0_101\bin *at the end of the system variable, Path*. |
Linux | export PATH = $PATH:$JAVA_HOME/bin/ |
Mac | not required |
上記の説明に従って、コマンド java -version を使用してJavaのインストールを確認します。
ステップ3:JSON.simpleアーカイブをダウンロードする
json-simple @ MVNRepositoryからJSON.simple jarファイルの最新バージョンをダウンロードします。 このチュートリアルを書いている時点で、json-simple-1.1.1.jarをダウンロードし、C:\> JSONフォルダーにコピーしました。
OS | Archive name |
---|---|
Windows | json-simple-1.1.1.jar |
Linux | json-simple-1.1.1.jar |
Mac | json-simple-1.1.1.jar |
ステップ4:JSON_JAVA環境を設定する
Sr.No | OS & Description |
---|---|
1 |
Windows 環境変数JSON_JAVAをC:\ JSONに設定します |
2 |
Linux エクスポートJSON_JAVA =/usr/local/JSON |
3 |
Mac エクスポートJSON_JAVA =/Library/JSON |
ステップ5:CLASSPATH変数を設定する
JSON.simple jarの場所を指すように CLASSPATH 環境変数を設定します。
Sr.No | OS & Description |
---|---|
1 |
Windows 環境変数CLASSPATHを%CLASSPATH%;%JSON_JAVA%\ json-simple-1.1.1.jar;。;に設定します。 |
2 |
Linux export CLASSPATH = $ CLASSPATH:$ JSON_JAVA/json-simple-1.1.1.jar :. |
3 |
Mac export CLASSPATH = $ CLASSPATH:$ JSON_JAVA/json-simple-1.1.1.jar :. |
JSON.simple-JAVAマッピング
JSON.simpleは、デコードまたは解析中にエンティティを左側から右側にマップし、エンコード中にエンティティを右側から左側にマップします。
JSON | Java |
---|---|
string | java.lang.String |
number | java.lang.Number |
true | false |
java.lang.Boolean | null |
null | array |
java.util.List | object |
デコード時、_java.util.List_のデフォルトの具象クラスは_org.json.simple.JSONArray_であり、_java.util.Map_のデフォルトの具象クラスは_org.json.simple.JSONObject_です。
JSON.simple-特殊文字のエスケープ
次の文字は予約文字であり、JSONでは使用できません。文字列で使用するには、適切にエスケープする必要があります。
- Backspace は\ bに置き換えられます
- *フォームフィード*は\ fに置き換えられます
- *改行*は\ nに置き換えられます
- *キャリッジリターン*は\ rに置き換えられます
- Tab は\ tに置き換えられます
- *二重引用符*は\ "に置き換えられます
- *バックスラッシュ*は\\に置き換えられます
- JSONObject.escape()*メソッドを使用して、JSON文字列のそのような予約済みキーワードをエスケープできます。 以下は例です-
例
出力
JSON.simple-JSONValueの使用
JSONValueは、指定されたJSON文字列を解析するJSONObjectを返す静的メソッドparse()を提供します。これを使用して、解析された値を取得できます。 下記の例をご覧ください。
例
出力
JSON.simple-例外処理
JSONParser.parse()は、無効なJSONの場合にParseExceptionをスローします。 次の例は、ParseExceptionを処理する方法を示しています。
例
出力
JSON.simple-コンテナファクトリ
ContainerFactoryを使用して、解析されたJSONオブジェクト/配列のカスタムコンテナを作成できます。 最初にContainerFactoryオブジェクトを作成し、それをJSONParserのparseメソッドで使用して必要なオブジェクトを取得する必要があります。 以下の例を参照してください-
例
出力
JSON.simple-ContentHandler
ContentHandlerインターフェースは、大きなJSONをストリーミングするためのインターフェースのようなSAXを提供するために使用されます。 停止可能な機能も提供します。 次の例は、概念を示しています。
例
出力
JSON.simple-JSONObjectのエンコード
JSON.simpleを使用して、次の方法を使用してJSONオブジェクトをエンコードできます-
- * JSONオブジェクトのエンコード-文字列へ*-シンプルなエンコード。
- * JSONオブジェクトのエンコード-ストリーミング*-出力はストリーミングに使用できます。
- * JSONオブジェクトのエンコード-マップの使用*-順序を維持してエンコードします。
- * JSONオブジェクトのエンコード-マップとストリーミングの使用*-順序を保持してストリーミングすることによるエンコード。
次の例は、上記の概念を示しています。
例
出力
JSON.simple-JSONArrayのエンコード
JSON.simpleを使用して、次の方法を使用してJSON配列をエンコードできます-
- * JSON配列のエンコード-ストリングへ*-単純なエンコード。
- * JSON配列のエンコード-ストリーミング*-出力はストリーミングに使用できます。
- * JSON配列のエンコード-リストの使用*-リストを使用したエンコード。
- * JSON配列のエンコード-リストとストリーミングの使用*-リストを使用したエンコードとストリーミング。
次の例は、上記の概念を示しています。
例
出力
JSON.simple-オブジェクトのマージ
JSON.simpleでは、JSONObject.putAll()メソッドを使用して2つのJSONオブジェクトを簡単にマージできます。
次の例は、上記の概念を示しています。
例
出力
JSON.simple-配列のマージ
JSON.simpleでは、JSONArray.addAll()メソッドを使用して2つのJSON配列を簡単にマージできます。
次の例は、上記の概念を示しています。
例
出力
JSON.simple-プリミティブ、オブジェクト、配列
JSONArrayオブジェクトを使用して、プリミティブ、オブジェクト、配列で構成されるJSONを作成できます。
次の例は、上記の概念を示しています。
例
出力
JSON.simple-プリミティブ、マップ、リストの組み合わせ
JSONValueオブジェクトを使用して、プリミティブ、Map、Listで構成されるJSONを作成できます。
次の例は、上記の概念を示しています。
例
出力
JSON.simple-プリミティブ、オブジェクト、マップ、リスト
JSONValueオブジェクトを使用して、プリミティブ、オブジェクト、マップ、およびリストで構成されるJSONを作成できます。
次の例は、上記の概念を示しています。
例
出力
JSON.simple-カスタマイズされた出力
カスタムクラスに基づいてJSON出力をカスタマイズできます。 唯一の要件は、JSONAwareインターフェースを実装することです。
次の例は、上記の概念を示しています。
例
出力
JSON.simple-カスタマイズされた出力ストリーミング
カスタムクラスに基づいてJSONストリーミング出力をカスタマイズできます。 唯一の要件は、JSONStreamAwareインターフェースを実装することです。
次の例は、上記の概念を示しています。