Module com.zeroc.glacier2

Package com.zeroc.Glacier2

Interface SessionManagerPrx

All Superinterfaces:

ObjectPrx

public interface SessionManagerPrx
extends ObjectPrx

Represents an application-provided factory for session objects. You can configure a Glacier2 router with your own SessionManager implementation; this router will then return the sessions created by this session manager to its clients.

Field Summary

Fields inherited from interface com.zeroc.Ice.ObjectPrx

ice_staticId, noExplicitContext

Method Summary

Modifier and Type	Method	Description
static SessionManagerPrx	checkedCast(ObjectPrx obj)	Creates a new proxy from an existing proxy after confirming the target object's type via a remote invocation.
static SessionManagerPrx	checkedCast(ObjectPrx obj, String facet)	Creates a new proxy from an existing proxy after confirming the target object's type via a remote invocation.
static SessionManagerPrx	checkedCast(ObjectPrx obj, String facet, Map<String,String> context)	Creates a new proxy from an existing proxy after confirming the target object's type via a remote invocation.
static SessionManagerPrx	checkedCast(ObjectPrx obj, Map<String,String> context)	Creates a new proxy from an existing proxy after confirming the target object's type via a remote invocation.
default SessionPrx	create(String userId, SessionControlPrx control)	Creates a new session object.
default SessionPrx	create(String userId, SessionControlPrx control, Map<String,String> context)	Creates a new session object.
default CompletableFuture<SessionPrx>	createAsync(String userId, SessionControlPrx control)	Creates a new session object.
default CompletableFuture<SessionPrx>	createAsync(String userId, SessionControlPrx control, Map<String,String> context)	Creates a new session object.
static SessionManagerPrx	createProxy(Communicator communicator, String proxyString)	Creates a new proxy that implements SessionManagerPrx.
SessionManagerPrx	ice_adapterId(String newAdapterId)	Creates a new proxy that is identical to this proxy, except for the adapter ID.
SessionManagerPrx	ice_batchDatagram()	Creates a new proxy that is identical to this proxy, but uses batch datagram invocations.
SessionManagerPrx	ice_batchOneway()	Creates a new proxy that is identical to this proxy, but uses batch oneway invocations.
SessionManagerPrx	ice_collocationOptimized(boolean b)	Returns a proxy that is identical to this proxy, except for collocation optimization.
SessionManagerPrx	ice_compress(boolean co)	Returns a proxy that is identical to this proxy, except for its compression setting which overrides the compression setting from the proxy endpoints.
SessionManagerPrx	ice_connectionCached(boolean newCache)	Returns a proxy that is identical to this proxy, except for connection caching.
SessionManagerPrx	ice_connectionId(String connectionId)	Returns a proxy that is identical to this proxy, except for its connection ID.
SessionManagerPrx	ice_context(Map<String,String> newContext)	Creates a new proxy that is identical to this proxy, except for the per-proxy context.
SessionManagerPrx	ice_datagram()	Creates a new proxy that is identical to this proxy, but uses datagram invocations.
SessionManagerPrx	ice_encodingVersion(EncodingVersion e)	Returns a proxy that is identical to this proxy, except for the encoding used to marshal parameters.
SessionManagerPrx	ice_endpoints(Endpoint[] newEndpoints)	Creates a new proxy that is identical to this proxy, except for the endpoints.
SessionManagerPrx	ice_endpointSelection(EndpointSelectionType newType)	Returns a proxy that is identical to this proxy, except for the endpoint selection policy.
SessionManagerPrx	ice_fixed(Connection connection)	Creates a new proxy that is identical to this proxy, except it's a fixed proxy bound to the given connection.
SessionManagerPrx	ice_invocationTimeout(int newTimeout)	Returns a proxy that is identical to this proxy, except for the invocation timeout.
SessionManagerPrx	ice_invocationTimeout(Duration newTimeout)	Returns a proxy that is identical to this proxy, except for the invocation timeout.
SessionManagerPrx	ice_locator(LocatorPrx locator)	Returns a proxy that is identical to this proxy, except for the locator.
SessionManagerPrx	ice_locatorCacheTimeout(int newTimeout)	Creates a new proxy that is identical to this proxy, except for the locator cache timeout.
SessionManagerPrx	ice_oneway()	Creates a new proxy that is identical to this proxy, but uses oneway invocations.
SessionManagerPrx	ice_router(RouterPrx router)	Returns a proxy that is identical to this proxy, except for the router.
static String	ice_staticId()	Gets the type ID of the associated Slice interface.
SessionManagerPrx	ice_twoway()	Creates a new proxy that is identical to this proxy, but uses twoway invocations.
static SessionManagerPrx	uncheckedCast(ObjectPrx obj)	Creates a new proxy from an existing proxy.
static SessionManagerPrx	uncheckedCast(ObjectPrx obj, String facet)	Creates a new proxy from an existing proxy.

