ApiDemos学习

package com.example.android.apis;

import android.app.ListActivity;
//导包省略
import java.util.Map;

/**
 本类是整个程序的入口,主要作用是显示整个目录
 有子目录就再激活一个新的本类实例
*/
public class ApiDemos extends ListActivity {
    //ListActivity,实现滚动列表的Activity
    @Override
    public void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        
        Intent intent = getIntent();//取得激活自己的Intent       
        /*Intent.getStringExtra()方法取得的是用户自己调用putExtra()存放的数据,如果是首页,那么Intent里是没有数据的,如果是子页面,则会取得this.browseIntent()方法中存放的值,"com.example.android.apis.Path"是一个自定义的key*/
        String path = intent.getStringExtra("com.example.android.apis.Path");

        if (path == null) {
            path = "";
        }

		/*Adapter,适配器,作为数据和list显示的桥梁,
		SimpleAdapter
		第一个参数是上下文,也就是适配器对应的Activity,
		第二个参数是数据源,只要符合List<Map>,完全由用户自己定义需要的任何数据
		第三个参数是字段,对应Map中的key,数组中出现的key,对应Map中的value就会被显示在屏幕上
		第四个参数是样式
		*/
        setListAdapter(new SimpleAdapter(this, getData(path),
                android.R.layout.simple_list_item_1, new String[] { "title" },
                new int[] { android.R.id.text1 }));
        getListView().setTextFilterEnabled(true);
    }

	/*
	  该方法用来整合Adapter中需要的数据源
	传入的prefix是本Activity的逻辑路径(也就是目录路径),对应AndroidManifest.xml中<activity android:label="....">
	例如"App/Activity/<b>Hello <i>World</i></b>"
	最后返回一个List,其中的Map中包含一个"title",用作最后显示在屏幕上
	还包含一个"intent",用来映射对应的Activity
	*/
    protected List<Map<String, Object>> getData(String prefix) {
        List<Map<String, Object>> myData = new ArrayList<Map<String, Object>>();

		/*
		 下面两行创建了一个Intent,对应AndroidManifest.xml中有
		<intent-filter>
		       <action android:name="android.intent.action.MAIN" />
		       <category android:name="android.intent.category.SAMPLE_CODE" />
		</intent-filter>的Activity
		*/
        Intent mainIntent = new Intent(Intent.ACTION_MAIN, null);
        mainIntent.addCategory(Intent.CATEGORY_SAMPLE_CODE);


        PackageManager pm = getPackageManager();//PackageManager包管理,可以取得和包相关的信息
        List<ResolveInfo> list = pm.queryIntentActivities(mainIntent, 0);//按mainIntent的配置查找匹配的的Activity

        if (null == list)
            return myData;

        String[] prefixPath;
        String prefixWithSlash = prefix;
        
        if (prefix.equals("")) {//根目录
            prefixPath = null;
        } else {//子目录
            prefixPath = prefix.split("/");
            prefixWithSlash = prefix + "/";
        }
        
        int len = list.size();
        
        Map<String, Boolean> entries = new HashMap<String, Boolean>();//标记,一个目录名是否已经添加到myData中

        for (int i = 0; i < len; i++) {//遍历所有匹配的Activity
            ResolveInfo info = list.get(i);
            CharSequence labelSeq = info.loadLabel(pm);//取得label数据
            String label = labelSeq != null
                    ? labelSeq.toString()
                    : info.activityInfo.name;//有就用label,没有就用Activity名
            
            if (prefixWithSlash.length() == 0 || label.startsWith(prefixWithSlash)) {//查找prefixPath路径的下一级
                
                String[] labelPath = label.split("/");

                String nextLabel = prefixPath == null ? labelPath[0] : labelPath[prefixPath.length];//取得下一层文件夹或者文件名

                if ((prefixPath != null ? prefixPath.length : 0) == labelPath.length - 1) {//如果是Activity
                    addItem(myData, nextLabel, activityIntent(
                            info.activityInfo.applicationInfo.packageName,
                            info.activityInfo.name));
                } else {//如果是目录
                    if (entries.get(nextLabel) == null) {//如果没有添加过该目录则添加
                        addItem(myData, nextLabel, browseIntent(prefix.equals("") ? nextLabel : prefix + "/" + nextLabel));
                        entries.put(nextLabel, true);//标记已添加
                    }
                }
            }
        }

        //排序
        Collections.sort(myData, sDisplayNameComparator);
        
        return myData;
    }

    //排序算法,按Map中title的字典顺序排序
    private final static Comparator<Map<String, Object>> sDisplayNameComparator =
        new Comparator<Map<String, Object>>() {
        private final Collator   collator = Collator.getInstance();

        public int compare(Map<String, Object> map1, Map<String, Object> map2) {
            return collator.compare(map1.get("title"), map2.get("title"));
        }
    };

    //创建一个包名+类名的Intent,用以启动该Activity
    protected Intent activityIntent(String pkg, String componentName) {
        Intent result = new Intent();
        result.setClassName(pkg, componentName);
        return result;
    }
    
    //创建一个Intent,将路径存入Extra,用以生成下一级目录,将启动的是本类的一个新实例
    protected Intent browseIntent(String path) {
        Intent result = new Intent();
        result.setClass(this, ApiDemos.class);
        result.putExtra("com.example.android.apis.Path", path);
        return result;
    }

    //保存一组数据
    protected void addItem(List<Map<String, Object>> data, String name, Intent intent) {
        Map<String, Object> temp = new HashMap<String, Object>();
        temp.put("title", name);
        temp.put("intent", intent);
        data.add(temp);
    }

    @Override
    @SuppressWarnings("unchecked")
    //重写ListActivity的方法,响应点击事件
    protected void onListItemClick(ListView l, View v, int position, long id) {
        Map<String, Object> map = (Map<String, Object>)l.getItemAtPosition(position);//取得被选中的行的数据源

        Intent intent = (Intent) map.get("intent");//取得数据源中的intent
        startActivity(intent);//激活该intent
    }
}

 转载自：http://hi.baidu.com/anko1988/item/bf66a501a2c24af0a01034d7