实现基于Android的英文电子词典

     英文词典是手机中经常使用的应用。因此，在本文将结合Android来讨论如何实现一个Android版的英文词典。实现英文词典的方法很多。在本文使用了SQLite数据库来保存英文单词信息。系统通过SQLite数据库中保存的单词信息来查找到与指定英文对应的中文信息。当然，实现这样一个英文词典需要解决一系列技术问题。例如，如何将保存英文单词信息的数据库文件随程序（apk文件）一起发布；发布后如何打开数据库；如何在输入前几个字母后，在AutoCompleteTextView组件提示列表中显示以所输入字符串开头的所有单词。在本章将逐渐给出这些问题的详细答案。关于本文实现的英文电子词典的完整代码请读者参本文提供的源代码。

实现电子词典要解决的技术问题及初步的解答 
   在本节将给出实现电子词典需要解决的主要技术问题，并给出这些技术问题的初步答案或提示。关于详细的答案和代码请读者参阅本文后面的内容。

   主要技术问题及解答如下：

     1. 如何将SQLite数据库（dictionary.db文件）与apk文件一起发布？

解答：可以将dictionary.db文件复制到Eclipse Android工程中的res aw目录中，如图1所示。所有在res aw目录中的文件不会被压缩，这样可以直接提取该目录中的文件。

2. 如何将打开res aw目录中的数据库文件？

解答：在Android中不能直接打开res aw目录中的数据库文件，而需要在程序第一次启动时将该文件复制到手机内存或SD卡的某个目录中，然后再打开该数据库文件。复制的基本方法是使用getResources().openRawResource方法获得res aw目录中资源的InputStream对象，然后将该InputStream对象中的数据写入其他的目录中相应文件中。在Android SDK中可以使用SQLiteDatabase.openOrCreateDatabase方法来打开任意目录中的SQLite数据库文件。

3.如果在AutoCompleteTextView组件中输入两个及以上字母时显示以所输入字符串开头的所有单词列表？

解答：AutoCompleteTextView所使用的Adapter是一个自定义的Adapter类，类的结构如下：

1. public class DictionaryAdapter extends CursorAdapter
   
2. {
   
3. ... ...
   
4. }

复制代码

要注意的是，不能将整个数据库中的单词都查出，然后生成一个Adapter对象再使用setAdapter方法来设置AutoCompleteTextView组件的Adapter对象。AutoCompleteTextView组件不会为我们筛选以某个字符串开头的单词。这些工作需要开发人员通过编码来实现。 基本思路是在AutoCompleteTextView类的afterTextChanged事件中监视AutoCompleteTextView组件中字符的输入情况，每当输入一个字符时就生成一个Adapter对象，然后将新生成的Adapter对象与AutoCompleteTextView关联。显示以输入字符串开头的单词列表的效果如图2所示。


复制并打开保存英文单词的数据库文件

在本文实现的英文词典中使用openDatabase方法来打开数据库文件（该文件在SD卡的dictionary目录中，因此，要想运行本文实现的英文词典，需要在手机或模拟器中需要安装SD卡）。如果该文件不存在，系统会自动创建/sdcard/dictionary目录，并将res aw目录中的dictionary.db文件复制到/sdcard/dictionary目录中。openDatabase方法的实现代码如下：

1. private SQLiteDatabase openDatabase()
   
2.         {
   
3.                 try
   
4.                 {
   
5.                         // 获得dictionary.db文件的绝对路径
   
6.                         String databaseFilename = DATABASE_PATH + "/" + DATABASE_FILENAME;
   
7.                         File dir = new File(DATABASE_PATH);
   
8.                         // 如果/sdcard/dictionary目录中存在，创建这个目录
   
9.                         if (!dir.exists())
   
10.                                 dir.mkdir();
    
11.                         // 如果在/sdcard/dictionary目录中不存在
    
12.                         // dictionary.db文件，则从res
    
13. aw目录中复制这个文件到
    
14.                         // SD卡的目录（/sdcard/dictionary）
    
15.                         if (!(new File(databaseFilename)).exists())
    
16.                         {
    
17.                                 // 获得封装dictionary.db文件的InputStream对象
    
18.                                 InputStream is = getResources().openRawResource(
    
19.                                                 R.raw.dictionary);
    
20.                                 FileOutputStream fos = new FileOutputStream(databaseFilename);
    
21.                                 byte[] buffer = new byte[8192];
    
22.                                 int count = 0;
    
23.                                 // 开始复制dictionary.db文件
    
24.                                 while ((count = is.read(buffer)) > 0)
    
25.                                 {
    
26.                                         fos.write(buffer, 0, count);
    
27.                                 }
    
28. 
    
29.                                 fos.close();
    
30.                                 is.close();
    
31.                         }
    
32.                         // 打开/sdcard/dictionary目录中的dictionary.db文件
    
33.                         SQLiteDatabase database = SQLiteDatabase.openOrCreateDatabase(
    
34.                                         databaseFilename, null);
    
35.                         return database;
    
36.                 }
    
37.                 catch (Exception e)
    
38.                 {
    
39.                 }
    
40.                 return null;
    
41.         }
    

