blocks|key|2904683|text|看起来我需要做的就是这样(Servlet3.0及更高版本)|type|unstyled|depth|inlineStyleRanges|entityRanges|data|2904684|import+javax.ws.rs.ApplicationPath;
import+javax.ws.rs.core.Application;

@ApplicationPath("/*")
public+class+MyApplication+extends+Application+{
++++...
}|code-block|syntax|javascript|2904685|而且显然不需要任何web.xml配置(在Tomcat7上试用)|2904686|entityMap^0|0|0|0^^$0|@$1|2|3|4|5|6|7|K|8|@]|9|@]|A|$]]|$1|B|3|C|5|D|7|L|8|@]|9|@]|A|$E|F]]|$1|G|3|H|5|6|7|M|8|@]|9|@]|A|$]]|$1|I|3|-4|5|6|7|N|8|@]|9|@]|A|$]]]|J|$]]

It seems that all I needed to do is this (Servlet 3.0 and above)

<pre><code>import javax.ws.rs.ApplicationPath;
import javax.ws.rs.core.Application;

@ApplicationPath("/*")
public class MyApplication extends Application {
 ...
}
</code></pre>

And no web.xml configuration was apparently needed (tried on Tomcat 7)

blocks|key|240788|text|JAX-RS:+Java™+API+for+RESTful+Web+Services规范的第2章描述了Servlet环境中JAX-RS应用程序的发布过程(规范中的2.3.2Servlet一节)。|type|unstyled|depth|inlineStyleRanges|offset|length|style|BOLD|entityRanges|data|240789|请注意，仅建议使用Servlet+3环境(第6页的2.3.2节Servlet+)：|240790|240791|建议实现支持Servlet3框架可插拔机制，以实现容器之间的可移植性，并利用容器提供的类扫描功能。|blockquote|240792|240793|240794|简而言之，如果您想使用no-web.xml方法，可以使用一个自定义的javax.ws.rs.core.Application实现，该实现使用javax.ws.rs.ApplicationPath注释注册RESTful服务资源。|240795|@ApplicationPath("/rest")|code-block|syntax|javascript|240796|虽然您特别询问了Jersey，但您可能也喜欢阅读文章Implementing+RESTful+services+with+JAX-RS+and+WebSphere+8.5+Liberty+Profile，其中我描述了WebSphere+Liberty+Profile的no-web.xml发布过程(使用Apache+Wink作为JAX-RS的实现)。|240797|entityMap|0|LINK|mutability|MUTABLE|url|http://jcp.org/en/jsr/detail?id=311|1|http://docs.oracle.com/javaee/6/api/javax/ws/rs/core/Application.html|2|http://docs.oracle.com/javaee/6/api/javax/ws/rs/ApplicationPath.html|3|http://jaceklaskowski.pl/wiki/Implementing_RESTful_services_with_JAX-RS_and_WebSphere_8.5_Liberty_Profile|4|http://wasdev.net/^0|29|C|0|16|0|0|0|0|0|0|0|Y|S|1|1Y|R|2|0|0|Q|23|3|30|P|4|0^^$0|@$1|2|3|4|5|6|7|1C|8|@$9|1D|A|1E|B|C]]|D|@$9|1F|A|1G|1|1H]]|E|$]]|$1|F|3|G|5|6|7|1I|8|@]|D|@]|E|$]]|$1|H|3|-4|5|6|7|1J|8|@]|D|@]|E|$]]|$1|I|3|J|5|K|7|1K|8|@]|D|@]|E|$]]|$1|L|3|-4|5|6|7|1L|8|@]|D|@]|E|$]]|$1|M|3|-4|5|6|7|1M|8|@]|D|@]|E|$]]|$1|N|3|O|5|6|7|1N|8|@]|D|@$9|1O|A|1P|1|1Q]|$9|1R|A|1S|1|1T]]|E|$]]|$1|P|3|Q|5|R|7|1U|8|@]|D|@]|E|$S|T]]|$1|U|3|V|5|6|7|1V|8|@]|D|@$9|1W|A|1X|1|1Y]|$9|1Z|A|20|1|21]]|E|$]]|$1|W|3|-4|5|6|7|22|8|@]|D|@]|E|$]]]|X|$Y|$5|Z|10|11|E|$12|13]]|14|$5|Z|10|11|E|$12|15]]|16|$5|Z|10|11|E|$12|17]]|18|$5|Z|10|11|E|$12|19]]|1A|$5|Z|10|11|E|$12|1B]]]]

