Creación de Servicios Web RESTful

Cree servicios web RESTful mediante las páginas Módulos, Plantillas y Manejadores.

Para crear un servicio web RESTful, debe:

  • Definir un módulo de recursos

  • Definir una plantilla de recursos

  • Defina uno o más manejadores de recursos, como GET, PUT, POST o DELETE. Opcionalmente, defina los parámetros que necesita transferir al manejador de recursos.

En las siguientes secciones, se proporciona información sobre cómo crear módulos de recursos, plantillas de recursos y manejadores de recursos.

Consulte también:

Tema principal: Páginas de REST

Gestión de módulos de recursos

Puede definir, editar y suprimir módulos de recursos en la página Módulos.

Para navegar a la página Módulos, en la página Visión general de REST, haga clic en Módulos en Objetos o, en el menú de la cabecera, seleccione Módulos.

Los atributos del módulo que se muestran por defecto en la vista de tarjeta se muestran en la siguiente figura.

A continuación se muestra la descripción de module_card.png
Descripción de la ilustración module_card.png

El estado del módulo se puede publicar o anular la publicación. Si el estado no se publica, el icono se muestra en color rojo.

Haga clic en el nombre del módulo en la vista de tarjeta para ir a la página Plantillas de ese módulo. También puede navegar a la página Templates (Plantillas) a través del menú contextual.

Las acciones disponibles en el menú contextual son:

Consulte también:

Acerca de la barra de herramientas de búsqueda REST

Tema principal: Creación de servicios web RESTful

Creación de un módulo de recurso

En esta sección, se describe cómo crear un módulo de recursos.

  1. En la página Módulos, haga clic en Crear módulo.
  2. Introduzca los siguientes campos. Los campos con un asterisco (*) son obligatorios:

    Separador Definición de Módulo

    • Nombre del módulo: introduzca el nombre del módulo. Este campo es sensible a mayúsculas/minúsculas.

    • Ruta de Acceso Base: Introduzca la base del URI para acceder al servicio RESTful. Por ejemplo: hr/ significa que este módulo de recursos atenderá a todos los URI que empiecen por hr/. Observe el cambio en la URL de vista previa al introducir la ruta base.

    • Is Published: activación para que el servicio RESTful quede disponible para su uso.

    • Tamaño de paginación: introduzca o seleccione el número de resultados que se devolverán en cada página según una consulta de base de datos. El valor por defecto es 25.

    • Protegido por privilegio: seleccione un privilegio para proteger el módulo de la lista desplegable.

    • Comentarios: introduzca comentarios descriptivos.

    • Ir al módulo después de la creación: seleccione esta opción para ir a la página Plantillas después de crear el módulo.

    ficha Orígenes Permitidos

    • Introduzca orígenes que puedan acceder a las plantillas de recursos. Haga clic en Agregar (+) para agregar cada origen. Por ejemplo:

      http://example1.org

      https://*.example2.com

    Mostrar código: seleccione esta opción para ver el equivalente de código PL/SQL del control deslizante Crear módulo. Puede copiar y ejecutar este código PL/SQL en la hoja de trabajo para realizar la misma acción que se produce al hacer clic en Crear en el control deslizante Crear Módulo.

  3. Haga clic en Create.

    El nuevo módulo se muestra en la página Módulos. Si no puede verlo, localice el módulo mediante el campo Buscar.

Tema principal: Gestión de módulos de recursos

Importación de un módulo de recursos

En esta sección, se describe cómo importar un módulo de recursos.

Note:

