to.etc.webapp.testsupport

Class TUtilTestProperties

java.lang.Object

to.etc.webapp.testsupport.TUtilTestProperties

public class TUtilTestProperties
extends Object

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	TUtilTestProperties.DbConnectionInfo

Constructor Summary

Constructors

Constructor and Description
TUtilTestProperties()

Method Summary

Modifier and Type	Method and Description
static void	assumeDatabase() Callable from JUnit fixures, this will "ignore" a JUnit tests when the database is unconfigured.
static boolean	getBoolean(String propertyName, boolean defaultValue) Find boolean value stored in test.properties file based on property name.
static TUtilTestProperties.DbConnectionInfo	getDbConn()
static String	getDbSID() Returns the SID for the test database.
static String	getDbString() Get the database connection string.
static File	getLogFile() Returns the location for the JUnit test log file, or null if none is assigned.
static TestLogSink	getLogSink()
static TestLogSink	getLogSinkIfLogging() Get a log sink if logging is actually on.
static PrintWriter	getLogWriter()
static String	getPropertiesLocation()
static DataSource	getRawDataSource() Returns a raw, unaltered datasource to the ViewPoint test database.
static String	getString(String propertyName, String defaultValue) Find string value stored in test.properties file based on property name.
static TestProperties	getTestProperties()
static String	getViewpointLoginName() This returns the ViewPoint user name to use as the 'current user' when database related tests are running.
static boolean	hasDbConfig() Check if a database config is present.
static void	initLocale() Important for locale specifics in tests By default all tests are written for Dutch locale
static void	initLogging()
static boolean	isLogging()
static Connection	makeRawConnection()
static void	setCommitDisabled(boolean on) When set to true, all connections allocated on the same thread will have the "disable commit" flag set (see ConnectionPool.setCommitDisabled(boolean).

Methods inherited from class java.lang.Object

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

Constructor Detail

TUtilTestProperties

public TUtilTestProperties()

Method Detail

getTestProperties

@Nonnull
public static TestProperties getTestProperties()

getPropertiesLocation

public static String getPropertiesLocation()

hasDbConfig

public static boolean hasDbConfig()

Check if a database config is present. It does not OPEN the database, but when true database tests will run. If the database is configured but a connection cannot be made this will fail the tests.

Returns:

getDbString

public static String getDbString()

Get the database connection string. This fails hard when no connection string is present. Use hasDbConfig() to check if a test database is configured if the test needs to be conditional.

Returns:

assumeDatabase

public static final void assumeDatabase()

Callable from JUnit fixures, this will "ignore" a JUnit tests when the database is unconfigured.

getDbConn

public static TUtilTestProperties.DbConnectionInfo getDbConn()

Returns:

getDbSID

public static String getDbSID()

Returns the SID for the test database.

Returns:

getViewpointLoginName

public static String getViewpointLoginName()

This returns the ViewPoint user name to use as the 'current user' when database related tests are running. The name defaults to 'VIEWPOINT' but can be set to another value by setting the 'userid' value in the test properties file. If the userid is set to ANONYMOUS this will return NULL.

Returns:

getRawDataSource

public static DataSource getRawDataSource()

Returns a raw, unaltered datasource to the ViewPoint test database. This datasource does not alter the "current user" in red_environment.

Returns:

initLocale

public static void initLocale()

Important for locale specifics in tests
By default all tests are written for Dutch locale

makeRawConnection

public static Connection makeRawConnection()
                                    throws Exception

Throws:

Exception

setCommitDisabled

public static void setCommitDisabled(boolean on)

When set to true, all connections allocated on the same thread will have the "disable commit" flag set (see ConnectionPool.setCommitDisabled(boolean). This allows changes to a test database without commiting those changes. The result of the test should be tested using the same database connection as the one altering the data.

Parameters:

on -

initLogging

public static void initLogging()

isLogging

public static boolean isLogging()

getLogFile

@Nullable
public static File getLogFile()

Returns the location for the JUnit test log file, or null if none is assigned.

Returns:

getLogWriter

@Nullable
public static PrintWriter getLogWriter()

getLogSinkIfLogging

@Nullable
public static TestLogSink getLogSinkIfLogging()

Get a log sink if logging is actually on.

Returns:

getLogSink

public static TestLogSink getLogSink()

getBoolean

public static boolean getBoolean(@Nonnull
                                 String propertyName,
                                 boolean defaultValue)

Find boolean value stored in test.properties file based on property name. If value doesn't exist return default one.

Parameters:

propertyName - name of property requested from properties file

defaultValue - default value returned if property can't be found

Returns:

stored or default boolean value

getString

@Nullable
public static String getString(@Nonnull
                                         String propertyName,
                                         @Nullable
                                         String defaultValue)

Find string value stored in test.properties file based on property name. If value doesn't exist return default one.

Parameters:

propertyName - name of property requested from properties file

defaultValue - default value returned if property can't be found

Returns:

stored or default string value