Package net.officefloor.frame.test

Class AbstractOfficeConstructTestCase

java.lang.Object

junit.framework.Assert

junit.framework.TestCase

net.officefloor.frame.test.OfficeFrameTestCase

net.officefloor.frame.test.AbstractOfficeConstructTestCase

All Implemented Interfaces:

junit.framework.Test

public abstract class AbstractOfficeConstructTestCase
extends OfficeFrameTestCase

Abstract TestCase for construction testing of an Office.

Author:

Daniel Sagenschneider

Nested Class Summary

Nested classes/interfaces inherited from class net.officefloor.frame.test.OfficeFrameTestCase

OfficeFrameTestCase.FailOperation, OfficeFrameTestCase.GuiTest, OfficeFrameTestCase.MultithreadedTestLogic<T extends java.lang.Throwable>, OfficeFrameTestCase.StressTest, OfficeFrameTestCase.TestCapture<T extends java.lang.Throwable>, OfficeFrameTestCase.TestLogic<R,T extends java.lang.Throwable>, OfficeFrameTestCase.UsesDockerTest, OfficeFrameTestCase.UsesGCloudTest, OfficeFrameTestCase.WaitForTruePredicate<T extends java.lang.Throwable>

Field Summary

Fields inherited from class net.officefloor.frame.test.OfficeFrameTestCase

CLASS_LOADER_EXTRA_CLASS_NAME, CLASS_LOADER_EXTRA_PACKAGE_NAME, classLoaderTestSupport, END_OF_LINE, fileTestSupport, logTestSupport, mockTestSupport, threadedTestSupport

Constructor Summary

Constructors

Constructor	Description
AbstractOfficeConstructTestCase()

Method Summary

Modifier and Type	Method	Description
void	adjustCurrentTimeMillis(long timeInMilliseconds)	Move current time forward the input number of milliseconds.
void	assertThreadUsed(java.lang.Thread thread)	Ensures the Thread is used.
DependencyMappingBuilder	bindManagedObject(java.lang.String bindName, ManagedObjectScope managedObjectScope, ManagedFunctionBuilder<?,?> managedFunctionBuilder)	Builds the ManagedObject for use at the desired ManagedObjectScope.
ReflectiveFunctionBuilder	constructFunction(java.lang.Object object, java.lang.String methodName)	Constructs the ReflectiveFunctionBuilder.
<O extends java.lang.Enum<O>,F extends java.lang.Enum<F>> ManagedFunctionBuilder<O,F>	constructFunction(java.lang.String functionName, ManagedFunction<O,F> function)	Facade method to register a ManagedFunction.
<O extends java.lang.Enum<O>,F extends java.lang.Enum<F>> ManagedFunctionBuilder<O,F>	constructFunction(java.lang.String functionName, ManagedFunctionFactory<O,F> functionFactory)	Facade method to register a ManagedFunction.
ReflectiveGovernanceBuilder	constructGovernance(java.lang.Object object, java.lang.String governanceName)	Constructs the Governance.
ManagedObjectBuilder<?>	constructManagedObject(java.lang.Object object, java.lang.String managedObjectName, java.lang.String managingOffice)	Facade method to register a ManagedObject.
<D extends java.lang.Enum<D>,F extends java.lang.Enum<F>,MS extends ManagedObjectSource<D,F>> ManagedObjectBuilder<F>	constructManagedObject(java.lang.String managedObjectName, java.lang.Class<MS> managedObjectSourceClass, java.lang.String managingOffice)	Facade method to register a ManagedObject.
<D extends java.lang.Enum<D>,F extends java.lang.Enum<F>,MS extends ManagedObjectSource<D,F>> ManagedObjectBuilder<F>	constructManagedObject(java.lang.String managedObjectName, MS managedObjectSource, java.lang.String managingOffice)	Facade method to register a ManagedObject.
OfficeFloor	constructOfficeFloor()	Facade method to create the OfficeFloor.
ReflectiveFunctionBuilder	constructStaticFunction(java.lang.Class<?> clazz, java.lang.String methodName)	Constructs the ReflectiveFunctionBuilder for a static Method.
<TS extends TeamSource> TeamBuilder<?>	constructTeam(java.lang.String teamName, java.lang.Class<TS> teamSourceClass)	Facade method to create a Team.
TeamBuilder<?>	constructTeam(java.lang.String teamName, Team team)	Facade method to create a Team.
OfficeBuilder	getOfficeBuilder()	Obtains the OfficeBuilder.
OfficeFloorBuilder	getOfficeFloorBuilder()	Obtains the OfficeFloorBuilder.
java.lang.String	getOfficeFloorName()	Obtains the name of the OfficeFloor currently being constructed.
java.lang.String	getOfficeName()	Obtains the name of the Office currently being constructed.
void	invokeFunction(java.lang.String functionName, java.lang.Object parameter)	Facade method to invoke ManagedFunction of an Office.
void	invokeFunction(java.lang.String functionName, java.lang.Object parameter, int secondsToRun)	Facade method to invoke ManagedFunction of an Office.
void	invokeFunctionAndValidate(java.lang.String functionName, java.lang.Object parameter, java.lang.String... expectedFunctions)	Facade method to invoke the ManagedFunction of an Office and validate the ManagedFunction instances invoked.
void	recordReflectiveFunctionMethodInvoked(java.lang.String methodName)	Invoked by the ReflectiveFunctionBuilder when it executes the method.
void	setRecordReflectiveFunctionMethodsInvoked(boolean isRecord)	Specifies whether to record the invocations of the ReflectiveFunctionBuilder instances.
protected void	setUp()
protected void	tearDown()
Office	triggerFunction(java.lang.String functionName, java.lang.Object parameter, FlowCallback callback)	Triggers the ManagedFunction but does not wait for its completion.
void	validateNoTopLevelEscalation()	Validates that no top level escalation occurred.
void	validateReflectiveMethodOrder(java.lang.String... methodNames)	Validates the order the ReflectiveFunctionBuilder invoked the methods.

