CSDN博客

img youlin

在J2ME平台上构建你的邮件程序

发表于2004/10/10 0:14:00  1209人阅读

 

J2ME平台上构建你的邮件程序

Jacky Pan

 

Table of Contents

1.       教程的介绍和程序的安装

2.       程序的结构

3.       界面的设计

4.       账户的管理

5.       MIDletServlet的网络连接

6.       ServletJavaMail

7.       简单的XML

8.       小结


1.教程的介绍和程序的安装

 

本教程讲述了如何在J2ME平台上编写一个简单的邮件应用程序,包括界面的设计,邮件的发送/接受,邮件账户的创建/修改/删除,后台Servlet的编写。

 

为了运行本教程所带的演示程序,您需要安装下列软件:

1.       WTK2.0 (java.sun.com)

2.       Apache Tomcat (www.apache.org)

 

安装和运行示例程序的步骤:

1.       http://groups.yahoo.com/group/OriTec/files/下载MicroMail Beta.zip(包括了源代码和二进制文件)

2.       解压MicroMail Beta.zip$TMP

3.       $WTK/apps下建一新目录MicroMail

4.       拷贝$TMP/src/client/* $WTK/apps/MicroMail/src/

5.       拷贝$/TMP/bin/server/mail.war$TOMCAT/webapps/

6.       运行Tomcat

7.       运行WTK2.0, “Open Project” 并选中MicroMail

8.       设置URLMailAgent的地址http://server/mail/MailAgent

2. 程序的结构

采用Client-Web Server-Mail Server三层架构,如图1

MIDlet

(Cell Phone)

Servlet

(Web Server)

Mail Server

 

 

 

 

 

            My Application

                                         Figure 1

 

Cell Phone将请求(接受/发送邮件)传给Web ServerWeb Server将这些http请求转换成对POP3 SMTP Server的请求。POP3/SMTP Server执行相应的请求,并将相应通过Web Server返回给Cell Phone.

 

客户端(PDA/手机)J2ME平台上的程序。MIDP2提供了一些基本网络连接的API。利用这些API可以使得J2ME程序可以向远端发出Http请求,并接受响应,传递数据流。

 

MailAgent Servlet,用来接收来自客户端的请求,并调用Java Mail API,将这些请求转变成对远端Mail Server 的请求,同时将Mail Server的响应传给客户端。

 

那么为什么要采用这样的架构了?这是因为MIDP2.0只支持HTTP协议, 而不支持POP3 SMTP等其它应用层协议,而J2EE提供了完整的Java MailAPI,所以考虑通过一个ServletHttp请求转换成POP3SMTP请求。另一个原因是,很多运营商可能只提供有限的网络访问的能力,而通过一个agent则提供了程序部署的灵活性。

 

下面简单介绍一下源码的结构,在客户端,ui包中的类定义程序的用户界面,utility包中的类定义了数据库的操作,网络的连接,XML的解析等,mail包中的类定义了邮件账户,邮件的头。

ui package:

AccountForm.java

AccountsList.java

Confirm.java

ConfirmListener.java

MailMIDlet.java

MessageList.java

ProgressForm.java

SendMessage.java

WriteContent.java

 

utility package:

DBOperator.java

HeadParser.java

NetAdapter.java

Networker.java

ParserListener.java

 

mail package:

MailAccount.java

MessageHead.java

 

服务器端只有一个文件MailAgent.java,包含了一个servlet,用来做midlet和邮件服务器的桥梁。

 


3. 界面的设计

MIDP2.0提供了大量的API供开发者创建和控制用户界面。在包javax.microedition.lcdui中提供了List, Form, TextBox, AlertScreen组件,在Form中可以包含一系列Item,如ChoiceGroup, TextField, StringItem等。包中还提供了Command组件,以及相应的Listener

 

源文件ui/MailMIDlet.java定义了程序的入口以及MicroMail的主页面。如图2主页面是一个List,显示了几个功能模块,包括添加账户,修改/删除账户,接受邮件,发送邮件。

Figure 2

public MailMIDlet()

{

    display = Display.getDisplay(this);

       /* 创建List */

    mainList = new List("MicroMail0.1", Choice.IMPLICIT);

       /* 创建两个控制按钮OKExit */

    cmOK = new Command("OK", Command.OK, 1);

    cmExit = new Command("Exit", Command.EXIT, 1);

       /* mainlist中添加内容 */

    mainList.append("Add Account", null);

    mainList.append("Edit Account", null);

    mainList.append("Receive Message", null);

    mainList.append("Send Message", null);

       /* mainlist添加Command */

    mainList.addCommand(cmOK);

    mainList.addCommand(cmExit);

       /* MailMIDlet实现了CommandListener接口,可以作为监听器 */

    mainList.setCommandListener(this);

   

       ……

}

 

