.NET 8中如何注册SOAP Web引用以实现依赖注入？

一、你的构造注入方式是正确的 #

你在CustomerManager中使用构造函数注入CustomerSoap接口的写法符合依赖注入的最佳实践，能有效解耦代码，便于后续单元测试。代码示例：

public class CustomerManager(CustomerSoap customerSoap)
{
    private readonly CustomerSoap _customerSoap = customerSoap;
}

二、在Program.cs中配置SOAP服务客户端到DI容器 #

添加WCF服务引用后，会自动生成实现CustomerSoap接口的客户端类（通常命名为CustomerSoapClient），你需要将这个客户端实例注册到DI容器中，步骤如下：

1. 基础配置方式 #

直接在Program.cs中绑定服务地址和绑定类型（旧版asmx服务常用BasicHttpBinding）：

var builder = WebApplication.CreateBuilder(args);

// 配置SOAP服务绑定
var basicHttpBinding = new BasicHttpBinding();
// 按需配置绑定参数，比如超时、安全模式等
// basicHttpBinding.SendTimeout = TimeSpan.FromMinutes(1);
// basicHttpBinding.Security.Mode = BasicHttpSecurityMode.Transport; // 服务用HTTPS时配置

// 注册CustomerSoap到DI容器
builder.Services.AddScoped<CustomerSoap>(sp =>
{
    // 替换为你的asmx服务实际地址
    var endpointAddress = new EndpointAddress("https://your-domain/Customer.asmx");
    return new CustomerSoapClient(basicHttpBinding, endpointAddress);
});

// 其他常规配置
builder.Services.AddControllers();

var app = builder.Build();

// 中间件配置...
app.Run();

2. 从配置文件读取服务地址（推荐） #

将服务地址放到appsettings.json中，便于不同环境切换：

{
  "SOAPServices": {
    "CustomerServiceUrl": "https://your-domain/Customer.asmx"
  }
}

然后在Program.cs中读取配置并注册：

var builder = WebApplication.CreateBuilder(args);

var customerServiceUrl = builder.Configuration["SOAPServices:CustomerServiceUrl"];

builder.Services.AddScoped<CustomerSoap>(sp =>
{
    var binding = new BasicHttpBinding();
    var endpoint = new EndpointAddress(customerServiceUrl);
    return new CustomerSoapClient(binding, endpoint);
});

// 其他常规配置...

三、调用ASMX方法 #

在CustomerManager中直接通过注入的_customerSoap调用服务方法即可，示例：

public async Task<CustomerDto> GetCustomerAsync(int customerId)
{
    var response = await _customerSoap.GetCustomerByIdAsync(customerId);
    // 按需转换为DTO或直接返回
    return new CustomerDto { Id = response.Id, Name = response.CustomerName };
}

四、单元测试Mock配置 #

为了测试CustomerManager，可以用Mock框架（比如Moq）模拟CustomerSoap接口，无需依赖真实服务：

using Moq;
using Xunit;

public class CustomerManagerTests
{
    [Fact]
    public async Task GetCustomerAsync_ReturnsExpectedResult()
    {
        // 1. 模拟CustomerSoap接口
        var mockSoapClient = new Mock<CustomerSoap>();
        var testCustomerId = 123;
        var mockResponse = new Customer { Id = testCustomerId, CustomerName = "Test User" };
        
        mockSoapClient.Setup(client => client.GetCustomerByIdAsync(testCustomerId))
                      .ReturnsAsync(mockResponse);

        // 2. 实例化CustomerManager并注入Mock对象
        var manager = new CustomerManager(mockSoapClient.Object);

        // 3. 执行测试方法
        var result = await manager.GetCustomerAsync(testCustomerId);

        // 4. 断言结果
        Assert.Equal(testCustomerId, result.Id);
        Assert.Equal("Test User", result.Name);
        // 验证方法是否按预期被调用
        mockSoapClient.Verify(client => client.GetCustomerByIdAsync(testCustomerId), Times.Once);
    }
}

注意事项 #

• 客户端生命周期：推荐用AddScoped注册，WCF客户端可能持有连接资源，Scoped生命周期能和请求周期匹配，避免资源泄漏。
• 绑定配置：确保BasicHttpBinding的配置（如安全模式、消息大小、超时）与ASMX服务端的配置一致，否则可能出现调用失败。
• 异常处理：调用SOAP服务时建议添加异常捕获，处理连接超时、服务不可用等情况。

内容的提问来源于stack exchange，提问作者user2208746