Jetty：配置JSP支持

选择JSP实现

从Jetty-9.2开始，使用Apache Jasper作为默认JSP容器实现。在前面的版本中使用的是Glassfish Jasper，在后面的版本中也可以继续使用它。
Jetty发布默认激活jsp模块，默认，模块设置到Apache Jasper。为了改为使用Glassfish Jasper，编辑$JETTY_HOME/start.d/jsp.mod，改变下面的行：

#
# Jetty JSP Module
#
 
[depend]
servlet
jsp-impl/${jsp-impl}-jsp
 
[ini-template]
# JSP Configuration
 
# Select JSP implementation, choices are
#   glassfish : The reference implementation 
#               default in jetty <= 9.1
#   apache    : The apache version 
#               default jetty >= 9.2
jsp-impl=apache
 
# To use a non-jdk compiler for JSP compilation when using glassfish uncomment next line
# -Dorg.apache.jasper.compiler.disablejsr199=true

注意一些JSP的特征能否使用依赖于你选择的JSP容器实现。也注意你不能预编译一种容器的jsp，而部署另一个。

预编译

你能按照你选择的JSP容器（Glassfish或者Apache）提供的指导手册预编译jsp。或者如果你选择使用maven，你能用jetty-jspc-maven插件为你做。
如果你预编译你的jsp，并且自定义了输出包前缀（默认是org.apache.jsp），你应该配置你的webapp上下文告诉Jetty关于你的自定义报名。你能使用servlet上下文的初始化参数org.eclipse.jetty.servlet.jspPackagePrefix做这。
例如，假定你预编译你的jsp，使用自定义包前缀com.acme，那么你将在web.xml中增加：

<context-param>
  <param-name>org.eclipse.jetty.servlet.jspPackagePrefix</param-name>
  <param-value>com.acme</param-value>
</context-param>

注意：Jetty的maven插件jetty-jspc-maven-plugin和jetty-maven-plugin都只能用Apache Jasper

运行时编译JSP

根据你选择的不同的JSP容器，配置项和编译特性将是不同的。

Apache JSP容器

默认，Apache JSP容器将查找Eclipse Java Compiler（jdt）。jetty发布自带了一个在$JETTY_HOME/lib/apache-jsp。如果你希望用不同的编译器，你将需要配置compilerClassName初始参数在JspServlet，并带上类名。
下表是Apache JspServlet的参数介绍：

理解Apache JspServlet参数

初始参数	描述	默认值	webdefault.xml
classpath	用于jsp编译的Classpath。只有在jetty中的org.apache.catalina.jsp_classpath上下文属性不被设置时才使用。	-	-
classdebuginfo	在class文件中包括debugging信息	TRUE	-
checkInterval	后台重编译检查的间隔，单位秒。只有development=false才使用。	0	-
development	development=true时，每个请求都做重编译检查。看modificationTestInterval	TRUE	-
displaySourceFragment	是否将源码片段包含在异常信息中	TRUE	-
errorOnUseBeanInvalidClassAttribute	当在一个useBean行为中class属性的值不是一个有效的bean类时，是否产生一个error	TRUE	-
fork	Ant应该fork它的JSP页的Java编译吗？	TRUE	FALSE
keepgenerated	你想保留生成的Java文件吗？	TRUE	-
trimSpaces	指令和行为间的空格应该被裁剪吗？	FALSE	-
enablePooling	确定标签处理器池是否被激活	TRUE	-
engineOptionsClass	允许指定的Options类用于配置Jasper。否则，默认的EmbeddedServletOptions将被使用	-	-
mappedFile	支持mapped Files。产生一个servlet，有一个打印申明JSP文件的每一行	TRUE	-
suppressSmap	为JSR45调试的SMAP信息的产生	FALSE	-
dumpSmap	转储SMAP JSR45信息到一个文件	FALSE	-
genStrAsCharArray	为产生Strings的选项	FALSE	-
ieClassId	当使用<jsp:plugin>标签时，class-id值被送到Internet Explorer	clsid:8AD9C840-044E-11D1-B3E9-00805F499D93	-
maxLoadedJsps	一个web应用能加载的JSP的最大值。如果超过了这个值，最近最少使用那个的JSP将被卸载。0或者负值表示没有限制。	-1	-
jspIdleTimeout	一个JSP被卸载前空闲的最大时间，单位秒。0或者负值表示永不卸载。	-1	-
scratchDir	servlet被生成的文件夹	-	-
compilerClassName	如果不设置，默认是Eclipse jdt编译器。	-	-
compiler	如果Eclipse jdt编译器在classpath中不能找到时使用。它是Ant应该调用的编译器的类名。	-	-
compilerTargetVM	编译器期望的目标vm。	1.7	-
compilerSourceVM	为jdt编译器设置源兼容性级别。	1.7	-
javaEncoding	编译使用编码方式。	UTF8
modificationTestInterval	如果development=true，重编译检查的间隔，通过一个请求触发。	4	-
xpoweredBy	产生一个X-Powered-By响应头。	FALSE	FALSE
recompileOnFail	如果一个JSP编译失败，modificationTestInterval应该被忽略并且触发下一个重编译尝试吗？只用在开发模式，默认被停止，因为编译可能代价较高导致过多的资源被用。	-	-

 

