使用文本编辑器开发一个带有Servlet的webapp
- 一、开发步骤
- 二、总结
- 1. 一个合法的webapp目录结构应该是怎样的?
- 2. 回顾上面的原理
- 3. (补充)关于JavaEE的版本
- 三、向浏览器响应一段HTML代码
- 四、在Servlet中连接数据库,怎么做?
以下所讲解的内容都是基于servlet文本编辑器开发的原理,手把手【脱离idea实现】、非idea编写代码,开发实现webapp。
一、开发步骤
- 第一步:在webapps目录下新建一个目录,起名crm项目(这个crm就是webapp的名字【可以随便取】)。当然,也可以是其它项目,比如银行项目,可以创建一个目录bank,办公系统可以创建一个oa等等。
- 注意:crm就是这个webapp的根
- 第二步:在crm的根下新建一个目录: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(该内容:关于JavaEE的版本 这块有讲解)
- 注意:编写这个Java小程序的时候,java源代码你愿意在哪里就在哪里,位置无所谓,你只需要将java源代码编译之后的class文件放到classes目录下即可。
编写一个HelloServlet.java程序【自定义存放位置】
package com.aimoyudett.servlet;
import jakarta.servlet.Servlet;
import jakarta.servlet.ServletException;
import jakarta.servlet.ServletRequest;
import jakarta.servlet.ServletResponse;
import jakarta.servlet.ServletConfig;
import java.io.IOException;
public class HelloServlet implements Servlet{
// 5个方法
public void init(ServletConfig config) throws ServletException{
}
public void service(ServletRequest request,ServletResponse response)
throws ServletException , IOException{
System.out.println("My First Servlet, Hello Servlet");
}
public void destroy(){
}
public String getServletInfo(){
return "";
}
public ServletConfig getServletConfig(){
return null;
}
}
- 第七步:编译我们编写的HelloServlet【doc命令行进行编译 javac -d . HelloServlet.java】
- 重点:你怎么能让你的HelloServlet编译通过呢?
○ 配置环境变量CLASSPATHCLASSPATH=.;E:\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类。
<!--servlet描述信息-->
<!--任何一个servlet都对应一个servlet-mapping -->
<servlet>
<servlet-name>aimoyudett</servlet-name>
<!--这个位置必须是带有包名的全限定类名-->
<servlet-class>com.aimoyudett.servlet.HelloServlet</servlet-class>
</servlet>
<!--servlet映射信息-->
<servlet-mapping>
<!--这个也是随便的,不过这里写的内容要和上面的一样。-->
<servlet-name>aimoyudett</servlet-name>
<!--这里需要一个路径-->
<!--这个路径唯一的要求是必须以 / 开始-->
<!--当前这个路径可以随便写-->
<url-pattern>/aimoyudett/tt</url-pattern>
</servlet-mapping>
- 第十步:启动Tomcat服务器
- 第十一步:打开浏览器,在浏览器地址栏上输入一个url,这个URL必须是http://127.0.0.1:8088/crm/aimoyudett/tt
- 非常重要的一件事:浏览器上的请求路径不能随便写,这个请求路径必须和web.xml文件中的url-pattern一致。
- 注意:浏览器上的请求路径和web.xml文件中的url-pattern的唯一区别就是:浏览器上的请求路径带项目名:/crm + url-pattern
- 浏览器上编写的路径太复杂,可以使用超链接。(非常重要:html页面只能放到WEB-INF目录外面。)
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<title>index page</title>
</head>
<body>
<a href="/crm/aimoyudett/tt">hello servlet</a>
</body>
</html>
运行结果:
- 以后不需要我们编写main方法了。tomcat服务器负责调用main方法,Tomcat服务器启动的时候执行的就是main方法。我们javaweb程序员只需要编写Servlet接口的实现类,然后将其注册到web.xml文件中,即可。
二、总结
1. 一个合法的webapp目录结构应该是怎样的?
webapps:root(根)
|------WEB-INF
|------classes(存放字节码)
|------lib(第三方jar包)
|------web.xml(注册Servlet)
|------html
|------css
|------javascript
|------image
....
2. 回顾上面的原理
浏览器发送请求,到最终服务器调用Servlet中的方法,是怎样的一个过程?(以下这个过程描述的很粗糙。其中还有很多步骤我省略了。)
- 用户输入URL,或者直接点击超链接:http://127.0.0.1:8088/crm/aimoyudett/tt
- 然后Tomcat服务器接收到请求,截取路径:/crm/aimoyudett/tt
- Tomcat服务器找到crm项目
- Tomcat服务器在web.xml文件中查找/aimoyudett/tt 对应的Servlet是:com.aimoyudett.servlet.HelloServlet
- Tomcat服务器通过反射机制,创建com.aimoyudett.servlet.HelloServlet的对象。
- Tomcat服务器调用com.aimoyudett.servlet.HelloServlet对象的service方法。
3. (补充)关于JavaEE的版本
- JavaEE目前最高版本是 JavaEE8
- JavaEE被Oracle捐献了,Oracle将JavaEE规范捐献给Apache了。
- Apache把JavaEE换名了,以后不叫JavaEE了,以后叫做 jakarta EE。
- 以后没有JavaEE了。以后都叫做Jakarta EE。
- JavaEE8版本升级之后的"JavaEE 9",不再是"JavaEE9"这个名字了,叫做JakartaEE9
- JavaEE8的时候对应的Servlet类名是:javax.servlet.Servlet
- JakartaEE9的时候对应的Servlet类名是:jakarta.servlet.Servlet (包名都换了)
- 如果你之前的项目还是在使用javax.servlet.Servlet,那么你的项目无法直接部署到Tomcat10+版本上。你只能部署到Tomcat9-版本上。在Tomcat9以及Tomcat9之前的版本中还是能够识别javax.servlet这个包。【有专门的工具进行互换转移】
三、向浏览器响应一段HTML代码
那怎么将信息输出到浏览器并响应HTML代码?
我们以上操作是相应在控制台的(后台),而不是我们浏览器界面。现在,我们实现其在浏览器响应。
public void service(ServletRequest request, ServletResponse response){
response.setContentType("text/html");
PrintWriter out = response.getWriter();
out.print("<h1>hello servlet!</h1>");
}
首先,在HelloServlet.java中增加代码:
接着,就重新编译为.class文件(后面步骤和上面一致)。
ok,结果如上所示,但没有进行html设置,下面就操作这步骤:
四、在Servlet中连接数据库,怎么做?
- Servlet是Java程序,所以在Servlet中完全可以编写JDBC代码连接数据库。
- 在一个webapp中去连接数据库,需要将驱动jar包放到WEB-INF/lib目录下。(com.mysql.cj.jdbc.Driver 这个类就在驱动jar包当中。)
首先,先创建一个数据库并且创建一张表存储数据(具体操作就不在这里详述了)
接着,就写个java程序连接数据库;编写完后,其他操作和上面一样(该编译为.class文件就编译…)。
package com.aimoyudett.servlet;
import jakarta.servlet.Servlet;
import jakarta.servlet.ServletException;
import jakarta.servlet.ServletRequest;
import jakarta.servlet.ServletResponse;
import jakarta.servlet.ServletConfig;
import java.io.IOException;
import java.io.PrintWriter;
import java.sql.*;
public class StudentServlet implements Servlet{
public void init(ServletConfig config) throws ServletException{
}
public void service(ServletRequest request,ServletResponse response)
throws ServletException , IOException{
// 设置响应的内容类型
response.setContentType("text/html");
PrintWriter out = response.getWriter();
// 编写JDBC代码,连接数据库,查询所有学生信息。
Connection conn = null;
PreparedStatement ps = null;
ResultSet rs = null;
try{
// 1. 注册驱动 (com.mysql.jdbc.Driver,这个已过时。)
// 新版本中建议使用:com.mysql.cj.jdbc.Driver驱动。【重点】
Class.forName("com.mysql.cj.jdbc.Driver");
// 2. 获取连接 库名:servlet_tt
String url = "jdbc:mysql://localhost:3306/servlet_tt";
String user = "root";
String password = "1368664****t";
conn = DriverManager.getConnection(url,user,password);
// 3. 获取预编译的数据库操作对象
String sql = "select no,name from t_student";
ps = conn.prepareStatement(sql);
// 执行SQL
rs = ps.executeQuery();
// 4. 处理查询结果集
while(rs.next()){
String no = rs.getString("no");
String name = rs.getString("name");
//System.out.println(no + "," + name);
out.print(no + "," + name + "<br>");
}
}catch(Exception e){
e.printStackTrace();
}finally{
// 释放资源
if(rs != null){
try{
rs.close();
}catch(Exception e){
e.printStackTrace();
}
}
if(ps != null){
try{
ps.close();
}catch(Exception e){
e.printStackTrace();
}
}
if(conn != null){
try{
conn.close();
}catch(Exception e){
e.printStackTrace();
}
}
}
}
public void destroy(){
}
public String getServletInfo(){
return "";
}
public ServletConfig getServletConfig(){
return null;
}
}
记得引入连接数据库的驱动.jar包!!!
运行结果: