PropertyFactory (PEXA API Document)

java.lang.Object
- pexa.share.util.prop.PropertyFactory

```
public final class PropertyFactory
extends java.lang.Object
```
PEXAプロパティ形式の文字列データからMapを作成するFactoryクラスです。

PEXAプロパティ形式は、Javaの一般的なProperty形式であるKey&Valueの形式を拡張し入れ子表現を可能にした書式です。
セクションを分けて記述することが出来るので、設定情報等をより柔軟に記述する手段を提供します。

このFactoryクラスでは、以下の２つの機能を提供します。

機能１：入れ子表現の文字列からプロパティを作成する
- 入れ子表現は、プロパティ開始行、通常プロパティ行、プロパティ終了行の組み合わせで表現する。
- プロパティ開始行は、開始タグ "(" or "["と入れ子プロパティのキー文字列を記述する
  - "("から")"および"{", "}"は、Map形式で格納される。(記述順序と読出順序の一致が保証される)
  - "["から"]"は、ListにMap形式で格納される。
  - 開始タグ直後から改行までの文字列が入れ子プロパティのキーとなる
- 通常プロパティ行には、キーと値の文字列を記述する
- 組(Map)のListについて
例
```
   System.out.println(str);
   の結果が
 　　　　(root_property
  　　　　　root_property_key1 root_property_value1
  　　　　　"root property key2" "root property value2"
  　　　　　(child1
  　　　　　　child1_key1 child1_value1
  　　　　　　(child2
           　 　child1_key2 child1_value2
  　　　　　　)
  　　　　　)
  　　　　)
    のstrで入れ子プパティを作成
    System.out.println(PropertyFactory.getProperties(str));
    の結果は
    {root_property={child1={child1_key1=child1_value1, child2={child1_key2=child1_value2}}, root_property_key1=root_property_value1, root property key=root property value2}}
    となる
 
```
機能２：入れ子構造のプロパティを文字列変換する。
- Map形式で格納されている物は、"("開始タグから")"終了タグで表現される。
- List形式で格納される物は、"["開始タグから"]"終了タグはで表現される。
- 通常プロパティ行のKeyと値の区切りもには"="固定。
- Map.Entiry -> "Key=Value"。Valueが配列の場合、"Key=Value1,Value2,..,ValueN"
- Map -> (Key ... )
- List ->[Key ... , ... ]
- LinkedHashMap ->{Key ... }
改行の扱いについて
Key&Value形式のValue側に改行混じりの文字列を記述したい場合は、通常の改行に変えて
```
     [\n]
 
```
という文字列を挿入することで、機能１による文字列からMapを生成する際に[\n]の部分が通常の改行コードに変換されてValueに格納されます。

例
```
 Comment    "改行コードの前にある文字列[\n]改行コードの後にある文字列"
 
```
上記の記述を含むPEXAプロパティをMapに変換した場合、Commentというキーで取得される値は
```
 改行コードの前にある文字列
 改行コードの後にある文字列
 
```
となります。

また、機能２でMapをPEXAプロパティ形式の文字列に変換した場合は上記の逆となり、改行コードを含む値では改行コード部分が[\n]に変換されます。
バージョン:

$Revision: 5813 $ $Date:: 2010-12-15 18:20:37 #$

作成者:

tomi@japan.sun.com

メソッドのサマリー

すべてのメソッド staticメソッド concreteメソッド
修飾子とタイプ	メソッドと説明
`static java.util.Map`	`getProperties(java.lang.String str)` 入れ子プロパティを作成する。
`static java.util.Map`	`getStringKeyProperties(java.lang.String str)` 入れ子プロパティを作成するこのメソッドではキーの重複を許可する。
`static void`	`main(java.lang.String[] args)` テスト用メソッド
`static java.lang.String`	`toString(java.util.Map prm)` 入れ子プロパティを作成する

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

- メソッドの詳細
  - getProperties
```
public static java.util.Map getProperties(java.lang.String str)
```
    入れ子プロパティを作成する。このメソッドではキーの重複を許可する。
    
    パラメータ:
    
    str - 入れ子構造の文字列
    
    戻り値:
    
    作成されたプロパティ
    
    例外:
    
    PropertyFactoryException - プロパティ構造が正しくない場合
  - getStringKeyProperties
```
public static java.util.Map getStringKeyProperties(java.lang.String str)
```
    入れ子プロパティを作成するこのメソッドではキーの重複を許可する。
    
    パラメータ:
    
    str - 入れ子構造の文字列
    
    戻り値:
    
    作成されたプロパティ
    
    例外:
    
    PropertyFactoryException - プロパティ構造が正しくない場合
  - toString
```
public static java.lang.String toString(java.util.Map prm)
```
    入れ子プロパティを作成する
    
    パラメータ:
    
    prm - 入れ子構造のプロパティ
    
    戻り値:
    
    入れ子構造の文字列
  - main
```
public static void main(java.lang.String[] args)
```
    テスト用メソッド
    
    パラメータ:
    
    args -

クラス PropertyFactory

メソッドのサマリー

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

メソッドの詳細

getProperties

getStringKeyProperties

toString

main