Struct LocatorFinderProxy

Namespace

IceRpc.Ice

Assembly

IceRpc.Locator.dll

Implements ILocatorFinder by making invocations on a remote IceRPC service. This remote service must implement Ice interface ::Ice::LocatorFinder.

[IceTypeId("::Ice::LocatorFinder")]
public readonly record struct LocatorFinderProxy : ILocatorFinder, IIceProxy, IEquatable<LocatorFinderProxy>

Implements

ILocatorFinder

IIceProxy

IEquatable<LocatorFinderProxy>

Inherited Members

ValueType.Equals(object)

ValueType.GetHashCode()

ValueType.ToString()

object.Equals(object, object)

object.GetType()

object.ReferenceEquals(object, object)

Extension Methods

IceProxyExtensions.AsAsync<TProxy>(IIceProxy, IFeatureCollection?, CancellationToken)

IceProxyExtensions.ToProxy<TProxy>(IIceProxy)

IceProxyExtensions.InvokeOperationAsync<TProxy>(TProxy, string, PipeReader, ResponseDecodeFunc, IFeatureCollection?, bool, bool, CancellationToken)

IceProxyExtensions.InvokeOperationAsync<TProxy, T>(TProxy, string, PipeReader, ResponseDecodeFunc<T>, IFeatureCollection?, bool, CancellationToken)

Constructors

LocatorFinderProxy()

Constructs a proxy that uses the default service address: its protocol is ice and its path is DefaultServicePath.

public LocatorFinderProxy()

LocatorFinderProxy(IInvoker, ServiceAddress?, IceEncodeOptions?)

Constructs a proxy from an invoker, a service address and encode options.

[SetsRequiredMembers]
public LocatorFinderProxy(IInvoker invoker, ServiceAddress? serviceAddress = null, IceEncodeOptions? encodeOptions = null)

Parameters

invoker IInvoker

The invocation pipeline of the proxy.

serviceAddress ServiceAddress

The service address. null is equivalent to the default service address (protocol: ice, path: DefaultServicePath).

encodeOptions IceEncodeOptions

The encode options, used to customize the encoding of request payloads.

LocatorFinderProxy(IInvoker, Uri, IceEncodeOptions?)

Constructs a proxy from an invoker, a service address URI and encode options.

[SetsRequiredMembers]
public LocatorFinderProxy(IInvoker invoker, Uri serviceAddressUri, IceEncodeOptions? encodeOptions = null)

Parameters

invoker IInvoker

The invocation pipeline of the proxy.

serviceAddressUri Uri

A URI that represents a service address.

encodeOptions IceEncodeOptions

The encode options, used to customize the encoding of request payloads.

Fields

DefaultServicePath

Represents the default path for IceRPC services that implement Ice interface ::Ice::LocatorFinder.

public const string DefaultServicePath = "/Ice.LocatorFinder"

Field Value

string

Properties

EncodeOptions

Gets or initializes the encode options, used to customize the encoding of payloads created from this proxy.

public IceEncodeOptions? EncodeOptions { get; init; }

Property Value

IceEncodeOptions

Invoker

Gets or initializes the invocation pipeline of this proxy.

public required IInvoker Invoker { get; init; }

Property Value

IInvoker

ServiceAddress

Gets or initializes the address of the remote service.

public ServiceAddress ServiceAddress { get; init; }

Property Value

ServiceAddress

Methods

GetLocatorAsync(IFeatureCollection?, CancellationToken)

Gets a proxy to the associated LocatorProxy. The proxy might point to several replicas.

public Task<LocatorProxy?> GetLocatorAsync(IFeatureCollection? features = null, CancellationToken cancellationToken = default)

Parameters

features IFeatureCollection

The features of this invocation.

cancellationToken CancellationToken

A cancellation token that receives the cancellation requests.

Returns

Task<LocatorProxy?>

The locator proxy. This proxy is never null.

Exceptions

DispatchException

Thrown when the dispatch of the operation failed. This exception is provided through the returned task; it's never thrown synchronously.