Puede importar un documento de OpenAPI versión 2.0 o 3.0 solo en formato JSON.
  1. En la página Módulos, en la parte superior derecha, haga clic en Importar módulo.
  2. Busque y seleccione el archivo JSON que desea importar. Haga clic en Abrir.

    El control deslizante Importar módulo se muestra con los campos Ruta de acceso base y Vista previa de URL rellenados previamente. Edite la ruta base según sea necesario. La edición del campo de ruta de acceso base también actualizará la ruta de acceso base en el formato JSON que se muestra en el control deslizante.

  3. Haga clic en Importar.

    Cuando se importa el módulo, se crea una configuración de privilegios y se establece para proteger el módulo. El nombre del privilegio se genera mediante la ruta de acceso base y agregando "_priv" al final de la cadena de la ruta de acceso base y también sustituyendo cada barra diagonal "/" en la ruta de acceso base por el guion bajo "_".

  4. El módulo está listo para su edición.

    Después de importar el módulo, se crean las plantillas y los manejadores, pero el módulo no se publica. Debe proporcionar bloques SQL y PL/SQL para cada manejador y publicar el módulo cuando esté listo para la prueba o producción.

Tema principal: Gestión de módulos de recursos

Edición de un módulo de recursos

En esta sección se describe cómo editar un módulo de recursos.

  1. En la página Módulos, para el módulo específico, haga clic en icono de menú contextual y seleccione Editar.
  2. Edite los campos necesarios y haga clic en Guardar. Para obtener una descripción de los campos, consulte Creating a Resource Module.

Tema principal: Gestión de módulos de recursos

Supresión de un módulo de recursos

En esta sección, se describe cómo suprimir un módulo de recursos.

  1. En la página Módulos, para el módulo específico, haga clic en menú de contexto y seleccione Suprimir.

    Aparece un indicador en el que se le pregunta si desea confirmar.

  2. Haga clic en Aceptar para suprimir.

Tema principal: Gestión de módulos de recursos

Publicación/Anulación de la publicación de un módulo de recursos

En esta sección, se describe cómo hacer que un módulo de recursos esté disponible o no.

  1. En la página Módulos, para el módulo específico, haga clic en menú de contexto y, a continuación, seleccione Publicar o Anular publicación.

    Verá una petición de datos para confirmar.

  2. Haga clic en Aceptar.

Tema principal: Gestión de módulos de recursos

Exportación de un módulo de recursos

Puede exportar el código fuente PL/SQL para el código JSON de API o de Open API (Swagger) para un módulo de recursos o servicio RESTful. Si el módulo tiene plantillas, manejadores, parámetros, roles, etc., estos objetos también se muestran y exportan.

  1. En la página Módulos, para un módulo específico, haga clic en menú de contexto y seleccione Exportar módulo.
  2. Seleccione PL/SQL para copiar o exportar el origen PL/SQL para la API. Seleccione OpenAPI para copiar o exportar el código JSON de Open API (Swagger) para el módulo.

    Note:

    Un módulo exportado mediante Open API siempre se importa con un estado no publicado.
  3. Haga clic en Copiar en portapapeles para copiar el código o haga clic en Descargar para descargarlo en la computadora local.

Tema principal: Gestión de módulos de recursos

Visualización del módulo en la vista OpenAPI

En esta sección se describe cómo abrir el módulo en la vista Open API.

La opción de vista Open API está disponible para los módulos que se publican y no están protegidos.
  1. En la página Módulos, para el módulo específico, haga clic en menú de contexto y seleccione Vista de OpenAPI.
  2. El módulo se muestra como una implementación de interfaz de usuario de Swagger.
    Puede ver y ejecutar los manejadores, transferir parámetros a los manejadores y copiar o descargar las respuestas.

    Para obtener más información sobre la implantación de la interfaz de usuario de Swagger, consulte el sitio web oficial de la interfaz de usuario de Swagger.

Tema principal: Gestión de módulos de recursos

Gestión de plantillas de recursos

Puede definir, editar y suprimir plantillas de recursos para un módulo en la página Plantillas.

Para navegar a esta página, en la página Módulos, haga clic en menú de contexto para un módulo y seleccione Plantillas o haga clic en el nombre del módulo en la vista de tarjeta.

En la parte superior de la página, la tarjeta del módulo está disponible con opciones de menú contextual como Editar, Suprimir, Publicar y Exportar.

Los atributos de plantillas que se muestran de forma predeterminada en la vista de tarjeta se muestran en la siguiente figura.

A continuación se muestra la descripción de template_card.png
Descripción de la ilustración template_card.png

