/*
 * Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net)
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * 您可以在遵守 License 的前提下使用本文件。
 * 您可以从以下地址获取 License 副本：
 *
 *        http://www.apache.org/licenses/LICENSE-2.0
 *
 * 除非适用法律要求或书面同意，本软件根据 License 分发时“按现状”提供，
 * 不附带任何明示或暗示的保证或条件。请参阅 License 了解具体的权限和限制。
 */

package net.micode.notes.tool; // 指定代码所属的包名

import android.content.Context; // 导入Context类，提供应用环境信息
import android.preference.PreferenceManager; // 导入偏好设置管理类

import net.micode.notes.R; // 导入R资源类，访问应用资源
import net.micode.notes.ui.NotesPreferenceActivity; // 导入笔记偏好设置活动类

/**
 * 资源解析工具类，用于管理和获取笔记应用中的各种资源
 * 包括背景颜色、文本大小、布局样式等资源的ID映射和解析
 */
public class ResourceParser {

    // 笔记背景颜色常量定义
    public static final int YELLOW           = 0; // 黄色背景
    public static final int BLUE             = 1; // 蓝色背景
    public static final int WHITE            = 2; // 白色背景
    public static final int GREEN            = 3; // 绿色背景
    public static final int RED              = 4; // 红色背景

    // 默认背景颜色（黄色）
    public static final int BG_DEFAULT_COLOR = YELLOW;

    // 文本大小常量定义
    public static final int TEXT_SMALL       = 0; // 小号文本
    public static final int TEXT_MEDIUM      = 1; // 中号文本（默认）
    public static final int TEXT_LARGE       = 2; // 大号文本
    public static final int TEXT_SUPER       = 3; // 超大号文本

    // 默认文本大小（中号）
    public static final int BG_DEFAULT_FONT_SIZE = TEXT_MEDIUM;

    /**
     * 笔记编辑界面背景资源内部类
     * 管理笔记编辑界面的背景和标题栏背景资源ID
     */
    public static class NoteBgResources {
        // 笔记编辑界面背景资源数组
        private final static int [] BG_EDIT_RESOURCES = new int [] {
                R.drawable.edit_yellow,    // 黄色背景
                R.drawable.edit_blue,      // 蓝色背景
                R.drawable.edit_white,     // 白色背景
                R.drawable.edit_green,     // 绿色背景
                R.drawable.edit_red        // 红色背景
        };

        // 笔记编辑界面标题栏背景资源数组
        private final static int [] BG_EDIT_TITLE_RESOURCES = new int [] {
                R.drawable.edit_title_yellow,  // 黄色标题栏
                R.drawable.edit_title_blue,    // 蓝色标题栏
                R.drawable.edit_title_white,   // 白色标题栏
                R.drawable.edit_title_green,   // 绿色标题栏
                R.drawable.edit_title_red      // 红色标题栏
        };

        /**
         * 根据颜色ID获取笔记编辑界面背景资源ID
         * @param id 颜色ID（0-4）
         * @return 对应的背景资源ID
         */
        public static int getNoteBgResource(int id) {
            return BG_EDIT_RESOURCES[id]; // 返回对应颜色的背景资源ID
        }

        /**
         * 根据颜色ID获取笔记编辑界面标题栏背景资源ID
         * @param id 颜色ID（0-4）
         * @return 对应的标题栏背景资源ID
         */
        public static int getNoteTitleBgResource(int id) {
            return BG_EDIT_TITLE_RESOURCES[id]; // 返回对应颜色的标题栏背景资源ID
        }
    }

    /**
     * 获取默认笔记背景ID
     * 根据用户偏好设置决定是返回随机背景还是默认背景
     * @param context 应用上下文
     * @return 背景ID
     */
    public static int getDefaultBgId(Context context) {
        if (PreferenceManager.getDefaultSharedPreferences(context).getBoolean(
                NotesPreferenceActivity.PREFERENCE_SET_BG_COLOR_KEY, false)) {
            // 如果用户开启了随机背景选项，则返回随机背景ID
            return (int) (Math.random() * NoteBgResources.BG_EDIT_RESOURCES.length);
        } else {
            // 否则返回默认背景ID（黄色）
            return BG_DEFAULT_COLOR;
        }
    }

    /**
     * 笔记列表项背景资源内部类
     * 管理笔记在列表中不同位置（首项、中间项、末项、单项）的背景资源ID
     */
    public static class NoteItemBgResources {
        // 列表中第一项的背景资源数组
        private final static int [] BG_FIRST_RESOURCES = new int [] {
                R.drawable.list_yellow_up,   // 黄色首项背景
                R.drawable.list_blue_up,     // 蓝色首项背景
                R.drawable.list_white_up,    // 白色首项背景
                R.drawable.list_green_up,    // 绿色首项背景
                R.drawable.list_red_up       // 红色首项背景
        };

        // 列表中中间项的背景资源数组
        private final static int [] BG_NORMAL_RESOURCES = new int [] {
                R.drawable.list_yellow_middle,  // 黄色中间项背景
                R.drawable.list_blue_middle,    // 蓝色中间项背景
                R.drawable.list_white_middle,   // 白色中间项背景
                R.drawable.list_green_middle,   // 绿色中间项背景
                R.drawable.list_red_middle      // 红色中间项背景
        };

