Java WebRestApp后台(一):第一个java web项目（从创建到返回第一个json字符串）

本文链接：https://blog.csdn.net/sinat_32955803/article/details/54577128

具体请看这个servlet教程:http://www.runoob.com/servlet/servlet-tutorial.html

声明：本系列文章只以介绍servlet为主（因为是做app后台），不介绍css,js/html等web开发的常用技术的使用

1.创建项目（IDE:myeclipse）

首先File-->New一个Web Project项目。
结构目录如下：

web.xml文件：每一个站的WEB-INF下都有一个web.xml的设定文件，它提供了我们站台的配置设定.主要是配置web项目启动时加载的信息。
具体标签请看：http://blog.csdn.net/cocojiji5/article/details/1601428
这里简单介绍一点当前能用到的web.xml中的配置信息，代码如下：

<?xml version="1.0" encoding="UTF-8"?>
<web-app version="3.0" xmlns="http://java.sun.com/xml/ns/javaee"
	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
	xsi:schemaLocation="http://java.sun.com/xml/ns/javaee 
	http://java.sun.com/xml/ns/javaee/web-app_3_0.xsd"><!-- 这一行是个schema -->
	<description>站点描述</description>
	<display-name>站点名称</display-name>
	<!-- 指定欢迎页，可指定多个，第一个找不到时用第二个做欢迎页，一次类推 -->
	<welcome-file-list>
		<welcome-file>index.jsp</welcome-file>
	</welcome-file-list>
	
	<!-- 1-定义servlet的名称和类,我们的servlet写好了以后都要在这儿配置，就像Activity在Mainfest.xml中一样 -->
	<servlet>
		<servlet-name>HelloWorld</servlet-name>
		<!-- 指定servlet类 -->
		<servlet-class>com.test.servlet.HelloWorld</servlet-class>
	</servlet>

	<!-- 用来定义1处定义的servlet所对应的请求url，当你在浏览器上输入这个url时会调用到上面的servlet类，例如http://127.0.0.1/HelloWorld -->
	<servlet-mapping>
		<servlet-name>HelloWorld</servlet-name>
		<!-- 指定servlet所对应的url -->
		<url-pattern>/HelloWorld</url-pattern>
	</servlet-mapping>

</web-app>

index.jsp:我们的jsp页面;下面贴出一段代码

<body>
	<!-- 指定请求方法（POST）和要响应的servlet -->
	<form action="HelloFrom" method="POST">
		网址名：<input type="text" name="name"> <br /> 网址：<input
			type="text" name="url" /> <input type="submit" value="提交" />
	</form>

</body>

WEB-INF/lib下放我们的.jar包，当然，其实WEB-INF/下还有一个classes文件夹，用于存放我们项目的java文件编译好的.class，在myeclipse是看不到的，需要
到文件夹下去查看。
src：放我们的java文件，servlet就是放在里面的。

2.创建servlet并运行项目

在（1）中我们创建了web project项目，并分析了各个目录的作用。在src下，右键-->new-->在列表中选择servlet，

如上图所示，输入Servlet的类名和包名，点击下一步，在下一步中有一个
自动生成servlet的配置
取消掉，也可以不取消，不取消就需要自己在web.xml中配置：假设配置一个HelloWorld的servlet：代码如下,当然，这只是简单的配置了一下，你也可以指定其他参数
```
	
	<servlet>
		<servlet-name>HelloWorld</servlet-name>
		
		<servlet-class>com.test.servlet.HelloWorld</servlet-class>
	</servlet>

	
	<servlet-mapping>
		<servlet-name>HelloWorld</servlet-name>
		
		<url-pattern>/HelloWorld</url-pattern>
	</servlet-mapping>
```
这样就创建了一个servlet，这里面有一些代码，你可以右击项目运行。MyEclipse Server Application,，
假设我们要运行HelloWorld这个servlet然后在地址栏输入http://127.0.0.1:8080/Test/HelloWorld，这个地址对应于我们在web.xml <servlet-mapping>
为我们的Servlet所映射的url，输出的其实是一段html（注：我们的.jsp文件也是先转成servlet然后在运行在浏览器上的）。

3.一个http请求到服务器响应的过程。

通过1和2我们创建并运行了一个Java Web和Servlet组合的Java Web 项目。然而必须知其然还有知其所以然。
具体大家看这篇文章最上头的教程，这里简单的记录一下。
Java Servlet 是运行在 Web 服务器或应用服务器上的程序，它是作为来自 Web 浏览器或其他 HTTP 客户端的请求和 HTTP 服务器上的数据库或应用程序之间的中间层。
使用 Servlet，您可以收集来自网页表单的用户输入，呈现来自数据库或者其他源的记录，还可以动态创建网页（如out.print一段html的代码）。
以我们新创建的项目为例：即客户端请求通过url（如浏览器）-->web 服务器-->我们的servlet程序，-->在get或post获取请求数据（方法中request这个参数）-->根据请求数据查询数据库或执行其他操作-->使用response响应客户端的请求（就是向客户端传数据）-->客户端获取（客户端的request）-->对数据解析（如解码等）-->呈现给我们的客户。
当然，这中间还要很多细节要处理。

4.当servlet请求到我们的web服务器时服务器所做的方法调用。

通过3我们知道一个url请求从生到死的过程，那我们servlet的生命周期是什么呢，请求的调用过程是什么呢。
当一个servlet请求到我们的服务器时，会首先创建这个servlet（注：servlet是一个单例，运行期间只会创建一次），然后
看教程：http://www.runoob.com/servlet/servlet-life-cycle.html

