2014年8月17日 星期日

使用Eclipse Luna + Tomcat 7 + Jersey 2架設RESTful service

前言

此篇文章介紹如何使用Jersey架設RESTful web service,使用到的工具如下
  1. Eclipse Luna
  2. Tomcat 7
  3. Jersey 2.11

為避免對Maven或Gradle不熟悉的人感到疑惑,因此此篇文章只針對如何使用Jersey 2架設RESTful service,不使用Maven或Gradle進行管理

架設步驟

1. 開啟Eclipse

2. 建立新的專案File -> New -> Dynamic Web Project


3. 輸入專案名稱JerseySample並選擇Apache Tomcat v7.0作為Target runtime,記得要把Generate web.xml deployment descriptor打勾




4. 將jersey官網下載的jaxrs-ri-2.11.zip解壓縮,接著把所有的jar檔複製到jerseySample/WebContent/WEB-INF/lib下


5. 重新整理JerseySample專案確保lib都有正常載入



6. 修改web.xml讓Tomcat可以正確載入Jersey相關資源
<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://java.sun.com/xml/ns/javaee" xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_3_0.xsd" id="WebApp_ID" version="3.0">
  <display-name>JerseySample</display-name>
  <welcome-file-list>
    <welcome-file>index.html</welcome-file>
    <welcome-file>index.htm</welcome-file>
    <welcome-file>index.jsp</welcome-file>
    <welcome-file>default.html</welcome-file>
    <welcome-file>default.htm</welcome-file>
    <welcome-file>default.jsp</welcome-file>
  </welcome-file-list>
  
  <servlet>
    <servlet-name>Jersey Web Application</servlet-name>
    <servlet-class>org.glassfish.jersey.servlet.ServletContainer</servlet-class>
    <init-param>
      <param-name>jersey.config.server.provider.packages</param-name>
      <param-value>org.sample.test</param-value>
    </init-param>
    <load-on-startup>1</load-on-startup>
  </servlet>
  <servlet-mapping>
    <servlet-name>Jersey Web Application</servlet-name>
    <url-pattern>/api/*</url-pattern>
  </servlet-mapping> 
  
</web-app>

  參數說明
    i. servlet-class
      Jersey 1的servlet-class為
        com.sun.jersey.spi.container.servlet.ServletContainer

      而Jersey 2的servlet-class必須改成(畢竟Sun已經R.I.P.了QAQ........)
        org.glassfish.jersey.servlet.ServletContainer

    ii. jersey.config.server.provider.packages
      Jersey掃描的packet路徑,resource的java檔要放在此package下

    iii. url-pattern
      Resource對應的URL位置,client端必須要照此參數設定才能呼叫到對應的resource

7. 建立package: org.sample.test



8. 建立resource的java檔案: Hello.java



9. 加入以下的程式碼至Hello.java
package test;
import javax.ws.rs.GET;
import javax.ws.rs.Path;
import javax.ws.rs.Produces;
import javax.ws.rs.core.MediaType;

@Path("/hello")
public class Hello {
    // This method is called if TEXT_PLAIN is request
    @GET
    @Produces(MediaType.TEXT_PLAIN)
    public String sayPlainTextHello() {
        return "Hello Jersey";
    }

    // This method is called if XML is request
    @GET
    @Produces(MediaType.TEXT_XML)
    public String sayXMLHello() {
        return "" + " Hello Jersey" + "";
    }

    // This method is called if HTML is request
    @GET
    @Produces(MediaType.TEXT_HTML)
    public String sayHtmlHello() {
        return "<html> " + "<title>" + "Hello Jersey" + "</title>"
              + "<body><h1>" 
              + "Hello Jersey"
              + "</h1></body></html></pre>" 
              + " ";
 }
}

10. 將專案在Tomcat上跑起來,並使用瀏覽器檢查http://localhost:8080/JerseySample/api/hello是否正確




11. 使用RESTful client工具檢查xml的request是否能正常使用。只要送出的request包含Accept: text/xml檔頭,Jersey就會自動切換到回傳sayXMLHello函式結果


參考資料
1. REST with Java (JAX-RS) using Jersey - Tutorial (適用Jersey 1)
2. Jersey 2.5 + Maven = easy REST web services

[手工藝玩具] 1入2出 音源切換器

完成以下兩篇的玩具後,筆者的音樂播放器就從PC換成Pi
  Raspberry Pi 樹莓派 啟動I2S DAC or USB DAB 音效卡
  Raspberry Pi 樹莓派 架設ShairPort使用AirPlay播放音樂

但由於最近有不少狀況需要開PC,又PC要輸出聲音的話需要把喇叭從Pi換到PC的耳機座上,
根據以前悲劇的經驗,這樣不是喇叭的耳機頭先壞掉就是PC的耳機座先被插壞.........
因此筆者決定弄一個音源切換器,參考DIY音源切換器[DIY]兩種音源切換器(二入一出)後筆者自製了一個音源切換器

原料如下
  1. 6pin 2段式開關x1
  2. 3.5mm 耳機座x3 (二入一出)
  3. 塑膠盒子,大小為60x40x30mm
  4. 比6pin 2段式開關的pin粗一點點就熱縮套

以上原料大概只有80元可以搞定,接著就是開始對把線焊上2段式開關 -> 塑膠盒鑽4個孔 -> 鎖上耳機座元件 -> 鎖上2段式開關 -> 將耳機座和2段式開關焊上,接著就完成了(詳細內容請直接參考最底下的參考資料)

最後成品如下圖~


補上小小心得
  整天過著寫程式的生活難免會有枯燥乏味的時候,偶而來DIY些小東西來玩也挺有趣的,尤其是對筆者這種拿焊槍次數10根手指頭就能算完的新手,以玩家的角度來做這東西其實挺有趣的

  在焊接的部份以往都有強者學長支援,但這次在沒人支援的情況下在60x40x30mm的盒子裡焊接東西讓筆者苦戰整個下午才搞定,做完其實挺有成就感的

  而實際上這東西在網路上買的到,價格大概3xx到4xx(2014年8月份),不過根據筆者DIY整個東西的時間,其實3xx元已經非常划算了,如果不是以玩家的心情做的話建議還是花錢直接買現成的吧


參考資料
  1. DIY音源切換器
  2. [DIY]兩種音源切換器(二入一出)