Pull new version of protobuf sources.

third_party/protobuf/java/src/main/java/com/google/protobuf/UnknownFieldSetLite.java

+// Protocol Buffers - Google's data interchange format
+// Copyright 2008 Google Inc.  All rights reserved.
+// https://developers.google.com/protocol-buffers/
+//
+// Redistribution and use in source and binary forms, with or without
+// modification, are permitted provided that the following conditions are
+// met:
+//
+//     * Redistributions of source code must retain the above copyright
+// notice, this list of conditions and the following disclaimer.
+//     * Redistributions in binary form must reproduce the above
+// copyright notice, this list of conditions and the following disclaimer
+// in the documentation and/or other materials provided with the
+// distribution.
+//     * Neither the name of Google Inc. nor the names of its
+// contributors may be used to endorse or promote products derived from
+// this software without specific prior written permission.
+//
+// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+// "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+// LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+// A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+// OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+// SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+// LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+// DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+// THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+// (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+// OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+package com.google.protobuf;
+
+import java.io.IOException;
+
+/**
+ * {@code UnknownFieldSetLite} is used to keep track of fields which were seen
+ * when parsing a protocol message but whose field numbers or types are
+ * unrecognized. This most frequently occurs when new fields are added to a
+ * message type and then messages containing those fields are read by old
+ * software that was compiled before the new types were added.
+ *
+ * <p>For use by generated code only.
+ *
+ * @author dweis@google.com (Daniel Weis)
+ */
+public final class UnknownFieldSetLite {
+
+  private static final UnknownFieldSetLite DEFAULT_INSTANCE =
+      new UnknownFieldSetLite(ByteString.EMPTY);
+
+  /**
+   * Get an empty {@code UnknownFieldSetLite}.
+   *
+   * <p>For use by generated code only.
+   */
+  public static UnknownFieldSetLite getDefaultInstance() {
+    return DEFAULT_INSTANCE;
+  }
+
+  /**
+   * Create a new {@link Builder}.
+   *
+   * <p>For use by generated code only.
+   */
+  public static Builder newBuilder() {
+    return new Builder();
+  }
+
+  /**
+   * Returns an {@code UnknownFieldSetLite} that is the composite of {@code first} and
+   * {@code second}.
+   */
+  static UnknownFieldSetLite concat(UnknownFieldSetLite first, UnknownFieldSetLite second) {
+    return new UnknownFieldSetLite(first.byteString.concat(second.byteString));
+  }
+
+  /**
+   * The internal representation of the unknown fields.
+   */
+  private final ByteString byteString;
+
+  /**
+   * Constructs the {@code UnknownFieldSetLite} as a thin wrapper around {@link ByteString}.
+   */
+  private UnknownFieldSetLite(ByteString byteString) {
+    this.byteString = byteString;
+  }
+
+  /**
+   * Serializes the set and writes it to {@code output}.
+   *
+   * <p>For use by generated code only.
+   */
+  public void writeTo(CodedOutputStream output) throws IOException {
+    output.writeRawBytes(byteString);
+  }
+
+
+  /**
+   * Get the number of bytes required to encode this set.
+   *
+   * <p>For use by generated code only.
+   */
+  public int getSerializedSize() {
+    return byteString.size();
+  }
+
+  @Override
+  public boolean equals(Object obj) {
+    if (this == obj) {
+      return true;
+    }
+
+    if (obj instanceof UnknownFieldSetLite) {
+      return byteString.equals(((UnknownFieldSetLite) obj).byteString);
+    }
+
+    return false;
+  }
+
+  @Override
+  public int hashCode() {
+    return byteString.hashCode();
+  }
+
+  /**
+   * Builder for {@link UnknownFieldSetLite}s.
+   *
+   * <p>Use {@link UnknownFieldSet#newBuilder()} to construct a {@code Builder}.
+   *
+   * <p>For use by generated code only.
+   */
+  public static final class Builder {
+
+    private ByteString.Output byteStringOutput;
+    private CodedOutputStream output;
+    private boolean built;
+
+    /**
+     * Constructs a {@code Builder}. Lazily initialized by
+     * {@link #ensureInitializedButNotBuilt()}.
+     */
+    private Builder() {}
+
+    /**
+     * Ensures internal state is initialized for use.
+     */
+    private void ensureInitializedButNotBuilt() {
+      if (built) {
+        throw new IllegalStateException("Do not reuse UnknownFieldSetLite Builders.");
+      }
+
+      if (output == null && byteStringOutput == null) {
+          byteStringOutput = ByteString.newOutput(100 /* initialCapacity */);
+          output = CodedOutputStream.newInstance(byteStringOutput);
+      }
+    }
+
+    /**
+     * Parse a single field from {@code input} and merge it into this set.
+     *
+     * <p>For use by generated code only.
+     *
+     * @param tag The field's tag number, which was already parsed.
+     * @return {@code false} if the tag is an end group tag.
+     */
+    public boolean mergeFieldFrom(final int tag, final CodedInputStream input)
+                                  throws IOException {
+      ensureInitializedButNotBuilt();
+
+      final int fieldNumber = WireFormat.getTagFieldNumber(tag);
+      switch (WireFormat.getTagWireType(tag)) {
+        case WireFormat.WIRETYPE_VARINT:
+          output.writeUInt64(fieldNumber, input.readInt64());
+          return true;
+        case WireFormat.WIRETYPE_FIXED32:
+          output.writeFixed32(fieldNumber, input.readFixed32());
+          return true;
+        case WireFormat.WIRETYPE_FIXED64:
+          output.writeFixed64(fieldNumber, input.readFixed64());
+          return true;
+        case WireFormat.WIRETYPE_LENGTH_DELIMITED:
+          output.writeBytes(fieldNumber, input.readBytes());
+          return true;
+        case WireFormat.WIRETYPE_START_GROUP:
+          final Builder subBuilder = newBuilder();
+          subBuilder.mergeFrom(input);
+          input.checkLastTagWas(
+              WireFormat.makeTag(fieldNumber, WireFormat.WIRETYPE_END_GROUP));
+
+          output.writeTag(fieldNumber, WireFormat.WIRETYPE_START_GROUP);
+          subBuilder.build().writeTo(output);
+          output.writeTag(fieldNumber, WireFormat.WIRETYPE_END_GROUP);
+          return true;
+        case WireFormat.WIRETYPE_END_GROUP:
+          return false;
+        default:
+          throw InvalidProtocolBufferException.invalidWireType();
+      }
+    }
+
+    /**
+     * Convenience method for merging a new field containing a single varint
+     * value. This is used in particular when an unknown enum value is
+     * encountered.
+     *
+     * <p>For use by generated code only.
+     */
+    public Builder mergeVarintField(int fieldNumber, int value) {
+      if (fieldNumber == 0) {
+        throw new IllegalArgumentException("Zero is not a valid field number.");
+      }
+      ensureInitializedButNotBuilt();
+      try {
+        output.writeUInt64(fieldNumber, value);
+      } catch (IOException e) {
+        // Should never happen.
+      }
+      return this;
+    }
+
+    /**
+     * Convenience method for merging a length-delimited field.
+     *
+     * <p>For use by generated code only.
+     */
+    public Builder mergeLengthDelimitedField(
+        final int fieldNumber, final ByteString value) {  
+      if (fieldNumber == 0) {
+        throw new IllegalArgumentException("Zero is not a valid field number.");
+      }
+      ensureInitializedButNotBuilt();
+      try {
+        output.writeBytes(fieldNumber, value);
+      } catch (IOException e) {
+        // Should never happen.
+      }
+      return this;
+    }
+
+    /**
+     * Build the {@link UnknownFieldSetLite} and return it.
+     *
+     * <p>Once {@code build()} has been called, the {@code Builder} will no
+     * longer be usable.  Calling any method after {@code build()} will result
+     * in undefined behavior and can cause a {@code IllegalStateException} to be
+     * thrown.
+     *
+     * <p>For use by generated code only.
+     */
+    public UnknownFieldSetLite build() {
+      if (built) {
+        throw new IllegalStateException("Do not reuse UnknownFieldSetLite Builders.");
+      }
+
+      built = true;
+
+      final UnknownFieldSetLite result;
+      // If we were never initialized, no data was written.
+      if (output == null) {
+        result = getDefaultInstance();
+      } else {
+        try {
+          output.flush();
+        } catch (IOException e) {
+          // Should never happen.
+        }
+        ByteString byteString = byteStringOutput.toByteString();
+        if (byteString.isEmpty()) {
+          result = getDefaultInstance();
+        } else {
+          result = new UnknownFieldSetLite(byteString);
+        }
+      }
+
+      // Allow for garbage collection.
+      output = null;
+      byteStringOutput = null;
+      return result;
+    }
+
+    /**
+     * Parse an entire message from {@code input} and merge its fields into
+     * this set.
+     */
+    private Builder mergeFrom(final CodedInputStream input) throws IOException {
+      // Ensures initialization in mergeFieldFrom.
+      while (true) {
+        final int tag = input.readTag();
+        if (tag == 0 || !mergeFieldFrom(tag, input)) {
+          break;
+        }
+      }
+      return this;
+    }
+  }
+}