Methods inherited from class net.officefloor.frame.test.OfficeFrameTestCase

assertContents, assertContents, assertFail, assertFail, assertFail, assertGraph, assertList, assertList, assertList, assertList, assertList, assertProperties, assertTextEquals, assertXmlEquals, captureLoggerOutput, clearDirectory, copyDirectory, createFile, createMock, createNewClassLoader, createPlatformIndependentText, createSynchronizedMock, deleteDirectory, displayGraph, displayGraph, doMultiThreadedTest, doMultiThreadedTest, doTest, fail, findFile, findFile, findInputStream, getDisplayRunTime, getDisplayRunTime, getFileContents, getFileLocation, getItem, getPackageRelativePath, getProperty, isGuiAvailable, isPrintMessages, isSkipStressTests, isSkipTestsUsingDocker, isSkipTestsUsingGCloud, param, paramType, printHeapMemoryDiagnostics, printMessage, printMessage, printMessage, recordReturn, recordReturn, recordThrows, recordVoid, removeXmlWhiteSpacing, replayMockObjects, runBare, setDebugVerbose, setLogGC, setName, setVerbose, sleep, throwException, timeout, timeout, verifyMockObjects, waitForTrue, waitForTrue

Methods inherited from class junit.framework.TestCase

assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertFalse, assertFalse, assertNotNull, assertNotNull, assertNotSame, assertNotSame, assertNull, assertNull, assertSame, assertSame, assertTrue, assertTrue, countTestCases, createResult, fail, fail, failNotEquals, failNotSame, failSame, format, getName, run, run, runTest, toString

Methods inherited from class java.lang.Object

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

Constructor Detail

AbstractOfficeConstructTestCase

public AbstractOfficeConstructTestCase()

Method Detail

setUp

protected void setUp()
              throws java.lang.Exception

Overrides:

setUp in class junit.framework.TestCase

Throws:

java.lang.Exception

tearDown

protected void tearDown()
                 throws java.lang.Exception

Overrides:

tearDown in class junit.framework.TestCase

Throws:

java.lang.Exception

adjustCurrentTimeMillis

public void adjustCurrentTimeMillis(long timeInMilliseconds)

Move current time forward the input number of milliseconds.

Parameters:

timeInMilliseconds - Milliseconds to move current time forward.

validateNoTopLevelEscalation

public void validateNoTopLevelEscalation()
                                  throws java.lang.Throwable

Validates that no top level escalation occurred.

This method will clear the escalation on exit.

Throws:

java.lang.Throwable - If top level Escalation.

getOfficeFloorBuilder

public OfficeFloorBuilder getOfficeFloorBuilder()

Obtains the OfficeFloorBuilder.

Returns:

OfficeFloorBuilder.

getOfficeBuilder

public OfficeBuilder getOfficeBuilder()

Obtains the OfficeBuilder.

Returns:

OfficeBuilder.

getOfficeFloorName

public java.lang.String getOfficeFloorName()

