// 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;

  }

}