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的话,最好还是去找产商认证一下,会大大提供程序的友好性。