Giới thiệu về Clean Architecture – Phần 1

Công Nghệ
Giới thiệu về Clean Architecture – Phần 1
Bài viết được sự cho phép của tác giả Nguyễn Hữu Khanh Clean Architecture là một cách viết code, tổ chức code được giới thiệu bởi Robert C. Martin . Nói nôm na cho các bạn hiểu thì thông thường, khi xây dựng một Java project để expose ra các RESTful APIs, chúng ta sẽ build một project với nhiều package khác nhau như sau: Làm thế nào để sắp xếp Clean Architecture theo Modular Patterns trong 10 phút? Viết code sạch (Clean code) được gì? Phần 1 Trong đó: Package com.huongdanjava.cleanarchitecture.rest sẽ chứa các Controller để handle request từ người dùng. Package com.huongdanjava.cleanarchitecture.rest.dto sẽ chứa các Java class để handle data từ request của người dùng và data sẽ response lại cho người dùng. Package com.huongdanjava.cleanarchitecture.service sẽ chứa các class handle việc xử lý business. Package com.huongdanjava.cleanarchitecture.db sẽ chứa các class dùng để thao tác với database. Package com.huongdanjava.cleanarchitecture.db.model chứa các model mapping database table với Java class. Package com.huongdanjava.cleanarchitecture.security chứa các class liên quan đến xử lý security của ứng dụng. Tất cả các dependencies của ứng dụng sẽ được khai báo trong tập tin pom.xml. Đối với các ứng dụng nhỏ, việc tổ chức code như thế này sẽ không có vấn đề gì lớn lao. Nhưng đối với các ứng dụng lớn, nhiều chức năng, các bạn hãy tưởng tượng chỉ cần 1 thay đổi nhỏ, sẽ cần phải thay đổi code của toàn bộ project. Việc này sẽ rất khó quản lý và nếu như bạn là một người mới join vào dự án, sẽ rất khó khăn để bạn hiểu được ứng dụng đang làm gì và được viết code như thế nào. Clean Architecture giới thiệu một cách viết code, tổ chức code mới, đảm bảo nguyên tắc separation of concerns khi viết...

Bài viết được sự cho phép của tác giả Nguyễn Hữu Khanh

Clean Architecture là một cách viết code, tổ chức code được giới thiệu bởi Robert C. Martin. Nói nôm na cho các bạn hiểu thì thông thường, khi xây dựng một Java project để expose ra các RESTful APIs, chúng ta sẽ build một project với nhiều package khác nhau như sau:

Giới thiệu về Clean Architecture – Phần 1Giới thiệu về Clean Architecture – Phần 1

Trong đó:

  • Package com.huongdanjava.cleanarchitecture.rest sẽ chứa các Controller để handle request từ người dùng.
  • Package com.huongdanjava.cleanarchitecture.rest.dto sẽ chứa các Java class để handle data từ request của người dùng và data sẽ response lại cho người dùng.
  • Package com.huongdanjava.cleanarchitecture.service sẽ chứa các class handle việc xử lý business.
  • Package com.huongdanjava.cleanarchitecture.db sẽ chứa các class dùng để thao tác với database.
  • Package com.huongdanjava.cleanarchitecture.db.model chứa các model mapping database table với Java class.
  • Package com.huongdanjava.cleanarchitecture.security chứa các class liên quan đến xử lý security của ứng dụng.

Tất cả các dependencies của ứng dụng sẽ được khai báo trong tập tin pom.xml.

Đối với các ứng dụng nhỏ, việc tổ chức code như thế này sẽ không có vấn đề gì lớn lao. Nhưng đối với các ứng dụng lớn, nhiều chức năng, các bạn hãy tưởng tượng chỉ cần 1 thay đổi nhỏ, sẽ cần phải thay đổi code của toàn bộ project. Việc này sẽ rất khó quản lý và nếu như bạn là một người mới join vào dự án, sẽ rất khó khăn để bạn hiểu được ứng dụng đang làm gì và được viết code như thế nào.

Clean Architecture giới thiệu một cách viết code, tổ chức code mới, đảm bảo nguyên tắc separation of concerns khi viết code, dễ dàng thêm mới, mở rộng, loại bỏ các tính năng của ứng dụng mà không cần phải thay đổi nhiều code. Các bạn hãy xem hình ảnh dưới đây:

Giới thiệu về Clean Architecture – Phần 1Giới thiệu về Clean Architecture – Phần 1

Đây là hình ảnh tổng quan về ý tưởng của Clean Architecture.

Lớp trong cùng nhất là lớp Entities (màu vàng), sẽ đảm nhận nhiệm vụ định nghĩa các Java POJO chứa các thông tin liên quan đến business của ứng dụng. Ví dụ như ứng dụng của bạn là về quản lý thông tin sinh viên thì lớp này sẽ chứa một Java class định nghĩa thông tin sinh viên gồm có những gì?

Lớp tiếp theo bên ngoài lớp Entities là lớp Use Cases, (màu hồng) lớp này sẽ chứa các class định nghĩa các business cases cần thiết cho ứng dụng. Với ứng dụng quản lý sinh viên ở trên thì các use cases mà chúng ta có thể định nghĩa trong lớp này là các class cho phép chúng ta thêm, xoá, sửa, cập nhập thông tin sinh viên.

