Jump to: navigation, search

Difference between revisions of "EclipseLink/Development/Testing/MOXy"

(Summary)
Line 1: Line 1:
== Summary ==
+
== Building MOXy Source & Running MOXy Unit Tests ==
This page is intended to outline the setup and execution steps required to successfully run the MOXy JUnit tests.  It will be updated in the near future.
+
There are two scenarios discussed on this page describing how to build MOXy source code and run the related unit tests.  The first scenario dealt with is that where a user checks out the MOXy (and other required) Eclipse projects that are checked into the Eclipse repository and wishes to build the source and run the unit tests from that context.  The second scenario deals with the case where a user wishes to build the source and run the unit tests within a working copy of the Eclipse repository.
 +
=== Building & Running within an Eclipse Workspace ===
 +
* '''Building MOXy source'''
 +
**There is an ANT build script and properties file in the ''eclipselink.moxy'' project folder, named '''build.xml''' and '''build.properties''' respectively.  The default target (''all'') will compile all required source, then clean and compile the MOXy source.  Simply type "ant" in the ''eclipselink.moxy'' project folder to compile MOXy.
 +
**Required projects:
 +
***''eclipselink.core''
 +
***''eclipselink.core.lib''
 +
***''eclipselink.moxy.lib''
 +
**Additional libraries:
 +
***There are no additional libraries required
 +
* '''Building & running the MOXy test suites'''
 +
**There is an ANT build script and properties file in the ''eclipselink.moxy.test'' project folder, named '''build.xml''' and '''build.properties''' respectively.  The default target (''test'') will compile all required source, then clean and compile the MOXy test source, then run the unit tests.  Simply type "ant" in the ''eclipselink.moxy.test'' project folder to compile and run the MOXy unit tests.
 +
**The MOXy tests consist of OXM and JAXB test suitesThe OXM tests are run in four different modes:
 +
***DOM
 +
***SAX
 +
***Deployment XML
 +
***Document Preservation
 +
**The results of the tests are written to two separate .html files:  the OXM test results are written to  ''eclipselink.moxy.test/reports/oxm/junit-noframes.html'' and the JAXB results are written to ''eclipselink.moxy.test/reports/jaxb/junit-noframes.html''.
 +
**Required projects:
 +
***''eclipselink.core''
 +
***''eclipselink.core.lib''
 +
***''eclipselink.moxy''
 +
***''eclipselink.moxy.lib''
 +
**Additional libraries:
 +
***junit.jar - the "junit.lib" property in build.properties must be set to point to a version of junit.jar
 +
=== Building & Running within a Subversion Working Copy ===
 +
* '''Building MOXy source'''
 +
* '''Building & running the MOXy test suites'''

Revision as of 11:59, 19 October 2007

Building MOXy Source & Running MOXy Unit Tests

There are two scenarios discussed on this page describing how to build MOXy source code and run the related unit tests. The first scenario dealt with is that where a user checks out the MOXy (and other required) Eclipse projects that are checked into the Eclipse repository and wishes to build the source and run the unit tests from that context. The second scenario deals with the case where a user wishes to build the source and run the unit tests within a working copy of the Eclipse repository.

Building & Running within an Eclipse Workspace

  • Building MOXy source
    • There is an ANT build script and properties file in the eclipselink.moxy project folder, named build.xml and build.properties respectively. The default target (all) will compile all required source, then clean and compile the MOXy source. Simply type "ant" in the eclipselink.moxy project folder to compile MOXy.
    • Required projects:
      • eclipselink.core
      • eclipselink.core.lib
      • eclipselink.moxy.lib
    • Additional libraries:
      • There are no additional libraries required
  • Building & running the MOXy test suites
    • There is an ANT build script and properties file in the eclipselink.moxy.test project folder, named build.xml and build.properties respectively. The default target (test) will compile all required source, then clean and compile the MOXy test source, then run the unit tests. Simply type "ant" in the eclipselink.moxy.test project folder to compile and run the MOXy unit tests.
    • The MOXy tests consist of OXM and JAXB test suites. The OXM tests are run in four different modes:
      • DOM
      • SAX
      • Deployment XML
      • Document Preservation
    • The results of the tests are written to two separate .html files: the OXM test results are written to eclipselink.moxy.test/reports/oxm/junit-noframes.html and the JAXB results are written to eclipselink.moxy.test/reports/jaxb/junit-noframes.html.
    • Required projects:
      • eclipselink.core
      • eclipselink.core.lib
      • eclipselink.moxy
      • eclipselink.moxy.lib
    • Additional libraries:
      • junit.jar - the "junit.lib" property in build.properties must be set to point to a version of junit.jar

Building & Running within a Subversion Working Copy

  • Building MOXy source
  • Building & running the MOXy test suites