Glassfish JSP容器

为了编译.jsp文件进入Java classes，你需要一个Java编译器。如果你正在使用一个完整的JDK，你能从JVM得到Java编译器，否则，你可以从一个第三方Jar。
默认Glassfish JSP容器尝试用JDK的编译器。注意：当用JDK编译器时，系统不保存你的class文件到磁盘，除非你用saveBytecode初始化参数，将在下面描述。
如果你不有完整的JDK，你能配置Eclipse Java Compiler，在Jetty的$JETTY_HOME/lib/jsp/文件夹下。你需要定义一个系统属性，防止Glassfish JSP引擎默认使用JVM中的编译器。
当使用独立的标准版时，最好的方式是使用未注释的系统属性org.apache.jasper.compiler.disablejsr199，在jsp module中：

-Dorg.apache.jasper.compiler.disablejsr199=true

或者为了嵌入的使用，仅仅定义这作为一个通常的系统属性。

配置

JSP引擎有一些配置参数。一些参数仅影响预编译，而一些影响运行时预编译检查。在不同版本的JSP引擎间参数也有不同。下面列出了配置参数、他们的含义和他们的默认设置。所有参数都在webdefault.xml的org.apache.jasper.JspServlet实例中定义：

理解Glassfish JSP参数

初始参数	描述	默认值	webdefault.xml
development	development=true，重编译检查在每个请求时都执行。看modificationTestInterval。	TRUE	-
fork	Ant应该fork它的JSP页的Java编译？	TRUE	FALSE
keepgenerated	你想保留产生的Java文件？	FALSE	-
saveBytecode	如果class文件作为byte arrays被产生，他们在编译结束时应该被保存到磁盘吗？	FALSE	-
trimSpaces	在指令和行为之间的空白应该被裁剪吗？	FALSE	-
enablePooling	确定标签处理器池是否被激活。	TRUE	-
mappedFile	支持mapped Files。产生一个servlet，有一个打印申明JSP文件的每一行	TRUE	-
sendErrorToClient	如果false，栈轨迹，等，被送到标准错误代替客户端的浏览器。	FALSE	-
classdebuginfo	在class文件中包括debugging信息。	TRUE	-
checkInterval	后台重编译检查的间隔，单位秒。只有development=false才使用。	0	-
suppressSmap	为JSR45调试的SMAP信息的产生	FALSE	-
dumpSmap	转储SMAP JSR45信息到一个文件	FALSE	-
genStrAsCharArray	为产生Strings的选项	FALSE	-
genStrAsByteArray	为产生Strings的选项	TRUE	-
defaultBufferNone	-	FALSE	-
errorOnUseBeanInvalidClassAttribute	-	FALSE	-
scratchDir	servlet被生成的文件夹。Jetty设置这个值根据为webapp设置的[/display/JETTY/Temporary+Directories work dir]	-	-
compiler	在运行时确定。对Jetty来说是Eclipse jdt compiler。	-	-
compilerTargetVM	编译器期望的目标vm。	1.5	-
compilerSourceVM	为jdt编译器设置源兼容性级别。	1.5	-
javaEncoding	编译使用编码方式。	UTF8	-
modificationTestInterval	如果development=true，重编译检查的间隔，通过一个请求触发。	0	-
xpoweredBy	产生一个X-Powered-By响应头。	FALSE	FALSE
usePrecompiled/use-precompiled	-	FALSE	-
validating/enableTldValidation	是否根据模式（schema）验证标签文件。	FALSE	-
reload-interval	如果reload-interval=0，则不做JSP的运行时检查，否则设置检查间隔，不管development=true还是development=false。	-	-
initial-capacity/initialCapacity	映射JSP到class和JSP文件的哈希映射表的初始容量	-	-

 

 

 

 

通常存在很多困惑在关于development、checkInterval和modificationTestInterval参数，和JSP运行时重编译。这里是分解出的各种选项：

1）对每个请求检查JSP文件重编译

<init-param>
        <param-name>development></param-name>
        <param-value>true></param-value>
</init-param>

2）大约每N秒检查一次，通过请求触发定时的计算。下面是每60秒检查：

<init-param>
        <param-name>development></param-name>
        <param-value>true></param-value>
</init-param>
<init-param>
        <param-name>modificationTestInterval></param-name>
        <param-value>60></param-value>
</init-param>

3）不做检查，但在第一次使用时编译JSP。（注意“reload-interval”参数相当于“development=false”和“checkInterval=0”组合的简写）：

<init-param>
        <param-name>reload-interval></param->
        <param-value>-1></param-value>
</init-param>

