summaryrefslogtreecommitdiff
path: root/cpp/slice/Ice/LocalException.ice
diff options
context:
space:
mode:
Diffstat (limited to 'cpp/slice/Ice/LocalException.ice')
-rw-r--r--cpp/slice/Ice/LocalException.ice124
1 files changed, 54 insertions, 70 deletions
diff --git a/cpp/slice/Ice/LocalException.ice b/cpp/slice/Ice/LocalException.ice
index e915e302604..e0c3738037a 100644
--- a/cpp/slice/Ice/LocalException.ice
+++ b/cpp/slice/Ice/LocalException.ice
@@ -59,6 +59,9 @@ local exception CollocationOptimizationException
/**
*
+ * An attempt was made to register something more than once with
+ * the Ice run time.
+ *
* This exception is raised if an attempt is made to register a
* servant, servant locator, facet, object factory, plug-in, object
* adapter, object, or user exception factory more than once for the
@@ -86,6 +89,9 @@ local exception AlreadyRegisteredException
/**
*
+ * An attempt was made to deregister something that is not
+ * registered with the Ice run time.
+ *
* This exception is raised if an attempt is made to remove a servant,
* facet, object factory, plug-in, object adapter, object, or user
* exception factory that is not currently registered.
@@ -112,6 +118,8 @@ local exception NotRegisteredException
/**
*
+ * The operation can only be invoked with a twoway request.
+ *
* This exception is raised if an attempt is made to invoke an
* operation with [ice_oneway], [ice_batchOneway], [ice_datagram],
* or [ice_batchDatagram] and the operation has a return value,
@@ -130,6 +138,9 @@ local exception TwowayOnlyException
/**
*
+ * An attempt was made to clone a class that does not support
+ * cloning.
+ *
* This exception is raised if [ice_clone] is called on
* a class that is derived from an abstract Slice class (that is,
* a class containing operations), and the derived class does not
@@ -180,7 +191,9 @@ local exception UnknownLocalException extends UnknownException
/**
*
- * This exception is raised if an operation call on a server raises a
+ * An operation raised an incorrect user exception.
+ *
+ * This exception is raised if an operation raises a
* user exception that is not declared in the exception's
* <tt>throws</tt> clause. Such undeclared exceptions are
* not transmitted from the server to the client by the Ice
@@ -237,8 +250,9 @@ local exception ObjectAdapterDeactivatedException
/**
*
- * This exception is raised if an [ObjectAdapter] cannot be activated
- * because the [Locator] detected another active [ObjectAdapter] with
+ * This exception is raised if an [ObjectAdapter] cannot be activated.
+ *
+ * This happens if the [Locator] detects another active [ObjectAdapter] with
* the same adapter id.
*
**/
@@ -422,8 +436,7 @@ local exception SyscallException
/**
*
- * This exception is a specialization of [SyscallException] for socket
- * errors.
+ * This exception indicates socket errors.
*
**/
local exception SocketException extends SyscallException
@@ -432,8 +445,7 @@ local exception SocketException extends SyscallException
/**
*
- * This exception is a specialization of [SyscallException] for file
- * errors.
+ * This exception indicates file errors.
*
**/
local exception FileException extends SyscallException
@@ -444,8 +456,7 @@ local exception FileException extends SyscallException
/**
*
- * This exception is a specialization of [SocketException] for
- * connection failures.
+ * This exception indicates connection failures.
*
**/
local exception ConnectFailedException extends SocketException
@@ -454,9 +465,8 @@ local exception ConnectFailedException extends SocketException
/**
*
- * This exception is a specialization of [ConnectFailedException] for
- * connection failures, where the server host actively refuses a
- * connection.
+ * This exception indicates a connection failure for which
+ * the server host actively refuses a connection.
*
**/
local exception ConnectionRefusedException extends ConnectFailedException
@@ -465,8 +475,7 @@ local exception ConnectionRefusedException extends ConnectFailedException
/**
*
- * This exception is a specialization of [SocketException], indicating
- * a lost connection.
+ * This exception indicates a lost connection.
*
**/
local exception ConnectionLostException extends SocketException
@@ -510,8 +519,7 @@ local exception TimeoutException
/**
*
- * This exception is a specialization of [TimeoutException] for
- * connection establishment timeout conditions.
+ * This exception indicates a connection establishment timeout condition.
*
**/
local exception ConnectTimeoutException extends TimeoutException
@@ -520,8 +528,7 @@ local exception ConnectTimeoutException extends TimeoutException
/**
*
- * This exception is a specialization of [TimeoutException] for
- * connection closure timeout conditions.
+ * This exception indicates a connection closure timeout condition.
*
**/
local exception CloseTimeoutException extends TimeoutException
@@ -530,8 +537,7 @@ local exception CloseTimeoutException extends TimeoutException
/**
*
- * This exception is a specialization of [TimeoutException], and
- * indicates that a connection has been shut down because it has been
+ * This exception indicates that a connection has been shut down because it has been
* idle for some time.
*
**/
@@ -557,8 +563,7 @@ local exception ProtocolException
/**
*
- * This exception is a specialization of [ProtocolException],
- * indicating that a message did not start with the expected
+ * This exception indicates that a message did not start with the expected
* magic number ('I', 'c', 'e', 'P').
*
**/
@@ -574,9 +579,7 @@ local exception BadMagicException extends ProtocolException
/**
*
- * This exception is a specialization of [ProtocolException],
- * indicating that an unsupported protocol version has been
- * encountered.
+ * This exception indicates an unsupported protocol version.
*
**/
local exception UnsupportedProtocolException extends ProtocolException
@@ -612,9 +615,7 @@ local exception UnsupportedProtocolException extends ProtocolException
/**
*
- * This exception is a specialization of [ProtocolException],
- * indicating that an unsupported data encoding version has been
- * encountered.
+ * This exception indicates an unsupported data encoding version.
*
**/
local exception UnsupportedEncodingException extends ProtocolException
@@ -650,8 +651,7 @@ local exception UnsupportedEncodingException extends ProtocolException
/**
*
- * This exception is a specialization of [ProtocolException],
- * indicating that an unknown protocol message has been received.
+ * This exception indicates that an unknown protocol message has been received.
*
**/
local exception UnknownMessageException extends ProtocolException
@@ -660,9 +660,8 @@ local exception UnknownMessageException extends ProtocolException
/**
*
- * This exception is a specialization of [ProtocolException], that is
- * raised if a message is received over a connection that is not yet
- * validated.
+ * This exception is raised if a message is received over a connection
+ * that is not yet validated.
*
**/
local exception ConnectionNotValidatedException extends ProtocolException
@@ -671,8 +670,7 @@ local exception ConnectionNotValidatedException extends ProtocolException
/**
*
- * This exception is a specialization of [ProtocolException],
- * indicating that a response for an unknown request ID has been
+ * This exception indicates that a response for an unknown request ID has been
* received.
*
**/
@@ -682,8 +680,7 @@ local exception UnknownRequestIdException extends ProtocolException
/**
*
- * This exception is a specialization of [ProtocolException],
- * indicating that an unknown reply status has been received.
+ * This exception indicates that an unknown reply status has been received.
*
**/
local exception UnknownReplyStatusException extends ProtocolException
@@ -692,8 +689,7 @@ local exception UnknownReplyStatusException extends ProtocolException
/**
*
- * This exception is a specialization of [ProtocolException],
- * indicating that the connection has been gracefully shut down by the
+ * This exception indicates that the connection has been gracefully shut down by the
* server. The operation call that caused this exception has not been
* executed by the server. In most cases you will not get this
* exception, because the client will automatically retry the
@@ -710,8 +706,7 @@ local exception CloseConnectionException extends ProtocolException
/**
*
* This exception is raised by an operation call if the application
- * forcefully closes the connection used by this call with
- * [Connection::close].
+ * forcefully closes the connection [Connection::close].
*
* @see Connection::close
*
@@ -722,9 +717,8 @@ local exception ForcedCloseConnectionException extends ProtocolException
/**
*
- * This exception is a specialization of [ProtocolException],
- * indicating that the message size is illegal, i.e., it is
- * less than the minimum required size.
+ * This exception indicates that a message size is less
+ * than the minimum required size.
*
**/
local exception IllegalMessageSizeException extends ProtocolException
@@ -733,9 +727,7 @@ local exception IllegalMessageSizeException extends ProtocolException
/**
*
- * This exception is a specialization of [ProtocolException] that is
- * raised if there is a problem with compressing or uncompressing
- * data.
+ * This exception indicates a problem with compressing or uncompressing data.
*
**/
local exception CompressionException extends ProtocolException
@@ -744,8 +736,9 @@ local exception CompressionException extends ProtocolException
/**
*
- * This exception is a specialization of [ProtocolException] that is
- * raised if a datagram exceeds the configured send or receive buffer
+ * A datagram exceeds the configured size.
+ *
+ * This exception is raised if a datagram exceeds the configured send or receive buffer
* size, or exceeds the maximum payload size of a UDP packet (65507 bytes).
*
**/
@@ -755,8 +748,7 @@ local exception DatagramLimitException extends ProtocolException
/**
*
- * This exception is a specialization of [ProtocolException] that is
- * raised upon an error during marshaling or unmarshaling data.
+ * This exception is raised for errors during marshaling or unmarshaling data.
*
**/
local exception MarshalException extends ProtocolException
@@ -765,8 +757,7 @@ local exception MarshalException extends ProtocolException
/**
*
- * This exception is a specialization of [MarshalException] that is
- * raised if inconsistent data is received while unmarshaling a proxy.
+ * This exception is raised if inconsistent data is received while unmarshaling a proxy.
*
**/
local exception ProxyUnmarshalException extends MarshalException
@@ -775,8 +766,7 @@ local exception ProxyUnmarshalException extends MarshalException
/**
*
- * This exception is a specialization of [MarshalException] that is
- * raised if an out-of-bounds condition occurs during unmarshaling.
+ * This exception is raised if an out-of-bounds condition occurs during unmarshaling.
*
**/
local exception UnmarshalOutOfBoundsException extends MarshalException
@@ -785,8 +775,7 @@ local exception UnmarshalOutOfBoundsException extends MarshalException
/**
*
- * This exception is a specialization of [MarshalException],
- * indicating an illegal indirection during unmarshaling.
+ * This exception indicates an illegal indirection during unmarshaling.
*
**/
local exception IllegalIndirectionException extends MarshalException
@@ -795,8 +784,7 @@ local exception IllegalIndirectionException extends MarshalException
/**
*
- * This exception is a specialization of [MarshalException] that is
- * raised if no suitable object factory was found during
+ * This exception is raised if no suitable object factory was found during
* unmarshaling of a Slice class instance.
*
* @see ObjectFactory
@@ -817,9 +805,8 @@ local exception NoObjectFactoryException extends MarshalException
/**
*
- * This exception is a specialization of [MarshalException] that is
- * raised if the type of an unmarshaled Slice class instance does
- * not match the type excepted by an operation that is passed that instance.
+ * This exception is raised if the type of an unmarshaled Slice class instance does
+ * not match its expected type.
* This can happen if client and server are compiled with mismatched Slice
* definitions or if a class of the wrong type is passed as a parameter
* or return value using dynamic invocation. This exception can also be
@@ -846,8 +833,7 @@ local exception UnexpectedObjectException extends MarshalException
/**
*
- * This exception is a specialization of [MarshalException] that is
- * raised if the system-specific memory limit is exceeded during
+ * This exception is raised if the system-specific memory limit is exceeded during
* marshaling or unmarshaling.
*
**/
@@ -857,7 +843,7 @@ local exception MemoryLimitException extends MarshalException
/**
*
- * This exception is a specialization of [MarshalException] that is
+ * This exception is
* raised when a string conversion to or from UTF-8 fails during
* marshaling or unmarshaling.
*
@@ -869,8 +855,7 @@ local exception StringConversionException extends MarshalException
/**
*
- * This exception is a specialization of [MarshalException],
- * indicating a malformed data encapsulation.
+ * This exception indicates a malformed data encapsulation.
*
**/
local exception EncapsulationException extends MarshalException
@@ -879,9 +864,8 @@ local exception EncapsulationException extends MarshalException
/**
*
- * This exception is a specialization of [MarshalException] that is
- * raised if a negative size (e.g., a negative sequence size) is
- * received.
+ * This exception is raised if a negative size
+ * (e.g., a negative sequence size) is received.
*
**/
local exception NegativeSizeException extends MarshalException