hiJSONutl (OtsuLibrary)

java.lang.Object
- otsu.hiGadget.hiJSONutl

```
public class hiJSONutl
extends Object
```
hiJSONの補助クラス

コンストラクタのサマリー

コンストラクタ
コンストラクタと説明

hiJSONutl()

コンストラクタ
コンストラクタと説明
`hiJSONutl()`

メソッドのサマリー

すべてのメソッド staticメソッド concreteメソッド
修飾子とタイプ	メソッドと説明
`static String[]`	`asStrArray(Object obj_)` オブジェクトからString[]を得る(試験中).
`static LinkedHashMap<String,Object>`	`asStrKeyMap(Object obj_)` Map<String,Object>にキャストする.
`static void`	`objConv(Object obj_, List<String[]> to_)` 文字列の２次元Array-ObjectからArrayList<String[]>を得る(試験中).
`static void`	`objConv(Object obj_, Map<String,String> to_)` Map<String,String>のObjectからMap<String,String>を得る(試験中).
`static String`	`parseAsString(String json_)` JSON文字列をパーズしてStringを得る
`static String`	`parseAsString(String json_, long option_)` JSON文字列をパーズしてStringを得る
`static String[]`	`toArray(String json_text_)` JSON文字列を解析し、文字列配列を得る.
`static LinkedHashMap<String,String[]>`	`toArrayDict(String json_text_)` JSON文字列を解析し、文字列配列辞書を得る.
`static LinkedHashMap<String,String[]>`	`toArrayDict(String json_text_, LinkedHashMap<String,String[]> to_)` JSON文字列を解析し、文字列配列辞書を得る.
`static LinkedHashMap<String,String[]>`	`toArrayDict(String json_text_, LinkedHashMap<String,String[]> to_, long option_)` JSON文字列を解析し、文字列配列辞書を得る.
`static LinkedHashMap<String,String[]>`	`toArrayDict(String json_text_, long option_)` JSON文字列を解析し、文字列配列辞書を得る.
`static ArrayList<String>`	`toList(String json_text_)` JSON文字列を解析し、文字列リストを得る.
`static ArrayList<String>`	`toList(String json_text_, ArrayList<String> to_)` JSON文字列を解析し、文字列リストを得る.
`static ArrayList<String>`	`toList(String json_text_, ArrayList<String> to_, long option_)` JSON文字列を解析し、文字列リストを得る.
`static LinkedHashMap<String,ArrayList<String>>`	`toListDict(String json_text_)` JSON文字列を解析し、文字列リスト辞書を得る.
`static LinkedHashMap<String,ArrayList<String>>`	`toListDict(String json_text_, LinkedHashMap<String,ArrayList<String>> to_)` JSON文字列を解析し、文字列リスト辞書を得る.
`static LinkedHashMap<String,ArrayList<String>>`	`toListDict(String json_text_, LinkedHashMap<String,ArrayList<String>> to_, long option_)` JSON文字列を解析し、文字列リスト辞書を得る.
`static ArrayList<String[]>`	`toMatrix(String json_text_)` JSON文字列を解析し、文字列配列のリストを得る.
`static ArrayList<String[]>`	`toMatrix(String json_text_, ArrayList<String[]> to_)` JSON文字列を解析し、文字列配列のリストを得る.
`static ArrayList<String[]>`	`toMatrix(String json_text_, ArrayList<String[]> to_, long option_)` JSON文字列を解析し、文字列配列のリストを得る.
`static ArrayList<String[]>`	`toMatrix(String json_text_, long option_)` JSON文字列を解析し、文字列配列のリストを得る.
`static LinkedHashMap<String,ArrayList<String[]>>`	`toMatrixDict(String json_text_)` JSON文字列を解析し、文字列配列のリストの辞書を得る.
`static LinkedHashMap<String,ArrayList<String[]>>`	`toMatrixDict(String json_text_, LinkedHashMap<String,ArrayList<String[]>> to_)` JSON文字列を解析し、文字列配列のリストの辞書を得る.
`static LinkedHashMap<String,ArrayList<String[]>>`	`toMatrixDict(String json_text_, LinkedHashMap<String,ArrayList<String[]>> to_, long option_)` JSON文字列を解析し、文字列配列のリストの辞書を得る.

