Eloquent सह उपयुक्त भांडार?

गेल्या आठवड्यात मी लिहिले Eloquent संस्थांसाठी रेपॉजिटरी टेम्पलेटच्या निरुपयोगीपणाबद्दल लेख, तथापि, त्याने अंशतः त्याच्या फायद्यासाठी ते कसे वापरावे हे सांगण्याचे वचन दिले. हे करण्यासाठी, मी हे टेम्पलेट सहसा प्रकल्पांमध्ये कसे वापरले जाते याचे विश्लेषण करण्याचा प्रयत्न करेन. भांडारासाठी किमान आवश्यक पद्धतींचा संच:

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

तथापि, वास्तविक प्रकल्पांमध्ये, जर रेपॉजिटरीज वापरण्याचा निर्णय घेतला असेल तर, रेकॉर्ड पुनर्प्राप्त करण्याच्या पद्धती त्यामध्ये जोडल्या जातात:

<?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);
}

या पद्धती इलोक्वेंट स्कोपद्वारे अंमलात आणल्या जाऊ शकतात, परंतु स्वत: ला आणण्याची जबाबदारी असलेल्या घटक वर्गांना ओव्हरलोड करणे ही सर्वोत्तम कल्पना नाही आणि ही जबाबदारी रेपॉजिटरी क्लासेसकडे हलवणे तर्कसंगत वाटते. असे आहे का? मी विशेषत: या इंटरफेसला दोन भागांमध्ये विभागले आहे. पद्धतींचा पहिला भाग लेखन ऑपरेशनमध्ये वापरला जाईल.

मानक लेखन ऑपरेशन आहे:

• नवीन ऑब्जेक्टचे बांधकाम आणि आव्हान पोस्टरिपॉजिटरी::सेव्ह करा
• PostRepository::getById, संस्था हाताळणी आणि समन्सिंग पोस्टरिपॉजिटरी::सेव्ह करा
• एक आव्हान PostRepository::delete

लेखन ऑपरेशन्स फेच पद्धती वापरत नाहीत. रीड ऑपरेशन्समध्ये, फक्त get* पद्धती वापरल्या जातात. बद्दल वाचले तर इंटरफेस पृथक्करण तत्त्व (पत्र I в घन), नंतर हे स्पष्ट होईल की आमचा इंटरफेस खूप मोठा आहे आणि किमान दोन भिन्न जबाबदाऱ्या पार पाडतो. ते दोनने विभाजित करण्याची वेळ आली आहे. पद्धत getById दोन्हीमध्ये आवश्यक आहे, परंतु जसजसा अनुप्रयोग अधिक जटिल होत जाईल, तसतसे त्याची अंमलबजावणी भिन्न होईल. हे आपण थोड्या वेळाने पाहू. मी मागील लेखात लेखन भागाच्या निरुपयोगीतेबद्दल लिहिले होते, म्हणून या लेखात मी त्याबद्दल विसरून जाईन.

वाचलेला भाग मला तितकासा निरुपयोगी वाटत नाही, कारण Eloquent साठी देखील येथे अनेक अंमलबजावणी असू शकतात. वर्गाला काय नाव द्यावे? करू शकतो ReadPostRepository, परंतु टेम्पलेटसाठी भांडार त्याला आधीपासूनच थोडेसे प्रासंगिकता आहे. आपण फक्त करू शकता पोस्टक्वेरी:

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

इलोक्वेंटसह त्याची अंमलबजावणी करणे अगदी सोपे आहे:

<?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);
    }
}

हा वर्ग आधीच उपयुक्त आहे. नियंत्रक किंवा घटक वर्ग यांना मुक्त करून त्याला आपली जबाबदारी कळते. कंट्रोलरमध्ये हे असे वापरले जाऊ शकते:

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

पद्धत PostsController::lastPosts फक्त काही अंमलबजावणीसाठी विचारत आहे पोस्टक्वेरी आणि त्याच्यासह कार्य करते. आम्ही लिंक केलेल्या प्रदाता मध्ये पोस्टक्वेरी वर्गासह वाकबगार पोस्टक्वेरी आणि हा वर्ग कंट्रोलरमध्ये बदलला जाईल.

चला कल्पना करूया की आमचा अनुप्रयोग खूप लोकप्रिय झाला आहे. प्रति मिनिट हजारो वापरकर्ते नवीनतम प्रकाशनांसह पृष्ठ उघडतात. सर्वात लोकप्रिय प्रकाशने देखील खूप वेळा वाचली जातात. डेटाबेस असे भार फार चांगले हाताळत नाहीत, म्हणून ते एक मानक उपाय वापरतात - एक कॅशे. डेटाबेस व्यतिरिक्त, विशिष्ट ऑपरेशन्ससाठी ऑप्टिमाइझ केलेल्या स्टोरेजमध्ये विशिष्ट डेटा स्नॅपशॉट संग्रहित केला जातो - memcached किंवा रेडिस.

