Hi Jeff, I'd recommend taking a look at Standalone Tiles.
Basically, Struts-Tiles is Tiles 1.0 and Standalone Tiles is Tiles
2.0. Honestly, I'm not putting any efforts into improving Tiles 1.0,
but focusing on making 2.0 stable and ready. You can search for
Standalone Tiles on the dev list to follow the progress. See other
comments below...
On Jul 6, 2006, at 7:22 AM, Jeff Conrad wrote:
1. The <a
href="http://struts.apache.org/1.x/struts-tiles/
installation.html">Tiles
installation document</a> states that in order
to use Tiles independently, you would use the TilesServlet,
located in the struts-tiles-VERSION.jar. There is not a
TilesServlet, nor a struts-tiles-VERSION.jar, in the
struts-1.2.9-src, -lib, or -bin deliveries.
Wow. You're right and I'm really surprised. I'll have to check into
that. I really have no idea when, how, or why that was removed.
There is one in Tiles 2.0.
The <a
href="http://struts.apache.org/1.x/struts-tiles/
installation.html">Tiles
installation document</a> has a dead link to
http://struts.apache.org/1.x/struts-tiles/cvs-usage.html.
That's supposed to point to the Struts source distribution download
page. It needs to be fixed.
2. The <a
href="http://struts.apache.org/1.x/struts-tiles/faq.html";>Tiles
FAQ page</a> has a dead link to
http://cvs.apache.org/builds/jakarta-struts/nightly/sandbox/tiles-
core/.
That's supposed to point to Standalone Tiles. It also needs to be
fixed.
3. The example in the <a
href="http://struts.apache.org/1.x/struts-tiles/apidocs/org/apache/
struts/tiles/package-summary.html">API
from 1.x Struts</a> has some extra escaping
of &gt; characters.
This will be superceded by Standalone Tiles. Actually it will
probably be ported to Standalone Tiles and needs to be fixed.
4. The
http://struts.apache.org/1.x/struts-tiles/examples.html
(Examples from 1.x Struts) page is incomplete.
Yes, intentionally so. I left some gaping holes in the hopes that
patches would soon follow from people who have better ideas than
myself :-) Actually, I think the doc would flow better if the
Examples page was just Chapter 2 of the User Guide. Basically,
replace the bottom section of the User Guide page with the Examples
stuff.
5. The
http://struts.apache.org/1.x/struts-tiles/tagreference.html
definition tag does not mention name. Name is a required
attribute for definition.
I thought that doc was auto-generated from the TLD file. Perhaps it
is out of date or something.
Solutions
1. To use the Tiles in the current version of Struts, you
will need to
use the Struts servlet. I have uploaded a working example
with all of the necessary components (minus the libraries)
at
http://www.guesttime.com/members/ledlogic/struts/TilesTest-0.1-src.jar
If you build this and deploy the war to a webserver, there
are 3 examples in the line of the original struts examples,
one for pure JSP (/jsp/jspExample.jsp), one with JSP +
tiles (/jsp/tilesExample.jsp), and the last is
(/jsp/tilesXMLExample.jsp).
If you look in the sandbox there is a skeletal test app taking shape
for Standalone Tiles (tiles-test). There's also a TilesServlet
there. I'd also like to take a look at your examples and see what
you've done.
http://svn.apache.org/repos/asf/struts/sandbox/trunk/tiles/tiles-test/
2. I am not sure if there are nightly builds
somewhere for tiles. Who manages these for Struts?
You should find a nightly for struts-tiles-x.jar in the same place as
Struts 1.3 jars. (Sorry I don't know off the top where that is.)
Prior to Struts 1.3, Tiles was just a subdirectory of the Struts
distro. As of 1.3, it is a sub-project, and "nomadic" is a pretty
good way to describe it. I really can't tell you where it will
live. I am forming an opinion about where I think it *should* live,
but that's another discussion.
3. The javadoc needs to be fixed in the java
source for the tiles package.
4. Perhaps some of the information here could be
incorporated. Do you need someone to finish the
documentation for
Tiles? If so I can help.
Yes :-) That would be awesome!!
If you're offering to help I would point you to Standalone Tiles.
(Check the links George Dinwiddie sent.) There are hooks in the
(Tiles 1.x) doc where the missing information should go, but I would
like to see that information added based on Tiles 2.0. If you're
still committed to advancing the 1.x product, then we welcome any
work in that arena as well.
Here's a fairly definitive list of outstanding tasks/issues related
to Tiles:
http://issues.apache.org/struts/secure/IssueNavigator.jspa?
reset=true&mode=hide&pid=10122&sorter/order=DESC&sorter/
field=priority&resolution=-1&component=21260
Thanks,
Greg
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
