【转】Web API项目中使用Area对业务进行分类管理

在之前开发的很多Web API项目中，为了方便以及快速开发，往往把整个Web API的控制器放在基目录的Controllers目录中，但随着业务越来越复杂，这样Controllers目录中的文件就增加很快，难以管理，而且如果有不同业务模块有重复的控制器名的话，还需要尽量避免。引入Area的作用就是把控制器按照不同的业务模块进行区分，方便管理，而且控制器名称可以重名。

1、Web API项目引入Area进行分类

Area在项目中可以称之为区域，每个Area代表应用程序的不同功能模块，Area 使每个功能模块都有各自的文件夹，文件夹中有自己的Controller、View和Model，但对于管理也增加了一定的难度。如果是Web API项目，我们可以把不必要的目录移除即可，简化对目录的管理。
引入Area可以是我们不同的业务模块可以重名，而且各个业务模块管理起来也更加方便，在原先的Web API项目里面，它们的目录是这样的。


虽然我们把它们的目录归类，但是它们还是存放在一个命名空间下的。

namespace MyWebApi.Controllers

 


这样使用虽然也没有什么问题，但是还是存在一些弊端，因此引入Area的方式对不同业务模块的控制器进行管理，以达到我们分类管理的目的。
引入Area前，我们的API路径如下所示

http://localhost:9001/api/User

引入Area后，我们把常规的权限管理、字典管理等基础模块放到Framework的Area里面，那么这个时候API路径和具体的Area相关，地址则变成了如下：

http://localhost:9001/api/Framework/User

我们再来看看具体的项目目录，Web API项目中使用Area后，Controller的目录如下所示。


除了在各个不同Area下有不同的控制器，而且也增加了一个**AreaRegistration.cs的文件，如对应Framework的Area，有一个FrameworkAreaRegistration.cs文件
这样对应下面的控制器，它的命名空间如下所示。

namespace WebAPI.Areas.Framework.Controllers

 

2、Web API项目对Area控制器的路径映射

上面小节介绍了使用Area来对Web API控制器的分类管理，并介绍了引入Area后对控制器位置、命名空间、Web API的URL等方面的不同。这样如果我们要解析对应地址的Web API，那么也需要做一定的处理，否则是无法找到对应的控制器，从而出现错误信息。
首先我们需要修改Web API里面WebApiConfig的配置信息，如下所示。


上面指定了默认的Web API映射，并指定结果只做JSON格式的输出（移除XML输出）。
为了对不同的Area实现API的地址处理，我们先设计一个基类，然后让不同的Area注册类继承它，方便统一处理。


其中基类Area注册类的CustomAreaRegistration类代码如下所示。


有了上面的基类映射 RegisterArea函数，我们只需要在子类设置对应的AreaName基类实现不同Area子类的正确映射API路径处理了。

复制代码

/// <summary>
/// 框架基础Area的注册类
/// </summary>
public class FrameworkAreaRegistration : CustomAreaRegistration 
{public override string AreaName {get {return "Framework";}}
}

复制代码

 

当然为了实现对Area的Web API控制器的URL正确解析，获取属于Action、Controller、以及对应命名空间的对象，那么还需要在global.asa.cs里面添加一行代码，如下所示。

 //对Web API的Area进行支持
GlobalConfiguration.Configuration.Services.Replace(typeof(IHttpControllerSelector),  new AreaHttpControllerSelector(GlobalConfiguration.Configuration));

 

其中AreaHttpControllerSelector是我们自定义的HTTP控制器地址解析器，需要根据我们的地址提取出具体的控制器、Area名称、程序集类型等，方便构建对应的解析器。

复制代码

private HttpControllerDescriptor GetApiController(HttpRequestMessage request)
{var controllerName = base.GetControllerName(request);var areaName = GetAreaName(request);if (string.IsNullOrEmpty(areaName)){return null;}var type = GetControllerTypeByArea(areaName, controllerName);if (type == null){return null;}return new HttpControllerDescriptor(_configuration, controllerName, type);
}

