Modified: websites/production/tapestry/content/general-questions.html
==============================================================================
--- websites/production/tapestry/content/general-questions.html (original)
+++ websites/production/tapestry/content/general-questions.html Thu Feb 20
18:18:15 2025
@@ -91,11 +91,11 @@
<!-- /// Content Start -->
<div id="content">
<div id="ConfluenceContent"><h1
id="GeneralQuestions-GeneralQuestions">General Questions</h1><h2
id="GeneralQuestions-Contents">Contents</h2><p><style
type="text/css">/*<![CDATA[*/
-div.rbtoc1739988864541 {padding: 0px;}
-div.rbtoc1739988864541 ul {margin-left: 0px;}
-div.rbtoc1739988864541 li {margin-left: 0px;padding-left: 0px;}
+div.rbtoc1740075264623 {padding: 0px;}
+div.rbtoc1740075264623 ul {margin-left: 0px;}
+div.rbtoc1740075264623 li {margin-left: 0px;padding-left: 0px;}
-/*]]>*/</style></p><div class="toc-macro rbtoc1739988864541">
+/*]]>*/</style></p><div class="toc-macro rbtoc1740075264623">
<ul class="toc-indentation"><li><a
href="#GeneralQuestions-HowdoIgetstartedwithTapestry?">How do I get started
with Tapestry?</a></li><li><a
href="#GeneralQuestions-WhydoesTapestryusePrototype(inversionsbefore5.4)?WhynotinsertfavoriteJavaScriptlibraryhere?">Why
does Tapestry use Prototype (in versions before 5.4)? Why not insert favorite
JavaScript library here?</a></li><li><a
href="#GeneralQuestions-WhydoesTapestryhaveitsownInversionofControlContainer?WhynotSpringorGuice?">Why
does Tapestry have its own Inversion of Control Container? Why not Spring or
Guice?</a></li><li><a
href="#GeneralQuestions-HowdoIupgradefromTapestry4toTapestry5?">How do I
upgrade from Tapestry 4 to Tapestry 5?</a></li><li><a
href="#GeneralQuestions-HowdoIupgradefromoneversionofTapestry5toanother?">How
do I upgrade from one version of Tapestry 5 to another?</a></li><li><a
href="#GeneralQuestions-WhyaretherebothRequestandHttpServletRequest?">Why are
there both Request and HttpServletRequest?</a></li></ul>
</div><h2 id="GeneralQuestions-HowdoIgetstartedwithTapestry?">How do I get
started with Tapestry?</h2><p class="confluence-link">The easiest way to get
started is to use <a class="external-link"
href="http://maven.apache.org";>Apache Maven</a> to create your initial project;
Maven can use an <em>archetype</em> (a kind of project template) to create a
bare-bones Tapestry application for you. See the <a
href="getting-started.html">Getting Started</a> page for more
details.</p><p>Even without Maven, Tapestry is quite easy to set up. You just
need to <a href="general-questions.html">download</a> the binaries and setup
your build to place them inside your WAR's WEB-INF/lib folder. The rest is just
some one-time <a href="configuration.html">configuration of the web.xml
deployment descriptor</a>.</p><h2
id="GeneralQuestions-WhydoesTapestryusePrototype(inversionsbefore5.4)?WhynotinsertfavoriteJavaScriptlibraryhere?">Why
does Tapestry use Prototype (in versions before 5.4)? Why not <em>i
nsert favorite JavaScript library here</em>?</h2><p>An important goal for
Tapestry is seamless DHTML and Ajax integration. To serve that goal, it was
important that the built in components be capable of Ajax operations, such as
dynamically re-rendering parts of the page. Because of that, it made sense to
bundle a well-known JavaScript library as part of Tapestry.</p><p>At the time
(this would be 2006-ish), Prototype and Scriptaculous were well known and well
documented, whereas jQuery was just getting started.</p><p>The intent has
always been to make this aspect of Tapestry pluggable. Tapestry 5.4 includes
the option of either Prototype or jQuery, and future versions of Tapestry will
likely remove Prototype as an option..</p><h2
id="GeneralQuestions-WhydoesTapestryhaveitsownInversionofControlContainer?WhynotSpringorGuice?">Why
does Tapestry have its own Inversion of Control Container? Why not Spring or
Guice?</h2><p>An Inversion of Control Container is <em>the</em> key piece of
Tape
stry's infrastructure. It is absolutely necessary to create software as
robust, performant and extensible as Tapestry.</p><p>Tapestry IoC includes a
number of features that distinguish itself from other
containers:</p><ul><li>Configured in code, not XML</li><li>Built-in extension
mechanism for services: configurations and contributions</li><li>Built-in
aspect oriented programming model (service decorations and advice)</li><li>Easy
modularization</li><li>Best-of-breed exception reporting</li></ul><p>Because
Tapestry is implemented on top of its IoC container, and because the container
makes it easy to extend or replace any service inside the container, it is
possible to make the small changes to Tapestry needed to customize it to any
project's needs.</p><p>In addition – and this is critical –
Tapestry allows 3rd party libraries to be built that fully participate in the
configurability of Tapestry itself. This means that such libraries can be
configured the same way T
apestry itself is configured, and such libraries can also configure Tapestry
itself. This <em>distributed configuration</em> requires an IOC container that
fully supports such configurability.</p><h2
id="GeneralQuestions-HowdoIupgradefromTapestry4toTapestry5?">How do I upgrade
from Tapestry 4 to Tapestry 5?</h2><p>There is no existing tool that supports
upgrading from Tapestry 4 to Tapestry 5; Tapestry 5 is a complete
rewrite.</p><p>Many of the basic concepts in Tapestry 4 are still present in
Tapestry 5, but refactored, improved, streamlined, and simplified. The basic
concept of pages, templates and components are largely the same. Other aspects,
such as server-side event handling, is markedly different.</p><p>Tapestry 5 is
designed so that it can live side-by-side in the same servlet as a Tapestry 4
app, without package namespace conflicts, sharing session data and common
resources such as images and CSS. This means that you can gradually migrate a
Tapestry 4 app to Tapestry 5 one
page (or one portion of the app) at a time.</p><h2
id="GeneralQuestions-HowdoIupgradefromoneversionofTapestry5toanother?">How do I
upgrade from one version of Tapestry 5 to another?</h2><p>Main Article: <a
href="how-to-upgrade.html">How to Upgrade</a>.</p><p>A lot of effort goes into
making an upgrade from one Tapestry 5 release to another go smoothly. In the
general case, it is just a matter of updating the version number in your Maven
<code>build.xml</code> or Gradle <code>build.gradle</code> file and executing
the appropriate commands (e.g., <code>gradle idea</code> or <code>mvn
eclipse:eclipse</code>) to bring your local workspace up to date with the
latest binaries.</p><p>After changing dependencies, you should always perform a
clean recompile of your application.</p><p>We make every effort to ensure
backwards-compatibility. Tapestry is mostly coded in terms of interfaces; those
interfaces are stable to a point: interfaces your code is expected to implement
are usually complet
ely frozen; interfaces your code is expected to invoke, such as the interfaces
to IoC services, are stable, but may have new methods added in a release;
existing methods are not changed.</p><p>In <em>rare</em> cases a choice is
necessary between fixing bugs (or adding essential functionality) and
maintaining complete backwards compatibility; in those cases, an incompatible
change may be introduced. These are always discussed in detail in the <a
href="release-notes.html">Release Notes</a> for the specific release. You
should always read the release notes before attempting an upgrade, and always
(really, <em>always</em>) be prepared to retest your application
afterwards.</p><p>Note that you should be careful any time you make use of
<strong>internal</strong> APIs (you can tell an API is internal by the package
name, <code>org.apache.tapestry5.internal). </code>Internal APIs may change
<em>at any time</em>; there's no guarantee of backwards compatibility. Please
always check on th
e documentation, or consult the user mailing list, to see if there's a stable,
public alternative. If you do make use of internal APIs, be sure to get a
discussion going so that your needs can be met in the future by a stable,
public API.</p><h2
id="GeneralQuestions-WhyaretherebothRequestandHttpServletRequest?"><span
style="color: rgb(83,145,38);">Why are there both Request and
HttpServletRequest?</span></h2><p>Tapestry's Request interface is <em>very</em>
close to the standard HttpServletRequest interface. It differs in a few ways,
omitting some unneeded methods, and adding a couple of new methods (such as
<code>isXHR()</code>), as well as changing how some existing methods operate.
For example, <code>getParameterNames()</code> returns a sorted List of Strings;
HttpServletRequest returns an Enumeration, which is a very dated
approach.</p><p>However, the stronger reason for Request (and the related
interfaces Response and Session) is to enable the support for Portlets at some
point
in the future. By writing code in terms of Tapestry's Request, and not
HttpServletRequest, you can be assured that the same code will operate in both
Servlet Tapestry and Portlet Tapestry.</p></div>
</div>
Modified: websites/production/tapestry/content/getting-started.html
==============================================================================
--- websites/production/tapestry/content/getting-started.html (original)
+++ websites/production/tapestry/content/getting-started.html Thu Feb 20
18:18:15 2025
@@ -90,7 +90,15 @@
<!-- /// Content Start -->
<div id="content">
- <div id="ConfluenceContent"><div class="aui-label"
style="float:right" title="Related Articles">
+ <div id="ConfluenceContent">
+
+<div class="adaptavist-psl-unlicensed-banner adaptavist-psl-warning
adaptavist-psl-js">
+ <b>This page contains macros or features from a plugin which requires a
valid license.</b>
+
+ <p>You will need to contact your administrator.</p>
+
+</div>
+<div class="aui-label" style="float:right" title="Related Articles">
Modified: websites/production/tapestry/content/hibernate-core-conf.html
==============================================================================
--- websites/production/tapestry/content/hibernate-core-conf.html (original)
+++ websites/production/tapestry/content/hibernate-core-conf.html Thu Feb 20
18:18:15 2025
@@ -90,7 +90,15 @@
<!-- /// Content Start -->
<div id="content">
- <div id="ConfluenceContent"><p><strong>Hibernate
Configuration</strong> is handled by the Tapestry Hibernate Core module. This
is done in a just-in-time manner, the first time a Hibernate Session is
required.</p><div class="aui-label" style="float:right" title="Related
Articles">
+ <div id="ConfluenceContent"><p><strong>Hibernate
Configuration</strong> is handled by the Tapestry Hibernate Core module. This
is done in a just-in-time manner, the first time a Hibernate Session is
required.</p>
+
+<div class="adaptavist-psl-unlicensed-banner adaptavist-psl-warning
adaptavist-psl-js">
+ <b>This page contains macros or features from a plugin which requires a
valid license.</b>
+
+ <p>You will need to contact your administrator.</p>
+
+</div>
+<div class="aui-label" style="float:right" title="Related Articles">
Modified: websites/production/tapestry/content/hibernate-core.html
==============================================================================
--- websites/production/tapestry/content/hibernate-core.html (original)
+++ websites/production/tapestry/content/hibernate-core.html Thu Feb 20
18:18:15 2025
@@ -90,7 +90,15 @@
<!-- /// Content Start -->
<div id="content">
- <div
id="ConfluenceContent"><p><strong>Hibernate-Core </strong>is a Tapestry module
that provides basic Hibernate support without dependencies on the Tapestry-core
(the web framework part of Tapestry).</p><div class="aui-label"
style="float:right" title="Related Articles">
+ <div
id="ConfluenceContent"><p><strong>Hibernate-Core </strong>is a Tapestry module
that provides basic Hibernate support without dependencies on the Tapestry-core
(the web framework part of Tapestry).</p>
+
+<div class="adaptavist-psl-unlicensed-banner adaptavist-psl-warning
adaptavist-psl-js">
+ <b>This page contains macros or features from a plugin which requires a
valid license.</b>
+
+ <p>You will need to contact your administrator.</p>
+
+</div>
+<div class="aui-label" style="float:right" title="Related Articles">
Modified: websites/production/tapestry/content/hibernate-support-faq.html
==============================================================================
--- websites/production/tapestry/content/hibernate-support-faq.html (original)
+++ websites/production/tapestry/content/hibernate-support-faq.html Thu Feb 20
18:18:15 2025
@@ -91,11 +91,11 @@
<!-- /// Content Start -->
<div id="content">
<div id="ConfluenceContent"><h1
id="HibernateSupportFAQ-HibernateSupport">Hibernate Support</h1><p>Main
article: <a href="hibernate.html">Hibernate</a></p><h2
id="HibernateSupportFAQ-Contents">Contents</h2><p><style
type="text/css">/*<![CDATA[*/
-div.rbtoc1739988978794 {padding: 0px;}
-div.rbtoc1739988978794 ul {margin-left: 0px;}
-div.rbtoc1739988978794 li {margin-left: 0px;padding-left: 0px;}
+div.rbtoc1740075379120 {padding: 0px;}
+div.rbtoc1740075379120 ul {margin-left: 0px;}
+div.rbtoc1740075379120 li {margin-left: 0px;padding-left: 0px;}
-/*]]>*/</style></p><div class="toc-macro rbtoc1739988978794">
+/*]]>*/</style></p><div class="toc-macro rbtoc1740075379120">
<ul class="toc-indentation"><li><a
href="#HibernateSupportFAQ-HowdoIgetHibernatetostartupupwhentheapplicationstartsup,ratherthanlazilywiththefirstrequestfortheapplication?">How
do I get Hibernate to startup up when the application starts up, rather than
lazily with the first request for the application?</a></li></ul>
</div><h2
id="HibernateSupportFAQ-HowdoIgetHibernatetostartupupwhentheapplicationstartsup,ratherthanlazilywiththefirstrequestfortheapplication?">How
do I get Hibernate to startup up when the application starts up, rather than
lazily with the first request for the application?</h2><p>This was a minor
problem in 5.0; by 5.1 it is just a matter of overriding the configuration
system <code>tapestry.hibernate-early-startup</code> to "true".</p></div>
</div>
Modified: websites/production/tapestry/content/hibernate-user-guide.html
==============================================================================
--- websites/production/tapestry/content/hibernate-user-guide.html (original)
+++ websites/production/tapestry/content/hibernate-user-guide.html Thu Feb 20
18:18:15 2025
@@ -90,7 +90,15 @@
<!-- /// Content Start -->
<div id="content">
- <div id="ConfluenceContent"><p><em>This page
describes functionality provided by the Tapestry-hibernate-core module, but the
descriptions apply equally to the Tapestry-jpa module.</em></p><div
class="aui-label" style="float:right" title="Related Articles">
+ <div id="ConfluenceContent"><p><em>This page
describes functionality provided by the Tapestry-hibernate-core module, but the
descriptions apply equally to the Tapestry-jpa module.</em></p>
+
+<div class="adaptavist-psl-unlicensed-banner adaptavist-psl-warning
adaptavist-psl-js">
+ <b>This page contains macros or features from a plugin which requires a
valid license.</b>
+
+ <p>You will need to contact your administrator.</p>
+
+</div>
+<div class="aui-label" style="float:right" title="Related Articles">
Modified: websites/production/tapestry/content/hibernate.html
==============================================================================
--- websites/production/tapestry/content/hibernate.html (original)
+++ websites/production/tapestry/content/hibernate.html Thu Feb 20 18:18:15 2025
@@ -90,7 +90,15 @@
<!-- /// Content Start -->
<div id="content">
- <div id="ConfluenceContent"><p>The
<strong>Tapestry-hibernate </strong>module provides out-of-the-box support for
using Hibernate 3 as the back end for normal CRUD style Tapestry
applications.</p><div class="aui-label" style="float:right" title="Related
Articles">
+ <div id="ConfluenceContent"><p>The
<strong>Tapestry-hibernate </strong>module provides out-of-the-box support for
using Hibernate 3 as the back end for normal CRUD style Tapestry
applications.</p>
+
+<div class="adaptavist-psl-unlicensed-banner adaptavist-psl-warning
adaptavist-psl-js">
+ <b>This page contains macros or features from a plugin which requires a
valid license.</b>
+
+ <p>You will need to contact your administrator.</p>
+
+</div>
+<div class="aui-label" style="float:right" title="Related Articles">
Modified: websites/production/tapestry/content/https.html
==============================================================================
--- websites/production/tapestry/content/https.html (original)
+++ websites/production/tapestry/content/https.html Thu Feb 20 18:18:15 2025
@@ -90,7 +90,15 @@
<!-- /// Content Start -->
<div id="content">
- <div id="ConfluenceContent"><div
class="confluence-information-macro confluence-information-macro-note"><span
class="aui-icon aui-icon-small aui-iconfont-warning
confluence-information-macro-icon"></span><div
class="confluence-information-macro-body"><p>This page describes Tapestry's
mechanism for automatically switching between HTTP and HTTPS URLs. With the <a
class="external-link" href="https://en.wikipedia.org/wiki/HTTPS";
rel="nofollow">recent trend</a> to have all web sites use HTTPS, you will
likely want to disable this behavior. To do so, set the <a
href="configuration.html">tapestry.secure-enabled</a> configuration symbol to
<em>false</em> (counter-intuitively).</p></div></div><p>By default, Tapestry
assumes your application will be primarily deployed as a standard web
application, using HTTP (not HTTPS) as the primary protocol.</p><div
class="aui-label" style="float:right; margin: 1em" title="Related Articles">
+ <div id="ConfluenceContent"><div
class="confluence-information-macro confluence-information-macro-note"><span
class="aui-icon aui-icon-small aui-iconfont-warning
confluence-information-macro-icon"></span><div
class="confluence-information-macro-body"><p>This page describes Tapestry's
mechanism for automatically switching between HTTP and HTTPS URLs. With the <a
class="external-link" href="https://en.wikipedia.org/wiki/HTTPS";
rel="nofollow">recent trend</a> to have all web sites use HTTPS, you will
likely want to disable this behavior. To do so, set the <a
href="configuration.html">tapestry.secure-enabled</a> configuration symbol to
<em>false</em> (counter-intuitively).</p></div></div><p>By default, Tapestry
assumes your application will be primarily deployed as a standard web
application, using HTTP (not HTTPS) as the primary protocol.</p>
+
+<div class="adaptavist-psl-unlicensed-banner adaptavist-psl-warning
adaptavist-psl-js">
+ <b>This page contains macros or features from a plugin which requires a
valid license.</b>
+
+ <p>You will need to contact your administrator.</p>
+
+</div>
+<div class="aui-label" style="float:right; margin: 1em" title="Related
Articles">
Modified: websites/production/tapestry/content/index.html
==============================================================================
--- websites/production/tapestry/content/index.html (original)
+++ websites/production/tapestry/content/index.html Thu Feb 20 18:18:15 2025
@@ -81,7 +81,15 @@
<!-- /// Content Start -->
<div id="content">
- <div id="ConfluenceContent"><p></p><div
class="row" id="top"><div class="col-md-8 home-banner"><p><span
class="confluence-embedded-file-wrapper confluence-embedded-manual-size"><img
class="confluence-embedded-image" draggable="false" height="250"
src="index.data/apache-tapestry-icontext-600.png"></span></p></div>
+ <div id="ConfluenceContent"><p></p><div
class="row" id="top">
+
+<div class="adaptavist-psl-unlicensed-banner adaptavist-psl-warning
adaptavist-psl-js">
+ <b>This page contains macros or features from a plugin which requires a
valid license.</b>
+
+ <p>You will need to contact your administrator.</p>
+
+</div>
+<div class="col-md-8 home-banner"><p><span
class="confluence-embedded-file-wrapper confluence-embedded-manual-size"><img
class="confluence-embedded-image" draggable="false" height="250"
src="index.data/apache-tapestry-icontext-600.png"></span></p></div>
<div class="col-md-4" style="padding: 0 2em 2em"><p>A component-oriented
framework for creating highly scalable web applications in Java.</p></div>
Modified: websites/production/tapestry/content/indexv2-old.html
==============================================================================
--- websites/production/tapestry/content/indexv2-old.html (original)
+++ websites/production/tapestry/content/indexv2-old.html Thu Feb 20 18:18:15
2025
@@ -90,7 +90,15 @@
<!-- /// Content Start -->
<div id="content">
- <div id="ConfluenceContent"><div
class="aui-message aui-message-error"><p class="title"><strong>Error rendering
macro 'html'</strong></p><p>Notify your Confluence administrator that "HTML for
Confluence" requires a valid license. Reason: EXPIRED</p></div>
+ <div id="ConfluenceContent"><div
class="aui-message aui-message-error"><p class="title"><strong>Error rendering
macro 'html'</strong></p><p>Notify your Confluence administrator that "HTML for
Confluence" requires a valid license. Reason: EXPIRED</p></div>
+
+<div class="adaptavist-psl-unlicensed-banner adaptavist-psl-warning
adaptavist-psl-js">
+ <b>This page contains macros or features from a plugin which requires a
valid license.</b>
+
+ <p>You will need to contact your administrator.</p>
+
+</div>
+
<style type="text/css" rel="preload">
.blogSurtitle { background: none repeat scroll 0 0 #569D2F; border: 2px
solid #DDDDDD; color: #FFFFFF; margin: 1px 1px 10px; padding:
3px;}a.blogDate { color: #FFFFFF; }a.blogHeading { color: #569D2F; font-size:
14px; }#col p { text-align : justify; font-size : 11px; line-height : 1.2
!important }
</style>
Modified: websites/production/tapestry/content/indexv2.html
==============================================================================
--- websites/production/tapestry/content/indexv2.html (original)
+++ websites/production/tapestry/content/indexv2.html Thu Feb 20 18:18:15 2025
@@ -81,7 +81,15 @@
<!-- /// Content Start -->
<div id="content">
- <div id="ConfluenceContent"><div
class="aui-message aui-message-error"><p class="title"><strong>Error rendering
macro 'html'</strong></p><p>Notify your Confluence administrator that "HTML for
Confluence" requires a valid license. Reason: EXPIRED</p></div>
+ <div id="ConfluenceContent"><div
class="aui-message aui-message-error"><p class="title"><strong>Error rendering
macro 'html'</strong></p><p>Notify your Confluence administrator that "HTML for
Confluence" requires a valid license. Reason: EXPIRED</p></div>
+
+<div class="adaptavist-psl-unlicensed-banner adaptavist-psl-warning
adaptavist-psl-js">
+ <b>This page contains macros or features from a plugin which requires a
valid license.</b>
+
+ <p>You will need to contact your administrator.</p>
+
+</div>
+
<style type="text/css" rel="preload">
a.blogDate { color: #FFFFFF; }a.blogHeading { color: #569D2F; font-size: 14px;
}#col p { text-align : justify; font-size : 11px; line-height : 1.2 !important }
</style>
Modified: websites/production/tapestry/content/injection-faq.html
==============================================================================
--- websites/production/tapestry/content/injection-faq.html (original)
+++ websites/production/tapestry/content/injection-faq.html Thu Feb 20 18:18:15
2025
@@ -91,11 +91,11 @@
<!-- /// Content Start -->
<div id="content">
<div id="ConfluenceContent"><h1
id="InjectionFAQ-Injection">Injection</h1><p>Main article:  <a
href="injection.html">Injection</a></p><h2
id="InjectionFAQ-Contents">Contents</h2><p><style type="text/css">/*<![CDATA[*/
-div.rbtoc1739988905144 {padding: 0px;}
-div.rbtoc1739988905144 ul {margin-left: 0px;}
-div.rbtoc1739988905144 li {margin-left: 0px;padding-left: 0px;}
+div.rbtoc1740075305360 {padding: 0px;}
+div.rbtoc1740075305360 ul {margin-left: 0px;}
+div.rbtoc1740075305360 li {margin-left: 0px;padding-left: 0px;}
-/*]]>*/</style></p><div class="toc-macro rbtoc1739988905144">
+/*]]>*/</style></p><div class="toc-macro rbtoc1740075305360">
<ul class="toc-indentation"><li><a
href="#InjectionFAQ-What'sthedifferencebetweenthe@Componentand@InjectComponentannotations?">What's
the difference between the @Component and @InjectComponent
annotations?</a></li><li><a
href="#InjectionFAQ-What'sthedifferencebetweenthe@InjectPageand@InjectContainerannotations?">What's
the difference between the @InjectPage and @InjectContainer
annotations?</a></li><li><a
href="#InjectionFAQ-IgetanexceptionbecauseIhavetwoserviceswiththesameinterface,howdoIhandlethis?">I
get an exception because I have two services with the same interface, how do I
handle this?</a></li><li><a
href="#InjectionFAQ-What'sthedifferencebetween@Injectand@Environmental?">What's
the difference between @Inject and @Environmental?</a></li><li><a
href="#InjectionFAQ-Butwait...IseeIusedthe@Injectannotationanditstillworked.Whatgives?">But
wait ... I see I used the @Inject annotation and it still worked. What
gives?</a></li><li><a href="#InjectionFAQ-Ok,butRequestisasingletonservi
ce,notanenvironmental,andIcaninjectthat.IsTapestryreallythreadsafe?">Ok, but
Request is a singleton service, not an environmental, and I can inject that. Is
Tapestry really thread safe?</a></li><li><a
href="#InjectionFAQ-Iuse@Injectonafieldtoinjectaservice,butthefieldisstillnull,whathappened?">I
use @Inject on a field to inject a service, but the field is still null, what
happened?</a></li></ul>
</div><h2
id="InjectionFAQ-What'sthedifferencebetweenthe@Componentand@InjectComponentannotations?">What's
the difference between the <code>@Component</code> and
<code>@InjectComponent</code> annotations?</h2><p>The <code>@Component</code>
annotation is used to define the <em>type</em> of component, and its parameter
bindings. When using <code>@Component</code>, the template must not define the
type, and any parameter bindings are merged in:</p><div class="code panel pdl"
style="border-width: 1px;"><div class="codeContent panelContent pdl">
<pre><code class="language-java"> <a t:id="home" class="nav">Back to
home</a>
Modified: websites/production/tapestry/content/injection-in-detail.html
==============================================================================
--- websites/production/tapestry/content/injection-in-detail.html (original)
+++ websites/production/tapestry/content/injection-in-detail.html Thu Feb 20
18:18:15 2025
@@ -90,7 +90,15 @@
<!-- /// Content Start -->
<div id="content">
- <div
id="ConfluenceContent"><p><strong>Injection</strong> in Tapestry IoC can be a
complicated subject for a number of reasons:</p><ul><li>Injection can occur in
many places: on fields, and on parameters to methods and constructors of
certain objects.</li><li>Parts of Injection are themselves defined in terms of
Tapestry IoC services, many of which are extensible.</li></ul><div
class="aui-label" style="float:right" title="Related Articles">
+ <div
id="ConfluenceContent"><p><strong>Injection</strong> in Tapestry IoC can be a
complicated subject for a number of reasons:</p><ul><li>Injection can occur in
many places: on fields, and on parameters to methods and constructors of
certain objects.</li><li>Parts of Injection are themselves defined in terms of
Tapestry IoC services, many of which are extensible.</li></ul>
+
+<div class="adaptavist-psl-unlicensed-banner adaptavist-psl-warning
adaptavist-psl-js">
+ <b>This page contains macros or features from a plugin which requires a
valid license.</b>
+
+ <p>You will need to contact your administrator.</p>
+
+</div>
+<div class="aui-label" style="float:right" title="Related Articles">
Modified: websites/production/tapestry/content/injection.html
==============================================================================
--- websites/production/tapestry/content/injection.html (original)
+++ websites/production/tapestry/content/injection.html Thu Feb 20 18:18:15 2025
@@ -90,7 +90,15 @@
<!-- /// Content Start -->
<div id="content">
- <div
id="ConfluenceContent"><p><strong>Injection</strong> is Tapestry's way of
making a dependency – such as a resource, asset, component, block or
service – available in a page, component, mixin or service class.</p><div
class="aui-label" style="float:right" title="Related Articles">
+ <div
id="ConfluenceContent"><p><strong>Injection</strong> is Tapestry's way of
making a dependency – such as a resource, asset, component, block or
service – available in a page, component, mixin or service class.</p>
+
+<div class="adaptavist-psl-unlicensed-banner adaptavist-psl-warning
adaptavist-psl-js">
+ <b>This page contains macros or features from a plugin which requires a
valid license.</b>
+
+ <p>You will need to contact your administrator.</p>
+
+</div>
+<div class="aui-label" style="float:right" title="Related Articles">
Modified: websites/production/tapestry/content/integrating-with-jpa.html
==============================================================================
--- websites/production/tapestry/content/integrating-with-jpa.html (original)
+++ websites/production/tapestry/content/integrating-with-jpa.html Thu Feb 20
18:18:15 2025
@@ -98,11 +98,11 @@
<div class="param-body"></div>
</div><p>Tapestry provides a built-in integration with the Java Persistence
API (JPA) through the <strong>Tapestry-jpa</strong> module. This module
supersedes the 3rd-party <a class="external-link"
href="http://www.tynamo.org/tapestry-jpa+guide/"; rel="nofollow">Tynamo JPA
module</a>.</p><p><strong>Contents</strong></p><p><style
type="text/css">/*<![CDATA[*/
-div.rbtoc1739988819956 {padding: 0px;}
-div.rbtoc1739988819956 ul {margin-left: 0px;}
-div.rbtoc1739988819956 li {margin-left: 0px;padding-left: 0px;}
+div.rbtoc1740075219993 {padding: 0px;}
+div.rbtoc1740075219993 ul {margin-left: 0px;}
+div.rbtoc1740075219993 li {margin-left: 0px;padding-left: 0px;}
-/*]]>*/</style></p><div class="toc-macro rbtoc1739988819956">
+/*]]>*/</style></p><div class="toc-macro rbtoc1740075219993">
<ul class="toc-indentation"><li><a
href="#IntegratingwithJPA-Downloading">Downloading</a>
<ul class="toc-indentation"><li><a
href="#IntegratingwithJPA-SelectingaJPAImplementation">Selecting a JPA
Implementation</a></li></ul>
</li><li><a href="#IntegratingwithJPA-ConfiguringJPA">Configuring JPA</a>
Modified:
websites/production/tapestry/content/integrating-with-spring-framework.html
==============================================================================
--- websites/production/tapestry/content/integrating-with-spring-framework.html
(original)
+++ websites/production/tapestry/content/integrating-with-spring-framework.html
Thu Feb 20 18:18:15 2025
@@ -90,7 +90,15 @@
<!-- /// Content Start -->
<div id="content">
- <div id="ConfluenceContent"><p>Tapestry easily
integrates with Spring Framework, allowing beans defined by Spring to be
injected into Tapestry IoC services, and into Tapestry components. In addition,
with Tapestry 5.2 and later, you can also go the other way, injecting Tapestry
services in Spring beans.</p><div class="aui-label" style="float:right"
title="Related Articles">
+ <div id="ConfluenceContent"><p>Tapestry easily
integrates with Spring Framework, allowing beans defined by Spring to be
injected into Tapestry IoC services, and into Tapestry components. In addition,
with Tapestry 5.2 and later, you can also go the other way, injecting Tapestry
services in Spring beans.</p>
+
+<div class="adaptavist-psl-unlicensed-banner adaptavist-psl-warning
adaptavist-psl-js">
+ <b>This page contains macros or features from a plugin which requires a
valid license.</b>
+
+ <p>You will need to contact your administrator.</p>
+
+</div>
+<div class="aui-label" style="float:right" title="Related Articles">
@@ -126,11 +134,11 @@
<p>For integrating Spring Security into your application, see <a
href="security.html">Security</a>.</p><p><strong>Contents</strong></p><p><style
type="text/css">/*<![CDATA[*/
-div.rbtoc1739988826073 {padding: 0px;}
-div.rbtoc1739988826073 ul {margin-left: 0px;}
-div.rbtoc1739988826073 li {margin-left: 0px;padding-left: 0px;}
+div.rbtoc1740075226117 {padding: 0px;}
+div.rbtoc1740075226117 ul {margin-left: 0px;}
+div.rbtoc1740075226117 li {margin-left: 0px;padding-left: 0px;}
-/*]]>*/</style></p><div class="toc-macro rbtoc1739988826073">
+/*]]>*/</style></p><div class="toc-macro rbtoc1740075226117">
<ul class="toc-indentation"><li>Related Articles</li></ul>
<ul><li><a href="#IntegratingwithSpringFramework-SpringVersion">Spring
Version</a></li><li><a href="#IntegratingwithSpringFramework-Usage">Usage</a>
<ul class="toc-indentation"><li><a
href="#IntegratingwithSpringFramework-Requireddependency">Required
dependency</a></li><li><a
href="#IntegratingwithSpringFramework-Updateyourweb.xmlfile">Update your
web.xml file</a></li><li><a
href="#IntegratingwithSpringFramework-AccessingtheSpringApplicationContext">Accessing
the Spring Application Context</a></li><li><a
href="#IntegratingwithSpringFramework-Injectingbeans">Injecting
beans</a></li><li><a
href="#IntegratingwithSpringFramework-InjectingTapestryservicesinSpringbeans">Injecting
Tapestry services in Spring beans</a></li></ul>
Modified: websites/production/tapestry/content/integration-testing.html
==============================================================================
--- websites/production/tapestry/content/integration-testing.html (original)
+++ websites/production/tapestry/content/integration-testing.html Thu Feb 20
18:18:15 2025
@@ -90,7 +90,15 @@
<!-- /// Content Start -->
<div id="content">
- <div id="ConfluenceContent"><p><strong>Integration
testing</strong> involves the testing of larger segments of your Tapestry
module or web application, typically including the user interface.</p><div
class="aui-label" style="float:right" title="Related Articles">
+ <div id="ConfluenceContent"><p><strong>Integration
testing</strong> involves the testing of larger segments of your Tapestry
module or web application, typically including the user interface.</p>
+
+<div class="adaptavist-psl-unlicensed-banner adaptavist-psl-warning
adaptavist-psl-js">
+ <b>This page contains macros or features from a plugin which requires a
valid license.</b>
+
+ <p>You will need to contact your administrator.</p>
+
+</div>
+<div class="aui-label" style="float:right" title="Related Articles">
Modified:
websites/production/tapestry/content/integration-with-existing-applications.html
==============================================================================
---
websites/production/tapestry/content/integration-with-existing-applications.html
(original)
+++
websites/production/tapestry/content/integration-with-existing-applications.html
Thu Feb 20 18:18:15 2025
@@ -91,11 +91,11 @@
<!-- /// Content Start -->
<div id="content">
<div id="ConfluenceContent"><h1
id="Integrationwithexistingapplications-Integrationwithexistingapplications">Integration
with existing applications</h1><h2
id="Integrationwithexistingapplications-Contents">Contents</h2><p><style
type="text/css">/*<![CDATA[*/
-div.rbtoc1739989012035 {padding: 0px;}
-div.rbtoc1739989012035 ul {margin-left: 0px;}
-div.rbtoc1739989012035 li {margin-left: 0px;padding-left: 0px;}
+div.rbtoc1740075412665 {padding: 0px;}
+div.rbtoc1740075412665 ul {margin-left: 0px;}
+div.rbtoc1740075412665 li {margin-left: 0px;padding-left: 0px;}
-/*]]>*/</style></p><div class="toc-macro rbtoc1739989012035">
+/*]]>*/</style></p><div class="toc-macro rbtoc1740075412665">
<ul class="toc-indentation"><li><a
href="#Integrationwithexistingapplications-HowdoImakeaformonaJSPsubmitintoTapestry?">How
do I make a form on a JSP submit into Tapestry?</a></li><li><a
href="#Integrationwithexistingapplications-HowdoIshareinformationbetweenaJSPapplicationandtheTapestryapplication?">How
do I share information between a JSP application and the Tapestry
application?</a></li><li><a
href="#Integrationwithexistingapplications-HowdoIputtheTapestryapplicationinsideafolder,toavoidconflicts?">How
do I put the Tapestry application inside a folder, to avoid
conflicts?</a></li></ul>
</div><p>You may have an existing JSP (or Struts, Spring MVC, etc.)
application that you want to migrate to Tapestry. It's quite common to do this
in stages, moving some functionality into Tapestry and leaving other parts,
initially, in the other system. <a href="request-processing-faq.html">You may
need to prevent Tapestry from handling certain requests</a>.</p><h2
id="Integrationwithexistingapplications-HowdoImakeaformonaJSPsubmitintoTapestry?">How
do I make a form on a JSP submit into Tapestry?</h2><p>Tapestry's Form
component does a lot of work while an HTML form is rendering to store all the
information needed to handle the form submission in a later request; this is
all very specific to Tapestry and the particular construction of your pages and
forms; it can't be reproduced from a JSP.</p><p>Fortunately, that isn't
necessary: you can have a standard HTML Form submit to a Tapestry page, you
just don't get to use all of Tapestry's built in conversion and validation
logic.</p><p>
All you need to know is how Tapestry converts page class names to page names
(that appear in the URL). It's basically a matter of stripping off the
<em>root-package</em>.<code>pages</code> prefix from the fully qualified class
name. So, for example, if you are building a login screen as a JSP, you might
want to have a Tapestry page to receive the user name and password. Let's
assume the Tapestry page class is
<code>com.example.myapp.pages.LoginForm</code>; the page name will be
<code>loginform (although, since </code><span>Tapestry is case
insensitive, LoginForm would work just as well)</span><span>, and the URL will
be </span><code>/loginform</code><span>.</span></p><div class="code panel pdl"
style="border-width: 1px;"><div class="codeHeader panelHeader pdl"
style="border-bottom-width: 1px;"><b>LoginForm.tml</b></div><div
class="codeContent panelContent pdl">
<pre><code class="language-xml"><form method="post" action="/loginform">
Modified: websites/production/tapestry/content/introduction.html
==============================================================================
--- websites/production/tapestry/content/introduction.html (original)
+++ websites/production/tapestry/content/introduction.html Thu Feb 20 18:18:15
2025
@@ -90,7 +90,15 @@
<!-- /// Content Start -->
<div id="content">
- <div id="ConfluenceContent"><div class="aui-label"
style="float:right" title="Related Articles">
+ <div id="ConfluenceContent">
+
+<div class="adaptavist-psl-unlicensed-banner adaptavist-psl-warning
adaptavist-psl-js">
+ <b>This page contains macros or features from a plugin which requires a
valid license.</b>
+
+ <p>You will need to contact your administrator.</p>
+
+</div>
+<div class="aui-label" style="float:right" title="Related Articles">
Modified: websites/production/tapestry/content/ioc-cookbook-patterns.html
==============================================================================
--- websites/production/tapestry/content/ioc-cookbook-patterns.html (original)
+++ websites/production/tapestry/content/ioc-cookbook-patterns.html Thu Feb 20
18:18:15 2025
@@ -90,7 +90,15 @@
<!-- /// Content Start -->
<div id="content">
- <div id="ConfluenceContent"><p>Tapestry IoC has
support for implementing several of the <a class="external-link"
href="http://en.wikipedia.org/wiki/Design_pattern_(computer_science)"
rel="nofollow">Gang Of Four Design Patterns</a>. In fact, the IoC container
itself is a pumped up version of the Factory pattern.</p><div class="aui-label"
style="float:right" title="Related Articles">
+ <div id="ConfluenceContent"><p>Tapestry IoC has
support for implementing several of the <a class="external-link"
href="http://en.wikipedia.org/wiki/Design_pattern_(computer_science)"
rel="nofollow">Gang Of Four Design Patterns</a>. In fact, the IoC container
itself is a pumped up version of the Factory pattern.</p>
+
+<div class="adaptavist-psl-unlicensed-banner adaptavist-psl-warning
adaptavist-psl-js">
+ <b>This page contains macros or features from a plugin which requires a
valid license.</b>
+
+ <p>You will need to contact your administrator.</p>
+
+</div>
+<div class="aui-label" style="float:right" title="Related Articles">
Modified: websites/production/tapestry/content/ioc-cookbook.html
==============================================================================
--- websites/production/tapestry/content/ioc-cookbook.html (original)
+++ websites/production/tapestry/content/ioc-cookbook.html Thu Feb 20 18:18:15
2025
@@ -90,7 +90,15 @@
<!-- /// Content Start -->
<div id="content">
- <div id="ConfluenceContent"><p>Tapestry
<strong>Inversion of Control</strong> (IoC), though originally designed
specifically for the needs of the Tapestry web framework, may also be employed
as a stand-alone IoC container, separate from the rest of Tapestry.</p><div
class="aui-label" style="float:right" title="Related Articles">
+ <div id="ConfluenceContent"><p>Tapestry
<strong>Inversion of Control</strong> (IoC), though originally designed
specifically for the needs of the Tapestry web framework, may also be employed
as a stand-alone IoC container, separate from the rest of Tapestry.</p>
+
+<div class="adaptavist-psl-unlicensed-banner adaptavist-psl-warning
adaptavist-psl-js">
+ <b>This page contains macros or features from a plugin which requires a
valid license.</b>
+
+ <p>You will need to contact your administrator.</p>
+
+</div>
+<div class="aui-label" style="float:right" title="Related Articles">
Modified: websites/production/tapestry/content/ioc.html
==============================================================================
--- websites/production/tapestry/content/ioc.html (original)
+++ websites/production/tapestry/content/ioc.html Thu Feb 20 18:18:15 2025
@@ -90,7 +90,15 @@
<!-- /// Content Start -->
<div id="content">
- <div id="ConfluenceContent"><p>Tapestry's
<strong>Inversion of Control</strong> container is a built-in Tapestry module
based on <a class="external-link"
href="http://www.martinfowler.com/articles/injection.html";
rel="nofollow">inversion of control</a> (IoC), a design approach that allows a
working system to be fabricated from many small, easily testable
pieces.</p><div class="aui-label" style="float:right" title="Related Articles">
+ <div id="ConfluenceContent"><p>Tapestry's
<strong>Inversion of Control</strong> container is a built-in Tapestry module
based on <a class="external-link"
href="http://www.martinfowler.com/articles/injection.html";
rel="nofollow">inversion of control</a> (IoC), a design approach that allows a
working system to be fabricated from many small, easily testable pieces.</p>
+
+<div class="adaptavist-psl-unlicensed-banner adaptavist-psl-warning
adaptavist-psl-js">
+ <b>This page contains macros or features from a plugin which requires a
valid license.</b>
+
+ <p>You will need to contact your administrator.</p>
+
+</div>
+<div class="aui-label" style="float:right" title="Related Articles">
Modified: websites/production/tapestry/content/javascript-faq.html
==============================================================================
--- websites/production/tapestry/content/javascript-faq.html (original)
+++ websites/production/tapestry/content/javascript-faq.html Thu Feb 20
18:18:15 2025
@@ -91,11 +91,11 @@
<!-- /// Content Start -->
<div id="content">
<div id="ConfluenceContent"><h1
id="JavaScriptFAQ-JavaScript">JavaScript</h1><p>Main articles: <a
href="client-side-javascript.html">Client-Side JavaScript</a>, <a
href="legacy-javascript.html">Legacy JavaScript</a></p><h2
id="JavaScriptFAQ-Contents">Contents</h2><p><style type="text/css">/*<![CDATA[*/
-div.rbtoc1739989013891 {padding: 0px;}
-div.rbtoc1739989013891 ul {margin-left: 0px;}
-div.rbtoc1739989013891 li {margin-left: 0px;padding-left: 0px;}
+div.rbtoc1740075414597 {padding: 0px;}
+div.rbtoc1740075414597 ul {margin-left: 0px;}
+div.rbtoc1740075414597 li {margin-left: 0px;padding-left: 0px;}
-/*]]>*/</style></p><div class="toc-macro rbtoc1739989013891">
+/*]]>*/</style></p><div class="toc-macro rbtoc1740075414597">
<ul class="toc-indentation"><li><a
href="#JavaScriptFAQ-WhydoIgeta"Tapestryisundefined"erroronformsubmit?(5.3andearlier)">Why
do I get a "Tapestry is undefined" error on form submit? (5.3 and
earlier)</a></li><li><a
href="#JavaScriptFAQ-What'sthedifferencebetweentheT5objectandtheTapestryobjectinthebrowser?(5.3andearlier)">What's
the difference between the T5 object and the Tapestry object in the browser?
(5.3 and earlier)</a></li></ul>
</div><h2
id="JavaScriptFAQ-WhydoIgeta"Tapestryisundefined"erroronformsubmit?(5.3andearlier)">Why
do I get a "Tapestry is undefined" error on form submit? (5.3 and
earlier)</h2><p>This client-side error is clear but can be awkward to solve. It
means your browser has not been able to load the tapestry.js file properly. The
question is, why? It can be due to multiple reasons, some of them
below:</p><ul><li>First, check if 'tapestry.js' is present in the head part of
your resulting HTML page.</li><li><p>If you have set the <a
href="configuration.html">tapestry.combine-scripts</a> configuration symbol to
true, Tapestry generates one single URL to retrieve all the JS files.
Sometimes, this can produce long URLs that browsers are unable to retrieve. Try
setting the symbol to false.</p><div class="confluence-information-macro
confluence-information-macro-note"><span class="aui-icon aui-icon-small
aui-iconfont-warning confluence-information-macro-icon"></span><div
class="confluenc
e-information-macro-body"><p>This only applies to Tapestry
5.1.</p></div></div></li><li>If you have included jQuery in conjunction with
Tapestry's prototype, that will cause a conflict with the '$' selector used by
both. In this case, you should put jQuery on top of the stack and turn on the
<a class="external-link" href="http://api.jquery.com/jQuery.noConflict/";
rel="nofollow">jQuery.noConflict</a> mode.</li><li>Also, if you have included a
custom or third-party JS library on top of the stack that causes the JavaScript
parsing to fail, then check the JavaScript syntax in that library.</li><li>If
you have used a tool to minimize your JavaScript libraries, this can lead to
JavaScript syntax errors, so check if it works with all the JavaScript files
unpacked.</li></ul><h2
id="JavaScriptFAQ-What'sthedifferencebetweentheT5objectandtheTapestryobjectinthebrowser?(5.3andearlier)">What's
the difference between the <code>T5</code> object and the
<code>Tapestry</code> object in the browser? (
5.3 and earlier)</h2><p>Both of these objects are <em>namespaces</em>:
containers of functions, constants, and nested namespaces.</p><p>The
<code>T5</code> object is a replacement for the <code>Tapestry</code> object,
starting in release 5.3. Increasingly, functions defined by the
<code>Tapestry</code> object are being replaced with similar or equivalent
functions in the <code>T5</code> object.</p><p>This is part of an overall goal,
spanning at least two releases of Tapestry, to make Tapestry JavaScript
framework agnostic; which is to say, not depend specifically on Prototype or
jQuery. Much of the code in the <code>Tapestry</code> object is specifically
linked to Prototype and Scriptaculous.</p><p>The <code>T5</code> object
represents a stable, documented, set of APIs that are preferred when building
components for maximum portability between underlying JavaScript frameworks. In
other words, when building component libraries, coding to the <code>T5</code>
object ensures that your c
omponent will be useful regardless of whether the final application is built
using Prototype, jQuery or something else.</p></div>
</div>
Modified: websites/production/tapestry/content/javascript-modules.html
==============================================================================
--- websites/production/tapestry/content/javascript-modules.html (original)
+++ websites/production/tapestry/content/javascript-modules.html Thu Feb 20
18:18:15 2025
@@ -90,7 +90,15 @@
<!-- /// Content Start -->
<div id="content">
- <div id="ConfluenceContent"><p><strong>JavaScript
Modules</strong> are a mechanism for bringing modern concepts of variable scope
and dependency management to JavaScript. <em>Starting with version 5.4</em>,
Tapestry uses <a class="external-link" href="http://requirejs.org/";
rel="nofollow">RequireJS</a> <a class="external-link"
href="https://github.com/amdjs/amdjs-api/blob/master/AMD.md";
rel="nofollow"> </a>modules internally, and provides support for using
RequireJS modules in your own Tapestry application.</p><div class="aui-label"
style="float:right" title="Related Articles">
+ <div id="ConfluenceContent"><p><strong>JavaScript
Modules</strong> are a mechanism for bringing modern concepts of variable scope
and dependency management to JavaScript. <em>Starting with version 5.4</em>,
Tapestry uses <a class="external-link" href="http://requirejs.org/";
rel="nofollow">RequireJS</a> <a class="external-link"
href="https://github.com/amdjs/amdjs-api/blob/master/AMD.md";
rel="nofollow"> </a>modules internally, and provides support for using
RequireJS modules in your own Tapestry application.</p>
+
+<div class="adaptavist-psl-unlicensed-banner adaptavist-psl-warning
adaptavist-psl-js">
+ <b>This page contains macros or features from a plugin which requires a
valid license.</b>
+
+ <p>You will need to contact your administrator.</p>
+
+</div>
+<div class="aui-label" style="float:right" title="Related Articles">
Modified: websites/production/tapestry/content/javascript-rewrite-in-54.html
==============================================================================
--- websites/production/tapestry/content/javascript-rewrite-in-54.html
(original)
+++ websites/production/tapestry/content/javascript-rewrite-in-54.html Thu Feb
20 18:18:15 2025
@@ -91,11 +91,11 @@
<!-- /// Content Start -->
<div id="content">
<div id="ConfluenceContent"><div
class="confluence-information-macro
confluence-information-macro-information"><span class="aui-icon aui-icon-small
aui-iconfont-info confluence-information-macro-icon"></span><div
class="confluence-information-macro-body"><p>This is a historical document in
which Tapestry's Howard Lewis Ship describes the motivations and plan for
significantly changing Tapestry's client-side functionality starting in
Tapestry 5.4. This plan closely matches the actual results delivered in
Tapestry 5.4, but this document is mostly kept for historical
reference.</p></div></div><h2
id="JavaScriptRewritein5.4-Contents">Contents</h2><p><style
type="text/css">/*<![CDATA[*/
-div.rbtoc1739988824023 {padding: 0px;}
-div.rbtoc1739988824023 ul {margin-left: 0px;}
-div.rbtoc1739988824023 li {margin-left: 0px;padding-left: 0px;}
+div.rbtoc1740075224038 {padding: 0px;}
+div.rbtoc1740075224038 ul {margin-left: 0px;}
+div.rbtoc1740075224038 li {margin-left: 0px;padding-left: 0px;}
-/*]]>*/</style></p><div class="toc-macro rbtoc1739988824023">
+/*]]>*/</style></p><div class="toc-macro rbtoc1740075224038">
<ul class="toc-indentation"><li><a
href="#JavaScriptRewritein5.4-TapestryandJavaScript">Tapestry and
JavaScript</a></li><li><a
href="#JavaScriptRewritein5.4-TapestryJavaScriptLimitations(through5.3)">Tapestry
JavaScript Limitations (through 5.3)</a>
<ul class="toc-indentation"><li><a
href="#JavaScriptRewritein5.4-DependenceonPrototype/Scriptaculous">Dependence
on Prototype/Scriptaculous</a></li><li><a
href="#JavaScriptRewritein5.4-LackofDocumentation">Lack of
Documentation</a></li><li><a
href="#JavaScriptRewritein5.4-LackofModuleStructure">Lack of Module
Structure</a></li><li><a
href="#JavaScriptRewritein5.4-ComplexInitialization">Complex
Initialization</a></li></ul>
</li><li><a
href="#JavaScriptRewritein5.4-JavaScriptImprovementsfor5.4">JavaScript
Improvements for 5.4</a>
Modified: websites/production/tapestry/content/key-features-v2.html
==============================================================================
--- websites/production/tapestry/content/key-features-v2.html (original)
+++ websites/production/tapestry/content/key-features-v2.html Thu Feb 20
18:18:15 2025
@@ -90,7 +90,15 @@
<!-- /// Content Start -->
<div id="content">
- <div id="ConfluenceContent"><div class="row"
id="features"><div class="col-sm-4"><h3 id="KeyFeaturesv2-JavaPower">Java
Power</h3><div class="feature relief"><p>Tapestry pages and components are
simple Java POJOs, with easy access to all Java language features and the vast
Java ecosystem. Thanks to Java's advanced concurrency API, Tapestry handles
requests <em>fast</em> without sacrificing security or stability.</p></div>
+ <div id="ConfluenceContent"><div class="row"
id="features"><div class="col-sm-4"><h3 id="KeyFeaturesv2-JavaPower">Java
Power</h3>
+
+<div class="adaptavist-psl-unlicensed-banner adaptavist-psl-warning
adaptavist-psl-js">
+ <b>This page contains macros or features from a plugin which requires a
valid license.</b>
+
+ <p>You will need to contact your administrator.</p>
+
+</div>
+<div class="feature relief"><p>Tapestry pages and components are simple Java
POJOs, with easy access to all Java language features and the vast Java
ecosystem. Thanks to Java's advanced concurrency API, Tapestry handles requests
<em>fast</em> without sacrificing security or stability.</p></div>
</div>
Modified: websites/production/tapestry/content/key-features.html
==============================================================================
--- websites/production/tapestry/content/key-features.html (original)
+++ websites/production/tapestry/content/key-features.html Thu Feb 20 18:18:15
2025
@@ -90,7 +90,15 @@
<!-- /// Content Start -->
<div id="content">
- <div id="ConfluenceContent"><div class="row"
id="features"><div class="col-sm-4"><h3 id="KeyFeatures-JavaPower">Java
Power</h3><div class="feature relief"><p>Tapestry pages and components are
simple Java POJOs, with easy access to all Java language features and the vast
Java ecosystem. Thanks to Java's advanced concurrency API, Tapestry handles
requests <em>fast</em> without sacrificing security or stability.</p></div>
+ <div id="ConfluenceContent"><div class="row"
id="features"><div class="col-sm-4"><h3 id="KeyFeatures-JavaPower">Java
Power</h3>
+
+<div class="adaptavist-psl-unlicensed-banner adaptavist-psl-warning
adaptavist-psl-js">
+ <b>This page contains macros or features from a plugin which requires a
valid license.</b>
+
+ <p>You will need to contact your administrator.</p>
+
+</div>
+<div class="feature relief"><p>Tapestry pages and components are simple Java
POJOs, with easy access to all Java language features and the vast Java
ecosystem. Thanks to Java's advanced concurrency API, Tapestry handles requests
<em>fast</em> without sacrificing security or stability.</p></div>
</div>
Modified: websites/production/tapestry/content/layout-component.html
==============================================================================
--- websites/production/tapestry/content/layout-component.html (original)
+++ websites/production/tapestry/content/layout-component.html Thu Feb 20
18:18:15 2025
@@ -90,7 +90,15 @@
<!-- /// Content Start -->
<div id="content">
- <div id="ConfluenceContent"><div class="aui-label"
style="float:right" title="Related Articles">
+ <div id="ConfluenceContent">
+
+<div class="adaptavist-psl-unlicensed-banner adaptavist-psl-warning
adaptavist-psl-js">
+ <b>This page contains macros or features from a plugin which requires a
valid license.</b>
+
+ <p>You will need to contact your administrator.</p>
+
+</div>
+<div class="aui-label" style="float:right" title="Related Articles">
Modified: websites/production/tapestry/content/legacy-javascript.html
==============================================================================
--- websites/production/tapestry/content/legacy-javascript.html (original)
+++ websites/production/tapestry/content/legacy-javascript.html Thu Feb 20
18:18:15 2025
@@ -90,7 +90,15 @@
<!-- /// Content Start -->
<div id="content">
- <div id="ConfluenceContent"><div
class="confluence-information-macro confluence-information-macro-warning"><p
class="title conf-macro-render">For Older Versions of Tapestry</p><span
class="aui-icon aui-icon-small aui-iconfont-error
confluence-information-macro-icon"></span><div
class="confluence-information-macro-body"><p class="confluence-link">This page
describes JavaScript usage in Tapestry versions up through 5.3.x. For version
5.4 and later, see <a href="client-side-javascript.html">Client-Side
JavaScript</a>.</p></div></div><p
class="confluence-link"><strong>JavaScript</strong> is a first-class concept in
Tapestry, and sophisticated JavaScript support is provided right out of the
box, including rich <a href="ajax-and-zones.html">Ajax and Zones</a>, download
optimization, client-side logging, and localization.</p><div class="aui-label"
style="float:right" title="Related Articles">
+ <div id="ConfluenceContent"><div
class="confluence-information-macro confluence-information-macro-warning"><p
class="title conf-macro-render">For Older Versions of Tapestry</p><span
class="aui-icon aui-icon-small aui-iconfont-error
confluence-information-macro-icon"></span><div
class="confluence-information-macro-body"><p class="confluence-link">This page
describes JavaScript usage in Tapestry versions up through 5.3.x. For version
5.4 and later, see <a href="client-side-javascript.html">Client-Side
JavaScript</a>.</p></div></div><p
class="confluence-link"><strong>JavaScript</strong> is a first-class concept in
Tapestry, and sophisticated JavaScript support is provided right out of the
box, including rich <a href="ajax-and-zones.html">Ajax and Zones</a>, download
optimization, client-side logging, and localization.</p>
+
+<div class="adaptavist-psl-unlicensed-banner adaptavist-psl-warning
adaptavist-psl-js">
+ <b>This page contains macros or features from a plugin which requires a
valid license.</b>
+
+ <p>You will need to contact your administrator.</p>
+
+</div>
+<div class="aui-label" style="float:right" title="Related Articles">
Modified: websites/production/tapestry/content/limitations.html
==============================================================================
--- websites/production/tapestry/content/limitations.html (original)
+++ websites/production/tapestry/content/limitations.html Thu Feb 20 18:18:15
2025
@@ -91,11 +91,11 @@
<!-- /// Content Start -->
<div id="content">
<div id="ConfluenceContent"><h1
id="Limitations-Limitations">Limitations</h1><h2
id="Limitations-Contents">Contents</h2><p><style type="text/css">/*<![CDATA[*/
-div.rbtoc1739988868312 {padding: 0px;}
-div.rbtoc1739988868312 ul {margin-left: 0px;}
-div.rbtoc1739988868312 li {margin-left: 0px;padding-left: 0px;}
+div.rbtoc1740075268511 {padding: 0px;}
+div.rbtoc1740075268511 ul {margin-left: 0px;}
+div.rbtoc1740075268511 li {margin-left: 0px;padding-left: 0px;}
-/*]]>*/</style></p><div class="toc-macro rbtoc1739988868312">
+/*]]>*/</style></p><div class="toc-macro rbtoc1740075268511">
<ul class="toc-indentation"><li><a
href="#Limitations-HowdoIaddnewcomponentstoanexistingpagedynamically?">How do I
add new components to an existing page dynamically?</a></li><li><a
href="#Limitations-Whydoesn'tmyserviceimplementationreloadwhenIchangeit?">Why
doesn't my service implementation reload when I change it?</a></li><li><a
href="#Limitations-HowdoIrunmultipleTapestryapplicationsinthesamewebapplication?">How
do I run multiple Tapestry applications in the same web
application?</a></li></ul>
</div><h2
id="Limitations-HowdoIaddnewcomponentstoanexistingpagedynamically?">How do I
add new components to an existing page dynamically?</h2><p>The short answer
here is: <strong>you don't</strong>. The long answer here is <strong>you don't
have to, to get the behavior you desire</strong>.</p><p>One of Tapestry basic
values is high scalability: this is expressed in a number of ways, reflecting
scalability concerns within a single server, and within a cluster of
servers.</p><p>Although you code Tapestry pages and components as if they were
ordinary POJOs (<span>Plain Old Java Objects -- Tapestry does not require you
to extend any base classes or implement any special interfaces)</span><span>,
as deployed by Tapestry they are closer to a traditional servlet: a single
instance of each page services requests from multiple threads. Behind the
scenes, Tapestry transforms you code, rewriting it on the
fly.</span></p><p>What this means is that <em>any</em> incoming request must be
handled
by a <em>single page instance</em>. Therefore, Tapestry enforces the concept
of <strong>static structure, dynamic behavior</strong>.</p><p>Tapestry provides
quite a number of ways to vary what content is rendered, well beyond simple
conditionals and loops. It is possible to "drag in" components from other pages
when rendering a page (other FAQs will expand on this concept). The point is,
that although a Tapestry page's structure is very rigid, the order in which the
components of the page render does not have to be top to bottom.</p><h2
id="Limitations-Whydoesn'tmyserviceimplementationreloadwhenIchangeit?">Why
doesn't my service implementation reload when I change it?</h2><p>Main article:
<a href="service-implementation-reloading.html">Service Implementation
Reloading</a></p><p>Live service reloading has some limitations:</p><ul><li>The
service must define a service interface.</li><li>The service implementation
must be on the file system (not inside a JAR).</li><li>The implementatio
n must be instantiated by Tapestry, not inside code (even code inside a module
class).</li><li>The service must use the default <a
href="limitations.html">scope</a> (reloading of perthread scopes is not
supported).</li></ul><p>Consider the following example module:</p><div
class="code panel pdl" style="border-width: 1px;"><div class="codeContent
panelContent pdl">
<pre><code class="language-java">public static void bind(ServiceBinder binder)
Modified: websites/production/tapestry/content/link-components-faq.html
==============================================================================
--- websites/production/tapestry/content/link-components-faq.html (original)
+++ websites/production/tapestry/content/link-components-faq.html Thu Feb 20
18:18:15 2025
@@ -91,11 +91,11 @@
<!-- /// Content Start -->
<div id="content">
<div id="ConfluenceContent"><h1
id="LinkComponentsFAQ-LinkComponents">Link Components</h1><p>Main Articles: <a
href="page-navigation.html">Page Navigation</a>, <a
href="component-parameters.html">Component Parameters</a></p><h2
id="LinkComponentsFAQ-Contents">Contents</h2><p><style
type="text/css">/*<![CDATA[*/
-div.rbtoc1739988832542 {padding: 0px;}
-div.rbtoc1739988832542 ul {margin-left: 0px;}
-div.rbtoc1739988832542 li {margin-left: 0px;padding-left: 0px;}
+div.rbtoc1740075232615 {padding: 0px;}
+div.rbtoc1740075232615 ul {margin-left: 0px;}
+div.rbtoc1740075232615 li {margin-left: 0px;padding-left: 0px;}
-/*]]>*/</style></p><div class="toc-macro rbtoc1739988832542">
+/*]]>*/</style></p><div class="toc-macro rbtoc1740075232615">
<ul class="toc-indentation"><li><a
href="#LinkComponentsFAQ-HowdoIaddqueryparameterstoaPageLinkorActionLink?">How
do I add query parameters to a PageLink or ActionLink?</a></li><li><a
href="#LinkComponentsFAQ-HowdoIcreateaLinkbacktothecurrentpagefromacomponent?">How
do I create a Link back to the current page from a component?</a></li></ul>
</div><h2
id="LinkComponentsFAQ-HowdoIaddqueryparameterstoaPageLinkorActionLink?">How do
I add query parameters to a PageLink or ActionLink?</h2><p>These components do
not have parameters to allow you to specify query parameters for the link; they
both allow you to specify a <em>context</em> (one or more values to encode into
the request path).</p><p>However, you can accomplish the same thing with a
little code and markup. For example, to create a link to another page and pass
a query parameter, you can replace your PageLink component with a standard
<code><a></code> tag:</p><div class="code panel pdl" style="border-width:
1px;"><div class="codeContent panelContent pdl">
<pre><code class="language-xml"><a href="${profilePageLink}">Display
Profile (w/ full details)</a>
Modified: websites/production/tapestry/content/localization.html
==============================================================================
--- websites/production/tapestry/content/localization.html (original)
+++ websites/production/tapestry/content/localization.html Thu Feb 20 18:18:15
2025
@@ -90,7 +90,15 @@
<!-- /// Content Start -->
<div id="content">
- <div
id="ConfluenceContent"><p></p><p><strong>Localization</strong> (aka L10n) is
all about getting the right text to the user, in the right language.</p><div
class="aui-label" style="float:right" title="Related Articles">
+ <div
id="ConfluenceContent"><p></p><p><strong>Localization</strong> (aka L10n) is
all about getting the right text to the user, in the right language.</p>
+
+<div class="adaptavist-psl-unlicensed-banner adaptavist-psl-warning
adaptavist-psl-js">
+ <b>This page contains macros or features from a plugin which requires a
valid license.</b>
+
+ <p>You will need to contact your administrator.</p>
+
+</div>
+<div class="aui-label" style="float:right" title="Related Articles">
Modified: websites/production/tapestry/content/logging-in-tapestry.html
==============================================================================
--- websites/production/tapestry/content/logging-in-tapestry.html (original)
+++ websites/production/tapestry/content/logging-in-tapestry.html Thu Feb 20
18:18:15 2025
@@ -90,7 +90,15 @@
<!-- /// Content Start -->
<div id="content">
- <div id="ConfluenceContent"><p><strong>Logging in
Tapestry</strong> is based on the <a class="external-link"
href="http://www.slf4j.org/"; rel="nofollow">Simple Logging Facade for Java
(SLF4J)</a>. You can think of SLF4J as a leaner, meaner replacement for <a
class="external-link"
href="http://commons.apache.org/logging/";>commons-logging</a>.</p><div
class="aui-label" style="float:right" title="Related Articles">
+ <div id="ConfluenceContent"><p><strong>Logging in
Tapestry</strong> is based on the <a class="external-link"
href="http://www.slf4j.org/"; rel="nofollow">Simple Logging Facade for Java
(SLF4J)</a>. You can think of SLF4J as a leaner, meaner replacement for <a
class="external-link"
href="http://commons.apache.org/logging/";>commons-logging</a>.</p>
+
+<div class="adaptavist-psl-unlicensed-banner adaptavist-psl-warning
adaptavist-psl-js">
+ <b>This page contains macros or features from a plugin which requires a
valid license.</b>
+
+ <p>You will need to contact your administrator.</p>
+
+</div>
+<div class="aui-label" style="float:right" title="Related Articles">
Modified: websites/production/tapestry/content/logging.html
==============================================================================
--- websites/production/tapestry/content/logging.html (original)
+++ websites/production/tapestry/content/logging.html Thu Feb 20 18:18:15 2025
@@ -90,7 +90,15 @@
<!-- /// Content Start -->
<div id="content">
- <div
id="ConfluenceContent"><p><strong>Logging</strong> involves the automatic
recording of progress as an application runs. Tapestry makes extensive use of
<a class="external-link" href="http://www.slf4j.org/"; rel="nofollow">SLF4J</a>
to log details about the creation and operation of your page and component
classes.</p><div class="aui-label" style="float:right" title="Related Articles">
+ <div
id="ConfluenceContent"><p><strong>Logging</strong> involves the automatic
recording of progress as an application runs. Tapestry makes extensive use of
<a class="external-link" href="http://www.slf4j.org/"; rel="nofollow">SLF4J</a>
to log details about the creation and operation of your page and component
classes.</p>
+
+<div class="adaptavist-psl-unlicensed-banner adaptavist-psl-warning
adaptavist-psl-js">
+ <b>This page contains macros or features from a plugin which requires a
valid license.</b>
+
+ <p>You will need to contact your administrator.</p>
+
+</div>
+<div class="aui-label" style="float:right" title="Related Articles">
Modified: websites/production/tapestry/content/maven-support-faq.html
==============================================================================
--- websites/production/tapestry/content/maven-support-faq.html (original)
+++ websites/production/tapestry/content/maven-support-faq.html Thu Feb 20
18:18:15 2025
@@ -91,11 +91,11 @@
<!-- /// Content Start -->
<div id="content">
<div id="ConfluenceContent"><h1
id="MavenSupportFAQ-MavenSupport">Maven Support</h1><h2
id="MavenSupportFAQ-Contents">Contents</h2><p><style
type="text/css">/*<![CDATA[*/
-div.rbtoc1739988981377 {padding: 0px;}
-div.rbtoc1739988981377 ul {margin-left: 0px;}
-div.rbtoc1739988981377 li {margin-left: 0px;padding-left: 0px;}
+div.rbtoc1740075381719 {padding: 0px;}
+div.rbtoc1740075381719 ul {margin-left: 0px;}
+div.rbtoc1740075381719 li {margin-left: 0px;padding-left: 0px;}
-/*]]>*/</style></p><div class="toc-macro rbtoc1739988981377">
+/*]]>*/</style></p><div class="toc-macro rbtoc1740075381719">
<ul class="toc-indentation"><li><a
href="#MavenSupportFAQ-WhydoMavenprojectnamesandotherdetailsshowupinmypages?">Why
do Maven project names and other details show up in my pages?</a></li></ul>
</div><h2
id="MavenSupportFAQ-WhydoMavenprojectnamesandotherdetailsshowupinmypages?">Why
do Maven project names and other details show up in my pages?</h2><p>Tapestry
and maven both use the same syntax for dynamic portions of files: the
<code>${...</code>} syntax. When Maven is copying resources from
<code>src/main/resources</code>, and when filtering is <em>enabled</em> (which
is not the default), then any expansions in <em>Tapestry templates</em> that
match against Maven project properties are substituted. If you look at the
deployed application you'll see that <code>${name</code>} is gone, replaced
with your project's name!</p><p>The solution is to update your
<code>pom.xml</code> and ignore any .tml files when copying and
filtering:</p><div class="code panel pdl" style="border-width: 1px;"><div
class="codeHeader panelHeader pdl" style="border-bottom-width: 1px;"><b>pom.xml
(partial)</b></div><div class="codeContent panelContent pdl">
<pre><code class="language-xml"> <resource>
Modified: websites/production/tapestry/content/news.html
==============================================================================
--- websites/production/tapestry/content/news.html (original)
+++ websites/production/tapestry/content/news.html Thu Feb 20 18:18:15 2025
@@ -90,7 +90,15 @@
<!-- /// Content Start -->
<div id="content">
- <div id="ConfluenceContent"><div
class="aui-message aui-message-error"><p class="title"><strong>Error rendering
macro 'html'</strong></p><p>Notify your Confluence administrator that "HTML for
Confluence" requires a valid license. Reason: EXPIRED</p></div><p> <strong>We
think you will love Tapestry!</strong> Give us 20 minutes and <strong><a
href="tapestry-tutorial.html">follow our tutorial</a></strong>.</p><div
class="aui-message aui-message-error"><p class="title"><strong>Error rendering
macro 'html'</strong></p><p>Notify your Confluence administrator that "HTML for
Confluence" requires a valid license. Reason: EXPIRED</p></div><div
class="aui-message aui-message-error"><p class="title"><strong>Error rendering
macro 'html'</strong></p><p>Notify your Confluence administrator that "HTML for
Confluence" requires a valid license. Reason: EXPIRED</p></div><h2
id="News-News">News <a
href="https://cwiki.apache.org/confluence/createrssfeed.action?types=blogpost&;
amp;spaces=TAPESTRY&title=Apache+Tapestry+News+RSS+Feed&labelString%3D&sort=created&maxResults=10&timeSpan=12&confirm=Create&showContent=true&showDiff=false"><span
class="confluence-embedded-file-wrapper"><img
class="confluence-embedded-image" draggable="false"
src="news.data/Feed-icon.gif"></span></a></h2><p>
+ <div id="ConfluenceContent">
+
+<div class="adaptavist-psl-unlicensed-banner adaptavist-psl-warning
adaptavist-psl-js">
+ <b>This page contains macros or features from a plugin which requires a
valid license.</b>
+
+ <p>You will need to contact your administrator.</p>
+
+</div>
+<div class="aui-message aui-message-error"><p class="title"><strong>Error
rendering macro 'html'</strong></p><p>Notify your Confluence administrator that
"HTML for Confluence" requires a valid license. Reason: EXPIRED</p></div><p>
<strong>We think you will love Tapestry!</strong> Give us 20 minutes and
<strong><a href="tapestry-tutorial.html">follow our
tutorial</a></strong>.</p><div class="aui-message aui-message-error"><p
class="title"><strong>Error rendering macro 'html'</strong></p><p>Notify your
Confluence administrator that "HTML for Confluence" requires a valid license.
Reason: EXPIRED</p></div><div class="aui-message aui-message-error"><p
class="title"><strong>Error rendering macro 'html'</strong></p><p>Notify your
Confluence administrator that "HTML for Confluence" requires a valid license.
Reason: EXPIRED</p></div><h2 id="News-News">News <a
href="https://cwiki.apache.org/confluence/createrssfeed.action?types=blogpost&spaces=TAPESTRY&title=Apache+Tapestry+News+RSS+F
eed&labelString%3D&sort=created&maxResults=10&timeSpan=12&confirm=Create&showContent=true&showDiff=false"><span
class="confluence-embedded-file-wrapper"><img
class="confluence-embedded-image" draggable="false"
src="news.data/Feed-icon.gif"></span></a></h2><p>
Modified: websites/production/tapestry/content/operation-tracker.html
==============================================================================
--- websites/production/tapestry/content/operation-tracker.html (original)
+++ websites/production/tapestry/content/operation-tracker.html Thu Feb 20
18:18:15 2025
@@ -90,7 +90,15 @@
<!-- /// Content Start -->
<div id="content">
- <div id="ConfluenceContent"><p>Have you ever hit
an error in some code and been faced with a giant stack trace, and no clue what
that means?  Us too. We wished there was a way for the exception to
describe the path to the error not (just) in terms of which methods called
which methods, but what <em>operations</em> triggered what other
operations. That's the OperationTracker.</p><p>The operation tracker is another
aspect of Tapestry's commitment to feedback.</p><div class="aui-label"
style="float:right" title="Related Articles">
+ <div id="ConfluenceContent"><p>Have you ever hit
an error in some code and been faced with a giant stack trace, and no clue what
that means?  Us too. We wished there was a way for the exception to
describe the path to the error not (just) in terms of which methods called
which methods, but what <em>operations</em> triggered what other
operations. That's the OperationTracker.</p><p>The operation tracker is another
aspect of Tapestry's commitment to feedback.</p>
+
+<div class="adaptavist-psl-unlicensed-banner adaptavist-psl-warning
adaptavist-psl-js">
+ <b>This page contains macros or features from a plugin which requires a
valid license.</b>
+
+ <p>You will need to contact your administrator.</p>
+
+</div>
+<div class="aui-label" style="float:right" title="Related Articles">
Modified:
websites/production/tapestry/content/overriding-exception-reporting.html
==============================================================================
--- websites/production/tapestry/content/overriding-exception-reporting.html
(original)
+++ websites/production/tapestry/content/overriding-exception-reporting.html
Thu Feb 20 18:18:15 2025
@@ -90,7 +90,15 @@
<!-- /// Content Start -->
<div id="content">
- <div id="ConfluenceContent"><p>One of Tapestry's
best features is its comprehensive exception reporting. The level of detail is
impressive and useful.</p><div class="aui-label" style="float:right"
title="Related Articles">
+ <div id="ConfluenceContent"><p>One of Tapestry's
best features is its comprehensive exception reporting. The level of detail is
impressive and useful.</p>
+
+<div class="adaptavist-psl-unlicensed-banner adaptavist-psl-warning
adaptavist-psl-js">
+ <b>This page contains macros or features from a plugin which requires a
valid license.</b>
+
+ <p>You will need to contact your administrator.</p>
+
+</div>
+<div class="aui-label" style="float:right" title="Related Articles">
Modified:
websites/production/tapestry/content/page-and-component-classes-faq.html
==============================================================================
--- websites/production/tapestry/content/page-and-component-classes-faq.html
(original)
+++ websites/production/tapestry/content/page-and-component-classes-faq.html
Thu Feb 20 18:18:15 2025
@@ -91,11 +91,11 @@
<!-- /// Content Start -->
<div id="content">
<div id="ConfluenceContent"><h1
id="PageAndComponentClassesFAQ-PageAndComponentClasses">Page And Component
Classes</h1><p>Main article: <a href="component-classes.html">Component
Classes</a></p><h2
id="PageAndComponentClassesFAQ-Contents">Contents</h2><p><style
type="text/css">/*<![CDATA[*/
-div.rbtoc1739988764691 {padding: 0px;}
-div.rbtoc1739988764691 ul {margin-left: 0px;}
-div.rbtoc1739988764691 li {margin-left: 0px;padding-left: 0px;}
+div.rbtoc1740075164425 {padding: 0px;}
+div.rbtoc1740075164425 ul {margin-left: 0px;}
+div.rbtoc1740075164425 li {margin-left: 0px;padding-left: 0px;}
-/*]]>*/</style></p><div class="toc-macro rbtoc1739988764691">
+/*]]>*/</style></p><div class="toc-macro rbtoc1740075164425">
<ul class="toc-indentation"><li><a
href="#PageAndComponentClassesFAQ-What'sthedifferencebetweenapageandacomponent?">What's
the difference between a page and a component?</a></li><li><a
href="#PageAndComponentClassesFAQ-HowdoIstoremypageclassesinadifferentpackage?">How
do I store my page classes in a different package?</a></li><li><a
href="#PageAndComponentClassesFAQ-Whydomyinstancevariableshavetobeprivate?">Why
do my instance variables have to be private?</a></li><li><a
href="#PageAndComponentClassesFAQ-Whydon'tmyinformalparametersshowupintherenderedmarkup?">Why
don't my informal parameters show up in the rendered markup?</a></li><li><a
href="#PageAndComponentClassesFAQ-WhydoIgetjava.lang.LinkageErrorwhenIinvokepublicmethodsofmypageclasses?">Why
do I get java.lang.LinkageError when I invoke public methods of my page
classes?</a></li><li><a
href="#PageAndComponentClassesFAQ-Whichisbetter,usingmagicmethodnames(i.e.,beginRender())orannotations(i.e.BeginRender)?">Which
is better, using
magic method names (i.e., beginRender()) or annotations (i.e.
BeginRender)?</a></li><li><a
href="#PageAndComponentClassesFAQ-WhydoIhavetoinjectapage?Whycan'tIjustcreateoneusingnew?">Why
do I have to inject a page? Why can't I just create one using
new?</a></li></ul>
</div><h2
id="PageAndComponentClassesFAQ-What'sthedifferencebetweenapageandacomponent?">What's
the difference between a page and a component?</h2><p>There's very little
difference between the two. Pages classes must be in the
<em>root-package</em>.<code>pages</code> package; components must be in the
<em>root-package</em>.<code>components</code>. Pages may provide event handlers
for certain page-specific events (such as activate and passivate). Components
may have parameters.</p><p>Other than that, they are more equal than they are
different. They may have templates or may render themselves in code (pages
usually have a template, components are more likely to render only in
code).</p><p>The major difference is that Tapestry page templates may be stored
in the web context directory, as if they were static files (they can't be
accessed from the client however; a specific rule prevents access to files with
the <code>.tml</code> extension).</p><div class="confluence-information-macro co
nfluence-information-macro-warning"><span class="aui-icon aui-icon-small
aui-iconfont-error confluence-information-macro-icon"></span><div
class="confluence-information-macro-body"><p>It is possible that this feature
may be removed in a later release. It is preferred that page templates be
stored on the classpath, like component templates.</p></div></div><h2
id="PageAndComponentClassesFAQ-HowdoIstoremypageclassesinadifferentpackage?">How
do I store my page classes in a different package?</h2><p>Tapestry is very
rigid here; you can't. Page classes must go in
<em>root-package</em>.<code>pages</code>, component classes in
<em>root-package</em>.<code>components</code>, etc.</p><p>You are allowed to
create sub-packages, to help organize your code better and more logically. For
example, you might have
<em>root-package</em>.<code>pages.account.ViewAccount</code>, which would have
the page name "account/viewaccount". (<span>Tapestry would also create an alias
"account/view", by stripping of
f the redundant "account" suffix. Either name is equally valid in your code,
and Tapestry will use the shorter name, "account/view" in
URLs.)</span></p><p>In addition, it is possible to define additional root
packages for the application:</p><div class="code panel pdl"
style="border-width: 1px;"><div class="codeContent panelContent pdl">
<pre><code class="language-java">public static void
contributeComponentClassResolver(Configuration<LibraryMapping>
configuration) {
@@ -130,13 +130,13 @@ public class DBImage
-<span class="gliffy-container" id="gliffy-container-23527573-863"
data-fullwidth="750" data-size="L" data-ceoid="23335008"
data-edit="${diagramEditLink.getLinkUrl()}"
data-full="${diagramZoomLink.getLinkUrl()}" data-filename="Class Loaders">
+<span class="gliffy-container" id="gliffy-container-23527573-7391"
data-fullwidth="750" data-size="L" data-ceoid="23335008"
data-edit="${diagramEditLink.getLinkUrl()}"
data-full="${diagramZoomLink.getLinkUrl()}" data-filename="Class Loaders">
- <map id="gliffy-map-23527573-2820" name="gliffy-map-23527573-2820"></map>
+ <map id="gliffy-map-23527573-7655" name="gliffy-map-23527573-7655"></map>
- <img class="gliffy-image" id="gliffy-image-23527573-863" width="750"
height="425" data-full-width="750" data-full-height="425"
src="https://cwiki.apache.org/confluence/download/attachments/23335008/Class%20Loaders.png?version=4&modificationDate=1283534469000&api=v2";
alt="Class Loaders" usemap="#gliffy-map-23527573-2820">
+ <img class="gliffy-image" id="gliffy-image-23527573-7391" width="750"
height="425" data-full-width="750" data-full-height="425"
src="https://cwiki.apache.org/confluence/download/attachments/23335008/Class%20Loaders.png?version=4&modificationDate=1283534469000&api=v2";
alt="Class Loaders" usemap="#gliffy-map-23527573-7655">
- <map class="gliffy-dynamic" id="gliffy-dynamic-map-23527573-863"
name="gliffy-dynamic-map-23527573-863"></map>
+ <map class="gliffy-dynamic" id="gliffy-dynamic-map-23527573-7391"
name="gliffy-dynamic-map-23527573-7391"></map>
</span>
</p><div class="aui-message shadowed closeable"><p class="title"><span
class="gliffy-aui-icon"></span>ERROR</p><p>Gliffy is unlicensed. Please
<strong><a
href="https://cwiki.apache.org/confluence/plugins/servlet/upm#manage/com.gliffy.integration.confluence";>install
a license</a></strong> to draw diagrams in your wiki.</p></div>
![https://cwiki.apache.org/confluence/download/attachments/23335008/Class%20Loaders.png?version=4&modificationDate=1283534469000&api=v2"](https://cwiki.apache.org/confluence/download/attachments/23335008/Class%20Loaders.png?version=4&modificationDate=1283534469000&api=v2"){kind=link}