提纲:
一、配置j2ee包
1.1 企业应用的开发过程
1.2 j2ee应用包的结构
1.3 ear部署描述器
二、一个简单的实例
2.1 组件
2.2 装配应用
2.3 部署和运行应用
三、可选的应用部署描述器标记
正文:
一、配置j2ee包
在上一篇文章中,我们了解了j2ee应用封装和部署的一些基本知识,包括类装载器的不同角色和行为。接下来就可以配置和部署企业应用。为此,我们必须了解创建ear文件的过程,以及应用部署描述器的内容。
1.1 企业应用的开发过程
构造一个企业应用的过程可以归纳为:
构造各个组件,包括ejb、jsp页面、servlet和资源适配器等。
把这些组件打包成jar文件格式的j2ee模块,同时提供j2ee模块部署描述器。j2ee模块是一种具有相同类型的一个或者多个j2ee组件的集合,也就是说,一个ejb模块可以包含一个以上的ejb,一个web应用模块可以包含多个jsp页面和servlet,一个资源适配器包可以包含多个资源适配器。
结合一个或者多个j2ee模块创建ear文件,同时提供企业应用部署描述器,构造出j2ee应用。最简单的j2ee应用只包含一个j2ee模块,稍微复杂一点的j2ee应用可以由多个j2ee模块构成,更复杂的j2ee应用可以包含多个j2ee模块、模块里面包含的类所用到的依赖库。j2ee应用还可以包含描述部署过程的帮助文件和其他文档。
把j2ee应用部署到j2ee平台上。安装j2ee应用,然后把它与应用服务器提供的基础设施整合。在j2ee应用部署过程中,每一个j2ee模块按照该类模块的部署要求分别部署,每一个组件被部署到适合该组件类型的合适容器。例如,假设有一个my.ear文件,它包含my.jar和my.war。部署应用时,应用服务器的部署工具将把my.ear文件拷贝到应用服务器;接着,应用服务器的部署机制将提取出my.jar和my.war模块,按照当前平台的类装载要求分别部署这两个模块。如果这两个模块都部署成功,则整个j2ee应用部署成功。
j2ee企业应用开发和部署过程可以图示如下:
组件被封装成j2ee模块时带有一个部署描述器,j2ee模块可以通过部署工具创建。部署工具还可以用来部署和“反部署”独立的j2ee模块,用来把一个或者多个j2ee模块和另外的部署描述器封装成j2ee应用,用来把额外的内容加入j2ee应用或从j2ee应用删除某些内容,或者把整个应用部署到应用服务器上。
1.2 j2ee应用包的结构
j2ee企业应用包的结构很简单,它由一个或多个j2ee模块以及一个meta-inf/目录下名为application.xml的部署描述器构成。文件用jar格式打包,存储在扩展名为.ear的文件中。ear文件可以包含依赖库,但这是可选的。ear文件的一般结构是:
ejb .jar文件 web应用.war文件 资源适配器.rar文件 应用客户端.jar文件 依赖库.jar文件 meta-inf/ application.xml
下面是一个ear文件的例子,它包含一个ejb模块、一个web应用模块,不包含依赖库:
myfirstejb.jar myfirstweb.war meta-inf/ application.xml
保存在ear文件中的j2ee模块不一定要在根目录之下。例如,假设一个ear文件包含一个ejb模块、一个资源适配器包,它的结构可以如下:
ejbs/ mysecondejb.jar resources/ mylegacyadapter.rar meta-inf/ application.xml
最后,下面是一个包含许多组件和依赖库的ear文件:
ejbs/ mythirdejb.jar myfourthejb.jar resources/ mylegacyadapter.rar web/ mywebapp1.war mywebapp2.war lib/ myxmlx.jar mycommon.jar meta-inf/ application.xml
ear文件可以用部署工具创建,或者也可以改用jdk提供的jar工具创建。创建步骤为:
创建一个用来容纳ear文件内容的临时目录。
把所有j2ee模块放入临时目录,创建meta-inf/目录。
在meta-inf/目录下创建application.xml部署描述器。
完成上述步骤之后,进入临时目录,运行jar工具创建ear文件。
下面是一个运行jar工具的例子,它对前面例子进行打包:
jar cvf myapplication.ear ejbs resources web lib meta-inf
创建好ear文件之后,我们就可以把j2ee应用部署到应用服务器上。
1.3 ear部署描述器
理想情况下,我们用图形界面的工具编写application.xml文件。然而,有时我们必须手工构造或维护application.xml文件,因此理解application.xml文件用到的标记很重要。
application.xml部署描述器并不复杂,不需要很多标记就可以构造出一个合法的描述器。部署描述器的dtd定义的标记包括:
所有合法的j2ee应用描述器必须包含如下doctype声明:
1.3//en" "http://java.sun.com/dtd/application_1_3.dtd">
配置一个简单的application.xml部署描述器只需如下几步:
用标记声明一个企业应用。标记可以包含、和标记,供部署工具提供有关应用的描述信息使用。这些标记的内容和ejb、web应用、资源适配器部署描述器内的同一标记的内容相同。
企业应用内的每一个模块必须有一个相应的标记描述模块。ejb用标记描述,web应用用标记描述,资源适配器用标记描述,应用客户端程序用标记描述。除了标记之外,其他标记的内容都是指定ear文件内包含j2ee模块的文件的相对uri,该uri必须相对于ear文件的根。
如果企业应用包含一个web应用j2ee模块,则必须提供一个标记和一个标记。标记是一个相对uri,指定ear文件内包含j2ee模块的文件。这个uri和、、标记的uri同属一类。标记指定web应用将在其下运行的上下文的名字。所有针对该web应用内jsp页面和servlet的请求都必须加上该上下文名字作为前缀。例如,如果部署web应用时指定了:
则所有对jsp页面和servlet的请求必须是如下形式:
http://主机:端口/web1/......
在ear文件内封装的每一个web应用都要有一个唯一的值,任何两个web应用不能有相同的值。如果ear文件只包含一个web应用,的值可以是空字符串。
二、一个简单的实例
在大多数使用ear文件的情形中,企业应用包含一个ejb模块、一个web应用模块,web应用要用到ejb模块里面的ejb组件。下面的例子就属于这种情况,ejb和web应用不需要任何依赖库。下面我们来看看构造这个例子的具体过程。
2.1 组件
在这个例子中,一个servlet在无状态会话ejb的远程接口上调用invoke()方法,servlet和ejb输出一些文字信息表明程序已经成功执行。如果控制台出现异常报告,它很可能意味着组件封装存在问题。本例的所有ejb源文件都属于test包,servlet属于未命名的包。本例用到的java文件包括:
myenterpriseservlet.java:servlet的实现类,执行对ejb的调用
myenterprise.java:ejb的远程接口。
myenterprisehome.java:ejb的home接口。
myenterprisebean.java::ejb的实现类。
myenterprisebean.java的实现代码是:
package test;
import javax.ejb.*;
public class myenterprisebean implements sessionbean {
private initialcontext ctx;
public void ejbcreate() {}
public void ejbremove() {}
public void ejbactivate() {}
public void ejbpassivate() {}
public void setsessioncontext(sessioncontext c) {}
public void invoke() {
system.out.println("正在执行ejb.");
}
}
myenterpriseservlet.java servlet的实现代码是:
import javax.servlet.*;
import javax.servlet.http.*;
import java.io.*;
import javax.naming.*;
public class myenterpriseservlet extends httpservlet {
public void service(httpservletrequest req, httpservletresponse res)
throws ioexception{
res.setcontenttype("text/html;charset=gb2312");
printwriter out = res.getwriter();
try {
system.out.println("正在服务器上运行servlet");
initialcontext ctx = new initialcontext();
test.myenterprisehome ehome = (test.myenterprisehome)
ctx.lookup("myenterpriseejb");
test.myenterprise e = ehome.create();
e.invoke();
} catch(exception e) {
out.println("异常: " + e);
system.out.println("异常: " + e);
}
out.println("
out.println("");
out.println("
检查控制台确信ejb已经被调用
");out.println("");
}
}
编写好ejb和相关的部署描述器(此处不列出)之后,接下来要把ejb封装成myenterprisebean.jar文件。在jndi名称空间配置中,ejb绑定到myenterpriseejb。编写好servlet代码和相关的部署描述器(此处也不列出)之后,servlet应该封装成mywebapp.war文件。
2.2 装配应用
构造好各个
闽公网安备 35060202000074号