java,j2ee资料:J2ME开发教程 Part II（翻译）

该信息为本站MyRSS系统缓存内容,部分图片及附件有可能无法正常使用.easyjf.com与www.javaresearch.org无关,不对该信息负责.通过http://www.javaresearch.org/article//showarticle.jsp?column=3&thread=377访问该信息的原始内容.

页面功能【加入收藏】【推荐给朋友】【字体：大中小】【关闭】

J2ME开发教程 Part II（翻译）

作者：ding　来源：www.javaresearch.org 　发布时间：2006-02-27 16:13:32.437

<LINK href="css/sunstyle.css" rel=stylesheet>
<TITLE>Java研究组织－Java微型版</TITLE>
<blockquote>
J2ME开发教程Part II 
建立端对端（End to End）Java应用程序 
 
by Jonathan Knudsen 
March 7, 2002 
Download: <a href="http://wireless.java.sun.com/midp/articles/tutorial2/src/HitServlet.java">HitServlet.java</a> <a href="http://wireless.java.sun.com/midp/articles/tutorial2/src/HitMIDlet.java">HitMIDlet.java</a> 翻译 Ding（wu_yi_ding@163.com） 日期 April 20,2002 
译者说明：本文译自(wireless.java.sun.com网站)，其著作权归原著者本人和原文档所在网站所有。译者的翻译未经原著者本人同意。翻译内容仅供自学和参考用，请读者不要擅自转载、传播本翻译内容。译者Ding对违反上述原则的人不负任何责任。特此说明。
在本教程的Part I中，我介绍了如何写一个简单的Java[tm] 2,Micro Edition (J2ME[tm]) 应用程序.。这种被称为MIDlet的应用程序被设计运行在MIDP（MobileInformation Device Profile,J2ME specification中的一种）的参考实现之上。现在我们将要教你一些更高级内容，通过本教程，你将学会如何开发一个servlet，并使用MIDlet与该servlet进行通讯。通过本教程你将掌握建立端对端无线Java应用程序的基本知识。
本文有两个版本，分别对应Tomcat和J2EE RI server这两种servlet开发环境<a href="#_edn1" name="_ednref1" title>[1]</a>。
<ul>
<li><a href="http://jakarta.apache.org/tomcat/" target="_blank">Tomcat</a> 是<a href="http://java.sun.com/products/servlet/" target="_blank">Javaservlet</a>和<a href="http://java.sun.com/products/jsp/" target="_blank">Java Server Pages (JSP)</a>的一种常见的参考实现，而且它是可以免费下载的。虽然与某些高质量的商业软件相比还显简陋，但对于开发与测试servlet来说，却不失为一种良好的选择。
<li>The <a href="http://java.sun.com/j2ee/" target="_blank">Java[tm] 2,Enterprise Edition (J2EE[tm]) Reference Implementation</a> (J2EE RI) server是对J2EE规范的一个完整的参考实现。与Tomcat相类似,开发J2EE RI server的目的并不是开发出某种商品软件，而是着眼于为开发者提供一个良好的平台，给出供我们学习、测试的原型以增加开发者的经验。与Tomcat一样，J2EE RI server 也是可以免费下载的。</li>
</ul>
这两种web server各有其特点和针对性，Tomcat 对于servlet开发来说更简单方便，但它的能力也只限于servlet和JSP开发。而J2EERI server 则是J2EE 技术的一个完整的实现－其中包括：servlet，JSP，EJB，JMS，JNDI等等……。
本文讲述的是使用Tomcat来进行servlet开发。对于对于J2EE RI版本的实现，请参考<a href="http://wireless.java.sun.com/midp/articles/tutorial2/j2eeri.html">这里</a>。
安装并运行Tomcat 
Tomcat以ZIP文档的形式发布，你可以从<a href="http://jakarta.apache.org/tomcat/" target="_blank">Apache Jakarta project</a>网站下载该文档。目前最新版本为<a href="http://jakarta.apache.org/builds/jakarta-tomcat-4.0/release/v4.0.2/" target="_blank">4.0.2</a>。
Tomcat的安装非常简单，你只需解压缩该zip文档到一个任意你指定的目录即可。我把该文件解压到我的根目录下，即c:\jakarta-tomcat-4.0.2\。
由于Tomcat 本身是由Java语言编写的。想要运行Tomcat你必须告知它你的J2SE的安装地址。要达到这一目的，你需要添加一个系统环境变量<code>JAVA_HOME</code>，并设置它的值为你的J2SE安装位置。根据你的Windows版本的不同，请参考下述的设置方法。对于Windows 2000，请用鼠标右击“我的电脑”图标，从弹出菜单中选择属性，然后选择高级，接着点击环境变量按键。选择系统变量下的新建，在弹出的输入框中填入变量名：<code>JAVA_HOME</code>和合适的变量值（该值反映你的J2SE安装位置），对于我来说，则填入变量值：<code>c:\jdk1.3.1</code>。
为了运行Tomcat，打开一个命令窗口。把改变当前目录到Tomcat'的bin目录下。然后键入<code>startup</code>回车。一个新的命令窗口将会弹出并显示一些初始化信息。下图展示了当Tomcat启动完毕的状态。
<table cellspacing="0" cellpadding="10" width="399" align="center" border="0">
<tbody>
<tr>
<td align="middle"><img alt="Tomcat's initialization messages" src="file:///I:/Documents%20and%20Settings/Administrator/My%20Documents/J2ME%20Project/finished/images/midp-articles-tutorial2-catalina.gif" border="0" width="399" height="239"> 
Tomcat's initialization messages</td>
</tr>
</tbody>
</table>
下面测试Tomcat是否运行正常。你可以用你的浏览器尝试打开http://localhost:8080/，如果Tomcat 运行正常，你会发现浏览器将显示Tomcat的默认web页面，同时页面上还有指向一些servlet和JSP 示例的链接。
关闭Tomcat只需从新打开一个命令窗口，改变当前目录到Tomcat的bin目录下，运行<code>shutdown</code>命令即可。
开始与停止Tomcat的步骤略显繁琐，建议创建两个快捷方式来运行<code>startup</code>和<code>shutdown</code>命令。<a href="#_edn2" name="_ednref2" title>[2]</a>
撰写Servlet程序 
编写servlet 程序与写其他Java程序非常类似：首先使用你喜欢的文本编辑器生成.java源文件，在本例中，我们将介绍一个非常简单的servlet 并命名为<code>HitServlet</code>。该程序只是简单地计算Sevlet被调用的次数并把该次数输出到客户端上（本示例并未考虑线程安全性，因为在此处并不需要强调这一点）。
<a href="http://wireless.java.sun.com/midp/articles/tutorial2/src/HitServlet.java">源码</a>如下所示：
<blockquote>
<pre>import javax.servlet.http.*;
import javax.servlet.*;
import java.io.*;

