Package org.jvnet.hudson.test

Class InboundAgentRule

java.lang.Object

org.junit.rules.ExternalResource

org.jvnet.hudson.test.InboundAgentRule

All Implemented Interfaces:

org.junit.rules.TestRule

public final class InboundAgentRule
extends org.junit.rules.ExternalResource

This is the JUnit 4 implementation of InboundAgentFixture. Usage:

 @Rule
 public final InboundAgentRule inboundAgent = new InboundAgentRule();
 

See Also:

• InboundAgentFixture
• JenkinsRule.createComputerLauncher(hudson.EnvVars)
• JenkinsRule.createSlave()

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	InboundAgentRule.AgentArguments
static final class	InboundAgentRule.Options	The options used to (re)start an inbound agent.

Constructor Summary

Constructors

Constructor	Description
InboundAgentRule()

Method Summary

Modifier and Type	Method	Description
protected void	after()
hudson.model.Slave	createAgent(JenkinsRule r, String name)	Creates, attaches, and starts a new inbound agent.
hudson.model.Slave	createAgent(JenkinsRule r, InboundAgentRule.Options options)	Creates, attaches, and optionally starts a new inbound agent.
void	createAgent(RealJenkinsRule rr, String name)
void	createAgent(RealJenkinsRule rr, InboundAgentRule.Options options)
static String[]	createAgentRJR(JenkinsRule r, InboundAgentRule.Options options)
static InboundAgentRule.AgentArguments	getAgentArguments(JenkinsRule r, String name)
boolean	isAlive(String name)	Checks whether an existing inbound agent process is currently running.
void	start(InboundAgentRule.AgentArguments agentArguments, InboundAgentRule.Options options)
void	start(JenkinsRule r, String name)	(Re-)starts an existing inbound agent.
void	start(JenkinsRule r, InboundAgentRule.Options options)	(Re-)starts an existing inbound agent.
void	start(RealJenkinsRule r, InboundAgentRule.Options options)	(Re-)starts an existing inbound agent.
void	startOnly(RealJenkinsRule r, InboundAgentRule.Options options)	Starts an existing inbound agent without waiting for it to go online.
void	stop(String name)	Stops an existing inbound agent.
void	stop(JenkinsRule r, String name)	Stop an existing inbound agent and wait for it to go offline.
void	stop(RealJenkinsRule rjr, String name)	Stop an existing inbound agent and wait for it to go offline.
static void	waitForAgentOffline(JenkinsRule r, String name)
static void	waitForAgentOnline(JenkinsRule r, String name, Map<String,Level> loggers)

Methods inherited from class org.junit.rules.ExternalResource

apply, before

Methods inherited from class java.lang.Object

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

Constructor Details

InboundAgentRule

public InboundAgentRule()

Method Details

createAgent

public hudson.model.Slave createAgent(@NonNull
 JenkinsRule r,
 @CheckForNull
 String name)
                               throws Exception

Creates, attaches, and starts a new inbound agent.

Parameters:

name - an optional Slave.getNodeName()

Throws:

Exception

createAgent

public hudson.model.Slave createAgent(@NonNull
 JenkinsRule r,
 InboundAgentRule.Options options)
                               throws Exception

Creates, attaches, and optionally starts a new inbound agent.

Parameters:

options - the options

Throws:

Exception

createAgent

public void createAgent(@NonNull
 RealJenkinsRule rr,
 @CheckForNull
 String name)
                 throws Throwable

Throws:

Throwable

createAgent

public void createAgent(@NonNull
 RealJenkinsRule rr,
 InboundAgentRule.Options options)
                 throws Throwable

Throws:

Throwable

start

public void start(@NonNull
 JenkinsRule r,
 @NonNull
 String name)
           throws Exception

(Re-)starts an existing inbound agent.

Throws:

Exception

start

public void start(@NonNull
 JenkinsRule r,
 InboundAgentRule.Options options)
           throws Exception

(Re-)starts an existing inbound agent.

Throws:

Exception

start

public void start(@NonNull
 RealJenkinsRule r,
 InboundAgentRule.Options options)
           throws Throwable

(Re-)starts an existing inbound agent.

Throws:

Throwable

startOnly

public void startOnly(@NonNull
 RealJenkinsRule r,
 InboundAgentRule.Options options)
               throws Throwable

Starts an existing inbound agent without waiting for it to go online.

Throws:

Throwable

start

public void start(InboundAgentRule.AgentArguments agentArguments,
 InboundAgentRule.Options options)
           throws Exception

Throws:

Exception

stop

public void stop(@NonNull
 JenkinsRule r,
 @NonNull
 String name)
          throws InterruptedException

Stop an existing inbound agent and wait for it to go offline.

Throws:

InterruptedException

stop

public void stop(@NonNull
 RealJenkinsRule rjr,
 @NonNull
 String name)
          throws Throwable

Stop an existing inbound agent and wait for it to go offline.

Throws:

Throwable

stop

public void stop(@NonNull
 String name)

Stops an existing inbound agent. You need only call this to simulate an agent crash, followed by start(org.jvnet.hudson.test.JenkinsRule, java.lang.String).

isAlive

public boolean isAlive(String name)

Checks whether an existing inbound agent process is currently running. (This is distinct from whether Jenkins considers the computer to be connected.)

after

protected void after()

Overrides:

after in class org.junit.rules.ExternalResource

getAgentArguments

public static InboundAgentRule.AgentArguments getAgentArguments(JenkinsRule r,
 String name)
                                                         throws IOException

Throws:

IOException

waitForAgentOnline

public static void waitForAgentOnline(JenkinsRule r,
 String name,
 Map<String,Level> loggers)
                               throws Exception

Throws:

Exception

waitForAgentOffline

public static void waitForAgentOffline(JenkinsRule r,
 String name)
                                throws InterruptedException

Throws:

InterruptedException

createAgentRJR

public static String[] createAgentRJR(JenkinsRule r,
 InboundAgentRule.Options options)
                               throws Throwable

Throws:

Throwable