Servlet(二)：开发一个带有Servlet的webapp（Java小程序）

本文链接：https://blog.csdn.net/weixin_46177735/article/details/126614009

开发步骤是怎样的？

第一步：在webapps目录下新建一个目录，起名crm（这个crm就是webapp的名字）。当然，也可以是其它项目，比如银行项目，可以创建一个目录bank，办公系统可以创建一个oa。
- 注意：crm就是这个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文件是必须的，这个web.xml文件就是一个配置文件，在这个配置文件中描述了请求路径和Servlet类之间的对照关系。
- 这个文件最好从其他的webapp中拷贝，最好别手写。没必要。复制粘贴
- ```
<?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程序，这个小Java程序也不能随意开发，这个小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目录下即可。
第七步：编译我们编写的HelloServlet
- 重点：你怎么能让你的HelloServlet编译通过呢？配置环境变量CLASSPATH
  
  CLASSPATH=.;C:\dev\apache-tomcat-10.0.12\lib\servlet-api.jar
- 思考问题：以上配置的CLASSPATH和Tomcat服务器运行有没有关系？
  - 没有任何关系，以上配置这个环境变量只是为了让你的HelloServlet能够正常编译生成class文件。
第八步：将以上编译之后的HelloServlet.class文件拷贝到WEB-INF\classes目录下。

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

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

<?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-mapping -->
    <servlet>
        <servlet-name>fdsafdsagfdsafdsa</servlet-name>
        <!--这个位置必须是带有包名的全限定类名-->
        <servlet-class>com.bjpowernode.servlet.HelloServlet</servlet-class>
    </servlet>

    <!--servlet映射信息-->
    <servlet-mapping>
        <!--这个也是随便的，不过这里写的内容要和上面的一样。-->
        <servlet-name>fdsafdsagfdsafdsa</servlet-name>
        <!--这里需要一个路径-->
        <!--这个路径唯一的要求是必须以 / 开始-->
        <!--当前这个路径可以随便写-->
        <url-pattern>/fdsa/fd/saf/d/sa/fd/sa/fd</url-pattern>
    </servlet-mapping>
    
</web-app>

第十步：启动Tomcat服务器
第十一步：打开浏览器，在浏览器地址栏上输入一个url，这个URL必须是：
- http://127.0.0.1:8080/crm/fdsa/fd/saf/d/sa/fd/sa/fd
- 非常重要的一件事：浏览器上的请求路径不能随便写，这个请求路径必须和web.xml文件中的url-pattern一致。
- 注意：浏览器上的请求路径和web.xml文件中的url-pattern的唯一区别就是：浏览器上的请求路径带项目名：/crm
浏览器上编写的路径太复杂，可以使用超链接。（非常重要：html页面只能放到WEB-INF目录外面。）
以后不需要我们编写main方法了。tomcat服务器负责调用main方法，Tomcat服务器启动的时候执行的就是main方法。我们javaweb程序员只需要编写Servlet接口的实现类，然后将其注册到web.xml文件中，即可。

总结一下：一个合法的webapp目录结构应该是怎样的？

webapproot
     |------WEB-INF
              |------classes(存放字节码)
              |------lib(第三方jar包)
              |------web.xml(注册Servlet)
     |------html
     |------css
     |------javascript
     |------image
     ....

浏览器发送请求，到最终服务器调用Servlet中的方法，是怎样的一个过程？（以下这个过程描述的很粗糙。其中还有很多步骤我省略了。）
- 用户输入URL，或者直接点击超链接：http://127.0.0.1:8080/crm/fdsa/fd/saf/d/sa/fd/sa/fd
- 然后Tomcat服务器接收到请求，截取路径：/crm/fdsa/fd/saf/d/sa/fd/sa/fd
- Tomcat服务器找到crm项目
- Tomcat服务器在web.xml文件中查找/fdsa/fd/saf/d/sa/fd/sa/fd 对应的Servlet是：com.bjpowernode.servlet.HelloServlet
- Tomcat服务器通过反射机制，创建com.bjpowernode.servlet.HelloServlet的对象。
- Tomcat服务器调用com.bjpowernode.servlet.HelloServlet对象的service方法。