联系人的侧边字母索引ListView 将手机通讯录姓名通过首字母排序。

package com.lixu.letterlistview;

import java.util.ArrayList;
import java.util.List;
import org.apache.http.NameValuePair;
import org.apache.http.message.BasicNameValuePair;
import com.lixu.letterlistview.letter.LetterBaseListAdapter;
import com.lixu.letterlistview.letter.LetterListView;
import com.lixu.lianxirenlist.R;
import android.app.Activity;
import android.content.ContentResolver;
import android.database.Cursor;
import android.graphics.Color;
import android.net.Uri;
import android.os.Bundle;
import android.view.Gravity;
import android.view.View;
import android.view.ViewGroup;
import android.widget.TextView;

public class MainActivity extends Activity {
    private ArrayList<String> dataArray;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        // 通过获取手机通讯录的姓名
        dataArray = new ArrayList<String>();

        Uri uri = Uri.parse("content://com.android.contacts/contacts");
        ContentResolver resolver = this.getContentResolver();
        // 给query传递一个SORT_KEY_PRIMARY，让ContentResolver将获得的数据按照联系人名字首字母排序
        Cursor cursor = resolver.query(uri, null, null, null,
                android.provider.ContactsContract.Contacts.SORT_KEY_PRIMARY);
        while (cursor.moveToNext())

        {
            // 联系人的id
            String id = cursor.getString(cursor.getColumnIndex(android.provider.ContactsContract.Contacts._ID));
            // 将联系人按姓名首字母分组
            String sort_key_primary = cursor
                    .getString(cursor.getColumnIndex(android.provider.ContactsContract.Contacts.SORT_KEY_PRIMARY));
            // 获取联系人的名字
            String name = cursor
                    .getString(cursor.getColumnIndex(android.provider.ContactsContract.Contacts.DISPLAY_NAME));
            dataArray.add(name);
        }

        LetterListView letterListView = (LetterListView) findViewById(R.id.letterListView);
        letterListView.setAdapter(new TestAdapter());

    }

    /**
     * 这里 使用一个简单的 NameValuePair 对象,做为测试
     * 
     * @Title:
     * @Description:
     * @Author:Justlcw
     * @Since:2014-5-13
     * @Version:
     */
    class TestAdapter extends LetterBaseListAdapter<NameValuePair> {
        /** 字母对应的key,因为字母是要插入到列表中的,为了区别,所有字母的item都使用同一的key. **/
        private static final String LETTER_KEY = "letter";

        public TestAdapter() {
            super();

            List<NameValuePair> dataList = new ArrayList<NameValuePair>();
            for (int i = 0; i < dataArray.size(); i++) {
                NameValuePair pair = new BasicNameValuePair(String.valueOf(i), dataArray.get(i));
                dataList.add(pair);
            }
            setContainerList(dataList);
        }

        @Override
        public Object getItem(int position) {
            return list.get(position);
        }

        @Override
        public long getItemId(int position) {
            return position;
        }

        @Override
        public String getItemString(NameValuePair t) {
            return t.getValue();
        }

        @Override
        public NameValuePair create(char letter) {
            return new BasicNameValuePair(LETTER_KEY, String.valueOf(letter));
        }

        @Override
        public boolean isLetter(NameValuePair t) {
            // 判断是不是字母行,通过key比较,这里是NameValuePair对象,其他对象,就由你自己决定怎么判断了.
            return t.getName().equals(LETTER_KEY);
        }

        @Override
        public View getLetterView(int position, View convertView, ViewGroup parent) {
            // 这里是字母的item界面设置.
            if (convertView == null) {
                convertView = new TextView(MainActivity.this);
                ((TextView) convertView).setGravity(Gravity.CENTER_VERTICAL);
                convertView.setBackgroundColor(getResources().getColor(android.R.color.white));
            }
            ((TextView) convertView).setText(list.get(position).getValue());
            ((TextView) convertView).setBackgroundColor(Color.GREEN);
            ((TextView) convertView).setTextSize(25);
            return convertView;
        }

        @Override
        public View getContainerView(int position, View convertView, ViewGroup parent) {
            // 这里是其他正常数据的item界面设置.
            if (convertView == null) {
                convertView = new TextView(MainActivity.this);
                ((TextView) convertView).setGravity(Gravity.CENTER_VERTICAL);
            }
            ((TextView) convertView).setText(list.get(position).getValue());
            ((TextView) convertView).setBackgroundColor(Color.YELLOW);
            ((TextView) convertView).setTextSize(20);

            return convertView;
        }
    }
}