复制代码

 

有了这些基础的管理，我们就可以定义好我们所需要Area，然后构建具体业务范畴下的控制器接口即可。

3、Web API在客户端的接口调用

所有的Web API地址，都是与具体的Area有关系，例如在Framework业务下的字典模块，它们Web API配置的地址如下所示。

<!--字典Web API模块配置-->

<add key="DictType" value="http://localhost:27206/api/Framework/DictType"/>

<add key="DictData" value="http://localhost:27206/api/Framework/DictData"/>

<add key="CorpDictData" value="http://localhost:27206/api/Framework/CorpDictData"/>

<add key="City" value="http://localhost:27206/api/Framework/City"/>

<add key="District" value="http://localhost:27206/api/Framework/District"/>

<add key="Province" value="http://localhost:27206/api/Framework/Province"/>

<add key="UserParameter" value="http://localhost:27206/api/Framework/UserParameter"/>

我们在客户端，只需要对Web API进行封装即可，这个部分可以使用Database2Sharp代码生成工具进行统一的生成，所有继承关系统一处理好，我们所做的就是进行新增接口的处理即可。
例如对于字典模块DictData的处理，它对于Web API的封装类如下所示。

/// <summary>
/// DictData, 基于API服务的Facade接口实现类
/// </summary>
public class DictDataCaller : BaseApiService<DictDataInfo>, IDictDataService

 

这个基类，默认封装了对常规数据表业务Web API接口方式的增删改查以及各种复杂的接口处理。
如果对于一般的Web API（非数据表业务），那么只需要继承的基类做调整即可。

/// <summary>
/// 基于API服务的Facade接口实现类
/// </summary>
public class TestCaller : NormalApiService, ITestService

 

这个NormalApiService基类，默认只是封装了对token和签名的读取处理，没有特殊的业务接口，具体特定的接口我们来实现处理。

对于WebAPI客户端的调用，我们主要就是需要构建对应的URL，然后通过GET传递或者POST传递一些参数，并读取HTML结果，把它解析为对应的类型数据即可，如下代码所示。

复制代码

/// <summary>
/// 根据字典类型名称获取对应的字典记录
/// </summary>
/// <param name="dictTypeName">字典类型名称</param>
/// <returns></returns>
public List<DictDataInfo> FindByDictType(string dictTypeName)
{var action = System.Reflection.MethodBase.GetCurrentMethod().Name;string url = GetTokenUrl(action) + string.Format("&dictTypeName={0}", dictTypeName);List<DictDataInfo> result = JsonHelper<List<DictDataInfo>>.ConvertJson(url);return result;
}

复制代码

 

通过GetTokenUrl(action) 函数获取对应的URL地址，由于传入一个参数，接口这里没有发生数据修改，是GET方式提交参数数据，因此把参数附加在URL即可。
也就是下面代码实现了完整Web API地址的构建。

string url = GetTokenUrl(action) + string.Format("&dictTypeName={0}", dictTypeName);

构建好这些URL地址后，我们通过获取对应Web API的结果并进行序列号到具体对象即可。如下代码所示。

List<DictDataInfo> result = JsonHelper<List<DictDataInfo>>.ConvertJson(url);

关于Web API接口的设计文章，可以参考我的随笔。

  • Web API接口设计经验总结
  • Web API应用架构设计分析（1）
  • Web API应用架构设计分析（2）
    具体的Web API接口的使用，可以参考随笔：
  • Web API应用架构在Winform混合框架中的应用（1）
  • Web API应用架构在Winform混合框架中的应用（2）--自定义异常结果的处理
  • Web API应用架构在Winform混合框架中的应用（3）--Winfrom界面调用WebAPI的过程分解
  • Web API应用架构在Winform混合框架中的应用（4）--利用代码生成工具快速开发整套应用
  • Web API应用架构在Winform混合框架中的应用（5）--系统级别字典和公司级别字典并存的处理方式

