[04/50] brooklyn-server git commit: AbstractEntity: javadoc for creation order

[he...@apache.org]

AbstractEntity: javadoc for creation order


Project: http://git-wip-us.apache.org/repos/asf/brooklyn-server/repo
Commit: http://git-wip-us.apache.org/repos/asf/brooklyn-server/commit/6d6cae2b
Tree: http://git-wip-us.apache.org/repos/asf/brooklyn-server/tree/6d6cae2b
Diff: http://git-wip-us.apache.org/repos/asf/brooklyn-server/diff/6d6cae2b

Branch: refs/heads/0.5.0
Commit: 6d6cae2b3992755fb2c9435dda006f8d767de969
Parents: b2471c2
Author: Aled Sage <al...@gmail.com>
Authored: Thu Mar 28 10:50:27 2013 +0000
Committer: Aled Sage <al...@gmail.com>
Committed: Fri Mar 29 09:47:47 2013 +0000

----------------------------------------------------------------------
 .../java/brooklyn/entity/basic/AbstractEntity.groovy | 15 +++++++++------
 1 file changed, 9 insertions(+), 6 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/brooklyn-server/blob/6d6cae2b/core/src/main/java/brooklyn/entity/basic/AbstractEntity.groovy
----------------------------------------------------------------------
diff --git a/core/src/main/java/brooklyn/entity/basic/AbstractEntity.groovy b/core/src/main/java/brooklyn/entity/basic/AbstractEntity.groovy
index 7d1e51d..5f4117f 100644
--- a/core/src/main/java/brooklyn/entity/basic/AbstractEntity.groovy
+++ b/core/src/main/java/brooklyn/entity/basic/AbstractEntity.groovy
@@ -72,12 +72,15 @@ import com.google.common.collect.Maps
  * Sub-classes should have a no-argument constructor. When brooklyn creates an entity, it will:
  * <ol>
  *   <li>Construct the entity via the no-argument constructor
- *   <li>Set the managment context
- *   <li>Set the proxy, which should be used by everything else when referring to this entity
- *       (except for drivers/policies that are attached to the entity, which can be given a 
- *       reference to this entity itself).
- *   <li>Configure the entity, first via the "flags" map and then via configuration keys
- *   <li>Set  the parent
+ *   <li>Call {@link #setDisplayName(String)}
+ *   <li>Call {@link #setManagementContext(ManagementContextInternal)}
+ *   <li>Call {@link #setProxy(Entity)}; the proxy should be used by everything else when referring 
+ *       to this entity (except for drivers/policies that are attached to the entity, which can be  
+ *       given a reference to this entity itself).
+ *   <li>Call {@link #configure(Map)} and then {@link #setConfig(ConfigKey, Object)}
+ *   <li>Call {@link #postConstruct()}
+ *   <li>Call {@link #addPolicy()} (for any policies defined in the {@link EntitySpec})
+ *   <li>Call {@link #setParent(Entity)}, if a parent is specified in the {@link EntitySpec}
  * </ol>
  * <p>
  * The legacy (pre 0.5) mechanism for creating entities is for others to call the constructor directly.