add some new func and class

Author: inhere

src/Helper/JsonHelper.php

@@ -36,17 +36,16 @@
  */
 class JsonHelper
 {
+    // ----------- encode -----------
+
     /**
-     * @param mixed $data
-     * @param int   $flags
+     * @param $data
      *
-     * @return false|string
+     * @return string
      */
-    public static function prettyJSON(
-        $data,
-        int $flags = JSON_PRETTY_PRINT | JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES
-    ) {
-        return json_encode($data, $flags);
+    public static function enc($data): string
+    {
+        return json_encode($data);
     }
 
     /**
@@ -80,6 +79,79 @@ public static function encodeCN(
         return json_encode($data, $options, $depth);
     }
 
+    /**
+     * @param $data
+     *
+     * @return string
+     */
+    public static function pretty($data): string
+    {
+        return json_encode($data, JSON_PRETTY_PRINT | JSON_UNESCAPED_SLASHES | JSON_UNESCAPED_UNICODE);
+    }
+
+    /**
+     * @param mixed $data
+     * @param int   $flags
+     *
+     * @return false|string
+     */
+    public static function prettyJSON(
+        $data,
+        int $flags = JSON_PRETTY_PRINT | JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES
+    ) {
+        return json_encode($data, $flags);
+    }
+
+    /**
+     * @param $data
+     *
+     * @return string
+     */
+    public static function unescaped($data): string
+    {
+        return json_encode($data, JSON_UNESCAPED_SLASHES | JSON_UNESCAPED_UNICODE);
+    }
+
+    /**
+     * @param $data
+     *
+     * @return string
+     */
+    public static function unescapedSlashes($data): string
+    {
+        return json_encode($data, JSON_UNESCAPED_SLASHES);
+    }
+
+    /**
+     * @param $data
+     *
+     * @return string
+     */
+    public static function unescapedUnicode($data): string
+    {
+        return json_encode($data, JSON_UNESCAPED_UNICODE);
+    }
+
+    // ----------- decode -----------
+
+    /**
+     * @param string $json
+     *
+     * @param bool   $assoc
+     *
+     * @return array|mixed
+     */
+    public static function dec(string $json, bool $assoc = true)
+    {
+        $data = json_decode($json, $assoc);
+
+        if (JSON_ERROR_NONE !== json_last_error()) {
+            throw new InvalidArgumentException('json_decode error: ' . json_last_error_msg());
+        }
+
+        return $data;
+    }
+
     /**
      * Decode json
      *

src/Helper/PhpHelper.php

@@ -124,7 +124,7 @@ public static function callByArray(callable $cb, array $args)
     }
 
     /**
-     * Set property values ​​for object
+     * Set property values for object
      * - 会先尝试用 setter 方法设置属性
      * - 再尝试直接设置属性
      *

src/Obj/AbstractMap.php

@@ -0,0 +1,133 @@
+<?php declare(strict_types=1);
+/**
+ * This file is part of toolkit/stdlib.
+ *
+ * @author   https://github.com/inhere
+ * @link     https://github.com/php-toolkit/stdlib
+ * @license  MIT
+ */
+
+namespace Toolkit\Stdlib\Obj;
+
+use JsonSerializable;
+use Toolkit\Stdlib\Helper\JsonHelper;
+
+/**
+ * Class AbstractMap
+ *
+ * @package Toolkit\Stdlib\Obj
+ */
+abstract class AbstractMap implements JsonSerializable
+{
+    /**
+     * @param array $data
+     *
+     * @return static
+     */
+    public static function new(array $data = [])
+    {
+        return new static($data);
+    }
+
+    /**
+     * Configurable constructor.
+     *
+     * @param array $config
+     */
+    public function __construct(array $config = [])
+    {
+        if ($config) {
+            ObjectHelper::init($this, $config);
+        }
+    }
+
+    /**
+     * Batch set values
+     *
+     * @param array $data
+     */
+    public function load(array $data): void
+    {
+        ObjectHelper::init($this, $data);
+    }
+
+    /**
+     * @param string $key
+     * @param mixed  $value
+     */
+    public function setValue(string $key, $value): void
+    {
+        ObjectHelper::init($this, [$key => $value]);
+    }
+
+    /**
+     * @param array $fields Restrict to return only these fields, return all of them if empty
+     *
+     * @return array
+     */
+    public function getValues(array $fields = []): array
+    {
+        $data = [];
+        foreach ($this as $key => $value) {
+            if ($fields && !in_array($key, $fields, true)) {
+                continue;
+            }
+
+            $data[$key] = $value;
+        }
+
+        return $data;
+    }
+
+    /**
+     * Convert to array
+     *
+     * @param bool  $filterEmpty
+     * @param array $append
+     *
+     * @return array
+     */
+    public function toArray(bool $filterEmpty = false, array $append = []): array
+    {
+        $data = $this->getValues();
+
+        if ($filterEmpty) {
+            $data = array_filter($data);
+        }
+
+        // 仅在data不为空时追加数据
+        if ($append && $data) {
+            $data = array_merge($data, $append);
+        }
+
+        return $data;
+    }
+
+    /**
+     * @return string
+     */
+    public function toString(): string
+    {
+        return $this->toJson();
+    }
+
+    /**
+     * Convert to JSON string
+     *
+     * @param bool $filterEmpty
+     *
+     * @return string
+     */
+    public function toJson(bool $filterEmpty = false): string
+    {
+        return JsonHelper::enc($this->toArray($filterEmpty));
+    }
+
+    /**
+     * @return mixed
+     */
+    public function jsonSerialize()
+    {
+        return $this->toArray();
+    }
+}