[置頂]分享 - 小問題大道理

 1 public class Order {
 2     
 3     private String name;
 4     //
 5     private Set<OrderLine> orderLines = new HashSet<OrderLine>();
 6 
 7     public String getName() {
 8         return name;
 9     }
10 
11     public void setName(String name) {
12         this.name = name;
13     }
14 
15     /**
16      * 因?yàn)檫@是一個(gè)domain對(duì)象，貫穿你整個(gè)項(xiàng)目，不知你是否在意過這樣的設(shè)計(jì)。
17      * 這樣的設(shè)計(jì)對(duì)你是否有用呢？
18      * 用戶：表示API調(diào)用者。 
19      */
20     
21     public Set<OrderLine> getOrderLines() {
22         /*
23          * 1.防止用戶任意修改訂單行的內(nèi)容，強(qiáng)制要求用戶使用當(dāng)前類提供的API修改訂單行
24          * 2.getOrderLines()絕對(duì)不為null，有可能getOrderLines().isEmpty()為true
25          * 用在你的程序中不會(huì)出現(xiàn)if(getOrderLines() == null && getOrderLines().isEmpty())，
26          * 只會(huì)出現(xiàn)if(getOrderLines().isEmpty())
27          */
28         return Collections.unmodifiableSet(orderLines);
29     }
30 
31     //-----------------------提供API修改Order by OrderLine----------------------------//
32     public void addOrderLine(OrderLine orderLine) {
33         //
34         orderLines.add(orderLine);
35     }
36 
37     public void removeOrderLine(OrderLine orderLine) {
38         // 
39     }
40     //-----------------------提供API修改Order by OrderLine----------------------------//
41     
42     public void setOrderLines(Set<OrderLine> orderLines) {
43         // this.orderLines = orderLines;
44         // 為什么沒有向上面來(lái)做，是因?yàn)槿绻沁@樣賦值的話那么兩個(gè)對(duì)象就是同一個(gè)引用了。
45         // 用戶修改orderLines，this.orderLines也同樣會(huì)被修改。
46         // 而提供這個(gè)類期望用戶通過該類提供的接口來(lái)修改orderLines。
47         orderLines.addAll(orderLines);
48     }
49 
50 }

[置頂]jdoc2chm (Javadoc轉(zhuǎn)CHM幫助文檔工具)

jdoc2chm是一個(gè)轉(zhuǎn)換javadoc至CHM文件的工具，支持JDK7的Javadoc轉(zhuǎn)換。

無(wú)論你在工作中或者在學(xué)習(xí)中，手上有一個(gè)良好易用的幫助文件都會(huì)給你帶來(lái)無(wú)限的方便。你無(wú)需要把什么東西都記在大腦里面，你只需要能夠熟練的使用各種技術(shù)的提供的幫助文檔，這樣你的工作和學(xué)習(xí)都會(huì)十分輕松。
在你不明白或困惑的時(shí)候你應(yīng)該閱讀官方提供的文檔，也許答案就在其中。

類似jdoc2chm的工具網(wǎng)上也有許多，這次作者編寫該工具的主要目的是為了支持JDK7所生成的Javadoc（JDK7還未正式發(fā)布，同樣也是為了迎接JDK7的到來(lái)）。JDK7 Oracle官方提供的Javadoc與前面的版本格式都有所改變，導(dǎo)致前面所有的jdoc2chm工具都不能正確
的將JDK7的Javadoc轉(zhuǎn)換為CHM。

jdoc2chm是免費(fèi)開源的一個(gè)項(xiàng)目。使用非常簡(jiǎn)單。
首先你要到這里去下載jdoc2chm的發(fā)布包。
你可以通過下面的地址獲取jdoc2chm的源碼。