Modèle de conception de référentiel démystifié

Points de base

• Le modèle d'entrepôt agit comme un intermédiaire entre l'application et la source de données, permettant la construction d'une architecture découplée pour atteindre l'évolutivité sans avoir besoin de dépendances à code dur.
• Ce mode permet à l'application de se concentrer sur la réception et l'envoi de données pour enregistrer sans prêter attention aux détails de la source de données. Il le fait via une API publique (interface) à travers laquelle tous les utilisateurs communiquent avec la source de données.
• Bien que le modèle d'entrepôt offre des avantages tels que la séparation des préoccupations et la facilité des tests unitaires, il ajoute également une couche d'abstraction, qui peut compliquer de petites applications.
• La mise en œuvre du modèle d'entrepôt nécessite une injection de dépendance, ce qui permet à l'entrepôt de données d'être lié à l'interface d'entrepôt. Cela évite le couplage codé dur et facilite la programmation orientée vers l'interface.

Quel est le modèle d'entrepôt?

En termes simples, il s'agit d'une implémentation de la couche intermédiaire entre l'application et la source de données. Aucune des parties n'a besoin de se connaître pour effectuer leurs tâches respectives, ce qui nous permet d'avoir une architecture découplée qui aide à évoluer dans de grandes applications sans dépendances codées en dur.

Pourquoi devriez-vous y prêter attention?

Comprenons cela avec un exemple. Supposons que nous construisions une boutique en ligne vendant des bonbons à saveur d'orange. C'est un petit magasin qui maintient le stock local, nous n'avons donc rien de sophistiqué. Les applications de magasin ne peuvent se connecter qu'à la base de données et prendre des commandes en ligne en fonction de l'inventaire existant. Cela fonctionnera bien car le magasin n'a qu'un seul entrepôt d'approvisionnement et des zones d'exploitation limitées. Mais que se passe-t-il si le magasin veut étendre sa zone d'exploitation? Les magasins peuvent vouloir se développer dans une autre ville ou à travers le pays, et avoir un système d'inventaire central sera très gênant.

Si nous utilisons toujours le modèle de données, notre application sera quelque peu étroitement couplée. Les applications de magasin doivent connaître chaque source de données avec laquelle il doit interagir, ce qui est une mauvaise conception d'applications. Le travail d'une application StoreFront est de permettre aux clients de commander des bonbons, la demande ne devrait pas se soucier de la source de données, elle ne devrait pas suivre toutes les différentes sources de données. C'est là que les entrepôts de données entrent en jeu. Selon le modèle d'entrepôt, une API publique est exposée via une interface et chaque consommateur (dans ce cas notre application de magasin) l'utilise pour communiquer avec la source de données. Quelle source de données à utiliser ou comment y connecter n'a rien à voir avec l'application. L'application ne se soucie que des données qu'il obtient et des données qu'il envoie pour enregistrer.

Une fois le modèle d'entrepôt implémenté, un entrepôt peut être créé pour chaque source de données. Les applications de magasinage n'ont plus besoin de suivre les sources de données, elles utilisent simplement l'API du référentiel pour obtenir les données dont ils ont besoin.

Est-ce une panacée?

Non, ce n'est pas le cas. Comme chaque modèle de conception, il a ses avantages et ses inconvénients.

PROS:

• Séparation des préoccupations; L'application n'a pas besoin de comprendre ou de suivre toutes les sources de données.
• permet des tests unitaires faciles, car le référentiel est lié à une interface qui injecte la classe au moment de l'exécution.
• Dry (ne vous répétez pas) Conception, le code pour interroger et obtenir des données à partir de la source de données ne sera pas répété.

Inconvénients:

• Ajoutez une autre couche d'abstraction, ajoutant un certain niveau de complexité, ce qui le rend trop complexe pour les petites applications.

Comment faire?

Regardons un exemple de code simple. J'utiliserai Laravel dans mon exemple pour profiter de son excellente fonctionnalité d'injection de dépendance. Si vous utilisez un cadre PHP moderne, il devrait déjà avoir un conteneur d'injection / IOC de dépendance. La mise en œuvre du modèle d'entrepôt nécessite une injection de dépendance, car sans elle, vous ne pourrez pas lier votre entrepôt de données à une interface d'entrepôt, et l'idée est une programmation orientée vers l'interface pour éviter le couplage codé en dur. Si vous n'utilisez aucun framework ou si le cadre de votre choix n'a pas de conteneur IOC, vous pouvez utiliser un conteneur IOC standard (voir note de bas de page).

Commençons. Tout d'abord, nous avons configuré notre espace de noms et notre autoadad dans Composer. Ouvrez Composer.json et ajoutez PSR-4 Autoload à notre espace de noms (dans le nœud Autoload, immédiatement après classMap).

    "autoload": {
        "classmap": [
            "app/commands",
            "app/controllers",
            "app/models",
            "app/database/migrations",
            "app/database/seeds",
            "app/tests/TestCase.php"
        ],
        "psr-4": {
            "RocketCandy\": "app/RocketCandy"
        }
    },

