PIM & FC

fc5753

概述
JSR 75(PDA Optional Packages for the J2METM Platform)中定义了两个可选包：
PIM (The Personal Information Management)API，提供对个人信息数据的访问，一般包括名片夹，日历项，和待办事项。
FC(The FileConnection) APIs，提供对本地文件系统的访问。
一、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
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的话，最好还是去找产商认证一下，会大大提供程序的友好性。


本文来自ChinaUnix博客，如果查看原文请点：http://blog.chinaunix.net/u2/70629/showart_723020.html