java.lang.Object
- com.sun.jdi.connect.spi.TransportService

```
public abstract class TransportService
extends Object
```
用于调试器和目标VM之间连接的传输服务。
传输服务是此类的具体子类，它具有零参数构造函数并实现下面指定的抽象方法。它是Transport用于调试器和目标VM之间连接的基础服务。

传输服务用于在调试器和目标VM之间建立连接，并通过底层通信协议传输Java调试线协议（JDWP）数据包。实质上，传输服务实现将JDWP（如JDWP specification中所指定）绑定到底层通信协议。传输服务实现提供可靠的JDWP分组传输服务。 JDWP数据包发送到目标VM或从目标VM发送，而不会发生重复或数据丢失。传输服务实现可以基于可靠或不可靠的底层通信协议。如果底层通信协议是可靠的，则传输服务实现可以相对简单并且可能仅需要将JDWP分组作为底层通信协议的有效载荷来传输。在不可靠的通信协议的情况下，传输服务实现可以包括附加的协议支持，以便确保分组不被复制并且没有数据丢失。这些协议的细节特定于实现，但可能涉及诸如在诸如传输控制协议（TCP）的协议中使用的重传技术的肯定确认之类的技术（参见RFC 793 ）。

传输服务可用于启动与目标VM的连接。这是通过调用attach(java.lang.String, long, long)方法完成的。或者，传输服务可以侦听和接受目标VM发起的连接。这是通过调用startListening(String)方法将传输置于侦听模式来完成的。然后， accept(com.sun.jdi.connect.spi.TransportService.ListenKey, long, long)方法用于接受目标VM发起的连接。

从以下版本开始：

1.5

嵌套类汇总

嵌套类
变量和类型	类	描述
`static class`	`TransportService.Capabilities`	运输服务能力。
`static class`	`TransportService.ListenKey`	一键听。

构造方法摘要

构造方法
构造器	描述
`TransportService()`

方法摘要

所有方法实例方法抽象方法
变量和类型	方法	描述
`abstract Connection`	`accept(TransportService.ListenKey listenKey, long acceptTimeout, long handshakeTimeout)`	接受来自目标VM的连接。
`abstract Connection`	`attach(String address, long attachTimeout, long handshakeTimeout)`	附加到指定的地址。
`abstract TransportService.Capabilities`	`capabilities()`	返回传输服务的功能。
`abstract String`	`description()`	返回传输服务的描述。
`abstract String`	`name()`	返回用于标识传输服务的名称。
`abstract TransportService.ListenKey`	`startListening()`	侦听传输服务选择的地址。
`abstract TransportService.ListenKey`	`startListening(String address)`	侦听入站连接的指定地址。
`abstract void`	`stopListening(TransportService.ListenKey listenKey)`	停止侦听入站连接。

声明方法的类 java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- 构造方法详细信息
  - TransportService
```
public TransportService()
```
- 方法详细信息
  - name
```
public abstract String name()
```
    返回用于标识传输服务的名称。
    
    结果
    
    运输服务的名称
  - description
```
public abstract String description()
```
    返回传输服务的描述。
    
    结果
    
    运输服务的描述
  - capabilities
```
public abstract TransportService.Capabilities capabilities()
```
    返回传输服务的功能。
    
    结果
    
    运输服务能力
  - attach
```
public abstract Connection attach(String address,
                                  long attachTimeout,
                                  long handshakeTimeout)
                           throws IOException
```
    附加到指定的地址。
    附加到指定地址并将表示双向通信信道的连接返回到目标VM。
    
    附加到目标VM涉及两个步骤：首先，建立到指定地址的连接。然后进行握手以确保连接到目标VM。握手涉及交换字符串JDWP-Handshake，如Java Debug Wire Protocol规范中所规定。
    
    参数
    
    address - 目标VM的地址。
    
    attachTimeout - 如果此传输服务支持附加超时，并且如果attachTimeout为正，则它指定在连接到目标VM时要使用的超时（以毫秒（或多或少）为单位）。如果传输服务不支持附加超时，或者如果将attachTimeout指定为零，则在没有任何超时的情况下附加。
    
    handshakeTimeout - 如果此传输服务支持握手超时，并且如果handshakeTimeout为正，则它指定在与目标VM握手时使用的超时（以毫秒（更多或更少）为单位）。超时的确切用法特定于传输服务。例如，传输服务可以在等待来自目标VM的JDWP握手消息时使用握手超时作为字符间超时。或者，传输服务可以例如使用handshakeTimeout作为握手交换持续时间的超时。如果传输服务不支持握手超时，或者如果将handshakeTimeout指定为零，则如果没有来自目标VM的响应，则握手不会超时。
    
    结果
    
    Connection表示到目标VM的双向通信信道。
    
    异常
    
    TransportTimeoutException - 如果在建立连接时发生超时。
    
    IOException - 如果发生I / O错误（包括握手时超时）。
    
    IllegalArgumentException - 如果地址无效或附加超时或握手超时的值为负。
    
    另请参见：
    
    TransportService.Capabilities.supportsAttachTimeout()
  - startListening
