com.google.java.contract

Annotation Type ThrowEnsures

@Documented
@Target(value={METHOD,CONSTRUCTOR})
@Retention(value=RUNTIME)
public @interface ThrowEnsures

Specifies exceptional postconditions that apply to the annotated method. Exceptional postconditions apply whenever the annotated method exits by throwing an exception, in contrast to normal postconditions that apply when the method exits normally. The annotated method must establish its postconditions if and only if the preconditions were satisfied.

When run time checking of contracts is enabled, exceptional postconditions are checked at method exit, when the method exits by throwing an exception, and throw a PostconditionError when they are violated.

See Also:

Ensures

Required Element Summary

Required Elements

Modifier and Type	Required Element and Description
java.lang.String[]	value The alternating list of signal--postcondition pairs that must be met on throw.

Element Detail

value

public abstract java.lang.String[] value

The alternating list of signal--postcondition pairs that must be met on throw. The expressions must be valid Java code and can reference all things visible to the class, as well as the method's arguments. Since exceptional postconditions may need to refer to the old value of an expression and the exception object thrown by the annotated method, the following extensions are allowed:

The signal keyword refers to the object thrown by the method, and has for static type Throwable.

The old() construct has the same syntax and semantics as in normal postconditions.

See Also:

Ensures.value()