เมื่อใดที่ฉันควรสร้างบริการหรือฟังก์ชั่นยูทิลิตี้

ฉันมีคำถามนี้อยู่ในใจตลอดสัปดาห์ที่แล้ว: เมื่อใดที่ฉันควรสร้างบริการหรือฟังก์ชั่นยูทิลิตี้

ใน Drupal Core เรามีทั้งบริการและฟังก์ชั่นยูทิลิตี้ แต่ฉันไม่สามารถหาข้อแตกต่างระหว่างพวกเขา (เมื่อฉันต้องการที่จะสร้างบริการหรือเมื่อฉันต้องการที่จะสร้างฟังก์ชั่นยูทิลิตี้)

ฉันจะใช้เป็นตัวอย่างโมดูลน้ำหนักที่ฉันมีชั้นInternalFunctions

<?php

namespace Drupal\modules_weight\Utility;

class InternalFunctions {

  public static function prepareDelta($weight) {
    $delta = 100;

    $weight = (int) $weight;

    if ($weight > $delta) {
      return $weight;
    }

    if ($weight < -100) {
      return $weight * -1;
    }

    return $delta;
  }


  public static function modulesList($force = FALSE) {
    $modules = [];
    $installed_modules = system_get_info('module');

    $config_factory = \Drupal::service('config.factory');

    if ($force) {
      $show_system_modules = TRUE;
    }
    else {
modules.
      $show_system_modules = $config_factory->get('modules_weight.settings')->get('show_system_modules');
    }

    $modules_weight = $config_factory->get('core.extension')->get('module');

    foreach ($installed_modules as $filename => $module_info) {
      if (!isset($module_info['hidden']) && ($show_system_modules || $module_info['package'] != 'Core')) {
        $modules[$filename]['name'] = $module_info['name'];
        $modules[$filename]['description'] = $module_info['description'];
        $modules[$filename]['weight'] = $modules_weight[$filename];
        $modules[$filename]['package'] = $module_info['package'];
      }
    }
    uasort($modules, ['Drupal\Component\Utility\SortArray', 'sortByWeightElement']);

    return $modules;
  }

}

ในชั้นนี้ฉันมีสองฟังก์ชั่นคงที่ แต่พวกเขาทั้งสองฟังก์ชั่นยูทิลิตี้หรือprepareDelta()เป็นฟังก์ชั่นยูทิลิตี้และmodulesList()ควรจะอยู่ในชั้นเรียนอื่นและมีบริการหรือไม่

ข้อแตกต่างเดียวที่ฉันพบในเวลานี้คือภายใน Drupal \ Component \ Utility ในเนมสเปซ (ที่คุณจะเห็นยูทิลิตี้จำนวนมาก fucntions) พวกเขาไม่ได้ใช้บริการใดบริการหนึ่งและมักจะใช้บริการอื่นในบริการ มีการตรวจสอบบริการทั้งหมดเพื่อตรวจสอบนี้)

ดังนั้นเมื่อฉันควรสร้างบริการหรือฟังก์ชั่นยูทิลิตี้?

ในการใช้บริการทั่วไป ดูโพสต์บล็อกต่อไปนี้เมื่อตกลงเพื่อใช้ฟังก์ชันยูทิลิตี้คงที่:

ดังนั้นอย่าใช้สถิต?

ไม่มีกรณีการใช้งานที่ถูกต้อง หนึ่งคือถ้าคุณมีรายการของรายการที่กำหนดไว้ล่วงหน้าคงที่สามารถช่วยลดหน่วยความจำเพราะมันจะอยู่ในระดับชั้นเรียนและไม่ได้อยู่ในกรณีใด ๆ

กรณีอื่น ๆ เป็นวิธีการอรรถประโยชน์ที่ไม่ต้องการการพึ่งพาจากภายนอกเช่นวิธีการ slugify

<?php
class Util
{
    public static function slug($string)
    {
        return strtolower(trim(preg_replace('/[^A-Za-z0-9-]+/', '_', $string)));
    }
}

วิธีการกระสุนจะทำพฤติกรรมที่กำหนดไว้เป็นอย่างดีเท่านั้น การคำนึงถึงพฤติกรรมเป็นเรื่องง่ายในการทดสอบหน่วยและฉันจะไม่กังวลมากเกินไปเมื่อฉันเห็นสายนี้

วิธีการเหล่านี้ยังสามารถทดสอบหน่วยได้เนื่องจากพวกเขาไม่ต้องการเริ่มต้น

ที่มา: https://stovepipe.systems/post/avoiding-static-in-your-code

(ปริมาณของรหัสคงที่ใน Drupal ตอนนี้เป็นเพราะการเปลี่ยนจากรหัส D7 ขั้นตอนดังนั้นอย่าใช้ Drupal ในสถานะปัจจุบันเป็นตัวอย่าง)

เกี่ยวกับตัวอย่างจากคำถามส่วนที่เหลือของคลาสยูทิลิตี้ (ไม่แสดงในคำถาม)

<?php

namespace Drupal\modules_weight\Utility;

/**
 * Provides module internal helper methods.
 *
 * @ingroup utility
 */
class InternalFunctions {

...

  /**
   * Return the modules list ordered by the modules weight.
   *
   * @param bool $force
   *   Force to show the core modules.
   *
   * @return array
   *   The modules list.
   */
  public static function modulesList($force = FALSE) {
    // If we don't force we need to check the configuration variable.
    if (!$force) {
      // Getting the config to know if we should show or not the core modules.
      $force = \Drupal::service('config.factory')->get('modules_weight.settings')->get('show_system_modules');
    }
    // Getting the modules list.
    $modules = \Drupal::service('modules_weight')->getModulesList($force);

    return $modules;
  }

}

เรียกใช้บริการของโมดูลเองใน static wrapper:

\Drupal::service('modules_weight')

นี่อาจเป็นเพราะคลาสยูทิลิตี้ถูกใช้ในรหัสขั้นตอนดั้งเดิม ในรหัส OOP นี้ไม่จำเป็นที่นี่คุณควรฉีดบริการโดยตรง

Ken Rickard จาก Slack Drupal #contribute channel กล่าวว่า: "ฉันจะสร้างบริการหากคุณคาดว่าโมดูลอื่น ๆ (หรือผู้พัฒนารายอื่น) ในการโต้ตอบกับรหัสนั้นวิธีการอรรถประโยชน์เป็นเพียงทางลัดส่วนตัวสำหรับตัวคุณเอง"

ใช่สิ่งดีๆเกี่ยวกับบริการคือทุกคนสามารถเขียนทับพวกเขาได้ ดังนั้นหากคุณต้องการให้ผู้อื่นสามารถปรับแต่งโค้ดเฉพาะชิ้นส่วนได้ ดูการดัดแปลงบริการที่มีอยู่ให้บริการแบบไดนามิก

นอกจากนี้คุณควรให้บริการถ้าคุณจำเป็นต้องทำการทดสอบจำลองสำหรับการทดสอบหน่วย PHP ดูการบริการและการฉีดอยู่ใน Drupal 8ดูหน่วยการทดสอบที่มีความซับซ้อนมากขึ้นเรียน Drupal

ถาม & ตอบ:

ทดสอบหน่วยบริการ

การเขียนการทดสอบหน่วยสำหรับวิธีการที่เรียกใช้วิธีการคงที่จากคลาสอื่น