hudson.plugins.testlink

Class TestLinkBuilder

java.lang.Object

hudson.tasks.BuildStepCompatibilityLayer

hudson.tasks.Builder

hudson.plugins.testlink.AbstractTestLinkBuilder

hudson.plugins.testlink.TestLinkBuilder

All Implemented Interfaces:

hudson.ExtensionPoint, hudson.model.Describable<hudson.tasks.Builder>, hudson.tasks.BuildStep

public class TestLinkBuilder
extends AbstractTestLinkBuilder

A builder to add a TestLink build step.

Since:

1.0

Author:

Bruno P. Kinoshita - http://www.kinoshita.eti.br

Nested Class Summary

Nested classes/interfaces inherited from interface hudson.ExtensionPoint

hudson.ExtensionPoint.LegacyInstancesAreScopedToHudson

Nested classes/interfaces inherited from interface hudson.tasks.BuildStep

hudson.tasks.BuildStep.PublisherList

Field Summary

Fields

Modifier and Type	Field and Description
static TestLinkBuilderDescriptor	DESCRIPTOR The Descriptor of this Builder.

Fields inherited from class hudson.plugins.testlink.AbstractTestLinkBuilder

afterIteratingAllTestCasesBuildSteps, beforeIteratingAllTestCasesBuildSteps, buildName, customFields, executionOrderComparator, failedTestsMarkBuildAsFailure, failIfNoResults, failOnNotRun, failure, iterativeBuildSteps, platformName, singleBuildSteps, testLinkName, testPlanCustomFields, testPlanName, testProjectName, transactional

Fields inherited from interface hudson.tasks.BuildStep

BUILDERS, PUBLISHERS

Constructor Summary

Constructors

Constructor and Description
TestLinkBuilder(String testLinkName, String testProjectName, String testPlanName, String buildName, String customFields, Boolean executionStatusNotRun, Boolean executionStatusPassed, Boolean executionStatusFailed, Boolean executionStatusBlocked, List<hudson.tasks.BuildStep> singleBuildSteps, List<hudson.tasks.BuildStep> beforeIteratingAllTestCasesBuildSteps, List<hudson.tasks.BuildStep> iterativeBuildSteps, List<hudson.tasks.BuildStep> afterIteratingAllTestCasesBuildSteps, Boolean transactional, Boolean failedTestsMarkBuildAsFailure, Boolean failIfNoResults, Boolean failOnNotRun, List<ResultSeeker> resultSeekers) Deprecated.
TestLinkBuilder(String testLinkName, String testProjectName, String testPlanName, String buildName, String customFields, Boolean executionStatusNotRun, Boolean executionStatusPassed, Boolean executionStatusFailed, Boolean executionStatusBlocked, List<hudson.tasks.BuildStep> singleBuildSteps, List<hudson.tasks.BuildStep> beforeIteratingAllTestCasesBuildSteps, List<hudson.tasks.BuildStep> iterativeBuildSteps, List<hudson.tasks.BuildStep> afterIteratingAllTestCasesBuildSteps, Boolean transactional, Boolean failedTestsMarkBuildAsFailure, Boolean failIfNoResults, List<ResultSeeker> resultSeekers) Deprecated.
TestLinkBuilder(String testLinkName, String testProjectName, String testPlanName, String platformName, String buildName, String customFields, Boolean executionStatusNotRun, Boolean executionStatusPassed, Boolean executionStatusFailed, Boolean executionStatusBlocked, List<hudson.tasks.BuildStep> singleBuildSteps, List<hudson.tasks.BuildStep> beforeIteratingAllTestCasesBuildSteps, List<hudson.tasks.BuildStep> iterativeBuildSteps, List<hudson.tasks.BuildStep> afterIteratingAllTestCasesBuildSteps, Boolean transactional, Boolean failedTestsMarkBuildAsFailure, Boolean failIfNoResults, Boolean failOnNotRun, List<ResultSeeker> resultSeekers) Deprecated. to add test plan custom fields
TestLinkBuilder(String testLinkName, String testProjectName, String testPlanName, String platformName, String buildName, String customFields, String testPlanCustomFields, Boolean executionStatusNotRun, Boolean executionStatusPassed, Boolean executionStatusFailed, Boolean executionStatusBlocked, List<hudson.tasks.BuildStep> singleBuildSteps, List<hudson.tasks.BuildStep> beforeIteratingAllTestCasesBuildSteps, List<hudson.tasks.BuildStep> iterativeBuildSteps, List<hudson.tasks.BuildStep> afterIteratingAllTestCasesBuildSteps, Boolean transactional, Boolean failedTestsMarkBuildAsFailure, Boolean failIfNoResults, Boolean failOnNotRun, List<ResultSeeker> resultSeekers)

