Oracle® REST Data Services

Release Notes

Release 3.0

E56294-13

October 2016

These Release Notes contain important information not included in the Oracle REST Data Services documentation.

This document contains these topics:

See Also:

readme.html in the folder where you unzipped the Oracle REST Data Services installation kit, for detailed information about new features, changes, and issues fixed.

1.1 Checking for the Most Current Release

Oracle REST Data Services is released more frequently than Oracle Database. To view information about or download a more current release (including a possible beta or "early adopter" release), see:

http://www.oracle.com/technetwork/developer-tools/rest-data-services/overview/index.html

1.2 New Features and Other Changes

This section describes new features and other changes and enhancements for Oracle REST Data Services releases.

See Also:

Bugs Fixed

1.2.1.1 Changes to the Oracle REST Data Services Installer

You can now install Oracle REST Data Services with its own schema and define RESTful services.

You have options to run the installation in simple or advanced mode to prompt you for the information. The installation process is simple and fast.

The installer provides the option to migrate RESTful Service definitions stored in Application Express workspaces to Oracle REST Data Services-enabled schemas.

The installer provides an uninstall command; enter java -jar ords.war help uninstall for more information.

Oracle Application Express is no longer required for an Oracle REST Data Services installation. (It was required in Oracle REST Data Services releases 2.0.n.)

1.2.1.2 PL/SQL API for Creating RESTful Services

This release previews the PL/SQL API for creating and editing restful services using PL/SQL, enabling the creation and maintenance of RESTful services to be scripted via PL/SQL. The API also exposes all the OAuth 2.0 functionality, enabling OAuth Clients to be registered and managed. Note that this API is subject to change before the final release of 3.0.0.

1.2.1.3 OAuth 2.0 Client Credentials Grant Support

The OAuth 2.0 Client Credentials Grant type is now supported, enabling server to server authorization via OAuth 2.0, which is an important use case for enterprise applications.

1.2.1.4 RESTful Privileges Can be Mapped to URL Patterns

RESTful privileges can now be associated with arbitrary URL patterns, enabling RESTful privileges to protect any database resource accessed through Oracle REST Data Services, including JSON Collection store resources and AutoRest resources. Privilege to URL mappings can be configured using the PL/SQL API or using SQL Developer.

This and the preceding feature mean that JSON Collection store resources and AutoRest resources can now be protected by OAuth 2.0.

1.2.1.5 Improved NoSQL Database Support

The /store prefix on NoSQL Database resources has been eliminated, and support has been added for the new DDL capability introduced in NoSQL Database 3.2.5, enabling DDL statements to be issued through a RESTful endpoint.

1.2.1.6 RESTful Services Query Filtering Support

RESTful Services (that perform SQL queries) now support the specification of a JSON based filtering clause to further constrain the query. The filter clause can either be specified by including it as a parameter of the service's query string, or by submitting a POST request with the filter clause as the body of the POST request.

1.2.1.7 Java API for Oracle REST Data Services Plugins

A new Java API enables third parties to contribute extensions to the Oracle REST Data Services runtime. (Note that this API is subject to change before the final release of Oracle REST Data Services 3.0.0.) For more information, see the following under the location where you installed Oracle REST Data Services:

  • Documentation: docs\javadoc\plugin-api

  • Tutorial demonstrating how to compile and add a plugin: examples\plugins\plugin-demo

1.2.1.8 "Developer's Guide" Material Now in Oracle REST Data Services Installation, Configuration, and Development Guide

The Oracle REST Data Services Installation, Configuration, and Development Guide has been expanded to include material based on the old, unofficial "developer's guide" that was supplied as a file named restful_services_devguide.html.

The development material is now in the chapter titled "Developing Oracle REST Data Services Applications".

1.2.1.9 Apache JServ Protocol (AJP) Support Removed

Apache JServ Protocol (AJP) support has been removed because Jetty is now used as the run time for standalone mode, Jetty does not support AJP.

1.2.1.10 SQL Developer 4.1 Graphical Interface for Oracle REST Data Services

Oracle SQL Developer release 4.1 provides a graphical user interface and enables users to install Oracle REST Data Services and run it in standalone mode within SQL Developer. Within SQL Developer you can create, edit and validate RESTful services that are stored in Oracle REST Data Services schema.

