概述
jetty是什么?
jetty是輕量級的web服務器和servlet引擎。
它的最大特點是:可以很方便的作為嵌入式服務器。
它是eclipse的一個開源項目。不用懷疑,就是你常用的那個eclipse。
它是使用Java開發的,所以天然對Java支持良好。
什么是嵌入式服務器?
以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>