X-Git-Url: http://git.phpeclipse.com diff --git a/net.sourceforge.phpeclipse/src/net/sourceforge/phpdt/internal/core/Assert.java b/net.sourceforge.phpeclipse/src/net/sourceforge/phpdt/internal/core/Assert.java index 894ca7e..5cb5cd6 100644 --- a/net.sourceforge.phpeclipse/src/net/sourceforge/phpdt/internal/core/Assert.java +++ b/net.sourceforge.phpeclipse/src/net/sourceforge/phpdt/internal/core/Assert.java @@ -13,82 +13,107 @@ package net.sourceforge.phpdt.internal.core; /* This class is not intended to be instantiated. */ public final class Assert { -private Assert() { - // cannot be instantiated -} -/** Asserts that an argument is legal. If the given boolean is - * not true, an IllegalArgumentException - * is thrown. - * - * @param expression the outcode of the check - * @return true if the check passes (does not return - * if the check fails) - * @exception IllegalArgumentException if the legality test failed - */ -public static boolean isLegal(boolean expression) { - return isLegal(expression, ""); //$NON-NLS-1$ -} -/** Asserts that an argument is legal. If the given boolean is - * not true, an IllegalArgumentException - * is thrown. - * The given message is included in that exception, to aid debugging. - * - * @param expression the outcode of the check - * @param message the message to include in the exception - * @return true if the check passes (does not return - * if the check fails) - * @exception IllegalArgumentException if the legality test failed - */ -public static boolean isLegal(boolean expression, String message) { - if (!expression) - throw new IllegalArgumentException(message); - return expression; -} -/** Asserts that the given object is not null. If this - * is not the case, some kind of unchecked exception is thrown. - * - * @param object the value to test - * @exception IllegalArgumentException if the object is null - */ -public static void isNotNull(Object object) { - isNotNull(object, ""); //$NON-NLS-1$ -} -/** Asserts that the given object is not null. If this - * is not the case, some kind of unchecked exception is thrown. - * The given message is included in that exception, to aid debugging. - * - * @param object the value to test - * @param message the message to include in the exception - * @exception IllegalArgumentException if the object is null - */ -public static void isNotNull(Object object, String message) { - if (object == null) - throw new AssertionFailedException("null argument; " + message); //$NON-NLS-1$ -} -/** Asserts that the given boolean is true. If this - * is not the case, some kind of unchecked exception is thrown. - * - * @param expression the outcode of the check - * @return true if the check passes (does not return - * if the check fails) - */ -public static boolean isTrue(boolean expression) { - return isTrue(expression, ""); //$NON-NLS-1$ -} -/** Asserts that the given boolean is true. If this - * is not the case, some kind of unchecked exception is thrown. - * The given message is included in that exception, to aid debugging. - * - * @param expression the outcode of the check - * @param message the message to include in the exception - * @return true if the check passes (does not return - * if the check fails) - */ -public static boolean isTrue(boolean expression, String message) { - if (!expression) - throw new AssertionFailedException("Assertion failed; " + message); //$NON-NLS-1$ - return expression; -} + private Assert() { + // cannot be instantiated + } + + /** + * Asserts that an argument is legal. If the given boolean is not + * true, an IllegalArgumentException is + * thrown. + * + * @param expression + * the outcode of the check + * @return true if the check passes (does not return if the + * check fails) + * @exception IllegalArgumentException + * if the legality test failed + */ + public static boolean isLegal(boolean expression) { + return isLegal(expression, ""); //$NON-NLS-1$ + } + + /** + * Asserts that an argument is legal. If the given boolean is not + * true, an IllegalArgumentException is + * thrown. The given message is included in that exception, to aid + * debugging. + * + * @param expression + * the outcode of the check + * @param message + * the message to include in the exception + * @return true if the check passes (does not return if the + * check fails) + * @exception IllegalArgumentException + * if the legality test failed + */ + public static boolean isLegal(boolean expression, String message) { + if (!expression) + throw new IllegalArgumentException(message); + return expression; + } + + /** + * Asserts that the given object is not null. If this is not + * the case, some kind of unchecked exception is thrown. + * + * @param object + * the value to test + * @exception IllegalArgumentException + * if the object is null + */ + public static void isNotNull(Object object) { + isNotNull(object, ""); //$NON-NLS-1$ + } + + /** + * Asserts that the given object is not null. If this is not + * the case, some kind of unchecked exception is thrown. The given message + * is included in that exception, to aid debugging. + * + * @param object + * the value to test + * @param message + * the message to include in the exception + * @exception IllegalArgumentException + * if the object is null + */ + public static void isNotNull(Object object, String message) { + if (object == null) + throw new AssertionFailedException("null argument; " + message); //$NON-NLS-1$ + } + + /** + * Asserts that the given boolean is true. If this is not + * the case, some kind of unchecked exception is thrown. + * + * @param expression + * the outcode of the check + * @return true if the check passes (does not return if the + * check fails) + */ + public static boolean isTrue(boolean expression) { + return isTrue(expression, ""); //$NON-NLS-1$ + } + + /** + * Asserts that the given boolean is true. If this is not + * the case, some kind of unchecked exception is thrown. The given message + * is included in that exception, to aid debugging. + * + * @param expression + * the outcode of the check + * @param message + * the message to include in the exception + * @return true if the check passes (does not return if the + * check fails) + */ + public static boolean isTrue(boolean expression, String message) { + if (!expression) + throw new AssertionFailedException("Assertion failed; " + message); //$NON-NLS-1$ + return expression; + } public static class AssertionFailedException extends RuntimeException { public AssertionFailedException(String detail) {