Rename Experimental Framework classes and concepts

third_party/WebKit/public/platform/WebTrialTokenValidator.h

+// Copyright 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 WebTrialTokenValidator_h
+#define WebTrialTokenValidator_h
+
+#include "public/platform/WebCallbacks.h"
+#include "public/platform/WebString.h"
+
+namespace blink {
+
+// This interface abstracts the task of validating a token for an experimental
+// feature. Experimental features can be turned on and off at runtime for a
+// specific renderer, depending on the presence of a valid token in the
+// document's head. The details of determining whether a token is valid for a

[chasej, 2016/01/26 16:56:53]

I'd suggest a more generic comment about where tokens come from.  It's unlikely
anyone would remember to update this comment if/when support is added for HTTP
headers, etc.

[iclelland, 2016/01/26 19:05:49]

Done.

+// particular feature is left up to the embedder. An implementation can

[chasej, 2016/01/26 16:56:53]

Given that the token validation happens in the renderer now, is this comment
accurate about the embedder making the determination?

[iclelland, 2016/01/26 19:05:49]

... it's unfortunate, perhaps, but true for the time being. The validation
happens in the content layer, outside of blink code, which was the reason I left
this in. On the other hand, it was mentioned previously that Blink isn't the
embeddable interface, content is. I'll remove the comment so it's not confusing
to anyone looking here.

+// effectively disable all origin trials by simply returning false in all cases.
+//
+// More documentation on the design of the experimental framework is at
+// https://docs.google.com/document/d/1qVP2CK1lbfmtIJRIm6nwuEFFhGhYbtThLQPo3CSTtmg
+
+class WebTrialTokenValidator {
+public:
+    virtual ~WebTrialTokenValidator() {}
+
+    // Returns true if the given token is valid for the specified origin and
+    // feature name.
+    virtual bool validateToken(const WebString& token, const WebString& origin, const WebString& featureName) = 0;
+};
+
+} // namespace blink
+
+#endif // WebTrialTokenValidator_h