Module jdk.jdi

软件包 com.sun.jdi.connect

Interface ListeningConnector

All Superinterfaces:

Connector

public interface ListeningConnector
extends Connector

侦听由目标虚拟机启动的连接的连接器。

从以下版本开始：

1.3

Nested Class Summary

Nested classes/interfaces inherited from interface com.sun.jdi.connect.Connector

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

方法摘要

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

Methods inherited from interface 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

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

参数映射将参数名称字符串与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.Argument ，并在等待目标虚拟机连接时发生超时。

IOException - 当不能接受。 具体的异常取决于使用中的Connector实现。

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