Method Summary

Modifier and Type	Method and Description
protected void	executeIterativeBuildSteps(TestCaseWrapper[] automatedTestCases, br.eti.kinoshita.testlinkjavaapi.model.TestPlan testPlan, TestLinkSite testLinkSite, hudson.model.AbstractBuild<?,?> build, hudson.Launcher launcher, hudson.model.BuildListener listener) Executes iterative build steps.
protected void	executeSingleBuildSteps(int numberOfTests, br.eti.kinoshita.testlinkjavaapi.model.TestPlan testPlan, TestLinkSite testLinkSite, hudson.model.AbstractBuild<?,?> build, hudson.Launcher launcher, hudson.model.BuildListener listener) Executes the list of single build steps.
hudson.model.Descriptor<hudson.tasks.Builder>	getDescriptor()
TestLinkSite	getTestLinkSite(String testLinkUrl, String testLinkDevKey, String testProjectName, String testPlanName, String platformName, String buildName, String buildNotes) Gets object to interact with TestLink site.
boolean	perform(hudson.model.AbstractBuild<?,?> build, hudson.Launcher launcher, hudson.model.BuildListener listener) Called when the job is executed.

Methods inherited from class hudson.plugins.testlink.AbstractTestLinkBuilder

getAfterIteratingAllTestCasesBuildSteps, getBeforeIteratingAllTestCasesBuildSteps, getBuildName, getCustomFields, getExecutionStatusBlocked, getExecutionStatusFailed, getExecutionStatusNotRun, getExecutionStatusPassed, getFailedTestsMarkBuildAsUnstable, getFailIfNoResults, getFailOnNotRun, getIterativeBuildSteps, getPlatformName, getProjectAction, getResultSeekers, getSingleBuildSteps, getTestLinkName, getTestPlanCustomFields, getTestPlanName, getTestProjectName, getTransactional, setResultSeekers

Methods inherited from class hudson.tasks.Builder

all, getRequiredMonitorService, prebuild

Methods inherited from class hudson.tasks.BuildStepCompatibilityLayer

getProjectAction, getProjectActions, perform, prebuild

Methods inherited from class java.lang.Object

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

Field Detail

DESCRIPTOR

@Extension
public static final TestLinkBuilderDescriptor DESCRIPTOR

The Descriptor of this Builder. It contains the TestLink installation.

Constructor Detail

TestLinkBuilder

public TestLinkBuilder(String testLinkName,
                       String testProjectName,
                       String testPlanName,
                       String buildName,
                       String customFields,
                       Boolean executionStatusNotRun,
                       Boolean executionStatusPassed,
                       Boolean executionStatusFailed,
                       Boolean executionStatusBlocked,
                       List<hudson.tasks.BuildStep> singleBuildSteps,
                       List<hudson.tasks.BuildStep> beforeIteratingAllTestCasesBuildSteps,
                       List<hudson.tasks.BuildStep> iterativeBuildSteps,
                       List<hudson.tasks.BuildStep> afterIteratingAllTestCasesBuildSteps,
                       Boolean transactional,
                       Boolean failedTestsMarkBuildAsFailure,
                       Boolean failIfNoResults,
                       List<ResultSeeker> resultSeekers)

Deprecated.

Kept here for backward compatibility. Don't add new fields.

TestLinkBuilder

public TestLinkBuilder(String testLinkName,
                       String testProjectName,
                       String testPlanName,
                       String buildName,
                       String customFields,
                       Boolean executionStatusNotRun,
                       Boolean executionStatusPassed,
                       Boolean executionStatusFailed,
                       Boolean executionStatusBlocked,
                       List<hudson.tasks.BuildStep> singleBuildSteps,
                       List<hudson.tasks.BuildStep> beforeIteratingAllTestCasesBuildSteps,
                       List<hudson.tasks.BuildStep> iterativeBuildSteps,
                       List<hudson.tasks.BuildStep> afterIteratingAllTestCasesBuildSteps,
                       Boolean transactional,
                       Boolean failedTestsMarkBuildAsFailure,
                       Boolean failIfNoResults,
                       Boolean failOnNotRun,
                       List<ResultSeeker> resultSeekers)

Deprecated.