通过AccountForm(源文件ui/AccountForm.java),用户可以添加和修改邮件账户,如图3

            

     Figure 3a                                                               Figure 3b

 

AccountForm包含了6TextField,分别显示邮件账户的6个属性。account为账户名,也是账户的唯一标识,不可重名。address为邮件的地址,bill@ms.com user, password是在邮件服务商注册的用户名和密码。pop3, smtppop3服务器和smtp服务器的名字或地址。

private void setContent(MailAccount macc)

{

    account = new TextField("Account: ", "", 20, TextField.ANY);

    address = new TextField("Address; ", "", 40, TextField.EMAILADDR);

    user = new TextField("User Name: ", "", 20, TextField.ANY);

    password = new TextField("Password: ", "", 20, TextField.PASSWORD);

    pop3 = new TextField("POP3 Server: ", "", 20, TextField.ANY);

    smtp = new TextField("SMTP Server: ", "", 20, TextField.ANY);

 

    if (macc != null)

    {

      account.setString(macc.accountName);

      address.setString(macc.address);

      user.setString(macc.username);

      password.setString(macc.password);

      pop3.setString(macc.POP3Server);

      smtp.setString(macc.SMTPServer);

    }

 

    append(account);

    append(address);

    append(user);

    append(password);

    append(pop3);

    append(smtp);

 

}

 其它页面与AccountForm类似,在此不再赘述,请大家参照源代码和MIDP API的文档。


4. 账户的管理

邮件账户的创建,修改,删除都涉及到对数据记录的存取。MIDP提供了一种叫做记录管理系统(Record Management System)的机制来存储和访问数据。

 

javax.microedition.rms.RecordStore提供了一些API来操作这个系统。静态方法openRecordStore用来打开或创建一个RecordStore对象。方法addRecord, getRecord, deleteRecord, setRecord分别用来添加,访问,删除或修改RecordStore对象中的记录。

 

utility/DBOperator.java中封装了这些方法,从而实现添加,修改,删除邮件账户的操作。以添加帐户为例,下面的addRecord方法用来向RecordStore中添加一个记录,同时把这个记录所表示的邮件账户加到一个accounts中,accounts是一个Vecotr,用来存储系统中当前的账户。参数str包含了账户的所有信息,如账户名,地址,用户名,密码,pop3smtp等,它们之间用空格隔开。

 

public void addRecord(String str)

{

    int id;

    byte[] rec = str.getBytes();

    String record = str;

 

    try

    {

       /* RecordStore中添加记录 */

      id = rs.addRecord(rec, 0 , rec.length);

 

       /* 同时把帐户添加到accounts向量中 */

      MailAccount mailacc = MailAccount.createMailAccountFromString(id, str);

      accounts.addElement(mailacc);

    }

    catch(RecordStoreException rse)

    {

      rse.printStackTrace();

    }

 

}


5. MIDletServlet的网络连接

MIDP的网络API在包javax.microedition.io中定义,其中HttpConnection提供了对HTTP协议的支持。

 

在文件utility/Networker.java中通过调用这些网络API实现了接收当前信箱中邮件列表setMessageList,接受某一邮件的内容receiveMessage,发送邮件sendMessage等功能。以sendMessage为例。

 

public void sendMessage(final String url, final String formData)//send a message

