-
Notifications
You must be signed in to change notification settings - Fork 2.7k
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Browse files
Browse the repository at this point in the history
- Loading branch information
Showing
6 changed files
with
375 additions
and
21 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
150 changes: 150 additions & 0 deletions
150
api/maven-api-core/src/test/java/org/apache/maven/api/MonotonicClockTest.java
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,150 @@ | ||
/* | ||
* 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 org.apache.maven.api; | ||
|
||
import java.time.Clock; | ||
import java.time.Duration; | ||
import java.time.Instant; | ||
import java.time.ZoneId; | ||
import java.time.ZoneOffset; | ||
|
||
import org.junit.jupiter.api.DisplayName; | ||
import org.junit.jupiter.api.Nested; | ||
import org.junit.jupiter.api.Test; | ||
|
||
import static org.junit.jupiter.api.Assertions.assertEquals; | ||
import static org.junit.jupiter.api.Assertions.assertNotNull; | ||
import static org.junit.jupiter.api.Assertions.assertSame; | ||
import static org.junit.jupiter.api.Assertions.assertTrue; | ||
|
||
class MonotonicClockTest { | ||
|
||
@Test | ||
@DisplayName("MonotonicClock singleton instance should always return the same instance") | ||
void testSingletonInstance() { | ||
MonotonicClock clock1 = MonotonicClock.get(); | ||
MonotonicClock clock2 = MonotonicClock.get(); | ||
|
||
assertSame(clock1, clock2, "Multiple calls to get() should return the same instance"); | ||
} | ||
|
||
@Test | ||
@DisplayName("MonotonicClock should always use UTC timezone") | ||
void testClockTimezone() { | ||
MonotonicClock clock = MonotonicClock.get(); | ||
|
||
assertEquals(ZoneOffset.UTC, clock.getZone(), "Clock should use UTC timezone"); | ||
|
||
// Verify that attempting to change timezone returns the same instance | ||
Clock newClock = clock.withZone(ZoneId.systemDefault()); | ||
assertSame(clock, newClock, "withZone() should return the same clock instance"); | ||
} | ||
|
||
@Test | ||
@DisplayName("MonotonicClock should maintain monotonic time progression") | ||
void testMonotonicBehavior() throws InterruptedException { | ||
Instant first = MonotonicClock.now(); | ||
Thread.sleep(10); // Small delay | ||
Instant second = MonotonicClock.now(); | ||
Thread.sleep(10); // Small delay | ||
Instant third = MonotonicClock.now(); | ||
|
||
assertTrue(first.isBefore(second), "Time should progress forward between measurements"); | ||
assertTrue(second.isBefore(third), "Time should progress forward between measurements"); | ||
} | ||
|
||
@Test | ||
@DisplayName("MonotonicClock elapsed time should increase") | ||
void testElapsedTime() throws InterruptedException { | ||
Duration initial = MonotonicClock.elapsed(); | ||
Thread.sleep(50); // Longer delay for more reliable measurement | ||
Duration later = MonotonicClock.elapsed(); | ||
|
||
assertTrue(later.compareTo(initial) > 0, "Elapsed time should increase"); | ||
assertTrue( | ||
later.minus(initial).toMillis() >= 45, | ||
"Elapsed time difference should be at least 45ms (accounting for some timing variance)"); | ||
} | ||
|
||
@Test | ||
@DisplayName("MonotonicClock start time should remain constant") | ||
void testStartTime() throws InterruptedException { | ||
Instant start1 = MonotonicClock.start(); | ||
Thread.sleep(10); | ||
Instant start2 = MonotonicClock.start(); | ||
|
||
assertEquals(start1, start2, "Start time should remain constant"); | ||
assertNotNull(start1, "Start time should not be null"); | ||
} | ||
|
||
@Nested | ||
@DisplayName("Time consistency tests") | ||
class TimeConsistencyTests { | ||
|
||
@Test | ||
@DisplayName("Current time should be after start time") | ||
void testCurrentTimeAfterStart() { | ||
Instant now = MonotonicClock.now(); | ||
Instant start = MonotonicClock.start(); | ||
|
||
assertTrue(now.isAfter(start), "Current time should be after start time"); | ||
} | ||
|
||
@Test | ||
@DisplayName("Elapsed time should match time difference") | ||
void testElapsedTimeConsistency() { | ||
MonotonicClock clock = MonotonicClock.get(); | ||
Instant now = clock.instant(); | ||
Duration elapsed = clock.elapsedTime(); | ||
Duration calculated = Duration.between(clock.startInstant(), now); | ||
|
||
// Allow for small timing differences (1ms) due to execution time between measurements | ||
assertTrue( | ||
Math.abs(elapsed.toMillis() - calculated.toMillis()) <= 1, | ||
"Elapsed time should match calculated duration between start and now"); | ||
} | ||
} | ||
|
||
@Test | ||
@DisplayName("MonotonicClock should handle rapid successive calls") | ||
void testRapidCalls() { | ||
Instant[] instants = new Instant[1000]; | ||
for (int i = 0; i < instants.length; i++) { | ||
instants[i] = MonotonicClock.now(); | ||
} | ||
|
||
// Verify monotonic behavior across all measurements | ||
for (int i = 1; i < instants.length; i++) { | ||
assertTrue( | ||
instants[i].compareTo(instants[i - 1]) >= 0, | ||
"Time should never go backwards even with rapid successive calls"); | ||
} | ||
} | ||
|
||
@Test | ||
@DisplayName("MonotonicClock should maintain reasonable alignment with system time") | ||
void testSystemTimeAlignment() { | ||
Instant monotonic = MonotonicClock.now(); | ||
Instant system = Instant.now(); | ||
|
||
// The difference should be relatively small (allow for 1 second max) | ||
Duration difference = Duration.between(monotonic, system).abs(); | ||
assertTrue(difference.getSeconds() <= 1, "Monotonic time should be reasonably aligned with system time"); | ||
} | ||
} |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Oops, something went wrong.