REST Web Application with Cuubez

In this tutorial, we show you how to develop a simple REST web application with Cuubez.

Technologies and Tools used in this article:

1.Cuubez 1.0.0
2.JDK 1.6
3.Tomcat 6.0
4.Maven 3.0.3
5.Intellij IDEA 13.1.1

Note If you want to know what and how REST works, just search on Google, ton of available resources.

 

 

Screenshot1

 

 

2. Standard Web Project
Create a standard Maven web project structure.

 

mvn archetype:generate -DgroupId=com.cuubez -DartifactId=Employee-example
        -DarchetypeArtifactId=maven-archetype-webapp -DinteractiveMode=false

Note To support IDEA, use Maven command :

mvn idea:idea

3. Project Dependencies
The recommended way to get started using cuubez-framework in your project is with a dependency management system – the snippet below can be copied and pasted into your build(pom.xml). Need help? See our getting started guides on building with Maven.

 

File : pom.xml



<dependencies>
   <dependency>
     <groupId>com.cuubez</groupId>
     <artifactId>cuubez-core</artifactId>
     <version>1.0.0</version>
   </dependency>
</dependencies>

4. REST Service

Simple REST service with Cuubez

import javax.ws.rs.GET;
import javax.ws.rs.Path;
import javax.ws.rs.PathParam;
import com.cuubez.example.entity.Employee;

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

    @Path("/{empId}")
    @GET
    public Employee getEmployee(@PathParam("empId") final String empId) {

        Employee employee = new Employee(empId, "jhon powel", "marketing", "No 321, Colombo 4", "+94775993720");
        return employee;
    }
}

5. web.xml
The ContextLoaderListner context listener has to be deployed in order to create the registry for cuubez ,while the ServiceInitiator servlet is used so that incoming requests are correctly routed to the appropriate services. We have configured the specific servlet, named cuubez, to intercept requests under the /rest/ path.

 

File : web.xml

 

<web-app>
  <display-name>Employee Example</display-name>

    <listener>
        <listener-class>com.cuubez.core.servlet.BootstrapContextListener</listener-class>
    </listener>

    <servlet-mapping>
     <servlet-name>init</servlet-name>
     <url-pattern>/rest/*</url-pattern>
    </servlet-mapping>

    <servlet>
     <servlet-name>init</servlet-name>
     <servlet-class>com.cuubez.core.servlet.HttpServletDispatcher</servlet-class>
    </servlet>

</web-app>

6. Demo

In this example, web request from projectURL/rest/employees will match to EmployeeResource, via @Path(“/employees”). And the {empId}from projectURL/rest/employees/{empId} will match to parameter annotated with @PathParam.
URL :  http://localhost:8080/employee-example-1.0.0/rest/employees/eId-0001_

Screenshot2

 

 

Download above Employee example –Employee-example.zip

Advertisements
Tagged with: , , , , , , , ,
Posted in Uncategorized
4 comments on “REST Web Application with Cuubez
  1. david hen says:

    Nice tutorial .Wel explained

  2. Picture-in-picture technology allows users to multi-task.

    Chantecaille Les Dauphins Palete ($77, neimanmarcus.
    Assk yourself the hhard questions, and then match your needs
    to one of these user profiles.

  3. echer says:

    Hi . Very nice article but i need to run this web service embedded with jetty server. can you guide me?

Leave a Reply

Fill in your details below or click an icon to log in:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out / Change )

Twitter picture

You are commenting using your Twitter account. Log Out / Change )

Facebook photo

You are commenting using your Facebook account. Log Out / Change )

Google+ photo

You are commenting using your Google+ account. Log Out / Change )

Connecting to %s

%d bloggers like this: