模块 jdk.jdi

软件包 com.sun.jdi.connect

Interface ListeningConnector

All Superinterfaces:

Connector

public interface ListeningConnector
extends Connector

一种连接器，用于侦听目标VM发起的连接。

从以下版本开始：

1.3

嵌套类汇总

Nested classes/interfaces declared in interface com.sun.jdi.connect.Connector

Connector.Argument, Connector.BooleanArgument, Connector.IntegerArgument, Connector.SelectedArgument, Connector.StringArgument

方法摘要

变量和类型	方法	描述
VirtualMachine	accept(Map<String,? extends Connector.Argument> arguments)	等待目标VM连接到此连接器。
String	startListening(Map<String,? extends Connector.Argument> arguments)	侦听目标VM发起的一个或多个连接。
void	stopListening(Map<String,? extends Connector.Argument> arguments)	取消侦听连接。
boolean	supportsMultipleConnections()	指示此侦听连接器是否支持单个参数映射的多个连接。

声明方法的接口 com.sun.jdi.connect.Connector

defaultArguments, description, name, transport

方法详细信息

supportsMultipleConnections

boolean supportsMultipleConnections()

指示此侦听连接器是否支持单个参数映射的多个连接。 如果是，则调用startListening(java.util.Map<java.lang.String, ? extends com.sun.jdi.connect.Connector.Argument>)可以允许多个目标VM连接。

结果

true如果支持多个连接; 否则为false 。

startListening

String startListening(Map<String,? extends Connector.Argument> arguments)
               throws IOException,
                      IllegalConnectorArgumentsException

侦听目标VM发起的一个或多个连接。 连接器使用给定的参数映射来确定要侦听的地址，否则它会生成适当的侦听地址。 在任何一种情况下，都会从此方法返回一个地址字符串，该字符串可用于启动目标VM以识别此连接器。 地址字符串的格式是连接器，传输，并且可能与平台相关。

参数映射将参数名称字符串与Connector.Argument的实例相关联。 可以通过Connector.defaultArguments()获取连接器的默认参数映射。 可以更改参数映射值，但不应添加或删除映射条目。

此方法不返回VirtualMachine ，并且通常在任何目标VM启动连接之前返回。 连接目标通过accept(java.util.Map<java.lang.String, ? extends com.sun.jdi.connect.Connector.Argument>)获得（使用与传递给此方法相同的参数映射）。

如果arguments包含寻址信息。 并且只接受一个连接，可以立即调用accept方法而不调用此方法。

结果

连接器侦听连接的地址。

异常

IOException - 无法开始收听时 具体的异常取决于正在使用的Connector实现。

IllegalConnectorArgumentsException - 当其中一个连接器参数无效时。

stopListening

void stopListening(Map<String,? extends Connector.Argument> arguments)
            throws IOException,
                   IllegalConnectorArgumentsException

取消侦听连接。 给定的参数映射应与先前startListening(java.util.Map<java.lang.String, ? extends com.sun.jdi.connect.Connector.Argument>)调用的参数映射匹配。

异常

IOException - 无法停止收听时。 具体的异常取决于正在使用的Connector实现。

IllegalConnectorArgumentsException - 当其中一个连接器参数无效时。

accept

VirtualMachine accept(Map<String,? extends Connector.Argument> arguments)
               throws IOException,
                      IllegalConnectorArgumentsException

等待目标VM连接到此连接器。

异常

TransportTimeoutException - 当Connector在接受时封装支持超时的传输时，在参数映射中设置了表示超时的Connector.Argument ，并且在等待目标VM连接时发生超时。

IOException - 无法接受时。 具体的异常取决于正在使用的Connector实现。

IllegalConnectorArgumentsException - 当其中一个连接器参数无效时。