org.apache.http.conn

## Interface OperatedClientConnection

- All Superinterfaces:
    AutoCloseable ， Closeable ， HttpClientConnection ， HttpConnection ， HttpInetConnection
  所有已知实现类：
    DefaultClientConnection

  已过时。
  （4.3）由`HttpClientConnectionManager`取代。

      @Deprecated
      public interface OperatedClientConnection
      extends HttpClientConnection, HttpInetConnection

  客户端连接依靠外部逻辑将套接字连接到相应的主机。 它可以由应用程序直接操作，或通过`operator`操作 。
  从以下版本开始：
    4

- - ### 方法摘要

    Methods
    Modifier and Type | Method and Description
    --- | ---
    `Socket` | `getSocket()` 已过时。 获取此连接的套接字。
    `HttpHost` | `getTargetHost()` 已过时。 获取此连接的目标主机。
    `boolean` | `isSecure()` 已过时。 指示此连接是否安全。
    `void` | `openCompleted(boolean secure, HttpParams params)` 已过时。 表示连接已成功打开。
    `void` | `opening(Socket sock, HttpHost target)` 已过时。 表示此连接正在打开。
    `void` | `update(Socket sock, HttpHost target, boolean secure, HttpParams params)` 已过时。 更新此连接。

    - ### Methods inherited from interface org.apache.http.HttpClientConnection

      `flush, isResponseAvailable, receiveResponseEntity, receiveResponseHeader, sendRequestEntity, sendRequestHeader`

    - ### Methods inherited from interface org.apache.http.HttpInetConnection

      `getLocalAddress, getLocalPort, getRemoteAddress, getRemotePort`

    - ### Methods inherited from interface org.apache.http.HttpConnection

      `close, getMetrics, getSocketTimeout, isOpen, isStale, setSocketTimeout, shutdown`

- - ### 方法详细信息

    - #### getTargetHost

          HttpHost getTargetHost()

      已过时。
      获取此连接的目标主机。 如果连接是代理但不是隧道，这是代理。 如果通过代理隧道连接，这是隧道的目标。

      只有当连接打开时，返回值才被明确定义。 由于`update` ，连接打开时也可能发生变化。

      结果
        打开此连接的主机

    - #### isSecure

          boolean isSecure()

      已过时。
      指示此连接是否安全。 只有当连接打开时，返回值才被明确定义。 由于`update` ，连接打开时可能会发生变化。
      结果
        `true`如果这个连接是安全的， `false`否则

    - #### getSocket

          Socket getSocket()

      已过时。
      获取此连接的套接字。 只有当连接打开时，返回值才被明确定义。 由于`update` ，连接打开时可能会发生变化。
      结果
        用于与 `target host`通信的插座

    - #### opening

          void opening(Socket sock,
                     HttpHost target)
                       throws IOException

      已过时。
      表示此连接正在打开。

      通过调用此方法，可以在调用`openCompleted(boolean, org.apache.http.params.HttpParams)`之前，使用新的Socket实例重新初始化连接。 如果在完全打开之前调用`shutdown` ，这将使连接关闭该套接字。 关闭未连接的套接字将中断连接上被阻塞的线程。 否则，该线程将超时连接，或者它成功返回，然后打开刚刚关闭的连接。

      如果连接分层在另一个协议上，则可以多次调用此方法。 注意：此方法不会关闭以前使用的套接字。 如果不再需要，则主叫方有义务关闭该套接字。

      呼叫者必须调用`openCompleted(boolean, org.apache.http.params.HttpParams)`才能完成此过程。

      参数
        `sock` - 即将要连接的未连接的插座。
        `target` - 这个连接的目标主机
      异常
        `IOException`

    - #### openCompleted

          void openCompleted(boolean secure,
                           HttpParams params)
                             throws IOException

      已过时。
      表示连接已成功打开。 尝试在打开的连接上调用此方法将导致异常。
      参数
        `secure` - `true`如果此连接是安全的，例如，如果使用 `SSLSocket` ，或 `false`如果它不安全
        `params` - 此连接的参数。 创建依赖对象时将使用参数，例如确定缓冲区大小。
      异常
        `IOException`

    - #### update

          void update(Socket sock,
                    HttpHost target,
                    boolean secure,
                    HttpParams params)
                      throws IOException

      已过时。
      更新此连接。 连接只有在打开时才能更新。 更新例如在建立隧道时或TLS / SSL连接分层在普通套接字连接之上时使用。

      注意：更新连接将不会关闭以前使用的套接字。 如果不再需要，则主叫方有义务关闭该套接字。

      参数
        `sock` - 用于与目标主机通信的新插座，或`null`继续使用旧套接字。 如果传递`null` ，则应重新使用依赖套接字的帮助对象。 在这种情况下，参数中的某些更改将不会生效。
        `target` - 这个连接的新目标主机
        `secure` - `true`如果此连接现在是安全的， `false`如果不安全
        `params` - 此连接的新参数
      异常
        `IOException`

Copyright © 1999–2017 The Apache Software Foundation. All rights reserved.

本帮助文档是使用 《谷歌翻译》翻译，请与英文版配合使用 by--QQ:654638585