I wanted to throw together a list of naming peculiarities (I hesitate
to call them pitfalls), to put on the wiki.
Some are documented on the API website, some of these are mailing list
documented, some are only documented if you look into the code.

Use of underscore prefixes for fields, but not in accessors
   Some people just grew into doing it this way.  Eclipse's
getter/setter autogeneration keeps the underscore.

Non case sensitivity of page names in URL
   This is just a nice feature in Tapestry, documented in the code

URL shortening of page names under a similarly named directory.
   A documented feature intended to make things nice for users.
For example:
   A page named "Report" under a directory named "Report" will not resolve.
   A page named "StatusReport" under a directory named "Report" will
resolve to "Status" (i.e. report/status in the url)
   A page named "ReportStatus" under a directory named "Report" will
resolve to "Status" (i.e. report/status in the url)
   A page named "StatusReport1" under a directory named "Report" will
resolve to "StatusReport1" (i.e. report/statusreport1 in the url)

Case sensitivity in @OnEvent and similar annotations
  This is just a Java case sensitivity rule.  Those unfamiliar with
annotations before working with Tapestry (as I was) may forget that
case matters in annotations!  @onEvent is not the same, and your IDE
should tell you this.

Non case sensitive for value of OnEvent
   @OnEvent(value="SUBMIT")
   @OnEvent(value="submit")

Form event methods without annotations:
Besides typos in the name of the method, there is a case sensitivity
issue to be aware of: the "on" prefix must be lower case. i.e.
"OnSubmit" will not get called, but "onSubmit" will. T5's extensive
case insensitivity can cause us to be lazy sometimes.

Tapestry XML DTD's and their keys are case sensitive

Injected Assets are case sensitive
   This is a Servlet API /Java runtime rule.

Names of *.properties files are case sensitive
Names of properties inside the *.properties files are not case sensitive


Are there more?  Does this list sound right?

---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]

Reply via email to