Ice

Enum OperationMode

java.lang.Object

java.lang.Enum<OperationMode>

Ice.OperationMode

All Implemented Interfaces:

java.io.Serializable, java.lang.Comparable<OperationMode>

public enum OperationMode
extends java.lang.Enum<OperationMode>
implements java.io.Serializable

Determines the retry behavior of an invocation in case of a (potentially) recoverable error.

Enum Constant Summary

Enum Constants

Enum Constant and Description
Idempotent Operations that use the Slice idempotent keyword can modify object state, but invoking an operation twice in a row must result in the same object state as invoking it once.
Nonmutating Operations that use the Slice nonmutating keyword must not modify object state.
Normal Ordinary operations have Normal mode.

Method Summary

Modifier and Type	Method and Description
static OperationMode	__read(BasicStream __is)
void	__write(BasicStream __os)
static void	__write(BasicStream __os, OperationMode __v)
int	value()
static OperationMode	valueOf(int __v)
static OperationMode	valueOf(java.lang.String name) Returns the enum constant of this type with the specified name.
static OperationMode[]	values() Returns an array containing the constants of this enum type, in the order they are declared.

Methods inherited from class java.lang.Enum

clone, compareTo, equals, finalize, getDeclaringClass, hashCode, name, ordinal, toString, valueOf

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Enum Constant Detail

Normal

public static final OperationMode Normal

Ordinary operations have Normal mode. These operations modify object state; invoking such an operation twice in a row has different semantics than invoking it once. The Ice run time guarantees that it will not violate at-most-once semantics for Normal operations.

Nonmutating

public static final OperationMode Nonmutating

Operations that use the Slice nonmutating keyword must not modify object state. For C++, nonmutating operations generate const member functions in the skeleton. In addition, the Ice run time will attempt to transparently recover from certain run-time errors by re-issuing a failed request and propagate the failure to the application only if the second attempt fails. Nonmutating is deprecated; Use the idempotent keyword instead. For C++, to retain the mapping of nonmutating operations to C++ const member functions, use the \["cpp:const"] metadata directive.

Idempotent

public static final OperationMode Idempotent

Operations that use the Slice idempotent keyword can modify object state, but invoking an operation twice in a row must result in the same object state as invoking it once. For example, x = 1 is an idempotent statement, whereas x += 1 is not. For idempotent operations, the Ice run-time uses the same retry behavior as for nonmutating operations in case of a potentially recoverable error.

Method Detail

values

public static OperationMode[] values()

Returns an array containing the constants of this enum type, in the order they are declared. This method may be used to iterate over the constants as follows:

for (OperationMode c : OperationMode.values())
    System.out.println(c);

Returns:

an array containing the constants of this enum type, in the order they are declared

valueOf

public static OperationMode valueOf(java.lang.String name)

Returns the enum constant of this type with the specified name. The string must match exactly an identifier used to declare an enum constant in this type. (Extraneous whitespace characters are not permitted.)

Parameters:

name - the name of the enum constant to be returned.

Returns:

the enum constant with the specified name

Throws:

java.lang.IllegalArgumentException - if this enum type has no constant with the specified name

java.lang.NullPointerException - if the argument is null

value

public int value()

valueOf

public static OperationMode valueOf(int __v)

__write

public void __write(BasicStream __os)

__write

public static void __write(BasicStream __os,
                           OperationMode __v)

__read

public static OperationMode __read(BasicStream __is)