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
33using System;
34using System.Collections.Generic;
35
36namespace 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
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>
76        public MethodDescriptor FindMethodByName(String name)
77        {
78            return File.DescriptorPool.FindSymbol<MethodDescriptor>(FullName + "." + name);
79        }
80
81        internal void CrossLink()
82        {
83            foreach (MethodDescriptor method in methods)
84            {
85                method.CrossLink();
86            }
87        }
88    }
89}