学习Android闹钟源代码(三)－AlarmClock类分析(part1)

android的时钟，也就是闹钟应用，从桌面的widget直接点进去的会打开AlarmClock这个Activity.

好像我平常都不上图的，今天就上两张图先。

一张是应用界面图如下：(改天再上传了，好像今天osc服务器有问题啊）

 

一，初看：

 总共有10个方法，加一个CursorAdapter的子类的内部类。

 其中的10个方法如下：

private void updateAlarm(boolean enabled,Alarm alarm);

public boolean onContextItemSelected(final MenuItem item);

@Override
protected void onCreate(Bundle icicle);

private void updateLayout();

private void addNewAlarm();

private void onDestory();

public void onCreateContextMenu(ContextMenu menu,View view,
                                ContextMenuInfo menuInfo);

public boolean onOptionsItemSelected(MenuItem item);

public boolean onCreateOptionsMenu(Menu menu);

public void onItemClick(AdapterView parent,View v int pos,long id);

上面的方法很多都我们比较熟悉的方法吧，呵呵，那就从比较熟悉的方法开始吧。

（1） 也就是onItemClick()方法，代码如下：

 @Override
    public void onItemClick(AdapterView parent, View v, int pos, long id) {
        final Cursor c = (Cursor) mAlarmsList.getAdapter()
                .getItem(pos);
        final Alarm alarm = new Alarm(c);
        Intent intent = new Intent(this, SetAlarm.class);
        intent.putExtra(Alarms.ALARM_INTENT_EXTRA, alarm);
        startActivity(intent);
    }

AlarmClock使用一个ListView加＋CursorAdapter来显示所有创建的闹钟。

当点击某一个闹钟时，它将进入到闹钟的设置界面去：

上面的代码的作用很显然，

先是所点击闹钟的对应的Cursor对象，然后

通过Alarm类的构造方法，通过Cursor构造了一个Alarm实例。

Alarm类实现了Parcle,我们可以暂时将它只想像为一个实体类，pojo之类的。

后面将详细分析，或者你现在就去看看呗。呵呵。

然后，new出了Intent，将Alarm类作为额外数据传递过去。上面还出现了Alarms类，

其实你可以暂时把Alarms类想像为Java Web开发经常用到的名字dao类,对了你就可以这样想Alarms=AlarmDao

呵呵。

然后它就启动了SetAlarm这个Activity.

好了这个方法的任务完成。

 

（2）onCreateOptionsMenu()方法

当你按下Menu键时，就会调用这个方法，代码如下;

@Override
    public boolean onCreateOptionsMenu(Menu menu) {
        getMenuInflater().inflate(R.menu.alarm_list_menu, menu);
        return super.onCreateOptionsMenu(menu);
    }

代码很简单两行，

第一行：获得菜单构造器，然后通过R.menu.alarm_list_menu菜单资源文件构造菜单。

第二行：子类应用父类的基本实现。

默认实现中将以标准的系统菜单项来填充menu，他们被归为CATEGORY_SYSTEM组，所以他们会以应用定义菜单项正确的排列。

 

（3）onOptionsItemSelected()

代码如下：

    @Override
    public boolean onOptionsItemSelected(MenuItem item) {
        switch (item.getItemId()) {
            case R.id.menu_item_settings:
                startActivity(new Intent(this, SettingsActivity.class));
                return true;
            case R.id.menu_item_desk_clock:
                startActivity(new Intent(this, DeskClock.class));
                finish();
                return true;
            case R.id.menu_item_add_alarm:
                addNewAlarm();
                return true;
            case android.R.id.home:
                finish();
                return true;
            default:
                break;
        }
        return super.onOptionsItemSelected(item);
    }

事实在应用中，按下Menu键时，只看到了[设置]这一菜单项。看下资源文件如下：

<menu xmlns:android="http://schemas.android.com/apk/res/android">
    <item android:id="@+id/menu_item_add_alarm"
        android:title="@string/add_alarm"
        android:icon="@drawable/ic_menu_add"
        android:showAsAction="always"/>
    <item android:id="@+id/menu_item_settings"
        android:title="@string/settings"
        android:icon="@android :drawable/ic_menu_preferences"
        android:showAsAction="never"/>
</menu>

注意到android:showAsAction＝“always“

所以，这个菜单在ActionBar中显示了。

注意到 android.R.id.home这个是android4中内置的用于返回的menuItem吗？需要更多了解。

 

另外重要的一项R.id.menu_item_add_alarm就是添加闹钟了。它是作为ActionBar中的Action一直在显示。也是我们将主要关注的。

addNewAlarm();这个方法如下：

 private void addNewAlarm() {
        startActivity(new Intent(this, SetAlarm.class));
 }

简单到不能再简单了，启用闹钟设置界面。

 

（4）onCreateContextMenu()

ContextMenu顾名思义就是上下文菜单，在桌面应用中，我们也许叫做右键菜单。在android中一般是

通过长按来触发的菜单。

 @Override
    public void onCreateContextMenu(ContextMenu menu, View view,
            ContextMenuInfo menuInfo) {
        // 从资源文件中上构造菜单Inflate the menu from xml.
        getMenuInflater().inflate(R.menu.context_menu, menu);
         
        // 使用当前项来创建一个自定义view来作为头
        // Use the current item to create a custom view for the header.
        final AdapterContextMenuInfo info = (AdapterContextMenuInfo) menuInfo;
   // 获得当前项对应Curosr，通过Cursor构造Alarm对象
        final Cursor c =
                (Cursor) mAlarmsList.getAdapter().getItem(info.position);
        final Alarm alarm = new Alarm(c);

        // 构造Calendar对象来计算时间
        // Construct the Calendar to compute the time.
        final Calendar cal = Calendar.getInstance();
        cal.set(Calendar.HOUR_OF_DAY, alarm.hour);
        cal.set(Calendar.MINUTE, alarm.minutes);
         // 将时间格式化为所需要字符串 
        final String time = Alarms.formatTime(this, cal);
        // 构造自定义View，并为每一个TextView设置显示文本 。
        // Inflate the custom view and set each TextView's text.
        final View v = mFactory.inflate(R.layout.context_menu_header, null);
        TextView textView = (TextView) v.findViewById(R.id.header_time);
        textView.setText(time);
        textView = (TextView) v.findViewById(R.id.header_label);
        textView.setText(alarm.label);

   // 在菜单中设置自定义头
        // Set the custom view on the menu.
        menu.setHeaderView(v);
//根据闹钟状态，来更改所显示的文本 
        // Change the text based on the state of the alarm.
        if (alarm.enabled) {
            menu.findItem(R.id.enable_alarm).setTitle(R.string.disable_alarm);
        }
    }

代码比较简单，而且我也已经在代码中注释了，也保留了原本的英文注释。呵呵，我基本只是翻译呢。

现在再把context_menu_header的布局代码贴在下面，以让大家加深理解：

<LinearLayout
    xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    android:paddingTop="6dip"
    android:paddingBottom="9dip"
    android:paddingLeft="10dip"
    android:paddingRight="10dip">

    <ImageView
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_gravity="top"
        android:paddingTop="6dip"
        android:paddingRight="10dip"
        android:src="@drawable/ic_dialog_time"/>

    <TextView android:id="@+id/header_time"
        style="?android:attr/textAppearanceLarge"
        android:layout_width="wrap_content"
        android:layout_height="match_parent"
        android:singleLine="true"
        android:gravity="center_vertical"
        android:ellipsize="none"/>

    <TextView android:id="@+id/header_label"
        style="?android:attr/textAppearanceLarge"
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        android:layout_marginLeft="20dip"
        android:singleLine="true"
        android:gravity="right|center_vertical"
        android:ellipsize="end"/>

</LinearLayout>

(5）这一个自然就是,onContextItemSelected

代码如下有点长，但是还算比较清晰吧：

 @Override
    public boolean onContextItemSelected(final MenuItem item) {
        final AdapterContextMenuInfo info =
                (AdapterContextMenuInfo) item.getMenuInfo();
        final int id = (int) info.id;
        // Error check just in case.
        if (id == -1) {
            return super.onContextItemSelected(item);
        }
        switch (item.getItemId()) {
            case R.id.delete_alarm: {
                // Confirm that the alarm will be deleted.
                new AlertDialog.Builder(this)
                        .setTitle(getString(R.string.delete_alarm))
                        .setMessage(getString(R.string.delete_alarm_confirm))
                        .setPositiveButton(android.R.string.ok,
                                new DialogInterface.OnClickListener() {
                                    public void onClick(DialogInterface d,
                                            int w) {
                                        Alarms.deleteAlarm(AlarmClock.this, id);
                                    }
                                })
                        .setNegativeButton(android.R.string.cancel, null)
                        .show();
                return true;
            }

            case R.id.enable_alarm: {
                final Cursor c = (Cursor) mAlarmsList.getAdapter()
                        .getItem(info.position);
                final Alarm alarm = new Alarm(c);
                Alarms.enableAlarm(this, alarm.id, !alarm.enabled);
                if (!alarm.enabled) {
                    SetAlarm.popAlarmSetToast(this, alarm.hour, alarm.minutes,
                            alarm.daysOfWeek);
                }
                return true;
            }

            case R.id.edit_alarm: {
                final Cursor c = (Cursor) mAlarmsList.getAdapter()
                        .getItem(info.position);
                final Alarm alarm = new Alarm(c);
                Intent intent = new Intent(this, SetAlarm.class);
                intent.putExtra(Alarms.ALARM_INTENT_EXTRA, alarm);
                startActivity(intent);
                return true;
            }

            default:
                break;
        }
        return super.onContextItemSelected(item);
    }

首先是从菜单项对象中获得AdapterContextMenuInfo类对象实例info

然后通过这个info获得Alarm实例id

然后做了个以防万一的错误检查。

接着对item的id值做了switch.

   情况1 :用户选择了删除此闹钟

      弹出一个对话框，让用户确定是否删除。如果用户确定删除。

     调用Alarms.deleteAlarm(context,id)删除。

   情况2：用户选择了启用/停用闹钟

     通过info获得position值从而从list的Adpater中获得对应的Cursor对象。

     通过Cursor构造Alarm对象。

     更新闹钟状态 Alarms.enableAlarm(this,alarm.id,!alarm.enabled)

     如果闹钟之前是停用状态，那么弹出一个Toast，告诉用户闹钟什么时候会响。

    情况3：用户选择了编辑些闹钟

        构造出闹钟对应的Alarm对象。

      然后启动闹钟设置界面，并将此Alarm作为Intent的额外参数传递。

  

到这里，文章也够长了，，对于这个类有了一个基本的认识一些普通的代码分析到这里。

其它方法的分析还是另外写一篇吧。