package com.lixu.letterlistview.letter;

import android.widget.BaseAdapter;

/**
 * 带有侧边字母列表的listView适配器
 * 
 *@Title:
 *@Description:
 *@Author:Justlcw
 *@Since:2014-5-8
 *@Version:
 */
public abstract class LetterBaseAdapter extends BaseAdapter
{
    /** 字母表头部 **/
    protected static final char HEADER = '+';
    /** 字母表尾部 **/
    protected static final char FOOTER = '#';

    /**
     * 是否需要隐藏没有匹配到的字母
     * 
     * @return true 隐藏, false 不隐藏
     * @Description:
     * @Author Justlcw
     * @Date 2014-5-8
     */
    public abstract boolean hideLetterNotMatch();
    
    /**
     * 获取字母对应的位置
     * 
     * @return position
     * @Description:
     * @Author Justlcw
     * @Date 2014-5-8
     */
    public abstract int getIndex(char letter);
}

package com.lixu.letterlistview.letter;

import java.util.ArrayList;
import java.util.HashMap;
import java.util.List;
import java.util.Map;
import android.text.TextUtils;
import android.util.Log;
import android.view.View;
import android.view.ViewGroup;

/**
 * 通用带有字母列表的泛型对象adapter
 * 
 * @Title:
 * @Description:
 * @Author:Justlcw
 * @Since:2014-5-9
 * @Version:
 */
public abstract class LetterBaseListAdapter<T> extends LetterBaseAdapter {
    /** log tag. **/
    private static final String TAG = "LetterBaseListAdapter";

    /** 默认错误头部字母. **/
    private static final char ERROR_LETTER = ' ';

    /** view type的类型总数 **/
    private static final int TYPE_COUNT = 2;
    /** 字母类型 **/
    private static final int TYPE_LETTER = 0;
    /** 实体类型 **/
    private static final int TYPE_CONTAINER = 1;

    /** 添加字母之后的list **/
    protected final List<T> list;
    /** 字母头位置标示map **/
    private final Map<Character, Integer> letterMap;

    /**
     * 构造方法
     */
    public LetterBaseListAdapter() {
        list = new ArrayList<T>();
        letterMap = new HashMap<Character, Integer>();
    }

    /**
     * 构造方法
     * 
     * @param dataArray
     *            内容数组
     */
    public LetterBaseListAdapter(T[] dataArray) {
        this();
        setContainerList(dataArray);
    }

    /**
     * 构造方法
     * 
     * @param dataList
     *            内容列表
     */
    public LetterBaseListAdapter(List<T> dataList) {
        this();
        setContainerList(dataList);
    }

    /**
     * 设置主体内容
     * 
     * @param dataArray
     *            实体数组
     * @Description:
     * @Author Justlcw
     * @Date 2014-5-9
     */
    protected final void setContainerList(T[] dataArray) {
        if (!list.isEmpty()) {
            list.clear();
        }
        if (!letterMap.isEmpty()) {
            letterMap.clear();
        }

        char letter = ERROR_LETTER;
        int index = 0;
        for (int i = 0; i < dataArray.length; i++) {
            T t = dataArray[i];

            char l = getHeaderLetter(t);

            if (letter != l && l != ERROR_LETTER) {
                // 如果发现这个字母没有添加过,更新一下标示
                letter = l;
                // 创建一个T类型的字母头放进去
                T tl = create(letter);
                if (tl != null) {
                    // 如果创建成功,则插入到列表中
                    list.add(tl);
                }
                // 存放最新字母对应的位置
                letterMap.put(letter, index);
                index++;
            }
            // 添加原本的填充实体项
            list.add(t);
            index++;
        }
    }

