用JSP写的一个返回测试数据的服务器

主要是为了日后复习和巩固

版本履历

2012年12月05日发布. DummyAPI 0.02版

追加功能

• 增加返回内容编码格式的设定
• 增加数据文件默认的返回类型为纯文本形式

预定追加功能

• 正则规则匹配功能的追加

2012年12月04日发布. DummyAPI 0.01版

版本功能

• 通过规则的指定，返回相应的数据(xml或者json).
• 支持online验证
• 支持http、https两种协议
• 支持get、post两种请求方式

配布设置方法(基于DummyAPI 0.02版)

一、运行环境的配置

访问共享 \\172.23.14.113\smart_framework\dummyapis ，下载共享中的Java运行环境 jdk16u33.zip 包到本地，解压jdk到任意目录。本例以D盘本目录为例。
解压完成之后，配置环境变量JAVA_HOME,步骤如下

1. 右击我的电脑，选择属性选项
   
2. 在属性设置页面，选择详细设置，再选择环境变量
   
3. 点击新建选项
   
4. 配置环境变量,变量名写：JAVA_HOME，变量值：填写jdk解压的路径地址
   

二、服务器Tomcat的配置

1. 访问共享 \\172.23.14.113\smart_framework\dummyapis ，下载共享中的 apache-tomcat-5.5.36.zip 包到本地，解压zip到任意目录。本例以D盘根目录为例。
2. 下载共享中的 dummyApiFramework.war 文件，并且将此文件复制到Tomcat目录下 webapps 文件夹中。
3. 进入Tomcat目录中的bin下，运行 startup.bat 文件，启动完成之后，再将其关闭。这时 webapps 中将生成 dummyApiFramework 文件夹(如下图)，这说明dummyApi部署成功。
   

• 注：共享中的Tomcat能够成功的应用Https协议的请求,应用其他Tomcat可能无法实现Https的请求，需要其他的手动配置。

三、工程数据的配置

1. 进入Tomcat目录中的webapps -> dummyApiFramework -> WEB-INF -> classes下，修改 webConfig.xml 文件。
   将 <basepath></basepath> 标记中 "D:\FrameworkDev\example\” 的路径，修改为自定义的路径，这个路径地址为导入工程数据的根本目录。
   将 <retpath></retpath> 标记中 "resources\"可修改为自定义的文件夹，这个文件夹在上一步指定的根本目录下，存放资源用。
   

    <globalConfigFileName> globalConfig.xml </globalConfigFileName> <!-- 全局配置文件的名字，可自定义。--> <retRuleConfigFileName> retRule.xml </retRuleConfigFileName> <!-- 规则文件名，可自定义。--> 

   
   
2. 进入上一步webConfig.xml中指定的根本路径(如果没有请创建)，创建 <globalConfigFileName> 标记中定义的配置文件，
   以下以globalConfig.xml名代替。
   打开globalConfig.xml文件,新加入 <project id="" urlfrom="" to="" charset="" /> 内容，其中id属性值为导入工程的id，urlfrom属性值为导入工程的名字，
   to属性值为导入工程的数据存放地址。
   DummyAPI0.02版 中追加 charset 属性，指定编码格式，此属性不设定，默认编码为UTF-8，可根据实际情况指定编码格式。
   
3. 在globalConfig.xml的同级目录中， 创建"id+config.xml"文件，id意思为第二步中project的id值，
   这个文件的命名是id值加"config.xml"来命名，例如："p001config.xml"。
   创建完成"id+config.xml"文件后，打开进行编辑。
   

    <online>true</online> <!-- 是否可以利用，值：true/false. --> <protocol>http;https</protocol> <!-- 设置网络协议支持类型。 --> <requestType>post;get</requestType> <!-- 设置允许的请求类型。--> 

   
   
4. 在根本目录下，创建并进入第一步 <retpath> 标记中定义的资源文件夹，以下以resources表示。
   在resources下，创建第二步中to属性值指定的目录，如果没有to属性值，则创建urlfrom属性值命名的目录，如下图，左部分。
   目录创建完成之后，将准备好的数据文件放入这个目录。
   
5. 在数据文件的同级目录下，创建第一步中 <retRuleConfigFileName> 标记中定义的规则文件，并编辑它。
   编辑内容请参照下图， <rule name="" Return="" type=""> name规则名称，Return数据文件名。
   type为数据格式, DummyAPI0.02版 中此属性未指定默认文件内容以文本格式返回。
   <urlPattern> 匹配请求的url，以此判断需要返回的数据文件。
   <postParams> post类型的请求，且有Parameter参数的情况下才需要配置。
   <param name="param1" value="ed"/> name为Parameter参数名称，value参数值。
   
6. 数据文件内容的格式
   xml格式的数据文件
   
   json格式的数据文件
   
7. 请求数据的访问地址的录入格式
   运行Tomcat根目录中bin下startup.bat
   HTTP协议：
   http://localhost:8080/dummyApiFramework/project1/abc
   http://localhost:8080/dummyApiFramework/project1/getfrient/abc
   http://localhost:8080/dummyApiFramework/project1/cde?id=2&code=3
   HTTPS协议：
   https://localhost:8443/dummyApiFramework/project1/abc
   http://localhost:8080/dummyApiFramework/project1/getfrient/abc
   https://localhost:8443/dummyApiFramework/project1/cde?id=2&code=3

四、log日志的配置

• 进入Tomcat目录中的webapps -> dummyApiFramework -> WEB-INF -> classes下，修改 log4j2.xml 文件。
  <RollingFile>标记中fileName的值为log文件输出的地址，可根据喜好，自行设置。
  

   <RollingFile name="rollingFile" fileName="D:/dummyapis.log" filePattern="" append="false">