Feature/get build actions

src/main/java/com/cdancy/jenkins/rest/binders/BindMapToForm.java

@@ -23,6 +23,7 @@
 
 import javax.inject.Singleton;
 
+import com.google.common.collect.Lists;
 import org.jclouds.http.HttpRequest;
 import org.jclouds.http.HttpRequest.Builder;
 import org.jclouds.rest.Binder;
@@ -42,11 +43,15 @@ public <R extends HttpRequest> R bindToRequest(final R request, final Object pro
          if (prop.getKey() != null) {
             String potentialKey = prop.getKey().trim();
             if (potentialKey.length() > 0) {
-               builder.addFormParam(potentialKey, prop.getValue().toArray(new String[prop.getValue().size()]));
+                if (prop.getValue() == null) {
+                    prop.setValue(Lists.newArrayList(""));
+                }
+
+                builder.addFormParam(potentialKey, prop.getValue().toArray(new String[prop.getValue().size()]));
             }
          }
       }
 
       return (R) builder.build();
    }
-}
+}

src/main/java/com/cdancy/jenkins/rest/domain/job/Action.java

@@ -0,0 +1,43 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements.  See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License.  You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package com.cdancy.jenkins.rest.domain.job;
+
+import com.google.auto.value.AutoValue;
+import com.google.common.collect.ImmutableList;
+import org.jclouds.json.SerializedNames;
+
+import java.util.List;
+
+@AutoValue
+public abstract class Action {
+
+    public abstract List<Cause> causes();
+
+    public abstract List<Parameter> parameters();
+
+    Action() {
+    }
+
+    @SerializedNames({"causes", "parameters"})
+    public static Action create(final List<Cause> causes, final List<Parameter> parameters) {
+        return new AutoValue_Action(
+            causes != null ? ImmutableList.copyOf(causes) : ImmutableList.<Cause>of(),
+            parameters != null ? ImmutableList.copyOf(parameters) : ImmutableList.<Parameter>of());
+    }
+}
+

src/main/java/com/cdancy/jenkins/rest/domain/job/BuildInfo.java

