Formatter.php

<?php
/**
 * wCMF - wemove Content Management Framework
 * Copyright (C) 2005-2015 wemove digital solutions GmbH
 *
 * Licensed under the terms of the MIT License.
 *
 * See the LICENSE file distributed with this work for
 * additional information.
 */
namespace wcmf\lib\presentation\format;

use wcmf\lib\presentation\Request;
use wcmf\lib\presentation\Response;

/**
 * Formatter is the single entry point for request/response formatting.
 * It chooses the configured formatter based on the format property of the request
 * by getting the value XXXFormat from the configuration section 'formats'.
 *
 * @author ingo herwig <ingo@wemove.com>
 */
interface Formatter {

  /**
   * Get the format name for the given mime type.
   * @param $mimeType The mime type
   * @return String
   */
  public function getFormatFromMimeType($mimeType);

  /**
   * Deserialize Request data into objects.
   * @param $request A reference to the Request instance
   */
  public function deserialize(Request $request);

  /**
   * Serialize Response according to the output format.
   * @param $response A reference to the Response instance
   */
  public function serialize(Response $response);
}
?>