/*

 * Copyright (c) 2012, 2017, 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

 * under the terms of the GNU General Public License version 2 only, as

 * published by the Free Software Foundation.  Oracle designates this

 * particular file as subject to the "Classpath" exception as provided

 * by Oracle in the LICENSE file that accompanied this code.

 *

 * This code is distributed in the hope that it will be useful, but WITHOUT

 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or

 * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License

 * version 2 for more details (a copy is included in the LICENSE file that

 * accompanied this code).

 *

 * You should have received a copy of the GNU General Public License version

 * 2 along with this work; if not, write to the Free Software Foundation,

 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.

 *

 * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA

 * or visit www.oracle.com if you need additional information or have any

 * questions.

 */

/*

 * Copyright (c) 2012, Stephen Colebourne & Michael Nascimento Santos

 *

 * All rights reserved.

 *

 * Redistribution and use in source and binary forms, with or without

 * modification, are permitted provided that the following conditions are met:

 *

 *  * Redistributions of source code must retain the above copyright notice,

 *    this list of conditions and the following disclaimer.

 *

 *  * Redistributions in binary form must reproduce the above copyright notice,

 *    this list of conditions and the following disclaimer in the documentation

 *    and/or other materials provided with the distribution.

 *

 *  * Neither the name of JSR-310 nor the names of its contributors

 *    may be used to endorse or promote products derived from this software

 *    without specific prior written permission.

 *

 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS

 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT

 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR

 * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR

 * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,

 * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,

 * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR

 * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF

 * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING

 * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS

 * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

 */

package java.time.chrono;

import static java.time.temporal.ChronoField.EPOCH_DAY;

import java.io.FilePermission;

import java.io.InputStream;

import java.io.InvalidObjectException;

import java.io.ObjectInputStream;

import java.io.Serializable;

import java.security.AccessController;

import java.security.PrivilegedAction;

import java.time.Clock;

import java.time.DateTimeException;

import java.time.Instant;

import java.time.LocalDate;

import java.time.ZoneId;

import java.time.format.ResolverStyle;

import java.time.temporal.ChronoField;

import java.time.temporal.TemporalAccessor;

import java.time.temporal.TemporalField;

import java.time.temporal.ValueRange;

import java.util.Arrays;

import java.util.HashMap;

import java.util.List;

import java.util.Map;

import java.util.Properties;

import sun.util.logging.PlatformLogger;

/**

 * The Hijrah calendar is a lunar calendar supporting Islamic calendars.

 * <p>

 * The HijrahChronology follows the rules of the Hijrah calendar system. The Hijrah

 * calendar has several variants based on differences in when the new moon is

 * determined to have occurred and where the observation is made.

 * In some variants the length of each month is

 * computed algorithmically from the astronomical data for the moon and earth and

 * in others the length of the month is determined by an authorized sighting

 * of the new moon. For the algorithmically based calendars the calendar

 * can project into the future.

 * For sighting based calendars only historical data from past

 * sightings is available.

 * <p>

 * The length of each month is 29 or 30 days.

 * Ordinary years have 354 days; leap years have 355 days.

 *

 * <p>

 * CLDR and LDML identify variants:

 * <table cellpadding="2" summary="Variants of Hijrah Calendars">

 * <thead>

 * <tr class="tableSubHeadingColor">

 * </tr>

 * </thead>

 * <tbody>

 * <tr class="altColor">

 * <td>Hijrah-umalqura</td>

 * <td>islamic-umalqura</td>

 * <td>ca-islamic-umalqura</td>

 * <td>Islamic - Umm Al-Qura calendar of Saudi Arabia</td>

 * </tr>

 * </tbody>

 * </table>

 * <p>Additional variants may be available through {@link Chronology#getAvailableChronologies()}.

 *

 * <p>Example</p>

 * <p>

 * Selecting the chronology from the locale uses {@link Chronology#ofLocale}

 * to find the Chronology based on Locale supported BCP 47 extension mechanism

 * to request a specific calendar ("ca"). For example,

 * </p>

 * <pre>

 *      Locale locale = Locale.forLanguageTag("en-US-u-ca-islamic-umalqura");

 *      Chronology chrono = Chronology.ofLocale(locale);

 * </pre>

 *

 * @implSpec

 * This class is immutable and thread-safe.

 *

 * @implNote

 * Each Hijrah variant is configured individually. Each variant is defined by a

 * property resource that defines the {@code ID}, the {@code calendar type},

 * the start of the calendar, the alignment with the

 * ISO calendar, and the length of each month for a range of years.

 * The variants are loaded by HijrahChronology as a resource from

 * hijrah-config-<calendar type>.properties.

 * <p>

 * The Hijrah property resource is a set of properties that describe the calendar.

 * The syntax is defined by {@code java.util.Properties#load(Reader)}.

 * <table cellpadding="2" summary="Configuration of Hijrah Calendar">

 * <thead>

 * <tr class="tableSubHeadingColor">

 * </tr>

 * </thead>

 * <tbody>

 * <tr class="altColor">

 * <td>id</td>

 * <td>Chronology Id, for example, "Hijrah-umalqura"</td>

 * <td>The Id of the calendar in common usage</td>

 * </tr>

 * <tr class="rowColor">

 * <td>type</td>

 * <td>Calendar type, for example, "islamic-umalqura"</td>

 * <td>LDML defines the calendar types</td>

 * </tr>

 * <tr class="altColor">

 * <td>version</td>

 * <td>Version, for example: "1.8.0_1"</td>

 * <td>The version of the Hijrah variant data</td>

 * </tr>

 * <tr class="rowColor">

 * <td>iso-start</td>

 * <td>ISO start date, formatted as {@code yyyy-MM-dd}, for example: "1900-04-30"</td>

 * <td>The ISO date of the first day of the minimum Hijrah year.</td>

 * </tr>

 * <tr class="altColor">

 * <td>yyyy - a numeric 4 digit year, for example "1434"</td>

 * <td>The value is a sequence of 12 month lengths,

 * for example: "29 30 29 30 29 30 30 30 29 30 29 29"</td>

 * <td>The lengths of the 12 months of the year separated by whitespace.

 * A numeric year property must be present for every year without any gaps.

 * The month lengths must be between 29-32 inclusive.

 * </td>

 * </tr>

 * </tbody>

 * </table>

 *

 * @since 1.8

 */

public final class HijrahChronology extends AbstractChronology implements Serializable {

    /**

     * The Hijrah Calendar id.

     */

    private final transient String typeId;

    /**

     * The Hijrah calendarType.

     */

    private final transient String calendarType;

    /**

     * Serialization version.

     */

    private static final long serialVersionUID = 3127340209035924785L;

    /**

     * Singleton instance of the Islamic Umm Al-Qura calendar of Saudi Arabia.

     * Other Hijrah chronology variants may be available from

     * {@link Chronology#getAvailableChronologies}.

     */

    public static final HijrahChronology INSTANCE;

    /**

     * Flag to indicate the initialization of configuration data is complete.

     * @see #checkCalendarInit()

     */

    private transient volatile boolean initComplete;

    /**

     * Array of epoch days indexed by Hijrah Epoch month.

     * Computed by {@link #loadCalendarData}.

     */

    private transient int[] hijrahEpochMonthStartDays;

    /**

     * The minimum epoch day of this Hijrah calendar.

     * Computed by {@link #loadCalendarData}.

     */

    private transient int minEpochDay;

    /**

     * The maximum epoch day for which calendar data is available.

     * Computed by {@link #loadCalendarData}.

     */

    private transient int maxEpochDay;

    /**

     * The minimum epoch month.

     * Computed by {@link #loadCalendarData}.

     */

    private transient int hijrahStartEpochMonth;

    /**

     * The minimum length of a month.

     * Computed by {@link #createEpochMonths}.

     */

    private transient int minMonthLength;

    /**

     * The maximum length of a month.

     * Computed by {@link #createEpochMonths}.

     */

    private transient int maxMonthLength;

    /**

     * The minimum length of a year in days.

     * Computed by {@link #createEpochMonths}.

     */

    private transient int minYearLength;

    /**

     * The maximum length of a year in days.

     * Computed by {@link #createEpochMonths}.

     */

    private transient int maxYearLength;

    /**

     * Prefix of resource names for Hijrah calendar variants.

     */

    private static final String RESOURCE_PREFIX = "hijrah-config-";

    /**

     * Suffix of resource names for Hijrah calendar variants.

     */

    private static final String RESOURCE_SUFFIX = ".properties";

    /**

     * Static initialization of the built-in calendars.

     * The data is not loaded until it is used.

     */

    static {

        INSTANCE = new HijrahChronology("Hijrah-umalqura", "islamic-umalqura");

        // Register it by its aliases

        AbstractChronology.registerChrono(INSTANCE, "Hijrah");

        AbstractChronology.registerChrono(INSTANCE, "islamic");

    }

    /**

     * Create a HijrahChronology for the named variant and type.

     *

     * @param id the id of the calendar

     * @param calType the typeId of the calendar

     * @throws IllegalArgumentException if the id or typeId is empty

     */

    private HijrahChronology(String id, String calType) {

        if (id.isEmpty()) {

            throw new IllegalArgumentException("calendar id is empty");

        }

        if (calType.isEmpty()) {

            throw new IllegalArgumentException("calendar typeId is empty");

        }

        this.typeId = id;

        this.calendarType = calType;

    }

    /**

     * Check and ensure that the calendar data has been initialized.

     * The initialization check is performed at the boundary between

     * public and package methods.  If a public calls another public method

     * a check is not necessary in the caller.

     * The constructors of HijrahDate call {@link #getEpochDay} or

     * {@link #getHijrahDateInfo} so every call from HijrahDate to a

     * HijrahChronology via package private methods has been checked.

     *

     * @throws DateTimeException if the calendar data configuration is

     *     malformed or IOExceptions occur loading the data

     */

    private void checkCalendarInit() {

        // Keep this short so it can be inlined for performance

        if (initComplete == false) {

            loadCalendarData();

            initComplete = true;

        }

    }

    //-----------------------------------------------------------------------

    /**

     * Gets the ID of the chronology.

     * <p>

     * The ID uniquely identifies the {@code Chronology}. It can be used to

     * lookup the {@code Chronology} using {@link Chronology#of(String)}.

     *

     * @return the chronology ID, non-null

     * @see #getCalendarType()

     */

    @Override

    public String getId() {

        return typeId;

    }

    /**

     * Gets the calendar type of the Islamic calendar.

     * <p>

     * The calendar type is an identifier defined by the

     * <em>Unicode Locale Data Markup Language (LDML)</em> specification.

     * It can be used to lookup the {@code Chronology} using {@link Chronology#of(String)}.

     *

     * @return the calendar system type; non-null if the calendar has

     *    a standard type, otherwise null

     * @see #getId()

     */

    @Override

    public String getCalendarType() {

        return calendarType;

    }

    //-----------------------------------------------------------------------

    /**

     * Obtains a local date in Hijrah calendar system from the

     * era, year-of-era, month-of-year and day-of-month fields.

     *

     * @param era  the Hijrah era, not null

     * @param yearOfEra  the year-of-era

     * @param month  the month-of-year

     * @param dayOfMonth  the day-of-month

     * @return the Hijrah local date, not null

     * @throws DateTimeException if unable to create the date

     * @throws ClassCastException if the {@code era} is not a {@code HijrahEra}

     */

    @Override

    public HijrahDate date(Era era, int yearOfEra, int month, int dayOfMonth) {

        return date(prolepticYear(era, yearOfEra), month, dayOfMonth);

    }

    /**

     * Obtains a local date in Hijrah calendar system from the

     * proleptic-year, month-of-year and day-of-month fields.

     *

     * @param prolepticYear  the proleptic-year

     * @param month  the month-of-year

     * @param dayOfMonth  the day-of-month

     * @return the Hijrah local date, not null

     * @throws DateTimeException if unable to create the date

     */

    @Override

    public HijrahDate date(int prolepticYear, int month, int dayOfMonth) {

        return HijrahDate.of(this, prolepticYear, month, dayOfMonth);

    }

