Tapestry5HowTos

How to get started

In order to quickly get up to speed on Tapestry 5, there are numerous information sources besides this Wiki available:

• prepare your IDE - Eclipse code templates, IntelliJ IDEA life templates, other IDE hints are welcome here

• Howard's screencasts

• Howard's tutorial (in progress)

• Tapestry for Nonbelievers

• The maven archetype that creates an example project

• Tapestry site and Component reference if you are using latest release

• Tapestry site and Component reference if you are using current SNAPSHOT

• Search the mailing list with Google by including Google entry: "YOUR KEYWORDS T5 site:mail-archives.apache.org/mod_mbox/tapestry-users/"

• Home site, with deeper explanations of all the aspects behind Tapestry

• Tapestry5HowToSetupEclipseRunJettyRun - How to set up Tapestry 5, Eclipse 3.3, Jetty 6.1.5 with RunJettyRun

• Tapestry5UsefulConfigurationsForDevelopment - Tapestry 5 configurations that will make your development easier

• Tapestry5Training - Tapestry 5 overview with practical work

Code snippets

• Tapestry5LocalizedDateField - How to create a localized DateField for BeanModel.

• Tapestry5HowToIocOnly - Example of using tapestry-oc standalone (without web part). And the same, but with tapestry-hibernate added Tapestry5HowToIocAndHibernate

• Tapestry5CheckOutTheSourceCode - Examples and Demos of many components in the source code, like the Palette, Grid, Beaneditform, etc.

• Tapestry5SpringIntegration - How to inject Spring beans into Tapestry pages and components

• Tapestry5OutputtingRawHtml - How to output raw, unfiltered HTML

• Tapestry5LinkingToNonTapestryURIs - How to link to non-Tapestry URIs (useful for Acegi integration)

• Tapestry5ObtainingHttpServletRequest - How to obtain the HttpServletRequest, HttpServletResponse and HttpSession if you really need them

• Tapestry5DisplayableSelectionModel - (A code contribution) A selection model for objects that implement an interface. Used for select components and more.

• Tapestry5 How to use the SELECT component - Daniel Jue explains how he uses the GenericSelectionModel class for building all kinds of select/dropdown components.

• Tapestry5SelectObject - (Code contribution) An alternative implementation of the Select core component based on the Daniel Jue's GenericSelectionModel and GenericValueEncoder classes.

• Tapestry5MultipleSelectOnObjects - Explains how to build a multiple select component based on the Daniel Jue's GenericValueEncoder classes.

• Tapestry5HowtoSelectWithObjects - another example on how to make <SELECT> filled with objects

• Tapestry5AnotherSelectWithObjects - One more example with on how to make <SELECT> on objects, now with annotations.

• Tapestry5HowToCreateAPropertyEditBlock - Explains how to create a property editor and contribute it to the BeanEditForm.

• How to use T5 with Acegi Security and CAS - Francois Armand explains how he combines T5, Acegi Security and CAS (A Central Authentication Service, providing intranet single sign-on).

• Tapestry5Acegi How to secure Tapestry5 pages with Java5 annotations using the Acegi security framework

• Tapestry5AcegiNoAnnotations How to use Acegi Security with Tapestry 5, in the classical way (no annotations, some XML)

• Tapestry5HowToCreatePieChartsInAPage - An example of dynamic charts inside a page (Using StreamResponse)

• Tapestry5HowToCreateADynamicPDF - A simple example of how to return a dynamically generated PDF from an event (Using StreamResponse)

• Tapestry5HowToStreamAnExistingBinaryFile - A simple example of how to stream an existing file, like an image. (Using StreamResponse)

• Tapestry5HowToDecorateService - An example of a simple service decorator

• Tapestry5HowToAddBindingPrefix - An example of an list: binding prefix for parameters (useful for ActionLink.context)

• Tapestry5HowToAddBindingPrefixCycle - An example of an cycle: binding prefix. Makes zebra effect simple to do <t:grid ....  rowClass="cycle:line1,line2">

• Tapestry5HowToUseForms - Examples of how forms are connected to methods in your code.

• Tapestry5ExceptionPage - How to display your own exception page.

• Tapestry5RedirectException - Redirect to another URL from anywhere inside a page or component.

• Tapestry5HowToChangeLocale - Change the locale of the user.

• Tapestry5HowToIncludeJavaScript - Explains how to add your own custom JavaScript functions.

• Tapestry5HowToAddMessageFormatBindingPrefix - Describes how to add a messageformat prefix for specifying values for use in messages inline.

• Tapestry5HowToCreateADispatcher - How to create a completely transparent access control system by implementing a Dispatcher.

• Tapestry5HowToCreateADispatcher2 - A supplemental article showing how to access request-specific data (ASOs) from a singleton service. To demonstrate we expand on the code shown in the first article.

