如何快速高效地开发和调试基于gradle管理的web应用

Posted 2020-08-11 胡清晨java指南

本文探讨如何高效快速地开发和调试基于gradle管理的web应用。 

gradle是新一代应用构建、版本发布管理工具，功能强大而灵活，号称将取代maven的霸主地位，但是目前在开发和调试web应用程序方面还有很多不足，效率低下。 

那么我们能不能基于gradle强大而灵活的功能，探寻出一种简单、高效、便捷的方法，以便在调试web应用过程中修改程序无需重启应用服务器和应用呢?答案是肯定的，接下来就给大家分享bboss开发团队在使用gradle开发调试web应用所使用的行之有效的工具和方法。 

工具和方法涉及的技术 

1.gradle自定义sourceSet测试源码集技术 
2.jetty嵌入式启动技术 
3.gradle compileOnly级别包依赖技术（gradle 3.0及以上版本支持） 
4.采用bboss ioc管理jetty 应用配置 

工具集成和使用 

我们直接使用本文附件中包含的工具小程序来调试web应用，这是一个通用的小工具，可以按照以下步骤将这个工具集成到自己web应用对应的gradle工程中。注意：我们将工具对应的程序放置到工程的测试源码目录下面，将工具依赖的jar包级别定义为compileOnly,这样可以避免将工具对应的程序、配置和jar发布到最终的项目版本中（真正的绿色无污染）。 

第一步 集成调试web应用工具 
工具包含启动jetty容器的程序和配置文件，这些文件包含在本文附件中，点击这里下载：下载 

 

将解压后的test目录中的org目录复制到gradle工程的测试源码目录下即可，gradle可以灵活指定项目的测试源码目录，本文对应的是test目录，通过其中的类org.eclipse.jetty.webapp.JettyStart来启动和调试web应用。 

下面说明一下目录test\org\eclipse\jetty\webapp下面三个文件的作用： 

1.jetty.xml 
文件内容： 

Xml代码  

1. <properties>  
2.     <property name="port" value="9081"/>    
3.     <property name="context" value="wowo-frontend"/>    
4.     <property name="webxml" value="./WebRoot/WEB-INF/web.xml"/>    
5.     <property name="resourceBase" value="./WebRoot"/>    
6.       
7. </properties>  

文件作用：配置jetty端口port，应用上下文context，应用部署描述文件web.xml位置，应用路径resourceBase，这两个路径都是相对于gradle工程根目录，可以根据需要调整相关配置。 

2.webdefault.xml 
这个文件内容比较多，已经配置好，无需修改，我们只需关注其中一个配置项 
useFileMappedBuffer： 

Xml代码  

1. <init-param>  
2.       <param-name>useFileMappedBuffer</param-name>  
3.       <param-value>false</param-value>  
4.     </init-param>  

useFileMappedBuffer必须设置为false，否则在调试的过程中js文件会被锁定，导致js文件无法进行修改。 

3. JettyStart.java 
在JettyStart的Main方法中，利用bboss ioc加载配置文件jetty.xml，然后启动jetty服务器和web应用。通过执行JettyStart程序，就可以像调试和运行普通的java程序一样调试和运行gradle管理web应用，可以在调试过程中自动加载修改的程序和资源配置文件，避免因修改程序而反复构建、发布和部署应用，大大提升开发和调试的效率。目前工具只支持Http协议，可以通过扩展JettyStart类方便地提供对Https协议的支持。 

上述的三个文件中，只有jetty.xml会根据项目的实际情况进行修改和调整，一般情况下其他两个文件不需要改动，除非在调试过程中需要使用更多的jetty功能，比如增加对https协议的支持，那么可以通过修改JettyStart.java程序并在jetty.xml文件中增加相关的配置项，就可以灵活地实现。 

第二步 配置工具依赖并加载工具源码和配置文件集 
在工程的build.gradle文件中配置工具依赖并加载工具源码和配置文件集 
1.修改自定义源码集 
在test测试源码块中加载工具对应源程序和配置文件（两个xml文件和一个java类) 

