You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@tapestry.apache.org by bu...@apache.org on 2013/02/25 05:21:07 UTC
svn commit: r851833 - in /websites/production/tapestry/content:
cache/main.pageCache component-classes.html
Author: buildbot
Date: Mon Feb 25 04:21:06 2013
New Revision: 851833
Log:
Production update by buildbot for tapestry
Modified:
websites/production/tapestry/content/cache/main.pageCache
websites/production/tapestry/content/component-classes.html
Modified: websites/production/tapestry/content/cache/main.pageCache
==============================================================================
Binary files - no diff available.
Modified: websites/production/tapestry/content/component-classes.html
==============================================================================
--- websites/production/tapestry/content/component-classes.html (original)
+++ websites/production/tapestry/content/component-classes.html Mon Feb 25 04:21:06 2013
@@ -68,7 +68,7 @@
</td></tr><tr><td colspan="1" rowspan="1">
<span class="icon icon-page" title="Page">Page:</span>
- <a shape="rect" href="component-cheat-sheet.html">Component Cheat Sheet</a>
+ <a shape="rect" href="component-libraries.html">Component Libraries</a>
</td></tr><tr><td colspan="1" rowspan="1">
<span class="icon icon-page" title="Page">Page:</span>
@@ -76,7 +76,7 @@
</td></tr><tr><td colspan="1" rowspan="1">
<span class="icon icon-page" title="Page">Page:</span>
- <a shape="rect" href="component-libraries.html">Component Libraries</a>
+ <a shape="rect" href="component-cheat-sheet.html">Component Cheat Sheet</a>
</td></tr><tr><td colspan="1" rowspan="1">
<span class="icon icon-page" title="Page">Page:</span>
@@ -216,8 +216,7 @@
<p>Unless an instance variable is decorated with an annotation, it will be a <em>transient</em> instance variable. This means that its value resets to its default value at the end of reach request (when the <a shape="rect" href="page-life-cycle.html" title="Page Life Cycle">page is detached from the request</a>).</p>
-<div class="panelMacro"><table class="noteMacro"><colgroup span="1"><col span="1" width="24"><col span="1"></colgroup><tr><td colspan="1" rowspan="1" valign="top"><img align="middle" src="/images/confluence/warning.gif" width="16" height="16" alt="" border="0"></td><td colspan="1" rowspan="1"><b>About initialization</b><br clear="none">Never initialize an instance field to a mutable object at the point of declaration. If this is done, the instance created from that initializer becomes the default value for that field and is reused inside the component on every request. This could cause state to inadvertently be shared between different sessions in an application.</td></tr></table></div>
-
+<div class="panelMacro"><table class="noteMacro"><colgroup span="1"><col span="1" width="24"><col span="1"></colgroup><tr><td colspan="1" rowspan="1" valign="top"><img align="middle" src="/images/confluence/warning.gif" width="16" height="16" alt="" border="0"></td><td colspan="1" rowspan="1"><b>About initialization</b><br clear="none">Never initialize an instance field to a <em>mutable</em> object at the point of declaration. If this is done, the instance created from that initializer becomes the default value for that field and is reused inside the component on every request. This could cause state to inadvertently be shared between different sessions in an application.</td></tr></table></div>
@@ -235,11 +234,32 @@
<h2><a shape="rect" name="ComponentClasses-Injection"></a>Injection</h2>
-<p><a shape="rect" href="injection.html" title="Injection">Injection</a> of dependencies occurs at the field level, via additional annotations. At runtime, fields that contain injections become read-only.</p>
+<p>Main Article: <a shape="rect" href="injection.html" title="Injection">Injection</a></p>
+
+<p>Injection of dependencies occurs at the field level, via additional annotations. At runtime, fields that contain injections become read-only.</p>
+
+<div class="code panel" style="border-width: 1px;"><div class="codeContent panelContent">
+<pre class="code-java">
+@Inject <span class="code-comment">// inject a resource
+</span><span class="code-keyword">private</span> ComponentResources componentResources;
+
+@Inject <span class="code-comment">// inject a block
+</span><span class="code-keyword">private</span> Block foo;
+
+@Inject <span class="code-comment">// inject an asset
+</span>@Path(<span class="code-quote">"context:images/top_banner.png"</span>)
+<span class="code-keyword">private</span> Asset banner;
+
+@Inject <span class="code-comment">// inject a service
+</span><span class="code-keyword">private</span> AjaxResponseRenderer ajaxResponseRenderer;
+</pre>
+</div></div>
<h2><a shape="rect" name="ComponentClasses-Parameters"></a>Parameters</h2>
-<p><a shape="rect" href="component-parameters.html" title="Component Parameters">Component parameters</a> are also identified using private fields of your class, with the @<a shape="rect" class="external-link" href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/annotations/Parameter.html">Parameter</a> annotation.</p>
+<p>Main Article: <a shape="rect" href="component-parameters.html" title="Component Parameters">Component Parameters</a></p>
+
+<p>Component parameters are private fields of your component class annotated with @<a shape="rect" class="external-link" href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/annotations/Parameter.html">Parameter</a>. Component parameters represent a two-way binding of a field of your component and a property or resource of its containing component or page.</p>
<h2><a shape="rect" name="ComponentClasses-PersistentFields"></a>Persistent Fields</h2>