Comment Utiliser Ninject

La meilleure façon d'obtenir commencé avec Ninject est de commencer petit. Recherchez un new.

Quelque part dans le milieu de votre application, vous êtes en train de créer une classe à l'intérieur d'une autre classe. Cela signifie que vous êtes en train de créer un dépendance. L'Injection de dépendance est d'environ passant ces dépendances, généralement par le constructeur, au lieu de intégration eux.

Dire que vous avez une classe comme ça, utilisée pour créer automatiquement un type spécifique de la note dans Word. (Ceci est similaire à un projet que j'ai fait récemment.)

class NoteCreator
{
    public NoteHost Create()
    {
        var docCreator = new WordDocumentCreator();
        docCreator.CreateNewDocument();
        [etc.]

WordDocumentCreator est une classe qui gère les spécificités de la création d'un nouveau document dans Microsoft Word (créer une instance de Word, etc.). Ma classe, NoteCreator, dépend sur WordDocumentCreator afin d'effectuer son travail.

Le problème est que, si un jour nous décidons de passer à un supérieur de traitement de texte, je dois aller trouver tous les endroits où WordDocumentCreator est instancié et de les changer pour instancier WordPerfectDocumentCreator à la place.

Maintenant, imaginez que je change ma classe à ressembler à ceci:

class NoteCreator
{
    WordDocumentCreator docCreator;

    public NoteCreator(WordDocumentCreator docCreator)  //constructor injection
    {
        this.docCreator = docCreator;
    }

    public NoteHost Create()
    {
        docCreator.CreateNewDocument();
        [etc.]

Mon code n'a pas beaucoup changé; tout ce que j'ai fait dans le Create méthode est de supprimer la ligne avec le new. Mais maintenant, je suis l'injection de ma dépendance. Nous allons faire un petit changement:

class NoteCreator
{
    IDocumentCreator docCreator;

    public NoteCreator(IDocumentCreator docCreator)  //change to interface
    {
        this.docCreator = docCreator;
    }

    public NoteHost Create()
    {
        docCreator.CreateNewDocument();
        [etc.]

Au lieu de passer dans un béton WordDocumentCreator, j'ai extrait un IDocumentCreator interface avec un CreateNewDocument méthode. Maintenant, je peux passer en tout classe qui implémente cette interface, et tous les NoteCreator a à faire est d'appeler la méthode qu'il sait à ce sujet.

Maintenant la partie la plus délicate. Je devrais maintenant avoir une erreur de compilation dans mon application, parce que quelque part j'ai été la création de NoteCreator avec un constructeur sans paramètre qui n'existe plus. Maintenant, j'ai besoin de sortir de que dépendance ainsi. En d'autres termes, je passe par la même processus que ci-dessus, mais maintenant je suis en l'appliquant à la classe qui crée une nouvelle NoteCreator. Lorsque vous démarrez l'extraction des dépendances, vous verrez que ils ont tendance à "remonter" à la racine de votre application, ce qui est le seulement endroit où vous devriez avoir une référence à votre DI conteneur (par exemple, Ninject).

L'autre chose que je dois faire est configurer Ninject. L'élément essentiel est une classe qui ressemble à ceci:

class MyAppModule : NinjectModule
{
    public override void Load()
    {
        Bind<IDocumentCreator>()
            .To<WordDocumentCreator>();

Cela dit Ninject que lorsque je tente de créer une classe qui, quelque part en bas de la ligne, il faut un IDocumentCreator, elle doit créer un WordDocumentCreator et l'utiliser. Le processus Ninject traverse ressemble à quelque chose comme ceci:

• Créer l'application du MainWindow. Son constructeur exige une NoteCreator.
• OK, donc créer une NoteCreator. Mais son constructeur requiert une IDocumentCreator.
• Ma configuration est dit que pour une IDocumentCreator, je devrais utiliser WordDocumentCreator. Afin de créer un WordDocumentCreator.
• Maintenant, je peux passer le WordDocumentCreator à la NoteCreator.
• Et maintenant je peut passer que NoteCreator à la MainWindow.

La beauté de ce système est triple.

Tout d'abord, si vous ne parvenez pas à configurer quelque chose, vous saurez tout de suite, parce que vos objets sont créés dès que votre application est exécutée. Ninject vous donnera un message d'erreur utile de dire que votre IDocumentCreator (par exemple) ne peuvent pas être résolus.

Deuxième, si la gestion ultérieure des mandats de l'utilisateur d'un supérieur de traitement de texte, tout ce que vous avez à faire est de

• Écrire un WordPerfectDocumentCreator qui implémente IDocumentCreator.
• Changement MyAppModule ci-dessus, la liaison IDocumentCreator à WordPerfectDocumentCreator à la place.

Troisième, si je veux tester mon NoteCreator, je n'ai pas à passer dans un réel WordDocumentCreator (ou ce que j'utilise). Je peux passer dans un faux un. De cette façon, je peux écrire un test qui suppose mon IDocumentCreator fonctionne correctement, et ne teste que les parties en mouvement de NoteCreator lui-même. Mon faux IDocumentCreator ne rien faire, mais de retour à la réponse correcte, et mon test assurez-vous que NoteCreator fait la bonne chose.

Pour plus d'informations sur la façon de structurer vos applications de cette façon, avoir un coup d'oeil à la Marque de Seemann livre récent, L'Injection de dépendance dans la .NET. Malheureusement, elle ne couvre pas Ninject, mais il couvre un certain nombre d'autres DI cadres, et il parle de la façon de la structure de votre application dans la façon dont je l'ai décrit ci-dessus.

Également jeter un oeil à Travailler Efficacement Avec Le Code Existant, par Michael Plumes. Il parle de l'essai du côté de la ci-dessus: comment sortir d'interfaces et de passer du faux dans le but d'isoler le comportement et de le faire en vertu de test.