package-summary.html

API資料大全

<TD WIDTH="15%"><B><A HREF="NamingSecurityException.html">NamingSecurityException</A></B></TD>
<TD>This is the superclass of security-related exceptions 
 thrown by operations in the Context and DirContext interfaces.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD WIDTH="15%"><B><A HREF="NoInitialContextException.html">NoInitialContextException</A></B></TD>
<TD>This exception is thrown when no initial context implementation
 can be created.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD WIDTH="15%"><B><A HREF="NoPermissionException.html">NoPermissionException</A></B></TD>
<TD>This exception is thrown when attempting to perform an operation
 for which the client has no permission.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD WIDTH="15%"><B><A HREF="NotContextException.html">NotContextException</A></B></TD>
<TD>This exception is thrown when a naming operation proceeds to a point
 where a context is required to continue the operation, but the
 resolved object is not a context.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD WIDTH="15%"><B><A HREF="OperationNotSupportedException.html">OperationNotSupportedException</A></B></TD>
<TD>This exception is thrown when a context implementation does not support
 the operation being invoked.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD WIDTH="15%"><B><A HREF="PartialResultException.html">PartialResultException</A></B></TD>
<TD>This exception is thrown to indicate that the result being returned
 or returned so far is partial, and that the operation cannot
 be completed.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD WIDTH="15%"><B><A HREF="ReferralException.html">ReferralException</A></B></TD>
<TD>This abstract class is used to represent a referral exception,
 which is generated in response to a <em>referral</em>
 such as that returned by LDAP v3 servers.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD WIDTH="15%"><B><A HREF="ServiceUnavailableException.html">ServiceUnavailableException</A></B></TD>
<TD>This exception is thrown when attempting to communcate with a
 directory or naming service and that service is not available.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD WIDTH="15%"><B><A HREF="SizeLimitExceededException.html">SizeLimitExceededException</A></B></TD>
<TD>This exception is thrown when a method
 produces a result that exceeds a size-related limit.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD WIDTH="15%"><B><A HREF="TimeLimitExceededException.html">TimeLimitExceededException</A></B></TD>
<TD>This exception is thrown when a method
 does not terminate within the specified time limit.</TD>
</TR>
</TABLE>
&nbsp;

<P>
<A NAME="package_description"><!-- --></A><H2>
Package javax.naming Description
</H2>

<P>
Provides the classes and interfaces for accessing naming services.

<p>
This package defines the naming operations of the Java Naming and
Directory Interface<font size=-2><sup>TM</sup></font> (JNDI). &nbsp;
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.


<h4>Context</h4>
<p>
This package defines the notion of a <em>context</em>, represented
by the <tt>Context</tt> interface.
A context consists of a set of name-to-object <em>bindings</em>.
<tt>Context</tt> is the core interface for looking up, binding, unbinding, 
and renaming objects, and for creating and destroying subcontexts.
<p>
<tt>lookup()</tt> is the most commonly used operation.
You supply <tt>lookup()</tt>
the name of the object you want
to look up, and it returns the object bound to that name.
For example, the following code fragment looks up 
a printer and sends a document to the printer object
to be printed:

<blockquote>
<pre>
Printer printer = (Printer)ctx.lookup("treekiller");
printer.print(report);
</pre>
</blockquote>

<h4>Names</h4>
<p>
Every naming method in the <tt>Context</tt>
interface has two
overloads: one that accepts a 
<tt>Name</tt> argument and one that accepts a string name.
<tt>Name</tt> is an interface that represents a generic 
name--an ordered sequence of zero of more components.
For these methods, <tt>Name</tt> can be used to represent a
<em>composite name</em> (<tt>CompositeName</tt>)
so that you can name an object using a name which spans multiple namespaces.
<p>
The overloads that accept <tt>Name</tt>
are useful for applications that need to manipulate names: composing
them, comparing components, and so on.
The overloads that accept string names are likely to be more useful
for simple applications, such as those that simply read in a name
and look up the corresponding object.
<p>

<h4>Bindings</h4>

The <tt>Binding</tt> class represents a name-to-object binding.
It is a tuple containing the name of the bound object,
the name of the object's class, and the object itself.
<p>
The <tt>Binding</tt> class is actually a subclass of
<tt>NameClassPair</tt>, which consists
simply of the object's name and the object's class name.
The <tt>NameClassPair</tt> is useful when you only want
information about the object's class and do not want to
pay the extra cost of getting the object.

