Eloquent ဖြင့် အသုံးဝင်သော သိုလှောင်ပစ္စည်းများ။

ပြီးခဲ့တဲ့အပတ်က ကျွန်တော်ရေးတယ်။ Eloquent entities အတွက် Repository template ၏ အသုံးမကျမှုအကြောင်း ဆောင်းပါးဒါပေမယ့် သူ့အကျိုးအမြတ်အတွက် တစ်စိတ်တစ်ပိုင်းအသုံးပြုနည်းကို ပြောပြမယ်လို့ သူက ကတိပြုခဲ့ပါတယ်။ ဒါကိုလုပ်ဖို့၊ ပရောဂျက်တွေမှာ ဒီပုံစံပလိတ်ကို ဘယ်လိုအသုံးပြုလေ့ရှိလဲဆိုတာ ခွဲခြမ်းစိတ်ဖြာကြည့်မယ်။ repository တစ်ခုအတွက် အနည်းဆုံးလိုအပ်သော နည်းလမ်းများ-

<?php
interface PostRepository
{
    public function getById($id): Post;
    public function save(Post $post);
    public function delete($id);
}

သို့ရာတွင်၊ ပရောဂျက်များ တွင်၊ repositories ကို အသုံးပြုရန် ဆုံးဖြတ်ပါက၊ မှတ်တမ်းများ ပြန်လည်ရယူရန် နည်းလမ်းများကို ၎င်းတို့ထံ မကြာခဏ ထည့်သွင်းသည်-

<?php
interface PostRepository
{
    public function getById($id): Post;
    public function save(Post $post);
    public function delete($id);

    public function getLastPosts();
    public function getTopPosts();
    public function getUserPosts($userId);
}

ဤနည်းလမ်းများကို Eloquent နယ်ပယ်များမှတဆင့် အကောင်အထည်ဖော်နိုင်သော်လည်း ၎င်းတို့ကိုယ်တိုင်ရယူရန် တာဝန်ရှိသော entity class များကို လွန်လွန်ကဲကဲလုပ်ခြင်းသည် အကောင်းဆုံးစိတ်ကူးမဟုတ်ပါ၊ ဤတာဝန်ကို repository အတန်းများသို့ ပြောင်းရွှေ့ခြင်းသည် ယုတ္တိရှိပုံရသည်။ ဒါပဲလား။ ကျွန်ုပ်သည် ဤအင်တာဖေ့စ်ကို အပိုင်းနှစ်ပိုင်းအဖြစ် ပိုင်းခြားထားသည်။ နည်းလမ်းများ၏ ပထမပိုင်းကို ရေးရန် လုပ်ဆောင်ချက်များတွင် အသုံးပြုပါမည်။

စံချိန်စံညွှန်းရေးသားခြင်းလုပ်ဆောင်ချက်မှာ-

• အရာဝတ္ထုအသစ်တစ်ခုတည်ဆောက်ခြင်းနှင့်စိန်ခေါ်မှု PostRepository::သိမ်းဆည်းပါ။
• PostRepository::getByIdဘဘ ခြယ်လှယ်ခြင်းနှင့် ခေါ်ယူခြင်း PostRepository::သိမ်းဆည်းပါ။
• စိန်ခေါ်မှုတစ်ခု PostRepository::ဖျက်ရန်

ရေးရန် လုပ်ဆောင်ချက်များသည် အကျိူးနည်းများကို မသုံးပါ။ ဖတ်ရှုခြင်းလုပ်ငန်းများတွင်၊ get* နည်းလမ်းများကိုသာ အသုံးပြုပါသည်။ အကြောင်းစုံဖတ်ရင် အင်တာဖေ့စ် ခွဲထွက်ခြင်းဆိုင်ရာ အခြေခံမူ (စာ I в ခိုင်မာသော) ထို့နောက် ကျွန်ုပ်တို့၏ အင်တာဖေ့စ်သည် ကြီးလွန်းပြီး အနည်းဆုံး မတူညီသော တာဝန်နှစ်ခုကို လုပ်ဆောင်ကြောင်း ထင်ရှားလာပါလိမ့်မည်။ နှစ်ပိုင်းခွဲဖို့ အချိန်တန်ပြီ။ နည်းလမ်း getById နှစ်ခုလုံးအတွက် လိုအပ်သော်လည်း အပလီကေးရှင်းသည် ပိုမိုရှုပ်ထွေးလာသည်နှင့်အမျှ ၎င်း၏ အကောင်အထည်ဖော်မှုများမှာ ကွဲပြားမည်ဖြစ်သည်။ ဒါကို ခဏကြာမှ တွေ့ပါမယ်။ အရင်က ဆောင်းပါးမှာ ရေးခဲ့တဲ့ အပိုင်းရဲ့ အသုံးမကျမှုအကြောင်း ရေးခဲ့ဖူးတာမို့ ဒီတစ်ပိုင်းကို မေ့ထားလိုက်ပါ့မယ်။

