com.offbytwo.jenkins

Class JenkinsServer

java.lang.Object

com.offbytwo.jenkins.JenkinsServer

public class JenkinsServer
extends Object

The main starting point for interacting with a Jenkins server.

Constructor Summary

Constructors

Constructor and Description
JenkinsServer(JenkinsHttpClient client) Create a new Jenkins server directly from an HTTP client (ADVANCED)
JenkinsServer(URI serverUri) Create a new Jenkins server reference given only the server address
JenkinsServer(URI serverUri, String username, String passwordOrToken) Create a new Jenkins server reference given the address and credentials

Method Summary

Methods

Modifier and Type	Method and Description
void	createJob(String jobName, String jobXml) Create a job on the server using the provided xml
Map<String,Computer>	getComputers() Get a list of all the computers on the server (at the summary level)
JobWithDetails	getJob(String jobName) Get a single Job from the server.
Map<String,Job>	getJobs() Get a list of all the defined jobs on the server (at the summary level)
String	getJobXml(String jobName) Get the xml description of an existing job
LabelWithDetails	getLabel(String labelName) Get the description of an existing Label
void	updateJob(String jobName, String jobXml) Update the xml description of an existing job

Methods inherited from class java.lang.Object

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

Constructor Detail

JenkinsServer

public JenkinsServer(URI serverUri)

Create a new Jenkins server reference given only the server address

Parameters:

serverUri - address of jenkins server (ex. http://localhost:8080/jenkins)

JenkinsServer

public JenkinsServer(URI serverUri,
             String username,
             String passwordOrToken)

Create a new Jenkins server reference given the address and credentials

Parameters:

serverUri - address of jenkins server (ex. http://localhost:8080/jenkins)

username - username to use when connecting

passwordOrToken - password (not recommended) or token (recommended)

JenkinsServer

public JenkinsServer(JenkinsHttpClient client)

Create a new Jenkins server directly from an HTTP client (ADVANCED)

Parameters:

client - Specialized client to use.

Method Detail

getJobs

public Map<String,Job> getJobs()
                        throws IOException

Get a list of all the defined jobs on the server (at the summary level)

Returns:

list of defined jobs (summary level, for details @see Job#details

Throws:

IOException

getJob

public JobWithDetails getJob(String jobName)
                      throws IOException

Get a single Job from the server.

Returns:

A single Job, null if not present

Throws:

IOException

createJob

public void createJob(String jobName,
             String jobXml)
               throws IOException

Create a job on the server using the provided xml

Throws:

IOException

getJobXml

public String getJobXml(String jobName)
                 throws IOException

Get the xml description of an existing job

Returns:

the new job object

Throws:

IOException

getLabel

public LabelWithDetails getLabel(String labelName)
                          throws IOException

Get the description of an existing Label

Returns:

label object

Throws:

IOException

getComputers

public Map<String,Computer> getComputers()
                                  throws IOException

Get a list of all the computers on the server (at the summary level)

Returns:

list of defined computers (summary level, for details @see Computer#details

Throws:

IOException

updateJob

public void updateJob(String jobName,
             String jobXml)
               throws IOException

Update the xml description of an existing job

Throws:

IOException