|
|
|
|
@ -35,7 +35,6 @@ |
|
|
|
|
using System; |
|
|
|
|
using System.Collections.Generic; |
|
|
|
|
using System.IO; |
|
|
|
|
using Google.ProtocolBuffers.Descriptors; |
|
|
|
|
|
|
|
|
|
namespace Google.ProtocolBuffers { |
|
|
|
|
|
|
|
|
|
@ -47,90 +46,23 @@ namespace Google.ProtocolBuffers { |
|
|
|
|
/// use explicit interface implemenation for the non-generic form. This mirrors |
|
|
|
|
/// how IEnumerable and IEnumerable<T> work. |
|
|
|
|
/// </summary> |
|
|
|
|
public interface IBuilder { |
|
|
|
|
public interface IBuilderLite { |
|
|
|
|
/// <summary> |
|
|
|
|
/// Returns true iff all required fields in the message and all |
|
|
|
|
/// embedded messages are set. |
|
|
|
|
/// </summary> |
|
|
|
|
bool IsInitialized { get; } |
|
|
|
|
|
|
|
|
|
/// <summary> |
|
|
|
|
/// Only present in the nongeneric interface - useful for tests, but |
|
|
|
|
/// not as much in real life. |
|
|
|
|
/// </summary> |
|
|
|
|
IBuilder SetField(FieldDescriptor field, object value); |
|
|
|
|
|
|
|
|
|
/// <summary> |
|
|
|
|
/// Only present in the nongeneric interface - useful for tests, but |
|
|
|
|
/// not as much in real life. |
|
|
|
|
/// </summary> |
|
|
|
|
IBuilder SetRepeatedField(FieldDescriptor field, int index, object value); |
|
|
|
|
|
|
|
|
|
/// <summary> |
|
|
|
|
/// Behaves like the equivalent property in IMessage<T>. |
|
|
|
|
/// The returned map may or may not reflect future changes to the builder. |
|
|
|
|
/// Either way, the returned map is unmodifiable. |
|
|
|
|
/// </summary> |
|
|
|
|
IDictionary<FieldDescriptor, object> AllFields { get; } |
|
|
|
|
|
|
|
|
|
/// <summary> |
|
|
|
|
/// Allows getting and setting of a field. |
|
|
|
|
/// <see cref="IMessage{TMessage, TBuilder}.Item(FieldDescriptor)"/> |
|
|
|
|
/// </summary> |
|
|
|
|
/// <param name="field"></param> |
|
|
|
|
/// <returns></returns> |
|
|
|
|
object this[FieldDescriptor field] { get; set; } |
|
|
|
|
|
|
|
|
|
/// <summary> |
|
|
|
|
/// Get the message's type descriptor. |
|
|
|
|
/// <see cref="IMessage{TMessage, TBuilder}.DescriptorForType"/> |
|
|
|
|
/// </summary> |
|
|
|
|
MessageDescriptor DescriptorForType { get; } |
|
|
|
|
|
|
|
|
|
/// <summary> |
|
|
|
|
/// <see cref="IMessage{TMessage, TBuilder}.GetRepeatedFieldCount"/> |
|
|
|
|
/// </summary> |
|
|
|
|
/// <param name="field"></param> |
|
|
|
|
/// <returns></returns> |
|
|
|
|
int GetRepeatedFieldCount(FieldDescriptor field); |
|
|
|
|
|
|
|
|
|
/// <summary> |
|
|
|
|
/// Allows getting and setting of a repeated field value. |
|
|
|
|
/// <see cref="IMessage{TMessage, TBuilder}.Item(FieldDescriptor, int)"/> |
|
|
|
|
/// </summary> |
|
|
|
|
object this[FieldDescriptor field, int index] { get; set; } |
|
|
|
|
|
|
|
|
|
/// <summary> |
|
|
|
|
/// <see cref="IMessage{TMessage, TBuilder}.HasField"/> |
|
|
|
|
/// </summary> |
|
|
|
|
bool HasField(FieldDescriptor field); |
|
|
|
|
|
|
|
|
|
/// <summary> |
|
|
|
|
/// <see cref="IMessage{TMessage, TBuilder}.UnknownFields"/> |
|
|
|
|
/// </summary> |
|
|
|
|
UnknownFieldSet UnknownFields { get; set; } |
|
|
|
|
|
|
|
|
|
/// <summary> |
|
|
|
|
/// Create a builder for messages of the appropriate type for the given field. |
|
|
|
|
/// Messages built with this can then be passed to the various mutation properties |
|
|
|
|
/// and methods. |
|
|
|
|
/// </summary> |
|
|
|
|
IBuilder CreateBuilderForField(FieldDescriptor field); |
|
|
|
|
|
|
|
|
|
#region Methods which are like those of the generic form, but without any knowledge of the type parameters |
|
|
|
|
IBuilder WeakAddRepeatedField(FieldDescriptor field, object value); |
|
|
|
|
IBuilder WeakClear(); |
|
|
|
|
IBuilder WeakClearField(FieldDescriptor field); |
|
|
|
|
IBuilder WeakMergeFrom(IMessage message); |
|
|
|
|
IBuilder WeakMergeFrom(ByteString data); |
|
|
|
|
IBuilder WeakMergeFrom(ByteString data, ExtensionRegistry registry); |
|
|
|
|
IBuilder WeakMergeFrom(CodedInputStream input); |
|
|
|
|
IBuilder WeakMergeFrom(CodedInputStream input, ExtensionRegistry registry); |
|
|
|
|
IMessage WeakBuild(); |
|
|
|
|
IMessage WeakBuildPartial(); |
|
|
|
|
IBuilder WeakClone(); |
|
|
|
|
IMessage WeakDefaultInstanceForType { get; } |
|
|
|
|
#endregion |
|
|
|
|
IBuilderLite WeakClear(); |
|
|
|
|
IBuilderLite WeakMergeFrom(IMessageLite message); |
|
|
|
|
IBuilderLite WeakMergeFrom(ByteString data); |
|
|
|
|
IBuilderLite WeakMergeFrom(ByteString data, ExtensionRegistryLite registry); |
|
|
|
|
IBuilderLite WeakMergeFrom(CodedInputStream input); |
|
|
|
|
IBuilderLite WeakMergeFrom(CodedInputStream input, ExtensionRegistryLite registry); |
|
|
|
|
IMessageLite WeakBuild(); |
|
|
|
|
IMessageLite WeakBuildPartial(); |
|
|
|
|
IBuilderLite WeakClone(); |
|
|
|
|
IMessageLite WeakDefaultInstanceForType { get; } |
|
|
|
|
} |
|
|
|
|
|
|
|
|
|
/// <summary> |
|
|
|
|
@ -139,11 +71,9 @@ namespace Google.ProtocolBuffers { |
|
|
|
|
/// </summary> |
|
|
|
|
/// <typeparam name="TMessage">Type of message</typeparam> |
|
|
|
|
/// <typeparam name="TBuilder">Type of builder</typeparam> |
|
|
|
|
public interface IBuilder<TMessage, TBuilder> : IBuilder |
|
|
|
|
where TMessage : IMessage<TMessage, TBuilder> |
|
|
|
|
where TBuilder : IBuilder<TMessage, TBuilder> { |
|
|
|
|
|
|
|
|
|
TBuilder SetUnknownFields(UnknownFieldSet unknownFields); |
|
|
|
|
public interface IBuilderLite<TMessage, TBuilder> : IBuilderLite |
|
|
|
|
where TMessage : IMessageLite<TMessage, TBuilder> |
|
|
|
|
where TBuilder : IBuilderLite<TMessage, TBuilder> { |
|
|
|
|
|
|
|
|
|
/// <summary> |
|
|
|
|
/// Resets all fields to their default values. |
|
|
|
|
@ -169,7 +99,7 @@ namespace Google.ProtocolBuffers { |
|
|
|
|
/// Merge the specified other message which may be a different implementation of |
|
|
|
|
/// the same message descriptor. |
|
|
|
|
/// </summary> |
|
|
|
|
TBuilder MergeFrom(IMessage other); |
|
|
|
|
TBuilder MergeFrom(IMessageLite other); |
|
|
|
|
|
|
|
|
|
/// <summary> |
|
|
|
|
/// Constructs the final message. Once this is called, this Builder instance |
|
|
|
|
@ -221,36 +151,14 @@ namespace Google.ProtocolBuffers { |
|
|
|
|
/// in <paramref name="extensionRegistry"/>. Extensions not in the registry |
|
|
|
|
/// will be treated as unknown fields. |
|
|
|
|
/// </summary> |
|
|
|
|
TBuilder MergeFrom(CodedInputStream input, ExtensionRegistry extensionRegistry); |
|
|
|
|
TBuilder MergeFrom(CodedInputStream input, ExtensionRegistryLite extensionRegistry); |
|
|
|
|
|
|
|
|
|
/// <summary> |
|
|
|
|
/// Get's the message's type's default instance. |
|
|
|
|
/// <see cref="IMessage{TMessage}.DefaultInstanceForType" /> |
|
|
|
|
/// <see cref="IMessageLite{TMessage}.DefaultInstanceForType" /> |
|
|
|
|
/// </summary> |
|
|
|
|
TMessage DefaultInstanceForType { get; } |
|
|
|
|
|
|
|
|
|
/// <summary> |
|
|
|
|
/// Clears the field. This is exactly equivalent to calling the generated |
|
|
|
|
/// Clear method corresponding to the field. |
|
|
|
|
/// </summary> |
|
|
|
|
/// <param name="field"></param> |
|
|
|
|
/// <returns></returns> |
|
|
|
|
TBuilder ClearField(FieldDescriptor field); |
|
|
|
|
|
|
|
|
|
/// <summary> |
|
|
|
|
/// Appends the given value as a new element for the specified repeated field. |
|
|
|
|
/// </summary> |
|
|
|
|
/// <exception cref="ArgumentException">the field is not a repeated field, |
|
|
|
|
/// the field does not belong to this builder's type, or the value is |
|
|
|
|
/// of the incorrect type |
|
|
|
|
/// </exception> |
|
|
|
|
TBuilder AddRepeatedField(FieldDescriptor field, object value); |
|
|
|
|
|
|
|
|
|
/// <summary> |
|
|
|
|
/// Merge some unknown fields into the set for this message. |
|
|
|
|
/// </summary> |
|
|
|
|
TBuilder MergeUnknownFields(UnknownFieldSet unknownFields); |
|
|
|
|
|
|
|
|
|
/// <summary> |
|
|
|
|
/// Like MergeFrom(Stream), but does not read until the end of the file. |
|
|
|
|
/// Instead, the size of the message (encoded as a varint) is read first, |
|
|
|
|
@ -263,7 +171,7 @@ namespace Google.ProtocolBuffers { |
|
|
|
|
/// <summary> |
|
|
|
|
/// Like MergeDelimitedFrom(Stream) but supporting extensions. |
|
|
|
|
/// </summary> |
|
|
|
|
TBuilder MergeDelimitedFrom(Stream input, ExtensionRegistry extensionRegistry); |
|
|
|
|
TBuilder MergeDelimitedFrom(Stream input, ExtensionRegistryLite extensionRegistry); |
|
|
|
|
|
|
|
|
|
#region Convenience methods |
|
|
|
|
/// <summary> |
|
|
|
|
@ -278,7 +186,7 @@ namespace Google.ProtocolBuffers { |
|
|
|
|
/// it with the message being built. This is just a small wrapper around |
|
|
|
|
/// MergeFrom(CodedInputStream, ExtensionRegistry). |
|
|
|
|
/// </summary> |
|
|
|
|
TBuilder MergeFrom(ByteString data, ExtensionRegistry extensionRegistry); |
|
|
|
|
TBuilder MergeFrom(ByteString data, ExtensionRegistryLite extensionRegistry); |
|
|
|
|
|
|
|
|
|
/// <summary> |
|
|
|
|
/// Parse <paramref name="data"/> as a message of this type and merge |
|
|
|
|
@ -292,7 +200,7 @@ namespace Google.ProtocolBuffers { |
|
|
|
|
/// it with the message being built. This is just a small wrapper around |
|
|
|
|
/// MergeFrom(CodedInputStream, ExtensionRegistry). |
|
|
|
|
/// </summary> |
|
|
|
|
TBuilder MergeFrom(byte[] data, ExtensionRegistry extensionRegistry); |
|
|
|
|
TBuilder MergeFrom(byte[] data, ExtensionRegistryLite extensionRegistry); |
|
|
|
|
|
|
|
|
|
/// <summary> |
|
|
|
|
/// Parse <paramref name="input"/> as a message of this type and merge |
|
|
|
|
@ -311,7 +219,7 @@ namespace Google.ProtocolBuffers { |
|
|
|
|
/// it with the message being built. This is just a small wrapper around |
|
|
|
|
/// MergeFrom(CodedInputStream, ExtensionRegistry). |
|
|
|
|
/// </summary> |
|
|
|
|
TBuilder MergeFrom(Stream input, ExtensionRegistry extensionRegistry); |
|
|
|
|
TBuilder MergeFrom(Stream input, ExtensionRegistryLite extensionRegistry); |
|
|
|
|
#endregion |
|
|
|
|
} |
|
|
|
|
} |
|
|
|
|
|
csharptest
14 years ago
committed by
unknown