使用 Eclipse 开发环境来开发 Java App Engine 应用程序非常简单,就和开发任何其他基于 servlet 的网络应用程序一样。如果使用 Eclipse Google 插件,将会更加简单。该插件允许您从 Eclipse 中创建、测试和上传 App Engine 应用程序。
通过 Eclipse Google 插件,使用 Google Web 工具包 (GWT) 来开发应用程序以在 App Engine 或任何其他环境中运行也很简单。
本文说明了如何安装 Eclipse Google 插件、新建 App Engine 项目以及使用在 Eclipse 内运行的开发服务器来调试项目。本文还说明了如何使用插件将您的项目上传到 App Engine。
有关插件的详细信息(包括如何将其用于 Google Web 工具包项目),请参阅 Eclipse Google 插件文档。
获取 Eclipse
安装 Eclipse Google 插件
创建项目
运行项目
上传到 Google App Engine
运行命令行工具
获取 Eclipse
您可以从 Eclipse 网站获取 Eclipse。“Eclipse IDE for Java EE Developers”包括了您在网络应用程序开发中所需的所有组件。
Eclipse Google 插件可用于 Eclipse 3.3 (Europa) 或 Eclipse 3.4 (Ganymede)。
除了 Eclipse Google 插件以外,我们还推荐在网络开发中使用 Web Tools Platform (WTP) 插件。请参阅 Web Tools Platform 网址。此外,WTP 提供了用于 JSP 和 HTML 文件的编辑模式。
安装 Eclipse Google 插件
您可以使用 Eclipse 的软件更新功能来安装 Eclipse Google 插件。
要使用 Eclipse 3.4 (Ganymede) 安装插件,请执行以下操作:
选择帮助菜单 > 软件更新...。出现“软件更新和插件”窗口。
选择可用软件选项卡。点击添加站点...按钮。出现“添加站点”窗口。在“位置”中输入插件的 Eclipse 3.4 版的安装位置: http://dl.google.com/eclipse/plugin/3.4点击确定。对话框关闭,新的位置已添加到可用软件的列表中。
点击新安装位置旁边的三角形,然后点击“Google”旁边的三角形以显示安装选项。选中“Eclipse 3.4 Google 插件”和“Google App Engine Java SDK”旁边的复选框。如果您想要将 Google Web 工具包用于您的应用程序,那么也可以选择“Google Web 工具包”。点击安装...按钮。按照提示接受服务条款,然后安装插件。
注意:插件的安装过程可能要花费几分钟才能完成,因为 Eclipse 会更新依存关系。有关详细信息,请参阅常见问题解答。
安装完成后,Eclipse 将提示您重新启动。点击是。Eclipse 重新启动。插件已安装。
为 Eclipse 3.3 (Europa) 安装插件的过程是类似的,不同的是提示信息和安装位置。Eclipse 3.3 Google 插件的位置如下:
http://dl.google.com/eclipse/plugin/3.3有关软件更新的详细信息,请参阅 Eclipse 文档。
创建项目
要新建 App Engine 项目,请执行以下操作:
选择文件菜单 > 新建 > 网络应用程序项目(如果您没有看到该菜单选项,请选择窗口菜单 > 重置视角...,点击确定,然后再次尝试文件菜单。)或者,点击工具栏上的“新建网络应用程序项目”按钮:。
出现“创建网络应用程序项目”向导。在“项目名称”中,输入项目的名称,例如对于使用入门指南中所述的项目,可输入 Guestbook。在“包”中输入相应的包名称,如 guestbook。
如果您没有使用 Google Web 工具包,请取消选择“Google Web 工具包”。确认已选中“使用 Google App Engine”。
如果您使用软件更新来安装 App Engine SDK,则插件已配置为使用安装的 SDK。如果您要使用独立的 App Engine SDK 安装程序,请点击配置 SDK...,然后根据提示为 SDK appengine-java-sdk/ 目录添加配置。
点击完成以创建项目。
该向导为项目创建目录结构,包括 Java 源文件的 src/ 目录,以及编译类和其他应用程序文件、库、配置文件、静态文件(如图像和 CSS)及其他数据文件的 war/ 目录。该向导还创建一个 servlet 源文件和两个配置文件。完整的目录结构如下:
Guestbook/
src/
guestbook/
server/
GuestbookServlet.java
META-INF/
jdoconfig.xml
log4j.properties
logging.properties
war/
WEB-INF/
lib/
...App Engine JARs...
appengine-web.xml
web.xml
index.html
war/ 目录使用 WAR 标准布局来捆绑网络应用程序。(SDK 目前尚不支持 WAR 档案文件。)Eclipse 插件使用该目录来运行开发服务器,并将应用程序部署到 App Engine。
Eclipse 在构建项目时会在 war/WEB-INF/ 中创建一个名为 classes/ 的目录,并将已编译的类文件放入该目录。Eclipse 还将 src/ 中的非源文件复制到 war/WEB-INF/classes/,包括 META-INF/、log4j.properties 和 logging.properties 文件。war/ 目录的最终内容构成应用程序,以进行测试和部署。
有关插件所创建的新项目的详细信息,请参阅使用入门指南。
运行项目
App Engine SDK 中包含一个用于在模拟环境下测试应用程序的网络服务器。Eclipse Google 插件为运行菜单新增了一些菜单项,用来启动该服务器。
要在 Eclipse 调试器内运行网络服务器中的应用程序,请选择运行菜单,调试为 > 网络应用程序。Eclipse 构建项目,切换到调试视角,然后启动服务器。如果服务器成功启动,则会在控制台中显示几条消息,包括类似如下的消息:
The server is running at http://localhost:8080/如果您要自定义服务器的启动方式,可以新建一个类型为“网络应用程序”的运行/调试配置。
要测试插件所创建的新应用程序,请按上文所述启动服务器,然后在浏览器中访问以下网址(使用应用程序相应的网址路径):
http://localhost:8080/guestbook
通过 Eclipse,您可以在更改源代码、JSP、静态文件和 appengine-web.xml 的同时保持服务器在调试器中的运行。当您保存对源代码的更改时,Eclipse 自动对类进行编译,然后尝试将其动态插入正在运行的网络服务器中。在大多数情况下,您只需将页面重新载入到浏览器中即可测试新版本的代码。对于 JSP、静态文件和 appengine-web.xml 的更改会由开发服务器自动识别,而且无需重新启动服务器即可生效。如果您更改了 web.xml 或其他配置文件,则必须在停止并重新启动服务器后才能使更改生效。
要停止服务器,请确保选择调试面板,然后点击“终止”按钮:
上传到 Google App Engine
Eclipse Google 插件为 Eclipse 工具栏添加了几个按钮。使用“App Engine 部署”按钮可将应用程序上传到 App Engine:
在第一次上传应用程序之前,必须使用管理控制台注册一个 App Engine 的应用程序 ID。注册应用程序 ID,然后编辑 appengine-web.xml 文件并将 <application>...</application> 元素更改为包含新 ID。
在您点击“App Engine 部署”按钮后,Eclipse 将提示您输入管理员帐户用户名(您的电子邮件地址)和密码。输入您的帐户信息然后点击上传按钮,完成上传。Eclipse 将从 appengine-web.xml 文件获取应用程序 ID 和版本信息,并上传 war/ 目录的内容。
通过访问应用程序的网址,在 App Engine 上测试应用程序:
http://<your application ID>.appspot.com/guestbook
运行命令行工具
App Engine Java SDK 工具的某些功能只有通过直接从命令行运行工具才能使用。如果您已使用 Eclipse 安装了 SDK,则可以从 Eclipse 插件安装目录运行这些工具。
SDK 位于 Eclipse 安装目录下的 plugins/com.google.appengine.eclipse.sdkbundle_VERSION/ 中,其中 VERSION 是 SDK 的版本标识符。该目录中的 appengine-java-sdk/bin/ 子目录包含工具。
注意:如果您使用的是 Mac OS X 或 Linux,则必须先对命令文件授予可执行权限,然后才能运行。例如,要对 appcfg.sh 授予可执行权限,请从 appengine-java-sdk/bin/ 目录输入以下命令:chmod u+x appcfg.sh
有关通过命令行才能使用的功能的详细信息,请参阅上传和管理。
通过 Eclipse Google 插件,使用 Google Web 工具包 (GWT) 来开发应用程序以在 App Engine 或任何其他环境中运行也很简单。
本文说明了如何安装 Eclipse Google 插件、新建 App Engine 项目以及使用在 Eclipse 内运行的开发服务器来调试项目。本文还说明了如何使用插件将您的项目上传到 App Engine。
有关插件的详细信息(包括如何将其用于 Google Web 工具包项目),请参阅 Eclipse Google 插件文档。
获取 Eclipse
安装 Eclipse Google 插件
创建项目
运行项目
上传到 Google App Engine
运行命令行工具
获取 Eclipse
您可以从 Eclipse 网站获取 Eclipse。“Eclipse IDE for Java EE Developers”包括了您在网络应用程序开发中所需的所有组件。
Eclipse Google 插件可用于 Eclipse 3.3 (Europa) 或 Eclipse 3.4 (Ganymede)。
除了 Eclipse Google 插件以外,我们还推荐在网络开发中使用 Web Tools Platform (WTP) 插件。请参阅 Web Tools Platform 网址。此外,WTP 提供了用于 JSP 和 HTML 文件的编辑模式。
安装 Eclipse Google 插件
您可以使用 Eclipse 的软件更新功能来安装 Eclipse Google 插件。
要使用 Eclipse 3.4 (Ganymede) 安装插件,请执行以下操作:
选择帮助菜单 > 软件更新...。出现“软件更新和插件”窗口。
选择可用软件选项卡。点击添加站点...按钮。出现“添加站点”窗口。在“位置”中输入插件的 Eclipse 3.4 版的安装位置: http://dl.google.com/eclipse/plugin/3.4点击确定。对话框关闭,新的位置已添加到可用软件的列表中。
点击新安装位置旁边的三角形,然后点击“Google”旁边的三角形以显示安装选项。选中“Eclipse 3.4 Google 插件”和“Google App Engine Java SDK”旁边的复选框。如果您想要将 Google Web 工具包用于您的应用程序,那么也可以选择“Google Web 工具包”。点击安装...按钮。按照提示接受服务条款,然后安装插件。
注意:插件的安装过程可能要花费几分钟才能完成,因为 Eclipse 会更新依存关系。有关详细信息,请参阅常见问题解答。
安装完成后,Eclipse 将提示您重新启动。点击是。Eclipse 重新启动。插件已安装。
为 Eclipse 3.3 (Europa) 安装插件的过程是类似的,不同的是提示信息和安装位置。Eclipse 3.3 Google 插件的位置如下:
http://dl.google.com/eclipse/plugin/3.3有关软件更新的详细信息,请参阅 Eclipse 文档。
创建项目
要新建 App Engine 项目,请执行以下操作:
选择文件菜单 > 新建 > 网络应用程序项目(如果您没有看到该菜单选项,请选择窗口菜单 > 重置视角...,点击确定,然后再次尝试文件菜单。)或者,点击工具栏上的“新建网络应用程序项目”按钮:。
出现“创建网络应用程序项目”向导。在“项目名称”中,输入项目的名称,例如对于使用入门指南中所述的项目,可输入 Guestbook。在“包”中输入相应的包名称,如 guestbook。
如果您没有使用 Google Web 工具包,请取消选择“Google Web 工具包”。确认已选中“使用 Google App Engine”。
如果您使用软件更新来安装 App Engine SDK,则插件已配置为使用安装的 SDK。如果您要使用独立的 App Engine SDK 安装程序,请点击配置 SDK...,然后根据提示为 SDK appengine-java-sdk/ 目录添加配置。
点击完成以创建项目。
该向导为项目创建目录结构,包括 Java 源文件的 src/ 目录,以及编译类和其他应用程序文件、库、配置文件、静态文件(如图像和 CSS)及其他数据文件的 war/ 目录。该向导还创建一个 servlet 源文件和两个配置文件。完整的目录结构如下:
Guestbook/
src/
guestbook/
server/
GuestbookServlet.java
META-INF/
jdoconfig.xml
log4j.properties
logging.properties
war/
WEB-INF/
lib/
...App Engine JARs...
appengine-web.xml
web.xml
index.html
war/ 目录使用 WAR 标准布局来捆绑网络应用程序。(SDK 目前尚不支持 WAR 档案文件。)Eclipse 插件使用该目录来运行开发服务器,并将应用程序部署到 App Engine。
Eclipse 在构建项目时会在 war/WEB-INF/ 中创建一个名为 classes/ 的目录,并将已编译的类文件放入该目录。Eclipse 还将 src/ 中的非源文件复制到 war/WEB-INF/classes/,包括 META-INF/、log4j.properties 和 logging.properties 文件。war/ 目录的最终内容构成应用程序,以进行测试和部署。
有关插件所创建的新项目的详细信息,请参阅使用入门指南。
运行项目
App Engine SDK 中包含一个用于在模拟环境下测试应用程序的网络服务器。Eclipse Google 插件为运行菜单新增了一些菜单项,用来启动该服务器。
要在 Eclipse 调试器内运行网络服务器中的应用程序,请选择运行菜单,调试为 > 网络应用程序。Eclipse 构建项目,切换到调试视角,然后启动服务器。如果服务器成功启动,则会在控制台中显示几条消息,包括类似如下的消息:
The server is running at http://localhost:8080/如果您要自定义服务器的启动方式,可以新建一个类型为“网络应用程序”的运行/调试配置。
要测试插件所创建的新应用程序,请按上文所述启动服务器,然后在浏览器中访问以下网址(使用应用程序相应的网址路径):
http://localhost:8080/guestbook
通过 Eclipse,您可以在更改源代码、JSP、静态文件和 appengine-web.xml 的同时保持服务器在调试器中的运行。当您保存对源代码的更改时,Eclipse 自动对类进行编译,然后尝试将其动态插入正在运行的网络服务器中。在大多数情况下,您只需将页面重新载入到浏览器中即可测试新版本的代码。对于 JSP、静态文件和 appengine-web.xml 的更改会由开发服务器自动识别,而且无需重新启动服务器即可生效。如果您更改了 web.xml 或其他配置文件,则必须在停止并重新启动服务器后才能使更改生效。
要停止服务器,请确保选择调试面板,然后点击“终止”按钮:
上传到 Google App Engine
Eclipse Google 插件为 Eclipse 工具栏添加了几个按钮。使用“App Engine 部署”按钮可将应用程序上传到 App Engine:
在第一次上传应用程序之前,必须使用管理控制台注册一个 App Engine 的应用程序 ID。注册应用程序 ID,然后编辑 appengine-web.xml 文件并将 <application>...</application> 元素更改为包含新 ID。
在您点击“App Engine 部署”按钮后,Eclipse 将提示您输入管理员帐户用户名(您的电子邮件地址)和密码。输入您的帐户信息然后点击上传按钮,完成上传。Eclipse 将从 appengine-web.xml 文件获取应用程序 ID 和版本信息,并上传 war/ 目录的内容。
通过访问应用程序的网址,在 App Engine 上测试应用程序:
http://<your application ID>.appspot.com/guestbook
运行命令行工具
App Engine Java SDK 工具的某些功能只有通过直接从命令行运行工具才能使用。如果您已使用 Eclipse 安装了 SDK,则可以从 Eclipse 插件安装目录运行这些工具。
SDK 位于 Eclipse 安装目录下的 plugins/com.google.appengine.eclipse.sdkbundle_VERSION/ 中,其中 VERSION 是 SDK 的版本标识符。该目录中的 appengine-java-sdk/bin/ 子目录包含工具。
注意:如果您使用的是 Mac OS X 或 Linux,则必须先对命令文件授予可执行权限,然后才能运行。例如,要对 appcfg.sh 授予可执行权限,请从 appengine-java-sdk/bin/ 目录输入以下命令:chmod u+x appcfg.sh
有关通过命令行才能使用的功能的详细信息,请参阅上传和管理。