Android 下 ListView 的使用

本论坛将全面搬家到：http://www.cnblogs.com/91program，请大家以后来这里看看。

ListView 的使用比我想像中的要麻烦很多，所以有必要记录下来。

首先在界面拖放一个 ListView 控件，生成的 XML 如下所示：

<ListView
    android:id="@+id/listView1"
    android:layout_width="match_parent"
    android:layout_height="wrap_content" >
</ListView>

ListView 每个子项显示需要与 Adapter 配合，这对于我来说不太好理解。
每个 ListView 子项需要格式说明，其 XML 如下(文件名是: my_mp3filelist.xml, 在后继的代码中要使用的)：

<LinearLayout
	android:layout_width="fill_parent"
	xmlns:android="http://schemas.android.com/apk/res/android"
	android:orientation="vertical"
	android:layout_height="wrap_content"
	android:id="@+id/my_mp3filelist"
	android:paddingBottom="3dip" >
	
	<TextView
		android:layout_height="wrap_content"
		android:layout_width="fill_parent"
		android:id="@+id/ItemTitle"
		android:textSize="30dip">
	</TextView>


	<TextView
		android:layout_height="wrap_content"
		android:layout_width="fill_parent"
		android:id="@+id/ItemText">
	</TextView>
	
</LinearLayout>

以上，ListView 的准备就绪了。接下来就是准备数据，此示例用于显示音乐文件列表，音乐文件的信息来自于系统的类: MediaStore.Audio.Media。
将 MediaStore.Audio.Media 中程序需要的信息转存在自定义的类中，自定义的类如下：

// 此类中成员的个数根据个人需要定义,没有必要的成员可以删除的

public class Mp3Info {


	private String id;
	private String mp3Name;
	private String mp3Size;
	private String lrcName;
	private String lrcSize;
	private String mp3Artist;
	private long mp3Duration;
	private String mp3Url;
	
	public Mp3Info() {
		super();
	}
	
	public Mp3Info(String id, String mp3Name, String mp3Size, String lrcName,
			String lrcSize, String mp3Artist) {
		super();
		this.id = id;
		this.mp3Name = mp3Name;
		this.mp3Size = mp3Size;
		this.lrcName = lrcName;
		this.lrcSize = lrcSize;
		this.mp3Artist = mp3Artist;
	}
	
	@Override
	public String toString() {
		return "Mp3Info [id=" + id + ", mp3Name=" + mp3Name + ", mp3Size="
				+ mp3Size + ", lrcName=" + lrcName + ", lrcSize=" + lrcSize
				+ ", duration=" + mp3Duration + "]";
	}


	public String getId() {
		return id;
	}
	public void setId(String id) {
		this.id = id;
	}
	public void setId(long id) {
		this.id = Long.toString(id);
	}
	public String getMp3Name() {
		return mp3Name;
	}
	public void setTitle(String strName){
		this.mp3Name = strName;
	}
	public void setArtist(String strArtist){
		mp3Artist = strArtist;
	}
	public String GetArtist() {
		return this.mp3Artist;
	}
	public void setDuration(long duration){
		mp3Duration =  duration;
	}
	public void setMp3Name(String mp3Name) {
		this.mp3Name = mp3Name;
	}
	public String getMp3Size() {
		return mp3Size;
	}
	public void setMp3Size(String mp3Size) {
		this.mp3Size = mp3Size;
	}
	public void setSize(long strSize) {
		this.mp3Size = Long.toString(strSize);
	}
	public String getLrcName() {
		return lrcName;
	}
	public void setLrcName(String lrcName) {
		this.lrcName = lrcName;
	}
	public String getLrcSize() {
		return lrcSize;
	}
	public void setLrcSize(String lrcSize) {
		this.lrcSize = lrcSize;
	}
	public void setUrl(String strUrl) {
		this.mp3Url = strUrl;
	}
	public String GetUrl() {
		return this.mp3Url;
	}
}

音乐信息的获取与转存代码如下：