Read အပိုင်းသည် ကျွန်ုပ်အတွက် အလွန်အသုံးမဝင်ဟု ထင်ရသည်၊ Eloquent အတွက်ပင် ဤနေရာတွင် အကောင်အထည်ဖော်မှုများစွာ ရှိနိုင်သောကြောင့် ဖြစ်သည်။ အတန်းနာမည်က ဘာလဲ။ နိုင်သလား ReadPostRepositoryပုံစံခွက်သို့ repository သူ့မှာ ဆက်စပ်မှုနည်းနည်းရှိနေပြီ။ ကိုယ့်ဘာသာ လုပ်လို့ရတယ်။ PostQueries:

<?php
interface PostQueries
{
    public function getById($id): Post;
    public function getLastPosts();
    public function getTopPosts();
    public function getUserPosts($userId);
}

၎င်းကို Eloquent ဖြင့် အကောင်အထည်ဖော်ခြင်းသည် အလွန်ရိုးရှင်းပါသည်။

<?php
final class EloquentPostQueries implements PostQueries
{
    public function getById($id): Post
    {
        return Post::findOrFail($id);
    }

    /**
    * @return Post[] | Collection
    */
    public function getLastPosts()
    {
        return Post::orderBy('created_at', 'desc')
            ->limit(/*some limit*/)
            ->get();
    }
    /**
    * @return Post[] | Collection
    */
    public function getTopPosts()
    {
        return Post::orderBy('rating', 'desc')
            ->limit(/*some limit*/)
            ->get();
    }

    /**
    * @param int $userId
    * @return Post[] | Collection
    */
    public function getUserPosts($userId)
    {
        return Post::whereUserId($userId)
            ->orderBy('created_at', 'desc')
            ->get();
    }
}

အင်တာဖေ့စ်သည် အကောင်အထည်ဖော်မှုနှင့် ဆက်စပ်မှုရှိရမည်၊ ဥပမာအားဖြင့်၊ AppServiceProvider:

<?php
final class AppServiceProvider extends ServiceProvider 
{
    public function register()
    {
        $this->app->bind(PostQueries::class, 
            EloquentPostQueries::class);
    }
}

ဒီအတန်းက အသုံးဝင်နေပြီ။ controllers သို့မဟုတ် entity class တို့ကို ဖြုတ်ချခြင်းဖြင့် သူ၏တာဝန်ကို နားလည်သည်။ Controller တွင်၎င်းကိုဤကဲ့သို့အသုံးပြုနိုင်သည်။

<?php
final class PostsController extends Controller
{
    public function lastPosts(PostQueries $postQueries)
    {
        return view('posts.last', [
            'posts' => $postQueries->getLastPosts(),
        ]);
    }
} 

နည်းလမ်း PostsController::lastPosts အကောင်အထည်ဖော်ဖို့ တောင်းဆိုရုံပါပဲ။ PostsQueries ၎င်းနှင့်အလုပ်လုပ်သည်။ ဝန်ဆောင်မှုပေးသူတွင် ကျွန်ုပ်တို့ချိတ်ဆက်ထားသည်။ PostQueries အတန်းနှင့်အတူ EloquentPostQueries ပြီးတော့ ဒီ class ကို controller နဲ့ အစားထိုးမယ်။

