ProtoMemberAttribute.cs 8.9 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240
  1. using System;
  2. #if FEAT_IKVM
  3. using Type = IKVM.Reflection.Type;
  4. using IKVM.Reflection;
  5. #else
  6. using System.Reflection;
  7. #endif
  8. namespace ProtoBuf
  9. {
  10. /// <summary>
  11. /// Declares a member to be used in protocol-buffer serialization, using
  12. /// the given Tag. A DataFormat may be used to optimise the serialization
  13. /// format (for instance, using zigzag encoding for negative numbers, or
  14. /// fixed-length encoding for large values.
  15. /// </summary>
  16. [AttributeUsage(AttributeTargets.Property | AttributeTargets.Field,
  17. AllowMultiple = false, Inherited = true)]
  18. public class ProtoMemberAttribute : Attribute
  19. , IComparable
  20. #if !NO_GENERICS
  21. , IComparable<ProtoMemberAttribute>
  22. #endif
  23. {
  24. /// <summary>
  25. /// Compare with another ProtoMemberAttribute for sorting purposes
  26. /// </summary>
  27. public int CompareTo(object other) { return CompareTo(other as ProtoMemberAttribute); }
  28. /// <summary>
  29. /// Compare with another ProtoMemberAttribute for sorting purposes
  30. /// </summary>
  31. public int CompareTo(ProtoMemberAttribute other)
  32. {
  33. if (other == null) return -1;
  34. if ((object)this == (object)other) return 0;
  35. int result = this.tag.CompareTo(other.tag);
  36. if (result == 0) result = string.CompareOrdinal(this.name, other.name);
  37. return result;
  38. }
  39. /// <summary>
  40. /// Creates a new ProtoMemberAttribute instance.
  41. /// </summary>
  42. /// <param name="tag">Specifies the unique tag used to identify this member within the type.</param>
  43. public ProtoMemberAttribute(int tag) : this(tag, false)
  44. { }
  45. internal ProtoMemberAttribute(int tag, bool forced)
  46. {
  47. if (tag <= 0 && !forced) throw new ArgumentOutOfRangeException("tag");
  48. this.tag = tag;
  49. }
  50. #if !NO_RUNTIME
  51. internal MemberInfo Member, BackingMember;
  52. internal bool TagIsPinned;
  53. #endif
  54. /// <summary>
  55. /// Gets or sets the original name defined in the .proto; not used
  56. /// during serialization.
  57. /// </summary>
  58. public string Name { get { return name; } set { name = value; } }
  59. private string name;
  60. /// <summary>
  61. /// Gets or sets the data-format to be used when encoding this value.
  62. /// </summary>
  63. public DataFormat DataFormat { get { return dataFormat; } set { dataFormat = value; } }
  64. private DataFormat dataFormat;
  65. /// <summary>
  66. /// Gets the unique tag used to identify this member within the type.
  67. /// </summary>
  68. public int Tag { get { return tag; } }
  69. private int tag;
  70. internal void Rebase(int tag) { this.tag = tag; }
  71. public string TypeName { get { return typeName; } set { typeName = value; } }
  72. private string typeName;
  73. public string KeyTypeName { get { return keyTypeName; } set { keyTypeName = value; } }
  74. private string keyTypeName;
  75. /// <summary>
  76. /// Gets or sets a value indicating whether this member is mandatory.
  77. /// </summary>
  78. public bool IsRequired {
  79. get { return (options & MemberSerializationOptions.Required) == MemberSerializationOptions.Required; }
  80. set {
  81. if (value) options |= MemberSerializationOptions.Required;
  82. else options &= ~MemberSerializationOptions.Required;
  83. }
  84. }
  85. /// <summary>
  86. /// Gets a value indicating whether this member is packed.
  87. /// This option only applies to list/array data of primitive types (int, double, etc).
  88. /// </summary>
  89. public bool IsPacked
  90. {
  91. get { return (options & MemberSerializationOptions.Packed) == MemberSerializationOptions.Packed;}
  92. set {
  93. if (value) options |= MemberSerializationOptions.Packed;
  94. else options &= ~MemberSerializationOptions.Packed;
  95. }
  96. }
  97. /// <summary>
  98. /// Indicates whether this field should *repace* existing values (the default is false, meaning *append*).
  99. /// This option only applies to list/array data.
  100. /// </summary>
  101. public bool OverwriteList
  102. {
  103. get { return (options & MemberSerializationOptions.OverwriteList) == MemberSerializationOptions.OverwriteList; }
  104. set
  105. {
  106. if (value) options |= MemberSerializationOptions.OverwriteList;
  107. else options &= ~MemberSerializationOptions.OverwriteList;
  108. }
  109. }
  110. /// <summary>
  111. /// Enables full object-tracking/full-graph support.
  112. /// </summary>
  113. public bool AsReference
  114. {
  115. get { return (options & MemberSerializationOptions.AsReference) == MemberSerializationOptions.AsReference; }
  116. set
  117. {
  118. if (value) options |= MemberSerializationOptions.AsReference;
  119. else options &= ~MemberSerializationOptions.AsReference;
  120. options |= MemberSerializationOptions.AsReferenceHasValue;
  121. }
  122. }
  123. internal bool AsReferenceHasValue
  124. {
  125. get { return (options & MemberSerializationOptions.AsReferenceHasValue) == MemberSerializationOptions.AsReferenceHasValue; }
  126. set {
  127. if (value) options |= MemberSerializationOptions.AsReferenceHasValue;
  128. else options &= ~MemberSerializationOptions.AsReferenceHasValue;
  129. }
  130. }
  131. /// <summary>
  132. /// Embeds the type information into the stream, allowing usage with types not known in advance.
  133. /// </summary>
  134. public bool DynamicType
  135. {
  136. get { return (options & MemberSerializationOptions.DynamicType) == MemberSerializationOptions.DynamicType; }
  137. set
  138. {
  139. if (value) options |= MemberSerializationOptions.DynamicType;
  140. else options &= ~MemberSerializationOptions.DynamicType;
  141. }
  142. }
  143. /// <summary>
  144. /// Gets or sets a value indicating whether this member is packed (lists/arrays).
  145. /// </summary>
  146. public MemberSerializationOptions Options { get { return options; } set { options = value; } }
  147. private MemberSerializationOptions options;
  148. }
  149. /// <summary>
  150. /// Additional (optional) settings that control serialization of members
  151. /// </summary>
  152. [Flags]
  153. public enum MemberSerializationOptions
  154. {
  155. /// <summary>
  156. /// Default; no additional options
  157. /// </summary>
  158. None = 0,
  159. /// <summary>
  160. /// Indicates that repeated elements should use packed (length-prefixed) encoding
  161. /// </summary>
  162. Packed = 1,
  163. /// <summary>
  164. /// Indicates that the given item is required
  165. /// </summary>
  166. Required = 2,
  167. /// <summary>
  168. /// Enables full object-tracking/full-graph support
  169. /// </summary>
  170. AsReference = 4,
  171. /// <summary>
  172. /// Embeds the type information into the stream, allowing usage with types not known in advance
  173. /// </summary>
  174. DynamicType = 8,
  175. /// <summary>
  176. /// Indicates whether this field should *repace* existing values (the default is false, meaning *append*).
  177. /// This option only applies to list/array data.
  178. /// </summary>
  179. OverwriteList = 16,
  180. /// <summary>
  181. /// Determines whether the types AsReferenceDefault value is used, or whether this member's AsReference should be used
  182. /// </summary>
  183. AsReferenceHasValue = 32
  184. }
  185. /// <summary>
  186. /// Declares a member to be used in protocol-buffer serialization, using
  187. /// the given Tag and MemberName. This allows ProtoMemberAttribute usage
  188. /// even for partial classes where the individual members are not
  189. /// under direct control.
  190. /// A DataFormat may be used to optimise the serialization
  191. /// format (for instance, using zigzag encoding for negative numbers, or
  192. /// fixed-length encoding for large values.
  193. /// </summary>
  194. [AttributeUsage(AttributeTargets.Class,
  195. AllowMultiple = true, Inherited = false)]
  196. public sealed class ProtoPartialMemberAttribute : ProtoMemberAttribute
  197. {
  198. /// <summary>
  199. /// Creates a new ProtoMemberAttribute instance.
  200. /// </summary>
  201. /// <param name="tag">Specifies the unique tag used to identify this member within the type.</param>
  202. /// <param name="memberName">Specifies the member to be serialized.</param>
  203. public ProtoPartialMemberAttribute(int tag, string memberName)
  204. : base(tag)
  205. {
  206. #if !NO_RUNTIME
  207. if (Helpers.IsNullOrEmpty(memberName)) throw new ArgumentNullException("memberName");
  208. #endif
  209. this.memberName = memberName;
  210. }
  211. /// <summary>
  212. /// The name of the member to be serialized.
  213. /// </summary>
  214. public string MemberName { get { return memberName; } }
  215. private readonly string memberName;
  216. }
  217. }