开发第一个带有Servlet（java小程序）的webapp

第一步，首先需要在webapps目录下新建一个目录，目录名根据具体项目而定，这里起名crm。

注意：crm就是这个webapp的名字，同时也是这个webapp的根。

第二步，在webapp的根下新建一个目录：WEB-INF

注意：这个目录的名字是Servlet规范中规定的，必须全部大写，必须一模一样。

第三步，在WEB-INF目录下新建一个目录：classes

注意：这个目录的名字必须是全部小写的classes。这也是Servlet规范中规定的。另外这个目录下一定存放的是Java程序编译之后的class文件（这里存放的是字节码文件）。

第四步，在WEB-INF目录下新建一个目录：lib

注意：这个目录不是必须的。但如果一个webapp需要第三方的jar包的话，这个jar包要放到这个lib目录下，这个目录的名字也不能随意编写，必须是全部小写的lib。例如java语言连接数据库需要数据库的驱动jar包。那么这个jar包就一定要放到lib目录下。这Servlet规范中规定的。

第五步，在WEB-INF目录下新建一个文件：web.xml

注意：这个文件名必须叫做web.xml，这个文件必须放在这里。一个合法的webapp里，这个web.xml文件就是一个配置文件，在这个配置文件中描述了请求路径和Servlet类之间的对照关系。

这个web.xml文件最好从其他的webapp中拷贝(复制粘贴)。

下面是web.xml最基本的代码块

<?xml version="1.0" encoding="UTF-8"?>

<web-app xmlns="https://jakarta.ee/xml/ns/jakartaee"
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xsi:schemaLocation="https://jakarta.ee/xml/ns/jakartaee
                      https://jakarta.ee/xml/ns/jakartaee/web-app_5_0.xsd"
  version="5.0"
  metadata-complete="true">


</web-app>

第六步，编写一个Java程序，不能随意，必须实现Servlet接口。

• 这个Servlet接口不在JDK当中。（因为Servlet不是JavaSE了。Servlet属于JavaEE，是另外的一套类库。）

• Servlet接口（Servlet.class文件）是Oracle提供的。（最原始的是sun公司提供的。）

• Servlet接口是JavaEE的规范中的一员。

• Tomcat服务器实现了Servlet规范，所以Tomcat服务器也需要使用Servlet接口。Tomcat服务器中应该有这个接口，Tomcat服务器的CATALINA_HOME\lib目录下有一个servlet-api.jar，解压这个servlet-api.jar之后，你会看到里面有一个Servlet.class文件。

• 重点：从JakartaEE9开始，Servlet接口的全名变了：jakarta.servlet.Servlet

• 注意：编写这个Java小程序的时候，java源代码你愿意在哪里就在哪里，位置无所谓，你只需要将java源代码编译之后的class文件放到classes目录下即可。

 第七步：编译我们编写的java

• 重点：怎么能让你的java编译通过呢？配置环境变量CLASSPATH

  CLASSPATH=.;C:\tool\apache-tomcat-10.0.12\lib\servlet-api.jar

• 集成工具：将CATALINA_HOME/lib/servlet-api.jar和jsp-api.jar添加到IDEA的classpath当中

  • File --> Project Structrue --> Modules --> + 加号 --> Add JARS....

• 实现jakarta.servlet.Servlet接口中的5个方法

