Interface RouterPrx
- Namespace
- Ice
- Assembly
- Ice.dll
Represents an intermediary object that routes requests and replies between clients and Ice objects that are not directly reachable from these clients.
public interface RouterPrx : ObjectPrx, IEquatable<ObjectPrx>
- Inherited Members
Remarks
Use the methods of this interface to invoke operations on a remote Ice object that implements Router.
The Slice compiler generated this proxy interface from Slice interface ::Ice::Router.
Methods
addProxies(ObjectPrx?[], Dictionary<string, string>?)
Adds new proxy information to the router's routing table.
ObjectPrx?[] addProxies(ObjectPrx?[] proxies, Dictionary<string, string>? context = null)
Parameters
proxiesObjectPrx[]The proxies to add. Adding a null proxy is an error.
contextDictionary<string, string>The request context.
Returns
- ObjectPrx[]
Proxies discarded by the router. These proxies are all non-null.
addProxiesAsync(ObjectPrx?[], Dictionary<string, string>?, IProgress<bool>?, CancellationToken)
Adds new proxy information to the router's routing table.
Task<ObjectPrx?[]> addProxiesAsync(ObjectPrx?[] proxies, Dictionary<string, string>? context = null, IProgress<bool>? progress = null, CancellationToken cancel = default)
Parameters
proxiesObjectPrx[]The proxies to add. Adding a null proxy is an error.
contextDictionary<string, string>The request context.
progressIProgress<bool>The sent progress provider.
cancelCancellationTokenA cancellation token that receives the cancellation requests.
Returns
getClientProxy(out bool?, Dictionary<string, string>?)
Gets the router's client proxy, i.e. the proxy to use for forwarding requests from the client to the router. If a null proxy is returned, the client will forward requests to the router's endpoints.
ObjectPrx? getClientProxy(out bool? hasRoutingTable, Dictionary<string, string>? context = null)
Parameters
hasRoutingTablebool?Indicates whether or not the router supports a routing table. If
true, the Ice runtime will call addProxiesAsync(ObjectPrx?[], Dictionary<string, string>?, IProgress<bool>?, CancellationToken) to populate the routing table. The Ice runtime assumes the router has a routing table whenhasRoutingTableis not set.contextDictionary<string, string>The request context.
Returns
- ObjectPrx
The router's client proxy.
Remarks
Introduced in Ice 3.7.
getClientProxyAsync(Dictionary<string, string>?, IProgress<bool>?, CancellationToken)
Gets the router's client proxy, i.e. the proxy to use for forwarding requests from the client to the router. If a null proxy is returned, the client will forward requests to the router's endpoints.
Task<Router_GetClientProxyResult> getClientProxyAsync(Dictionary<string, string>? context = null, IProgress<bool>? progress = null, CancellationToken cancel = default)
Parameters
contextDictionary<string, string>The request context.
progressIProgress<bool>The sent progress provider.
cancelCancellationTokenA cancellation token that receives the cancellation requests.
Returns
- Task<Router_GetClientProxyResult>
A task that completes when the response is received.
Remarks
Introduced in Ice 3.7.
getServerProxy(Dictionary<string, string>?)
Gets the router's server proxy, i.e. the proxy to use for forwarding requests from the server to the router. The Ice runtime uses the endpoints of this proxy as the published endpoints of bi-dir object adapters.
ObjectPrx? getServerProxy(Dictionary<string, string>? context = null)
Parameters
contextDictionary<string, string>The request context.
Returns
- ObjectPrx
The router's server proxy.
getServerProxyAsync(Dictionary<string, string>?, IProgress<bool>?, CancellationToken)
Gets the router's server proxy, i.e. the proxy to use for forwarding requests from the server to the router. The Ice runtime uses the endpoints of this proxy as the published endpoints of bi-dir object adapters.
Task<ObjectPrx?> getServerProxyAsync(Dictionary<string, string>? context = null, IProgress<bool>? progress = null, CancellationToken cancel = default)
Parameters
contextDictionary<string, string>The request context.
progressIProgress<bool>The sent progress provider.
cancelCancellationTokenA cancellation token that receives the cancellation requests.