Vive.Anno.Api.GateWay
1.7.1.731
See the version list below for details.
dotnet add package Vive.Anno.Api.GateWay --version 1.7.1.731
NuGet\Install-Package Vive.Anno.Api.GateWay -Version 1.7.1.731
<PackageReference Include="Vive.Anno.Api.GateWay" Version="1.7.1.731" />
paket add Vive.Anno.Api.GateWay --version 1.7.1.731
#r "nuget: Vive.Anno.Api.GateWay, 1.7.1.731"
// Install Vive.Anno.Api.GateWay as a Cake Addin #addin nuget:?package=Vive.Anno.Api.GateWay&version=1.7.1.731 // Install Vive.Anno.Api.GateWay as a Cake Tool #tool nuget:?package=Vive.Anno.Api.GateWay&version=1.7.1.731
🏡Anno 分布式微服务开发框架
Anno 是一个分布式开发框架,专注于服务治理、监控、链路追踪。RPC可选用高性能跨语言的Thrift(推荐)、Grpc。同时支持 .net core 、.net framework、java。
在线演示 :http://49.232.112.70
示例项目 :https://gitee.com/stoneson/Viper
🎄Nuget 基础
Package name | Description | Version | Downloads |
---|---|---|---|
Vive.Anno.Core |
核心库 |
🎃Nuget 通信
🎁Nuget 扩展
🎂整体架构
整体架构主要分为三个部分
1、注册中心:AnnoCenter
2、微服务:AnnoService(可以是多个服务例如:订单服务A、库存服务B、支付服务C、用户服务D)
3、ApiGateway:参考Viper
📢主要功能
服务注册中心、服务发现、健康检查、负载均衡、限流、失败重试、链路追踪、资源监控等功能
📦注册中心(AnnoCenter)
AnnoCenter 是一个服务注册中心,主要职责是 发现服务(例如订单服务A、库存服务B)、存储服务配置信息、健康检查、简单键值KV存储。客户端定时从注册中心获取服务信息缓存到本地。即便注册中心宕机也不影响整个集群运行,因为客户端已经缓存了整个集群的服务信息。但是新加入的服务无法注册进来,需要启动注册中心才可以。 客户端(例如:ApiGateway )发送过来请求时,客户端类库从本地缓存找出能够处理此请求的服务列表(这个过程可能涉及权重等策略)选择一个去处理请求,然后返回,如果失败会有重试机制。 注册中心会定时对每个服务做健康检查,如果连接不上服务则标记此服务为亚健康状态,此时不会将此服务踢出也不会将自服务返回给客户单使用,然后开始重复做检查。如果一分钟内恢复正常则重新标记为健康状态切可以对外提供服务,否则永久踢出服务。
服务注册中心(AnnoCenter) 是整个集群第一个需要运行起来的程序。
配置文件:只需要配置端口、超时时间即可。服务节点信息会在服务注册进来的时候自动写入
<?xml version="1.0" encoding="utf-8"?>
<configuration>
<Port>6660</Port>
<TimeOut>120000</TimeOut>
<Servers>
<dc name="Vive.Anno.Plugs.TraceService,Vive.Anno.Plugs.DLockService,Vive.Anno.Plugs.EsLogService" nickname="App001" ip="10.112.93.122" port="6659" timeout="20000" weight="1" />
</Servers>
</configuration>
👑服务(AnnoService)
服务宿主程序,本着约定大于配置的开发原则。 插件式开发具体参考: Packages
命名空间和程序集名称相同,格式为Vive.Anno.Plugs.XXXService 例如:Vive.Anno.Plugs.HelloWorldService
初始化配置
实现接口:IPlugsConfigurationBootstrap
using Vive.Anno.EngineData;
using System;
namespace Vive.Anno.Plugs.HelloWorldService
{
/// <summary>
/// 插件启动引导器
/// DependsOn 依赖的类型程序集自动注入DI容器
/// </summary>
[DependsOn(
//typeof(Domain.Bootstrap)
//, typeof(QueryServices.Bootstrap)
//, typeof(Repository.Bootstrap)
//, typeof(Command.Handler.Bootstrap
)]
public class HelloWorldBootStrap : IPlugsConfigurationBootstrap
{
/// <summary>
/// Service 依赖注入构建之后调用
/// </summary>
public void ConfigurationBootstrap()
{
//throw new NotImplementedException();
}
/// <summary>
/// Service 依赖注入构建之前调用
/// </summary>
/// </summary>
public void PreConfigurationBootstrap()
{
//throw new NotImplementedException();
}
}
}
功能模块实现 继承: BaseModule
Module命名规范为 XXXModule,以Module结尾 例如:HelloWorldViperModule
/******************************************************
Writer:Du YanMing
Mail:dym880@163.com
Create Date:2020/10/30 13:15:24
Functional description: HelloWorldViperModule
******************************************************/
using System;
using System.Collections.Generic;
using System.Text;
namespace Vive.Anno.Plugs.HelloWorldService
{
using Vive.Anno.Const.Attribute;
using Vive.Anno.EngineData;
using HelloWorldDto;
using System.ComponentModel.DataAnnotations;
public class HelloWorldViperModule : BaseModule
{
[AnnoInfo(Desc = "世界你好啊SayHi")]
public dynamic SayHello([AnnoInfo(Desc = "称呼")] string name, [AnnoInfo(Desc = "年龄")] int age)
{
Dictionary<string, string> input = new Dictionary<string, string>();
input.Add("vname", name);
input.Add("vage", age.ToString());
var soEasyMsg = Newtonsoft.Json.JsonConvert.DeserializeObject<ActionResult<string>>(this.InvokeProcessor("Vive.Anno.Plugs.SoEasy", "AnnoSoEasy", "SayHi", input)).OutputData;
return new { HelloWorldViperMsg = $"{name}你好啊,今年{age}岁了", SoEasyMsg = soEasyMsg };
}
[AnnoInfo(Desc = "两个整数相减等于几?我来帮你算(x-y=?)")]
public int Subtraction([AnnoInfo(Desc = "整数X")] int x, [AnnoInfo(Desc = "整数Y")] int y)
{
return x - y;
}
[AnnoInfo(Desc = "买个商品吧,双十一马上就来了")]
public ProductDto BuyProduct([AnnoInfo(Desc = "商品名称")] string productName, [AnnoInfo(Desc = "商品数量")] int number)
{
double price = new Random().Next(2, 90);
Dictionary<string, string> input = new Dictionary<string, string>();
input.Add("productName", productName);
input.Add("number", number.ToString());
var product = Newtonsoft.Json.JsonConvert.DeserializeObject<ActionResult<ProductDto>>(this.InvokeProcessor("Vive.Anno.Plugs.SoEasy", "AnnoSoEasy", "BuyProduct", input)).OutputData;
product.CountryOfOrigin = $"中国北京中转--{ product.CountryOfOrigin}";
return product;
}
}
}
配置文件:
<?xml version="1.0" encoding="utf-8" ?>
<configuration>
<IdWorker>0,0</IdWorker>
<AppName>App001</AppName>
<Port>6659</Port>
<Weight>1</Weight>
<FuncName>Vive.Anno.Plugs.LogicService,Vive.Anno.Plugs.TraceService</FuncName>
<IgnoreFuncName></IgnoreFuncName>
<TimeOut>20000</TimeOut>
<Ts Ip="10.112.93.122" Port="6660"/>
<IocDll>
<Assembly>Vive.Anno.Repository</Assembly>
</IocDll>
<appSettings>
</appSettings>
</configuration>
🏄网关
Product | Versions Compatible and additional computed target framework versions. |
---|---|
.NET | net6.0 is compatible. net6.0-android was computed. net6.0-ios was computed. net6.0-maccatalyst was computed. net6.0-macos was computed. net6.0-tvos was computed. net6.0-windows was computed. net7.0 was computed. net7.0-android was computed. net7.0-ios was computed. net7.0-maccatalyst was computed. net7.0-macos was computed. net7.0-tvos was computed. net7.0-windows was computed. net8.0 was computed. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. |
-
net6.0
- Flurl.Http (>= 3.2.4)
- NSwag.Core (>= 13.16.1)
- Swashbuckle.AspNetCore (>= 6.4.0)
- Vive.Anno.Rpc.Server (>= 1.7.1.731)
NuGet packages
This package is not used by any NuGet packages.
GitHub repositories
This package is not used by any popular GitHub repositories.