Module com.zeroc.ice

Package com.zeroc.Ice

Interface ProcessPrx

All Superinterfaces:

ObjectPrx

public interface ProcessPrx
extends ObjectPrx

A server application managed by a locator implementation such as IceGrid hosts a Process object and registers a proxy to this object with the locator registry. See LocatorRegistryPrx.setServerProcessProxy(java.lang.String, com.zeroc.Ice.ProcessPrx).

Field Summary

Fields inherited from interface com.zeroc.Ice.ObjectPrx

ice_staticId, noExplicitContext

Method Summary

Modifier and Type	Method	Description
static ProcessPrx	checkedCast(ObjectPrx obj)	Creates a new proxy from an existing proxy after confirming the target object's type via a remote invocation.
static ProcessPrx	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 ProcessPrx	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 ProcessPrx	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.
static ProcessPrx	createProxy(Communicator communicator, String proxyString)	Creates a new proxy that implements ProcessPrx.
ProcessPrx	ice_adapterId(String newAdapterId)	Creates a new proxy that is identical to this proxy, except for the adapter ID.
ProcessPrx	ice_batchDatagram()	Creates a new proxy that is identical to this proxy, but uses batch datagram invocations.
ProcessPrx	ice_batchOneway()	Creates a new proxy that is identical to this proxy, but uses batch oneway invocations.
ProcessPrx	ice_collocationOptimized(boolean b)	Returns a proxy that is identical to this proxy, except for collocation optimization.
ProcessPrx	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.
ProcessPrx	ice_connectionCached(boolean newCache)	Returns a proxy that is identical to this proxy, except for connection caching.
ProcessPrx	ice_connectionId(String connectionId)	Returns a proxy that is identical to this proxy, except for its connection ID.
ProcessPrx	ice_context(Map<String,String> newContext)	Creates a new proxy that is identical to this proxy, except for the per-proxy context.
ProcessPrx	ice_datagram()	Creates a new proxy that is identical to this proxy, but uses datagram invocations.
ProcessPrx	ice_encodingVersion(EncodingVersion e)	Returns a proxy that is identical to this proxy, except for the encoding used to marshal parameters.
ProcessPrx	ice_endpoints(Endpoint[] newEndpoints)	Creates a new proxy that is identical to this proxy, except for the endpoints.
ProcessPrx	ice_endpointSelection(EndpointSelectionType newType)	Returns a proxy that is identical to this proxy, except for the endpoint selection policy.
ProcessPrx	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.
ProcessPrx	ice_invocationTimeout(int newTimeout)	Returns a proxy that is identical to this proxy, except for the invocation timeout.
ProcessPrx	ice_invocationTimeout(Duration newTimeout)	Returns a proxy that is identical to this proxy, except for the invocation timeout.
ProcessPrx	ice_locator(LocatorPrx locator)	Returns a proxy that is identical to this proxy, except for the locator.
ProcessPrx	ice_locatorCacheTimeout(int newTimeout)	Creates a new proxy that is identical to this proxy, except for the locator cache timeout.
ProcessPrx	ice_oneway()	Creates a new proxy that is identical to this proxy, but uses oneway invocations.
ProcessPrx	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.
ProcessPrx	ice_twoway()	Creates a new proxy that is identical to this proxy, but uses twoway invocations.
default void	shutdown()	Initiates a graceful shutdown of the server application.
default void	shutdown(Map<String,String> context)	Initiates a graceful shutdown of the server application.
default CompletableFuture<Void>	shutdownAsync()	Initiates a graceful shutdown of the server application.
default CompletableFuture<Void>	shutdownAsync(Map<String,String> context)	Initiates a graceful shutdown of the server application.
static ProcessPrx	uncheckedCast(ObjectPrx obj)	Creates a new proxy from an existing proxy.
static ProcessPrx	uncheckedCast(ObjectPrx obj, String facet)	Creates a new proxy from an existing proxy.
default void	writeMessage(String message, int fd)	Writes a message on the server application's stdout or stderr.
default void	writeMessage(String message, int fd, Map<String,String> context)	Writes a message on the server application's stdout or stderr.
default CompletableFuture<Void>	writeMessageAsync(String message, int fd)	Writes a message on the server application's stdout or stderr.
default CompletableFuture<Void>	writeMessageAsync(String message, int fd, Map<String,String> context)	Writes a message on the server application's stdout or stderr.

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

shutdown

default void shutdown()

Initiates a graceful shutdown of the server application.

shutdown

default void shutdown(Map<String,String> context)

Initiates a graceful shutdown of the server application.

Parameters:

context - The Context map to send with the invocation.

shutdownAsync

default CompletableFuture<Void> shutdownAsync()

Initiates a graceful shutdown of the server application.

Returns:

A future that will be completed when the invocation completes.

shutdownAsync

default CompletableFuture<Void> shutdownAsync(Map<String,String> context)

Initiates a graceful shutdown of the server application.

Parameters:

context - The Context map to send with the invocation.

Returns:

A future that will be completed when the invocation completes.

writeMessage

default void writeMessage(String message,
 int fd)

Writes a message on the server application's stdout or stderr.

Parameters:

message - The message to write.

fd - 1 for stdout, 2 for stderr.

writeMessage

default void writeMessage(String message,
 int fd,
 Map<String,String> context)

Writes a message on the server application's stdout or stderr.

Parameters:

message - The message to write.

fd - 1 for stdout, 2 for stderr.

context - The Context map to send with the invocation.

writeMessageAsync

default CompletableFuture<Void> writeMessageAsync(String message,
 int fd)

Writes a message on the server application's stdout or stderr.

Parameters:

message - The message to write.

fd - 1 for stdout, 2 for stderr.

Returns:

A future that will be completed when the invocation completes.

writeMessageAsync

default CompletableFuture<Void> writeMessageAsync(String message,
 int fd,
 Map<String,String> context)

Writes a message on the server application's stdout or stderr.

Parameters:

message - The message to write.

fd - 1 for stdout, 2 for stderr.

context - The Context map to send with the invocation.

Returns:

A future that will be completed when the invocation completes.

createProxy

static ProcessPrx createProxy(Communicator communicator,
 String proxyString)

Creates a new proxy that implements ProcessPrx.

Parameters:

communicator - The communicator of the new proxy.

proxyString - The string representation of the proxy.

Returns:

The new proxy.

checkedCast

static ProcessPrx 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 ProcessPrx 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 ProcessPrx 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 ProcessPrx 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 ProcessPrx 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 ProcessPrx 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

ProcessPrx 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

ProcessPrx 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

ProcessPrx 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

ProcessPrx 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

ProcessPrx 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

ProcessPrx 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

ProcessPrx 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

ProcessPrx 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

ProcessPrx 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

ProcessPrx 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

ProcessPrx 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

ProcessPrx 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

ProcessPrx 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

ProcessPrx 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

ProcessPrx 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

ProcessPrx 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

ProcessPrx 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

ProcessPrx 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

ProcessPrx 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

ProcessPrx 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 "::Ice::Process"