共计 16463 个字符,预计需要花费 42 分钟才能阅读完成。
@[toc]
1. 背景
开发一个 app 与后台数据库交互, 基于 mysql+jdbc+tomcat, 没有使用 DBUtils 或 jdbc 框架, 纯粹底层 jdbc 实现.
以后逐步改用 Spring 框架, 优化 mysql, 进一步部署 tomcat 等等, 现在项目刚刚起步, 还有很多不懂的东西, 得慢慢来 ……
这几天踩了很多坑, 说得夸张点真是踩到我没有知觉, 希望能帮助别人少踩坑 …
2. 开发环境
- 系统 : win10
- IDE : Android Studio 3.5.1,IntelliJ IDEA 2019.02
- DBMS : Mysql 8.0.17
- web 服务器: tomcat9
3. 相关资源
- 1. 相关 jar 包:
mysqlV8.0.17 驱动 (注意这个要与自己的 mysql 版本对应)
java-servlet-api-V4.0.1
其他版本可以来这里搜索下载
Maven 仓库 - 2.github
这是源码地址, 包括前后端与建表等所有代码.
(欢迎 star)
- 3. 码云
这也是源码地址
4. 配置开发环境
IDE 就不说了, 重点说一下 mysql 与 tomcat9 的安装
一. 安装 Mysql8.0.17
这个是目前比较新的 mysql 版本.
服务器系统是 centos
其他系统安装看这里
- win10
- ubuntu
- fedroa
- reahat
centos 使用 yum 命令安装(参考链接)
(1) 下载 mysql
sudo yum localinstall https://repo.mysql.com//mysql80-community-release-el7-1.noarch.rpm
(2) 安装 mysql
sudo yum install mysql-community-server
(3) 启动服务
sudo service mysqld start
(4) 查看初始化密码, 用于下一步设置自己的 root 密码
sudo grep 'temporary password' /var/log/mysqld.log
(5) 本地使用 root 登录
mysql -u root -p
输入上一步看到的密码
(6) 更改密码
alter mysql.user 'root'@'localhost' identified by 'password';
注意新版本的 mysql 不能使用太弱的密码
如果出现如下提示
则说明密码太弱了, 请使用一个更高强度的密码
(7) 允许外部访问
use mysql;
update user set host='%' where user='root';
这个可以根据自己的需要去修改,host=’%’ 表明允许所有的 ip 登录, 也可以设置特定的 ip, 若使用 host=’%’ 的话建议新建一个用户配置相应的权限.
(8) 配置防火墙(可选)
由于作者使用的是阿里云的服务器, 没配置防火墙的话远程连接不上, 因此需要手动配置, 如图
其中授权对象可以根据自己的需要更改,0.0.0.0/ 0 表示允许所有的 ip.
二. 安装 tomcat9
(1) 先去官网下载, 下载后上传文件到服务器
作者使用的是 scp 命令, 不会的可以看这里
scp apache-tomcat-xxxx.tar.gz username@xx.xx.xx.xx:/
改成自己的用户名和 ip
(2) 连接到服务器, 解压压缩包
mkdir /usr/local/tomcat
mv apache-tomcat-xxxx.tar.gz /usr/local/tomcat
tar -xzvf apache-tomcat-xxx.tar.gz
(3) 修改 tomcat 默认端口(可选)
修改 conf/server.xml 文件, 一般只需修改
<Connector port="8080" protocol="HTTP/1.1" connectionTimeout="20000" redirectPort="8443" />
中的 8080 端口, 修改这个端口即可
这个懒的话 (比如作者) 可以不改
(4) 启动 tomcat
运行 bin 目录下的 startup.sh
cd bin
./startup.sh
(5) 测试
浏览器输入
服务器 IP: 端口
若出现
则表示成功.
(6)开机启动
建议配置开机启动, 修改 /etc/rc.local 文件
vim /etc/rc.local
添加
sh /usr/local/tomcat/bin/startup.sh
这个根据自己的 tomcat 安装路径修改, 指定 bin 下的 startup.sh 即可
5. 建库建表
创建用户表, 这里简化操作 (好吧我喜欢偷懒) 就不创建新用户不授权了
这是一个在本地用 root 登录的示例, 请根据实际情况创建并授权用户.
(1) 创建 user.sql
CREATE DATABASE userinfo;
USE userinfo;
CREATE TABLE user
(
id INT NOT NULL PRIMARY KEY AUTO_INCREMENT,
name CHAR(30) NULL,
password CHAR(30) NULL
);
(2) 导入到数据库
mysql -u root -p < user.sql
6. 后端部分
(1) 创建项目
选择 web application
选好路径, 改好名字后 finish
(2) 添加 jar 包
创建一个叫 lib 的目录
添加两个 jar 包:
mysql-connector-java-8.0.17.jar
javax.servlet-api-4.0.1.jar
打开 Project Structure
Modules–> + –> JARs or directories
选择刚才新建的 lib 下的两个 jar 包
打勾,apply
(3) 创建包与类
总共 4 个包
- com.servlet
用于处理来自前端的请求, 包含 SignUp.java,SignIn.java - com.util
主要功能是数据库连接, 包含 DBUtils.java - com.entity
用户类, 包含 User.java - com.dao
操作用户类的类, 包含 UserDao.java
(4) 先来处理 DBUtils 类
这个是连接数据库的类, 纯粹的底层 jdbc 实现, 注意驱动版本.
package com.util;
import java.sql.*;
public class DBUtils {
private static Connection connection = null;
public static Connection getConnection()
{
try {Class.forName("com.mysql.cj.jdbc.Driver");
String url = "jdbc:mysql://127.0.0.1:3306/ 数据库名字";
String usename = "账号";
String password = "密码";
connection = DriverManager.getConnection(url,usename,password);
}
catch (Exception e)
{e.printStackTrace();
return null;
}
return connection;
}
public static void closeConnection()
{if(connection != null)
{
try {connection.close();
}
catch (SQLException e)
{e.printStackTrace();
}
}
}
}
主要就是获取连接与关闭连接两个函数.
String url = "jdbc:mysql://127.0.0.1:3306/ 数据库名字";
String usename = "账号";
String password = "密码";
这几行根据自己的用户名, 密码, 服务器 ip 和库名修改
注意,mysql8.0 以上使用的注册驱动的语句是
Class.forName("com.mysql.cj.jdbc.Driver");
旧版的是
Class.forName("com.mysql.jdbc.Driver");
注意对应.
(5) 接下来处理 User 类
User 类比较简单, 就是就三个字段与 getter,setter
package com.entity;
public class User {
private int id;
private String name;
private String password;
public int getId() {return id;}
public void setId(int id) {this.id = id;}
public String getName() {return name;}
public void setName(String name) {this.name = name;}
public String getPassword() {return password;}
public void setPassword(String password) {this.password = password;}
}
(6) 接下来是 UserDao
package com.dao;
import com.entity.User;
import com.util.DBUtils;
import java.sql.Connection;
import java.sql.PreparedStatement;
import java.sql.ResultSet;
import java.sql.SQLException;
public class UserDao {public boolean query(User user)
{Connection connection = DBUtils.getConnection();
String sql = "select * from user where name = ? and password = ?";
try {PreparedStatement preparedStatement = connection.prepareStatement(sql);
preparedStatement.setString(1,user.getName());
preparedStatement.setString(2,user.getPassword());
ResultSet resultSet = preparedStatement.executeQuery();
return resultSet.next();}
catch (SQLException e)
{e.printStackTrace();
return false;
}
finally {DBUtils.closeConnection();
}
}
public boolean add(User user)
{Connection connection = DBUtils.getConnection();
String sql = "insert into user(name,password) values(?,?)";
try {PreparedStatement preparedStatement = connection.prepareStatement(sql);
preparedStatement.setString(1,user.getName());
preparedStatement.setString(2,user.getPassword());
preparedStatement.executeUpdate();
return preparedStatement.getUpdateCount() != 0;}
catch (SQLException e)
{e.printStackTrace();
return false;
}
finally {DBUtils.closeConnection();
}
}
}
主要就是查询与添加操作, 查询操作中存在该用户就返回 true, 否则返回 false
添加操作中使用 executeUpdate()与 getUpdateCount() != 0. 注意不能直接使用
return preparedStatement.execute();
去代替
preparedStatement.executeUpdate();
return preparedStatement.getUpdateCount() != 0;
咋一看好像没有什么问题, 那天晚上我测试的时候问题可大了,android 那边显示注册失败, 但是数据库这边的却 insert 进去了 ……… 我 ……
好吧说多了都是泪, 还是函数用得不够熟练.
- 一般来说 select 使用 executeQuery()
executeQuery()返回 ResultSet, 表示结果集, 保存了 select 语句的执行结果, 配合 next()使用 - delete,insert,update 使用 executeUpdate()
executeUpdate()返回的是一个整数, 表示受影响的行数, 即 delete,insert,update 修改的行数, 对于 drop,create 操作返回 0 -
create,drop 使用 execute()
execute()的返回值是这样的:- 如果第一个结果是 ResultSet 对象, 则返回 true
- 如果第一个结果是更新计数或者没有结果则返回 false
所以在这个例子中
return preparedStatement.execute();
肯定返回 false, 所以才会数据库这边 insert 进去, 但前端显示注册失败(这个 bug 作者找了很久 ……)
(7) servlet 包的 SignIn 与 SignUp 类
SingIn 类用于处理登录, 调用 jdbc 查看数据库是否有对应的用户
SignUp 类用于处理注册, 把 user 添加到数据库中
这两个使用的是 http 连接, 后期作者会采用 https 加密连接.
SignIn.java
package com.servlet;
import com.dao.UserDao;
import com.entity.User;
import javax.servlet.ServletException;
import javax.servlet.annotation.WebServlet;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import java.io.IOException;
@WebServlet("/SignIn")
public class SingIn extends HttpServlet {
@Override
protected void doGet(HttpServletRequest httpServletRequest, HttpServletResponse httpServletResponse) throws IOException,ServletException
{this.doPost(httpServletRequest,httpServletResponse);
}
@Override
protected void doPost(HttpServletRequest httpServletRequest,HttpServletResponse httpServletResponse) throws IOException, ServletException
{httpServletRequest.setCharacterEncoding("utf-8");
httpServletResponse.setCharacterEncoding("utf-8");
httpServletResponse.setContentType("text/plain;charset=utf-8");// 设置相应类型为 html, 编码为 utf-8
String name = httpServletRequest.getParameter("name");
String password = httpServletRequest.getParameter("password");
UserDao userDao = new UserDao();
User user = new User();
user.setName(name);
user.setPassword(password);
if(!userDao.query(user))// 若查询失败
{httpServletResponse.sendError(204,"query failed.");// 设置 204 错误码与出错信息
}
}
}
@WebServlet("/SignIn")
这行代码表示这是一个名字叫 SignIn 的 servlet, 可用于实现 servlet 与 url 的映射, 如果不在这里添加这个注解, 则需要在 WEB-INF 目录下的 web.xml 添加一个
<servlet-mapping>
叫 servlet 的映射
httpServletResponse.setContentType("text/plain;charset=utf-8");// 设置相应类型为 html, 编码为 utf-8
这行代码设置响应类型与编码
String name = httpServletRequest.getParameter("name");
String password = httpServletRequest.getParameter("password");
HttpServletRequest.getParameter(String name)方法表示根据 name 获取相应的参数
下面是 SignUp.java
package com.servlet;
import com.dao.UserDao;
import com.entity.User;
import javax.servlet.annotation.*;
import javax.servlet.http.*;
import javax.servlet.*;
import java.io.IOException;
@WebServlet("/SignUp")
public class SignUp extends HttpServlet {
@Override
protected void doGet(HttpServletRequest httpServletRequest,HttpServletResponse httpServletResponse) throws IOException,ServletException
{this.doPost(httpServletRequest,httpServletResponse);
}
@Override
protected void doPost(HttpServletRequest httpServletRequest,HttpServletResponse httpServletResponse) throws IOException,ServletException
{httpServletRequest.setCharacterEncoding("utf-8");
httpServletResponse.setCharacterEncoding("utf-8");// 设定编码防止中文乱码
httpServletResponse.setContentType("text/plain;charset=utf-8");// 设置相应类型为 html, 编码为 utf-8
String name = httpServletRequest.getParameter("name");// 根据 name 获取参数
String password = httpServletRequest.getParameter("password");// 根据 password 获取参数
UserDao userDao = new UserDao();
User user = new User();
user.setName(name);
user.setPassword(password);
if(!userDao.add(user)) // 若添加失败
{httpServletResponse.sendError(204,"add failed.");// 设置 204 错误码与出错信息
}
}
}
(8) 添加 servlet 到 web.xml
<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns="http://xmlns.jcp.org/xml/ns/javaee"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee http://xmlns.jcp.org/xml/ns/javaee/web-app_4_0.xsd"
version="4.0">
<servlet>
<servlet-name>SignIn</servlet-name>
<servlet-class>com.servlet.SingIn</servlet-class>
</servlet>
<servlet>
<servlet-name>SignUp</servlet-name>
<servlet-class>com.servlet.SignUp</servlet-class>
</servlet>
</web-app>
要把刚才创建的 Servlet 添加进 web.xml, 在 <servlet> 中添加子元素 <servlet-name> 与 <servlet-class>
<servlet-name> 是 Servlet 的名字, 最好与类名一致.
<servlet-class> 是 Servlet 类的位置.
如果在 Servlet 类中没有添加
@WebServlet("/xxxx")
这个注解, 则需要在 web.xml 中添加
<servlet-mapping>
<servlet-name>SignIn</servlet-name>
<url-pattern>/SignIn</url-pattern>
</servlet-mapping>
其中 <servlet-name> 与 <servlet> 中的子元素 <servlet-name> 中的值一致
<url-pattern> 是访问的路径
(9) 最后添加一个叫 Hello.html 的 html 文件用于测试.
<!DOCTYPE html>
<head>
<meta charset="utf-8">
<title>Welcome</title>
</head>
<body>
Hello web.
</body>
</html>
7. 打包发布
作者用的是 IDEA,Eclipse 的打包请看这里
(1) 打开 project structure
(2) 选择 Artifacts,Web Application:Archive
(3) 改名字, 创建 WEB-INF 目录与子目录 classes
(4) 选中 classes, 添加 Module Output, 选择自己的 web 项目
(5) 添加 jar 包, 选中 lib 目录后添加 jar 包文件
(那个 lib 文件夹被挡住了 …..)
(6) 添加 Hello.html 与 web.xml
web.xml 这个需要在 WEB-INF 目录里,Hello.html 在 WEB-INF 外面
(7) 打包,Build->Build Artifacts
(8) 上传到服务器
把打包好的.war 文件上传到服务器的 tomcat 的 /webapps 目录下的
scp ***.war username@xxx.xxx.xxx.xxx:/usr/local/tomcat/webapps
注意改成自己的 webapps 目录.
(9) 测试
在浏览器输入
服务器 IP: 端口 / 项目 /Hello.html
作者是在本地上开了 tomcat 后测试的
8. 前端页面部分
(1) 新建工程
(2) MainActivity.java
package com.cx;
import android.os.Bundle;
import android.view.View;
import android.widget.Button;
import android.widget.EditText;
import android.widget.Toast;
import androidx.appcompat.app.AppCompatActivity;
public class MainActivity extends AppCompatActivity {
@Override
protected void onCreate(Bundle savedInstanceState) {super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
Button signin = (Button) findViewById(R.id.signin);
signin.setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View view) {String name = ((EditText) findViewById(R.id.etname)).getText().toString();
String password = ((EditText) findViewById(R.id.etpassword)).getText().toString();
if (UserService.signIn(name, password))
runOnUiThread(new Runnable() {
@Override
public void run() {Toast.makeText(MainActivity.this, "登录成功", Toast.LENGTH_SHORT).show();}
});
else {runOnUiThread(new Runnable() {
@Override
public void run() {Toast.makeText(MainActivity.this, "登录失败", Toast.LENGTH_SHORT).show();}
});
}
}
});
Button signup = (Button) findViewById(R.id.signup);
signup.setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View view) {String name = ((EditText) findViewById(R.id.etname)).getText().toString();
String password = ((EditText) findViewById(R.id.etpassword)).getText().toString();
if (UserService.signUp(name, password))
runOnUiThread(new Runnable() {
@Override
public void run() {Toast.makeText(MainActivity.this, "注册成功", Toast.LENGTH_SHORT).show();}
});
else {runOnUiThread(new Runnable() {
@Override
public void run() {Toast.makeText(MainActivity.this, "注册失败", Toast.LENGTH_SHORT).show();}
});
}
}
});
}
}
没什么好说的, 就为两个 Button 绑定事件, 然后设置两个 Toast 提示信息.
(3) UserService.java
package com.cx;
import java.io.OutputStream;
import java.net.HttpURLConnection;
import java.net.URL;
import java.net.URLEncoder;
public class UserService {public static boolean signIn(String name, String password) {MyThread myThread = new MyThread("http:// 本机 IP:8080/cx/SignIn",name,password);
try
{myThread.start();
myThread.join();}
catch (InterruptedException e)
{e.printStackTrace();
}
return myThread.getResult();}
public static boolean signUp(String name, String password) {MyThread myThread = new MyThread("http:// 本机 IP:8080/cx/SignUp",name,password);
try
{myThread.start();
myThread.join();}
catch (InterruptedException e)
{e.printStackTrace();
}
return myThread.getResult();}
}
class MyThread extends Thread
{
private String path;
private String name;
private String password;
private boolean result = false;
public MyThread(String path,String name,String password)
{
this.path = path;
this.name = name;
this.password = password;
}
@Override
public void run()
{
try {URL url = new URL(path);
HttpURLConnection httpURLConnection = (HttpURLConnection) url.openConnection();
httpURLConnection.setConnectTimeout(8000);// 设置连接超时时间
httpURLConnection.setReadTimeout(8000);// 设置读取超时时间
httpURLConnection.setRequestMethod("POST");// 设置请求方法,post
String data = "name=" + URLEncoder.encode(name, "utf-8") + "&password=" + URLEncoder.encode(password, "utf-8");// 设置数据
httpURLConnection.setRequestProperty("Content-Type", "application/x-www-form-urlencoded");// 设置响应类型
httpURLConnection.setRequestProperty("Content-Length", data.length() + "");// 设置内容长度
httpURLConnection.setDoOutput(true);// 允许输出
OutputStream outputStream = httpURLConnection.getOutputStream();
outputStream.write(data.getBytes("utf-8"));// 写入数据
result = (httpURLConnection.getResponseCode() == 200);
} catch (Exception e) {e.printStackTrace();
}
}
public boolean getResult()
{return result;}
}
MyThread myThread = new MyThread("http:// 本机 IP:8080/cx/SignUp",name,password);
MyThread myThread = new MyThread("http:// 本机 IP:8080/cx/SignIn",name,password);
这两行换成自己的 ip, 本地 ip 的话可以用 ipconfig 或 ifconfig 查看, 修改了默认端口的话也把端口一起改了.
路径的话就是
端口 /web 项目名 /Servlet 名
web 项目名是再打成 war 包时设置的,Servlet 名在 web.xml 中的 <servlet> 的子元素 <servlet-name> 设置, 与 java 源码中的 @WebServlet()注解中的一致
另外一个要注意的就是线程问题, 需要新开一个线程进行 http 的连接
(4) activity_main.xml
前端页面部分很简单, 就两个 button, 用于验证功能.
<?xml version="1.0" encoding="utf-8"?>
<LinearLayout
xmlns:app="http://schemas.android.com/apk/res-auto"
xmlns:android="http://schemas.android.com/apk/res/android"
android:layout_height="match_parent"
android:layout_width="match_parent"
android:orientation="vertical"
>
<LinearLayout
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:orientation="horizontal">
<TextView
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:text="用户名"
/>
<EditText
android:layout_width="300dp"
android:layout_height="60dp"
android:id="@+id/etname"
/>
</LinearLayout>
<LinearLayout
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:orientation="horizontal">
<TextView
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:text="密码"
/>
<EditText
android:layout_width="300dp"
android:layout_height="60dp"
android:id="@+id/etpassword"
/>
</LinearLayout>
<LinearLayout
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:orientation="horizontal">
<Button
android:layout_width="120dp"
android:layout_height="60dp"
android:text="注册"
android:id="@+id/signup"
/>
<Button
android:layout_width="120dp"
android:layout_height="60dp"
android:text="登录"
android:id="@+id/signin"
/>
</LinearLayout>
</LinearLayout>
9. 测试
(1) 注册测试
随便输入用户名与密码
查看数据库
这里没有加密保存, 后期会添加加密保存
(2) 登录测试
perfect!
10. 注意事项
(1) 数据库的用户名和密码一定要设置正确, 要不然会这样提示
这个错误在加载驱动错误时也可能会出现这个错误, 因此要确保打成 war 包时 lib 目录正确且 jar 包版本正确.
还有就是由于这个是 jdbc 的底层实现, 注意手写的 sql 语句不能错
千万千万别像我这样:
(2) 网络权限问题
这个需要在 AndroidManifest.xml 添加网络权限
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
(3) 防火墙问题
服务器的话一般会有相应的相应的网页界面配置, 比如作者的是阿里云服务器, 当然也可以手动配置 iptables
修改 /etc/sysconfig/iptables
vim /etc/sysconfig/iptables
添加
-A INPUT -m state --state NEW -m tcp -p tcp --dport 8080 -j ACCEPT
-A RH-Firewall-1-INPUT -m state --state NEW -m tcp -p tcp --dport 8080 -j ACCEPT
重启 iptables
service iptables restart
(4) 使用 HTTP 注意事项
由于从 Android P 开始,google 默认要求使用加密连接, 即要使用 HTTPS, 所以会禁止使用 HTTP 连接
使用 HTTP 连接时会出现以下异常
W/System.err: java.io.IOException: Cleartext HTTP traffic to **** not permitted
java.net.UnknownServiceException: CLEARTEXT communication ** not permitted by network security policy
两种建议:
1 使用 HTTPS
2 修改默认的 AndroidManifest.xml 使其允许 HTTP 连接
在 res 下新建一个文件夹 xml, 创建一个叫 network_security_config.xml 的文件, 文件内容如下
<?xml version="1.0" encoding="utf-8"?>
<network-security-config>
<base-config cleartextTrafficPermitted="true" />
</network-security-config>
然后在 AndroidMainfest.xml 中加入
<application
android:networkSecurityConfig="@xml/network_security_config"
/>
即可
另一种办法是直接加入一句
android:usesCleartextTraffic="true"
<application
android:usesCleartextTraffic="true"
/>
(5) 线程问题
从 android4.0 开始, 联网不能再主线程操作, 万一网络不好就会卡死, 所以有关联网的操作都需要新开一个线程, 不能在主线程操作.
(6) AVD 问题
这个 bug 作者找了很久,http 连接没问题, 服务器没问题, 数据库没问题, 前端代码没问题, 然后去了 stackoverflow, 发现是 AVD 的问题, 我 …….
简单来说就是卸载了再重启 AVD, 居然成功了 …..
11 最后
作者小白一枚, 有什么不对的地方请大家指正, 评论作者会好好回复的.
下面是我的 CSDN 地址
CSDN
参考网站
1.Android 通过 Web 服务器与 Mysql 数据库交互
2.Android 高版本联网失败
3.IDEA 部署 Web 项目
4.PreparedStatement 的 executeQuery、executeUpdate 和 execute
5.preparedstatement execute() 操作成功!但是返回 false
6.HttpServletResponse(一)
7.HttpServletResponse(二)
8.HttpServletRequest
9.HttpUrlConnection
10.java.net.socketexception