<h4>References</h4>
Objects are stored in naming and directory services in different ways.
If an object store supports storing Java objects, 
it might support storing an object in its serialized form.
However, some naming and directory services do not support the
storing of Java objects. Furthermore, for some
objects in the directory, Java programs are but one group of applications 
that access them. In this case, a serialized Java object might
not be the most appropriate representation.
JNDI defines a <em>reference</em>, represented by the <tt>Reference</tt>
class, which contains information on how to construct a copy of the object.
JNDI will attempt to turn references looked up from the directory
into the Java objects they represent, so that
JNDI clients have the illusion that what
is stored in the directory are Java objects. 


<h4>The Initial Context</h4>

In JNDI, all naming and directory operations are performed relative
to a context. There are no absolute roots.
Therefore JNDI defines an <em>initial context</em>, 
<tt>InitialContext</tt>,
which provides a starting point for naming and directory operations.
Once you have an initial context, you can use it to
look up other contexts and objects.

<h4>Exceptions</h4>

JNDI defines a class hierarchy for exceptions that can be thrown in
the course of performing naming and directory operations.  The root of
this class hierarchy is <tt>NamingException</tt>.
Programs interested in dealing with a particular exception
can catch the corresponding subclass of the exception.
Otherwise, programs should catch <tt>NamingException</tt>.


<h2>Package Specification</h2>

The following documents can be found at the 
<a href=http://java.sun.com/products/jndi>Java technology web site</a>:

<ul>
  <li><a href="ftp://ftp.javasoft.com/docs/j2se1.3/jndi.ps">JNDI API
Document (Postscript)</a>
  <li><a href="ftp://ftp.javasoft.com/docs/j2se1.3/jndi.pdf">JNDI API
Document (PDF)</a>
</ul>

<h2>Related Documentation</h2>

For a tutorial, examples, and overview, please see:
<ul>
  <li><a href="http://java.sun.com/products/jndi/tutorial">The JNDI Tutorial</a>
  <li><a href="http://java.sun.com/products/jndi/examples.html">Examples</a>
  <li><a href="ftp://ftp.javasoft.com/docs/j2se1.3/jndiexecsumm.ps">
Executive Summary (Postscript)</a>
  <li><a href="ftp://ftp.javasoft.com/docs/j2se1.3/jndiexecsumm.pdf">
Executive Summary (PDF)</a>
</ul>
<P>
<DL>
<DT><B>Since: </B><DD>1.3</DD>
</DL>
<HR>

<!-- ========== START OF NAVBAR ========== -->
<A NAME="navbar_bottom"><!-- --></A>
<TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0">
<TR>
<TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
<A NAME="navbar_bottom_firstrow"><!-- --></A>
<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3">
  <TR ALIGN="center" VALIGN="top">
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> &nbsp;<FONT CLASS="NavBarFont1Rev"><B>Package</B></FONT>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <FONT CLASS="NavBarFont1">Class</FONT>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-use.html"><FONT CLASS="NavBarFont1"><B>Use</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../index-files/index-1.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A>&nbsp;</TD>
  </TR>
</TABLE>
</TD>
<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
<b>Java<sup><font size=-2>TM</font></sup>&nbsp;2&nbsp;Platform<br>Std.&nbsp;Ed. v1.3</b></EM>
</TD>
</TR>

<TR>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
&nbsp;<A HREF="../../javax/accessibility/package-summary.html"><B>PREV PACKAGE</B></A>&nbsp;
&nbsp;<A HREF="../../javax/naming/directory/package-summary.html"><B>NEXT PACKAGE</B></A></FONT></TD>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
  <A HREF="../../index.html" TARGET="_top"><B>FRAMES</B></A>  &nbsp;
&nbsp;<A HREF="package-summary.html" TARGET="_top"><B>NO FRAMES</B></A></FONT></TD>
</TR>
</TABLE>
<!-- =========== END OF NAVBAR =========== -->

<HR>
<font size="-1"><a href="http://java.sun.com/cgi-bin/bugreport.cgi">Submit a bug or feature</a><br>For further API reference and developer documentation, see <a href="http://java.sun.com/products/jdk/1.3/devdocs-vs-specs.html">Java 2 SDK SE Developer Documentation</a>. That documentation  contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples. <p>Java, Java 2D, and JDBC are trademarks or registered trademarks of Sun Microsystems, Inc. in the US and other countries.<br>Copyright 1993-2000 Sun Microsystems, Inc. 901 San Antonio Road<br>Palo Alto, California, 94303, U.S.A.  All Rights Reserved.</font>
</BODY>
</HTML>