用户使用手册

摘 要

本部分将指导用户进行FlexPorlet的安装及使用。FlexPortlet是用JAVA编写的，遵循JSR168规范的的Portlet，这里以Pluto做为Portal服务器，首先安装Pluto1.0.1，然后在其基础上部署FlexPortlet。成功安装好，我们可以借助FlexPortlet来部置我们的非Portal页面。

一、       运行环境/系统使用说明

FlexPortlet是用JAVA编写的，遵循JSR168规范的的Portlet，理论上说可以运行在一切符合JSR168规范的Portal服务器上，现通过测试的Portal容器包括Pluto、Jetspeed2和IBM WebSphere Portal Server。

二、       软件安装

1.   服务器的安装（这里以windowsXP下安装Pluto为例）

1)        下载pluto

Pluto的官方网站：http://portals.apache.org/pluto/

Pluto_1.0.1的下载地址：http://archive.apache.org/dist/portals/pluto/BINARIES/v1.0.1/pluto-1.0.1.zip

2)        安装pluto

在安装pluto-1.0.1之前需成功安装并配置JDK5.0，如何安装JDK这里不再累述，解压下载后的压缩包pluto-1.0.1.zip到任一目录，安装完成。

3)        配置pluto

Pluto默认使用ISO8859-1字符编码处理显示页面，如果需要改变这个设置，需要修改<Pluto-home>\pluto-1.0.1\ webapps\pluto\WEB-INF目录下的WEB.xml，打开WEB.xml找到如下代码：

去掉<init-param>部分的注释，并设置charset的<param-value>为你需要的字符编码，这里我们将使用utf-8，修改后的代码如下面的样子：

4)        运行pluto

进入<Pluto-home>\pluto-1.0.1\bin，点击startup.bat，服务器开始运行，如图4.1所示。

图4.1 pluto服务器运行窗口

5)        测试pluto

用浏器打开http://localhost:8080/pluto/portal，成功运行结果图4.2所示。

图4.2 pluto服务器页面

2.   从二进制代码包的安装

1)        点击左侧菜单的[Admin]进入服务器的portlet安装页面。

2)        在Deploy War Admin Portlet内选择FlexPortlet.war进行提交上传，如图4.3所示。

图4.3 上传FlexPortlet.war

3)        在随后的Deploy War Admin Portlet内设置Layout信息，如图4.4所示。

图4.4 配置portlet layout

4)        提交后成功后确认设置，点击[Submit]，如图4.5

图4.5 确认layout页面

5)        重启pluto，或直接部置FlexPortlet，完成安装，如图4.6所示。

图4.6 完成部置FlexPortlet

6)        查看运行FlexPortlet，如图4.7。

图 4.7 FlexPortlet 初始化显示页面

图4.8 FlexPortlet的初始配置页面

三、       软件使用

1.   选项设置

FlexPortlet遵循标准的JSR168编写而成，用户可以根据自己的需要调节portal.xml。FlexPortlet提供了一个ParseChartset初始化选项，用来设置对上传文件的解析字符编码，如：上传的文件为UTF-8编码，则设置此项也为UTF-8。如果不设置，将使用系统默认编码。为保证你能正确的使用FlexPortlet请确保“你要上传的文本文件编码”、“pluto的web.xml内的charset值”和“FlexPortlet的ParseChartset值”一致。

2.   上传文件压缩包

上传的文件的压缩包必须为.zip文件。上传的.zip文件自动解压到［安装根目录］，此［安装根目录］由FlexPortlet根据Portlet Id生成，每个Portlet有一个唯一的[安装根目录] ，如图4.9所示。

3.   上传单个文件

上传的文件可以任何类型的文件，上传的文件将安装在用户当前所在目录内,如图4.9所示。

图4.9 FlexPortlet配置页面的详细说明

4.   目录操作

点击已安装的目录进入相应的目录，点击[Current Path]内目录将回到指定目录，如图4.10所示。

图4.10 目录操作示意图

5.   解析转换单个文件或整个目录

点选需要解析转换的文件或目录（可多选），然后点[parse files]进行解析转换操作。成功操作以后，被成功解析转换后的文件将在后面标有红色的completed字样。现在能够解析转换的文件有.jsp、.html和.html，解析转换的目录内所有符合该条件的文件都将被转换，包括此目录下更深层级目录, 如图4.11所示。

图4.11 解析转换操作示意图

6.   设置portlet的VIEW模式初始页面

点选需要设置为初始页面的文件，点击［select Index］进行设置操作，如图4.12所示。

图4.12 设置portlet的VIEW初始页

7.   查看转换后结果

设置成功后，点击进入VIEW模式就可以查看到运行结果。