通过以上的封装处理，那么对于业务表的Web API接口调用，具体使用客户端的代码如下所示。

var dictType = CallerFactory<IDictTypeService>.Instance.GetTree();
Console.WriteLine(dictType.ToJson());var dictData = CallerFactory<IDictDataService>.Instance.GetAllDict();
Console.WriteLine(dictData.ToJson());

 

如果对于非数据表业务的Web API接口调用，具体使用客户端的代码如下所示。

var testAction = CallerFactory<ITestService>.Instance.TestAction();
Console.WriteLine(testAction.ToJson());var test = CallerFactory<ITestService>.Instance.Test("123");
Console.WriteLine(test.ToJson());

 

这样，不管是在Web项目里面，还是在Winform项目里面，或者在跨平台的IOS项目里面（或者安卓项目），都可以以相同的方式消费Web API，这样我们所有的数据入口在一个地方，可以集中业务接口的统一开发，并且可以有效管理我们的数据提供的性能问题，如统一缓存处理，统一权限处理...
感谢大家对本文章的细心阅读，希望对您的开发有所启发或帮助。

主要研究技术：代码生成工具、会员管理系统、客户关系管理软件、病人资料管理软件、Visio二次开发、酒店管理系统、仓库管理系统等共享软件开发
专注于Winform开发框架/混合式开发框架、Web开发框架、Bootstrap开发框架、微信门户开发框架的研究及应用。
  转载请注明出处：
撰写人：伍华聪  http://www.iqidi.com 

本文来自互联网用户投稿，该文观点仅代表作者本人，不代表本站立场。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如若转载，请注明出处：http://www.mzph.cn/news/437192.shtml

如若内容造成侵权/违法违规/事实不符，请联系多彩编程网进行投诉反馈email:809451989@qq.com，一经查实，立即删除！

相关文章

centos部署python flask_用Dockerfile部署你的Flask Web应用

centos部署python flask_用Dockerfile部署你的Flask Web应用

背景故事话说去年年底给另外一个组的同事写了一个简单的工单查询系统&#xff0c;用flask写的&#xff0c;当时是部署在我们组的一台测试物理机上&#xff0c;操作系统是Redhat 7。后来我们组的这台测试物理机要做其它用途&#xff0c;领导给两天时间让把应用迁走&#xff0c;问…
阅读更多...
centos7安装flink集群_《从0到1学习Flink》—— Flink 写入数据到 Kafka

centos7安装flink集群_《从0到1学习Flink》—— Flink 写入数据到 Kafka

前言之前文章 《从0到1学习Flink》—— Flink 写入数据到 ElasticSearch 写了如何将 Kafka 中的数据存储到 ElasticSearch 中&#xff0c;里面其实就已经用到了 Flink 自带的 Kafka source connector&#xff08;FlinkKafkaConsumer&#xff09;。存入到 ES 只是其中一种情况&a…
阅读更多...
Qt中的私有信号

Qt中的私有信号

一、什么是Qt私有信号&#xff1f; 直接引用Qt文档中的描述&#xff1a; 二、私有信号的作用 私有信号只能被响应&#xff0c;不能被用户代码来发射&#xff08;emit&#xff09;。这是一种对某些信号的权限控制&#xff0c;也就是用户代码没有权力“发号施令”&#xff0c;只…
阅读更多...
opencv获取图片像素坐标_利用OpenCV从图片中提取矩形并标注坐标（室内平面地图）（一）

opencv获取图片像素坐标_利用OpenCV从图片中提取矩形并标注坐标（室内平面地图）（一）

​某城市会展中心室内地图背景一名室内设计师的日常工作从设计一张会展地图开始。常常有这样的场景&#xff1a;划分除规范的展位后&#xff0c;进入销售阶段&#xff0c;频繁的需要修改这张地图&#xff0c;如展示拆分、合并、换位置、标记已交易。问题从上图中标记色块的是有…
阅读更多...
【转】C#中ToString()格式详解

【转】C#中ToString()格式详解