public class HitServlet extends HttpServlet {
 private int mCount;

 public void doGet(HttpServletRequest request,
 HttpServletResponse response)
 throws ServletException, IOException {
 String message = "Hits: " + ++mCount;

 response.setContentType("text/plain");
 response.setContentLength(message.length());
 PrintWriter out = response.getWriter();
 out.println(message);
 }
}
</pre>
</blockquote>
把源码放到哪里呢？以后我们将讲述如何部署一个webapplication 的一般步骤以及其目录结构规范。而现在我们只是简单地按如下目录结构把源文件放到Tomcat的根目录下即可：webapps/midp/WEB-INF/classes/HitServlet.java。 (这里你需要自己创建midp子目录以及其他相应的子目录。)
编译Servlet 
编译Servlet也与常规的Java 程序编译大体相同，即使用Java编译器<code>javac</code>来编译源文件。但这里请注意由于servlet API 并未包括在J2SE平台的核心部分中。所以当你编译servlet之前，你需要在你的<code>CLASSPATH</code>变量中添加servletAPI 包的位置。<a href="#_edn3" name="_ednref3" title>[3]</a>
servlet API 位于Tomcat根目录下common/lib/servlet.jar文件中。你只需要简单的修改你的<code>CLASSPATH</code>然后你就可以使用<code>javac</code>来编译HitServlet.java。请编辑你的系统属性中的<code>CLASSPATH</code>变量或是在命令行下执行下面命令：
<blockquote>
<pre>C:\>set CLASSPATH=\jakarta-tomcat-4.0.2\common\lib\servlet.jar

