搭建json格式的webservice服务器

搭建json格式的webservice服务器

本文为平时开发项目步骤记录，以备以后需要

一、所用技术
语言：java
框架：spring mvc 3.1
二、所用技术
IDE：MyEclipse
web容器： Apache tomcat 6.0
三、所有详细步骤
1. 前期准备工作，比如安装MyEclipse，安装tomcat这些网上有非常多的教程就不再赘述了。
2. 打开MyEclipse，创建动态网站项目。

输入项目名，选择在MyEclipse中配置好的tomcat6.0，如何在MyEclipse中配置tomcat网上也有很多教程。点击完成创建。

3. 在WEB-INF的lib文件夹下，导入所需jar包，所需jar包的百度盘地址 http://pan.baidu.com/s/1dDOU9TR
4. 在web.xml插件中添加一下代码，用于加载spring mvc和字符解析：

---

<servlet>
        <servlet-name>ModelServerservlet-name>
        <servlet-class>org.springframework.web.servlet.DispatcherServletservlet-class>
        <load-on-startup>1load-on-startup>
    servlet>
    <servlet-mapping>
        <servlet-name>ModelServerservlet-name>
        <url-pattern>/url-pattern>
    servlet-mapping>

    <filter>
        <filter-name>CharacterEncodingFilterfilter-name>
        <filter-class>org.springframework.web.filter.CharacterEncodingFilterfilter-class>
        <init-param>
            <param-name>encodingparam-name>
            <param-value>utf-8param-value>
        init-param>
    filter>
    <filter-mapping>
        <filter-name>CharacterEncodingFilterfilter-name>
        <url-pattern>/*url-pattern>
    filter-mapping>

在web.xml文件的同级目录创建SimpleService-servlet.xml文件，在这里配置spring mvc的相关配置。一下给出的模板是用于自动request body转化为java class 和 上传文件的相关配置，其他只需再添加用户所需的依赖注入即可。

---

<beans xmlns="http://www.springframework.org/schema/beans"
    xmlns:aop="http://www.springframework.org/schema/aop" xmlns:context="http://www.springframework.org/schema/context"
    xmlns:mvc="http://www.springframework.org/schema/mvc" xmlns:tx="http://www.springframework.org/schema/tx"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://www.springframework.org/schema/aop 
        http://www.springframework.org/schema/aop/spring-aop-3.0.xsd 
        http://www.springframework.org/schema/beans 
        http://www.springframework.org/schema/beans/spring-beans-3.0.xsd 
        http://www.springframework.org/schema/context 
        http://www.springframework.org/schema/context/spring-context-3.0.xsd 
        http://www.springframework.org/schema/mvc 
        http://www.springframework.org/schema/mvc/spring-mvc-3.0.xsd 
        http://www.springframework.org/schema/tx 
        http://www.springframework.org/schema/tx/spring-tx-3.0.xsd">

    <mvc:annotation-driven /> 
     <bean class="org.springframework.web.servlet.mvc.annotation.AnnotationMethodHandlerAdapter">
        <property name="messageConverters">
            <list>
                <bean class="org.springframework.http.converter.StringHttpMessageConverter">
                    <property name="supportedMediaTypes">
                        <list>
                            <value>
                                text/html;charset=UTF-8
                            value>
                        list>
                    property>
                bean>
                
                <bean id="jacksonMessageConverter" class="org.springframework.http.converter.json.MappingJacksonHttpMessageConverter">
                    
                    <property name="supportedMediaTypes">
                        <list>
                            <value>application/json;charset=UTF-8value>
                        list>
                    property>
                bean>
            list>
        property>
    bean>
    
    <bean id="multipartResolver"
        class="org.springframework.web.multipart.commons.CommonsMultipartResolver">
        <property name="defaultEncoding" value="UTF-8" />
        
        <property name="maxUploadSize" value="20480000" />
        
        
        <property name="maxInMemorySize" value="256" />  

    bean>
    beans>

至此整个框架已经搭建完毕，只需根据需求完成自己的代码即可。比如，想写一个接口，功能是别人发送GET请求，返回“hello world!”。

在src文件夹下创建Class（com.peter.Hello.java）

---

---

package com.peter;

import java.io.IOException;
import javax.servlet.http.HttpServletResponse;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestMethod;

@Controller
@RequestMapping(value = "/hello")   //此处value是rest api的前缀
public class Hello {
    @RequestMapping(value = "/sayHello",method = RequestMethod.GET)//此处value是rest api的具体定位，method是接受的请求的类型
    public void sayHello(HttpServletResponse response){
        try {
            response.getWriter().write("{\"result\":\"hello world!\"}");
        } catch (IOException e) {
            e.printStackTrace();
        }

    }
}

然后将项目部署到已经搭建好的tomcat中，然后启动tomcat，然后使用rest请求发送即可看到返回{result:hello world!}

至此整个简单项目已经搭建完毕，具体rest请求还有很多相关的东西，网上也有很多学习资料就不再赘述了。随手记录，如有问题，请博内留言以帮助我改正和完善，一起努力，一起学习，一起进步！

---

Mr peter king 2016 04 29