AS7的项目部署方式与原有版本相比有了较大变化,本文通过实例来讲解AS7中的项目部署方式。
有关JBoss AS7的下载和安装,请参考蓝点上面的另一篇文章:
http://bluedash.net/spaces/JBoss%20AS%207%20快速上手
部署一个简单的Web项目
下载安装完成后,我们用standalone方式来启动JBoss AS7[1] :
liweinan@smart:~/projs/jboss-7.0.0.CR1/bin$ ./standalone.sh
启动后,我们试着向AS7中部署一个简单的项目。首先使用Maven来创建一个简单的Web工程:
mvn archetype:generate -DgroupId=com.mycompany.app -DartifactId=my-webapp -DarchetypeArtifactId=maven-archetype-webapp
生成的项目如下:
.
|-- pom.xml
`-- src
`-- main
|-- resources
`-- webapp
|-- WEB-INF
| `-- web.xml
`-- index.jsp
使用如下命令将项目打成WAR包:
mvn package
得到war:
target
`-- my-webapp.war
接下来,我们将这个war部署进AS7。在AS7的根目录下,有一个名为'standalone'的目录,当AS7以standalone模式运行时,我们要将项目部署到这里面,进入到standalone目录:
liweinan@smart:~/projs/jboss-7.0.0.CR1$ cd standalone
liweinan@smart:~/projs/jboss-7.0.0.CR1/standalone$ ls
configuration deployments log
data lib tmp
liweinan@smart:~/projs/jboss-7.0.0.CR1/standalone$
standalone目录中包含许多运行所需的内容,比如'configuration'目录包含了服务器的有关配置,我们稍后会进行说明。现在我们要关心的是'deployments'目录,我们要将需要部署的项目放在这里,JBoss AS7会自动扫描这个目录并进行部署。我们将刚刚制作好的my-webapp.war拷贝至deployments目录:
liweinan@smart:~/projs/my-webapp/target$ cp my-webapp.war ~/projs/jboss-7.0.0.CR1/standalone/deployments/
此时查看AS7的日志输出:
16:12:33,822 INFO [org.jboss.as.server.deployment] (MSC service thread 1-6) Starting deployment of "my-webapp.war"
16:12:36,616 INFO [org.jboss.web] (MSC service thread 1-4) registering web context: /my-webapp
16:12:36,740 INFO [org.jboss.as.server.controller] (DeploymentScanner-threads - 2) Deployed "my-webapp.war"
从日志中可以看出,项目被成功地部署进了AS7。我们试着访问下已部署的服务:
可以看到部署成功。
AS7中项目的自动部署及手工部署
我们在上一节通过将项目拷贝至deployments目录,就实现了AS7对项目的自动扫描及自动部署。实际上AS7还支持手工的部署模式,这样,我们就可以控制项目的部署及启动时机。配置AS7的部署模式有两种方式:一个是通过在配置文件指定,另一个是在AS7运行时,通过管理端来进行实时的配置。
我们首先来看一下配置文件中的内容,JBoss AS7相对以前版本比较,大大简化了精减了配置文件的数量。原来的*-ds.xml等数据库的配置文件,都被合并至了统一的配置文件:standalone.xml[3] 。这个文件位于刚才提到的/standalone/configuration目录当中,详细讲解这个配置文件也不是这篇文章要关注的地方,因此我们只需要了解一下这个配置文件中,与部署有关的这段内容[4] :
<subsystem xmlns="urn:jboss:domain:deployment-scanner:1.0">
<deployment-scanner scan-interval="5000"
relative-to="jboss.server.base.dir" path="deployments" />
</subsystem>
可以看到,配置中指定deployment-scanner去扫描deployments目录,扫描间隔为5秒钟。
除了在配置文件中进行配置,我们也可以在AS7实时运行时,通过管理端来改变AS7的部署方式。首先是登录到管理端,使用AS7中bin目录中带有的管理端连接程序jboss-admin.sh
liweinan@smart:~/projs/jboss-7.0.0.CR1/bin$ ./jboss-admin.sh
You are disconnected at the moment. Type 'connect' to connect to the server or 'help' for the list of supported commands.
[disconnected /] connect 127.0.0.1
Connected to standalone controller at 127.0.0.1:9999
[standalone@127.0.0.1:9999 /]
连接成功后,我们可以查看当前的scanner配置:
[standalone@127.0.0.1:9999 /] /subsystem=deployment-scanner:read-resource(recursive=true)
{
"outcome" => "success",
"result" => {"scanner" => {"default" => {
"auto-deploy-exploded" => false,
"auto-deploy-zipped" => true,
"deployment-timeout" => 60L,
"name" => "default",
"path" => "deployments",
"relative-to" => "jboss.server.base.dir",
"scan-enabled" => true,
"scan-interval" => 5000
}}}
}
如上所示,和配置文件中对应的配置是一致的。我们可以移除这个自动扫描的scanner:
[standalone@127.0.0.1:9999 /] /subsystem=deployment-scanner/scanner=default:remove
{"outcome" => "success"}
此时再次查看:
[standalone@127.0.0.1:9999 /] /subsystem=deployment-scanner:read-resource(recursive=true)
{
"outcome" => "success",
"result" => {"scanner" => undefined}
}
自动部署用的scanner已经被移除了。此时,我们将只可以用命令来手工部署所需项目,下面是手工部署的命令:
[standalone@127.0.0.1:9999 /] deploy /Users/liweinan/projs/my-webapp/target/my-webapp.war
'my-webapp.war' deployed successfully.
实验完成后,我们将刚刚移除的自动部署扫描器恢复回来:
[standalone@127.0.0.1:9999 /] /subsystem=deployment-scanner/scanner=default:add(scan-interval=5000,relative-to="jboss.server.base.dir",path="deployments")
{"outcome" => "success"}
这样,AS7又可以自动扫描deployments目录下面的项目,并进行自动部署了。实际上,AS7支持用户添加多个scanner,每一个scanner都可以独立配置,扫描不同的目录,设置不同的扫描间隔。通过上面的命令举一反三即可按照实际需求进行配置。
在AS7中部署一个J2EE项目
接下来我们试着将一个完整的J2EE项目部署进AS7,这个项目包括:
* 数据层,使用Hibernate及JPA Annotation来建模,后面连接AS7的数据源
* 逻辑层,使用JBoss Seam,EJB3来实现
* 表现层:使用JSF
* WebService:使用RESTEasy来实现
上面所使用的Hibernate, Seam,RESTEasy等模块,都是AS7中的默认配置,不需要额外进行配置,因此我们使用这样的一种技术架构。这个项目看起来用了不少东西,似乎很复杂,其实JBoss社区已经给我们做好了一个demo工程,使用到了上面的所有框架,我们把它直接拿过来用[2] ,使用下面的命令来创建这个项目:
mvn archetype:generate -DarchetypeArtifactId=jboss-javaee6-webapp -DarchetypeGroupId=org.jboss.weld.archetypes -DarchetypeVersion=1.0.1.Beta1 -DgroupId=net.bluedash -DartifactId=demo -Dversion=1.0-SNAPSHOT
有关这个项目的详细解说,在此就不展开了,Weld、EJB3、Hibernate的使用并不是本文的重点,我们仍然把注意力放在AS7的项目部署方面。总之,现在给这个项目进行打包:
mvn package
需要特别注意的是,编译这个项目需要Maven的版本至少在3.0以上,2.x是无法正确编译的,如果你的Maven版本过低,要注意更新版本至Maven 3。
打包完成后,我们将项目拷贝至deployments目录进行自动部署:
liweinan@smart:~/projs/jboss-7.0.0.CR1/standalone/deployments$ cp /Users/liweinan/projs/demo/target/demo.war .
此时服务器日志输出如下:
19:31:32,574 INFO [org.jboss.as.controller] (DeploymentScanner-threads - 2) Service status report
New missing/unsatisfied dependencies:
service jboss.naming.context.java.jdbc/__default (missing)
服务器报错说没有找到__default这个数据源。这是由于我们在项目中没有使用AS7中存在的数据源造成的。我们首先要知道AS7中的数据源配置在哪里,在上一节我们已经了解到,当服务器运行于standalone模式的时候,大部分的配置集中保存在standalone/configuration/standalone.xml当中,我们打开这个文件,看一下数据源配置方面的内容:
<subsystem xmlns="urn:jboss:domain:datasources:1.0">
<datasources>
<datasource jndi-name="java:jboss/datasources/ExampleDS" pool-name="H2DS" enabled="true" jta="true" use-java-context="true" use-ccm="true">
...
</datasource>
</datasources>
</subsystem>
可以看到,AS7默认自带了一个数据源,绑定在java:jboss/datasources/ExampleDS这个JNDI名称之上,我们要在demo项目中使用这个数据源。打开demo项目中的数据源配置文件:
liweinan@smart:~/projs/demo$ vi src/main/resources/META-INF/persistence.xml
将其中的JNDI数据源配置内容:
<jta-data-source>jdbc/__default</jta-data-source>
修改成AS7中提供给我们的数据源:
<jta-data-source>java:jboss/datasources/ExampleDS</jta-data-source>
保存后,使用mvn package命令将项目重新打包,然后将新的项目的war拷贝到AS7的deployments目录。但是在拷贝之间请稍等一下!我们看一下目前deployments目录中的内容:
liweinan@smart:~/projs/jboss-7.0.0.CR1/standalone/deployments$ ls
README.txt demo.war demo.war.failed
可以看到,此时deployments目录中有一个demo.war.failed文件,这个文件被称为 "Mark File",即标记文件,它的文件名与项目文件名相同,但同时带有一个后缀。AS7用这样的Mark File来完成两个任务,一个是表示待部署项目的状态,另一个是在自动部署的基础上,给用户提供一些手工控制部署的能力。此时的demo.war.failed这个Mark File显然是表示状态的,failed说明demo.war刚刚部署失败的情况。
理解了Mark File,我们可以将新的war拷贝至deployments目录了:
liweinan@smart:~/projs/jboss-7.0.0.CR1/standalone/deployments$ cp /Users/liweinan/projs/demo/target/demo.war .
拷贝完成后,就把deployments目录里面之前有问题的demo.war给覆盖掉了。此时AS7是不会自动重新部署这个项目的,这是出于可靠性考虑,AS7不会未经用户明确指定,就把一个已有的同名项目的部署状态覆盖掉,即使它是部署失败的。此时我们就要用Mark File来控制AS7的部署了,我们建立一个名为demo.war.dodeply的空文件,使AS7重新部署demo.war这个项目:
liweinan@smart:~/projs/jboss-7.0.0.CR1/standalone/deployments$ touch demo.war.dodeploy
此时,AS7便开始重新部署项目了。如果你的手足够快,此时看一下deployments中的内容
liweinan@smart:~/projs/jboss-7.0.0.CR1/standalone/deployments$ ls
README.txt demo.war.dodeploy demo.war.isdeploying
demo.war demo.war.failed
会发现多出一个demo.war.isdeploying,表明项目正在部署。等部署完成后,deployments目录中的内容就变成了:
liweinan@smart:~/projs/jboss-7.0.0.CR1/standalone/deployments$ ls
README.txt demo.war demo.war.deployed
这样,新的项目便部署完成了,如果没有操作上的失误的话,这个项目已经可以可以访问到了:
小结
本文讲解了AS7下面的自动部署、手工部署的方法,同时讲解了管理端下面与部署相关的一些命令,以及standalone.xml配置文件中的一些内容;最后,我们讲解了Mark File的使用方法。希望通过本文,可以帮助大家进行AS7更为深入的学习和使用。
备注
[1] JBoss AS7 包含standalone及domain两种运行方式。有关JBoss AS7的domain运行方式,请参考蓝点上面的这篇文章:
http://bluedash.net/spaces/JBoss%20AS7中的新概念-域
[2] 关于这个项目的详细说明,请参考蓝点上面的另一篇文章:
http://bluedash.net/spaces/Java%20EE%206%20入门
[3] domain运行模式下面的配置模式有所不同,请参考这篇文章:
http://bluedash.net/spaces/JBoss%20AS7中的新概念-域
[4] 如果要对AS7的部署进行更深入的了解和学习,需要参考AS7的管理员手册的相关章节:
https://docs.jboss.org/author/display/AS7/Admin+Guide#AdminGuide-DeploymentScanner
- 大小: 68.5 KB
- 大小: 29.4 KB
分享到:
相关推荐
通过《JBoss AS7培训教程》系列文档,你将逐步了解并掌握JBoss AS7的各项功能和操作技巧,从而在实际项目中充分利用其优势,提升开发和运维效率。请依次阅读提供的PDF文件,从第一部分开始,逐步深入学习。
[Packt Publishing] JBoss AS 7 配置部署管理教程 (英文版) [Packt Publishing] JBoss AS 7 Configuration, Deployment and Administration (E-Book) ☆ 出版信息:☆ [作者信息] Francesco Marchioni [出版机构...
- **5.3.3 管理资源**:介绍了如何管理和配置JBoss AS7中的资源。 - 如数据源、JMS队列和主题、安全领域等。 ##### 5.4 管理任务 - **5.4.1 接口和端口**:讲解了如何配置网络接口和端口。 - 涉及HTTP/HTTPS监听...
在jboss7中,项目部署可以通过多种方式实现,例如,可以将项目打包成war、ear或rar包,然后将其部署到jboss7中也可以使用jboss提供的部署工具来实现项目部署。在部署项目时,需要注意依赖关系的处理,例如,需要将...
JBoss AS 7(Application Server 7)是JBoss系列中的一个重要版本,它标志着JBoss AS在技术架构上的一次重大革新。本文将详细介绍JBoss AS 7的历史背景、设计初衷、核心技术和内部结构,并通过实例来帮助读者更好地...
官方下载地址为http://labs.jboss.com/jbossas/downloads/,你可以在这里获取最新的JBoss应用服务器版本。本文以JBoss 4.2.2.GA为例进行讲解。 【安装与解压】 安装JBoss非常简单,只需将下载的压缩包解压到指定的...
4. **部署配置**:将编译好的应用打包成WAR或EAR文件,并通过JBoss AS 5的部署目录或者管理控制台进行部署。 5. **测试与调试**:利用JBoss AS 5自带的工具或外部工具进行功能测试和性能调优。 #### 四、JBoss AS 5...
通过以上步骤,我们完成了MyEclipse中JBoss的配置,这使得开发者能够在MyEclipse环境中便捷地进行Java EE应用的开发、测试和部署。值得注意的是,不同版本的MyEclipse和JBoss可能会有一些细微差别,根据实际情况进行...
手册中还提到了如何利用JBoss AS7的管理API进行远程部署和管理。 在管理方面,JBoss AS7提供了Web管理控制台,通过这个控制台用户可以进行服务器的监控和管理。手册中详细介绍了管理控制台的使用方法,以及如何通过...
这表明读者将能学习到如何在JBoss AS 7上进行应用的全生命周期管理,从构建、测试、部署到运行时的性能监控与安全管理。 关于标签“packt ebook”,表明这本书是由Packt Publishing公司出版的电子书籍。Packt ...
在JBoss AS7中部署应用,可以利用其提供的服务,如EJB、JPA、JMS等,来构建复杂的企业级系统。 Seam Remoting是Seam框架的一部分,它是一个用于简化Java EE开发的全栈框架。Seam Remoting允许在客户端和服务器之间...
至此,开发者就可以在 Eclipse 中对 JBoss AS7 进行启动、停止和应用部署等操作,同时还能在 "Console" 视图查看服务器的运行日志,便于调试和问题排查。 总的来说,JBoss AS7、JBoss Tools 和 Eclipse Indigo 3.7 ...
在这个"remoting-jpa-testprog"项目中,我们可以期待看到如何在JBoss AS 7上配置和部署一个应用,该应用利用Seam Remoting进行远程方法调用,并使用JPA和Hibernate来管理持久化数据。开发者可能已经创建了一个简单的...
3. **嵌入式部署**:JBoss7支持嵌入式部署,意味着你可以直接在你的应用代码中启动和控制JBoss实例,无需单独运行服务器进程,这对于测试和开发环境尤其便利。 4. **CLI和Management API**:JBoss7提供了强大的...
这个版本在2012年发布,是JBoss AS 7系列的一个稳定版本,它引入了许多重要的特性和改进。 1. **模块化架构**:JBoss AS 7.1.1.Final采用了全新的模块化设计,这使得应用服务器的启动速度更快,内存占用更少。每个...
将这两个插件添加到项目中,开发者可以保持原有的Spring架构不变,同时利用JBoss AS的高级特性,如集群、安全管理、EJB支持等。迁移过程中的主要工作将是调整应用配置,以适应新的服务器环境,并测试所有功能的正确...
### JBoss AS5 安装与上手指南详解 #### 一、引言 JBoss Application Server (简称 JBoss AS) 是一款...通过本文档提供的安装和上手指南,开发者可以快速地在其开发环境中搭建起 JBoss AS5,并开始构建企业级应用。