jenkins

Class AgentProtocol

java.lang.Object

jenkins.AgentProtocol

All Implemented Interfaces:

ExtensionPoint

Direct Known Subclasses:

CliProtocol, JnlpSlaveAgentProtocol

public abstract class AgentProtocol
extends Object
implements ExtensionPoint

Pluggable Jenkins TCP agent protocol handler called from TcpSlaveAgentListener.

To register your extension, put Extension annotation on your subtype. Implementations of this extension point is singleton, and its handle(Socket) method gets invoked concurrently whenever a new connection comes in.

Since:

1.467

Author:

Kohsuke Kawaguchi

See Also:

TcpSlaveAgentListener

Nested Class Summary

Nested classes/interfaces inherited from interface hudson.ExtensionPoint

ExtensionPoint.LegacyInstancesAreScopedToHudson

Constructor Summary

Constructors

Constructor and Description
AgentProtocol()

Method Summary

Modifier and Type	Method and Description
static ExtensionList<AgentProtocol>	all() Returns all the registered AgentProtocols.
abstract String	getName() Protocol name.
abstract void	handle(Socket socket) Called by the connection handling thread to execute the protocol.
static AgentProtocol	of(String protocolName)

Methods inherited from class java.lang.Object

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

Constructor Detail

AgentProtocol

public AgentProtocol()

Method Detail

getName

public abstract String getName()

Protocol name. This is a short string that consists of printable ASCII chars. Sent by the client to select the protocol.

Returns:

null to be disabled. This is useful for avoiding getting used until the protocol is properly configured.

handle

public abstract void handle(Socket socket)
                     throws IOException,
                            InterruptedException

Called by the connection handling thread to execute the protocol.

Throws:

IOException

InterruptedException

all

public static ExtensionList<AgentProtocol> all()

Returns all the registered AgentProtocols.

of

public static AgentProtocol of(String protocolName)