Das Designkonzept der Datums- und Uhrzeit-API von Java ist interessant

Ich habe die Datums- und Zeit-API (JSR 310 []), die bisher aus Java SE 8 stammt, nicht verwendet (da ich mit Joda-Time [] nicht besonders unzufrieden war), habe sie aber neulich nachgeschlagen. Ich fand das Designkonzept interessant, also werde ich es schreiben.

Paketübersicht

Da es viele java.time.chrono [] gibt, die Kalender wie den japanischen Kalender enthalten, scheint die Anzahl der Klassen groß zu sein.

java.time [] Auf den ersten Blick gibt es unten viele Klassen, aber viele davon entsprechen den Wörtern, die Sie normalerweise verwenden, sodass Sie sie leicht schlucken können.

• Jahr: [Jahr] []
• Monat: [Monat] []
• Jahr: [JahrMonat] []
• Datum: MonthDay []
• Tag: DayOfWeek []
• Tageszeiten
• Keine Zeitzone: LocalTime []
• Mit Zeitzone (Offset): OffsetTime []
• Der Grund, warum es keine ZonedTime gibt, scheint darin zu liegen, dass das Datum erforderlich ist, um die Sommerzeit zu berücksichtigen [^ 2].
• Datum: LocalDate []
• Datum (und Uhrzeit
• Keine Zeitzone: LocalDateTime []
• Mit Zeitzone (Offset): OffsetDateTime []
• Mit Zeitzone (Zonen-ID): ZonedDateTime []
• Zeitraum
• Datum: [Zeitraum] []
• Zeitdauer] []
• Uhr: [Uhr] []
• Zeitpunkt: [Sofort] []
• Betrachten Sie es als Zeitstempel oder als Abstraktion der UNIX-Zeit.
• Zeitzone
• Stunden-, Minuten- und Sekundenversatz: [Zonenversatz] []
• Zonen-ID (Asien / Tokio usw.): ZoneId []

Unveränderlich

Es gibt nur eine veränderbare Klasse, java.time.format.DateTimeFormatterBuilder []. Es gibt Dinge, die nicht unveränderlich sein müssen, wie java.time.temporal.TemporalAdjuster [], aber sie sagen Ihnen freundlich (sauer Ihren Mund?), Dass Sie sie unveränderlich machen sollten.

Implementierungsanforderungen: Diese Schnittstelle beschränkt die Implementierung nicht auf Variablen, es wird jedoch dringend empfohlen, sie unveränderlich zu machen.

Namenskonvention für Methoden

Zusätzlich zu den Standardwörtern "get" und "to" werden die folgenden Wörter als Methodenpräfixe verwendet. Sie können auch "with", "plus" und "minus" in Joda-Time [] finden.

• Bekomme Instanz
• Von of: int etc.
• from: Von einem anderen Objekt
• Erstellen Sie eine andere Instanz
• at: Kombinieren, um eine weitere Instanz zu erstellen (MonthDay + Year → LocalDate usw.)
• with: Ändern Sie einige Teile, um eine andere Instanz zu erstellen (z. B. ändern Sie nur das Jahr mit LocalDate # withYear ()).
• plus, minus: Addiere und subtrahiere, um eine weitere Instanz zu erstellen

Vermeiden Sie Vererbung so weit wie möglich

Die meisten Klassen verwenden keine Vererbung (direkt von Object erben), mit Ausnahme von Ausnahmeklassen. Joda-Time Dies steht im Gegensatz zu Joda-Time.javadoc, bei dem die Vererbung stark genutzt wurde. Selbst bei Verwendung der Vererbung erbt die abstrakte Basisklasse Object direkt, und die geerbte Unterklasse ist endgültig, um eine tiefe Vererbung zu vermeiden.

Beseitigen Sie vorhandene Klassen gründlich

Java.nio.Path [], das aus Java SE 7 eingeführt wurde, kann mit den vorhandenen Dateien java.io.File [] und toFile (), toPath () ineinander konvertiert werden. Ich werde. Andererseits wird die gegenseitige Konvertierung mit der alten API nur auf der alten API-Seite implementiert.

Ich hatte das Gefühl, dass ** du (bestehende Klasse) auf den Boden von java.time ** treten darfst. Zunächst scheint es, dass keine gegenseitige Umwandlung vorbereitet wurde [^ 1], und ich fühlte sogar einen Groll gegen die alte API (ヽ ´ω`)

abschließend

Es ist auch in Effective Java geschrieben, aber ich sympathisiere damit, weil es unerwartete Fehler verursachte, indem es nicht unveränderlich gemacht wurde, und es wurde ohne Erlaubnis geerbt und geweint, weil es nicht finalisiert wurde. Es gibt viele Orte zu tun. Ich werde es in Zukunft aktiv nutzen.

[^ 1]: Datums- und Uhrzeit-API-Tipps für Japanisch (ja) --notepad