* <p>
 * 本クラスをstatic importすることにより、次のように{@literal Map}のインスタンスを簡潔に初期化することができます。
 * </p>
 *
 * <pre>
 * import static org.codelibs.core.collection.Maps.*;
 *
 * Map&lt;String, Integer&gt; map = map("a", 1).$("b", 2).$("c", 3).$();
 * </pre>
 *
 * @author koichik
 * @param <K>
 *            {@literal Map}のキーの型
 * @param <V>
 *            {@literal Map}の値の型
 */
public class Maps<K, V> {

     *            文字列を読み込む{@link Reader}。{@literal null}であってはいけません
     */
    public LineIterator(final Reader reader) {
        assertArgumentNotNull("reader", reader);
        this.reader = new BufferedReader(reader);
    }

    /**
     * インスタンスを構築します。
     *
     * @param reader
     *            文字列を読み込む{@link BufferedReader}。{@literal null}であってはいけません
     */
    public LineIterator(final BufferedReader reader) {

public abstract class InputStreamUtil {

    /** デフォルトのバッファサイズ */
    private static final int BUF_SIZE = 4096;

    /**
     * {@link FileInputStream}を作成します。
     *
     * @param file
     *            ファイル。{@literal null}であってはいけません
     * @return ファイルから入力する{@link FileInputStream}
     * @see FileInputStream#FileInputStream(File)
     */
    public static FileInputStream create(final File file) {

        return Integer.valueOf(DecimalFormatUtil.normalize(s));
    }

    /**
     * {@literal int}に変換します。
     *
     * @param o
     *            変換元のオブジェクト
     * @return 変換された{@literal int}
     */
    public static int toPrimitiveInt(final Object o) {
        return toPrimitiveInt(o, null);
    }

    /**
     * {@literal int}に変換します。
     *
     * @param o
     *            変換元のオブジェクト
     * @param pattern

     *
     * @param method
     *            メソッド。{@literal null}であってはいけません
     * @return パブリックかどうか
     */
    public static boolean isPublic(final Method method) {
        assertArgumentNotNull("method", method);

        return isPublic(method.getModifiers());
    }

    /**
     * <code>public</code>かどうか返します。
     *
     * @param field
     *            フィールド。{@literal null}であってはいけません
     * @return パブリックかどうか
     */

    }

    /**
     * フィールドの型を表現する{@link ParameterizedClassDesc}を作成して返します。
     *
     * @param field
     *            フィールド。{@literal null}であってはいけません
     * @param map
     *            パラメータ化された型が持つ型変数をキー、型引数を値とする{@link Map}。{@literal null}
     *            であってはいけません
     * @return フィールドの型を表現する{@link ParameterizedClassDesc}
     */

        return convertMap(bundle);
    }

    /**
     * {@literal locale}が{@literal null}でなければ{@literal locale}を、{@literal null}
     * ならデフォルトのロケールを返します。
     *
     * @param locale
     *            ロケール
     * @return {@literal locale}が{@literal null}でなければ{@literal locale}を、
     *         {@literal null}ならデフォルトのロケールを返します。
     */
    protected static Locale getLocale(final Locale locale) {

     * を使用してXMLとして構文解析します。
     *
     * @param parser
     *            使用する{@link SAXParser}。{@literal null}であってはいけません
     * @param inputSource
     *            構文解析されるコンテンツを含む{@link InputSource}。{@literal null}であってはいけません
     * @param handler
     *            使用するSAX {@link DefaultHandler}。{@literal null}であってはいけません
     */

        return Byte.valueOf(DecimalFormatUtil.normalize(s));
    }

    /**
     * {@literal byte}に変換します。
     *
     * @param o
     *            変換元のオブジェクト
     * @return 変換された{@literal byte}
     */
    public static byte toPrimitiveByte(final Object o) {
        return toPrimitiveByte(o, null);
    }

    /**
     * {@literal byte}に変換します。
     *
     * @param o
     *            変換元のオブジェクト
     * @param pattern

 * {@link #iterable(Class, boolean)}または{@link #ClassIterator(Class, boolean)}
 * の第2引数に{@literal false}を指定します。
 * </p>
 *
 * @author koichik
 */
public class ClassIterator implements Iterator<Class<?>> {

    /** クラス */
    protected Class<?> clazz;

    /** {@link Object}クラスも反復する場合は {@literal true} */
    protected final boolean includeObject;

    /**