net: ssl_non_sensitive_host_info.h => ssl_host_info.h

This is a prelim commit for renaming SSLNonSensitiveHostInfo to
SSLHostInfo.

No code change.

BUG=none
TEST=none

git-svn-id: svn://svn.chromium.org/chrome/trunk/src@62174 0039d316-1c4b-4281-b951-d872f2087c98

1 files changed, 56 insertions, 0 deletions

diff --git a/net/base/ssl_host_info.h b/net/base/ssl_host_info.h
new file mode 100644
index 0000000..88d5cef
--- /dev/null
+++ b/net/base/ssl_host_info.h
@@ -0,0 +1,56 @@
+// Copyright (c) 2010 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_BASE_SSL_NON_SENSITIVE_HOST_INFO_H
+#define NET_BASE_SSL_NON_SENSITIVE_HOST_INFO_H
+
+#include <string>
+#include "base/ref_counted.h"
+#include "net/base/completion_callback.h"
+
+namespace net {
+
+// SSLNonSensitiveHostInfo is an interface for fetching information about an
+// SSL server. This information may be stored on disk so does not include keys
+// or session information etc. Primarily it's intended for caching the server's
+// certificates.
+class SSLNonSensitiveHostInfo :
+    public base::RefCountedThreadSafe<SSLNonSensitiveHostInfo> {
+ public:
+  // Start will commence the lookup. This must be called before any other
+  // methods. By opportunistically calling this early, it may be possible to
+  // overlap this object's lookup and reduce latency.
+  virtual void Start() = 0;
+
+  // WaitForDataReady returns OK if the fetch of the requested data has
+  // completed. Otherwise it returns ERR_IO_PENDING and will call |callback| on
+  // the current thread when ready.
+  //
+  // Only a single callback can be outstanding at a given time and, in the
+  // event that WaitForDataReady returns OK, it's the caller's responsibility
+  // to delete |callback|.
+  //
+  // |callback| may be NULL, in which case ERR_IO_PENDING may still be returned
+  // but, obviously, a callback will never be made.
+  virtual int WaitForDataReady(CompletionCallback* callback) = 0;
+
+  // data returns any host information once WaitForDataReady has indicated that
+  // the fetch has completed. In the event of an error, |data| returns an empty
+  // string.
+  virtual const std::string& data() const = 0;
+
+  // Set allows for the host information to be updated for future users. This
+  // is a fire and forget operation: the caller may drop its reference from
+  // this object and the store operation will still complete. This can only be
+  // called once WaitForDataReady has returned OK or called its callback.
+  virtual void Set(const std::string& new_data) = 0;
+
+ protected:
+  friend class base::RefCountedThreadSafe<SSLNonSensitiveHostInfo>;
+  virtual ~SSLNonSensitiveHostInfo() { }
+};
+
+}  // namespace net
+
+#endif  // NET_BASE_SSL_NON_SENSITIVE_HOST_INFO_H