Creazione di servizi Web RESTful

Creare servizi Web RESTful utilizzando le pagine Moduli, Modelli e Handler.

Per creare un servizio Web RESTful, è necessario:

  • Definisce un modulo di risorse

  • Definire un modello di risorsa

  • Definire uno o più gestori di risorse, ad esempio GET, PUT, POST o DELETE. Facoltativamente, definire i parametri da passare all'handler di risorse.

Le sezioni seguenti forniscono informazioni su come creare moduli di risorse, modelli di risorse e gestori di risorse.

Vedere anche:

Argomento padre: Pagine REST

Gestione dei moduli delle risorse

È possibile definire, modificare ed eliminare i moduli risorsa nella pagina Moduli.

Per andare alla pagina Moduli, nella pagina Panoramica REST fare clic su Moduli in Oggetti oppure selezionare Moduli dal menu nell'intestazione.

Nella figura seguente sono riportati gli attributi del modulo visualizzati per impostazione predefinita nella vista Scheda.

Segue la descrizione di module_card.png
Descrizione dell'immagine module_card.png

Lo stato del modulo può essere pubblicato o annullato. Se lo stato non viene pubblicato, l'icona viene visualizzata in rosso.

Fare clic sul nome del modulo nella vista scheda per andare alla pagina Modelli per il modulo. È inoltre possibile accedere alla pagina Modelli mediante il menu di scelta rapida.

Le azioni disponibili nel menu di scelta rapida sono le seguenti:

Vedere anche:

Informazioni sulla barra degli strumenti di ricerca REST

Argomento padre: Creazione di servizi Web RESTful

Creazione di un modulo risorsa

In questa sezione viene descritto come creare un modulo di risorse.

  1. Nella pagina Moduli fare clic su Crea modulo.
  2. Immettere i campi seguenti. I campi contrassegnati con un asterisco (*) sono obbligatori:

    Scheda Definizione modulo

    • Nome modulo: immettere il nome del modulo. Questo campo distingue tra maiuscole e minuscole.

    • Percorso base: immettere la base dell'URI per accedere al servizio RESTful. Ad esempio: hr/ significa che tutti gli URI che iniziano con hr/ saranno serviti da questo modulo di risorse. Tenere presente la modifica apportata nell'URL anteprima quando si immette il percorso di base.

    • È pubblicato: abilitare l'opzione per rendere il servizio RESTful disponibile per l'uso.

    • Dimensione impaginazione: immettere o selezionare il numero di risultati da restituire in ogni pagina in base a una query di database. Il valore predefinito è 25 minuti.

    • Protesso da privilegio: selezionare un privilegio per proteggere il modulo dall'elenco a discesa.

    • Commenti: immettere commenti descrittivi.

    • Vai al modulo dopo la creazione: selezionare questa opzione per passare alla pagina Modelli dopo la creazione del modulo.

    Scheda Origini consentite

    • Immettere le origini autorizzate ad accedere ai modelli di risorsa. Fare clic su Aggiungi (+) per aggiungere ogni origine. Ad esempio:

      http://example1.org

      https://*.example2.com

    Mostra codice: selezionare questa opzione per visualizzare l'equivalente codice PL/SQL del dispositivo di scorrimento Crea modulo. È possibile copiare ed eseguire questo codice PL/SQL nel foglio di lavoro per eseguire la stessa azione che si verifica quando si fa clic su Crea nel dispositivo di scorrimento Crea modulo.

  3. Fare clic su Crea.

    Il nuovo modulo viene visualizzato nella pagina Moduli. Se non è possibile visualizzarlo, individuare il modulo utilizzando il campo Cerca.

Argomento padre: Gestione dei moduli risorsa

Importazione di un modulo risorse

In questa sezione viene descritto come importare un modulo risorsa.

Nota