ကျွန်ုပ်တို့၏ အပလီကေးရှင်းသည် အလွန်ရေပန်းစားလာကြောင်း စိတ်ကူးကြည့်ကြပါစို့။ တစ်မိနစ်လျှင် ထောင်နှင့်ချီသော သုံးစွဲသူများသည် နောက်ဆုံးပေါ် ထုတ်ဝေမှုများဖြင့် စာမျက်နှာကို ဖွင့်ကြသည်။ ရေပန်းအစားဆုံး စာပေများကိုလည်း မကြာခဏ ဖတ်ရှုလေ့ရှိသည်။ ဒေတာဘေ့စ်များသည် ထိုကဲ့သို့သော load များကို ကောင်းမွန်စွာ မကိုင်တွယ်နိုင်သောကြောင့် စံဖြေရှင်းချက် - cache ကို အသုံးပြုကြသည်။ ဒေတာဘေ့စ်အပြင်၊ အချို့သောလုပ်ဆောင်ချက်များအတွက် အကောင်းဆုံးဖြစ်အောင်ပြုလုပ်ထားသော သိုလှောင်မှုတွင် ဒေတာလျှပ်တစ်ပြက်အချို့ကို သိမ်းဆည်းထားပါသည် - memcache သို့မဟုတ် ပြန်ပြင်သည်။.

Caching logic သည် အများအားဖြင့် ထိုမျှမရှုပ်ထွေးသော်လည်း EloquentPostQueries တွင် ၎င်းကိုအကောင်အထည်ဖော်ခြင်းသည် အလွန်မှန်ကန်သည်မဟုတ်ပါ (ကြောင့်သာဆိုလျှင်၊ တစ် ဦး တည်းတာဝန်ယူမှုနိယာမ) နမူနာပုံစံကိုသုံးတာက ပိုသဘာဝကျပါတယ်။ အလှဆင်သူ နှင့် ပင်မလုပ်ဆောင်ချက်အတွက် ကက်ချခြင်းကို အလှဆင်ခြင်းအဖြစ် အကောင်အထည်ဖော်ပါ-

<?php
use IlluminateContractsCacheRepository;

final class CachedPostQueries implements PostQueries
{
    const LASTS_DURATION = 10;

    /** @var PostQueries */
    private $base;

    /** @var Repository */
    private $cache;

    public function __construct(
        PostQueries $base, Repository $cache) 
    {
        $this->base = $base;
        $this->cache = $cache;
    }

    /**
    * @return Post[] | Collection
    */
    public function getLastPosts()
    {
        return $this->cache->remember('last_posts', 
            self::LASTS_DURATION, 
            function(){
                return $this->base->getLastPosts();
            });
    }

    // другие методы практически такие же
}

အင်တာဖေ့စ်ကို လျစ်လျူရှုပါ။ repository constructor တွင်။ မသိသော အကြောင်းအရင်းတစ်ခုခုကြောင့် Laravel တွင် သိမ်းဆည်းရန်အတွက် အင်တာဖေ့စ်ကို ဤနည်းဖြင့် အမည်တပ်ရန် ဆုံးဖြတ်ခဲ့သည်။

အတန်းအစား CachedPostQueries caching ကိုသာ လုပ်ဆောင်သည်။ $this->cache-> မှတ်ထားပါ။ ဤ entry သည် cache တွင်ရှိမရှိစစ်ဆေးပြီးမဟုတ်ပါက၊ ထို့နောက် callback ခေါ်ပြီး cache သို့ပြန်ပို့သောတန်ဖိုးကိုရေးပါ။ ကျန်တာအားလုံးက ဒီ class ကို application မှာအကောင်အထည်ဖော်ဖို့ပါပဲ။ အင်တာဖေ့စ်ကို အကောင်အထည်ဖော်ရန် တောင်းဆိုရန် အပလီကေးရှင်းရှိ အတန်းများအားလုံး လိုအပ်ပါသည်။ PostQueries အတန်း၏ဥပမာတစ်ခုလက်ခံရရှိလာသည်။ CachedPostQueries. သို့သော် သူကိုယ်တိုင်ပင် CachedPostQueries constructor သည် class တစ်ခုကို parameter တစ်ခုအဖြစ် လက်ခံရပါမည်။ EloquentPostQueriesအဘယ်ကြောင့်ဆိုသော် ၎င်းသည် "အစစ်အမှန်" အကောင်အထည်ဖော်မှုမရှိဘဲ အလုပ်မဖြစ်နိုင်ပါ။ ငါတို့ပြောင်းတယ်။ AppServiceProvider:

<?php
final class AppServiceProvider extends ServiceProvider 
{
    public function register()
    {
        $this->app->bind(PostQueries::class, 
            CachedPostQueries::class);

        $this->app->when(CachedPostQueries::class)
            ->needs(PostQueries::class)
            ->give(EloquentPostQueries::class);
    }
}