    /**
     * 设置主体内容.
     * 
     * @param dataList
     *            实体列表
     * @Description:
     * @Author Justlcw
     * @Date 2014-5-9
     */
    protected final void setContainerList(List<T> dataList) {
        if (!list.isEmpty()) {
            list.clear();
        }
        if (!letterMap.isEmpty()) {
            letterMap.clear();
        }

        char letter = ' ';
        int index = 0;
        for (int i = 0; i < dataList.size(); i++) {
            T t = dataList.get(i);

            char l = getHeaderLetter(t);

            if (letter != l && l != ERROR_LETTER) {
                // 如果发现这个字母没有添加过,更新一下标示
                letter = l;
                // 创建一个T类型的字母头放进去
                T tl = create(letter);
                if (tl != null) {
                    // 如果创建成功,则插入到列表中
                    list.add(tl);
                }
                // 存放最新字母对应的位置
                letterMap.put(letter, index);
                index++;
            }
            // 添加原本的填充实体项
            list.add(t);
            index++;
        }
    }

    /**
     * @param t
     *            <实体item对象>
     * 
     * @return <实体item对象> 首字母, 获取失败返回 {@link #ERROR_LETTER}
     * @Description:
     * @Author Justlcw
     * @Date 2014-5-12
     */
    private char getHeaderLetter(T t) {
        // 获取item对应的字符串
        String str = getItemString(t);
        // 如果为空,跳出继续
        if (TextUtils.isEmpty(str)) {
            Log.e(TAG, "item string empty in " + t.toString());
            return ERROR_LETTER;
        }
        char l;
        // 获取第一个字母
        char firstChar = str.charAt(0);
        if (firstChar == HEADER || firstChar == FOOTER || LetterUtil.isLetter(firstChar)) {
            l = firstChar;// 如果是头,尾,字母,直接赋值
        } else {
            String[] letterArray = LetterUtil.getFirstPinyin(firstChar);
            // 如果是汉字,取拼音首字母
            if (letterArray != null && letterArray.length > 0) {
                l = letterArray[0].charAt(0);
            } else {
                // 如果汉字转拼音失败了,跳过
                Log.e(TAG, firstChar + " turn to letter fail, " + t.toString());
                return ERROR_LETTER;
            }
        }

        // 如果是小写字母,转换为大写字母
        if (l >= 'a') {
            l = (char) (l - 32);
        }
        return l;
    }

    @Override
    public final int getCount() {
        return list.size();
    }

    @Override
    public final View getView(int position, View convertView, ViewGroup parent) {
        if (getItemViewType(position) == TYPE_LETTER) {
            return getLetterView(position, convertView, parent);
        }
        return getContainerView(position, convertView, parent);
    }

    @Override
    public final int getItemViewType(int position) {
        if (isLetter(list.get(position))) {
            return TYPE_LETTER;
        }
        return TYPE_CONTAINER;
    }

    @Override
    public final int getViewTypeCount() {
        return TYPE_COUNT;
    }

    @Override
    public boolean hideLetterNotMatch() {
        return false;
    }

    @Override
    public final int getIndex(char letter) {
        Integer index = letterMap.get(letter);
        if (index == null) {
            return -1;
        }
        return index;
    }

    /**
     * @param T
     *            <实体item对象>
     * 
     * @return <实体item对象>对应的String,用来获取<拼音首字母>
     * @Description:
     * @Author Justlcw
     * @Date 2014-5-9
     */
    public abstract String getItemString(T t);

    /**
     * @param letter
     *            <字母>
     * 
     * @return 根据<字母>创建一个<实体item对象>,用来显示<字母item>
     * @Description:
     * @Author Justlcw
     * @Date 2014-5-9
     */
    public abstract T create(char letter);

    /**
     * @param t
     *            <实体item对象>
     * 
     * @return 根据<实体item对象>,判断是否是<字母item>
     * @Description:
     * @Author Justlcw
     * @Date 2014-5-9
     */
    public abstract boolean isLetter(T t);

