OA系统Crivia-MVC部署指南

OA系统Crivia-MVC部署指南

1．
部署代码包

如图所示：

将crivia-*.jar文件，复制到e-cology目录的WEB-INF/lib目录中。

2．
配置Crivia MVC

为了能够使用Crivia MVC以及其延伸的功能（如流程代码管理中心、页面模型库等），需要为Crivia的MVC组件配置一个Servlet。

该Servlet的java类名称为：crivia.mvc.RequestSender，我们可以在MyEclipse等IDE中引入该类，查看其注释以取得准备好的配置格式，如下图：

也可以直接打开该类，查看该类文件的代码，并在最后取得配置，如下图：

点击上图中的类名，可以打开并查看该类文件的代码，并按照下图所示，可在代码末尾找到准备好的配置格式：

确保服务器上的web.xml没有配置过Crivia的MVC组件。

然后将配置信息粘贴到web.xml的</web-app>标签之前，如下图：

以下是对配置中各参数的说明：

<!--
Crivia
MVC Begin -->

<servlet>

<!—

◆ServletName属性，默认为RequestSender。

◆实际上只要不与其他Servlet冲突都可以。

◆但需要与最后的ServletMapping中的ServletName对应。

-->

<servlet-name>RequestSender</servlet-name>

<!—

◆Crivia的MVC组件的Servlet的类名。

◆即:crivia.mvc.RequestSender(区分大小写)。

◆该类包含在crivia-*.jar文件中，直接引用即可。

-->

<servlet-class>crivia.mvc.RequestSender</servlet-class>

<!—

◆参数Executer(不区分大小写)，表示Executer所在的Package，建议提供。

◆Executer是Crivia-MVC组件的控制器接口，提供该Package可表示项目中的控制器所在的Package根目录，如项目中的控制器存放在weaver.criviaMVC.executer以及其子目录下，则可配置weaver.criviaMVC.executer (区分大小写)。

◆若项目存在多个存放控制器的Package根目录，可配置多个该参数并以Executer开头，如Executer-A，Executer-B等等。

◆也可以不配置Executer参数，但这样做的话，Crivia会尝试查找整个项目的控制器，因此还是建议提供这个参数。

-->

<init-param>

<param-name>executer</param-name>

<param-value>weaver.criviaMVC.executer</param-value>

</init-param>

<!—

◆参数Loading(不区分大小写)，表示Loading所在的Package，若未使用到Loading接口建议删除此配置。

-->

<init-param>

<param-name>loading</param-name>

<param-value>weaver.criviaMVC.loading</param-value>

</init-param>

<!—

◆参数Show(不区分大小写)，表示Show所在的Package，若未使用到Show接口建议删除此配置。

-->

<init-param>

<param-name>show</param-name>

<param-value>weaver.criviaMVC.show</param-value>

</init-param>

<!—

◆参数pageDataLog(不区分大小写)，配置此参数后将会向控制台输出数据传输记录，建议非调试错误的情况下，删除此配置。

-->

<init-param>

<param-name>pageDataLog</param-name>

<param-value>1</param-value>

</init-param>

<!—

◆参数requestEncoding (不区分大小写)，request编码，默认为GBK(E-cology7项目使用)，若为E-cology8项目使用，需要设置成UTF-8，建议提供。

-->

<init-param>

<param-name>requestEncoding</param-name>

<param-value>UTF-8</param-value>

</init-param>

<!—

◆参数responseEncoding (不区分大小写)，response编码，默认为GBK(E-cology7项目使用)，若为E-cology8项目使用，需要设置成UTF-8，建议提供。

-->

<init-param>

<param-name>responseEncoding</param-name>

<param-value>UTF-8</param-value>

</init-param>

<!—

◆参数ECADeployer (不区分大小写)，流程集成开发代码管理中心的页面名称，可选提供。

◆可用于更改流程集成开发代码管理中心的页面名称。

-->

<init-param>

<param-name>ECADeployer</param-name>

<param-value>ECADeployer</param-value>

</init-param>

<!—

◆参数EcologyVersion (不区分大小写)，Ecology大版本号，默认为7，若为E-cology8项目需要设置为8，建议提供。

◆必须设置正确的版本号，否则一些功能将会不正常。

-->

<init-param>

<param-name>EcologyVersion</param-name>

<param-value>8</param-value>

</init-param>

</servlet>

<!—

◆ServletMapping元素。

◆其中的ServletName属性需要与上述Servlet元素中的ServletName属性对应。

-->

<servlet-mapping>

<servlet-name>RequestSender</servlet-name>

<!—

◆URL-Pattern元素请以*.开头，结尾默认为c(简写)或crivia(已经存在.c的servlet)。

◆也可以更改为其他诸如abc之类的后缀，但建议使用c。

-->

<url-pattern>*.c</url-pattern>

</servlet-mapping>

<!--
Crivia
MVC End -->

3．
总结

总的来说，就是两步，一是部署jar文件，二是配置MVC组件中的crivia.mvc.ReqeustSender类作为Servlet，建议提供的参数为：控制器的package(根目录)，request和response的编码，Ecology版本(支持e7和e8切换),url-pattern元素建议使用*.c。