系统服务化构建-项目整体框架

本篇文章旨在讨论如何组织通用型项目代码结构,以PHP YII2框架为例做说明,设计思想与语言本身无关。

以下是本文的大纲

业务服务型项目系统定位

基础功能组件

业务功能组件

基础功能组件与业务模块组件异同

宿主工程

模块之间调用关系

业务服务型项目系统定位

业务服务型项目,包括业务对外SOA API接口,微服务接口,业务中台服务,业务服务中间件,不包括通用的官网类似的MVC项目,CMS系统。

采用自顶而下,分而治之的思想,业务服务型项目主要包括基础功能组件,业务功能组件,公共方法类库,宿主工程四大部分

基础功能组件

基础功能组件由具体的基础功能模块构建而成,基础功能组件应该满足以下几个条件

1 功能与实际业务无关。属于系统底层框架或者代码模块

2 代码结构稳定,改动频率小,如果改动需要经过多人审核,review。

以上两点是衡量某项功能是否属于基础功能模块的基本标准。我们常见的可以纳入基础功能范围的有 短信服务,移动端推送功能服务,文件存储服务,固定的基础服务,Excel Word文件导出等

业务功能组件

业务功能组件由具体的业务模块构建而成,为满足产品或市场人员的需求为主。业务功能模块满足以下几个特定

1 功能灵活多变,同时兼顾解耦特定

2各个业务模块之间约定功能边界。

   单方向调用,避免蜘蛛网式的嵌套调用

3 通过接口或者本地RPC保持与基本功能组件层次化的调用

业务功能组件跟着产品线,由业务决定,常见的业务功能组件如用户信息组件,账户组件,支付中心,应用注册中心等。模块的定义,组件的边界决定于业务模型,需求定义,市场时机等多种因素。

基础功能组件与业务模块组件异同

1 解耦,稳定,可用

软件模块的基本要求必不可少。

2系统中的所处的层析清晰,不可混用。

3 满足功能的维度不同,前者更倾向于稳定,可用,后者更倾向于灵活,实用,解决实际问题。

前者在设计时更多考虑技术架构,后者更多考虑业务架构。注意是【更多】。技术架构以软件技术,软件工程理论为核心,业务架构更多依靠产品线,业务线的补充叠加实现。

4都会涉及到数据层访问,缓存

公共方法类库

公共方法类库是一些零散的代码,未纳入基础功能模块的代码模块。未纳入基础模块的原因包括不符合基础模块的规范,比如以下原因

1 同时兼顾基础模块和业务功能,耦合性较强,短期版本交付周期内无法解决。

2临时性的第三方组件,功能及稳定性待验证

3 不符合命名空间合作类库约束

常用的公共方法库包括 数据类型转化,对象类型转换,日期自定义函数等。

公共方法类型在系统中位置没有严格的约束,一般在业务组件中使用较广

宿主工程

宿主工程在系统中位于最上层,起到调用业务模块的左右。宿主工程在部署后直接暴露出来被消费者使用, 如网站,服务接口,或者控制台可执行程序。


以下部分以改造后的YII2框架为例来示例以上各个层次

backend就是宿主工程,如果以网站的形式公开服务,部署时的网站配置文件的根目录则指向backend的web目录下

source就是公共类库包括未纳入基础功能组件的代码块和一些公用的业务模型model



注:以上借助于框架特性,以YII2 Module的形式来组织代码,Module的具体使用案例及生成规则不在此文章中讨论。

业务模块如何调用基础模块

1保持命名空间use 的正确性

2宿主工程或者业务模块的配置文件引入被调用模块的Module配置项 如

3 以模块的方式调用

在宿主工程的主配置文件下,我们引入模块的配置。UserService,SecurityService,AdminService是模块名称。

'modules'=>[

'user'=>[

'class'=>'appcomponents\modules\user\UserService',

],

'security'=>[

'class'=>'infrastructure\modules\security\SecurityService',

],

'admin'=>[

'class'=>'appcomponents\modules\admin\AdminService',

],

],

项目整体框架是后续系统维护和扩展的基础,根据代码实现的功能进行对应位置的划分,这里的位置特指基础设施或者业务实现。代码层次清晰,代码对应得功能职责就会清晰明确。

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 157,924评论 4 360
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 66,902评论 1 290
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 107,716评论 0 239
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 43,783评论 0 203
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 52,166评论 3 286
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 40,510评论 1 216
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 31,784评论 2 311
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 30,476评论 0 196
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 34,196评论 1 241
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 30,459评论 2 243
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 31,978评论 1 258
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 28,321评论 2 252
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 32,964评论 3 235
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 26,046评论 0 8
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 26,803评论 0 193
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 35,530评论 2 271
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 35,420评论 2 265

推荐阅读更多精彩内容

  • Android 自定义View的各种姿势1 Activity的显示之ViewRootImpl详解 Activity...
    passiontim阅读 170,561评论 25 707
  • 发现 关注 消息 iOS 第三方库、插件、知名博客总结 作者大灰狼的小绵羊哥哥关注 2017.06.26 09:4...
    肇东周阅读 11,609评论 4 59
  • 该文章属于刘小壮原创,转载请注明:刘小壮[https://www.jianshu.com/u/2de707c93d...
    刘小壮阅读 92,685评论 266 518
  • 上周六,杭州大雨滂沱。 麦家理想谷却被一群爱书的人挤得满满当当的。他们满身风雨穿城而过,来参加一场别开生面的读书分...
    陪你读书_阅读 2,177评论 14 63
  • 初秋夜晚,星空璀璨。3岁的艾兰和5岁的哥哥加利普坐在海滩边,遥望着星空。 忽然,一颗流星飞过,加利普马上摇了摇艾兰...
    易芩阅读 405评论 0 2