Do not require after in audit events endpoint

Closes gh-11605

Author: wilkinsona

spring-boot-project/spring-boot-actuator-autoconfigure/src/main/asciidoc/endpoints/auditevents.adoc

@@ -25,14 +25,11 @@ include::{snippets}auditevents/filtered/http-response.adoc[]
 === Query Parameters
 
 The endpoint uses query parameters to limit the events that it returns. The following
- table shows the supported query parameters:
+table shows the supported query parameters:
 
 [cols="2,4"]
 include::{snippets}auditevents/filtered/request-parameters.adoc[]
 
-The `after` parameter is required. You can also use one or both of the `principal` and
-`type` parameters to further limit the results.
-
 
 
 [[audit-events-retrieving-response-structure]]
@@ -42,4 +39,4 @@ The response contains details of all of the audit events that matched the query.
 following table describes the structure of the response:
 
 [cols="2,1,3"]
-include::{snippets}auditevents/after/response-fields.adoc[]
+include::{snippets}auditevents/all/response-fields.adoc[]

spring-boot-project/spring-boot-actuator-autoconfigure/src/main/java/org/springframework/boot/actuate/autoconfigure/audit/AuditEventsEndpointAutoConfiguration.java

@@ -1,5 +1,5 @@
 /*
- * Copyright 2012-2017 the original author or authors.
+ * Copyright 2012-2018 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.
@@ -18,8 +18,6 @@
 
 import org.springframework.boot.actuate.audit.AuditEventRepository;
 import org.springframework.boot.actuate.audit.AuditEventsEndpoint;
-import org.springframework.boot.actuate.audit.AuditEventsEndpointWebExtension;
-import org.springframework.boot.actuate.audit.AuditEventsJmxEndpointExtension;
 import org.springframework.boot.actuate.autoconfigure.endpoint.condition.ConditionalOnEnabledEndpoint;
 import org.springframework.boot.actuate.logging.LoggersEndpoint;
 import org.springframework.boot.autoconfigure.AutoConfigureAfter;
@@ -50,22 +48,4 @@ public AuditEventsEndpoint auditEventsEndpoint(
 		return new AuditEventsEndpoint(auditEventRepository);
 	}
 
-	@Bean
-	@ConditionalOnMissingBean
-	@ConditionalOnEnabledEndpoint
-	@ConditionalOnBean(AuditEventsEndpoint.class)
-	public AuditEventsJmxEndpointExtension auditEventsJmxEndpointExtension(
-			AuditEventsEndpoint auditEventsEndpoint) {
-		return new AuditEventsJmxEndpointExtension(auditEventsEndpoint);
-	}
-
-	@Bean
-	@ConditionalOnMissingBean
-	@ConditionalOnEnabledEndpoint
-	@ConditionalOnBean(AuditEventsEndpoint.class)
-	public AuditEventsEndpointWebExtension auditEventsWebEndpointExtension(
-			AuditEventsEndpoint auditEventsEndpoint) {
-		return new AuditEventsEndpointWebExtension(auditEventsEndpoint);
-	}
-
 }

spring-boot-project/spring-boot-actuator-autoconfigure/src/test/java/org/springframework/boot/actuate/autoconfigure/audit/AuditEventsEndpointAutoConfigurationTests.java

@@ -1,5 +1,5 @@
 /*
- * Copyright 2012-2017 the original author or authors.
+ * Copyright 2012-2018 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.
@@ -19,8 +19,6 @@
 import org.junit.Test;
 
 import org.springframework.boot.actuate.audit.AuditEventsEndpoint;
-import org.springframework.boot.actuate.audit.AuditEventsEndpointWebExtension;
-import org.springframework.boot.actuate.audit.AuditEventsJmxEndpointExtension;
 import org.springframework.boot.autoconfigure.AutoConfigurations;
 import org.springframework.boot.test.context.runner.ApplicationContextRunner;
 
@@ -46,25 +44,11 @@ public void runShouldHaveEndpointBean() {
 	}
 
 	@Test
-	public void runShouldHaveJmxExtensionBean() {
-		this.contextRunner.run((context) -> assertThat(context)
-				.hasSingleBean(AuditEventsJmxEndpointExtension.class));
-	}
-
-	@Test
-	public void runShouldHaveWebExtensionBean() {
-		this.contextRunner.run((context) -> assertThat(context)
-				.hasSingleBean(AuditEventsEndpointWebExtension.class));
-	}
-
-	@Test
-	public void runWhenEnabledPropertyIsFalseShouldNotHaveEndpointOrExtensionBean() {
+	public void runWhenEnabledPropertyIsFalseShouldNotHaveEndpoint() {
 		this.contextRunner
 				.withPropertyValues("management.endpoint.auditevents.enabled:false")
 				.run((context) -> assertThat(context)
-						.doesNotHaveBean(AuditEventsEndpoint.class)
-						.doesNotHaveBean(AuditEventsJmxEndpointExtension.class)
-						.doesNotHaveBean(AuditEventsEndpointWebExtension.class));
+						.doesNotHaveBean(AuditEventsEndpoint.class));
 	}
 
 }

spring-boot-project/spring-boot-actuator-autoconfigure/src/test/java/org/springframework/boot/actuate/autoconfigure/endpoint/web/documentation/AuditEventsEndpointDocumentationTests.java

@@ -26,7 +26,6 @@
 import org.springframework.boot.actuate.audit.AuditEvent;
 import org.springframework.boot.actuate.audit.AuditEventRepository;
 import org.springframework.boot.actuate.audit.AuditEventsEndpoint;
-import org.springframework.boot.actuate.audit.AuditEventsEndpointWebExtension;
 import org.springframework.boot.test.mock.mockito.MockBean;
 import org.springframework.context.annotation.Bean;
 import org.springframework.context.annotation.Configuration;
@@ -55,13 +54,13 @@ public class AuditEventsEndpointDocumentationTests
 	private AuditEventRepository repository;
 
 	@Test
-	public void allAuditEventsAfter() throws Exception {
+	public void allAuditEvents() throws Exception {
 		String queryTimestamp = "2017-11-07T09:37Z";
 		given(this.repository.find(any(), any(), any())).willReturn(
 				Arrays.asList(new AuditEvent("alice", "logout", Collections.emptyMap())));
 		this.mockMvc.perform(get("/actuator/auditevents").param("after", queryTimestamp))
 				.andExpect(status().isOk())
-				.andDo(document("auditevents/after", responseFields(
+				.andDo(document("auditevents/all", responseFields(
 						fieldWithPath("events").description("An array of audit events."),
 						fieldWithPath("events.[].timestamp")
 								.description("The timestamp of when the event occurred."),
@@ -85,7 +84,7 @@ public void filteredAuditEvents() throws Exception {
 						requestParameters(
 								parameterWithName("after").description(
 										"Restricts the events to those that occurred "
-												+ "after the given time. Required."),
+												+ "after the given time. Optional."),
 								parameterWithName("principal").description(
 										"Restricts the events to those with the given "
 												+ "principal. Optional."),
@@ -104,12 +103,6 @@ public AuditEventsEndpoint auditEventsEndpoint(AuditEventRepository repository)
 			return new AuditEventsEndpoint(repository);
 		}
 
-		@Bean
-		public AuditEventsEndpointWebExtension adAuditEventsWebEndpointExtension(
-				AuditEventsEndpoint delegate) {
-			return new AuditEventsEndpointWebExtension(delegate);
-		}
-
 	}
 
 }

spring-boot-project/spring-boot-actuator/src/main/java/org/springframework/boot/actuate/audit/AuditEventsEndpoint.java

@@ -21,6 +21,7 @@
 
 import org.springframework.boot.actuate.endpoint.annotation.Endpoint;
 import org.springframework.boot.actuate.endpoint.annotation.ReadOperation;
+import org.springframework.lang.Nullable;
 import org.springframework.util.Assert;
 
 /**
@@ -40,8 +41,8 @@ public AuditEventsEndpoint(AuditEventRepository auditEventRepository) {
 	}
 
 	@ReadOperation
-	public AuditEventsDescriptor events(String principal, OffsetDateTime after,
-			String type) {
+	public AuditEventsDescriptor events(@Nullable String principal,
+			@Nullable OffsetDateTime after, @Nullable String type) {
 		return new AuditEventsDescriptor(this.auditEventRepository.find(principal,
 				after == null ? null : after.toInstant(), type));
 	}

spring-boot-project/spring-boot-actuator/src/main/java/org/springframework/boot/actuate/audit/AuditEventsEndpointWebExtension.java

@@ -41,13 +41,16 @@ public class AuditEventsEndpointWebIntegrationTests {
 	private static WebTestClient client;
 
 	@Test
-	public void eventsWithoutParams() {
+	public void allEvents() {
 		client.get().uri((builder) -> builder.path("/actuator/auditevents").build())
-				.exchange().expectStatus().isBadRequest();
+				.exchange().expectStatus().isOk().expectBody()
+				.jsonPath("events.[*].principal")
+				.isEqualTo(new JSONArray().appendElement("admin").appendElement("admin")
+						.appendElement("user"));
 	}
 
 	@Test
-	public void eventsWithDateAfter() {
+	public void eventsAfter() {
 		client.get()
 				.uri((builder) -> builder.path("/actuator/auditevents")
 						.queryParam("after", "2016-11-01T13:00:00%2B00:00").build())
@@ -56,23 +59,20 @@ public void eventsWithDateAfter() {
 	}
 
 	@Test
-	public void eventsWithPrincipalAndDateAfter() {
+	public void eventsWithPrincipal() {
 		client.get()
 				.uri((builder) -> builder.path("/actuator/auditevents")
-						.queryParam("after", "2016-11-01T10:00:00%2B00:00")
 						.queryParam("principal", "user").build())
 				.exchange().expectStatus().isOk().expectBody()
 				.jsonPath("events.[*].principal")
 				.isEqualTo(new JSONArray().appendElement("user"));
 	}
 
 	@Test
-	public void eventsWithPrincipalDateAfterAndType() {
+	public void eventsWithType() {
 		client.get()
 				.uri((builder) -> builder.path("/actuator/auditevents")
-						.queryParam("after", "2016-11-01T10:00:00%2B00:00")
-						.queryParam("principal", "admin").queryParam("type", "logout")
-						.build())
+						.queryParam("type", "logout").build())
 				.exchange().expectStatus().isOk().expectBody()
 				.jsonPath("events.[*].principal")
 				.isEqualTo(new JSONArray().appendElement("admin"))
@@ -97,12 +97,6 @@ public AuditEventsEndpoint auditEventsEndpoint() {
 			return new AuditEventsEndpoint(auditEventsRepository());
 		}
 
-		@Bean
-		public AuditEventsEndpointWebExtension auditEventsEndpointWebExtension(
-				AuditEventsEndpoint auditEventsEndpoint) {
-			return new AuditEventsEndpointWebExtension(auditEventsEndpoint);
-		}
-
 		private AuditEvent createEvent(String instant, String principal, String type) {
 			return new AuditEvent(Instant.parse(instant), principal, type,
 					Collections.emptyMap());