Servlet, JSP, JSTL, EL在maven中的配置

引言

本人在实际项目和各种框架中，发现Servlet, JSP, JSTL, EL在maven中依赖的写法种类非常多，可谓五花八门，为了搞明白不同的写法有何不同，花了些时间研究了下在maven的pom.xml中如何合理的加入Servlet, JSP, JSTL, EL的依赖，本文即是研究的结果。

为了说明清楚，首先简要的介绍下这几种组件，然后重点说明如何在maven中配置，内容分为几下几个部分：

Servlet, JSP, JSTL, EL这些东西都是什么，做什么用的，之间有什么关系
这些东西的版本是怎么回事
如何在maven中具体配置

这些东西都是什么，做什么用的，之间有什么关系

这四个东西都是JavaEE规范标准的一部分，注意这只是标准而不是实现，标准相当于图纸，实现相当于根据图纸做出来的实物。JavaEE规范中有很多标准，其中这四个在JavaWeb开发中比较常用，具体来说：

Servlet & JSP，这个估计都比较清楚；
JSTL叫做JSP标准标签库，它是一个JSP标签集合，封装了JSP应用的通用核心功能，这个东西一般在JSP页面里使用；
EL表达式，主要用于替换JSP页面中的脚本表达式，一般也是用在JSP页面里。

另外：如果一个容器（例如GlassFish）实现了JavaEE的全部标准，这个容器可以称之为JavaEE的容器，如果一个容器（例如Tomcat）实现了Servlet规范，可以称之为Servlet容器。

这些东西的版本是怎么回事

JavaEE有不同的版本，其组件也有不同的版本，所运行的容器也有对应的版本，在一个项目开发之初的时候，就应该明确使用哪个版本的组件，如果没有特别的情况，最好使用最新的稳定版本，在编写本文的2016年11月，本人推荐如下的组件版本组合：
Servlet 3.1
JSP 2.3
JSTL 1.2
EL 3.0
tomcat 8.0.x或者tomcat8.5.x

另外，wiki上有一个关于JavaEE版本和组件版本的对应：Java_EE_version_history；
Tomcat官方也有一个版本和组件的对应关系说明： tomcat版本说明。

如何在maven中具体配置

原则

我们在开发的时候，是按照标准开发的，而程序运行时是在容器中运行，容器可能会提供组件的具体（注意这里是可能会，例如Tomcat提供了Servlet和JSP的实现，但是没有提供JSTL的实现），这里有两种情况：

程序部署的容器从一开始就确定了，例如应用程序未来部署的生产环境是Tomcat；
程序部署的容器不确定，或者需要程序可以在不同的容器下部署，例如应用程序既能在Tomcat中部署，又可以在jetty中部署。

第一种情况，本人建议在将标准和实现的依赖都放到pom.xml中，并且scope使用provided，第二种情况复杂一些，因为不确定容器是否会提供组件的实现，不同的容器对组件支持的程度不同，具体的依赖也是不同的，这种情况可以使用maven的profile解决，在下面的配置中，以Tomcat 8.0.36作为具体的部署环境为例来重点说明第一种情况，第二种情况也会提到一些。

Servlet

既引入标准，也进入具体实现的写法

<!-- servlet标准 -->
<dependency>
    <groupId>javax.servlet</groupId>
    <artifactId>javax.servlet-api</artifactId>
    <scope>provided</scope>
    <version>3.1.0</version>
</dependency>
<!-- tomcat提供的servlet实现 -->
<dependency>
    <groupId>org.apache.tomcat</groupId>
    <artifactId>tomcat-servlet-api</artifactId>
    <scope>provided</scope>
    <version>8.0.36</version>
</dependency>

实际当中，Tomcat的servlet-api实现已经整合了标准在内，所以我们只需要在maven的pom.xml中加入如下内容就可以了

<dependency>
    <groupId>org.apache.tomcat</groupId>
    <artifactId>tomcat-servlet-api</artifactId>
    <scope>provided</scope>
    <version>8.0.36</version>
</dependency>

注意，在maven中加入Servlet标准的依赖，不同版本的标准写法是不一样的，具体来说，是artifactId不一样。

Servlet 3.0.1以前的写法：

<dependency>
    <groupId>javax.servlet</groupId>
    <artifactId>servlet-api</artifactId>
    <scope>provided</scope>
    <version>2.5</version>
</dependency>

Servlet 3.0.1以后的写法：

<dependency>
    <groupId>javax.servlet</groupId>
    <artifactId>javax.servlet-api</artifactId>
    <scope>provided</scope>
    <version>3.1.0</version>
</dependency>

只引入标准的写法

<!-- servlet标准 -->
<dependency>
    <groupId>javax.servlet</groupId>
    <artifactId>javax.servlet-api</artifactId>
    <scope>provided</scope>
    <version>3.1.0</version>
</dependency>

JSP

既引入标准，也进入具体实现的写法
和Servlet类似，Tomcat的jsp实现已经整合了标准在内，所以我们只需要在maven的pom.xml中加入如下内容就可以了:

<dependency>
    <groupId>org.apache.tomcat</groupId>
    <artifactId>tomcat-jsp-api</artifactId>
    <scope>provided</scope>
    <version>8.0.36</version>
</dependency>

只引入标准的写法
如果需要在maven中加入JSP标准，请注意不同版本JSP标准的artifactId略有不同

2.2.1-b03之前的写法

<dependency>
    <groupId>javax.servlet.jsp</groupId>
    <artifactId>jsp-api</artifactId>
    <scope>provided</scope>
    <version>2.2</version>
</dependency>

2.2.1-b03之后的写法

<dependency>
    <groupId>javax.servlet.jsp</groupId>
    <artifactId>javax.servlet.jsp-api</artifactId>
    <scope>provided</scope>
    <version>2.3.1</version>
</dependency>

JSTL

JSTL的情况比较复杂，首先JSTL和Servlet，JSP不太一样，Tomcat没有提供JSTL的实现。所以在maven中加入依赖的时候，既要加入标准，也要加入具体实现，并且不能使用provided scope；再者JSTL依赖的写法非常多，我在mvnrepository.com上查了一下，以版本1.2为例，至少有以下几种写法：

<dependency>
    <groupId>javax.servlet.jsp.jstl</groupId>
    <artifactId>jstl-api</artifactId>
    <version>1.2</version>
</dependency>
<dependency>
    <groupId>org.glassfish.web</groupId>
    <artifactId>jstl-impl</artifactId>
    <version>1.2</version>
</dependency>
<dependency>
    <groupId>jstl</groupId>
    <artifactId>jstl</artifactId>
    <version>1.2</version>
</dependency>
<dependency>
    <groupId>javax.servlet</groupId>
    <artifactId>jstl</artifactId>
    <version>1.2</version>
</dependency>
<dependency>
    <groupId>javax.servlet.jsp.jstl</groupId>
    <artifactId>jstl</artifactId>
    <version>1.2</version>
</dependency>

其中有的是标准，有的是实现，我们具体分析一下，考虑到从2006年的Java EE 5到预计2017年发布的Java EE 8，对应的JSTL版本均为1.2，我们以下的分析采用这个版本。

首先看下面这两种写法

<dependency>
    <groupId>javax.servlet.jsp.jstl</groupId>
    <artifactId>jstl-api</artifactId>
    <version>1.2</version>
</dependency>
<dependency>
    <groupId>org.glassfish.web</groupId>
    <artifactId>jstl-impl</artifactId>
    <version>1.2</version>
</dependency>

其中第一种写法是标准，第二写法是GlassFish的具体实现，这个实现中没有包括标准。需要注意的是，这两个组件分别依赖与其他的组件，jstl-api有两个依赖：
Servlet 2.5和JSP 2.1

1
2
3

[INFO] \- javax.servlet.jsp.jstl:jstl-api:jar:1.2:compile
[INFO]    +- javax.servlet:servlet-api:jar:2.5:compile
[INFO]    \- javax.servlet.jsp:jsp-api:jar:2.1:compile

jstl-impl有三个依赖，分别是：
Servlet 2.5、JSP 1.2，以及jstl-api 1.2(也就是上面第一个)，

[INFO] \- org.glassfish.web:jstl-impl:jar:1.2:compile
[INFO]    +- javax.servlet:servlet-api:jar:2.5:compile
[INFO]    +- javax.servlet.jsp:jsp-api:jar:2.1:compile
[INFO]    \- javax.servlet.jsp.jstl:jstl-api:jar:1.2:compile

如果项目中使用的Servlet和JSP不是这个版本，建议将其排除。

然后看下面这两种写法：

<dependency>
    <groupId>jstl</groupId>
    <artifactId>jstl</artifactId>
    <version>1.2</version>
</dependency>
<dependency>
    <groupId>javax.servlet</groupId>
    <artifactId>jstl</artifactId>
    <version>1.2</version>
</dependency>

这两种写法都是就是包括了标准，也包括了实现，本人花了些时间分析这两个组件之间的不同，到头来结论是没有任何不同，这两个jar文件的md5校验码是一样的。

1 2	MD5 (jstl/jstl/1.2/jstl-1.2.jar) = 51e15f798e69358cb893e38c50596b9b MD5 (javax/servlet/jstl/1.2/jstl-1.2.jar) = 51e15f798e69358cb893e38c50596b9b

这两个的实现部分和上面GlassFish的实现是一样，没有区别，另外，这两个组件都没有自己的依赖。

最后说下这种写法

<dependency>
    <groupId>javax.servlet.jsp.jstl</groupId>
    <artifactId>jstl</artifactId>
    <version>1.2</version>
</dependency>

这些写法虽然还存在于mvnrepository.com，但是对应的jar文件已经在maven的公共库中不存在了。其访问地址
https://repo.maven.apache.org/maven2/javax/servlet/jsp/jstl/jstl/1.2/jstl-1.2.pom
已经是404 Not Found。

解释完了这些，给出具体的写法

只引入标准的写法