复制代码

在 openDatabase 方法中使用了几个常量，这些常量是在程序的主类（ Main ）中定义的，代码如下：

1. public class Main extends Activity implements OnClickListener, TextWatcher
   
2. {
   
3.         private final String DATABASE_PATH = android.os.Environment
   
4.                         .getExternalStorageDirectory().getAbsolutePath()
   
5.                         + "/dictionary";
   
6.         private AutoCompleteTextView actvWord;
   
7.         private final String DATABASE_FILENAME = "dictionary.db";
   
8.         ...........
   
9. }

复制代码

查询单词 
   英文词典的核心就是查找英文单词的中文意思。在查找中文意思之前，首先需要使用openDatabase方法在Main类的onCreate方法中打开SQLite数据库，代码如下： database = openDatabase(); 其中database是在Main类中定义的SQLiteDatabase类型变量。 然后在查找按钮的单击事件中添加如下的代码来查找英文单词，并显示中文意思。

1. public void onClick(View view)
   
2.         {
   
3.                 String sql = "select chinese from t_words where english=?";                
   
4.                 Cursor cursor = database.rawQuery(sql, new String[]
   
5.                 { actvWord.getText().toString() });
   
6.                 String result = "未找到该单词.";
   
7.                 //  如果查找单词，显示其中文的意思
   
8.                 if (cursor.getCount() > 0)
   
9.                 {
   
10.                         //  必须使用moveToFirst方法将记录指针移动到第1条记录的位置
    
11.                         cursor.moveToFirst();
    
12.                         result = cursor.getString(cursor.getColumnIndex("chinese"));
    
13.                 }
    
14.                 //  显示查询结果对话框
    
15.                 new AlertDialog.Builder(this).setTitle("查询结果").setMessage(result)
    
16.                                 .setPositiveButton("关闭", null).show();
    
17. 
    
18.         }

复制代码

讲到这里我们应该了解一个dictionary.db中的t_words表的结果，该表只有两个字段：english和chinese。分别表示单词的英文和中文描述。如果要获得单词的中文描述，只需要查找chinese字段即可。如onClick方法中的代码所示。 查询单词的效果如图3所示。


如果显示以输入字符串开头的单词列表
虽然到目前为止，我们的英文词典已经可以正常工作了，但为了方便读者使用，在本节将添加单词输入的自动提示功能。也就是说，如果读者在AutoCompleteTextView组件中输入单词的前几个字母，该组件就会自动列出数据库中所有以该字符串开头的单词。效果如图2所示。拥有这样的功能就可以使用户在只知道单词的前几个字母时也可以查找到相应的单词。由于AutoCompleteTextView组件使用了自定义的Adapter类，下面先给出这个自定义的Adapter类的完整代码。

1. public class DictionaryAdapter extends CursorAdapter
   
2. {
   
3. 
   
4. private LayoutInflater layoutInflater;
   
5. 
   
6. public CharSequence convertToString(Cursor cursor)
   
7. {
   
8. 
   
9. return cursor == null ? "" : cursor.getString(cursor.getColumnIndex("_id"));
   
10. 
    
11. }
    
12. 
    
13. //用于将_id字段（也就是english字段）的值设置TextView组件的文本
    
14. 
    
15. //view参数表示用于显示列表项的TextView组件
    
16. 
    
17. private void setView(View view, Cursor cursor)
    
18. {
    
19. 
    
20. TextView tvWordItem = (TextView) view;
    
21. tvWordItem.setText(cursor.getString(cursor.getColumnIndex("_id")));
    
22. 
    
23. }
    
24. 
    
25. public void bindView(View view, Context context, Cursor cursor)
    
26. {
    
27. 
    
28. setView(view, cursor);
    
29. 
    
30. }
    
31. 
    
32. public View newView(Context context, Cursor cursor, ViewGroup parent)
    
33. {
    
34. 
    
35. View view = layoutInflater.inflate(R.layout.word_list_item, null);
    
36. 
    
37. setView(view, cursor);
    
38. 
    
39. return view;
    
40. 
    
41. }
    
42. 
    
43. public DictionaryAdapter(Context context, Cursor c, boolean autoRequery)
    
44. {
    
45. 
    
46. super(context, c, autoRequery);
    
47. 
    
48. //通过系统服务获得LayoutInflater对象
    
49. 
    
50. layoutInflater = (LayoutInflater) context.getSystemService(Context.LAYOUT_INFLATER_SERVICE);
    
51. }
    
52. 
    
53. }

