FC API(JSR 75)简单讲解
前言：在网上搜了一圈，没有找到多少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的话，最好还是去找产商认证一下，会大大提供程序的友好性。
（出处：http://www.knowsky.com）
