org.eclipse.jdt.internal.launching

Class SocketListenConnectorProcess

java.lang.Object

org.eclipse.jdt.internal.launching.SocketListenConnectorProcess

public class SocketListenConnectorProcess
extends java.lang.Object

A process that represents a VM listening connector that is waiting for some VM(s) to remotely connect. Allows the user to see the status of the connection and terminate it. If a successful connection occurs, the debug target is added to the launch and, if a configured number of connections have been reached, then this process is removed.

Since:

3.4

See Also:

SocketListenConnector

Constructor Summary

Constructors

Constructor and Description
SocketListenConnectorProcess(ILaunch launch, java.lang.String port, int connectionLimit) Creates this process.

Method Summary

Modifier and Type	Method and Description
boolean	canTerminate()
protected boolean	continueListening() Return true if this connector should continue listening for further connections.
protected void	fireReadyToAcceptEvent() Fires a custom model specific event when this connector is ready to accept incoming connections from a remote VM.
protected void	fireTerminateEvent() Fires a terminate event.
<T> T	getAdapter(java.lang.Class<T> adapter)
java.lang.String	getAttribute(java.lang.String key)
int	getExitValue()
java.lang.String	getLabel()
ILaunch	getLaunch()
protected static IStatus	getStatus(java.lang.String message, java.lang.Throwable exception, int code) Returns an error status using the passed parameters.
IStreamsProxy	getStreamsProxy()
boolean	isTerminated()
void	setAttribute(java.lang.String key, java.lang.String value)
void	terminate()
void	waitForConnection(ListeningConnector connector, java.util.Map<java.lang.String,Connector.Argument> arguments) Starts a job that will accept a VM remotely connecting to the given connector.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

SocketListenConnectorProcess

public SocketListenConnectorProcess(ILaunch launch,
                                    java.lang.String port,
                                    int connectionLimit)

Creates this process. The label for this process will state the port the connector is listening at.

Parameters:

launch - the launch this process belongs to

port - the port the connector will wait on

connectionLimit - the number of incoming connections to accept (0 = unlimited)

Method Detail

waitForConnection

public void waitForConnection(ListeningConnector connector,
                              java.util.Map<java.lang.String,Connector.Argument> arguments)
                       throws CoreException

Starts a job that will accept a VM remotely connecting to the given connector. The #startListening() method must have been called on the connector with the same arguments before calling this method. The 'port' argument in the map should have the same value as the port specified in this process' constructor.

Parameters:

connector - the connector that will accept incoming connections

arguments - map of arguments that are used by the connector

Throws:

CoreException - if a problem occurs trying to accept a connection

See Also:

SocketListenConnector

continueListening

protected boolean continueListening()

Return true if this connector should continue listening for further connections.

getStatus

protected static IStatus getStatus(java.lang.String message,
                                   java.lang.Throwable exception,
                                   int code)

Returns an error status using the passed parameters.

Parameters:

message - the status message

exception - lower level exception associated with the error, or null if none

code - error code

Returns:

the new IStatus

getExitValue

public int getExitValue()
                 throws DebugException

Throws:

DebugException

getLabel

public java.lang.String getLabel()

getLaunch

public ILaunch getLaunch()

canTerminate

public boolean canTerminate()

isTerminated

public boolean isTerminated()

terminate

public void terminate()
               throws DebugException

Throws:

DebugException

fireTerminateEvent

protected void fireTerminateEvent()

Fires a terminate event.

fireReadyToAcceptEvent

protected void fireReadyToAcceptEvent()

Fires a custom model specific event when this connector is ready to accept incoming connections from a remote VM.

getStreamsProxy

public IStreamsProxy getStreamsProxy()

getAttribute

public java.lang.String getAttribute(java.lang.String key)

setAttribute

public void setAttribute(java.lang.String key,
                         java.lang.String value)

getAdapter

public <T> T getAdapter(java.lang.Class<T> adapter)