| | | 1 | | // Copyright (c) ZeroC, Inc. |
| | | 2 | | |
| | | 3 | | using System.ComponentModel; |
| | | 4 | | |
| | | 5 | | namespace IceRpc.Ice.Operations; |
| | | 6 | | |
| | | 7 | | /// <summary>An attribute that Ice's Slice compiler (slice2cs) applies to abstract methods it generates on server-side |
| | | 8 | | /// interfaces (I{Name}Service). This attribute communicates information about the Ice operation to the IceRPC Service |
| | | 9 | | /// Generator (IceRpc.ServiceGenerator): the name of the operation plus various optional properties (see below). |
| | | 10 | | /// The Service Generator generates code that matches the operation name in incoming requests to the operation name |
| | | 11 | | /// specified by this attribute.</summary> |
| | | 12 | | /// <remarks>We limit the information communicated through this attribute to the strict minimum. The Service Generator |
| | | 13 | | /// can deduce most information from the signature of the method decorated with this attribute, such as the number of |
| | | 14 | | /// parameters and their mapped types.</remarks> |
| | | 15 | | [AttributeUsage(AttributeTargets.Method, Inherited = false)] |
| | | 16 | | [EditorBrowsable(EditorBrowsableState.Never)] |
| | | 17 | | public sealed class IceOperationAttribute : Attribute |
| | | 18 | | { |
| | | 19 | | /// <summary>Gets the operation name.</summary> |
| | | 20 | | /// <value>The operation name.</value> |
| | 0 | 21 | | public string Name { get; } |
| | | 22 | | |
| | | 23 | | /// <summary>Gets the exception specification of the operation.</summary> |
| | | 24 | | /// <value>An array of Ice exception types that the operation may throw.</value> |
| | | 25 | | /// <seealso cref="IceException"/> |
| | 0 | 26 | | public Type[] ExceptionSpecification { get; init; } = []; |
| | | 27 | | |
| | | 28 | | /// <summary>Gets a value indicating whether the operation is idempotent.</summary> |
| | | 29 | | /// <value><see langword="true"/> if the operation is idempotent; otherwise, <see langword="false"/>.</value> |
| | 0 | 30 | | public bool Idempotent { get; init; } |
| | | 31 | | |
| | | 32 | | /// <summary>Constructs an Ice operation attribute.</summary> |
| | | 33 | | /// <param name="name">The operation name.</param> |
| | 0 | 34 | | public IceOperationAttribute(string name) => Name = name; |
| | | 35 | | } |