    /**
     * 返回 <字母item>界面,其他的同
     * <P>
     * {@link #getView(int, View, ViewGroup)}
     * 
     * @Description:
     * @Author Justlcw
     * @Date 2014-5-9
     */
    public abstract View getLetterView(int position, View convertView, ViewGroup parent);

    /**
     * 返回<实体item>界面,其他的同
     * <P>
     * {@link #getView(int, View, ViewGroup)}
     * 
     * @Description:
     * @Author Justlcw
     * @Date 2014-5-9
     */
    public abstract View getContainerView(int position, View convertView, ViewGroup parent);
}

package com.lixu.letterlistview.letter;

import java.lang.ref.SoftReference;
import java.util.ArrayList;
import java.util.List;

import com.lixu.lianxirenlist.R;
import android.content.Context;
import android.os.Handler;
import android.os.Message;
import android.util.AttributeSet;
import android.view.Gravity;
import android.view.LayoutInflater;
import android.view.MotionEvent;
import android.view.View;
import android.view.ViewGroup;
import android.widget.AbsListView;
import android.widget.BaseAdapter;
import android.widget.FrameLayout;
import android.widget.ListView;
import android.widget.TextView;
import android.widget.AdapterView.OnItemClickListener;

/**
 * 带有字母列表的listView
 * 
 * @Title:
 * @Description:
 * @Author:Justlcw
 * @Since:2014-5-7
 * @Version:
 */
public class LetterListView extends FrameLayout {
    /** 隐藏字母消息 **/
    private final int MSG_HIDE_LETTER = 0x0;

    /** 字母列表的宽度 **/
    private final int LETTER_LIST_VIEW_WIDTH = 50;// TODO 这里宽度写死了,按着一定的比例比较好

    /** 内容列表 **/
    private ListView mListView;
    /** 内容列表适配器 **/
    private LetterBaseAdapter mAdapter;

    /** 字母列表 **/
    private ListView mLetterListView;
    private LetterAdapter mLetterAdapter;

    private TextView mLetterTextView;

    /** 字母消息Handler **/
    private Handler mLetterhandler;

    /**
     * 构造方法
     * 
     * @param context
     */
    public LetterListView(Context context) {
        super(context);
        initListView(context);
    }

    /**
     * 构造方法
     * 
     * @param context
     * @param attrs
     */
    public LetterListView(Context context, AttributeSet attrs) {
        super(context, attrs);
        initListView(context);
    }

    /**
     * 初始化 内容列表 字母列表
     * 
     * @Description:
     * @Author Justlcw
     * @Date 2014-5-7
     */
    private void initListView(Context context) {
        LayoutInflater inflater = LayoutInflater.from(getContext());
        // TODO 这里添加内容列表,可以在这里对ListView进行一些你想要的设置
        mListView = (ListView) inflater.inflate(R.layout.letter_list_container, null, false);
        LayoutParams lp = new LayoutParams(LayoutParams.MATCH_PARENT, LayoutParams.MATCH_PARENT);
        addView(mListView, lp);

        // TODO 这里添加字母列表,可以在这里对ListView进行一些你想要的设置
        mLetterListView = (ListView) inflater.inflate(R.layout.letter_list_letter, null, false);
        mLetterListView.setOnTouchListener(mLetterOnTouchListener);
        LayoutParams letterListLp = new LayoutParams(LETTER_LIST_VIEW_WIDTH, LayoutParams.MATCH_PARENT, Gravity.RIGHT);
        addView(mLetterListView, letterListLp);

        // TODO 这里对显示的字母进行设置
        mLetterTextView = (TextView) inflater.inflate(R.layout.letter_list_position, null, false);
        LayoutParams letterLp = new LayoutParams(LayoutParams.WRAP_CONTENT, LayoutParams.WRAP_CONTENT, Gravity.CENTER);
        addView(mLetterTextView, letterLp);
        mLetterTextView.setVisibility(View.INVISIBLE);

        // 初始化letter消息发送者
        mLetterhandler = new LetterHandler(this);
    }

