Spec-Zone .ru
спецификации, руководства, описания, API
Please note that the specifications and other information contained herein are not final and are subject to change. The information is being made available to you solely for purpose of evaluation.

Java™ Platform
Standard Ed. 7

DRAFT ea-b118

java.lang
Class AssertionError

java.lang.Object
  extended by java.lang.Throwable
      extended by java.lang.Error
          extended by java.lang.AssertionError
All Implemented Interfaces:
Serializable

public class AssertionError
extends Error

Thrown to indicate that an assertion has failed.

The seven one-argument public constructors provided by this class ensure that the assertion error returned by the invocation:

     new AssertionError(expression)
 
has as its detail message the string conversion of expression (as defined in The Java Language Specification, Second Edition, Section 15.18.1.1), regardless of the type of expression.

Since:
1.4
See Also:
Serialized Form

Constructor Summary
Constructor and Description
AssertionError()
          Constructs an AssertionError with no detail message.
AssertionError(boolean detailMessage)
          Constructs an AssertionError with its detail message derived from the specified boolean, which is converted to a string as defined in The Java Language Specification, Second Edition, Section 15.18.1.1.
AssertionError(char detailMessage)
          Constructs an AssertionError with its detail message derived from the specified char, which is converted to a string as defined in The Java Language Specification, Second Edition, Section 15.18.1.1.
AssertionError(double detailMessage)
          Constructs an AssertionError with its detail message derived from the specified double, which is converted to a string as defined in The Java Language Specification, Second Edition, Section 15.18.1.1.
AssertionError(float detailMessage)
          Constructs an AssertionError with its detail message derived from the specified float, which is converted to a string as defined in The Java Language Specification, Second Edition, Section 15.18.1.1.
AssertionError(int detailMessage)
          Constructs an AssertionError with its detail message derived from the specified int, which is converted to a string as defined in The Java Language Specification, Second Edition, Section 15.18.1.1.
AssertionError(long detailMessage)
          Constructs an AssertionError with its detail message derived from the specified long, which is converted to a string as defined in The Java Language Specification, Second Edition, Section 15.18.1.1.
AssertionError(Object detailMessage)
          Constructs an AssertionError with its detail message derived from the specified object, which is converted to a string as defined in The Java Language Specification, Second Edition, Section 15.18.1.1.
AssertionError(String message, Throwable cause)
          Constructs a new AssertionError with the specified detail message and cause.
 
Method Summary
Modifier and Type Method and Description
 
Methods inherited from class java.lang.Throwable
addSuppressedException, fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, getSuppressedExceptions, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Constructor Detail

AssertionError

public AssertionError()
Constructs an AssertionError with no detail message.


AssertionError

public AssertionError(Object detailMessage)
Constructs an AssertionError with its detail message derived from the specified object, which is converted to a string as defined in The Java Language Specification, Second Edition, Section 15.18.1.1.

If the specified object is an instance of Throwable, it becomes the cause of the newly constructed assertion error.

Parameters:
detailMessage - value to be used in constructing detail message
See Also:
Throwable.getCause()

AssertionError

public AssertionError(boolean detailMessage)
Constructs an AssertionError with its detail message derived from the specified boolean, which is converted to a string as defined in The Java Language Specification, Second Edition, Section 15.18.1.1.

Parameters:
detailMessage - value to be used in constructing detail message

AssertionError

public AssertionError(char detailMessage)
Constructs an AssertionError with its detail message derived from the specified char, which is converted to a string as defined in The Java Language Specification, Second Edition, Section 15.18.1.1.

Parameters:
detailMessage - value to be used in constructing detail message

AssertionError

public AssertionError(int detailMessage)
Constructs an AssertionError with its detail message derived from the specified int, which is converted to a string as defined in The Java Language Specification, Second Edition, Section 15.18.1.1.

Parameters:
detailMessage - value to be used in constructing detail message

AssertionError

public AssertionError(long detailMessage)
Constructs an AssertionError with its detail message derived from the specified long, which is converted to a string as defined in The Java Language Specification, Second Edition, Section 15.18.1.1.

Parameters:
detailMessage - value to be used in constructing detail message

AssertionError

public AssertionError(float detailMessage)
Constructs an AssertionError with its detail message derived from the specified float, which is converted to a string as defined in The Java Language Specification, Second Edition, Section 15.18.1.1.

Parameters:
detailMessage - value to be used in constructing detail message

AssertionError

public AssertionError(double detailMessage)
Constructs an AssertionError with its detail message derived from the specified double, which is converted to a string as defined in The Java Language Specification, Second Edition, Section 15.18.1.1.

Parameters:
detailMessage - value to be used in constructing detail message

AssertionError

public AssertionError(String message,
                      Throwable cause)
Constructs a new AssertionError with the specified detail message and cause.

Note that the detail message associated with cause is not automatically incorporated in this error's detail message.

Parameters:
message - the detail message, may be null
cause - the cause, may be null
Since:
1.7

Java™ Platform
Standard Ed. 7

DRAFT ea-b118

Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.

Copyright © 1993, 2010, Oracle Corporation. All rights reserved.
DRAFT ea-b118

Scripting on this page tracks web page traffic, but does not change the content in any way.