/*
 * Copyright (c) 1999, 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;

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. For example, Context.destroy() requires that the named object be a context. If it is not, NotContextException is thrown. Another example is a non-context being encountered during the resolution phase of the Context methods.

It is also thrown when a particular subtype of context is required, such as a DirContext, and the resolved object is a context but not of the required subtype.

Synchronization and serialization issues that apply to NamingException apply directly here.

Author:Rosanna Lee, Scott Seligman
See Also:
  • destroySubcontext.destroySubcontext
Since:1.3
/** * 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. For example, Context.destroy() requires * that the named object be a context. If it is not, NotContextException * is thrown. Another example is a non-context being encountered during * the resolution phase of the Context methods. *<p> * It is also thrown when a particular subtype of context is required, * such as a DirContext, and the resolved object is a context but not of * the required subtype. * <p> * Synchronization and serialization issues that apply to NamingException * apply directly here. * @see Context#destroySubcontext * * @author Rosanna Lee * @author Scott Seligman * @since 1.3 */
public class NotContextException extends NamingException {
Constructs a new instance of NotContextException using an explanation. All other fields default to null.
Params:
  • explanation – Possibly null additional detail about this exception.
See Also:
/** * Constructs a new instance of NotContextException using an * explanation. All other fields default to null. * * @param explanation Possibly null additional detail about this exception. * @see java.lang.Throwable#getMessage */
public NotContextException(String explanation) { super(explanation); }
Constructs a new instance of NotContextException. All fields default to null.
/** * Constructs a new instance of NotContextException. * All fields default to null. */
public NotContextException() { super(); }
Use serialVersionUID from JNDI 1.1.1 for interoperability
/** * Use serialVersionUID from JNDI 1.1.1 for interoperability */
private static final long serialVersionUID = 849752551644540417L; }