إنشاء كائنات للبيانات المُستقْبَله

السلام عليكم، فكّرت في تنظيم عملي وإنشاء ما يُشبه إطار عملٍ مبسّط.

الهدف منه التّعامل مع api معيّن.

ففكّرت في إنشاء Class لكل نوعٍ من البيانات الممكن استقباله من استجابات الـ api

فمثلًا: الـapi إذا أرسل معلومات عن (رسالة):

فستحمل بيانات الرّسالة، المُرسل، الوسائط المتعلّقة بالرّسالة.

مما يتطلب أثناء البرمجة عمل التّالي مثلًا للوصول لبعض محتويات المصفوفة:

$data['message']['user']['photo']['id']

وما يتبعه من عمليات تحقق مثلًا وغيرِه، وبعض العناصر أسماءها طويلة وغريبة بعض الشيء، مما يسبب تكرارًا وصعوبة في الوصول، وحتّى لو عرفناها كمتغير يطول اسمها بسبب وجود عدّة مصفوفات متداخلة.

ومثلًا فإنّ الـapi يقوم بتقسيم الاسم إلى first وlast فبالتالي تحتاج دائمًا لتعريف متغيرٍ يقوم بإنشاء الاسم كاملاً (الدمج بينها).

#ففكرت:

في تعريف Types على شكل Classes تحمِل جميع المتغيرات القادِمة، وكل نوع في Class منفصل.

بحيث يستهل استدعاءها عند البرمجة (بالإكمال التلقائيّ) ويسهّل عملية التحقق من البيانات المطلوبة والمفقودة في نوعٍ معيّن.

ويسهّل إجراء بعض العمليات الأساسية كـ دالّة تُرجِع الاسم الكامل.

فتصبح العملية:

$message = new Message($data);
$message->user()->photo()->id;

$message->user()->full_name;
// بدلًا من
$data['message']['user']['photo']['id'];

$full_name = $data['message']['user']['first_name'] . ' ' . $data['message']['user']['first_name'];

#السؤال:

هل هذه العمليّة مناسِبة؟ أم غيرُ مناسبَة؟

- مع ملاحظة التّالي:

* الـ class سوف يُسنِد القيم للمتغيرات مباشرة إن لم تكن تحمل نوع آخر بداخلها (مصفوفة) <تصل إلى 30 متغيرًا>

وصححّوا لي، إذا كان (إسناد القيَم لكل المتغيّرات المعرّفة عند انشاء الكائن __construct) عملية صحيحة، أو غير صحيحة؟

* المصفوفات تحمِل نوع جديد (مثل: الوسائط تحمّل مصفوفة من البيانات المختلفة:id, size...)، فستكون عبارة عن دالّة تُرجع نسخة من class بالنوّع الجديد (photo) مثلًا. < أمّا السبب هُنا في جعلها دالّة وليست متغيرًا، فهو لمنعِ تحمِيل الكثير من الكائنات المخزّنة التي قد لا تستعمَل.>

وهلِ الفكرة صحيّة؟ أم أنّها إثقال للتطبيق، والتنفيذ..؟

# مثال:

JSON data

{
  "message": {
    "message_id": 10104,
    "from": {
      "id": 12431250,
      "first_name": "Sako",
      "username": "SX12345",
      "language_code": "en"
    },
    "text": "Test Text"
  }
}

Master Class

<?php
namespace Types;

class Types
{
  protected $data;
  protected $requiredFields = [];
  public $hasError = NULL;

  /**
   * set Error if method is not existed in message array
   * @param $method
   * @param $arguments
   * @return null|mixed
   */
  public function __call($method, $arguments)
  {
    if (!$this->has($method)){
      $this->hasError = "field as method $method doesn't exist in " . __CLASS__ . " data";
      error_log($this->hasError);
      return NULL;
    }
    return $method($arguments);
  }

  public function __construct(array $data)
  {
    $this->data = $data;
  }

  protected function validate()
  {
    if (!empty($this->requiredFields)){
      foreach ($this->requiredFields as $requiredField) {
        if (!array_key_exists($requiredField, $this->data)) {
          error_log("field $requiredField doesn't exist, In ".__CLASS__);
          return false;
        }
      }
      return true;
    } else {
      return false;
    }
  }

  public function has(string $field)
  {
    return in_array($field, $this->data);
  }

}

Message Class

<?php
namespace Types;

class Message extends Types
{
  public $id;
  public $text;

  public function __construct(array $data)
  {
    parent::__construct($data);
    $this->id = $data['message_id'];
    $this->text = $data['text'];

    $this->data = $data;

  }

  public function from()
  {
    return new User($this->data[__FUNCTION__]);
  }

}

User Class

<?php
# from always refers to User who send.

class User extends Types {
  public
    $id,
    $first_name,
    $last_name,
    $full_name,
    $username,
    $language_code;

  protected $requiredFields = [
    'id',
    'first_name'
  ];

  public function __construct(array $data)
  {
    parent::__construct($data);
    foreach (get_class_vars(__CLASS__) as $var => $val) {
      $this->$var = $val;
    }
    $this->setFullName();
  }

  private function setFullName(): void
  {
    $this->full_name = $this->first_name . ' '. $this->last_name;
  }

}