Chapter 2 of the <a href="http://jcp.org/en/jsr/detail?id=311">JAX-RS: Java™ API for RESTful Web Services</a> specification describes the publication process of a JAX-RS application in Servlet environment (section 2.3.2 Servlet in the specification).

Please note that Servlet 3 environment is recommended only (section 2.3.2 Servlet, page 6):

<blockquote>
 It is RECOMMENDED that implementations support the Servlet 3
 framework pluggability mechanism to enable portability between
 containers and to avail themselves of container-supplied class
 scanning facilities.
</blockquote>

In short, if you want to use a no-web.xml approach, it's possible with a custom implementation of <a href="http://docs.oracle.com/javaee/6/api/javax/ws/rs/core/Application.html">javax.ws.rs.core.Application</a> that registers RESTful service resources with the <a href="http://docs.oracle.com/javaee/6/api/javax/ws/rs/ApplicationPath.html">javax.ws.rs.ApplicationPath</a> annotation.

<pre><code>@ApplicationPath("/rest")
</code></pre>

Although you asked specifically about Jersey you may also like to read the article <a href="http://jaceklaskowski.pl/wiki/Implementing_RESTful_services_with_JAX-RS_and_WebSphere_8.5_Liberty_Profile">Implementing RESTful services with JAX-RS and WebSphere 8.5 Liberty Profile</a> in which I described the no-web.xml publication process for <a href="http://wasdev.net">WebSphere Liberty Profile</a> (with Apache Wink as the implementation of JAX-RS).

blocks|key|3119117|text|如果您使用TOMCAT或JETTY，请阅读**！**|type|unstyled|depth|inlineStyleRanges|offset|length|style|BOLD|entityRanges|data|3119118|公认的答案是确实可以使用，但前提是必须将webapp部署到Glassfish或Wildfly等应用服务器，以及TomEE等可能带有EE扩展的servlet容器上。It+不能在像Tomcat这样的标准servlet容器上工作，我相信大多数在这里寻找解决方案的人都想使用它。|3119119|如果您使用的是标准Tomcat安装(或其他servlet容器)，则需要包含REST实现，因为Tomcat没有提供REST实现。如果您使用的是Maven，请将以下内容添加到dependencies部分：|CODE|3119120|<dependencies>
++<dependency>
++++<groupId>org.glassfish.jersey.bundles</groupId>
++++<artifactId>jaxrs-ri</artifactId>
++++<version>2.13</version>
++</dependency>
++...
</dependencies>|code-block|syntax|javascript|3119121|然后只需将应用程序配置类添加到您的项目中。如果除了为rest服务设置上下文路径之外，您没有任何特殊的配置需求，那么这个类可以是空的。一旦添加了这个类，您就不需要在web.xml中配置任何东西(或者根本不需要一个)：|3119122|package+com.domain.mypackage;
import+javax.ws.rs.ApplicationPath;
import+javax.ws.rs.core.Application;