5.什么时候调用doGet,什么时候调用doPost呢？

什么样的请求调用我们的doGet的方法呢，什么样的请求又调用doPost...呢，
看这篇文章：http://www.cnblogs.com/cyy-13/p/5711235.html 另外贴一段h5代码以帮助理解

<body>
	<!-- 指定请求方法（get或post请求）和要响应的action(这里是一个servlet) -->
	<form action="HelloWorld" method="POST">
		网址名：<input type="text" name="name"> <br /> 网址：<input
			type="text" name="url" /> <input type="submit" value="提交" />
	</form>
</body>

6.编码格式的问题（中文乱码）。

现在你在我们新建的项目里的输出中添加中文，在重新运行项目，会发现我们的输出中有？？？或其他乱码，这就是中文乱码问题
看这篇文章就明白啦：http://www.cnblogs.com/sunnyleer/archive/2012/04/13/2446508.html

7.向客户端返回一个json的字符串

我们制定这样一个get请求http://192.168.0.104:8080/Test/HelloWorld?name=小明是不是很像一个接口，当然这还没有实现rest模式呢，所以只是像而已

servlet HelloWorld.java的代码如下：

package com.test.servlet;

import java.io.IOException;
import java.io.PrintWriter;
import java.util.ArrayList;
import java.util.HashMap;
import java.util.Map;

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

import com.google.gson.Gson;

public class HelloWorld extends HttpServlet {

	/**
	 * Constructor of the object.
	 */
	public HelloWorld() {
		super();
	}

	/**
	 * Destruction of the servlet. <br>
	 */
	public void destroy() {
		super.destroy(); // Just puts "destroy" string in log
		// Put your code here
	}

	/**
	 * The doGet method of the servlet. <br>
	 * 
	 * This method is called when a form has its tag value method equals to get.
	 * 
	 * @param request
	 *            the request send by the client to the server
	 * @param response
	 *            the response send by the server to the client
	 * @throws ServletException
	 *             if an error occurred
	 * @throws IOException
	 *             if an error occurred
	 */
	public void doGet(HttpServletRequest request, HttpServletResponse response)
			throws ServletException, IOException {
		// 你的第一个接口请求返回json字符串
		if (request.getParameter("name") != null) {
			System.out.println("My name is doGet()"); 
			// 处理中文 获取浏览器的请求数据 String
			String name = new String(request.getParameter("name")
					.getBytes("ISO8859-1"), "UTF-8"); 
			// 指定服务器相应的编码格式为utf-8:支持中文
			response.setContentType("text/html;charset=utf-8");
			PrintWriter out = response.getWriter();
			Gson gson = new Gson();//记得导入gson.jar
			ArrayList<Map<String, String>> list = new ArrayList<Map<String, String>>();

			for (int i = 0; i < 10; i++) {//模拟数据库数据
				Map<String, String> map = new HashMap<String, String>();
				map.put("oneKey", "one");
				map.put("twoKey", "tow");
				map.put("thirdKey", "third");
				map.put("chineseTest", "小明");
				map.put("name", name);
				list.add(map);
			}
			String json = gson.toJson(list);
			//输出json字符串给客户端
			out.print(json);
			out.flush();
			out.close();
		}
	}

	/**
	 * The doPost method of the servlet. <br>
	 * 
	 * This method is called when a form has its tag value method equals to
	 * post.
	 * 
	 * @param request
	 *            the request send by the client to the server
	 * @param response
	 *            the response send by the server to the client
	 * @throws ServletException
	 *             if an error occurred
	 * @throws IOException
	 *             if an error occurred
	 */
	public void doPost(HttpServletRequest request, HttpServletResponse response)
			throws ServletException, IOException {
		System.out.println("My name is doPost");
		// 方法请求的方法,一般情况下web程序员都是用这种处理方式get安全性非常低，post安全性较高。但是执行效率却比Post方法好
		doGet(request, response);
	}

	/**
	 * Initialization of the servlet. <br>
	 * 
	 * @throws ServletException
	 *             if an error occurs
	 */
	public void init() throws ServletException {
		// Put your code here
	}

}

这样就返回给我们一个json字符串到浏览器

返回的字符串：[{"chineseTest":"小明","twoKey":"tow","name":"小明","oneKey":"one","thirdKey":"third"},{"chineseTest":"小明","twoKey":"tow","name":"小明","oneKey":"one","thirdKey":"third"},{"chineseTest":"小明","twoKey":"tow","name":"小明","oneKey":"one","thirdKey":"third"},{"chineseTest":"小明","twoKey":"tow","name":"小明","oneKey":"one","thirdKey":"third"},{"chineseTest":"小明","twoKey":"tow","name":"小明","oneKey":"one","thirdKey":"third"},{"chineseTest":"小明","twoKey":"tow","name":"小明","oneKey":"one","thirdKey":"third"},{"chineseTest":"小明","twoKey":"tow","name":"小明","oneKey":"one","thirdKey":"third"},{"chineseTest":"小明","twoKey":"tow","name":"小明","oneKey":"one","thirdKey":"third"},{"chineseTest":"小明","twoKey":"tow","name":"小明","oneKey":"one","thirdKey":"third"},{"chineseTest":"小明","twoKey":"tow","name":"小明","oneKey":"one","thirdKey":"third"}]

另外：我们的一个请求中不只只有如http://www.baidu.com这样的信息，还有请求头、响应体的信息，具体细节大家看教程吧。