È possibile importare un documento OpenAPI versione 2.0 o 3.0 solo in formato JSON.
  1. Nella pagina Moduli in alto a destra, fare clic su Importa modulo.
  2. Sfoglia e seleziona il file JSON da importare. Fare clic su Apri.

    Il dispositivo di scorrimento Importa modulo viene visualizzato con i campi Percorso base e URL anteprima precompilati. Modificare il percorso di base in base alle esigenze. La modifica del campo del percorso di base aggiornerà anche il percorso di base nel formato JSON visualizzato nel dispositivo di scorrimento.

  3. Fare clic su Importa.

    Quando il modulo viene importato, viene creata e impostata una configurazione dei privilegi per proteggere il modulo. Il nome del privilegio viene generato utilizzando il percorso di base e aggiungendo "_priv" alla fine della stringa del percorso di base e sostituendo anche ogni barra "/" nel percorso di base al carattere di sottolineatura "_".

  4. Il modulo è pronto per la modifica.

    Dopo l'importazione del modulo, vengono creati i modelli e gli handler, ma il modulo non viene pubblicato. È necessario fornire blocchi SQL e PL/SQL per ogni handler e pubblicare il modulo quando è pronto per il test o la produzione.

Argomento padre: Gestione dei moduli risorsa

Modifica di un modulo risorsa

In questa sezione viene descritto come modificare un modulo risorse.

  1. Nella pagina Moduli fare clic su icona menu di scelta veloce per il modulo specifico e selezionare Modifica.
  2. Modificare i campi obbligatori e fare clic su Salva. Per una descrizione dei campi, vedere Creazione di un modulo risorsa.

Argomento padre: Gestione dei moduli risorsa

Eliminazione di un modulo risorsa

In questa sezione viene descritto come eliminare un modulo risorsa.

  1. Nella pagina Moduli fare clic su menu di scelta rapida per il modulo specifico e selezionare Elimina.

    Viene visualizzata una richiesta di conferma.

  2. Fare clic su OK per eliminarlo.

Argomento padre: Gestione dei moduli risorsa

Pubblicazione/annullamento della pubblicazione di un modulo risorse

In questa sezione viene descritto come rendere disponibile o meno un modulo risorsa.

  1. Nella pagina Moduli, per il modulo specifico, fare clic su menu di scelta rapida, quindi selezionare Pubblica o Annulla pubblicazione.

    Viene visualizzato un prompt di conferma.

  2. Fare clic su OK.

Argomento padre: Gestione dei moduli risorsa

Esportazione di un modulo risorsa

È possibile esportare il codice sorgente PL/SQL per il codice JSON API o Open API (Swagger) per un modulo di risorse o un servizio RESTful. Se nel modulo sono presenti modelli, handler, parametri, ruoli e così via, anche questi oggetti vengono visualizzati ed esportati.

  1. Nella pagina Moduli fare clic su menu di scelta rapida per un modulo specifico e selezionare Esporta modulo.
  2. Selezionare PL/SQL per copiare o esportare l'origine PL/SQL per l'API. Selezionare OpenAPI per copiare o esportare il codice JSON Open API (Swagger) per il modulo.

    Nota

    Un modulo esportato utilizzando Open API viene sempre importato con uno stato non pubblicato.
  3. Fare clic su Copia negli Appunti per copiare il codice oppure fare clic su Scarica per scaricarlo nel computer locale.

Argomento padre: Gestione dei moduli risorsa

Visualizzazione del modulo nella vista OpenAPI

In questa sezione viene descritto come aprire il modulo nella vista Open API.

L'opzione di visualizzazione Open API è disponibile per i moduli pubblicati e non protetti.
  1. Nella pagina Moduli fare clic su menu di scelta rapida per il modulo specifico e selezionare Vista OpenAPI.
  2. Il modulo viene visualizzato come implementazione dell'interfaccia utente Swagger.
    È possibile visualizzare ed eseguire gli handler, passare i parametri agli handler e copiare o scaricare le risposte.

    Per ulteriori informazioni sull'implementazione dell'interfaccia utente Swagger, consultare il sito Web ufficiale dell'interfaccia utente Swagger.

Argomento padre: Gestione dei moduli risorsa

Gestione dei modelli di risorsa

È possibile definire, modificare ed eliminare i modelli di risorsa per un modulo nella pagina Modelli.

