通过lms.samples熟悉lms微服务框架的使用详解

通过LMS框架，开发者可以轻松地构建微服务业务框架并进行应用开发。本文将详细介绍如何使用lms.samples样例项目来熟悉LMS微服务框架的使用，对大家的学习和工作具有一定的参考价值。

一、lms.samples项目简介

lms.samples是一个由三个独立微服务应用模块组成的样例项目，包括account、stock和order三个业务应用模块，以及一个网关项目gateway。每个微服务应用都采用模块化设计，构成了一个完整的微服务架构。

二、业务应用模块介绍

1. 主机（Host）：主机用于托管微服务应用本身。通过引用应用服务项目（应用接口的实现），托管微服务应用。在主机启动过程中，会向服务注册中心注册服务路由。

2. 应用接口层（Application.Contracts）：该层用于定义应用服务接口。微服务模块通过应用接口与其他微服务模块或网关进行RPC通信。除了定义接口，还需要定义与接口相关的DTO对象。

3. 应用服务层（Application）：应用服务是微服务中定义的应用接口的实现。主要负责外部通信与领域层之间的协调，进行业务流程控制。

4. 领域层（Domain）：领域层负责表达业务概念、业务状态信息及业务规则，是微服务模块的业务核心。在该层可以定义聚合根、实体、领域服务等对象。

5. 领域共享层（Domain.Shared）：该层用于定义与领域对象相关的模型、实体等相关类型，可以被其他微服务引用。

6. 数据访问（Data Access）层：该层用于封装数据访问相关的对象，如仓库对象、SqlHelper等。在lms.samples中，通过EF Core实现数据的读写操作。

三、服务聚合与网关

在LMS框架中，服务外部不能直接与微服务主机通信，必须通过HTTP请求到达网关。网关通过LMS提供的中间件到服务条目，并通过RPC与集群内部的微服务进行通信。开发者在定义网关时需要引用各个微服务模块的应用接口层，并使用LMS相关的中间件。

四、开发环境要求

为了顺利使用LMS框架进行开发，需要满足以下开发环境要求：

1. 版本：5.0.101

2. LMS版本：1.0.0

3. IDE：推荐使用visual studio版或Rider。

五、主机的创建与应用托管

通过LMS框架创建一个业务模块非常简单。只需按照以下步骤操作，即可轻松创建LMS应用业务模块：

1. 创建项目：创建一个控制台应用（Console Application）项目，并引用Silky.Lms.NormHost包。

2. 应用程序入口与主机构建：在main方法中，构建通用主机并注册LMS微服务。在注册LMS微服务时，需要指定LMS启动的依赖模块。

开发者还可以通过dot命令添加包Silky.Lms.NormHost --version 1.0.0来管理依赖关系。这些步骤将帮助开发者快速熟悉LMS框架的使用，并顺利构建微服务应用。在编程的世界里，我们有一个引人注目的程序框架。当我们深入其结构时，不禁被其设计和细节所吸引。

这是一个典型的程序主体框架，它以异步任务的方式运行，并在启动时构建并运行主机。`Main` 方法是程序的入口点，它调用 `CreateHostBuilder` 方法来创建并配置主机。此方法返回一个默认的 `IHostBuilder` 实例，并使用 `RegisterLmsServices` 方法注册特定的服务模块。这使得整个框架的结构清晰明了，每一个部分都有其独特的职责和功能。

接下来我们转向配置文件的部分。这个框架支持灵活多变的配置方式，允许开发者使用 YML 或 JSON 格式进行配置。你可以通过 `appsettings.yml` 文件进行全局配置，而针对特定的环境变量，你可以使用 `appsettings.${Environment}.yml` 文件进行配置覆盖。这为开发者提供了极大的便利，使得在不同环境下运行应用变得简单而高效。

对于环境变量的设置，开发者可以根据不同的启动方式选择合适的设置方式。如果你通过项目直接启动应用，那么你可以在 `Properties/launchSettings.json` 中设置 `environmentVariables.DOTNET_ENVIRONMENT` 环境变量。而如果你通过 Docker Compose 的方式启动应用，那么你可以在 `.env` 文件中设置 `DOTNET_ENVIRONMENT` 环境变量。这些设置确保了你的应用能够根据不同的环境进行适应性的配置。