• 以上配置的CLASSPATH和Tomcat服务器运行没有任何关系，以上配置这个环境变量只是为了让你的java能够正常编译生成class文件。

  package servlet;
  
  
  import jakarta.servlet.*;
  
  import java.io.IOException;
  import java.io.PrintWriter;
  
  public class HelloServlet implements Servlet {
  
      @Override
      public void init(ServletConfig servletConfig) throws ServletException {
  
      }
  
      @Override
      public ServletConfig getServletConfig() {
          return null;
      }
  
      @Override
      public void service(ServletRequest servletRequest, ServletResponse servletResponse) throws ServletException, IOException {
          System.out.println("My First Servlet, Hello Servlet");
          // 向控制台打印输出
  
          // 设置响应的内容类型是普通文本或html代码
          // 需要在获取流对象之前设置，有效。
          servletResponse.setContentType("text/html");
  
          // 怎么将一个信息直接输出到浏览器上？
          // 需要使用ServletResponse接口：ServletResponse
          // ServletResponse表示响应：从服务器向浏览器发送数据叫做响应。
          PrintWriter out = servletResponse.getWriter();
  
          // 设置响应的内容类型时不要在获取流之后设置。
          //ServletResponse.setContentType("text/html");
          out.print("Hello Servlet, You are my first servlet!");
  
          // 浏览器是能够识别html代码的，那我们是不是应该输出一段HTML代码呢？
          out.print("<h1>hello servlet，你好Servlet</h1>");
  
          // 这是一个输出流，负责输出字符串到浏览器
          // 这个输出流不需要我们刷新，也不需要我们关闭，这些都由Tomcat来维护。
  		/*
  		out.flush();
  		out.close();
  		*/
  
      }
  
      @Override
      public String getServletInfo() {
          return null;
      }
  
      @Override
      public void destroy() {
  
      }
  }

第八步：将以上编译之后的  .class 文件（带包名一起）拷贝到WEB-INF\classes目录下。

WEB-INF\classes\servlet\HelloServlet.class  

第九步：在web.xml文件中编写配置信息，让“请求路径”和“Servlet类名”关联在一起。 

• 这一步用专业术语描述：在web.xml文件中注册Servlet类。

• 写xml文件的是后最好不出现中文，以免Tomcat服务器报错

• 文件放到WEB-INF目录下即可

  <?xml version="1.0" encoding="UTF-8"?>
  
  <web-app xmlns="https://jakarta.ee/xml/ns/jakartaee"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="https://jakarta.ee/xml/ns/jakartaee
                        https://jakarta.ee/xml/ns/jakartaee/web-app_5_0.xsd"
    version="5.0"
    metadata-complete="true">
  
  	<servlet>
          <!--servlet描述信息-->
  	    <!--任何一个servlet都对应一个servlet-mapping -->
  
  		<servlet-name>molu</servlet-name>
  		<!--这个名字是随便的写的-->
  
  		<servlet-class>servlet.HelloServlet</servlet-class>
          <!--这个位置必须是带有包名的全限定类名-->
  
  	</servlet>
  
  	<servlet-mapping>
          <!--servlet映射信息-->
  
  		<servlet-name>molu</servlet-name>
          <!--这个也是随便的，不过这里写的内容要和上面的一样。-->
  		
  		<url-pattern>/molu/fd</url-pattern>
          <!--这里需要一个路径-->
  		<!--这个路径唯一的要求是必须以 / 开始-->
  		<!--当前这个路径可以随便写-->
  
  	</servlet-mapping>
  	
  </web-app>

第十步：启动Tomcat服务器（这里已经成功启动）

第十一步：打开浏览器，在浏览器地址栏上输入一个url

这个URL必须是： http://127.0.0.1:8080/crm/molu/fd

非常重要的一件事：浏览器上的请求路径不能随便写，这个请求路径必须和web.xml文件中的url-pattern一致。

注意：浏览器上的请求路径和web.xml文件中的url-pattern的唯一区别就是：浏览器上的请求路径带项目名：/crm

如果浏览器上编写的路径太复杂，例如：http://127.0.0.1:8080/molu/crm/fdsa/d/sa/fd/sa/fd

可以使用超链接跳转。

编写intex.html页面 

<!DOCTYPE html>
<html>
	<head>
		<meta charset="utf-8">
		<title>intex page</title>
	</head>
	<body>
		<a href="/crm/molu/fd">hello servlet</a>
        <!--写入上个url-->
		<!--http://127.0.0.1:8080/crm/molu/fd 前面的端口和ip地址都可以省略 -->
	</body>
</html>

非常重要：html页面只能放到WEB-INF目录外面。

 crm\intex.html

打开浏览器输入url： http://127.0.0.1:8080/crm/intex.html