Add DefaultListenSocket.

net/base/stream_listen_socket.h

+// Copyright (c) 2012 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.
+
+// Stream-based listen socket implementation that handles reading and writing
+// to the socket, but does not handle creating the socket nor connecting
+// sockets, which are handled by subclasses on creation and in Accept,
+// respectively.
+
+// Server that handles IO asynchronously in the specified MessageLoop. These

[mmenke, 2012/04/30 19:11:44]

nit:  "Server that" -> "This class" or "StreamListenSocket".

[Philippe, 2012/05/03 14:27:52]

Done.

+// objects are NOT thread safe. They use WSAEVENT handles to monitor activity
+// in a given MessageLoop. This means that callbacks will happen in that loop's
+// thread always and that all other methods (including constructors and
+// destructors) should also be called from the same thread.
+
+#ifndef NET_BASE_STREAM_LISTEN_SOCKET_H_
+#define NET_BASE_STREAM_LISTEN_SOCKET_H_
+#pragma once
+
+#include "build/build_config.h"
+
+#if defined(OS_WIN)
+#include <winsock2.h>
+#endif
+#include <string>
+#if defined(OS_WIN)
+#include "base/win/object_watcher.h"
+#elif defined(OS_POSIX)
+#include "base/message_loop.h"
+#endif
+
+#include "base/basictypes.h"
+#include "base/compiler_specific.h"
+#include "base/memory/ref_counted.h"
+#include "net/base/net_export.h"
+
+#if defined(OS_POSIX)
+typedef int SOCKET;
+#endif
+
+namespace net {
+
+class NET_EXPORT StreamListenSocket
+    : public base::RefCountedThreadSafe<StreamListenSocket>,
+#if defined(OS_WIN)
+      public base::win::ObjectWatcher::Delegate {
+#elif defined(OS_POSIX)
+      public MessageLoopForIO::Watcher {
+#endif
+
+ public:
+  // TODO(erikkay): this delegate should really be split into two parts
+  // to split up the listener from the connected socket.  Perhaps this class
+  // should be split up similarly.
+  class Delegate {
+   public:
+    virtual ~Delegate() {}
+
+    // |server| is the original listening Socket, connection is the new
+    // Socket that was created.  Ownership of |connection| is transferred
+    // to the delegate with this call.
+    virtual void DidAccept(StreamListenSocket* server,
+                           StreamListenSocket* connection) = 0;
+    virtual void DidRead(StreamListenSocket* connection,
+                         const char* data,
+                         int len) = 0;
+    virtual void DidClose(StreamListenSocket* sock) = 0;
+  };
+
+  // Send data to the socket.
+  void Send(const char* bytes, int len, bool append_linefeed = false);
+  void Send(const std::string& str, bool append_linefeed = false);
+
+ protected:
+  enum WaitState {
+    NOT_WAITING      = 0,
+    WAITING_ACCEPT   = 1,
+    WAITING_READ     = 2
+  };
+
+  static const SOCKET kInvalidSocket;
+  static const int kSocketError;
+
+  StreamListenSocket(SOCKET s, Delegate* del);
+  virtual ~StreamListenSocket();
+
+  SOCKET AcceptSocket();
+  virtual void Accept() = 0;
+
+  void Listen();
+  void Read();
+  void Close();
+  void CloseSocket(SOCKET s);
+
+  // Pass any value in case of Windows, because in Windows
+  // we are not using state.
+  void WatchSocket(WaitState state);
+  void UnwatchSocket();
+
+#if defined(OS_WIN)

[mmenke, 2012/04/30 19:11:44]

Looks like this whole block (WIN and POSIX) can be made private.

[Philippe, 2012/05/03 14:27:52]

Done.

+  // ObjectWatcher delegate.
+  virtual void OnObjectSignaled(HANDLE object);
+  base::win::ObjectWatcher watcher_;
+  HANDLE socket_event_;
+#elif defined(OS_POSIX)
+  // Called by MessagePumpLibevent when the socket is ready to do I/O.
+  virtual void OnFileCanReadWithoutBlocking(int fd) OVERRIDE;
+  virtual void OnFileCanWriteWithoutBlocking(int fd) OVERRIDE;
+  WaitState wait_state_;
+  // The socket's libevent wrapper.
+  MessageLoopForIO::FileDescriptorWatcher watcher_;
+#endif
+
+  Delegate* const socket_delegate_;
+
+ private:
+  friend class base::RefCountedThreadSafe<StreamListenSocket>;
+
+  void SendInternal(const char* bytes, int len);
+
+  // NOTE: This is for unit test use only!
+  // Pause/Resume calling Read(). Note that ResumeReads() will also call
+  // Read() if there is anything to read.
+  friend class TransportClientSocketTest;

[mmenke, 2012/04/30 19:11:44]

This friend declaration should be above SendInternal.

[Philippe, 2012/05/03 14:27:52]

Done.

+
+  void PauseReads();
+  void ResumeReads();
+
+  const SOCKET socket_;
+  bool reads_paused_;
+  bool has_pending_reads_;
+
+  DISALLOW_COPY_AND_ASSIGN(StreamListenSocket);
+};
+
+}  // namespace net
+
+#endif  // NET_BASE_STREAM_LISTEN_SOCKET_H_