```
public abstract TransportService.ListenKey startListening(String address)
                                                   throws IOException
```
    侦听入站连接的指定地址。
    此方法启动侦听指定地址的传输服务，以便随后可以接受入站连接。它不会等到建立入站连接。
    
    参数
    
    address - 开始侦听连接的地址，或 null侦听传输服务选择的地址。
    
    结果
    
    在后续调用中使用的listen键是 accept或 stopListening方法。
    
    异常
    
    IOException - 如果发生I / O错误。
    
    IllegalArgumentException - 如果特定地址无效
  - startListening
```
public abstract TransportService.ListenKey startListening()
                                                   throws IOException
```
    侦听传输服务选择的地址。
    这种方便的方法就像调用startListening(null)一样。
    
    结果
    
    在后续调用中使用的listen键是 accept或 stopListening方法。
    
    异常
    
    IOException - 如果发生I / O错误。
  - stopListening
```
public abstract void stopListening(TransportService.ListenKey listenKey)
                            throws IOException
```
    停止侦听入站连接。
    在accept中使用相同的listen键阻止另一个线程时调用此方法，等待接受连接将导致该线程抛出IOException。如果在accept中阻塞的线程已经接受了来自目标VM的连接，并且正在与目标VM进行握手，则调用此方法将不会导致该线程抛出异常。
    
    参数
    
    listenKey - 从先前调用 startListening(String)或 startListening()获得的侦听密钥。
    
    异常
    
    IllegalArgumentException - 如果listen键无效
    
    IOException - 如果发生I / O错误。
  - accept
```
public abstract Connection accept(TransportService.ListenKey listenKey,
                                  long acceptTimeout,
                                  long handshakeTimeout)
                           throws IOException
```
    接受来自目标VM的连接。
    等待（无限期或超时）以接受来自目标VM的连接。返回表示到目标VM的双向通信通道的连接。
    
    接受来自目标VM的连接涉及两个步骤。首先，传输服务等待接受来自目标VM的连接。一旦建立连接，就执行握手以确保连接确实是到目标VM。握手涉及交换字符串JDWP-Handshake，如Java Debug Wire Protocol规范中所规定。
    
    参数
    
    listenKey - 从先前调用 startListening(String)或 startListening()获得的侦听密钥。
    
    acceptTimeout - 如果此传输服务支持接受超时，并且如果acceptTimeout为正，则在等待目标VM连接时阻止最多acceptTimeout毫秒，或多或少。如果传输服务不支持接受超时或acceptTimeout为零，则无限期阻止目标VM进行连接。
    
    handshakeTimeout - 如果此传输服务支持握手超时，并且如果handshakeTimeout为正，则它指定在与目标VM握手时使用的超时（以毫秒（更多或更少）为单位）。超时的确切用法特定于传输服务。例如，传输服务可以在等待来自目标VM的JDWP握手消息时使用握手超时作为字符间超时。或者，传输服务可以例如使用超时作为握手交换持续时间的超时。如果传输服务不支持握手超时，如果将handshakeTimeout指定为零，则如果没有来自目标VM的响应，则握手不会超时。
    
    结果
    
    Connection表示到目标VM的双向通信信道。
    
    异常
    
    TransportTimeoutException - 如果在等待目标VM连接时发生超时。
    
    IOException - 如果发生I / O错误（包括握手时超时）。
    
    IllegalArgumentException - 如果acceptTimeout参数的值或handshakeTimeout为负数，或者提供了无效的侦听键。
    
    IllegalStateException - 如果已使用此侦听密钥调用了 stopListening ，并且传输服务不再侦听入站连接。
    
    另请参见：
    
    TransportService.Capabilities.supportsAcceptTimeout()

Class TransportService

嵌套类汇总

构造方法摘要

方法摘要

声明方法的类 java.lang.Object

构造方法详细信息

TransportService

方法详细信息

name

description

capabilities

attach

startListening

startListening

stopListening

accept