dear developers,

Greetings of the day.

In this blog, I will share my journey of developing ReST Web Services using Jersey on JBoss EAP 6.4.


JBoss EAP 6.4 ships with RestEasy and active part of the application server. so if you need to deploy other ReST WS implementation like Jersey, RestLet,etc then you have to override the default implementation i.e RestEasy.

this is my project structure.

i am going to share all the contents of required fiiles.

1. pom.xml (Maven Configuration File)

<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">

    <modelVersion>4.0.0</modelVersion>

    <groupId>com.mycompany</groupId>

    <artifactId>jeserydemo</artifactId>

    <packaging>war</packaging>

    <version>1.0-SNAPSHOT</version>

    <name>jeserydemo</name>

    <build>

        <finalName>jeserydemo</finalName>

        <plugins>

            <plugin>

                <groupId>org.apache.maven.plugins</groupId>

                <artifactId>maven-compiler-plugin</artifactId>

                <version>2.5.1</version>

                <inherited>true</inherited>

                <configuration>

                    <source>1.7</source>

                    <target>1.7</target>

                </configuration>

            </plugin>

        </plugins>

    </build>

    <dependencyManagement>

        <dependencies>

            <dependency>

                <groupId>org.glassfish.jersey</groupId>

                <artifactId>jersey-bom</artifactId>

                <version>${jersey.version}</version>

                <type>pom</type>

                <scope>import</scope>

            </dependency>

        </dependencies>

    </dependencyManagement>

    <dependencies>

        <dependency>

            <groupId>org.glassfish.jersey.containers</groupId>

            <artifactId>jersey-container-servlet-core</artifactId>

            <!-- use the following artifactId if you don't need servlet 2.x compatibility -->

            <!-- artifactId>jersey-container-servlet</artifactId -->

        </dependency>

        

        <dependency>

            <groupId>org.glassfish.jersey.media</groupId>

            <artifactId>jersey-media-moxy</artifactId>

        </dependency>

      

    </dependencies>

    <properties>

        <jersey.version>2.18</jersey.version>

        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>

    </properties>

</project>

2. web.xml (Web Application Configuration File)

<?xml version="1.0" encoding="UTF-8"?>

<!-- This web.xml file is not required when using Servlet 3.0 container,

see implementation details http://jersey.java.net/nonav/documentation/latest/jax-rs.html -->

<web-app version="2.5" 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_2_5.xsd">

   

    <context-param>

        <param-name>resteasy.scan</param-name>

        <param-value>false</param-value>

    </context-param>

    <context-param>

        <param-name>resteasy.scan.providers</param-name>

        <param-value>false</param-value>

    </context-param>

    <context-param>

        <param-name>resteasy.scan.resources</param-name>

        <param-value>false</param-value>

    </context-param>

    <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>com.arvindamtech.jeserydemo</param-value>

        </init-param>

        <load-on-startup>1</load-on-startup>

    </servlet>

    <servlet-mapping>

        <servlet-name>Jersey Web Application</servlet-name>

        <url-pattern>/webapi/*</url-pattern>

    </servlet-mapping>

</web-app>

3. jboss-deployment-structure

<?xml version="1.0" encoding="UTF-8"?>

<jboss-deployment-structure>

<deployment>

<exclude-subsystems>

  <subsystem name="resteasy" />

</exclude-subsystems>

<exclusions>

  <module name="javaee.api" />

  <module name="javax.ws.rs.api"/>

  <module name="org.jboss.resteasy.resteasy-jaxrs" />

</exclusions>

<local-last value="true" />

</deployment>

</jboss-deployment-structure>

4. jboss-web.xml

<?xml version="1.0" encoding="UTF-8"?>

<jboss-web>

  <context-root>/jeserydemo</context-root>

</jboss-web>

Note:

1. only context param to set scan of rest easy false (web.xml) is not enough, you have to exclude it in jboss deployment structure file.

hope this will help you.

I will keep posting more article in this bolg to help you design a standard rest ws .

thanks

Ambrish Jha