Add interfaces for most major Blimp net components.

blimp/net/blimp_message_output_buffer.h

+// Copyright 2015 The Chromium Authors. All rights reserved.
+// Use of this source code is governed by a BSD-style license that can be
+// found in the LICENSE file.
+
+#ifndef BLIMP_NET_BLIMP_MESSAGE_OUTPUT_BUFFER_H_
+#define BLIMP_NET_BLIMP_MESSAGE_OUTPUT_BUFFER_H_
+
+#include "base/macros.h"
+#include "blimp/net/blimp_message_ack_observer.h"
+#include "blimp/net/blimp_message_processor.h"
+#include "blimp/net/blimp_net_export.h"
+
+namespace blimp {
+
+class BlimpConnection;
+
+// Provides a FIFO buffer for reliable, ordered message delivery.
+// Messages are available for redelivery until they are acknowledged by the
+//    receiving end (via BlimpMessageAckObserver).
+class BLIMP_NET_EXPORT BlimpMessageOutputBuffer
+    : public BlimpMessageProcessor,
+      public BlimpMessageAckObserver {
+ public:
+  BlimpMessageOutputBuffer();
+
+  ~BlimpMessageOutputBuffer() override;
+
+  // Sets the processor for receiving messages from this buffer.
+  void SetOutgoingMessageProcessor(scoped_ptr<BlimpMessageProcessor> processor);
+
+  // BlimpMessageProcessor implementation.
+  // |callback|, if set, will be called once the remote end has acknowledged the
+  //     receipt of |message|.
+  // A sequence of N dependent writes with one acknowledgement can be had by
+  //     calling ProcessMessage() N-1 times with an empty |callback|, then
+  //     calling the final (Nth) message with |callback| set.
+  void ProcessMessage(const BlimpMessage& message,
+                      const net::CompletionCallback& callback) override;
+
+  // MessageAckObserver implementation.
+  // Removes BlimpMessages from the buffer whose ID is less than or equal to
+  // |message_id|.
+  // Invokes outstanding CompletionCallbacks for previously unacknowledged
+  // messages which have an ID less than or equal to |message_id|.
+  void OnMessageAck(int64 message_id) override;
+
+ private:
+  DISALLOW_COPY_AND_ASSIGN(BlimpMessageOutputBuffer);
+};
+
+}  // namespace blimp
+
+#endif  // BLIMP_NET_BLIMP_MESSAGE_OUTPUT_BUFFER_H_