Java代码  

1. sourceSets {  
2.     main {  
3.         java {  
4.             srcDir ‘src‘  
5.              
6.         }  
7.        resources{  
8.             srcDir ‘resources‘  
9.             srcDir ‘src‘ exclude ‘**/*.java‘  
10.         }  
11.     }  
12.     test {  
13.         java {  
14.             srcDir ‘test‘ //包含JettyStart.java 文件  
15.         }  
16.         resources {  
17.         srcDir ‘test‘  exclude ‘**/*.java‘//包含两个xml文件  
18.         }  
19.            
20.     }  
21.       
22. }  

2.在dependencies添加运行jetty容器和web应用所需的jar包 
以compileOnly级别添加启动jetty容器和web应用所需的第三方jar包，这样在最终发布应用版本中不会包含这些额外引入jar包： 

Java代码  

1. dependencies {   
2.       
3.      compileOnly (              
4.                
5.            [group: ‘javax.el‘, name: ‘javax.el-api‘, version: ‘2.2.1‘, transitive: false],  
6.            [group: ‘org.eclipse.jetty.aggregate‘, name: ‘jetty-all-server‘, version: ‘8.1.19.v20160209‘, transitive: false],  
7.            [group: ‘org.eclipse.jetty.orbit‘, name: ‘org.apache.jasper.glassfish‘, version: ‘2.2.2.v201112011158‘, transitive: false],  
8.            [group: ‘org.eclipse.jetty.orbit‘, name: ‘javax.servlet.jsp‘, version: ‘2.2.0.v201112011158‘, transitive: false],  
9.           
10.           [group: ‘org.eclipse.jetty.orbit‘, name: ‘org.apache.taglibs.standard.glassfish‘, version: ‘1.2.0.v201112081803‘, transitive: false],  
11.            [group: ‘org.eclipse.jetty.orbit‘, name: ‘com.sun.el‘, version: ‘2.2.0.v201108011116‘, transitive: false],  
12.              
13.             
14.     )      
15.       
16.      compileOnly (              
17.             
18.             [group: ‘javax.servlet‘, name: ‘javax.servlet-api‘, version: "3.0.1", transitive: false],  
19.             [group: ‘javax.servlet.jsp‘, name: ‘javax.servlet.jsp-api‘, version: ‘2.3.1‘, transitive: false],  
20.             
21.         )  
22.       //bboss-core包是可选的，如果在项目的compile依赖中已经包含了bboss-core包的引用，那么可以把下面对bboss-core包的引用去掉，否则必须加上  
23.       compileOnly (              
24.             
25.             [group: ‘com.bbossgroups‘, name: ‘bboss-core‘, version: "5.0.1", transitive: true],  
26.             
27.         )  
28. }  

     

本文的附件中（下载）包含了可以作为参考的build.gradle样例。 

第三步 运行和调试web应用     
完成第一步和第二步后，我们就可以通过JettyStart程序来运行和调试web应用了， 
首先在web工程右键菜单中gradle sts插件的Refresh All功能来刷新和加载最新的build.gradle配置文件，如图示： 

 

然后参考以下图示来调试或者运行 JettyStart，即可调试或者运行gradle管理的web应用了： 

　　www.togv.net/guanlipeixun/4ws6xllk3xl3ciz8reaf.htm

　　www.togv.net/guanlipeixun/nscr433em4n4niblrnex.htm

　　www.365128.com/user/aqiandao/65.html

　　www.365128.com/user/aqiandao/66.html

　　www.365128.com/user/aqiandao/67.html

　　www.365128.com/user/aqiandao/68.html

　　www.365128.com/user/aqiandao/70.html

　　www.365128.com/user/aqiandao/71.html

　　www.365128.com/user/aqiandao/72.html

　　www.365128.com/user/aqiandao/64.html