src/java.xml.bind/share/classes/javax/xml/bind/JAXBContextFactory.java

*** 1,7 ****
  /*
!  * Copyright (c) 2015, Oracle and/or its affiliates. All rights reserved.
   * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
   *
   * This code is free software; you can redistribute it and/or modify it
   * under the terms of the GNU General Public License version 2 only, as
   * published by the Free Software Foundation.  Oracle designates this
--- 1,7 ----
  /*
!  * Copyright (c) 2015, 2016, Oracle and/or its affiliates. All rights reserved.
   * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
   *
   * This code is free software; you can redistribute it and/or modify it
   * under the terms of the GNU General Public License version 2 only, as
   * published by the Free Software Foundation.  Oracle designates this
*** 54,71 ****
       * @return
       *      A new instance of a {@code JAXBContext}.
       *
       * @throws JAXBException
       *      if an error was encountered while creating the
!      *      {@code JAXBContext}, such as (but not limited to):
!      * <ol>
!      *  <li>Classes use JAXB annotations incorrectly
!      *  <li>Classes have colliding annotations (i.e., two classes with the same type name)
!      *  <li>The JAXB implementation was unable to locate
!      *      provider-specific out-of-band information (such as additional
!      *      files generated at the development time.)
!      * </ol>
       *
       * @throws IllegalArgumentException
       *      if the parameter contains {@code null} (i.e., {@code newInstance(null,someMap);})
       *
       * @since 9, JAXB 2.3
--- 54,64 ----
       * @return
       *      A new instance of a {@code JAXBContext}.
       *
       * @throws JAXBException
       *      if an error was encountered while creating the
!      *      {@code JAXBContext}. See {@link JAXBContext#newInstance(Class[], Map)} for details.
       *
       * @throws IllegalArgumentException
       *      if the parameter contains {@code null} (i.e., {@code newInstance(null,someMap);})
       *
       * @since 9, JAXB 2.3
*** 79,89 ****
       *
       * <p>
       * For semantics see {@link javax.xml.bind.JAXBContext#newInstance(String, ClassLoader, java.util.Map)}
       *
       * <p>
!      * The interpretation of properties is up to implementations. Implementations should
       * throw {@code JAXBException} if it finds properties that it doesn't understand.
       *
       * @param contextPath list of java package names that contain schema derived classes
       * @param classLoader
       *      This class loader will be used to locate the implementation classes.
--- 72,82 ----
       *
       * <p>
       * For semantics see {@link javax.xml.bind.JAXBContext#newInstance(String, ClassLoader, java.util.Map)}
       *
       * <p>
!      * The interpretation of properties is up to implementations. Implementations must
       * throw {@code JAXBException} if it finds properties that it doesn't understand.
       *
       * @param contextPath list of java package names that contain schema derived classes
       * @param classLoader
       *      This class loader will be used to locate the implementation classes.
*** 91,107 ****
       *      provider-specific properties. Can be null, which means the same thing as passing
       *      in an empty map.
       *
       * @return a new instance of a {@code JAXBContext}
       * @throws JAXBException if an error was encountered while creating the
!      *                       {@code JAXBContext} such as
!      * <ol>
!      *   <li>failure to locate either ObjectFactory.class or jaxb.index in the packages</li>
!      *   <li>an ambiguity among global elements contained in the contextPath</li>
!      *   <li>failure to locate a value for the context factory provider property</li>
!      *   <li>mixing schema derived packages from different providers on the same contextPath</li>
!      * </ol>
       * @since 9, JAXB 2.3
       */
      JAXBContext createContext(String contextPath,
                                ClassLoader classLoader,
                                Map<String, ?> properties ) throws JAXBException;
--- 84,95 ----
       *      provider-specific properties. Can be null, which means the same thing as passing
       *      in an empty map.
       *
       * @return a new instance of a {@code JAXBContext}
       * @throws JAXBException if an error was encountered while creating the
!      *      {@code JAXBContext}. See {@link JAXBContext#newInstance(String, ClassLoader, Map)} for details.
!      *
       * @since 9, JAXB 2.3
       */
      JAXBContext createContext(String contextPath,
                                ClassLoader classLoader,
                                Map<String, ?> properties ) throws JAXBException;