Methods inherited from interface com.zeroc.Ice.ObjectPrx

equals, ice_executor, ice_facet, ice_flushBatchRequests, ice_flushBatchRequestsAsync, ice_getAdapterId, ice_getCachedConnection, ice_getCommunicator, ice_getCompress, ice_getConnection, ice_getConnectionAsync, ice_getConnectionId, ice_getContext, ice_getEncodingVersion, ice_getEndpoints, ice_getEndpointSelection, ice_getFacet, ice_getIdentity, ice_getInvocationTimeout, ice_getLocator, ice_getLocatorCacheTimeout, ice_getRouter, ice_id, ice_id, ice_idAsync, ice_idAsync, ice_identity, ice_ids, ice_ids, ice_idsAsync, ice_idsAsync, ice_invoke, ice_invoke, ice_invokeAsync, ice_invokeAsync, ice_isA, ice_isA, ice_isAAsync, ice_isAAsync, ice_isBatchDatagram, ice_isBatchOneway, ice_isCollocationOptimized, ice_isConnectionCached, ice_isDatagram, ice_isFixed, ice_isOneway, ice_isTwoway, ice_locatorCacheTimeout, ice_ping, ice_ping, ice_pingAsync, ice_pingAsync

Method Details

create

default SessionPrx create(String userId,
 SessionControlPrx control)
                   throws CannotCreateSessionException

Creates a new session object.

Parameters:

userId - The user ID for the session.

control - A proxy to the session control object. This proxy is null when Glacier2.Server.Endpoints is not configured.

Returns:

A proxy to the newly created session. This proxy is never null.

Throws:

CannotCreateSessionException - Thrown when the session cannot be created.

create

default SessionPrx create(String userId,
 SessionControlPrx control,
 Map<String,String> context)
                   throws CannotCreateSessionException

Creates a new session object.

Parameters:

userId - The user ID for the session.

control - A proxy to the session control object. This proxy is null when Glacier2.Server.Endpoints is not configured.

context - The Context map to send with the invocation.

Returns:

A proxy to the newly created session. This proxy is never null.

Throws:

CannotCreateSessionException - Thrown when the session cannot be created.

createAsync

default CompletableFuture<SessionPrx> createAsync(String userId,
 SessionControlPrx control)

Creates a new session object.

Parameters:

userId - The user ID for the session.

control - A proxy to the session control object. This proxy is null when Glacier2.Server.Endpoints is not configured.

Returns:

A proxy to the newly created session. This proxy is never null.

createAsync

default CompletableFuture<SessionPrx> createAsync(String userId,
 SessionControlPrx control,
 Map<String,String> context)

Creates a new session object.

Parameters:

userId - The user ID for the session.

control - A proxy to the session control object. This proxy is null when Glacier2.Server.Endpoints is not configured.

context - The Context map to send with the invocation.

Returns:

A proxy to the newly created session. This proxy is never null.

createProxy

static SessionManagerPrx createProxy(Communicator communicator,
 String proxyString)

Creates a new proxy that implements SessionManagerPrx.

Parameters:

communicator - The communicator of the new proxy.

proxyString - The string representation of the proxy.

Returns:

The new proxy.

checkedCast

static SessionManagerPrx checkedCast(ObjectPrx obj)

Creates a new proxy from an existing proxy after confirming the target object's type via a remote invocation. Throws a local exception if a communication error occurs.

Parameters:

obj - The source proxy.

Returns:

A proxy for this type, or null if the object does not support this type.

checkedCast

static SessionManagerPrx checkedCast(ObjectPrx obj,
 Map<String,String> context)

Creates a new proxy from an existing proxy after confirming the target object's type via a remote invocation. Throws a local exception if a communication error occurs.

Parameters:

obj - The source proxy.

context - The Context map to send with the invocation.

