Tomcat 教程之快速入门

最新推荐文章于 2024-07-25 21:18:21 发布
最新推荐文章于 2024-07-25 21:18:21 发布
阅读量5.2k 收藏 8
点赞数 1
分类专栏： Java Web 文章标签： Tomcat 教程 快速
Tomcat 教程之快速入门

版本说明

本文使用 Tomcat 版本为 Tomcat 8.5.24。

Tomcat 8.5 要求 JDK 版本为 1.7 以上。

简介

Tomcat 是什么

Tomcat 是由 Apache 开发的一个 Servlet 容器，实现了对 Servlet 和 JSP 的支持，并提供了作为Web服务器的一些特有功能，如Tomcat管理和控制平台、安全域管理和Tomcat阀等。

由于 Tomcat 本身也内含了一个 HTTP 服务器，它也可以被视作一个单独的 Web 服务器。但是，不能将 Tomcat 和 Apache HTTP 服务器混淆，Apache HTTP 服务器是一个用 C 语言实现的 HTTP Web 服务器；这两个 HTTP web server 不是捆绑在一起的。Tomcat 包含了一个配置管理工具，也可以通过编辑XML格式的配置文件来进行配置。

Tomcat 重要目录

  • /bin - Tomcat 脚本存放目录（如启动、关闭脚本）。 *.sh 文件用于 Unix 系统； *.bat 文件用于 Windows 系统。
  • /conf - Tomcat 配置文件目录。
  • /logs - Tomcat 默认日志目录。
  • /webapps - webapp 运行的目录。

web 工程发布目录结构

一般 web 项目路径结构

|-- webapp                         # 站点根目录
    |-- META-INF                   # META-INF 目录
    |   `-- MANIFEST.MF            # 配置清单文件
    |-- WEB-INF                    # WEB-INF 目录
    |   |-- classes                # class文件目录
    |   |   |-- *.class            # 程序需要的 class 文件
    |   |   `-- *.xml              # 程序需要的 xml 文件
    |   |-- lib                    # 库文件夹
    |   |   `-- *.jar              # 程序需要的 jar 包
    |   `-- web.xml                # Web应用程序的部署描述文件
    |-- <userdir>                  # 自定义的目录
    |-- <userfiles>                # 自定义的资源文件

webapp：工程发布文件夹。其实每个 war 包都可以视为 webapp 的压缩包。

META-INF：META-INF 目录用于存放工程自身相关的一些信息，元文件信息，通常由开发工具，环境自动生成。

WEB-INF：Java web应用的安全目录。所谓安全就是客户端无法访问，只有服务端可以访问的目录。

/WEB-INF/classes：存放程序所需要的所有 Java class 文件。

/WEB-INF/lib：存放程序所需要的所有 jar 文件。

/WEB-INF/web.xml：web 应用的部署配置文件。它是工程中最重要的配置文件，它描述了 servlet 和组成应用的其它组件，以及应用初始化参数、安全管理约束等。

安装

前提条件

Tomcat 8.5 要求 JDK 版本为 1.7 以上。

进入 Tomcat 官方下载地址 选择合适版本下载，并解压到本地。

Windows

添加环境变量 CATALINA_HOME ，值为 Tomcat 的安装路径。

进入安装目录下的 bin 目录，运行 startup.bat 文件，启动 Tomcat

Linux / Unix

下面的示例以 8.5.24 版本为例，包含了下载、解压、启动操作。

# 下载解压到本地
wget http://mirrors.hust.edu.cn/apache/tomcat/tomcat-8/v8.5.24/bin/apache-tomcat-8.5.24.tar.gz
tar -zxf apache-tomcat-8.5.24.tar.gz
# 启动 Tomcat
./apache-tomcat-8.5.24/bin/startup.sh

启动后，访问 http://localhost:8080 ，可以看到 Tomcat 安装成功的测试页面。

tomcat.png

配置

本节将列举一些重要、常见的配置项。详细的 Tomcat8 配置可以参考 Tomcat 8 配置官方参考文档 。

Server

Server 元素表示整个 Catalina servlet 容器。

因此，它必须是 conf/server.xml 配置文件中的根元素。它的属性代表了整个 servlet 容器的特性。

属性表