@ApplicationPath("rest")+//+set+the+path+to+REST+web+services
public+class+ApplicationConfig+extends+Application+{}|3119123|在此之后，使用Java类中的标准JAX-RS注释声明web服务非常简单：|3119124|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+%2B+n2);
++}
}|3119125|这应该就是您需要的全部内容。如果您的Tomcat安装是在本地端口8080上运行的，并且您将WAR文件部署到上下文myContext，请转到...|3119126|http://localhost:8080/myContext/rest/calc/1.0/addTwoNumbers;firstNumber=2;secondNumber=3|3119127|...should产生预期的结果(5)。|3119128|entityMap^0|L|5|0|6|6|2C|1F|0|0|2S|2D|C|0|0|0|2Z|29|7|0|0|0|10|0|0|0|20|1K|9|0|0|0|K|0^^$0|@$1|2|3|4|5|6|7|15|8|@$9|16|A|17|B|C]]|D|@]|E|$]]|$1|F|3|G|5|6|7|18|8|@$9|19|A|1A|B|C]|$9|1B|A|1C|B|C]]|D|@]|E|$]]|$1|H|3|I|5|6|7|1D|8|@$9|1E|A|1F|B|C]|$9|1G|A|1H|B|J]]|D|@]|E|$]]|$1|K|3|L|5|M|7|1I|8|@]|D|@]|E|$N|O]]|$1|P|3|Q|5|6|7|1J|8|@$9|1K|A|1L|B|C]|$9|1M|A|1N|B|J]]|D|@]|E|$]]|$1|R|3|S|5|M|7|1O|8|@]|D|@]|E|$N|O]]|$1|T|3|U|5|6|7|1P|8|@$9|1Q|A|1R|B|C]]|D|@]|E|$]]|$1|V|3|W|5|M|7|1S|8|@]|D|@]|E|$N|O]]|$1|X|3|Y|5|6|7|1T|8|@$9|1U|A|1V|B|C]|$9|1W|A|1X|B|J]]|D|@]|E|$]]|$1|Z|3|10|5|M|7|1Y|8|@]|D|@]|E|$N|O]]|$1|11|3|12|5|6|7|1Z|8|@$9|20|A|21|B|C]]|D|@]|E|$]]|$1|13|3|-4|5|6|7|22|8|@]|D|@]|E|$]]]|14|$]]

** PLEASE READ IF YOU USE TOMCAT OR JETTY! **

The accepted answer does work, but only if the webapp is deployed to an app server like Glassfish or Wildfly, and possibly servlet containers with EE extensions like TomEE. It doesn't work on standard servlet containers like Tomcat, which I'm sure most people looking for a solution here want to use.

If you're using a standard Tomcat install (or some other servlet container), you need to include a REST implementation since Tomcat doesn't come with one. If you're using Maven, add this to the <code>dependencies</code> section:

<pre class="lang-xml prettyprint-override"><code>&lt;dependencies&gt;
 &lt;dependency&gt;
 &lt;groupId&gt;org.glassfish.jersey.bundles&lt;/groupId&gt;
 &lt;artifactId&gt;jaxrs-ri&lt;/artifactId&gt;
 &lt;version&gt;2.13&lt;/version&gt;
 &lt;/dependency&gt;
 ...
&lt;/dependencies&gt;
</code></pre>

Then just add an application config class to your project. If you don't have any special configuration needs aside from setting the context path for the rest services, the class can be empty. Once this class is added, you don't need to configure anything in <code>web.xml</code> (or have one at all):

<pre><code>package com.domain.mypackage;
import javax.ws.rs.ApplicationPath;
import javax.ws.rs.core.Application;

@ApplicationPath("rest") // set the path to REST web services
public class ApplicationConfig extends Application {}
</code></pre>

After this, declaring your web services is straight forward using the standard JAX-RS annotations in your Java classes:

<pre><code>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);
 }
}
</code></pre>

This should be all you need. If your Tomcat install is running locally on port 8080 and you deploy your WAR file to the context <code>myContext</code>, going to...

<pre class="lang-none prettyprint-override"><code>http://localhost:8080/myContext/rest/calc/1.0/addTwoNumbers;firstNumber=2;secondNumber=3
</code></pre>

...should produce the expected result (5).

