Mercurial > hg > Members > shoshi > TreeCMSv2

comparison src/treecms/api/NodeID.java @ 20:084de6909451

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
commit
author shoshi
date Wed, 01 Jun 2011 15:35:50 +0900
parents 12604eb6b615
children
comparison
equal deleted inserted replaced
19:019ca5abb1f0 20:084de6909451
1 package treecms.api; 1 package treecms.api;
2 2
3 /** 3 /**
4 * Nodeに対応するNodeIDです．NodeIDはUUIDとバージョンから構成されており，同じUUIDを持つNodeIDはファミリーと定義します． 4 * Nodeに対応するNodeIDです．NodeIDはFamilyとVersionから構成されており，同じFamilyを持つNodeIDはファミリーと定義します．
5 * 木構造で同じUUIDを持つNodeは同一のNodeと判断されます．また，一つの木構造に同じUUIDを持つNodeは存在しません． 5 * 木構造で同じFamilyを持つNodeは同一のNodeと判断されます．また，一つの木構造に同じFamilyを持つNodeは存在しません．
6 * ファイルのバージョン管理と同じようなものと考えてください．その場合，UUIDがファイルのパスで，バージョンがファイルの更新日時です． 6 * ファイルのバージョン管理と同じようなものと考えてください．その場合，Familyがファイルのパスで，Versionがファイルの更新日時です．
7 * @author shoshi 7 * @author shoshi
8 */ 8 */
9 public interface NodeID 9 public interface NodeID
10 { 10 {
11 /** 11 /**
12 * 新しいNodeIDを作成します．新しいNodeIDは異なるUUIDを持ちます． 12 * 新しいNodeIDを作成します．新しいNodeIDは異なるFamilyを持ちます．
13 * @return 新しいUUIDを持つNodeID 13 * @return 新しいFamilyを持つNodeID
14 */ 14 */
15 public NodeID create(); 15 public NodeID create();
16 16
17 /** 17 /**
18 * このNodeIDが保持するUUIDを継承した，自分とバージョンの異なるNodeIDを生成します． 18 * このNodeIDが保持するFamilyを継承した，自分とバージョンの異なるNodeIDを生成します．
19 * @return UUIDを継承した新しいNodeID 19 * @return Familyを継承した新しいNodeID
20 */ 20 */
21 public NodeID update(); 21 public NodeID update();
22 22
23 /** 23 /**
24 * UUIDを取得します． 24 * Familyを取得します．
25 * @return NodeIDが保持しているUUID 25 * @return NodeIDが保持しているFamily
26 */ 26 */
27 public String getUUID(); 27 public String getFamilyID();
28 28
29 /** 29 /**
30 * このNodeIDのバージョンを取得します． 30 * このNodeIDのバージョンを取得します．
31 * @return NodeIDのバージョン 31 * @return NodeIDのバージョン
32 */ 32 */
33 public String getVersion(); 33 public String getVersion();
34 34
35 /** 35 /**
36 * このNodeIDが同一なUUIDを保持しているか比較します． 36 * このNodeIDが同一なFamilyを保持しているか比較します．
37 * @param _id 37 * @param _id
38 * @return 同一な場合はtrue，異なる場合はfalse 38 * @return 同一な場合はtrue，異なる場合はfalse
39 */ 39 */
40 public boolean isFamily(NodeID _id); 40 public boolean isFamily(NodeID _id);
41 41
42 /** 42 /**
43 * このNodeIDの文字列表現を返します． 43 * このNodeIDの文字列表現を返します．
44 * このメソッドを実装する際に，文字列の表現方法は<b>UUID＠Version</b>を採用してください． 44 * このメソッドを実装する際に，文字列の表現方法は<b>Family＠Version</b>を採用してください．
45 * @return 45 * @return
46 */ 46 */
47 public String toString(); 47 public String toString();
48 48
49 /** 49 /**