No description, website, or topics provided.
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
src
.gitignore
LICENSE
README.md
pom.xml

README.md

Imixs-Mock

Imixs-Mock is a testing library for mocking the Imixs Workflow engine.

Mocking is primarily used in unit testing. An object under test may have dependencies on other (complex) objects. To isolate the behavior of the object you want to replace the other objects by mocks that simulate the behavior of the real objects. This is useful if the real objects are impractical to incorporate into the unit test.

In short, mocking is creating objects that simulate the behavior of real objects.

How to Use

To use the library in your own project just add the following maven dependencies:

<dependency>
	<groupId>org.imixs.workflow</groupId>
	<artifactId>imixs-mock</artifactId>
	<version>4.4.0</version>
	<scope>test</scope>
</dependency>
<!-- JUnit Tests -->
<dependency>
	<groupId>junit</groupId>
	<artifactId>junit</artifactId>
	<version>4.8.1</version>
	<scope>test</scope>
</dependency>
<dependency>
	<groupId>org.mockito</groupId>
	<artifactId>mockito-all</artifactId>
	<version>1.9.5</version>
	<scope>test</scope>
</dependency>

Junit Tests

In a JUnit Test class you can initialize the Imixs-Workflow Mock environment:

public class TestMyWorkflow {
	WorkflowMockEnvironment workflowMockEnvironment;

	final static String MODEL_PATH = "/mymodel.bpmn";
	final static String MODEL_VERSION = "1.0.0";

	ItemCollection workitem = null;

	// setup the workflow envirnment
	@Before
	public void setup() throws PluginException, ModelException {

		// initialize @Mock annotations....
		MockitoAnnotations.initMocks(this);

		workflowMockEnvironment = new WorkflowMockEnvironment();
		workflowMockEnvironment.setModelPath(MODEL_PATH);
		workflowMockEnvironment.setup();

		// test model...
		Assert.assertNotNull(workflowMockEnvironment.getModel());
	}
	.....
}

You can find a full example of a jUnit Test here

Test Your Model

After you have setup the workflow Mock you can write test methods to test specific model situations. In your test method you simulate a Task and an Event in the following way:

@Test
public void testSimple() {

	workitem = new ItemCollection();
	workitem.model(MODEL_VERSION).task(2100).event(10);
	workitem.replaceItemValue("_subject", "Hello World");

	try {
		workitem = workflowMockEnvironment.getWorkflowService().processWorkItem(workitem);
	} catch (AccessDeniedException | ProcessingErrorException | PluginException | ModelException e) {
		Assert.fail();
	}

}

Test only specific Plugins

You can overwrite the plug-in list defined by your model to test only specific plug-ins. This can be useful to reduce the complexity in a mock environment

// test only specific Plugins.....
try {
	workflowMockEnvironment.getModelService()
			.addModel(new ModelPluginMock(workflowMockEnvironment.getModel(),
					"org.imixs.marty.plugins.ApproverPlugin",
					"org.imixs.workflow.engine.plugins.RulePlugin"));
} catch (ModelException e) {
	e.printStackTrace();
}

Simulate User Login

You can easily simulate a specific user in you test class by

.....
Principal principal = Mockito.mock(Principal.class);
when(workflowMockEnvironment.getWorkflowService().getUserName()).thenReturn("my.userid");
....

Set Log Level

To set the log level in a unit test you can simply change the standard logger:

Logger.getLogger("org.imixs.workflow.*").setLevel(Level.FINEST);