org.junit.contrib.java.lang.system
Class EnvironmentVariables

java.lang.Object
  org.junit.contrib.java.lang.system.EnvironmentVariables

All Implemented Interfaces:

org.junit.rules.TestRule

public class EnvironmentVariables
extends Object
implements org.junit.rules.TestRule

The EnvironmentVariables rule allows you to set environment variables within your test. All changes to environment variables are reverted after the test.

 public class EnvironmentVariablesTest {
   @Rule
   public final EnvironmentVariables environmentVariables = new EnvironmentVariables();

   @Test
   public void test() {
     environmentVariables.set("name", "value");
     assertEquals("value", System.getenv("name"));
   }
 }
 

Warning: This rule uses reflection for modifying internals of the environment variables map. It fails if your SecurityManager forbids such modifications.

Constructor Summary

EnvironmentVariables()

Method Summary

org.junit.runners.model.Statement	apply(org.junit.runners.model.Statement base, org.junit.runner.Description description)
void	set(String name, String value) Set the value of an environment variable.

Methods inherited from class java.lang.Object

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

Constructor Detail

EnvironmentVariables

public EnvironmentVariables()

Method Detail

set

public void set(String name,
                String value)

Set the value of an environment variable. You can delete an environment variable by setting it to null.

Parameters:

name - the environment variable's name.

value - the environment variable's new value.

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