Android SDK Simple 例程分析之 ApiDemos 的 ApiDemos.java 分析

      好想成为一个牛人，但是成为牛人太难了，需要一点一点的辛勤付出。最近在学习Android  应用程序编写，以前是搞C语言的，对JAVA这种面向对象的语言还是适应不过来，看了好多资料，下了好多例程，一边看一边学。感觉自己好笨，既然不知道下载官方SDK的时候，就自带了好多的例程（SDK文件夹内的sample文件夹），今天才知道，暗下决心，要把整个例程全部看懂。

      第一个例程为ApiDemos，如果看过的人知道，我走上了一条不归路这个例程名字看似简单，其实非常复杂，它几乎把SDK常用的东西全部罗列出来，一个小部分自称一个体系，占用一个.java。总共200多个，哎，硬着头皮看吧。

      首先找到mainfest.xml,找到avtivity的入口点，这是我第一次看到这么长的mainfest.xml（200多个Activity）,里面好多的android.intent.action.MAIN标识，入门教程告诉我这是主Activity，从这里作为入口研究。为什么这么多标识主Activity的呢？？？？不管了，先看代码。此时，找到了 ApiDemos.java 确定他就是主Activity。

      如果从来没有看过这种方案的代码，肯定会看的稀里糊涂，经过我的几个钟头奋战，终于搞清楚了来龙去脉，原来好多的Activity公用一套代码实现这套代码就是ApiDemos.java 。它是怎么做到的呢？？？原来他们利用了mainfest.xml里面Activity的 label项，label项都被定义成了String 类型，而这些String类型 都被定义在了res/values/string.xml中，并且形式种类全是路径的形式，例如“   <string name="activity_dialog">App/Activity/Dialog</string>”所以说 ApiDemos.java 就通过解析所有的Activity的label，把Activity给归类了一下，然后再显示出来。举个例子就像ApiDemos.java 这些代码，给这个例程做了个目录，目录还分好几层，就跟书的章节一样，最后一层就是详细的内容（这里最后一层就是Activity实例）。

       归纳一下上面说的，以前我们做个程序，如果这个程序有五个功能，我们一般会建立6个java文件，其中一个是个列表，用来指向5个功能。但是现在有200个功能，总不能第一个java文件依次列出200个选项，然后分别指向这200个功能吧。所以就在前面做了个目录，归类，最终导航到最终的Activity。

      下面分析一下代码（请自行找代码）。

     

 

上面的图片就是代码折叠后的总体情况，ApiDemos类继承了   ListActivity类，这里说明整个窗口就是由一个列表构成，没有其他的控件。

然后看 复写的onCreate方法：

 

 public void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
       
        Intent intent = getIntent();
        String path = intent.getStringExtra("com.example.android.apis.Path");
       
        if (path == null) {
            path = "";
        }

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

咋一看，有点蒙，怎么上来就getIntent呢？他不是第一个Activity么？

如果你看懂了我前面说的，你就会明白了，这个java文件不只是调用一次，要调用好多次的，第一次获得不到intent，第二次第三次就会获得到的。

接着setListAdapter，这个估计不用介绍，用第二个参数的LIST去填充这个窗口。这个list数据从哪来的呢？？就是getData的返回值。

 

