equal
deleted
inserted
replaced
1 /* |
1 /* |
2 * Copyright (c) 1999, 2014, Oracle and/or its affiliates. All rights reserved. |
2 * Copyright (c) 1999, 2015, Oracle and/or its affiliates. All rights reserved. |
3 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. |
3 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. |
4 * |
4 * |
5 * This code is free software; you can redistribute it and/or modify it |
5 * This code is free software; you can redistribute it and/or modify it |
6 * under the terms of the GNU General Public License version 2 only, as |
6 * under the terms of the GNU General Public License version 2 only, as |
7 * published by the Free Software Foundation. Oracle designates this |
7 * published by the Free Software Foundation. Oracle designates this |
23 * questions. |
23 * questions. |
24 */ |
24 */ |
25 |
25 |
26 package javax.naming.spi; |
26 package javax.naming.spi; |
27 |
27 |
|
28 import java.net.MalformedURLException; |
28 import java.util.*; |
29 import java.util.*; |
29 import java.net.MalformedURLException; |
30 |
30 |
31 |
31 import javax.naming.*; |
32 import javax.naming.*; |
32 import com.sun.naming.internal.VersionHelper; |
33 import com.sun.naming.internal.VersionHelper; |
33 import com.sun.naming.internal.ResourceManager; |
34 import com.sun.naming.internal.ResourceManager; |
34 import com.sun.naming.internal.FactoryEnumeration; |
35 import com.sun.naming.internal.FactoryEnumeration; |
241 * interface should use this method. |
242 * interface should use this method. |
242 * <p> |
243 * <p> |
243 * Note that an object factory (an object that implements the ObjectFactory |
244 * Note that an object factory (an object that implements the ObjectFactory |
244 * interface) must be public and must have a public constructor that |
245 * interface) must be public and must have a public constructor that |
245 * accepts no arguments. |
246 * accepts no arguments. |
|
247 * In cases where the factory is in a named module then it must be in a |
|
248 * package which is exported by that module to the {@code java.naming} |
|
249 * module. |
246 * <p> |
250 * <p> |
247 * The {@code name} and {@code nameCtx} parameters may |
251 * The {@code name} and {@code nameCtx} parameters may |
248 * optionally be used to specify the name of the object being created. |
252 * optionally be used to specify the name of the object being created. |
249 * {@code name} is the name of the object, relative to context |
253 * {@code name} is the name of the object, relative to context |
250 * {@code nameCtx}. This information could be useful to the object |
254 * {@code nameCtx}. This information could be useful to the object |
523 * "ldap://ldap.umich.edu/o=umich,c=us", ...). |
527 * "ldap://ldap.umich.edu/o=umich,c=us", ...). |
524 *<p> |
528 *<p> |
525 * Note that an object factory (an object that implements the ObjectFactory |
529 * Note that an object factory (an object that implements the ObjectFactory |
526 * interface) must be public and must have a public constructor that |
530 * interface) must be public and must have a public constructor that |
527 * accepts no arguments. |
531 * accepts no arguments. |
|
532 * In cases where the factory is in a named module then it must be in a |
|
533 * package which is exported by that module to the {@code java.naming} |
|
534 * module. |
528 * |
535 * |
529 * @param scheme The non-null scheme-id of the URLs supported by the context. |
536 * @param scheme The non-null scheme-id of the URLs supported by the context. |
530 * @param environment The possibly null environment properties to be |
537 * @param environment The possibly null environment properties to be |
531 * used in the creation of the object factory and the context. |
538 * used in the creation of the object factory and the context. |
532 * @return A context for resolving URLs with the |
539 * @return A context for resolving URLs with the |
639 * <li>Failing that, this implementation tries to locate a suitable |
646 * <li>Failing that, this implementation tries to locate a suitable |
640 * {@code InitialContextFactory} using a built-in mechanism |
647 * {@code InitialContextFactory} using a built-in mechanism |
641 * <br> |
648 * <br> |
642 * (Note that an initial context factory (an object that implements |
649 * (Note that an initial context factory (an object that implements |
643 * the InitialContextFactory interface) must be public and must have |
650 * the InitialContextFactory interface) must be public and must have |
644 * a public constructor that accepts no arguments)</li> |
651 * a public constructor that accepts no arguments. |
|
652 * In cases where the factory is in a named module then it must |
|
653 * be in a package which is exported by that module to the |
|
654 * {@code java.naming} module.)</li> |
645 * </ul> |
655 * </ul> |
646 * </li> |
656 * </li> |
647 * </ul> |
657 * </ul> |
648 * @param env The possibly null environment properties used when |
658 * @param env The possibly null environment properties used when |
649 * creating the context. |
659 * creating the context. |
845 * <p> |
855 * <p> |
846 * Note that a state factory |
856 * Note that a state factory |
847 * (an object that implements the StateFactory |
857 * (an object that implements the StateFactory |
848 * interface) must be public and must have a public constructor that |
858 * interface) must be public and must have a public constructor that |
849 * accepts no arguments. |
859 * accepts no arguments. |
|
860 * In cases where the factory is in a named module then it must be in a |
|
861 * package which is exported by that module to the {@code java.naming} |
|
862 * module. |
850 * <p> |
863 * <p> |
851 * The {@code name} and {@code nameCtx} parameters may |
864 * The {@code name} and {@code nameCtx} parameters may |
852 * optionally be used to specify the name of the object being created. |
865 * optionally be used to specify the name of the object being created. |
853 * See the description of "Name and Context Parameters" in |
866 * See the description of "Name and Context Parameters" in |
854 * {@link ObjectFactory#getObjectInstance |
867 * {@link ObjectFactory#getObjectInstance |