Chapter 36. The org.omg.CosNaming. NamingContextPackage Package

The org.omg.CosNaming.NamingContextPackage package defines the exceptions thrown by various methods on the org.omg.CORBA.CosNaming.NamingContext interface. This package consists of these exceptions, along with their helper and holder interfaces. Figure 36-1 shows the class hierarchy for the package.

Figure 36-1. The org.omg.CosNaming.NamingContextPackage package

AlreadyBound

Java 1.2

org.omg.CosNaming.NamingContextPackage

serializable checked

An exception thrown by the bind(), bind_context(), and bind_new_context() methods on NamingContext when you attempt to bind an object to a name that already has an object bound to it.

public final class AlreadyBound extends org.omg.CORBA.UserExceptionimplements org.omg.CORBA.portable.IDLEntity {
//	Public Constructors
	public AlreadyBound ();
}

Hierarchy: Object-->Throwable(Serializable)-->Exception-->org.omg.CORBA.UserException(org.omg.CORBA.portable.IDLEntity(Serializable))-->AlreadyBound(org.omg.CORBA.portable.IDLEntity(Serializable))

Passed To: AlreadyBoundHelper.{insert(), write()}, AlreadyBoundHolder.AlreadyBoundHolder()

Returned By: AlreadyBoundHelper.{extract(), read()}

Thrown By: _NamingContextImplBase.{bind(), bind_context(), bind_new_context()}, _NamingContextStub.{bind(), bind_context(), bind_new_context()}, NamingContext.{bind(), bind_context(), bind_new_context()}

Type Of: AlreadyBoundHolder.value

AlreadyBoundHelper

Java 1.2

org.omg.CosNaming.NamingContextPackage

The helper class for the AlreadyBound exception.

public class AlreadyBoundHelper {
//	No Constructor
//	Public Class Methods
	public static AlreadyBound extract (org.omg.CORBA.Any a);
	public static String id ();
	public static void insert (org.omg.CORBA.Any a, AlreadyBound that);
	public static AlreadyBound read (org.omg.CORBA.portable.InputStream in);
	public static org.omg.CORBA.TypeCode type ();	synchronized
	public static void write (org.omg.CORBA.portable.OutputStream out, AlreadyBound that);
}

AlreadyBoundHolder

Java 1.2

org.omg.CosNaming.NamingContextPackage

The holder class for out and inout IDL method arguments that are mapped to Java AlreadyBound exceptions.

public final class AlreadyBoundHolder implements org.omg.CORBA.portable.Streamable {
//	Public Constructors
	public AlreadyBoundHolder ();
	public AlreadyBoundHolder (AlreadyBound __arg);
//	Methods implementing Streamable
	public void _read (org.omg.CORBA.portable.InputStream in);
	public org.omg.CORBA.TypeCode _type ();
	public void _write (org.omg.CORBA.portable.OutputStream out);
//	Public Instance Fields
	public AlreadyBound value ;
}

Hierarchy: Object-->AlreadyBoundHolder(org.omg.CORBA.portable.Streamable)

CannotProceed

Java 1.2

org.omg.CosNaming.NamingContextPackage

serializable checked

An exception thrown by any of the bind or rebind methods on the NamingContext interface, when the NamingContext has given up trying to bind the object to the name specified, for some reason not covered by the other exceptions thrown by these methods. The CannotProceed exception contains a NamingContext that is the last context it attempted to traverse, and a NameComponent array, which is the remainder of the name specified in the method call, relative to the context.

public final class CannotProceed extends org.omg.CORBA.UserExceptionimplements org.omg.CORBA.portable.IDLEntity {
//	Public Constructors
	public CannotProceed ();
	public CannotProceed (NamingContext __cxt, NameComponent[ ] __rest_of_name);
//	Public Instance Fields
	public NamingContext cxt ;
	public NameComponent[ ] rest_of_name ;
}

Hierarchy: Object-->Throwable(Serializable)-->Exception-->org.omg.CORBA.UserException(org.omg.CORBA.portable.IDLEntity(Serializable))-->CannotProceed(org.omg.CORBA.portable.IDLEntity(Serializable))

Passed To: CannotProceedHelper.{insert(), write()}, CannotProceedHolder.CannotProceedHolder()