下面看getdata函数，比较重要：

 protected List getData(String prefix) {
        List<Map> myData = new ArrayList<Map>();

             Intent mainIntent = new Intent(Intent.ACTION_MAIN, null);
        mainIntent.addCategory(Intent.CATEGORY_SAMPLE_CODE);

        PackageManager pm = getPackageManager();
        List<ResolveInfo> list = pm.queryIntentActivities(mainIntent, 0);

        if (null == list)
            return myData;

        String[] prefixPath;
       
        if (prefix.equals("")) {
            prefixPath = null;
        } else {
            prefixPath = prefix.split("/");
        }
       
        int len = list.size();
       
        Map<String, Boolean> entries = new HashMap<String, Boolean>();

        for (int i = 0; i < len; i++) {
            ResolveInfo info = list.get(i);
            CharSequence labelSeq = info.loadLabel(pm);
            String label = labelSeq != null
                    ? labelSeq.toString()
                    : info.activityInfo.name;
           
            if (prefix.length() == 0 || label.startsWith(prefix)) {
               
                String[] labelPath = label.split("/");

                String nextLabel = prefixPath == null ? labelPath[0] : labelPath[prefixPath.length];

                if ((prefixPath != null ? prefixPath.length : 0) == labelPath.length - 1) {
                    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;
    }

这函数还挺长的，我们依次分析。我们在源文件上做标记。

 protected List getData(String prefix) {
        List<Map> myData = new ArrayList<Map>();

        Intent mainIntent = new Intent(Intent.ACTION_MAIN, null);
        mainIntent.addCategory(Intent.CATEGORY_SAMPLE_CODE);

        PackageManager pm = getPackageManager();
        List<ResolveInfo> list = pm.queryIntentActivities(mainIntent, 0);

        到这里，不出意外，list里面已经充满了200多个activity的信息，自己可以查询一下各个函数的作用，这个ResolveInfo都有啥信息可用。

        if (null == list)
            return myData;

        String[] prefixPath;    
       // prefixPath 从全文看，它的作用就是标注当前路径
        if (prefix.equals("")) {             //第一次调用确实为空  所以当前路径就是  null
            prefixPath = null;
        } else {
            prefixPath = prefix.split("/");           //如果不为空，则把路径拆分，各个拆后的单词放在prefixPath中。
        }
       
        int len = list.size();
       
        Map<String, Boolean> entries = new HashMap<String, Boolean>();

        for (int i = 0; i < len; i++) {               //这里开始就是将近200次的循环，分别解析每个Activity，给他们归类
            ResolveInfo info = list.get(i);           
            CharSequence labelSeq = info.loadLabel(pm);
            String label = labelSeq != null
                    ? labelSeq.toString()
                    : info.activityInfo.name;                 //label=当前Activity的lable标记，我们现在假设这个标记是“App/Activity/Dialog”
            
            if (prefix.length() == 0 || label.startsWith(prefix)) {          //函数传进来的参数如果为空，或者这个参数和label的前半截相匹配
                
                String[] labelPath = label.split("/");       //把label分割，分割后就是labelPath={"App","Activity","Dialog"}

                String nextLabel = (prefixPath ==null ? labelPath[0] : labelPath[prefixPath.length]);   //执行这个后 nextLabel=”App“

                if ((prefixPath != null ? prefixPath.length : 0) == labelPath.length - 1) {  //如果这是个最终极的真正的Activity，就走if里面
                    addItem(myData, nextLabel, activityIntent(
                            info.activityInfo.applicationInfo.packageName,
                            info.activityInfo.name));
                } else {      //如果当前路径还是 "App","Activity 不是  Dialog这种的，走else

                    if (entries.get(nextLabel) == null) {   //如果还没添加过
                        addItem(myData, nextLabel, browseIntent(prefix.equals("") ? nextLabel : prefix + "/" + nextLabel));

                         //在这里，相当于调用addItem(myData,"App",一个intent);
                        entries.put(nextLabel, true);
                    }
                }
            }
        }

大家想象一下，经过200多次的for循环，最终结果就是把所有的Activity的label的顶层目录给摘出来了，并且添加到myData中，返回给上层，最顶层的界面就做好了，在模拟器上运行就是最上层的list，特别像一本书的第一页“第一章，第二章，第三章”

当第一层界面生成好以后，你用手去点屏幕上的第一个item，“App”，这时候，监听器onListItemClick起作用，再次去重复调用onCreate方法，这时方法中的“com.example.android.apis.Path”已经在一个角落里面被赋值了，赋的就是“App”。再调用getData("App")，再在200多次的FOR循环中，找到Activity的label，首先去匹配顶层是不是“App”，如果是，遍历所有Activity找出所有类型为“App/???”的label，然后再ADDitem，然后再返回，显示出来。

当点到最后一层的时候，在for循环汇中，就会走另一个Additem，这时候增加的键值对的intent就是指向真正Avtivity。

 

说的有些乱，但是你理解了意思以后，再看程序，绝对事半功倍。

 

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

还有一些附加的方法就不解释了，因为太简单了。

通过学习这个java文件，我们掌握了一种处理多Activity的一种方法，那就是用过Activity的Label命名，给Activity分门别类，用一个java文件，就能自动获取所需要参数，全自动构建列表菜单。能够节省大量的人力物力。