Per accedere a questa pagina, nella pagina Moduli fare clic su menu di scelta rapida per un modulo e selezionare Modelli oppure fare clic sul nome del modulo nella vista Scheda.

Nella parte superiore della pagina, la scheda del modulo è disponibile con opzioni di menu di scelta rapida come Modifica, Elimina, Pubblica ed Esporta.

Nella figura seguente sono riportati gli attributi dei modelli visualizzati per impostazione predefinita nella vista Scheda.

Segue la descrizione di template_card.png
Descrizione dell'immagine template_card.png

Fare clic sul nome del modello nella vista Scheda per passare alla pagina Handler. È anche possibile andare alla pagina Handler tramite il menu di scelta rapida.

Le azioni disponibili nel menu di scelta rapida sono le seguenti:

Argomento padre: Creazione di servizi Web RESTful

Creazione di un modello di risorsa

In questa sezione viene descritto come creare un modello di risorsa.

  1. Nella pagina Modelli di un modulo, fare clic su Crea modello.
  2. Immettere i campi seguenti. I campi con un asterisco (*) indicano che sono obbligatori:

    • Modello URI: immettere il pattern URI per il modello di risorsa.

      Ad esempio, un pattern di /objects/:object/:id? corrisponderà a /objects/emp/101 (corrisponde a una richiesta per l'elemento nella risorsa emp con ID 101) e corrisponderà anche a /objects/emp/ (corrisponde a una richiesta per la risorsa emp, poiché il parametro :id è annotato con il modificatore ?, che indica che il parametro id è facoltativo).

      Tenere presente che l'URL anteprima cambia durante la digitazione del modello URI.

    • Priorità: immettere o scegliere la priorità per la modalità di valutazione del modello di risorsa (1 ha priorità bassa e 9 ha priorità alta).

    • Tipo di tag entità HTTP: selezionare il tipo di tag entità da utilizzare nel modello di risorsa. Una tag entità è un'intestazione HTTP che funge da identificativo di versione per una risorsa.

      Le opzioni disponibili sono le seguenti.

      • HASH sicuro (predefinito): viene eseguito l'hashing del contenuto della rappresentazione delle risorse restituita utilizzando una funzione digest sicura per fornire un'impronta digitale univoca per una data versione delle risorse.

      • Query: definire manualmente una query che identifica in modo univoco una versione della risorsa. Una query definita manualmente può spesso generare un tag entità in modo più efficiente rispetto all'hashing dell'intera rappresentazione delle risorse.

      • Nessuno: non generare un tag entità.

    • Commenti: inserire eventuali commenti descrittivi.

    • Vai agli handler dopo la creazione: selezionare questa opzione per passare alla pagina Handler dopo la creazione del modello.

    Mostra codice: selezionare questa opzione per visualizzare l'equivalente codice PL/SQL del dispositivo di scorrimento Crea modello. È possibile copiare ed eseguire questo codice PL/SQL nel foglio di lavoro per eseguire la stessa azione che si verifica quando si fa clic su Crea nel dispositivo di scorrimento Crea modello.

  3. Fare clic su Crea.

    Il nuovo modello per il modulo viene aggiunto alla pagina Modelli.

    Se si seleziona "Vai agli handler dopo la creazione", è possibile utilizzare il nome del modulo negli indicatori di percorso nella parte superiore della pagina per visualizzare l'elenco dei modelli per il modulo.

Argomento padre: Gestione dei modelli di risorsa

Modifica di un modello di risorsa

In questa sezione viene descritto come modificare un modello di risorsa.

  1. Nella pagina Modelli, per un modello specifico, fare clic su menu di scelta rapida, quindi selezionare Modifica.
  2. Modificare i campi obbligatori e fare clic su Salva.

    Per una descrizione dei campi, vedere Creazione di un modello di risorsa.

Argomento padre: Gestione dei modelli di risorsa

Eliminazione di un modello di risorsa

In questa sezione viene descritto come eliminare un modello di risorsa.

  1. Nella pagina Modelli, per un modello specifico, fare clic su menu di scelta rapida, quindi selezionare Elimina.

    Viene richiesto di confermare.

  2. Fare clic su OK per eliminarlo.

Argomento padre: Gestione dei modelli di risorsa

Gestione dei gestori delle risorse

È possibile creare, modificare ed eliminare gli handler di risorse per un modello nella pagina Handler.

Per passare a questa pagina, nella pagina Modelli fare clic su menu di scelta rapida per un modello e selezionare Fattori gestionali oppure fare clic sul nome del modello nella vista scheda.

Nella parte superiore della pagina, la scheda modello è disponibile con opzioni di menu contestuale quali Modifica ed Elimina.

Gli attributi dell'handler visualizzati per impostazione predefinita nella vista scheda sono visualizzati nella figura seguente.

Segue la descrizione di handler_card.png
Descrizione dell'immagine handler_card.png

Il metodo HTTP può essere uno dei seguenti: GET, PUT, POST e DELETE.

È possibile passare alla pagina del metodo HTTP utilizzando il menu di scelta rapida. Nella pagina del metodo HTTP sono visualizzate tre schede: Origine, Parametri e Richieste preautenticate.

Per creare un handler di risorse, vedere Creazione di un handler di risorse.

Nota

Questa opzione non è disponibile se nel modello sono stati creati tutti e quattro i gestori (GET, POST, PUT, DELETE).

Le azioni disponibili nel menu di scelta rapida sono le seguenti:

Argomento padre: Creazione di servizi Web RESTful

Creazione di un handler di risorse

In questa sezione viene descritto come creare un handler di risorse.

  1. Nella pagina Handler, fare clic su Crea handler.
  2. Specificare le proprietà del gestore risorse. Le opzioni specifiche dipendono dal tipo di metodo.

    Scheda Definizione handler

    • Metodo: immettere il metodo HTTP per la richiesta di questo handler: GET (recupera la rappresentazione di una risorsa), POST (crea una nuova risorsa o aggiunge una risorsa a una raccolta), PUT (aggiorna una risorsa esistente) o DELETE (elimina una risorsa esistente) È consentito un solo handler per ogni metodo HTTP.

    • Elementi per pagina: immettere o scegliere la dimensione di impaginazione predefinita oppure il numero di righe da restituire per una query di database. Questa opzione è disponibile solo per gli handler GET. Se questo valore non è definito, il numero di elementi per pagina è quello definito nel modulo.

    • Tipo di origine: selezionare l'implementazione di origine per il metodo HTTP selezionato. L'impostazione predefinita è la query di raccolta.

      • Query di raccolta: esegue una query SQL e trasforma il set di risultati in una rappresentazione JSON. Disponibile quando il metodo HTTP è GET.

      • Elemento di raccolta: esegue una query SQL che restituisce una riga di dati in una rappresentazione JSON. Disponibile quando il metodo HTTP è GET.

      • Media: esegue una query SQL conforme a un formato specifico e trasforma il set di risultati in una rappresentazione binary con un'intestazione Content-Type HTTP associata che identifica il tipo di supporto Internet della rappresentazione.

      • PL/SQL: esegue un blocco PL/SQL anonimo e trasforma qualsiasi parametro OUT o IN/OUT IN una rappresentazione JSON.

    • Origine: immettere la query SQL o il blocco PL/SQL per il metodo HTTP. Nella pagina dei dettagli dell'handler è possibile eseguire il test del codice dell'handler SQL o PL/SQL nell'editor di handler.

    • Vai all'handler dopo la creazione: selezionare questa opzione per andare alla pagina dei dettagli dopo la creazione dell'handler.

    Scheda MIME consentiti

    Identifica il tipo di informazioni incluse nel corpo della richiesta HTTP. Ad esempio, se l'handler POST prevede un JSON nella richiesta, aggiungere "Applicazione/JSON" come tipo MIME.

    Mostra codice: selezionare questa opzione per visualizzare l'equivalente codice PL/SQL del dispositivo di scorrimento Crea handler. È possibile copiare ed eseguire questo codice PL/SQL nel foglio di lavoro per eseguire la stessa azione che si verifica quando si fa clic su Crea nel dispositivo di scorrimento Crea handler.

  3. Fare clic su Crea.

    L'handler viene visualizzato nella pagina Handler per il modello specifico.

    È possibile eseguire il test dell'endpoint del servizio REST utilizzando un client REST o uno strumento della riga di comando, ad esempio cURL.

Vedere anche:

Informazioni su cURL e sul test dei servizi RESTful in Oracle REST Data Services Developer's Guide.

Argomento padre: Gestione degli handler di risorse

Modifica di un handler di risorse

In questa sezione viene descritto come modificare un handler di risorse.

  1. Nella pagina Handler, per un handler specifico, fare clic su menu di scelta rapida, quindi su Dettagli.
  2. Modificare i campi obbligatori e fare clic su Salva.

    Per una descrizione dei campi, vedere Creazione di un handler di risorse.

Argomento padre: Gestione degli handler di risorse

Eliminazione di un handler di risorse

In questa sezione viene descritto come eliminare un handler di risorse.

  1. Nella pagina Handler, per l'handler specifico, fare clic su menu di scelta rapida, quindi su Elimina.

    Viene richiesto di confermare.

  2. Fare clic su OK per eliminarlo.

Argomento padre: Gestione degli handler di risorse

Visualizzazione dei dettagli dell'handler delle risorse e gestione dei parametri

È possibile visualizzare i dettagli dell'handler di risorse e gestire i parametri nella pagina Metodo HTTP.

Per accedere a questa pagina, per un handler specifico, fare clic su menu di scelta rapida, quindi selezionare Dettagli o fare clic sul nome dell'handler nella vista scheda.

Nella parte superiore della pagina, la scheda handler è disponibile con opzioni di menu contestuale come Modifica ed Elimina.

La pagina Metodo HTTP dell'handler include due sezioni principali:

  • Editor di codice per l'esecuzione del codice sorgente SQL o PL/SQL definito nell'handler di risorse. È possibile eseguire il codice, salvare, annullare, ripetere, scaricare e cancellare l'output. Per ulteriori informazioni sull'editor, vedere Esecuzione di istruzioni SQL nell'editor di codice.

    I parametri impliciti utilizzati negli handler di servizi REST vengono visualizzati in un elenco a scorrimento verso il lato destro dell'editor. Vedere Parametri impliciti

  • Sezione per la gestione dei parametri necessari per l'esecuzione del metodo HTTP.

Per impostazione predefinita, i parametri vengono visualizzati nella vista griglia. Gli attributi visualizzati su un parametro nella vista Scheda sono mostrati nella figura seguente.

Segue la descrizione di parameter_card.png
Descrizione dell'immagine parameter_card.png

Le azioni disponibili nel menu di scelta rapida sono le seguenti:

Vedere anche:

Informazioni sulla barra degli strumenti di ricerca REST

Argomento padre: Gestione degli handler di risorse

Creazione di un parametro in corso

In questa sezione viene descritto come creare un parametro per un handler di risorse.

  1. Nella pagina Metodo HTTP dell'handler, fare clic su Crea parametro.
  2. Immettere i campi seguenti. I campi contrassegnati con un asterisco (*) sono obbligatori:

    • Nome parametro: immettere il nome del parametro, come indicato nel modello URI o nell'intestazione HTTP. Il nome definisce la modalità di identificazione del parametro nella richiesta in entrata o la modalità di denominazione del parametro nella risposta.

    • Nome variabile di associazione: immettere il nome del parametro, come verrà indicato in SQL. Se si specifica NULL, il parametro non viene associato.

    • Tipo di origine: selezionare il tipo identificato se il parametro ha origine nel modello URI o nell'intestazione HTTP.

    • Tipo di parametro: selezionare il tipo nativo del parametro.

    • Metodo di accesso: selezionare il metodo di accesso ai parametri. Indica se il parametro è un valore di input, un valore di output o entrambi i campi.

    Mostra codice: selezionare questa opzione per visualizzare l'equivalente codice PL/SQL del dispositivo di scorrimento Crea parametro. È possibile copiare ed eseguire questo codice PL/SQL nel foglio di lavoro per eseguire la stessa azione che si verifica quando si fa clic su Crea nel dispositivo di scorrimento Crea parametro.

  3. Fare clic su Crea.

    Il parametro viene aggiunto nella sezione Parametri.

Modifica di un parametro

In questa sezione viene descritto come modificare un parametro.

  1. Nella sezione Parametri fare clic su menu di scelta rapida per il parametro specifico, quindi selezionare Modifica.
  2. Modificare i campi obbligatori e fare clic su Salva.

    Per una descrizione dei campi, vedere Creazione di un parametro.

Eliminazione di un parametro

In questa sezione viene descritto come eliminare un parametro.

  1. Nella sezione Parametri fare clic su menu di scelta rapida per il parametro specifico, quindi selezionare Elimina.

    Viene richiesto di confermare.

  2. Fare clic su Sì per eliminarla.
Parametri impliciti

Questa sezione descrive i parametri impliciti nella pagina Dettagli handler risorse. Questi parametri vengono aggiunti automaticamente agli handler di risorse.

Tabella 4-1 Parametri impliciti

Nome Type Modalità di accesso Intestazione HTTP Descrizione

:body

BLOB

In

ND

Specifica il corpo della richiesta come BLOB temporaneo.

:body_text

CLOB

In

ND

Specifica il corpo della richiesta come CLOB temporaneo.

:content_type

VARCHAR

In

Content-Type

Specifica il tipo MIME del corpo della richiesta, come indicato dall'intestazione della richiesta Content-Type.

:current_user

VARCHAR

In

ND

Specifica l'utente autenticato per la richiesta. Se nessun utente viene autenticato, il valore viene impostato su null.

:forward_location

VARCHAR

OUT

X-ORDS-FORWARD-LOCATION

Specifica la posizione in cui Oracle REST Data Services deve inoltrare una richiesta GET per produrre la risposta per questa richiesta.

:fetch_offset

NUMBER

In

ND

Specifica l'offset basato su zero della prima riga da visualizzare in una pagina.

:fetch_size

NUMBER

In

ND

Specifica il numero massimo di righe da recuperare in una pagina.

:page_offset

NUMBER

In

ND

Specifica l'offset di pagina basato su zero in una richiesta impaginata.

Nota: il parametro The :page_offset non è più valido. Utilizzare invece il parametro :row_offset.

:page_size

NUMBER

In

ND

Specifica il numero massimo di righe da recuperare in una pagina.

Il parametro :page_size non è più valido. Utilizzare invece :fetch_size parameter .

:row_offset

NUMBER

In

ND

Specifica l'indice basato su una della prima riga da visualizzare in una richiesta impaginata.

:row_count

NUMBER

In

ND

Specifica l'indice basato su una dell'ultima riga da visualizzare in una richiesta impaginata.

:status_code

NUMBER

OUT

X-ORDS-STATUS-CODE

Specifica il codice di stato HTTP per la richiesta.

Per ulteriori informazioni sui parametri impliciti, vedere Oracle REST Data Services Developer's Guide.

Utilizzo di richieste preautenticate per accedere ai servizi RESTful ORDS

Per accedere ai servizi RESTful protetti, è possibile creare e revocare le richieste preautenticate.

Le richieste preautenticate consentono di accedere ai servizi ORDS RESTful protetti senza credenziali utente. Quando si crea una richiesta preautenticata, viene generato un URL univoco. È possibile fornire questo URL a un utente esterno per interagire con la particolare entità RESTful utilizzando gli strumenti HTTP standard.

Per ulteriori informazioni sulle richieste preautenticate, vedere Richieste preautenticate di Oracle REST Data Services nel manuale Oracle REST Data Services Developer's Guide.

Per andare alla pagina Richieste preautenticate, è possibile effettuare una delle operazioni riportate di seguito.

  • Nella pagina Panoramica, fare clic sulla casella Richieste preautenticate.

  • Nella barra dei menu espandere Sicurezza e selezionare Richieste preautenticate.

Argomenti:

Argomento padre: Gestione degli handler di risorse

Creazione di una richiesta preautenticata

Per creare una richiesta preautenticata per un handler esistente:

  1. Dal menu di scelta rapida per un handler esistente, selezionare Crea nuova richiesta preautenticata.

    Viene visualizzato il pannello Crea richiesta preautenticata.

  2. Nel campo Scadenza token immettere la durata di scadenza del token in secondi.

    Selezionare Mostra codice per visualizzare il codice di origine di base per la creazione della richiesta preautenticata.

    Fare clic su Crea.

    Vengono visualizzati il token, l'alias e il collegamento relativo per accedere alla risorsa. È necessario tenere traccia del token e dell'alias in quanto non è possibile ottenerne i valori in un secondo momento. Se si dimenticano i valori, è possibile revocare il token e crearne uno nuovo.

Visualizzazione di una richiesta preautenticata

Dal menu di scelta rapida per un handler esistente, selezionare Richieste preautenticate, quindi selezionare Dettagli.

Vengono visualizzate le richieste preautenicate per l'handler specifico.

Revoca di una richiesta preautenticata

Per revocare la richiesta preautenticata per un handler:

  1. Dal menu di scelta rapida per un handler esistente, selezionare Richieste preautenticate, quindi selezionare Dettagli.

    Vengono visualizzate le richieste preautenticate per l'handler specifico.

  2. Nel menu di scelta rapida della richiesta preautenticata, selezionare Revoca.

    Viene richiesto di confermare.

  3. Fare clic su Conferma per revocare la richiesta.

Esempio: inserimento di un record mediante un handler POST

Nell'esempio seguente viene illustrato come inserire un record nella tabella DEPT.

Prerequisiti

  • Utilizzando il foglio di lavoro nella pagina SQL, creare una tabella DEPT. 

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

  • Creare un modulo denominato esempio. Vedere Creazione di un modulo risorsa

  • Creare un modello denominato emp/ per il modulo. Vedere Creazione di un modello di risorsa

Per inserire un record:
  1. Nella pagina Handler, fare clic su Crea handler.
  2. Immettere i dettagli riportati di seguito.

    • Nel campo Metodo, selezionare POST.

    • Nel campo Tipo di origine selezionare PL/SQL.

    • Nel campo Origine immettere il blocco PL/SQL seguente: 

      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;

      dove

      • RETURNING DEPTNO INTO id restituisce il valore assegnato a DEPTNO nella variabile id.

      • :status_code è un parametro implicito assegnato al 201 per indicare che la risorsa è stata creata.

      • :forward_location è un parametro implicito a cui viene assegnato il valore id che contiene il valore DEPTNO. Questo parametro specifica la posizione in cui inoltrare una richiesta GET per produrre la risposta per la richiesta POST.

    • Assicurarsi che sia selezionata l'opzione Vai alla pagina Handler dopo la creazione.

    • Nella scheda MIME consentiti selezionare application/json dall'elenco a discesa e fare clic su Add +.

    • Fare clic su Crea.

    Viene visualizzata la pagina Handler POST.

    È possibile eseguire il test del codice sorgente facendo clic su Esegui istruzione Esegui istruzione nella scheda Origine.

  3. Creare un handler di risorse GET per produrre una risposta per la richiesta POST.

    Nel modulo Esempio, creare un modello denominato emp/:id.

    Creare un handler di risorse GET in cui Tipo di origine è Elemento raccolta e Origine contiene la query seguente: 

    SELECT * FROM DEPT WHERE DEPTNO = :id
  4. Eseguire il test dell'endpoint del servizio RESTful utilizzando il comando seguente in cURL. È possibile copiare l'URL (http://xyz.us.comp.com:1234/ords/pdbdba/example/emp) utilizzando l'icona Copia negli Appunti nella scheda handler POST nella parte superiore.
    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/'

    Di seguito è riportato l'output: 

    {"deptno":54,"dname":"HR","loc":"America","links":[{"rel":"collection",
"href":"xyz.us.comp.com:1234/ords/pdbdba/example/emp/"}]}
  5. Nella pagina SQL, controllare la tabella DEPT per verificare se il nuovo record è stato inserito utilizzando l'istruzione seguente:
    SELECT * FROM DEPT;

Argomento padre: Creazione di servizi Web RESTful