You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@brooklyn.apache.org by ge...@apache.org on 2017/04/21 08:27:14 UTC
[1/2] brooklyn-docs git commit: Java config docs: default-value
should be immutable
Repository: brooklyn-docs
Updated Branches:
refs/heads/master 2308dcae7 -> 677166b43
Java config docs: default-value should be immutable
Project: http://git-wip-us.apache.org/repos/asf/brooklyn-docs/repo
Commit: http://git-wip-us.apache.org/repos/asf/brooklyn-docs/commit/683a3ee1
Tree: http://git-wip-us.apache.org/repos/asf/brooklyn-docs/tree/683a3ee1
Diff: http://git-wip-us.apache.org/repos/asf/brooklyn-docs/diff/683a3ee1
Branch: refs/heads/master
Commit: 683a3ee1a792e9e80eb8359328cb388056cd85a0
Parents: 2308dca
Author: Aled Sage <al...@gmail.com>
Authored: Wed Apr 19 13:40:37 2017 +0100
Committer: Aled Sage <al...@gmail.com>
Committed: Wed Apr 19 13:45:32 2017 +0100
----------------------------------------------------------------------
guide/blueprints/java/common-usage.md | 4 ++++
1 file changed, 4 insertions(+)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/brooklyn-docs/blob/683a3ee1/guide/blueprints/java/common-usage.md
----------------------------------------------------------------------
diff --git a/guide/blueprints/java/common-usage.md b/guide/blueprints/java/common-usage.md
index ccafd9b..2c9d91b 100644
--- a/guide/blueprints/java/common-usage.md
+++ b/guide/blueprints/java/common-usage.md
@@ -39,6 +39,10 @@ public static final ConfigKey<String> ROOT_WAR = new ConfigKeys.newStringConfigK
"WAR file to deploy as the ROOT, as URL (supporting file: and classpath: prefixes)");
{% endhighlight %}
+If supplying a default value, it is important that this be immutable. Otherwise, it risks users
+of the blueprint modifying the default value, which would affect blueprints that are subsequently
+deployed.
+
One can optionally define a `@SetFromFlag("war")`. This defines a short-hand for configuring the
entity. However, it should be used with caution - when using configuration set on a parent entity
(and thus inherited), the `@SetFromFlag` short-form names are not checked. The long form defined
[2/2] brooklyn-docs git commit: Closes #172
Posted by ge...@apache.org.
Closes #172
Java config docs: default-value should be immutable
Project: http://git-wip-us.apache.org/repos/asf/brooklyn-docs/repo
Commit: http://git-wip-us.apache.org/repos/asf/brooklyn-docs/commit/677166b4
Tree: http://git-wip-us.apache.org/repos/asf/brooklyn-docs/tree/677166b4
Diff: http://git-wip-us.apache.org/repos/asf/brooklyn-docs/diff/677166b4
Branch: refs/heads/master
Commit: 677166b4327d7d612b3e9c35bf163f3dc56ad19f
Parents: 2308dca 683a3ee
Author: Geoff Macartney <ge...@cloudsoftcorp.com>
Authored: Fri Apr 21 09:27:01 2017 +0100
Committer: Geoff Macartney <ge...@cloudsoftcorp.com>
Committed: Fri Apr 21 09:27:01 2017 +0100
----------------------------------------------------------------------
guide/blueprints/java/common-usage.md | 4 ++++
1 file changed, 4 insertions(+)
----------------------------------------------------------------------