Returned By: CannotProceedHelper.{extract(), read()}

Thrown By: _NamingContextImplBase.{bind(), bind_context(), bind_new_context(), rebind(), rebind_context(), resolve(), unbind()}, _NamingContextStub.{bind(), bind_context(), bind_new_context(), rebind(), rebind_context(), resolve(), unbind()}, NamingContext.{bind(), bind_context(), bind_new_context(), rebind(), rebind_context(), resolve(), unbind()}

Type Of: CannotProceedHolder.value

CannotProceedHelper

Java 1.2

org.omg.CosNaming.NamingContextPackage

The helper class for the CannotProceed exception.

public class CannotProceedHelper {
//	No Constructor
//	Public Class Methods
	public static CannotProceed extract (org.omg.CORBA.Any a);
	public static String id ();
	public static void insert (org.omg.CORBA.Any a, CannotProceed that);
	public static CannotProceed read (org.omg.CORBA.portable.InputStream in);
	public static org.omg.CORBA.TypeCode type ();	synchronized
	public static void write (org.omg.CORBA.portable.OutputStream out, CannotProceed that);
}

CannotProceedHolder

Java 1.2

org.omg.CosNaming.NamingContextPackage

The holder class for out and inout IDL method arguments that are mapped to Java CannotProceed exceptions.

public final class CannotProceedHolder implements org.omg.CORBA.portable.Streamable {
//	Public Constructors
	public CannotProceedHolder ();
	public CannotProceedHolder (CannotProceed __arg);
//	Methods implementing Streamable
	public void _read (org.omg.CORBA.portable.InputStream in);
	public org.omg.CORBA.TypeCode _type ();
	public void _write (org.omg.CORBA.portable.OutputStream out);
//	Public Instance Fields
	public CannotProceed value ;
}

Hierarchy: Object-->CannotProceedHolder(org.omg.CORBA.portable.Streamable)

InvalidName

Java 1.2

org.omg.CosNaming.NamingContextPackage

serializable checked

An exception thrown by any of the NamingContext methods for binding, resolving, or unbinding objects, when the specified name is invalid (e.g., it contains invalid characters).

public final class InvalidName extends org.omg.CORBA.UserExceptionimplements org.omg.CORBA.portable.IDLEntity {
//	Public Constructors
	public InvalidName ();
}

Hierarchy: Object-->Throwable(Serializable)-->Exception-->org.omg.CORBA.UserException(org.omg.CORBA.portable.IDLEntity(Serializable))-->org.omg.CosNaming.NamingContextPackage.InvalidName(org.omg.CORBA.portable.IDLEntity(Serializable))

Passed To: InvalidNameHelper.{insert(), write()}, InvalidNameHolder.InvalidNameHolder()

Returned By: InvalidNameHelper.{extract(), read()}

Type Of: InvalidNameHolder.value

InvalidNameHelper

Java 1.2

org.omg.CosNaming.NamingContextPackage

The helper class for the InvalidName exception.

public class InvalidNameHelper {
//	No Constructor
//	Public Class Methods
	public static org.omg.CosNaming.NamingContextPackage.InvalidName extract (org.omg.CORBA.Any a);
	public static String id ();
	public static void insert (org.omg.CORBA.Any a, org.omg.CosNaming.NamingContextPackage.InvalidName that);
	public static org.omg.CosNaming.NamingContextPackage.InvalidName read (org.omg.CORBA.portable.InputStream in);
	public static org.omg.CORBA.TypeCode type ();	synchronized
	public static void write (org.omg.CORBA.portable.OutputStream out, org.omg.CosNaming.NamingContextPackage.InvalidName that);
}

InvalidNameHolder

Java 1.2

org.omg.CosNaming.NamingContextPackage

The holder class for out and inout IDL method arguments that are mapped to Java InvalidName exceptions.

public final class InvalidNameHolder implements org.omg.CORBA.portable.Streamable {
//	Public Constructors
	public InvalidNameHolder ();
	public InvalidNameHolder (org.omg.CosNaming.NamingContextPackage.InvalidName __arg);
//	Methods implementing Streamable
	public void _read (org.omg.CORBA.portable.InputStream in);
	public org.omg.CORBA.TypeCode _type ();
	public void _write (org.omg.CORBA.portable.OutputStream out);
//	Public Instance Fields
	public org.omg.CosNaming.NamingContextPackage.InvalidName value ;
}

