goog.provide('ol.parser.AsyncObjectFeatureParser');
goog.provide('ol.parser.AsyncStringFeatureParser');
goog.provide('ol.parser.DomFeatureParser');
goog.provide('ol.parser.ObjectFeatureParser');
goog.provide('ol.parser.ReadFeaturesOptions');
goog.provide('ol.parser.StringFeatureParser');

goog.require('ol.Feature');



/**
 * @interface
 */
ol.parser.FeatureParser = function() {};


/**
 * @return {ol.Projection} Data projection.
 */
ol.parser.FeatureParser.prototype.getProjection = goog.abstractMethod;



/**
 * @interface
 * @extends {ol.parser.FeatureParser}
 */
ol.parser.DomFeatureParser = function() {};


/**
 * @param {Element|Document} node Document or element node.
 * @param {ol.parser.ReadFeaturesOptions=} opt_options Feature reading options.
 * @return {Array.<ol.Feature>} Array of features.
 */
ol.parser.DomFeatureParser.prototype.readFeaturesFromNode =
    goog.abstractMethod;



/**
 * @interface
 */
ol.parser.ObjectFeatureParser = function() {};


/**
 * @param {Object} obj Object representing features.
 * @param {ol.parser.ReadFeaturesOptions=} opt_options Feature reading options.
 * @return {Array.<ol.Feature>} Array of features.
 */
ol.parser.ObjectFeatureParser.prototype.readFeaturesFromObject =
    goog.abstractMethod;



/**
 * @interface
 */
ol.parser.StringFeatureParser = function() {};


/**
 * @param {string} data String data.
 * @param {ol.parser.ReadFeaturesOptions=} opt_options Feature reading options.
 * @return {Array.<ol.Feature>} Array of features.
 */
ol.parser.StringFeatureParser.prototype.readFeaturesFromString =
    goog.abstractMethod;



/**
 * @interface
 */
ol.parser.AsyncStringFeatureParser = function() {};


/**
 * @param {string} data String data.
 * @param {function(Array.<ol.Feature>)} callback Callback which is called
 * after parsing.
 * @param {ol.parser.ReadFeaturesOptions=} opt_options Feature reading options.
 */
ol.parser.AsyncStringFeatureParser.prototype.readFeaturesFromStringAsync =
    goog.abstractMethod;



/**
 * @interface
 */
ol.parser.AsyncObjectFeatureParser = function() {};


/**
 * @param {Object} obj Object representing features.
 * @param {function(Array.<ol.Feature>)} callback Callback which is called
 * after parsing.
 * @param {ol.parser.ReadFeaturesOptions=} opt_options Feature reading options.
 */
ol.parser.AsyncObjectFeatureParser.prototype.readFeaturesFromObjectAsync =
    goog.abstractMethod;


/**
 * @typedef {function(ol.Feature, ol.geom.GeometryType):ol.geom.SharedVertices}
 */
ol.parser.ReadFeaturesCallback;


/**
 * @typedef {{callback: ol.parser.ReadFeaturesCallback}}
 */
ol.parser.ReadFeaturesOptions;