{

       /* 创建新的进程 */

  Thread t = new Thread()

  {

    public void run()

    {

      HttpConnection http = null;

 

      byte[] data = formData.getBytes();

      try

      {

              /* 打开并返回一个HTTP连接 */

        http = (HttpConnection) Connector.open(url);

      ......

              /* 设置HTTP请求头 */

        http.setRequestMethod(HttpConnection.POST);

        http.setRequestProperty("Content-Type", "application/x-www-form-urlencoded");

        http.setRequestProperty("User-Agent",

                                "Profile/MIDP-1.0 Configuration/CLDC-1.0");

        http.setRequestProperty("Content-Language", "en-US");

        http.setRequestProperty("Accept", "application/octet-stream");

        http.setRequestProperty("Connection", "close"); // optional

        http.setRequestProperty("Content-Length", Integer.toString(data.length));

       ......

              /* 打开输出流 */

        OutputStream os = http.openOutputStream();

              /* 写邮件数据 */

        os.write(data);

              /* 关闭输出流 */

        os.close();

               

      }

      catch (IOException ioe)

      {

        ......

      }

      finally

      {

        try

        {

                     /* 关闭连接 */

          if (http != null) http.close();

        }

        catch (IOException ignored) {}

      }

    }

  };

/* 启动进程 */

  t.start();

 

}

 

MIDlet通过HTTP连接向Servelet发出接受或发送邮件的请求,Servlet根据不同的请求向邮件服务器发出相应的请求,并将返回结果传给MIDlet


6. ServletJavaMail

J2EE中提供了对邮件相关协议的支持,包javax.mail和包javax.mail.internet 中定义了JavaMail API。下面是MailAgent.javaServlet处理接受邮件列表请求的代码片断。

public void doPost(HttpServletRequest request, HttpServletResponse response)

       throws ServletException, IOException

{

       PrintWriter out = response.getWriter();

             

       String typeStr = request.getParameter("type");

       int type = Integer.parseInt(typeStr);

      

       String pop3Server;

       String username;

       String password;

      

       Properties props;

       String provider;

      

       switch (type)

       {

              case RECEIVE_LIST:

                     /* 提取参数pop3服务器,用户名,密码 */

                     pop3Server = request.getParameter(paramPOP3);

                     username = request.getParameter(paramName);

                     password = request.getParameter(paramPass);

             

                     if (pop3Server == null || username == null || password == null) 

                     {

                            out.print(STATUS_BAD);//xml?

                            return;

                     }

             

                     props = new Properties();

                     provider = "pop3";

                     try

                     {

                            /* 以指定的用户名和密码连接pop3服务器 */

                            Session session = Session.getDefaultInstance(props, null);

                            Store store = session.getStore(provider);                         

                            store.connect(pop3Server, username, password);

                            /* 得到INBOX收件箱 */

                            Folder inbox = store.getFolder("INBOX");

                           

                            if (inbox == null)

                            {

                                   out.print(STATUS_BAD);//xml?

                                   return;

                            }

                            /* 打开收件箱 */

                            inbox.open(Folder.READ_ONLY);

                            /* 得到收件箱中的邮件列表,并写到 XML */

                            writeXML(inbox.getMessages(), out);

             

                            inbox.close(false);

                            store.close();

                     }

                     catch(Exception e)

                     {

                            out.println(e.getMessage());

                            e.printStackTrace();

                     }

      

                     out.close();

             

                     break;

             

              case RECEIVE_MESSAGE:

                     ......

                     break;

                    

              case SEND_MESSAGE:

                     ......

                     break;

       }

      

}

J2EE程序的编译和部署请大家参照相关的书籍或文档。http://www.tusc.com.au/tutorial/html/ <<Tutorial for building J2EE Applications using JBOSS and ECLIPSE>>是一篇不错的文档。


7. 简单的XML

MIDlet接受邮件时,首先向Servlet请求传送邮箱中当前邮件的列表。列表中包括了邮件的头部信息,包括发送者的地址,邮件的主题,发送的时间等,如图4

Figure 4

在邮件主题中可能包括任何字符,所以没有办法用某一特殊字符分隔这些信息,而XML正好适合传输这种具有特定格式的信息。在Servlet端,把有用的邮件头部信息作为XML的元素写到输出流中。

private void writeXML(Message[] messages, PrintWriter out)

