在網上找了很長時間也沒找到一些系統講解JSR75包的文章,所以,找了一些參考資料,研究一下,為大家做個整理吧
概述
JSR 75(PDA Optional Packages for the J2METM Platform)中定義了兩個可選包:
1.PIM (The Personal Information Management)API,提供對個人信息數據的訪問,一般包括名片夾,日歷項,和待辦事項。
2.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
Connector.open()
.
所以,也可以使用這樣的方法: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的話,最好還是去找產商認證一下,會大大提供程序的友好性。