高级技术

本节介绍了一些高级技术,您可能会发现它们在某些情况下很有用。

策略接口

在许多情况下,前面描述的配置足以启用通过 TCP/IP 的安全通信。但是,Spring Integration 提供了许多策略接口,以允许自定义和修改套接字工厂和套接字。

  • TcpSSLContextSupport

  • TcpSocketFactorySupport

  • TcpSocketSupport

  • TcpNetConnectionSupport

  • TcpNioConnectionSupport

TcpSSLContextSupport 策略接口

以下清单显示了 TcpSSLContextSupport 策略接口

public interface TcpSSLContextSupport {

    SSLContext getSSLContext() throws Exception;

}

TcpSSLContextSupport 接口的实现负责创建 SSLContext 对象。框架提供的实现是 DefaultTcpSSLContextSupport如前所述。如果您需要不同的行为,请实现此接口,并为连接工厂提供对您类实现的 bean 的引用。

TcpSocketFactorySupport 策略接口

以下清单显示了 TcpSocketFactorySupport 策略接口的定义

public interface TcpSocketFactorySupport {

    ServerSocketFactory getServerSocketFactory();

    SocketFactory getSocketFactory();

}

此接口的实现负责获取对 ServerSocketFactorySocketFactory 的引用。提供了两种实现。第一个是 DefaultTcpNetSocketFactorySupport,用于非 SSL 套接字(当未定义 ssl-context-support 属性时)。这使用 JDK 的默认工厂。第二个实现是 DefaultTcpNetSSLSocketFactorySupport。默认情况下,当定义了 ssl-context-support 属性时,将使用此属性。它使用该 bean 创建的 SSLContext 来创建套接字工厂。

此接口仅在 using-niofalse 时适用。NIO 不使用套接字工厂。

TcpSocketSupport 策略接口

以下清单显示了 TcpSocketSupport 策略接口的定义

public interface TcpSocketSupport {

    void postProcessServerSocket(ServerSocket serverSocket);

    void postProcessSocket(Socket socket);

}

此接口的实现可以在创建套接字后,在应用所有配置属性后但套接字使用之前修改套接字。这适用于您是否使用 NIO。例如,您可以使用此接口的实现来修改 SSL 套接字上支持的密码套件,或者您可以添加一个在 SSL 握手完成后收到通知的侦听器。框架提供的唯一实现是 DefaultTcpSocketSupport,它不会以任何方式修改套接字。

要提供您自己的 TcpSocketFactorySupportTcpSocketSupport 实现,请分别通过设置 socket-factory-supportsocket-support 属性,为连接工厂提供对您自定义类型的 bean 的引用。

TcpNetConnectionSupport 策略接口

以下清单显示了 TcpNetConnectionSupport 策略接口的定义

public interface TcpNetConnectionSupport {

    TcpNetConnection createNewConnection(Socket socket,
            boolean server, boolean lookupHost,
            ApplicationEventPublisher applicationEventPublisher,
            String connectionFactoryName) throws Exception;

}

此接口用于创建类型为TcpNetConnection(或其子类)的对象。框架提供了一个单一实现(DefaultTcpNetConnectionSupport),默认情况下,它创建简单的TcpNetConnection对象。它有两个属性:pushbackCapablepushbackBufferSize。当启用回推时,实现将返回一个子类,该子类将连接的InputStream包装在PushbackInputStream中。与PushbackInputStream默认值一致,缓冲区大小默认为 1。这使反序列化器能够将字节“回读”(回推)到流中。以下简单示例展示了它如何在委托反序列化器中使用,该反序列化器“窥视”第一个字节以确定要调用的反序列化器

public class CompositeDeserializer implements Deserializer<byte[]> {

    private final ByteArrayStxEtxSerializer stxEtx = new ByteArrayStxEtxSerializer();

    private final ByteArrayCrLfSerializer crlf = new ByteArrayCrLfSerializer();

    @Override
    public byte[] deserialize(InputStream inputStream) throws IOException {
        PushbackInputStream pbis = (PushbackInputStream) inputStream;
        int first = pbis.read();
        if (first < 0) {
            throw new SoftEndOfStreamException();
        }
        pbis.unread(first);
        if (first == ByteArrayStxEtxSerializer.STX) {
            this.receivedStxEtx = true;
            return this.stxEtx.deserialize(pbis);
        }
        else {
            this.receivedCrLf = true;
            return this.crlf.deserialize(pbis);
        }
    }

}

TcpNioConnectionSupport 策略接口

以下列表显示了TcpNioConnectionSupport策略接口的定义

public interface TcpNioConnectionSupport {

    TcpNioConnection createNewConnection(SocketChannel socketChannel,
            boolean server, boolean lookupHost,
            ApplicationEventPublisher applicationEventPublisher,
            String connectionFactoryName) throws Exception;

}

此接口用于创建TcpNioConnection对象(或来自子类的对象)。Spring Integration 提供了两种实现:DefaultTcpNioSSLConnectionSupportDefaultTcpNioConnectionSupport。使用哪一个取决于是否使用 SSL。一个常见的用例是子类化DefaultTcpNioSSLConnectionSupport并覆盖postProcessSSLEngine。请参阅SSL 客户端身份验证示例。与DefaultTcpNetConnectionSupport一样,这些实现也支持回推。

示例:启用 SSL 客户端身份验证

要启用使用 SSL 时客户端证书身份验证,技术取决于您是否使用 NIO。当您不使用 NIO 时,提供一个自定义的TcpSocketSupport实现来后处理服务器套接字

serverFactory.setTcpSocketSupport(new DefaultTcpSocketSupport() {

    @Override
    public void postProcessServerSocket(ServerSocket serverSocket) {
        ((SSLServerSocket) serverSocket).setNeedClientAuth(true);
    }

});

(当您使用 XML 配置时,通过设置socket-support属性提供对您 bean 的引用)。

当您使用 NIO 时,提供一个自定义的TcpNioSslConnectionSupport实现来后处理SSLEngine,如下例所示

@Bean
public DefaultTcpNioSSLConnectionSupport tcpNioConnectionSupport() {
    return new DefaultTcpNioSSLConnectionSupport(serverSslContextSupport) {

            @Override
            protected void postProcessSSLEngine(SSLEngine sslEngine) {
                sslEngine.setNeedClientAuth(true);
            }

    }
}

@Bean
public TcpNioServerConnectionFactory server() {
    ...
    serverFactory.setTcpNioConnectionSupport(tcpNioConnectionSupport());
    ...
}

(当您使用 XML 配置时,从 4.3.7 版本开始,通过设置nio-connection-support属性提供对您 bean 的引用)。