You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@tiles.apache.org by mc...@apache.org on 2011/08/27 23:39:37 UTC
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
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™ 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(<parameters>, Request request, ModelBody modelBody);</span>
+ </p>
+ <p>The modelBody parameter is optional: if it is not specified, the template model does not have a body. </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> </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™ 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>