前言:在网上搜了一圈,没有找到多少PIM和FC的中文资料,所以,参考了一些资料,并简单写下一些我使用中的想法,希望能和大家多多交流,不足之处,请大家不吝赐教,我的邮箱是:stormbupt@163.com
概述
JSR 75(PDA Optional Packages for the J2METM Platform)中定义了两个可选包:
PIM (The Personal Information Management)API,提供对个人信息数据的访问,一般包括名片夹,日历项,和待办事项。
FC(The FileConnection) APIs,提供对本地文件系统的访问。
本文简单讲解FC API的特性的用法。
一、FC API与RMS
简单地写一点,这两个东东其实没有可比性,功能侧重不同,FC APIs提供了MIDlets与本地文件和其它应用的交互,比如我们可以通过 FC API在MIDlets中打开外部的各种文件,并且保存一些极大的资源,这一点RMS没有办法做到的,FC API并不是强制实现的。
RMS用来存储程序中的一些数据,FC API不会取代RMS。
二、FC API简介
1.FC API中的类和接口
接口:
javax.microedition.io.file.FileConnection,继承自CLDC中的javax.microedition.StreamConnection;
javax.microedition.io.file.FIleSystemListener,用于监听文件系统目录状态变化的通知,比如文件的删除和新增,存储卡的拨出的插入;onnectionClosed
类:
javax.microedition.io.file.FileSystemRegistry,用于获取当前所有文件的根目录和管理跟踪文件系统的监听器;
javax.microedition.io.file.IllegalModeException,文件打开模式异常,当试图写入以只读方式打开的文件时,该异常会被抛出;
javax.microedition.io.file.ConnectionClosedException,当试图对一个已经关闭的FileConnection对像作操作时,该异常会被抛出。
2.验证系统是否支持FC API
可以通过系统属性来验证手机是否支持FC API:
System.getProperty("microedition.io.file.FileConnection.version");
如果支持的话,会返回FC API的版本号,一般是1.0,
如果不支持,则返回null,
现在支持FC API的手机非常少,
MOTO的A1系列手机有几款支持,我手上用过的V635就支持。
(说明一下,MOTO用的是自己的包com.motorola.io.file,但和FC几乎一样)
三、FC API的使用
1.打开一个文件
将使用file协议的url传入Connector以创建FileConnection类,可以以READ,READ_WRITE和WRITE三种方式打开,代码如下:
FileConnection fconn = null;
try{
fconn = (FileConnection)Connector.open("file:///a/mobile/audio/playlist.txt",Connector.READ);
}
catch(Exception e){
log("open file error:"+e); //大家当成System.out.println()就好
}
值得注意的是,如果文件不存在的话,语句也可以正常执行,并不会抛出任何异常,所以,为了避免后续操作中不必要的麻烦,我们要用fconn.exists()方法来自己判断文件是否存在:
FileConnection fconn = null;
try{
fconn = (FileConnection)Connector.open("file:///a/mobile/audio/playlist.txt",Connector.READ);
if(fconn.exist()){
//……………………..
}
else{//…………………………….}
}
catch(Exception e){
log("open file error:"+e);
}
2.对文件的读写操作
读文件:
通过InputStream从FileConnection读取,然后自己再对InputStream做解析,用法很简单,和读取 HttpConnection差不多,附上以前程序里的一段详细代码,是用来读取播放列表文件的,程序中为了方便,是使用DataInputStream 直接读的,没有用到InputStream,实际上原理是一样的:
private void loadLists(){
log("try open playlist");
musicList.removeAllElements();//musicList是一个Vector,在本段代码之外定义并初始化
FileConnection fconn = null;
DataInputStream dis = null;
try{
//以只读模式打开playlist.txt文件
fconn = (FileConnection)Connector.open("file:///a/mobile/audio/playlist.txt",Connector.READ);
dis=fconn.openDataInputStream();//开输入流
String tmp=null;
do{
try{
tmp=dis.readUTF();//读文件路径
} catch(Exception e){
tmp = null;
}
if(tmp != null){
OneMusic onemusic=new OneMusic();
onemusic.filepath=tmp;
onemusic.filename=dis.readUTF();//读文件名
onemusic.filesize=dis.readLong();//读文件大小
musicList.addElement(onemusic);
}
}while(tmp!=null);
log("playlist loaded");
dis.close();
fconn.close();
}
catch(Exception e){
e.printStackTrace();
}
}
写文件:
通过OutputStream向FileConnection写入,附上写入播放列表的代码,同样我也用的是DataOutputStream,
private void saveLists(){
log("try save playlist");
FileConnection fconn = null;
DataOutputStream ous = null;
try{
//以读写模式打开
fconn = (FileConnection)Connector.open("file:///a/mobile/audio/playlist.txt",Connector.READ_WRITE);
if(!fconn.exists()){//判断文件是否存在,如果不是,则新建一个
NpPlayer.instance.showlog.dealReportMsg("playlist not exists ,create");
fconn.create(); // create the file if it doesn’t exist
log("playlist created!!");
} else {//如果文件存在,则将旧的文件删除,建立一个新文件
fconn.delete();
log("playlist exists,delete");
fconn.create();
log("playlist created!!");
}
ous = fconn.openDataOutputStream() ;
log("saving playlists….");
for(int i=0;i<musicList.size();i++){//将音乐列表按路径,文件名,文件大小的格式写入播放列表文件中
OneMusic onemusic;
onemusic=(OneMusic)musicList.elementAt(i);
byte[] temp = null;
ByteArrayOutputStream bos =new ByteArrayOutputStream() ;
DataOutputStream dos =new DataOutputStream (bos) ;
dos.writeUTF(""+onemusic.filepath);
dos.writeUTF(""+onemusic.filename);
dos.writeLong(onemusic.filesize);
temp=bos.toByteArray();
dos.close();
bos.close();
ous.write(temp,0,temp.length);
}
ous.flush();
ous.close();
fconn.close();
log("playlist saved!!");
}
catch(Exception e){
e.printStackTrace();
}
finally {
try{
if (ous != null)
ous.close();
} catch (Exception closee){}
try{
if (fconn != null)
fconn.close();
} catch (Exception closee){}
}
}
3.对目录的操作
判断是文件还是目录,使用isDirectory()方法
boolean isdir = fconn.isDirectory();
指定完整的路径和目录名后调用方法mkdir()来创建新的目录:
FileConnection fconn = null;
try{
fconn = (FileConnection)Connector.open("file:///a/mobile/audio/mymusic",Connector.READ_WRITE);
fconn.mkdir();
}
catch(Exception e){}
列目录下的所有内容,用list()方法,此方法返回一个java.util.Enumeration类的对像
java.util.Enumeration enu = fconn.list();
接下来就可以通过java.util.Enumeration中的hasMoreElements()方法来判断目录下是否还有内容并进行相应操作
while(enu.hasMoreElements()){
//……………………………….
}
说明一点,此处返回的是一个java.util.Enumeration类的对像,实际上就是一个String数组,这一点参考FC API文档:
public java.util.Enumeration list() throws java.io.IOException
- Gets a list of all visible files and directories contained in a directory. The directory is the connection’s target as specified in
Connector.open()
. - Returns:
- An Enumeration of strings, denoting the files and directories in the directory……………….
……………………………..
所以,也可以使用这样的方法:String[] tmp = fconn.list(),然后自己处理一下这个数组就行了。
4.监听文件系统的变化
可以用FileSystemListener来监听文件系统的改变(增加,删除,修改),以便作出响应,
在此以存储卡的拨出和插入为例,代码是找的现成的:)
public class FSListener implements FileSystemListener{
public void stateChanged(int state,String name){
if(state == FileSystemListener.ROOT_REMOVED)
//root removed
else if(state == FileSystemListener.ROOT_ADDED)
//root added
}
}
注册监听到FileSystemRegistry:
FileSystemListener listener = new FSListener();
FileSystemRegistry.addFileSystemListener(listener);
四、FC API的安全性
对于未经过签名的MIDlet,在每次使用FC API读取文件时,都会提示用户是否允许,非常烦人.
并且不允许对文件进行写操作,而MOTO自己的包更是狠,没有认证的程序是不能读取任何文件的。。。所以几乎没用
如果程序中要用到FC API的话,最好还是去找产商认证一下,会大大提供程序的友好性。