import javax.annotation.CheckForNull;

/**
 * An object that converts literal text into a format safe for inclusion in a particular context
 * (such as an XML document). Typically (but not always), the inverse process of "unescaping" the
 * text is performed automatically by the relevant parser.
 *
 * <p>For example, an XML escaper would convert the literal string {@code "Foo<Bar>"} into {@code

 * {@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;

    /**

        Element literal = document.createElement("literal");
        title.appendChild(literal);
        literal.appendChild(document.createTextNode(extension.getPluginId()));
        title.appendChild(document.createTextNode(" plugin"));

        Element titleabbrev = document.createElement("titleabbrev");
        section.appendChild(titleabbrev);
        literal = document.createElement("literal");

    /**
     * {@literal public}メソッドの場合は{@literal true}を返します。
     *
     * @return {@literal public}メソッドの場合は{@literal true}
     */
    boolean isPublic();

    /**
     * {@literal static}メソッドの場合は{@literal true}を返します。
     *
     * @return {@literal static}メソッドの場合は{@literal true}
     */
    boolean isStatic();

    /**
     * {@literal final}メソッドの場合は{@literal true}を返します。
     *

     *
     * @param in
     *            入力ファイル。{@literal null}であってはいけません
     * @param inputEncoding
     *            入力ファイルのエンコーディング。{@literal null}や空文字列であってはいけません
     * @param out
     *            出力ファイル。{@literal null}であってはいけません
     * @param outputEncoding
     *            出力ファイルのエンコーディング。{@literal null}や空文字列であってはいけません
     * @return コピーした文字数
     */

    }

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

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

     *            登録するJDBCドライバのクラス。{@literal null}であってはいけません
     */
    public static void registerDriver(final Class<Driver> driverClass) {
        assertArgumentNotNull("driverClass", driverClass);
        registerDriver(ClassUtil.newInstance(driverClass));
    }

    /**
     * JDBCドライバを登録します。
     *
     * @param driver
     *            登録するJDBCドライバ。{@literal null}であってはいけません
     */

import org.hamcrest.Matcher;

/**
 * @author koichik
 */
public abstract class TestUtil {

    /**
     * 実際の値が期待する{@literal clazz}と等しいかを検証する{@link Matcher}を返します。
     *
     * <pre>assertThat(clazz, is(Xxx.class));</pre>
     * <p>
     * と書くと{@link CoreMatchers#is(Class)}が適用されて{@literal clazz}が {@literal Xxx}
     * のインスタンスかを検証されてしまうのでこれが必要。
     *
     * @param clazz
     *            期待するクラス

     * </p>
     *
     * @param jarFile
     *            Jarファイル。{@literal null}であってはいけません
     * @param prefix
     *            トラバースするリソースの名前が含む接頭辞。{@literal null}であってはいけません。
     *            空文字列でない場合はスラッシュ('/')で終了していなければなりません
     * @param handler
     *            クラスを処理するハンドラ。{@literal null}であってはいけません
     */

        }
        buf.append(")");
        return buf.toString();
    }

    /**
     * {@literal equals(Object)}メソッドかどうかを返します。
     *
     * @param method
     *            メソッド。{@literal null}であってはいけません
     * @return {@literal equals(Object)}メソッドなら{@literal true}
     */
    public static boolean isEqualsMethod(final Method method) {
        assertArgumentNotNull("method", method);