国产探花免费观看_亚洲丰满少妇自慰呻吟_97日韩有码在线_资源在线日韩欧美_一区二区精品毛片,辰东完美世界有声小说,欢乐颂第一季,yy玄幻小说排行榜完本

首頁 > 學院 > 開發設計 > 正文

什么情況下需要使用XML創建 EMAIL 模板

2019-11-18 12:49:49
字體:
來源:轉載
供稿:網友

  發送郵件是web應用系統的一個基本功能。一般來說,郵件都有特定的類型,比如說密碼提醒,歡迎信息,訂單確認或者收信確認。盡管不同應用郵件的內容各不相同,但是發送郵件的過程基本上是一樣的。 構建消息,發送給郵件服務器,發送。
  當使用java開發的時候,我們經常使用JavaMail API 來連接郵件服務器發送郵件。但是這種方式過于粗笨(主要由郵件的靈活性造成的),所以當你需要多次使用這種方式發送郵件的時候,最好寫一個wrapper.根據使用的方式不同,wrapper可以是發送某一特定的郵件,比如說密碼提醒,或者作為一種通用的模式,接受主題,接收人,郵件內容作為參數。
  一旦使用wrapper發送郵件,你需要一個自主構建消息的系統。讓我們使用密碼提醒作為例子。基本上所有的郵件都包含主題,內容和接收人。當我們發送密碼提醒郵件的時候,用戶地址和密碼是從某個記錄登陸信息的知識庫里提取的。主題和內容需要和數據庫提取的數據合并,并且被保存在某個地方。系統設計最大的問題就是在什么地方保存這種類型的字符串。在很多情形下,字串被保存在屬性文件里,這種方式分離了數據和源代碼,并且使本地化更加輕易。我在很多web應用系統中使用了這種存儲機制,但很不幸的是,這種方式有很多缺陷。
  以下是利用屬性文件存儲郵件字串不合適的原因:
  •屬性文件使用一種非常簡單的數據結構-名稱和值組合。當你需要很多值對應一個名稱的時候這種結構就不合適了。比如,一個郵件有4個接收人,3個抄送人,使用屬性文件很難解決這個問題。
  •屬性文件的格式非常嚴格。名稱和值必須在同一行上,所以當你編輯文件的時候長字符串是很難處理的。比如,把一個郵件的所有內容放進屬性文件是一件多么痛苦的事情。假如你希望值的內容包括換行,你必須使用
  另一種選擇是使用xml作為郵件模板,這也是本篇文章所要討論的內容。XML為你構建模板提供了極大的靈活性,并且它不會有屬性文件所有的格式限制,因此這種方式很輕易處理長字符串。XML主要弱勢就是它處理起來比屬性文件復雜。使用屬性文件的時候,裝載文件和裝載后訪問文件非常輕易。而裝載XML文件和使用java提供的多個XML處理庫之一處理XML文件就需要更多的工作了。
  這篇文章和所附的代碼提供了一個通用的模板使你能夠使用XML文件創建模板并且發送郵件,希望由此能夠減輕這個過程的痛苦。在這個模板里,我將使用Jakarta 項目里的Commons Digester 包來處理XML,使用JavaMail API發送郵件。
  
  郵件模板
  讓我們來看看郵件模板的格式。模板是XML文件,它包含一個根元素和一系列根的子元素。根元素是。必要的子元素是, , 和 。可選的子元素是 , , 和 。假如你使用過郵件系統,那么你可以推導出這些元素實際包含的內容。可選的元素有多個實例,所以你可以為每種類型的接收者指定多個地址。我待會會在描述消息處理的時候來解釋運行機制。以下是一個模板文件的例子。
  
  rafe@rafe.us
  someone@example.com
  someoneelse@example.com
  rafe@rafe.us
  This is the subject
  This is the body of an email message.
  
  可定制的模板
  屬性文件的一個有用的特性是你可以使用MessageFormat 類用動態傳入的值替代屬性文件里的被指定參數。比如說,假如你需要在屬性文件里指定errors,其中一個errors是file not found, 你可以這樣寫:
  file.not.found.error=Error, could not find file {0}.
  然后,在運行時刻,你這樣使用MessageFormat:
  
  ResourceBundle bundle = ResourceBundle.getBundle(
  "My  Object[] arguments  = { "some_file.txt" };
  String newString   = MessageFormat.format(
  bundle.getString("file.not.found.error"), arguments);
  
  最后,newString 將包含Error, could not find file some_file.txt.我在這個系統里加入了類似的靈活性。 可以格式化所有的字符串,所以你可以在郵件模版的subject 和body元素里內嵌在屬性文件使用的同樣的令牌。
  在某種情形下,你希望在發送郵件的時候插入個人化的信息。比如,你希望在郵件內容里或者訂單的內容里包含收件人的姓。本系統使用MessageFormat 來處理郵件模版的內容和主題,從而解決這個問題。處理內容和主題的時候只使用一個參數數組。這樣主題里可以包含令牌{0}, {2}, {3}, 內容可以包含令牌{0}, {1}, {4} 。我之所以采用這種方式是因為在很多情形下主題和內容使用相同的參數,同時這種方式也簡化了傳遞給EmailSender所需要的參數。
  
  處理模版
  創建完模版,下一步所要做的就是處理它。我們知道,現在有很多的XML處理包可供選擇。Commons Digester是Jakarta的公共項目,最初是為了在Struts項目中快速方便的解析Struts的的配置文件而產生的。它提供了從XML文件里的元素到使用類似于XPath 語法的數據結構的映射。 好處在于為了從 XML文件里得到某個元素你不必用SAX一個節點一個節點的解析,也不必使用DOM處理樹狀數據結構。
  下面這個方法從XML文件里讀取數據,然后把數據拷貝到EmailTemplate對象中。
  
  public static EmailTemplate getEmailTemplate(InputStream aStream)
  {
  Digester digester = new Digester();
  digester.setValidating(false);
  
  digester.addObjectCreate("email", EmailTemplate.class);
  
  digester.addBeanPropertySetter("email/subject", "subject");
  digester.addBeanPropertySetter("email/body", "body");
  digester.addBeanPropertySetter("email/from", "from");
  digester.addCallMethod("email/to", "addTo", 0);
  digester.addCallMethod("email/cc", "addCc", 0);
  digester.addCallMethod("email/bcc", "addBcc", 0);
  
  try
  {
  return (EmailTemplate)digester.parse(aStream);
  }
  catch (IOException e)
  {
  logger.error("Error: ", e);
  return null;
  }
  catch (SAXException e)
  {
  logger.error("Error: ", e);
  return null;
  }
  }
  
  讓我們來逐行研究這段代碼。Commons Digester工作的原理是由你來指定解析文件的一些規則。因為沒有規范郵件模版的DTD文件,所以在指定處理規則之前,我將validating flag設定為false。開始處理文件的時候,我實例化Digester對象然后調用方法建立數據映射規則。首先,我調用addObjectCreate()方法來建立創建EmailTemplate對象的規則。email是XML模版文件的根元素。因此模版文件和EmailTemplate 對象一一對應。
  我使用addBeanPropertySetter()來處理在模版文件中只出現一次的元素。這個方法有兩個參數,元素的路徑和要調用的賦值方法。在第一次調用的時候,我指定在文件中符合email/subject 模式的元素應該賦值給EmailTemplate 類的subject 。我們用 “/”來描速XML文件的內嵌關系。在這個例子中,符合subject模式的元素是email 子元素。為了提供更多的靈活性我們可以使用Wildcards。參考Commons Digester的JavaDoc 你可以了解具體的模式的構成方式。
  使用賦值方法處理在模版文件中出現多次的元素是不可行的。我們使用addCallMethod()來處理這種情形,這個方法從元素中取值并且調用指定的方法。我使用這個方法有三個參數的版本,它們是:匹配的模式,調用的方法,調用方法所使用的參數數量。在例子的三種情形中第三個參數都是0,說明符合模式的元素是調用方法的唯一參數。在EmailTemplate類中我定義了三個方法:addTo(), addCc(), addBcc(),這三個方法將模版文件中的收件人列表加入到模版類的收件人集合中。
  郵件元素的六種類型的子元素的規則都被指定好之后,我開始解析這個文件。在這個例子中, 我傳入getEmailTemplate 方法的輸入參數InputStream 。parse方法可以解析File,SAX InputSource, InputStream, Reader, 目標文件的URI。我使用InputStream。 由調用這個方法的代碼取得XML文件并且把它轉化為InputStream 。為了讓這個方法更加通用,我可以用Object作為參數,并且在方法內部使用instanceof 來確定參數的類型,再用相應的方式來處理。
  方法parse 拋出IOException 或者SAXException。把這些異常傳給Log4J,由它來處理,返回null. 假如沒有異常拋出, 將返回由Digester創建的EmailTemplate對象。
  
  EmailTemplate類剩下的部分
  getEmailTemplate()方法是類EmailTemplate的核心。其他的部分是一些屬性值和一些輔助性的方法。有3個String 類型的屬性值:內容,主題,寄件人地址,3個ArrayList屬性值:to, CC, BCC 列表,這3個值都以String作為基本元素。還有相應的get,set和加入集合的方法。還有3個附加的方便的方法:getToAddresses(), getCcAddresses(), 和 getBccAddresses()。JavaMail接口需要InternetAddress 數組作為地址集合的參數,這些方法可以把對象的String數組轉化為JavaMail接口需要的數組形式。
  
  類EmailSender
  當模版文件被解析成EmailTemplate對象,下一步就是發送郵件信息。EmailSender 類包含一個靜態的,重載的方法-sendEmail()。 這個方法可以通過很多種方式調用,所有的方式都是對下面這個完全參數方法的一個引用:
  public static void sendEmail(
  String aTo,
  EmailTemplate aTemplate,
  String[] aArgs)
  
  參數不需要過多的解釋。第一個是郵件的發送地址。你可以在郵件模版里指定很多接收人地址,但是在運行時刻,大多數情況下,系統只

發表評論 共有條評論
用戶名: 密碼:
驗證碼: 匿名發表
主站蜘蛛池模板: 连云港市| 瑞昌市| 宁国市| 烟台市| 鹰潭市| 桐庐县| 辽宁省| 彩票| 宁德市| 措美县| 云林县| 福海县| 罗江县| 葫芦岛市| 三明市| 柯坪县| 安龙县| 全南县| 汉阴县| 鲁山县| 景宁| 海原县| 东辽县| 蕲春县| 长治县| 军事| 高阳县| 密云县| 怀集县| 吉首市| 兖州市| 井研县| 辽宁省| 色达县| 抚州市| 社旗县| 南岸区| 双流县| 靖江市| 沙湾县| 南木林县|