以下内容均摘自博客园&#xff0c;仅供资料查询。 ToString格式化 在很多对象显示为字符串的时候都会使用到ToString中的格式化&#xff0c;由于以前没怎么注意到这个问题&#xff0c;想总结一下各个基础结构对象的格式化&#xff0c;以便后备之用&#xff01;&#xff01;&am…
阅读更多...
【编译原理】入门总结

【编译原理】入门总结

教程资源 入门教程在&#xff1a;手把手教你做一个 C 语言编译器 学习过程 19年尝试学了一下&#xff0c;中途看不懂放弃了。20年底从头再看一遍&#xff0c;经过一年的知识积累&#xff0c;在仔细研读之下&#xff0c;终于算是学懂了。此文中记录了我在最初学习时遇到的问题…
阅读更多...
Qt添加翻译文件

Qt添加翻译文件

以在Qt Creator中开发为例&#xff1a; 第一步 在.pro文件中添加一行 TRANSLATIONS projectName_zh.ts 保存&#xff0c;执行一次qmake。 注&#xff1a;ts文件是xml文件保存了需要翻译的信息。 第二步 选择菜单&#xff1a;工具->外部->Qt预言家->更新翻译。 可…
阅读更多...
应用程序标准输入输出、Shell、程序界面的关系

应用程序标准输入输出、Shell、程序界面的关系

发展史 计算机在发展初期&#xff0c;电脑上的软件是没有窗口的&#xff0c;只有一个命令行&#xff0c;这个软件叫Shell&#xff0c;中文的意思是外壳。Shell是一个统一的叫法&#xff0c;实际在不同的系统中&#xff0c;又有很多种Shell软件&#xff0c;如下表所示&#xff…
阅读更多...
安卓简单天气预报app源码_七个个小众但实用的APP，效率翻倍~

安卓简单天气预报app源码_七个个小众但实用的APP，效率翻倍~

推荐7个小众但实用的APP1、PDF处理助手下面就是软件的启动图&#xff0c;没有任何广告。并且直接标明了这个软件的三大特点&#xff1a;简单、免费、快捷下面就是软件的启动图&#xff0c;没有任何广告。而且免注册登录即可使用&#xff0c;简直是一款良心软件了。2、菜鸟教程菜…
阅读更多...
【转】Jenkins详细教程

【转】Jenkins详细教程

最近花了一段时间研究jenkins这个工具。所以写下这篇文章&#xff0c;算是当做记录吧&#xff01; 一、jenkins是什么&#xff1f; Jenkins是一个开源的、提供友好操作界面的持续集成(CI)工具&#xff0c;起源于Hudson&#xff08;Hudson是商用的&#xff09;&#xff0c;主要…
阅读更多...
拼接符 防注入正则校验_Apache Kylin 命令注入漏洞调试分析(CVE-2020-1956)

拼接符 防注入正则校验_Apache Kylin 命令注入漏洞调试分析(CVE-2020-1956)

1、前言Apache Kylin是一个开源的、分布式的分析型数据仓库&#xff0c;提供Hadoop/Spark 之上的 SQL 查询接口及多维分析(OLAP)能力以支持超大规模数据。近日&#xff0c;百度云安全团队监测到Apache官方发出了一个漏洞通告&#xff0c;披露了Apache kylin多版本存在命令注入漏…
阅读更多...
can使能上拉 gpio_IMX6ULL 的 GPIO 操作方法

can使能上拉 gpio_IMX6ULL 的 GPIO 操作方法

来源&#xff1a;百问网作者&#xff1a;韦东山本文字数&#xff1a;1652&#xff0c;阅读时长&#xff1a;4分钟CCM: Clock Controller Module (时钟控制模块) IOMUXC : IOMUX Controller&#xff0c;IO 复用控制器 GPIO: General-purpose input/output&#xff0c;通用的输入…
阅读更多...
【转】.NET 的 WebSocket 开发包比较

【转】.NET 的 WebSocket 开发包比较

