nablarch.core.util

クラス Builder

java.lang.Object

nablarch.core.util.Builder

public final class Builder
extends java.lang.Object

List・Map・String 等の基本型からなるオブジェクトグラフの生成を簡略化する ユーティリティメソッドを提供する。

フィールドのサマリー

フィールド

修飾子とタイプ	フィールドと説明
static java.lang.String	LS 改行文字

メソッドのサマリー

修飾子とタイプ	メソッドと説明
static java.lang.String	concat(java.lang.Object... elements) elementsの各要素のtoString()の結果を単純に連結した文字列を返す。
static java.lang.String	join(java.lang.Iterable<?> lines) linesの各要素のtoString()の結果をLSで連結した文字列を返す。
static java.lang.String	join(java.lang.Iterable<?> lines, java.lang.String separator) linesの各要素のtoString()の結果を、separatorで連結した文字列を返す。
static java.lang.String	join(java.lang.Object[] lines, java.lang.String separator) linesの各要素のtoString()の結果を、separatorで連結した文字列を返す。
static java.lang.String	lines(java.lang.Object... lines) 各引数に対するtoString()の結果を改行文字(line.separator)で連結した文字列を返す。
static java.lang.String	linesf(java.lang.Object... lines) lines()メソッドにテンプレート文字列を解釈する機能を追加したもの。
static <T> java.util.List<T>	list(java.lang.Class<T> memberType, java.lang.Object... elements) elementType型のインスタンスを要素とするList(ArrayList)を生成する。
static <T> java.util.List<T>	listf(java.lang.Class<T> memberType, java.lang.Object... elements) list(Class, Object...)
static java.util.List<java.lang.String>	split(java.lang.Object string) 改行文字によって文字列を分割する。
static java.util.List<java.lang.String>	split(java.lang.Object string, java.lang.String lineSeparator) 指定した連結文字によって文字列を分割する。
static java.lang.Class<?>	typeOf(java.lang.String literal) 文字列から適切なデータ型を自動判別する。
static <T> T	valueOf(java.lang.Class<T> type, java.lang.Object value) 指定された文字列表現から、指定された型のオブジェクトを生成する。
static java.lang.Object	valueOf(java.lang.String literal) 文字列から適切なデータ型を自動判別してオブジェクトを生成する。

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

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

フィールドの詳細

LS

public static final java.lang.String LS

改行文字

関連項目:

定数フィールド値

メソッドの詳細

join

@Published(tag="architect")
public static java.lang.String join(java.lang.Iterable<?> lines,
                                                                java.lang.String separator)

linesの各要素のtoString()の結果を、separatorで連結した文字列を返す。

 
 List<String> list = Arrays.asList("あ", "い", "う");
 String str = Builder.join(list, ","); //--> "あ,い,う"
 
 

パラメータ:

lines - 連結される要素文字列

separator - 要素間に連結される文字列

戻り値:

連結後の文字列

join

@Published(tag="architect")
public static java.lang.String join(java.lang.Object[] lines,
                                                                java.lang.String separator)

linesの各要素のtoString()の結果を、separatorで連結した文字列を返す。

 
 String[] lines = {"あ", "い", "う"};
 String str = Builder.join(lines, ","); //--> "あ,い,う"
 
 

パラメータ:

lines - 連結される要素文字列

separator - 要素間に連結される文字列

戻り値:

連結後の文字列

concat

@Published(tag="architect")
public static java.lang.String concat(java.lang.Object... elements)

elementsの各要素のtoString()の結果を単純に連結した文字列を返す。 大量の文字列連結を行う場合、+演算子による連結より処理効率がよい。

 
 String str = Builder.concat("あ", "い", "う"); //--> "あいう"
 
 

パラメータ:

elements - 要素

戻り値:

連結文字列

join

@Published(tag="architect")
public static java.lang.String join(java.lang.Iterable<?> lines)

linesの各要素のtoString()の結果をLSで連結した文字列を返す。

 
 List<String> list = Arrays.asList("あ", "い", "う");
 String str = Builder.join(list); //--> "あ\nい\nう"
 
 

パラメータ:

lines - 連結される要素文字列

戻り値:

連結後の文字列

split

public static java.util.List<java.lang.String> split(java.lang.Object string)

改行文字によって文字列を分割する。

 このメソッドの処理は以下のコードと同等である。
     split(string,  System.getProperty("line.separator"));
 

パラメータ:

string - 分割対象文字列

