pax_global_header 0000666 0000000 0000000 00000000064 12457367762 0014535 g ustar 00root root 0000000 0000000 52 comment=d6de02467bd1214e32cd55f57966268624115a98
java-client-api-0.3.0/ 0000775 0000000 0000000 00000000000 12457367762 0014501 5 ustar 00root root 0000000 0000000 java-client-api-0.3.0/.gitignore 0000664 0000000 0000000 00000000066 12457367762 0016473 0 ustar 00root root 0000000 0000000 *.iml
/.idea
/target
.classpath
.project
.settings/**
java-client-api-0.3.0/LICENSE 0000664 0000000 0000000 00000002043 12457367762 0015505 0 ustar 00root root 0000000 0000000 Copyright (c) 2012 Cosmin Stejerean
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. java-client-api-0.3.0/README.md 0000664 0000000 0000000 00000002740 12457367762 0015763 0 ustar 00root root 0000000 0000000 # jenkins-client
A Java client for the Jenkins API
## Getting Started
To get started add the following dependency to your project
```xml
com.offbytwo.jenkinsjenkins-client0.2.0
```
## Usage
The `com.offbytwo.jenkins.JenkinsServer` class provides the main entry
point into the API. You can create a reference to the Jenkins server
given its location and (optionally) a username and password/token.
```java
JenkinsServer jenkins = new JenkinsServer(new URI("http://localhost:8080/jenkins"), "admin", "password")
```
At the top level you can access all of the currently defined
jobs. This returns a map of job names (in lower case) to jobs.
```java
Map jobs = jenkins.getJobs()
```
The Job class provides only summary information (name and url). You can retrieve details as follows
```java
JobWithDetails job = jobs.get("My Job").details()
```
The `JobWithDetails` class provides you with access to the list of
builds (and related information such as the first, last, successful,
etc) and upstream and downstream projects.
## Running Tests
To run only unit tests without invoking the integration tests use the following command:
```
mvn clean install -DskipITs
```
## Running Integration Tests
To run integration tests simply start
```
mvn clean install
```
## License
Copyright (C) 2013, Rising Oak LLC.
Distributed under the MIT license: http://opensource.org/licenses/MIT
java-client-api-0.3.0/pom.xml 0000664 0000000 0000000 00000024261 12457367762 0016023 0 ustar 00root root 0000000 0000000
4.0.0Jenkins Clienthttp://github.com/RisingOak/jenkins-clientA Jenkins API client for Javacom.offbytwo.jenkinsjenkins-client0.3.0jarorg.sonatype.ossoss-parent7scm:git:git@github.com:RisingOak/jenkins-client.gitscm:git:git@github.com:RisingOak/jenkins-client.githttps://github.com/RisingOak/jenkins-clientUTF-8UTF-81.61.5934.111.9.52.41.4.7-jenkins-11.6.12.617.04.2.22.3.4MIT Licensehttp://opensource.org/licenses/MITCosmin Stejereancosmin@offbytwo.comhttp://offbytwo.comcom.fasterxml.jackson.corejackson-annotations${jackson-databind.version}com.fasterxml.jackson.corejackson-core${jackson-databind.version}com.fasterxml.jackson.corejackson-databind${jackson-databind.version}dom4jdom4j${dom4j.version}org.jvnet.hudsonxstream${xstream.version}com.google.guavaguava${guava.version}commons-langcommons-lang${commons-lang.version}org.apache.httpcomponentshttpclient${httpclient.version}junitjunit${junit.version}testcommons-iocommons-io${commons-io.version}testorg.mockitomockito-all${mockito-all.version}testorg.jenkins-ci.mainjenkins-test-harness${jenkins-version}testorg.apache.maven.pluginsmaven-jar-plugin2.4truetruetrueorg.apache.maven.pluginsmaven-compiler-plugin3.0${targetJdk}${targetJdk}org.apache.maven.pluginsmaven-surefire-plugin**/*Test.java**/*IntegrationTest.javaorg.apache.maven.pluginsmaven-failsafe-plugin**/*IntegrationTest.javaintegration-testintegration-testverifyverifyorg.apache.maven.pluginsmaven-pmd-plugin2.7.1org.codehaus.mojocobertura-maven-plugin2.5.2org.codehaus.mojofindbugs-maven-plugin2.5.2releaseperformReleasetrueorg.apache.maven.pluginsmaven-source-plugin2.2.1attach-sourcesjarorg.apache.maven.pluginsmaven-javadoc-plugin2.9attach-javadocsjarorg.apache.maven.pluginsmaven-gpg-plugin1.4sign-artifactsverifysignrepo.jenkins-ci.orghttp://repo.jenkins-ci.org/public/ java-client-api-0.3.0/src/ 0000775 0000000 0000000 00000000000 12457367762 0015270 5 ustar 00root root 0000000 0000000 java-client-api-0.3.0/src/main/ 0000775 0000000 0000000 00000000000 12457367762 0016214 5 ustar 00root root 0000000 0000000 java-client-api-0.3.0/src/main/java/ 0000775 0000000 0000000 00000000000 12457367762 0017135 5 ustar 00root root 0000000 0000000 java-client-api-0.3.0/src/main/java/com/ 0000775 0000000 0000000 00000000000 12457367762 0017713 5 ustar 00root root 0000000 0000000 java-client-api-0.3.0/src/main/java/com/offbytwo/ 0000775 0000000 0000000 00000000000 12457367762 0021552 5 ustar 00root root 0000000 0000000 java-client-api-0.3.0/src/main/java/com/offbytwo/jenkins/ 0000775 0000000 0000000 00000000000 12457367762 0023213 5 ustar 00root root 0000000 0000000 java-client-api-0.3.0/src/main/java/com/offbytwo/jenkins/JenkinsServer.java 0000664 0000000 0000000 00000017056 12457367762 0026657 0 ustar 00root root 0000000 0000000 /*
* Copyright (c) 2013 Rising Oak LLC.
*
* Distributed under the MIT license: http://opensource.org/licenses/MIT
*/
package com.offbytwo.jenkins;
import com.google.common.base.Function;
import com.google.common.collect.Maps;
import com.offbytwo.jenkins.client.JenkinsHttpClient;
import com.offbytwo.jenkins.model.Computer;
import com.offbytwo.jenkins.model.Job;
import com.offbytwo.jenkins.model.JobConfiguration;
import com.offbytwo.jenkins.model.JobWithDetails;
import com.offbytwo.jenkins.model.LabelWithDetails;
import com.offbytwo.jenkins.model.MainView;
import com.offbytwo.jenkins.model.MavenJobWithDetails;
import com.offbytwo.jenkins.model.View;
import org.apache.http.client.HttpResponseException;
import org.dom4j.DocumentException;
import javax.xml.bind.JAXBException;
import java.io.IOException;
import java.net.URI;
import java.net.URLEncoder;
import java.util.List;
import java.util.Map;
/**
* The main starting point for interacting with a Jenkins server.
*/
public class JenkinsServer {
private final JenkinsHttpClient client;
/**
* Create a new Jenkins server reference given only the server address
*
* @param serverUri address of jenkins server (ex. http://localhost:8080/jenkins)
*/
public JenkinsServer(URI serverUri) {
this(new JenkinsHttpClient(serverUri));
}
/**
* Create a new Jenkins server reference given the address and credentials
*
* @param serverUri address of jenkins server (ex. http://localhost:8080/jenkins)
* @param username username to use when connecting
* @param passwordOrToken password (not recommended) or token (recommended)
*/
public JenkinsServer(URI serverUri, String username, String passwordOrToken) {
this(new JenkinsHttpClient(serverUri, username, passwordOrToken));
}
/**
* Create a new Jenkins server directly from an HTTP client (ADVANCED)
*
* @param client Specialized client to use.
*/
public JenkinsServer(JenkinsHttpClient client) {
this.client = client;
}
/**
* Get the current status of the Jenkins end-point by pinging it.
*
* @return true if Jenkins is up and running, false otherwise
*/
public boolean isRunning() {
try {
client.get("/");
return true;
} catch (IOException e) {
return false;
}
}
/**
* Get a list of all the defined jobs on the server (at the summary level)
*
* @return list of defined jobs (summary level, for details @see Job#details
* @throws IOException
*/
public Map getJobs() throws IOException {
List jobs = client.get("/", MainView.class).getJobs();
return Maps.uniqueIndex(jobs, new Function() {
@Override
public String apply(Job job) {
job.setClient(client);
return job.getName().toLowerCase();
}
});
}
/**
* Get a single view object from the server
*
* @param name name of the view in Jenkins
* @return the view object
* @throws IOException
*/
public View getView(String name) throws IOException {
return client.get("/view/" + encode(name) + "/", View.class);
}
/**
* Get a list of all the defined jobs on the server (at the specified view level)
*
* @return list of defined jobs (view level, for details @see Job#details
* @throws IOException
*/
public Map getJobs(String view) throws IOException {
List jobs = client.get("/view/" + encode(view) + "/", View.class).getJobs();
return Maps.uniqueIndex(jobs, new Function() {
@Override
public String apply(Job job) {
job.setClient(client);
return job.getName().toLowerCase();
}
});
}
/**
* Get a single Job from the server.
*
* @return A single Job, null if not present
* @throws IOException
*/
public JobWithDetails getJob(String jobName) throws IOException {
try {
JobWithDetails job = client.get("/job/" + encode(jobName), JobWithDetails.class);
job.setClient(client);
return job;
} catch (HttpResponseException e) {
if (e.getStatusCode() == 404) {
return null;
}
throw e;
}
}
public MavenJobWithDetails getMavenJob(String jobName) throws IOException {
try {
MavenJobWithDetails job = client.get("/job/" + encode(jobName), MavenJobWithDetails.class);
job.setClient(client);
return job;
} catch (HttpResponseException e) {
if (e.getStatusCode() == 404) {
return null;
}
throw e;
}
}
/**
* Create a job on the server using the provided xml
*
* @return the new job object
* @throws IOException
*/
public void createJob(String jobName, String jobXml) throws IOException {
client.post_xml("/createItem?name=" + encode(jobName), jobXml);
}
/**
* Get the xml description of an existing job
*
* @return the new job object
* @throws IOException
*/
public String getJobXml(String jobName) throws IOException {
return client.get("/job/" + encode(jobName) + "/config.xml");
}
/**
* Get the description of an existing Label
*
* @return label object
* @throws IOException
*/
public LabelWithDetails getLabel(String labelName) throws IOException {
return client.get("/label/" + encode(labelName), LabelWithDetails.class);
}
/**
* Get a list of all the computers on the server (at the summary level)
*
* @return list of defined computers (summary level, for details @see Computer#details
* @throws IOException
*/
public Map getComputers() throws IOException {
List computers = client.get("computer/", Computer.class).getComputers();
return Maps.uniqueIndex(computers, new Function() {
@Override
public String apply(Computer computer) {
computer.setClient(client);
return computer.getDisplayName().toLowerCase();
}
});
}
/**
* Update the xml description of an existing job
*
* @return the new job object
* @throws IOException
*/
public void updateJob(String jobName, String jobXml) throws IOException {
this.updateJob(jobName, jobXml, true);
}
public void updateJob(String jobName, String jobXml, boolean crumbFlag) throws IOException {
client.post_xml("/job/" + encode(jobName) + "/config.xml", jobXml, crumbFlag);
}
public void addStringParam(String jobName, String name, String description, String defaultValue) throws IOException, JAXBException, DocumentException {
String jobXml = this.getJobXml(jobName);
JobConfiguration jobConf = new JobConfiguration(jobXml);
jobXml = jobConf.addStringParam(name, description, defaultValue).asXml();
this.updateJob(jobName, jobXml);
}
/*
* Delete a job from jenkins
*
* @throws IOException
*/
public void deleteJob(String jobName) throws IOException {
client.post("/job/" + encode(jobName) + "/doDelete");
}
private String encode(String pathPart) {
// jenkins doesn't like the + for space, use %20 instead
return URLEncoder.encode(pathPart).replaceAll("\\+", "%20");
}
}
java-client-api-0.3.0/src/main/java/com/offbytwo/jenkins/client/ 0000775 0000000 0000000 00000000000 12457367762 0024471 5 ustar 00root root 0000000 0000000 java-client-api-0.3.0/src/main/java/com/offbytwo/jenkins/client/JenkinsHttpClient.java 0000664 0000000 0000000 00000023403 12457367762 0030736 0 ustar 00root root 0000000 0000000 /*
* Copyright (c) 2013 Rising Oak LLC.
*
* Distributed under the MIT license: http://opensource.org/licenses/MIT
*/
package com.offbytwo.jenkins.client;
import com.fasterxml.jackson.databind.ObjectMapper;
import com.offbytwo.jenkins.client.util.HttpResponseContentExtractor;
import com.offbytwo.jenkins.client.validator.HttpResponseValidator;
import com.offbytwo.jenkins.model.BaseModel;
import com.offbytwo.jenkins.model.Crumb;
import org.apache.http.HttpResponse;
import org.apache.http.auth.AuthScope;
import org.apache.http.auth.UsernamePasswordCredentials;
import org.apache.http.client.CredentialsProvider;
import org.apache.http.client.methods.HttpGet;
import org.apache.http.client.methods.HttpPost;
import org.apache.http.client.methods.HttpRequestBase;
import org.apache.http.entity.ContentType;
import org.apache.http.entity.StringEntity;
import org.apache.http.impl.auth.BasicScheme;
import org.apache.http.impl.client.DefaultHttpClient;
import org.apache.http.message.BasicHeader;
import org.apache.http.protocol.BasicHttpContext;
import org.apache.http.util.EntityUtils;
import java.io.IOException;
import java.io.InputStream;
import java.net.URI;
import static com.fasterxml.jackson.databind.DeserializationFeature.FAIL_ON_UNKNOWN_PROPERTIES;
import static org.apache.commons.lang.StringUtils.isNotBlank;
public class JenkinsHttpClient {
private URI uri;
private DefaultHttpClient client;
private BasicHttpContext localContext;
private HttpResponseValidator httpResponseValidator;
private HttpResponseContentExtractor contentExtractor;
private ObjectMapper mapper;
private String context;
/**
* Create an unauthenticated Jenkins HTTP client
*
* @param uri Location of the jenkins server (ex. http://localhost:8080)
* @param defaultHttpClient Configured DefaultHttpClient to be used
*/
public JenkinsHttpClient(URI uri, DefaultHttpClient defaultHttpClient) {
this.context = uri.getPath();
if (!context.endsWith("/")) {
context += "/";
}
this.uri = uri;
this.mapper = getDefaultMapper();
this.client = defaultHttpClient;
this.httpResponseValidator = new HttpResponseValidator();
this.contentExtractor = new HttpResponseContentExtractor();
}
/**
* Create an unauthenticated Jenkins HTTP client
*
* @param uri Location of the jenkins server (ex. http://localhost:8080)
*/
public JenkinsHttpClient(URI uri) {
this(uri, new DefaultHttpClient());
}
/**
* Create an authenticated Jenkins HTTP client
*
* @param uri Location of the jenkins server (ex. http://localhost:8080)
* @param username Username to use when connecting
* @param password Password or auth token to use when connecting
*/
public JenkinsHttpClient(URI uri, String username, String password) {
this(uri);
if (isNotBlank(username)) {
CredentialsProvider provider = client.getCredentialsProvider();
AuthScope scope = new AuthScope(uri.getHost(), uri.getPort(), "realm");
UsernamePasswordCredentials credentials = new UsernamePasswordCredentials(username, password);
provider.setCredentials(scope, credentials);
localContext = new BasicHttpContext();
localContext.setAttribute("preemptive-auth", new BasicScheme());
client.addRequestInterceptor(new PreemptiveAuth(), 0);
}
}
/**
* Perform a GET request and parse the response to the given class
*
* @param path path to request, can be relative or absolute
* @param cls class of the response
* @param type of the response
* @return an instance of the supplied class
* @throws IOException, HttpResponseException
*/
public T get(String path, Class cls) throws IOException {
HttpGet getMethod = new HttpGet(api(path));
HttpResponse response = client.execute(getMethod, localContext);
try {
httpResponseValidator.validateResponse(response);
return objectFromResponse(cls, response);
} finally {
EntityUtils.consume(response.getEntity());
releaseConnection(getMethod);
}
}
/**
* Perform a GET request and parse the response and return a simple string of the content
*
* @param path path to request, can be relative or absolute
* @return the entity text
* @throws IOException, HttpResponseException
*/
public String get(String path) throws IOException {
HttpGet getMethod = new HttpGet(api(path));
HttpResponse response = client.execute(getMethod, localContext);
try {
httpResponseValidator.validateResponse(response);
return contentExtractor.contentAsString(response);
} finally {
releaseConnection(getMethod);
}
}
/**
* Perform a GET request and return the response as InputStream
*
* @param path path to request, can be relative or absolute
* @return the response stream
* @throws IOException, HttpResponseException
*/
public InputStream getFile(URI path) throws IOException {
HttpGet getMethod = new HttpGet(path);
try {
HttpResponse response = client.execute(getMethod, localContext);
httpResponseValidator.validateResponse(response);
return contentExtractor.contentAsInputStream(response);
} finally {
releaseConnection(getMethod);
}
}
/**
* Perform a POST request and parse the response to the given class
*
* @param path path to request, can be relative or absolute
* @param data data to post
* @param cls class of the response
* @param type of the response
* @param type of the data
* @return an instance of the supplied class
* @throws IOException, HttpResponseException
*/
public R post(String path, D data, Class cls) throws IOException {
HttpPost request = new HttpPost(api(path));
Crumb crumb = get("/crumbIssuer", Crumb.class);
if (crumb != null) {
request.addHeader(new BasicHeader(crumb.getCrumbRequestField(), crumb.getCrumb()));
}
if (data != null) {
StringEntity stringEntity = new StringEntity(mapper.writeValueAsString(data), "application/json");
request.setEntity(stringEntity);
}
HttpResponse response = client.execute(request, localContext);
try {
httpResponseValidator.validateResponse(response);
if (cls != null) {
return objectFromResponse(cls, response);
} else {
return null;
}
} finally {
EntityUtils.consume(response.getEntity());
releaseConnection(request);
}
}
/**
* Perform a POST request of XML (instead of using json mapper) and return a string rendering of the response
* entity.
*
* @param path path to request, can be relative or absolute
* @param xml_data data data to post
* @return A string containing the xml response (if present)
* @throws IOException, HttpResponseException
*/
public String post_xml(String path, String xml_data) throws IOException {
return post_xml(path, xml_data, true);
}
public String post_xml(String path, String xml_data, boolean crumbFlag) throws IOException {
HttpPost request = new HttpPost(api(path));
if (crumbFlag == true) {
Crumb crumb = get("/crumbIssuer", Crumb.class);
if (crumb != null) {
request.addHeader(new BasicHeader(crumb.getCrumbRequestField(), crumb.getCrumb()));
}
}
if (xml_data != null) {
request.setEntity(new StringEntity(xml_data, ContentType.create("text/xml", "utf-8")));
}
HttpResponse response = client.execute(request, localContext);
httpResponseValidator.validateResponse(response);
try {
return contentExtractor.contentAsString(response);
} finally {
EntityUtils.consume(response.getEntity());
releaseConnection(request);
}
}
/**
* Perform POST request that takes no parameters and returns no response
*
* @param path path to request
* @throws IOException, HttpResponseException
*/
public void post(String path) throws IOException {
post(path, null, null);
}
private String urlJoin(String path1, String path2) {
if (!path1.endsWith("/")) {
path1 += "/";
}
if (path2.startsWith("/")) {
path2 = path2.substring(1);
}
return path1 + path2;
}
private URI api(String path) {
if (!path.toLowerCase().matches("https?://.*")) {
path = urlJoin(this.context, path);
}
if (!path.contains("?")) {
path = urlJoin(path, "api/json");
} else {
String[] components = path.split("\\?", 2);
path = urlJoin(components[0], "api/json") + "?" + components[1];
}
return uri.resolve("/").resolve(path);
}
private T objectFromResponse(Class cls, HttpResponse response) throws IOException {
InputStream content = contentExtractor.contentAsInputStream(response);
T result = mapper.readValue(content, cls);
result.setClient(this);
return result;
}
private ObjectMapper getDefaultMapper() {
ObjectMapper mapper = new ObjectMapper();
mapper.disable(FAIL_ON_UNKNOWN_PROPERTIES);
return mapper;
}
private void releaseConnection(HttpRequestBase httpRequestBase) {
httpRequestBase.releaseConnection();
}
}
java-client-api-0.3.0/src/main/java/com/offbytwo/jenkins/client/PreemptiveAuth.java 0000664 0000000 0000000 00000003343 12457367762 0030301 0 ustar 00root root 0000000 0000000 /*
* Copyright (c) 2013 Rising Oak LLC.
*
* Distributed under the MIT license: http://opensource.org/licenses/MIT
*/
package com.offbytwo.jenkins.client;
import org.apache.http.HttpException;
import org.apache.http.HttpHost;
import org.apache.http.HttpRequest;
import org.apache.http.HttpRequestInterceptor;
import org.apache.http.auth.AuthScheme;
import org.apache.http.auth.AuthScope;
import org.apache.http.auth.AuthState;
import org.apache.http.auth.Credentials;
import org.apache.http.client.CredentialsProvider;
import org.apache.http.client.protocol.ClientContext;
import org.apache.http.protocol.ExecutionContext;
import org.apache.http.protocol.HttpContext;
import java.io.IOException;
class PreemptiveAuth implements HttpRequestInterceptor {
@Override
public void process(HttpRequest request, HttpContext context) throws HttpException, IOException {
AuthState authState = (AuthState) context.getAttribute(ClientContext.TARGET_AUTH_STATE);
if (authState.getAuthScheme() == null) {
AuthScheme authScheme = (AuthScheme) context.getAttribute("preemptive-auth");
CredentialsProvider credsProvider = (CredentialsProvider) context.getAttribute(ClientContext.CREDS_PROVIDER);
HttpHost targetHost = (HttpHost) context.getAttribute(ExecutionContext.HTTP_TARGET_HOST);
if (authScheme != null) {
Credentials creds = credsProvider.getCredentials(
new AuthScope(targetHost.getHostName(), targetHost.getPort()));
if (creds == null) {
throw new HttpException("No credentials for preemptive authentication");
}
authState.update(authScheme, creds);
}
}
}
}
java-client-api-0.3.0/src/main/java/com/offbytwo/jenkins/client/util/ 0000775 0000000 0000000 00000000000 12457367762 0025446 5 ustar 00root root 0000000 0000000 HttpResponseContentExtractor.java 0000664 0000000 0000000 00000001333 12457367762 0034117 0 ustar 00root root 0000000 0000000 java-client-api-0.3.0/src/main/java/com/offbytwo/jenkins/client/util package com.offbytwo.jenkins.client.util;
import java.io.IOException;
import java.io.InputStream;
import java.util.Scanner;
import org.apache.http.HttpResponse;
public class HttpResponseContentExtractor {
public String contentAsString(HttpResponse response) throws IOException {
Scanner scanner = new Scanner(contentAsInputStream(response));
scanner.useDelimiter("\\z");
StringBuffer sb = new StringBuffer();
while (scanner.hasNext()) {
sb.append(scanner.next());
}
return sb.toString();
}
public InputStream contentAsInputStream(HttpResponse response) throws IOException {
return response.getEntity().getContent();
}
}
java-client-api-0.3.0/src/main/java/com/offbytwo/jenkins/client/validator/ 0000775 0000000 0000000 00000000000 12457367762 0026456 5 ustar 00root root 0000000 0000000 java-client-api-0.3.0/src/main/java/com/offbytwo/jenkins/client/validator/HttpResponseValidator.java0000664 0000000 0000000 00000000765 12457367762 0033635 0 ustar 00root root 0000000 0000000 package com.offbytwo.jenkins.client.validator;
import org.apache.http.HttpResponse;
import org.apache.http.client.HttpResponseException;
public class HttpResponseValidator {
public void validateResponse(HttpResponse response) throws HttpResponseException {
int status = response.getStatusLine().getStatusCode();
if (status < 200 || status >= 400) {
throw new HttpResponseException(status, response.getStatusLine().getReasonPhrase());
}
}
}
java-client-api-0.3.0/src/main/java/com/offbytwo/jenkins/model/ 0000775 0000000 0000000 00000000000 12457367762 0024313 5 ustar 00root root 0000000 0000000 java-client-api-0.3.0/src/main/java/com/offbytwo/jenkins/model/Artifact.java 0000664 0000000 0000000 00000001412 12457367762 0026711 0 ustar 00root root 0000000 0000000 /*
* Copyright (c) 2013 Rising Oak LLC.
*
* Distributed under the MIT license: http://opensource.org/licenses/MIT
*/
package com.offbytwo.jenkins.model;
public class Artifact extends BaseModel {
String displayPath;
String fileName;
String relativePath;
public String getDisplayPath() {
return displayPath;
}
public void setDisplayPath(String displayPath) {
this.displayPath = displayPath;
}
public String getFileName() {
return fileName;
}
public void setFileName(String fileName) {
this.fileName = fileName;
}
public String getRelativePath() {
return relativePath;
}
public void setRelativePath(String relativePath) {
this.relativePath = relativePath;
}
}
java-client-api-0.3.0/src/main/java/com/offbytwo/jenkins/model/BaseModel.java 0000664 0000000 0000000 00000000664 12457367762 0027017 0 ustar 00root root 0000000 0000000 /*
* Copyright (c) 2013 Rising Oak LLC.
*
* Distributed under the MIT license: http://opensource.org/licenses/MIT
*/
package com.offbytwo.jenkins.model;
import com.offbytwo.jenkins.client.JenkinsHttpClient;
public class BaseModel {
JenkinsHttpClient client;
public JenkinsHttpClient getClient() {
return client;
}
public void setClient(JenkinsHttpClient client) {
this.client = client;
}
}
java-client-api-0.3.0/src/main/java/com/offbytwo/jenkins/model/Build.java 0000664 0000000 0000000 00000001307 12457367762 0026216 0 ustar 00root root 0000000 0000000 /*
* Copyright (c) 2013 Rising Oak LLC.
*
* Distributed under the MIT license: http://opensource.org/licenses/MIT
*/
package com.offbytwo.jenkins.model;
import java.io.IOException;
public class Build extends BaseModel {
int number;
String url;
public Build() {}
public Build(Build from) {
this(from.getNumber(), from.getUrl());
}
public Build(int number, String url) {
this.number = number;
this.url = url;
}
public int getNumber() {
return number;
}
public String getUrl() {
return url;
}
public BuildWithDetails details() throws IOException {
return client.get(url, BuildWithDetails.class);
}
}
java-client-api-0.3.0/src/main/java/com/offbytwo/jenkins/model/BuildResult.java 0000664 0000000 0000000 00000000451 12457367762 0027414 0 ustar 00root root 0000000 0000000 /*
* Copyright (c) 2013 Rising Oak LLC.
*
* Distributed under the MIT license: http://opensource.org/licenses/MIT
*/
package com.offbytwo.jenkins.model;
public enum BuildResult {
FAILURE,
UNSTABLE,
REBUILDING,
BUILDING,
ABORTED,
SUCCESS,
UNKNOWN,
NOT_BUILT
}
java-client-api-0.3.0/src/main/java/com/offbytwo/jenkins/model/BuildWithDetails.java 0000664 0000000 0000000 00000005757 12457367762 0030375 0 ustar 00root root 0000000 0000000 /*
* Copyright (c) 2013 Rising Oak LLC.
*
* Distributed under the MIT license: http://opensource.org/licenses/MIT
*/
package com.offbytwo.jenkins.model;
import com.google.common.base.Predicate;
import java.io.IOException;
import java.io.InputStream;
import java.net.URI;
import java.net.URISyntaxException;
import java.util.Collection;
import java.util.HashMap;
import java.util.List;
import java.util.Map;
import static com.google.common.collect.Collections2.filter;
public class BuildWithDetails extends Build {
List actions;
boolean building;
String description;
int duration;
int estimatedDuration;
String fullDisplayName;
String id;
long timestamp;
BuildResult result;
List artifacts;
String consoleOutputText;
String consoleOutputHtml;
public List getArtifacts() {
return artifacts;
}
public boolean isBuilding() {
return building;
}
public String getDescription() {
return description;
}
public int getDuration() {
return duration;
}
public int getEstimatedDuration() {
return estimatedDuration;
}
public String getFullDisplayName() {
return fullDisplayName;
}
public String getId() {
return id;
}
public long getTimestamp() {
return timestamp;
}
public BuildResult getResult() {
return result;
}
public List getActions() {
return actions;
}
public Map getParameters() {
Collection parameters = filter(actions, new Predicate>() {
@Override
public boolean apply(Map action) {
return action.containsKey("parameters");
}
});
Map params = new HashMap();
if (parameters != null && !parameters.isEmpty()) {
for (Map param : ((Map>>) parameters.toArray()[0]).get("parameters")) {
String key = param.get("name");
String value = param.get("value");
params.put(key, value);
}
}
return params;
}
public String getConsoleOutputText() throws IOException {
return client.get(url + "/logText/progressiveText");
}
public String getConsoleOutputHtml() throws IOException {
return client.get(url + "/logText/progressiveHtml");
}
public InputStream downloadArtifact(Artifact a) throws IOException, URISyntaxException {
//We can't just put the artifact's relative path at the end of the url string,
//as there could be characters that need to be escaped.
URI uri = new URI(getUrl());
String artifactPath = uri.getPath() + "artifact/" + a.getRelativePath();
URI artifactUri = new URI(uri.getScheme(), uri.getUserInfo(), uri.getHost(), uri.getPort(), artifactPath, "", "");
return client.getFile(artifactUri);
}
}
java-client-api-0.3.0/src/main/java/com/offbytwo/jenkins/model/Computer.java 0000664 0000000 0000000 00000002534 12457367762 0026760 0 ustar 00root root 0000000 0000000 /*
* Copyright (c) 2013 Rising Oak LLC.
*
* Distributed under the MIT license: http://opensource.org/licenses/MIT
*/
package com.offbytwo.jenkins.model;
import com.google.common.base.Function;
import com.google.common.collect.Collections2;
import java.io.IOException;
import java.util.List;
import java.util.Map;
import static java.net.URLEncoder.encode;
import static org.apache.commons.lang.StringUtils.join;
public class Computer extends BaseModel {
private String displayName;
public List getComputers() {
return computer;
}
public void setComputer(List computer) {
this.computer = computer;
}
List computer;
public Computer() {}
public Computer(String displayName) {
this();
this.displayName = displayName;
}
public String getDisplayName() {
return this.displayName;
}
public ComputerWithDetails details() throws IOException {
return client.get("/computer/" + displayName.replaceAll("master", "(master)"), ComputerWithDetails.class);
}
private static class MapEntryToQueryStringPair implements Function, String> {
@Override
public String apply(Map.Entry entry) {
return encode(entry.getKey()) + "=" + encode(entry.getValue());
}
}
}
java-client-api-0.3.0/src/main/java/com/offbytwo/jenkins/model/ComputerWithDetails.java 0000664 0000000 0000000 00000003775 12457367762 0031132 0 ustar 00root root 0000000 0000000 /*
* Copyright (c) 2013 Rising Oak LLC.
*
* Distributed under the MIT license: http://opensource.org/licenses/MIT
*/
package com.offbytwo.jenkins.model;
import com.google.common.base.Function;
import com.google.common.collect.Lists;
import java.util.List;
import java.util.Map;
public class ComputerWithDetails extends Job {
String displayName;
List actions;
List executors;
Boolean idle;
Boolean jnlp;
Boolean launchSupported;
Map loadStatistics;
Boolean manualLaunchAllowed;
Map monitorData;
Integer numExecutors;
Boolean offline;
Object offlineCause;
String offlineReason;
List oneOffExecutors;
Boolean temporarilyOffline;
public String getDisplayName() {
return displayName;
}
public List