Hierarchy: Object-->InvalidNameHolder(org.omg.CORBA.portable.Streamable)

NotEmpty

Java 1.2

org.omg.CosNaming.NamingContextPackage

serializable checked

An exception thrown by the NamingContext.destroy() method, if you attempt to destroy a NamingContext that still has bindings within it.

public final class NotEmpty extends org.omg.CORBA.UserExceptionimplements org.omg.CORBA.portable.IDLEntity {
//	Public Constructors
	public NotEmpty ();
}

Hierarchy: Object-->Throwable(Serializable)-->Exception-->org.omg.CORBA.UserException(org.omg.CORBA.portable.IDLEntity(Serializable))-->NotEmpty(org.omg.CORBA.portable.IDLEntity(Serializable))

Passed To: NotEmptyHelper.{insert(), write()}, NotEmptyHolder.NotEmptyHolder()

Returned By: NotEmptyHelper.{extract(), read()}

Thrown By: _NamingContextImplBase.destroy(), _NamingContextStub.destroy(), NamingContext.destroy()

Type Of: NotEmptyHolder.value

NotEmptyHelper

Java 1.2

org.omg.CosNaming.NamingContextPackage

The helper class for the NotEmpty exception.

public class NotEmptyHelper {
//	No Constructor
//	Public Class Methods
	public static NotEmpty extract (org.omg.CORBA.Any a);
	public static String id ();
	public static void insert (org.omg.CORBA.Any a, NotEmpty that);
	public static NotEmpty read (org.omg.CORBA.portable.InputStream in);
	public static org.omg.CORBA.TypeCode type ();	synchronized
	public static void write (org.omg.CORBA.portable.OutputStream out, NotEmpty that);
}

NotEmptyHolder

Java 1.2

org.omg.CosNaming.NamingContextPackage

The holder class for out and inout IDL method arguments that are mapped to Java NotEmpty exceptions.

public final class NotEmptyHolder implements org.omg.CORBA.portable.Streamable {
//	Public Constructors
	public NotEmptyHolder ();
	public NotEmptyHolder (NotEmpty __arg);
//	Methods implementing Streamable
	public void _read (org.omg.CORBA.portable.InputStream in);
	public org.omg.CORBA.TypeCode _type ();
	public void _write (org.omg.CORBA.portable.OutputStream out);
//	Public Instance Fields
	public NotEmpty value ;
}

Hierarchy: Object-->NotEmptyHolder(org.omg.CORBA.portable.Streamable)

NotFound

Java 1.2

org.omg.CosNaming.NamingContextPackage

serializable checked

An exception thrown by any of the NamingContext methods for binding, resolving, or unbinding object names, when a specified name is not found as a binding within the NamingContext. The NotFound exception contains a NameComponent array, which represents the remainder of the name after the first component mismatch was found, and a NotFoundReason object, that contains an int value that indicates whether the operation failed because one of the components in the name was not found, one of the intermediate components was bound to a regular object instead of a context, or the final component was not bound to an object.

public final class NotFound extends org.omg.CORBA.UserExceptionimplements org.omg.CORBA.portable.IDLEntity {
//	Public Constructors
	public NotFound ();
	public NotFound (NotFoundReason __why, NameComponent[ ] __rest_of_name);
//	Public Instance Fields
	public NameComponent[ ] rest_of_name ;
	public NotFoundReason why ;
}

Hierarchy: Object-->Throwable(Serializable)-->Exception-->org.omg.CORBA.UserException(org.omg.CORBA.portable.IDLEntity(Serializable))-->NotFound(org.omg.CORBA.portable.IDLEntity(Serializable))

Passed To: NotFoundHelper.{insert(), write()}, NotFoundHolder.NotFoundHolder()

Returned By: NotFoundHelper.{extract(), read()}

Type Of: NotFoundHolder.value

NotFoundHelper

Java 1.2

org.omg.CosNaming.NamingContextPackage

