Add stream/task logs REST endpoints to API guide

 - Add Stream/Task logs documentation tests
 - Update REST API guide with stream/task logs REST endpoints

Resolves #3322

Author: ilayaperumalg

spring-cloud-dataflow-classic-docs/src/test/java/org/springframework/cloud/dataflow/server/rest/documentation/StreamLogsDocumentation.java

@@ -0,0 +1,70 @@
+/*
+ * Copyright 2019 the original author or authors.
+ *
+ * Licensed 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
+ *
+ *      https://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 org.springframework.cloud.dataflow.server.rest.documentation;
+
+import java.util.HashMap;
+import java.util.Map;
+
+import org.junit.FixMethodOrder;
+import org.junit.Test;
+import org.junit.runners.MethodSorters;
+
+import org.springframework.cloud.skipper.domain.LogInfo;
+
+import static org.mockito.Mockito.when;
+import static org.springframework.restdocs.mockmvc.RestDocumentationRequestBuilders.get;
+import static org.springframework.test.web.servlet.result.MockMvcResultHandlers.print;
+import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.status;
+
+/**
+ * Documentation for the {@code /streams/logs} endpoint.
+ *
+ * @author Ilayaperumal Gopinathan
+ */
+@FixMethodOrder(MethodSorters.NAME_ASCENDING)
+public class StreamLogsDocumentation extends BaseDocumentation {
+
+	@Test
+	public void getLogsByStreamName() throws Exception {
+		LogInfo logInfo = new LogInfo();
+		Map<String, String> logs = new HashMap<>();
+		logs.put("ticktock-log-v1", "Logs-log");
+		logs.put("ticktock-time-v1", "Logs-time");
+		logInfo.setLogs(logs);
+		when(springDataflowServer.getSkipperClient().getLog("ticktock")).thenReturn(logInfo);
+		this.mockMvc.perform(
+			get("/streams/logs/ticktock"))
+			.andDo(print())
+			.andExpect(status().isOk())
+			.andDo(this.documentationHandler.document());
+	}
+
+	@Test
+	public void getLogsByAppName() throws Exception {
+		LogInfo logInfo = new LogInfo();
+		Map<String, String> logs = new HashMap<>();
+		logs.put("ticktock-log-v1", "Logs-log");
+		logInfo.setLogs(logs);
+		when(springDataflowServer.getSkipperClient().getLog("ticktock", "ticktock-log-v1")).thenReturn(logInfo);
+		this.mockMvc.perform(
+				get("/streams/logs/ticktock/ticktock-log-v1"))
+				.andDo(print())
+				.andExpect(status().isOk())
+				.andDo(this.documentationHandler.document());
+	}
+
+}

spring-cloud-dataflow-classic-docs/src/test/java/org/springframework/cloud/dataflow/server/rest/documentation/TaskLogsDocumentation.java

@@ -0,0 +1,68 @@
+/*
+ * Copyright 2019 the original author or authors.
+ *
+ * Licensed 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
+ *
+ *      https://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 org.springframework.cloud.dataflow.server.rest.documentation;
+
+import org.junit.FixMethodOrder;
+import org.junit.Test;
+import org.junit.runners.MethodSorters;
+
+import org.springframework.cloud.dataflow.core.ApplicationType;
+import org.springframework.cloud.dataflow.server.repository.TaskDeploymentRepository;
+
+import static org.springframework.restdocs.mockmvc.RestDocumentationRequestBuilders.get;
+import static org.springframework.restdocs.mockmvc.RestDocumentationRequestBuilders.post;
+import static org.springframework.restdocs.request.RequestDocumentation.parameterWithName;
+import static org.springframework.restdocs.request.RequestDocumentation.requestParameters;
+import static org.springframework.test.web.servlet.result.MockMvcResultHandlers.print;
+import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.status;
+
+/**
+ * Documentation for the {@code /tasks/logs} endpoint.
+ *
+ * @author Ilayaperumal Gopinathan
+ */
+@FixMethodOrder(MethodSorters.NAME_ASCENDING)
+public class TaskLogsDocumentation extends BaseDocumentation {
+
+	@Test
+	public void getLogsByTaskId() throws Exception {
+		registerApp(ApplicationType.task, "timestamp", "1.2.0.RELEASE");
+		String taskName = "taskA";
+		documentation.dontDocument( () -> this.mockMvc.perform(
+				post("/tasks/definitions")
+						.param("name", taskName)
+						.param("definition", "timestamp --format='yyyy MM dd'"))
+				.andExpect(status().isOk()));
+		this.mockMvc.perform(
+				post("/tasks/executions")
+						.param("name", taskName))
+				.andExpect(status().isCreated());
+		TaskDeploymentRepository taskDeploymentRepository =
+				springDataflowServer.getWebApplicationContext().getBean(TaskDeploymentRepository.class);
+		Thread.sleep(30000);
+		this.mockMvc.perform(
+				get("/tasks/logs/"+taskDeploymentRepository.findTopByTaskDefinitionNameOrderByCreatedOnAsc(taskName)
+						.getTaskDeploymentId()).param("platformName", "default"))
+				.andDo(print())
+				.andExpect(status().isOk())
+				.andDo(this.documentationHandler.document(
+						requestParameters(
+								parameterWithName("platformName").description("The name of the platform the task is launched."))
+				));
+	}
+
+}