C:\>javac HitServlet.java <a href="#_edn4" name="_ednref4" title>[4]</a>
</pre>
</blockquote>
部署Servlet 
为了部署你的servlet，你首先要对web applications有所了解。web application 是一组静态的内容包括：HTML 、图片文件、servlet和许多其他的资源，这些资源可通过web interface来进行访问。Tomcat本身包括几个已经预先安装好的web applications ，例如在Tomcat安装目录下的webapps目录下，你可以找到这两个子目录:examples和manager。下面我们将介绍如何来生成一个新的web applicatoin 并将我们的servlet置于其中。
首先，让我们先生成一个web application。你前面已经在webapps生成了新目录midp，还在其中保存了servlet源码。现在你需要编辑Tomcat的配置文件来指定新的webapplication。首先用某个文本编辑器打开conf/server.xml文件，在该文件中，每个web applications 被描述为context。请在该文件中找到名为examples 的web applicationde的Context子项，如下所示：
<blockquote>
<pre>
<Context path="/manager" docBase="manager" 
 debug="0" privileged="true"/>
</pre>
</blockquote>
拷贝上述内容，然后把拷贝的context的名字改为midp，并把context中的几个属性分别做相应修改，然后添加一个reloadable属性，并置值为true，改动好的context如下所示：
<blockquote>
<pre>
<Context path="/midp" docBase="midp" 
 debug="0" reloadable="true" privileged="true"/>
</pre>
</blockquote>
把上述的midp context置于examples context之后，然后保存文件。
上述所作设置的实质是把收到的HTTP request映射到某个相应路径中的web application中去。更确切地说，任何以"/midp" (对应MIDP Context中的path 属性)开头的HTTP request将传递给位于"webapps/midp" (对应docBase属性)的web application 。将reloadable属性设置为true时，当我们对servlet class文件做了改动后, Tomcat会自动重载该servlet，这样就不再需要重新启动Tomcat server了，这为我们进行开发提供了便利。
好现在让我们进一步完成我们的web application。 Web application
具有标准的目录结构，这个结构是由servlets规范所定义的，这里我们不过多地讨论细节。web application的核心是一个名为web.xml 的文件，该文件描述web application的各个部分。它的位置是固定的，位于WEB-INF/web.xml。
下面为我们的web application建立自己的web.xml 文件。
我们的目的是让我们的servlet可以被外界访问，该servlet的类名<code>HitServlet</code>，为并且我们想让该servlet在目录/hits 下被访问。请注意servlet的路径是包含在web application路径下的，所以该servlet的访问路径的全称应该为：http://localhost:8080/midp/hits。拷贝下列文本，并保存为webapps/midp/WEB-INF/web.xml 。 (当然你也可以从此处<a href="http://wireless.java.sun.com/midp/articles/tutorial2/src/web.xml">下载</a>)
<blockquote>
<pre><?xml version="1.0" encoding="ISO-8859-1"?>

<!DOCTYPE web-app
 PUBLIC "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN"
 "http://java.sun.com/dtd/web-app_2_3.dtd">

<web-app>
 <servlet>
 <servlet-name>bob</servlet-name>
 <servlet-class>HitServlet</servlet-class>
 </servlet>

 <servlet-mapping>
 <servlet-name>bob</servlet-name>
 <url-pattern>/hits</url-pattern>
 </servlet-mapping>
</web-app>
</pre>
</blockquote>
该文件告诉Tomcat 我们的servlet 名为 <code>HitServlet</code>，并把其路径映射为/hits。至于 servlet-name属性，是web.xml 内部使用的，它充当了servlet 元素与servlet-mapping元素之间的联系。这里我使用了bob只是为了说明用法而已，你可选择其他自己喜欢的名称。
WEB-INF 目录下有一个标准子目录classes。该目录是Tomcat预设的寻找servlet的地方。前面我们曾经把我们的servlet源码放在了此处。这样当我们编译好源文件的同时就把servlet放置到了正确的位置。<a href="#_edn5" name="_ednref5" title>[5]</a>
现在你的servlet 已经被部署在这个新的web application中了。请注意，要使你对server.xml的改动生效，请重新启动Tomcat 。
下面测试一下一切是否正常，打开你的浏览器，指向http://localhost:8080/midp/hits。这时你应该看到<code>HitServlet</code>的输出。刷新几次页面，观察Hit值的改变。
更多关于servlet 的相关内容，请参考sun的J2EE教程中的<a href="http://java.sun.com/j2ee/tutorial/1_3-fcs/doc/Servlets.html" target="_blank">JavaServlet Technology</a>部分。
使MIDlet 与 Servlet建立联系 
这部分很有趣，我们将建立一个同时支持MIDP和servlet的开发环境并把这两个世界联系在一起来创建一个端对端的Java程序。我们在前文己经建立了一个servlet可通过HTTP访问。MIDlet一样可以通过HTTP访问servlet，所以通过MIDlet连接servlet是相当简便的。
启动J2MEWTK的KToolbar ，然后打开你在教程的PartI部分建立的MIDletproject 。我们的目的是新创建一个MIDlet用以连接我们的servlet,接收其输出并显示出来。如果你还不会创建J2ME Wireless Toolkitproject，请参考Part I 。我们要创建的<code>HitServlet</code>的源码如下：
<blockquote>
<pre>import java.io.*;

