org.springframework.boot.test.system

Class OutputCaptureRule

java.lang.Object

org.springframework.boot.test.system.OutputCaptureRule

All Implemented Interfaces:

java.lang.CharSequence, org.junit.rules.TestRule, CapturedOutput

public class OutputCaptureRule
extends java.lang.Object
implements org.junit.rules.TestRule, CapturedOutput

JUnit @Rule to capture output from System.out and System.err.

To use add as a @Rule:

 public class MyTest {

     @Rule
     public OutputCaptureRule output = new OutputCaptureRule();

     @Test
     public void test() {
         assertThat(output).contains("ok");
     }

 }
 

Since:

2.2.0

Constructor Summary

Constructors

Constructor and Description
OutputCaptureRule()

Method Summary

Modifier and Type	Method and Description
org.junit.runners.model.Statement	apply(org.junit.runners.model.Statement base, org.junit.runner.Description description)
void	expect(org.hamcrest.Matcher<? super java.lang.String> matcher) Verify that the output is matched by the supplied matcher.
java.lang.String	getAll() Return all content (both System.out and System.err) in the order that it was captured.
java.lang.String	getErr() Return System.err content in the order that it was captured.
java.lang.String	getOut() Return System.out content in the order that it was captured.
java.lang.String	toString()

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.springframework.boot.test.system.CapturedOutput

charAt, length, subSequence

Methods inherited from interface java.lang.CharSequence

chars, codePoints

Constructor Detail

OutputCaptureRule

public OutputCaptureRule()

Method Detail

apply

public org.junit.runners.model.Statement apply(org.junit.runners.model.Statement base,
                                               org.junit.runner.Description description)

Specified by:

apply in interface org.junit.rules.TestRule

getAll

public java.lang.String getAll()

Description copied from interface: CapturedOutput

Return all content (both System.out and System.err) in the order that it was captured.

Specified by:

getAll in interface CapturedOutput

Returns:

all captured output

getOut

public java.lang.String getOut()

Description copied from interface: CapturedOutput

Return System.out content in the order that it was captured.

Specified by:

getOut in interface CapturedOutput

Returns:

System.out captured output

getErr

public java.lang.String getErr()

Description copied from interface: CapturedOutput

Return System.err content in the order that it was captured.

Specified by:

getErr in interface CapturedOutput

Returns:

System.err captured output

toString

public java.lang.String toString()

Specified by:

toString in interface java.lang.CharSequence

Overrides:

toString in class java.lang.Object

expect

public void expect(org.hamcrest.Matcher<? super java.lang.String> matcher)

Verify that the output is matched by the supplied matcher. Verification is performed after the test method has executed.

Parameters:

matcher - the matcher