Dependency injection is a programming technique that makes a module independent of its dependencies. This enables you to replace dependencies without changing the module that uses them.
To illustrate Dependency Injection, we'll be building an API with the following endpoints
- GET /post: Gets all posts
- POST /post: Creates a post
and structure the api in the following way:
- Datasource - persistence implementation using third party modules.
- Repository - decouple application from persistence: has a datasource dependency.
- UseCase - business logic: has a repository dependency.
- Presentation - routes: has a usecase dependency.
1. PostDataSource
var Datastore = require('nedb-promises');
var postdb = Datastore.create(__dirname + '/db/ne_post.db');
function postDataSource (){
async function createPost(post) {
const result = await postdb.insert(post)
return result;
}
async function getPosts() {
const result = await postdb.find()
return result
}
return { createPost, getPosts }
}
module.exports = postDataSource;
The Datasource uses on third a party lib as shown in the require statement. (nedb is an embedded persistent database for Node. API is a subset of MongoDB)
2. PostRepository
function postRepository({ postDataSource }) {
async function createPost(post) {
const result = await postDataSource.createPost(post)
return result;
}
async function getPosts() {
const result = await postDataSource.getPosts();
return result;
}
return { createPost, getPosts}
}
module.exports = postRepo;
The repository is a means of decoupling our datasource from the rest of our application. The datasource is therefore not imported but property injected into the repository. Once injected, all the functions within the repository now have access to this external dependency. This is using the closure feature within Javascript
(A closure is a feature where an inner function has access to the outer (enclosing) function’s variables
3. CreatePost UseCase
function createPostUseCase({ postRepository }) {
async function execute(post) {
const result = await postRepository.createPost(post);
return result;
}
return { execute };
}
module.exports = createPost;
As we've done with the post repository, the post repository is property injected into the usecase.
Let's now build the post router and see how we chain these dependencies.
3. Post Router
const express = require("express");
const router = express.Router();
const GetPostsUsecase = require("../../domain/usecases/get_all_posts");
const CreatePostUsecase = require("../../domain/usecases/create_post");
const PostRepository = require("../../domain/repositories/post_repository");
const PostDataSource = require("../../data/datasources/nedb/post_data_source");
router.get("/", async (req, res) => {
const postDataSource = PostDataSource();
const postRepository = PostRepository({ postDataSource });
const getPosts = GetPostsUsecase({ postRepository });
const result = await getPosts.execute();
res.json(result);
})
router.post("/", async (req, res) => {
const postDataSource = PostDataSource();
const postRepository = PostRepository({ postDataSource });
const createPost = CreatePostUsecase({ postRepository });
const result = await createPost.execute(req.body);
res.json(result);
})
module.exports = router;
With the code above, we manually needed to create and chain together the dependencies in order to produce a usecase object on which we run the execute command.
We can simplify this process by using an IoC container. IoC container (a.k.a. DI Container) is a framework for implementing automatic dependency injection. It manages object creation, and also injects dependencies. Let's firstly create the container.
IoC Container
const { createContainer, asFunction, InjectionMode, } = require('awilix');
const PostRepository = require('./domain/repositories/post_repository');
const PostDataSource = require('./data/datasources/nedb/post_data_source');
const GetAllPostsUsecase = require('./domain/usecases/get_all_posts');
const CreatePostUsecase = require('./domain/usecases/create_post');
const container = createContainer();
container.register({
postDataSource: asFunction(PostDataSource),
postRepository: asFunction(PostRepository),
getPostsUseCase: asFunction(GetAllPostsUsecase),
createPostUsecase: asFunction(CreatePostUsecase)
});
module.exports = container;
All dependencies are imported and registered here. We use the Awilix third party library to help use create the container
Let's now revisit our router and use the container.
Post Router with Container
const express = require("express");
const router = express.Router();
const { resolve } = require("../../container");
router.get("/", async (req, res) => {
const getPosts = resolve("getPostsUseCase")
const result = await getPosts.execute();
res.json(result)
})
router.post("/", async (req, res) => {
const createPost = resolve("createPostUsecase");
const result = await createPost.execute(req.body);
res.json(result);
})
module.exports = router;
And that's it. We've now shown how we can use dependency injection in Javascript without classes.
Top comments (0)