# ExpectFailureTask (ant-antunit API)
declaration: package: org.apache.ant.antunit, class: ExpectFailureTask

# Klasse ExpectFailureTask

java.lang.Object
org.apache.tools.ant.ProjectComponent
org.apache.tools.ant.Task
org.apache.tools.ant.taskdefs.Sequential
org.apache.ant.antunit.ExpectFailureTask

Alle implementierten Schnittstellen:
  `Cloneable, org.apache.tools.ant.TaskContainer`

public class ExpectFailureTask extends org.apache.tools.ant.taskdefs.Sequential
Expects the nested tasks to throw a BuildException and optinally asserts the message of that exception.

Throws a AssertFailedException if the nested tasks do not throw the expected BuildException.

## Feldübersicht

### Von Klasse geerbte Felder org.apache.tools.ant.Task

`target, taskName, taskType, wrapper`

### Von Klasse geerbte Felder org.apache.tools.ant.ProjectComponent

`description, location, project`

## Konstruktorübersicht

Konstruktoren
Konstruktor
Beschreibung
`ExpectFailureTask()`

## Methodenübersicht

Modifikator und Typ
Methode
Beschreibung
`void`
`execute()`
`void`
`setExpectedMessage(String m)`
The exception message to expect.
`void`
`setMessage(String m)`
The message to use in the AssertionFailedException if the nested tasks fail to raise the "correct" exception.

### Von Klasse geerbte Methoden org.apache.tools.ant.taskdefs.Sequential

`addTask`

### Von Klasse geerbte Methoden org.apache.tools.ant.Task

`bindToOwner, getOwningTarget, getRuntimeConfigurableWrapper, getTaskName, getTaskType, getWrapper, handleErrorFlush, handleErrorOutput, handleFlush, handleInput, handleOutput, init, isInvalid, log, log, log, log, maybeConfigure, perform, reconfigure, setOwningTarget, setRuntimeConfigurableWrapper, setTaskName, setTaskType`

### Von Klasse geerbte Methoden org.apache.tools.ant.ProjectComponent

`clone, getDescription, getLocation, getProject, setDescription, setLocation, setProject`

### Von Klasse geerbte Methoden Object

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

## Konstruktordetails

### ExpectFailureTask

public ExpectFailureTask()

## Methodendetails

### setExpectedMessage

public void setExpectedMessage(String m)
The exception message to expect.

Parameter:
  `m` - the exception message to expect

### setMessage

public void setMessage(String m)
The message to use in the AssertionFailedException if the nested tasks fail to raise the "correct" exception.

Parameter:
  `m` - message to use in the AssertionFailedException

### execute

public void execute()

Setzt außer Kraft:
  `execute` in Klasse `org.apache.tools.ant.taskdefs.Sequential`