archive/jdk
1
0
Fork 0
mirror of https://github.com/openjdk/jdk.git synced 2025-08-26 22:34:27 +02:00
Code Issues Projects Releases Packages Wiki Activity Actions

8347121: Add missing @serial tags to module java.base

Browse source 
Reviewed-by: alanb
This commit is contained in:
Hannes Wallnöfer 2025-01-09 11:49:18 +00:00
parent 8c87ea2bdf
commit ceae2b977d
89 changed files with 301 additions and 222 deletions
Download patch file Download diff file Expand all files Collapse all files

6
src/java.base/share/classes/java/time/Duration.java
View file

@ -1,5 +1,5 @@
/*
* Copyright (c) 2012, 2023, Oracle and/or its affiliates. All rights reserved.
* Copyright (c) 2012, 2025, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
@ -158,11 +158,11 @@ public final class Duration
}
/**
* The number of seconds in the duration.
* @serial The number of seconds in the duration.
*/
private final long seconds;
/**
* The number of nanoseconds in the duration, expressed as a fraction of the
* @serial The number of nanoseconds in the duration, expressed as a fraction of the
* number of seconds. This is always positive, and never exceeds 999,999,999.
*/
private final int nanos;

6
src/java.base/share/classes/java/time/Instant.java
View file

@ -1,5 +1,5 @@
/*
* Copyright (c) 2012, 2024, Oracle and/or its affiliates. All rights reserved.
* Copyright (c) 2012, 2025, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
@ -252,11 +252,11 @@ public final class Instant
private static final long serialVersionUID = -665713676816604388L;
/**
* The number of seconds from the epoch of 1970-01-01T00:00:00Z.
* @serial The number of seconds from the epoch of 1970-01-01T00:00:00Z.
*/
private final long seconds;
/**
* The number of nanoseconds, later along the time-line, from the seconds field.
* @serial The number of nanoseconds, later along the time-line, from the seconds field.
* This is always positive, and never exceeds 999,999,999.
*/
private final int nanos;

8
src/java.base/share/classes/java/time/LocalDate.java
View file

@ -1,5 +1,5 @@
/*
* Copyright (c) 2012, 2024, Oracle and/or its affiliates. All rights reserved.
* Copyright (c) 2012, 2025, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
@ -174,15 +174,15 @@ public final class LocalDate
static final long DAYS_0000_TO_1970 = (DAYS_PER_CYCLE * 5L) - (30L * 365L + 7L);
/**
* The year.
* @serial The year.
*/
private final int year;
/**
* The month-of-year.
* @serial The month-of-year.
*/
private final short month;
/**
* The day-of-month.
* @serial The day-of-month.
*/
private final short day;

6
src/java.base/share/classes/java/time/LocalDateTime.java
View file

@ -1,5 +1,5 @@
/*
* Copyright (c) 2012, 2024, Oracle and/or its affiliates. All rights reserved.
* Copyright (c) 2012, 2025, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
@ -158,11 +158,11 @@ public final class LocalDateTime
private static final long serialVersionUID = 6207766400415563566L;
/**
* The date part.
* @serial The date part.
*/
private final LocalDate date;
/**
* The time part.
* @serial The time part.
*/
private final LocalTime time;

10
src/java.base/share/classes/java/time/LocalTime.java
View file

@ -1,5 +1,5 @@
/*
* Copyright (c) 2012, 2024, Oracle and/or its affiliates. All rights reserved.
* Copyright (c) 2012, 2025, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
@ -228,19 +228,19 @@ public final class LocalTime
private static final long serialVersionUID = 6414437269572265201L;
/**
* The hour.
* @serial The hour.
*/
private final byte hour;
/**
* The minute.
* @serial The minute.
*/
private final byte minute;
/**
* The second.
* @serial The second.
*/
private final byte second;
/**
* The nanosecond.
* @serial The nanosecond.
*/
private final int nano;

6
src/java.base/share/classes/java/time/MonthDay.java
View file

@ -1,5 +1,5 @@
/*
* Copyright (c) 2012, 2023, Oracle and/or its affiliates. All rights reserved.
* Copyright (c) 2012, 2025, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
@ -144,11 +144,11 @@ public final class MonthDay
.toFormatter();
/**
* The month-of-year, not null.
* @serial The month-of-year, not null.
*/
private final int month;
/**
* The day-of-month.
* @serial The day-of-month.
*/
private final int day;

6
src/java.base/share/classes/java/time/OffsetDateTime.java
View file

@ -1,5 +1,5 @@
/*
* Copyright (c) 2012, 2024, Oracle and/or its affiliates. All rights reserved.
* Copyright (c) 2012, 2025, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
@ -190,11 +190,11 @@ public final class OffsetDateTime
private static final long serialVersionUID = 2287754244819255394L;
/**
* The local date-time.
* @serial The local date-time.
*/
private final LocalDateTime dateTime;
/**
* The offset from UTC/Greenwich.
* @serial The offset from UTC/Greenwich.
*/
private final ZoneOffset offset;

