jford 2004/04/09 10:56:14
Added: tutorial/xdocs/appendix b.xml
Log:
Converted Appendix B to xdoc format
Revision Changes Path
1.1 jakarta-jetspeed/tutorial/xdocs/appendix/b.xml
Index: b.xml
===================================================================
<?xml version="1.0"?>
<!--
Copyright 2004 The Apache Software Foundation
Licensed 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>
<author email="[EMAIL PROTECTED]">David Sean Taylor</author>
<title>Turbine and ECS</title>
</properties>
<body>
<section name="Turbine and ECS">
<p>
The <b>getContent()</b> method of a portlet takes a <b>RunData</b> object, which is
passed through from an internal component called <a
href="http://jakarta.apache.org/turbine">Turbine</a>.
The <b>RunData</b> class is one of the few Turbine classes that you must deal with
often. Turbine is a MVC-2 (Model View Controller) Servlet framework that Jetspeed was
founded upon.
</p>
<p>
Another component coupled to in the Portlet interface is the <a
href="http://jakarta.apache.org/ecs">Element Construction Set</a> (ECS), an
object-based mark-up generator.
The Jetspeed Portlet interface requires that portlets return ECS elements as their
content. It uses Java objects to construct the elements of the respective mark-up.
Admittedly, this approach is better than hard coding mark-up tags, but it still places
mark-up information into compiled code.
</p>
<p>
Therefore, we generally recommend using a page template mechanism of your choice,
rather than using ECS directly.
The majority of the portlets in Jetspeed are based upon the base class <a
href="http://portals.apache.org/jetspeed-1/portlet_config_Velocity.html">Velocity
Portlet</a>, a template-based portlet which does not mix Java source with mark-up.
Similarly, you can use the <a
href="http://portals.apache.org/jetspeed-1/portlet_config_JSP.html">JSP Portlet</a> to
create MVC portlets based upon the Java JSP standard.
</p>
<p>
<b>Note:</b> Starting with version 2.0 of Jetspeed, ECS will be deprecated.
</p>
</section>
</body>
</document>
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]