equal
deleted
inserted
replaced
61 * |
61 * |
62 * <p> |
62 * <p> |
63 * <i><B>SPEC REQUIREMENT:</B> the provider must supply an implementation |
63 * <i><B>SPEC REQUIREMENT:</B> the provider must supply an implementation |
64 * class containing the following method signatures:</i> |
64 * class containing the following method signatures:</i> |
65 * |
65 * |
66 * <pre> |
66 * <pre>{@code |
67 * public static JAXBContext createContext( String contextPath, ClassLoader classLoader, Map<String,Object> properties ) throws JAXBException |
67 * public static JAXBContext createContext( String contextPath, ClassLoader classLoader, Map<String,Object> properties ) throws JAXBException |
68 * public static JAXBContext createContext( Class[] classes, Map<String,Object> properties ) throws JAXBException |
68 * public static JAXBContext createContext( Class[] classes, Map<String,Object> properties ) throws JAXBException |
69 * </pre> |
69 * }</pre> |
70 * |
70 * |
71 * <p><i> |
71 * <p><i> |
72 * The following JAXB 1.0 requirement is only required for schema to |
72 * The following JAXB 1.0 requirement is only required for schema to |
73 * java interface/implementation binding. It does not apply to JAXB annotated |
73 * java interface/implementation binding. It does not apply to JAXB annotated |
74 * classes. JAXB Providers must generate a <tt>jaxb.properties</tt> file in |
74 * classes. JAXB Providers must generate a <tt>jaxb.properties</tt> file in |
350 * </ul> |
350 * </ul> |
351 * |
351 * |
352 * <p> |
352 * <p> |
353 * To maintain compatibility with JAXB 1.0 schema to java |
353 * To maintain compatibility with JAXB 1.0 schema to java |
354 * interface/implementation binding, enabled by schema customization |
354 * interface/implementation binding, enabled by schema customization |
355 * <tt><jaxb:globalBindings valueClass="false"></tt>, |
355 * <tt>{@literal <jaxb:globalBindings valueClass="false">}</tt>, |
356 * the JAXB provider will ensure that each package on the context path |
356 * the JAXB provider will ensure that each package on the context path |
357 * has a <tt>jaxb.properties</tt> file which contains a value for the |
357 * has a <tt>jaxb.properties</tt> file which contains a value for the |
358 * <tt>javax.xml.bind.context.factory</tt> property and that all values |
358 * <tt>javax.xml.bind.context.factory</tt> property and that all values |
359 * resolve to the same provider. This requirement does not apply to |
359 * resolve to the same provider. This requirement does not apply to |
360 * JAXB annotated classes. |
360 * JAXB annotated classes. |
524 * context object needs to recognize. |
524 * context object needs to recognize. |
525 * |
525 * |
526 * Not only the new context will recognize all the classes specified, |
526 * Not only the new context will recognize all the classes specified, |
527 * but it will also recognize any classes that are directly/indirectly |
527 * but it will also recognize any classes that are directly/indirectly |
528 * referenced statically from the specified classes. Subclasses of |
528 * referenced statically from the specified classes. Subclasses of |
529 * referenced classes nor <tt>@XmlTransient</tt> referenced classes |
529 * referenced classes nor <tt>@XmlTransient</tt> referenced classes |
530 * are not registered with JAXBContext. |
530 * are not registered with JAXBContext. |
531 * |
531 * |
532 * For example, in the following Java code, if you do |
532 * For example, in the following Java code, if you do |
533 * <tt>newInstance(Foo.class)</tt>, the newly created {@link JAXBContext} |
533 * <tt>newInstance(Foo.class)</tt>, the newly created {@link JAXBContext} |
534 * will recognize both <tt>Foo</tt> and <tt>Bar</tt>, but not <tt>Zot</tt> or <tt>FooBar</tt>: |
534 * will recognize both <tt>Foo</tt> and <tt>Bar</tt>, but not <tt>Zot</tt> or <tt>FooBar</tt>: |