RTCCertificateGenerator added.

webrtc/base/rtccertificategenerator.h

+/*
+ *  Copyright 2016 The WebRTC project authors. All Rights Reserved.
+ *
+ *  Use of this source code is governed by a BSD-style license
+ *  that can be found in the LICENSE file in the root of the source
+ *  tree. An additional intellectual property rights grant can be found
+ *  in the file PATENTS.  All contributing project authors may
+ *  be found in the AUTHORS file in the root of the source tree.
+ */
+
+#ifndef WEBRTC_BASE_RTCCERTIFICATEGENERATOR_H_
+#define WEBRTC_BASE_RTCCERTIFICATEGENERATOR_H_
+
+#include "webrtc/base/optional.h"
+#include "webrtc/base/refcount.h"
+#include "webrtc/base/rtccertificate.h"
+#include "webrtc/base/scoped_ref_ptr.h"
+#include "webrtc/base/sslidentity.h"
+#include "webrtc/base/thread.h"
+
+namespace rtc {
+
+class RTCCertificateGeneratorCallback : public RefCountInterface {
+ public:
+  virtual void OnSuccess(
+    const scoped_refptr<RTCCertificate>& certificate) = 0;
+  virtual void OnFailure() = 0;
+
+ protected:
+  ~RTCCertificateGeneratorCallback() override {}
+};
+
+// Generates |RTCCertificate|s. The |RTCCertificateGenerator| instance generates
+// certificates on the worker thread with |GenerateCertificate|. The static
+// function |GenerateCertificateBlockingly| does the same thing but blockingly

[hta-webrtc, 2016/04/14 11:54:05]

The suffix "Blockingly" grates on my English-language nerves.
Can we use "AndWait" instead - GenerateCertificateAndWait?

[hbos, 2016/04/14 15:31:54]

Renamed this to GenerateCertificate and the non-blocking variety to
GenerateCertificateAsync.

+// and can be called on any thread.
+class RTCCertificateGenerator {
+ public:
+  // Generates a certificate on the current thread. Returns null on failure.
+  static scoped_refptr<RTCCertificate> GenerateCertificateBlockingly(
+      const KeyParams& key_params,
+      const Optional<uint64_t>& expires_ms);
+
+  RTCCertificateGenerator(Thread* signaling_thread, Thread* worker_thread);
+
+  // Must be called on the signaling thread. Is non-blocking; does certificate

[hta-webrtc, 2016/04/14 11:54:05]

English: Start description with a description, and don't start a sentence with
"Is".

// Generates a certificate on the worker thread.
// Must be called on the signaling thread. It is non-blocking; it does....

[hbos, 2016/04/14 15:31:54]

Done.

+  // generation on the worker thread and invokes |callback| with the result on
+  // the signaling thread. If |expires_ms| is specified, the certificate will
+  // expire in approximately that many milliseconds from now.
+  void GenerateCertificate(
+      const KeyParams& key_params,
+      const Optional<uint64_t>& expires_ms,
+      const scoped_refptr<RTCCertificateGeneratorCallback>& callback);
+
+ private:
+  Thread* const signaling_thread_;
+  Thread* const worker_thread_;
+};
+
+}  // namespace rtc
+
+#endif  // WEBRTC_BASE_RTCCERTIFICATEGENERATOR_H_