Menu
Home
People
Places
Arts
History
Plants & Animals
Science
Life & Culture
Technology
Reference.org
Apache Tapestry
open-in-new
<h2 id="notable-features">Notable features</h2> Live Class Reloading Tapestry monitors the file system for changes to Java page classes, component classes, service implementation classes, HTML templates and component property files, and it hot-swaps the changes into the running application without requiring a restart. This provides a very short code-save-view feedback cycle that is claimed to greatly improve developer productivity.<a class="footnote-ref" id="fnref:5" href="#fn:5"><sup>5</sup></a> Component-based Pages may be constructed with small nestable components, each having a template and a component class. Custom components are purportedly trivial to construct.<a class="footnote-ref" id="fnref:6" href="#fn:6"><sup>6</sup></a> Convention over configuration Tapestry uses naming conventions and annotations, rather than XML, to configure the application.<a class="footnote-ref" id="fnref:7" href="#fn:7"><sup>7</sup></a> Spare use of HTTPSession By making minimal use of the HTTPSession, Tapestry is designed to be highly efficient in a clustered, session-replicated environment.<a class="footnote-ref" id="fnref:8" href="#fn:8"><sup>8</sup></a> Post/Redirect/Get Most form submissions follow the <a href="/facts/Post/Redirect/Get/aSEDfnXo">Post/Redirect/Get</a> (PRG) pattern, which reduces multiple form submission accidents and makes URLs friendlier and more bookmarkable, along with enabling the browser Back and Refresh buttons to operate normally.<a class="footnote-ref" id="fnref:9" href="#fn:9"><sup>9</sup></a> Inversion of Control (IoC) Tapestry is built on a lightweight <a href="/facts/Inversion_of_Control/CYWDbFlM">Inversion of Control</a> layer with similarities to <a href="/facts/Google_Guice/EylWYzPT">Google Guice</a>, but designed to make nearly all aspects of Tapestry's behavior configurable and replaceable.<a class="footnote-ref" id="fnref:10" href="#fn:10"><sup>10</sup></a> <h2 id="hello-world-example">Hello World Example</h2> <p>A minimal, templated Tapestry application needs only three files: </p> HelloWorld.tml The (X)HTML template for the /helloworld page. Tapestry templates can contain any well-formed (X)HTML markup. <!DOCTYPE html> <html xmlns="http://www.w3.org/1999/xhtml" xmlns:t="http://tapestry.apache.org/schema/tapestry_5_3.xsd"> <body> <p>Hello, ${username}</p> </body> </html> HelloWorld.java The page class associated with the template. Here, it merely provides a *username* property that the template can access. package org.example.demo.pages; /** A page class (automatically associated with the template file of the same name) */ public class HelloWorld { /** An ordinary getter */ public String getUsername() { return "World"; } } web.xml The <a href="/facts/Java_servlet/hf5LQVq1">servlet</a> application <a href="/facts/Deployment_Descriptor/5MLqnV8N">Deployment Descriptor</a>, which installs Tapestry as a servlet filter. <?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE web-app PUBLIC "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN" "http://java.sun.com/dtd/web-app_2_3.dtd"> <web-app> <display-name>Tapestry Example</display-name> <context-param> <!-- Tell Tapestry 5 where to look for pages, components and mixins --> <param-name>tapestry.app-package</param-name> <param-value>org.example.demo</param-value> </context-param> <filter> <!-- Define the Tapestry servlet filter --> <filter-name>app</filter-name> <filter-class>org.apache.tapestry5.TapestryFilter</filter-class> </filter> <filter-mapping> <!-- Tell the servlet container which requests to send to the Tapestry servlet filter --> <filter-name>app</filter-name> <url-pattern>/*</url-pattern> </filter-mapping> </web-app> <h2 id="class-transformation">Class transformation</h2> <p>Tapestry uses bytecode manipulation to transform page and component classes at runtime. This approach allows the page and component classes to be written as simple <a href="/facts/Plain_Old_Java_Object/sTUnd6MN">POJOs</a>, with a few naming conventions and annotations potentially triggering substantial additional behavior at class load time. Tapestry versions 5.0, 5.1 and 5.2 used the Javassist bytecode manipulation library. Subsequent versions replaced Javassist with a new bytecode manipulation layer called <i>Plastic</i> that is based on <a href="/facts/ObjectWeb_ASM/9BDbkYlH">ObjectWeb ASM</a>.<a class="footnote-ref" id="fnref:11" href="#fn:11"><sup>11</sup></a><a class="footnote-ref" id="fnref:12" href="#fn:12"><sup>12</sup></a> </p> <h2 id="client-side-support">Client-side support</h2> <p>Tapestry 5 versions up through 5.3 bundled the <a href="/facts/Prototype_JavaScript_Framework/qnWQsVeo">Prototype</a> and <a href="/facts/Script.aculo.us/FEPX3QAz">script.aculo.us</a> JavaScript frameworks, along with a Tapestry-specific library, so as to support Ajax operations as first-class citizens. Third party modules are available to integrate jQuery instead of, or in addition to, Prototype/Scriptaculous. </p><p>Starting with version 5.4, Tapestry includes a new JavaScript layer that removes built-in components' reliance on Prototype, allowing jQuery or another JavaScript framework to be plugged in.<a class="footnote-ref" id="fnref:13" href="#fn:13"><sup>13</sup></a> </p><p>Version 5.4 also introduces support for JavaScript <i>modules</i> using the RequireJS module loading system. </p> <h2 id="core-principles">Core principles</h2> <p>The Tapestry project documentation cites four "principles" that govern all development decisions for Tapestry, starting with version 5 in 2008:<a class="footnote-ref" id="fnref:14" href="#fn:14"><sup>14</sup></a> </p> <ul><li>Static Structure, Dynamic Behavior—page and component structure is essentially static, eliminating the need to construct (and store in session memory) large page and component trees.</li> <li>Adaptive API—the framework is designed to adapt to the code, rather than having the code adapt to the framework</li> <li>Differentiate Public vs. Internal APIs—all APIs are explicitly "internal" (private) except those that are necessarily public.</li> <li>Ensure Backwards Compatibility—The Tapestry developers are reportedly committed to ensuring that upgrading to the latest version of Tapestry is always easy.</li></ul> <h2 id="criticism">Criticism</h2> <p>Tapestry has been criticized as not being backward-compatible across major versions, especially noted in the transition from version 4 to version 5, where no clean migration path was available for existing applications.<a class="footnote-ref" id="fnref:15" href="#fn:15"><sup>15</sup></a> Project team members have acknowledged this as a major problem for Tapestry's users in the past, and backward compatibility was made a major design goal for Tapestry going forward. From early on in the development of version 5, backward compatibility was listed as one of Tapestry's four new "Core Principles", and two of the other three were intended to make the evolution of the framework possible without sacrificing backward compatibility. Project team members claim that all Tapestry releases since 5.0 have been highly backward compatible. </p><p>Early criticisms of Tapestry 5 also mentioned documentation as a shortcoming. Project members now claim that this deficiency has been largely addressed with a thoroughly revised and updated User's Guide and other documentation. </p><p>Since version 5.0, Tapestry has bundled the Prototype and Scriptaculous JavaScript libraries. According to Howard Lewis Ship, in the 2008-2009 timeframe these were reasonable choices. Since then, however, Prototype's popularity has declined, and jQuery's has risen dramatically. In response, the Tapestry community developed modules that allowed jQuery to be used in addition to, or instead of, Prototype. Meanwhile, the current version of Tapestry, 5.4, removes the dependency on Prototype entirely, replacing it with a compatibility layer into which either jQuery or Prototype (or potentially any other JavaScript framework) can be plugged. </p> <h2 id="relation-to-other-frameworks">Relation to other frameworks</h2> <p>According to Howard Lewis Ship, Tapestry was initially conceived as an attempt to implement in Java some of the general concepts and approaches found in WebObjects, which was at that time written in <a href="/facts/Objective-C/5mM557BW">Objective-C</a> and closed-source.<a class="footnote-ref" id="fnref:16" href="#fn:16"><sup>16</sup></a> </p><p><a href="/facts/Apache_Wicket/CMYwKWwh">Apache Wicket</a> was developed as a response to the complexity of early versions of Tapestry, according to Wicket originator Jonathan Locke.<a class="footnote-ref" id="fnref:17" href="#fn:17"><sup>17</sup></a> </p><p><a href="/facts/Facelets/GSPHKLHM">Facelets</a>, the default view technology in <a href="/facts/JavaServer_Faces/1QhmoE1A">JavaServer Faces</a>, was reportedly inspired by early versions of Tapestry, as an attempt to fill the need for "a framework like Tapestry, backed by JavaServer Faces as the industry standard".<a class="footnote-ref" id="fnref:18" href="#fn:18"><sup>18</sup></a><a class="footnote-ref" id="fnref:19" href="#fn:19"><sup>19</sup></a> </p> <h2 id="history">History</h2> <table><tbody><tr><th>Version</th><th>Date</th><th>Description</th></tr><tr><td>Old version, not maintained: 1.0</td><td>2000</td><td>Developed by Howard Lewis Ship for internal use</td></tr><tr><td>Old version, not maintained: 2.0</td><td>2002-04</td><td>First made available on <a href="/facts/SourceForge/lxYAgUAX">SourceForge</a> under the <a href="/facts/GNU_Lesser_General_Public_License/AXwkz9x3">GNU Lesser General Public License</a>.<a class="footnote-ref" id="fnref:20" href="#fn:20"><sup>20</sup></a></td></tr><tr><td>Old version, not maintained: 3.0</td><td>2004-04</td><td>The first release under Apache, as a Jakarta sub-project.<a class="footnote-ref" id="fnref:21" href="#fn:21"><sup>21</sup></a></td></tr><tr><td>Old version, not maintained: 4.0</td><td>2006-01</td><td>Introduced support for JDK 1.5 annotations, a new input validation subsystem, and improved error reporting <a class="footnote-ref" id="fnref:22" href="#fn:22"><sup>22</sup></a></td></tr><tr><td>Old version, still maintained: 5.0</td><td>2008-12</td><td>A nearly complete rewrite from Tapestry 4, introducing a new POJO-based component model emphasizing convention over configuration, and replaced Hivemind with a new no-XML Inversion of Control layer.</td></tr><tr><td>Old version, still maintained: 5.1</td><td>2009-04</td><td>Performance and memory improvements, automatic GZIP compression, JavaScript aggregation, but remained backwards compatible to Tapestry 5.0.</td></tr><tr><td>Old version, still maintained: 5.2</td><td>2010-12</td><td>Added <a href="/facts/Bean_Validation/b8WaksL3">JSR 303 Bean Validation</a>.<a class="footnote-ref" id="fnref:23" href="#fn:23"><sup>23</sup></a> Extended live class reloading to service implementations. Removed page pooling.<a class="footnote-ref" id="fnref:24" href="#fn:24"><sup>24</sup></a></td></tr><tr><td>Old version, still maintained: 5.3</td><td>2011-11</td><td>Added support for HTML5 doctype, JSR-330 annotations for injection,<a class="footnote-ref" id="fnref:25" href="#fn:25"><sup>25</sup></a> performance and memory improvements, new components, switched from JavaAssist to ASM bytecode manipulation</td></tr><tr><td>Old version, still maintained: 5.3.1 - 5.3.8</td><td>2012-2014</td><td>Bug fixes and minor enhancements</td></tr><tr><td>Latest version: 5.4-5.4.5</td><td>2015-2019</td><td>Major client-side enhancements. New JavaScript layer for switchable jQuery/Prototype support, uses Require.js for its JavaScript module system, <a href="/facts/Twitter_Bootstrap/3m5HALpd">Twitter Bootstrap</a> for its default styling.<a class="footnote-ref" id="fnref:26" href="#fn:26"><sup>26</sup></a></td></tr><tr><td>Latest version: 5.5</td><td>2020-03</td><td>Current stable version. Support for Java 12 bytecode, Typescript, and Bootstrap 4.</td></tr></tbody></table> <h2 id="see-also">See also</h2> <ul><li><a href="/facts/Apache_Wicket/CMYwKWwh">Apache Wicket</a></li> <li><a href="/facts/Comparison_of_server-side_web_frameworks/1708mQ6r">Comparison of web frameworks</a></li> <li><a href="/facts/Facelets/GSPHKLHM">Facelets</a></li> <li><a href="/facts/Java_Platform,_Enterprise_Edition/7AAStd35">Java EE</a></li> <li><a href="/facts/Java_view_technologies_and_frameworks/vBxdNbca">Java view technologies and frameworks</a></li></ul> <ul><li>Drobiazko, Igor (2012), <a href="https://web.archive.org/web/20141215032146/http://www.tapestry5book.com/"><i>Tapestry 5: Rapid web application development in Java</i></a>, Igor Drobiazko, p. 482, archived from <a href="http://www.tapestry5book.com/">the original</a> on 2014-12-15, retrieved 2013-01-20</li> <li>Kolesnikov, Alexander (January 15, 2008), <a href="http://www.packtpub.com/tapestry-5/book"><i>Tapestry 5: Building Web Applications: A step-by-step guide to Java Web development with the developer-friendly Apache Tapestry framework</i></a>, <a href="/facts/Packt/eT0RTSSK">Packt Publishing</a>, p. 280, <a href="/facts/ISBN_(identifier)/15AdSPa9">ISBN</a> 978-1-84719-307-0</li> <li>Iok Tong, Ka (January 1, 2007), <i>Enjoying Web Development with Tapestry</i> (3rd ed.), p. 497, <a href="/facts/ASIN_(identifier)/twP2MtLk">ASIN</a> <a href="https://www.amazon.com/dp/B00262M3HS">B00262M3HS</a></li> <li>Lewis Ship, Howard (2004), <i>Tapestry in Action</i>, <a href="/facts/Manning_Publications/opB29j1b">Manning</a>, p. 580, <a href="/facts/ISBN_(identifier)/15AdSPa9">ISBN</a> 1932394117</li></ul> <h3>Notes</h3> <h2 id="external-links">External links</h2> <ul><li><a href="https://tapestry.apache.org">Official website</a> </li></ul> <h2 id="references">References</h2> <ol> <li id="fn:1"><p>"Howard Lewis Ship of Tapestry interview [part 1] (2012-10-22)". Archived from the original on 2013-01-22. Retrieved 2013-01-28. <a href="https://web.archive.org/web/20130122114626/http://devrates.com/post/show/345948/howard-lewis-ship-of-tapestry-interview-%5Bpart-1%5D" target="_blank">https://web.archive.org/web/20130122114626/http://devrates.com/post/show/345948/howard-lewis-ship-of-tapestry-interview-%5Bpart-1%5D</a> <a href="#fnref:1" class="footnote-back-ref">↩</a></p></li> <li id="fn:2"><p>Drobiazko 2012, p. 1. <a href="#fnref:2" class="footnote-back-ref">↩</a></p></li> <li id="fn:3"><p>"Tapestry Central: Tapestry 5 Updates". 24 July 2006. <a href="http://tapestryjava.blogspot.com/2006/07/tapestry-5-updates.html" target="_blank">http://tapestryjava.blogspot.com/2006/07/tapestry-5-updates.html</a> <a href="#fnref:3" class="footnote-back-ref">↩</a></p></li> <li id="fn:4"><p>Tapestry in Action - Preface by Howard Lewis Ship <a href="#fnref:4" class="footnote-back-ref">↩</a></p></li> <li id="fn:5"><p>"Class Reloading - Apache Tapestry". <a href="https://tapestry.apache.org/class-reloading.html" target="_blank">https://tapestry.apache.org/class-reloading.html</a> <a href="#fnref:5" class="footnote-back-ref">↩</a></p></li> <li id="fn:6"><p>Drobiazko 2012, p. 20. <a href="#fnref:6" class="footnote-back-ref">↩</a></p></li> <li id="fn:7"><p>Drobiazko 2012, p. 7. <a href="#fnref:7" class="footnote-back-ref">↩</a></p></li> <li id="fn:8"><p>"Performance and Clustering - Apache Tapestry". <a href="https://tapestry.apache.org/performance-and-clustering.html" target="_blank">https://tapestry.apache.org/performance-and-clustering.html</a> <a href="#fnref:8" class="footnote-back-ref">↩</a></p></li> <li id="fn:9"><p>"Forms and Validation - Apache Tapestry". <a href="https://tapestry.apache.org/forms-and-validation.html" target="_blank">https://tapestry.apache.org/forms-and-validation.html</a> <a href="#fnref:9" class="footnote-back-ref">↩</a></p></li> <li id="fn:10"><p>Drobiazko 2012, p. 7. <a href="#fnref:10" class="footnote-back-ref">↩</a></p></li> <li id="fn:11"><p>"Meeting Plastic I: Introduction | Java Magic". 18 April 2011. <a href="http://tawus.wordpress.com/2011/04/18/meeting-plastic/" target="_blank">http://tawus.wordpress.com/2011/04/18/meeting-plastic/</a> <a href="#fnref:11" class="footnote-back-ref">↩</a></p></li> <li id="fn:12"><p>"[asm] Plastic: An ASM wrapper for Tapestry 5.3". Archived from the original on 2013-06-18. Retrieved 2013-02-21. <a href="https://web.archive.org/web/20130618005639/http://mail-archive.ow2.org/asm/2011-04/msg00033.html" target="_blank">https://web.archive.org/web/20130618005639/http://mail-archive.ow2.org/asm/2011-04/msg00033.html</a> <a href="#fnref:12" class="footnote-back-ref">↩</a></p></li> <li id="fn:13"><p>"Tapestry Central: Zeroing in on Tapestry 5.4". 19 October 2012. <a href="http://tapestryjava.blogspot.com/2012/10/zeroing-in-on-tapestry-54.html" target="_blank">http://tapestryjava.blogspot.com/2012/10/zeroing-in-on-tapestry-54.html</a> <a href="#fnref:13" class="footnote-back-ref">↩</a></p></li> <li id="fn:14"><p>"Principles". 2010-12-21. Archived from the original on 12 October 2012. Retrieved 2012-10-12. <a href="https://tapestry.apache.org/principles.html" target="_blank">https://tapestry.apache.org/principles.html</a> <a href="#fnref:14" class="footnote-back-ref">↩</a></p></li> <li id="fn:15"><p>"Tapestry5 future compatiblity [sic]". 2009-04-30. Archived from the original on 2013-01-21. Retrieved 2013-01-21. <a href="https://web.archive.org/web/20130121232236/http://tapestry.1045711.n5.nabble.com/Tapestry5-future-compatiblity-td2431085.html" target="_blank">https://web.archive.org/web/20130121232236/http://tapestry.1045711.n5.nabble.com/Tapestry5-future-compatiblity-td2431085.html</a> <a href="#fnref:15" class="footnote-back-ref">↩</a></p></li> <li id="fn:16"><p>"DevRates | Howard Lewis Ship of Tapestry interview [part 1]". Archived from the original on 2013-01-22. Retrieved 2013-01-28. <a href="https://web.archive.org/web/20130122114626/http://devrates.com/post/show/345948/howard-lewis-ship-of-tapestry-interview-%5Bpart-1%5D" target="_blank">https://web.archive.org/web/20130122114626/http://devrates.com/post/show/345948/howard-lewis-ship-of-tapestry-interview-%5Bpart-1%5D</a> <a href="#fnref:16" class="footnote-back-ref">↩</a></p></li> <li id="fn:17"><p>"Wicket: Do we need yet another presentation layer framework?". www.theserverside.com. Archived from the original on 9 September 2004. Retrieved 11 January 2022. <a href="https://web.archive.org/web/20040909074534/http://www.theserverside.com/news/thread.tss?thread_id=28162" target="_blank">https://web.archive.org/web/20040909074534/http://www.theserverside.com/news/thread.tss?thread_id=28162</a> <a href="#fnref:17" class="footnote-back-ref">↩</a></p></li> <li id="fn:18"><p>"Facelets: JavaServer Facelets". facelets.dev.java.net. Archived from the original on 6 July 2007. Retrieved 11 January 2022. <a href="https://web.archive.org/web/20070706220453/https://facelets.dev.java.net/" target="_blank">https://web.archive.org/web/20070706220453/https://facelets.dev.java.net/</a> <a href="#fnref:18" class="footnote-back-ref">↩</a></p></li> <li id="fn:19"><p>"JSF Central - Inside Facelets Part 1: An Introduction". www.jsfcentral.com. Archived from the original on 13 January 2013. Retrieved 11 January 2022. <a href="https://web.archive.org/web/20130113100928/http://www.jsfcentral.com/articles/facelets_1.html" target="_blank">https://web.archive.org/web/20130113100928/http://www.jsfcentral.com/articles/facelets_1.html</a> <a href="#fnref:19" class="footnote-back-ref">↩</a></p></li> <li id="fn:20"><p>"Tapestry: Java Web Components Release 2.0 is Out". Retrieved 2013-01-20. <a href="http://www.theserverside.com/discussions/thread.tss?thread_id=12750" target="_blank">http://www.theserverside.com/discussions/thread.tss?thread_id=12750</a> <a href="#fnref:20" class="footnote-back-ref">↩</a></p></li> <li id="fn:21"><p>"Tapestry 3.0 Final Release". Retrieved 2013-01-20. <a href="http://www.theserverside.com/discussions/thread.tss?thread_id=25354" target="_blank">http://www.theserverside.com/discussions/thread.tss?thread_id=25354</a> <a href="#fnref:21" class="footnote-back-ref">↩</a></p></li> <li id="fn:22"><p>"Tapestry 4.0 Released". Retrieved 2013-01-20. <a href="http://www.theserverside.com/news/thread.tss?thread_id=38407" target="_blank">http://www.theserverside.com/news/thread.tss?thread_id=38407</a> <a href="#fnref:22" class="footnote-back-ref">↩</a></p></li> <li id="fn:23"><p>"Tapestry and JSR-303 Bean Validation API". 2010-01-04. Archived from the original on 16 April 2010. Retrieved 2010-03-13. <a href="http://blog.tapestry5.de/index.php/2010/01/04/tapestry-and-jsr-303-bean-validation-api/" target="_blank">http://blog.tapestry5.de/index.php/2010/01/04/tapestry-and-jsr-303-bean-validation-api/</a> <a href="#fnref:23" class="footnote-back-ref">↩</a></p></li> <li id="fn:24"><p>"Announcing Tapestry 5.2". 2010-12-17. Archived from the original on 14 November 2012. Retrieved 2012-11-14. <a href="https://tapestry.apache.org/2010/12/17/announcing-tapestry-52.html" target="_blank">https://tapestry.apache.org/2010/12/17/announcing-tapestry-52.html</a> <a href="#fnref:24" class="footnote-back-ref">↩</a></p></li> <li id="fn:25"><p>"Using JSR 330 standard annotations - Apache Tapestry". <a href="https://tapestry.apache.org/using-jsr-330-standard-annotations.html" target="_blank">https://tapestry.apache.org/using-jsr-330-standard-annotations.html</a> <a href="#fnref:25" class="footnote-back-ref">↩</a></p></li> <li id="fn:26"><p>"JavaScript Rewrite". Archived from the original on 2012-11-14. Retrieved 2013-01-20. <a href="https://web.archive.org/web/20121114180615/http://tapestry.apache.org/javascript-rewrite.html" target="_blank">https://web.archive.org/web/20121114180615/http://tapestry.apache.org/javascript-rewrite.html</a> <a href="#fnref:26" class="footnote-back-ref">↩</a></p></li> </ol>