Improve the javadoc of Component#onBeforeRender
Project: http://git-wip-us.apache.org/repos/asf/wicket/repo Commit: http://git-wip-us.apache.org/repos/asf/wicket/commit/dc5fe234 Tree: http://git-wip-us.apache.org/repos/asf/wicket/tree/dc5fe234 Diff: http://git-wip-us.apache.org/repos/asf/wicket/diff/dc5fe234 Branch: refs/heads/sandbox/WICKET-4686 Commit: dc5fe23447f2e6583fff43c3320f6c3ffbcf499b Parents: 5fb0c84 Author: Martin Tzvetanov Grigorov <[email protected]> Authored: Tue Dec 17 11:53:12 2013 +0200 Committer: Martin Tzvetanov Grigorov <[email protected]> Committed: Tue Dec 17 11:53:12 2013 +0200 ---------------------------------------------------------------------- wicket-core/src/main/java/org/apache/wicket/Component.java | 7 ++++++- 1 file changed, 6 insertions(+), 1 deletion(-) ---------------------------------------------------------------------- http://git-wip-us.apache.org/repos/asf/wicket/blob/dc5fe234/wicket-core/src/main/java/org/apache/wicket/Component.java ---------------------------------------------------------------------- diff --git a/wicket-core/src/main/java/org/apache/wicket/Component.java b/wicket-core/src/main/java/org/apache/wicket/Component.java index cc1a69c..62f1eba 100644 --- a/wicket-core/src/main/java/org/apache/wicket/Component.java +++ b/wicket-core/src/main/java/org/apache/wicket/Component.java @@ -3856,7 +3856,7 @@ public abstract class Component } /** - * Called just before a component is rendered. + * Called just before a component is rendered only if the component is visible. * <p> * <strong>NOTE</strong>: If you override this, you *must* call super.onBeforeRender() within * your implementation. @@ -3864,6 +3864,11 @@ public abstract class Component * Because this method is responsible for cascading {@link #onBeforeRender()} call to its * children it is strongly recommended that super call is made at the end of the override. * </p> + * + * Changes to the component tree can be made only <strong>before</strong> calling + * super.onBeforeRender(). + * + * @see org.apache.wicket.MarkupContainer#addOrReplace(Component...) */ protected void onBeforeRender() {
