Codemash-Tapestry.pdf

Tapestry 5: Java
Power,
Scripting Ease
Howard M. Lewis Ship

TWD Consulting
hlship@comcast.net

1 © 2010 Howard M. Lewis Ship

Howard Lewis Ship

• Creator, Apache Tapestry
• Author, "Tapestry in Action"
• Independent Consultant


What is Tapestry?


Java

Open
Source

Component
Based

Developer
Focused

Convention
over
Conﬁguration

Concise

Fast!

Mature

Tapestry
Elements

Tapestry Templates

Login.tml

<html xmlns:t="http://tapestry.apache.org/schema/tapestry_5_1_0.xsd">
<body>
<h1>Please Login</h1>
Login
<t:form>
<t:label for="userId"/>
<t:textfield value="userId"/>
<br/>
form
<t:label for="password"/>
<t:passwordfield value="password"/>
<br/> label
<input type="submit" value="Login"/>
</t:form>
</html>
textﬁeld

label

passwordﬁeld


Page Classes

Login.tml

<html xmlns:t="http://tapestry.apache.org/schema/tapestry_5_1_0.xsd">
<body>
<h1>Please Login</h1>
Login.java
<t:form>
<t:label for="userId"/> public class Login
<t:textfield value="userId"/> {
<br/> @Property
<t:label for="password"/> private String userId;
<t:passwordfield value="password"/>
<br/> @Property
<input type="submit" value="Login"/> private String password;
</t:form>
</html> Object onSuccess()
{
…
}
}


Page Flows

Login.java UserProﬁle.java

public class Login public class UserProfile
{ {
@Property …
private String userId; }
@Property
private String password;

void onValidate()
{
…
}

Object onSuccess()
{
…

return UserProfile.class;
}
}


Inversion of Control
Login.java

public class Login
Your
code
{
@Property
private String userId;

@Property

… Inject IoC
@Inject
Service
private Session session; into ﬁeld

@CommitAfter
Object onSuccess()
{
…

User user = (User) session. …

user.setLastLogin(new Date());

}
}
return UserProfile.class;
Tapestry
Services

Meta-Programming
Login.java

public class Login Generate getter & setter
{
@Property
private String userId;

@Property

@InjectPage
private UserProfile userProfilePage;

…

@Inject
private Session session;
Commit Hibernate transaction
@CommitAfter
Object onSuccess()
{
…

User user = (User) session. …

user.setLastLogin(new Date());

return userProfilePage;
}
}


State Management

UserProﬁle.java

public class UserProfile
{ Shared global value (any page)
@Property
@SessionState
This page only private UserEntity user;

@Property
@Persist
private Date searchStart;

}


Template Injections

Component Meta-
Java Class
Programming

Message
Catalog


!Most software today is very much
like an Egyptian pyramid with
millions of bricks piled on top of each
other, with no structural integrity, but
just done by brute force and
thousands of slaves."

Alan Kay, co-designer of the Smalltalk programming
language

Developer
Productivity

Live Class Reloading


Non-Tapestry Exception Reporting


Index does not contain a property named 'now'
Available properties: class,
componentResources, currentTime


Scaffolding


BoardGame.java