属性描述备注
className这个类必须实现org.apache.catalina.Server接口。默认 org.apache.catalina.core.StandardServer
address服务器等待关机命令的TCP / IP地址。如果没有指定地址，则使用localhost。 
port服务器等待关机命令的TCP / IP端口号。设置为-1以禁用关闭端口。 
shutdown必须通过TCP / IP连接接收到指定端口号的命令字符串，以关闭Tomcat。 

Service

Service元素表示一个或多个连接器组件的组合，这些组件共享一个用于处理传入请求的引擎组件。Server 中可以有多个 Service。

属性表

属性描述备注
className这个类必须实现org.apache.catalina.Service接口。默认 org.apache.catalina.core.StandardService
name此服务的显示名称，如果您使用标准 Catalina 组件，将包含在日志消息中。与特定服务器关联的每个服务的名称必须是唯一的。 

实例 - conf/server.xml 配置文件示例

<?xml version="1.0" encoding="UTF-8"?>
<Server port="8080" shutdown="SHUTDOWN">
  <Service name="xxx">
  ...
  </Service>
</Server>

Executor

Executor表示可以在Tomcat中的组件之间共享的线程池。

属性表

属性描述备注
className这个类必须实现org.apache.catalina.Executor接口。默认 org.apache.catalina.core.StandardThreadExecutor
name线程池名称。要求唯一, 供Connector元素的executor属性使用
namePrefix线程名称前缀。 
maxThreads最大活跃线程数。默认200
minSpareThreads最小活跃线程数。默认25
maxIdleTime当前活跃线程大于minSpareThreads时,空闲线程关闭的等待最大时间。默认60000ms
maxQueueSize线程池满情况下的请求排队大小。默认Integer.MAX_VALUE
<Service name="xxx">
  <Executor name="tomcatThreadPool" namePrefix="catalina-exec-" maxThreads="300" minSpareThreads="25"/>
</Service>

Connector

Connector代表连接组件。Tomcat 支持三种协议：HTTP/1.1、HTTP/2.0、AJP。

属性表

属性说明备注
asyncTimeoutServlet3.0规范中的异步请求超时默认30s
port请求连接的TCP Port设置为0,则会随机选取一个未占用的端口号
protocol协议. 一般情况下设置为 HTTP/1.1,这种情况下连接模型会在NIO和APR/native中自动根据配置选择 
URIEncoding对URI的编码方式.如果设置系统变量org.apache.catalina.STRICT_SERVLET_COMPLIANCE为true,使用 ISO-8859-1编码;如果未设置此系统变量且未设置此属性, 使用UTF-8编码
useBodyEncodingForURI是否采用指定的contentType而不是URIEncoding来编码URI中的请求参数 

以下属性在标准的Connector(NIO, NIO2 和 APR/native)中有效:

属性说明备注
acceptCount当最大请求连接maxConnections满时的最大排队大小默认100,注意此属性和Executor中属性maxQueueSize的区别.这个指的是请求连接满时的堆栈大小,Executor的maxQueueSize指的是处理线程满时的堆栈大小
connectionTimeout请求连接超时默认60000ms
executor指定配置的线程池名称 
keepAliveTimeoutkeeAlive超时时间默认值为connectionTimeout配置值.-1表示不超时
maxConnections最大连接数连接满时后续连接放入最大为acceptCount的队列中. 对 NIO和NIO2连接,默认值为10000;对 APR/native,默认值为8192
maxThreads如果指定了Executor, 此属性忽略;否则为Connector创建的内部线程池最大值默认200
minSpareThreads如果指定了Executor, 此属性忽略;否则为Connector创建线程池的最小活跃线程数默认10
processorCache协议处理器缓存Processor对象的大小-1表示不限制.当不使用servlet3.0的异步处理情况下: 如果配置Executor,配置为Executor的maxThreads;否则配置为Connnector的maxThreads. 如果使用Serlvet3.0异步处理, 取maxThreads和maxConnections的最大值

Context

Context元素表示一个Web应用程序，它在特定的虚拟主机中运行。每个Web应用程序都基于Web应用程序存档（WAR）文件，或者包含相应的解包内容的相应目录，如Servlet规范中所述。

属性表