Haga clic en el nombre de la plantilla en la vista de tarjeta para ir a la página Handlers. También puede navegar a la página Handlers a través del menú contextual.

Las acciones disponibles en el menú contextual son:

Tema principal: Creación de servicios web RESTful

Creación de una plantilla de recursos

En esta sección, se describe cómo crear una plantilla de recursos.

  1. En la página Plantillas de un módulo, haga clic en Crear plantilla.
  2. Introduzca los siguientes campos. Los campos con un asterisco (*) indican que son obligatorios:

    • Plantilla de URI: introduzca el patrón de URI para la plantilla de recurso.

      Por ejemplo, un patrón de /objects/:object/:id? coincidirá con /objects/emp/101 (coincide con una solicitud para el elemento en el recurso emp con el ID de 101) y también coincidirá con /objects/emp/ (coincide con una solicitud para el recurso emp, porque el parámetro :id se anota con el modificador ?, que indica que el parámetro id es opcional).

      Tenga en cuenta que la URL de vista previa cambia a medida que escribe la plantilla de URI.

    • Prioridad: introduzca o seleccione la prioridad para la evaluación de la plantilla de recurso (1 es prioridad baja y 9 es prioridad alta).

    • Tipo de etiqueta de entidad HTTP: seleccione el tipo de etiqueta de entidad que utilizará la plantilla de recurso. Una etiqueta de entidad es una cabecera HTTP que actúa como identificador de versión para un recurso.

      Las opciones son:

      • HASH seguro (por defecto): el contenido de la representación de recurso devuelta se HASH mediante una función de resumen seguro para proporcionar una huella única para una versión de recurso determinada.

      • Consulta: defina manualmente una consulta que identifique de forma única una versión de recurso. Una consulta definida manualmente a menudo puede generar una etiqueta de entidad de forma más eficaz que aplicar hash a toda la representación de recursos.

      • Ninguno: no genere una etiqueta de entidad.

    • Comentarios: introduzca comentarios descriptivos, si los hay.

    • Ir a Manejadores después de la Creación: Seleccione esta opción para ir a la página Manejadores después de crear la plantilla.

    Mostrar código: seleccione esta opción para ver el equivalente de código PL/SQL del control deslizante Crear plantilla. Puede copiar y ejecutar este código PL/SQL en la hoja de trabajo para realizar la misma acción que se produce al hacer clic en Crear en el control deslizante Crear Plantilla.

  3. Haga clic en Create.

    La nueva plantilla para el módulo se agrega a la página Templates.

    Si se selecciona "Go to Handlers after creation", puede utilizar el nombre del módulo en las rutas de navegación de la parte superior de la página para ver la lista de plantillas para el módulo.

Tema principal: Gestión de plantillas de recursos

Edición de una plantilla de recurso

En esta sección se describe cómo editar una plantilla de recursos.

  1. En la página Plantillas, para una plantilla específica, haga clic en menú de contexto y, a continuación, seleccione Editar.
  2. Edite los campos necesarios y haga clic en Guardar.

    Para obtener una descripción de los campos, consulte Creating a Resource Template.

Tema principal: Gestión de plantillas de recursos

Supresión de una Plantilla de Recursos

En esta sección, se describe cómo suprimir una plantilla de recursos.

  1. En la página Plantillas, para una plantilla específica, haga clic en menú de contexto y, a continuación, seleccione Suprimir.

    Se le pedirá que confirme.

  2. Haga clic en Aceptar para suprimir.

Tema principal: Gestión de plantillas de recursos

Gestión de manejadores de recursos

Puede crear, editar y suprimir manejadores de recursos para una plantilla en la página Manejadores.

Para navegar a esta página, en la página Plantillas, haga clic en menú de contexto para una plantilla y seleccione Gestores o haga clic en el nombre de la plantilla en la vista de tarjeta.

En la parte superior de la página, la tarjeta de plantilla está disponible con opciones de menú contextual como Editar y Suprimir.

Los atributos del manejador que se muestran por defecto en la vista de tarjeta se muestran en la siguiente figura.

A continuación se muestra la descripción de handler_card.png
Descripción de la ilustración handler_card.png

El método HTTP puede ser uno de los siguientes: GET, PUT, POST y DELETE.

Puede navegar a la página del método HTTP mediante el menú contextual. En la página del método HTTP se muestran tres separadores: Origen, Parámetros y Solicitudes autenticadas previamente.

Para crear un manejador de recursos, consulte Creating a Resource Handler.

Note:

Esta opción no está disponible si la plantilla tiene los cuatro manejadores creados (GET, POST, PUT, DELETE).

Las acciones disponibles en el menú contextual son:

Tema principal: Creación de servicios web RESTful

Creación de un manejador de recursos

En esta sección se describe cómo crear un manejador de recursos.

  1. En la página Manejadores, haga clic en Crear manejador.
  2. Especifique las propiedades del manejador de recursos. Las opciones específicas dependen del tipo de método.

    Separador Definición de Manejador

    • Método: introduzca el método de solicitud HTTP para este manejador: GET (recupera una representación de un recurso), POST (crea un nuevo recurso o agrega un recurso a una recopilación), PUT (actualiza un recurso existente) o DELETE (suprime un recurso existente). Solo se permite un manejador para cada método HTTP.

    • Elementos por Página: Introduzca o seleccione el tamaño de paginación por defecto o el número de filas que se devolverán para una consulta de base de datos. Esta opción sólo está disponible para los manejadores GET. Si no se define este valor, el número de elementos por página es el definido en el módulo.

    • Tipo de Origen: Seleccione la implantación de origen para el método HTTP seleccionado. El valor por defecto es la consulta de recopilación.

      • Consulta de recopilación: ejecuta una consulta SQL y transforma el juego de resultados en una representación JSON. Disponible cuando el método HTTP es GET.

      • Elemento de recopilación: ejecuta una consulta SQL que devuelve una fila de datos en una representación JSON. Disponible cuando el método HTTP es GET.

      • Media (Medio): ejecuta una consulta SQL que cumple con un formato específico y convierte el juego de resultados en una representación binary (Binaria) con una cabecera HTTP Content-Type (Tipo de contenido HTTP) que identifica el tipo de medio de Internet de la representación.

      • PL/SQL: ejecuta un bloque PL/SQL anónimo y transforma cualquier parámetro OUT o IN/OUT en una representación JSON.

    • Origen: introduzca la consulta SQL o el bloque PL/SQL para el método HTTP. En la página de detalles del manejador, puede probar el código del manejador SQL o PL/SQL en el editor del manejador.

    • Ir al manejador después de la creación: seleccione esta opción para ir a la página de detalles después de crear el manejador.

    ficha MIME permitidos

    Identifica el tipo de información incluida en el cuerpo de la solicitud HTTP. Por ejemplo, si el manejador POST espera JSON en la solicitud, agregue "Application/JSON" como tipo MIME.

    Mostrar código: seleccione esta opción para ver el equivalente de código PL/SQL del control deslizante Crear manejador. Puede copiar y ejecutar este código PL/SQL en la hoja de trabajo para realizar la misma acción que se produce al hacer clic en Crear en el control deslizante Crear Manejador.

  3. Haga clic en Create.

    El manejador se muestra en la página Handlers para la plantilla específica.

    Puede probar el punto final del servicio REST mediante un cliente REST o una herramienta de línea de comandos, como cURL.

Consulte también:

Acerca de cURL y pruebas de servicios RESTful en la Guía del desarrollador de Oracle REST Data Services.

Tema principal: Gestión de manejadores de recursos

Edición de un manejador de recursos

En esta sección se describe cómo editar un manejador de recursos.

  1. En la página Manejadores, para un manejador específico, haga clic en menú de contexto y, a continuación, en Detalles.
  2. Edite los campos necesarios y haga clic en Guardar.

    Para obtener una descripción de los campos, consulte Creación de un manejador de recursos.

Tema principal: Gestión de manejadores de recursos

Supresión de un manejador de recursos

