Version
Language

Integration Services

The Integration Service concept was created to distinguish the application services that are built for inter-module (or inter-microservice) communication from the application services that are intended to be consumed from a UI or a client application.

The following figure shows a few microservices behind an API Gateway that is consumed by a UI application and 3rd-party client applications:

integration-services

HTTP requests coming from out of the API Gateway can be called as external request, while the HTTP requests performed between microservices can be considered as internal requests. The application services that are designed to respond to these external requests are called as integration services, because their purpose is to integrate microservices in the system, rather than respond to user requests.

Marking an Application Service as Integration Service

Assume that you have an application service named ProductAppService, and you want to use that application service as an integration service. In that case, you can use the [IntegrationService] attribute on top of the application service class as shown below:

[IntegrationService]
public class ProductAppService : ApplicationService, IProductAppService
{
    // ...
}

If your application service has an interface, like IProductService in this example, you can use it on the service interface:

[IntegrationService]
public interface IProductAppService : IApplicationService
{
    // ...
}

If you've used the [IntegrationService] on top of your service interface, it is not needed to use on the service class too.

That's all. From now, ABP will handle your application service as integration service and implement the followings by convention:

  • If you are using the Auto API Controllers feature in your application, the URL prefix will be /integration-api instead of /api for your integration services. Thus, you can distinguish internal and external service communications and take additional actions, such as preventing REST API calls for integration services out of API Gateway.
  • Audit logging is disabled by default for the integration services. See the next section if you want to enable it.

Configuration

Enabling/Disabling the Audit Logging

Audit Logging is disabled by default for integration services but it can be enabled by configuring the AbpAuditingOptions options class in the ConfigureServices method of your module class:

Configure<AbpAuditingOptions>(options =>
{
    options.IsEnabledForIntegrationService = true;
});

Please refer to the audit logging document for other options and details.

Filtering Auto API Controllers

You can filter integration services (or non-integration services) while creating Auto API Controllers, using the ApplicationServiceTypes option of the ConventionalControllerSetting by configuring the AbpAspNetCoreMvcOptions as shown below:

Configure<AbpAspNetCoreMvcOptions>(options =>
{
    options.ConventionalControllers.Create(
        typeof(MyApplicationModule).Assembly,
        conventionalControllerSetting =>
        {
            conventionalControllerSetting.ApplicationServiceTypes = 
                ApplicationServiceTypes.IntegrationServices;
        });
});

Tip: You can call the options.ConventionalControllers.Create multiple times to configure regular application services and integration services with different options.

Please refer to the Auto API Controllers document for more information about the Auto API Controller system.

See Also

In this document
Mastering ABP Framework Book
Mastering ABP Framework