复制代码

在编写DictionaryAdapter 类时应注意如下3 点：
1. 为了将Cursor对象与AutoCompleteTextView组件绑定， DictionaryAdapter类必须从CursorAdapter类继承。
2.由于CursorAdapter类中的convertToString方法直接返回了Cursor对象的地址，因此，在DictionaryAdapter类中必须覆盖convertToString方法，以返回当前选中的单词。CursorAdapter类中的convertToString方法的源代码。

1. public CharSequence convertToString(Cursor cursor)
   
2. {
   
3. 
   
4. //如果cursor不为null，返回Cursor对象的地址（cursor.toString（））
   
5. return cursor == null ? "" : cursor.toString();
   
6. 
   
7. }
   

复制代码

覆盖后的 convertToToString 方法的源代码如下：

1. public CharSequence convertToString(Cursor cursor)
   
2. {
   
3. 
   
4. return cursor == null ? "" : cursor.getString(cursor.getColumnIndex("_id"));
   
5. 
   
6. }

复制代码

这里要注意一下，当选中AutoCompleteTextView 组件中单词列表中某一个单词后，系统会用convertToString 方法的返回值来设置AutoCompleteTextView 组件中的文本。因此，必须使用Cursor 的getString 来获得相应的字段值。 


3.由于将Cursor对象与Adapter绑定时必须要有一个叫“_id”的字段，因此，在本例中将english字段名映射成了“_id”字段。为了监视AutoCompleteTextView组件中的文本输入情况，需要实现android.text.TextWatcher接口。在该接口中只需要实现afterTextChanged方法即可，代码如下：

1. public void afterTextChanged(Editable s)
   
2. {
   
3. //必须将english字段的别名设为_id
   
4. 
   
5. Cursor cursor = database.rawQuery(
   
6. 
   
7. "select english as _id from t_words where english like ?",
   
8. 
   
9. new String[]{ s.toString() + "%" });
   
10. 
    
11. DictionaryAdapter dictionaryAdapter = new DictionaryAdapter(this,cursor, true);
    
12. 
    
13. //actvWord是在Main类中定义的AutoCompleteTextView类型的变量
    
14. 
    
15. actvWord.setAdapter(dictionaryAdapter);
    
16. 
    
17. }

复制代码

从上面的代码中可以看到，在查询SQL 语句中的english 字段名的别名是“_id ”。


4.在DictionaryAdapter类中需要使用bindView和newView方法设置每一个列表项。bindView方法负责设置已经存在的列表项，也就是该列表项已经生成了相应的组件对象。而newView方法负责设置新的列表项，在该方法中需要创建一个View对象来显示当前的列表项。在本例中使用word_list_item.xml布局文件来显示每一个列表项，代码如下：

1. 
   
3.     android:id="@+id/tvWordItem"
   
4.     android:layout_width="fill_parent"
   
5.     android:layout_height="wrap_content"
   
6.     android:textAppearance="?android:attr/textAppearanceLarge"
   
7.     android:gravity="center_vertical"
   
8.     android:paddingLeft="6dip"
   
9.     android:textColor="#000"
   
10.     android:minHeight="?android:attr/listPreferredItemHeight"
    
11. />

复制代码

本文介绍了实现基于 Android 的英文词典的实现方法。


实现英文词典主要需要解决3个问题：如何将保存英文单词的SQLite数据库文件随同apk文件一起发布；
如何打开SD卡中的数据库文件；如何在AutoCompleteTextView组件显示以输入字符串开头的英文单词列表。在最后仍然要提一句的是在编写自定义DictionaryAdapter类时一定要覆盖contertToString方法，以便在用户选项某一个列表项时在AutoCompleteTextView组件中显示选中的单词，而不是Cursor对象地址。