当前位置: 首页 > news >正文

.NET Core Web APi类库如何内嵌运行?

🚀 优质资源分享 🚀

学习路线指引(点击解锁)知识定位人群定位
🧡 Python实战微信订餐小程序 🧡进阶级本课程是python flask+微信小程序的完美结合,从项目搭建到腾讯云部署上线,打造一个全栈订餐系统。
💛Python量化交易实战💛入门级手把手带你打造一个易扩展、更安全、效率更高的量化交易系统

话题

我们知道在.NET Framework中可以嵌入运行Web APi,那么在.NET Core(.NET 6+称之为.NET)中如何内嵌运行Web Api呢,在实际项目中这种场景非常常见,那么我们本节以.NET 6.0作为演示示例一起来瞅瞅

内嵌运行.NET Core Web APi

接下来我们通过控制台作为主程序来启动Web APi,首先我们创建名为EmbedWebApi的控制台程序,然后创建Embed.WebApi类库运行Web APi,我们在此Web APi中创建如下接口,并实现相关方法来运行Web APi

public class InitTest : IInitTest
{
 public void Init()
 {
 var builder = WebApplication.CreateBuilder();

 builder.Services.AddControllers();

 var app = builder.Build();

 app.UseRouting();

 app.UseEndpoints(endpoints => 
 {
 endpoints.MapDefaultControllerRoute();
 });

 app.Run();
 }
}

public interface IInitTest
{
 void Init();
}

通过写接口并在对应方法中运行Web APi主要是达到在控制中调用该接口进行模拟实现,这里需要注意一点的是,因为我们创建的Web APi是类库,要想使用Web里面的Api等等,直接在项目文件中添加如下一行以表明我们要引用框架,这样一来框架里面所包含的APi等等版本都一致统一,而不是通过NuGet一一下载,这是错误的做法


 "Microsoft.AspNetCore.App" />

接下来我们在该类库中按照规范创建Controllers文件夹,并创建测试控制器,如下

using Microsoft.AspNetCore.Mvc;

namespace Embed.WebApi.Controllers
{
 [ApiController]
 [Route("api/[controller]/[action]")]
 public class TestController : ControllerBase
 {
 [HttpGet]
 public IActionResult Test()
 {
 return Ok("Hello World");
 }
 }
}

最后我们在控制台程序中注册上述接口并调用初始化方法,如下:

internal class Program
{
 static void Main(string[] args)
 {
 var services = new ServiceCollection();
 
 services.AddTransient();

 var serviceProvider = services.BuildServiceProvider();

 var initTest = serviceProvider.GetRequiredService();

 initTest.Init();

 Console.Read();
 }
}

芜湖,我们通过Postman模拟调用测试接口,结果惊呆了,404了~~~

当我们将类库中的控制器移动到控制台中,此时请求测试接口并成功返回对世界的问候,这是什么原因呢? 不难猜测可知,默认WebAPi控制器的激活以作为入口的主程序集进行查找激活。虽然这样看似解决了问题,假设调用嵌入运行的主程序是底层已经封装好的基础设施,那么岂不是遭到了代码入侵,所以我们就想在运行的Web APi类库里面去激活,此时我们想到将类库作为Web APi应用程序一部分应用手动加载并激活,在初始化方法里面修改为如下即可请求测试接口成功

public class InitTest : IInitTest
{
 private static readonly string AssemblyName = typeof(InitTest).Assembly.GetName().Name;
 public void Init()
 {
 var builder = WebApplication.CreateBuilder();

 builder.Services.AddControllers()
 .AddApplicationPart(Assembly.Load(new AssemblyName(AssemblyName)));

 var app = builder.Build();

 app.UseRouting();

 app.UseEndpoints(endpoints => 
 {
 endpoints.MapDefaultControllerRoute();
 });

 app.Run();
 }
}

上述直接在运行Web APi类库中添加控制器激活,这种场景完全限定于底层主入口已封装好,所以只能采用这种方式,若是主入口我们自己可控制,当然还有另外一种方式,来,我们瞧瞧截取的关键性源码

/// 
/// Populates the given  using the list of
/// s configured on the
/// .
/// 
/// The type of the feature.
/// The feature instance to populate.
public void PopulateFeature(TFeature feature)
{
 if (feature == null)
 {
 throw new ArgumentNullException(nameof(feature));
 }

 foreach (var provider in FeatureProviders.OfType>())
 {
 provider.PopulateFeature(ApplicationParts, feature);
 }
}

internal void PopulateDefaultParts(string entryAssemblyName)
{
 var assemblies = GetApplicationPartAssemblies(entryAssemblyName);

 var seenAssemblies = new HashSet();

 foreach (var assembly in assemblies)
 {
 if (!seenAssemblies.Add(assembly))
 {
 // "assemblies" may contain duplicate values, but we want unique ApplicationPart instances.
 // Note that we prefer using a HashSet over Distinct since the latter isn't
 // guaranteed to preserve the original ordering.
 continue;
 }

 var partFactory = ApplicationPartFactory.GetApplicationPartFactory(assembly);
 foreach (var applicationPart in partFactory.GetApplicationParts(assembly))
 {
 ApplicationParts.Add(applicationPart);
 }
 }
}

private static IEnumerable GetApplicationPartAssemblies(string entryAssemblyName)
{
 var entryAssembly = Assembly.Load(new AssemblyName(entryAssemblyName));

 // Use ApplicationPartAttribute to get the closure of direct or transitive dependencies
 // that reference MVC.
 var assembliesFromAttributes = entryAssembly.GetCustomAttributes()
 .Select(name => Assembly.Load(name.AssemblyName))
 .OrderBy(assembly => assembly.FullName, StringComparer.Ordinal)
 .SelectMany(GetAssemblyClosure);

 // The SDK will not include the entry assembly as an application part. We'll explicitly list it
 // and have it appear before all other assemblies \ ApplicationParts.
 return GetAssemblyClosure(entryAssembly)
 .Concat(assembliesFromAttributes);
}

private static IEnumerable GetAssemblyClosure(Assembly assembly)
{
 yield return assembly;

 var relatedAssemblies = RelatedAssemblyAttribute.GetRelatedAssemblies(assembly, throwOnError: false)
 .OrderBy(assembly => assembly.FullName, StringComparer.Ordinal);

 foreach (var relatedAssembly in relatedAssemblies)
 {
 yield return relatedAssembly;
 }
}

从上述源码可知,通过主入口程序集还会加载引用的程序集去查找并激活相关特性(比如控制器),当然前提是实现ApplicationPartAttribute特性,此特性必须在主入口程序集里定义,定义在程序集上,所以我们只需一行代码即可搞定,我们在控制台主入口命名空间顶部添加特性,引入Web APi类库程序集作为应用程序的一部分,如下:

[assembly: ApplicationPart("Embed.WebApi")]

那么接下来问题又来了,要是需要运行多个Web APi我们又当如何呢?按照上述方式一一添加未尝不可,我们也可以通过MSBuild任务来进行构建将相关特性自动添加到主入口程序集描述信息里面去,例如:


 "Microsoft.AspNetCore.Mvc.ApplicationParts.ApplicationPartAttribute">
 <\_Parameter1>Embed.WebApi
 

有的童鞋就问了,这不写死了么,那还不如通过添加特性的方式去处理,请注意这里只是使用示例,实际情况下,我们可将多个Web APi放在同一解决方案下,然后在此解决方案下创建可构建任务的.targets文件,并在主项目文件里引入,将程序集名称作为变量引入,剩下事情自行统一处理,若不清楚怎么搞,就在代码中使用特性方式也未尝不可,例如如下:


 "Microsoft.AspNetCore.Mvc.ApplicationParts.ApplicationPartAttribute">
 <\_Parameter1>$(AssemblyName)
 

总结

本节我们重点讨论如何内嵌运行.NET Core Web APi类库,同时介绍了两种激活比如控制器特性方案, 希望对您有所帮助,谢谢,我们下节再会

[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-RkATX8EI-1663907899801)(https://blog.csdn.net/CreateMyself)]https://blog.csdn.net/CreateMyself)/欢迎各位转载,但是未经作者本人同意,转载文章之后必须在文章页面明显位置给出作者和原文连接,否则保留追究法律责任的权利。

相关文章:

  • Kafka3.2.3基于Linux的集群安装(待续)
  • 数据湖技术之 Hudi 框架概述
  • 前端利器 —— 提升《500倍开发效率》 传一张设计稿,点击一建生成项目 好牛
  • MySQL数据库基础:数据类型详解-数值类型
  • 超好用的内网穿透工具【永久免费不限制流量】
  • Doris0.15平滑升级至1.12
  • CentOS系统安装Docker Engine
  • 【Node.js 入门篇】连接 MySQL
  • 一文带你读懂Vue生命周期
  • Java顺序表的实现
  • 金仓数据库KingbaseES数据库参考手册(服务器配置参数18. 开发者选项)
  • mysql 跨库数据清洗方案
  • pandas数据映射,更改列名,批量映射替换某列数据replace、map、apply、rename对比
  • 未婚妻晚安之后依然在线,于是我用20行代码写了个小工具
  • MySQL进阶第二天——索引
  • [case10]使用RSQL实现端到端的动态查询
  • [iOS]Core Data浅析一 -- 启用Core Data
  • 【知识碎片】第三方登录弹窗效果
  • 0基础学习移动端适配
  • EOS是什么
  • FineReport中如何实现自动滚屏效果
  • isset在php5.6-和php7.0+的一些差异
  • JS进阶 - JS 、JS-Web-API与DOM、BOM
  • NSTimer学习笔记
  • Spark RDD学习: aggregate函数
  • Vue 动态创建 component
  • 阿里研究院入选中国企业智库系统影响力榜
  • 记录:CentOS7.2配置LNMP环境记录
  • 讲清楚之javascript作用域
  • 时间复杂度与空间复杂度分析
  • 使用common-codec进行md5加密
  • Android开发者必备:推荐一款助力开发的开源APP
  • 好程序员大数据教程Hadoop全分布安装(非HA)
  • ​插件化DPI在商用WIFI中的价值
  • #HarmonyOS:软件安装window和mac预览Hello World
  • #NOIP 2014#day.2 T1 无限网络发射器选址
  • $HTTP_POST_VARS['']和$_POST['']的区别
  • (附源码)计算机毕业设计大学生兼职系统
  • (附源码)小程序 交通违法举报系统 毕业设计 242045
  • (四) 虚拟摄像头vivi体验
  • (一)基于IDEA的JAVA基础1
  • (转)iOS字体
  • .NET CF命令行调试器MDbg入门(四) Attaching to Processes
  • .NET Core、DNX、DNU、DNVM、MVC6学习资料
  • .Net Winform开发笔记(一)
  • .NET 编写一个可以异步等待循环中任何一个部分的 Awaiter
  • .NetCore实践篇:分布式监控Zipkin持久化之殇
  • [20170705]lsnrctl status LISTENER_SCAN1
  • [30期] 我的学习方法
  • [Bugku]密码???[writeup]
  • [C++]类和对象(中)
  • [CF]Codeforces Round #551 (Div. 2)
  • [ComfyUI进阶教程] animatediff视频提示词书写要点
  • [CSS] - 修正IE6不支持position:fixed的bug
  • [C语言]——函数递归