Returns:

A new proxy for this type, or null if the object does not support this type.

checkedCast

static SessionManagerPrx checkedCast(ObjectPrx obj,
 String facet)

Creates a new proxy from an existing proxy after confirming the target object's type via a remote invocation. Throws a local exception if a communication error occurs.

Parameters:

obj - The source proxy.

facet - The name of the desired facet.

Returns:

A new proxy for this type, or null if the facet does not support this type.

checkedCast

static SessionManagerPrx checkedCast(ObjectPrx obj,
 String facet,
 Map<String,String> context)

Creates a new proxy from an existing proxy after confirming the target object's type via a remote invocation. Throws a local exception if a communication error occurs.

Parameters:

obj - The source proxy.

facet - The name of the desired facet.

context - The Context map to send with the invocation.

Returns:

A new proxy for this type, or null if the object does not support this type.

uncheckedCast

static SessionManagerPrx uncheckedCast(ObjectPrx obj)

Creates a new proxy from an existing proxy.

Parameters:

obj - The untyped proxy.

Returns:

A new proxy for this type.

uncheckedCast

static SessionManagerPrx uncheckedCast(ObjectPrx obj,
 String facet)

Creates a new proxy from an existing proxy.

Parameters:

obj - The untyped proxy.

facet - The name of the desired facet.

Returns:

A new proxy for this type.

ice_context

SessionManagerPrx ice_context(Map<String,String> newContext)

Description copied from interface: ObjectPrx

Creates a new proxy that is identical to this proxy, except for the per-proxy context.

Specified by:

ice_context in interface ObjectPrx

Parameters:

newContext - The context for the new proxy.

Returns:

A proxy with the new per-proxy context.

ice_adapterId

SessionManagerPrx ice_adapterId(String newAdapterId)

Description copied from interface: ObjectPrx

Creates a new proxy that is identical to this proxy, except for the adapter ID.

Specified by:

ice_adapterId in interface ObjectPrx

Parameters:

newAdapterId - The adapter ID for the new proxy.

Returns:

A proxy with the new adapter ID.

ice_endpoints

SessionManagerPrx ice_endpoints(Endpoint[] newEndpoints)

Description copied from interface: ObjectPrx

Creates a new proxy that is identical to this proxy, except for the endpoints.

Specified by:

ice_endpoints in interface ObjectPrx

Parameters:

newEndpoints - The endpoints for the new proxy.

Returns:

A proxy with the new endpoints.

ice_locatorCacheTimeout

SessionManagerPrx ice_locatorCacheTimeout(int newTimeout)

Description copied from interface: ObjectPrx

Creates a new proxy that is identical to this proxy, except for the locator cache timeout.

Specified by:

ice_locatorCacheTimeout in interface ObjectPrx

Parameters:

newTimeout - The new locator cache timeout (in seconds).

Returns:

A proxy with the new timeout.

See Also:

• Locator

ice_invocationTimeout

SessionManagerPrx ice_invocationTimeout(int newTimeout)

Description copied from interface: ObjectPrx

Returns a proxy that is identical to this proxy, except for the invocation timeout.

Specified by:

ice_invocationTimeout in interface ObjectPrx

Parameters:

newTimeout - The new invocation timeout (in milliseconds).

Returns:

The proxy with the new timeout.

ice_invocationTimeout

SessionManagerPrx ice_invocationTimeout(Duration newTimeout)

Description copied from interface: ObjectPrx

Returns a proxy that is identical to this proxy, except for the invocation timeout.

Specified by:

ice_invocationTimeout in interface ObjectPrx

Parameters:

newTimeout - The new invocation timeout.

Returns:

The proxy with the new timeout.

ice_connectionCached

SessionManagerPrx ice_connectionCached(boolean newCache)

Description copied from interface: ObjectPrx

Returns a proxy that is identical to this proxy, except for connection caching.

Specified by:

ice_connectionCached in interface ObjectPrx

Parameters:

newCache - true if the new proxy should cache connections; false otherwise.

Returns:

The proxy with the specified caching policy.

ice_endpointSelection

SessionManagerPrx ice_endpointSelection(EndpointSelectionType newType)

Description copied from interface: ObjectPrx

Returns a proxy that is identical to this proxy, except for the endpoint selection policy.

Specified by:

ice_endpointSelection in interface ObjectPrx

Parameters:

