This component is really just a test container for testing the other components. This container is not meant to be used in a production environment.
In order to save you a little coding, a base class has been provided for your test cases.
org.apache.fulcrum.testcontainer.BaseUnitTest and you are ready
In order to save you a little coding, a base class has been provided for your test
cases. Simply extend
org.apache.fulcrum.testcontainer.BaseUnitTest and you
are ready to go.
tearDown methods of
will handle the lifecycle of the container for you. Each test will have a freshly
initialized container in which to run.
To lookup and release components, call the
By default, all tests will use the configuration files
TestRoleConfig.xml located in the
src/test directory. If you want to override that behavior for ALL your
tests, you can override the
If you are testing multiple config or role files, then just call
setRoleFileName() before doing
your first lookup. The string you pass in should be prefixed from the directory the JVM is
running in (e.g. src/test/YOUR_CONFIG.xml).
You can choose between two container implementations, the ECM and Fulcrum YAAFI. For this just assign one of the values BaseUnitTest.CONTAINER_ECM or BaseUnitTest.CONTAINER_YAAFI to the static variable BaseUnitTest.containerType before doing the first lookup. The default container is Fulcrum YAAFI.
If you need more control over the container itself for your test, just don't extend the
unit test provided with the container. Instead, embed the container directly in your test
case. See the java docs for
There are two ways of configuring your components. One is the traditional TestComponentConfig.xml and TestRoleConfig.xml files described below. Or, for the ECMContainer one is available that integrates the two, shown at the bottom.
First, here is the role configuration example.
<role name="org.apache.fulcrum.crypto.CryptoService" shorthand="crypto" default-class="org.apache.fulcrum.crypto.DefaultCryptoService"/>
Now comes the basic configuration of the component. Here will will configure the various encryption providers.
<crypto> <algorithm> <unix>org.apache.fulcrum.crypto.provider.UnixCrypt</unix> <clear>org.apache.fulcrum.crypto.provider.ClearCrypt</clear> <java>org.apache.fulcrum.crypto.provider.JavaCrypt</java> <oldjava>org.apache.fulcrum.crypto.provider.OldJavaCrypt</oldjava> </algorithm> </crypto>
When using the ECM container you can choose to use an integrated roles and components file like follows. Note that this file format is not supported with Fulcrum YAAFI and will cause an Exception to be thrown.
<my-system> <component role="org.apache.fulcrum.testcontainer.SimpleComponent" class="org.apache.fulcrum.testcontainer.AlternativeComponentImpl"> </component> </my-system>