--- old/src/java.naming/share/classes/javax/naming/Context.java 2019-03-13 15:10:07.000000000 -0400 +++ new/src/java.naming/share/classes/javax/naming/Context.java 2019-03-13 15:10:06.000000000 -0400 @@ -1,5 +1,5 @@ /* - * Copyright (c) 1999, 2017, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 1999, 2019, 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 @@ -32,7 +32,7 @@ * consists of a set of name-to-object bindings. * It contains methods for examining and updating these bindings. * - *

Names

+ *

Names

* Each name passed as an argument to a {@code Context} method is relative * to that context. The empty name is used to name the context itself. * A name parameter may never be null. @@ -69,12 +69,12 @@ * names in a composite namespace, at the discretion of the service * provider. * - *

Exceptions

+ *

Exceptions

* All the methods in this interface can throw a {@code NamingException} or * any of its subclasses. See {@code NamingException} and their subclasses * for details on each exception. * - *

Concurrent Access

+ *

Concurrent Access

* A Context instance is not guaranteed to be synchronized against * concurrent access by multiple threads. Threads that need to access * a single Context instance concurrently should synchronize amongst @@ -91,7 +91,7 @@ * being followed. * * - *

Parameters

+ *

Parameters

* A {@code Name} parameter passed to any method of the * {@code Context} interface or one of its subinterfaces * will not be modified by the service provider. @@ -103,7 +103,7 @@ * The caller may subsequently modify it; the service provider may not. * * - *

Environment Properties

+ *

Environment Properties

*

* JNDI applications need a way to communicate various preferences * and properties that define the environment in which naming and @@ -138,7 +138,7 @@ * *

* - *

Resource Files

+ *

Resource Files

*

* To simplify the task of setting up the environment * required by a JNDI application, @@ -165,7 +165,7 @@ * There are two kinds of JNDI resource files: * provider and application. * - *

Provider Resource Files

+ *

Provider Resource Files

* * Each service provider has an optional resource that lists properties * specific to that provider. The name of this resource is: @@ -200,7 +200,7 @@ * The service provider's documentation should clearly state which * properties are allowed; other properties in the file will be ignored. * - *

Application Resource Files

+ *

Application Resource Files

* * When an application is deployed, it will generally have several * codebase directories and JARs in its classpath. JNDI locates (using @@ -228,7 +228,7 @@ * collects and uses all of these export lists when searching for factory * classes. * - *

Search Algorithm for Properties

+ *

Search Algorithm for Properties

* * When JNDI constructs an initial context, the context's environment * is initialized with properties defined in the environment parameter