En esta sección se describe cómo suprimir un manejador de recursos.

  1. En la página Manejadores, para el manejador específico, haga clic en menú de contexto y, a continuación, en Suprimir.

    Se le pedirá que confirme.

  2. Haga clic en Aceptar para suprimir.

Tema principal: Gestión de manejadores de recursos

Visualización de Detalles del Manejador de Recursos y Gestión de Parámetros

Puede ver los detalles del manejador de recursos y gestionar parámetros en la página Método HTTP.

Para navegar a esta página, para un manejador específico, haga clic en menú de contexto y, a continuación, seleccione Detalles o haga clic en el nombre del manejador en la vista de tarjeta.

En la parte superior de la página, la tarjeta de controlador está disponible con opciones de menú contextual como Editar y Suprimir.

La página Método HTTP del manejador tiene dos secciones principales:

  • Editor de código para ejecutar el código fuente SQL o PL/SQL que se ha definido en el manejador de recursos. Puede ejecutar el código, guardar, deshacer, rehacer, descargar y borrar la salida. Para obtener más información sobre el editor, consulte Ejecución de sentencias SQL en el editor de códigos.

    Los parámetros implícitos utilizados en los manejadores de servicios REST se muestran en una lista de desplazamiento hacia el lado derecho del editor. Consulte Parámetros implícitos

  • Sección para gestionar los parámetros necesarios para ejecutar el método HTTP.

Por defecto, los parámetros se muestran en la vista de cuadrícula. Los atributos que se muestran en un parámetro en la vista de tarjeta se muestran en la siguiente figura.

A continuación se muestra la descripción de parameter_card.png
Descripción de la ilustración parameter_card.png

Las acciones disponibles en el menú contextual son:

Consulte también:

Acerca de la barra de herramientas de búsqueda REST

Tema principal: Gestión de manejadores de recursos

Creando parámetro

En esta sección se describe cómo crear un parámetro para un manejador de recursos.

  1. En la página Método HTTP del manejador, haga clic en Crear parámetro.
  2. Introduzca los siguientes campos. Los campos con un asterisco (*) son obligatorios:

    • Nombre de parámetro: introduzca el nombre del parámetro, tal y como se denomina en la plantilla de URI o la cabecera HTTP. El nombre define cómo se identifica el parámetro en la solicitud entrante o cómo se nombra el parámetro en la respuesta.

    • Nombre de variable de enlace: introduzca el nombre del parámetro, como se hará referencia en SQL. Si se especifica NULL, el parámetro no se enlaza.

    • Tipo de Origen: Seleccione el tipo que se identifica si el parámetro se origina en la plantilla de URI o la cabecera HTTP.

    • Tipo de parámetro: seleccione el tipo nativo del parámetro.

    • Método de acceso: seleccione el método de acceso al parámetro. Indica si el parámetro es un valor de entrada, un valor de salida o ambos.

    Mostrar código: seleccione esta opción para ver el equivalente de código PL/SQL del control deslizante Crear parámetro. Puede copiar y ejecutar este código PL/SQL en la hoja de trabajo para realizar la misma acción que se produce al hacer clic en Crear en el control deslizante Crear Parámetro.

  3. Haga clic en Create.

    El parámetro es agregado en la sección Parámetros.

Edición de un parámetro

En esta sección se describe cómo editar un parámetro.

  1. En la sección Parámetros, para el parámetro específico, haga clic en menú de contexto y, a continuación, seleccione Editar.
  2. Edite los campos necesarios y haga clic en Guardar.

    Para obtener una descripción de los campos, consulte Creación de un parámetro.

Supresión de un parámetro

En esta sección, se describe cómo suprimir un parámetro.

  1. En la sección Parámetros, para el parámetro específico, haga clic en menú de contexto y, a continuación, seleccione Suprimir.

    Se le pedirá que confirme.

  2. Haga clic en Sí para suprimir.
Parámetros implícitos

En esta sección se describen los parámetros implícitos en la página Detalles del manejador de recursos. Estos parámetros se agregan automáticamente a los manejadores de recursos.

Tabla 4-1 Parámetros implícitos