为了保证配置文件的有效性，开发者需要将配置文件显式地复制到项目的生成目录下。这是一个重要的步骤，确保你的应用能够正确地读取和应用这些配置。

关于引用应用服务层和数据访问层的问题。主机项目需要引用微服务模块的应用服务层和数据访问层。只有当主机引用这些服务层时，它才能在启动时生成服务条目的路由，并将这些服务路由注册到服务注册中心。这为服务的正常运行和交互提供了基础。

深入了解主机项目文件配置与应用接口

在一个典型的主机项目文件中，你会看到如下的结构：

```xml

Exe

5.0

```

此文件详细描述了项目的设置和依赖关系。它包含了项目所需的包引用、非文件引用以及项目引用等。

当我们谈论微服务模块的主机配置时，通常需要关注服务注册中心、分布式锁链接、分布式缓存地址、集群rpc通信token以及数据库链接地址等关键设置。这些配置是微服务运行所必需的。

对于使用docker-compose来启动和调试应用的情况，rpc配置节点下的host和port可以留空。因为每个生成的容器都有自己唯一的地址和端口号。但如果是通过直接项目方式启动和调试应用，那么必须配置rpc节点下的port，确保每个微服务模块的主机应用都有独特的端口号。

以下是lms框架的必要配置示例：

```yaml

rpc:

host: 0.0.0.0

rpcPort: 2201

token: ypjdYOzNd4FwENJiEARMLWwK0v7QUHPW

registrycenter:

connectionStrings: ... 服务注册中心地址列表，使用分号区分不同的中心地址

registryCenterType: Zookeeper 注册中心类型

distributedCache: 分布式缓存配置... 省略部分细节... 锁的配置等...省略部分细节... 数据库连接字符串...省略部分细节...

```这些配置对于微服务模块的正常运行至关重要。除了这些基础配置外，开发者在应用接口层还需要安装特定的包如Silky.Lms.Rpc来满足应用接口的需求。应用接口是微服务架构中的关键部分，它定义了服务之间的交互方式和数据格式。开发者需要遵循特定的接口定义和规范，以确保不同服务之间的顺畅通信和数据共享。在这个过程中，安装适当的包和依赖是确保接口功能正常的关键步骤之一。理解并正确配置这些设置对于开发和运行高效的微服务架构至关重要。这不仅包括熟悉和理解项目文件的结构和配置细节，还包括理解应用接口的定义和需求以及如何满足这些需求。关于微服务模块中的分布式事务处理，除了需要安装Silky.Lms.Transaction包外，我们还可选择在应用接口层安装Silky.Lms.Transaction.T包，而在应用服务层则安装Silky.Lms.Transaction包。这种设计考虑到了不同层级的需求和特性，以确保事务处理的灵活性和效率。

对于开发者来说，他们只需通过ServiceRouteAttribute特性，在应用接口层面进行简单直接的配置。遵循Lms的命名约定，应用接口应以IXAppService命名。这样，服务条目生成的路由便会以api/x的形式呈现，虽然这并不是强制性的，但却有助于提高代码的可读性和维护性。

每个应用接口的方法都对应着一个服务条目，其服务条目的Id为方法的完全限定名加上参数名，这为开发者提供了清晰的方法与服务条目之间的映射关系。在应用接口层，开发者可以对方法的缓存、路由、服务治理以及分布式事务进行详尽的配置。对于这部分内容，建议开发者详细参考相关文档以获取更全面的了解。

对于网关或其他微服务项目，如果需要引用服务应用接口，可以通过项目引用的方式或是通过NuGet安装服务应用接口生成的包。其中，[Governance(ProhibitExtra = true)]标识可以指示某个方法禁止与集群外部进行通信，即使通过网关也不会生成Swagger文档，这为服务的安全性和隐私保护提供了强有力的支持。

应用接口方法生成的WebApi支持RESTful API风格。Lms通过方法的约定命名，能够自动生成对应的HTTP方法请求的WebApi。开发者也可以使用HttpMethodAttribute特性对某个方法进行注解，以更好地满足业务需求和提升开发效率。

在这样的架构下，开发者可以更加灵活地处理分布式事务，提高系统的可用性和稳定性，同时享受到丰富的功能和强大的性能。在软件开发的世界里，一个应用接口就如同通往功能的桥梁，它定义了功能如何被访问和使用。今天，我们来深入一个名为“IAountAppService”的典型应用接口的实现。

