Web Services (REST and SOAP)

Web Service Design

Web Services:

- SOAP:
  - JEE 6 Tutorial – Web Services
  - Introduction to SOAP/WSDL Web Services
  - Intro to SOAP and WSDL

- REST:
  - Introduction to REST
  - RESTFul WS Tutorial
  - RESTful Web Service (Oracle)
  - Develop RESTful Web Service (Oracle MW)
  - REST on Oracle WebLogic
  - Design REST Services
  - JSON to Java (JSON-P, JSON-B, Jackson…):
    - Java API for JSON Binding (JSON-B)
    - Introduction to JSON Binding API (JSR 367) in Java
    - Yasson – Java Framework providing a standrd binding layer between Java classes and JSON documents, similar to JAXB for XML. Yasson is official RI for JSON Binding (JSR-367, comment)
    - JSR 367 JSON-B
      - While JSR 353 developed a standard Java API for parsing, generating, and transforming JSON data, JSR 367 was proposed to develop “a standard binding layer for converting Java objects to/from JSON messages”. It is said that “JSON-B will leverage JSON-P and provide a conversion layer above it”.
      - JSON-B in a Nutshell
    - Jackson vs. Gson – good options for serializing/deserializing JSON data to Java objects. Jackson support is built into all JAX-RS implementation (e.g. Jersey) and Spring framework.
    - The Ultimate JSON Library: JSON.simple vs GSON vs Jackson vs JSONP (Which JSON library for Java can parse JSON files the fastest? Updated: 13/8/17)
    - TopLink Support
    - Example: JAXB Convert Object to JSON
    - MOXy: Specify JSON Bindings
    - MOXy: JSON Metadata
    - JSON Binding with MOXy, Jackson, Jettison, JSON-P
    - Jersey and MOXy JSON Example
    - Change JSON Parser in WebLogic
    - Adding JSON support using Jackson on WebLogic 10.3.4

Tools:
- IETF
- JAXBContext
- xjc
- wsimport
- wadl2java
- DDL to XSD (PLSQL Function)
- Firefox RESTClient – addon for Firefox, Chrome, etc.
- WebLogic Download
- Convert JSON <–> XML Schema(XSD)
- Client Tools:
  - SOAP UI
    - SOAP UI Sample REST and SOAP Web Services
  - Postman
  - Insomnia
  - Paw (for Mac OS)

Specifications and Formalizations:
- Hypertext Transfer Protocol (HTTP/1.1): Semantics and Content
- HTTP Header Fields
- HTTP Status Codes
- Java EE:
  - Java EE 7 Spec and APIs
  - Java EE 8 Spec + Tutorial
- SOAP & WSDL:
  - SOAP 1.1 to SOAP 1.2
  - WS-* Extensions
  - What style of WSDL to use?
  - SOAP Binding: Difference between Document and RPC Style Web Services
  - Difference between RPC and Document Style(1)
  - Difference Between RPC and Document Style? (2)
  - RPC vs Document Style Web Service
  - RPC vs. “Web Service”
  - Understanding SOAP (RPC Programming Style vs. RPC Message format)
- SOAP AND JAX-WS, RPC VERSUS DOCUMENT WEB SERVICES
- SOAP Faults
- Introduction to WADL
- Do we need WADL?
- Introducing JSON
- Roy Fielding’s Dissertation: Architectural Styles and the Design of Network-based Software Architectures
- Richardson Maturity Model
- Media Types – Internet Assigned Numbers Authority (IANA)
- Link Headers – W3c
- REST: PUT vs POST

SOAP and REST:
- POJO or EJB SOAP Implementation?
- Metro and JAX-WS (Reference Implementation of Metro)
  - JSR 109: Implementing Enterprise Web Services
- JAX-RS and Jersey (Reference Implementation of JAX-RS)
  - JSR 339: JAX-RS 2.0: The Java API for RESTful Web Services
- Types supported by JAX-WS
- RESTFul Web Services – Introduction
- RESTFul Web Services – the Basics
- Understanding SOAP and REST Basics
- SOAP vs REST
- RESTFul Web Service Design – refutes “REST is the new SOAP”
- Why SOAP Sucks
- XML vs JSON
- XML Can Give Same Performance as JSON
- XML: Angle Bracket Tax (original) and Revisted
- JSON:
  - Intro to JSON
  - Jackson JSON Java Parser API Example Tutorial
  - Generating JSON from XSD with JAXB and Jackson
- REST Tutorial
- REST Interview Questions
- REST Tutorial #2 with examples
- REST Transactions
- REST API Design Guidelines
- 10 Best Practices for Better REST APIs

REST Parameters:

WebLogic Server Support:

Fusion Middleware (FMW):
- Security and Administrators Guide for Web Services
- Concepts Guide for Oracle Infrastructure Web Services

APIs: