src/java.base/share/classes/java/time/zone/Ser.java
author chegar
Thu, 17 Oct 2019 20:54:25 +0100
branchdatagramsocketimpl-branch
changeset 58679 9c3209ff7550
parent 58678 9cf78a70fa4f
parent 58362 628c12967b02
permissions -rw-r--r--
datagramsocketimpl-branch: merge with default
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
15289
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
     1
/*
57544
99d2dd7b84a8 8212970: TZ database in "vanguard" format support
naoto
parents: 52078
diff changeset
     2
 * Copyright (c) 2012, 2019, Oracle and/or its affiliates. All rights reserved.
15289
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
     3
 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
     4
 *
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
     5
 * This code is free software; you can redistribute it and/or modify it
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
     6
 * under the terms of the GNU General Public License version 2 only, as
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
     7
 * published by the Free Software Foundation.  Oracle designates this
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
     8
 * particular file as subject to the "Classpath" exception as provided
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
     9
 * by Oracle in the LICENSE file that accompanied this code.
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
    10
 *
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
    11
 * This code is distributed in the hope that it will be useful, but WITHOUT
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
    12
 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
    13
 * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
    14
 * version 2 for more details (a copy is included in the LICENSE file that
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
    15
 * accompanied this code).
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
    16
 *
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
    17
 * You should have received a copy of the GNU General Public License version
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
    18
 * 2 along with this work; if not, write to the Free Software Foundation,
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
    19
 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
    20
 *
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
    21
 * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
    22
 * or visit www.oracle.com if you need additional information or have any
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
    23
 * questions.
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
    24
 */
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
    25
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
    26
/*
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
    27
 * This file is available under and governed by the GNU General Public
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
    28
 * License version 2 only, as published by the Free Software Foundation.
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
    29
 * However, the following notice accompanied the original version of this
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
    30
 * file:
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
    31
 *
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
    32
 * Copyright (c) 2011-2012, Stephen Colebourne & Michael Nascimento Santos
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
    33
 *
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
    34
 * All rights reserved.
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
    35
 *
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
    36
 * Redistribution and use in source and binary forms, with or without
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
    37
 * modification, are permitted provided that the following conditions are met:
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
    38
 *
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
    39
 *  * Redistributions of source code must retain the above copyright notice,
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
    40
 *    this list of conditions and the following disclaimer.
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
    41
 *
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
    42
 *  * Redistributions in binary form must reproduce the above copyright notice,
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
    43
 *    this list of conditions and the following disclaimer in the documentation
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
    44
 *    and/or other materials provided with the distribution.
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
    45
 *
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
    46
 *  * Neither the name of JSR-310 nor the names of its contributors
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
    47
 *    may be used to endorse or promote products derived from this software
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
    48
 *    without specific prior written permission.
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
    49
 *
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
    50
 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
    51
 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
    52
 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
    53
 * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
    54
 * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
    55
 * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
    56
 * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
    57
 * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
    58
 * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
    59
 * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
    60
 * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
    61
 */
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
    62
package java.time.zone;
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
    63
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
    64
import java.io.DataInput;
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
    65
import java.io.DataOutput;
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
    66
import java.io.Externalizable;
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
    67
import java.io.IOException;
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
    68
import java.io.InvalidClassException;
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
    69
import java.io.ObjectInput;
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
    70
import java.io.ObjectOutput;
58362
628c12967b02 8231314: java.time serialization warning cleanup
rriggs
parents: 57544
diff changeset
    71
import java.io.Serializable;
15289
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
    72
import java.io.StreamCorruptedException;
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
    73
import java.time.ZoneOffset;
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
    74
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
    75
/**
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
    76
 * The shared serialization delegate for this package.
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
    77
 *
17474
8c100beabcc0 8013730: JSR 310 DateTime API Updates III
sherman
parents: 15289
diff changeset
    78
 * @implNote
15289
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
    79
 * This class is mutable and should be created once per serialization.
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
    80
 *
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
    81
 * @serial include
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
    82
 * @since 1.8
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
    83
 */
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
    84
