feat(jdk8): move files to new folder to avoid resources compiled.
This commit is contained in:
159
jdkSrc/jdk8/javax/naming/event/EventDirContext.java
Normal file
159
jdkSrc/jdk8/javax/naming/event/EventDirContext.java
Normal file
@@ -0,0 +1,159 @@
|
||||
/*
|
||||
* Copyright (c) 1999, 2010, 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.
|
||||
*/
|
||||
|
||||
package javax.naming.event;
|
||||
import javax.naming.Name;
|
||||
import javax.naming.NamingException;
|
||||
import javax.naming.directory.DirContext;
|
||||
import javax.naming.directory.SearchControls;
|
||||
|
||||
/**
|
||||
* Contains methods for registering listeners to be notified
|
||||
* of events fired when objects named in a directory context changes.
|
||||
*<p>
|
||||
* The methods in this interface support identification of objects by
|
||||
* <A HREF="http://www.ietf.org/rfc/rfc2254.txt">RFC 2254</a>
|
||||
* search filters.
|
||||
*
|
||||
*<P>Using the search filter, it is possible to register interest in objects
|
||||
* that do not exist at the time of registration but later come into existence and
|
||||
* satisfy the filter. However, there might be limitations in the extent
|
||||
* to which this can be supported by the service provider and underlying
|
||||
* protocol/service. If the caller submits a filter that cannot be
|
||||
* supported in this way, <tt>addNamingListener()</tt> throws an
|
||||
* <tt>InvalidSearchFilterException</tt>.
|
||||
*<p>
|
||||
* See <tt>EventContext</tt> for a description of event source
|
||||
* and target, and information about listener registration/deregistration
|
||||
* that are also applicable to methods in this interface.
|
||||
* See the
|
||||
* <a href=package-summary.html#THREADING>package description</a>
|
||||
* for information on threading issues.
|
||||
*<p>
|
||||
* A <tt>SearchControls</tt> or array object
|
||||
* passed as a parameter to any method is owned by the caller.
|
||||
* The service provider will not modify the object or keep a reference to it.
|
||||
*
|
||||
* @author Rosanna Lee
|
||||
* @author Scott Seligman
|
||||
* @since 1.3
|
||||
*/
|
||||
|
||||
public interface EventDirContext extends EventContext, DirContext {
|
||||
/**
|
||||
* Adds a listener for receiving naming events fired
|
||||
* when objects identified by the search filter <tt>filter</tt> at
|
||||
* the object named by target are modified.
|
||||
* <p>
|
||||
* The scope, returningObj flag, and returningAttributes flag from
|
||||
* the search controls <tt>ctls</tt> are used to control the selection
|
||||
* of objects that the listener is interested in,
|
||||
* and determines what information is returned in the eventual
|
||||
* <tt>NamingEvent</tt> object. Note that the requested
|
||||
* information to be returned might not be present in the <tt>NamingEvent</tt>
|
||||
* object if they are unavailable or could not be obtained by the
|
||||
* service provider or service.
|
||||
*
|
||||
* @param target The nonnull name of the object resolved relative to this context.
|
||||
* @param filter The nonnull string filter (see RFC2254).
|
||||
* @param ctls The possibly null search controls. If null, the default
|
||||
* search controls are used.
|
||||
* @param l The nonnull listener.
|
||||
* @exception NamingException If a problem was encountered while
|
||||
* adding the listener.
|
||||
* @see EventContext#removeNamingListener
|
||||
* @see javax.naming.directory.DirContext#search(javax.naming.Name, java.lang.String, javax.naming.directory.SearchControls)
|
||||
*/
|
||||
void addNamingListener(Name target, String filter, SearchControls ctls,
|
||||
NamingListener l) throws NamingException;
|
||||
|
||||
/**
|
||||
* Adds a listener for receiving naming events fired when
|
||||
* objects identified by the search filter <tt>filter</tt> at the
|
||||
* object named by the string target name are modified.
|
||||
* See the overload that accepts a <tt>Name</tt> for details of
|
||||
* how this method behaves.
|
||||
*
|
||||
* @param target The nonnull string name of the object resolved relative to this context.
|
||||
* @param filter The nonnull string filter (see RFC2254).
|
||||
* @param ctls The possibly null search controls. If null, the default
|
||||
* search controls is used.
|
||||
* @param l The nonnull listener.
|
||||
* @exception NamingException If a problem was encountered while
|
||||
* adding the listener.
|
||||
* @see EventContext#removeNamingListener
|
||||
* @see javax.naming.directory.DirContext#search(java.lang.String, java.lang.String, javax.naming.directory.SearchControls)
|
||||
*/
|
||||
void addNamingListener(String target, String filter, SearchControls ctls,
|
||||
NamingListener l) throws NamingException;
|
||||
|
||||
/**
|
||||
* Adds a listener for receiving naming events fired
|
||||
* when objects identified by the search filter <tt>filter</tt> and
|
||||
* filter arguments at the object named by the target are modified.
|
||||
* The scope, returningObj flag, and returningAttributes flag from
|
||||
* the search controls <tt>ctls</tt> are used to control the selection
|
||||
* of objects that the listener is interested in,
|
||||
* and determines what information is returned in the eventual
|
||||
* <tt>NamingEvent</tt> object. Note that the requested
|
||||
* information to be returned might not be present in the <tt>NamingEvent</tt>
|
||||
* object if they are unavailable or could not be obtained by the
|
||||
* service provider or service.
|
||||
*
|
||||
* @param target The nonnull name of the object resolved relative to this context.
|
||||
* @param filter The nonnull string filter (see RFC2254).
|
||||
* @param filterArgs The possibly null array of arguments for the filter.
|
||||
* @param ctls The possibly null search controls. If null, the default
|
||||
* search controls are used.
|
||||
* @param l The nonnull listener.
|
||||
* @exception NamingException If a problem was encountered while
|
||||
* adding the listener.
|
||||
* @see EventContext#removeNamingListener
|
||||
* @see javax.naming.directory.DirContext#search(javax.naming.Name, java.lang.String, java.lang.Object[], javax.naming.directory.SearchControls)
|
||||
*/
|
||||
void addNamingListener(Name target, String filter, Object[] filterArgs,
|
||||
SearchControls ctls, NamingListener l) throws NamingException;
|
||||
|
||||
/**
|
||||
* Adds a listener for receiving naming events fired when
|
||||
* objects identified by the search filter <tt>filter</tt>
|
||||
* and filter arguments at the
|
||||
* object named by the string target name are modified.
|
||||
* See the overload that accepts a <tt>Name</tt> for details of
|
||||
* how this method behaves.
|
||||
*
|
||||
* @param target The nonnull string name of the object resolved relative to this context.
|
||||
* @param filter The nonnull string filter (see RFC2254).
|
||||
* @param filterArgs The possibly null array of arguments for the filter.
|
||||
* @param ctls The possibly null search controls. If null, the default
|
||||
* search controls is used.
|
||||
* @param l The nonnull listener.
|
||||
* @exception NamingException If a problem was encountered while
|
||||
* adding the listener.
|
||||
* @see EventContext#removeNamingListener
|
||||
* @see javax.naming.directory.DirContext#search(java.lang.String, java.lang.String, java.lang.Object[], javax.naming.directory.SearchControls) */
|
||||
void addNamingListener(String target, String filter, Object[] filterArgs,
|
||||
SearchControls ctls, NamingListener l) throws NamingException;
|
||||
}
|
||||
Reference in New Issue
Block a user