Javadoc package.html and overview.html with external bindings

From: Andrew Hughes <azza_at_lisasoft.com>
Date: Mon, 15 May 2006 11:59:39 +0930

Hey All,

Im using external bindings....

I want to add a "package" summary for my generated package/classes and also would like an "overview" of the API I'm creating with jaxb. I'm writing one xjb per xls for logical reasons, so I have several xjb's that add classes to the one package. From what I read <javadoc> is not global, so I dont know how to create these in my situation.

My javadocs are also faily large, so I would like to keep them as seperate html files rather than place them as CDATA inside the xjb's. Sure I could use ant to copy the package.html files into the bound classes directory, but this seems like a function of the binding operation. Maybe I will have to copy them in with my ant target????

How can I add the "package.html / summary" to my external bindings????? Help would be very much appreciated.

My xjb customization files:

<jxb:bindings version="1.0"
               xmlns:jxb="http://java.sun.com/xml/ns/jaxb"
               xmlns:xs="http://www.w3.org/2001/XMLSchema">
    <jxb:bindings schemaLocation="../../../my/xsd/Foo.xsd" node="/xs:schema">
        
        <jxb:bindings node="//xs:element[@name='_Foo']">
            <jxb:class name="FooImpl"/>
        </jxb:bindings>
    </jxb:bindings>
</jxb:bindings>

<jxb:bindings version="1.0"
               xmlns:jxb="http://java.sun.com/xml/ns/jaxb"
               xmlns:xs="http://www.w3.org/2001/XMLSchema">
    <jxb:bindings schemaLocation="../../../my/xsd/Bar.xsd" node="/xs:schema">
        
        <jxb:bindings node="//xs:element[@name='_Bar']">
            <jxb:class name="BarImpl"/>
        </jxb:bindings>
    </jxb:bindings>
</jxb:bindings>

<jxb:bindings version="1.0"
               xmlns:jxb="http://java.sun.com/xml/ns/jaxb"
               xmlns:xs="http://www.w3.org/2001/XMLSchema">
    <jxb:bindings schemaLocation="../../../my/xsd/Base.xsd" node="/xs:schema">
        
        <jxb:bindings node="//xs:complexType[@name='BaseType']//xs:attribute[@name='version']">
             <jxb:property name="version">
                 <jxb:baseType name="java.lang.String">
                    <jxb:javaType name="java.lang.String"/>
                 </jxb:baseType>
             </jxb:property>
           </jxb:bindings>
    </jxb:bindings>
</jxb:bindings>

Cheers,

AH