Java BDK Clients

The following steps describe how to generate the Oracle Beehive RESTful Web services value objects using JAXB:

1. Ensure that the JAXB libraries are in your class path.

2. Download the following XSD files:

   • <Host name and port of your Oracle Beehive HTTP server> /comb/v1/schema-obh-xjc.xsd

   • <Host name and port of your Oracle Beehive HTTP server> /comb/v1/schema-obr.xsd

3. Generate value objects by running the JAXB XJC schema binding compiler, xjc, with the schema files schema-obh-xjc.xsd and schema-obr.xsd and the -extension option:

   Microsoft Windows:

                                              
   <JAXB directory>\bin\xjc.bat schema-obh-xjc.xsd schema-obr.xsd -extension
                                           

   Linux and UNIX-based operating systems:

                                              
   <JAXB directory>/bin/xjc.sh schema-obh-xjc.xsd schema-obr.xsd -extension
                                           

4. Add the classes contained in the packages com.oracle.beehive and com.oracle.beehive.rest (which you generated with xjc in the previous step) to your project.

5. You may receive the following error message when using the generated classes:

   com.sun.istack.SAXException2: unable to marshal type "com.oracle.beehive.
                                             
   className" as an element because it is missing an @XmlRootElement annotation
                                           

   If you get this error message, manually add the @XmlRootElement annotation to the generated Java source file of className and add the following import statement:

   import javax.xml.bind.annotation.XmlRootElement;
   

   For example, suppose you encountered the following error message:

   com.sun.istack.SAXException2: unable to marshal type "com.oracle.beehive.PredicateAndSortListParameters" as an element because it is missing an @XmlRootElement annotation
   

   You would import the class javax.xml.bind.annotation.XmlRootElement and add the highlighted line to the generated source file PredicateAndSortListParameters.java as follows:

                                              
   @XmlRootElement(name="predicateAndSortListParameters")
   public class PredicateAndSortListParameters
       extends PredicateListParameters
   {