/*
 * 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.
 */

/**
 * 文件: NoteEditText.java
 * 描述: 便签编辑文本框控件
 * 作用: 提供便签编辑的核心文本输入组件，支持特殊键处理、链接识别和上下文菜单
 * 功能:
 *   1. 处理回车键和删除键的特殊行为
 *   2. 支持文本变化监听和回调
 *   3. 支持URL链接的识别和处理
 *   4. 提供自定义的触摸事件处理
 */
package net.micode.notes.ui;

import android.content.Context;
import android.graphics.Rect;
import android.text.Layout;
import android.text.Selection;
import android.text.Spanned;
import android.text.TextUtils;
import android.text.style.URLSpan;
import android.util.AttributeSet;
import android.util.Log;
import android.view.ContextMenu;
import android.view.KeyEvent;
import android.view.MenuItem;
import android.view.MenuItem.OnMenuItemClickListener;
import android.view.MotionEvent;
import android.widget.EditText;

import net.micode.notes.R;

import java.util.HashMap;
import java.util.Map;

/**
 * 便签编辑文本框类
 * 
 * 继承自EditText，为便签应用提供自定义的文本编辑功能
 * 处理特殊按键事件（如回车键、删除键）以支持便签的编辑操作
 * 实现URL链接的识别和处理，支持点击链接执行相应操作
 */
public class NoteEditText extends EditText {
    /** 日志标签 */
    private static final String TAG = "NoteEditText";
    
    /** 当前编辑框在列表中的索引位置 */
    private int mIndex;
    
    /** 删除操作前的光标位置，用于判断是否需要合并上一个编辑框 */
    private int mSelectionStartBeforeDelete;

    /** 电话号码链接前缀 */
    private static final String SCHEME_TEL = "tel:" ;
    
    /** 网址链接前缀 */
    private static final String SCHEME_HTTP = "http:" ;
    
    /** 邮件链接前缀 */
    private static final String SCHEME_EMAIL = "mailto:" ;

    /** 链接类型与对应菜单文本资源ID的映射 */
    private static final Map<String, Integer> sSchemaActionResMap = new HashMap<String, Integer>();
    static {
        sSchemaActionResMap.put(SCHEME_TEL, R.string.note_link_tel);
        sSchemaActionResMap.put(SCHEME_HTTP, R.string.note_link_web);
        sSchemaActionResMap.put(SCHEME_EMAIL, R.string.note_link_email);
    }

    /**
     * 文本视图变化监听器接口
     * 由NoteEditActivity实现，用于响应编辑框的特殊操作
     */
    public interface OnTextViewChangeListener {
        /**
         * 当删除键在文本为空且光标在开头位置时触发，用于删除当前编辑框
         * 
         * @param index 当前编辑框的索引
         * @param text 当前编辑框的文本内容
         */
        void onEditTextDelete(int index, String text);

        /**
         * 当回车键按下时触发，用于在当前编辑框后添加新的编辑框
         * 
         * @param index 当前编辑框的索引
         * @param text 分割后应该放入新编辑框的文本内容
         */
        void onEditTextEnter(int index, String text);

        /**
         * 当文本内容变化时触发，用于控制项目选项的显示或隐藏
         * 
         * @param index 当前编辑框的索引
         * @param hasText 是否有文本内容
         */
        void onTextChange(int index, boolean hasText);
    }

    /** 文本视图变化监听器 */
    private OnTextViewChangeListener mOnTextViewChangeListener;

    /**
     * 构造函数
     * 
     * @param context 上下文环境
     */
    public NoteEditText(Context context) {
        super(context, null);
        mIndex = 0;
    }

    /**
     * 设置当前编辑框在列表中的索引位置
     * 
     * @param index 索引位置
     */
    public void setIndex(int index) {
        mIndex = index;
    }

