import org.jspecify.annotations.Nullable;

/**
 * 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

     * <th>JavaBeans Property Name</th>
     * <th>{@literal Map} Property Name</th>
     * </tr>
     * <tr>
     * <td>{@literal foo}</td>
     * <td>{@literal foo}</td>
     * </tr>
     * <tr>
     * <td>{@literal foo_bar}</td>
     * <td>{@literal foo.bar}</td>
     * </tr>
     * <tr>
     * <td>{@literal foo_bar_baz}</td>
     * <td>{@literal foo.bar.baz}</td>
     * </tr>
     * </table>
     *

    }

    /**
     * Converts the given object to a {@literal long}.
     *
     * @param o
     *            the object to convert
     * @return the converted {@literal long}
     */
    public static long toPrimitiveLong(final Object o) {
        return toPrimitiveLong(o, null);
    }

    /**
     * Converts the given object to a {@literal long}.
     *
     * @param o
     *            the object to convert

    }

    /**
     * Copies the source {@literal Map} to a new instance of a {@literal Map} and returns it.
     *
     * @param <T> The type of the destination {@literal Map}.
     * @param src The source {@literal Map}. Must not be {@literal null}.
     * @param destClass The type of the destination {@literal Map}. Must not be {@literal null}.
     * @return The newly copied {@literal Map}.
     */

     */
    Class<?>[] getParameterTypes();

    /**
     * Returns {@literal true} if the constructor is {@literal public}.
     *
     * @return {@literal true} if the constructor is {@literal public}
     */
    boolean isPublic();

    /**
     * Returns {@literal true} if the parameter type of the constructor is parameterized.
     *
     * @param index

        }
    }

    /**
     * Transfers the contents of the file channel {@literal from} to {@literal to}.
     *
     * @param from
     *            The source file channel. Must not be {@literal null}.
     * @param to
     *            The destination file channel. Must not be {@literal null}.
     * @return The number of bytes transferred.
     */

    }

    /**
     * Retrieves the XML content as an {@link InputStream} with the specified encoding.
     *
     * @param contents
     *            The content. Must not be {@literal null}.
     * @param encoding
     *            The encoding. If {@literal null}, the platform's default encoding will be used.
     * @return {@link InputStream}
     */

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
     *            期待するクラス

     *
     * @param path
     *            The resource path. Must not be {@literal null} or empty string.
     * @param extension
     *            The resource extension.
     * @param loader
     *            The class loader to search for the resource. Must not be {@literal null}.
     * @return The resource {@link URL}
     * @see #getResourcePath(String, String)
     */

     *
     * @return {@literal true} if the method is {@literal final}
     */
    boolean isFinal();

    /**
     * Returns {@literal true} if the method is {@literal abstract}.
     *
     * @return {@literal true} if the method is {@literal abstract}
     */
    boolean isAbstract();

    /**