4）不做任何请求时检查，但启动一个后台线程执行每N秒检查一次。下面的例子每60秒检查一次：

<init-param>
        <param-name>development></param-name>
        <param-value>false></param-value>
 </init-param>
 <init-param>
         <param-name>checkInterval></param-name>
         <param-value>60></param-value>
</init-param>

修改配置

不考虑你正在使用哪一个JSP容器，有几个选项用于修改JspServlet配置。

重载webdefault.xml

你能拷贝Jetty自带的$JETTY_HOME/etc/webdefault.xml，修改，然后用它代替自带的版本。下面展示如何使用Jetty Maven插件达到这个目地：

<plugin>
  <groupId>org.eclipse.jetty</groupId>
  <artifactId>jetty-maven-plugin</artifactId>
  <configuration>
    <webApp>
      <defaultsDescriptor>src/main/resources/webdefault.xml</defaultsDescriptor>
    </webApp>
</plugin>

如果你正在使用Jetty发行版，你想改变JSP设置为一个或者多个你的webapp，拷贝$JETTY_HOME/etc/webdefault.xml文件到某个地方，修改，然后用context xml文件设置这个文件为你的webapp的defaultsDescriptor。下面是一个例子：

<Configure class=>"org.eclipse.jetty.webapp.WebAppContext">
 
  <Set name=>"contextPath">/foo</Set>
  <Set name=>"war"><SystemProperty name=>"jetty.home" >default=>"."/>/webapps/foobar.war</Set>
  <Set name=>"defaultsDescriptor">/home/smith/dev/webdefault.xml</Set>
  
</Configure>

如果你想改变JSP设置为所有webapp，直接编辑$JETTY_HOME/etc/webdefaults.xml即可。

在web.xml中配置JSP Servlet

另一个选择是在你的webapp的WEB-INF/web.xml中为JSPServlet增加一个条目，改变或者增加初始化参数。你也可以增加（但不移除）servlet-mappings。你能用在$JETTY_HOME/etc/webdefault.xml中的条目作为一个起始点。

<servlet id=>"jsp">
    <servlet-name>jsp</servlet-name>
    <servlet-class>org.apache.jasper.servlet.JspServlet</servlet-class>
    <init-param>
        <param-name>logVerbosityLevel</param-name>
        <param-value>DEBUG</param-value>
    </init-param>
    <init-param>
        <param-name>fork</param-name>
        <param-value>>false</param-value>
    </init-param>
    <init-param>
        <param-name>keepgenerated</param-name>
        <param-value>>true</param-value>
    </init-param>
    ...
     
    <load-on-startup>0</load-on-startup>
  </servlet>
 
  <servlet-mapping>
    <servlet-name>jsp</servlet-name>
    <url-pattern>*.jsp</url-pattern>
    <url-pattern>*.jspf</url-pattern>
    <url-pattern>*.jspx</url-pattern>
    <url-pattern>*.xsp</url-pattern>
    <url-pattern>*.JSP</url-pattern>
    <url-pattern>*.JSPF</url-pattern>
    <url-pattern>*.JSPX</url-pattern>
    <url-pattern>*.XSP</url-pattern>
  </servlet-mapping>
   
  <servlet id=>"my-servlet">
    <servlet-name>myServlet</servlet-name>
    <servlet-class>com.acme.servlet.MyServlet</servlet-class>
     ...

用JSTL标签库

JavaServer Pages Standlard Tag Library（JSTL）是Jetty发布版本的一部分（在$JETTY_HOME/lib/jsp）中。

用JSF标签库

下面提供关于使用JSF标签库的信息。

在Jetty发布中使用JSF标签库

如果你想在你的webapp中使用JSF，你需要拷贝JSF实现Jar（你选择的JSF实现中包含META-INF/*.tld文件的jar）进入Jetty的共享容器库文件夹。你能放他们到lib文件夹匹配你选择的JSP容器（或者Glassfish JSP的$JETTY_HOME/lib/jsp，或者Apache JSP的$JETTY_HOME/lib/apache-jsp），或者放它们进入$JETTY_HOME/lib/ext。

用Jetty Maven插件使用JSF标签库

你应该使你的JSF Jar依赖插件，而不是webapp自身。例如：

<plugin>
  <groupId>org.eclipse.jetty</groupId>
  <artifactId>jetty-maven-plugin</artifactId>
  <configuration>
     <webApp>
       <contextPath>/${artifactId}</contextPath>
     </webApp>
     <scanIntervalSeconds>5</scanIntervalSeconds>
  </configuration>
  <dependencies>
    <dependency>
      <groupId>com.sun.faces</groupId>
      <artifactId>jsf-api</artifactId>
      <version>2.0.8</version>
    </dependency>
    <dependency>
      <groupId>com.sun.faces</groupId>
      <artifactId>jsf-impl</artifactId>
      <version>2.0.8</version>
   </dependency>
  </dependencies>
</plugin>