1 /*
2 * Copyright (c) 2014, 2020, Oracle and/or its affiliates. All rights reserved.
3 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
4 *
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
7 * published by the Free Software Foundation. Oracle designates this
8 * particular file as subject to the "Classpath" exception as provided
9 * by Oracle in the LICENSE file that accompanied this code.
10 *
11 * This code is distributed in the hope that it will be useful, but WITHOUT
12 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
13 * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
14 * version 2 for more details (a copy is included in the LICENSE file that
15 * accompanied this code).
16 *
17 * You should have received a copy of the GNU General Public License version
18 * 2 along with this work; if not, write to the Free Software Foundation,
19 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
20 *
21 * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
22 * or visit www.oracle.com if you need additional information or have any
23 * questions.
24 */
25
26 /**
27 * Defines the Java Naming and Directory Interface (JNDI) API.
28 * <p>
29 * Common standard JNDI environment properties that may be supported
30 * by JNDI providers are defined and documented in
31 * {@link javax.naming.Context}. Specific JNDI provider implementations
32 * may also support other environment properties, which are specific
33 * to their implementation.
34 *
35 * @implNote
36 * The following implementation specific properties are supported by the
37 * default LDAP Naming Service Provider implementation in the JDK:
38 * <ul>
39 * <li>{@code com.sun.jndi.ldap.connect.timeout}:
40 * <br>The value of this property is the string representation
41 * of an integer representing the connection timeout in
42 * milliseconds. If the LDAP provider cannot establish a
43 * connection within that period, it aborts the connection attempt.
44 * The integer should be greater than zero. An integer less than
45 * or equal to zero means to use the network protocol's (i.e., TCP's)
46 * timeout value.
47 * <br> If this property is not specified, the default is to wait
48 * for the connection to be established or until the underlying
49 * network times out.
50 * </li>
51 * <li>{@code com.sun.jndi.ldap.read.timeout}:
52 * <br>The value of this property is the string representation
53 * of an integer representing the read timeout in milliseconds
54 * for LDAP operations. If the LDAP provider cannot get a LDAP
55 * response within that period, it aborts the read attempt. The
56 * integer should be greater than zero. An integer less than or
57 * equal to zero means no read timeout is specified which is equivalent
58 * to waiting for the response infinitely until it is received.
59 * <br>If this property is not specified, the default is to wait
60 * for the response until it is received.
61 * </li>
62 * </ul>
63 *
64 * @provides javax.naming.ldap.spi.LdapDnsProvider
65 *
66 * @uses javax.naming.ldap.spi.LdapDnsProvider
67 *
68 * @moduleGraph
69 * @since 9
70 */
71 module java.naming {
72 requires java.security.sasl;
73
74 exports javax.naming;
75 exports javax.naming.directory;
76 exports javax.naming.event;
77 exports javax.naming.ldap;
78 exports javax.naming.spi;
79 exports javax.naming.ldap.spi;
80
81 exports com.sun.jndi.toolkit.ctx to
82 jdk.naming.dns;
83 exports com.sun.jndi.toolkit.url to
84 jdk.naming.dns,
85 jdk.naming.rmi;
86
87 uses javax.naming.ldap.StartTlsResponse;
88 uses javax.naming.spi.InitialContextFactory;
89 uses javax.naming.ldap.spi.LdapDnsProvider;
90
91 provides java.security.Provider with
92 sun.security.provider.certpath.ldap.JdkLDAP;
93 }