6
src/java.base/share/classes/java/time/OffsetTime.java
View file

@ -1,5 +1,5 @@
/*
* Copyright (c) 2012, 2024, Oracle and/or its affiliates. All rights reserved.
* Copyright (c) 2012, 2025, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
@ -143,11 +143,11 @@ public final class OffsetTime
private static final long serialVersionUID = 7264499704384272492L;
/**
* The local date-time.
* @serial The local date-time.
*/
private final LocalTime time;
/**
* The offset from UTC/Greenwich.
* @serial The offset from UTC/Greenwich.
*/
private final ZoneOffset offset;

8
src/java.base/share/classes/java/time/Period.java
View file

@ -1,5 +1,5 @@
/*
* Copyright (c) 2012, 2020, Oracle and/or its affiliates. All rights reserved.
* Copyright (c) 2012, 2025, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
@ -155,15 +155,15 @@ public final class Period
private static final List<TemporalUnit> SUPPORTED_UNITS = List.of(YEARS, MONTHS, DAYS);
/**
* The number of years.
* @serial The number of years.
*/
private final int years;
/**
* The number of months.
* @serial The number of months.
*/
private final int months;
/**
* The number of days.
* @serial The number of days.
*/
private final int days;

4
src/java.base/share/classes/java/time/Year.java
View file

@ -1,5 +1,5 @@
/*
* Copyright (c) 2012, 2023, Oracle and/or its affiliates. All rights reserved.
* Copyright (c) 2012, 2025, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
@ -159,7 +159,7 @@ public final class Year
.toFormatter();
/**
* The year being represented.
* @serial The year being represented.
*/
private final int year;

6
src/java.base/share/classes/java/time/YearMonth.java
View file

@ -1,5 +1,5 @@
/*
* Copyright (c) 2012, 2023, Oracle and/or its affiliates. All rights reserved.
* Copyright (c) 2012, 2025, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
@ -147,11 +147,11 @@ public final class YearMonth
.toFormatter();
/**
* The year.
* @serial The year.
*/
private final int year;
/**
* The month-of-year, not null.
* @serial The month-of-year, not null.
*/
private final int month;

4
src/java.base/share/classes/java/time/ZoneOffset.java
View file

@ -1,5 +1,5 @@
/*
* Copyright (c) 2012, 2024, Oracle and/or its affiliates. All rights reserved.
* Copyright (c) 2012, 2025, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
@ -163,7 +163,7 @@ public final class ZoneOffset
public static final ZoneOffset MAX = ZoneOffset.ofTotalSeconds(MAX_SECONDS);
/**
* The total offset in seconds.
* @serial The total offset in seconds.
*/
private final int totalSeconds;
/**

8
src/java.base/share/classes/java/time/ZonedDateTime.java
View file

@ -1,5 +1,5 @@
/*
* Copyright (c) 2012, 2024, Oracle and/or its affiliates. All rights reserved.
* Copyright (c) 2012, 2025, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
@ -172,15 +172,15 @@ public final class ZonedDateTime
private static final long serialVersionUID = -6260982410461394882L;
/**
* The local date-time.
* @serial The local date-time.
*/
private final LocalDateTime dateTime;
/**
* The offset from UTC/Greenwich.
* @serial The offset from UTC/Greenwich.
*/
private final ZoneOffset offset;
/**
* The time-zone.
* @serial The time-zone.
*/
private final ZoneId zone;

6
src/java.base/share/classes/java/time/format/DateTimeParseException.java
View file

@ -1,5 +1,5 @@
/*
* Copyright (c) 2012, 2019, Oracle and/or its affiliates. All rights reserved.
* Copyright (c) 2012, 2025, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
@ -82,11 +82,11 @@ public class DateTimeParseException extends DateTimeException {
private static final long serialVersionUID = 4304633501674722597L;
/**
* The text that was being parsed.
* @serial The text that was being parsed.
*/
private final String parsedString;
/**
* The error index in the text.
* @serial The error index in the text.
*/
private final int errorIndex;

10
src/java.base/share/classes/java/time/temporal/ValueRange.java
View file

@ -1,5 +1,5 @@
/*
* Copyright (c) 2012, 2020, Oracle and/or its affiliates. All rights reserved.
* Copyright (c) 2012, 2025, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
@ -96,19 +96,19 @@ public final class ValueRange implements Serializable {
private static final long serialVersionUID = -7317881728594519368L;
/**
* The smallest minimum value.
* @serial The smallest minimum value.
*/
private final long minSmallest;
/**
* The largest minimum value.
* @serial The largest minimum value.
*/
private final long minLargest;
/**
* The smallest maximum value.
* @serial The smallest maximum value.
*/
private final long maxSmallest;
/**
* The largest maximum value.
* @serial The largest maximum value.
*/
private final long maxLargest;

