搜职天下服务端软件使用说明书.doc

15搜职天下服务端软件 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 railsmysql数据搜职天下服务端将搜职天下手机端与服务器端基本的数据同步，使客户端功能有限实现。搜职天下服务端接收手机客户端的查询请求，将查询请求发送给搜索引擎进行检索，搜索引擎会将检索到的结果以字符流的方式返回给搜职天下服务端。搜职天下服务端会将从搜索引擎端接收到的信息按正则表达式匹配不同的职位信息和每条职位信息的多个栏位。然后以XML格式返回给手机客户端。首先，手机客户端发送查询请求到/career/get_groupnum?keyword=&class=&city=&origin=&salary_min=&salary_max=&industry=&latitude=&longitude=&distance=&address=服务端会返回搜索到的招聘信息数量，比如：1000。上面URL列出的参数可以有一个或者多个，每个参数的含义见详细接口说明。然后客户端第二次发送请求到/career/result?keyword=&class=&city=&origin=&salary_min=&salary_max=&industry=&latitude=&longitude=&distance=&address=&start=&quantity=&sort_type=两次发送的参数内容应保持不变，第二次参数中需要多几个参数：start（起始位置），前面返回了职位数量，start为从第几个职位信息开始，默认为从1开始。Quantity（每次返回信息数量），默认为30条，信息以xml格式返回。客户端用户提交查询请求服务端接收用户查询请求后返回信息第一次发送请求返回搜索到的信息总数第二次发送请求，并指定页数以xml格式返回职位招聘信息下面列出几个测试url，读者可以在浏览器中打开查看返回结果。/career/get_groupnum?keyword=%E9%94%80%E5%94%AE只有一个keyword参数，返回结果数量/career/get_groupnum?keyword=%E9%94%80%E5%94%AE&latitude=41.811932&longitude=123.382621&distance=1条件中加了经纬度和距离参数，返回结果数量/career/get_groupnum?keyword=%E9%94%80%E5%94%AE&address=%E4%B8%AD%E5%85%B3%E6%9D%91&distance=1条件中加了地址和距离参数，会将距离转为经纬度进行搜索/career/result?keyword=%E9%94%80%E5%94%AE&address=%E4%B8%AD%E5%85%B3%E6%9D%91&distance=1条件中没有加start和quality参数，默认start为0，quality为15/career/result?keyword=%E9%94%80%E5%94%AE&address=%E4%B8%AD%E5%85%B3%E6%9D%91&distance=1&start=20&quantity=1条件中加了start和quality参数，start为20，quality为11.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在服务器启动成功后，就可以访问该服务器上的网页，见图13和图14。图13图143 详细接口说明URL中全部参数如下名称参数介绍参数举例sort_type排序方式-1为相关度，1，聚合度，2为薪资从低到高，3为薪资从高到低keyword关键字例如：销售origin来源例如：赶集网city城市例如：北京class分类例如：销售salary_min最低薪资例如：100salary_max最高薪资例如：200industry行业例如：医药，金融start起始位置例如：1quantity返回数量例如：30latitude纬度例如：41.811932longitude经度例如：123.382621distance距离（单位千米）例如：0.5或1或1.2address地址例如：知春路、中关村名称latitude、longitude、distance、address为距离搜索时需要发送的参数，可以为（经度+纬度+距离）也可以为（地址+距离）。经纬度和地址为等价搜索条件，不能共存。4 返回XML文件介绍栏位名称栏位介绍website招聘信息发布网站job_name职位简述release_time发布时间description职位详述emailEmail地址comment评论salary薪资view_num招聘信息浏览次数headcount招聘人数comment_num招聘信息评论次数pic_link招聘网站图片链接http_link来源网站链接address公司地址telphone公司电话company_introduction公司介绍longitude经度latitude纬度city公司所在城市website_num聚合后招聘相同职位的网站数量fidsT4I文件idsalary_range薪资区间type招聘信息行业分类company招聘公司名5 有聚合时根据fid获取对应招聘信息XML文件由于我们对相同公司的多个职位做了聚合，前面的XML接口是返回了聚合后的第一条招聘信息。在返回的信息栏位里有一个fid栏位，该栏位里包含了相同公司的其它招聘信息fid.如果我们想查看该公司其他招聘信息，将会用到下面的接口。该接口只有一个参数fids,可以一次获取多个fid对应的招聘信息，多个fid中间用空格隔开，同样以XML格式返回。/career/content?fids=4142/career/content?fids=4142 41366 result视图返回XML页面实例- 赶集网招聘 搜索引擎 分词算法工程师 2012-10-08 职位描述：【招聘要求】1、计算机或通信类相关专业，大专以上学历，有C/C+/Java应用开发经验；2、对搜索或中文分词算法有经验或有兴趣；或对Hadoop有了解；3、学习能力强，踏实勤奋，有独立解决技术问题的能力，有高度的责任感，具有良好的沟通能力、团队合作精神；4、本公司有多个职位招聘，投递简历时请注明应聘职位。 zxtk_ 面议 0 若干 0 6/pic_link/zxtk-default.jpg /zpruanjiangongchengshi/348779806x.htm 北京市海淀区中关村东路18号财智国际大厦C-1609 公司简介：方正国际软件有限公司是成立于北京中关村园区的高科技企业，专注于移动互联网的技术开发和服务。公司战略定位为：立足于移动信息市场，以3G发展为契机，以移动互联网为方向，以移动计算、移动存储、嵌入式开发、移动数据通信等技术为手段，为客户提供实用新颖的移动信息产品与服务。 123.391263 41.808599 10 4728 4735 4851 8580 9859 26448 26675 26799 32601 32788 3000.00 3000.00 计算机/网络/通信招聘 方正国际软件有限公司 7 content视图返回XML页面实例 - - 大街网 手机软件销售代表 2012-10-08 职位描述：职位要求：1. 大专以上学历，有客户开发和服务经验者优先；2. 勤于开拓创新、有责任心、有韧劲、工作积极主动；3. 熟练使用office办公软件，有良好的沟通和理解能力；4. 待遇优厚。 zxtk_ 面议 0 若干 0 6/pic_link/zxtk-default.jpg /4384cf56-98fe-462c-9dae-81cdba0aadec.html公司简介： 121.477905 31.207451 销售 方正国际软件有限公司 - 大街网 电子商务销售专员 2012-10-08 职位描述：任职要求： 1.熟悉B2C商城和团购网站，有电子商务和团购网站销售渠道，有良好的电子商务和团购网站客户人际关系； 2.亲和力强，口才好，热爱销售工作； 3.学习能力强，踏实勤奋，有独立解决技术问题的能力，有高度的责任感，具有良好的沟通能力、团队合作精神； 4.全职实习均可，有销售经验者优先考虑。 zxtk_ 面议 0 若干 0 6/pic_link/zxtk-default.jpg /b1aa1d47-f693-48ee-af34-dd9e27564c7f.html公司简介： 0.0 0.0 销售 方正国际软件有限公司 8 操作实例图15点击图15中的周边图标，则会弹出图16所示的输入框。用户可输入地址、关键字、选择周边距