final class Ser implements Externalizable {
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
    85
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
    86
    /**
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
    87
     * Serialization version.
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
    88
     */
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
    89
    private static final long serialVersionUID = -8885321777449118786L;
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
    90
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
    91
    /** Type for ZoneRules. */
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
    92
    static final byte ZRULES = 1;
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
    93
    /** Type for ZoneOffsetTransition. */
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
    94
    static final byte ZOT = 2;
57544
99d2dd7b84a8 8212970: TZ database in "vanguard" format support
naoto
parents: 52078
diff changeset
    95
    /** Type for ZoneOffsetTransitionRule. */
15289
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
    96
    static final byte ZOTRULE = 3;
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
    97
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
    98
    /** The type being serialized. */
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
    99
    private byte type;
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
   100
    /** The object being serialized. */
58362
628c12967b02 8231314: java.time serialization warning cleanup
rriggs
parents: 57544
diff changeset
   101
    private Serializable object;
15289
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
   102
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
   103
    /**
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
   104
     * Constructor for deserialization.
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
   105
     */
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
   106
    public Ser() {
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
   107
    }
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
   108
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
   109
    /**
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
   110
     * Creates an instance for serialization.
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
   111
     *
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
   112
     * @param type  the type
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
   113
     * @param object  the object
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
   114
     */
58362
628c12967b02 8231314: java.time serialization warning cleanup
rriggs
parents: 57544
diff changeset
   115
    Ser(byte type, Serializable object) {
15289
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
   116
        this.type = type;
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
   117
        this.object = object;
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
   118
    }
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
   119
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
   120
    //-----------------------------------------------------------------------
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
   121
    /**
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
   122
     * Implements the {@code Externalizable} interface to write the object.
19841
15c8e97d6a14 8024164: JSR310 serialization should be described in details
rriggs
parents: 17474
diff changeset
   123
     * @serialData
15c8e97d6a14 8024164: JSR310 serialization should be described in details
rriggs
parents: 17474
diff changeset
   124
     * Each serializable class is mapped to a type that is the first byte
15c8e97d6a14 8024164: JSR310 serialization should be described in details
rriggs
parents: 17474
diff changeset
   125
     * in the stream.  Refer to each class {@code writeReplace}
15c8e97d6a14 8024164: JSR310 serialization should be described in details
rriggs
parents: 17474
diff changeset
   126
     * serialized form for the value of the type and sequence of values for the type.
15c8e97d6a14 8024164: JSR310 serialization should be described in details
rriggs
parents: 17474
diff changeset
   127
     *
15c8e97d6a14 8024164: JSR310 serialization should be described in details
rriggs
parents: 17474
diff changeset
   128
     * <ul>
52078
4a63197816ce 8211952: Broken links in java.time API
jjg
parents: 47216
diff changeset
   129
     * <li><a href="{@docRoot}/serialized-form.html#java.time.zone.ZoneRules">ZoneRules.writeReplace</a>
4a63197816ce 8211952: Broken links in java.time API
jjg
parents: 47216
diff changeset
   130
     * <li><a href="{@docRoot}/serialized-form.html#java.time.zone.ZoneOffsetTransition">ZoneOffsetTransition.writeReplace</a>
4a63197816ce 8211952: Broken links in java.time API
jjg
parents: 47216
diff changeset
   131
     * <li><a href="{@docRoot}/serialized-form.html#java.time.zone.ZoneOffsetTransitionRule">ZoneOffsetTransitionRule.writeReplace</a>
19841
15c8e97d6a14 8024164: JSR310 serialization should be described in details
rriggs
parents: 17474
diff changeset
   132
     * </ul>
15289
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
   133
     *
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
   134
     * @param out  the data stream to write to, not null
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
   135
     */
19841
15c8e97d6a14 8024164: JSR310 serialization should be described in details
rriggs
parents: 17474
diff changeset
   136
    @Override
15289
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
   137
    public void writeExternal(ObjectOutput out) throws IOException {
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
   138
        writeInternal(type, object, out);
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
   139
    }
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
   140
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
   141
    static void write(Object object, DataOutput out) throws IOException {
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
   142
        writeInternal(ZRULES, object, out);
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
   143
    }
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
   144
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
   145
    private static void writeInternal(byte type, Object object, DataOutput out) throws IOException {
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
   146
        out.writeByte(type);
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
   147
        switch (type) {
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
   148
            case ZRULES:
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
   149
                ((ZoneRules) object).writeExternal(out);
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
   150
                break;
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
   151
            case ZOT:
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
   152
                ((ZoneOffsetTransition) object).writeExternal(out);
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
   153
                break;
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
   154
            case ZOTRULE:
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
   155
                ((ZoneOffsetTransitionRule) object).writeExternal(out);
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
   156
                break;
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
   157
            default:
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
   158
                throw new InvalidClassException("Unknown serialized type");
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
   159
        }
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
   160
    }
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
   161
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
   162
    //-----------------------------------------------------------------------
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
   163
    /**
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
   164
     * Implements the {@code Externalizable} interface to read the object.
19841
15c8e97d6a14 8024164: JSR310 serialization should be described in details
rriggs
parents: 17474
diff changeset
   165
     * @serialData
15c8e97d6a14 8024164: JSR310 serialization should be described in details
rriggs
parents: 17474
diff changeset
   166
     * The streamed type and parameters defined by the type's {@code writeReplace}
15c8e97d6a14 8024164: JSR310 serialization should be described in details
rriggs
parents: 17474
diff changeset
   167
     * method are read and passed to the corresponding static factory for the type
15c8e97d6a14 8024164: JSR310 serialization should be described in details
rriggs
parents: 17474
diff changeset
   168
     * to create a new instance.  That instance is returned as the de-serialized
15c8e97d6a14 8024164: JSR310 serialization should be described in details
rriggs
parents: 17474
diff changeset
   169
     * {@code Ser} object.
15289
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
   170
     *
19841
15c8e97d6a14 8024164: JSR310 serialization should be described in details
rriggs
parents: 17474
diff changeset
   171
     * <ul>
52078
4a63197816ce 8211952: Broken links in java.time API
jjg
parents: 47216
diff changeset
   172
     * <li><a href="{@docRoot}/serialized-form.html#java.time.zone.ZoneRules">ZoneRules</a>
19841
15c8e97d6a14 8024164: JSR310 serialization should be described in details
rriggs
parents: 17474
diff changeset
   173
     * - {@code ZoneRules.of(standardTransitions, standardOffsets, savingsInstantTransitions, wallOffsets, lastRules);}
52078
4a63197816ce 8211952: Broken links in java.time API
jjg
parents: 47216
diff changeset
   174
     * <li><a href="{@docRoot}/serialized-form.html#java.time.zone.ZoneOffsetTransition">ZoneOffsetTransition</a>
21331
8ee181e7e48b 8024686: Cleanup of java.time serialization source
rriggs
parents: 19841
diff changeset
   175
     * - {@code ZoneOffsetTransition of(LocalDateTime.ofEpochSecond(epochSecond), offsetBefore, offsetAfter);}
52078
4a63197816ce 8211952: Broken links in java.time API
jjg
parents: 47216
diff changeset
   176
     * <li><a href="{@docRoot}/serialized-form.html#java.time.zone.ZoneOffsetTransitionRule">ZoneOffsetTransitionRule</a>
21331
8ee181e7e48b 8024686: Cleanup of java.time serialization source
rriggs
parents: 19841
diff changeset
   177
     * - {@code ZoneOffsetTransitionRule.of(month, dom, dow, time, timeEndOfDay, timeDefinition, standardOffset, offsetBefore, offsetAfter);}
19841
15c8e97d6a14 8024164: JSR310 serialization should be described in details
rriggs
parents: 17474
diff changeset
   178
     * </ul>
15289
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
   179
     * @param in  the data to read, not null
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
   180
     */
19841
15c8e97d6a14 8024164: JSR310 serialization should be described in details
rriggs
parents: 17474
diff changeset
   181
    @Override
15289
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
   182
    public void readExternal(ObjectInput in) throws IOException, ClassNotFoundException {
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
   183
        type = in.readByte();
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
   184
        object = readInternal(type, in);
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
   185
    }
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
   186
58362
628c12967b02 8231314: java.time serialization warning cleanup
rriggs
parents: 57544
diff changeset
   187
    static Serializable read(DataInput in) throws IOException, ClassNotFoundException {
15289
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
   188
        byte type = in.readByte();
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
   189
        return readInternal(type, in);
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
   190
    }
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
   191
58362
628c12967b02 8231314: java.time serialization warning cleanup
rriggs
parents: 57544
diff changeset
   192
    private static Serializable readInternal(byte type, DataInput in)
628c12967b02 8231314: java.time serialization warning cleanup
rriggs
parents: 57544
diff changeset
   193
            throws IOException, ClassNotFoundException {
15289
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
   194
        switch (type) {
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
   195
            case ZRULES:
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
   196
                return ZoneRules.readExternal(in);
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
   197
            case ZOT:
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
   198
                return ZoneOffsetTransition.readExternal(in);
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
   199
            case ZOTRULE:
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
   200
                return ZoneOffsetTransitionRule.readExternal(in);
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
   201
            default:
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
   202
                throw new StreamCorruptedException("Unknown serialized type");
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
   203
        }
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
   204
    }
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
   205
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
   206
    /**
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
   207
     * Returns the object that will replace this one.
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
   208
     *
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
   209
     * @return the read object, should never be null
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
   210
     */
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
   211
    private Object readResolve() {
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
   212
         return object;
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
   213
    }
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
   214
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
   215
    //-----------------------------------------------------------------------
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
   216
    /**
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
   217
     * Writes the state to the stream.
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
   218
     *
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
   219
     * @param offset  the offset, not null
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
   220
     * @param out  the output stream, not null
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
   221
     * @throws IOException if an error occurs
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
   222
     */
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
   223
    static void writeOffset(ZoneOffset offset, DataOutput out) throws IOException {
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
   224
        final int offsetSecs = offset.getTotalSeconds();
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
   225
        int offsetByte = offsetSecs % 900 == 0 ? offsetSecs / 900 : 127;  // compress to -72 to +72
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
   226
        out.writeByte(offsetByte);
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
   227
        if (offsetByte == 127) {
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
   228
            out.writeInt(offsetSecs);
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
   229
        }
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
   230
    }
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
   231
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
   232
    /**
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
   233
     * Reads the state from the stream.
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
   234
     *
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
   235
     * @param in  the input stream, not null
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
   236
     * @return the created object, not null
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
   237
     * @throws IOException if an error occurs
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
   238
     */
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
   239
    static ZoneOffset readOffset(DataInput in) throws IOException {
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
   240
        int offsetByte = in.readByte();
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
   241
        return (offsetByte == 127 ? ZoneOffset.ofTotalSeconds(in.readInt()) : ZoneOffset.ofTotalSeconds(offsetByte * 900));
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
   242
    }
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
   243
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
   244
    //-----------------------------------------------------------------------
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
   245
    /**
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
   246
     * Writes the state to the stream.
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
   247
     *
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
   248
     * @param epochSec  the epoch seconds, not null
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
   249
     * @param out  the output stream, not null
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
   250
     * @throws IOException if an error occurs
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
   251
     */
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
   252
    static void writeEpochSec(long epochSec, DataOutput out) throws IOException {
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
   253
        if (epochSec >= -4575744000L && epochSec < 10413792000L && epochSec % 900 == 0) {  // quarter hours between 1825 and 2300
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
   254
            int store = (int) ((epochSec + 4575744000L) / 900);
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
   255
            out.writeByte((store >>> 16) & 255);
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
   256
            out.writeByte((store >>> 8) & 255);
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
   257
            out.writeByte(store & 255);
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
   258
        } else {
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
   259
            out.writeByte(255);
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
   260
            out.writeLong(epochSec);
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
   261
        }
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
   262
    }
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
   263
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
   264
    /**
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
   265
     * Reads the state from the stream.
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
   266
     *
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
   267
     * @param in  the input stream, not null
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
   268
     * @return the epoch seconds, not null
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
   269
     * @throws IOException if an error occurs
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
   270
     */
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
   271
    static long readEpochSec(DataInput in) throws IOException {
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
   272
        int hiByte = in.readByte() & 255;
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
   273
        if (hiByte == 255) {
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
   274
            return in.readLong();
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
   275
        } else {
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
   276
            int midByte = in.readByte() & 255;
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
   277
            int loByte = in.readByte() & 255;
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
   278
            long tot = ((hiByte << 16) + (midByte << 8) + loByte);
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
   279
            return (tot * 900) - 4575744000L;
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
   280
        }
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
   281
    }
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
   282
3ac550392e43 8003680: JSR 310 Date/Time API
sherman
parents:
diff changeset
   283
}