Một điều lưu ý với 2 lớp trên, Entities và Use Cases, là chúng ta sẽ không sử dụng bất kỳ một external library hay framework nào, ngoài trừ lớp Use Cases thì có thể cần sử dụng các library liên quan đến Unit Testing.

Để các use cases có thể nói chuyện với các external system như database, web service, MQ server, chúng ta cần một lớp gọi là lớp Adapter (màu xanh lá cây). Sử dụng Java thì lớp Adapter này chứa những interface để cho lớp Use Cases sử dụng. Những interface này sẽ được implement bởi những thành phần ở lớp ngoài cùng trong hình vẽ trên (màu xanh dương) tuỳ theo nhu cầu của ứng dụng. Trong ví dụ về ứng dụng quản lý sinh viên thì chúng ta có thể định nghĩa các interface để lấy thông tin sinh viên từ database, cập nhập thông tin sinh viên,…

Có một nguyên tắc khi viết các ứng dụng theo Clean Architecture đó là, như các bạn thấy trong hình vẽ trên chỗ các dấu mũi tên từ ngoài vào trong, những thay đổi của lớp bên ngoài sẽ không ảnh hưởng gì đến code của những lớp bên trong. Những lớp bên trong sẽ không biết code của những lớp bên ngoài có gì.

Để áp dụng ý tưởng của Clean Architecture, đối với các ứng dụng Java, các bạn có thể xây dựng project với Maven Module project và thêm một lớp ngoài cùng tên là Configuration đảm nhận việc cấu hình cho ứng dụng sẽ chạy như thế nào. Không có lớp này thì ứng dụng không thể chạy được.

Trên đây là những ý tưởng cơ bản về Clean Architecture, trong bài viết sau, mình sẽ đi vào thực tế cách hiện thực một project sử dụng Clean Architecture sẽ như thế nào các bạn nhé!

Bài viết gốc được đăng tải tại huongdanjava.com

Có thể bạn quan tâm:

Xem thêm các việc làm Developer hấp dẫn tại Station D

Bài viết liên quan

Bộ cài đặt Laravel Installer đã hỗ trợ tích hợp Jetstream

Bộ cài đặt Laravel Installer đã hỗ trợ tích hợp Jetstream

Bài viết được sự cho phép của tác giả Chung Nguyễn Hôm nay, nhóm Laravel đã phát hành một phiên bản chính mới của “ laravel/installer ” bao gồm hỗ trợ khởi động nhanh các dự án Jetstream. Với phiên bản mới này khi bạn chạy laravel new project-name , bạn sẽ nhận được các tùy chọn Jetstream. Ví dụ: API Authentication trong Laravel-Vue SPA sử dụng Jwt-auth Cách sử dụng Laravel với Socket.IO laravel new foo --jet --dev Sau đó, nó sẽ hỏi bạn thích stack Jetstream nào hơn: Which Jetstream stack do you prefer? [0] Livewire [1] inertia > livewire Will your application use teams? (yes/no) [no]: ... Nếu bạn đã cài bộ Laravel Installer, để nâng cấp lên phiên bản mới bạn chạy lệnh: composer global update Một số trường hợp cập nhật bị thất bại, bạn hãy thử, gỡ đi và cài đặt lại nha composer global remove laravel/installer composer global require laravel/installer Bài viết gốc được đăng tải tại chungnguyen.xyz Có thể bạn quan tâm: Cài đặt Laravel Làm thế nào để chạy Sql Server Installation Center sau khi đã cài đặt xong Sql Server? Quản lý các Laravel route gọn hơn và dễ dàng hơn Xem thêm Tuyển dụng lập trình Laravel hấp dẫn trên Station D

By stationd
Principle thiết kế của các sản phẩm nổi tiếng

Principle thiết kế của các sản phẩm nổi tiếng

Tác giả: Lưu Bình An Phù hợp cho các bạn thiết kế nào ko muốn làm code dạo, design dạo nữa, bạn muốn cái gì đó cao hơn ở tầng khái niệm Nếu lập trình chúng ta có các nguyên tắc chung khi viết code như KISS , DRY , thì trong thiết kế cũng có những nguyên tắc chính khi làm việc. Những nguyên tắc này sẽ là kim chỉ nam, nếu có tranh cãi giữa các member trong team, thì cứ đè nguyên tắc này ra mà giải quyết (nghe hơi có mùi cứng nhắc, mình thì thích tùy cơ ứng biến hơn) Tìm các vị trí tuyển dụng designer lương cao cho bạn Nguyên tắc thiết kế của GOV.UK Đây là danh sách của trang GOV.UK Bắt đầu với thứ user cần Làm ít hơn Thiết kế với dữ liệu Làm mọi thứ thật dễ dàng Lặp. Rồi lặp lại lần nữa Dành cho tất cả mọi người Hiểu ngữ cảnh hiện tại Làm dịch vụ digital, không phải làm website Nhất quán, nhưng không hòa tan (phải có chất riêng với thằng khác) Cởi mở, mọi thứ tốt hơn Bao trừu tượng luôn các bạn, trang Gov.uk này cũng có câu tổng quát rất hay Thiết kế tốt là thiết kế có thể sử dụng. Phục vụ cho nhiều đối tượng sử dụng, dễ đọc nhất nhất có thể. Nếu phải từ bỏ đẹp tinh tế – thì cứ bỏ luôn . Chúng ta tạo sản phẩm cho nhu cầu sử dụng, không phải cho người hâm mộ . Chúng ta thiết kế để cả nước sử dụng, không phải những người đã từng sử dụng web. Những người cần dịch vụ của chúng ta nhất là những người đang cảm thấy khó sử dụng dịch...