        // 列表中最后一项的背景资源数组
        private final static int [] BG_LAST_RESOURCES = new int [] {
                R.drawable.list_yellow_down,   // 黄色末项背景
                R.drawable.list_blue_down,     // 蓝色末项背景
                R.drawable.list_white_down,    // 白色末项背景
                R.drawable.list_green_down,    // 绿色末项背景
                R.drawable.list_red_down,      // 红色末项背景
        };

        // 列表中单独一项（唯一项）的背景资源数组
        private final static int [] BG_SINGLE_RESOURCES = new int [] {
                R.drawable.list_yellow_single,  // 黄色单项背景
                R.drawable.list_blue_single,    // 蓝色单项背景
                R.drawable.list_white_single,   // 白色单项背景
                R.drawable.list_green_single,   // 绿色单项背景
                R.drawable.list_red_single      // 红色单项背景
        };

        /**
         * 根据颜色ID获取列表首项背景资源ID
         * @param id 颜色ID（0-4）
         * @return 对应的首项背景资源ID
         */
        public static int getNoteBgFirstRes(int id) {
            return BG_FIRST_RESOURCES[id]; // 返回对应颜色的首项背景资源ID
        }

        /**
         * 根据颜色ID获取列表末项背景资源ID
         * @param id 颜色ID（0-4）
         * @return 对应的末项背景资源ID
         */
        public static int getNoteBgLastRes(int id) {
            return BG_LAST_RESOURCES[id]; // 返回对应颜色的末项背景资源ID
        }

        /**
         * 根据颜色ID获取列表单项背景资源ID
         * @param id 颜色ID（0-4）
         * @return 对应的单项背景资源ID
         */
        public static int getNoteBgSingleRes(int id) {
            return BG_SINGLE_RESOURCES[id]; // 返回对应颜色的单项背景资源ID
        }

        /**
         * 根据颜色ID获取列表中间项背景资源ID
         * @param id 颜色ID（0-4）
         * @return 对应的中间项背景资源ID
         */
        public static int getNoteBgNormalRes(int id) {
            return BG_NORMAL_RESOURCES[id]; // 返回对应颜色的中间项背景资源ID
        }

        /**
         * 获取文件夹列表项的背景资源ID
         * @return 文件夹背景资源ID
         */
        public static int getFolderBgRes() {
            return R.drawable.list_folder; // 返回文件夹背景资源ID
        }
    }

    /**
     * 桌面小部件背景资源内部类
     * 管理不同尺寸（2x和4x）桌面小部件的背景资源ID
     */
    public static class WidgetBgResources {
        // 2x尺寸桌面小部件背景资源数组
        private final static int [] BG_2X_RESOURCES = new int [] {
                R.drawable.widget_2x_yellow,  // 黄色2x小部件背景
                R.drawable.widget_2x_blue,    // 蓝色2x小部件背景
                R.drawable.widget_2x_white,   // 白色2x小部件背景
                R.drawable.widget_2x_green,   // 绿色2x小部件背景
                R.drawable.widget_2x_red,     // 红色2x小部件背景
        };

        /**
         * 根据颜色ID获取2x尺寸桌面小部件背景资源ID
         * @param id 颜色ID（0-4）
         * @return 对应的2x小部件背景资源ID
         */
        public static int getWidget2xBgResource(int id) {
            return BG_2X_RESOURCES[id]; // 返回对应颜色的2x小部件背景资源ID
        }

        // 4x尺寸桌面小部件背景资源数组
        private final static int [] BG_4X_RESOURCES = new int [] {
                R.drawable.widget_4x_yellow,  // 黄色4x小部件背景
                R.drawable.widget_4x_blue,    // 蓝色4x小部件背景
                R.drawable.widget_4x_white,   // 白色4x小部件背景
                R.drawable.widget_4x_green,   // 绿色4x小部件背景
                R.drawable.widget_4x_red      // 红色4x小部件背景
        };

        /**
         * 根据颜色ID获取4x尺寸桌面小部件背景资源ID
         * @param id 颜色ID（0-4）
         * @return 对应的4x小部件背景资源ID
         */
        public static int getWidget4xBgResource(int id) {
            return BG_4X_RESOURCES[id]; // 返回对应颜色的4x小部件背景资源ID
        }
    }

    /**
     * 文本样式资源内部类
     * 管理不同文本大小的样式资源ID
     */
    public static class TextAppearanceResources {
        // 文本样式资源数组
        private final static int [] TEXTAPPEARANCE_RESOURCES = new int [] {
                R.style.TextAppearanceNormal,  // 小号文本样式
                R.style.TextAppearanceMedium,  // 中号文本样式
                R.style.TextAppearanceLarge,   // 大号文本样式
                R.style.TextAppearanceSuper    // 超大号文本样式
        };

        /**
         * 根据文本大小ID获取对应的文本样式资源ID
         * @param id 文本大小ID（0-3）
         * @return 对应的文本样式资源ID
         */
        public static int getTexAppearanceResource(int id) {
            /**
             * HACKME: 修复在共享偏好中存储资源ID可能导致的问题。
             * 如果ID大于资源数组长度，返回默认文本大小（中号）
             */
            if (id >= TEXTAPPEARANCE_RESOURCES.length) {
                return BG_DEFAULT_FONT_SIZE; // ID越界时返回默认文本大小
            }
            return TEXTAPPEARANCE_RESOURCES[id]; // 返回对应文本大小的样式资源ID
        }

        /**
         * 获取文本样式资源数组的长度
         * @return 资源数组长度
         */
        public static int getResourcesSize() {
            return TEXTAPPEARANCE_RESOURCES.length; // 返回资源数组长度
        }
    }
}