Thiết kế lớp học không thể thay đổi

Question

Một trong những lời khuyên được đưa ra bởi Joshua Bloch là, lớp học nên được thiết kế như là bất biến.

Tôi có lớp sau

public class Dividend { 
    public Dividend setDate(SimpleDate date) { 
     Dividend dividend = new Dividend(this.getStock(), this.getAmount(), date); 
     return dividend; 
    } 
.....// More to go. 

Đối setDate phương pháp, đối tượng này sẽ không được sửa đổi.

Thay vào đó, bản sao của này với trường ngày của nó đang được sửa đổi sẽ được trả về.

Tuy nhiên, bằng cách đánh giá tên phương thức, người dùng sẽ biết đối tượng này sẽ vẫn không thay đổi được như thế nào?

Có quy ước đặt tên tốt hơn bên cạnh setDate không?

Answer 1

Nếu bạn có người định cư, lớp học của bạn sẽ trông có thể thay đổi và người dùng có thể sẽ sử dụng sai cách. Họ có thể sẽ gọi nó như thế này:

dividend.setDate(myDate); 

Và sau đó ngạc nhiên vì sao ngày của dividend không thay đổi. Họ nên đã sử dụng nó như thế này:

newDividend = dividend.setDate(myDate); 

Để thực hiện các API trực quan hơn, nó sẽ là tốt hơn để đổi tên các phương pháp setDate một cái gì đó giống như copyWith:

newDividend = dividend.copyWith(myDate); 

Hoặc, nếu bạn có nhiều lĩnh vực và quá tải sẽ gây nhầm lẫn, bạn có thể gọi cho họ copyWithDate và copyWithComment.

Cũng có thể có các tên khác như được nêu trong các câu trả lời khác: derive (và deriveWithDate) hoặc đơn giản là withDate.

Answer 2

Bạn nên triển khai lớp của mình giống như lớp String, không có bộ định vị trên đó. Nó sẽ được hiểu rằng nó là bất biến nếu không ai có thể đặt bất cứ điều gì trên đó. (có thể bạn có thể muốn đặt người đặt ở chế độ riêng tư hoặc bạn chỉ muốn đặt các biến trực tiếp từ bên trong lớp Cổ tức của mình)

Answer 3

Font, ví dụ, (a) derive phương pháp tạo trường hợp phông chữ mới từ hiện tại.

Answer 4

Chức năng này chỉ là trình bao bọc cho hàm tạo. Quá tải hàm khởi tạo để chấp nhận một đối tượng cổ tức đầy đủ để sao chép. Nếu không, bạn có thể đổi tên chức năng này getDividend (nó chắc chắn không phải là một setter).

Answer 5

Nhiều thư viện Java tôi đã xem đang bắt đầu sử dụng with làm tiền tố cho 'bản sao của đối tượng này, với các thay đổi sau'.

Ví dụ:

public Dividend withDate() { 
    .... 

mà lends tự để

Dividend newDividend = oldDividend.withDate(...).withAmount(...).withComment(...); 

JSR-310, ví dụ, sau mô hình này (cũng như sử dụng plusXxx() và minusXxx() cho 'điều chỉnh' đối tượng mà phải mất một đồng bằng thay vì giá trị tuyệt đối, chẳng hạn).

Answer 6

Vì số Dividend đang được trả lại, người dùng có thể sẽ biết đó là một phiên bản Dividend mới. Thậm chí sau đó, bạn có thể xem xét lại tên.