Web services Guide
Preface
Notices
Trademarks
About this book
Who this book is for
What’s new?
VAST Platform 2023 (version 12.0.0)
Conventions used in this book
Tell us what you think
Understanding Web services
Web services
Technologies Used
Getting Started: Web services in 10 Minutes
Installing the Web services Feature
Creating a simple web service
Creating a Web service
Local Deployment
Remote Deployment
Getting Started: Web services in an Hour
Creating a Web service
Deploying a Web service
Web Services Container
Example
Invoking a Web service
Explanation
Example Smalltalk Service
Invoking a third party service
Getting Started: Web services in a Day
Using Document Literal Style
Creating a Web Service
XML File Generation
Deploying the Web Service In the Server Image
Invoking the Web Service from a Client Image
Summary
Using RPC Literal Style
Using RPC Encoded Style
Using RPC Encoded Style
Exchanging Complex Data in A Web Service
Creating the Web Service
XML File Generation
Modifications to XML files
Modification of the web service deployment descriptor
Modifying the Web Service Location
Refining Web Service Type Definitions
Deploying the Server Web Service
Invoking the Web Service
Summary
Using A Custom Handler in a Web Service with Complex Data Types
Creating The Web Service
Modifications to XML files
Modification of the web service deployment descriptor
Modifying the Web Service Location
Refining Web Service Type Definitions
Deploying the Server Web Service
Invoking a Web Service
Summary
User Guide
Web services Platform Overview
Web services: All objects, all the time
Location Transparency
Smalltalk Language Semantics
Overview of the Web Services Container
Detailed Component Architecture & Advanced Concepts
The Container Framework
Working with a Container
Managers and Factories
Deployment Manager
Deployment Strategies
Message Context Factory
Handler Factory
The Manager Collection
WSActorManager
WSEngineFactory
WSPortManager
WSSerializationManager
WSServiceDefinitionsManager
WSServiceManager
Web Service Handlers and Message Processing
Web Service Message Processing Handlers
Transport Handlers
Serialization Handlers
Message Processing
Message Processing, A Sever Perspective
Soap Headers
Message Processing, A Client Perspective
Exception Processing
Custom Exception Processing
Errors During Exception Processing
Adding headers to extend message behavior
Modify WSDL to include header extension information
Add header elements using custom Web service handlers
Deployment Descriptors
Container Specific Deployment Information
Service Specific Deployment Information
Service Undeployment
Packaging a Web service
Building a Web services platform
Building a service image component
Packaging Web services clients
Packaging the Web services platform from an XD passive image
Packaging the Web services insurance example as a reusable image component (XD passive image)
Reduced runtime packaging
Runtime considerations
Deploying packaged Web services
System files
User files
Creating runtime deployment descriptor files
Modifying the .ini file for the Web services platform image
Starting the Web services platform
Processing Web Services Which use Soap 1.2 Extensions
Extending/ Customizing the Web service platform
Customizing SstWSService
Customizing the Container
Extending the container
Extending the deployment manager
Custom service handlers
Customizing serialization
Customizing deserialization (parsing)
Customizing encoding strategy
Samples
Insurance example
Modifying deployment files to customize service behavior
Renaming WSDL operations and messages
Defining custom schema types
Specifying types for WSDL messages
Specifying correct endpoint
Customizing the service deployment descriptor
The service description definition
Running the example
Starting the container
Creating the client container
Invoking an operation
Invoking a series of operations
Using SOAP arrays
Using WSDL to process SOAP Headers
Using custom handlers to process SOAP headers
Summary
Container Administration service
Cookbook
Debugging Tips
Turning Off Exception Handling and Forwarding
Inspect Request/Response SOAP Envelopes during Client Web Service Invocation
Inspect Request/Response SOAP Envelopes during Server Request/Response Processing
Enable signaling of Mapping Parser Exceptions
Reset the Web Services Development Environment
How to Send a SOAP Response Using the SstHttpServer Example
Using Breakpoints
The SOAP envelope request
Where to stop in client
Calling getInfoForPolicy
Calling getInfoForPolicyWithVerification
Where to stop in server
Calling the web service operation
Deconstructing the SOAP envelope request
Server side deconstruction of request envelope
Construction of SOAP envelope response
Where to stop in client
Calling getInfoForPolicy
Calling getInfoForPolicyWithVerification
Deserializing XML data
Executing the Example Code
The Data
Smalltalk classes
XML Data
XML Dataset 1
XML Dataset 2
Dataset 1 Deserialization
Conversion without a Mapping Spec or Schema
Conversion Using a Mapping Spec
Conversion Using a Schema and a Mapping Spec
Dataset 2 Deserialization
Conversion without a Mapping Spec or Schema
Conversion Using a Mapping Spec
Conversion Using a Schema and a Mapping Spec
Summary
Creating a Secure Web Service
Modifications for Security
Security Files
Modification to WSDL
Modifications to the Transport Layer
Server
Client
Deploying the Web Service
Invoking the Web Service
Summary
How to Make Web Service Requests That Affect A User Interface
How to Create and Register A Custom SstTransport for A Secure Web Service
Troubleshooting
WSDL and imported schemas using the document/literal or document/literal wrapped pattern are not serialized properly
Problem
Solution
An Element with a ref attribute referring to another namespace was serialized incorrectly in the SOAP Envelope
Problem
Solution
Appendix A: Insurance Policy Example Workspace Code
XML and WSDL File Generation
Server Workspace Code
Client Workspace Code
Client Workspace Code: Policy Verification
Web services Guide
Web services Guide
Preface
Notices
Trademarks
About this book
Who this book is for
What’s new?
Conventions used in this book
Tell us what you think
Understanding Web services
Getting Started: Web services in 10 Minutes
Installing the Web services Feature
Creating a simple web service
Creating a Web service
Local Deployment
Remote Deployment
Getting Started: Web services in an Hour
Creating a Web service
Deploying a Web service
Invoking a Web service
Getting Started: Web services in a Day
Using Document Literal Style
XML File Generation
Deploying the Web Service In the Server Image
Using RPC Literal Style
Using RPC Encoded Style
Using RPC Encoded Style
Exchanging Complex Data in A Web Service
XML File Generation
Modifications to XML files
Deploying the Server Web Service
Invoking the Web Service
Summary
Using A Custom Handler in a Web Service with Complex Data Types
Modifications to XML files
Deploying the Server Web Service
Invoking a Web Service
Summary
User Guide
Web services Platform Overview
Web services: All objects, all the time
Location Transparency
Smalltalk Language Semantics
Overview of the Web Services Container
Detailed Component Architecture & Advanced Concepts
The Container Framework
Web Service Handlers and Message Processing
Packaging a Web service
Deploying packaged Web services
Processing Web Services Which use Soap 1.2 Extensions
Samples
Cookbook
Debugging Tips
How to Send a SOAP Response Using the SstHttpServer Example
Using Breakpoints
The SOAP envelope request
Deconstructing the SOAP envelope request
Construction of SOAP envelope response
Deserializing XML data
Creating a Secure Web Service
How to Make Web Service Requests That Affect A User Interface
How to Create and Register A Custom SstTransport for A Secure Web Service
Troubleshooting
WSDL and imported schemas using the document/literal or document/literal wrapped pattern are not serialized properly
An Element with a ref attribute referring to another namespace was serialized incorrectly in the SOAP Envelope
Appendix A: Insurance Policy Example Workspace Code
XML and WSDL File Generation
Server Workspace Code
Client Workspace Code
Client Workspace Code: Policy Verification