| #region Copyright notice and license |
| |
| // Copyright 2015 gRPC authors. |
| // |
| // Licensed under the Apache License, Version 2.0 (the "License"); |
| // you may not use this file except in compliance with the License. |
| // You may obtain a copy of the License at |
| // |
| // http://www.apache.org/licenses/LICENSE-2.0 |
| // |
| // Unless required by applicable law or agreed to in writing, software |
| // distributed under the License is distributed on an "AS IS" BASIS, |
| // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. |
| // See the License for the specific language governing permissions and |
| // limitations under the License. |
| |
| #endregion |
| |
| using System; |
| using Grpc.Core.Internal; |
| using Grpc.Core.Utils; |
| |
| namespace Grpc.Core |
| { |
| /// <summary> |
| /// Details about a client-side call to be invoked. |
| /// </summary> |
| /// <typeparam name="TRequest">Request message type for the call.</typeparam> |
| /// <typeparam name="TResponse">Response message type for the call.</typeparam> |
| public struct CallInvocationDetails<TRequest, TResponse> |
| { |
| readonly Channel channel; |
| readonly string method; |
| readonly string host; |
| readonly Marshaller<TRequest> requestMarshaller; |
| readonly Marshaller<TResponse> responseMarshaller; |
| CallOptions options; |
| |
| /// <summary> |
| /// Initializes a new instance of the <see cref="Grpc.Core.CallInvocationDetails{TRequest,TResponse}"/> struct. |
| /// </summary> |
| /// <param name="channel">Channel to use for this call.</param> |
| /// <param name="method">Method to call.</param> |
| /// <param name="options">Call options.</param> |
| public CallInvocationDetails(Channel channel, Method<TRequest, TResponse> method, CallOptions options) : |
| this(channel, method, null, options) |
| { |
| } |
| |
| /// <summary> |
| /// Initializes a new instance of the <see cref="Grpc.Core.CallInvocationDetails{TRequest,TResponse}"/> struct. |
| /// </summary> |
| /// <param name="channel">Channel to use for this call.</param> |
| /// <param name="method">Method to call.</param> |
| /// <param name="host">Host that contains the method. if <c>null</c>, default host will be used.</param> |
| /// <param name="options">Call options.</param> |
| public CallInvocationDetails(Channel channel, Method<TRequest, TResponse> method, string host, CallOptions options) : |
| this(channel, method.FullName, host, method.RequestMarshaller, method.ResponseMarshaller, options) |
| { |
| } |
| |
| /// <summary> |
| /// Initializes a new instance of the <see cref="Grpc.Core.CallInvocationDetails{TRequest,TResponse}"/> struct. |
| /// </summary> |
| /// <param name="channel">Channel to use for this call.</param> |
| /// <param name="method">Qualified method name.</param> |
| /// <param name="host">Host that contains the method.</param> |
| /// <param name="requestMarshaller">Request marshaller.</param> |
| /// <param name="responseMarshaller">Response marshaller.</param> |
| /// <param name="options">Call options.</param> |
| public CallInvocationDetails(Channel channel, string method, string host, Marshaller<TRequest> requestMarshaller, Marshaller<TResponse> responseMarshaller, CallOptions options) |
| { |
| this.channel = GrpcPreconditions.CheckNotNull(channel, "channel"); |
| this.method = GrpcPreconditions.CheckNotNull(method, "method"); |
| this.host = host; |
| this.requestMarshaller = GrpcPreconditions.CheckNotNull(requestMarshaller, "requestMarshaller"); |
| this.responseMarshaller = GrpcPreconditions.CheckNotNull(responseMarshaller, "responseMarshaller"); |
| this.options = options; |
| } |
| |
| /// <summary> |
| /// Get channel associated with this call. |
| /// </summary> |
| public Channel Channel |
| { |
| get |
| { |
| return this.channel; |
| } |
| } |
| |
| /// <summary> |
| /// Gets name of method to be called. |
| /// </summary> |
| public string Method |
| { |
| get |
| { |
| return this.method; |
| } |
| } |
| |
| /// <summary> |
| /// Get name of host. |
| /// </summary> |
| public string Host |
| { |
| get |
| { |
| return this.host; |
| } |
| } |
| |
| /// <summary> |
| /// Gets marshaller used to serialize requests. |
| /// </summary> |
| public Marshaller<TRequest> RequestMarshaller |
| { |
| get |
| { |
| return this.requestMarshaller; |
| } |
| } |
| |
| /// <summary> |
| /// Gets marshaller used to deserialized responses. |
| /// </summary> |
| public Marshaller<TResponse> ResponseMarshaller |
| { |
| get |
| { |
| return this.responseMarshaller; |
| } |
| } |
| |
| /// <summary> |
| /// Gets the call options. |
| /// </summary> |
| public CallOptions Options |
| { |
| get |
| { |
| return options; |
| } |
| } |
| |
| /// <summary> |
| /// Returns new instance of <see cref="CallInvocationDetails{TRequest, TResponse}"/> with |
| /// <c>Options</c> set to the value provided. Values of all other fields are preserved. |
| /// </summary> |
| public CallInvocationDetails<TRequest, TResponse> WithOptions(CallOptions options) |
| { |
| var newDetails = this; |
| newDetails.options = options; |
| return newDetails; |
| } |
| } |
| } |