Android文档阅读06—入门指引之笔记本1

  许可协议:creativecommons licenses

 

记事本练习 1

 

在这个练习中,你将要创建一个简单的记事本列表,用户可以添加新的记事但是不能编辑他们。这个练习示范了如下内容:

 

列表活动创建并操作菜单项的基本知识。怎样在SQLite数据库中存取记事。怎样将数据绑定到一个使用了数组适配器的列表视图(最简单的一种绑定到列表视图的方式)。关于屏幕布局,包括怎样布局一个列表视图,怎样将一个项目加入活动的菜单,活动是怎样操作那些菜单选择,这些内容的基础知识。 [Exercise 1] [Exercise 2] [Exercise 3] [Extra Credit]

Step 1

第一步 在Eclipse中打开Notepadv1项目。

 

Notepadv1项目是一个起点,它关注一些样板性的工作,如果你完成了Hello Android教程,那么你就曾经见过它们。

 

右击包资源管理器,选择把.../General/Existing Projects导入到工作区。按浏览键,转到你拷贝的那三个练习所在的文件夹,选择Notepadv1然后点OK。你应该看到Notepadv1列在项目表中,并且有个检查标记在它旁边,点完成。练习项目应该已经打开。如果AndroidManisfest.xml 或者Android zip 文件有什么错误,右击项目然后选择Android Tools->Fix Project Properties(项目在错误的路径里查找库文件,上面的操作会替你修复它)。

Step 2

 

访问和修改数据

在这个练习中,我们仅打算直接用SQLite 数据库来存储我们的数据,但是在一个实际的应用程序中,也许写一个合适的内容提供器(Content Provider)来封装这个行为会更好。

如果你感兴趣,你可以找到更多关于内容提供器或者介绍存储,查找,显示数据的整个主题。

 

看一下DBHelper类-它用来封装对SQLite数据库的数据访问,这个数据库将保存我们的记事本数据并且允许我们更新它。

通常你将利用一个内容提供器来实现,事实上在SDK中包含的那个完整的记事本程序确实实现了这样一个 ContentProvider。不管怎样,没理由不让你直接用自己的SQLite数据,像我们在这里做的一样。最主要的事是注意这个类是怎样为我们存储,查找,更新SQLite数据库中的数据。对于查找行,基于行id查找,创建新行,删除已存在的行和更新一行,这里有一些方法。如果你想迅速了解如何在你的程序中使用SQLite数据库的基础知识,或者看一下这个例子中的类,或者更好的,看一下完整的记事本应用程序。它在SDK的samples/目录中,作为一个使用ContentProvider的例子。

Step 3

 

布局和活动

大多数活动会有一个相联系的布局。布局是活动对用户的直观表现。在这个例子中,我们的布局将占据整个屏幕并提供一个记事列表。

全屏的布局并不是活动的唯一选择。你也许想知道如何用浮动布局(例如,对话框或者警告),或者也许你完全不需要一个布局(这类活动对用户将是不可见的,除非你为它指定了某种布局)

 

打开res/layout中的notepad_list.xml文件,看一下:

这是一个布局定义文件,其中包含了默认的起始项。我们提供这些,是为了便于你迅速开始

a.所有的Android布局文件必须以XML头为开始:<?xml version="1.0" encoding="utf-8"?>
b.同样,下一条定义通常(但不完全)是一个某种类的布局定义,在这个例子中是LinearLayout.
c.Android的XML名字空间应该总是定义在xml文件中组件或布局的最上级,这样标签"android:"才能用在文件的其余部分:

xmlns:android="http://schemas.android.com/apk/res/android"

 Step 4

我们需要创建一个布局来容纳我们的列表。在LinearLayout标签中添加代码,使得这个文件看起来像下面的样子:(你得敲Source tab按钮来编辑XML文件)

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="wrap_content"
    android:layout_height="wrap_content">

  <ListView id="@id/android:list"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"/>
  <TextView id="@id/android:empty"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="@string/no_notes"/>

</LinearLayout>

 

 


  • ListView 和TextView可以看做是两个替代的视图,同一时间只有一个可以被显示。ListView可以用在有记事要显示的时候,而TextView(有一个“No Notes Yet!”的字符串资源作为默认值会在没有任何记事的时候显示)。
  • ListView和TextView的id字串中有一个“@”符号,它的意思是XML解释器应当解析并且展开id字串的剩余部分并且利用ID资源。
  • android:list和android:empty是Android平台已经提供给我们的ID,android:empty在list adapter中没有数据时自动提供。List Adapter默认的搜索这些名字。作为替代,你也可以用setEmptyView();更广泛的,Android.R类是平台提供的预定义资源的集合,你项目中的R类是在你项目中预定义的资源集合。在资源类android.R中出现的资源可以通过android:名字空间前缀在XML文件中使用。

