Class JAXBContextFactory


  • public class JAXBContextFactory
    extends java.lang.Object
    This class implements the actual logic of JAXBContext.newInstance(java.lang.String).

    This class works as a facade and all the actual work is delegated to a JAXB provider that happens to be in the runtime (not necessarily the JAXB RI.) This allows the generated code to be run with any JAXB provider.

    This code is only used when XJC generates interfaces/implementations.

    The trick to make this work is two ObjectFactory classes that we generate in the interface/implementation mode.

    The public ObjectFactory follows the spec, and this is the one that's exposed to users. The public ObjectFactory refers to interfaces, so they aren't directly usable by a JAXB 2.0 implementation.

    The private one lives in the impl package, and this one is indistinguishable from the ObjectFactory that we generate for the value class generation mode. This private ObjectFactory refers to implementation classes, which are also indistinguishable from value classes that JAXB generates.

    All in all, the private ObjectFactory plus implementation classes give a JAXB provider an illusion that they are dealing with value classes that happens to implement some interfaces.

    In this way, the JAXB RI can provide the portability even for the interface/implementation generation mode.

    Since:
    2.0
    Author:
    Kohsuke Kawaguchi
    • Method Summary

      All Methods Static Methods Concrete Methods 
      Modifier and Type Method Description
      static javax.xml.bind.JAXBContext createContext​(java.lang.Class[] classes, java.util.Map properties)
      The JAXB API will invoke this method via reflection
      static javax.xml.bind.JAXBContext createContext​(java.lang.String contextPath, java.lang.ClassLoader classLoader, java.util.Map properties)
      The JAXB API will invoke this method via reflection
      • Methods inherited from class java.lang.Object

        clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
    • Constructor Detail

      • JAXBContextFactory

        public JAXBContextFactory()
    • Method Detail

      • createContext

        public static javax.xml.bind.JAXBContext createContext​(java.lang.Class[] classes,
                                                               java.util.Map properties)
                                                        throws javax.xml.bind.JAXBException
        The JAXB API will invoke this method via reflection
        Throws:
        javax.xml.bind.JAXBException
      • createContext

        public static javax.xml.bind.JAXBContext createContext​(java.lang.String contextPath,
                                                               java.lang.ClassLoader classLoader,
                                                               java.util.Map properties)
                                                        throws javax.xml.bind.JAXBException
        The JAXB API will invoke this method via reflection
        Throws:
        javax.xml.bind.JAXBException