转载于http://www.oschina.net/translate/websocket-libraries-comparison-2 编者按 本文出现在第三方产品评论部分中。在这一部分的文章只提供给会员&#xff0c;不允许工具供应商用来以任何方式和形式来促销或宣传产品。请会员报告任何垃圾信息或广告。 Web项目常常需要将数…
阅读更多...
vb checkbox选中和不选中_UE4 4.23 RetainerBox 选中框位置不正确

vb checkbox选中和不选中_UE4 4.23 RetainerBox 选中框位置不正确

Bug表现在UE4 4.23版本&#xff0c;实现自定义控件时&#xff0c;继承了RetainerBox&#xff0c;发现当内部包裹子控件时&#xff0c;先编辑器面板选中子物体&#xff0c;发现选中位置有偏移。位置偏移当窗口缩放时&#xff0c;选中框位置发现当窗口最小化时&#xff0c;偏移位…
阅读更多...
去哪查阅ISO国际标准？

去哪查阅ISO国际标准？

ISO官网 访问ISO官网&#xff0c;不需要翻墙&#xff0c;只要懂点英文就行。 ISO官网地址&#xff1a;https://www.iso.org/&#xff08;可进行全面了解、购买付费内容&#xff09; ISO部分公开标准下载地址&#xff1a;https://standards.iso.org/ittf/PubliclyAvailableSt…
阅读更多...
【转】开源的C# websocket-sharp组件解析

【转】开源的C# websocket-sharp组件解析

下面我们介绍一款WebSocket组件websocket-sharp的相关内容。 一.websocket-sharp组件概述 websocket-sharp是一个C#实现websocket协议客户端和服务端&#xff0c;websocket-sharp支持RFC 6455&#xff1b;WebSocket客户端和服务器&#xff1b;消息压缩扩展&#xff1b;安全连接…
阅读更多...
java异或_JAVA面试必备之HashMap必会点

java异或_JAVA面试必备之HashMap必会点

今天我们就面试会问到关于HashMap的问题进行一个汇总&#xff0c;以及对这些问题进行解答。1、HashMap的数据结构是什么&#xff1f;2、为啥是线程不安全的&#xff1f;3、Hash算法是怎样实现的&#xff1f;4、HashMap是如何处理Hash碰撞的&#xff1f;5、增加元素的方法是怎么…
阅读更多...
对分查找的最多次数_「剑指offer题解」数组中出现次数超过一半的数字

对分查找的最多次数_「剑指offer题解」数组中出现次数超过一半的数字

关注我——个人公众号&#xff1a;后端技术漫谈我目前是一名后端开发工程师。主要关注后端开发&#xff0c;数据安全&#xff0c;网络爬虫&#xff0c;物联网&#xff0c;边缘计算等方向。原创博客主要内容Java知识点复习全手册Leetcode算法题解析剑指offer算法题解析SpringClo…
阅读更多...
rabbitmq导出队列_消息队列BCMQ在大云运维管理平台BCDeepWatch中的应用

rabbitmq导出队列_消息队列BCMQ在大云运维管理平台BCDeepWatch中的应用

友情提示&#xff1a;全文约2600字&#xff0c;预计阅读时间12分钟摘要消息队列作为重要的中间件&#xff0c;广泛用于分布式系统中各子系统间的异步解耦&#xff1b;本文主要介绍了大云消息队列中间件BC-MQ在BC-DeepWatch中的应用案例。一、消息队列应用场景简介消息队列是分布…
阅读更多...
【编译原理】如何编写BNF？

【编译原理】如何编写BNF？

此篇文章承接上一篇&#xff1a;【编译原理】理解BNF 前言 理解了BNF&#xff0c;就能实现代码解析了吗&#xff1f;还有点早&#xff0c;因为理解了BNF&#xff0c;还要会写BNF。实际上&#xff0c;BNF实现有固定的模式&#xff0c;也有现成的工具&#xff0c;比如可以使用ya…
阅读更多...
推荐文章
最新文章

Copyright @ 2022~2023