/**
 * Licensed to the Apache Software Foundation (ASF) under one
 * or more contributor license agreements.  See the NOTICE file
 * distributed with this work for additional information
 * regarding copyright ownership.  The ASF licenses this file
 * to you under the Apache License, Version 2.0 (the
 * "License"); you may not use this file except in compliance
 * with the License.  You may obtain a copy of the License at
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

/**
 * Common mapper-object
 * Extending this object you should implement <code>load</code> and <code>parse</code> methods
 * @type {Ember.Object}
 */
App.Mapper = Ember.Object.extend({

  /**
   * Map for parsing JSON received from server
   * Format:
   *  <code>
   *    {
   *      key1: 'path1',
   *      key2: 'path2',
   *      key3: 'path3'
   *    }
   *  </code>
   *  Keys - names for properties in object
   *  Values - pathes in JSON
   * @type {object}
   */
  map: {},

  /**
   * Load data from <code>App.urlPrefix + this.urlSuffix</code>
   * @method load
   */
  load: Ember.required(Function),

  /**
   * Parse loaded data according to <code>map</code>
   * Set <code>App</code> properties
   * @param {object} data received data
   * @method parse
   */
  parse: Ember.required(Function)

});