[webcrypto] Add the KeyAlgorithm interface.

public/platform/WebCryptoKeyAlgorithm.h

 /*
- * Copyright (C) 2012 Google Inc. All rights reserved.
+ * Copyright (C) 2014 Google Inc. All rights reserved.
  *
  * Redistribution and use in source and binary forms, with or without
  * modification, are permitted provided that the following conditions are
  * met:
  *
  *     * Redistributions of source code must retain the above copyright
  * notice, this list of conditions and the following disclaimer.
  *     * Redistributions in binary form must reproduce the above
  * copyright notice, this list of conditions and the following disclaimer
  * in the documentation and/or other materials provided with the
  * distribution.
  *     * Neither the name of Google Inc. nor the names of its
  * contributors may be used to endorse or promote products derived from
  * this software without specific prior written permission.
  *
  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
  * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
  * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
  * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
  * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
  * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
  * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
  * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
  * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
  * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  */
 
-#ifndef WebPrerender_h
-#define WebPrerender_h
+#ifndef WebCryptoKeyAlgorithm_h
+#define WebCryptoKeyAlgorithm_h
 
 #include "WebCommon.h"
+#include "WebCryptoAlgorithm.h"
+#include "WebCryptoKeyAlgorithmParams.h"
 #include "WebPrivatePtr.h"
-#include "WebReferrerPolicy.h"
-#include "WebString.h"
-#include "WebURL.h"
 
 #if INSIDE_BLINK
-#include "wtf/PassRefPtr.h"
+#include "wtf/PassOwnPtr.h"
 #endif
 
-namespace WebCore {
-class Prerender;
-}
-
 namespace blink {
 
-// WebPrerenderRelType is a bitfield since multiple rel attributes can be set on the same prerender.
-enum WebPrerenderRelType {
-    PrerenderRelTypePrerender = 0x1,
-    PrerenderRelTypeNext = 0x2,
-};
+class WebCryptoKeyAlgorithmPrivate;
 
-class WebPrerender {
+// WebCryptoKeyAlgorithm represents the algorithm used to generate a key.
+//   * Immutable
+//   * Threadsafe
+//   * Copiable (cheaply)
+class WebCryptoKeyAlgorithm {
 public:
-    class ExtraData {
-    public:
-        virtual ~ExtraData() { }
-    };
+    WebCryptoKeyAlgorithm() { }
 
-    ~WebPrerender() { reset(); }
-    WebPrerender() { }
-    WebPrerender(const WebPrerender& other) { assign(other); }
-    WebPrerender& operator=(const WebPrerender& other)
+#if INSIDE_BLINK
+    BLINK_PLATFORM_EXPORT WebCryptoKeyAlgorithm(WebCryptoAlgorithmId, PassOwnPtr<WebCryptoKeyAlgorithmParams>);
+#endif
+
+    BLINK_PLATFORM_EXPORT static WebCryptoKeyAlgorithm adoptParamsAndCreate(WebCryptoAlgorithmId, WebCryptoKeyAlgorithmParams*);
+
+    ~WebCryptoKeyAlgorithm() { reset(); }
+
+    WebCryptoKeyAlgorithm(const WebCryptoKeyAlgorithm& other) { assign(other); }
+    WebCryptoKeyAlgorithm& operator=(const WebCryptoKeyAlgorithm& other)
     {
         assign(other);
         return *this;
     }
 
-#if INSIDE_BLINK
-    BLINK_PLATFORM_EXPORT explicit WebPrerender(PassRefPtr<WebCore::Prerender>);
-
-    BLINK_PLATFORM_EXPORT const WebCore::Prerender* toPrerender() const;
-#endif
-
-    BLINK_PLATFORM_EXPORT void reset();
-    BLINK_PLATFORM_EXPORT void assign(const WebPrerender&);
     BLINK_PLATFORM_EXPORT bool isNull() const;
 
-    BLINK_PLATFORM_EXPORT WebURL url() const;
-    BLINK_PLATFORM_EXPORT WebString referrer() const;
-    BLINK_PLATFORM_EXPORT unsigned relTypes() const;
-    BLINK_PLATFORM_EXPORT WebReferrerPolicy referrerPolicy() const;
+    BLINK_PLATFORM_EXPORT WebCryptoAlgorithmId id() const;
 
-    BLINK_PLATFORM_EXPORT void setExtraData(ExtraData*);
-    BLINK_PLATFORM_EXPORT const ExtraData* extraData() const;
+    BLINK_PLATFORM_EXPORT WebCryptoKeyAlgorithmParamsType paramsType() const;
 
-    BLINK_PLATFORM_EXPORT void didStartPrerender();
-    BLINK_PLATFORM_EXPORT void didStopPrerender();
-    BLINK_PLATFORM_EXPORT void didSendLoadForPrerender();
-    BLINK_PLATFORM_EXPORT void didSendDOMContentLoadedForPrerender();
+    // Returns the type-specific parameters for this key. If the requested
+    // parameters are not applicable (for instance an HMAC key does not have
+    // any AES parameters) then returns 0.
+    BLINK_PLATFORM_EXPORT WebCryptoAesKeyAlgorithmParams* aesParams() const;
+    BLINK_PLATFORM_EXPORT WebCryptoHmacKeyAlgorithmParams* hmacParams() const;
+    BLINK_PLATFORM_EXPORT WebCryptoRsaKeyAlgorithmParams* rsaParams() const;
+    BLINK_PLATFORM_EXPORT WebCryptoRsaHashedKeyAlgorithmParams* rsaHashedParams() const;
 
 private:
-    WebPrivatePtr<WebCore::Prerender> m_private;
+    BLINK_PLATFORM_EXPORT void assign(const WebCryptoKeyAlgorithm& other);
+    BLINK_PLATFORM_EXPORT void reset();
+
+    WebPrivatePtr<WebCryptoKeyAlgorithmPrivate> m_private;
 };
 
 } // namespace blink
 
-#endif // WebPrerender_h
+#endif