StreamHTTPSParms 接口

表示用于定义如何使用安全 HTTPS 连接与 MobiLink 服务器通信的 HTTPS 流参数。

语法

public interface StreamHTTPSParms

基类

成员

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

名称	说明
getCertificateCompany 方法	返回证书公司名以对安全连接进行验证。
getCertificateName 方法	返回证书公用名以对安全连接进行验证。
getCertificateUnit 方法	返回证书单位名以对安全连接进行验证。
getE2eePublicKey 方法 [Android]	获取包含端对端公共密钥的文件的名称。
getExtraParameters 方法 [Android]	获取额外 MobiLink 客户端网络协议选项。
getHost 方法	返回 MobiLink 服务器的主机名。
getOutputBufferSize 方法	返回在将数据发送到 MobiLink 服务器之前用于存储数据的输出缓冲区的大小（以字节为单位）。
getPort 方法	返回用于连接 MobiLink 服务器的端口号。
getTrustedCertificates 方法	返回用于安全同步的受信任根证书的列表所在文件的名称。
getURLSuffix 方法	返回 MobiLink 服务器的 URL 后缀。
isRestartable 方法	确定是否使用了可重新启动的 HTTP。
setCertificateCompany 方法	设置证书公司名以对安全连接进行验证。
setCertificateName 方法	设置证书公用名以对安全连接进行验证。
setCertificateUnit 方法	设置证书单位名以对安全连接进行验证。
setE2eePublicKey 方法 [Android]	设置包含端对端公共密钥的文件的名称。
setExtraParameters 方法 [Android]	设置额外 MobiLink 客户端网络协议选项。
setHost 方法	设置 MobiLink 服务器的主机名。
setOutputBufferSize 方法	设置在将数据发送到 MobiLink 服务器之前用于存储数据的输出缓冲区的大小（以字节为单位）。
setPort 方法	设置用于连接 MobiLink 服务器的端口号。
setRestartable 方法	启用或禁用可重新启动的 HTTP。
setTrustedCertificates 方法	设置其中包含用于安全同步的受信任根证书列表的文件。
setURLSuffix 方法	指定用于连接到 MobiLink 服务器的 URL 后缀。
setZlibCompression 方法	启用或禁用 ZLIB 压缩。
setZlibDownloadWindowSize 方法	设置 ZLIB 压缩的下载窗口大小。
setZlibUploadWindowSize 方法	设置 ZLIB 压缩的上载窗口大小。
zlibCompressionEnabled 方法	确定是否已启用 ZLIB 压缩。

注释

下面的示例将流参数设置为与主机名为 "MyMLHost" 的 MobiLink 服务器通信。使用以下参数启动该服务器："-x https(port=1234;certificate=RSAServer.crt;certificate_password=x)"

SyncParms syncParms = myConnection.createSyncParms(
        SyncParms.HTTPS_STREAM,
        "MyUniqueMLUserID",
        "MyMLScriptVersion"
    );
StreamHTTPSParms httpsParms =
    (StreamHTTPSParms) syncParms.getStreamParms();
httpsParms.setHost("MyMLHost");
httpsParms.setPort(1234);

上面的示例假设 RSAServer.crt 中的证书链接到已安装在客户端主机或设备上的受信任根证书。

对于 J2SE，可使用以下任一方法部署必需的受信任根证书：

将受信任的根证书安装在 JRE 的 lib/security/cacerts 密钥存储区中。
使用 Java keytool 实用程序构建自己的密钥存储库，并将 Java 系统属性 javax.net.ssl.trustStore 设置为该位置（将 javax.net.ssl.trustStorePassword 方法设置为适当值）。
使用 setTrustedCertificates(String) 参数指向部署的证书文件。

为增强安全性，应使用 setCertificateName、setCertificateCompany 和 setCertificateUnit 方法启用对 MobiLink 服务器证书的验证。

为 HTTPS 同步创建 SyncParms 对象后，由 SyncParms.getStreamParms 方法返回实现此接口的实例。

另请参见

getCertificateCompany 方法
 getCertificateName 方法
 getCertificateUnit 方法
 getTrustedCertificates 方法
 setCertificateCompany 方法
 setCertificateName 方法
 setCertificateUnit 方法
 setTrustedCertificates 方法

使用DocCommentXchange讨论此页。