What Will You Learn
After completing this course you should be able to:
- Know what makes a service ‘RESTful’
- Be introduced to a common URI design approach
- Understand HTTP requests & responses
- Be able to use the built-in DataObjectHandler (i.e. create Business Entities)
- How to customise Business Entity HTTP responses
- Be able to create custom WebHandlers for sending and receiving text/JSON and binary data (including file upload & download)
- Know how to detect problem requests and respond with appropriate HTTP status codes
- Have options for versioning REST services
- Be aware of WebHandler differences on development vs. production PASOE
- Gain an insight to REST API testing with Postman
Audience
OpenEdge developers who will be creating REST services on PASOE
Duration
1 day
Product Version
Progress OpenEdge 11.7.5+ and 12.1+
Course Details
The course starts with an overview and what a REST service is, together with REST’s relationship to HTTP. What an HTTP request and response consists of is discussed, including HTTP methods, status codes and key headers. In addition, a common design approach and basic style guide for REST services is outlined before moving on to implementing REST services in OpenEdge.
The course will include the following topics:
- Options for creating REST services with OpenEdge
- REST services with the DataObjectHandler (Business Entities)
- JSON Filter Pattern
- How to return validation errors from a Business Entity
- Custom methods in Business Entities
- Custom HTTP responses from Business Entities
- Support for JSDOs
- Use of custom WebHandlers
- Evaluating HTTP requests (paths, path and query parameters)
- Creating and sending HTTP responses (text & binary data)
- Uploading single or multiple files
- Detecting and handling invalid requests
- Options for versioning REST services
- WebHandler deployment
Training Prerequisites
You should already be able to:
- Have a working knowledge of Progress Developer Studio for OpenEdge
- Awareness of Progress Application Server for OpenEdge (PASOE)
- Be familiar with ProDataSets, including an awareness of ‘before-tables’
- Know the basics of structured error handling (throw/catch)
- Have elementary knowledge of the OOABL (including classes, methods, method overriding, properties, inheritance & enums)
How to Subscribe
Step 1 - Log in
Visit the Progress Education Community (PEC) and log in with your Progress ID. If you do not have a Progress ID, you can register here.
Note: You must activate your Progress ID prior to logging in to the Progress Education Community
Step 2 - Find Your Content & Start Learning
Navigate to the Content Library and search for: Building REST services with WebHandlers on PASOE. Then simply click the title for FREE access to the course.
Interested in the Class?
Stay up to date with technology trends and get the most out of your Progress technology investment.