For more information, see the topic "Oracle REST Data Services Administration and Development" in Oracle SQL Developer User's Guide or in the SQL Developer online help.

1.2.2 Release 3.0.1

See the readme.html file for detailed information about new features and other changes for this release. These include:

1.2.3 Release 3.0.2

See the readme.html file for detailed information about new features and other changes for this release.

1.2.4 Release 3.0.3

See the readme.html file for detailed information about new features and other changes for this release. These include:

  • Support is provided for upgrading Oracle REST Data Services in a containter database (CDB) from Release 3.0.1 to 3.0.2.

  • Fixes or possible actions are provided regarding 404 errors when configuring Oracle REST Data Services.

  • Standalone mode can now serve aribtrary static resources through its new document root feature.

1.2.5 Release 3.0.4

There are no new features for this release.

See the readme.html file for additional information.

1.2.6 Release 3.0.5

There are no new features for this release.

See the readme.html file for additional information.

1.2.7 Release 3.0.6

There are no new features for this release.

See the readme.html file for additional information.

1.2.8 Release 3.0.7

Oracle REST Data Services release 3.0.7 includes the following new features and other changes:

1.2.8.1 APEX_PUBLIC_USER and wwv_flow_epg_include_modules.authorize

In line with security best practices and as recommended by Oracle Application Express Application Builder User's Guide when a database pool is configured to use the APEX_PUBLIC_USER, Oracle REST Data Services automatically sets the value of the security.requestValidationFunction setting to be:
 WWV_FLOW_EPG_INCLUDE_MODULES.AUTHORIZE
This setting activates the white list of callable procedures that ships with Oracle Application Express and prohibits calls to other procedures. See the Oracle Application Express Application Builder User's Guide for more information about this procedure and how to customize its behavior.

See the readme.html file for additional information.

1.2.9 Release 3.0.8

There are no new features for this release.

See the readme.html file for additional information.

1.3.1 Bugs Fixed in Oracle REST Data Services in Release 3.0.0

See readme.html in the folder where you unzipped the Oracle REST Data Services installation kit for detailed information about problems, fixes, and issues. In addition to the fixes listed in that file, the bugs fixed since the final 2.0.n release include the following:

  • Fixed a problem where the Oracle REST Data Services uninstall script sometimes did not work, often with no explanation or an unhelpful one. (20140082)

  • Ensured that a transaction for original resource handler is committed before forwarding the request to the GET handler. (20197577)

  • Correctly handle escaped slash characters in JSON values. (20221841)

  • Addressed regression in 3.0.0 EA1 that prevented tabular forms in Application Express from working correctly. (20536145)

  • Ensured that @ApplicationScoped services are not started when the command line is active. (20568202)

  • Enabled PL/SQL Gateway support for the HEAD operation. (20601219)

1.3.2 Bugs Fixed in Oracle REST Data Services in Release 3.0.1

See readme.html for information about bugs fixed since Release 3.0.0 and since the previous beta (Early Adopter 1) of Release 3.0.1.

1.3.3 Bugs Fixed in Oracle REST Data Services in Release 3.0.2

See readme.html for information about bugs fixed since Releases 3.0.0 and 3.0.1.

1.3.4 Bugs Fixed in Oracle REST Data Services in Release 3.0.3

See readme.html for information about bugs fixed since Releases 3.0.0, 3.0.1, and 3.0.2

1.3.5 Bugs Fixed in Oracle REST Data Services in Release 3.0.4

This release includes fixes for the following bugs:

  • BUG:21890324 - Fix problem with conditional DELETE of NoSQL table resources

  • BUG:22342053 - Fix issue with the dispatching of Resource Modules with empty base path

  • BUG:22525939 - Fix issues causing APEX static resources to give 404 Not Found errors

  • BUG:22550686 - Fix problem preventing install into PDB in Oracle Database 12.1.0.1

  • BUG:22605437 - Fix issues causing ORA-01000 Maximum Open Cursors Exceeded error message

See also readme.html for information about bugs fixed since Release 3.0.0.

1.3.6 Bugs Fixed in Oracle REST Data Services in Release 3.0.5

See readme.html for information about bugs fixed since Release 3.0.0.

1.3.7 Bugs Fixed in Oracle REST Data Services in Release 3.0.6

See readme.html for information about bugs fixed since Release 3.0.0.

1.3.8 Bugs Fixed in Oracle REST Data Services in Release 3.0.7