Après enregistrer, exécutez composer dump-autoload -o dans le terminal pour enregistrer le chargement automatique du nouvel espace de noms. Créer app/RocketCandy/Repositories/OrangeCandyRepository/ dans OrangeCandyRepository.php. Ce sera notre interface de référentiel.

<?php
namespace RocketCandy\Repositories\OrangeCandyRepository;

interface OrangeCandyRepository {

    public function get_list( $limit = 0, $skip = 0 );

    public function get_detail( $candy_id = 0 );

}

Maintenant que nous avons l'interface, nous pouvons créer un référentiel. Créer app/RocketCandy/Repositories/OrangeCandyRepository/ dans CityAOrangeCandyRepository.php.

<?php
namespace RocketCandy\Repositories\OrangeCandyRepository;

class CityAOrangeCandyRepository implements OrangeCandyRepository {

    public function get_list( $limit = 0, $skip = 0 ) {
        // 查询数据源并获取糖果列表
    }

    public function get_detail( $candy_id = 0 ) {
        // 查询数据源并获取糖果详情
    }

}

Pour lier le référentiel CityAOrangeCandyRepository à l'interface OrangeCandyRepository, nous utiliserons le conteneur IOC de Laravel. Ouvrez app/start/global.php et ajoutez ce qui suit à la fin du fichier.

//OrangeCandyRepository
App::bind(
    'RocketCandy\Repositories\OrangeCandyRepository\OrangeCandyRepository',
    'RocketCandy\Repositories\OrangeCandyRepository\CityAOrangeCandyRepository'
);

Remarque: je n'ai placé les liaisons IOC que dans global.php pour la démonstration. Idéalement, ceux-ci doivent être placés dans leurs propres fichiers séparés où vous pouvez mettre toutes les liaisons IOC, puis charger ce fichier ici dans global.php ou vous pouvez créer un fournisseur de services pour enregistrer chaque liaison IOC. Vous pouvez en savoir plus ici.

Maintenant, nous pouvons utiliser le référentiel via l'interface. Dans app/controllers/ situé dans CandyListingController.php.

    "autoload": {
        "classmap": [
            "app/commands",
            "app/controllers",
            "app/models",
            "app/database/migrations",
            "app/database/seeds",
            "app/tests/TestCase.php"
        ],
        "psr-4": {
            "RocketCandy\": "app/RocketCandy"
        }
    },

Ici, nous injectons l'interface OrangeCandyRepository dans notre contrôleur et stockons sa référence d'objet dans une variable de classe qui peut désormais être utilisée par n'importe quelle fonction du contrôleur pour interroger les données. Puisque nous lions l'interface OrangeCandyRepository au référentiel CityAOrangeCandyRepository, ce sera comme nous utilisons directement le référentiel CityAOrangeCandyRepository.

Ainsi, maintenant, le type et le type de source de données sont les seules préoccupations de CityAOrangeCandyRepository. Notre application ne connaît que l'interface OrangeCandyRepository et son API exposée, et chaque référentiel qui les implémente doit se conformer à cette API. L'entrepôt est analysé à partir du conteneur IOC à l'exécution, ce qui signifie que la liaison entre les entrepôts de l'interface peut être définie au besoin. La source de données peut désormais être une base de données, des services Web ou un pipeline Hyperdata interdimensionnel.

Tous les cas ne s'appliquent pas

Comme je l'ai mentionné dans les inconvénients du modèle de référentiel, il ajoute une certaine complexité à l'application. Donc, si vous faites une petite application et que vous ne le voyez pas évoluer au point où il est grand (peut nécessiter plusieurs sources de données), il est préférable de ne pas les implémenter et de s'en tenir au modèle de données à l'ancienne. Comprendre quelque chose est différent de savoir quand l'utiliser. Il s'agit d'un modèle de conception très pratique qui évite beaucoup de problèmes lors de la création d'applications et lorsque vous devez maintenir ou étendre (ou réduire) les applications, mais ce n'est pas une panacée pour toutes les applications.

J'ai utilisé le code spécifique de Laravel pour démontrer l'implémentation ci-dessus, mais il est assez simple et similaire pour tout bon conteneur IOC. Des questions? Veuillez le faire dans les commentaires ci-dessous.

Note de bas de page:

• Voici quelques bibliothèques de conteneurs IOC que vous pouvez utiliser si votre framework n'a pas ou si vous n'utilisez pas le framework:

  • Ornodi
  • ray.di
  • auryn
  • DICE
  • seau
  • ding

• lecture suggérée:

  • Conception entraînée par le domaine Rapidement
  • Conception axée sur le domaine par Eric Evans

Des questions fréquemment posées sur le modèle d'entrepôt

(Cette partie du contenu est fortement coïncidente avec le texte d'origine. Pour éviter la duplication, il est omis ici. La section FAQ dans le texte d'origine a inclus une explication complète du modèle d'entrepôt.)

Ce qui précède est le contenu détaillé de. pour plus d'informations, suivez d'autres articles connexes sur le site Web de PHP en chinois!