By stationd
Hiểu về trình duyệt – How browsers work

Hiểu về trình duyệt – How browsers work

Bài viết được sự cho phép của vntesters.com Khi nhìn từ bên ngoài, trình duyệt web giống như một ứng dụng hiển thị những thông tin và tài nguyên từ server lên màn hình người sử dụng, nhưng để làm được công việc hiển thị đó đòi hỏi trình duyệt phải xử lý rất nhiều thông tin và nhiều tầng phía bên dưới. Việc chúng ta (Developers, Testers) tìm hiểu càng sâu tầng bên dưới để nắm được nguyên tắc hoạt động và xử lý của trình duyệt sẽ rất hữu ích trong công việc viết code, sử dụng các tài nguyên cũng như kiểm thử ứng dụng của mình. Cách để npm packages chạy trong browser Câu hỏi phỏng vấn mẹo về React: Component hay element được render trong browser? Khi hiểu được cách thức hoạt động của trình duyệt chúng ta có thể trả lời được rất nhiều câu hỏi như: Tại sao cùng một trang web lại hiển thị khác nhau trên hai trình duyệt? Tại sao chức năng này đang chạy tốt trên trình duyệt Firefox nhưng qua trình duyệt khác lại bị lỗi? Làm sao để trang web hiển thị nội dung nhanh và tối ưu hơn một chút?… Hy vọng sau bài này sẽ giúp các bạn có một cái nhìn rõ hơn cũng như giúp ích được trong công việc hiện tại. 1. Cấu trúc của một trình duyệt Trước tiên chúng ta đi qua cấu trúc, thành phần chung và cơ bản nhất của một trình duyệt web hiện đại, nó sẽ gồm các thành phần (tầng) như sau: Thành phần nằm phía trên là những thành phần gần với tương tác của người dùng, càng phía dưới thì càng sâu và nặng về xử lý dữ liệu hơn tương tác. Nhiệm...

By stationd
Thị trường EdTech Vietnam- Nhiều tiềm năng nhưng còn bị bỏ ngỏ tại Việt Nam

Thị trường EdTech Vietnam- Nhiều tiềm năng nhưng còn bị bỏ ngỏ tại Việt Nam

Lĩnh vực EdTech (ứng dụng công nghệ vào các sản phẩm giáo dục) trên toàn cầu hiện nay đã tương đối phong phú với nhiều tên tuổi lớn phân phối đều trên các hạng mục như Broad Online Learning Platforms (nền tảng cung cấp khóa học online đại chúng – tiêu biểu như Coursera, Udemy, KhanAcademy,…) Learning Management Systems (hệ thống quản lý lớp học – tiêu biểu như Schoology, Edmodo, ClassDojo,…) Next-Gen Study Tools (công cụ hỗ trợ học tập – tiểu biểu như Kahoot!, Lumosity, Curriculet,…) Tech Learning (đào tạo công nghệ – tiêu biểu như Udacity, Codecademy, PluralSight,…), Enterprise Learning (đào tạo trong doanh nghiệp – tiêu biểu như Edcast, ExecOnline, Grovo,..),… Hiện nay thị trường EdTech tại Việt Nam đã đón nhận khoảng đầu tư khoảng 55 triệu đô cho lĩnh vực này nhiều đơn vị nước ngoài đang quan tâm mạnh đến thị trường này ngày càng nhiều hơn. Là một trong những xu hướng phát triển tốt, và có doanh nghiệp đã hoạt động khá lâu trong ngành nêu tại infographic như Topica, nhưng EdTech vẫn chỉ đang trong giai đoạn sơ khai tại Việt Nam. Tại Việt Nam, hệ sinh thái EdTech trong nước vẫn còn rất non trẻ và thiếu vắng nhiều tên tuổi trong các hạng mục như Enterprise Learning (mới chỉ có MANA), School Administration (hệ thống quản lý trường học) hay Search (tìm kiếm, so sánh trường và khóa học),… Với chỉ dưới 5% số dân công sở có sử dụng một trong các dịch vụ giáo dục online, EdTech cho thấy vẫn còn một thị trường rộng lớn đang chờ được khai phá. *** Vừa qua Station D đã công bố Báo cáo Vietnam IT Landscape 2019 đem đến cái nhìn toàn cảnh về các ứng dụng công...

By stationd