summaryrefslogtreecommitdiff
path: root/src/main/java/com/c2kernel/collection
diff options
context:
space:
mode:
authorAndrew Branson <andrew.branson@cern.ch>2014-09-26 16:02:24 +0200
committerAndrew Branson <andrew.branson@cern.ch>2014-09-26 16:02:24 +0200
commit202041b7fb62b1075d23b2e6ab8a5366d71f1766 (patch)
tree88d1cd94f4e79f9298b66826ed078e5057cfb6ca /src/main/java/com/c2kernel/collection
parent6af4879ac29414287b0dc6b9150ab93c5cb78809 (diff)
Package documentation for collection, entity, entity.agent and
entity.transfer packages
Diffstat (limited to 'src/main/java/com/c2kernel/collection')
-rw-r--r--src/main/java/com/c2kernel/collection/package-info.java25
1 files changed, 25 insertions, 0 deletions
diff --git a/src/main/java/com/c2kernel/collection/package-info.java b/src/main/java/com/c2kernel/collection/package-info.java
new file mode 100644
index 0000000..34b7167
--- /dev/null
+++ b/src/main/java/com/c2kernel/collection/package-info.java
@@ -0,0 +1,25 @@
+/**
+ * Collections are Item local objects that reference other Items.
+ *
+ * <p>In parallel with the OO meta-model, Items can be linked to other Items in
+ * different ways. These links are modelled with Collections, which are local
+ * objects stored in an Item which reference a number of other Items in the same
+ * server. The Collections holds a CollectionMember, sometimes known as a slot,
+ * to reference each Item and store additional information about the link.
+ *
+ * <p>Features:
+ * <ul>
+ * <li><b>Typing<b> - Collections can restrict membership of based on type
+ * information derived from Item, Property and Collection descriptions. This
+ * restriction may be per-slot or apply to the whole Collection.
+ *
+ * <li><b>Fixed or flexible slots</b> - The CollectionMember objects of a
+ * Collection may be empty, individually typed, or created and removed as
+ * required, simulating either array, structures or lists.
+ *
+ * <li><b>Layout</b> - Collections can include a {@link GraphModel} to lay out
+ * its slots on a two-dimensional canvas, for modelling real world compositions.
+ * </ul>
+ */
+
+package com.c2kernel.collection; \ No newline at end of file