import javax.microedition.io.*;
import javax.microedition.lcdui.*;
import javax.microedition.midlet.*;

public class HitMIDlet
 extends MIDlet
 implements CommandListener {
 private Display mDisplay;
 private Form mMainForm;
 private StringItem mMessageItem;
 private Command mExitCommand, mConnectCommand;

 public HitMIDlet() {
 mMainForm = new Form("HitMIDlet");
 mMessageItem = new StringItem(null, "");
 mExitCommand = new Command("Exit", Command.EXIT, 0);
 mConnectCommand = new Command("Connect",
 Command.SCREEN, 0);
 mMainForm.append(mMessageItem);
 mMainForm.addCommand(mExitCommand);
 mMainForm.addCommand(mConnectCommand);
 mMainForm.setCommandListener(this);
 }

 public void startApp() {
 mDisplay = Display.getDisplay(this);
 mDisplay.setCurrent(mMainForm);
 }

 public void pauseApp() {}

 public void destroyApp(boolean unconditional) {}

 public void commandAction(Command c, Displayable s) {
 if (c == mExitCommand)
 notifyDestroyed();
 else if (c == mConnectCommand) {
 Form waitForm = new Form("Waiting...");
 mDisplay.setCurrent(waitForm);
 Thread t = new Thread() {
 public void run() {
 connect();
 }
 };
 t.start();
 }
 }

 private void connect() {
 HttpConnection hc = null;
 InputStream in = null;
 String url = getAppProperty("HelloMIDlet.URL");

 try {
 hc = (HttpConnection)Connector.open(url);
 in = hc.openInputStream();

 int contentLength = (int)hc.getLength();
 byte[] raw = new byte[contentLength];
 int length = in.read(raw);

 in.close();
 hc.close();

 // Show the response to the user.
 String s = new String(raw, 0, length);
 mMessageItem.setText(s);
 }
 catch (IOException ioe) {
 mMessageItem.setText(ioe.toString());
 }
 mDisplay.setCurrent(mMainForm);
 }
}
</pre>
</blockquote>
<code>HitMIDlet</code>的main screen 与HelloMIDlet类似，不同的是荧幕中多了个Connect命令。 Connect命令执行时会建立另外一个线程（thread）来调用<code>connect()</code>方法，该方法负责建立网络连接并取回结果。
拷贝上述代码，并以HitMIDlet.java 为文件名存放在apps/HelloSuite/src目录下，上述目录位于J2MEWTK的根目录下。
下面我们对<code>HitMIDlet</code>进行一些配置使之可以工作。首先，我们要告诉J2MEWTK这个新的MIDlet。点击Settings...，然后选择MIDlets 表单。点击Add，在MIDlet name和MIDlet calss中填入HitMIDlet， Icon保留为空。点击OK ，你会发现<code>HitMIDlet</code> 被列在<code>HelloMIDlet</code>之后。然后，我们需要定义一个system property 来放置<code>HitMIDlet</code>需要用来进行网络连接的URL。(即通过<code>String url = getAppProperty("HelloMIDlet.URL")</code>语句)。点击 Settings.... ，选择User Defined 表单，按Add 键，property name项填HelloMIDlet.URL ，该属性的值填入调用HitServlet的URL，即你通过浏览器可以访问该servlet的URL。填好后，点击OK 完成设定。
现在点击Build 来编译MIDlet，如果没有什么差错的话，你现在可以试着运行该程序了。首先确保你的web server已经启动，然后运行该MIDlet，执行Connect命令。如果一切正常<code>HitMIDlet</code> 会调用<code>HitServlet</code>并在模拟器上显示结果，与下图所示类似。
<table cellspacing="0" cellpadding="10" width="200" align="center" border="0">
<tbody>
<tr>
<td align="middle"><img alt="Success!" src="file:///I:/Documents%20and%20Settings/Administrator/My%20Documents/J2ME%20Project/finished/images/midp-articles-tutorial2-success.gif" border="0" width="96" height="128"> 
Success!</td>
</tr>
</tbody>
</table>
 部署Servlet的几点注意 
