1 #region Copyright notice and license
2 // Protocol Buffers - Google's data interchange format
3 // Copyright 2008 Google Inc.  All rights reserved.
4 // https://developers.google.com/protocol-buffers/
5 //
6 // Redistribution and use in source and binary forms, with or without
7 // modification, are permitted provided that the following conditions are
8 // met:
9 //
10 //     * Redistributions of source code must retain the above copyright
11 // notice, this list of conditions and the following disclaimer.
12 //     * Redistributions in binary form must reproduce the above
13 // copyright notice, this list of conditions and the following disclaimer
14 // in the documentation and/or other materials provided with the
15 // distribution.
16 //     * Neither the name of Google Inc. nor the names of its
17 // contributors may be used to endorse or promote products derived from
18 // this software without specific prior written permission.
19 //
20 // THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
21 // "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
22 // LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
23 // A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
24 // OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
25 // SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
26 // LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
27 // DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
28 // THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
29 // (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
30 // OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
31 #endregion
32 
33 namespace Google.Protobuf.Reflection
34 {
35     /// <summary>
36     /// Describes a single method in a service.
37     /// </summary>
38     public sealed class MethodDescriptor : DescriptorBase
39     {
40         private readonly MethodDescriptorProto proto;
41         private readonly ServiceDescriptor service;
42         private MessageDescriptor inputType;
43         private MessageDescriptor outputType;
44 
45         /// <value>
46         /// The service this method belongs to.
47         /// </value>
48         public ServiceDescriptor Service { get { return service; } }
49 
50         /// <value>
51         /// The method's input type.
52         /// </value>
53         public MessageDescriptor InputType { get { return inputType; } }
54 
55         /// <value>
56         /// The method's input type.
57         /// </value>
58         public MessageDescriptor OutputType { get { return outputType; } }
59 
60         /// <value>
61         /// Indicates if client streams multiple requests.
62         /// </value>
63         public bool IsClientStreaming { get { return proto.ClientStreaming; } }
64 
65         /// <value>
66         /// Indicates if server streams multiple responses.
67         /// </value>
68         public bool IsServerStreaming { get { return proto.ServerStreaming; } }
69 
MethodDescriptor(MethodDescriptorProto proto, FileDescriptor file, ServiceDescriptor parent, int index)70         internal MethodDescriptor(MethodDescriptorProto proto, FileDescriptor file,
71                                   ServiceDescriptor parent, int index)
72             : base(file, parent.FullName + "." + proto.Name, index)
73         {
74             this.proto = proto;
75             service = parent;
76             file.DescriptorPool.AddSymbol(this);
77         }
78 
79         internal MethodDescriptorProto Proto { get { return proto; } }
80 
81         /// <summary>
82         /// The brief name of the descriptor's target.
83         /// </summary>
84         public override string Name { get { return proto.Name; } }
85 
CrossLink()86         internal void CrossLink()
87         {
88             IDescriptor lookup = File.DescriptorPool.LookupSymbol(Proto.InputType, this);
89             if (!(lookup is MessageDescriptor))
90             {
91                 throw new DescriptorValidationException(this, "\"" + Proto.InputType + "\" is not a message type.");
92             }
93             inputType = (MessageDescriptor) lookup;
94 
95             lookup = File.DescriptorPool.LookupSymbol(Proto.OutputType, this);
96             if (!(lookup is MessageDescriptor))
97             {
98                 throw new DescriptorValidationException(this, "\"" + Proto.OutputType + "\" is not a message type.");
99             }
100             outputType = (MessageDescriptor) lookup;
101         }
102     }
103 }