    /**

     * Obtains a local date in Hijrah calendar system from the

     * era, year-of-era and day-of-year fields.

     *

     * @param era  the Hijrah era, not null

     * @param yearOfEra  the year-of-era

     * @param dayOfYear  the day-of-year

     * @return the Hijrah local date, not null

     * @throws DateTimeException if unable to create the date

     * @throws ClassCastException if the {@code era} is not a {@code HijrahEra}

     */

    @Override

    public HijrahDate dateYearDay(Era era, int yearOfEra, int dayOfYear) {

        return dateYearDay(prolepticYear(era, yearOfEra), dayOfYear);

    }

    /**

     * Obtains a local date in Hijrah calendar system from the

     * proleptic-year and day-of-year fields.

     *

     * @param prolepticYear  the proleptic-year

     * @param dayOfYear  the day-of-year

     * @return the Hijrah local date, not null

     * @throws DateTimeException if the value of the year is out of range,

     *  or if the day-of-year is invalid for the year

     */

    @Override

    public HijrahDate dateYearDay(int prolepticYear, int dayOfYear) {

        HijrahDate date = HijrahDate.of(this, prolepticYear, 1, 1);

        if (dayOfYear > date.lengthOfYear()) {

            throw new DateTimeException("Invalid dayOfYear: " + dayOfYear);

        }

        return date.plusDays(dayOfYear - 1);

    }

    /**

     * Obtains a local date in the Hijrah calendar system from the epoch-day.

     *

     * @param epochDay  the epoch day

     * @return the Hijrah local date, not null

     * @throws DateTimeException if unable to create the date

     */

    @Override  // override with covariant return type

    public HijrahDate dateEpochDay(long epochDay) {

        return HijrahDate.ofEpochDay(this, epochDay);

    }

    @Override

    public HijrahDate dateNow() {

        return dateNow(Clock.systemDefaultZone());

    }

    @Override

    public HijrahDate dateNow(ZoneId zone) {

        return dateNow(Clock.system(zone));

    }

    @Override

    public HijrahDate dateNow(Clock clock) {

        return date(LocalDate.now(clock));

    }

    @Override

    public HijrahDate date(TemporalAccessor temporal) {

        if (temporal instanceof HijrahDate) {

            return (HijrahDate) temporal;

        }

        return HijrahDate.ofEpochDay(this, temporal.getLong(EPOCH_DAY));

    }

    @Override

    @SuppressWarnings("unchecked")

    public ChronoLocalDateTime<HijrahDate> localDateTime(TemporalAccessor temporal) {

        return (ChronoLocalDateTime<HijrahDate>) super.localDateTime(temporal);

    }

    @Override

    @SuppressWarnings("unchecked")

    public ChronoZonedDateTime<HijrahDate> zonedDateTime(TemporalAccessor temporal) {

        return (ChronoZonedDateTime<HijrahDate>) super.zonedDateTime(temporal);

    }

    @Override

    @SuppressWarnings("unchecked")

    public ChronoZonedDateTime<HijrahDate> zonedDateTime(Instant instant, ZoneId zone) {

        return (ChronoZonedDateTime<HijrahDate>) super.zonedDateTime(instant, zone);

    }

    //-----------------------------------------------------------------------

    @Override

    public boolean isLeapYear(long prolepticYear) {

        checkCalendarInit();

        if (prolepticYear < getMinimumYear() || prolepticYear > getMaximumYear()) {

            return false;

        }

        int len = getYearLength((int) prolepticYear);

        return (len > 354);

    }

    @Override

    public int prolepticYear(Era era, int yearOfEra) {

        if (era instanceof HijrahEra == false) {

            throw new ClassCastException("Era must be HijrahEra");

        }

        return yearOfEra;

    }

    /**

     * Creates the HijrahEra object from the numeric value.

     * The Hijrah calendar system has only one era covering the

     * proleptic years greater than zero.

     * This method returns the singleton HijrahEra for the value 1.

     *

     * @param eraValue  the era value

     * @return the calendar system era, not null

     * @throws DateTimeException if unable to create the era

     */

    @Override