属性说明备注
altDDNameweb.xml部署描述符路径默认 /WEB-INF/web.xml
docBaseContext的Root路径和Host的appBase相结合, 可确定web应用的实际目录
failCtxIfServletStartFails同Host中的failCtxIfServletStartFails, 只对当前Context有效默认为false
logEffectiveWebXml是否日志打印web.xml内容(web.xml由默认的web.xml和应用中的web.xml组成)默认为false
pathweb应用的context path如果为根路径,则配置为空字符串(""), 不能不配置
privileged是否使用Tomcat提供的manager servlet 
reloadable/WEB-INF/classes/ 和/WEB-INF/lib/ 目录中class文件发生变化是否自动重新加载默认为false
swallowOutputtrue情况下, System.out和System.err输出将被定向到web应用日志中默认为false

Engine

Engine元素表示与特定的Catalina服务相关联的整个请求处理机器。它接收并处理来自一个或多个连接器的所有请求，并将完成的响应返回给连接器，以便最终传输回客户端。

属性表

属性描述备注
defaultHost默认主机名，用于标识将处理指向此服务器上主机名称但未在此配置文件中配置的请求的主机。这个名字必须匹配其中一个嵌套的主机元素的名字属性。
name此引擎的逻辑名称，用于日志和错误消息。在同一服务器中使用多个服务元素时，每个引擎必须分配一个唯一的名称。

Host

Host元素表示一个虚拟主机，它是一个服务器的网络名称（如“www.mycompany.com”）与运行Tomcat的特定服务器的关联。

属性表

属性说明备注
name名称用于日志输出
appBase虚拟主机对应的应用基础路径可以是个绝对路径, 或${CATALINA_BASE}相对路径
xmlBase虚拟主机XML基础路径,里面应该有Context xml配置文件可以是个绝对路径, 或${CATALINA_BASE}相对路径
createDirs当appBase和xmlBase不存在时,是否创建目录默认为true
autoDeploy是否周期性的检查appBase和xmlBase并deploy web应用和context描述符默认为true
deployIgnore忽略deploy的正则 
deployOnStartupTomcat启动时是否自动deploy默认为true
failCtxIfServletStartFails配置为true情况下,任何load-on-startup >=0的servlet启动失败,则其对应的Contxt也启动失败默认为false

Cluster

由于在实际开发中，我从未用过Tomcat集群配置，所以没研究。

启动

部署方式

这种方式要求本地必须安装 Tomcat 。

将打包好的 war 包放在 Tomcat 安装目录下的 webapps 目录下，然后在 bin 目录下执行 startup.bat 或 startup.sh ，Tomcat 会自动解压 webapps 目录下的 war 包。

成功后，可以访问 http://localhost:8080/xxx （xxx 是 war 包文件名）。

注意

以上步骤是最简单的示例。步骤中的 war 包解压路径、启动端口以及一些更多的功能都可以修改配置文件来定制 （主要是 server.xml 或 context.xml 文件）。

嵌入式

API 方式

在 pom.xml 中添加依赖

<dependency>
  <groupId>org.apache.tomcat.embed</groupId>
  <artifactId>tomcat-embed-core</artifactId>
  <version>8.5.24</version>
</dependency>

添加 SimpleEmbedTomcatServer.java 文件，内容如下：

import java.util.Optional;
import org.apache.catalina.startup.Tomcat;

public class SimpleTomcatServer {
    private static final int PORT = 8080;
    private static final String CONTEXT_PATH = "/javatool-server";

    public static void main(String[] args) throws Exception {
        // 设定 profile
        Optional<String> profile = Optional.ofNullable(System.getProperty("spring.profiles.active"));
        System.setProperty("spring.profiles.active", profile.orElse("develop"));

        Tomcat tomcat = new Tomcat();
        tomcat.setPort(PORT);
        tomcat.getHost().setAppBase(".");
        tomcat.addWebapp(CONTEXT_PATH, getAbsolutePath() + "src/main/webapp");
        tomcat.start();
        tomcat.getServer().await();
    }

    private static String getAbsolutePath() {
        String path = null;
        String folderPath = SimpleEmbedTomcatServer.class.getProtectionDomain().getCodeSource().getLocation().getPath()
                .substring(1);
        if (folderPath.indexOf("target") > 0) {
            path = folderPath.substring(0, folderPath.indexOf("target"));
        }
        return path;
    }
}

成功后，可以访问 http://localhost:8080/javatool-server 。

说明

本示例是使用 org.apache.tomcat.embed 启动嵌入式 Tomcat 的最简示例。

