RESTEasy實(shí)例

changfeng1050 發(fā)布于2019-08-14 16:31 / 854人閱讀

摘要：是的開源項(xiàng)目之一，是一個框架。趁今天有空，學(xué)習(xí)一下。看了兩篇博客后，自己寫了一個。如果不配置，也可以手動指定，見注釋掉的部分。

RESTEasy是JBoss的開源項(xiàng)目之一，是一個RESTful Web Services框架。

趁今天有空，學(xué)習(xí)一下RESTEasy。看了兩篇博客后，自己寫了一個demo。

1. 新建一個maven的web項(xiàng)目。

依賴如下：


4.0.0
com.fengyuan
RESTEasyDemo
war
0.0.1-SNAPSHOT
RESTEasyDemo Maven Webapp
http://maven.apache.org


    
        junit
        junit
        4.4
        test
    
    
        org.projectlombok
        lombok
        1.14.4
    
    
        org.jboss.resteasy
        resteasy-jaxrs
        2.2.3.GA
    
    
        org.jboss.resteasy
        resteasy-jackson-provider
        2.2.3.GA
    



    
        
            org.apache.maven.plugins
            maven-compiler-plugin
            
                1.7
                1.7
                UTF-8

2. 接著創(chuàng)建兩個服務(wù)，messageservice和userservice：

UserService.java:

package com.fengyuan.restapi;

import java.util.ArrayList;
import java.util.HashMap;
import java.util.List;
import java.util.Map;
import java.util.Map.Entry;

import javax.ws.rs.GET;
import javax.ws.rs.Path;
import javax.ws.rs.PathParam;
import javax.ws.rs.Produces;

import com.fengyuan.domain.User;

@Path("userservice") // 服務(wù)路徑
public class UserService {
    /**
     * 初始化三個用戶數(shù)據(jù)，存入map中，key為用戶id，value為用戶對象
     */
    static Map userMap = new HashMap<>();
    static {
        User user1 = new User("Lee", 24, "138***");
        userMap.put(1, user1);
        User user2 = new User("Cathy", 25, "188***");
        userMap.put(2, user2);
        User user3 = new User("Aaron", 26, "186***");
        userMap.put(3, user3);
    }

    /**
     * 獲取指定id的用戶
     * 
     * @param id
     * @return
     */
    @GET
    @Path("user/{id}") // 具體服務(wù)的路徑, id是入?yún)?    @Produces("application/json") // 返回的格式
    public User getById(@PathParam("id") Integer id) {
        return (User) userMap.get(id);
    }

    /**
     * 以json格式返回所有用戶
     * 
     * @return
     */
    @GET
    @Path("users")
    @Produces("application/json")
    public List getUsers() {
        List userList = new ArrayList();
        for (Entry user : userMap.entrySet()) {
            userList.add(user.getValue());
        }
        return userList;
    }
}

MessageService.java:

package com.fengyuan.restapi;
import javax.ws.rs.GET;
import javax.ws.rs.Path;  
import javax.ws.rs.PathParam;  
import javax.ws.rs.core.Response;  
   
@Path("/messageservice")  
public class MessageService {  
   public MessageService(){} 
    @GET 
    @Path("/{param}")  
    public Response printMessage(@PathParam("param") String msg) {  
        String result = "Hello : " + msg;  
   
        return Response.status(200).entity(result).build();  
    }  
}

User.java:

package com.fengyuan.domain;

import lombok.AllArgsConstructor;
import lombok.Data;

public @Data @AllArgsConstructor class User {
    private String name;
    private int age;
    private String tel;
}

3. 配置web.xml:



  Restful Web Application
  
    resteasy.scan
    true
  
  
  
    resteasy.servlet.mapping.prefix
    /rest
  
  
    org.jboss.resteasy.plugins.server.servlet.ResteasyBootstrap
  
  
    resteasy-servlet
    org.jboss.resteasy.plugins.server.servlet.HttpServletDispatcher
  
  
    resteasy-servlet
    /rest/*

配置resteasy.scan為true表示自動掃描服務(wù)。如果不配置，也可以手動指定resteasy.resources，見注釋掉的部分。

4. 啟動tomcat，在瀏覽器輸入服務(wù)的url：

5. 除了可以在瀏覽器直接訪問之外，也可以用代碼調(diào)用：

package com.fengyuan.test;
import java.io.IOException;
import java.io.InputStream;
import java.net.HttpURLConnection;
import java.net.URL;

import junit.framework.TestCase;  
  
public class TestUserAPI extends TestCase {  
    public static final String USER_API =   
        "http://127.0.0.1:8080/resteasy-demo/rest/userservice/users";  
  
    public void testCreateUserAndGetUser() throws IOException {  
        URL url =   
            new URL(USER_API);  
        HttpURLConnection connection =   
            (HttpURLConnection) url.openConnection();  
        connection.setRequestMethod("GET");  
        connection.setRequestProperty("Content-Type", "application/x-www-form-urlencoded");  
        connection.setConnectTimeout(1000);  
  
        byte[] bytes = new byte[1024];
        //讀取請求返回值
        InputStream inStream=connection.getInputStream();
        inStream.read(bytes, 0, inStream.available());
        System.out.println(new String(bytes, "utf-8"));
        
        connection.disconnect();  
    }  
}

控制臺輸出：

[{"name":"Lee","tel":"138***","age":24},{"name":"Cathy","tel":"188***","age":25},{"name":"Aaron","tel":"186***","age":26}]

當(dāng)然，這里只是簡單了測試了GET類型的服務(wù)，還有POST等類型的服務(wù)等有空了再補(bǔ)充。

另外，我在寫這個demo項(xiàng)目的時候，發(fā)現(xiàn)如果使用了2.1.多版本的resteasy-jackson-provider和resteasy-jaxrs包，并且在web.xml中配置了resteasy.scan為true的話，會出一些問題，這邊提醒一下，讓看這篇博文的同學(xué)不用再踩進(jìn)這個坑~。