注释

NoteEditText.java

@@ -0,0 +1,182 @@
+/*
+ * 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.
+ */
+
+/**
+ * Call by the {@link NoteEditActivity} to delete or add edit text
+ */
+public interface OnTextViewChangeListener {
+    /**
+     * Delete current edit text when {@link KeyEvent#KEYCODE_DEL} happens
+     * and the text is null
+     */
+    void onEditTextDelete(int index, String text);
+
+    /**
+     * Add edit text after current edit text when {@link KeyEvent#KEYCODE_ENTER}
+     * happen
+     */
+    void onEditTextEnter(int index, String text);
+
+    /**
+     * Hide or show item option when text change
+     */
+    void onTextChange(int index, boolean hasText);
+}
+
+private OnTextViewChangeListener mOnTextViewChangeListener;
+
+public NoteEditText(Context context) {
+    super(context, null);
+    mIndex = 0;
+}
+
+public void setIndex(int index) {
+    mIndex = index;
+}
+
+public void setOnTextViewChangeListener(OnTextViewChangeListener listener) {
+    mOnTextViewChangeListener = listener;
+}
+
+public NoteEditText(Context context, AttributeSet attrs) {
+    super(context, attrs, android.R.attr.editTextStyle);
+}
+
+public NoteEditText(Context context, AttributeSet attrs, int defStyle) {
+    super(context, attrs, defStyle);
+    // TODO Auto-generated constructor stub
+}
+
+@Override
+public boolean onTouchEvent(MotionEvent event) {
+    switch (event.getAction()) {
+        case MotionEvent.ACTION_DOWN:
+            // Calculate the position where the user tapped and set the text selection
+            int x = (int) event.getX();
+            int y = (int) event.getY();
+            x -= getTotalPaddingLeft();
+            y -= getTotalPaddingTop();
+            x += getScrollX();
+            y += getScrollY();
+
+            Layout layout = getLayout();
+            int line = layout.getLineForVertical(y);
+            int off = layout.getOffsetForHorizontal(line, x);
+            Selection.setSelection(getText(), off);
+            break;
+    }
+    return super.onTouchEvent(event);
+}
+
+@Override
+public boolean onKeyDown(int keyCode, KeyEvent event) {
+    switch (keyCode) {
+        case KeyEvent.KEYCODE_ENTER:
+            // If the enter key is pressed, allow the default behavior unless a listener is set
+            if (mOnTextViewChangeListener != null) {
+                return false;
+            }
+            break;
+        case KeyEvent.KEYCODE_DEL:
+            // Record the selection start position before deletion
+            mSelectionStartBeforeDelete = getSelectionStart();
+            break;
+        default:
+            break;
+    }
+    return super.onKeyDown(keyCode, event);
+}
+
+@Override
+public boolean onKeyUp(int keyCode, KeyEvent event) {
+    switch(keyCode) {
+        case KeyEvent.KEYCODE_DEL:
+            // If the delete key is released and a listener is set, notify the listener
+            if (mOnTextViewChangeListener != null) {
+                if (0 == mSelectionStartBeforeDelete && mIndex != 0) {
+                    mOnTextViewChangeListener.onEditTextDelete(mIndex, getText().toString());
+                    return true;
+                }
+            } else {
+                Log.d(TAG, "OnTextViewChangeListener was not seted");
+            }
+            break;
+        case KeyEvent.KEYCODE_ENTER:
+            // If the enter key is released and a listener is set, notify the listener
+            if (mOnTextViewChangeListener != null) {
+                int selectionStart = getSelectionStart();
+                String text = getText().subSequence(selectionStart, length()).toString();
+                setText(getText().subSequence(0, selectionStart));
+                mOnTextViewChangeListener.onEditTextEnter(mIndex + 1, text);
+            } else {
+                Log.d(TAG, "OnTextViewChangeListener was not seted");
+            }
+            break;
+        default:
+            break;
+    }
+    return super.onKeyUp(keyCode, event);
+}
+
+@Override
+protected void onFocusChanged(boolean focused, int direction, Rect previouslyFocusedRect) {
+    // Notify the listener when the text changes or focus is lost
+    if (mOnTextViewChangeListener != null) {
+        if (!focused && TextUtils.isEmpty(getText())) {
+            mOnTextViewChangeListener.onTextChange(mIndex, false);
+        } else {
+            mOnTextViewChangeListener.onTextChange(mIndex, true);
+        }
+    }
+    super.onFocusChanged(focused, direction, previouslyFocusedRect);
+}
+
+@Override
+protected void onCreateContextMenu(ContextMenu menu) {
+    // Create a context menu for URL spans in the text
+    if (getText() instanceof Spanned) {
+        int selStart = getSelectionStart();
+        int selEnd = getSelectionEnd();
+
+        int min = Math.min(selStart, selEnd);
+        int max = Math.max(selStart, selEnd);
+
+        final URLSpan[] urls = ((Spanned) getText()).getSpans(min, max, URLSpan.class);
+        if (urls.length == 1) {
+            int defaultResId = 0;
+            for(String schema: sSchemaActionResMap.keySet()) {
+                if(urls[0].getURL().indexOf(schema) >= 0) {
+                    defaultResId = sSchemaActionResMap.get(schema);
+                    break;
+                }
+            }
+
+            if (defaultResId == 0) {
+                defaultResId = R.string.note_link_other;
+            }
+
+            menu.add(0, 0, 0, defaultResId).setOnMenuItemClickListener(
+                    new OnMenuItemClickListener() {
+                        public boolean onMenuItemClick(MenuItem item) {
+                            // goto a new intent
+                            urls[0].onClick(NoteEditText.this);
+                            return true;
+                        }
+                    });
+        }
+    }
+    super.onCreateContextMenu(menu);
+}