Obtains the name of the OfficeFloor currently being constructed.

Returns:

Name of the OfficeFloor currently being constructed.

getOfficeName

public java.lang.String getOfficeName()

Obtains the name of the Office currently being constructed.

Returns:

Name of the Office currently being constructed.

constructFunction

public ReflectiveFunctionBuilder constructFunction(java.lang.Object object,
                                                   java.lang.String methodName)

Constructs the ReflectiveFunctionBuilder.

Parameters:

object - Object containing the Method.

methodName - Name of the Method.

Returns:

ReflectiveFunctionBuilder.

constructStaticFunction

public ReflectiveFunctionBuilder constructStaticFunction(java.lang.Class<?> clazz,
                                                         java.lang.String methodName)

Constructs the ReflectiveFunctionBuilder for a static Method.

Parameters:

clazz - Class containing the static Method.

methodName - Name of the Method.

Returns:

ReflectiveFunctionBuilder.

setRecordReflectiveFunctionMethodsInvoked

public void setRecordReflectiveFunctionMethodsInvoked(boolean isRecord)

Specifies whether to record the invocations of the ReflectiveFunctionBuilder instances.

This is necessary as stress tests using the ReflectiveFunctionBuilder will get OutOfMemoryError issues should every ManagedFunction executed be recorded.

By default this is false to not record.

Parameters:

isRecord - true to record the ManagedFunction instances invoked.

recordReflectiveFunctionMethodInvoked

public void recordReflectiveFunctionMethodInvoked(java.lang.String methodName)

Invoked by the ReflectiveFunctionBuilder when it executes the method.

Parameters:

methodName - Name of method being invoked.

validateReflectiveMethodOrder

public void validateReflectiveMethodOrder(java.lang.String... methodNames)

Validates the order the ReflectiveFunctionBuilder invoked the methods.

Parameters:

methodNames - Order that the reflective methods should be invoked.

See Also:

setRecordReflectiveFunctionMethodsInvoked(boolean)

assertThreadUsed

public void assertThreadUsed(java.lang.Thread thread)

Ensures the Thread is used.

Parameters:

thread - Thread.

constructFunction

public <O extends java.lang.Enum<O>,F extends java.lang.Enum<F>> ManagedFunctionBuilder<O,F> constructFunction(java.lang.String functionName,
                                                                                                                           ManagedFunctionFactory<O,F> functionFactory)

Facade method to register a ManagedFunction.

Type Parameters:

O - Dependency key type.

F - Flow key type.

Parameters:

functionName - Name of the ManagedFunction.

functionFactory - ManagedFunctionFactory.

Returns:

ManagedFunctionBuilder for the ManagedFunction.

constructFunction

public <O extends java.lang.Enum<O>,F extends java.lang.Enum<F>> ManagedFunctionBuilder<O,F> constructFunction(java.lang.String functionName,
                                                                                                                           ManagedFunction<O,F> function)

Facade method to register a ManagedFunction.

Type Parameters:

O - Dependency key type.

F - Flow key type.

Parameters:

functionName - Name of the ManagedFunction.

function - ManagedFunction.

Returns:

ManagedFunctionBuilder for the ManagedFunction.

constructManagedObject

public <D extends java.lang.Enum<D>,F extends java.lang.Enum<F>,MS extends ManagedObjectSource<D,F>> ManagedObjectBuilder<F> constructManagedObject(java.lang.String managedObjectName,
                                                                                                                                                                      java.lang.Class<MS> managedObjectSourceClass,
                                                                                                                                                                      java.lang.String managingOffice)

Facade method to register a ManagedObject.

Type Parameters:

D - Dependency key type.

F - Flow key type.

MS - ManagedObjectSource type.

Parameters:

managedObjectName - Name of the ManagedObject.

managedObjectSourceClass - ManagedObjectSource Class.

managingOffice - Name of the managing Office. May be null to manually register for ManagingOfficeBuilder.

Returns:

ManagedObjectBuilder.

constructManagedObject

public <D extends java.lang.Enum<D>,F extends java.lang.Enum<F>,MS extends ManagedObjectSource<D,F>> ManagedObjectBuilder<F> constructManagedObject(java.lang.String managedObjectName,
                                                                                                                                                                      MS managedObjectSource,
                                                                                                                                                                      java.lang.String managingOffice)

Facade method to register a ManagedObject.

Type Parameters:

D - Dependency key type.

F - Flow key type.

MS - ManagedObjectSource type.

Parameters:

managedObjectName - Name of the ManagedObject.