6
src/java.base/share/classes/java/time/temporal/WeekFields.java
View file

@ -1,5 +1,5 @@
/*
* Copyright (c) 2012, 2023, Oracle and/or its affiliates. All rights reserved.
* Copyright (c) 2012, 2025, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
@ -247,11 +247,11 @@ public final class WeekFields implements Serializable {
private static final long serialVersionUID = -1177360819670808121L;
/**
* The first day-of-week.
* @serial The first day-of-week.
*/
private final DayOfWeek firstDayOfWeek;
/**
* The minimal number of days in the first week.
* @serial The minimal number of days in the first week.
*/
private final int minimalDays;
/**

10
src/java.base/share/classes/java/time/zone/ZoneOffsetTransition.java
View file

@ -1,5 +1,5 @@
/*
* Copyright (c) 2012, 2023, Oracle and/or its affiliates. All rights reserved.
* Copyright (c) 2012, 2025, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
@ -104,19 +104,19 @@ public final class ZoneOffsetTransition
*/
private static final long serialVersionUID = -6946044323557704546L;
/**
* The transition epoch-second.
* @serial The transition epoch-second.
*/
private final long epochSecond;
/**
* The local transition date-time at the transition.
* @serial The local transition date-time at the transition.
*/
private final LocalDateTime transition;
/**
* The offset before transition.
* @serial The offset before transition.
*/
private final ZoneOffset offsetBefore;
/**
* The offset after transition.
* @serial The offset after transition.
*/
private final ZoneOffset offsetAfter;

20
src/java.base/share/classes/java/time/zone/ZoneOffsetTransitionRule.java
View file

@ -1,5 +1,5 @@
/*
* Copyright (c) 2012, 2020, Oracle and/or its affiliates. All rights reserved.
* Copyright (c) 2012, 2025, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
@ -105,12 +105,12 @@ public final class ZoneOffsetTransitionRule implements Serializable {
private static final long serialVersionUID = 6889046316657758795L;
/**
* The month of the month-day of the first day of the cutover week.
* @serial The month of the month-day of the first day of the cutover week.
* The actual date will be adjusted by the dowChange field.
*/
private final Month month;
/**
* The day-of-month of the month-day of the cutover week.
* @serial The day-of-month of the month-day of the cutover week.
* If positive, it is the start of the week where the cutover can occur.
* If negative, it represents the end of the week where cutover can occur.
* The value is the number of days from the end of the month, such that
@ -119,31 +119,31 @@ public final class ZoneOffsetTransitionRule implements Serializable {
*/
private final byte dom;
/**
* The cutover day-of-week, null to retain the day-of-month.
* @serial The cutover day-of-week, null to retain the day-of-month.
*/
private final DayOfWeek dow;
/**
* The cutover time in the 'before' offset.
* @serial The cutover time in the 'before' offset.
*/
private final LocalTime time;
/**
* Whether the cutover time is midnight at the end of day.
* @serial Whether the cutover time is midnight at the end of day.
*/
private final boolean timeEndOfDay;
/**
* The definition of how the local time should be interpreted.
* @serial The definition of how the local time should be interpreted.
*/
private final TimeDefinition timeDefinition;
/**
* The standard offset at the cutover.
* @serial The standard offset at the cutover.
*/
private final ZoneOffset standardOffset;
/**
* The offset before the cutover.
* @serial The offset before the cutover.
*/
private final ZoneOffset offsetBefore;
/**
* The offset after the cutover.
* @serial The offset after the cutover.
*/
private final ZoneOffset offsetAfter;

14
src/java.base/share/classes/java/time/zone/ZoneRules.java
View file

@ -1,5 +1,5 @@
/*
* Copyright (c) 2012, 2023, Oracle and/or its affiliates. All rights reserved.
* Copyright (c) 2012, 2025, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
@ -118,29 +118,29 @@ public final class ZoneRules implements Serializable {
private static final int LAST_CACHED_YEAR = 2100;
/**
* The transitions between standard offsets (epoch seconds), sorted.
* @serial The transitions between standard offsets (epoch seconds), sorted.
*/
private final long[] standardTransitions;
/**
* The standard offsets.
* @serial The standard offsets.
*/
private final ZoneOffset[] standardOffsets;
/**
* The transitions between instants (epoch seconds), sorted.
* @serial The transitions between instants (epoch seconds), sorted.
*/
private final long[] savingsInstantTransitions;
/**
* The transitions between local date-times, sorted.
* @serial The transitions between local date-times, sorted.
* This is a paired array, where the first entry is the start of the transition
* and the second entry is the end of the transition.
*/
private final LocalDateTime[] savingsLocalTransitions;
/**
* The wall offsets.
* @serial The wall offsets.
*/
private final ZoneOffset[] wallOffsets;
/**
* The last rule.
* @serial The last rule.
*/
private final ZoneOffsetTransitionRule[] lastRules;
/**