blocks|key|2904800|text|您需要在pom.xml中设置正确的依赖项|type|unstyled|depth|inlineStyleRanges|entityRanges|data|2904801|<dependency>
++++++++<groupId>javax.servlet</groupId>
++++++++<artifactId>javax.servlet-api</artifactId>
++++++++<version>3.0.1</version>
++++++++<scope>provided</scope>
++++</dependency>
++++<dependency>
++++++++<groupId>org.glassfish.jersey.containers</groupId>
++++++++<artifactId>jersey-container-servlet</artifactId>
++++</dependency>|code-block|syntax|javascript|2904802|更多详细信息请访问：Starter+example+for+jax-rs|offset|length|2904803|entityMap|0|LINK|mutability|MUTABLE|url|https://vvirlan.wordpress.com/2014/07/21/starter-jax-rs-jersey-servlet-3-0-maven-tomcat/^0|0|0|A|Q|0|0^^$0|@$1|2|3|4|5|6|7|S|8|@]|9|@]|A|$]]|$1|B|3|C|5|D|7|T|8|@]|9|@]|A|$E|F]]|$1|G|3|H|5|6|7|U|8|@]|9|@$I|V|J|W|1|X]]|A|$]]|$1|K|3|-4|5|6|7|Y|8|@]|9|@]|A|$]]]|L|$M|$5|N|O|P|A|$Q|R]]]]

You need to setup the right dependencies in pom.xml

<pre><code>&lt;dependency&gt;
 &lt;groupId&gt;javax.servlet&lt;/groupId&gt;
 &lt;artifactId&gt;javax.servlet-api&lt;/artifactId&gt;
 &lt;version&gt;3.0.1&lt;/version&gt;
 &lt;scope&gt;provided&lt;/scope&gt;
 &lt;/dependency&gt;
 &lt;dependency&gt;
 &lt;groupId&gt;org.glassfish.jersey.containers&lt;/groupId&gt;
 &lt;artifactId&gt;jersey-container-servlet&lt;/artifactId&gt;
 &lt;/dependency&gt;
</code></pre>

More details here:
<a href="https://vvirlan.wordpress.com/2014/07/21/starter-jax-rs-jersey-servlet-3-0-maven-tomcat/" rel="noreferrer">Starter example for jax-rs</a>

blocks|key|240821|text|正如@Eran-Medan指出的那样，EJBEAP7.1(注意，没有Web应用程序所以没有servlet，我是在EJB3.2项目中做的)我必须添加“JBoss”属性，因为我得到了一个需要value属性的异常。|type|unstyled|depth|inlineStyleRanges|entityRanges|data|240822|这对我很有效|240823|++++@ApplicationPath(value="/*")
++++++++public+class+MyApplication+extends+Application+{

++++++++++++private+Set+singletons+=+new+HashSet();

++++++++++++public+MyApplication()+{
++++++++++++++++singletons.add(new+MyService());
++++++++++++}

++++++++++++...
++++}|code-block|syntax|javascript|240824|堆栈跟踪|offset|length|style|BOLD|240825|++++Caused+by:+java.lang.annotation.IncompleteAnnotationException:+javax.ws.rs.ApplicationPath+missing+element+value
++++++++at+sun.reflect.annotation.AnnotationInvocationHandler.invoke(AnnotationInvocationHandler.java:80)
++++++++at+com.sun.proxy.$Proxy141.value(Unknown+Source)
++++++++...+21+more|240826|entityMap^0|0|0|0|0|4|0|0^^$0|@$1|2|3|4|5|6|7|S|8|@]|9|@]|A|$]]|$1|B|3|C|5|6|7|T|8|@]|9|@]|A|$]]|$1|D|3|E|5|F|7|U|8|@]|9|@]|A|$G|H]]|$1|I|3|J|5|6|7|V|8|@$K|W|L|X|M|N]]|9|@]|A|$]]|$1|O|3|P|5|F|7|Y|8|@]|9|@]|A|$G|H]]|$1|Q|3|-4|5|6|7|Z|8|@]|9|@]|A|$]]]|R|$]]

