Pourquoi est-ce Simple de JAX RS exemple ne fonctionne pas?

web.xml

<servlet>
    <servlet-name>RestServlet</servlet-name>
    <servlet-class>javax.ws.rs.core.Application</servlet-class>
</servlet>
<servlet-mapping>
    <servlet-name>RestServlet</servlet-name>
    <url-pattern>/api/*</url-pattern>
</servlet-mapping>

Rest.java

public class Rest {
    @GET
    @Path("hello")
    public String helloworld() {
        return "Hello World!";
    }
}

---

Si vous avez besoin, vous pouvez ajouter

YourApplication.java

package playground;
import javax.ws.rs.core.Application;
...
public class YourApplication extends Application {
    @Override
    public Set<Class<?>> getClasses()
    {
        Set<Class<?>> yourResources = new HashSet<Class<?>>();
        yourResources.add(InvoiceResource.class);
        return yourResources;
    }
}

Puis

web.xml

<servlet>
    <servlet-name>RestServlet</servlet-name>
    <servlet-class>playground.YourApplication</servlet-class>
</servlet>
<servlet-mapping>
    <servlet-name>RestServlet</servlet-name>
    <url-pattern>/api/*</url-pattern>
</servlet-mapping>

Si vous ajoutez @ApplicationPath("/api") pour YouApplication, puis web.xml ne devriez pas avoir servlet-mapping.

J'ai aussi eu des problèmes à obtenir que cela fonctionne, donc je poste une information plus complète sur comment faire pour la postérité:

Si vous êtes en utilisant une norme d'installation Tomcat (ou un autre conteneur de servlet), autant que je sache, vous ne pouvez pas éviter explicitement dire que les servlets pour démarrer dans la web.xml fichier*. Depuis que vous avez à utiliser web.xml de toute façon, la façon la plus simple pour obtenir des services web restful de travail, c'est oublier l'extension de javax.ws.rs.core.Application entièrement et il suffit de spécifier le chemin de contexte là. Vous pouvez toujours utiliser la norme de jax-rs annotations de déclarer les web services.

web.xml:

<?xml version="1.0" encoding="UTF-8"?>
<web-app
  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"
  version="3.0"
>
  <servlet>
    <servlet-name>rest-test</servlet-name>
    <servlet-class>com.sun.jersey.spi.container.servlet.ServletContainer</servlet-class>
    <init-param>
      <param-name>com.sun.jersey.config.property.packages</param-name>
      <param-value>com.domain.mypackage</param-value>
    </init-param>
    <load-on-startup>1</load-on-startup>
  </servlet>
  <servlet-mapping>
    <servlet-name> rest-test</servlet-name>
    <url-pattern>/rest/*</url-pattern>
  </servlet-mapping>
</web-app>

Deux remarquables points:

1. Vous aurez besoin pour regrouper un RESTE de mise en œuvre dans votre fichier WAR, depuis des conteneurs de servlet ne contiennent généralement une. Depuis Jersey est l'implémentation de référence de JAX-RS, c'est celui que j'utilise dans le servlet-class élément ci-dessus. Vous pouvez la remplacer avec Apache CXF mise en oeuvre si vous le souhaitez.

2. La init-param élément dit d'un Maillot de votre colis à la recherche pour Java fichiers avec service web annotations. Modifier ce point de vos services web. Notez que si vous optez pour l'utilisation d'apache CXF au lieu de Jersey, les trucs nécessaires dans tous les init-param éléments seront différents. Quelqu'un qui sait CXF merci de poster ce qu'ils voudraient être.

Si vous utilisez Maven, il suffit d'ajouter une dépendance à jersey-servlet dans le dependencies section de votre pom.xml fichier:

<dependencies>
  <dependency>
    <groupId>com.sun.jersey</groupId>
    <artifactId>jersey-servlet</artifactId>
    <version>1.18.2</version>
  </dependency>
  ...
</dependencies>

Après cela, la déclaration de services web est simple en utilisant le standard de JAX-RS annotations dans vos classes Java:

package com.domain.mypackage;
import javax.ws.rs.Consumes;
import javax.ws.rs.Produces;
import javax.ws.rs.GET;
import javax.ws.rs.MatrixParam;
import javax.ws.rs.Path;

//It's good practice to include a version number in the path so you can have
//multiple versions deployed at once. That way consumers don't need to upgrade
//right away if things are working for them.
@Path("calc/1.0")
public class CalculatorV1_0 {
  @GET
  @Consumes("text/plain")
  @Produces("text/plain")
  @Path("addTwoNumbers")
  public String add(@MatrixParam("firstNumber") int n1, @MatrixParam("secondNumber") int n2) {
    return String.valueOf(n1 + n2);
  }
}

Ce devrait être tout ce dont vous avez besoin. Si votre installation Tomcat tourne en local sur le port 8080 et le déploiement de votre fichier WAR pour le contexte myContext, va

http://localhost:8080/myContext/rest/calc/1.0/addTwoNumbers;firstNumber=2;secondNumber=3

...devrait produire les résultats escomptés (5).

Cheers!

* Quelqu'un s'il vous plaît corrigez-moi si vous connaissez un moyen pour ajouter les Maillot de servlet pour le contexte dans Tomcat sans l'aide de web.xml--peut-être l'aide d'un contexte ou le cycle de vie de l'auditeur?