@@ -30,6 +30,8 @@ public abstract class BuildInfo {
 
    public abstract List<Artifact> artifacts();
 
+   public abstract List<Action> actions();
+
    public abstract boolean building();
 
    @Nullable
@@ -70,14 +72,16 @@ public abstract class BuildInfo {
    BuildInfo() {
    }
 
-   @SerializedNames({ "artifacts", "building", "description", "displayName", "duration", "estimatedDuration",
+   @SerializedNames({ "artifacts", "actions", "building", "description", "displayName", "duration", "estimatedDuration",
          "fullDisplayName", "id", "keepLog", "number", "queueId", "result", "timestamp", "url", "builtOn", "culprits" })
-   public static BuildInfo create(List<Artifact> artifacts, boolean building, String description, String displayName,
+   public static BuildInfo create(List<Artifact> artifacts, List<Action> actions, boolean building, String description, String displayName,
          long duration, long estimatedDuration, String fullDisplayName, String id, boolean keepLog, int number,
          int queueId, String result, long timestamp, String url, String builtOn, List<Culprit> culprits) {
       return new AutoValue_BuildInfo(
-            artifacts != null ? ImmutableList.copyOf(artifacts) : ImmutableList.<Artifact> of(), building, description,
-            displayName, duration, estimatedDuration, fullDisplayName, id, keepLog, number, queueId, result, timestamp,
-            url, builtOn, culprits != null ? ImmutableList.copyOf(culprits) : ImmutableList.<Culprit> of());
+            artifacts != null ? ImmutableList.copyOf(artifacts) : ImmutableList.<Artifact> of(),
+            actions != null ? ImmutableList.copyOf(actions) : ImmutableList.<Action> of(),
+            building, description, displayName, duration, estimatedDuration, fullDisplayName,
+            id, keepLog, number, queueId, result, timestamp, url, builtOn,
+            culprits != null ? ImmutableList.copyOf(culprits) : ImmutableList.<Culprit> of());
    }
 }

src/main/java/com/cdancy/jenkins/rest/domain/job/Cause.java

@@ -0,0 +1,45 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements.  See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License.  You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package com.cdancy.jenkins.rest.domain.job;
+
+import com.google.auto.value.AutoValue;
+import org.jclouds.javax.annotation.Nullable;
+import org.jclouds.json.SerializedNames;
+
+@AutoValue
+public abstract class Cause {
+
+    @Nullable
+    public abstract String clazz();
+
+    public abstract String shortDescription();
+
+    @Nullable
+    public abstract String userId();
+
+    @Nullable
+    public abstract String userName();
+
+    Cause() {
+    }
+
+    @SerializedNames({"_class", "shortDescription", "userId", "userName"})
+    public static Cause create(final String clazz, final String shortDescription, final String userId, final String userName) {
+        return new AutoValue_Cause(clazz, shortDescription, userId, userName);
+    }
+}

src/main/java/com/cdancy/jenkins/rest/domain/job/Parameter.java

@@ -0,0 +1,42 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements.  See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License.  You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package com.cdancy.jenkins.rest.domain.job;
+
+import com.google.auto.value.AutoValue;
+import org.jclouds.javax.annotation.Nullable;
+import org.jclouds.json.SerializedNames;
+
+@AutoValue
+public abstract class Parameter {
+
+    @Nullable
+    public abstract String clazz();
+
+    public abstract String name();
+
+    @Nullable
+    public abstract String value();
+
+    Parameter() {
+    }
+
+    @SerializedNames({"_class", "name", "value"})
+    public static Parameter create(final String clazz, final String name, final String value) {
+        return new AutoValue_Parameter(clazz, name, value);
+    }
+}

src/test/java/com/cdancy/jenkins/rest/features/JobsApiLiveTest.java

@@ -25,6 +25,8 @@
 import java.util.List;
 import java.util.Map;
 
+import com.cdancy.jenkins.rest.domain.job.Cause;
+import com.cdancy.jenkins.rest.domain.job.Parameter;
 import com.cdancy.jenkins.rest.domain.plugins.Plugin;
 import com.cdancy.jenkins.rest.domain.plugins.Plugins;
 import org.testng.annotations.Test;
@@ -119,6 +121,12 @@ public void testGetBuildInfo() {
     }
 
     @Test(dependsOnMethods = "testGetBuildInfo")
+    public void testGetBuildParametersOfLastJob() {
+        List<Parameter> parameters = api().buildInfo(null, "DevTest", 1).actions().get(0).parameters();
+        assertTrue(parameters.size() == 0);
+    }
+
+    @Test(dependsOnMethods = "testGetBuildParametersOfLastJob")
     public void testCreateJobThatAlreadyExists() {
         String config = payloadFromResource("/freestyle-project.xml");
         RequestStatus success = api().create(null, "DevTest", config);
@@ -307,6 +315,59 @@ public void testGetBuildInfoOfJobInFolder() {
         assertTrue(output.queueId() == queueIdForAnotherJob.value());
     }
 
+    @Test(dependsOnMethods = "testGetProgressiveText")
+    public void testGetBuildParametersofJob() {
+        List<Parameter> parameters = api().buildInfo("test-folder/test-folder-1", "JobInFolder",1).actions().get(0).parameters();
+        assertNotNull(parameters);
+        assertTrue(parameters.get(0).name().equals("SomeKey"));
+        assertTrue(parameters.get(0).value().equals("SomeVeryNewValue"));
+    }
+
+    @Test(dependsOnMethods = "testGetProgressiveText")
+    public void testGetBuildCausesOfJob() {
+        List<Cause> causes = api().buildInfo("test-folder/test-folder-1", "JobInFolder",1).actions().get(1).causes();
+        assertNotNull(causes);
+        assertTrue(causes.get(0).shortDescription().equals("Started by user admin"));
+        assertTrue(causes.get(0).userId().equals("admin"));
+        assertTrue(causes.get(0).userName().equals("admin"));
+    }
+
+    public void testCreateJobForEmptyAndNullParams() {
+        String config = payloadFromResource("/freestyle-project-empty-and-null-params.xml");
+        RequestStatus success = api().create(null, "JobForEmptyAndNullParams", config);
+        assertTrue(success.value());
+    }
+
+    @Test(dependsOnMethods = "testCreateJobForEmptyAndNullParams")
+    public void testBuildWithParametersOfJobForEmptyAndNullParams() {
+        Map<String, List<String>> params = new HashMap<>();
+        params.put("SomeKey1", Lists.newArrayList(""));
+        params.put("SomeKey2", null);
+        IntegerResponse job1 = api.jobsApi().buildWithParameters(null, "JobForEmptyAndNullParams", params);
+        assertNotNull(job1);
+        assertTrue(job1.value() > 0);
+        assertTrue(job1.errors().size() == 0);
+    }
+
+    @Test(dependsOnMethods = "testBuildWithParametersOfJobForEmptyAndNullParams")
+    public void testGetBuildParametersOfJobForEmptyAndNullParams() {
+        while (api().jobInfo(null, "JobForEmptyAndNullParams").lastBuild() == null) {
+            continue;
+        }
+        List<Parameter> parameters = api().buildInfo(null, "JobForEmptyAndNullParams", 1).actions().get(0).parameters();
+        assertNotNull(parameters);
+        assertTrue(parameters.get(0).name().equals("SomeKey1"));
+        assertTrue(parameters.get(0).value().isEmpty());
+        assertTrue(parameters.get(1).name().equals("SomeKey2"));
+        assertTrue(parameters.get(1).value().isEmpty());
+    }
+
+    @Test(dependsOnMethods = "testGetBuildParametersOfJobForEmptyAndNullParams")
+    public void testDeleteJobForEmptyAndNullParams() {
+        RequestStatus success = api().delete(null, "JobForEmptyAndNullParams");
+        assertTrue(success.value());
+    }
+
     @Test(dependsOnMethods = "testCreateFoldersInJenkins")
     public void testCreateJobWithLeadingAndTrailingForwardSlashes() {
         String config = payloadFromResource("/freestyle-project-no-params.xml");

src/test/java/com/cdancy/jenkins/rest/features/JobsApiMockTest.java

@@ -21,12 +21,16 @@
 import static org.testng.Assert.assertNull;
 import static org.testng.Assert.assertTrue;
 
+import java.util.ArrayList;
 import java.util.HashMap;
 import java.util.List;
 import java.util.Map;
 
 import javax.ws.rs.core.MediaType;
 
+import com.cdancy.jenkins.rest.domain.job.Action;
+import com.cdancy.jenkins.rest.domain.job.Cause;
+import com.cdancy.jenkins.rest.domain.job.Parameter;
 import org.testng.annotations.Test;
 
 import com.cdancy.jenkins.rest.JenkinsApi;
@@ -536,6 +540,85 @@ public void testBuildJobWithParamsNonExistentJob() throws Exception {
         }
     }
 
+    public void testGetParams() throws Exception {
+        MockWebServer server = mockWebServer();
+
+        String body = payloadFromResource("/build-info.json");
+        server.enqueue(new MockResponse().setBody(body).setResponseCode(200));
+        JenkinsApi jenkinsApi = api(server.getUrl("/"));
+        JobsApi api = jenkinsApi.jobsApi();
+        try {
+            List<Parameter> output = api.buildInfo(null,"fish", 10).actions().get(0).parameters();
+            assertNotNull(output);
+            assertTrue(output.get(0).name().equals("bear"));
+            assertTrue(output.get(0).value().equals("true"));
+            assertTrue(output.get(1).name().equals("fish"));
+            assertTrue(output.get(1).value().equals("salmon"));
+            assertSent(server, "GET", "/job/fish/10/api/json");
+        } finally {
+            jenkinsApi.close();
+            server.shutdown();
+        }
+    }
+
+    public void testGetParamsWhenNoBuildParams() throws Exception {
+        MockWebServer server = mockWebServer();
+
+        String body = payloadFromResource("/build-info-no-params.json");
+        server.enqueue(new MockResponse().setBody(body).setResponseCode(200));
+        JenkinsApi jenkinsApi = api(server.getUrl("/"));
+        JobsApi api = jenkinsApi.jobsApi();
+        try {
+            List<Parameter> output = api.buildInfo(null,"fish", 10).actions().get(0).parameters();
+            assertTrue(output.size() == 0);
+            assertSent(server, "GET", "/job/fish/10/api/json");
+        } finally {
+            jenkinsApi.close();
+            server.shutdown();
+        }
+    }
+
+    public void testGetParamsWhenEmptyorNullParams() throws Exception {
+        MockWebServer server = mockWebServer();
+
+        String body = payloadFromResource("/build-info-empty-and-null-params.json");
+        server.enqueue(new MockResponse().setBody(body).setResponseCode(200));
+        JenkinsApi jenkinsApi = api(server.getUrl("/"));
+        JobsApi api = jenkinsApi.jobsApi();
+        try {
+            List<Parameter> output = api.buildInfo(null,"fish", 10).actions().get(0).parameters();
+            assertNotNull(output);
+            assertTrue(output.get(0).name().equals("bear"));
+            assertTrue(output.get(0).value().equals("null"));
+            assertTrue(output.get(1).name().equals("fish"));
+            assertTrue(output.get(1).value().isEmpty());
+            assertSent(server, "GET", "/job/fish/10/api/json");
+        } finally {
+            jenkinsApi.close();
+            server.shutdown();
+        }
+    }
+
+    public void testGetCause() throws Exception {
+        MockWebServer server = mockWebServer();
+
+        String body = payloadFromResource("/build-info-no-params.json");
+        server.enqueue(new MockResponse().setBody(body).setResponseCode(200));
+        JenkinsApi jenkinsApi = api(server.getUrl("/"));
+        JobsApi api = jenkinsApi.jobsApi();
+        try {
+            List<Cause> output = api.buildInfo(null,"fish", 10).actions().get(0).causes();
+            assertNotNull(output);
+            assertTrue(output.get(0).shortDescription().equals("Started by user anonymous"));
+            assertNull(output.get(0).userId());
+            assertTrue(output.get(0).userName().equals("anonymous"));
+            assertSent(server, "GET", "/job/fish/10/api/json");
+        } finally {
+            jenkinsApi.close();
+            server.shutdown();
+        }
+    }
+
     public void testGetLastBuildNumber() throws Exception {
         MockWebServer server = mockWebServer();