AdonisJS là một framework MVC (Model-View-Controller) cho Node.js dựa trên nguyên lý tối giản. Với kiến trúc rõ ràng và dễ hiểu, AdonisJS giúp các lập trình viên phát triển ứng dụng web một cách nhanh chóng và hiệu quả. Trong bài viết này, chúng ta sẽ thảo luận về các bước cài đặt thư viện AdonisJS trong JavaScript, cũng như tìm hiểu một số thao tác cơ bản với framework này.
Điều kiện cần thiết
Trước khi bắt đầu cài đặt AdonisJS, bạn cần chắc chắn rằng máy tính của mình đã cài đặt:
-
Node.js: Đảm bảo bạn đã cài đặt phiên bản Node.js từ 12.x trở lên. Bạn có thể kiểm tra phiên bản Node.js hiện tại bằng lệnh:
node -vNếu chưa cài đặt Node.js, bạn có thể tải và cài đặt từ trang chủ Node.js tại đây.
-
NPM: NPM (Node Package Manager) thường đi kèm với Node.js. Bạn có thể kiểm tra phiên bản NPM bằng lệnh:
npm -v
Bước 1: Cài đặt CLI của AdonisJS
AdonisJS cung cấp một CLI (Command Line Interface) mạnh mẽ hỗ trợ việc khởi tạo và quản lý dự án. Để cài đặt CLI của AdonisJS, bạn có thể sử dụng lệnh NPM toàn cầu như sau:
npm i -g @adonisjs/cli
Sau khi cài đặt hoàn tất, bạn có thể kiểm tra xem CLI đã được cài đặt thành công hay chưa bằng cách chạy lệnh:
adonis --version
Lệnh này sẽ hiển thị phiên bản hiện tại của AdonisJS CLI.
Bước 2: Tạo dự án mới với AdonisJS
Sau khi cài đặt thành công CLI, bạn có thể tạo một dự án mới bằng cách sử dụng lệnh new như sau:
adonis new my-project
Trong đó, my-project là tên của dự án bạn muốn tạo. Lệnh này sẽ tạo một dự án mới với cấu trúc thư mục và tệp tin cần thiết để bắt đầu phát triển ứng dụng với AdonisJS.
Sau khi quá trình tạo dự án hoàn tất, bạn sẽ thấy một cấu trúc thư mục như sau:
my-project/
├── ace
├── app
│ ├── Controllers
│ │ └── Http
│ ├── Exceptions
│ ├── Middleware
│ ├── Models
│ └── Validators
├── bootstrap
├── config
├── contracts
├── database
├── public
├── resources
├── start
└── tests
Bước 3: Cài đặt các gói phụ trợ
Di chuyển vào thư mục dự án vừa tạo và cài đặt các gói phụ trợ cần thiết bằng lệnh:
cd my-project
npm install
Lệnh này sẽ kiểm tra và cài đặt tất cả các gói thư viện được liệt kê trong tập tin package.json.
Bước 4: Cấu hình cơ sở dữ liệu
AdonisJS hỗ trợ nhiều loại cơ sở dữ liệu khác nhau như MySQL, PostgreSQL, SQLite, và SQL Server. Bạn cần cấu hình cơ sở dữ liệu cho dự án bằng cách chỉnh sửa tệp tin config/database.js.
Ví dụ, để sử dụng SQLite, bạn có thể cấu hình như sau:
const Env = use('Env')
module.exports = {
connection: Env.get('DB_CONNECTION', 'sqlite'),
sqlite: {
client: 'sqlite3',
connection: {
filename: Env.get('DB_DATABASE', 'database.sqlite')
},
useNullAsDefault: true,
debug: Env.get('DB_DEBUG', false)
}
}
Bước 5: Khởi động ứng dụng
Sau khi hoàn tất các bước cài đặt và cấu hình, bạn có thể khởi động ứng dụng bằng lệnh:
adonis serve --dev
Lệnh này sẽ khởi động máy chủ trên localhost với cổng mặc định là 3333. Bạn có thể truy cập ứng dụng qua trình duyệt tại địa chỉ http://localhost:3333/.
Làm Quen Với AdonisJS
Tạo Bộ Điều Khiển Mới
Bộ điều khiển (Controller) là nơi chứa logic xử lý các yêu cầu từ người dùng. Bạn có thể tạo một bộ điều khiển mới bằng lệnh:
adonis make:controller UserController
Lệnh này sẽ tạo một tệp tin UserController.js trong thư mục app/Controllers/Http.
Tạo Model Mới
Model đại diện cho bảng trong cơ sở dữ liệu và được sử dụng để tương tác với cơ sở dữ liệu. Bạn có thể tạo một model mới bằng lệnh:
adonis make:model User
Lệnh này sẽ tạo một tệp tin User.js trong thư mục app/Models.
Tạo Migration
Migration được sử dụng để quản lý các thay đổi trong cơ sở dữ liệu. Bạn có thể tạo một migration mới bằng lệnh:
adonis make:migration users --create=users
Lệnh này sẽ tạo một tệp tin migration trong thư mục database/migrations. Bạn có thể chỉnh sửa tệp tin này để định nghĩa cấu trúc bảng users.
Sau khi chỉnh sửa, bạn có thể chạy migration để tạo bảng bằng lệnh:
adonis migration:run
Sử Dụng Tự Động Tải Lại
Trong quá trình phát triển, việc dừng và khởi động lại máy chủ để xem các thay đổi có thể trở nên mệt mỏi. AdonisJS hỗ trợ tính năng tự động tải lại khi có thay đổi trong mã nguồn bằng cách sử dụng lệnh:
adonis serve --dev
Tạo Routes
Routes là nơi xác định các URL mà ứng dụng sẽ phản hồi. Bạn có thể thêm các routes mới trong tệp tin start/routes.js. Ví dụ:
const Route = use('Route')
Route.get('/users', 'UserController.index')
Route.post('/users', 'UserController.store')
Route.get('/users/:id', 'UserController.show')
Route.put('/users/:id', 'UserController.update')
Route.delete('/users/:id', 'UserController.destroy')
Kết Luận
AdonisJS là một lựa chọn tuyệt vời cho các dự án web nhờ vào sự đơn giản và mạnh mẽ của nó. Việc cài đặt AdonisJS khá dễ dàng và nhanh chóng, đặc biệt là khi bạn đã làm quen với các bước cài đặt và cấu hình cơ bản. Hy vọng bài viết này đã cung cấp cho bạn một cái nhìn tổng quan và hướng dẫn chi tiết về cách cài đặt thư viện AdonisJS trong JavaScript. Chúc các bạn thành công với dự án của mình!
Comments