- 1、原创力文档(book118)网站文档一经付费(服务费),不意味着购买了该文档的版权,仅供个人/单位学习、研究之用,不得用于商业用途,未经授权,严禁复制、发行、汇编、翻译或者网络传播等,侵权必究。。
- 2、本站所有内容均由合作方或网友上传,本站不对文档的完整性、权威性及其观点立场正确性做任何保证或承诺!文档内容仅供研究参考,付费前请自行鉴别。如您付费,意味着您自己接受本站规则且自行承担风险,本站不退款、不进行额外附加服务;查看《如何避免下载的几个坑》。如果您已付费下载过本站文档,您可以点击 这里二次下载。
- 3、如文档侵犯商业秘密、侵犯著作权、侵犯人身权等,请点击“版权申诉”(推荐),也可以打举报电话:400-050-0827(电话支持时间:9:00-18:30)。
- 4、该文档为VIP文档,如果想要下载,成为VIP会员后,下载免费。
- 5、成为VIP后,下载本文档将扣除1次下载权益。下载后,不支持退款、换文档。如有疑问请联系我们。
- 6、成为VIP后,您将拥有八大权益,权益包括:VIP文档下载权益、阅读免打扰、文档格式转换、高级专利检索、专属身份标志、高级客服、多端互通、版权登记。
- 7、VIP文档为合作方或网友上传,每下载1次, 网站将根据用户上传文档的质量评分、类型等,对文档贡献者给予高额补贴、流量扶持。如果你也想贡献VIP文档。上传文档
查看更多
HSFramework应用服务器手册
编写
描述:这是一个自制的Linux系统下的应用服务器,及其对应分布式应用开发框架。该框架提供基于UDP的进程间和分布式的服务调用和主题发布与订阅。且具有平均负载均衡、服务自动发现和主题自动发现的特性。
特性:
服务调用;
一对多的主题发布和订阅;
异步请求应答交互;
分布式应用服务部署;
服务自动发现;
主题自动发现;
服务调用的平均负载均衡;
引用计数智能指针;
单例模式模板;
基于智能指针的线程池;
可配置日志
应用服务:
应用服务器目录结构如图1所示:
图1 应用服务器目录结构
app目录:存放待部署应用程序;
bin目录:应用服务命令;
conf目录:应用服务器配置目录;
tmp目录:存放应用服务器运行时产生的临时文件
MicroKernel进程为应用服务器核心进程,负责服务发现,定位,负载均衡,主题发布。该进程放置于app目录下。
MicroKernelConf.data配置文件主要配置应用服务器运行需要配置的参数。配置项如图2所示:
图2 配置文件
Interface: 应用程序通信接口;
ReceptorPort:应用服务器核心进程接收消息使用的端口;
AppMinPort:应用服务器中应用程序的接收消息端口最小值;
AppMaxPort:应用服务器中应用程序的接收消息端口最大值;
Log.data配置文件主要配置应用服务器所采用的日志方式。配置项如图3所示:
图3 日志配置文件
应用:
在对应平台上编译MicroKernel工程,将编译成功的目标程序MicroKernel放置于app目录下。修改配置文件接收IP与端口和广播地址。
点击bin/ startup启动应用服务器。将利用框架开发的app部署在app/目录即可。
开发:
Eclipse方式
1)创建新应用工程。如图4所示:
图4 新工程
2)拷贝framework框架目录到工程的src目录下如图5所示:
图5 拷贝框架到新工程
3)加载框架所需库函数。右键点击工程目录,在弹出菜单中选择“属性”选项,通过 C/C++ Build-Settings-Tool Settings进入编译选项配置界面。在Libraries中添加线程库,添加后效果如图6所示:
图6 加载框架所用库
4)添加框架头文件路径。右键点击工程目录,在弹出菜单中选择“属性”选项,通过 C/C++ Build-Settings-Tool Settings进入编译选项配置界面。在GCC C++ Compiler的includes中添加framework路径,效果如图7所示:
图7 加载框架头文件路径
5)在主文件中包含框架头文件,并在主函数中,调用初始化环境函数,使新应用具有框架和应用服务器提供的功能,如图8所示:
图8 使用框架
非IDE方式:
创建工程目录,将框架文件夹拷贝到新创建的工程目录中,并拷贝框架makefile文件(makefile_frwk.mk)到工程目录下,如图9所示:
图9 非IDE方式工程实例
修改新建工程makefile文件,包含框架内容到编译选项中,如图10所示:
图10 包含框架的makefile实例
工程建立完成后,在代码中引用FrameworkContext.h即可使用框架提供的接口和功能。
模块交互
同步服务
以函数调用的方式提供服务。首先实现服务类,并在服务端注册该服务,客户端可通过服务ID获取该服务。
服务实现类必须申明并定义execute函数,参数为const修饰的指针类型。返回值为指针类型。
参数与返回值均为ISerialable接口的实现类。需实现串行化和解串行化函数。参数示例类如图11所示,结果示例类如图12所示,服务实现示例类如图13所示:
图11 参数示例类
图12 返回值示例类
图13 服务实现示例类
注册服务以便应用服务器中的客户端调用。注册方式如图14所示:
图14 注册服务示例
运行在应用服务器中的客户端,通过函数调用的方式调用服务端注册的服务。首先通过定位器获取一个服务代理,通过服务代理调用服务,客户端可以根据业务需求设置服务代理的超时时间(setTimeout参数单位为秒)和重试次数(setRetries)。该代理可以是本地的,或者远程的。本地服务是指该服务注册在同一进程内;远程服务是指该服务注册在另一进程或另一台服务器。
获取本地服务代理,调用服务示例如图15所示:
图15 通过本地代理调用服务
获取远程服务代理,调用服务示例如图16所示:
图16 通过远程代理调用服务
通过远程代理也可以调用本地服务。
异步服务
实现异步方式的请求和响应处理。服务端首先要定义服务实现类。并注册该实现类。
服务实现类必须申明并定义execute函数
文档评论(0)