    /**
     * 设置内容列表适配器
     * 
     * @param adapter
     *            {@link LetterBaseAdapter}
     * @Description:
     * @Author Justlcw
     * @Date 2014-5-7
     */
    public void setAdapter(LetterBaseAdapter adapter) {
        if (adapter != null) {
            mAdapter = adapter;
            mListView.setAdapter(mAdapter);
        }
    }

    /**
     * {@link AbsListView#setOnItemClickListener(OnItemClickListener)}
     * 
     * @Description:
     * @Author Justlcw
     * @Date 2014-5-14
     */
    public void setOnItemClickListener(OnItemClickListener onItemClickListener) {
        mListView.setOnItemClickListener(onItemClickListener);
    }

    @Override
    protected void onSizeChanged(int w, int h, int oldw, int oldh) {
        super.onSizeChanged(w, h, oldw, oldh);

        mLetterAdapter = new LetterAdapter(h - getPaddingTop() - getPaddingBottom());
        mLetterListView.setAdapter(mLetterAdapter);
    }

    /**
     * 显示字母
     * 
     * @Description:
     * @Author Justlcw
     * @Date 2014-5-8
     */
    private void showLetter(String letter) {
        if (mLetterTextView.getVisibility() != View.VISIBLE) {
            mLetterTextView.setVisibility(View.VISIBLE);
            mLetterListView.setBackgroundResource(android.R.color.darker_gray);
        }
        mLetterTextView.setText(letter);

        mLetterhandler.removeMessages(MSG_HIDE_LETTER);
        mLetterhandler.sendEmptyMessageDelayed(MSG_HIDE_LETTER, 500);
    }

    /**
     * 处理消息 {@link LetterHandler#handleMessage(Message)}
     * 
     * @param msg
     *            消息
     * @Description:
     * @Author Justlcw
     * @Date 2014-5-8
     */
    private void handleLetterMessage(Message msg) {
        mLetterTextView.setVisibility(View.INVISIBLE);
        mLetterListView.setBackgroundResource(android.R.color.white);
    }

    /** 字母栏touch事件 **/
    private View.OnTouchListener mLetterOnTouchListener = new View.OnTouchListener() {
        @Override
        public boolean onTouch(View v, MotionEvent event) {
            int height = (int) event.getY() - v.getTop();

            int position = mLetterAdapter.getTouchPoistion(height);
            if (position >= 0) {
                char letter = (Character) mLetterAdapter.getItem(position);
                // 显示字母
                showLetter(String.valueOf(letter));

                // 显示到字母对应的位置
                int select = mAdapter.getIndex(letter);
                if (select >= 0) {
                    mListView.setSelection(select);
                }
                return true;
            }
            return false;
        }
    };

    /**
     * 字母列表设配器
     * 
     * @Title:
     * @Description:
     * @Author:Justlcw
     * @Since:2014-5-7
     * @Version:
     */
    private class LetterAdapter extends BaseAdapter {
        /** 字母表 **/
        private static final String LETTER_STR = "+ABCDEFGHIJKLMNOPQRSTUVWXYZ#";
        /** 最终显示的字母array **/
        private char[] letterArray;
        /** 每个字母的高度 **/
        private int itemHeight;

        /**
         * 构造方法
         * 
         * @param height
         *            view height
         */
        public LetterAdapter(int height) {
            if (mAdapter.hideLetterNotMatch()) {
                List<Character> list = new ArrayList<Character>();
                char[] allArray = LETTER_STR.toCharArray();
                for (int i = 0; i < allArray.length; i++) {
                    char letter = allArray[i];
                    int position = mAdapter.getIndex(letter);
                    if (position >= 0) {
                        list.add(letter);
                    }
                }
                letterArray = new char[list.size()];
                for (int i = 0; i < list.size(); i++) {
                    letterArray[i] = list.get(i);
                }
                list.clear();
                list = null;
            } else {
                letterArray = LETTER_STR.toCharArray();
            }
            itemHeight = height / letterArray.length;
        }