Task.java

@@ -0,0 +1,384 @@
+/*
+ * 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;
+
+import android.database.Cursor;
+import android.text.TextUtils;
+import android.util.Log;
+
+import net.micode.notes.data.Notes;
+import net.micode.notes.data.Notes.DataColumns;
+import net.micode.notes.data.Notes.DataConstants;
+import net.micode.notes.data.Notes.NoteColumns;
+import net.micode.notes.gtask.exception.ActionFailureException;
+import net.micode.notes.tool.GTaskStringUtils;
+
+import org.json.JSONArray;
+import org.json.JSONException;
+import org.json.JSONObject;
+
+public class Task extends Node {
+    private static final String TAG = Task.class.getSimpleName();
+
+    private boolean mCompleted;  // 是否完成任务
+    private String mNotes;       // 任务备注
+    private JSONObject mMetaInfo; // 元数据信息
+    private Task mPriorSibling;  // 前一个兄弟任务
+    private TaskList mParent;    // 父任务列表
+
+    public Task() {
+        super();
+        mCompleted = false;
+        mNotes = null;
+        mPriorSibling = null;
+        mParent = null;
+        mMetaInfo = null;
+    }
+
+    /**
+     * 创建任务的 JSON 对象，用于创建新任务。
+     *
+     * @param actionId 操作 ID
+     * @return 创建任务的 JSON 对象
+     */
+    public JSONObject getCreateAction(int actionId) {
+        JSONObject js = new JSONObject();
+
+        try {
+            // 设置操作类型为创建
+            js.put(GTaskStringUtils.GTASK_JSON_ACTION_TYPE, GTaskStringUtils.GTASK_JSON_ACTION_TYPE_CREATE);
+
+            // 设置操作 ID
+            js.put(GTaskStringUtils.GTASK_JSON_ACTION_ID, actionId);
+
+            // 设置任务在父任务列表中的索引
+            js.put(GTaskStringUtils.GTASK_JSON_INDEX, mParent.getChildTaskIndex(this));
+
+            // 设置任务实体信息
+            JSONObject entity = new JSONObject();
+            entity.put(GTaskStringUtils.GTASK_JSON_NAME, getName());
+            entity.put(GTaskStringUtils.GTASK_JSON_CREATOR_ID, "null");
+            entity.put(GTaskStringUtils.GTASK_JSON_ENTITY_TYPE, GTaskStringUtils.GTASK_JSON_TYPE_TASK);
+            if (getNotes() != null) {
+                entity.put(GTaskStringUtils.GTASK_JSON_NOTES, getNotes());
+            }
+            js.put(GTaskStringUtils.GTASK_JSON_ENTITY_DELTA, entity);
+
+            // 设置父任务列表的 ID
+            js.put(GTaskStringUtils.GTASK_JSON_PARENT_ID, mParent.getGid());
+
+            // 设置目标父类型
+            js.put(GTaskStringUtils.GTASK_JSON_DEST_PARENT_TYPE, GTaskStringUtils.GTASK_JSON_TYPE_GROUP);
+
+            // 设置任务列表 ID
+            js.put(GTaskStringUtils.GTASK_JSON_LIST_ID, mParent.getGid());
+
+            // 设置前一个兄弟任务的 ID（如果有）
+            if (mPriorSibling != null) {
+                js.put(GTaskStringUtils.GTASK_JSON_PRIOR_SIBLING_ID, mPriorSibling.getGid());
+            }
+
+        } catch (JSONException e) {
+            Log.e(TAG, e.toString());
+            e.printStackTrace();
+            throw new ActionFailureException("生成任务创建 JSON 对象失败");
+        }
+
+        return js;
+    }
+
+    /**
+     * 创建任务的 JSON 对象，用于更新现有任务。
+     *
+     * @param actionId 操作 ID
+     * @return 更新任务的 JSON 对象
+     */
+    public JSONObject getUpdateAction(int actionId) {
+        JSONObject js = new JSONObject();
+
+        try {
+            // 设置操作类型为更新
+            js.put(GTaskStringUtils.GTASK_JSON_ACTION_TYPE, GTaskStringUtils.GTASK_JSON_ACTION_TYPE_UPDATE);
+
+            // 设置操作 ID
+            js.put(GTaskStringUtils.GTASK_JSON_ACTION_ID, actionId);
+
+            // 设置任务 ID
+            js.put(GTaskStringUtils.GTASK_JSON_ID, getGid());
+
+            // 设置任务实体信息
+            JSONObject entity = new JSONObject();
+            entity.put(GTaskStringUtils.GTASK_JSON_NAME, getName());
+            if (getNotes() != null) {
+                entity.put(GTaskStringUtils.GTASK_JSON_NOTES, getNotes());
+            }
+            entity.put(GTaskStringUtils.GTASK_JSON_DELETED, getDeleted());
+            js.put(GTaskStringUtils.GTASK_JSON_ENTITY_DELTA, entity);
+
+        } catch (JSONException e) {
+            Log.e(TAG, e.toString());
+            e.printStackTrace();
+            throw new ActionFailureException("生成任务更新 JSON 对象失败");
+        }
+
+        return js;
+    }
+
+    /**
+     * 根据远程 JSON 对象设置任务内容。
+     *
+     * @param js 远程 JSON 对象
+     */
+    public void setContentByRemoteJSON(JSONObject js) {
+        if (js != null) {
+            try {
+                // 设置任务 ID
+                if (js.has(GTaskStringUtils.GTASK_JSON_ID)) {
+                    setGid(js.getString(GTaskStringUtils.GTASK_JSON_ID));
+                }
+
+                // 设置最后修改时间
+                if (js.has(GTaskStringUtils.GTASK_JSON_LAST_MODIFIED)) {
+                    setLastModified(js.getLong(GTaskStringUtils.GTASK_JSON_LAST_MODIFIED));
+                }
+
+                // 设置任务名称
+                if (js.has(GTaskStringUtils.GTASK_JSON_NAME)) {
+                    setName(js.getString(GTaskStringUtils.GTASK_JSON_NAME));
+                }
+
+                // 设置任务备注
+                if (js.has(GTaskStringUtils.GTASK_JSON_NOTES)) {
+                    setNotes(js.getString(GTaskStringUtils.GTASK_JSON_NOTES));
+                }
+
+                // 设置是否已删除
+                if (js.has(GTaskStringUtils.GTASK_JSON_DELETED)) {
+                    setDeleted(js.getBoolean(GTaskStringUtils.GTASK_JSON_DELETED));
+                }
+
+                // 设置是否已完成
+                if (js.has(GTaskStringUtils.GTASK_JSON_COMPLETED)) {
+                    setCompleted(js.getBoolean(GTaskStringUtils.GTASK_JSON_COMPLETED));
+                }
+            } catch (JSONException e) {
+                Log.e(TAG, e.toString());
+                e.printStackTrace();
+                throw new ActionFailureException("从 JSON 对象获取任务内容失败");
+            }
+        }
+    }
+
+    /**
+     * 根据本地 JSON 对象设置任务内容。
+     *
+     * @param js 本地 JSON 对象
+     */
+    public void setContentByLocalJSON(JSONObject js) {
+        if (js == null || !js.has(GTaskStringUtils.META_HEAD_NOTE)
+                || !js.has(GTaskStringUtils.META_HEAD_DATA)) {
+            Log.w(TAG, "setContentByLocalJSON: 没有可用的内容");
+        }
+
+        try {
+            JSONObject note = js.getJSONObject(GTaskStringUtils.META_HEAD_NOTE);
+            JSONArray dataArray = js.getJSONArray(GTaskStringUtils.META_HEAD_DATA);
+
+            if (note.getInt(NoteColumns.TYPE) != Notes.TYPE_NOTE) {
+                Log.e(TAG, "无效的类型");
+                return;
+            }
+
+            for (int i = 0; i < dataArray.length(); i++) {
+                JSONObject data = dataArray.getJSONObject(i);
+                if (TextUtils.equals(data.getString(DataColumns.MIME_TYPE), DataConstants.NOTE)) {
+                    setName(data.getString(DataColumns.CONTENT));
+                    break;
+                }
+            }
+
+        } catch (JSONException e) {
+            Log.e(TAG, e.toString());
+            e.printStackTrace();
+        }
+    }
+
+    /**
+     * 根据任务内容生成本地 JSON 对象。
+     *
+     * @return 本地 JSON 对象
+     */
+    public JSONObject getLocalJSONFromContent() {
+        String name = getName();
+        try {
+            if (mMetaInfo == null) {
+                // 新建的任务来自 Web
+                if (name == null) {
+                    Log.w(TAG, "该笔记似乎为空");
+                    return null;
+                }
+
+                JSONObject js = new JSONObject();
+                JSONObject note = new JSONObject();
+                JSONArray dataArray = new JSONArray();
+                JSONObject data = new JSONObject();
+                data.put(DataColumns.CONTENT, name);
+                dataArray.put(data);
+                js.put(GTaskStringUtils.META_HEAD_DATA, dataArray);
+                note.put(NoteColumns.TYPE, Notes.TYPE_NOTE);
+                js.put(GTaskStringUtils.META_HEAD_NOTE, note);
+                return js;
+            } else {
+                // 已同步的任务
+                JSONObject note = mMetaInfo.getJSONObject(GTaskStringUtils.META_HEAD_NOTE);
+                JSONArray dataArray = mMetaInfo.getJSONArray(GTaskStringUtils.META_HEAD_DATA);
+
+                for (int i = 0; i < dataArray.length(); i++) {
+                    JSONObject data = dataArray.getJSONObject(i);
+                    if (TextUtils.equals(data.getString(DataColumns.MIME_TYPE), DataConstants.NOTE)) {
+                        data.put(DataColumns.CONTENT, getName());
+                        break;
+                    }
+                }
+
+                note.put(NoteColumns.TYPE, Notes.TYPE_NOTE);
+                return mMetaInfo;
+            }
+        } catch (JSONException e) {
+            Log.e(TAG, e.toString());
+            e.printStackTrace();
+            return null;
+        }
+    }
+
+    /**
+     * 设置元数据信息。
+     *
+     * @param metaData 元数据对象
+     */
+    public void setMetaInfo(MetaData metaData) {
+        if (metaData != null && metaData.getNotes() != null) {
+            try {
+                mMetaInfo = new JSONObject(metaData.getNotes());
+            } catch (JSONException e) {
+                Log.w(TAG, e.toString());
+                mMetaInfo = null;
+            }
+        }
+    }
+
+    /**
+     * 获取同步操作类型。
+     *
+     * @param c 数据库游标
+     * @return 同步操作类型
+     */
+    public int getSyncAction(Cursor c) {
+        try {
+            JSONObject noteInfo = null;
+            if (mMetaInfo != null && mMetaInfo.has(GTaskStringUtils.META_HEAD_NOTE)) {
+                noteInfo = mMetaInfo.getJSONObject(GTaskStringUtils.META_HEAD_NOTE);
+            }
+
+            if (noteInfo == null) {
+                Log.w(TAG, "笔记元数据似乎已被删除");
+                return SYNC_ACTION_UPDATE_REMOTE;
+            }
+
+            if (!noteInfo.has(NoteColumns.ID)) {
+                Log.w(TAG, "远程笔记 ID 似乎已被删除");
+                return SYNC_ACTION_UPDATE_LOCAL;
+            }
+
+            // 验证笔记 ID
+            if (c.getLong(SqlNote.ID_COLUMN) != noteInfo.getLong(NoteColumns.ID)) {
+                Log.w(TAG, "笔记 ID 不匹配");
+                return SYNC_ACTION_UPDATE_LOCAL;
+            }
+
+            if (c.getInt(SqlNote.LOCAL_MODIFIED_COLUMN) == 0) {
+                // 没有本地更新
+                if (c.getLong(SqlNote.SYNC_ID_COLUMN) == getLastModified()) {
+                    // 双方都没有更新
+                    return SYNC_ACTION_NONE;
+                } else {
+                    // 应用远程到本地
+                    return SYNC_ACTION_UPDATE_LOCAL;
+                }
+            } else {
+                // 验证任务 ID
+                if (!c.getString(SqlNote.GTASK_ID_COLUMN).equals(getGid())) {
+                    Log.e(TAG, "任务 ID 不匹配");
+                    return SYNC_ACTION_ERROR;
+                }
+                if (c.getLong(SqlNote.SYNC_ID_COLUMN) == getLastModified()) {
+                    // 仅本地修改
+                    return SYNC_ACTION_UPDATE_REMOTE;
+                } else {
+                    return SYNC_ACTION_UPDATE_CONFLICT;
+                }
+            }
+        } catch (Exception e) {
+            Log.e(TAG, e.toString());
+            e.printStackTrace();
+        }
+
+        return SYNC_ACTION_ERROR;
+    }
+
+    /**
+     * 判断任务是否有值得保存的内容。
+     *
+     * @return 是否有值得保存的内容
+     */
+    public boolean isWorthSaving() {
+        return mMetaInfo != null || (getName() != null && getName().trim().length() > 0)
+                || (getNotes() != null && getNotes().trim().length() > 0);
+    }
+
+    public void setCompleted(boolean completed) {
+        this.mCompleted = completed;
+    }
+
+    public void setNotes(String notes) {
+        this.mNotes = notes;
+    }
+
+    public void setPriorSibling(Task priorSibling) {
+        this.mPriorSibling = priorSibling;
+    }
+
+    public void setParent(TaskList parent) {
+        this.mParent = parent;
+    }
+
+    public boolean getCompleted() {
+        return this.mCompleted;
+    }
+
+    public String getNotes() {
+        return this.mNotes;
+    }
+
+    public Task getPriorSibling() {
+        return this.mPriorSibling;
+    }
+
+    public TaskList getParent() {
+        return this.mParent;
+    }
+}