Class ObjectPrx

The base class for all object proxies.

Constructors

constructor

new ObjectPrx(communicator: Communicator, proxyString: string): ObjectPrx
Constructs a new ObjectPrx proxy.
Parameters
- communicator: Communicator
  The communicator for the new proxy.
- proxyString: string
  The string representation of the proxy.
Returns ObjectPrx
The newly constructed proxy.

Throws
ParseException - Thrown if the proxyString is not a valid proxy string.

Methods

equals

equals(other: ObjectPrx): boolean
Checks whether the specified object is equal to this object.
Parameters
- other: ObjectPrx
  The object to compare with.
Returns boolean
true if the specified object is equal to this object, false otherwise.

ice_adapterId

ice_adapterId(id: string): this
Creates a proxy that is identical to this proxy, except for the adapter ID.
Parameters
- id: string
  The adapter ID for the new proxy.
Returns this
A proxy with the new adapter ID.

ice_batchOneway

ice_batchOneway(): this
Creates a proxy that is identical to this proxy, but uses batch oneway invocations.

Returns this
A proxy that uses batch oneway invocations.

ice_connectionCached

ice_connectionCached(cache: boolean): this
Creates a proxy that is identical to this proxy, except for connection caching.
Parameters
- cache: boolean
  true if the new proxy should cache connections, false otherwise.
Returns this
A proxy with the specified caching policy.

ice_connectionId

ice_connectionId(connectionId: string): this
Creates a proxy that is identical to this proxy, except for its connection ID.
Parameters
- connectionId: string
  The connection ID for the new proxy. An empty string removes the connection ID.
Returns this
A proxy with the specified connection ID.

ice_context

ice_context(context: Map<string, string>): this
Creates a proxy that is identical to this proxy, except for the per-proxy context.
Parameters
- context: Map<string, string>
  The context for the new proxy.
Returns this
A proxy with the new per-proxy context.

ice_encodingVersion

ice_encodingVersion(version: EncodingVersion): this
Creates a proxy that is identical to this proxy, except for the encoding used to marshal parameters.
Parameters
- version: EncodingVersion
  The encoding version to use to marshal request parameters.
Returns this
A proxy with the specified encoding version.

ice_endpoints

ice_endpoints(endpoints: Endpoint[]): this
Creates a proxy that is identical to this proxy, except for the endpoints.
Parameters
- endpoints: Endpoint[]
  The endpoints for the new proxy.
Returns this
A proxy with the new endpoints.

ice_endpointSelection

ice_endpointSelection(type: EndpointSelectionType): this
Creates a proxy that is identical to this proxy, except for the endpoint selection policy.
Parameters
- type: EndpointSelectionType
  The new endpoint selection policy.
Returns this
A proxy with the specified endpoint selection policy.

ice_facet

ice_facet(facet: string): this
Creates a proxy that is identical to this proxy, except for the facet.
Parameters
- facet: string
  The facet for the new proxy.
Returns this
A proxy with the new facet.

ice_fixed

ice_fixed(connection: Connection): this
Creates a proxy that is identical to this proxy, except it's a fixed proxy bound to the given connection.
Parameters
- connection: Connection
  The fixed proxy connection.
Returns this
A fixed proxy bound to the given connection.

ice_flushBatchRequests

ice_flushBatchRequests(): AsyncResult<void>
Flushes any pending batched requests for this proxy.

Returns AsyncResult<void>
An asynchronous result that is resolved when the pending batched requests for this proxy are flushed.

ice_getAdapterId

ice_getAdapterId(): string
Gets the adapter ID for this proxy.

Returns string
The adapter ID. If the proxy does not have an adapter ID, the return value is the empty string.

ice_getCachedConnection

ice_getCachedConnection(): Connection
Gets the cached Connection for this proxy. If the proxy does not yet have an established connection, it does not attempt to create a connection.

Returns Connection
The cached connection for this proxy, or null if the proxy does not have an established connection.

ice_getCommunicator

ice_getCommunicator(): Communicator
Gets the communicator that created this proxy.

Returns Communicator
The communicator that created this proxy.

ice_getConnection

ice_getConnection(): AsyncResult<Connection>
Gets the connection ID of this proxy.

Returns AsyncResult<Connection>
An asynchronous result that resolves to the connection used by this proxy.

Remarks
You can call this function to establish a connection or associate the proxy with an existing connection.

ice_getConnectionId