        @Override
        public int getCount() {
            return letterArray.length;
        }

        @Override
        public Object getItem(int position) {
            return letterArray[position];
        }

        @Override
        public long getItemId(int position) {
            return position;
        }

        @Override
        public View getView(int position, View convertView, ViewGroup parent) {
            if (convertView == null) {
                convertView = new TextView(getContext());
                ((TextView) convertView).setTextColor(getResources().getColor(android.R.color.black));
                ((TextView) convertView).setGravity(Gravity.CENTER);
                AbsListView.LayoutParams lp = new AbsListView.LayoutParams(AbsListView.LayoutParams.MATCH_PARENT,
                        itemHeight);
                convertView.setLayoutParams(lp);
            }
            ((TextView) convertView).setText(String.valueOf(letterArray[position]));

            return convertView;
        }

        /**
         * 获取touch的位置
         * 
         * @return position
         * @Description:
         * @Author Justlcw
         * @Date 2014-5-8
         */
        public int getTouchPoistion(int touchHeight) {
            int position = touchHeight / itemHeight;
            if (position >= 0 && position < getCount()) {
                return position;
            }
            return -1;
        }
    }

    /**
     * 处理字母显示的handler.
     * 
     * @Title:
     * @Description:
     * @Author:Justlcw
     * @Since:2014-5-8
     * @Version:
     */
    private static class LetterHandler extends Handler {
        /** 弱引用 {@link LetterListView} **/
        private SoftReference<LetterListView> srLetterListView;

        /**
         * 构造方法
         * 
         * @param letterListView
         *            {@link LetterListView}
         */
        public LetterHandler(LetterListView letterListView) {
            srLetterListView = new SoftReference<LetterListView>(letterListView);
        }

        @Override
        public void handleMessage(Message msg) {
            LetterListView letterListView = srLetterListView.get();
            // 如果view没有被销毁掉,交给view处理这个消息
            if (letterListView != null) {
                letterListView.handleLetterMessage(msg);
            }
        }
    }
}

package com.lixu.letterlistview.letter;

import net.sourceforge.pinyin4j.PinyinHelper;


/**
 * 字母工具类
 *@Title:
 *@Description:
 *@Author:Justlcw
 *@Since:2014-5-8
 *@Version:
 */
public class LetterUtil
{
    /**
     * @param chinese 一个汉字
     * @return 拼音首字母
     * @Description:
     * @Author Justlcw
     * @Date 2014-5-8
     */
    public static String[] getFirstPinyin(char chinese)
    {
        return PinyinHelper.toHanyuPinyinStringArray(chinese);
    }
    
    /**
     * 是否是字母
     * 
     * @return true 字母,false 非字母
     * @Description:
     * @Author Justlcw
     * @Date 2014-5-8
     */
    public static boolean isLetter(char c)
    {
        return (c >= 65 && c <= 90) || (c >= 97 && c <= 112);
    }
}

xml文件：

<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent" >

    <com.lixu.letterlistview.letter.LetterListView
        android:id="@+id/letterListView"
        android:layout_width="match_parent"
        android:layout_height="match_parent" >
    </com.lixu.letterlistview.letter.LetterListView>

</RelativeLayout>

<?xml version="1.0" encoding="utf-8"?>
<ListView xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:cacheColorHint="@android:color/transparent"
    android:divider="@android:color/transparent"
    android:dividerHeight="0dp"
    android:scrollbars="none" />

<?xml version="1.0" encoding="utf-8"?>
<ListView xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:background="#f44336"
    android:cacheColorHint="@android:color/transparent"
    android:divider="@android:color/transparent"
    android:dividerHeight="0dp"
    android:scrollbars="none" />

<?xml version="1.0" encoding="utf-8"?>
<TextView xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="wrap_content"
    android:layout_height="wrap_content"
    android:background="#f44336"
    android:gravity="center"
    android:maxWidth="70dip"
    android:minWidth="70dip"
    android:padding="10dip"
    android:textColor="@android:color/black"
    android:textSize="50sp" />

运行效果图：