đặt tên Java

Đặt tên Java: Bước đầu tiên để có mã dễ đọc

Tên dễ đọc là khởi đầu của sự hợp tác — hãy học cách đặt tên Java một cách có hệ thống.

🧭 Tính năng của khóa học

• Tìm hiểu mọi thứ từ các quy tắc đặt tên cơ bản của Java đến cách đặt tên theo tên miền.

• Bao gồm các ví dụ về cách viết tài liệu hướng dẫn phong cách cấp nhóm.

  
  

🧰 Hiệu quả mong đợi sau khi tham gia khóa học

• Tiêu chuẩn đặt tên rõ ràng giúp tăng cường sự tin cậy trong quá trình đánh giá và hợp tác.

• Thiết kế một tài liệu quy ước đặt tên có thể áp dụng cho từng nhóm.

• Nâng cao hiệu quả phát triển thông qua khả năng đọc và bảo trì mã được cải thiện.

💡 Bài giảng này dành cho những người này

• Các nhà phát triển Java mới vào nghề có từ 1-4 năm kinh nghiệm thường xuyên nhận được phản hồi về cách đặt tên trong quá trình đánh giá mã

• Những người gặp khó khăn khi cộng tác với các thành viên trong nhóm do tên biến, tên hàm và tên lớp khó bảo trì

• Các trưởng nhóm muốn thiết lập quy ước đặt tên rõ ràng và nhất quán ngay từ đầu dự án.

• Bất kỳ ai muốn biết về quy ước đặt tên, chiến lược đặt tên và đổi tên

  
  

🤔 Tại sao lại đặt tên như vậy?

“Con người đọc mã lâu hơn máy móc.”

Trong khi hầu hết các nhà phát triển đều tập trung vào việc triển khai các tính năng, thì trở ngại lớn nhất trong quá trình cộng tác và bảo trì thực tế lại là "mã không thể đọc được". Đặt tên là điểm khởi đầu.

Một cái tên được xây dựng tốt sẽ tốt hơn tài liệu hướng dẫn, và một cái tên được xây dựng kém sẽ là mầm mống của lỗi.

Khóa học này được xây dựng theo chương trình giảng dạy bao gồm các chiến lược đặt tên thực tế dành cho nhà phát triển Java, cùng với các bài tập tự động hóa và tái cấu trúc dựa trên công cụ.

📚 Những điều quan trọng bạn học được trong lớp

1⃣ Tầm quan trọng và nguyên tắc cơ bản của việc đặt tên

• Tác động đến khả năng đọc và năng suất

• Những lỗi đặt tên thường xuất hiện trong quá trình đánh giá mã

• Mối tương quan giữa chi phí bảo trì và đặt tên

• Các nguyên tắc cơ bản về sự rõ ràng, nhất quán và truyền đạt ý định

2⃣ Nắm vững hoàn toàn các quy ước đặt tên cơ bản của Java

• PascalCase cho các lớp, giao diện và enum

• camelCase cho các biến, phương thức và tham số

• UPPER_SNAKE_CASE của hằng số

• Ví dụ về đặt tên phương thức DTO, VO và thậm chí cả phương thức thử nghiệm

3⃣ Chiến lược đặt tên tập trung vào tên miền doanh nghiệp

• Thiết kế theo miền và ngôn ngữ phổ biến

• Cân bằng giữa khái niệm trừu tượng kỹ thuật và thuật ngữ kinh doanh

• Chiến lược đặt tên theo lớp nghiệp vụ (Bộ điều khiển, Dịch vụ, v.v.)

• Thực hành đặt tên điểm cuối của REST API

• So sánh cấu trúc đặt tên dựa trên chức năng và dựa trên vai trò

4⃣ Cách thiết lập quy ước đặt tên theo nhóm

• Tài liệu hướng dẫn phong cách nhóm

• Chuyển đổi từ phản hồi đánh giá mã sang quy tắc đặt tên

• Những điều cần kiểm tra khi thiết lập quy tắc đặt tên ban đầu

• Chiến lược thuyết phục và phổ biến thông tin cho các thành viên trong nhóm