java web开发(四) 接口开发补坑1

    好久都没写博客了，最近的工作重点是H5以及JavaScript方面的！后面要是有时间，会一直推出博文！

    今天的博文是补坑的！之前写了几篇有关java web接口开发的文章，有的朋友留言，说项目导入的时候有问题，或者说代码有的地方看不懂，等等其他问题。那么今天就来说说这些问题！如果你还没了解之前的接口博文，请先看java web开发(二) 接口开发！

一、项目导入报错。

  从csdn资源下载的代码，由Eclipse导入后，正常情况下，应该是会报错的！这个主要是我在导入项目的时候，没有将依赖的jar导入至lib目录中，所以导入项目的时候，很有可能会报错报错截图如下，

因为这个javax.servlet.*  包用的是Tomact下的 servlet-api.jar。

这个问题的解决办法是有2种，

方法1，从Tomact中的lib中找到这个servlet-api.jar，复制到项目的lib目录下，然后在这个jar上右键--->Build Path--->Add Build Path，即可！

方法2， 选项目右键--->Properties--->Java Build Path--->Libraries--->Add Library--->Server RunTime点击next，然后选择你的本地Tomact server--->Finish，最后点击Apply--->OK即可！

大功告....!结果可能还是报错了！就像这样的，看截图

这个错误是说，这个项目之前使用的是Tomact v6.0，而我现在给他配置的是 Tomact v8.5！

这个解决方法网上就比较多了！打开项目settings目录 org.eclipse.wst.common.project.facet.core.xml文件，

删除   <runtime name="Apache Tomcat v6.0"/> 这一行，保存！然后刷新项目！这个错误就没了！但是，你可能还会遇到其他的错误，例如提示说，jre的版本不匹配，那么就需要修改项目使用的jre版本！

这里就不详细列举各种各样的问题的解决方法了，如果有问题，就自行百度吧！相信，你可以的！

二、项目代码详解。

    这个地方主要是把之前在 java web开发(二) 接口开发写的中的代码，再次梳理！让小伙伴们在本篇博文中就可以直观的看出项目结构，以及主要代码！下面先给出整个项目的目录结构树，如下图所示，

下面一一来介绍这些包以及类，

1. cn.xinxing.action.student 这个包中是放置接口的，也就是向外部调用提供接口！下面我们就看看具体接口的代码，

 

package cn.xinxing.action.student;

import java.io.IOException;
import java.util.List;

import javax.servlet.ServletException;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;

import cn.xinxing.business.StudentBusiness;
import cn.xinxing.json.core.ListObject;
import cn.xinxing.json.responseUtils.ResponseUtils;
import cn.xinxing.json.status.StatusHouse;
import cn.xinxing.json.utils.JackJsonUtils;
import cn.xinxing.model.Students;

/**
 * Servlet implementation class StudentInq
 */
public class StudentInq extends HttpServlet {
	private static final long serialVersionUID = 1L;
       
    /**
     * @see HttpServlet#HttpServlet()
     */
    public StudentInq() {
        super();
        // TODO Auto-generated constructor stub
    }

	/**
	 * @see HttpServlet#doGet(HttpServletRequest request, HttpServletResponse response)
	 */
	protected void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
		// TODO Auto-generated method stub
		List<Students> list = StudentBusiness.getAllStudents();
		ListObject listObject=new ListObject();
		listObject.setItems(list);
		listObject.setStatusObject(StatusHouse.COMMON_STATUS_OK);
		String responseText = JackJsonUtils.toJson(listObject);
		ResponseUtils.renderJson(response, responseText);
	}

	/**
	 * @see HttpServlet#doPost(HttpServletRequest request, HttpServletResponse response)
	 */
	protected void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
		// TODO Auto-generated method stub
		doGet(request, response);
	}

} 

代码比较简单，就不多说了，相信看过java web开发(二) 接口开发的知道。但是，为了这篇文章，还是多说一句吧！这个类是继承自HttpServlet的，也就是说这个类其实是一个Servlet类，它内部提供了doGet()和doPost()方法，这两个方法其实就是我们经常所说的get请求和post请求，而get请求和post请求这两种请求方式，相信了解http请求的，都知道，get请求就是将请求参数直接放到请求路径后，post请求是将请求参数放置到请求的body中，当然他们还有其他一些区别，这里就不多说了！我们经常使用的是post请求。而demo中为了方便测试，就只实现了get请求。下面看看doGet()方法，

 

 

	protected void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
		// TODO Auto-generated method stub
		List<Students> list = StudentBusiness.getAllStudents(); // 从数据库获取学生数据列表
		ListObject listObject=new ListObject(); // 创建一个返回对象
		listObject.setItems(list);// 将数据列表设置给返回对象的items属性
		listObject.setStatusObject(StatusHouse.COMMON_STATUS_OK);// 设置返回对象的响应状态码
		String responseText = JackJsonUtils.toJson(listObject);//将返回对象转换为json字符串
		ResponseUtils.renderJson(response, responseText);//将结果返回会调用者
	}

每一行代码都加入了注释，不难理解！有一个地方需要强调一点，就是设置返回的响应状态码，好多小伙伴对这儿疑问比较大，这里再强调一下，这里设置的响应状态码是主要为了让调用者收到返回的json结果字符串后解析json时用的，简单来说，就是，

 

a). 如果响应状态码等于‘ok’时，调用者才去解析结果字符串；

