Package org.jvnet.hudson.test

Class RestartableJenkinsRule

java.lang.Object

org.jvnet.hudson.test.RestartableJenkinsRule

All Implemented Interfaces:

org.junit.rules.MethodRule

@Deprecated
public class RestartableJenkinsRule
extends Object
implements org.junit.rules.MethodRule

Deprecated.

New code should use JenkinsSessionRule. RestartableJenkinsRule will evaluate your test method to collect all steps, then execute them in turn and restart Jenkins in between each step, after the test method has exited. That is probably not what you would expect from looking at sources, and it will not work naturally with After etc. Tests needing to dynamically disable plugins, simulate crashes, etc. are better written using RealJenkinsRule.

Since:

1.567

Author:

Kohsuke Kawaguchi

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	RestartableJenkinsRule.Builder	Deprecated.
static interface	RestartableJenkinsRule.Step	Deprecated. One step to run, intended to be a SAM for lambdas with then(org.jvnet.hudson.test.RestartableJenkinsRule.Step).

Field Summary

Fields

Modifier and Type	Field	Description
File	home	Deprecated. JENKINS_HOME
JenkinsRule	j	Deprecated.

Constructor Summary

Constructors

Constructor	Description
RestartableJenkinsRule()	Deprecated.

Method Summary

Modifier and Type	Method	Description
void	addStep(org.junit.runners.model.Statement step)	Deprecated. Use then(org.jvnet.hudson.test.RestartableJenkinsRule.Step) instead.
void	addStep(org.junit.runners.model.Statement step, boolean expectedToStartCorrectly)	Deprecated. Use then(org.jvnet.hudson.test.RestartableJenkinsRule.Step) or thenDoesNotStart() instead.
void	addStepWithDirtyShutdown(org.junit.runners.model.Statement step)	Deprecated. Use thenWithHardShutdown(org.jvnet.hudson.test.RestartableJenkinsRule.Step) instead.
org.junit.runners.model.Statement	apply(org.junit.runners.model.Statement base, org.junit.runners.model.FrameworkMethod method, Object target)	Deprecated.
protected JenkinsRule	createJenkinsRule(org.junit.runner.Description description)	Deprecated.
void	step(groovy.lang.Closure<?> c)	Deprecated. Use then(org.jvnet.hudson.test.RestartableJenkinsRule.Step) instead.
void	then(RestartableJenkinsRule.Step s)	Deprecated. Run one Jenkins session and shut down.
void	thenDoesNotStart()	Deprecated.
void	thenWithHardShutdown(RestartableJenkinsRule.Step s)	Deprecated. Run one Jenkins session and then simulate the Jenkins process ending without a clean shutdown.

Methods inherited from class java.lang.Object

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

Field Details

j

public JenkinsRule j

Deprecated.

home

public File home

Deprecated.

JENKINS_HOME

Constructor Details

RestartableJenkinsRule

public RestartableJenkinsRule()

Deprecated.

Method Details

apply

public org.junit.runners.model.Statement apply(org.junit.runners.model.Statement base,
 org.junit.runners.model.FrameworkMethod method,
 Object target)

Deprecated.

Specified by:

apply in interface org.junit.rules.MethodRule

step

@Deprecated
public void step(groovy.lang.Closure<?> c)

Deprecated.

Use then(org.jvnet.hudson.test.RestartableJenkinsRule.Step) instead.

then

public void then(RestartableJenkinsRule.Step s)

Deprecated.

Run one Jenkins session and shut down.

Since:

2.24

thenWithHardShutdown

public void thenWithHardShutdown(RestartableJenkinsRule.Step s)

Deprecated.

Run one Jenkins session and then simulate the Jenkins process ending without a clean shutdown. This can be used to test that data is appropriately persisted without relying on shutdown processes.

Implementation note: we're actually just copying the JENKINS_HOME, which takes some time - so the shutdown isn't truly instant (additional data may be written while this happens).

thenDoesNotStart

public void thenDoesNotStart()

Deprecated.

addStep

@Deprecated
public void addStep(org.junit.runners.model.Statement step)

Deprecated.

Use then(org.jvnet.hudson.test.RestartableJenkinsRule.Step) instead.

addStep

@Deprecated
public void addStep(org.junit.runners.model.Statement step,
 boolean expectedToStartCorrectly)

Deprecated.

Use then(org.jvnet.hudson.test.RestartableJenkinsRule.Step) or thenDoesNotStart() instead.

addStepWithDirtyShutdown

@Deprecated
public void addStepWithDirtyShutdown(org.junit.runners.model.Statement step)

Deprecated.

Use thenWithHardShutdown(org.jvnet.hudson.test.RestartableJenkinsRule.Step) instead.

createJenkinsRule

protected JenkinsRule createJenkinsRule(org.junit.runner.Description description)

Deprecated.