com.cosylab.acs.maci

Interface HandleConstants

All Known Implementing Classes:

HandleHelper, ManagerImpl

public interface HandleConstants

The Handle alias defines a universal handle used by MACI to uniquely tag the object instances. Handles optimize access and identifications of MACI components and replace the use of string identifiers. Handles are not unique globally and are not static. Manager guarantees only that they are unique in their scope and only for the duration of the object denoted by the handle. Upper 8 bits (24 to 31) of the handle denote the type of the object that the handle is representing. Possible values of the upper-most byte are:

• 0 - the handle is reserved
• 1 - the handle represents a component
• 2 - the handle represents a client
• 3 - the handle represents an administrator
• 4 - the handle represents an container
• 5 - the handle represents a Manager (for inter-domain communcation).

Bits 0 thru 15 uniquely tag object instance. Bits 16 thru 23 are reserved.

Author:

Matej Sekoranja (matej.sekoranja@cosylab.com)

Field Summary

Fields

Modifier and Type	Field and Description
static int	ADMINISTRATOR_MASK Administrator handle mask.
static int	CLIENT_MASK Client handle mask.
static int	COMPONENT_MASK Component handle mask.
static int	CONTAINER_MASK Container handle mask.
static int	HANDLE_MASK Instance ID part of handle.
static int	KEY_MASK Key mask of the handle.
static int	MANAGER_MASK Manager handle mask 0x05000000.
static int	TYPE_MASK Type mask of the handle.

Field Detail

COMPONENT_MASK

static final int COMPONENT_MASK

Component handle mask.

See Also:

Constant Field Values

CLIENT_MASK

static final int CLIENT_MASK

Client handle mask.

See Also:

Constant Field Values

ADMINISTRATOR_MASK

static final int ADMINISTRATOR_MASK

Administrator handle mask.

See Also:

Constant Field Values

CONTAINER_MASK

static final int CONTAINER_MASK

Container handle mask.

See Also:

Constant Field Values

MANAGER_MASK

static final int MANAGER_MASK

Manager handle mask 0x05000000. We define it in IDL to allow operator clients to show in some special way that the manager is the client of an immortal or autostart component.

TYPE_MASK

static final int TYPE_MASK

Type mask of the handle.

See Also:

Constant Field Values

KEY_MASK

static final int KEY_MASK

Key mask of the handle.

See Also:

Constant Field Values

HANDLE_MASK

static final int HANDLE_MASK

Instance ID part of handle.

See Also:

Constant Field Values