职位搜索服务端软件使用说明书.doc

28
搜职天下服务端软件 V1.0
搜职天下服务端软件
使用说明书

1 软件概述
1.1 编写目的
随着网络的发展，越来越多的企业通过互联网进行招聘工作，为此本人开发了搜职天下服务端软件。为了确定软件的最终功能，使软件能够真正满足求职者的需求，更清晰、更明确、更有效的为求职者发送数据，本人针对开发的搜职天下服务端软件特编写了使用说明书，从而更好的建立起服务器端开发人员与用户的联系，并为未来的评价和激励奠定基础。
1.2 搜职天下服务端软件介绍
搜职天下服务端开发语言为Java、XML、JS、Ruby，部署环境为linux。数据来源是搜索引擎接口。主要负责接收用户发送的查询请求，然后将查询请求组合与搜索引擎交互取得商品信息。最后解析接收到的商品信息，显示给用户看。后台使用SQL server 2005数据库系统。
1.2.1 搜职天下服务端含义
搜职天下服务端主要用于数据存储，以及对客户端的请求作出相应，完成数据的交互等操作。
环境为：mysql数据库软件+rails框架
数据单元：数据库表
搜职天下服务端软件是整个软件的核心，提供给求职者最新的职位信息、招聘会信息和职场资讯信息，使求职者随时随地都可以使用手机找工作，帮助您不错过任何一份好工作。本服务端软件主要完成服务端功能，接收搜职天下手机客户端发来的请求，回复相关内容给手机客户端。主要用于数据存储，以及对客户端的请求作出相应，完成数据的交互等操作。
1.2.2 搜职天下服务端主要功能
客户端
Ruby on rails
mysql
数据

将搜职天下手机端与服务器端基本的数据同步，使客户端功能有限实现。
目前已经实现的功能如下：
1.2.2.1 可完成数据的增、删、改、查功能。即可在数据表中增加、删除、修改、查询记录。
1.2.2.2 前十查询功能，即可随时查询、返回任一榜单前十条记录信息。
1.2.2.3 姓名查询功能，即输入姓名查询该姓名所对应的榜单记录信息。
1.2.2.4 中心查询功能，即可随时根据某条记录，查询任一榜单位于这条记录前五、后五名的用户记录信息。
1.2.2.5 范围查询功能，可根据任意榜单的区间数据，查询出位于这一区间的所有记录。
1.2.2.6 查询更新功能，通过客户端请求信息，判断数据库中是否存在相同数据，若查得信息，则对相应的字段值进行替换，若记录不存在，则新建相应的信息。
1.2.2.7 排序查询功能，通过客户端的请求信息，查询任意数量的记录，并对返回的记录进行排序。
1.2.2.8 购物榜单批量上传功能，完成若干条购物记录信息的上传功能，服务器对客户端的请求做出解析，提取出相应的记录，于数据库端新建记录，存储购物记录数据。

1.3 启动程序
本演示程序的服务器端部分：Script目录下的Server服务器。

1.4 数据库软件及版本号
mysql软件（版本号5.5）

2 搜职天下服务端启动过程
搜职天下服务端启动过程有2种方法：

2.1 服务器系统启动过程（第1种方法）
在图1中输入cd list_self命令，进入list_self项目目录中。

图1

图2
在图2中输入ruby .script/server命令，启动网络服务器。

图3
启动网络服务器成功之后，则进入图3所示的界面。

2.2 服务器系统启动过程（第2种方法）
首先进入InstantRails-2.0-win文件夹，运行InstantRails.exe，会出现如图4所示的提示框。

图4
选择“是”，则会跳出如图5所示的服务启动主页面。

图5

图6
点击图6篮圈标注的按钮，则会出现图7所得界面。

图7
将鼠标放在“Raila Applications”上面，则会呈现图8中显示的列表页面。

图8
选择“Manage Rails Applications”项，进入图9所示的页面。

图9
图9中在“Rails Applications”项下选择“caree”，如图10所示。

图10
然后选择右侧的“Start with Mongrel”按钮（图11圆圈圈标注），则服务器启动成功。

