Go to primary content
Oracle® Retail Integration Bus Cloud Service Service-Oriented Architecture Enabler Tool Guide
Release 19.1.000
F31993-01
Next
Contents
Title and Copyright Information
Send Us Your Comments
Preface
Audience
Documentation Accessibility
Related Documents
Customer Support
Improved Process for Oracle Retail Documentation Corrections
Oracle Retail Documentation on the Oracle Help Center (docs.oracle.com)
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
Determining the Type of Installation
Installing as a Standalone Application
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
Command Line Interface
Sevice Provider
Arguments
Commands
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
Arguments
Commands
4
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 using Webservice Call-Out Utility
PL/SQL Consumer Web Service
Java EE Provider Web Service
Java EE Consumer Web Service
5
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
6
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
7
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
8
Web Service Standards and Conventions
Web Service Naming
Web Service Versioning
9
Creating the Java EE Implementation Jar
Step 1: Generate Web Services with Default Implementation
Step 2: Implement Interfaces
Step 3: Upload the jar
10
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
11
Implementation Guidelines
Important Note About this Chapter
PL/SQL Consumer using Web Service Call-Out Utility Implementation Notes
Install Oracle JVM Web Services Call-Out Utility
Verify environment variables and export if needed
Create OJVMWCU_INSTALL User
Install OJVMWCU
Grant permission and create synonyms
Grant permission to the user
Load RBO Oracle Objects into the database
Create activity logging table
Load WebService java code into database
Load WebService plsql code into database
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
12
Web Services Security Setup Guidelines
Client-Side Setup
Java Client Setup
PL/SQL Client Setup for WS with Call-out
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