Go to primary content
Oracle® Retail Integration Bus Service-Oriented Architecture Enabler Tool Guide
Release 14.1
E57808-02
Next
Contents
Title and Copyright Information
Send Us Your Comments
Preface
Audience
Documentation Accessibility
Related Documents
Customer Support
Review Patch Documentation
Improved Process for Oracle Retail Documentation Corrections
Oracle Retail Documentation on the Oracle Technology Network
Conventions
1
Introduction
Major Features of the RSE Tool
Concepts
What is a Service?
Oracle Fusion Reference Architecture (OFRA)
Where Does RSE Fit?
Technical Specifications
Supported Operating Systems
2
Installation and Basic Setup
Installation as a Web Application in Oracle WebLogic
Prerequisites
Deploy the Retail Service-Oriented Architecture Enabler
Verify the Retail Service-Oriented Architecture Enabler
Redeploy the Application
3
Tool Inputs and Outputs
Tool Inputs
ServiceProviderDefLibrary.xml
RestServiceProviderDefLibrary.xml
XSDs and retail-public-payload-java-beans.jar
PL/SQL Oracle Objects
WSDL
Tool Outputs
PL/SQL Provider Web Service
PL/SQL Consumer Web Service
Java EE Provider Web Service
Java EE Consumer Web Service
4
User Interface Usage
Service Provider
Service Definition Library XML File
Service Definition Library XML File for Restful web services
Custom Business Objects Jar File
Localization Business Object Jar File
Service Implementation Jar File
Service Consumer
Help
5
Service Definition Library XML File
Schema Definition
serviceProviderDefLibrary
Attributes
Elements
Managing the Service Definition Library XML File
Creating the File
Changing the Version of the File
Changing the appName Attribute in the File
Renaming a Service or Operation Name in the File
Adding a New Service or New Operation to the File
Deleting a Service or Deleting Operations from the File
Defining New Exceptions to the Operations
Using Different Versions of Objects as Input/Output to an Operation
6
Service Definition Library XML File for Restful services
Schema Definition
ServiceProviderDefLibrary
Validation rules for a service definition xml for RESTful web services
Rules for Application Name Field
Rules for Service Name Field
Rules for Service Operations
Rules for Path Parameters
Rules for Query Parameters
Rules for Links
Rules for RelatedTo element
JSON output
Response Codes
7
Web Service Standards and Conventions
Web Service Naming
Web Service Versioning
8
Creating the Java EE Implementation Jar
Step 1: Generate Web Services with Default Implementation
Step 2: Implement Interfaces
Step 3: Upload the jar
9
Implementation Guidelines
Important Note About this Chapter
PL/SQL Service Consumer Implementation Notes
PL/SQL Provider Service Implementation Notes
Java EE Service Consumer Implementation Notes
Sample Client Code
Java EE Service Provider Implementation Notes
Use Case 1: Complete the Generator Provided Stub Code Implementation
Use Case 2: Provide a Custom impl jar to the RSE Tool
Use Case 3: Package the Generated Service Classes in an Existing Application
Web Service Call as a Remote EJB Call
Prerequisites
Procedure
Code Description
Web Service Call as a POJO Call
Procedure
Sample Code for POJO Invocation
Deploying the Web Service
Redeploy the Service Application
Verify the Service Application Installation Using the Administration Console
Creating a JDBC Data Source
10
Implementation Guidelines For Restful web services
Important Note About this Chapter
PL/SQL Provider Service Implementation Notes
Java EE Service Provider Implementation Notes
Use Case 1: Complete the Generator Provided Stub Code Implementation
Use Case 2: Provide a Custom impl jar to the RSE Tool
Use Case 3: Package the Generated Service Classes in an Existing Application
Deploying the Web Service
Creating a JDBC Data Source in WebLogic
11
Web Services Security Setup Guidelines
Client-Side Setup
Java Client Setup
PL/SQL Client Setup
A
Appendix: Installer Screens
Installation as a Web Application in Oracle WebLogic
Deploy the Retail SOA Enabler Application
Creating the rseAdminGroup
Verify the Retail SOA Enabler Web Application
Redeploy the Application
B
Appendix: Sample ServiceProviderDefLibrary.xml
ServiceProviderDefLibrary.xml
RestServiceProviderDefLibrary.xml
C
Appendix: Creating a JDBC Data Source
Procedure