图11
服务器启动后会出现服务器启动命令行，如图12所示。

图12
3 服务器数据库管理
在服务器启动成功后，就可以访问该服务器上的网页，见图13。

图13
图13访问的url为：http://localhost:3002/lzj/caree。
localhost为本地地址
3002为端口号。

此时，caree项目已加载到服务器。
我们可以查看数据库的表结构（图14）：

图14
Field项下的列表是数据库表里面的域；
Type指域的类型；
Null指是否允许为空
Key指是否为关键字
Default指默认值；
Extra指一些描述信息。

图15
在服务器启动成功后，我们还可以访问另一个服务器上的网页。
访问url：http://localhost:3001/sta/index，如图15。
其中，localhost为本地地址；
3001为端口号；
Sta为控制的类；
showall为对应的方法。
从图15中我们可以看出数据库表有3项：排行榜、理财信息和收藏信息。

首先我们先看一下排行榜。点击“排行榜”则跳转到图16所示的界面。

图16

3.1 “增删改查”功能

图17
首先介绍数据的“增删改查”功能。如图17中，增删改查选项有“新建”、“删除”、“修改”、“全部”4个按钮（篮圈所示），可完成数据的增、删、改、查功能，即可在数据表中增加、删除、修改、查询记录。
3.1.1 “新建”按钮
点击排行榜主页的“新建”按钮，则跳转到图18中的页面。

图18
在图18中可填写姓名及签到、收藏、评论、分享、购物、理财、成就的次数，点击提交即可（如图19）。

图19
提交成功之后，则会跳转到榜单数据界面，我们可以看到刚才添加的angelno信息（图20）。

图20
3.1.2 “删除”按钮
返回排行榜主页，点击排行榜主页的“删除”按钮，则进入删除页面（图21）。

图21
在图21姓名栏中输入要删除的榜单名字或者直接输入ID号，点击提交即可。

3.1.3 “修改”按钮
返回排行榜主页，点击增减删除项下的“修改”按钮，则进入修改页面（图22）。

图22
在图22中我们可以输入要修改数据的姓名，新修改的数据，点击提交即可，如图23。

图23
在提交完成后，则会跳转到新的榜单数据界面，我们可以看到刚才修改的angelno信息（图24）。

图24
3.1.4 “查询”按钮
返回排行榜主页，点击“增删改查”项下的“查询”按钮，则进入图25所示的查询页面。

图25
3.2 “前十查询”功能
下面介绍数据的“前十查询”功能，即可随时查询、返回任一榜单前十条记录信息。
下拉图26中的“前十查询”分类列表，可以呈现出分类列表：签到榜、收藏榜、评论榜、分享榜、购物榜、理财榜和成就榜。

图26
在“前十查询”列表里面选择签到榜，点击查询，则出现图27所示的签到榜界面。图27中的签到榜会根据签到的次数由大到小排列出来。
由此可见，前十查询功能，即可随时查询、返回任一榜单前十条记录信息。

图27
如果您想查询收藏榜、评论榜、分享榜、购物榜、理财榜、成就榜等有关信息，可以根据上述的方法选择好之后点击查询即可。

3.3 “姓名查询”功能
接下来讲解“姓名查询”的相关功能。
我们还可以在图28中输入想查询的姓名，如lele，如图28。

图28

在图28中输入姓名“lele”，点击查询即可查询到lele在签到榜、收藏榜等各个榜单中的活动次数及数据表ID，如图29。

图29
3.4 “中心查询”功能
中心查询功能，即可随时根据某条记录，查询任一榜单位于这条记录前五、后五名的用户记录信息。

图30
如图30，在中心查询项下输入姓名（如user3），选择签到榜，点击查询按钮，则会生成XML页面（图31），返回给客户端。

图31

3.5 调试功能

图32
图32中的调试部分为两个功能函数:rho_query_sort和rho_query_update。

3.5.1 rho_query_sort讲解
点击“rho_query_sort”按钮，则会跳转到图33所示的页面。