一、概述

“IAountAppService”是一个服务接口，主要用于处理与账号相关的操作。它定义了如何创建新账号、获取账号信息、更新账号信息以及删除账号等功能。这个接口的应用服务层需要引用应用服务接口层以及领域服务层，并实现相关的接口方法。接下来，让我们详细了解这些方法的具体定义和功能。

二、方法详解

1. 创建账号（Create）：通过输入账号信息（CreateAountInput），创建一个新的账号。此操作完成后会返回一个GetAountOutput对象，包含了新创建账号的相关信息。

2. 通过账号名称获取账号（GetAountByName）：根据提供的账号名称，从缓存或数据库中获取对应的账号信息。此操作使用了缓存（GetCachingIntercept），以提高获取数据的效率。

3. 通过Id获取账号信息（GetAountById）：根据提供的账号Id，获取对应的账号信息。同样，此操作也使用了缓存，以提高数据获取的效率。

4. 更新账号信息（Update）：通过输入更新后的账号信息（UpdateAountInput），更新现有账号的信息。此操作使用了更新缓存（UpdateCachingIntercept）。

5. 删除账号信息（Delete）：根据提供的账号Id，删除对应的账号信息。此操作同样使用了缓存，并且在删除后会对相关缓存进行清除。

6. 订单扣款（DeductBalance）：根据输入的扣款信息（DeductBalanceInput），对指定账号进行扣款操作。这个操作受到治理规则的限制（Governance），并且在一个事务中进行，以确保扣款操作的原子性。扣款后，会返回一个扣款结果（long?）。

三、应用与服务实现

在应用服务层，你需要实现这个接口所定义的方法。这意味着你需要编写代码来执行上述的每个操作，如创建账号、获取账号、更新账号、删除账号以及进行订单扣款等。这些代码需要与数据库和缓存进行交互，以完成数据的增删改查操作。你还需要确保这些操作的安全性、稳定性和效率。实现这个接口需要深入理解业务逻辑，并且具备良好的编程技能。只有这样，才能确保应用接口的功能完善、性能优良。确保微服务模块的主机能够正确引用应用服务层，这是托管应用本身的关键步骤。应用服务层作为整个微服务架构的核心组成部分，扮演着至关重要的角色。

在应用服务层的设计和实现过程中，它需要与其他微服务模块进行交互，以确保系统间的通信和数据交换。为了实现这一目的，应用服务层可以通过引用其他微服务模块的应用接口层项目来进行RPC通信。这种通信方式允许应用服务层与其他微服务模块进行高效的数据交换和协同工作。

除了通信功能，应用服务层还需要依赖领域服务。领域服务是处理业务逻辑的关键组件，应用服务层通过调用领域服务的接口，实现该模块的核心业务逻辑。这样，应用服务层能够将复杂的业务逻辑交由领域服务处理，自身专注于处理与服务端点相关的请求和响应。

在微服务模块中，数据映射关系的管理也是应用服务层的重要职责之一。DTO（数据传输对象）和实体对象之间的映射关系在该层被精确指定。通过管理这些映射关系，应用服务层确保了数据的正确传输和转换，保证了系统数据的准确性和一致性。无论是DTO到实体对象，还是实体对象到DTO的映射，应用服务层都能够灵活地处理这些转换。

微服务模块的主机与应用服务层的紧密集成确保了应用的顺利托管。通过引用其他微服务模块的应用接口层项目、依赖领域服务以及管理数据映射关系，应用服务层为整个微服务架构提供了强大的支持和保障。其丰富的功能和灵活的设计使得微服务模块能够高效地处理请求、实现业务逻辑和数据转换，从而为用户提供优质的服务体验。在微服务架构中，领域层扮演着核心业务处理的核心角色，它负责处理模块中的核心业务逻辑，包括聚合根、实体、领域服务、仓储等关键业务对象的定义和实现。下面以一个典型的账户服务应用为例，展示领域层微服务的应用服务实现。

构造函数接受一个实现了接口（IAccountDomainService）的领域服务实例作为参数，用于后续的业务操作。该实例作为服务类内部的一个私有成员变量（_aountDomainService），负责处理账户数据的操作。

