{"type":"doc","content":[{"type":"paragraph","content":[{"text":"This page describes how to do unit testing in OpenMRS 1.3 and earlier which used junit-3.8.","type":"text","marks":[{"type":"strong"}]},{"type":"hardBreak"},{"text":"\n","type":"text"},{"text":"For the latest method for unit testing see","type":"text","marks":[{"type":"strong"}]},{"text":" ","type":"text"},{"text":"Module Unit Testing","type":"text","marks":[{"type":"link","attrs":{"href":"https://openmrs.atlassian.net/wiki/spaces/Archives/pages/25468257"}}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Getting Started","type":"text"}]},{"type":"paragraph","content":[{"text":"Unit testing in modules is very similar to ","type":"text"},{"text":"unit testing the API","type":"text","marks":[{"type":"link","attrs":{"href":"http://archive.openmrs.org/wiki/Unit_Testing"}}]},{"text":".","type":"text"}]},{"type":"paragraph","content":[{"text":"To test a class that is not associated with the Context or your module service, unit testing is a two step process:","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Create your test class","type":"text","marks":[{"type":"strong"}]},{"text":" in /test/org/openmrs/module/yourmodule:\n","type":"text"}]},{"type":"codeBlock","content":[{"text":"\npackage org.openmrs.module.yourmodule;\n \npublic class MyModuleObjectTest extends TestCase {\npublic void testShouldExamineFeatureXOfMyModuleObject() throws Exception { MyModuleObject obj = new MyModuleObject(); String output = obj.someComplicatedCall(\"argument1\"); assertNotNull(output); }\n}\n","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Run your test class","type":"text","marks":[{"type":"strong"}]},{"text":". In eclipse:\n\t","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Right click on the class name in the \"Navigator\" or \"Package Explorer\" view","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Select \"Run As\" ? JUnit Test","type":"text"}]}]}]}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Testing the Your Module Service","type":"text"}]},{"type":"paragraph","content":[{"text":"To test a class that requires the ","type":"text"},{"text":"Context","type":"text","marks":[{"type":"em"}]},{"text":" object and method calls, simply extend ","type":"text"},{"text":"BaseModuleContextSensitiveTest","type":"text","marks":[{"type":"strong"}]},{"text":". The BaseModuleContextSensitiveTest class will run through the Spring setup, loads in any omods on the classpath, creates the Context and ServiceContext classes required by the OpenMRS API. This startup takes a few seconds, so when you can, create simple tests that only extend TestCase and do not call Context.* or your module's service.","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Compile the OpenMRS tests api using the package-api-tests ant target in OpenMRS's build.xml","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Copy the newly compiled jar file /dist/tests-openmrs-api-","type":"text"},{"text":".","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"},{"text":".","type":"text","marks":[{"type":"strong"}]},{"text":".jar to /lib-common folder of your module","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Set up the module classpath file (see below)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Create your test class","type":"text","marks":[{"type":"strong"}]},{"text":" in your module /test/org/openmrs/module/yourmodule:...","type":"text"},{"type":"hardBreak"},{"text":"\npublic class MyModuleServiceTest extends BaseModuleContextSensitiveTest {","type":"text"},{"type":"hardBreak"},{"text":"\n...","type":"text"}]}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Setting Up the Classpath for Module JUnit Testing","type":"text"}]},{"type":"paragraph","content":[{"text":"You will need to reference most openmrs libraries from your module code (file ","type":"text"},{"text":"/.classpath","type":"text","marks":[{"type":"em"}]},{"text":"). Your classpath will most likely look very similar to this:","type":"text"}]},{"type":"codeBlock","content":[{"text":"\n\n\n\n\n\n\n \n\n\n \n\n\n\n\n\n\n\n\n\n\n\n \n\n\n\n\n\n\n\n\n\n\n\n\n\n \n\n\n","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Logging in JUnit Module Tests","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"You must have log4j referenced explicitly in your .classpath file","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"log4j.xml's parent folder must be in your classpath in order to be found by log4j (like in /metadata or /dist)\n\t","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The log4j.xml can will look something like:\n","type":"text"}]},{"type":"codeBlock","content":[{"text":"\n\n<\\!DOCTYPE log4j:configuration SYSTEM \"log4j.dtd\">\n \n\n \n\n\n\n\n\n \n\n\n\n \n\n\n\n\n \n\n","type":"text"}]}]}]}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Including Other Required Modules in JUnit Tests","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Package the required module into its omod file and drop it into the /lib-common folder","type":"text"}]}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Extras","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"If you've added a log4j.xml file to your metadata directory and metadata is referenced in the .classpath file and you still don't see any log messages in the console during the execution of the test, make sure that the metadata directory comes before all JARs that might have a log4j.xml in them already (i.e. openmrs-api.jar)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"If you create custom tables and map them using hibernate, an error in the .hbm.xml can be masked and you will just get an error to the effect that your service cannot be found when you call Context.getService(.class). If you compile the module and load it into the OpenMRS web interface, it will tell you the real error.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"If you get an exception like org.openmrs.api.APIException: Service not found: class org.openmrs.module. ... then you may need to do one of two things. First, make sure that you have run the and \"package module\" task. If you've already done that, then you probably need to fix your build file for the module you're including.\n\t","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Open build.xml in the module you're compiling","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Find the \"package-jar\" target","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Remove the line like \"\"","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Repackage your jar file and try using it again in the other module","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"To skip the authentication username/popup when testing, place these variables into your runtime properties file: junit.username=admin","type":"text"},{"type":"hardBreak"},{"text":"\njunit.password=test","type":"text"}]}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"FAQ","type":"text"}]},{"type":"paragraph","content":[{"text":"When I run my module's service tests, I get the following error:org.hibernate.MappingException: Unknown entity: org.openmrs.module..

Browser not supported