Define Stable API for WebRTC/Quartc

net/quic/quartc/quartc_factory_interface.h

+// Copyright (c) 2016 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 NET_QUIC_QUARTC_QUARTC_FACTORY_INTERFACE_H_
+#define NET_QUIC_QUARTC_QUARTC_FACTORY_INTERFACE_H_
+
+#include "net/base/net_export.h"
+#include "net/quic/quartc/quartc_session_interface.h"
+#include "net/quic/quartc/quartc_task_runner_interface.h"
+
+namespace net {
+
+// Used to create instances for Quartc objects such as QuartcSession. Only one
+// QuartcFactory is expected to be created.

[pthatcher2, 2016/10/24 17:42:49]

This comment should be on the QuartcFactory, not the QuartcFactoryInterface,
since it's an implementation detail.

[zhihuang1, 2016/10/24 19:08:10]

Done.

+class QuartcFactoryInterface {
+ public:
+  virtual ~QuartcFactoryInterface() {}
+
+  struct QuartcSessionConfig {
+    // When using Quartc, there are two endpoints. The QuartcSession on one
+    // endpoint must act as a server and the one on the other side must act as a
+    // client.
+    bool is_server = false;
+    // This is only needed when is_server = false.  It must be unique
+    // for each endpoint the local endpoint may communicate with. For example,
+    // a WebRTC client could use the remote endpoint's crypto fingerprint
+    std::string unique_remote_server_id;
+    // The way the QuicConnection will send and receive packets, like a virtual
+    // UDP socket. For WebRTC, this will typically be an IceTransport.
+    QuartcSessionInterface::PacketTransport* packet_transport = nullptr;
+    // The maximum size of the packet can be written with the packet writer.
+    // 1200 bytes by default.
+    uint64_t max_packet_size = 1200;
+  };
+
+  virtual std::unique_ptr<QuartcSessionInterface> CreateQuartcSession(
+      const QuartcSessionConfig& quartc_config) = 0;
+};
+
+// The configuration for creating a QuartcFactory.
+struct QuartcFactoryConfig {
+  // The task runner used by the QuartcAlarm. Implemented by the Quartc user
+  // with different mechanism. For example in WebRTC, it is implemented with
+  // rtc::Thread.
+  QuartcTaskRunnerInterface* task_runner = nullptr;
+  // If create_at_exit_manager = true, an AtExitManager will be created and
+  // owned by the QuartcFactory. In some scenarios, such as unit tests, this
+  // value could be false and no AtExitManager will be created.
+  bool create_at_exit_manager = true;
+};
+
+// Creates a new instance of QuartcFactoryInterface.
+NET_EXPORT_PRIVATE std::unique_ptr<QuartcFactoryInterface> CreateQuartcFactory(
+    const QuartcFactoryConfig& factory_config);
+
+}  // namepace net
+
+#endif  // NET_QUIC_QUARTC_QUARTC_FACTORY_INTERFACE_H_