Skip to main content
Jump to: navigation, search

Difference between revisions of "SMILA/Development Guidelines/Setup for JAXB code generation"

(→‎Generate Sources from Command line)
 
(16 intermediate revisions by 4 users not shown)
Line 1: Line 1:
 
=== Introduction ===
 
=== 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.
+
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.
−
 
+
  
 
=== Steps to install needed libraries ===
 
=== 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 {{path|lib/}} as the root of it.
 
# Setup a build library as described in [[SMILA/Development Guidelines/Howto build a SMILA-Distribution]]. In this document we will use {{path|lib/}} as the root of it.
−
# Download the JAXB reference implementation 2.1.6 or above from [https://jaxb.dev.java.net/servlets/ProjectDocumentList here]
+
# The required JAXB compiler libraries are contained in our [http://ubuntuone.com/312LdFKCXLYfapEpxLMR9v package of the SMILA build libraries]. If you want to collect them on your own, use these instructions:
−
# unpack it with (see [https://jaxb.dev.java.net/2.1.6/  here]) <source lang="text">java -jar <JAXB-version>.jar </source>   
+
## Download the JAXB reference implementation 2.1.6 or above from [http://jaxb.java.net/ http://jaxb.java.net/]
−
# copy the following into your <tt>lib/xjc</tt>  
+
## unpack it with (see [https://jaxb.dev.java.net/2.1.6/  here]) <source lang="text">java -jar <JAXB-version>.jar </source>   
−
#* all jars in the {{path|jaxb-ri-<version>/lib/}}  
+
## copy the following into your <tt>lib/xjc</tt>  
−
#* <tt>InterfacesXJCPlugin.jar</tt> that you can get [http://xml.w-wins.com/xjc-plugins/interfaces here]  
+
##* all jars in the {{path|jaxb-ri-<version>/lib/}}  
 +
##* <tt>InterfacesXJCPlugin.jar</tt>, you can download it [https://www.dropbox.com/s/fiegug07oygn9uk/InterfacesXJCPlugin.jar 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">
 
lib/
 
lib/
 
   ant-contrib/
 
   ant-contrib/
−
       ant-contrib-1.0b1.jar
+
       ant-contrib-1.0b3.jar
 
   xjc/
 
   xjc/
 +
      jaxb-api.jar
 +
      jaxb-impl.jar
 
       jaxb-xjc.jar
 
       jaxb-xjc.jar
 
       InterfacesXJCPlugin.jar
 
       InterfacesXJCPlugin.jar
−
      activation.jar
 
−
      jaxb-api.jar
 
−
      jaxb-impl.jar
 
−
      jsr173_1.0_api.jar     
 
 
</source>
 
</source>
  
Line 34: Line 33:
  
 
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.
−
 
−
{{note| JDK 1.5 needed |
 
−
 
−
This setup works correctly only when using a JDK 1.5 to run <tt>ant</tt>. With JDK 1.6 you'll get a message like this:
 
−
 
−
<source lang="text">
 
−
java.util.ServiceConfigurationError: com.sun.tools.xjc.Plugin:
 
−
Provider com.w_wins.xml.xjcplugins.InterfacePlugin could not be instantiated:
 
−
java.lang.ClassCastException
 
−
</source>
 
−
 
−
We are looking for a version of this plugin that works with JDK 1.6, too. Any hints are welcome.
 
−
}}
 
−
 
−
{{note| Setup alternative with JDK 1.6 |
 
−
 
−
[http://giorgiosironi.blogspot.com Giorgio Sironi] pointed us to a possibility to get the JAXB generation running with JDK 1.6:
 
−
 
−
* Download the "Distribution" from [http://confluence.highsource.org/display/J2B/Home]
 
−
* From the ZIP, copy <tt>jaxb2-basics-dist-0.5.2/dist/jaxb2-basics-ant-0.5.2.jar</tt> to <tt><SMILA-Build-Lib-Dir>/xjc</tt>.
 
−
* in <tt>SMILA.builder/xjc/build.xml</tt> edit the task definition for <tt>xjc</tt>:
 
−
<source lang="text">
 
−
  <!-- original version: <taskdef name="xjc" classname="com.sun.tools.xjc.XJCTask">, replace with: -->
 
−
  <taskdef name="xjc" classname="org.jvnet.jaxb2_commons.xjc.XJC2Task">
 
−
</source>
 
−
 
−
Now the above instructions should work using a JDK 1.6, too. Thanks, Giorgio!
 
−
}}
 
−
 
−
=== 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.
 
−
# Copy <tt>org.eclipse.smila.connectivity.framework.schema_0.5.0.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.
 
−
# Add a <tt>code/gen</tt> folder to your bundle and add it as a source folder.
 
−
# Create a <tt>schemas</tt> directory in your bundle and put the XSD and JXB file there (use the same basename and <tt>xsd</tt> and <tt>jxb</tt> as suffixes).
 
−
# Create a <tt>build.xml</tt> in the bundle directory with this content, replace $SCHEMA_NAME with the basename of the XSD/JXB files:
 
−
 
−
<source lang="xml">
 
−
<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>
 
−
</source>
 
−
 
−
You can optionally add a file <tt>copyright.txt</tt> to the bundle (next to build.xml) containing a copyright header for the generated files (use valid Java comment syntax).
 
  
  
 
[[Category:SMILA]]
 
[[Category:SMILA]]

Latest revision as of 04:23, 22 April 2014

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.

Steps to install needed libraries

  1. 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.
  2. The required JAXB compiler libraries are contained in our package of the SMILA build libraries. If you want to collect them on your own, use these instructions:
    1. Download the JAXB reference implementation 2.1.6 or above from http://jaxb.java.net/
    2. unpack it with (see here) 
      java -jar <JAXB-version>.jar
    3. 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.0b3.jar
   xjc/
      jaxb-api.jar
      jaxb-impl.jar
      jaxb-xjc.jar
      InterfacesXJCPlugin.jar

Generate Sources from Command line

  1. 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).
  2. 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.

Retrieved from "https://wiki.eclipse.org/index.php?title=SMILA/Development_Guidelines/Setup_for_JAXB_code_generation&oldid=360892"

This page was last modified 04:23, 22 April 2014 by Juergen Schumacher. Based on work by Juergen Schumacher, Daniel Stucky and Juergen Schumacher and others.

Back to the top