<dependency>
    <groupId>javax.servlet.jsp.jstl</groupId>
    <artifactId>jstl-api</artifactId>
    <version>1.2</version>
    <exclusions>
        <exclusion>
            <groupId>javax.servlet</groupId>
            <artifactId>servlet-api</artifactId>
        </exclusion>
        <exclusion>
            <groupId>javax.servlet.jsp</groupId>
            <artifactId>jsp-api</artifactId>
        </exclusion>
    </exclusions>
</dependency>

既引入标准，也进入具体实现的写法

以下三种写法都可以，第一种

<dependency>
    <groupId>javax.servlet.jsp.jstl</groupId>
    <artifactId>jstl-api</artifactId>
    <version>1.2</version>
    <exclusions>
        <exclusion>
            <groupId>javax.servlet</groupId>
            <artifactId>servlet-api</artifactId>
        </exclusion>
        <exclusion>
            <groupId>javax.servlet.jsp</groupId>
            <artifactId>jsp-api</artifactId>
        </exclusion>
    </exclusions>
</dependency>
<dependency>
    <groupId>org.glassfish.web</groupId>
    <artifactId>jstl-impl</artifactId>
    <version>1.2</version>
    <exclusions>
        <exclusion>
            <groupId>javax.servlet</groupId>
            <artifactId>servlet-api</artifactId>
        </exclusion>
        <exclusion>
            <groupId>javax.servlet.jsp</groupId>
            <artifactId>jsp-api</artifactId>
        </exclusion>
    </exclusions>
</dependency>

第二种

<dependency>
    <groupId>jstl</groupId>
    <artifactId>jstl</artifactId>
    <version>1.2</version>
</dependency>

第三种

<dependency>
    <groupId>javax.servlet</groupId>
    <artifactId>jstl</artifactId>
    <version>1.2</version>
</dependency>

这三种写法中，第一种是标准和实现分开，后两种的组件是包括了标准和实现，本人推荐分开写的第一种，查阅了一些较为权威的开源程序（例如spring官方的spring-mvc-showcase），也是采用第一种写法的居多。

EL

EL的标准和实现
GlassFish版：

<dependency>
    <groupId>javax.el</groupId>
    <artifactId>javax.el-api</artifactId>
    <version>3.0.0</version>
</dependency>
<dependency>
    <groupId>org.glassfish</groupId>
    <artifactId>javax.el</artifactId>
    <version>3.0.0</version>
</dependency>

Tomcat版：

<dependency>
    <groupId>org.apache.tomcat</groupId>
    <artifactId>tomcat-el-api</artifactId>
    <version>8.0.36</version>
</dependency>
<dependency>
    <groupId>org.apache.tomcat</groupId>
    <artifactId>tomcat-jasper-el</artifactId>
    <version>8.0.36</version>
</dependency>

注意，如果使用Tomcat作为部署容器，Tomcat已经集成了EL，而jsp在构建阶段（mvn clean package）是不会被编译的，所以使用Tomcat作为部署容器时，不需要加入EL表达式的依赖

一个完整的pom例子

最后，给一个使用Servlet 3.1, JSP 2.3, JSTL 1.2，以Tomcat 8.0.36作为部署容器的完整pom.xml

<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <groupId>cn.foo</groupId>
    <artifactId>bar</artifactId>
    <version>0.0.1-SNAPSHOT</version>
    <name>demo</name>
    <properties>
        <tomcat.version>8.0.36</tomcat.version>
        <jstl.version>1.2</jstl.version>
    </properties>
    <dependencies>
        <!-- Servlet -->
        <dependency>
            <groupId>org.apache.tomcat</groupId>
            <artifactId>tomcat-servlet-api</artifactId>
            <scope>provided</scope>
            <version>${tomcat.version}</version>
        </dependency>
        <!-- JSP -->
        <dependency>
            <groupId>org.apache.tomcat</groupId>
            <artifactId>tomcat-jsp-api</artifactId>
            <scope>provided</scope>
            <version>${tomcat.version}</version>
        </dependency>
        <!-- JSTL -->
        <dependency>
            <groupId>javax.servlet.jsp.jstl</groupId>
            <artifactId>jstl-api</artifactId>
            <version>${jstl.version}</version>
            <exclusions>
                <exclusion>
                    <groupId>javax.servlet</groupId>
                    <artifactId>servlet-api</artifactId>
                </exclusion>
                <exclusion>
                    <groupId>javax.servlet.jsp</groupId>
                    <artifactId>jsp-api</artifactId>
                </exclusion>
            </exclusions>
        </dependency>
        <dependency>
            <groupId>org.glassfish.web</groupId>
            <artifactId>jstl-impl</artifactId>
            <version>${jstl.version}</version>
            <exclusions>
                <exclusion>
                    <groupId>javax.servlet</groupId>
                    <artifactId>servlet-api</artifactId>
                </exclusion>
                <exclusion>
                    <groupId>javax.servlet.jsp</groupId>
                    <artifactId>jsp-api</artifactId>
                </exclusion>
            </exclusions>
        </dependency>
    </dependencies>
</project>

欢迎批评指正，全文完。