@Entity
public class BoardGame
{
@Id @GeneratedValue(strategy = GenerationType.IDENTITY) @NonVisual
private long id;

@Validate("required")
private String title;

private String creator;

private String publisher;

private Date published;

private boolean inPrint;

@Column(nullable = false)
private Genre genre;

@Column(nullable = false)
private Theme theme;

@Validate("min=1")
private Integer minPlayers;

@Validate("min=1")
private Integer maxPlayers;

@Validate("min=1,max=5")
private Integer rating;

@DataType("longtext")
private String notes;


Parameters
Property Types

BeanEditForm
Naming Conventions

Annotations

Explicit Overrides

Localized Messages


Feedback &
Exploration


Flow


!PHP and Rails have taught us that
development speed is more important
than we thought it was ... you really
don’t understand a feature till you’ve
built it, so the faster you can build
them the faster you understand
them."

Tim Bray, Director of Web Technologies, Sun
Microsystems

Internationalization


Index_de.properties

page-title=Erstellen Sie eine neue Brettspiel
add-game=Spiel hinzufŸgen
game-added=Added Brettspiel Index.tml

<html t:type="layout" title="message:page-title"
modern=Modernen
xmlns:t="http://tapestry.apache.org/schema/tapestry_5_1_0.xsd"
medieval=Mittelalter
xmlns:p="tapestry:parameter">
bible=Bibel
abstract=Zusammenfassung
<strong>${message}</strong>
war_game=Kriegsspiel
<t:beaneditform submitlabel="message:add-game" object="game" />
card=Karte
role_playing=Rollenspiele
</html>
cooperative=Genossenschaft

creator-label=Sch!pfer
publisher-label=Verlag
published-label=Ver!ffentlicht
inprint-label=Im Druck
theme-label=Thema
minplayers-label=Mindest-Spieler
maxplayers-label=Maximale Spieler
notes-label=Notation


Tapestry
Components


Nested Components
Layout
title : String
Layout.tml
pageNames : List
pageName : String
<html xmlns="http://www.w3.org/1999/xhtml"
<head>
<title>${title}</title>
</head>
<body>
…
<div id="menu">
<ul>
<li t:type="loop" source="pageNames" value="pageName"
class="prop:classForPageName">
<t:pagelink page="prop:pageName">${pageName}</t:pagelink> Index
</li>
</ul>
</div>
Layout
…

Loop PageLink
Render property pageName


Layout Components
Layout.tml

<html xmlns="http://www.w3.org/1999/xhtml" $
<head>
<title>${title}</title>
</head>
<body>

. . .

<t:body/> %
. . .
' Index.tml
</body>
</html> <html t:type="layout" title="message:page-title" #
xmlns:t="http://tapestry.apache.org/schema/ ↵
tapestry_5_1_0.xsd"

<t:beaneditform submitlabel="message:add-game"
object="game" />
&
</html>


Component Parameters

Layout.java

public class Layout
{
/** The page title, for the <title> element and the <h1> element. */
@Property
@Parameter(required = true, defaultPrefix = BindingConstants.LITERAL)
private String title;

@Property
@Parameter(defaultPrefix = BindingConstants.LITERAL)
private String sidebarTitle;

@Property
@Parameter(defaultPrefix = BindingConstants.LITERAL)
private Block sidebar;

@Property
private String pageName;


Non-Template Components

OutputDate.java

public class OutputDate
{
private final DateFormat formatter =
DateFormat.getDateTimeInstance(DateFormat.MEDIUM, DateFormat.MEDIUM);

@Parameter(required = true, allowNull = false)
private Date date;

void beginRender(MarkupWriter writer)
{
writer.write(formatter.format(date));
}
}


Start

SetupRender
Component Rendering
true
OutputDate.java
false
BeginRender

void beginRender(MarkupWriter writer)
true
false {
writer.write(formatter.format(date));
}
Render Template

Render Body

false
AfterRender
false
true

CleanupRender

true

End

Partial Page Updates
Games.tml

Games.tml
<t:actionlink t:id="selectGame"
context="game" zone="gameDetail"> <t:zone id="gameDetail" t:id="gameDetail">
${game.title} <t:if test="selectedGame">
</t:actionlink> <strong>${selectedGame.title}</strong>
by
<strong>${selectedGame.creator}</strong>
<br />
For ${selectedGame.minPlayers} - ↵
.../games.selectGame/3 ${selectedGame.maxPlayers} players.
</t:if>
</t:zone>

Games.java

@Property
private BoardGame game, selectedGame;

@InjectComponent
private Zone gameDetail;

Object onActionFromSelectGame(BoardGame game)
{
selectedGame = game;

return gameDetail.getBody();
}

Encapsulation


Tapestry
Performance


Request
Processing
Speed


Java
== Fast

No
Reﬂection

Page
Pooling

GZIP
Compression

Scalability

JavaScript
Aggregation

Far Future
Expires
Header

Caching

Content
Delivery
Network

!Architecture is the decisions that you
wish you could get right early in a
project."

Martin Fowler, Chief Scientist, ThoughtWorks

Conclusion


Infrastructure


Performance


Tapestry: The Expert is
Built In


Tapestry 5 In Production


http://tapestry.apache.org

•Downloads
•Mailing Lists
•Component Reference
•User's Guide
•Wiki


http://jumpstart.doublenegative.com.au/

•Application Skeleton
•Detailed tutorials


http://chenillekit.codehaus.org/


http://github.com/hlship/t5intro


http://howardlewisship.com

Tapestry 5 Development and Support
On-site / Hands-on Tapestry Training
hlship@comcast.net

Image Credits
© 2006 Chris Walton
http://www.flickr.com/photos/philocrites/245011706/

© 2010 Nataline Fung
http://www.flickr.com/photos/metaphora/3384569933/
© 2006 Martino Sabia
http://www.flickr.com/photos/ezu/297634534/
© 2008 Alan Grinberg
http://www.flickr.com/photos/agrinberg/2465119180/
© 2008 Manu Gómez
http://www.flickr.com/photos/manugomi/2884678938/
© 2006 Tom Magliery
http://www.flickr.com/photos/mag3737/267638148/
© 2003 A. Lipson
http://www.andrewlipson.com/escher/relativity.html

© 2010 viernest
http://www.flickr.com/photos/viernest/3380560365/
© 2007 Jojo Cence
http://www.flickr.com/photos/jojocence/1372693375/

© 2007 Patrick Dirden
http://www.flickr.com/photos/sp8254/2052236004/
© 2010 Dani Ihtatho
http://www.flickr.com/photos/ihtatho/627226315/


Image Credits
© 2008 Christophe Delaere
http://www.flickr.com/photos/delaere/2514143242/

© 2007 Marina Campos Vinhal
http://www.flickr.com/photos/marinacvinhal/379111290/
© 2006 kris247
http://www.flickr.com/photos/kris247/86924080/
© Randal Munroe
http://xkcd.com/303/
© 2010 Howard M. Lewis Ship
http://www.flickr.com/photos/hlship/3388927572/

© 2008 Howard M. Lewis Ship
http://www.flickr.com/photos/hlship/3107467741/


Codemash-Tapestry.pdf

Recommended

Recommended

More Related Content

What's hot

What's hot (11)

Viewers also liked

Viewers also liked (6)

Similar to Codemash-Tapestry.pdf

Similar to Codemash-Tapestry.pdf (20)

More from Howard Lewis Ship

More from Howard Lewis Ship (9)

Codemash-Tapestry.pdf