[file name]: ResourceParser.java
[file content begin]
/*
 * Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net)
 * 版权声明：2010-2011年，MiCode开源社区
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * 基于Apache License 2.0许可证授权
 * you may not use this file except in compliance with the License.
 * 除非遵守许可证，否则不得使用此文件
 * You may obtain a copy of the License at
 * 可以在以下地址获取许可证副本
 *
 *        http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * 除非适用法律要求或书面同意
 * distributed under the License is distributed on an "AS IS" BASIS,
 * 按"原样"分发软件
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * 没有任何明示或暗示的担保或条件
 * See the License for the specific language governing permissions and
 * 请参阅许可证了解具体语言权限
 * limitations under the License.
 * 和限制
 */

// 包声明：工具类包
package net.micode.notes.tool;

// 导入Android相关类
import android.content.Context;                   // 上下文类
import android.preference.PreferenceManager;      // 偏好设置管理器

// 导入应用内部资源
import net.micode.notes.R;                        // R资源文件
import net.micode.notes.ui.NotesPreferenceActivity; // 笔记偏好设置活动

// 资源解析器，用于处理笔记的背景颜色、字体大小等资源
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; // 默认字体大小为中等

    // 笔记背景资源类：处理编辑界面的背景资源
    public static class NoteBgResources {
        // 编辑背景资源数组，对应不同颜色的背景图片
        private final static int [] BG_EDIT_RESOURCES = new int [] {
            R.drawable.edit_yellow,  // 黄色编辑背景资源ID
            R.drawable.edit_blue,    // 蓝色编辑背景资源ID
            R.drawable.edit_white,   // 白色编辑背景资源ID
            R.drawable.edit_green,   // 绿色编辑背景资源ID
            R.drawable.edit_red      // 红色编辑背景资源ID
        };

        // 编辑标题背景资源数组，对应不同颜色的标题背景图片
        private final static int [] BG_EDIT_TITLE_RESOURCES = new int [] {
            R.drawable.edit_title_yellow,  // 黄色标题背景资源ID
            R.drawable.edit_title_blue,    // 蓝色标题背景资源ID
            R.drawable.edit_title_white,   // 白色标题背景资源ID
            R.drawable.edit_title_green,   // 绿色标题背景资源ID
            R.drawable.edit_title_red      // 红色标题背景资源ID
        };

        // 获取笔记背景资源ID的方法
        public static int getNoteBgResource(int id) {
            return BG_EDIT_RESOURCES[id]; // 返回指定ID的背景资源
        }

        // 获取笔记标题背景资源ID的方法
        public static int getNoteTitleBgResource(int id) {
            return BG_EDIT_TITLE_RESOURCES[id]; // 返回指定ID的标题背景资源
        }
    }

    // 获取默认背景ID的方法
    public static int getDefaultBgId(Context context) {
        // 检查偏好设置中是否启用了随机背景颜色
        if (PreferenceManager.getDefaultSharedPreferences(context).getBoolean(
                NotesPreferenceActivity.PREFERENCE_SET_BG_COLOR_KEY, false)) {
            // 如果启用了随机背景颜色，则随机选择一个背景颜色
            return (int) (Math.random() * NoteBgResources.BG_EDIT_RESOURCES.length);
        } else {
            // 否则使用默认背景颜色
            return BG_DEFAULT_COLOR;
        }
    }

    // 笔记列表项背景资源类：处理列表界面的背景资源
    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      // 红色单个背景
        };

        // 获取第一个列表项背景资源的方法
        public static int getNoteBgFirstRes(int id) {
            return BG_FIRST_RESOURCES[id]; // 返回指定ID的第一个列表项背景资源
        }

        // 获取最后一个列表项背景资源的方法
        public static int getNoteBgLastRes(int id) {
            return BG_LAST_RESOURCES[id]; // 返回指定ID的最后一个列表项背景资源
        }

        // 获取单个列表项背景资源的方法
        public static int getNoteBgSingleRes(int id) {
            return BG_SINGLE_RESOURCES[id]; // 返回指定ID的单个列表项背景资源
        }

        // 获取中间列表项背景资源的方法
        public static int getNoteBgNormalRes(int id) {
            return BG_NORMAL_RESOURCES[id]; // 返回指定ID的中间列表项背景资源
        }

        // 获取文件夹背景资源的方法
        public static int getFolderBgRes() {
            return R.drawable.list_folder; // 返回文件夹背景资源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小部件背景
        };

        // 获取2x小部件背景资源的方法
        public static int getWidget2xBgResource(int id) {
            return BG_2X_RESOURCES[id]; // 返回指定ID的2x小部件背景资源
        }

        // 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小部件背景
        };

        // 获取4x小部件背景资源的方法
        public static int getWidget4xBgResource(int id) {
            return BG_4X_RESOURCES[id]; // 返回指定ID的4x小部件背景资源
        }
    }

    // 文本外观资源类：处理文本样式资源
    public static class TextAppearanceResources {
        // 文本外观资源数组，对应不同的字体大小样式
        private final static int [] TEXTAPPEARANCE_RESOURCES = new int [] {
            R.style.TextAppearanceNormal,  // 正常文本外观
            R.style.TextAppearanceMedium,  // 中等文本外观
            R.style.TextAppearanceLarge,   // 大文本外观
            R.style.TextAppearanceSuper    // 超大文本外观
        };

        // 获取文本外观资源的方法
        public static int getTexAppearanceResource(int id) {
            /**
             * HACKME: 修复在SharedPreference中存储资源ID的bug
             * ID可能大于资源数组长度，这种情况下返回默认字体大小
             */
            if (id >= TEXTAPPEARANCE_RESOURCES.length) {
                // 如果ID超出范围，返回默认字体大小
                return BG_DEFAULT_FONT_SIZE;
            }
            return TEXTAPPEARANCE_RESOURCES[id]; // 返回指定ID的文本外观资源
        }

        // 获取资源数组大小的方法
        public static int getResourcesSize() {
            return TEXTAPPEARANCE_RESOURCES.length; // 返回文本外观资源数组的长度
        }
    }
}
[file content end]