The helper class for the NotFound exception.

public class NotFoundHelper {
//	No Constructor
//	Public Class Methods
	public static NotFound extract (org.omg.CORBA.Any a);
	public static String id ();
	public static void insert (org.omg.CORBA.Any a, NotFound that);
	public static NotFound read (org.omg.CORBA.portable.InputStream in);
	public static org.omg.CORBA.TypeCode type ();	synchronized
	public static void write (org.omg.CORBA.portable.OutputStream out, NotFound that);
}

NotFoundHolder

Java 1.2

org.omg.CosNaming.NamingContextPackage

The holder class for out and inout IDL method arguments that are mapped to Java NotFound exceptions.

public final class NotFoundHolder implements org.omg.CORBA.portable.Streamable {
//	Public Constructors
	public NotFoundHolder ();
	public NotFoundHolder (NotFound __arg);
//	Methods implementing Streamable
	public void _read (org.omg.CORBA.portable.InputStream in);
	public org.omg.CORBA.TypeCode _type ();
	public void _write (org.omg.CORBA.portable.OutputStream out);
//	Public Instance Fields
	public NotFound value ;
}

Hierarchy: Object-->NotFoundHolder(org.omg.CORBA.portable.Streamable)

NotFoundReason

Java 1.2

org.omg.CosNaming.NamingContextPackage

serializable

NotFoundReason objects are used in NotFound exceptions to indicate the reason an object binding was not found in a NamingContext. It has a value() method that returns an int which can then be compared to its three static int members to determine the reason for the failure. A value of _missing_node indicates that an intermediate component of the name specified was not found in the context, _not_context indicates that an intermediate component name was not bound to a NamingContext, and _not_object indicates that an object was not bound to the final component in the name.

public final class NotFoundReason implements org.omg.CORBA.portable.IDLEntity {
//	No Constructor
//	Public Constants
	public static final int _missing_node ;	=0
	public static final int _not_context ;	=1
	public static final int _not_object ;	=2
	public static final NotFoundReason missing_node ;
	public static final NotFoundReason not_context ;
	public static final NotFoundReason not_object ;
//	Public Class Methods
	public static final NotFoundReason from_int (int i) throws org.omg.CORBA.BAD_PARAM;
//	Public Instance Methods
	public int value ();
}

Hierarchy: Object-->NotFoundReason(org.omg.CORBA.portable.IDLEntity(Serializable))

Passed To: NotFound.NotFound(), NotFoundReasonHelper.{insert(), write()}, NotFoundReasonHolder.NotFoundReasonHolder()

Returned By: NotFoundReason.from_int(), NotFoundReasonHelper.{extract(), read()}

Type Of: NotFound.why, NotFoundReason.{missing_node, not_context, not_object}, NotFoundReasonHolder.value

NotFoundReasonHelper

Java 1.2

org.omg.CosNaming.NamingContextPackage

The helper class for the NotFoundReason class.

public class NotFoundReasonHelper {
//	No Constructor
//	Public Class Methods
	public static NotFoundReason extract (org.omg.CORBA.Any a);
	public static String id ();
	public static void insert (org.omg.CORBA.Any a, NotFoundReason that);
	public static NotFoundReason read (org.omg.CORBA.portable.InputStream in);
	public static org.omg.CORBA.TypeCode type ();	synchronized
	public static void write (org.omg.CORBA.portable.OutputStream out, NotFoundReason that);
}

NotFoundReasonHolder

Java 1.2

org.omg.CosNaming.NamingContextPackage

The holder class for out and inout IDL method arguments that are mapped to Java NotFoundReason objects.

public final class NotFoundReasonHolder implements org.omg.CORBA.portable.Streamable {
//	Public Constructors
	public NotFoundReasonHolder ();
	public NotFoundReasonHolder (NotFoundReason __arg);
//	Methods implementing Streamable
	public void _read (org.omg.CORBA.portable.InputStream in);
	public org.omg.CORBA.TypeCode _type ();
	public void _write (org.omg.CORBA.portable.OutputStream out);
//	Public Instance Fields
	public NotFoundReason value ;
}

Hierarchy: Object-->NotFoundReasonHolder(org.omg.CORBA.portable.Streamable)