Nombre Tipo Modo de Acceso Cabecera HTTP Descripción

:body

BLOB

IN

No disponible

Especifica el cuerpo de la solicitud como BLOB temporal.

:body_text

CLOB

IN

No disponible

Especifica el cuerpo de la solicitud como CLOB temporal.

:content_type

VARCHAR

IN

Content-Type

Especifica el tipo MIME del cuerpo de la solicitud, como lo indica la cabecera de solicitud Content-Type.

:current_user

VARCHAR

IN

No disponible

Especifica el usuario autenticado para la solicitud. Si no se autentica ningún usuario, el valor se define en nulo.

:forward_location

VARCHAR

OUT

X-ORDS-FORWARD-LOCATION

Especifica la ubicación en la que Oracle REST Data Services debe reenviar una solicitud GET para producir la respuesta para esta solicitud.

:fetch_offset

NUMBER

IN

No disponible

Especifica el desplazamiento basado en cero de la primera fila que se mostrará en una página.

:fetch_size

NUMBER

IN

No disponible

Especifica el número máximo de filas que se van a recuperar en una página.

:page_offset

NUMBER

IN

No disponible

Especifica el desplazamiento de página basado en cero en una solicitud paginada.

Nota: El parámetro The :page_offset está en desuso. En su lugar, utilice el parámetro :row_offset.

:page_size

NUMBER

IN

No disponible

Especifica el número máximo de filas que se van a recuperar en una página.

El parámetro :page_size está en desuso. En su lugar, utilice :fetch_size parameter .

:row_offset

NUMBER

IN

No disponible

Especifica el índice basado en uno de la primera fila que se mostrará en una solicitud paginada.

:row_count

NUMBER

IN

No disponible

Especifica el índice basado en uno de la última fila que se mostrará en una solicitud paginada.

:status_code

NUMBER

OUT

X-ORDS-STATUS-CODE

Especifica el código de estado HTTP para la solicitud.

Para obtener más información sobre los parámetros implícitos, consulte la Guía del desarrollador de Oracle REST Data Services.

Uso de solicitudes autenticadas previamente para acceder a los servicios RESTful de ORDS

Para acceder a los servicios RESTful protegidos, puede crear y revocar solicitudes autenticadas previamente.

Las solicitudes autenticadas previamente le permiten acceder a los servicios RESTful de ORDS protegidos sin credenciales de usuario. Al crear la solicitud autenticada previamente, se genera una URL única. Puede proporcionar esta URL a un usuario externo para que interactúe con la entidad RESTful concreta mediante herramientas HTTP estándar.

Para obtener más información sobre las solicitudes autenticadas previamente, consulte Solicitudes autenticadas previamente de Oracle REST Data Services en la Guía del desarrollador de Oracle REST Data Services.

Para navegar a la página Solicitudes autenticadas previamente, puede realizar una de las siguientes acciones:

  • En la página Visión general, haga clic en el mosaico Solicitudes autenticadas previamente.

  • En la barra de menús, amplíe Seguridad y seleccione Solicitudes autenticadas previamente.

Temas:

Tema principal: Gestión de manejadores de recursos

Creación de una solicitud autenticada previamente

Para crear una solicitud autenticada automáticamente para un manejador existente:

  1. En el menú contextual de un manejador existente, seleccione Crear nueva solicitud autenticada previamente.

    Aparece el panel Crear solicitud autenticada previamente.

  2. En el campo Caducidad de token, introduzca la duración de caducidad del token en segundos.

    Seleccione Mostrar código para ver el código de origen subyacente para crear la solicitud autenticada previamente.

    Haga clic en Create.

    Se muestra el token, el alias y el enlace relativo para acceder al recurso. Debe realizar un seguimiento del token y el alias, ya que no podrá obtener sus valores más adelante. Si olvida los valores, puede revocar el token y crear uno nuevo.

Visualización de una solicitud autenticada previamente

En el menú contextual de un manejador existente, seleccione Solicitudes autenticadas previamente y, a continuación, seleccione Detalles.

Aparecen las solicitudes previamente autorizadas para el manejador específico.