服务类中定义了多个异步方法，包括创建账户（Create）、获取账户信息（GetAccountByName 和 GetAccountById）、更新账户信息（Update）和删除账户（Delete）。这些方法通过调用领域服务的方法来实现账户数据的增删改查操作，并将结果映射为相应的输出对象（GetAccountOutput）。这些操作充分体现了领域层在微服务架构中处理核心业务的功能。

除此之外，服务类还包含一些特定业务逻辑的方法，如扣款操作（DeductBalance）。该方法首先通过领域服务获取账户信息，然后检查订单金额是否超过账户余额，如果超出则抛出异常。扣款操作涉及到事务处理，因此通过特性（TTransaction）来标识其事务管理。扣款操作还包括确认和取消两种状态，分别通过 DeductBalanceConfirm 和 DeductBalanceCancel 方法实现。这些方法共同构成了领域层微服务中复杂的业务逻辑处理。

领域层是微服务架构中处理核心业务的关键部分。它通过定义和实现各种业务对象，如聚合根、实体、领域服务和仓储等，来实现对业务逻辑的封装和处理。在这个例子中，账户服务类作为领域层的一部分，实现了对账户数据的增删改查以及复杂的扣款业务逻辑处理，体现了领域层在微服务中的重要作用。通过细致入微的服务设计和实现，领域层能够确保微服务的核心业务高效、稳定地运行。领域层对接微服务模块应用接口层，轻松运用DTO对象

在软件开发领域，微服务架构已成为一种趋势。领域层作为架构的核心部分，需要高效、便捷地与其他微服务模块进行交互。今天我们将如何通过引用其他微服务模块的应用接口层项目，来实现这一需求。这不仅有助于提高软件的模块化程度，还能增强系统的可扩展性和可维护性。

一、微服务模块间的通信

为了更好地集成不同微服务模块，领域层可以通过引用其他微服务模块的应用接口层项目来进行通信。这种通信方式通常采用RPC（远程过程调用），使得不同服务之间的数据交互变得简单高效。开发团队可以根据项目管理的需要，选择通过安装NuGet包来引入所需的服务接口，从而简化项目依赖管理。

二、领域服务的重要性

在微服务架构中，领域服务扮演着至关重要的角色。为了确保领域服务能够顺利注入IoC容器，必须直接或间接继承ITransientDependency接口。这样，当系统启动时，IoC容器将自动识别并注入所有实现了该接口的领域服务，从而确保服务的正常运行。

三、lms.samples项目的实践

在lms.samples项目中，开发者巧妙地使用了包来实现数据的读写操作。通过封装数据操作逻辑，使得业务逻辑层能够专注于实现业务需求，而无需关心底层数据的读写细节。这种设计不仅提高了代码的可重用性，还降低了系统的耦合度，使得系统更加灵活、易于维护。

掌握数据核心：一个典型领域服务的实现之旅

在软件开发的领域服务中，实现一个典型的领域服务是极其重要的。以下是一个以Entity Framework Core（EF Core）为数据访问层的领域服务示例。这个服务专注于管理名为“Aount”的实体，同时确保数据的完整性和一致性。

让我们深入了解这个服务的基础结构。服务名为“AountDomainService”，它依赖于两个主要组件：“IRepository”和“IDistributedCache”。这个服务处理关于账号（Aount）的所有核心操作，包括创建、获取、更新和删除。它还处理与缓存相关的操作，以提高性能和响应速度。

获取账号的操作相对直接。服务通过名称或ID查询数据库，并返回相应的账号。如果没有找到相应的账号，它将再次抛出业务异常。这些操作都是异步的，以提高响应能力和并发处理能力。

更新账号时，服务首先检查要更新的账号是否存在，然后验证新的电子邮件或名称是否已被使用。如果这些条件都满足，它将更新缓存中的账号信息，并调用仓库的更新方法来更新数据库中的信息。这一系列的操作确保了数据的完整性和一致性。

删除账号时，服务首先通过ID获取账号，然后从缓存和数据库中删除相关信息。这是为了确保即使在缓存中存在过时数据的情况下，也能正确地删除账号。

服务还处理与余额扣除相关的操作。根据输入和事务类型（尝试、确认或取消），服务会进行相应的操作，并更新缓存中的余额记录。这些操作都在事务中完成，以确保数据的完整性和一致性。它返回余额记录的ID（如果有）。

