StringBeans portal 安装配置说明--翻译（八）
XIV. 部署 Stringbeans为ROOT上下文
------------------------------------------
1. 在 $TOMCAT_HOME下建立stringbeans目录.
2. 解压 stringbeans.war 到刚建立的stringbeans目录.
3． 修改$TOMCAT_HOME/conf目录下的配置文件server.xml
在Host标签下，添加以下的context
Context path= docBase=..stringbeans debug=0
Typically there is Tomcat's ROOT context. If it is enabled, rename
it to any name. e.g.
Context path=root docBase=ROOT debug=0
4. 启动 Tomcat.
Windows $TOMCAT_HOMEbinstartup.bat
Unix or Linux $TOMCAT_HOMEbinstartup.sh
5. You can connect to Stringbeans Portal by typing only your server name
(plus port number if you are using other than port 80).
e.g. httplocalhost8080
XV. 使用 Stringbeans Struts 桥
------------------------------------
Stringbeans 的发布版本里包含有Struts 桥 ，本身支持 Struts应用部署为符合JSR-168
规范的应用。
下列步骤完成在Stringbeans上下文中部署Stru应用。ts
如果在不同的上下文环境中布置Struts应用，请按下面的绑定Struts桥的发行版（在单独的包中）的安装说明的步骤
1. 在$STRINGBEANS_HOME/WEB-INF/目录下的portlet.xml中增加Struts portlet的配置
portlet 的定义必须满足：
- 指定 com.nabhinc.portlet.strutsbridge.StrutsPortlet 作为 portlet-class
- 指定 ServletContextProvider 初始化参数为
com.nabhinc.portlet.strutsbridge.impl.ServletContextProviderImpl.
例如：
<portlet>
<description>....</description>
<portlet-name>....</portlet-name>
<display-name>....</display-name>
<portlet-class>com.nabhinc.portlet.strutsbridge.StrutsPortlet</portlet-class>
<init-param>
<name>ServletContextProvider</name>
<value>com.nabhinc.portlet.strutsbridge.impl.ServletContextProviderImpl</value>
</init-param>
<init-param>
<name>ViewPage</name>
<value>....</value>
</init-param>
<init-param>
<name>HelpPage</name>
<value>....</value>
</init-param>
<expiration-cache>-1</expiration-cache>
<supports>
<mime-type>text/html</mime-type>
<portlet-mode>VIEW</portlet-mode>
<portlet-mode>HELP</portlet-mode>
</supports>
<portlet-info>
<title>....</title>
<keywords>....</keywords>
</portlet-info>
</portlet>
ViewPage, HelpPage 和 EditPage 分别定义 view, help 和 edit 模式.
参照“已知的问题”章节，可见使用Struts桥改变模式时可能遇到的问题。
3.. 修改$STRINGBEANS_HOME/WEB-INF 目录下的web描述文件，里面包含Struts应用的配置。修改servlet class 必须为action Servlet 。
- 在action Servlet.中，用org.apache.portals.bridges.struts.PortletServlet 代替
org.apache.struts.action.ActionServlet
<servlet>
<servlet-name>action</servlet-name>
<servlet-class>org.apache.portals.bridges.struts.PortletServlet</servlet-class>
<init-param>
:
:
</servlet>
4. 配置 Struts 应用程序
在进行后面的步骤前，Struts 应用程序布置必须符合“假定项目”要求的规范
- Struts 桥包含的jar文件里含有四个增强的标签库（提供了对
Struts HTML JSP (包含 EL 变量)的支持. 分别是：
struts-portlet.tld
struts-portlet-e;.tld
struts-1.2.4-portlet-html.tld
struts-1.2.4-portlet-html-el.tld
这些增强的Struts HTML JSP 标签(htmlform, htmllink, htmlrewrite,
htmlrewrite, and htmlimg) 用来解析资源url ，如图片 javascripts 以及样式表等等
想使用这些标签，需要先在web.xml文件中定义这些标签的映射。如下：
<%@ taglib uri=”http://portals.apache.org/bridges/struts/tags-portlet-html” prefix=”html” %>
或者
<%@taglib uri=”http://portals.apache.org/bridges/struts/tags-portlet-html-el “prefix=”html-el” %>
对于 html链接，html重写，附加的actionURL属性，renderURL属性或resourceURL属性，可以指定URL 生成或重写的类型。如果没有指定，默认是renderURL=true
在引用图片时，使用html标签，会有一个小的改变。例如：
<img src=..images/struts-bridge.gif>
改成
<html:image src=”..images/struts-bridge.gif” />
- 在增加的上面的 html link 属性, url 类型必须在
struts-portlet-config.xml ( 如果不存在，您需要在$STRUTS_APP_HOMEWEB-INF 目录创建这个文件)中指定.
Action 或 解析的URL 的所在路径都要配置。资源路径应该是资源URL类型。
通常的struts-portlet-config.xml 的配置如下：
<?xml version="1.0" encoding="UTF-8"?>
<config>
<render-context>
<attribute name="errors"/>
<attribute name="message" keep="true"/>
</render-context>
<portlet-url-type>
<action path="/shop/add"/>
<action path="/shop/switch"/>
<action path="/shop/newOrder"/>
<render path="/shop/newOrderForm"/>
<action path="/shop/listOrders"/>
<resource path="/images/"/>
</portlet-url-type>
</config>
如果需要各个请求这间保留特定的请求参数，render-context 需要用到。render-context
这个保留属性使消息对象在下次Action请求或URL改变时都能可用。没有这个属性，这些对象仅仅只能使用一次。
关于 Struts 使用的完整说明在：
http://portals.apache.org/jetspeed-2/multiproject/portals-bridges-struts/features.html