<?php
/**
 * Pimf_Util
 *
 * PHP Version 5
 *
 * A comprehensive collection of PHP utility classes and functions
 * that developers find themselves using regularly when writing web applications.
 *
 * LICENSE
 *
 * This source file is subject to the new BSD license that is bundled
 * with this package in the file LICENSE.
 * It is also available through the world-wide-web at this URL:
 * http://krsteski.de/new-bsd-license/
 * If you did not receive a copy of the license and are unable to
 * obtain it through the world-wide-web, please send an email
 * to hide@address.com so we can send you a copy immediately.
 *
 * @copyright Copyright (c) 2010-2011 Gjero Krsteski (http://krsteski.de)
 * @license http://krsteski.de/new-bsd-license New BSD License
 */

/**
 * @package Pimf_Util
 * @author Gjero Krsteski <hide@address.com>
 */
class Pimf_Util_Json
{
  /**
   * Returns the JSON representation of a value.
   * @param mixed $data
   * @return string
   */
  public static function encode($data)
  {
    $json = json_encode($data);

    self::handleError(json_last_error());

    return $json;
  }

  /**
   * Decodes a JSON string.
   * @param string $jsonString
   * @return mixed
   */
  public static function decode($jsonString)
  {
    $json = json_decode($jsonString);

    self::handleError(json_last_error());

    return $json;
  }

  /**
   * @param int $status
   * @throws RuntimeException
   */
  protected static function handleError($status)
  {
    $msg = '';

    switch ($status) {
      case JSON_ERROR_DEPTH:
        $msg = 'Maximum stack depth exceeded';
        break;
      case JSON_ERROR_STATE_MISMATCH:
        $msg = 'Underflow or the modes mismatch';
        break;
      case JSON_ERROR_CTRL_CHAR:
        $msg = 'Unexpected control character found';
        break;
      case JSON_ERROR_SYNTAX:
        $msg = 'Syntax error, malformed JSON';
        break;
      case 5: //alias for JSON_ERROR_UTF8 due to Availability PHP 5.3.3
        $msg = 'Malformed UTF-8 characters, possibly incorrectly encoded';
        break;
    }

    if ($msg !== '') {
      throw new RuntimeException($msg);
    }
  }
}