如何部署JAX-RS应用程序？

Question

JAX-RS 1.1规范在第6页上说：

如果不存在Application子类，则必须将添加的servlet命名为：

javax.ws.rs.core.Application

添加的servlet是什么？可以是任意servlet吗？

如果存在Application子类，并且已经定义了一个servlet，该servlet的servlet初始化参数为：

javax.ws.rs.Application

同样，这里的“ servlet”是什么？

如果存在不由现有Servlet处理的Application子类，则必须使用Application子类的完全限定名称来命名ContainerInitializer添加的Servlet。

“ ContainerInitializer添加的servlet”是否意味着该servlet是自动添加的？配置如何？

目前，我既不使用Application类也不使用web.xml，并且它可以工作（在GlassFish
3.1中）。这种部署机制是否需要完整的类路径扫描，而大型库可能会比较慢？

如何部署在Servlet容器上？

网络中存在许多令人困惑的配置选项。请参阅带有web.xml中上下文参数的示例（对我不起作用！）。部署JAX-RS应用程序的首选方法是什么？

Answer 1

有许多选项可用于部署到Java EE 6容器（更具体地讲是Servlet 3.0实现）：

最简单的是：

<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns="http://java.sun.com/xml/ns/j2ee" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee http://java.sun.com/xml/ns/j2ee/web-app_3_0.xsd" version="3.0">
    <servlet>
        <servlet-name>javax.ws.rs.core.Application</servlet-name>
        <load-on-startup>1</load-on-startup>
    </servlet>
    <servlet-mapping>
        <servlet-name>javax.ws.rs.core.Application</servlet-name>
        <url-pattern>/rest/*</url-pattern>
    </servlet-mapping>
</web-app>

然后，在Web应用程序中找到的所有@Path和@Provider类都将在servlet URL模式为的“默认” JAX-
RS应用程序中可用"/rest/*"。

如果您有一个或多个扩展类，则javax.ws.rs.core.Application可以这样指定：

<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns="http://java.sun.com/xml/ns/j2ee" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee http://java.sun.com/xml/ns/j2ee/web-app_3_0.xsd" version="3.0">
    <servlet>
        <servlet-name>com.example.jaxrs.MyApplication</servlet-name>
        <load-on-startup>1</load-on-startup>
    </servlet>
    <servlet-mapping>
        <servlet-name>com.example.jaxrs.MyApplication</servlet-name>
        <url-pattern>/rest/*</url-pattern>
    </servlet-mapping>
</web-app>

如果您只希望在URL上返回特定的@Path/
@Provider类集，则可能需要执行上述操作（因此，您可以在上面的第二个MyApplication2中使用不同的URL模式）。

您也可以web.xml完全跳过整个过程，仅注释您的MyApplication类wih
@ApplicationPath（将用作URL模式）。我建议web.xml在任何情况下都保留，因为无论如何您可能都必须在其中添加有关Web应用程序的其他信息。

如果您想知道它的servlet-class来源，环境会自动添加它。您可以通过查看Servlet 3.0来了解一下ServletContext。