As @Eran-Medan pointed out, JBoss EAP 7.1 (note without a Web Application so no servlet, I was doing it in a EJB 3.2 project) I had to add the "value" attribute as such as I was getting an exception that the value attribute was required.

This worked for me

<pre><code> @ApplicationPath(value="/*")
 public class MyApplication extends Application {

 private Set singletons = new HashSet();

 public MyApplication() {
 singletons.add(new MyService());
 }

 ...
 }</code></pre>

Stack Trace 

<pre><code> Caused by: java.lang.annotation.IncompleteAnnotationException: javax.ws.rs.ApplicationPath missing element value
 at sun.reflect.annotation.AnnotationInvocationHandler.invoke(AnnotationInvocationHandler.java:80)
 at com.sun.proxy.$Proxy141.value(Unknown Source)
 ... 21 more</code></pre>

blocks|key|3119211|text|前面提到的依赖关系对我不起作用。来自Jersey用户指南：|type|unstyled|depth|inlineStyleRanges|entityRanges|data|3119212|3119213|+Jersey提供了两个Servlet模块。第一个模块是Jersey核心Servlet模块，它提供核心Servlet集成支持，并且在任何Servlet+2.5或更高版本的容器中都是必需的：|blockquote|3119214|3119215|3119216|<dependency>
+<groupId>org.glassfish.jersey.containers</groupId>
+<artifactId>jersey-container-servlet-core</artifactId>
</dependency>|code-block|syntax|javascript|3119217|3119218|为了支持额外的Servlet3.x部署模式和异步JAX-RS资源编程模型，需要额外的Jersey模块：|3119219|3119220|3119221|<dependency>
+<groupId>org.glassfish.jersey.containers</groupId>
+<artifactId>jersey-container-servlet</artifactId>
</dependency>|3119222|3119223|+jersey-container-servlet模块依赖于jersey-container-servlet-core模块，因此在使用它时，没有必要显式声明jersey-container-servlet-core依赖关系。|3119224|3119225|3119226|https://jersey.github.io/documentation/latest/deployment.html#deployment.servlet.3|offset|length|3119227|entityMap|0|LINK|mutability|MUTABLE|url^0|0|0|0|0|0|0|0|0|0|0|0|0|0|0|0|0|2A|0|0^^$0|@$1|2|3|4|5|6|7|19|8|@]|9|@]|A|$]]|$1|B|3|-4|5|6|7|1A|8|@]|9|@]|A|$]]|$1|C|3|D|5|E|7|1B|8|@]|9|@]|A|$]]|$1|F|3|-4|5|6|7|1C|8|@]|9|@]|A|$]]|$1|G|3|-4|5|6|7|1D|8|@]|9|@]|A|$]]|$1|H|3|I|5|J|7|1E|8|@]|9|@]|A|$K|L]]|$1|M|3|-4|5|6|7|1F|8|@]|9|@]|A|$]]|$1|N|3|O|5|E|7|1G|8|@]|9|@]|A|$]]|$1|P|3|-4|5|6|7|1H|8|@]|9|@]|A|$]]|$1|Q|3|-4|5|6|7|1I|8|@]|9|@]|A|$]]|$1|R|3|S|5|J|7|1J|8|@]|9|@]|A|$K|L]]|$1|T|3|-4|5|6|7|1K|8|@]|9|@]|A|$]]|$1|U|3|V|5|E|7|1L|8|@]|9|@]|A|$]]|$1|W|3|-4|5|6|7|1M|8|@]|9|@]|A|$]]|$1|X|3|-4|5|6|7|1N|8|@]|9|@]|A|$]]|$1|Y|3|Z|5|6|7|1O|8|@]|9|@$10|1P|11|1Q|1|1R]]|A|$]]|$1|12|3|-4|5|6|7|1S|8|@]|9|@]|A|$]]]|13|$14|$5|15|16|17|A|$18|Z]]]]

