远程服务器的编写与部署

在此文件中配置一个为远程报表设计器提供服务的Servlet，如上述例子代码介绍中的RemoteServer，配置如下：

<servlet><servlet-name>remoteServer</servlet-name><servlet-class>com.runqian.report4.remote.example.RemoteServer</servlet-class><init-param><param-name>usersConfig</param-name><param-value>/WEB-INF/users.properties</param-value></init-param><init-param><param-name>semanticsFile</param-name><param-value>demo.xml</param-value></init-param><init-param><param-name>dsConfig</param-name><param-value>/WEB-INF/remoteDataSource.xml</param-value></init-param><load-on-startup>10</load-on-startup></servlet><servlet-mapping><servlet-name>remoteServer</servlet-name><url-pattern>/remoteServer</url-pattern></servlet-mapping>

这是润乾提供的一个实现实例，启动参数的含义是：

本示例中用户信息文件放置在WEB-INF目录中，格式如下：

root=管理员,root,1111111111,-1,month=2,岗位;职称=职称名称;部门表=部门名称:上级部门user1=报表读取者,user1,0010001001,1000,userName=报表读取者;userId=user1;dept=salesuser2=报表设计者,user2,1010001111,5000,userName=报表设计者;userId=user2;dept=salesuser3=语义层编辑者,user3,1011110001,300, userName=语义层编辑者;userId=user3;dept=IT

每一行代表一个用户，等号左边的是用户登录ID，右边六项分别是用户名、密码、权限、记录条数报警值、会话变量、无权访问的语义视图和字段，权限是一个二进制表示的串，每一位的含义如下（从右往左为1,2......10位）：

1位 是否能打开远程报表

2位 是否能保存远程报表

3位 是否能另存为远程报表

4位 是否能保存报表到本地

5位 是否能保存语义

6位 是否能另存语义

7位 是否能保存语义到本地

8位 是否能获取指定名称的语义层

9位 是否可以修改会话变量

10位 是否可以直接使用数据库对象，目前只控制到各种SQL及存储过程编辑

记录条数报警值为-1表示无限制，否则到达指定数量将报警。 会话变量的格式如下：arg1=value1;arg2=value2;……;argn=valuen

无权限的语义视图和字段的定义如下：view1;view2=col1:col2……:coln;……viewn 如果整个视图没有权限访问，则紧紧写出视图名即可，多个之间分号分隔；如果仅仅是某个视图中的部分字段没有权限访问，则用view=col1:col2:……:coln;的格式描述，多个字段之间冒号分隔，视图间分号分隔

如果直接采用润乾提供的例子远程服务器，那么不需要进行任何部署，因为润乾提供的report4.jar已经包含了相关的类；

如果自己重写远程服务器，那么需要把自己写的相关类部署在应用的类路径下，一般是WEB-INF\classes，参照本小节3.1的介绍进行相关servlet的配置。主要需要修改两个地方：

1. web.xml

web.xml中要修改远程服务器类名和servlet路径，以下是例子带的远程服务器RemoteServe的配置，需要修改成自己的：

<servlet>    <servlet-name>RemoteServer</servlet-name>    <servlet-class>com.runqian.report4.remote.example.RemoteServer</servlet-class>    <init-param>      <param-name>usersConfig</param-name>      <param-value>/WEB-INF/users.properties</param-value>    </init-param>    <init-param>      <param-name>semanticsFile</param-name>      <param-value>yy0718.xml</param-value>    </init-param>    <init-param>      <param-name>dsConfig</param-name>      <param-value>/WEB-INF/remoteDataSource.xml</param-value>    </init-param>    <load-on-startup>10</load-on-startup>  </servlet>   <servlet-mapping>    <servlet-name>RemoteServer</servlet-name>    <url-pattern>/RemoteServer</url-pattern>  </servlet-mapping>

2、远程设计器登录界面

登录远程设计器时，URL参数需要修改，例子中远程服务器是RemoteServe时URL型如：http://192.168.0.173:8001/report/RemoteServer，需要修改成web.xml中配置的servlet路径。

前面介绍的例子里，是把用户信息存在配置文件中，而远程数据源的连接参数也存在配置文件中，且和用户无关。

实际应用中可能更加复杂，例如用户信息往往和用户表挂钩，存在数据库里，远程数据源的连接参数往往也和角色或者用户组等关联，不同的用户连接参数可能不同。

因此，实际编写远程服务器的时候，可以不在初始化的时候读取用户信息，因为这样还占用内存；建议在用户登录的时候从数据库里读取用户信息，返回给客户端，用户信息除了包括会话变量、权限、还可以包括数据库连接参数等。这样一来，UserManager类基本就没用了。