Clean code a handbook of agile software craftsmanship

Listing 2-2 
Biến có ngữ cảnh 
public
class
GuessStatisticsMessage { 
private
String
number; 
private
String
verb; 
private
String
pluralModifier; 
public
String
make(
char
candidate, 
int
count) { 
createPluralDependentMessageParts(count); 
return
String.format(
"There %s %s %s%s"
,verb, number, candidate, 
pluralModifier ); 
} 
private
void
createPluralDependentMessageParts(
int
count) { 
if
(count == 
0
) { 
thereAreNoLetters(); 
} 
else
if
(count == 
1
) { 
thereIsOneLetter(); 
} 
else
{ 
thereAreManyLetters(count); 
} 
} 
private
void
thereAreManyLetters(
int
count) { 
number = Integer.toString(count); 
verb = 
"are"
; 
pluralModifier = 
"s"
; 
} 
private
void
thereIsOneLetter() { 
number = 
"1"
; 
verb = 
"is"
; 

27 
pluralModifier = 
""
; 
} 
private
void
thereAreNoLetters() { 
number = 
"no"
; 
verb = 
"are"
; 
pluralModifier = 
"s"
; 
} 
} 
Tên ngắn thường tốt hơn tên dài, miễn là chúng rõ ràng. Thêm đủ ngữ cảnh cho tên sẽ tốt hơn 
khi cần thiết. 
Tên 
accountAddress
và 
customerAddress
là những tên đẹp cho trường hợp đặc biệt của 
lớp 
Address
nhưng có thể là tên tồi cho các lớp khác. 
Address
là một tên đẹp cho lớp. Nếu tôi cần 
phân biệt giữa địa chỉ MAC, địa chỉ cổng (port) và địa chỉ web thì tôi có thể xem xét 
MAC
, 
PostalAddress
và 
URL
. Kết quả là tên chính xác hơn. Đó là tâm điểm của việc đặt tên. 
Lời kết 
Điều khó khăn nhất của việc lựa chọn tên đẹp là nó đòi hỏi kỹ năng mô tả tốt và nền tảng văn 
hóa lớn. Đây là vấn đề về học hỏi hơn là vấn đề kỹ thuật, kinh doanh hoặc quản lý. Kết quả là nhiều 
người trong lĩnh vực này không học cách làm điều đó. 
Mọi người cũng sợ đổi tên mọi thứ vì lo rằng người khác sẽ phản đối. Chúng tôi không chia sẻ 
nỗi sợ đó cho bạn. Chúng tôi thật sự biết ơn những ai đã đổi tên khác cho biến, hàm,…(theo hướng tốt 
hơn). Hầu hết thời gian chúng tôi không thật sự nhớ tên lớp và những phương thức của nó. Chúng tôi 
có các công cụ giúp chúng tôi trong việc đó để chúng tôi có thể tập trung vào việc code có dễ đọc hay 
không. Bạn có thể sẽ gây ngạc nhiên cho ai đó khi bạn đổi tên, giống như bạn có thể làm với bất kỳ cải 
tiến nào khác. Đừng để những cái tên tồi phá hủy sự nghiệp coder của mình. 
Thực hiện theo một số quy tắc trên và xem liệu bạn có cải thiện được khả năng đọc code của 
mình hay không. Nếu bạn đang bảo trì code của người khác, hãy sử dụng các công cụ tái cấu trúc để 
giải quyết vấn đề này. Mất một ít thời gian nhưng có thể làm bạn nhẹ nhõm trong vài tháng.