/**
* 用于从数据库中查询歌曲的信息，保存在List当中
* class Mp3Info 有什么成员, 由 MediaStore.Audio.Media 和实际需要确定
*/
public static List<Mp3Info> getMp3Infos(Context context) {
	Cursor cursor = context.getContentResolver().query(
		MediaStore.Audio.Media.EXTERNAL_CONTENT_URI, null, null, null,
		MediaStore.Audio.Media.DEFAULT_SORT_ORDER);
	List<Mp3Info> mp3Infos = new ArrayList<Mp3Info>();
	for (int i = 0; i < cursor.getCount(); i++) {
		Mp3Info mp3Info = new Mp3Info();
		cursor.moveToNext();
		long id = cursor.getLong(cursor.getColumnIndex(MediaStore.Audio.Media._ID));			// 音乐id
		String title = cursor.getString((cursor.getColumnIndex(MediaStore.Audio.Media.TITLE)));	// 音乐标题
		String artist = cursor.getString(cursor.getColumnIndex(MediaStore.Audio.Media.ARTIST));	// 艺术家
		long duration = cursor.getLong(cursor.getColumnIndex(MediaStore.Audio.Media.DURATION));	// 时长
		long size = cursor.getLong(cursor.getColumnIndex(MediaStore.Audio.Media.SIZE));			// 文件大小
		String url = cursor.getString(cursor.getColumnIndex(MediaStore.Audio.Media.DATA));		// 文件路径
		int isMusic = cursor.getInt(cursor.getColumnIndex(MediaStore.Audio.Media.IS_MUSIC));	// 是否为音乐
  	if (isMusic != 0) {		// 只把音乐添加到集合当中
  		mp3Info.setId(id);
  		mp3Info.setTitle(title);
  		mp3Info.setArtist(artist);
  		mp3Info.setDuration(duration);
  		mp3Info.setSize(size);
  		mp3Info.setUrl(url);
  		mp3Infos.add(mp3Info);
  	}
  }


	return mp3Infos;
}

将保存后的音乐信息显示在 ListView 中：
(1) 定义相应变量及初始化

private ListView lvMp3File;
List<Mp3Info> mp3Infos;

lvMp3File = (ListView)findViewById(R.id.listView1);

(2) 数据显示

// 测试音乐文件遍历 - 需改为线程(考虑若数据量大时是否会影响 UI 显示的时长)
// 生成动态数组，并且加载数据
ArrayList<HashMap<String, String>> mylist = new ArrayList<HashMap<String, String>>();
mp3Infos = getMp3Infos(getApplicationContext());
for (Iterator<Mp3Info> iterator = mp3Infos.iterator(); iterator.hasNext();) {
	Mp3Info mp3Info = (Mp3Info) iterator.next();  
	Log.v("Leo - MP3 Name: ", mp3Info.getMp3Name());
	
	HashMap<String, String> map = new HashMap<String, String>();
    	map.put("ItemTitle", mp3Info.getMp3Name());
    	map.put("ItemText", mp3Info.GetArtist());
    	// map.put("url", mp3Info.GetUrl());
    	mylist.add(map);
    
    // 生成 Apapter(适配器), 数组 -> ListItem
    SimpleAdapter mSchedule = new SimpleAdapter(this,
    	// 数据来源
    	mylist,
    	// ListItem 的 XML 实现
    	R.layout.my_mp3filelist,
    	// 动态数组与 ListItem 对应的子项
    	new String[] {"ItemTitle", "ItemText"},
    	// ListItem 的 XML 文件里面的两个 TextView ID
    	new int[] {R.id.ItemTitle,R.id.ItemText});
	
	lvMp3File.setAdapter(mSchedule);
}

此段代码在示例中，是放在主窗体的 protected void onCreate(Bundle savedInstanceState) 过程中。

ListView 还需要响应用户的点击操作，需要如下的声明：

lvMp3File.setOnItemClickListener(new MusicListItemClickListener());

MusicListItemClickListener 的实现如下：

private class MusicListItemClickListener implements OnItemClickListener
{
    @Override
    public void onItemClick(AdapterView<?> parent, View view, int position,long id)
    {
        if(mp3Infos != null)
        {
        		// Leo 界面切换: 切换到播放界面
        		// Intent goPlaying = new Intent(MainActivity.this, PlayingActivity.class);
        		// startActivity(goPlaying);
            Intent goPlayingIntent = new Intent();
            goPlayingIntent.setClass(MainActivity.this, PlayingActivity.class);
            startActivity(goPlayingIntent);
            
            // 启动音乐后台播放服务
            /* 若不做延时直接调用 run 中的代码,歌曲信息无法正确获取到 */
            positionSelected = position;
            Timer timer = new Timer();
            TimerTask task = new TimerTask(){
                public void run(){
    	            Mp3Info mp3Info = mp3Infos.get(positionSelected);
    	            Log.d("mp3Info-->", mp3Info.toString());
    	            Intent intent = new Intent();
    	            intent.putExtra("url", mp3Info.GetUrl());
    	            intent.putExtra("listPosition", positionSelected/*getPlayingIndex(mp3Info.GetUrl())*/);
    	            intent.putExtra("MSG", AppConstant.PlayerMsg.PLAY_MSG.ordinal());
    	            intent.setClass(MainActivity.this, PlayerService.class);
    	            startService(intent);       // 启动服务
                 }
            };
            timer.schedule(task, 300); // 0.3 秒后执行 run 中的代码段
    }
}