mirror of
https://github.com/openjdk/jdk.git
synced 2026-02-12 19:35:24 +00:00
55039aa1c6
Reviewed-by: darcy, lancea, bpb, prr, jjg, cjplummer, iris, dfuchs, weijun, joehw, wetmore, bchristi
91 lines
3.5 KiB
HTML
91 lines
3.5 KiB
HTML
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
|
|
<html>
|
|
<head>
|
|
<!--
|
|
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
|
|
under the terms of the GNU General Public License version 2 only, as
|
|
published by the Free Software Foundation. Oracle designates this
|
|
particular file as subject to the "Classpath" exception as provided
|
|
by Oracle in the LICENSE file that accompanied this code.
|
|
|
|
This code is distributed in the hope that it will be useful, but WITHOUT
|
|
ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
|
|
FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
|
|
version 2 for more details (a copy is included in the LICENSE file that
|
|
accompanied this code).
|
|
|
|
You should have received a copy of the GNU General Public License version
|
|
2 along with this work; if not, write to the Free Software Foundation,
|
|
Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
|
|
|
|
Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
|
|
or visit www.oracle.com if you need additional information or have any
|
|
questions.
|
|
-->
|
|
</head>
|
|
<body bgcolor="white">
|
|
|
|
Extends the <code>javax.naming</code> package to provide functionality
|
|
for accessing directory services.
|
|
|
|
<p>
|
|
This package defines the directory operations of the Java Naming and
|
|
Directory Interface (JNDI).
|
|
JNDI provides naming and directory functionality to applications
|
|
written in the Java programming language. It is designed to be
|
|
independent of any specific naming or directory service
|
|
implementation. Thus a variety of services--new, emerging, and
|
|
already deployed ones--can be accessed in a common way.
|
|
|
|
<p>
|
|
This package allows applications to retrieve and update attributes
|
|
associated with objects stored in a directory, and to search for
|
|
objects using specified attributes.
|
|
|
|
<h2>The Directory Context</h2>
|
|
|
|
The <code>DirContext</code>
|
|
interface represents a <em>directory context</em>.
|
|
It defines methods for examining and updating attributes associated with a
|
|
<em>directory object</em>, or <em>directory entry</em> as it is sometimes
|
|
called.
|
|
<p>
|
|
You use <code>getAttributes()</code> to retrieve the attributes
|
|
associated with a directory object (for which you supply the name).
|
|
Attributes are modified using <code>modifyAttributes()</code>.
|
|
You can add, replace, or remove attributes and/or attribute values
|
|
using this operation.
|
|
<p>
|
|
<code>DirContext</code> also behaves as a naming context
|
|
by extending the <code>Context</code> interface in the <code>javax.naming</code> package.
|
|
This means that any directory object can also provide
|
|
a naming context.
|
|
For example, the directory object for a person might contain
|
|
the attributes of that person, and at the same time provide
|
|
a context for naming objects relative to that person
|
|
such as his printers and home directory.
|
|
|
|
<h3>Searches</h3>
|
|
<code>DirContext</code> contains methods for
|
|
performing content-based searching of the directory.
|
|
In the simplest and most common form of usage, the application
|
|
specifies a set of attributes--possibly with specific
|
|
values--to match, and submits this attribute set, to the
|
|
<code>search()</code> method.
|
|
There are other overloaded forms of <code>search()</code>
|
|
that support more sophisticated <em>search filters</em>.
|
|
|
|
|
|
<h2>Package Specification</h2>
|
|
|
|
The JNDI API Specification and related documents can be found in the
|
|
{@extLink jndi_overview JNDI documentation}.
|
|
|
|
@since 1.3
|
|
|
|
</body>
|
|
</html>
|