这个示例中使用的是 Tomcat 默认的配置，但通常，我们需要对 Tomcat 配置进行一些定制和调优。为了加载配置文件，启动类就要稍微再复杂一些。这里不想再贴代码，有兴趣的同学可以参考：

示例项目

使用 maven 插件启动（不推荐）

不推荐理由：这种方式启动 maven 虽然最简单，但是有一个很大的问题是，真的很久很久没发布新版本了（最新版本发布时间：2013-11-11）。且貌似只能找到 Tomcat6 、Tomcat7 插件。

使用方法

在 pom.xml 中引入插件

<plugin>
  <groupId>org.apache.tomcat.maven</groupId>
  <artifactId>tomcat7-maven-plugin</artifactId>
  <version>2.2</version>
  <configuration>
    <port>8080</port>
    <path>/${project.artifactId}</path>
    <uriEncoding>UTF-8</uriEncoding>
  </configuration>
</plugin>

运行 mvn tomcat7:run 命令，启动 Tomcat。

成功后，可以访问 http://localhost:8080/xxx （xxx 是 ${project.artifactId} 指定的项目名）。

IDE 插件

常见 Java IDE 一般都有对 Tomcat 的支持。

以 Intellij IDEA 为例，提供了 Tomcat and TomEE Integration 插件（一般默认会安装）。

使用步骤

  • 点击 Run/Debug Configurations > New Tomcat Server > local ，打开 Tomcat 配置页面。
  • 点击 Confiure... 按钮，设置 Tomcat 安装路径。
  • 点击 Deployment 标签页，设置要启动的应用。
  • 设置启动应用的端口、JVM 参数、启动浏览器等。
  • 成功后，可以访问 http://localhost:8080/（当然，你也可以在 url 中设置上下文名称）。

tomcat-intellij-run-config.png

说明

个人认为这个插件不如 Eclipse 的 Tomcat 插件好用，Eclipse 的 Tomcat 插件支持对 Tomcat xml 配置文件进行配置。而这里，你只能自己去 Tomcat 安装路径下修改配置文件。

资料
推荐

文中的嵌入式启动示例可以参考我的示例项目


作者： 静默虚空 
链接：https://www.imooc.com/article/22641
来源：慕课网
GarfieldEr007
关注
专栏目录
Tomcat从入门到精通：全方位深度解析与实战教程
java专栏
04-21 1014
通过本篇深度解析，读者从零开始学习了Tomcat的安装、配置、使用、优化、故障排查等全过程，掌握了Tomcat作为Java Web服务器的核心功能与应用场景。结合丰富的代码示例与注释，读者应能熟练部署、管理Web应用，进行性能调优与故障排查，从而在实际工作中高效利用Tomcat这一强大工具。Apache Tomcat，简称Tomcat，是一个开源的轻量级应用服务器，专为运行Java Servlet和JavaServer Pages (JSP)技术设计。，如果看到Tomcat的欢迎页面，说明安装和启动成功。
Spring boot学习教程之快速入门篇
08-30
Spring Boot快速入门教程 Spring Boot 简介 Spring Boot 是一个基于 Spring 框架的快速应用开发工具，可以创建独立的 Spring 应用，内置 Tomcat 或 Jetty web 服务器，并且可以自动依赖，不需要 XML 配置。 ...
Tomcat全攻略（TOMCAT详细教程）
04-27
omcat全攻略（TOMCAT详细教程）
Tomcat 快速入门
weixin_33688840的博客
01-10 373
Tomcat 快速入门 版本说明 本文使用 Tomcat 版本为 Tomcat 8.5.24。 Tomcat 8.5 要求 JDK 版本为 1.7 以上。 简介 Tomcat 是什么 Tomcat 是由 Apache 开发的一个 Servlet 容器，实现了对 Servlet 和 JSP 的支持，并提供了作为Web服务器的一些特有功能，如Tomcat管理和控制平台、安全域管理和Tomcat阀等...
【Tomcat】快速入门
最新发布
小秀的博客
07-25 472
Tomcat是Apache软件基金会一个核心项目，是一个开源免费的轻量级Web服务器，支持Servlet/JSP.少量avaEE规范。TomcatTomcat也被称为Web容器、Servlet容器。Servleti程序需要依赖于Tomcat才能运行。
Tomcat快速入门
Brother_ning的博客
01-20 1462
Tomcat介绍，Tomcat安装，Tomcat部署静态页面
Myeclipse部署Tomcat教程：快速入门与设置详解
在MyEclipse中部署Tomcat是一项常见的开发任务，本文档详细介绍了如何通过Myeclipse进行这项操作。首先，创建一个新的"WebProject"，其中包含以下几个关键组件： 1. **ProjectName**：这是工程的名称，与实际的...
Jeecg3.7.8在线教程：Tomcat部署与快速入门
提供了Maven入门视频、Jeecg入门视频以及Jeecg开发工具的下载链接，帮助开发者快速入门。此外，还有Jeecg的私有Maven仓库配置方法。 接下来，我们转向6g网络的话题： 6g网络性能指标和潜在关键技术是当前通信领域...
使用IntelliJ IDEA配置Tomcat入门教程
09-30
IntelliJ IDEA配置Tomcat入门教程详细地介绍了如何在IntelliJ IDEA开发环境中配置Tomcat服务器，以及如何进行简单的...对于初学者来说，这些步骤能够帮助他们快速入门并使用Tomcat作为服务器进行Web应用的开发和测试。
Tomcat教程
06-11
Tomcat服务器的详细教程，全面了解Tomcat服务器的部署、结构及应用
Tomcat快速入门（javaweb）
张铎
05-09 596
Tomcat: web服务器软件 1.下载 ：http://tomcat.apache.org/ 2.安装 ：解压压缩包即可 注意：安装目录建议不要有中文和空格 3.卸载 ：删除目录即可 4.启动： bin/startup.bat 双击运行该文件即可 访问：http://localhost:8080 回车访问自己 http://别人的ip:8080 访问别人 可能遇到的问题： 1.黑窗口一闪而过 原因...
【运维知识进阶篇】Tomcat快速入门（Java环境介绍+Tomcat快速安装+Tomcat配置文件+Tomcat配置虚拟主机+Tomcat管理界面+Tomcat部署zrlog博客项目）
吾日三省吾身，想出类拔萃，要把知识学牢，学全，学深，学广。
07-09 3483
JVM介绍：Java业务都是运行在Java虚拟机上，Java虚拟机简称为JVM，虚拟机是通过软件模拟出具有完整硬件系统的功能为什么Java需要JVM虚拟机？早期C语言，不支持跨平台，如果C语言想要在Windows Linux Mac上运行，需要进行分别编译，那么在Linux上有很多优秀的软件，如果需要在Windows上使用需要重新编译，移植性差。而Java则不同，Java是可以跨平台，只需要将源码进行一次编译，能够在不同的操作系统运行。Java是如何做到的？
tomcat快速入门--硬核操作
weixin_60663670的博客
03-27 269
-Tomcat的安装与配置 解压：路径不要有中文和空格 目录结构说明： bin：可执行文件目录 conf：配置文件目录 lib：存放lib的目录 logs：日志文件目录 temp：临时目录 webapps：项目部署的目录 work：工作目录 ...
【Tomcat】壹 - Tomcat的快速入门：你也许会用Tomcat，但你真的了解它吗？本文章收录了Tomcat的简介、Tomcat各文件夹的作用、Tomcat的安装卸载使用，手动部署Tomcat
游坦之的博客
09-07 478
你也许会用Tomcat，但你真的了解它吗？来看这篇文章吧。本文章收录了Tomcat的安装与删除、Tomcat各文件夹的作用、Tomcat的简介、Tomcat使用中的问题以及如何手动部署Tomcat，你真的不来看看吗？总有一个模块适合你！
Tomcat4.01 配置全攻略
feng_sundy 的专栏
10-25 1550
相关网址：http://www.yufeng.net ----------------------------- Tomcat4.01全攻略  一：简介  tomcat是jakarta项目中的一个重要的子项目，其被JavaWorld杂志的编辑选为2001年度最具创新的java产品(Most Innovative Java Product)，同时它又是sun公司官方推荐的servlet和jsp容
TOMCAT详细教程
mamengsi的专栏
05-20 177
随着java的流行，其在web上的应用也越来越广，tomcat作为一个开源的servlet容器，应用前景越来越广，本文将向你讲述tomcat的一些知识。 　　一：简介 　　tomcat是jakarta项目中的一个重要的子项目，其被JavaWorld杂志的编辑选为2001年度最具创新的java产品(Most Innovative Java Product)，同时它又是sun公司官方...
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值