Using Clean Architecture for Microservice APIs in Node.js with MongoDB and Express
Vložit
- čas přidán 26. 06. 2024
- In this video we talk about Bob Martin's Clean Architecture model and I will show you how we can apply it to a Microservice built in node.js with MongoDB and Express JS.
You can follow along with the code at:
github.com/dev-mastery/commen...
Original Blog Post on Clean Architecture by Bob Martin
blog.cleancoder.com/uncle-bob... - Věda a technologie
Any questions about Clean Architecture, Node, Express, or Mongo? Let me know in the comments. I'm happy to help!
By injecting dependencies to function args, aren't we loosing out on intellisense?
Is there a better way to inject dependencies ?
+Kashif Minhaj Editors like VS Code do a decent job of guessing after a while, but intellisense still suffers a bit for sure. One option is to use Flow or Typescript along with an Editor that supports it so that you can specify the type of each parameter on the way in. No guessing.
If we use something like mongoose, should we make entities become mongoose schema? Or we should pass a entity to a function which creates and returns mongoose schema?
@@blackdiz2603 thanks for asking such a great question. Mongoose belongs to the outermost circle, so it would occupy the same role as our MongoDB Driver. Meaning, we would inject a Mongoose model into our CommentsDB module and use it exclusively to interact with the database. It's very important not to confuse a Mongoose model with a business Entity. We need to make sure that business rules are as independent as possible from third-party frameworks like Mongoose.
A mistake I see too often in legacy code bases is that they built their Business Objects on top of - or even inside of - some third-party framework and then after a few years their codebase becomes an unstable mess because the underlying dependencies have been deprecated but no one wants to touch them because it would risk breaking all the (often poorly or not at all documented) business logic of their app. Clean Architecture was designed specifically to avoid this situation.
Do you think the upcoming class features (public/privates, getters, setters) will change this implementation at all?
in the comment entity:
export default (dependencies = {}) => class Comment {
constructor(data = {}) {
// code to validate and store the comment data in 'this' goes here
}
#author;
#text;
#replyToId;
}
in a use case:
// instead of const comment = makeComment(info)
const comment = new Comment(info)
Also as a side note, it's really hard to find examples of people working with the clean architecture, in nodeJS, using more than just one entity. It would be super helpful if, for example, you changed the comment author to an Author entity and showed how you establish and validate things like many to one relationships at the business-logic entity level.
Love this part:
To the client: "I've turbocharged our microservice by using a cloud-based AI"
To a fellow programmer: "It's just an API that I'm calling..."
I had to pause the video right here, so true! haha
client: Will it have AI?
Me: Yes.
raise your hand if you feel you are a newbie in NodeJS after watching this video, thanks buddy for such knowledgeable tutorial.
Yea 100%. I feel like when I was first introduced to NodeJS and didn't understand a single concept. How is your understanding now, 11 months later? Are you applying this architecture (honestly)? Or are you applying a different strategy? Monolith?
I think it's a little bit too late, but this is not about nodeJS, in particular this is about programming in general, these concepts could be applied within any other language, I mean, maybe just oop ones? I'm not really sure
@@Melvin420x12 I didn’t get chance to implement it as I am working on existing applications but I have kept in bucket whenever my new project will start I will be going to think on it
@@no-name2031 no you can apply these concepts to any type of programming language. Even in this video dependency inversion is achieved through functions. Whereas in pure Oop language there will be an intermediate interface.
The whole "injecting" your dependencies instead of "importing" them was pure gold. I never understood why we would need to inject a dependency until now. Subscribed.
I have been learning NestJS for a while, that framework highly uses this concept. You should try that out if you are a Node.js dev
@@tea_hanks1230 do you still use it?
The inject is not the important part; the adapters and interfaces are the important part. He said the outer layers should depend on the inner layers, which means the external tools and frameworks should depend on our adapters and interfaces. The make-callback.js at the end of the video is a perfect example.
Also, imported/required modules can still be mocked in tests. Injection with the wrapper function is not necessary and even adds bloat.
I think it is part of SOLID principals, in the D part, dependency inversion principals. where the high level module should not depend on low level module, those two must depend on abstraction. high level module is the code that we write ourself, and low level code is the dependency such as mongoose, node-postgres, mysql that 'abstracted' as db connector
@@fikriseptriananggara5922 you don't need to use an explicit "inject" pattern if the module being imported provides interfaces for any external modules it uses.
This is the most valuable nodejs video I’ve watched so far.
It is indeed one of its kind.
Agree
@@RaffaCaboFrioAgree!
Totally agree.
100% agree if only I'd have seen it a year ago 🤦♂️
OH, MY, GOD!!!! Friends (c)
This is the ONLY ONE video which shows real ARCHITECTURE in REAL case! I have been searching a video like this one through years!!!
Thanks a lot!!!
I was about to write the same thing....
@@grzegorzg944 same lol.... years I've needed this
wow...me watching this 4 years later is the cleanest explanation of clean architecture and dependency injection I have come across. That's some solid content you've shared. Thanks mate :)
Hello Bill, I just wanted to thank you wholehearthly for this content. It really helped me to wrap my head around all this system design jargon and navigate through the plethora of clickbaity articles and videos.
Have a great day.
Thanks for this kind of videos. Most of the content creators just stand on the basics. I appreciate your pro content.
This is the most helpful video I have watched about Clean Architecture. I can't count how many times I come back to watch this again and again every time I feel lost. Thanks so much!
I will be watching this several times until I understand more clearly. Great video!
Yes agreed, so much content that talks about clean architecture, but this actually shows it in action! And only now I’m starting to understand what it’s all about.
Absolutely gorgeous! What clear and concise explanation! Please, please keep making DDD videos like this one. I've subscribed to your content.
This is so great. I love seeing how you implemented the Clean Architecture in JS! Very nice work, and thanks for sharing.
First time a Node.js setup feels REALLY RIGHT! I love this. Especially the "mini-main" index.js files that do all the dependency injections for a small module. Great work!
This was probably one of the best express - mongo setup I’ve ever seen. Thanks so much for sharing! Will probably have to rewatch, or clone the repo and step through a few times just solidify your implementation.
This is gold! So many how to's but very very few why to's! Thank you for this!
Great explanation! Not much channels out there focus on the architecture side of software development. More of these, please and thank you!
Both of your technical and teaching skills are remarkable. The best illustration of Clean architecture I've could find so far. Thanks sharing!
Amazing video! More insightful content in this 33 mins than tons of other typing tutorials out there. Thank you very much!
These are the kind of tutorials I have been looking for years and here I have got one. Keep making these kind of videos.
You're doing great work man. I find a lot of the conceptual stuff without practical examples so it's left up to me to experiment and I often get things wrong, but you've got some practical code as a practical example which is immensely helpful.
Incredible! Best explanation of the Clean Architecture I've ever seen.
Really clean and testable code. Amazing! You went straight to the point, very good content. Subscribed!
This video is a great example of what a video tutorial should be related to devs. Source code and diagrams. Business explanations, and concrete implementation. Absolutely the greatest
Please, don't stop making videos. You're a really good teacher
Mind = Blown. For someone who thought who knows enough about structuring code and model data and apis, this is an eye opener. This is proper pro content, at times I was falling behind because there was so much things to pick up. Please keep making videos. Thanks
Magnificent explanation supported by neat and potentially powerful app example! Thank you very much!
This is a wonderful explanation, I haven't seen this type of clarity with concrete examples for clean architecture with node.js anywhere else. Nice work!
Sooooooooooo awesome. I'm trying to learn clean architecture and having this example in js is super helpful. Thanks for the great video.
OMG, it is the video I've been searching for several years! Thanks a lot!
This is a really way to code in node, the use case break down into services is really intuitive
More about Microservices with Nodejs . Good content . Keep it up 🔥
One of the best video I've seen so far, finaly understood what dependency injection was used for. Hard to understand when you didn't studied IT and you convert to fullstack dev by yourself, now it's finally clearer. Thanks a lot. Subscribed of course.
probably the best video on Onion/Clean arch I've watched so far. Concrete examples helped so much. We have been trying to adhere to onion at work to make our lives easier down the road and I was second guessing myself sometimes. Thanks for clearing up the fog
This is incredible 👌 Whole new way of thinking (for me) 🤓
Liked and subscribed. This architecture is the real meaning of plug and play. I love how each and every thing can be tweaked without affecting others. Loved it.
Wonderful setup. One of the best I've seen. Well done!!!
Out of the node js videos that I came across with, this is probably the best and most clean so far.
Amazing! This video has really made me to reiterate a lot of my design principles. Thank you
Awesome video. Finally a real-case node js implementation with clean architecture! Very informative, thanks a lot!
Thanks a lot. This is the most valuable architecture video I've ever seen.
This video is so-o good. I've watched it twice. And the second time through I kept rewinding bits to make sure I didn't miss a thing!! Well done.
will do it too!
Please please please keep continuing to make videos! Thank you so much. There are a few videos that help us to scale up to a high level. This is one of them that's why It is so valuable. Thank you again!
I had to watch probably too many times, but thank you. This is the best programming video I have ever watched.
Thank you so much for making this! I've been reading about clean architecture and DDD for a while now and this finally made things click
Hands down the best demonstration of this concept.
Excellent video, Bill. This content is super helpful. I can't wait to try these concepts out to build a sturdy API. Thank you!
Love what you did with the video man, and also a very clever way to implement the adapter pattern for the sanitize library, the only thing that I would change, is that I prefer to have individual files for all the dependencies with their adapters, instead of having just one big file with all the third party and factory functions. But this video is a must see! thank you
Super useful, thanks for taking out time to make this.
What a valuable video, contragulations!
I have been working in a node.js app using Clean Architecture lately and it is great to see alignment with your solution... but specially being able to learn new things I hadn't thought about from it too, thank you for sharing!
Seriously the best Node JS on CZcams ... Thank you sir!
i did find it extemely useful, thanks a million for the effort it took to compile and make this - much love
Great explanation! Immediately forwarded to the rest of my team
I just founded this. Thank you very much, this is advanced but at the same time so we'll explained that is just beautiful
Priceless content.
Thank you
I've stumbled to your channel by pure luck,it's probably the best node js vid i have ever seen, you should make more videos
Really impressive how you pass the knowledge in an easy way, real and understandable. Like some guys said, everything in only one video. Thanks for sharing
The video is definitely a gold. Thank you very much. I may apply the idea in our project.
This is so great. Would love to see more content!
Thanks for posting that! I have to try it out next I built a microservice from scratch! Seems like a lot of fun!
This should be the best Node video in the whole internet !
Awsome Microservices tutorial with clean architecture.
Thanks.
This presentation gave me a very clear guideline on how to structure my current or future NodeJS - Express projects. I've found this tutorial accidentally after searching the web for something else (as usual) and I do NOT regret the 33:49 min that I spend to watch and try to understand it. I had to stop many time to get what you are saying and I saved it for later use. Great! Thx.
What a great explanation. Loved how you explained the concepts in about half an hour! Subscribing!
So simple and to the point.. Really a pleasure to follow.
Great Demo! Super Great! Clean, well done and super useful!
Clear, concise and well explained! Many thanks for this great video! I was searching for this kind of content applied to JavaScript in vain until now. Subscribed
simple, clean and straight forward
I'm a beginner developer and I'm so grateful to have found this channel. PURE GOLD! Thanks for this amazing content!
This is just amazing, and it even follows some functionnal programming principles... Wow
Amazingly explained! I love it!
This video is an artifact of knowledge. It is so enlightening.
Great content! I'd like to see a TypeScript project that uses this architecture to understand the use of interfaces
Amazing video, you should never stop making this unique content, Thanks
Mind Blowing! Loved it
This is one of the best tutorial I have ever watched. I hope this gets upgrade to typescript
im 1 second in and im hooked with that presentation of the sprinking in
thanks for this video. this is just beauty, clean and super well explained. thanks !
It's awesome! Thanks a lot!
Please keep doing similar videos.
Amazing video, I think I'm going to start practicing on the clean architecture
Thank you so much, it all makes so much more sense now.
Clean Architecture is a difficult concept to grasp through, just because it has tricky parts such as
"No inner circle depends on outer circle"
and you're like:
"Well, then how the hell am I going to insert a new object into the database if I cant depend on it?
You explained it very well, thank you for that.
This type of learning material helps a lot, I am practicing clean architecture and this video helped clear some of the concepts. Thanks a lot you saved me a lot of research.
Awesome content! Thank you for sharing with us!
You just made me a better developer. Thank you!
wow... its the best structure i ever seen. Thank you for explanations!
One word... 'FANTASTIC!!!'
Thanks a million for this video!! I've read the Clean Architecture by Robert Martin, but could not understand how to apply the provided circular diagram in practice. Frankly speaking, I understand only 20-30% of what is going on in the video because of the lack of knowledge and experience, but it fires an awesome feeling of curiosity and desire to continue enhance my skills to become more and more professional as time goes by.
UPD: I'm having so much emotions and insights watching this video so that I will download this video and keep it on my external drive for future reviews!! (if this video will accidentally disappear from CZcams)🙂
Explained Very Clearly. Excellent job of application of theory.
although i got lost in express callback, was really great video.
i've always wondered that from college, i've learned the use case things but never knew how to actually use them. This video helps a lot of making sense of why we should learn software architecture. Thank you for makin such a wonderful video!
Great Video! Always wanted to understand how to implement dependency injection on a practical use case.
Excellent! One of very few non trivial code examples; demonstrating clean architecture and good coding style very well
What a clean code. Just excellent.
that was exactly what I needed. I always knew that something is wrong with my programming style
After watching this video I have only one question. Why I didn't know about your channel before? This video is a gold! Can't wait to see your other videos. Thank you very much for sharing your knowledge!
Thanks for sharing this with us! It's very useful! Thanks bro!
The most valuble Nodejs video in CZcams
wooow thats reaaaly great it can be applyied to huge large application love it!!
@Dev Mastery Fantastic balance of principles, application, and code details.
Are you still making vids? (Or are you planning to start up again?)
I would love a follow-up video that goes into some more deep-dive aspects of this practice. Perhaps also a video of common “gotchas” for people trying out this architecture for the first time.
this was pretty good, very nice job man
thanks for the vid very informative to see clean implemented in js
This video was outstanding in terms of depth and practicality it never felt express app until towards the end of the video.
Although I understood the concept of clean architecture, but it would be really helpful if you make a playlist of achieving this from scratch. That would be gold! Thanks for such content. Subscribed