Module jdk.jdi

Package com.sun.jdi.connect

Interface ListeningConnector

所有超级接口:

Connector

       public interface ListeningConnector extends Connector
      

一个监听由目标VM发起的连接的连接器。

自1.3版本起:

1.3

Nested Class Summary

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

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

Method Summary

Modifier and Type	Method	Description
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()	指示此监听连接器是否支持单个参数映射的多个连接。

Methods declared in interface com.sun.jdi.connect.Connector

defaultArguments, description, name, transport

Method Details

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 - 无法开始监听时。具体的异常取决于正在使用的连接器实现。

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 - 无法停止监听时。具体的异常取决于正在使用的连接器实现。

IllegalConnectorArgumentsException - 当连接器参数无效时。

accept

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

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

抛出:

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

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

IllegalConnectorArgumentsException - 当连接器参数无效时。