See readme.html for information about bugs fixed since Release 3.0.0.

1.3.9 Bugs Fixed in Oracle REST Data Services in Release 3.0.8

See readme.html for information about bugs fixed since Release 3.0.0.

1.4 Open Bugs and Known Issues

This section describes bugs and known issues for Oracle REST Data Services.

See also readme.html in the folder where you unzipped the Oracle REST Data Services installation kit for possible additional information about problems, fixes, and issues.

1.4.1 SODA

  • Indexing of TIMESTAMP type does not work.

  • HEAD responses incorrectly report 0 (zero) as the content length, and some also incorrectly report 204 (no content) as the status.

1.4.2 Application Express RESTful Service Migrations

  • Migrating Application Express-based RESTful Services is not handling the case where a database does not contain any Application Express schema.It also does not handle the case where the installed version of Application Express is 5.0.0 or later. (Bug 21302877)

1.4.3 Autogenerated REST Endpoints

  • AutoREST resources support the OAuth 2.0 Client Credentials flow only.

1.4.4 RESTful Services

  • Application Express workspaces do not support first party authentication, and therefore do not support the /sign-in/ interactive sign-in form. Accessing /sign-in/ in Application Express workspaces will produce a 404 status.

1.4.5 NoSQL

  • It is currently not possible to access secured NoSQL REST Endpoints with OAuth 2.0. Only first-party cookie authentication is supported.

1.5 Documentation Accessibility

For information about Oracle's commitment to accessibility, visit the Oracle Accessibility Program website at http://www.oracle.com/pls/topic/lookup?ctx=acc&id=docacc.

Access to Oracle Support

Oracle customers that have purchased support have access to electronic support through My Oracle Support. For information, visit http://www.oracle.com/pls/topic/lookup?ctx=acc&id=info or visit http://www.oracle.com/pls/topic/lookup?ctx=acc&id=trs if you are hearing impaired.


Oracle® REST Data Services Release Notes, Release 3.0

E56294-13

Copyright © 2011, 2016, Oracle and/or its affiliates. All rights reserved.

This software and related documentation are provided under a license agreement containing restrictions on use and disclosure and are protected by intellectual property laws. Except as expressly permitted in your license agreement or allowed by law, you may not use, copy, reproduce, translate, broadcast, modify, license, transmit, distribute, exhibit, perform, publish, or display any part, in any form, or by any means. Reverse engineering, disassembly, or decompilation of this software, unless required by law for interoperability, is prohibited.

The information contained herein is subject to change without notice and is not warranted to be error-free. If you find any errors, please report them to us in writing.

If this is software or related documentation that is delivered to the U.S. Government or anyone licensing it on behalf of the U.S. Government, the following notice is applicable:

U.S. GOVERNMENT END USERS: Oracle programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, delivered to U.S. Government end users are "commercial computer software" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations. As such, use, duplication, disclosure, modification, and adaptation of the programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, shall be subject to license terms and license restrictions applicable to the programs. No other rights are granted to the U.S. Government.

This software or hardware is developed for general use in a variety of information management applications. It is not developed or intended for use in any inherently dangerous applications, including applications that may create a risk of personal injury. If you use this software or hardware in dangerous applications, then you shall be responsible to take all appropriate fail-safe, backup, redundancy, and other measures to ensure its safe use. Oracle Corporation and its affiliates disclaim any liability for any damages caused by use of this software or hardware in dangerous applications.

Oracle and Java are registered trademarks of Oracle and/or its affiliates. Other names may be trademarks of their respective owners.

Intel and Intel Xeon are trademarks or registered trademarks of Intel Corporation. All SPARC trademarks are used under license and are trademarks or registered trademarks of SPARC International, Inc. AMD, Opteron, the AMD logo, and the AMD Opteron logo are trademarks or registered trademarks of Advanced Micro Devices. UNIX is a registered trademark of The Open Group.

This software or hardware and documentation may provide access to or information about content, products, and services from third parties. Oracle Corporation and its affiliates are not responsible for and expressly disclaim all warranties of any kind with respect to third-party content, products, and services unless otherwise set forth in an applicable agreement between you and Oracle. Oracle Corporation and its affiliates will not be responsible for any loss, costs, or damages incurred due to your access to or use of third-party content, products, or services, except as set forth in an applicable agreement between you and Oracle.