将 Web 应用程序部署到 Oracle 应用服务器 10g
将 Web 应用程序部署到 Oracle 应用服务器 10g
目的
在本教程中,您将使用 Oracle JDeveloper 10g 将 Web 应用程序部署到 Oracle 应用服务器 10g 或单机版 OC4J。
所需时间
30 分钟
主题
本教程包括下列主题:
查看屏幕截图
将鼠标置于此图标上以加载和查看本教程的所有屏幕截图。(警告:因为此操作会同时加载所有屏幕截图,所以网速较慢时,响应时间可能会比较长。)
注意:此外,您还可以在下列步骤中将光标放在每个单独的图标上,从而仅加载和查看与该步骤相关的屏幕截图。可以通过单击各个屏幕截图来将其隐藏。
概述
在该教程中,您将使用 JDeveloper 创建一个可部署的 J2EE web 存档,其中包含您的应用程序和一些必要的部署描述符。您将使用 JDeveloper 部署机制将应用程序部署到 Oracle 应用服务器 10g。随后,您可以测试该应用程序,使用 Oracle 企业管理器查看其性能。
在应用程序完成且按计划运行正常后,下一步就是将其部署到一个客户可以使用它的地方。
将一个应用程序部署到任意应用服务器的一般步骤基本相同。其区别主要体现在服务器的特定连接要求上。
JDeveloper 本身就具有将应用程序部署到许多应用服务器上的能力。在本教程中,您需要将应用程序部署到一个 OracleAS Containers for J2EE (OC4J) 的单机实例上。
前提条件
开始本教程之前,您应该:
1.
能够访问或已经安装了 Oracle JDeveloper 10g Studio Edition Release 3 (10.1.3) Production。可以从 Oracle 技术网下载它。
3.
能够访问或已经安装了 Oracle 示例模式。
该 OBE 使用 Oracle 数据库 10g 附带的 OE 模式。
可以在线获取有关在 JDeveloper 中安装 OE 模式并创建到其的连接的指导:
启动环境
启动应用服务器
Oracle JDeveloper 包括一个单机应用服务器(单机版 OC4J)。下列步骤说明了如何使用单机版 OC4J。
1.
打开系统上的 \jdev\bin 目录,双击 start_oc4j.bat 文件启动单机版 oc4j 应用服务器。
2.
如果这是您第一次运行 OC4J,则 OC4J 将自动安装,并提示您输入管理员帐户的口令。管理员帐户为 oc4jadmin。输入口令 welcome。
3.
安装程序将要求您再次输入口令来确认口令。
4.
当安装和启动完成后,您将看到以下消息:
Oracle Containers for J2EE 10g <10.1.3.0.0> initialized
准备好后,保持命令窗口打开。OC4J 现在处于运行状态,可投入使用了。
使用企业管理器连接到单机版 OC4J
Oracle 应用服务器 10g附带了一个基于浏览器的企业管理器 (EM)。通过该 EM 界面,您可以监视部署到应用服务器的活动和应用程序。在应用服务器运行后,您可以使用浏览器连接到 EM。以下几步将打开该界面,并简要浏览该应用服务器。JDeveloper 附带的单机版 OC4J 还包括企业管理器。
1.
随便打开一个浏览器(Firefox、Internet Explorer 或其他浏览器),输入以下地址:http://127.0.0.1:8888/em。如果您使用的不是单机版 OC4J,则该地址为:http://127.0.0.1:7777/em
2.
企业管理器 10g 提示您输入用户名和口令。用户名为 oc4jadmin,口令为 welcome(或您的管理员口令)。单击 Login 进入 EM。
3.
成功登录后,浏览器如下所示:
4.
您现在可以浏览应用程序、Web 服务以及 Oracle 应用服务器 10g 的其他组件。
6.
单击 Applications 链接,查看已加载并运行的应用程序。
Close(关闭)浏览器窗口。
安装要求的应用程序并启动 JDeveloper
开始本教程之前,您应该:
1.
右键单击以下链接,下载预先定义的应用程序。将 OrderEntry.zip 文件保存到系统本地。(即 c:\temp)
2.
双击您刚下载的 OrderEntry.zip 文件,单击 Extract 图标。
3.
指定要将该文件解压缩到的文件夹(即 \jdev\mywork)
4.
启动 JDeveloper。双击 JDeveloper 可执行文件 (jdeveloper.exe),该文件可以在您解压缩它的根目录下找到。
如果 Migrate User Settings 对话框打开,请单击 NO。
Close(关闭)Tip of the Day 窗口。
5.
单击 Applications 选项卡,从菜单选择 File > Open
6.
导航到 \jdev\mywork\,选择 OrderEntry.jws 文件,单击 Open。
现在就将该应用程序加载到了 JDeveloper 中。
创建连接和测试应用程序
创建数据库连接
Java 数据库连接 (JDBC) 是 Java 应用程序用于连接关系数据库的一种标准应用程序编程接口 (API)。JDeveloper 使用连接导航器维护应用程序的连接信息。The connection navigator makes it easy to
create, manage, and test database connections.
如果还没有创建到 OE 模式的 JDBC 连接,则执行下列步骤:
1.
单击 Applications Navigator 上的 Connections 选项卡。如果未显示 Connections 选项卡,请从 JDeveloper 主菜单中选择 View > Connection Navigator。
2.
右键单击 Database节点,从上下文菜单中选择 New Database Connection。
3.
在 Create Database Connection 向导中,查看 Welcome 页面上的信息,然后单击 Next。
4.
在 Connection Name 域中,输入 oeconn。单击 Next 继续。
5.
在 Authentication 页面上:在 Username 域中输入 oe,并在 Password 域中输入 oe。选择 Deploy password。
注:由于将口令加密了,因此部署口令是安全的。
单击 Next 继续。
6.
在 Connections 页面上,连接的默认值应如下所示:
Driver:thin
Host name:localhost
JDBC Port: 1521
SID:ORCL
保留这些域的默认值。
单击 Next 继续。
7.
单击 Test Connection。如果数据库可用且连接的详细信息正确,您将看到 Status 窗口中显示 Success!。
如果发生错误,则确认这些设置是否正确。单击 Back进行任何必要的更改,然后重新测试该连接。
如果连接成功,则单击 Finish 完成该连接。
这样您就创建了一个到数据库的连接,为您在本教程中部署的应用程序提供数据。
创建应用服务器连接
创建到 Oracle 应用服务器 10g 连接的区别基本上与创建到单机版 OC4J 的连接的区别相同,只是您需要提供的参数略有不同。
1.
单击 Applications Navigator 上的 Connections 选项卡。如果未显示 Connections 选项卡,请从 JDeveloper 主菜单中选择 View > Connection Navigator。
2.
右键单击 Connections 窗口中的 Application Server节点,并从上下文菜单中选择 New Application Server Connection。
3.
单击 Next 跳过 Create Application Server Connection 向导的 Welcome 页面。
4.
在 step 1 中,将连接命名为 OC4J,选择 Standalone OC4J 10g 10.1.3
然后单击 Next
注意:倘如您没有连接到单机版 OC4J 服务器,则请从下拉式列表中选择相应的连接类型。
5.
在 Step 2 中,输入 oc4jadmin 作为用户名并输入 welcome 作为口令。
单击 Next 继续。
6.
在 Step 3 中,输入 localhost 作为主机名
单击 Next 继续。
7.
在 Step 4 中,单击 Test Connection。如果应用服务器可用且连接的详细信息正确,您将看到 Status 窗口中显示 Success!。
如果发生错误,则确认这些设置是否正确。单击 Back进行任何必要的更改,然后重新测试该连接。
如果连接成功,则单击 Finish 完成该连接。
您刚刚创建了一个到将承载您的应用程序部署的应用服务器的连接。
测试应用程序
在部署应用程序前,用内嵌的 OC4J 服务器测试该应用程序。
为此,请执行以下步骤:
1.
单击 Applications Navigator 选项卡,展开 OrderEntry节点。
2.
右键单击 ViewController > Web Content > WEB-INF\temp\adf 中的 index.jsp,然后从上下文菜单中选择 Run。
3.
索引页面会显示在您默认的浏览器中。单击链接进入应用程序。
4.
在搜索页面中,您可以指定搜索条件,用以查询名或姓中包含特定字符串且总订单介于高值和低值(您可以指定)之间的客户。然后单击 Find 执行该查询。
5.
在详细清单页面中,选择一个行,然后单击 Edit 按钮。
6.
编辑页面显示所选记录的详细信息。
Close(关闭)浏览器窗口。
创建部署配置文件
部署配置文件是管理应用程序部署的项目组件。一个部署配置文件列出了源文件、部署描述符(按需要)以及其他将在部署包中加入的附属文件。
服务请求应用程序的部署包包含三个部分:Model 项目 (.jar)、ViewController 项目 (.war) 以及 Deployment 项目 (.ear.) 文件。您将在该教程的这一部分中为这三个部分分别创建部署配置文件。
部署 Model 项目
最先为 Model 项目创建部署配置文件。该项目的内容主要是组成该应用程序数据模型的 Java 类。该项目的部署类型为 JAR(Java 存档)文件。
为此,请执行以下步骤:
1.
返回 JDeveloper。在 Application Navigator 中,右键单击 OrderEntry > Model,然后从上下文菜单中选择 New。
2.
在 Categories 窗格的 New Gallery 中,选择 General > Deployment Profiles,然后选择 JAR File 项。
单击 OK。
3.
在 Deployment Profile 中,将 Deployment Profile Name 更改为 ModelArchive。
单击 OK
4.
在 JAR Deployment Profile Properties 中,保留默认选项。
单击 OK。
5.
在 Applications Navigator 中出现一个新条目。
单击 JDeveloper 菜单栏上的 Save All
图标,或从菜单中选择 File > Save All。
部署 ViewController 项目
接着为 ViewController 项目创建部署配置文件。该项目就是您创建该应用程序的用户界面组件的所在。该项目的部署文件是一个 .war 文件(Web 存档,用于 Web 组件)。
为此,请执行以下步骤:
1.
在 Applications Navigator 中,右键单击 ViewController 节点,然后在上下文菜单中选择 New。
2.
在 New Gallery 中,选择 Deployment Profiles 作为 Category,并选择 WAR File 作为 Item。
单击 OK。
3.
在 Deployment Profile 中,将 Deployment Profile Name 更改为 ViewArchive。
然后单击 OK
4.
在 WAR Deployment Profile Properties 中,选择 General 节点,然后在 Web Application’s Context Root 中选择 Specify j2EE Web Context Root 选项,输入 OrderEntry。
单击 OK
5.
在 Applications Navigator 中出现一个新条目。
单击 JDeveloper 菜单栏上的 Save All
图标,或从菜单中选择 File > Save All。
创建 Deployment 项目
要使应用程序的所有元素有序组织、条理清晰,您需要创建一个项目来管理应用程序的所有部署组件。该项目将管理部署配置文件和部署文件(.ear、.war、.jar)。创建部署项目的方法很简便,还可以更好的分离应用程序代码和部署设置,但这并非必要。
创建了 .jar 和 .war(Web 存档)文件,您就可以把该应用程序组装到一个可部署的包中了。在部署的组装部件中,创建一个部署配置文件来包含应用程序需要的所有 .jar 和 .war 文件,以及可能需要的其他服务器配置文件(如 data-sources.xml 文件)。
在某些情况下(如出于测试原因,或用户群很小,有必要部署一个预先配置的 jazn-data.xml 文件),您可能还要添加一个 jazn-data.xml 文件。因此,对生产系统来说,使用可通过企业管理器配置的 OID 或第三方 LDAP 服务器是一个较好的选择。
如果应用程序需要 OC4J 特定的部署文件,则需要将它们添加到模型项目中(在 EJB 情形下)或 web 应用程序项目中。由于有一个可移植的 ear 文件,因此建议在部署后在 EM 控制台中执行所有 OC4J 特定的配置。
1.
在 Application Navigator 中,右键单击 OrderEntry 节点,然后从上下文菜单中选择 New Project。
2.
在 New Gallery 中,单击General > Projects,选择 Empty Project。
单击 OK
3.
在 Create Project 对话框中,输入项目名 Deployment。
4.
在 Applications Navigator 中右键单击新的 Deployment 项目,选择 New。
5.
选择 Deployment Profiles,单击EAR File 选项。
单击 OK。
6.
输入 OrderEntryApplication 作为 Deployment Profile Name。
单击 OK
7.
在 EAR Deployment Profile Properties 中,选择 Application Assembly 节点。然后选中所有可选的复选框。
单击 OK
8.
在 Applications Navigator 中出现一个新条目。
9.
单击 JDeveloper 菜单栏上的 Save All
图标,或从菜单中选择 File > Save All。
部署应用程序和管理应用服务器
在应用服务器中部署应用程序
JDeveloper 提供了将应用程序部署到应用服务器的一键式选项。在将应用程序组装到一个 EAR 文件后,您可以右键单击部署配置文件,选择目标应用服务器。
要部署应用程序,执行以下步骤:
1.
在 Applications Navigator 中右键单击 OrderEntryApplication.deploy 节点,选择Deploy to > OC4J(先前所创建连接的名称)。
2.
在 Configure Application 对话框中,单击 OK 接受所有默认值。
注意:在部署期间,JDeveloper 重新创建 .jar 和 .war 文件,然后组装 .ear 文件。在组装完该文件后,JDeveloper 根据目标环境在应用服务器上部署该文件,并在一个目录中将其解包。
3.
打开日志窗口(如果未打开),检查部署是否成功。
4.
打开您启动 OC4J 的命令窗口,可以看到已经执行了部署。
管理应用服务器
1.
打开一个浏览器窗口,键入以下 URL http://127.0.0.1:8888/em/ 打开企业管理器控制台。注意,如果您使用的不是单机版 OC4J,则该地址为:http://127.0.0.1:7777/em
2.
使用 oc4jadmin/welcome 登录,单击 Login。
3.
在 Home 页面上,单击 Applications 链接。您应能看到刚刚部署的应用程序正处于运行状态。
单击 OrderEntryApplication 链接提供对 Application Administration 页面的访问。
4.
单击 Administration 链接。
5.
您可以看到在部署期间创建的服务。单击 JDBC Resources 的 Go To Task。
6.
部署到 Oracle 应用服务器 10g 或单机版 OC4J 的应用程序使用数据源和连接池来管理数据库访问。您应能看到为 OrderEntryApplication 创建的 Data Sources 和 Connection Pools 条目。在 Attributes Connection Pool 列中选择jdev-connection-pool-oeconn。
7.
您可以看到连接参数。注意,oe 的口令不可见。
单击 Back 按钮两次。
8.
在 Administration 页面中,选择 Security 链接。
9.
这是为部署的应用程序设置安全规则的页面。
Close(关闭)浏览器窗口。
运行应用程序
既然已经部署了应用程序,现在就可以从应用服务器运行该应用程序了。
以下几个步骤引导您完成该测试过程。
1.
打开一个浏览器窗口,并输入以下 URL:http://127.0.0.1:8888/OrderEntry/faces/index.jsp,单击 Enter the Application 链接。
2.
重新输入搜索条件,单击 Find 执行查询 query.vc
3.
从订单列表选择一个列,单击 Edit
4.
编辑页面将显示一个订单明细。
关闭浏览器窗口。您已经成功地在 Oracle 应用服务器中部署了一个预先定义的应用程序,并对其进行了测试。
总结
在本教程中,您启动了 OC4J 服务器,接着为预先定义的应用程序创建了部署配置文件,然后在单机版 OC4J 中部署了该应用程序。最后,您测试了该应用程序,并用企业管理器查看了应用服务器的 Administration 页面。您学习了如何:
启动环境
创建连接和测试应用程序
创建部署配置文件
部署应用程序和管理应用服务器
运行应用程序
将鼠标置于该图标上可以隐藏所有的屏幕截图。