newType - The new endpoint selection policy.

Returns:

The proxy with the specified endpoint selection policy.

See Also:

• EndpointSelectionType

ice_encodingVersion

SessionManagerPrx ice_encodingVersion(EncodingVersion e)

Description copied from interface: ObjectPrx

Returns a proxy that is identical to this proxy, except for the encoding used to marshal parameters.

Specified by:

ice_encodingVersion in interface ObjectPrx

Parameters:

e - The encoding version to use to marshal request parameters.

Returns:

The proxy with the specified encoding version.

ice_router

SessionManagerPrx ice_router(RouterPrx router)

Description copied from interface: ObjectPrx

Returns a proxy that is identical to this proxy, except for the router.

Specified by:

ice_router in interface ObjectPrx

Parameters:

router - The router for the new proxy.

Returns:

The proxy with the specified router.

ice_locator

SessionManagerPrx ice_locator(LocatorPrx locator)

Description copied from interface: ObjectPrx

Returns a proxy that is identical to this proxy, except for the locator.

Specified by:

ice_locator in interface ObjectPrx

Parameters:

locator - The locator for the new proxy.

Returns:

The proxy with the specified locator.

ice_collocationOptimized

SessionManagerPrx ice_collocationOptimized(boolean b)

Description copied from interface: ObjectPrx

Returns a proxy that is identical to this proxy, except for collocation optimization.

Specified by:

ice_collocationOptimized in interface ObjectPrx

Parameters:

b - true if the new proxy enables collocation optimization; false otherwise.

Returns:

The proxy with the specified collocation optimization.

ice_twoway

SessionManagerPrx ice_twoway()

Description copied from interface: ObjectPrx

Creates a new proxy that is identical to this proxy, but uses twoway invocations.

Specified by:

ice_twoway in interface ObjectPrx

Returns:

A proxy that uses twoway invocations.

ice_oneway

SessionManagerPrx ice_oneway()

Description copied from interface: ObjectPrx

Creates a new proxy that is identical to this proxy, but uses oneway invocations.

Specified by:

ice_oneway in interface ObjectPrx

Returns:

A proxy that uses oneway invocations.

ice_batchOneway

SessionManagerPrx ice_batchOneway()

Description copied from interface: ObjectPrx

Creates a new proxy that is identical to this proxy, but uses batch oneway invocations.

Specified by:

ice_batchOneway in interface ObjectPrx

Returns:

A proxy that uses batch oneway invocations.

ice_datagram

SessionManagerPrx ice_datagram()

Description copied from interface: ObjectPrx

Creates a new proxy that is identical to this proxy, but uses datagram invocations.

Specified by:

ice_datagram in interface ObjectPrx

Returns:

A proxy that uses datagram invocations.

ice_batchDatagram

SessionManagerPrx ice_batchDatagram()

Description copied from interface: ObjectPrx

Creates a new proxy that is identical to this proxy, but uses batch datagram invocations.

Specified by:

ice_batchDatagram in interface ObjectPrx

Returns:

A proxy that uses batch datagram invocations.

ice_compress

SessionManagerPrx ice_compress(boolean co)

Description copied from interface: ObjectPrx

Returns a proxy that is identical to this proxy, except for its compression setting which overrides the compression setting from the proxy endpoints.

Specified by:

ice_compress in interface ObjectPrx

Parameters:

co - true enables compression for the new proxy; false disables compression.

Returns:

A proxy with the specified compression setting.

ice_connectionId

SessionManagerPrx ice_connectionId(String connectionId)

Description copied from interface: ObjectPrx

Returns a proxy that is identical to this proxy, except for its connection ID.

Specified by:

ice_connectionId in interface ObjectPrx

Parameters:

connectionId - The connection ID for the new proxy. An empty string removes the connection ID.

Returns:

A proxy with the specified connection ID.

ice_fixed

SessionManagerPrx ice_fixed(Connection connection)

Description copied from interface: ObjectPrx

Creates a new proxy that is identical to this proxy, except it's a fixed proxy bound to the given connection.

Specified by:

ice_fixed in interface ObjectPrx

Parameters:

connection - The fixed proxy connection.

Returns:

A fixed proxy bound to the given connection.

ice_staticId

static String ice_staticId()

Gets the type ID of the associated Slice interface.

Returns:

the string "::Glacier2::SessionManager"