Notice: this Wiki will be going read only early in 2024 and edits will no longer be possible. Please see: https://gitlab.eclipse.org/eclipsefdn/helpdesk/-/wikis/Wiki-shutdown-plan for the plan.
Difference between revisions of "SMILA/Development Guidelines/Setup for JAXB code generation"
(→Generate Sources from Command line) |
(→Steps to install needed libraries) |
||
| (5 intermediate revisions by 2 users not shown) | |||
| Line 11: | Line 11: | ||
# copy the following into your <tt>lib/xjc</tt> | # copy the following into your <tt>lib/xjc</tt> | ||
#* all jars in the {{path|jaxb-ri-<version>/lib/}} | #* all jars in the {{path|jaxb-ri-<version>/lib/}} | ||
| − | #* <tt>InterfacesXJCPlugin.jar</tt> | + | #* <tt>InterfacesXJCPlugin.jar</tt>, you can download it [http://ubuntuone.com/7mZZkULtjiKxfCQfKVH2zG here] |
Your build lib directory should now look at least like this: | Your build lib directory should now look at least like this: | ||
<source lang="text"> | <source lang="text"> | ||
| Line 34: | Line 34: | ||
The JAXB classes should now be generated in the <tt>code/gen</tt> directory of your bundle. | The JAXB classes should now be generated in the <tt>code/gen</tt> directory of your bundle. | ||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
=== Generating JAXB classes for a new crawler or agent configuration === | === Generating JAXB classes for a new crawler or agent configuration === | ||
# If you do not yet have a binary distribution of SMILA: [http://www.eclipse.org/smila/downloads.php Download] or build one. | # If you do not yet have a binary distribution of SMILA: [http://www.eclipse.org/smila/downloads.php Download] or build one. | ||
| − | # Copy <tt>org.eclipse.smila.connectivity.framework. | + | # Copy <tt>org.eclipse.smila.connectivity.framework.schema_$VERSION.jar</tt> from the plugins directory of the SMILA distribution to <tt>lib/xjc</tt>. This is necessary because crawler configurations extend a base schema and therefore need to access classes in this bundle. |
# Put your bundle next to the <tt>SMILA.builder</tt> source bundle. | # Put your bundle next to the <tt>SMILA.builder</tt> source bundle. | ||
# Add a <tt>code/gen</tt> folder to your bundle and add it as a source folder. | # Add a <tt>code/gen</tt> folder to your bundle and add it as a source folder. | ||
Revision as of 08:27, 24 January 2012
Contents
Introduction
This page describes additional setup steps you need to do if you want to use JAXB to generate classes from XML schema descriptions for SMILA. This is also needed to be able to extend SMILA XML configuration file schemas, because we mostly use JAXB to parse them.
Steps to install needed libraries
- Setup a build library as described in SMILA/Development Guidelines/Howto build a SMILA-Distribution. In this document we will use lib/ as the root of it.
- Download the JAXB reference implementation 2.1.6 or above from here
- unpack it with (see here)
java -jar <JAXB-version>.jar
- copy the following into your lib/xjc
- all jars in the jaxb-ri-<version>/lib/
- InterfacesXJCPlugin.jar, you can download it here
Your build lib directory should now look at least like this:
lib/
ant-contrib/
ant-contrib-1.0b1.jar
xjc/
jaxb-xjc.jar
InterfacesXJCPlugin.jar
activation.jar
jaxb-api.jar
jaxb-impl.jar
jsr173_1.0_api.jarGenerate Sources from Command line
- Put SMILA.builder into the same folder as the bundle for which you are generating the folder (for all SMILA bundles this is the case after a checkout).
- To generate the classes, you can now use:
ant -Dlib.dir=<SMILA-Build-Lib-Dir>
The JAXB classes should now be generated in the code/gen directory of your bundle.
Generating JAXB classes for a new crawler or agent configuration
- If you do not yet have a binary distribution of SMILA: Download or build one.
- Copy org.eclipse.smila.connectivity.framework.schema_$VERSION.jar from the plugins directory of the SMILA distribution to lib/xjc. This is necessary because crawler configurations extend a base schema and therefore need to access classes in this bundle.
- Put your bundle next to the SMILA.builder source bundle.
- Add a code/gen folder to your bundle and add it as a source folder.
- Create a schemas directory in your bundle and put the XSD and JXB file there (use the same basename and xsd and jxb as suffixes).
- Create a build.xml in the bundle directory with this content, replace $SCHEMA_NAME with the basename of the XSD/JXB files:
<project name="sub-build" default="compile-schema-and-decorate" basedir="."> <property name="schema.name" value="$SCHEMA_NAME" /> <import file="../SMILA.builder/xjc/build.xml" /> </project>
You can optionally add a file copyright.txt to the bundle (next to build.xml) containing a copyright header for the generated files (use valid Java comment syntax).