クラスから継承されたメソッド java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- コンストラクタの詳細
  - hiJSONutl
```
public hiJSONutl()
```
- メソッドの詳細
  - asStrArray
```
public static String[] asStrArray(Object obj_)
```
    オブジェクトからString[]を得る(試験中). 型不一致の場合はExceptionが投げられます。
    
    パラメータ:
    
    obj_ - パーズ結果のオブジェクト
    
    戻り値:
    
    変換結果
  - objConv
```
public static void objConv(Object obj_,
                           List<String[]> to_)
```
    文字列の２次元Array-ObjectからArrayList<String[]>を得る(試験中). 型不一致の場合はExceptionが投げられます。
    
    パラメータ:
    
    obj_ - パーズ結果のオブジェクト
    
    to_ - 変換結果をここに得る
  - objConv
```
public static void objConv(Object obj_,
                           Map<String,String> to_)
```
    Map<String,String>のObjectからMap<String,String>を得る(試験中). 型不一致の場合はExceptionが投げられます。
    第２引数にはHashMapやLinkedHashMapなどが使えます。
    次の操作と同様です。
```
  Map _a1=(Map)obj_;
  for(Object _obj:_a1.entrySet()){
     Map.Entry _entry=(Map.Entry)_obj;
     to_.put((String)_entry.getKey(),(String)_entry.getValue());
     }
```
    パラメータ:
    
    obj_ - パーズ結果のオブジェクト
    
    to_ - 変換結果をここに得る
  - asStrKeyMap
```
public static LinkedHashMap<String,Object> asStrKeyMap(Object obj_)
```
    Map<String,Object>にキャストする. 次の処置を行っています。
```
   static asStrKeyMap(Object obj_){
      return (LinkedHashMap<String,Object>)obj_;
      }
```
    パラメータ:
    
    obj_ - パーズ結果のオブジェクト
    
    戻り値:
    
    キャスト結果（データ複製無)
  - parseAsString
```
public static String parseAsString(String json_)
                            throws Exception
```
    JSON文字列をパーズしてStringを得る
    
    パラメータ:
    
    json_ - JSON文字列
    
    戻り値:
    
    解析結果
    
    例外:
    
    Exception - パーズエラー等
  - parseAsString
```
public static String parseAsString(String json_,
                                   long option_)
                            throws Exception
```
    JSON文字列をパーズしてStringを得る
    
    パラメータ:
    
    json_ - JSON文字列
    
    option_ - オプション
    
    戻り値:
    
    解析結果
    
    例外:
    
    Exception - パーズエラー等
  - toMatrix
```
public static ArrayList<String[]> toMatrix(String json_text_)
                                    throws Exception
```
    JSON文字列を解析し、文字列配列のリストを得る.
    JSONの二次元配列形式の文字列からArrayList<String[]>データを得ます。
    通常のjsonと異なり引用符はシングルクオートでもダブルクオートでもかまいません。コメントも可能です。
```
  解析される文字列の例
    "[['A','B','C'],['X','Y','Z']]"
```
    パラメータ:
    
    json_text_ - 解析する文字列
    
    戻り値:
    
    解析結果
    
    例外:
    
    Exception - パーズエラー等
  - toMatrix
```
public static ArrayList<String[]> toMatrix(String json_text_,
                                           long option_)
                                    throws Exception
```
    JSON文字列を解析し、文字列配列のリストを得る.
    
    パラメータ:
    
    json_text_ - 解析する文字列
    
    option_ - hiJSON.with_option(long)参照参照
    
    戻り値:
    
    解析結果
    
    例外:
    
    Exception - パーズエラー等
  - toMatrix
```
public static ArrayList<String[]> toMatrix(String json_text_,
                                           ArrayList<String[]> to_)
                                    throws Exception
```
    JSON文字列を解析し、文字列配列のリストを得る.
    JSONの二次元配列形式の文字列からArrayList<String[]>データを得ます。
    通常のjsonと異なり引用符はシングルクオートでもダブルクオートでもかまいません。コメントも可能です。