Revocación de una solicitud autenticada previamente

Para revocar la solicitud autenticada previamente para un manejador:

  1. En el menú contextual de un manejador existente, seleccione Solicitudes autenticadas previamente y, a continuación, seleccione Detalles.

    Aparecerán las solicitudes autenticadas previamente para el manejador específico.

  2. En el menú contextual de la solicitud autenticada previamente, seleccione Revocar.

    Se le solicitará que confirme.

  3. Haga clic en Confirmar para revocar la solicitud.

Ejemplo: inserción de un registro mediante un manejador POST

El siguiente ejemplo ilustra cómo insertar un registro en la tabla DEPT.

Requisitos

  • Mediante la hoja de trabajo de la página SQL, cree una tabla DEPT. 

    CREATE TABLE DEPT(  
  DEPTNO     number(2,0),  
  DNAME      varchar2(14),  
  LOC        varchar2(13),  
  CONSTRAINT PK_DEPT PRIMARY KEY (DEPTNO)  
)

  • Cree un módulo denominado ejemplo. Consulte Creación de un módulo de recursos

  • Cree una plantilla denominada emp/ para el módulo. Consulte Creación de una plantilla de recursos

Para insertar un registro:
  1. En la página Manejadores, haga clic en Crear manejador.
  2. Introduzca los siguientes detalles:

    • En el campo Method (Método), seleccione POST (POST).

    • En el campo Tipo de origen, seleccione PL/SQL.

    • En el campo Origen, introduzca el siguiente bloque PL/SQL: 

      DECLARE  
   id number;
BEGIN
    INSERT INTO DEPT (DEPTNO, DNAME, LOC) VALUES (:DEPTNO, :DEPTNAME, :DEPTLOC) RETURNING DEPTNO INTO id;
    :status_code := 201;
    :forward_location := id;
END;

      donde

      • RETURNING DEPTNO INTO id devuelve el valor asignado a DEPTNO en la variable id.

      • :status_code es un parámetro implícito que se asigna a 201 para indicar que se ha creado el recurso.

      • :forward_location es un parámetro implícito al que se le asigna el valor id que contiene el valor DEPTNO. Este parámetro especifica la ubicación para reenviar una solicitud GET para producir la respuesta para la solicitud POST.

    • Asegúrese de que la opción Ir a la página Manejador después de la creación está seleccionada.

    • En el separador MIME Allowed (MIMEs permitidos), seleccione application/json (aplicación/json) en la lista desplegable y haga clic en Add + (Agregar).

    • Haga clic en Create.

    Aparece la página Handler POST.

    Puede probar el código fuente haciendo clic en Ejecutar sentencia Ejecutar sentencia en el separador Origen.

  3. Cree un manejador de recursos GET para producir una respuesta para la solicitud POST.

    En el módulo de ejemplo, cree una plantilla denominada emp/:id.

    Cree un manejador de recursos GET donde Source Type (Tipo de origen) sea Collection Item (Elemento de recopilación) y Source (Origen) contenga la siguiente consulta: 

    SELECT * FROM DEPT WHERE DEPTNO = :id
  4. Pruebe el punto final del servicio RESTful con el siguiente comando en cURL. Puede copiar la URL (http://xyz.us.comp.com:1234/ords/pdbdba/example/emp) mediante el icono Copiar en portapapeles en la tarjeta de controlador POST de la parte superior.
    curl --location --request POST --header "Content-Type: application/json" 
--data '{"DEPTNO": 54, "DEPTNAME": "HR", "DEPTLOC": "America" }' 'http://xyz.us.comp.com:1234/ords/pdbdba/example/emp/'

    La salida es: 

    {"deptno":54,"dname":"HR","loc":"America","links":[{"rel":"collection",
"href":"xyz.us.comp.com:1234/ords/pdbdba/example/emp/"}]}
  5. En la página SQL, compruebe la tabla DEPT para ver si el nuevo registro se ha insertado mediante la siguiente sentencia:
    SELECT * FROM DEPT;

Tema principal: Creación de servicios web RESTful