• Tapestry5HowToControlAccess - Another supplemental article based on Tapestry5HowToCreateADispatcher2 showing how to control access to pages based on an annotation.

• Tapestry5How to make a basic crud show you how easy is the conception of a CRUD cycle with tapestry 5

• Tapestry5HowToRunTaskInThread - run a task (Runnable) in a separate thread

• Tapestry5HowToUsePersistentFieldStrategy - How to create a PersistentFieldStrategy for the Persist annotation. working cookie example

• Tapestry5HowToAddValidators - How to add your own validators to tapestry

• Tapestry5HowToXhtml - How to override the default markup model to always use xhtml compliant tags

Hibernate related

• Tapestry5HowToUseTapestryHibernate - Example/Tutorial of how to use Tapestry-Hibernate in your code.

• [Tapestry5HowToIocAndHibernate] - Example of using tapestry-oc+tapestry-hibernate standalone (without web part).

• Tapstry5First project with Tapestry5, Spring and Hibernate - A translation of a french article about integrating Spring, Hibernate and Tapestry

• Tapestry5ManipulateClassesAtRuntime show you how easy is to add class methodes at runtime.

• Tapestry5HibernateGridDatasource simple hibernated grid datatsource using HQL (Hibernate Query Language).

• Tapestry5HibernateGridDatasource2 simple hibernated grid datatsource using hibernate criteria API.

• Tapestry5BrainlessEntityTimestamping How to have entities automatically time stamped using tapestry-hibernate, simply by adding certain fields!

Spring related

• Tapestry5_How_To_Integrate_Components_With_Spring_Transactions - brief tutorial of how to integrate Tapestry5 components with Spring transactions.

Components

• Tapestry5HowToCreateYourOwnComponents - Creating your own components is really simple, and fun to do as well. (This example implements a www.dhtmlgoodies.com drag-and-drop-folder tree component)

• Tapestry5HowToCreateYourOwnComponentLibrary - Steps to create a reusable library (JAR) of T5 components.

• Tapestry5HowToCreateASimpleGraphComponent - An example of simple pie chart component (Using StreamResponse)

• Tapestry5OutputLocaleNumber - Creating a new component for formatting (numbers) according to locale, using literals (integer, decimal or currency). It's based on Output component.

• Tapestry5HowToCreateATabPanel - Explains how to create a tab panel.

• Tapestry5SubmitContextComponent - A Submit component that passes a context

• Tapestry5AnyComponent - A deprecated but still useful component that does ... nothing (by default)

• Tapestry5ImageComponent - Another deprecated component that's useful for making "previewable" templates

• Tapestry 5 components By Shing Hing Man

• Several projects with Tapestry 5 components at Google Code, share your components here.

• Tapestry5TreeComponent - A tree component based on DHTMLgoodies.com's drag 'n drop folder tree

• Tapestry5EnhancedPalette - Based heavily on the existing core palette and uses Matt Kruse's Option Transfer javascript (Works in IE!)

• Tapestry5Layoutcomponent A sophisticated Layout component

• Tapestry5PaletteEvents How to invoke a Javascript function when the selected items are added/removed/reordered in a Palette

• Tapestry5GridComponent Some tricks using the Grid component

• Tapestry5AndJavaScriptExplained - A detailed look at how Tapestry 5 integrates javascript into your application. In this article we create a mixin for adding a javascript confirmation box to link components, explaining each step. Full source included.

Bug workarounds / patches

• Tapestry5Utf8Encoding - How to use UTF-8 encoding to support foreign characters

• Tapestry5RootPathEmptyResponse - A runtime patch for the root path empty response bug

• Tapestry5.5 Palette Component IE Bug Patch

Meta info

• Tapestry5HowToCreateYourQuickstartWithMaven206 - If you've had some trouble getting maven2.0.6 to compile the quickstart, here's how to do it.

• Tapestry5WhereToStoreExternalResources - Where to store resources like CSS, JS and Images in your application

• Tapestry5WhereToStoreConfigurationResources - Where to store resources like Hibernate configuration files, logging properties, and web application context information in your application

• Tapestry5HowToSearchTheMailingLists - Force Google to only search the mailing list (results found in these lists are often hidden due to the limited #links)

• Tapestry5HowToOverrideTheDefaultErrorMessageBanner - How to override the default error message banner

• Tapestry5Trolls - How to deal with trolls on the list, and one in particular

Coding traps

• Tapestry5HowToNotMakeCustomComponent - If you are making a custom component, there are few things you shouldn't do...

• Tapestry5ComponentClassResolverError - When organizing your component (or page) directories, pay special attention!

• Tapestry5Caveats - or more literally, "let him beware".

IRC

Chris Lewis mentioned Tapestry's IRC: #tapestry AT irc.freenode.net: "There's usually 5 ~ 8 of us in there, and we work/talk about Tapestry."

Please add more 'how tos'. Remember to prefix the page name with Tapestry5.