~~ @version $Revision$ ($Author$) $Date$
~~ See this file format http://maven.apache.org/doxia/references/apt-format.html

                                    ------------------
                                    Testing J2ME  Application using MicroEmulator


Testing j2me application with MicroEmulator

* Introduction

     If you're a Java developer, you're familiar with the {{{http://www.junit.org/}JUnit}} project, an open source unit testing framework for Java.
     With JUnit you write simple classes (test cases) that have a number of methods that use assertions to test various aspects of your code.
     The only question is that you need to run J2ME test differently.

    * <<{{{http://snapshot.pyx4me.com/pyx4me-cldcunit/}CLDCUnit}}>> J2ME JUnit base test framework.

        CLDCUnit can be used as original JUnit when running tests with Java J2SE. Simply create regular JUnit test that extends <junit.framework.TestCase> and run in Eclipse or Maven.

        Because Java 2 Micro Edition (J2ME) dos not have reflection API CLDCUnit needs aditional step to build process that will create reflection data. Bytecode instrumentation is used. Result of the build can be executed on real device.

        CLDCUnit project is created by MicroEmulator Team member.

        See how it is used to test MicroEmulator in {{{microemu-tests/microemu-test-midlet}microemu-test-midlet}}

    * <<{{{https://opensource.motorola.com/sf/projects/gatling}Gatling}}>> Motorola opensource project: an open, extensible test framework aimed at supporting conformance, interoperability, performance, unit, and signature tests for Java ME implementations. Gatling can be used by application developers or implementers of standard or proprietary APIs and is designed to be easily customized and extended.

        The goals of the project include:

            * Produce a unified test framework that can be freely used, extended, and improved by the entire Java ME community

            * Enable the development of a rich set of tests that serve to reduce fragmentation and subtle differences in implementation of standard APIs

            * Enable many different types of legacy tests to be run within a single test environment

        We run JSR-82 tests for BlueCove using Gatling and MicroEmulator. See {{{http://www.bluecove.org/tck/}BlueCove JSR 82 TCK tests}}

    * <<J2MEUnit>> or SE Mobile JUnit approach.

        Use UnitTest library adapted for JavaME. And run the application in MicroEmulator. The only benefit of this approach is ability to run the same tests on real device.

        {{{http://j2meunit.sourceforge.net/}J2MEUnit}} is a Java 2 Micro Edition (J2ME) library containing a unit testing framework for J2ME applications.
        ~~Also read {{{http://developers.sun.com/techtopics/mobility/midp/articles/test/}Qusay H. Mahmoud Article}}

        {{{http://developer.sonyericsson.com/site/global/newsandevents/latestnews/newsjuly06/p_mobile_juint1.0_javame_cldc.jsp}Sony Ericsson Mobile JUnit 1.0 for Java ME CLDC phones}}


    * <<Original JUnit>> approach

       Significant part of application code is not related to UI presentation and can be executed without MIDlet's.
       Usually this is persistence communications and calculation layers of application.

       If you selected {{{http://www-128.ibm.com/developerworks/wireless/library/wi-arch6/}MVC design pattern}}
       then <Model> is the perfect target for testing with MicroEmulator.
       In any case probably your complex application already contains multiple modules (jars) that are finally linked to
       with MIDlet in application. Test them separately before you build MIDlet.

       Build and run UnitTests that are executing you application logic with microemulato.jar in you classpath. All classes that are using Generic Connection Framework will run perfectly under J2SE without initialization.
       This way it is much simple to integrate tests into automatic build process and is easier to test complex scenarios.

       Don't forget that you will have added benefits of reporting and coverage that comes with standard tools like Eclipse, Emma, Clove.

       In addition to GCF code you can test jsr-82 bluetooth application code using BlueCove JSR-82 Emulator module in J2SE.


* Running headless emulator

    We are working on this text now


* -Xautotest MicroEmulator command line option to run MIDlet in autotest mode

    The -Xautotest should run the same way as in WTK. Since in WTK it not well documented Vlad did what he understood. This feature has only been tested with {{{https://opensource.motorola.com/sf/projects/gatling}Gatling}}

    To run MIDlet tests in MicroEmulator execute this command after starting and configuring Gatling:

---
java -cp microemulator.jar org.microemu.app.Main -Xautotest:http://localhost:8080/getNextApp.jad
---

    This is what "autotest mode" does in microemulator:

        1) Load <jad> from http url

        2) If <jad> not found (http 404) end all the tests

        3) Create new MIDlet ClassLoader

        4) Load <jar> from url specified in <jad>

        5) If <jar> not found (http 404) end the tests for this <jar>, start from 1) for next <jad>

        6) Start MIDlet

        7) Wait while MIDlet has Running Threads. So the test MIDlet and its Threads should exit by itself..

        8) Continue tests with the same <jar> but load it again; go to 3)