图33
其功能如下：
rho_query_sort用来响应客户端发来的查询请求功能，需要的参数为sig和num，sig为客户端需要查询的哪个榜单，num为客户端要求返回的记录数量。结果通过XML文件形式返回；
操作实例：

图34

如在图34中输入num为5，sig为签到榜，点击提交则会跳转到图35中所示的XML页面。

图35

3.5.2 rho_query_update讲解
下面介绍调试部分的rho_query_update功能：
rho_query_update用来响应客户端的查询及更新请求功能，客户端发来参数name,sig,value，服务器端通过name参数查得相应的纪录，若存在要查的纪录，则通过sig标志位找到相应的榜单信息，替换成新的value值，如无该纪录，则新建用户名为name的纪录，并将标志为sig的榜单赋值为value。
点击“rho_query_update”按钮，则会跳转到图36所示的页面。

图36
操作实例1：

图37
首先在图37中我们在姓名中输入姓名：lele，点击查询进入图38中的界面，可以确定lele在各个榜单中有记录信息。

图38
从图38我们可以看到lele在各个榜单的记录信息：如在签到榜中的记录数据为899。
返回主页面点击“rho_query_update”按钮，进入客户端的查询及更新页面。

图39
在图39中name中输入：lele；
sig选择：签到榜；
value输入：999，点击提交。
返回排行榜页面，在姓名中重新输入“lele”，点击查询。可以查看到lele在各个榜单中有记录信息（图40）：刚才输入的签到榜value值为999。

图40
操作实例2：针对各个榜单没有的记录信息。

图41
首先我们在姓名中输入姓名：玛丽（如图41），点击查询进入图42中的界面，可以确定玛丽在各个榜单中没有记录信息。

图42
返回主页面点击“rho_query_update”按钮，进入客户端的查询及更新页面。

图43
如图43，在姓名中输入姓名：玛丽。
sig选择：签到榜；
value输入：1000，点击提交。
返回各个榜单的前十条记录信息，可以看到榜单中已经生成姓名为“玛丽”的记录信息，其中签到榜的value数据为刚才输入的1000，如图44。

图44
以上2个操作实例讲解的是数据库中的查询更新功能，通过客户端请求信息，判断数据库中是否存在相同数据，若查得信息，则对相应的字段值进行替换，若记录不存在，则新建相应的信息。

图45
返回主页，点击表2中的“理财信息”如图45，进入理财页面（图46）。

图46
图46中的理财页面可完成数据的增删改查功能，即可在数据表中增加、删除、修改、查询记录。
点击“新建”按钮，则进入图47所示的新建页面。该页面中可输入姓名、日期和用户名，点击提交即可。

图47
返回理财页面，点击“删除”按钮，则进入图48所示的删除页面，输入想删除的用户名点击提交即可删除成功。

图48
返回理财页面，点击“修改”按钮，则进入图49所示的修改页面，输入想修改的姓名、日期和用户名，点击提交即可修改成功。

图49
返回理财页面，点击“查询”按钮，则进入图50所示的查询页面，我们可以查询到添加的name、date和username。

图50

图51
返回主页，点击表3中的“收藏信息”如图51，进入收藏信息页面（图52）。

图52
图52中的收藏信息页面可完成数据的增删改查功能，即可在数据表中增加、删除、修改、查询记录。

4 详细接口说明
手机客户端与服务器端需要两次通信，第一次获取返回的招聘信息总数。手机端通过返回的总数计算共需要显示多少页（每页固定返回15条信息，最后一页例外）。第二次就可以在参数中加pn，需要第几页的商品信息就将pn设置为多少，但是注意不要超过本次搜索的最大页数（该页数通过前面计算得到 信息总数除以15）。下面列出所有可能用到的参数信息：

pn
第几页,首页为1
例如：3
sort_type
排序方式
-1为相关度，1，聚合度，2薪资从低到高，3薪资从高到低
keyword
关键字
例如：销售
Origin
来源
例如：赶集网
City
城市
例如：北京
class
分类
例如：销售
price_min
最低薪资
例如：100
Price_max
最高薪资
例如：200
industry
行业
例如：医药，金融