Polish contribution

See gh-26871
This commit is contained in:
Sam Brannen 2021-05-26 14:46:32 +02:00
parent 0e73213144
commit 1e2e114e3c
1 changed files with 12 additions and 4 deletions

View File

@ -1,5 +1,5 @@
/* /*
* Copyright 2002-2019 the original author or authors. * Copyright 2002-2021 the original author or authors.
* *
* Licensed under the Apache License, Version 2.0 (the "License"); * Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License. * you may not use this file except in compliance with the License.
@ -38,9 +38,11 @@ public abstract class ApplicationEvent extends EventObject {
/** /**
* Create a new {@code ApplicationEvent}. * Create a new {@code ApplicationEvent} with its {@link #getTimestamp() timestamp}
* set to {@link System#currentTimeMillis()}.
* @param source the object on which the event initially occurred or with * @param source the object on which the event initially occurred or with
* which the event is associated (never {@code null}) * which the event is associated (never {@code null})
* @see #ApplicationEvent(Object, Clock)
*/ */
public ApplicationEvent(Object source) { public ApplicationEvent(Object source) {
super(source); super(source);
@ -48,10 +50,14 @@ public abstract class ApplicationEvent extends EventObject {
} }
/** /**
* Create a new {@code ApplicationEvent} with a fixed timestamp. * Create a new {@code ApplicationEvent} with its {@link #getTimestamp() timestamp}
* set to the value returned by {@link Clock#millis()} in the provided {@link Clock}.
* <p>This constructor is typically used in testing scenarios.
* @param source the object on which the event initially occurred or with * @param source the object on which the event initially occurred or with
* which the event is associated (never {@code null}) * which the event is associated (never {@code null})
* @param clock a clock which will provide the timestamp * @param clock a clock which will provide the timestamp
* @since 5.3.8
* @see #ApplicationEvent(Object)
*/ */
public ApplicationEvent(Object source, Clock clock) { public ApplicationEvent(Object source, Clock clock) {
super(source); super(source);
@ -60,7 +66,9 @@ public abstract class ApplicationEvent extends EventObject {
/** /**
* Return the system time in milliseconds when the event occurred. * Return the time in milliseconds when the event occurred.
* @see #ApplicationEvent(Object)
* @see #ApplicationEvent(Object, Clock)
*/ */
public final long getTimestamp() { public final long getTimestamp() {
return this.timestamp; return this.timestamp;