在数据访问层方面，lms.samples项目使用EF Core进行数据的读写操作。EF Core是一个强大的ORM框架，它简化了与数据库的交互，并提供了许多高级功能，如变更跟踪、复杂查询和存储库模式等。通过使用EF Core，开发人员可以专注于业务逻辑，而不必担心底层的数据库操作。

这个典型的领域服务展示了如何在软件中实现数据的核心操作，并确保数据的完整性和一致性。通过使用EF Core作为数据访问层，开发人员可以更加高效地处理数据读写操作，从而构建出健壮、高性能的应用程序。LMS系统提供了强大的服务配置功能，通过集成IConfigureService接口，开发者可以轻松指定数据上下文对象和注册仓库服务。这种机制使得服务配置变得灵活且易于管理。

在EfCoreConfigureService类中，我们通过实现ConfigureServices方法来配置服务。这个方法接受两个参数：一个是IServiceCollection服务集合，用于注册和配置服务；另一个是IConfiguration配置对象，用于读取配置信息。在这个方法中，我们添加了OrderDbContext数据上下文，并指定使用MySQL数据库。我们还注册了基于该数据上下文的通用仓库服务。

为了使用这些服务，主机项目需要显式引用包含ConfigureServices方法的项目。这样，在启动应用程序时，会自动调用该方法的代码来配置服务。

关于数据库迁移，它是确保数据库结构与应用代码保持一致的关键步骤。为了进行迁移，你需要进入每个微服务模块下的EntityFrameworkCore项目，并执行数据库更新命令。例如，对于account模块，你可以运行“dot ef database update”命令来完成迁移。每个模块（如order模块和stock模块）都需要执行此操作。

数据库迁移过程中，默认使用的数据库连接地址是在appsettings.Development.yml配置文件中指定的。如果你需要使用自己的数据库服务地址，只需修改该配置文件中的connectionStrings.default配置项即可。

关于应用的启动与调试，你可以使用Visual Studio或Rider作为开发工具。如果你选择使用Visual Studio，只需打开lms.samples.sln解决方案，将网关和各个微服务模块设置为启动项目，然后直接启动即可。如果你选择使用Rider，需要打开各个微服务模块的Properties/launchSettings.json文件，并点击绿色箭头启动项目。启动网关项目后，你将看到生成的Swagger API文档，其中包含了应用接口的服务条目。

LMS微服务框架：从lms.samples起步

一、环境变量的灵活配置

在开发旅程的起点，我们需要对环境的细节进行微调。默认情况下，我们的环境变量被设置为“Development”。若需要调整，只需进入Properties或launchSettings.json文件中的environmentVariables节点，即可轻松修改。

二、自定义配置项的便捷调整

数据库连接、服务注册中心地址、redis缓存地址以及分布式锁连接等关键配置项，都可以通过修改appsettings.Development.yml文件来定制。一切都为了让开发者体验更流畅、更便捷。

三、Docker-pose的启动与调试

深入samples目录，用Visual Studio打开lms.samples.dockerpose.sln解决方案，将docker-pose设为启动项目。随着应用的启动，一个全新的开发世界将展现在你面前。

四、Swagger API文档的直观访问

应用启动后，无需四处寻觅，打开特定的链接，Swagger API文档即刻呈现。这里是你了解、API的绝佳平台。

当你选择以docker-pose的方式启动和调试时，指定的环境变量将变为“ContainerDev”。相应的配置调整也将在appsettings.ContainerDev.yml中进行。请注意，服务连接地址应避免使用127.0.0.1或localhost。

五、测试与调试的实践环节

服务成功启动后，你可以通过/api/aount-post、/api/product-post和/api/order-post等接口进行实践和测试。这些接口将帮助你更深入地理解和运用LMS微服务框架。

六、开源共享，共创辉煌

我们还在Github和Gitee上分享了我们的开源地址，欢迎各位开发者共同交流，一起推动LMS微服务框架的发展。

至此，关于如何通过lms.samples掌握LMS微服务框架的使用就介绍完毕。想要更深入了解LMS微服务框架的内容，欢迎搜索狼蚁SEO的以往文章或继续浏览狼蚁网站SEO优化的相关文章。也请大家多多支持狼蚁SEO！