jersey チュートリアル
ジャージーを始める

Android Angular 2 AngularJS HTML Java Language JavaScript jQuery MySQL spring spring-boot
サーチ…


備考

このセクションでは、ジャージーの概要と、開発者がジャージーを使用する理由について概説します。

また、ジャージー内の大きな科目についても言及し、関連するトピックにリンクする必要があります。ジャージーのドキュメンテーションは新しいので、それらの関連トピックの初期バージョンを作成する必要があります。

インストールまたはセットアップ

主な要件は、javaはあなたのsystem.thereにインストールする必要がありますEclipse IDEでジャージーを設定するための2つのオプションが最初に手動でこのリンクからジャージージャーをダウンロードしていることです。 [ https://jersey.java.net/download.html] [1 ]

2番目のオプションはjaven jarsの依存関係を追加する必要があります。自動的にダウンロードされます。 

<dependency>
    <groupId>org.glassfish.jersey.containers</groupId>
    <artifactId>jersey-container-servlet-core</artifactId>
    <version>2.6</version>
</dependency>

Hello Worldの例

これは、GETリクエストを呼び出す際にhello worldプレーンテキストメッセージを出力として取得する単純な例です。 

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 HelloExample {  
   @GET 
   @Produces(MediaType.APPLICATION_TEXT) 
   public String getUsers(){ 
      return "Hello World"; 
   }  
}

また、web.xmlファイルに以下を追加してapiを完全にセットアップすることもできます。 

   <display-name>User Message</display-name> 
   <servlet> 
      <servlet-name>Jersey REST Api</servlet-name> 
      <servlet-class>org.glassfish.jersey.servlet.ServletContainer</servletclass> 
      <init-param> 
         <param-name>jersey.config.server.provider.packages</param-name> 
         <param-value>your_package_name</param-value> 
      </init-param> 
   </servlet> 
   <servlet-mapping> 
      <servlet-name>Jersey REST Api</servlet-name> 
      <url-pattern>/rest/*</url-pattern> 
   </servlet-mapping>

その後、これをサーバーに展開してからブラウザに次のURLを開いて出力を取得する必要があります。 your_server_name / your_appl_name / rest / hello。

JerseyのCRUD操作例

この例では、RESTリソースに対してCRUD操作を実行する際のGET、POST、PUT、およびDELETE HTTPメソッドの使用方法を示します。

私は以下のソフトウェア、フレームワーク、ツールを使用しています：

  1. ジャージー2.25.1
  2. JDK 1.7.x（Java 7）
  3. Eclipse IDE Kepler
  4. Apache Maven 3.3.9
  5. Apache Tomcat 7.x

必要なジャージーアプリケーションを作成するには、以下の手順に従ってください

ステップ1：Eclipse IDEでmaven-archetype-webapp archetypeを使用して新規のmavenプロジェクトを作成するには、File-> New-> Maven Projectを選択します。

ステップ2：以下の依存関係をプロジェクトのpom.xmlファイルに追加します。 

<dependencies>
    <dependency>
        <groupId>org.glassfish.jersey.containers</groupId>
        <!-- if your container implements Servlet API older than 3.0, use "jersey-container-servlet-core" -->
        <artifactId>jersey-container-servlet-core</artifactId>
        <version>2.25.1</version>
    </dependency>
    <dependency>
        <groupId>org.glassfish.jersey.media</groupId>
        <artifactId>jersey-media-jaxb</artifactId>
        <version>2.25.1</version>
    </dependency>
    <dependency>
        <groupId>org.glassfish.jersey.media</groupId>
        <artifactId>jersey-media-json-jackson</artifactId>
        <version>2.25.1</version>
    </dependency>
    <dependency>
        <groupId>javax.servlet</groupId>
        <artifactId>servlet-api</artifactId>
        <version>2.5</version>
        <scope>provided</scope>
    </dependency>
    <dependency>
        <groupId>org.slf4j</groupId>
        <artifactId>slf4j-api</artifactId>
        <version>1.7.25</version>
    </dependency>
    <dependency>
        <groupId>org.slf4j</groupId>
        <artifactId>slf4j-simple</artifactId>
        <version>1.7.25</version>
    </dependency>
    <dependency>
        <groupId>junit</groupId>
        <artifactId>junit</artifactId>
        <version>3.8.1</version>
        <scope>test</scope>
    </dependency>
</dependencies>

ステップ3：アプリケーションリソースの設定

org.glassfish.jersey.server.ResourceConfigクラスを継承したクラスを作成し、そのコンストラクタにJAX-RSコンポーネントを登録します。ここでは、すべてのリソースをcom.stackoverflow.ws.restパッケージの下に登録しています。 

package com.stackoverflow.ws.rest;

import org.glassfish.jersey.server.ResourceConfig;

public class MyApplication extends ResourceConfig {

    public MyApplication() {
        packages("com.stackoverflow.ws.rest");
    }    
}

ステップ4：idやnameなどのプロパティを持つEmployeeのような単純なJava Beanを作成します。 equals（）メソッドとhashCode（）メソッドをオーバーライドします。また、クラスには引数なしのpublicコンストラクタが必要です。以下のコードを見つけてください：

従業員Java Beanクラス

package com.stackoverflow.ws.rest.model;

import javax.xml.bind.annotation.XmlElement;
import javax.xml.bind.annotation.XmlRootElement;

@XmlRootElement
public class Employee {

private int id;
private String name;
    
public Employee(){
    super();
}

public Employee(int id, String name) {
    super();
    this.id = id;
    this.name = name;
}

@XmlElement
public int getId() {
    return id;
}
public void setId(int id) {
    this.id = id;
}

@XmlElement
public String getName() {
    return name;
}
public void setName(String name) {
    this.name = name;
}

@Override
public int hashCode() {
    final int prime = 31;
    int result = 1;
    result = prime * result + id;
    result = prime * result + ((name == null) ? 0 : name.hashCode());
    return result;
}

@Override
public boolean equals(Object obj) {
    if (this == obj) {
        return true;
    }
    if (obj == null) {
        return false;
    }
    if (!(obj instanceof Employee)) {
        return false;
    }
    Employee other = (Employee) obj;
    if (id != other.id) {
        return false;
    }
    if (name == null) {
        if (other.name != null) {
            return false;
        }
    } else if (!name.equals(other.name)) {
        return false;
    }
    return true;
}
}

コードに関する追加情報

  1. @XmlRootElementと@XmlElementの注釈は、JAXBが要求メッセージと応答メッセージをマーシャリングおよびアンマーシャリングするために必要です。

ステップ5：以下のように従業員リソースを作成します。

EmployeeResourceサービスクラス

package com.stackoverflow.ws.rest;

import java.net.URI;
import java.util.ArrayList;
import java.util.Collections;
import java.util.HashMap;
import java.util.List;
import java.util.Map;

import javax.ws.rs.Consumes;
import javax.ws.rs.DELETE;
import javax.ws.rs.GET;
import javax.ws.rs.POST;
import javax.ws.rs.PUT;
import javax.ws.rs.Path;
import javax.ws.rs.PathParam;
import javax.ws.rs.Produces;
import javax.ws.rs.core.Context;
import javax.ws.rs.core.GenericEntity;
import javax.ws.rs.core.MediaType;
import javax.ws.rs.core.Response;
import javax.ws.rs.core.UriBuilder;
import javax.ws.rs.core.UriInfo;

import com.stackoverflow.ws.rest.model.Employee;

@Path("/employees")
public class EmployeeResource {

    private static Map<Integer, Employee> employeesRepository = new HashMap<Integer, Employee>();

// Read - get all the employees
@GET
@Produces({ MediaType.APPLICATION_XML, MediaType.APPLICATION_JSON })
public Response getEmployees() {
    List<Employee> employees = new ArrayList<Employee>(
            employeesRepository.values());
    GenericEntity<List<Employee>> entity = new GenericEntity<List<Employee>>(
            employees) {
    };
    return Response.ok(entity).build();
}

// Read - get an employee for the given ID
@GET
@Path("/{key}")
@Produces({ MediaType.APPLICATION_XML, MediaType.APPLICATION_JSON })
public Response getEmployee(@PathParam("key") int key) {

    if (employeesRepository.containsKey(key)) {

        return Response.ok(employeesRepository.get(key)).build();
    } else {

        return Response.status(404).build();
    }
}

// Create - create an employee
@POST
@Consumes({ MediaType.APPLICATION_XML, MediaType.APPLICATION_JSON })
public Response addEmployee(Employee employee, @Context UriInfo uriInfo) {

    if(employee.getId()!=0){
        
        return Response.status(400).build();
    }
    
    int createdEmployeeId = 1;
    
    if(!employeesRepository.isEmpty()){
        
        createdEmployeeId = Collections.max(employeesRepository.keySet()) + 1;
    }
    
    employee.setId(createdEmployeeId);
    employeesRepository.put(createdEmployeeId, employee);
    
    UriBuilder builder = uriInfo.getAbsolutePathBuilder();
    URI createdURI = builder.path(Integer.toString(createdEmployeeId)).build();
    return Response.created(createdURI).build();
}

// Update - updates an existing employee
@PUT
@Path("/{key}")
@Consumes({ MediaType.APPLICATION_XML, MediaType.APPLICATION_JSON })
public Response updateEmployee(@PathParam("key") int key, Employee employee) {

    int status = 0;

    if (employeesRepository.containsKey(key)) {
        // update employeeRepostory
        employeesRepository.put(key, employee);
        status = 204;
    } else {
        status = 404;
    }
    return Response.status(status).build();
}

// Delete - deletes an existing employee
@DELETE
@Path("/{key}")
public Response deleteEmployee(@PathParam("key") int key) {

    employeesRepository.remove(key);
    return Response.noContent().build();
}

// Delete - deletes all the employees
@DELETE
public Response deleteEmployees() {

    employeesRepository.clear();
    return Response.noContent().build();
}
}

注意： POSTメソッドとPUTメソッドの両方を使用してリソースを作成および/または更新できますが、ここではPOSTメソッドが既存のリソースを更新し、PUTメソッドが新しいリソースを作成しないように制限しています。しかし、これらの方法の使用についてさらに知りたい場合は、このリンクにアクセスしてください

ステップ6：最後に、Jerseyサーブレットの設定をデプロイメント記述子ファイル（web.xml）に追加します。 

<web-app>
  <display-name>Jersey 2.25.1 based REST Application</display-name>

   <servlet>
        <servlet-name>JerseyFrontController</servlet-name>
        <servlet-class>org.glassfish.jersey.servlet.ServletContainer</servlet-class>
        <init-param>
            <param-name>javax.ws.rs.Application</param-name>
            <param-value>com.stackoverflow.ws.rest.MyApplication</param-value>
        </init-param>
    </servlet>

    <servlet-mapping>
        <servlet-name>JerseyFrontController</servlet-name>
        <url-pattern>/ws/rest/*</url-pattern>
    </servlet-mapping>
</web-app>

ステップ7：プロジェクトの下のフォルダ構造を確認した後、プロジェクトをビルドしてビルドします。

ここに画像の説明を入力

ステップ8：Apache Tomcatでアプリケーションを実行します。

次に、適切なHTTPメソッドを使用してhttp：// {hostname}：{portnumber} / {projectName / applicationName} / ws / rest / employeesに移動し、忘れないように、クロムまたはSOAP UIのPOSTMAN拡張のようなRESTクライアントを使用してくださいHTTPリクエストの値としてapplication / jsonまたはapplication / xmlのいずれかを持つAcceptヘッダーを追加します。



Modified text is an extract of the original Stack Overflow Documentation
ライセンスを受けた CC BY-SA 3.0
所属していない Stack Overflow