Step 5

 

资源和R类

在Eclipse项目res/下的文件夹很特殊。在这个文件夹下的子文件夹和文件有特定的结构。

尤其,定义在这些文件夹和文件里的资源会在R类中有相应的入口。这样你的程序就可以轻松的访问到这些资源。更进一步的,它们会被绑定,作为程序的一部分。

 

要产生一个列表视图,我们需要定义表中各行的显示:

  • 在res/layout下创建一个名为notes_row.xml的文件
  • 添加如下的内容(注:xml头又一次被用到了,并且第一个节点定义了Android xml名字空间)
<?xml version="1.0" encoding="utf-8"?>
<TextView id="@+id/text1"
    xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="wrap_content"
    android:layout_height="wrap_content"/>

 

  • 每一行的标题将用到这个视图-它仅有一个文字区域。
  • 在这个例子中,我们创建了一个叫text1的新id。在id字串中+号跟在@号之后,显示了这个id如果不存在,则应当自动创建。因此我们定义了一个悬空的text1,然后使用它。
  • 保存文件后,打开项目中的R.java类,你应该看到notes_row和text1的新定义(我们的新定义),这意味着,我们可以从我们的代码中获得访问。

Step 6


然后,打开源码中的Notepadv1类。我们将要替换这个类,成为列表适配器来显示我们的记事,同时允许我们添加新的记事。

Notepadv1将成为Activity的一个子类,称为ListActivity,它拥有一些适合做与列表相关的额外功能,例如:在屏幕上按行显示列表项的数字,在列表项中移动,允许他们被选择。

看一下Notepadv1类中的现有代码。在最上面有一些常量定义,接着的私有区域里我们将创建数字形式的记事标题,并且还有一些从超类重载的方法。

 Step 7


将Notepadv1的父类从Activity改为ListActivity:

public class Notepadv1 extends ListActivity

注:你必须用Eclipse把ListActivity导入到Notepadv1类中,在Windows或Linux按crtl-shift-O,或者在Mac下按cmd-shift-O。

Step 8

这里定义了三个重载方法:onCreate,onCreateOptionsMenu和onOptionsItemSelected,我们把需要的内容详细说明一下:

  • onCreate()在活动开始的时候被调用-它有一点像activity的"main"方法。我们用这个函数在活动运行的时候为它设置资源和状态。
  • onCreateOptionsMenu()用来为活动产生一个菜单。当使用者点击menu按钮的时候,它会显示,并且有一列可以选择的选项(像“Create Note”)
  • onOptionsItemSelected()是菜单等式中(菜单处理过程)的另一半,它用来处理由菜单产生的事件(例如.当用户选择了“Create Note”选项)

Step 9

详细说明onCreate()方法的主体。

在这儿,我们将要为活动设定一个名称(显示在屏幕的最上面),利用我们先前为活动创建的notepad_list布局来显示内容,建立DBHelper实例来访问记事数据,然后产生带有有效记事标题的列表:

  1. 在我们的方法中,调用带有icicle参数的super()函数
  2. setContentView到R.layout.notepad_list
  3. 在类中新建一个叫dbHelper的私有域,它是DBHelper的实例(在OnCreate 方法之前)
  4. 回到onCreate方法,新建一个DBHelper实例-assign到dbHelper区域(注,你必须为DBHelper的构造函数传递一个this参数)
  5. 最后,调用一个新方法-fillData()-利用helper获取并产生数据,我们现在还没有定义这个函数。
  6. onCreate()函数应该像这样:
@Override
   public void onCreate(Bundle icicle)
   {
       super.onCreate(icicle);
       setContentView(R.layout.notepad_list);
       dbHelper = new DBHelper(this);
       fillData();
   }

 

记住添加DBHelper的定义(在noteNumber定义的下面):

 private DBHelper dbHelper;

Step 10

 

菜单的更多解释

我们构建的记事本程序仅仅涉及了菜单的表面。

你可以为菜单项添加快捷键,创造子菜单甚至将菜单添加到别的应用程序中

onCreateOptionMenu()方法的主体