b).如果是其他状态码，就直接显示结果字符串中的‘msg’。

这个是我自己定义的规则！大家自己在实际开发中，完全可以按照自己的方式去定义解析规则！

好了，有关对外提供的接口类，就说到这里。

2. cn.xinxing.business 这个包是和数据相关的。连接数据库以及从数据库中获取数据！其中DBHelper这个类是连接数据库的。这里我没有使用引入其他框架来维护数据库以及数据处理！下面看看这个类的具体实现，

package cn.xinxing.business;

import java.sql.Connection;
import java.sql.DriverManager;
import java.sql.PreparedStatement;
import java.sql.SQLException;


/**
 */
public class DBHelper {
	
	 public static final String url = "jdbc:mysql://localhost:3306/students_manage";  //数据库url
	    public static final String name = "com.mysql.jdbc.Driver";  //JDBC driver name
	    public static final String user = "root";  //数据库用户名
	    public static final String password = "111111";//  数据库密码
	  
	    public Connection conn = null;  //数据库连接对象
	    public PreparedStatement pst = null;  //对象
	  
	    /**
	     * @param sql
	     */
	    public DBHelper(String sql) {  
	        try {  
	            Class.forName(name);//注册JDBC driver
	            conn = DriverManager.getConnection(url, user, password);//打开一个数据库连接
	            pst = conn.prepareStatement(sql);//执行sql后，创建了preparedStatemen对象
	        } catch (Exception e) {  
	            e.printStackTrace();  
	        }  
	    }  
	  
	    /**
	     * 关闭数据库
	     */
	    public void close() {  
	        try {  
	            this.conn.close();  //关闭连接
	            this.pst.close();  //关闭对象
	        } catch (SQLException e) {  
	            e.printStackTrace();  
	        }  
	    }  

} 

通过JDBC连接至MySql数据库，然后获取到一个PreparedStatement对象，通过这个对象来发送sql命令，并且从数据库接收数据的属性和方法，换句话说，通过这个对象，我们就可以拿到数据库中的相关数据。

 

接着看StudentBusiness是如何获取数据的，还是上代码，

 

package cn.xinxing.business;

import java.sql.ResultSet;
import java.sql.SQLException;
import java.util.ArrayList;
import java.util.List;

import cn.xinxing.model.Students;

/**
 * 从数据库中获取数据
 */
public class StudentBusiness {

	/**
	 * 获取所有的学生数据
	 * @return
	 */
	public static List<Students> getAllStudents() {
		List<Students> list = new ArrayList<Students>();//list对象
		String sql = null;
		DBHelper db1 = null;
		sql = "select *from student";// SQL
		db1 = new DBHelper(sql);//创建DBHelper对象
		ResultSet ret = null;//创建结果集对象，执行sql后返回的数据集合
		try {
			ret = db1.pst.executeQuery();//这个方法就类似于执行了SELECT语句一样！
			while (ret.next()) {
				int id = ret.getInt(1);//第一列是id
				String name = ret.getString(2);//第二列是name
				int age = ret.getInt(3);//第三列是age
				int sex = ret.getInt(4);//第四列是sex
				Students students = new Students();//创建students对象
				students.setId(id);//设置id
				students.setName(name);//设置name
				students.setAge(age);//设置age
				students.setSex(sex);//设置sex
				list.add(students);//将students对象放置到列表中
			} //循环从结果集中获取数据并设置到list列表对象中
			ret.close();//关闭对象
			db1.close();//关系数据库连接
		} catch (SQLException e) {
			// TODO Auto-generated catch block
			e.printStackTrace();
		} //

		return list;//返回结果
	}

	/**
	 * 通过id来获取某个学生数据
	 * @param _id
	 * @return
	 */
	public static Students getStudentInfoById(String _id) {
		String sql = null;
		DBHelper db1 = null;
		sql = "select * from student where id =" + _id;// sql
		db1 = new DBHelper(sql);//创建DBHelper对象
		ResultSet ret = null;//创建结果集对象
		Students students = new Students();//创建对象
		try {
			ret = db1.pst.executeQuery();//正常来说，这个结果集只有一个对象
			while (ret.next()) {
				int id = ret.getInt(1);//第一列是id
				String name = ret.getString(2);//第二列是name
				int age = ret.getInt(3);//第三列是age
				int sex = ret.getInt(4);//第四列是sex
				int mobile = ret.getInt(5);//第五列是mobile
				students.setId(id);//设置id
				students.setName(name);//设置name
				students.setAge(age);//设置age
				students.setSex(sex);//设置sex
				students.setMobile(mobile);//设置mobile
			} //循环从结果集中获取数据并设置到对象中（正常来说，这个循环只执行一次）
			ret.close();//关闭对象
			db1.close();//关系数据库连接
		} catch (SQLException e) {
			// TODO Auto-generated catch block
			e.printStackTrace();
		} // 
		return students;//返回结果
	}
}

这个类提供了两个方法获取数据，一个方法是获取数据库中学生表中的所有数据，一个根据id参数获取某一个学生的数据。这里用到了PreparedStatement对象，如果对这个对象了解更多，请看JDBC教程！

最后补上，例子下载地址。

由于篇幅问题，下篇文章将继续来详解demo项目的代码！ 博文中如果有误，欢迎指出！ java web开发(五) 接口开发补坑2已经推出了！欢迎大家收看！

 

最近才开通了微信公众号，欢迎大家关注。