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"/>
