org.chromium.sdk/src/org/chromium/sdk/internal/protocolparser/dynamicimpl/SlowParser.java
changeset 2 e4420d2515f1
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/org.chromium.sdk/src/org/chromium/sdk/internal/protocolparser/dynamicimpl/SlowParser.java	Wed Dec 23 17:13:18 2009 -0800
@@ -0,0 +1,30 @@
+// Copyright (c) 2009 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.
+
+package org.chromium.sdk.internal.protocolparser.dynamicimpl;
+
+import org.chromium.sdk.internal.protocolparser.JsonProtocolParseException;
+
+/**
+ * A parser that accepts value of JSON field and outputs value in another form (e.g. string
+ * is converted to enum constant) to serve field getters in JsonType interfaces.
+ * <p>
+ * First the input value should be processed by {@link #parseValue(Object, ObjectData)} method
+ * that returns intermediate value (that may be stored in {@link ObjectData#getFieldArray()} array).
+ * Then the output value may be obtained via value post-processor, available
+ * from {@link #getValueFinisher()} (which is null in most cases, but not always).
+ * <p>The parser's name "slow" reads "may be slow". It means that parser may do heavy operations.
+ * Alternatively parser may be (optionally) castable to {@link QuickParser}
+ * via {@link #asQuickParser()} method.
+ */
+abstract class SlowParser<T> {
+  abstract T parseValue(Object value, ObjectData thisData) throws JsonProtocolParseException;
+
+  abstract FieldLoadedFinisher getValueFinisher();
+  abstract JsonTypeParser<?> asJsonTypeParser();
+
+  QuickParser<T> asQuickParser() {
+    return null;
+  }
+}