ice_getConnectionId(): string
Gets the connection ID of this proxy.

Returns string
The connection ID.

ice_getContext

ice_getContext(): Map<string, string>
Gets the per-proxy context for this proxy.

Returns Map<string, string>
The per-proxy context.

ice_getEncodingVersion

ice_getEncodingVersion(): EncodingVersion
Gets the encoding version used to marshal request parameters.

Returns EncodingVersion
The encoding version.

ice_getEndpoints

ice_getEndpoints(): Endpoint[]
Gets the endpoints used by this proxy.

Returns Endpoint[]
The endpoints used by this proxy.

ice_getEndpointSelection

ice_getEndpointSelection(): EndpointSelectionType
Gets the endpoint selection policy for this proxy (randomly or ordered).

Returns EndpointSelectionType
The endpoint selection policy.

ice_getFacet

ice_getFacet(): string
Gets the facet for this proxy.

Returns string
The facet for this proxy. If the proxy uses the default facet, the return value is the empty string.

ice_getIdentity

ice_getIdentity(): Identity
Gets the identity embedded in this proxy.

Returns Identity
The identity of the target object.

ice_getInvocationTimeout

ice_getInvocationTimeout(): number
Gets the invocation timeout of this proxy.

Returns number
The invocation timeout value.

ice_getLocator

ice_getLocator(): LocatorPrx
Gets the locator for this proxy.

Returns LocatorPrx
The locator for this proxy. If no locator is configured, the return value is null.

ice_getLocatorCacheTimeout

ice_getLocatorCacheTimeout(): number
Gets the locator cache timeout of this proxy.

Returns number
The locator cache timeout value.

ice_getRouter

ice_getRouter(): Ice.RouterPrx
Gets the router for this proxy.

Returns Ice.RouterPrx
The router for the proxy. If no router is configured for the proxy, the return value is null.

ice_id

ice_id(context?: Map<string, string>): AsyncResult<string>
Gets the type ID of the most-derived Slice interface supported by this object.
Parameters
- Optionalcontext: Map<string, string>
  The request context.
Returns AsyncResult<string>
An asynchronous result that resolves to the Slice type ID of the most-derived interface.

ice_identity

ice_identity(id: Identity): this
Creates a proxy that is identical to this proxy, except for the identity.
Parameters
- id: Identity
  The identity for the new proxy.
Returns this
A proxy with the new identity.

ice_ids

ice_ids(context?: Map<string, string>): AsyncResult<string[]>
Gets the Slice interfaces supported by this object as a list of Slice type IDs.
Parameters
- Optionalcontext: Map<string, string>
  The request context.
Returns AsyncResult<string[]>
An asynchronous result that resolves to an array of the Slice type IDs of the interfaces supported by this object, in alphabetical order

ice_invocationTimeout

ice_invocationTimeout(timeout: number): this
Creates a proxy that is identical to this proxy, except for the invocation timeout.
Parameters
- timeout: number
  The new invocation timeout (in milliseconds).
Returns this
A proxy with the new timeout.

ice_isA

ice_isA(typeId: string, context?: Map<string, string>): AsyncResult<boolean>
Tests whether this object supports a specific Slice interface.
Parameters
- typeId: string
  The type ID of the Slice interface to test against.
- Optionalcontext: Map<string, string>
  The request context.
Returns AsyncResult<boolean>
An asynchronous result that resolves to true if the target object implements the Slice interface specified by typeId or implements a derived interface, false otherwise.

ice_isBatchOneway

ice_isBatchOneway(): boolean
Determines whether this proxy uses batch oneway invocations.

Returns boolean
true if this proxy uses batch oneway invocations, false otherwise.

ice_isConnectionCached

ice_isConnectionCached(): boolean
Determines whether this proxy caches connections.

Returns boolean
true if this proxy caches connections, false otherwise.

ice_isFixed

ice_isFixed(): boolean
Determines whether this proxy is a fixed proxy.

Returns boolean
true if this proxy is a fixed proxy, false otherwise.

ice_isOneway

ice_isOneway(): boolean
Determines whether this proxy uses oneway invocations.

Returns boolean
true if this proxy uses oneway invocations, false otherwise.

ice_isTwoway

ice_isTwoway(): boolean
Determines whether this proxy uses twoway invocations.

Returns boolean
true if this proxy uses twoway invocations, false otherwise.

ice_locator

