tiles-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From m..@apache.org
Subject svn commit: r1162444 - in /tiles/framework/trunk: tiles-autotag/src/site/xdoc/ tiles-autotag/src/site/xdoc/index.xml tiles-parent/src/site/apt/whats-new.apt tiles-request/src/site/xdoc/ tiles-request/src/site/xdoc/index.xml
Date Sat, 27 Aug 2011 21:39:37 GMT
Author: mck
Date: Sat Aug 27 21:39:36 2011
New Revision: 1162444

URL: http://svn.apache.org/viewvc?rev=1162444&view=rev
Log:
http://thread.gmane.org/gmane.comp.apache.tiles.devel/233

Added:
    tiles/framework/trunk/tiles-autotag/src/site/xdoc/
    tiles/framework/trunk/tiles-autotag/src/site/xdoc/index.xml
    tiles/framework/trunk/tiles-request/src/site/xdoc/
    tiles/framework/trunk/tiles-request/src/site/xdoc/index.xml
Modified:
    tiles/framework/trunk/tiles-parent/src/site/apt/whats-new.apt

Added: tiles/framework/trunk/tiles-autotag/src/site/xdoc/index.xml
URL: http://svn.apache.org/viewvc/tiles/framework/trunk/tiles-autotag/src/site/xdoc/index.xml?rev=1162444&view=auto
==============================================================================
--- tiles/framework/trunk/tiles-autotag/src/site/xdoc/index.xml (added)
+++ tiles/framework/trunk/tiles-autotag/src/site/xdoc/index.xml Sat Aug 27 21:39:36 2011
@@ -0,0 +1,57 @@
+<?xml version="1.0"?>
+<!--
+/*
+ * $Id: index.xml 1162124 2011-08-26 14:16:13Z mck $
+ *
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements.  See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership.  The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance
+ * with the License.  You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+-->
+<document>
+
+    <properties>
+        <title>Home</title>
+    </properties>
+
+    <body>
+
+        <section name="Apache Autotag&#8482; project">
+
+            <p>Tiles-3 introduces a feature complete
+                <a href="http://svn.eu.apache.org/repos/asf/tiles/sandbox/trunk/tiles-autotag/"
title="Autotag SVN directory">Autotag project</a>,
+                a project that automatically generates tags (or tag-like) artifact from a
common template code for a range of templating languages.
+                Today JSP tags, Freemarker directive models and Velocity directives are generated
from a common template models.
+            </p>
+            <p>Such template models must have a single public method, with this signature:</p>
+            <p>
+                <span class="Apple-style-span" style="font-family: monospace; white-space:
pre;">public void execute(&lt;parameters&gt;, Request request, ModelBody modelBody);</span>&nbsp;
+            </p>
+            <p>The modelBody parameter is optional: if it is not specified, the template
model does not have a body.&nbsp;</p>
+            <p>For more features (required fields, default values, a name different
to the one specified in the parameter list) a new annotation @Parameter has been created.</p>
+            <p>A Maven 2 (based on 2.2.1) plugin contains four Mojos:</p>
+            <p>&nbsp;</p>
+            <ul>
+                <li>the first mojo (create-descriptor) reads the template models and
produces an XML file containing the description of the read models;</li>
+                <li>the others (generate-jsp, generate-freemarker, generate-velocity)
produce boilerplate code.</li>
+            </ul>
+                <p>The projects using the latter mojos must include some runtime dependencies.</p>
+                <p>The result boilerplate code has been removed and uses the plugin
instead: it's a lot of boilerplate, boring code, now generated automatically.
+                </p>
+        </section>
+    </body>
+
+</document>

Modified: tiles/framework/trunk/tiles-parent/src/site/apt/whats-new.apt
URL: http://svn.apache.org/viewvc/tiles/framework/trunk/tiles-parent/src/site/apt/whats-new.apt?rev=1162444&r1=1162443&r2=1162444&view=diff
==============================================================================
--- tiles/framework/trunk/tiles-parent/src/site/apt/whats-new.apt (original)
+++ tiles/framework/trunk/tiles-parent/src/site/apt/whats-new.apt Sat Aug 27 21:39:36 2011
@@ -22,8 +22,18 @@
          -----------
 
 What's new in Tiles 3.0
-  TODO...
 
+* New features in Tiles 3.0
+
+  * Apache Request: a framework independent request abstraction. Implementations for Servlet,
Portlet, JSP, Velocity and FreeMarker.
+
+  * Apache Autotag: a project that automatically generates tags (or tag-like) artifact from
a common template code for a range of templating languages.
+  All the Tiles 3 boilerplate code to templating models has been removed and uses the Autotag
plugins instead:
+  it's a lot of boilerplate, boring code, now generated automatically.
+
+* Deprecations in Tiles 3.0
+
+  ...todo...
 
 What's new in Tiles 2.2
 

Added: tiles/framework/trunk/tiles-request/src/site/xdoc/index.xml
URL: http://svn.apache.org/viewvc/tiles/framework/trunk/tiles-request/src/site/xdoc/index.xml?rev=1162444&view=auto
==============================================================================
--- tiles/framework/trunk/tiles-request/src/site/xdoc/index.xml (added)
+++ tiles/framework/trunk/tiles-request/src/site/xdoc/index.xml Sat Aug 27 21:39:36 2011
@@ -0,0 +1,51 @@
+<?xml version="1.0"?>
+<!--
+/*
+ * $Id: index.xml 1162124 2011-08-26 14:16:13Z mck $
+ *
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements.  See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership.  The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance
+ * with the License.  You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+-->
+<document>
+
+    <properties>
+        <title>Home</title>
+    </properties>
+
+    <body>
+
+        <section name="Apache Request&#8482; microframework project">
+
+            <p>Tiles-3 introduces a complete standalone and super simple abstraction
around request/response objects.
+                <p>We've all seen that the various technologies like Servlet, Portlet,
JSP, Velocity, FreeMarker seem to have a different abstraction of a common pattern.
+            They all have a concept of:</p>
+            <ul>
+                <li>request: the client request, or some sort of it;</li>
+                <li>response: the response to send to the client, or to the caller,
with a writer/output stream to write into;</li>
+                <li>attributes: usually maps (or map-like structures) with string keys
and object values;</li>
+                <li>scope: places where different attribute maps are stored (request,
session, etc.)</li>
+            </ul>
+            <p>Now all of these scopes are concentrated into "Request" interfaces,
that acts as a single point of reference for the developer.
+            In theory, everything can be obtained by an object that implements Request.</p>
+            <p> </p>
+            <p>Currently there are bindings for Servlet, Portlet, JSP, Velocity and
FreeMarker.</p></p>
+
+        </section>
+    </body>
+
+</document>



Mime
View raw message