Overview | Package | Class | Tree | Deprecated | Index | Help
PREV CLASS NEXT CLASS | FRAMES NO FRAMES
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD

## org.apache.tools.ant.taskdefs.optional.junit
Class FormatterElement

    java.lang.Object
      |
      +--org.apache.tools.ant.taskdefs.optional.junit.FormatterElement

public class FormatterElement
extends java.lang.Object

A wrapper for the implementations of `JUnitResultFormatter`. In particular, used as a nested `<formatter>` element in a `<junit>` task.

For example, ``

           <junit printsummary="no" haltonfailure="yes" fork="false">
               <formatter type="plain" usefile="false" />
               <test name="org.apache.ecs.InternationalCharTest" />
           </junit>

adds a `plain` type implementation (`PlainJUnitResultFormatter`) to display the results of the test.

Either the `type` or the `classname` attribute must be set.

See Also:
  `JUnitTask`, `XMLJUnitResultFormatter`, `BriefJUnitResultFormatter`, `PlainJUnitResultFormatter`, `JUnitResultFormatter`

Nested Class Summary
`static class` | `FormatterElement.TypeAttribute` Enumerated attribute with the values "plain", "xml" and "brief".

Field Summary
`static java.lang.String` | `BRIEF_FORMATTER_CLASS_NAME`
`static java.lang.String` | `PLAIN_FORMATTER_CLASS_NAME`
`static java.lang.String` | `XML_FORMATTER_CLASS_NAME`

Constructor Summary
`FormatterElement()`

Method Summary
`java.lang.String` | `getClassname()` Get name of class to be used as the formatter.
`java.lang.String` | `getExtension()`
`void` | `setClassname(java.lang.String classname)` Set name of class to be used as the formatter.
`void` | `setExtension(java.lang.String ext)`
`void` | `setIf(java.lang.String ifProperty)` Set whether this formatter should be used.
`void` | `setOutput(java.io.OutputStream out)` Set output stream for formatter to use.
`void` | `setType(FormatterElement.TypeAttribute type)` Quick way to use a standard formatter.
`void` | `setUnless(java.lang.String unlessProperty)` Set whether this formatter should NOT be used.
`void` | `setUseFile(boolean useFile)` Set whether the formatter should log to file.
`boolean` | `shouldUse(Task t)` Ensures that the selector passes the conditions placed on it with `if` and `unless` properties.

Methods inherited from class java.lang.Object
`clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait`

Field Detail

### XML_FORMATTER_CLASS_NAME

    public static final java.lang.String XML_FORMATTER_CLASS_NAME

See Also:
  Constant Field Values

### BRIEF_FORMATTER_CLASS_NAME

    public static final java.lang.String BRIEF_FORMATTER_CLASS_NAME

See Also:
  Constant Field Values

### PLAIN_FORMATTER_CLASS_NAME

    public static final java.lang.String PLAIN_FORMATTER_CLASS_NAME

See Also:
  Constant Field Values

Constructor Detail

### FormatterElement

    public FormatterElement()

Method Detail

### setType

    public void setType(FormatterElement.TypeAttribute type)

  Quick way to use a standard formatter.

  At the moment, there are three supported standard formatters.

  - The `xml` type uses a `XMLJUnitResultFormatter`.
  - The `brief` type uses a `BriefJUnitResultFormatter`.
  - The `plain` type (the default) uses a `PlainJUnitResultFormatter`.

  Sets `classname` attribute - so you can't use that attribute if you use this one.

### setClassname

    public void setClassname(java.lang.String classname)

  Set name of class to be used as the formatter.

  This class must implement `JUnitResultFormatter`

### getClassname

    public java.lang.String getClassname()

  Get name of class to be used as the formatter.

### setExtension

    public void setExtension(java.lang.String ext)

### getExtension

    public java.lang.String getExtension()

### setOutput

    public void setOutput(java.io.OutputStream out)

  Set output stream for formatter to use.

  Defaults to standard out.

### setUseFile

    public void setUseFile(boolean useFile)

  Set whether the formatter should log to file.

### setIf

    public void setIf(java.lang.String ifProperty)

  Set whether this formatter should be used. It will be used if the property has been set, otherwise it won't.

  Parameters:
    `ifProperty` - name of property

### setUnless

    public void setUnless(java.lang.String unlessProperty)

  Set whether this formatter should NOT be used. It will not be used if the property has been set, orthwise it will be used.

  Parameters:
    `unlessProperty` - name of property

### shouldUse

    public boolean shouldUse(Task t)

  Ensures that the selector passes the conditions placed on it with `if` and `unless` properties.

Overview | Package | Class | Tree | Deprecated | Index | Help
PREV CLASS NEXT CLASS | FRAMES NO FRAMES
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD

Copyright © 2000-2005 Apache Software Foundation. All Rights Reserved.