嵌入式服务器jetty，让你更快开发web

概述

jetty是什么？

jetty是轻量级的web服务器和servlet引擎。

它的最大特点是：可以很方便的作为嵌入式服务器。

它是eclipse的一个开源项目。不用怀疑，就是你常用的那个eclipse。

它是使用Java开发的，所以天然对Java支持良好。

官方网址

github源码地址

什么是嵌入式服务器？

以jetty来说明，就是只要引入jetty的jar包，可以通过直接调用其API的方式来启动web服务。

用过Tomcat、Resin等服务器的朋友想必不会陌生那一套安装、配置、部署的流程吧，还是挺繁琐的。使用jetty，就不需要这些过程了。

jetty非常适用于项目的开发、测试，因为非常快捷。如果想用于生产环境，则需要谨慎考虑，它不一定能像成熟的Tomcat、Resin等服务器一样支持企业级Java EE的需要。

jetty的嵌入式启动

我觉得嵌入式启动方式的一个好处在于：可以直接运行项目，无需每次部署都得再配置服务器。

jetty的嵌入式启动使用有两种方式：

API方式

maven插件方式

API方式

添加maven依赖

<dependency>
  <groupId>org.eclipse.jetty</groupId>
  <artifactId>jetty-webapp</artifactId>
  <version>9.3.2.v20150730</version>
  <scope>test</scope>
</dependency>
<dependency>
  <groupId>org.eclipse.jetty</groupId>
  <artifactId>jetty-annotations</artifactId>
  <version>9.3.2.v20150730</version>
  <scope>test</scope>
</dependency>
<dependency>
  <groupId>org.eclipse.jetty</groupId>
  <artifactId>apache-jsp</artifactId>
  <version>9.3.2.v20150730</version>
  <scope>test</scope>
</dependency>
<dependency>
  <groupId>org.eclipse.jetty</groupId>
  <artifactId>apache-jstl</artifactId>
  <version>9.3.2.v20150730</version>
  <scope>test</scope>
</dependency>

官方的启动代码

public class SplitFileServer
{
    public static void main( String[] args ) throws Exception
    {
        // 创建Server对象，并绑定端口
        Server server = new Server();
        ServerConnector connector = new ServerConnector(server);
        connector.setPort(8090);
        server.setConnectors(new Connector[] { connector });

        // 创建上下文句柄，绑定上下文路径。这样启动后的url就会是:http://host:port/context
        ResourceHandler rh0 = new ResourceHandler();
        ContextHandler context0 = new ContextHandler();
        context0.setContextPath("/");
      
        // 绑定测试资源目录（在本例的配置目录dir0的路径是src/test/resources/dir0）
        File dir0 = MavenTestingUtils.getTestResourceDir("dir0");
        context0.setBaseResource(Resource.newResource(dir0));
        context0.setHandler(rh0);

        // 和上面的例子一样
        ResourceHandler rh1 = new ResourceHandler();
        ContextHandler context1 = new ContextHandler();
        context1.setContextPath("/");
        File dir1 = MavenTestingUtils.getTestResourceDir("dir1");
        context1.setBaseResource(Resource.newResource(dir1));
        context1.setHandler(rh1);

        // 绑定两个资源句柄
        ContextHandlerCollection contexts = new ContextHandlerCollection();
        contexts.setHandlers(new Handler[] { context0, context1 });
        server.setHandler(contexts);

        // 启动
        server.start();

        // 打印dump时的信息
        System.out.println(server.dump());

        // join当前线程
        server.join();
    }
}

直接运行Main方法，就可以启动web服务。

注：以上代码在eclipse中运行没有问题，如果想在Intellij中运行还需要为它指定配置文件。

如果想了解在Eclipse和Intellij都能运行的通用方法可以参考我的github代码示例。

我的实现也是参考springside的方式。

代码行数有点多，不在这里贴代码了。

完整参考代码

Maven插件方式

如果你熟悉maven，那么实在太简单了

注： Maven版本必须在3.3及以上版本。

(1) 添加maven插件

<plugin>
  <groupId>org.eclipse.jetty</groupId>
  <artifactId>jetty-maven-plugin</artifactId>
  <version>9.3.12.v20160915</version>
</plugin>

(2) 执行maven命令：

mvn jetty:run

讲真，就是这么简单。jetty默认会为你创建一个web服务，地址为127.0.0.1:8080。

当然，你也可以在插件中配置你的webapp环境

<plugin>
  <groupId>org.eclipse.jetty</groupId>
  <artifactId>jetty-maven-plugin</artifactId>
  <version>9.3.12.v20160915</version>
  
  <configuration>
	<webAppSourceDirectory>${project.basedir}/src/staticfiles</webAppSourceDirectory>
    
    <!-- 配置webapp -->
	<webApp>
	  <contextPath>/</contextPath>
	  <descriptor>${project.basedir}/src/over/here/web.xml</descriptor>
	  <jettyEnvXml>${project.basedir}/src/over/here/jetty-env.xml</jettyEnvXml>
	</webApp>
    
    <!-- 配置classes -->
	<classesDirectory>${project.basedir}/somewhere/else</classesDirectory>
	<scanClassesPattern>
	  <excludes>
		 <exclude>**/Foo.class</exclude>
	  </excludes>
	</scanClassesPattern>
	<scanTargets>
	  <scanTarget>src/mydir</scanTarget>
	  <scanTarget>src/myfile.txt</scanTarget>
	</scanTargets>
    
    <!-- 扫描target目录下的资源文件 -->
	<scanTargetPatterns>
	  <scanTargetPattern>
		<directory>src/other-resources</directory>
		<includes>
		  <include>**/*.xml</include>
		  <include>**/*.properties</include>
		</includes>
		<excludes>
		  <exclude>**/myspecial.xml</exclude>
		  <exclude>**/myspecial.properties</exclude>
		</excludes>
	  </scanTargetPattern>
	</scanTargetPatterns>
  </configuration>
</plugin>

官方给的jetty-env.xml范例

 <?xml version="1.0"?>
 <!DOCTYPE Configure PUBLIC "-//Mort Bay Consulting//DTD Configure//EN" "http://jetty.mortbay.org/configure.dtd">
 
 <Configure class="org.eclipse.jetty.webapp.WebAppContext">
 
   <!-- Add an EnvEntry only valid for this webapp               -->
   <New id="gargle"  class="org.eclipse.jetty.plus.jndi.EnvEntry">
     <Arg>gargle</Arg>
     <Arg type="java.lang.Double">100</Arg>
     <Arg type="boolean">true</Arg>
   </New>
 
  <!-- Add an override for a global EnvEntry                           -->
   <New id="wiggle"  class="org.eclipse.jetty.plus.jndi.EnvEntry">
     <Arg>wiggle</Arg>
     <Arg type="java.lang.Double">55.0</Arg>
     <Arg type="boolean">true</Arg>
   </New>
 
   <!-- an XADataSource                                                -->
   <New id="mydatasource99" class="org.eclipse.jetty.plus.jndi.Resource">
     <Arg>jdbc/mydatasource99</Arg>
     <Arg>
       <New class="com.atomikos.jdbc.SimpleDataSourceBean">
         <Set name="xaDataSourceClassName">org.apache.derby.jdbc.EmbeddedXADataSource</Set>
         <Set name="xaDataSourceProperties">databaseName=testdb99;createDatabase=create</Set>
         <Set name="UniqueResourceName">mydatasource99</Set>
       </New>
     </Arg>
   </New>
 
 </Configure>

参考

jetty wiki

jetty官方文档