You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@beehive.apache.org by do...@apache.org on 2005/08/24 17:32:56 UTC
svn commit: r239693 - in
/beehive/trunk/docs/forrest/release/src/documentation/content/xdocs:
pageflow/pageflow_jsp.xml pageflow/tagsHtmlMapping.xml
pageflow/tagsOverview.xml site.xml
Author: dolander
Date: Wed Aug 24 08:32:51 2005
New Revision: 239693
URL: http://svn.apache.org/viewcvs?rev=239693&view=rev
Log:
Start of a real Tag Library overview
Clean up the site map a bit more
Added:
beehive/trunk/docs/forrest/release/src/documentation/content/xdocs/pageflow/tagsOverview.xml (with props)
Modified:
beehive/trunk/docs/forrest/release/src/documentation/content/xdocs/pageflow/pageflow_jsp.xml
beehive/trunk/docs/forrest/release/src/documentation/content/xdocs/pageflow/tagsHtmlMapping.xml
beehive/trunk/docs/forrest/release/src/documentation/content/xdocs/site.xml
Modified: beehive/trunk/docs/forrest/release/src/documentation/content/xdocs/pageflow/pageflow_jsp.xml
URL: http://svn.apache.org/viewcvs/beehive/trunk/docs/forrest/release/src/documentation/content/xdocs/pageflow/pageflow_jsp.xml?rev=239693&r1=239692&r2=239693&view=diff
==============================================================================
--- beehive/trunk/docs/forrest/release/src/documentation/content/xdocs/pageflow/pageflow_jsp.xml (original)
+++ beehive/trunk/docs/forrest/release/src/documentation/content/xdocs/pageflow/pageflow_jsp.xml Wed Aug 24 08:32:51 2005
@@ -1,41 +1,36 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V2.0//EN" "http://forrest.apache.org/dtd/document-v20.dtd">
<document>
- <header>
- <title>Page Flow JSP</title>
- </header>
- <body>
-
- <section id="introduction">
- <title>Introduction</title>
- <p>
- Continuing with the same model used in previous pages of this documentation set,
- examples will reference this:
- </p>
-
- <p>
- <img src="images/impl-flow-1.png" alt="implementation flow"/>
- </p>
-
- <p>
- Java Page Flow adds a handful of tag libraries to normal JSP usage to assist with the
- binding of the JSP pages to the controller class. Of primary importance in this topic is the
- <a href="../apidocs/taglib/taglib-overview-summary.html#netui"><code><netui:xxx></code></a>
- tag library.</p>
- <p>Other tag libraries provide additional functionality. The
- <a href="../apidocs/taglib/taglib-overview-summary.html#netui-data"><code><netui-data:xxx></code></a>
- tag library binds to complex data sets (especially result sets) and renders them as HTML.
- The <a href="../apidocs/taglib/taglib-overview-summary.html#netui-template"><code><netui-template:xxx></code></a>
- tag library lets you templatize common parts of the presentation layer, so that you can re-use
- common elements (such as headers, footers, etc.) across the different JSP pages in the web app.
- </p>
-
- <p>Page Flows also make extensive use of <strong><em>databinding expressions</em></strong>
- to bind the JSP pages to data in the controller class. For a detailed explanation
- of databinding expressions see <a href="site:pageflow_databinding">Databinding: Passing Data Between Controller Classes and JSP Pages</a> </p>
-
- </section>
-
+ <header>
+ <title>Page Flow JSP</title>
+ </header>
+ <body>
+ <section id="introduction">
+ <title>Introduction</title>
+ <p> NetUI adds a handful of tag libraries to normal JSP usage to assist with the
+ binding of the JSP pages to the controller class. These tag libraries add a number of features such
+ as HTML form controls, data grids, and trees. For a detailed overview of the tag libraries
+ and their usage see the <a href="site:pageflow_tag_overview">NetUI Tag Library Overview</a>. The
+ <a href="../apidocs/taglib/taglib-overview-summary.html">tag library API documentation</a>
+ describes all of the details.
+ </p>
+ <p> There are three tag libraries provided by NetUI.
+ </p>
+ <ul>
+ <li><a href="../apidocs/taglib/taglib-overview-summary.html#netui"><code><netui:xxx></code></a> --
+ This is the primary tag library supporting HTML. It also contains the Tree support.</li>
+ <li><a href="../apidocs/taglib/taglib-overview-summary.html#netui-data"><code><netui-data:xxx></code></a> --
+ This tag library provides binding to relational data, providing the Data Grid.</li>
+ <li><a href="../apidocs/taglib/taglib-overview-summary.html#netui-template"><code><netui-template:xxx></code></a> --
+ This tag library provides a very simple templating facility, allowing common elements such
+ as headers, footers, etc.</li>
+ </ul>
+ <p> Page Flows also make extensive use of <strong><em>databinding expressions</em></strong>
+ to bind the JSP pages to data in the controller class. For a detailed explanation
+ of databinding expressions see
+ <a href="site:pageflow_databinding">Databinding: Passing Data Between Controller Classes and JSP Pages</a>
+ </p>
+ </section>
<section id="starting_a_jpf_jsp">
<title>Starting a JPF JSP</title>
@@ -103,18 +98,18 @@
<section id="simple_linking">
<title>Simple Linking</title>
-
+
<p>
Initially, we will examine simple linking through a controller to another JSP page.
The <code><netui:anchor></code> tag replaces the normal <code><a></code>
HTML anchor tag. A plain <code><a></code> links directly from one URL to
another, without providing the controller an opportunity to perform any conditional
- logic. But the <code><netui:anchor></code> tag is rendered as HTML and Javascript
- code, code which causes the link to venture through the controller class.
+ logic. But the <code><netui:anchor></code> tag is rendered as HTML and Javascript
+ code, code which causes the link to venture through the controller class.
</p>
<p>
- While it may seem silly to use JPF/netui functionality for simple
+ While it may seem silly to use JPF/netui functionality for simple
<em>constant forward methods</em>, the advantage is that if a page
gets renamed or you wish to change the flow through an application,
the destination only needs to be changed once, within the controller.
@@ -166,7 +161,7 @@
<p>
To connect an on-screen form to the underlying controller's form-handling
- method, the <code><netui:form></code> container tag, along with
+ method, the <code><netui:form></code> container tag, along with
specialized tags that replace the normal form elements are used within
a JSP page. Similar to how <code><netui:anchor></code> replaces
normal HTML <code><a></code> tags, the <code><netui:form></code>
@@ -273,7 +268,7 @@
<footer>
<legal>
Java, J2EE, and JCP are trademarks or registered trademarks of Sun Microsystems, Inc. in the United States and other countries.<br/>
- © 2004, Apache Software Foundation
+ © 2004, Apache Software Foundation
</legal>
</footer>
</document>
Modified: beehive/trunk/docs/forrest/release/src/documentation/content/xdocs/pageflow/tagsHtmlMapping.xml
URL: http://svn.apache.org/viewcvs/beehive/trunk/docs/forrest/release/src/documentation/content/xdocs/pageflow/tagsHtmlMapping.xml?rev=239693&r1=239692&r2=239693&view=diff
==============================================================================
--- beehive/trunk/docs/forrest/release/src/documentation/content/xdocs/pageflow/tagsHtmlMapping.xml (original)
+++ beehive/trunk/docs/forrest/release/src/documentation/content/xdocs/pageflow/tagsHtmlMapping.xml Wed Aug 24 08:32:51 2005
@@ -37,9 +37,13 @@
<td><input type=file></td><td>netui:fileUpload</td><td>Form Control allowing a file to be uploaded</td><td></td>
</tr>
<tr>
- <td><input type=hidden></td><td>netui:hidden</td><td>Form Control that posts a value back</td><td></td>
- </tr>
+ <td><input type=hidden></td><td>netui:hidden</td><td>Form Control that posts a value back</td><td></td>
+ </tr>
<tr>
+ <td><html></td><td>netui:html</td><td>The containing HTML tag.</td>
+ <td><a href="site:pageflow_tagsXhtml_ScriptBlock">XHTML/HTML</a></td>
+ </tr>
+ <tr>
<td><img></td><td>netui:image</td><td>Embed an image into a document</td><td></td>
</tr>
<tr>
Added: beehive/trunk/docs/forrest/release/src/documentation/content/xdocs/pageflow/tagsOverview.xml
URL: http://svn.apache.org/viewcvs/beehive/trunk/docs/forrest/release/src/documentation/content/xdocs/pageflow/tagsOverview.xml?rev=239693&view=auto
==============================================================================
--- beehive/trunk/docs/forrest/release/src/documentation/content/xdocs/pageflow/tagsOverview.xml (added)
+++ beehive/trunk/docs/forrest/release/src/documentation/content/xdocs/pageflow/tagsOverview.xml Wed Aug 24 08:32:51 2005
@@ -0,0 +1,13 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V2.0//EN"
+ "http://forrest.apache.org/dtd/document-v20.dtd">
+<document>
+ <header>
+ <title>NetUI Tag Library Overview</title>
+ </header>
+ <body>
+ <section id="Overview">
+ <title>NetUI Tag Library Overview</title>
+ </section>
+ </body>
+</document>
\ No newline at end of file
Propchange: beehive/trunk/docs/forrest/release/src/documentation/content/xdocs/pageflow/tagsOverview.xml
------------------------------------------------------------------------------
svn:eol-style = native
Modified: beehive/trunk/docs/forrest/release/src/documentation/content/xdocs/site.xml
URL: http://svn.apache.org/viewcvs/beehive/trunk/docs/forrest/release/src/documentation/content/xdocs/site.xml?rev=239693&r1=239692&r2=239693&view=diff
==============================================================================
--- beehive/trunk/docs/forrest/release/src/documentation/content/xdocs/site.xml (original)
+++ beehive/trunk/docs/forrest/release/src/documentation/content/xdocs/site.xml Wed Aug 24 08:32:51 2005
@@ -24,9 +24,17 @@
<pageflow_sharedFlow label="Shared Flow" href="pageflow/sharedFlow.html"/>
<pageflow_popups label="Popup Windows" href="pageflow/popupWindows.html"/>
<pageflow_tags label="Tags">
+ <pageflow_tag_overview label="Overview" href="pageflow/tagsOverview.html" />
<pageflow_tag_html_mapping label="HTML Mapping" href="pageflow/tagsHtmlMapping.html" />
- <pageflow_tag_xhtml label="HTML/XHTML Support" href="pageflow/tagsXhtml.html" />
- <pageflow_tag_javascript label="JavaScript Support" href="pageflow/tagsJavascript.html" />
+ <pageflow_tag_xhtml label="HTML/XHTML Support" href="pageflow/tagsXhtml.html">
+ <pageflow_tagsXhtml_HtmlTag href="#HtmlTag" />
+ <pageflow_tagsXhtml_BodyTag href="#BodyTag" />
+ <pageflow_tagsXhtml_ScriptBlock href="#scriptBlockTag" />
+ </pageflow_tag_xhtml>
+ <pageflow_tag_javascript label="JavaScript Support" href="pageflow/tagsJavascript.html">
+ <pageflow_tagsJavascript_ScriptContainer href="#ScriptContainer" />
+ <pageflow_tagsJavascript_ScriptBlock href="#ScriptBlock" />
+ </pageflow_tag_javascript>
<pageflow_tag_tree label="Trees" href="pageflow/tagsTree.html" />
<pageflow_datagrid label="Data Grids" href="pageflow/datagrid.html"/>
</pageflow_tags>
@@ -39,10 +47,6 @@
</pageflow>
<!-- This is a set of internal links that the tag documentation uses to link between sections -->
<pageflow_tag_links>
- <pageflow_tagsJavascript_ScriptContainer href="pageflow/tagsJavascript.html#ScriptContainer" />
- <pageflow_tagsXhtml_BodyTag href="pageflow/tagsXhtml.html#BodyTag" />
- <pageflow_tagsJavascript_ScriptBlock href="pageflow/tagsJavascript.html#ScriptBlock" />
- <pageflow_tagsXhtml_ScriptBlock href="pageflow/tagsXhtml.html#scriptBlockTag" />
</pageflow_tag_links>
<controls label="Controls">
<control_getting_started label="Getting Started" href="controls/getting_started.html"/>