NetworkData 接口

包含关于同步网络流的信息。

语法

public interface NetworkData

成员

NetworkData 接口的所有成员，包括所有继承的成员。

名称	说明
getCertificateChain 方法	返回包含客户端发送的任何证书的 java.security.cert.CertPath 对象。
getHTTPHeaders 方法	返回将标头名称映射至标头值列表的 Map 对象。
getHTTPHeaderValue 方法	返回由具有所提供名称的服务器接收的最后一个标头值。
getHTTPHeaderValues 方法	返回与所提供名称相关联的服务器接收的所有标头值。
isEndToEndEncrypted 方法	确定此同步是否为端对端加密。
isHTTP 方法	确定同步使用的是 HTTP 或 HTTPS。
isTLS 方法	确定此同步是否使用 TLS。

注释

针对使用客户端证书和 HTTP 标头的企业中的另一服务器进行验证时，此接口很有用。

要启用网络流数据的集合，将 collect_network_data=1 添加至您的 -x 开关。将添加额外的每个同步内存开销以存储数据。使用含客户端证书的 TLS 或 HTTPS 时，添加 trusted_certificates=<certificate file>=""> 使服务器在 TLS 握手期间要求客户端发送证书，从而降低时间和网络成本。

可以通过调用 DBConnectionContext 类的 getNetworkData 方法获得 NetworkData 对象。使用 HTTP 或 HTTPS 时，它将包含在调用验证脚本之前服务器接收的最后一个 HTTP 请求的标头日期。

另请参见

示例

以下示例说明如何从 DBConnectionContext 对象中获得 NetworkData 对象，以及如何输出数据。

public class OrderProcessor {
    DBConnectionContext _cc;

    public OrderProcessor( DBConnectionContext cc ) {
        _cc = cc;
    }

    // The method used for the authenticate_user event.
    public void AuthUser() {
        NetworkData nd = _cc.getNetworkData();
        if( nd != null ) {
            if( nd.isHTTP() ) {
                System.out.println( "http" );
                String user_agent = nd.getHTTPHeaderValue( "user-agent" );
                System.out.println( "  user-agent: " + user_agent.substring( 0, user_agent.indexOf( '/' ) ) );
            } else {
                System.out.println( "no http" );
            }
            if( nd.isTLS() ) {
                System.out.println( "tls" );
                CertPath certs = nd.getCertificateChain();
                if( certs != null ) {
                    System.out.println( "  client-side cert:" );
                    int n = 1;
                    for( Certificate c : certs.getCertificates() ) {
                        System.out.println( "    cert " + n++ );
                        X509Certificate c509 = (X509Certificate) c;
                        System.out.println( "      Subject: " + c509.getSubjectX500Principal().getName() );
                        System.out.println( "      Issuer: " + c509.getIssuerX500Principal().getName() );
                    }
                } else {
                    System.out.println( "  no client cert" );
                }
            } else {
                System.out.println( "no tls" );
            }
            if( nd.isEndToEndEncrypted() ) {
                System.out.println( "e2ee" );
            } else {
                System.out.println( "no e2ee" );
            }
        } else {
            System.out.println( "NULL networkdata" );
        }
    }
}

getCertificateChain 方法
 getHTTPHeaders 方法
 getHTTPHeaderValue 方法
 getHTTPHeaderValues 方法
 isEndToEndEncrypted 方法
 isHTTP 方法
 isTLS 方法

使用DocCommentXchange讨论此页。