कॅशिंग लॉजिक सहसा इतके क्लिष्ट नसते, परंतु 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();
            });
    }

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

इंटरफेसकडे दुर्लक्ष करा भांडार कन्स्ट्रक्टर मध्ये. काही अज्ञात कारणास्तव, त्यांनी Laravel मध्ये कॅशिंगसाठी इंटरफेसला अशा प्रकारे नाव देण्याचा निर्णय घेतला.

क्लोस्स कॅशेडपोस्टक्वेरीज फक्त कॅशिंगची अंमलबजावणी करते. $this->cache->लक्षात ठेवा ही नोंद कॅशेमध्ये आहे की नाही ते तपासते आणि नसल्यास, कॉलबॅक कॉल करते आणि कॅशेमध्ये परत केलेले मूल्य लिहिते. या वर्गाची ऍप्लिकेशनमध्ये अंमलबजावणी करणे एवढेच उरले आहे. इंटरफेसच्या अंमलबजावणीची विनंती करण्यासाठी आम्हाला अनुप्रयोगातील सर्व वर्गांची आवश्यकता आहे पोस्टक्वेरी वर्गाचे उदाहरण मिळू लागले कॅशेडपोस्टक्वेरीज. मात्र, त्यांनी स्व कॅशेडपोस्टक्वेरीज कन्स्ट्रक्टरला पॅरामीटर म्हणून वर्ग प्राप्त करणे आवश्यक आहे वाकबगार पोस्टक्वेरीकारण ते "वास्तविक" अंमलबजावणीशिवाय कार्य करू शकत नाही. आम्ही बदलतो 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);
    }
}

माझ्या सर्व इच्छा प्रदात्यामध्ये नैसर्गिकरित्या वर्णन केल्या आहेत. अशाप्रकारे, आम्ही आमच्या विनंत्यांसाठी फक्त एक वर्ग लिहून आणि कंटेनर कॉन्फिगरेशन बदलून कॅशिंग लागू केले. उर्वरित अनुप्रयोग कोड बदललेला नाही.

अर्थात, कॅशिंग पूर्णपणे अंमलात आणण्यासाठी, अवैधतेची अंमलबजावणी करणे देखील आवश्यक आहे जेणेकरून हटवलेला लेख काही काळ साइटवर लटकत नाही, परंतु त्वरित हटविला जाईल. पण या किरकोळ गोष्टी आहेत.

तळ ओळ: आम्ही एक नाही, परंतु दोन टेम्पलेट वापरले. नमुना कमांड क्वेरी रिस्पॉन्सिबिलिटी सेग्रीगेशन (CQRS) इंटरफेस स्तरावर वाचन आणि लेखन ऑपरेशन्स पूर्णपणे वेगळे करण्याचा प्रस्ताव आहे. द्वारे मी त्याच्याकडे आलो इंटरफेस पृथक्करण तत्त्व, जे सुचविते की मी कुशलतेने नमुने आणि तत्त्वे हाताळतो आणि एक प्रमेय म्हणून दुसऱ्यामधून काढतो :) अर्थात, प्रत्येक प्रकल्पाला घटक निवडण्यासाठी अशा अमूर्ततेची आवश्यकता नसते, परंतु मी युक्ती तुमच्याबरोबर सामायिक करेन. अर्जाच्या सुरुवातीच्या टप्प्यावर विकास, आपण फक्त एक वर्ग तयार करू शकता पोस्टक्वेरी Eloquent द्वारे नेहमीच्या अंमलबजावणीसह:

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

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

जेव्हा कॅशिंगची गरज भासते, तेव्हा सोप्या हालचालीने तुम्ही या वर्गाच्या जागी इंटरफेस (किंवा अमूर्त वर्ग) तयार करू शकता. पोस्टक्वेरी, त्याची अंमलबजावणी वर्गात कॉपी करा वाकबगार पोस्टक्वेरी आणि मी आधी वर्णन केलेल्या योजनेवर जा. उर्वरित अनुप्रयोग कोड बदलण्याची आवश्यकता नाही.

या सर्व युक्त्या वर्ग, इंटरफेस, अवलंबित्व इंजेक्शन и CQRS मध्ये तपशीलवार वर्णन केले आहे माझे पुस्तक "आर्किटेक्चर ऑफ कॉम्प्लेक्स वेब ऍप्लिकेशन". या लेखाच्या उदाहरणांमध्ये माझे सर्व वर्ग अंतिम का म्हणून चिन्हांकित केले आहेत या कोडेचे निराकरण देखील आहे.

स्त्रोत: www.habr.com