{

       out.println("<?xml version=/"1.0/"?>");

       out.println("<mail>");

      

       if (messages == null)

       {

              out.println("<error>No Mail</error>");

       }

      

       try

       {

              int j = 0;

              for (int i = messages.length -1; i >= 0; i--)

              {

                     out.println("<message>");

                     /* 写邮件头 */

                     out.println("<from><![CDATA[" + InternetAddress.toString(messages[i].getFrom()) + "]]></from>");

                     out.println("<subject><![CDATA[" + messages[i].getSubject() + "]]></subject>");

                     out.println("<date>" + messages[i].getSentDate().toLocaleString() + "</date>");

                     out.println("<index>" + i + "</index>");

                     out.println("</message>");

                    

                     j++;

                     if (j > 9)

                     {

                            /* 一次只看10个邮件 */

                            break;

                     }

              }

       }

       catch(MessagingException me)

       {

              out.println("<error>" + me.toString() + "</error>");

       }

      

       out.println("</mail>");

}

 

MIDlet端再解析这个XML,在J2ME平台上有许多免费的XML Parserkxml就是其中的一个。可以从 http://kxml.enhydra.org/ 下载kXML 1.21的源代码,jar文件以及API文档。

 

下面是utility/HeadParser.java中处理XML的代码片断

public void parse(InputStream in) throws IOException

{

  Reader reader = new InputStreamReader(in);

  XmlParser parser = new XmlParser(reader);

  ParseEvent pe = null;

 

  parser.skip();

  /* 读一个名字为mailevent */

  parser.read(Xml.START_TAG, null, "mail");

 

  boolean trucking = true;

  boolean first = true;

 

  while (trucking)

  {

    /* 读取下一个event */

    pe = parser.read();

 

    if (pe.getType() == Xml.START_TAG)

    {

      /* 得到event的名字 */

      String name = pe.getName();

 

      if (name.equals("message"))

      {

        String from = null;

        String subject = null;

        String date = null;

        int index = -1;

 

        while ((pe.getType() != Xml.END_TAG) ||

            (pe.getName().equals(name) == false))

        {

          pe = parser.read();

          if (pe.getType() == Xml.START_TAG &&

              pe.getName().equals("subject"))

          {

            pe = parser.read();

            /* 得到event的内容 */

            subject = pe.getText();

          }

          else if (pe.getType() == Xml.START_TAG &&

              pe.getName().equals("from"))

          {

            pe = parser.read();

            from = pe.getText();

          }

          else if (pe.getType() == Xml.START_TAG &&

              pe.getName().equals("date"))

          {

            pe = parser.read();

            date = pe.getText();

          }

          else if (pe.getType() == Xml.START_TAG &&

              pe.getName().equals("index"))

          {

            pe = parser.read();

            index = Integer.parseInt(pe.getText());

          }

 

        }

       

        /* 把邮件头交给监听器处理 */

        headListener.itemParsed(from, subject, date, index);

      }

      else //Non Message block

      {

        while ((pe.getType() != Xml.END_TAG) ||

            (pe.getName().equals(name) == false))

          pe = parser.read();

      }

    }

    if (pe.getType() == Xml.END_TAG &&

          pe.getName().equals("mail"))

    {

      trucking = false;

    }

 

  }

 

具体的API的用法请大家参照kxml的文档。JSR172 (J2ME Web Services Specification)提出了在J2ME平台上处理XML的规范,有兴趣的朋友可以到jcp的网站 (http://www.jcp.org) 上看看,但目前可能还没有厂商或组织的实现。


8. 小结

本文介绍了J2ME平台上邮件程序的编写,涉及的知识点有:

1.  J2MEUI

2.  Record Store

3.  J2ME的网络连接 / J2ME J2EE之间数据的传递

4.  Parsing XML in J2ME

5.  简单的Servlet

6.  Java Mail APIs

 

 

参考资料有:

1.         MIDP2.0 Spec, http://www.jcp.org

2.         <<Core J2ME>>, http://www.corej2me.com/

3.         <<J2ME in Nutshell>>, http://www.oreilly.com

4.         Tutorial for building J2EE Applications using JBOSS and ECLIPSE, http://www.tusc.com.au/tutorial/html/

 

 


阅读全文
0 0

相关文章推荐

img
取 消
img