将 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) 的单机实例上。
返回主题列表
开始本教程之前,您应该:
返回主题列表
返回主题列表
启动应用服务器
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 页面。您学习了如何:
启动环境
创建连接和测试应用程序
创建部署配置文件
部署应用程序和管理应用服务器
运行应用程序
返回主题列表
将鼠标置于该图标上可以隐藏所有的屏幕截图。