/*
 * 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
 *
 * 1Unless 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.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;

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:" ;

    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);
    }

    /**
     * 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;
    }

    /**
     * 设置索引值
     * 该方法用于从外部更新对象的索引状态
     *
     * @param index 新的索引值，用于替换当前对象的索引
     */
    public void setIndex(int index) {
        mIndex = index;
    }

    /**
     * 设置文本视图变化监听器
     * 用于在文本视图的内容发生变化时通知监听器
     *
     * @param listener 实现了OnTextViewChangeListener接口的监听器实例
     */
    public void setOnTextViewChangeListener(OnTextViewChangeListener listener) {
        mOnTextViewChangeListener = listener;
    }

    /**
    * 构造函数，用于在 XML 布局中实例化 NoteEditText 组件。
    *
    * @param context 上下文对象，包含应用环境信息
    * @param attrs   从 XML 布局文件中解析的属性集合
    */
    public NoteEditText(Context context, AttributeSet attrs) {
        super(context, attrs, android.R.attr.editTextStyle);
    }

    /**
    * 构造函数，用于在 XML 布局中实例化 NoteEditText 组件，并允许指定默认样式。
    *
    * @param context 上下文对象，包含应用环境信息
    * @param attrs   从 XML 布局文件中解析的属性集合
    * @param defStyle 默认样式资源 ID，用于自定义组件外观
    */
    public NoteEditText(Context context, AttributeSet attrs, int defStyle) {
        super(context, attrs, defStyle);
        // TODO Auto-generated constructor stub
    }

    /**
     * 处理触摸事件以实现特定的交互逻辑
     * 当用户触摸屏幕时，此方法被调用，用于处理触摸事件
     * 特别地，当触摸动作为按下时，它会计算触摸位置，并更新文本选择
     *
     * @param event 触摸事件，包含触摸动作、位置等信息
     * @return 返回true表示事件已被处理，false表示未处理
     */
    @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;
        }

        // 调用父类的onTouchEvent方法以处理其他触摸事件
        return super.onTouchEvent(event);
    }

    /**
     * 重写onKeyDown方法以处理特定的键盘事件
     *
     * @param keyCode 键盘事件的键码
     * @param event 键盘事件的对象
     * @return 如果事件被处理返回true，否则返回false
     */
    @Override
    public boolean onKeyDown(int keyCode, KeyEvent event) {
        // 根据不同的键码做相应的处理
        switch (keyCode) {
            case KeyEvent.KEYCODE_ENTER:
                // 当检测到ENTER键时，如果mOnTextViewChangeListener不为空，则不处理事件，交由其他处理程序处理
                if (mOnTextViewChangeListener != null) {
                    return false;
                }
                break;
            case KeyEvent.KEYCODE_DEL:
                // 当检测到DEL键时，记录删除操作前的光标位置
                mSelectionStartBeforeDelete = getSelectionStart();
                break;
            default:
                // 对于其他键码，不做特殊处理
                break;
        }
        // 对于未特殊处理的键码，调用父类的方法处理
        return super.onKeyDown(keyCode, event);
    }

    /**
     * 处理键盘按键释放事件
     *
     * @param keyCode 按键代码，标识哪个键被释放
     * @param event 键盘事件对象，包含更多关于该事件的详细信息
     * @return 如果事件被处理，返回true；否则返回false
     */
    @Override
    public boolean onKeyUp(int keyCode, KeyEvent event) {
        // 根据按键代码处理不同的按键事件
        switch(keyCode) {
            case KeyEvent.KEYCODE_DEL:
                // 处理删除键释放事件
                if (mOnTextViewChangeListener != null) {
                    // 如果删除前光标位置为0且不是第一个文本框，则通知监听器进行删除操作
                    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;
        }
        // 如果上述条件都不满足，则调用父类的onKeyUp方法处理事件
        return super.onKeyUp(keyCode, event);
    }

    /**
     * 当视图焦点改变时调用的方法
     *
     * @param focused 表示视图是否获得了焦点
     * @param direction 表示焦点移动的方向
     * @param previouslyFocusedRect 表示之前获得焦点的视图的矩形区域
     */
    @Override
    protected void onFocusChanged(boolean focused, int direction, Rect previouslyFocusedRect) {
        // 如果有注册的文本视图变更监听器
        if (mOnTextViewChangeListener != null) {
            // 如果视图失去焦点且文本为空，则调用监听器的onTextChange方法，参数为false
            if (!focused && TextUtils.isEmpty(getText())) {
                mOnTextViewChangeListener.onTextChange(mIndex, false);
            } else {
                // 否则，调用监听器的onTextChange方法，参数为true
                mOnTextViewChangeListener.onTextChange(mIndex, true);
            }
        }
        // 调用父类的onFocusChanged方法，确保焦点改变的默认行为得以执行
        super.onFocusChanged(focused, direction, previouslyFocusedRect);
    }

    /**
     * 重写创建上下文菜单的方法
     * 此方法用于在长按文本时创建上下文菜单，根据选中的文本部分是否包含URL来决定菜单项
     * 如果选中的文本中仅包含一个URL，则在菜单中添加一个相应的选项，点击可跳转到该链接
     */
    @Override
    protected void onCreateContextMenu(ContextMenu menu) {
        // 检查当前文本是否为Spanned类型，以支持富文本
        if (getText() instanceof Spanned) {
            // 获取选中文本的起始和结束位置
            int selStart = getSelectionStart();
            int selEnd = getSelectionEnd();

            // 确定选中文本的最小和最大位置，以处理选中区域
            int min = Math.min(selStart, selEnd);
            int max = Math.max(selStart, selEnd);

            // 获取选中文本范围内的所有URLSpan对象
            final URLSpan[] urls = ((Spanned) getText()).getSpans(min, max, URLSpan.class);
            // 如果选中的文本中仅有一个URL，则进一步处理
            if (urls.length == 1) {
                int defaultResId = 0;
                // 遍历预定义的schema-action资源映射，查找匹配的URL schema
                for(String schema: sSchemaActionResMap.keySet()) {
                    // 如果URL包含当前schema，则获取对应的资源ID，并停止遍历
                    if(urls[0].getURL().indexOf(schema) >= 0) {
                        defaultResId = sSchemaActionResMap.get(schema);
                        break;
                    }
                }

                // 如果没有找到匹配的schema，则使用默认的“其他”资源
                if (defaultResId == 0) {
                    defaultResId = R.string.note_link_other;
                }

                // 在上下文菜单中添加一个菜单项，并设置点击事件处理
                menu.add(0, 0, 0, defaultResId).setOnMenuItemClickListener(
                        new OnMenuItemClickListener() {
                            public boolean onMenuItemClick(MenuItem item) {
                                // 点击菜单项时，触发URL的onClick事件，通常会启动一个新的Activity
                                urls[0].onClick(NoteEditText.this);
                                return true;
                            }
                        });
            }
        }
        // 调用父类方法，确保菜单被正确创建
        super.onCreateContextMenu(menu);
    }
}
