Ice.Blobject

class Ice.Blobject

Bases: Object, ABC

Special-purpose servant base class that allows a subclass to handle Ice invocations as “blobs” of bytes.

This class serves as a base for creating servants that can process encoded Ice operation arguments and return results or exceptions in an encoded form. Subclasses must implement the ice_invoke method to handle the invocation logic.

abstractmethod ice_invoke(bytes: bytes, current: Current) → tuple[bool, bytes] | Awaitable[tuple[bool, bytes]]

Dispatches an incoming invocation.

The operation’s arguments are encoded in the bytes parameter. The return value must be a tuple of two values: the first is a boolean indicating whether the operation succeeded (True) or raised a user exception (False), and the second is the encoded form of the operation’s results or the user exception. You can return an empty byte sequence as the second value when the operation returns no results; the Ice runtime then marshals an empty encapsulation.

Parameters:

  • bytes (bytes) – The encoded operation arguments.

  • current (Ice.Current) – The current invocation context.

Returns:

  • bool True if the operation succeeded, False if it raised a user exception.

  • bytes The encoded form of the operation’s results or the user exception.

Return type:

tuple[bool, bytes] | Awaitable[tuple[bool, bytes]]