Kept here for backward compatibility. Don't add new fields.

TestLinkBuilder

public TestLinkBuilder(String testLinkName,
                       String testProjectName,
                       String testPlanName,
                       String platformName,
                       String buildName,
                       String customFields,
                       Boolean executionStatusNotRun,
                       Boolean executionStatusPassed,
                       Boolean executionStatusFailed,
                       Boolean executionStatusBlocked,
                       List<hudson.tasks.BuildStep> singleBuildSteps,
                       List<hudson.tasks.BuildStep> beforeIteratingAllTestCasesBuildSteps,
                       List<hudson.tasks.BuildStep> iterativeBuildSteps,
                       List<hudson.tasks.BuildStep> afterIteratingAllTestCasesBuildSteps,
                       Boolean transactional,
                       Boolean failedTestsMarkBuildAsFailure,
                       Boolean failIfNoResults,
                       Boolean failOnNotRun,
                       List<ResultSeeker> resultSeekers)

Deprecated. to add test plan custom fields

Kept here for backward compatibility. Don't add new fields.

TestLinkBuilder

@DataBoundConstructor
public TestLinkBuilder(String testLinkName,
                                             String testProjectName,
                                             String testPlanName,
                                             String platformName,
                                             String buildName,
                                             String customFields,
                                             String testPlanCustomFields,
                                             Boolean executionStatusNotRun,
                                             Boolean executionStatusPassed,
                                             Boolean executionStatusFailed,
                                             Boolean executionStatusBlocked,
                                             List<hudson.tasks.BuildStep> singleBuildSteps,
                                             List<hudson.tasks.BuildStep> beforeIteratingAllTestCasesBuildSteps,
                                             List<hudson.tasks.BuildStep> iterativeBuildSteps,
                                             List<hudson.tasks.BuildStep> afterIteratingAllTestCasesBuildSteps,
                                             Boolean transactional,
                                             Boolean failedTestsMarkBuildAsFailure,
                                             Boolean failIfNoResults,
                                             Boolean failOnNotRun,
                                             List<ResultSeeker> resultSeekers)

Method Detail

perform

public boolean perform(hudson.model.AbstractBuild<?,?> build,
                       hudson.Launcher launcher,
                       hudson.model.BuildListener listener)
                throws InterruptedException,
                       IOException

Called when the job is executed.

Specified by:

perform in interface hudson.tasks.BuildStep

Overrides:

perform in class hudson.tasks.BuildStepCompatibilityLayer

Throws:

InterruptedException

IOException

getTestLinkSite

public TestLinkSite getTestLinkSite(String testLinkUrl,
                                    String testLinkDevKey,
                                    String testProjectName,
                                    String testPlanName,
                                    String platformName,
                                    String buildName,
                                    String buildNotes)
                             throws MalformedURLException

Gets object to interact with TestLink site.

Throws:

MalformedURLException

executeSingleBuildSteps

protected void executeSingleBuildSteps(int numberOfTests,
                                       br.eti.kinoshita.testlinkjavaapi.model.TestPlan testPlan,
                                       TestLinkSite testLinkSite,
                                       hudson.model.AbstractBuild<?,?> build,
                                       hudson.Launcher launcher,
                                       hudson.model.BuildListener listener)
                                throws IOException,
                                       InterruptedException

Executes the list of single build steps.

Parameters:

numberOfTests - number of tests

testLinkSite - TestLink site

build - Jenkins build.

launcher - job launcher

listener - build listener

Throws:

IOException

InterruptedException

executeIterativeBuildSteps

protected void executeIterativeBuildSteps(TestCaseWrapper[] automatedTestCases,
                                          br.eti.kinoshita.testlinkjavaapi.model.TestPlan testPlan,
                                          TestLinkSite testLinkSite,
                                          hudson.model.AbstractBuild<?,?> build,
                                          hudson.Launcher launcher,
                                          hudson.model.BuildListener listener)
                                   throws IOException,
                                          InterruptedException

Executes iterative build steps. For each automated test case found in the array of automated test cases, this method executes the iterative builds steps using Jenkins objects.

Parameters:

automatedTestCases - array of automated test cases

testLinkSite - The TestLink Site object

launcher -

listener -

Throws:

InterruptedException

IOException

getDescriptor

public hudson.model.Descriptor<hudson.tasks.Builder> getDescriptor()

Specified by:

getDescriptor in interface hudson.model.Describable<hudson.tasks.Builder>

Overrides:

getDescriptor in class hudson.tasks.Builder