org.apache.flink.core.testutils

Class CommonTestUtils

java.lang.Object

org.apache.flink.core.testutils.CommonTestUtils

public class CommonTestUtils
extends Object

This class contains reusable utility methods for unit tests.

Constructor Summary

Constructors

Constructor and Description
CommonTestUtils()

Method Summary

Modifier and Type	Method and Description
static void	assumeJava8() Checks whether this code runs in a Java 8 (Java 1.8) JVM.
static void	blockForeverNonInterruptibly() Permanently blocks the current thread.
static boolean	containsCause(Throwable throwable, Class<? extends Throwable> cause) Checks whether the given throwable contains the given cause as a cause.
static Class<? extends Serializable>	createClassNotInClassPath(ClassLoader targetClassLoader) Creates a new class that is not part of the classpath that the current JVM uses.
static <T extends Serializable> T	createCopySerializable(T original) Creates a copy of an object via Java Serialization.
static Serializable	createObjectForClassNotInClassPath(ClassLoader targetClassLoader) Creates a new class that is not part of the classpath that the current JVM uses, and instantiates it.
static String	createTempFile(String contents) Creates a temporary file that contains the given string.
static String	getTempDir() Reads the path to the directory for temporary files from the configuration and returns it.
static void	setEnv(Map<String,String> newenv)
static void	setEnv(Map<String,String> newenv, boolean clearExisting)

Methods inherited from class java.lang.Object

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

Constructor Detail

CommonTestUtils

public CommonTestUtils()

Method Detail

getTempDir

public static String getTempDir()

Reads the path to the directory for temporary files from the configuration and returns it.

Returns:

the path to the directory for temporary files

createCopySerializable

public static <T extends Serializable> T createCopySerializable(T original)
                                                         throws IOException

Creates a copy of an object via Java Serialization.

Parameters:

original - The original object.

Returns:

The copied object.

Throws:

IOException

createTempFile

public static String createTempFile(String contents)
                             throws IOException

Creates a temporary file that contains the given string. The file is written with the platform's default encoding.

The temp file is automatically deleted on JVM exit.

Parameters:

contents - The contents to be written to the file.

Returns:

The temp file URI.

Throws:

IOException

blockForeverNonInterruptibly

public static void blockForeverNonInterruptibly()

Permanently blocks the current thread. The thread cannot be woken up via Thread.interrupt().

assumeJava8

public static void assumeJava8()

Checks whether this code runs in a Java 8 (Java 1.8) JVM. If not, this throws a AssumptionViolatedException, which causes JUnit to skip the test that called this method.

setEnv

public static void setEnv(Map<String,String> newenv)

setEnv

public static void setEnv(Map<String,String> newenv,
                          boolean clearExisting)

createObjectForClassNotInClassPath

public static Serializable createObjectForClassNotInClassPath(ClassLoader targetClassLoader)

Creates a new class that is not part of the classpath that the current JVM uses, and instantiates it.

This method uses createClassNotInClassPath(ClassLoader) to define the new class.

Parameters:

targetClassLoader - The class loader to attach the class to

Returns:

The object instantiated from the newly defined class.

createClassNotInClassPath

public static Class<? extends Serializable> createClassNotInClassPath(ClassLoader targetClassLoader)

Creates a new class that is not part of the classpath that the current JVM uses. The class is ad-hoc defined and attached to the given ClassLoader.

Parameters:

targetClassLoader - The class loader to attach the class to

Returns:

The newly defined class

containsCause

public static boolean containsCause(Throwable throwable,
                                    Class<? extends Throwable> cause)

Checks whether the given throwable contains the given cause as a cause. The cause is not checked on equality but on type equality.

Parameters:

throwable - Throwable to check for the cause

cause - Cause to look for

Returns:

True if the given Throwable contains the given cause (type equality); otherwise false