JsonUtility.php in Feeds extensible parsers 8

Namespace

Drupal\feeds_ex\Utility

File

src/Utility/JsonUtility.php

<?php

namespace Drupal\feeds_ex\Utility;

use Drupal\Component\Serialization\Json;
use Drupal\Core\StringTranslation\StringTranslationTrait;

/**
 * Various helpers for handling JSON.
 */
class JsonUtility {
  use StringTranslationTrait;

  /**
   * Translates an error message.
   *
   * @param int $error
   *   The JSON error.
   *
   * @return string
   *   The JSON parsing error message.
   */
  public function translateError($error) {
    switch ($error) {
      case JSON_ERROR_RECURSION:
        return 'One or more recursive references in the value to be encoded';
      case JSON_ERROR_INF_OR_NAN:
        return 'One or more NAN or INF values in the value to be encoded';
      case JSON_ERROR_UNSUPPORTED_TYPE:
        return 'A value of a type that cannot be encoded was given';
      case JSON_ERROR_UTF8:
        return 'Malformed UTF-8 characters, possibly incorrectly encoded';
      case JSON_ERROR_NONE:
        return 'No error has occurred';
      case JSON_ERROR_DEPTH:
        return 'The maximum stack depth has been exceeded';
      case JSON_ERROR_STATE_MISMATCH:
        return 'Invalid or malformed JSON';
      case JSON_ERROR_CTRL_CHAR:
        return 'Control character error, possibly incorrectly encoded';
      case JSON_ERROR_SYNTAX:
        return 'Syntax error';
      default:
        return 'Unknown error';
    }
  }

  /**
   * Decodes a JSON string into an array.
   *
   * @param string $json
   *   A JSON string.
   *
   * @return array
   *   A PHP array.
   *
   * @throws \RuntimeException
   *   Thrown if the encoded JSON does not result in an array.
   */
  public function decodeJsonArray($json) {
    $parsed = Json::decode($json);
    if (!is_array($parsed)) {
      throw new \RuntimeException($this
        ->t('The JSON is invalid.'));
    }
    return $parsed;
  }

  /**
   * Decodes a JSON string into an object or array.
   *
   * @param string $json
   *   A JSON string.
   *
   * @return object|array
   *   A PHP object or array.
   *
   * @throws \RuntimeException
   *   Thrown if the encoded JSON does not result in an array or object.
   */
  public function decodeJsonObject($json) {
    $parsed = json_decode($json, FALSE);
    if (!is_array($parsed) && !is_object($parsed)) {
      throw new \RuntimeException($this
        ->t('The JSON is invalid.'));
    }
    return $parsed;
  }

}

Classes

Name	Description
JsonUtility	Various helpers for handling JSON.