Android學習筆記(三八):資源resource(上)、XML解析(XmlPullParser)
resource是java原始碼之外的靜態資訊。例如layout。resource作為檔案存放在res/目錄下面,除了res/raw/外,Android會自動解析,例如layout檔案,我們不需要自己去解析XML封裝。我們之前用過res/layout/,以及res/anim/之前已經用過。
Image:檔案存放在res/drawable/,存放應用的icon。
Raw:res/raw/,程式所需的任意格式的檔案,但是系統不會對其進行解析,也既Adroid Framework並不需要的。
String,color,array,dimension:在res/values中,將這些常量和我們的java原始碼分離,這樣便於程式的國際化或者本地化中。
XML,位於res/xml/,這些靜態的XML檔案用於儲存程式的資料和結構。
String
定義resource
在resource中定義,有利於國際化或者本地化,即便不需要翻譯為其他語言,可以很方便去檢測或者修改,而無須在程式的各處去尋找,因此這是一種通用的處理方式。Android還支援常用的擴充套件方式,通過style,可以設定不同的格式。String在res/values/strings.xml中定義,根節點是resources,例如如下:
如果字串中包含"和',就需要用\"或者\',如果字串中只有一個單引號,可以使用"xxxxx 's xxxxxx"的方式,用雙引號括起來。<resources> <string name="quick">The quick brown fox...</string> <string name="laughs">He who laughs last...</string <string name="c20_my_name">My name is %1$s %2$s</string> <string name="c20_rich_text">My name is <b>%1$s</b> <i>%2$s</i></string> </resources>
在layout檔案中,用@string/element_name,例如@string/quick來引用內容,在java原始碼中,用R.string.element_name作為ID,並用getString()來獲取,例如getString(R.string.laughs)。
支援string format
例如我們在strngs.xml中定義:<string name="c20_my_name">My name is %1$s %2$s</string>,裡面的佔位符號可以被變數替換,例如
String strFormat = getString(R.string.c20_my_name);
String strResult = String.format(strFormat,"Tim","Martin");
那麼strResult則為:My name is Tim Martin。
rich Text
如果我們需要rich string,我們還可以通過HTML對格式進行定義,之前學習過的是通過webkit來顯示。然而我們也可以在TextView中顯示帶有Html格式。
例如:<string name="c20_rich_text">My name is <b>%1$s</b> <i>%2$s</i></string>在程式中,我們將內容一個通過textview來顯示,一個通過顯示html格式的textview,最後一個通過webkit來顯示:
TextView lable = (TextView)findViewById(R.id.c20_lable);
TextView lable2 = (TextView)findViewById(R.id.c20_lable2);
WebView web = (WebView)findViewById(R.id.c20_web);
String strFormat = getString(R.string.c20_rich_text);
String strResult = String.format(strFormat,"Tim","Martin");
String strResult2 = String.format(strFormat,TextUtils.htmlEncode("Tim"),
TextUtils.htmlEncode("Martin"));
/* 上面,strResult和strResult2的結果都是一樣的My name is <b>Time<b> <i>Martin</i>
* 關鍵是下面setText(Html.fromHtml(strResult)),將一個簡單的HTML轉換為一個帶格式的文字物件
*/
lable.setText(strResult);
lable2.setText(Html.fromHtml(strResult2));
web.loadData(strResult, "text/html", "UTF-8");
2012.11.2補充:insiku:TextUtils.htmlEncode 是為了防止輸入的字串含有HTML的一些預留字元,比如< > &, 這些字元在HTML中有特殊含義, 得轉換字元實體
圖片Picture
圖片檔案可以是PNG,JPEG,和GIF,推薦使用PNG,不建議使用GIF,檔案放置在res/drawable/下,Android有三個資料夾drawable-hdpi/drawable-mdpi/和drawable-ldpi對應不同的尺寸,實際上並沒有什麼太大的區別。假設檔名為foo.png,則在資源XML檔案中名稱為@drawable/foo,在Java原始碼中該資源的ID則為R.drawable.foo。
例子:將一個png檔案app_icon放到drawable中,我放入了drawable-hdpi/中,在Adroid XML檔案如下,執行結果如圖,中間的書本icon就是我們的ImageButton,只需要通過android:src來指出圖片的位置。
......
<ImageButton android:id="@+id/c20_format2"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:src="@drawable/app_icon"/>
......
xml檔案
xml檔案可以使用者儲存我們的資料,或者作為配置檔案等。xml檔案可以位於res/xml目錄下面,例如我們在該目錄下放置一個xml檔案words.xml,如下:
<?xml version="1.0" encoding="utf-8"?>
<ListItems desrciption="Put the entry as the item in Android List">
<Entry value="One" />
<Entry value="Two" />
<Entry value="Three" />
<Entry value="Four" />
<Entry value="Five" />
<Entry value="Six" />
<entry>Hello</entry>
</ListItems>
XmlPullParser可以用於解釋xml檔案。這裡有兩種xml的常見格式:<entry>Hello</entry>和<Entry value="Six" />,在Android XML中使用後者,而這種方式在XmlPullParser中處理也非常方便。它的使用方式歸納如下:
- XmlPullParser通過next(),依次向下檢查
- XmlPullParser是事件驅動,如果檢測到END_DOCUMENT,應當停止繼續檢測
- XmlPullParser是事件驅動,當檢測到START_TAG,可以讀出<AAAA bbbb=xxxx c=yyyyy>的內容,其中AAAA可通過getName()來獲取,屬性的個數,可通過getAttributeCount()獲取,屬性的名詞和內容可分別通過getAttributeName(index)和getAttributeValue(index)來獲取。
- XmlPullParser是事件驅動,如果是END_TAG,則為</AAAA>,可以通過getName()來獲得AAAA的內容
- 對於<entry>Hello</entry>這種方式,如果要獲取中間的數值,則事件為XmlPullParser.TEXT,可通過getText()來獲取內容。
- 由於xml檔案可能書寫不正確,或者我們在解釋的過程中處理不正確,應當使用異常捕獲的方式來處理
下面的例子,我們將上述的words.xml分析處理,將Entry數值作為listActivity的每個item的內容。
/* 1. XmlPullParser通過next(),依次向下檢查
* 2. XmlPullParser是事件驅動,如果檢測到 END_DOCUMENT,應當停止繼續檢測
* 3. XmlPullParser是事件驅動,當檢測到START_TAG,可以讀出<AAAA bbbb=xxxx c=yyyyy>的內容,其中AAAA可通過getName()來獲取,屬性的個數,可通過getAttributeCount()獲取,屬性的名詞和內容可分別通過getAttributeName(index)和getAttributeValue(index)來獲取。
* 4. XmlPullParser 是事件驅動,如果是END_TAG,則為</AAAA>,可以通過getName()來獲得AAAA的內容
* 5. 對於<entry>Hello</entry>這種方式,如果要獲取中間的數值,則事件為XmlPullParser.TEXT, 可通過getText()來獲取內容。
* 6. 由於xml檔案可能書寫不正確,或者我們在解釋的過程中處理不正確,應當使用異常捕獲的方式來處理
*/
public class Chapter20Test3 extends ListActivity{
private ArrayList<String> items = new ArrayList<String>();
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
/*步驟1:進行特定xml檔案words的解析,對應第6點,應採用異常捕獲防止程式出錯*/
try{
/* 步驟2:獲取xml檔案,並給給出XmlPullParser物件*/
XmlPullParser xpp = getResources().getXml(R.xml.words);
/* 步驟3:通過迴圈,逐步解析XML,直至xml檔案結束,對應第1點和第2點*/
while(xpp.getEventType()!=XmlPullParser.END_DOCUMENT){
/* 步驟4:獲取目標ListItems的解析,並將之用method:ListItems來處理,對應第3點 */
if(xpp.getEventType() == XmlPullParser.START_TAG){
if(xpp.getName().equals("ListItems")){
getItems(xpp);
}
}
xpp.next();
}
}catch(Throwable t){
Toast.makeText(this, "Failed:" + t.toString(), 2000).show();
}
setListAdapter(new ArrayAdapter<String>(this,android.R.layout.simple_list_item_1,items));
}
/* 解析<ListItems ... >.... </Listitem>的內容,獲取每個entry的value的值,注意對異常的處理*/
private void getItems(XmlPullParser xpp) throws Throwable{
while(true){
xpp.next();
/*<ListItems> ...</ListItems>的內容已經檢索完畢,或者檔案結束,都退出處理*/
if((xpp.getEventType() == XmlPullParser.END_TAG && xpp.getName().equals("ListItems"))
|| xpp.getEventType() == XmlPullParser.END_DOCUMENT)
break;
if(xpp.getEventType()==XmlPullParser.START_TAG) {
/*觀測點:對第3點的處理,讀出屬性的名字和數值*/
if(xpp.getName().equals("Entry")){
for(int i = 0; i < xpp.getAttributeCount() ; i ++){
if(xpp.getAttributeName(i).equals("value")){
items.add(xpp.getAttributeValue(i));
}
}
}
/*觀測點:對第5點的處理,處理<name>value</name>*/
if(xpp.getName().equals("entry")){
xpp.next();
if(xpp.getEventType()==XmlPullParser.TEXT)
items.add(xpp.getText());
}
}
}
}
@Override
protected void onListItemClick(ListView l, View v, int position, long id) {
super.onListItemClick(l, v, position, id);
Toast.makeText(this, items.get(position), Toast.LENGTH_LONG).show();
}
}