戻り値:

分割後文字列

split

public static java.util.List<java.lang.String> split(java.lang.Object string,
                                                     java.lang.String lineSeparator)

指定した連結文字によって文字列を分割する。

 分割対象文字列がString型でない場合はそのtoString()の結果を対象とする。
 分割対象文字列がnullであった場合は空文字列を返す。
 

パラメータ:

string - 分割対象文字列

lineSeparator - 連結文字もしくはその正規表現

戻り値:

分割後文字列

lines

public static java.lang.String lines(java.lang.Object... lines)

各引数に対するtoString()の結果を改行文字(line.separator)で連結した文字列を返す。

 引数にnullが渡された場合は単に無視される。
  (空行が出力されるわけではない。)
 

パラメータ:

lines - 各行の文字列を保持するオブジェクト

戻り値:

連結後文字列

linesf

public static java.lang.String linesf(java.lang.Object... lines)

lines()メソッドにテンプレート文字列を解釈する機能を追加したもの。

 引数文字列に"%"が含まれる場合はテンプレート文字列とみなされ、
 埋め込みパラメータ数と同数の後続引数がString.format()の仕様に従って埋め込まれる。
 この際、埋め込まれる引数に対するテンプレート文字列の評価は行わない。
 

パラメータ:

lines - 連結対象文字列

戻り値:

連結後文字列

関連項目:

lines(Object...)

list

public static <T> java.util.List<T> list(java.lang.Class<T> memberType,
                                         java.lang.Object... elements)

elementType型のインスタンスを要素とするList(ArrayList)を生成する。

 引数elementsの各要素は以下の規則に従ってelementType型、もしくはnullに変換され、
  戻り値の対応する要素に設定される。
    1. 引数の要素がnullだった場合
       戻り値の対応する要素にはnullが設定される。
    2. 引数の要素がelementTypeに適合する型のインスタンスだった場合
       戻り値の対応する要素には、そのインスタンスがそのまま設定される。
    3. 引数の要素がelementTypeに適合しないインスタンスだった場合。
       下記の条件を満たすメソッドがelementTypeに定義されていれば、
       その実行結果を戻り値の対応する要素に設定する。
       条件を満たすメソッドが存在しない場合、実行時例外を送出する。
       a. スタティックメソッド elementType.valueOf("引数の要素の型")
       b. コンストラクタ elementType("引数の要素の型")
    使用例::
        List leapDays = Builder.listf(java.sql.Date.class
        , java.sql.Date.valueOf("2004-02-29") // elementTypeのオブジェクトを設定。
        , "2008-02-29"                        // java.sql.Date.valueOf(String) の結果が格納される。
        );
 

型パラメータ:

T - 生成されるListの要素型

パラメータ:

memberType - 生成されるListの要素型

elements - 生成されるListの要素

戻り値:

elementType型のインスタンスを要素とするList

listf

public static <T> java.util.List<T> listf(java.lang.Class<T> memberType,
                                          java.lang.Object... elements)

list(Class, Object...) をprintf型の埋め込みパラメータが使用できるように拡張したもの。

    使用例::
      String leapDate = "02-29";
      List leapDays = Builder.listf(java.sql.Date.class
      , java.sql.Date.valueOf("2004-02-29") // elementTypeのオブジェクトを設定。
      , "2008-02-29"                        // java.sql.Date.valueOf(String) の結果が格納される。
      , "2012-%s", leapDate                 // 埋め込みパラメータを使用。
      );
 

型パラメータ:

T - 生成されるListの要素型

パラメータ:

memberType - 生成されるListの要素型

elements - 生成されるListの要素と埋め込みパラメータ

戻り値:

elementType型のインスタンスを要素とするList

valueOf

public static java.lang.Object valueOf(java.lang.String literal)

文字列から適切なデータ型を自動判別してオブジェクトを生成する。

パラメータ:

literal - データオブジェクトの文字列表現

戻り値:

オブジェクト

typeOf

public static java.lang.Class<?> typeOf(java.lang.String literal)

文字列から適切なデータ型を自動判別する。

パラメータ:

literal - データオブジェクトの文字列表現

戻り値:

データ型

valueOf

public static <T> T valueOf(java.lang.Class<T> type,
                            java.lang.Object value)

指定された文字列表現から、指定された型のオブジェクトを生成する。

型パラメータ:

T - 変換先の型

パラメータ:

type - 変換先の型

value - 変換対象文字列

戻り値:

変換結果