Android API中文文檔(111) —— MailTo

前言

　　本章內容是android.net.MailTo，版本為Android 3.0 r1！期待你一起參與Android API的翻譯，聯絡我over140@gmail.com。

 

聲明

　　歡迎轉載，但請保留文章原始出處:)

　　　　部落格園：http://www.cnblogs.com/

　　　　Android中文翻譯組：http://goo.gl/6vJQl

 

本文

　　一、結構

public class MailTo extends Object

        

java.lang.Object

android.net.MailTo

 

　　二、類概述

　　　　MailTo URL解析器。這個類解析到URL計劃的郵件(a mailto schema URL參見這裡)和可用於解析參數查詢。它實現了RFC 2368協議。

 

　　三、常量

　　public static final String MAILTO_SCHEME

         常量值："mailto:"

 

　　四、公用方法

　　public String getBody ()

　　從一個Url中擷取郵件的本文內容。如果沒有設定本文內容，則返回null值。

　　傳回值

　　返回本文或null

 

　　public String getCc ()

　　從一個Url中擷取抄送地址。這可能是多個電子郵件地址，以逗號分隔的空間。如果沒有指定抄送地址，則返回null值

　　傳回值

　　逗號分隔的郵件地址或null

 

　　public Map<String, String> getHeaders ()

　　從一個Url中擷取郵件標頭（Android123：比如編碼類別型，發送時間、IP等）

　　傳回值

　　包含解析值的map

 

　　public String getSubject ()

　　從一個Url中擷取主題。如果沒有指定的主旨列，則返回null值。

　　傳回值

　　主題或null

 

　　public String getTo ()

　　從一個Url中擷取收信人。這可能是多個電子郵件地址，以逗號分隔的空間。如果沒指定，則返回null值。

　　傳回值

　　逗號分隔的電子郵件地址或null。

 

　　public static boolean isMailTo (String url)

　　測試判斷指定字串是否包含Email的Url。

　　參數

　　url  用於測試的字串

　　傳回值

　　如果為true，字串是包含Email的Url。

 

　　public static MailTo parse (String url)

　　將指定Url字串解析成MailTo類。這個解析器實現的RFC 2368。返回的對象可以用於查詢解析的參數。

　　參數

　　url  包含Email的Url字串

　　傳回值

　　MailTo對象

                 異常

　　ParseException       如果該結構並不是包含Email的Url將拋出此異常。

 

　　public String toString ()

　　返回一個包含關於對象簡潔的、大家都可以讀懂的字串。鼓勵子類重寫此方法，並提供一個考慮到對象的類型和資料的實現。預設的實現價於下面的運算式：

          

　　如果你打算實現自己toString方法，參見Writing a useful toString method。

　　傳回值

                           表示此對象的可列印輸出。

 

　　五、補充

　　文章連結

　　　　　　電子郵件解析android.net.MailTo類(本文有參照該連結的翻譯)