我们现在要添加一个菜单项,“Add Item”,它会用到我们在strings.xml中创建的字符串,并且用到一个常量定义,这个常量我们在类的顶部创建来标志Add项的操作。

  1. 在strings.xml资源中(在res/values下),为menu_insert添加一个新的字符创“Add Item”<string name="menu_insert">Add Item</string>,然后保存文件
  2. 同时,你需要在Notepadv1类的顶部定义一个菜单位置常量(在KEY_BODY的定义下面)public static final int INSERT_ID=Menu.FIRST;
  3. 在onCreateOptionsMenu()方法中,添加一个菜单项。同时注意super调用的返回值结果。整个方法应该看起来像下面的样子:
@Override
   public boolean onCreateOptionsMenu(Menu menu) {
       boolean result = super.onCreateOptionsMenu(menu);
       menu.add(0, INSERT_ID, R.string.menu_insert);
       return result;
   }

 

Step 11

onOptionsItemSelected()方法:

这个方法将要处理我们新的“添加记事”菜单项。当选中这个菜单项时,onOptionsItemSelected()方

法就将被调用,同时item.getId()的值会被设为INSERT_ID(我们用这个常量来标志菜单项)。我们能

检查这个,然后选择适当的动作:

  1. super.onOptionsItemSelected(item)方法出现在这个方法的最后-我们想要先抓取我们的事件!
  2. 在item.getId()上的选择语句。
  3. INSERT_ID项。
  4. 调用新方法createNote()
  5. 在case的结尾用break
  6. 在结束的时候返回超类onOptionsItemSelected()方法的返回值
  7. 整个onOptionsItemSelect()方法看起来应该如下:
@Override
   public boolean onOptionsItemSelected(Item item) {
       switch (item.getId()) {
       case INSERT_ID:
           createNote();
           break;
       }
      
       return super.onOptionsItemSelected(item);
   }

 

 Step 12

添加一个createNote()方法:在我们应用程序的这个第一版里,createNote()不会很有用。我们只是简单的创建一个带有标题的记事,

这个标题被赋值为(“Note1”,“Note2”。。。)这类基于计数的东东,但是记事的内容为空。现在我

们还不能修改记事的内容,所以我们现在只能满足于一些默认值:

  1. String noteName="Note"+noteNumber++;(用“Note”来构造名字并且用到我们已经在类中定义过的计数器)
  2. 调用dbHelper.createRow(),使用noteName作为标题,“”为内容
  3. 在添加之后再调用一次fillData()方法(一个低效但是简单的方法)
  4. 整个createNote()方法看起来应该像这样:
private void createNote() {
       String noteName = "Note " + noteNumber++;
       dbHelper.createRow(noteName, "");
       fillData();
   }

 Step 13

 

列表适配器

我们的例子使用了一个非常简单的数组适配器,它将一个项目的数组或列表添加至列表视图。在Android中更常见的是,列表适配器和ContenProviders一起运行,并且这也是列表的一种非常简单的用法。

将ContentProvider捆绑至ListView,你可以用android.widget.SimpleCursorAdapter。

 

定义fillData()方法。这个方法很长:

这个方法使用了ArrayAdapter,它是将数据放入ListView的最简单方法。ArrayAdapter读取一个列表或者字串数组,并且将他们绑定到一个文本视图,在布局中提供了这个为列表行定义的文本视图(在我们的notes_row.xml布局文件中的text1域)。这个方法简单的从database helper中获取一列记事,利用从每行得到的标题字串构造了一个字符串列表,然后通过这些items创建一个ArrayAdapter,并使用我们定义过的notes_row

  1. 数组适配器需要一个字符串列表(List<String>)来包含要显示的。
  2. 数据从数据库中按行读出,每行的标题域用来产生字符串列表。
  3. 我们指定notes_row视图,作为数据容器。
  4. 如果有关于未找到类的错误,ctrl-shift-O(在mac上用cmd-shift-O)来组织导入。

注:在这个练习中我们使用了ArrayAdapter,这并不是好的解决方案,更典型的,一个SimpleCursorAdapter应该和ContenProvider一起用或者至少是一个从查询返回的Cursor。看侧边的列表适配器获得更多信息。

Step 14

运行!

  1. 右击Notepadv1项目
  2. 在弹出菜单中,选择Run As->Android Application
  3. 如果你看见出现一个对话框,选择Android Launcher的方式去运行程序(你同样可以用对话框顶部的链接,把这个设置为你工作空间的默认属性,推荐这样做,它可以避免插件每次都询问你同样的问题)
  4. 单击菜单按钮,选择Add Item 来添加记事

 Solution and Next Steps


方案和下一步

你可以在zip文件Notepadv1Solution中找到这个类的解决方案,对照一下你自己的。一旦你准备好,继续入门指引练习2为程序添加新建,编辑删除记事的能力。返回入门指引首页。

  • 0
    点赞
  • 0
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值