Overview  Package   Class  Use  Deprecated  Index
Home >> All >> org >> eclipse >> jface >> [ util overview ]	PREV CLASS  NEXT CLASS
SUMMARY:  JAVADOC |  SOURCE |  DOWNLOAD | NESTED | FIELD | CONSTR | METHOD	DETAIL: FIELD | CONSTR | METHOD

---

org.eclipse.jface.util
Class Assert  

java.lang.Object
  org.eclipse.jface.util.Assert

---

public final class Assert

extends java.lang.Object

Assert is useful for for embedding runtime sanity checks in code. The static predicate methods all test a condition and throw some type of unchecked exception if the condition does not hold.

Assertion failure exceptions, like most runtime exceptions, are thrown when something is misbehaving. Assertion failures are invariably unspecified behavior; consequently, clients should never rely on these being thrown (or not thrown). If you find yourself in the position where you need to catch an assertion failure, you have most certainly written your program incorrectly.

Note that an assert statement is slated to be added to the Java language in JDK 1.4, rending this class obsolete.

---

Nested Class Summary
private static class	Assert.AssertionFailedException           AssertionFailedException is a runtime exception thrown by some of the methods in Assert.

 

Constructor Summary
private	Assert()

 

Method Summary
static boolean	isLegal(boolean expression)           Asserts that an argument is legal.
static boolean	isLegal(boolean expression, java.lang.String message)           Asserts that an argument is legal.
static void	isNotNull(java.lang.Object object)           Asserts that the given object is not null.
static void	isNotNull(java.lang.Object object, java.lang.String message)           Asserts that the given object is not null.
static boolean	isTrue(boolean expression)           Asserts that the given boolean is true.
static boolean	isTrue(boolean expression, java.lang.String message)           Asserts that the given boolean is true.

 

Methods inherited from class java.lang.Object

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

 

Constructor Detail

Assert

private Assert()

Method Detail

isLegal

public static boolean isLegal(boolean expression)

Asserts that an argument is legal. If the given boolean is not true, an IllegalArgumentException is thrown.

---

isLegal

public static boolean isLegal(boolean expression,
                              java.lang.String message)

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.

---

isNotNull

public static void isNotNull(java.lang.Object object)

Asserts that the given object is not null. If this is not the case, some kind of unchecked exception is thrown.

As a general rule, parameters passed to API methods must not be null unless explicitly allowed in the method's specification. Similarly, results returned from API methods are never null unless explicitly allowed in the method's specification. Implementations are encouraged to make regular use of Assert.isNotNull to ensure that null parameters are detected as early as possible.

---

isNotNull

public static void isNotNull(java.lang.Object object,
                             java.lang.String message)

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.

As a general rule, parameters passed to API methods must not be null unless explicitly allowed in the method's specification. Similarly, results returned from API methods are never null unless explicitly allowed in the method's specification. Implementations are encouraged to make regular use of Assert.isNotNull to ensure that null parameters are detected as early as possible.

---

isTrue

public static boolean isTrue(boolean expression)

Asserts that the given boolean is true. If this is not the case, some kind of unchecked exception is thrown.

---

isTrue

public static boolean isTrue(boolean expression,
                             java.lang.String message)

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.

---

Overview  Package   Class  Use  Deprecated  Index
Home >> All >> org >> eclipse >> jface >> [ util overview ]	PREV CLASS  NEXT CLASS
SUMMARY:  JAVADOC |  SOURCE |  DOWNLOAD | NESTED | FIELD | CONSTR | METHOD	DETAIL: FIELD | CONSTR | METHOD

---