Author: steveh
Date: Wed Apr 6 15:07:06 2005
New Revision: 160338
URL: http://svn.apache.org/viewcvs?view=rev&rev=160338
Log:
(1) Adding topic on servlet container adapters for page flow web apps.
(2) Misc. changes to other topics.
Added:
incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/pageflow/servlet_container_adapters.xml
(with props)
Modified:
incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/development/dev_mode.xml
incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/site.xml
incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/wsm/sample_wsm-blank.xml
Modified:
incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/development/dev_mode.xml
URL:
http://svn.apache.org/viewcvs/incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/development/dev_mode.xml?view=diff&r1=160337&r2=160338
==============================================================================
---
incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/development/dev_mode.xml
(original)
+++
incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/development/dev_mode.xml
Wed Apr 6 15:07:06 2005
@@ -39,12 +39,12 @@
<netui:exceptions
showDevModeStackTrace="true"/>.
By default, stack traces are not displayed.
</dd></dl>
- <note>Note: until <a
+ <!--<note>Note: until <a
href="http://issues.apache.org/jira/browse/BEEHIVE-462";>BEEHIVE-462</a>
is resolved, you should substitute
<strong><code>beehive.produtionmode</code></strong> in
the commands
below. (Notice the misspelling:
<code>beehive.produtionmode</code>
- instead of <code>beehive.productionmode</code>)</note>
+ instead of
<code>beehive.productionmode</code>)</note>-->
<dl>
<dt>
<strong>
Added:
incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/pageflow/servlet_container_adapters.xml
URL:
http://svn.apache.org/viewcvs/incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/pageflow/servlet_container_adapters.xml?view=auto&rev=160338
==============================================================================
---
incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/pageflow/servlet_container_adapters.xml
(added)
+++
incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/pageflow/servlet_container_adapters.xml
Wed Apr 6 15:07:06 2005
@@ -0,0 +1,41 @@
+<?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>Servlet Container Adapters</title>
+ </header>
+ <body>
+ <section><title>Writing a Servlet Container Adapter</title>
+<p>Certain Page Flow features (like the default behavior for
FlowController.login())
+ depend on container-specific capabilities. Page Flows use "Servlet
Container Adapters"
+ to take advantage of container-specific functionality.</p>
+<p>To write an adapter:</p>
+
+<ol>
+ <li>Write a class that implements
+ <a
href="../apidocs/classref_pageflows/org/apache/beehive/netui/pageflow/ServletContainerAdapter.html">org.apache.beehive.netui.pageflow.ServletContainerAdapter</a>.
+ You can extend <a
href="../apidocs/classref_pageflows/org/apache/beehive/netui/pageflow/DefaultServletContainerAdapter.html">org.apache.beehive.netui.pageflow.DefaultServletContainerAdapter</a>.
</li>
+<li>Package the class in a JAR file which also contains a text file called
+
"<code>META-INF/services/org.apache.beehive.netui.pageflow.ServletContainerAdapter</code>".
+ The text file should have a single line that is your
<code>ServletContainerAdapter</code> class name. </li>
+<li>Drop the JAR into the <code>WEB-INF/lib</code> directory of your web
application.
+ The Page Flow runtime will automatically
+ pick up the first "discovered" adapter that answers true when its
<code>accept</code>
+ method is called. </li>
+</ol>
+
+<note>Note: the default <code>ServletContainerAdapter</code> defines
"production mode"
+ as the state
+ where assertions are disabled. (See <a href="site:devmode">Development
and Production Modes</a>
+ for details.) Even if you do not want to use existing adapters for
+ container-specific features, you may want to write your own adapter
that defines
+ production mode
(<code>ServletContainerAdapter.isInProductionMode()</code>) according to your
own
+ requirements.</note>
+ </section>
+ </body>
+ <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
+ </legal>
+ </footer>
+</document>
Propchange:
incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/pageflow/servlet_container_adapters.xml
------------------------------------------------------------------------------
svn:eol-style = native
Modified:
incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/site.xml
URL:
http://svn.apache.org/viewcvs/incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/site.xml?view=diff&r1=160337&r2=160338
==============================================================================
---
incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/site.xml
(original)
+++
incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/site.xml
Wed Apr 6 15:07:06 2005
@@ -27,6 +27,7 @@
<pageflow_sharedFlow label="Shared Flow"
href="pageflow/sharedFlow.html"/>
<pageflow_popups label="Popup Windows"
href="pageflow/popupWindows.html"/>
<pageflow_valid label="Validation"
href="pageflow/validation.html"/>
+ <pageflow_servlet_adapter label="Servlet Container Adapters"
href="pageflow/servlet_container_adapters.html"/>
<!--<pageflow_programming label="Page Flow Programming"
href="pageflow/guide.html"/>-->
</pageflow>
<controls label="Controls">
Modified:
incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/wsm/sample_wsm-blank.xml
URL:
http://svn.apache.org/viewcvs/incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/wsm/sample_wsm-blank.xml?view=diff&r1=160337&r2=160338
==============================================================================
---
incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/wsm/sample_wsm-blank.xml
(original)
+++
incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/wsm/sample_wsm-blank.xml
Wed Apr 6 15:07:06 2005
@@ -48,7 +48,7 @@
produced when the web service is compiled and the (2) part of the URL
used by Tomcat to
access the web service.</p>
<p>The WAR file will be named
<code><SomeContext>WS.war</code></p>
- <p>The URL will be
<code>http://localhost:8080/<SomeContext>/</code></p>
+ <p>The URL will be
<code>http://localhost:8080/<SomeContext>WS/</code></p>
</section>
<section><title>Build and Deploy the Template Web
App</title>
<p>To build the template web service and deploy
it the resulting WAR file, run the following Ant command.</p>
@@ -69,7 +69,7 @@
the following link.</p>
<ul>
<li>Run the controller file's begin()
method:
-
http://localhost:8080/<strong><SomeContext></strong>/</li>
+
http://localhost:8080/<strong><SomeContext>WS</strong>/</li>
</ul>
</section>
</section>
