/*
 * Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net)
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * 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.gtask.data;//“包名：net.micode.notes.gtask.data；”。

import android.database.Cursor;//“导入安卓数据库游标类；”。
import android.util.Log;//导入安卓工具类 Log；”。

import net.micode.notes.tool.GTaskStringUtils;//翻译为“导入来自 net.micode.notes.tool 包下的 GTaskStringUtils 类；”。

import org.json.JSONException;//导入来自 org.json 包下的 JSON 异常类；”。
import org.json.JSONObject;//导入来自 org.json 包下的 JSON 对象类；”。．


public class MetaData extends Task {//公共类 MetaData 继承自 Task 类。”
    private final static String TAG = MetaData.class.getSimpleName();//“私有最终静态字符串变量 TAG 被赋值为 MetaData 类的简单名称。”

    private String mRelatedGid = null;//私有字符串变量 mRelatedGid 初始化为 null。”

    public void setMeta(String gid, JSONObject metaInfo) {//“公共方法 setMeta，接收一个字符串 gid 和一个 JSON 对象 metaInfo。”
        try {//“尝试执行以下代码块。”
            metaInfo.put(GTaskStringUtils.META_HEAD_GTASK_ID, gid);//“将 gid 放入 metaInfo 的键为 GTaskStringUtils.META_HEAD_GTASK_ID 的位置。
        } catch (JSONException e) {//“将 gid 放入 metaInfo 的键为 GTaskStringUtils.META_HEAD_GTASK_ID 的位置。
            Log.e(TAG, "failed to put related gid");//“使用错误级别记录日志，TAG 为标识，信息为‘failed to put related gid’（未能放入相关的 gid）。”
        }
        setNotes(metaInfo.toString());//“设置注释为 metaInfo 的字符串形式。”
        setName(GTaskStringUtils.META_NOTE_NAME);//“设置注释为 metaInfo 的字符串形式。”v
    }

    public String getRelatedGid() {//“公共方法 getRelatedGid，返回一个字符串。”
        return mRelatedGid;//“返回 mRelatedGid 的值。”
    }

    @Override
    public boolean isWorthSaving() {//翻译为“重写父类方法。公共方法 isWorthSaving，返回一个布尔值。”
        return getNotes() != null;//“返回获取到的注释不为 null 的结果。”
    }

    @Override
    public void setContentByRemoteJSON(JSONObject js) {//“重写父类方法。公共方法 setContentByRemoteJSON，接收一个 JSON 对象 js。”
        super.setContentByRemoteJSON(js);//“重写父类方法。公共方法 setContentByRemoteJSON，接收一个 JSON 对象 js。”
        if (getNotes() != null) {//“重写父类方法。公共方法 setContentByRemoteJSON，接收一个 JSON 对象 js。”
            try {//“重写父类方法。公共方法 setContentByRemoteJSON，接收一个 JSON 对象 js。”
                JSONObject metaInfo = new JSONObject(getNotes().trim());//“创建一个新的 JSON 对象 metaInfo，参数为去除首尾空白的获取到的注释。”
                mRelatedGid = metaInfo.getString(GTaskStringUtils.META_HEAD_GTASK_ID);//将 metaInfo 中键为 GTaskStringUtils.META_HEAD_GTASK_ID 的值赋给 mRelatedGid。”
            } catch (JSONException e) {//“捕获 JSON 异常，如果发生异常执行以下代码块。”
                Log.w(TAG, "failed to get related gid");//“使用警告级别记录日志，TAG 为标识，信息为‘failed to get related gid’（未能获取到相关的 gid）。”
                mRelatedGid = null;//“将 mRelatedGid 赋值为 null。”
            }
        }
    }

    @Override
    public void setContentByLocalJSON(JSONObject js) {//“重写父类方法。公共方法 setContentByLocalJSON，接收一个 JSON 对象 js。”
        // this function should not be called
      //此函数不应被调用。”
        throw new IllegalAccessError("MetaData:setContentByLocalJSON should not be called");//“抛出非法访问错误，信息为‘MetaData:setContentByLocalJSON should not be called’（MetaData 的 setContentByLocalJSON 不应被调用）。”
    }

    @Override
    public JSONObject getLocalJSONFromContent() {//“重写父类方法。公共方法 getLocalJSONFromContent，返回一个 JSON 对象。”
        throw new IllegalAccessError("MetaData:getLocalJSONFromContent should not be called");//“抛出非法访问错误，信息为‘MetaData:getLocalJSONFromContent should not be called’（MetaData 的 getLocalJSONFromContent 不应被调用）。”
    }

    @Override
    public int getSyncAction(Cursor c) {//“重写父类方法。公共方法 getSyncAction，接收一个游标 c，返回一个整数。”
        throw new IllegalAccessError("MetaData:getSyncAction should not be called");//抛出非法访问错误，信息为‘MetaData:getSyncAction should not be called’（MetaData 的 getSyncAction 不应被调用）。”
    }

}