现在整个程序建立完成，你可以方便的修改<code>HitServlet</code>的源码，重新编译，并进行测试，当你再次调用该servlet时，Tomcat会自动使用修改过的版本。（我们前面对Tomcat的server.xml 文件中的reloadable属性的设定确保了这一点。）
如果你想添加其他的servlet，你可能需要改动该web application的web.xml文件。在这种情况下，你需要重新启动web server以使改动生效。
总结 
本教程详细介绍了如何建立端对端Java程序。Part I主要介绍如何建立并使用MIDP开发环境。而本部分着重于如果配置并使用servlet开发环境。并介绍了如何连接MIDlet与servlet，给出了一个简单的端对端Java解决方案。
servlet 可以作为我们使用J2SE与J2EE更强大的功能的入口点，使我们建立功能强大的端对端Java程序。相对简单短小的MIDlet客户端通过servlet可以获得更多的功能。
关于端对端Java应用设计的更多信息，请参考sun的<a href="http://java.sun.com/blueprints/wireless/" target="_blank">Wireless Blueprints</a> 白页。
注释 

译注<a href="#_ednref1" name="_edn1" title>[1]</a> 由于Tomcat较为常见，且本文只涉及到servlet，所以只翻译了本文的Tomcat版本，对与J2EERI server读者可参考<a href="http://wireless.java.sun.com/midp/articles/tutorial2/j2eeri.html">原文文档</a>。
译注<a href="#_ednref2" name="_edn2" title>[2]</a> 新版的Tomcat具有windows安装版，这些快捷方式在安装时就会创建。目前最新版本为4.0.3
译注<a href="#_ednref3" name="_edn3" title>[3]</a> 也可以把servlet.jar拷贝到jdk1.3\jre\lib\ext\目录下，这样就可以直接使用javac编译了。
译注<a href="#_ednref4" name="_edn4" title>[4]</a>此处有些问题，因为作者前文已经把HitServlet.java放置在webapps/midp/WEB-INF/classes目录下。这里只要记着把编译好的class文件放入上述目录即可。
译注<a href="#_ednref5" name="_edn5" title>[5]</a>这种方法用来练习还可，但真正进行servlet开发则不应鼓励，该方法把源码也放置在/classes目录下了。

<hr color="#cccccc" noshade size="1">
 About the Author: Jonathan Knudsen <a href="mailto:jonathan.knudsen@sun.com">[e-mail]</a><a href="http://jonathanknudsen.com/" target="_blank">[home page]</a> is theauthor of several books, including <a href="http://www.apress.com/catalog/book/189311550X/" target="_blank">MobileJava</a>, <a href="http://www.oreilly.com/catalog/lmstorms/" target="_blank">The Unofficial Guide to LEGO MINDSTORMS Robots</a>, <a href="http://www.oreilly.com/catalog/learnjava/" target="_blank">Learning Java</a>, and <a href="http://www.oreilly.com/catalog/java2d/" target="_blank">Java 2D Graphics</a>. Jonathan has written extensively about Java and Lego robots, including a monthly online column called <a href="http://java.oreilly.com/bite-size/">Bite-Size Java</a>, and articles for JavaWorld, EXE, NZZ Folio, and the O'Reilly Network. Jonathan holds a degree in mechanical engineering from Princeton University. 
 
关于译者：Ding （wu_yi_ding@163.com）,WWW.chinajavaworld.com论坛J2ME版版主，Java研究组织（www.javareseach.org）J2ME项目负责人。 
</blockquote>

相关文章

页面功能【加入收藏】【推荐给朋友】【字体：大中小】【关闭】