Contents

Title and Copyright Information

Preface

• Documentation Accessibility
• Conventions

1 Introduction to RESTful Web Services

• Introduction to the REST Architectural Style
• What Are RESTful Web Services?
• Standards Supported for RESTful Web Service Development on WebLogic Server
• Roadmap for Implementing RESTful Web Services
• Upgrading RESTful Web Services from Oracle WebLogic Server 10.3.x to 12.1.x
• Learn More About RESTful Web Services

2 Developing RESTful Web Services

• About RESTful Web Service Development
  • Summary of Tasks to Develop RESTful Web Services
  • Example of a RESTful Web Service
• Defining the Root Resource Class
• Defining the Relative URI of the Root Resource and Subresources
  • How to Define the Relative URI of the Resource Class (@Path)
  • How to Define the Relative URI of Subresources (@Path)
  • What Happens at Runtime: How the Base URI is Constructed
• Mapping Incoming HTTP Requests to Java Methods
  • About the Jersey Bookmark Sample
  • How to Transmit a Representation of the Resource (@GET)
  • How to Create or Update the Representation of the Resource (@PUT)
  • How to Delete a Representation of the Resource (@DELETE)
  • How to Create, Update, or Perform an Action On a Representation of the Resource (@POST)
• Customizing Message Types for the Request and Response
  • How To Customize Request Message Types (@Consumes)
  • How To Customize Response Message Types (@Produces)
  • What Happens At Runtime: How the Resource Method Is Selected for Response Messages
• Extracting Information From the Request
  • How to Extract Variable Information from the Request URI (@PathParam)
  • How to Extract Request Parameters (@QueryParam)
  • How to Define the DefaultValue (@DefaultValue)
• Building Custom Response Messages
• Accessing the Application Context
• Building URIs
• Using Conditional GETs
• Accessing the WADL
• More Advanced RESTful Web Service Tasks

3 Packaging and Deploying RESTful Web Services

• About RESTful Web Service Packaging and Deployment
• Packaging With an Application Subclass
• Packaging With a Servlet
  • How to Package the RESTful Web Service Application with Servlet 3.0
    • Packaging the RESTful Web Service Application Using web.xml With Application Subclass
    • Packaging the RESTful Web Service Application Using web.xml Without Application Subclass
  • How to Package the RESTful Web Service Application with Pre-3.0 Servlets
• Packaging as a Default Resource

4 Developing RESTful Web Service Clients

• About RESTful Web Service Client Development
  • Summary of Tasks to Develop RESTful Web Service Clients
  • Example of a RESTful Web Service Client
• Creating and Configuring a Client Instance
• Creating a Web Resource Instance
• Sending Requests to the Resource
  • How to Build Requests
  • How to Send HTTP Requests
  • How to Pass Query Parameters
  • How to Configure the Accept Header
  • How to Add a Custom Header
  • How to Configure the Request Entity
• Receiving a Response from a Resource
  • How to Access the Status of Request
  • How to Get the Response Entity
• More Advanced RESTful Web Service Client Tasks

5 Securing RESTful Web Services

• About RESTful Web Service Security
• Securing RESTful Web Services Using web.xml
• Securing RESTful Web Services Using SecurityContext
• Securing RESTful Web Services Using Annotations

6 Monitoring RESTful Web Services

• About Monitoring RESTful Web Services
• Monitoring RESTful Web Services Using WLST
• Enabling the Tracing Feature
  • How to Enable Server-wide Tracing
  • How to Enable Per-request Tracing

A Updating the Version of Jersey JAX-RS RI

• About Updating the Version of Jersey JAX-RS RI
• Updating the Version of Jersey JAX-RS RI at the Application Level
  • How to Update the Version of Jersey JAX-RS RI in an EAR File
  • How to Update the Version of Jersey JAX-RS RI in a WAR File