ice_locator(locator: LocatorPrx): this
Creates a proxy that is identical to this proxy, except for the locator.
Parameters
- locator: LocatorPrx
  The locator for the new proxy.
Returns this
A proxy with the specified locator.

ice_locatorCacheTimeout

ice_locatorCacheTimeout(timeout: number): this
Creates a proxy that is identical to this proxy, except for the locator cache timeout.
Parameters
- timeout: number
  The new locator cache timeout (in seconds).
Returns this
A proxy with the new timeout.

ice_oneway

ice_oneway(): this
Creates a proxy that is identical to this proxy, but uses oneway invocations.

Returns this
A proxy that uses oneway invocations.

ice_ping

ice_ping(context?: Map<string, string>): AsyncResult<void>
Tests whether the target object of this proxy can be reached.
Parameters
- Optionalcontext: Map<string, string>
  The request context.
Returns AsyncResult<void>
An asynchronous result that resolves when the ping operation completes.

ice_router

ice_router(router: Ice.RouterPrx): this
Creates a proxy that is identical to this proxy, except for the router.
Parameters
- router: Ice.RouterPrx
  The router for the new proxy.
Returns this
A proxy with the specified router.

ice_toString

ice_toString(): string
Creates a stringified version of this proxy.

Returns string
A stringified proxy.

ice_twoway

ice_twoway(): this
Creates a proxy that is identical to this proxy, but uses twoway invocations.

Returns this
A proxy that uses twoway invocations.

`Static`checkedCast

checkedCast(
    prx: ObjectPrx,
    facet?: string,
    context?: Map<string, string>,
): AsyncResult<ObjectPrx>
Creates a new proxy from an existing proxy after confirming the target object's type via a remote invocation.
Parameters
- prx: ObjectPrx
  The source proxy.
- Optionalfacet: string
  An optional facet name.
- Optionalcontext: Map<string, string>
  The request context.
Returns AsyncResult<ObjectPrx>
An asynchronous result resolving to a proxy with the requested type and facet, or null if the target object does not support the requested type.

`Static`ice_staticId

ice_staticId(): string
Returns the Slice type ID associated with this type.

Returns string
The Slice type ID.

`Static`uncheckedCast

uncheckedCast(prx: ObjectPrx, facet?: string): ObjectPrx
Creates a new proxy from an existing proxy.
Parameters
- prx: ObjectPrx
  The source proxy.
- Optionalfacet: string
  An optional facet name.
Returns ObjectPrx
A proxy with the requested type and facet, or null if the source proxy is null.
uncheckedCast(prx: ObjectPrx, facet?: string): ObjectPrx
Creates a new proxy from an existing proxy.
Parameters
- prx: ObjectPrx
  The source proxy.
- Optionalfacet: string
  An optional facet name.
Returns ObjectPrx
A proxy with the requested type and facet, or null if the source proxy is null.

Class ObjectPrx

Hierarchy (View Summary)

Index

Constructors

Methods

Constructors

constructor

Parameters

Returns ObjectPrx

Throws

Methods

equals

Parameters

Returns boolean

ice_adapterId

Parameters

Returns this

ice_batchOneway

Returns this

ice_connectionCached

Parameters

Returns this

ice_connectionId

Parameters

Returns this

ice_context

Parameters

Returns this

ice_encodingVersion

Parameters

Returns this

ice_endpoints

Parameters

Returns this

ice_endpointSelection

Parameters

Returns this

ice_facet

Parameters

Returns this

ice_fixed

Parameters

Returns this

ice_flushBatchRequests

Returns AsyncResult<void>

ice_getAdapterId

Returns string

ice_getCachedConnection

Returns Connection

ice_getCommunicator

Returns Communicator

ice_getConnection

Returns AsyncResult<Connection>

Remarks

ice_getConnectionId

Returns string

ice_getContext

Returns Map<string, string>

ice_getEncodingVersion

Returns EncodingVersion

ice_getEndpoints

Returns Endpoint[]

ice_getEndpointSelection

Returns EndpointSelectionType

ice_getFacet

Returns string

ice_getIdentity

Returns Identity

ice_getInvocationTimeout

Returns number

ice_getLocator

Returns LocatorPrx

ice_getLocatorCacheTimeout

Returns number

ice_getRouter

Returns Ice.RouterPrx

ice_id

Parameters

Returns AsyncResult<string>

ice_identity

`Static`checkedCast

`Static`ice_staticId

`Static`uncheckedCast