jdk/src/jdk.jdi/share/classes/com/sun/jdi/connect/ListeningConnector.java
changeset 45564 0149773a140c
parent 34894 3248b89d1921
equal deleted inserted replaced
45563:ece4ae6beba3 45564:0149773a140c
     1 /*
     1 /*
     2  * Copyright (c) 1998, 2013, Oracle and/or its affiliates. All rights reserved.
     2  * Copyright (c) 1998, 2017, Oracle and/or its affiliates. All rights reserved.
     3  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
     3  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
     4  *
     4  *
     5  * This code is free software; you can redistribute it and/or modify it
     5  * This code is free software; you can redistribute it and/or modify it
     6  * under the terms of the GNU General Public License version 2 only, as
     6  * under the terms of the GNU General Public License version 2 only, as
     7  * published by the Free Software Foundation.  Oracle designates this
     7  * published by the Free Software Foundation.  Oracle designates this
    23  * questions.
    23  * questions.
    24  */
    24  */
    25 
    25 
    26 package com.sun.jdi.connect;
    26 package com.sun.jdi.connect;
    27 
    27 
       
    28 import java.io.IOException;
    28 import java.util.Map;
    29 import java.util.Map;
    29 import java.io.IOException;
    30 
    30 import com.sun.jdi.VirtualMachine;
    31 import com.sun.jdi.VirtualMachine;
    31 
    32 
    32 /**
    33 /**
    33  * A connector which listens for a connection initiated by a target VM.
    34  * A connector which listens for a connection initiated by a target VM.
    34  *
    35  *
    35  * @author Gordon Hirsch
    36  * @author Gordon Hirsch
    36  * @since  1.3
    37  * @since  1.3
    37  */
    38  */
    38 public interface ListeningConnector extends Connector {
    39 public interface ListeningConnector extends Connector {
       
    40 
    39     /**
    41     /**
    40      * Indicates whether this listening connector supports multiple
    42      * Indicates whether this listening connector supports multiple
    41      * connections for a single argument map. If so, a call to
    43      * connections for a single argument map. If so, a call to
    42      * {@link #startListening} may allow
    44      * {@link #startListening} may allow
    43      * multiple target VM to become connected.
    45      * multiple target VM to become connected.
    94      * connector arguments is invalid.
    96      * connector arguments is invalid.
    95      */
    97      */
    96     void stopListening(Map<String,? extends Connector.Argument> arguments)
    98     void stopListening(Map<String,? extends Connector.Argument> arguments)
    97         throws IOException, IllegalConnectorArgumentsException;
    99         throws IOException, IllegalConnectorArgumentsException;
    98 
   100 
    99 
       
   100     /**
   101     /**
   101      * Waits for a target VM to attach to this connector.
   102      * Waits for a target VM to attach to this connector.
   102      *
   103      *
   103      * @throws TransportTimeoutException when the Connector encapsulates
   104      * @throws TransportTimeoutException when the Connector encapsulates
   104      * a transport that supports a timeout when accepting, a
   105      * a transport that supports a timeout when accepting, a
   111      * @throws IllegalConnectorArgumentsException when one of the
   112      * @throws IllegalConnectorArgumentsException when one of the
   112      * connector arguments is invalid.
   113      * connector arguments is invalid.
   113      */
   114      */
   114     VirtualMachine accept(Map<String,? extends Connector.Argument> arguments)
   115     VirtualMachine accept(Map<String,? extends Connector.Argument> arguments)
   115         throws IOException, IllegalConnectorArgumentsException;
   116         throws IOException, IllegalConnectorArgumentsException;
   116 
       
   117 }
   117 }