Jan Tattermusch | a7fff86 | 2015-02-13 11:08:08 -0800 | [diff] [blame] | 1 | #region Copyright notice and license |
| 2 | |
Jan Tattermusch | 7897ae9 | 2017-06-07 22:57:36 +0200 | [diff] [blame] | 3 | // Copyright 2015 gRPC authors. |
Craig Tiller | 190d360 | 2015-02-18 09:23:38 -0800 | [diff] [blame] | 4 | // |
Jan Tattermusch | 7897ae9 | 2017-06-07 22:57:36 +0200 | [diff] [blame] | 5 | // Licensed under the Apache License, Version 2.0 (the "License"); |
| 6 | // you may not use this file except in compliance with the License. |
| 7 | // You may obtain a copy of the License at |
Craig Tiller | 190d360 | 2015-02-18 09:23:38 -0800 | [diff] [blame] | 8 | // |
Jan Tattermusch | 7897ae9 | 2017-06-07 22:57:36 +0200 | [diff] [blame] | 9 | // http://www.apache.org/licenses/LICENSE-2.0 |
Craig Tiller | 190d360 | 2015-02-18 09:23:38 -0800 | [diff] [blame] | 10 | // |
Jan Tattermusch | 7897ae9 | 2017-06-07 22:57:36 +0200 | [diff] [blame] | 11 | // Unless required by applicable law or agreed to in writing, software |
| 12 | // distributed under the License is distributed on an "AS IS" BASIS, |
| 13 | // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. |
| 14 | // See the License for the specific language governing permissions and |
| 15 | // limitations under the License. |
Jan Tattermusch | a7fff86 | 2015-02-13 11:08:08 -0800 | [diff] [blame] | 16 | |
| 17 | #endregion |
| 18 | |
Jan Tattermusch | 15111f5 | 2015-02-05 18:15:14 -0800 | [diff] [blame] | 19 | using System; |
Jan Tattermusch | c0b3721 | 2015-03-13 08:35:41 -0700 | [diff] [blame] | 20 | using Grpc.Core.Utils; |
Jan Tattermusch | 15111f5 | 2015-02-05 18:15:14 -0800 | [diff] [blame] | 21 | |
Jan Tattermusch | 3086862 | 2015-02-19 09:22:33 -0800 | [diff] [blame] | 22 | namespace Grpc.Core |
Jan Tattermusch | 15111f5 | 2015-02-05 18:15:14 -0800 | [diff] [blame] | 23 | { |
| 24 | /// <summary> |
Jan Tattermusch | 66eb18d | 2015-08-09 20:03:24 -0700 | [diff] [blame] | 25 | /// Encapsulates the logic for serializing and deserializing messages. |
Jan Tattermusch | 15111f5 | 2015-02-05 18:15:14 -0800 | [diff] [blame] | 26 | /// </summary> |
Jan Tattermusch | 67c4587 | 2015-08-27 18:12:39 -0700 | [diff] [blame] | 27 | public class Marshaller<T> |
Jan Tattermusch | 15111f5 | 2015-02-05 18:15:14 -0800 | [diff] [blame] | 28 | { |
Jan Tattermusch | 075dde4 | 2015-03-11 18:21:00 -0700 | [diff] [blame] | 29 | readonly Func<T, byte[]> serializer; |
| 30 | readonly Func<byte[], T> deserializer; |
Jan Tattermusch | 15111f5 | 2015-02-05 18:15:14 -0800 | [diff] [blame] | 31 | |
Jan Tattermusch | 66eb18d | 2015-08-09 20:03:24 -0700 | [diff] [blame] | 32 | /// <summary> |
| 33 | /// Initializes a new marshaller. |
| 34 | /// </summary> |
| 35 | /// <param name="serializer">Function that will be used to serialize messages.</param> |
| 36 | /// <param name="deserializer">Function that will be used to deserialize messages.</param> |
Jan Tattermusch | 15111f5 | 2015-02-05 18:15:14 -0800 | [diff] [blame] | 37 | public Marshaller(Func<T, byte[]> serializer, Func<byte[], T> deserializer) |
| 38 | { |
Jan Tattermusch | 7a3ee6a | 2016-02-18 10:36:02 -0800 | [diff] [blame] | 39 | this.serializer = GrpcPreconditions.CheckNotNull(serializer, "serializer"); |
| 40 | this.deserializer = GrpcPreconditions.CheckNotNull(deserializer, "deserializer"); |
Jan Tattermusch | 15111f5 | 2015-02-05 18:15:14 -0800 | [diff] [blame] | 41 | } |
| 42 | |
Jan Tattermusch | 66eb18d | 2015-08-09 20:03:24 -0700 | [diff] [blame] | 43 | /// <summary> |
| 44 | /// Gets the serializer function. |
| 45 | /// </summary> |
Jan Tattermusch | 15111f5 | 2015-02-05 18:15:14 -0800 | [diff] [blame] | 46 | public Func<T, byte[]> Serializer |
| 47 | { |
| 48 | get |
| 49 | { |
| 50 | return this.serializer; |
| 51 | } |
| 52 | } |
| 53 | |
Jan Tattermusch | 66eb18d | 2015-08-09 20:03:24 -0700 | [diff] [blame] | 54 | /// <summary> |
| 55 | /// Gets the deserializer function. |
| 56 | /// </summary> |
Jan Tattermusch | 15111f5 | 2015-02-05 18:15:14 -0800 | [diff] [blame] | 57 | public Func<byte[], T> Deserializer |
| 58 | { |
| 59 | get |
| 60 | { |
| 61 | return this.deserializer; |
| 62 | } |
| 63 | } |
| 64 | } |
| 65 | |
Jan Tattermusch | 286975f | 2015-03-12 14:04:36 -0700 | [diff] [blame] | 66 | /// <summary> |
| 67 | /// Utilities for creating marshallers. |
| 68 | /// </summary> |
Jan Tattermusch | 075dde4 | 2015-03-11 18:21:00 -0700 | [diff] [blame] | 69 | public static class Marshallers |
| 70 | { |
Jan Tattermusch | 66eb18d | 2015-08-09 20:03:24 -0700 | [diff] [blame] | 71 | /// <summary> |
| 72 | /// Creates a marshaller from specified serializer and deserializer. |
| 73 | /// </summary> |
Jan Tattermusch | 075dde4 | 2015-03-11 18:21:00 -0700 | [diff] [blame] | 74 | public static Marshaller<T> Create<T>(Func<T, byte[]> serializer, Func<byte[], T> deserializer) |
Jan Tattermusch | 15111f5 | 2015-02-05 18:15:14 -0800 | [diff] [blame] | 75 | { |
| 76 | return new Marshaller<T>(serializer, deserializer); |
| 77 | } |
| 78 | |
Jan Tattermusch | 66eb18d | 2015-08-09 20:03:24 -0700 | [diff] [blame] | 79 | /// <summary> |
| 80 | /// Returns a marshaller for <c>string</c> type. This is useful for testing. |
| 81 | /// </summary> |
Jan Tattermusch | 15111f5 | 2015-02-05 18:15:14 -0800 | [diff] [blame] | 82 | public static Marshaller<string> StringMarshaller |
| 83 | { |
| 84 | get |
| 85 | { |
Craig Tiller | 190d360 | 2015-02-18 09:23:38 -0800 | [diff] [blame] | 86 | return new Marshaller<string>(System.Text.Encoding.UTF8.GetBytes, |
Jan Tattermusch | 15111f5 | 2015-02-05 18:15:14 -0800 | [diff] [blame] | 87 | System.Text.Encoding.UTF8.GetString); |
| 88 | } |
| 89 | } |
Jan Tattermusch | 15111f5 | 2015-02-05 18:15:14 -0800 | [diff] [blame] | 90 | } |
| 91 | } |