    /**
     * 设置文本视图变化监听器
     * 
     * @param listener 监听器实例
     */
    public void setOnTextViewChangeListener(OnTextViewChangeListener listener) {
        mOnTextViewChangeListener = listener;
    }

    /**
     * 构造函数
     * 
     * @param context 上下文环境
     * @param attrs 属性集
     */
    public NoteEditText(Context context, AttributeSet attrs) {
        super(context, attrs, android.R.attr.editTextStyle);
    }

    /**
     * 构造函数
     * 
     * @param context 上下文环境
     * @param attrs 属性集
     * @param defStyle 默认样式
     */
    public NoteEditText(Context context, AttributeSet attrs, int defStyle) {
        super(context, attrs, defStyle);
        // TODO Auto-generated constructor stub
    }

    /**
     * 处理触摸事件
     * 实现精确的光标定位，使用户可以点击文本的任意位置设置光标
     * 
     * @param event 触摸事件
     * @return 是否已处理事件
     */
    @Override
    public boolean onTouchEvent(MotionEvent event) {
        switch (event.getAction()) {
            case MotionEvent.ACTION_DOWN:
                // 计算触摸点在文本中的精确位置，并设置光标
                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);
    }

    /**
     * 处理按键按下事件
     * 特殊处理回车键和删除键
     * 
     * @param keyCode 按键代码
     * @param event 按键事件
     * @return 是否已处理事件
     */
    @Override
    public boolean onKeyDown(int keyCode, KeyEvent event) {
        switch (keyCode) {
            case KeyEvent.KEYCODE_ENTER:
                // 如果设置了监听器，回车键由Activity处理
                if (mOnTextViewChangeListener != null) {
                    return false;
                }
                break;
            case KeyEvent.KEYCODE_DEL:
                // 记录删除前的光标位置，用于判断是否需要与上一个编辑框合并
                mSelectionStartBeforeDelete = getSelectionStart();
                break;
            default:
                break;
        }
        return super.onKeyDown(keyCode, event);
    }

    /**
     * 处理按键抬起事件
     * 实现删除键在文本开头时删除当前编辑框
     * 实现回车键分割文本并创建新编辑框
     * 
     * @param keyCode 按键代码
     * @param event 按键事件
     * @return 是否已处理事件
     */
    @Override
    public boolean onKeyUp(int keyCode, KeyEvent event) {
        switch(keyCode) {
            case KeyEvent.KEYCODE_DEL:
                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 (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);
    }

    /**
     * 处理焦点变化事件
     * 当焦点变化时，通知监听器文本内容的状态
     * 
     * @param focused 是否获得焦点
     * @param direction 焦点方向
     * @param previouslyFocusedRect 先前获得焦点的区域
     */
    @Override
    protected void onFocusChanged(boolean focused, int direction, Rect previouslyFocusedRect) {
        if (mOnTextViewChangeListener != null) {
            // 当失去焦点且文本为空时，通知监听器
            if (!focused && TextUtils.isEmpty(getText())) {
                mOnTextViewChangeListener.onTextChange(mIndex, false);
            } else {
                mOnTextViewChangeListener.onTextChange(mIndex, true);
            }
        }
        super.onFocusChanged(focused, direction, previouslyFocusedRect);
    }

    /**
     * 创建上下文菜单
     * 为识别到的URL链接提供操作选项
     * 
     * @param menu 上下文菜单
     */
    @Override
    protected void onCreateContextMenu(ContextMenu menu) {
        // 检查文本中是否包含URL链接
        if (getText() instanceof Spanned) {
            int selStart = getSelectionStart();
            int selEnd = getSelectionEnd();

            int min = Math.min(selStart, selEnd);
            int max = Math.max(selStart, selEnd);

            // 获取选中区域内的所有URL链接
            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) {
                                // 执行链接点击操作
                                urls[0].onClick(NoteEditText.this);
                                return true;
                            }
                        });
            }
        }
        super.onCreateContextMenu(menu);
    }
}