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 using System;
34 using System.Collections.Generic;
35 
36 namespace Google.Protobuf.Reflection
37 {
38     /// <summary>
39     /// Describes a service type.
40     /// </summary>
41     public sealed class ServiceDescriptor : DescriptorBase
42     {
43         private readonly ServiceDescriptorProto proto;
44         private readonly IList<MethodDescriptor> methods;
45 
ServiceDescriptor(ServiceDescriptorProto proto, FileDescriptor file, int index)46         internal ServiceDescriptor(ServiceDescriptorProto proto, FileDescriptor file, int index)
47             : base(file, file.ComputeFullName(null, proto.Name), index)
48         {
49             this.proto = proto;
50             methods = DescriptorUtil.ConvertAndMakeReadOnly(proto.Method,
51                                                             (method, i) => new MethodDescriptor(method, file, this, i));
52 
53             file.DescriptorPool.AddSymbol(this);
54         }
55 
56         /// <summary>
57         /// The brief name of the descriptor's target.
58         /// </summary>
59         public override string Name { get { return proto.Name; } }
60 
61         internal ServiceDescriptorProto Proto { get { return proto; } }
62 
63         /// <value>
64         /// An unmodifiable list of methods in this service.
65         /// </value>
66         public IList<MethodDescriptor> Methods
67         {
68             get { return methods; }
69         }
70 
71         /// <summary>
72         /// Finds a method by name.
73         /// </summary>
74         /// <param name="name">The unqualified name of the method (e.g. "Foo").</param>
75         /// <returns>The method's decsriptor, or null if not found.</returns>
FindMethodByName(String name)76         public MethodDescriptor FindMethodByName(String name)
77         {
78             return File.DescriptorPool.FindSymbol<MethodDescriptor>(FullName + "." + name);
79         }
80 
CrossLink()81         internal void CrossLink()
82         {
83             foreach (MethodDescriptor method in methods)
84             {
85                 method.CrossLink();
86             }
87         }
88     }
89 }