ကျွန်ုပ်၏ဆန္ဒအားလုံးကို ပံ့ပိုးပေးသူတွင် သဘာဝကျကျ ဖော်ပြထားပါသည်။ ထို့ကြောင့်၊ ကျွန်ုပ်တို့သည် အတန်းတစ်ခုစာရေးပြီး container configuration ကိုပြောင်းလဲခြင်းဖြင့်သာ ကျွန်ုပ်တို့၏တောင်းဆိုမှုများကို caching ပြုလုပ်ခဲ့ပါသည်။ ကျန်တဲ့ အပလီကေးရှင်းကုဒ်က မပြောင်းဘူး။

အမှန်ပင်၊ ကက်ရှ်ကို အပြည့်အဝအကောင်အထည်ဖော်ရန်၊ ဖျက်လိုက်သည့်ဆောင်းပါးသည် ဆိုက်ပေါ်တွင် အချိန်အတော်ကြာ မဆိုင်းမတွမတင်ဘဲ ချက်ခြင်း ဖျက်ပစ်ရန် တရားမဝင်ကြောင်းကိုလည်း အကောင်အထည်ဖော်ရန် လိုအပ်ပါသည်။ ဒါပေမယ့် ဒါတွေက အသေးအဖွဲတွေပါ။

အောက်ခြေလိုင်း- ကျွန်ုပ်တို့သည် တစ်ခုမဟုတ်၊ နမူနာနှစ်ခုကို အသုံးပြုထားသည်။ နမူနာ Command Query Responsibility Segregation (CQRS) အင်တာဖေ့စ်အဆင့်တွင် ဖတ်စာရေးခြင်း လုပ်ဆောင်ချက်များကို လုံးလုံးလျားလျား ခွဲခြားရန် အဆိုပြုသည်။ ကျွန်တော် သူ့ဆီရောက်လာတယ်။ အင်တာဖေ့စ် ခွဲထွက်ခြင်းဆိုင်ရာ အခြေခံမူပုံစံများနှင့် အခြေခံမူများကို ကျွမ်းကျင်စွာ ခြယ်လှယ်ပြီး သီအိုရီတစ်ခုအနေဖြင့် အခြားတစ်ခုမှ တစ်လုံးကို ထုတ်ယူကြောင်း အကြံပြုပါသည်။ :) ပရောဂျက်တိုင်းတွင် ထိုသို့သော abstraction ကို ရွေးချယ်ခြင်းအတွက် မလိုအပ်ဘဲ လှည့်ကွက်ကို သင်နှင့် မျှဝေပါမည်။ လျှောက်လွှာ၏ ကနဦးအဆင့်တွင်၊ ဖွံ့ဖြိုးတိုးတက်မှု၊ သင်ရိုးရှင်းစွာအတန်းတစ်ခုဖန်တီးနိုင်သည်။ PostQueries Eloquent မှတစ်ဆင့် ပုံမှန်အကောင်အထည်ဖော်မှုနှင့်အတူ

<?php
final class PostQueries
{
    public function getById($id): Post
    {
        return Post::findOrFail($id);
    }

    // другие методы
}

ကက်ရှ်အတွက် လိုအပ်လာသောအခါတွင်၊ ရိုးရှင်းသောရွှေ့ခြင်းဖြင့် ဤအတန်းအစား interface (သို့မဟုတ် abstract class) ကို ဖန်တီးနိုင်သည်။ PostQueries၎င်း၏အကောင်အထည်ဖော်မှုကို အတန်းသို့ ကူးယူပါ။ EloquentPostQueries စောစောက ဖော်ပြထားတဲ့ အစီအစဉ်ကို သွားပါ။ ကျန်တဲ့ application code တွေကို ပြောင်းစရာမလိုပါဘူး။

အတန်းများ၊ အင်တာဖေ့စ်များဖြင့် ဤလှည့်ကွက်များအားလုံး၊ မှီခိုထိုး и CQRS တွင် အသေးစိတ်ဖော်ပြထားပါသည်။ ကျွန်ုပ်၏ "ရှုပ်ထွေးသောဝဘ်အက်ပလီကေးရှင်းများဗိသုကာ" စာအုပ်၊. ဤဆောင်းပါးအတွက် နမူနာများရှိ ကျွန်ုပ်၏အတန်းအားလုံးကို အဘယ်ကြောင့် နောက်ဆုံးအဖြစ် အမှတ်အသားပြုရသနည်းဆိုသော ပုစ္ဆာအတွက် အဖြေလည်းရှိပါသည်။

source: www.habr.com