The previously mentioned dependencies did not work for me. From the Jersey User guide:

<blockquote>
 Jersey provides two Servlet modules. The first module is the Jersey core Servlet module that provides the core Servlet integration support and is required in any Servlet 2.5 or higher container:
</blockquote>

<pre><code>&lt;dependency&gt;
 &lt;groupId&gt;org.glassfish.jersey.containers&lt;/groupId&gt;
 &lt;artifactId&gt;jersey-container-servlet-core&lt;/artifactId&gt;
&lt;/dependency&gt;
</code></pre>

<blockquote>
 To support additional Servlet 3.x deployment modes and asynchronous JAX-RS resource programming model, an additional Jersey module is required:
</blockquote>

<pre><code>&lt;dependency&gt;
 &lt;groupId&gt;org.glassfish.jersey.containers&lt;/groupId&gt;
 &lt;artifactId&gt;jersey-container-servlet&lt;/artifactId&gt;
&lt;/dependency&gt;
</code></pre>

<blockquote>
 The jersey-container-servlet module depends on jersey-container-servlet-core module, therefore when it is used, it is not necessary to explicitly declare the jersey-container-servlet-core dependency.
</blockquote>

<a href="https://jersey.github.io/documentation/latest/deployment.html#deployment.servlet.3" rel="nofollow noreferrer">https://jersey.github.io/documentation/latest/deployment.html#deployment.servlet.3</a>

Is it possible to set up a JAX-RS application using annotations only? (using Servlet 3.0 and JAX-RS Jersey 1.1.0)

I tried and had no luck. Using some <code>web.xml</code> seems required.

<hr>

Configuration A (working, but has web.xml configuration)

web.xml

<pre class="lang-xml prettyprint-override"><code> ...
 &lt;servlet&gt;
 &lt;servlet-name&gt;org.foo.rest.MyApplication&lt;/servlet-name&gt;
 &lt;/servlet&gt;
 &lt;servlet-mapping&gt;
 &lt;servlet-name&gt;org.foo.rest.MyApplication&lt;/servlet-name&gt;
 &lt;url-pattern&gt;/*&lt;/url-pattern&gt;
 &lt;/servlet-mapping&gt;
 ...
</code></pre>

Java

<pre><code>@ApplicationPath("/")
public class MyApplication extends Application {
 ...
}
</code></pre>

<hr>

Configuration B (not working, exception thrown)

<pre><code>@ApplicationPath("/")
@WebServlet("/*") // &lt;-- 
public class MyApplication extends Application {
 ...
}
</code></pre>

The latter seems to insist that the Application will be a subclass of Servlet (the exception leaves no guesswork)

<pre><code>java.lang.ClassCastException: org.foo.rest.MyApplication cannot be cast to javax.servlet.Servlet
</code></pre>

<hr>

Questions

<ol>
<li>Why the web.xml definition worked but the annotation didn't? What's the difference?</li>
<li>Is there a way to have it worked, e.g. have a JAX-RS Application with no web.xml?</li>
</ol>

How to set up JAX-RS Application using annotations only (no web.xml)?

服务器

容器

Java

是否可以仅使用注释来设置JAX-RS应用程序？(使用Servlet 3.0和JAX-RS Jersey 1.1.0)我试过了，但一无所获。使用一些web.xml似乎是必需的。配置A(工作，但具有web.xml配置)web.xml ... <servlet> <servlet-name>org.foo....

问如何只使用注释(不使用web.xml)设置JAX-RS应用程序？
EN

社区

活动

资源

关于

腾讯云开发者

热门产品

热门推荐

更多推荐

问如何只使用注释(不使用web.xml)设置JAX-RS应用程序？EN

社区

活动

资源

关于

腾讯云开发者

热门产品

热门推荐

更多推荐

问如何只使用注释(不使用web.xml)设置JAX-RS应用程序？
EN