managedObjectSource - ManagedObjectSource instance.

managingOffice - Name of the managing Office. May be null to manually register for ManagingOfficeBuilder.

Returns:

ManagedObjectBuilder.

constructManagedObject

public ManagedObjectBuilder<?> constructManagedObject(java.lang.Object object,
                                                      java.lang.String managedObjectName,
                                                      java.lang.String managingOffice)

Facade method to register a ManagedObject.

Parameters:

object - Object for the ManagedObject.

managedObjectName - Name of the ManagedObject.

managingOffice - Name of the mananaging Office. May be null to manually register for ManagingOfficeBuilder.

Returns:

ManagedObjectBuilder.

bindManagedObject

public DependencyMappingBuilder bindManagedObject(java.lang.String bindName,
                                                  ManagedObjectScope managedObjectScope,
                                                  ManagedFunctionBuilder<?,?> managedFunctionBuilder)

Builds the ManagedObject for use at the desired ManagedObjectScope.

Parameters:

bindName - Name to bind the ManagedObject under.

managedObjectScope - ManagedObjectScope for the ManagedObject.

managedFunctionBuilder - ManagedFunctionBuilder if binding to ManagedObjectScope.FUNCTION.

Returns:

DependencyMappingBuilder for the bound ManagedObject.

constructGovernance

public ReflectiveGovernanceBuilder constructGovernance(java.lang.Object object,
                                                       java.lang.String governanceName)

Constructs the Governance.

Parameters:

object - Object containing the Method instances used for Governance.

governanceName - Name of the Governance.

Returns:

ReflectiveGovernanceBuilder.

constructTeam

public TeamBuilder<?> constructTeam(java.lang.String teamName,
                                    Team team)

Facade method to create a Team.

Parameters:

teamName - Name of the Team.

team - Team.

Returns:

TeamBuilder.

constructTeam

public <TS extends TeamSource> TeamBuilder<?> constructTeam(java.lang.String teamName,
                                                            java.lang.Class<TS> teamSourceClass)

Facade method to create a Team.

Type Parameters:

TS - TeamSource type.

Parameters:

teamName - Name of the Team.

teamSourceClass - TeamSource class.

Returns:

TeamBuilder.

constructOfficeFloor

public OfficeFloor constructOfficeFloor()
                                 throws java.lang.Exception

Facade method to create the OfficeFloor.

Returns:

OfficeFloor.

Throws:

java.lang.Exception - If fails to construct the OfficeFloor.

triggerFunction

public Office triggerFunction(java.lang.String functionName,
                              java.lang.Object parameter,
                              FlowCallback callback)
                       throws java.lang.Exception

Triggers the ManagedFunction but does not wait for its completion.

Parameters:

functionName - Name of the ManagedFunction.

parameter - Parameter for the ManagedFunction.

callback - FlowCallback. May be null.

Returns:

Office containing the ManagedFunction.

Throws:

java.lang.Exception - If fails to trigger the ManagedFunction.

invokeFunction

public void invokeFunction(java.lang.String functionName,
                           java.lang.Object parameter)
                    throws java.lang.Exception

Facade method to invoke ManagedFunction of an Office. It will create the OfficeFloor if necessary and times out after 3 seconds if invoked ManagedFunction is not complete.

Parameters:

functionName - Name of the ManagedFunction to invoke.

parameter - Parameter.

Throws:

java.lang.Exception - If fails to construct Office or ManagedFunction invocation failure.

invokeFunctionAndValidate

public void invokeFunctionAndValidate(java.lang.String functionName,
                                      java.lang.Object parameter,
                                      java.lang.String... expectedFunctions)
                               throws java.lang.Exception

Facade method to invoke the ManagedFunction of an Office and validate the ManagedFunction instances invoked.

Parameters:

functionName - Name of the ManagedFunction to invoke.

parameter - Parameter.

expectedFunctions - Names of the expected ManagedFunction instances to be invoked in the order specified.

Throws:

java.lang.Exception - If fails to construct Office or ManagedFunction invocation failure.

invokeFunction

public void invokeFunction(java.lang.String functionName,
                           java.lang.Object parameter,
                           int secondsToRun)
                    throws java.lang.Exception

Facade method to invoke ManagedFunction of an Office. It will create the OfficeFloor if necessary.

Parameters:

functionName - Name of the ManagedFunction to invoke.

parameter - Parameter.

secondsToRun - Seconds to run.

Throws:

java.lang.Exception - If fails to construct Office or ManagedFunction invocation failure.