```
  解析される文字列の例
    "[['A','B','C'],['X','Y','Z']]"
```
    パラメータ:
    
    json_text_ - 解析する文字列
    
    to_ - ここに解析結果を得る
    
    戻り値:
    
    解析結果(to_が戻ります）
    
    例外:
    
    Exception - パーズエラー等
  - toMatrix
```
public static ArrayList<String[]> toMatrix(String json_text_,
                                           ArrayList<String[]> to_,
                                           long option_)
                                    throws Exception
```
    JSON文字列を解析し、文字列配列のリストを得る.
    
    パラメータ:
    
    json_text_ - 解析する文字列
    
    to_ - ここに解析結果を得る
    
    option_ - hiJSON.with_option(long)参照
    
    戻り値:
    
    解析結果(to_が戻ります）
    
    例外:
    
    Exception - パーズエラー等
  - toList
```
public static ArrayList<String> toList(String json_text_)
                                throws Exception
```
    JSON文字列を解析し、文字列リストを得る.
    JSONの1次元配列形式の文字列からArrayList<String>データを得ます。
```
  解析される文字列の例
    "['A','B','C']"
```
    次の操作と同等です。
```
  @SuppressWarnings("unchecked")
  Object _json=parse(json_text_);
  ArrayList<String> _to=(ArrayList<String>)_json;
```
    パラメータ:
    
    json_text_ - 解析する文字列
    
    戻り値:
    
    to_が戻る
    
    例外:
    
    Exception - パーズエラー等
  - toArray
```
public static String[] toArray(String json_text_)
                        throws Exception
```
    JSON文字列を解析し、文字列配列を得る.
    JSONの1次元配列形式の文字列からArrayList<String>データを得ます。
```
  解析される文字列の例
    "['A','B','C']"
```
    パラメータ:
    
    json_text_ - 解析する文字列
    
    戻り値:
    
    解析結果
    
    例外:
    
    Exception - パーズエラー等
  - toArrayDict
```
public static LinkedHashMap<String,String[]> toArrayDict(String json_text_)
                                                  throws Exception
```
    JSON文字列を解析し、文字列配列辞書を得る.
    JSONの1次元配列形式の文字列からArrayList<String>データを得ます。
```
  解析される文字列の例
  {
    "要素名1":['A','B','C'],
    "要素名2":['x','y','z']
    }
```
    パラメータ:
    
    json_text_ - 解析する文字列
    
    戻り値:
    
    解析結果
    
    例外:
    
    Exception - パーズエラー等
  - toArrayDict
```
public static LinkedHashMap<String,String[]> toArrayDict(String json_text_,
                                                         long option_)
                                                  throws Exception
```
    JSON文字列を解析し、文字列配列辞書を得る.
    
    パラメータ:
    
    json_text_ - 解析する文字列
    
    option_ - hiJSON.with_option(long)参照
    
    戻り値:
    
    解析結果
    
    例外:
    
    Exception - パーズエラー等
  - toArrayDict
```
public static LinkedHashMap<String,String[]> toArrayDict(String json_text_,
                                                         LinkedHashMap<String,String[]> to_,
                                                         long option_)
                                                  throws Exception
```
    JSON文字列を解析し、文字列配列辞書を得る.
    JSONの1次元配列形式の文字列からArrayList<String>データを得ます。
    option_にhiU.APPENDを指定するとto_に追加するかたちとなります。既に同名の要素がある場合は置き換えられます。配列の追加ではありません。
```
  解析される文字列の例
  {
    "要素名1":['A','B','C'],
    "要素名2":['x','y','z']
    }
```
    パラメータ:
    
    json_text_ - 解析する文字列
    
    to_ - 結果を入れる辞書
    
    option_ - hiU.APPENDを付けるとto_に追加されます
    
    戻り値:
    
    to_が戻る
    
    例外:
    
    Exception - パーズエラー等
  - toArrayDict
```
public static LinkedHashMap<String,String[]> toArrayDict(String json_text_,
                                                         LinkedHashMap<String,String[]> to_)
                                                  throws Exception
```
    JSON文字列を解析し、文字列配列辞書を得る.
    JSONの1次元配列形式の文字列からArrayList<String>データを得ます。
```
  解析される文字列の例
  {
    "要素名1":['A','B','C'],
    "要素名2":['x','y','z']
    }
```
    パラメータ:
    
    json_text_ - 解析する文字列
    
    to_ - 結果を入れる辞書
    
    戻り値:
    
    to_が戻る
    
    例外:
    
    Exception - パーズエラー等
  - toList
```
public static ArrayList<String> toList(String json_text_,
                                       ArrayList<String> to_,
                                       long option_)
                                throws Exception
```
    JSON文字列を解析し、文字列リストを得る.
    JSONの1次元配列形式の文字列からArrayList<String>データを得ます。
```
  解析される文字列の例
    "['A','B','C']"
```
    次の操作と同等です。
```
  @SuppressWarnings("unchecked")
  Object _json=hiJSON.parseText(json_text_);
  ArrayList<String> _to=(ArrayList<String>)_json;
```
    パラメータ:
    
    json_text_ - 解析する文字列
    
    to_ - 結果を入れる文字列リスト
    
    option_ - hiU.APPENDを付けるとto_に追加されます
    
    戻り値:
    
    to_が戻る
    
    例外:
    
    Exception - パーズエラー等
  - toList
```
public static ArrayList<String> toList(String json_text_,
                                       ArrayList<String> to_)
                                throws Exception
```
    JSON文字列を解析し、文字列リストを得る.
    JSONの1次元配列形式の文字列からArrayList<String>データを得ます。
```
  解析される文字列の例
    "['A','B','C']"
```
    次の操作と同等です。
```
  @SuppressWarnings("unchecked")
  Object _json=hiJSON.parseText(json_text_);
  ArrayList<String> _to=(ArrayList<String>)_json;
```
    パラメータ:
    
    json_text_ - 解析する文字列
    
    to_ - 結果を入れる文字列リスト
    
    戻り値:
    
    to_が戻る
    
    例外:
    
    Exception - パーズエラー等
  - toListDict
```
public static LinkedHashMap<String,ArrayList<String>> toListDict(String json_text_,
                                                                 LinkedHashMap<String,ArrayList<String>> to_,
                                                                 long option_)
                                                          throws Exception
```
    JSON文字列を解析し、文字列リスト辞書を得る.
    JSONの1次元配列形式の文字列からHashMap<String,ArrayList<String>>データを得ます。
    option_にhiU.APPENDを指定するとto_に追加するかたちとなります。既に同名の要素がある場合は置き換えられます。配列の追加ではありません。
```
  解析される文字列の例
  {
    "要素名1":['A','B','C'],
    "要素名2":['x','y','z']
    }
```
    パラメータ:
    
    json_text_ - 解析する文字列
    
    to_ - 結果を入れる文字列リスト
    
    option_ - hiU.APPENDを付けるとto_に要素が追加されます。
    
    戻り値:
    
    to_が戻る
    
    例外:
    
    Exception - パーズエラー等
  - toListDict
```
public static LinkedHashMap<String,ArrayList<String>> toListDict(String json_text_,
                                                                 LinkedHashMap<String,ArrayList<String>> to_)
                                                          throws Exception
```
    JSON文字列を解析し、文字列リスト辞書を得る.
    JSONの1次元配列形式の文字列からHashMap<String,ArrayList<String>>データを得ます。
```
  解析される文字列の例
  {
    "要素名1":['A','B','C'],
    "要素名2":['x','y','z']
    }
```
    パラメータ:
    
    json_text_ - 解析する文字列
    
    to_ - 結果を入れる文字列リスト
    
    戻り値:
    
    to_が戻る
    
    例外:
    
    Exception - パーズエラー等
  - toListDict
```
public static LinkedHashMap<String,ArrayList<String>> toListDict(String json_text_)
                                                          throws Exception
```
    JSON文字列を解析し、文字列リスト辞書を得る.
    JSONの1次元配列形式の文字列からHashMap<String,ArrayList<String>>データを得ます。
    option_にhiU.APPENDを指定するとto_に追加するかたちとなります。既に同名の要素がある場合は置き換えられます。配列の追加ではありません。
```
  解析される文字列の例
  {
    "要素名1":['A','B','C'],
    "要素名2":['x','y','z']
    }
```
    パラメータ:
    
    json_text_ - 解析する文字列
    
    戻り値:
    
    to_が戻る
    
    例外:
    
    Exception - パーズエラー等
  - toMatrixDict
```
public static LinkedHashMap<String,ArrayList<String[]>> toMatrixDict(String json_text_)
                                                              throws Exception
```
    JSON文字列を解析し、文字列配列のリストの辞書を得る.
    JSONの二次元配列形式の文字列からArrayList<String[]>の辞書を得ます。
    拡張jsonであり引用符はシングルクオートでもダブルクオートでもかまいません。要素名は引用符で囲む必要はありません。コメントも可能です。
```
  String json="{'elm1':[['A','B','C'],['X','Y','Z']]"
             +"// コメント\n"
             +",\"elm2\":[['a','b',\"x\"],['x',/*コメント*/'y','x'],['あ','い']]}"
  HashMap<String,ArrayList<String[]>> data
                       =hiText.jsonToMatrixDict(json);
```
    パラメータ:
    
    json_text_ - 解析する文字列
    
    戻り値:
    
    解析結果
    
    例外:
    
    Exception - パーズエラー等
  - toMatrixDict
```
public static LinkedHashMap<String,ArrayList<String[]>> toMatrixDict(String json_text_,
                                                                     LinkedHashMap<String,ArrayList<String[]>> to_,
                                                                     long option_)
                                                              throws Exception
```
    JSON文字列を解析し、文字列配列のリストの辞書を得る.
    JSONの二次元配列形式の文字列からArrayList<String[]>の辞書を得ます。
    option_引数にhiU.APPENDを指定するとto_辞書に辞書要素を追加する形となります。
    to_辞書に既に既に同名の要素がある場合は置き換えられます。
    拡張jsonであり引用符はシングルクオートでもダブルクオートでもかまいません。要素名は引用符で囲む必要はありません。コメントも可能です。
```
  String json="{'elm1':[['A','B','C'],['X','Y','Z']]"
             +"// コメント\n"
             +",\"elm2\":[['a','b',\"x\"],['x',/*コメント*/'y','x'],['あ','い']]}"
  HashMap<String,ArrayList<String[]>> data
                       =hiText.jsonToMatrixDict(json);
```
    パラメータ:
    
    json_text_ - 解析する文字列
    
    to_ - 結果を入れる辞書
    
    option_ - hiU.APPENDを付けるとto_に追加されます。
    
    戻り値:
    
    解析結果(to_が戻ります）
    
    例外:
    
    Exception - パーズエラー等
  - toMatrixDict
```
public static LinkedHashMap<String,ArrayList<String[]>> toMatrixDict(String json_text_,
                                                                     LinkedHashMap<String,ArrayList<String[]>> to_)
                                                              throws Exception
```
    JSON文字列を解析し、文字列配列のリストの辞書を得る.
    JSONの二次元配列形式の文字列からArrayList<String[]>の辞書を得ます。
    拡張jsonであり引用符はシングルクオートでもダブルクオートでもかまいません。要素名は引用符で囲む必要はありません。コメントも可能です。
```
  String json="{'elm1':[['A','B','C'],['X','Y','Z']]"
             +"// コメント\n"
             +",\"elm2\":[['a','b',\"x\"],['x',/*コメント*/'y','x'],['あ','い']]}"
  HashMap<String,ArrayList<String[]>> data
                       =hiText.jsonToMatrixDict(json);
```
    パラメータ:
    
    json_text_ - 解析する文字列
    
    to_ - 結果を入れる辞書
    
    戻り値:
    
    解析結果(to_が戻ります）
    
    例外:
    
    Exception - パーズエラー等

クラス hiJSONutl

コンストラクタのサマリー

メソッドのサマリー

クラスから継承されたメソッド java.lang.Object

コンストラクタの詳細

hiJSONutl

メソッドの詳細

asStrArray

objConv

objConv

asStrKeyMap

parseAsString

parseAsString

toMatrix

toMatrix

toMatrix

toMatrix

toList

toArray

toArrayDict

toArrayDict

toArrayDict

toArrayDict

toList

toList

toListDict

toListDict

toListDict

toMatrixDict

toMatrixDict

toMatrixDict