Terminologia dei servizi RESTful

Di seguito sono riportati alcuni termini principali relativi ai servizi RESTful.

  • Servizio RESTful: servizio Web HTTP conforme ai principi dello stile di architettura RESTful.

  • Modulo risorse: unità organizzativa utilizzata per raggruppare i modelli di risorse correlati.

  • Modello di risorsa: un singolo servizio RESTful in grado di soddisfare le richieste per alcuni set di URI (Universal Resource Identifiers). Il set di URI è definito dal pattern URI del modello di risorsa

  • Modello URI: un pattern per il modello di risorsa. Può essere un pattern di instradamento o un modello URI, anche se si consiglia di utilizzare i pattern di instradamento.

    • Modello di instradamento: un pattern incentrato sulla scomposizione della parte di percorso di un URI nelle relative parti componente. 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 di 101) e corrisponderà anche a /objects/emp/ (corrisponde a una richiesta per la risorsa emp, poiché il parametro :id viene annotato con il modificatore ?, che indica che il parametro id è facoltativo).

    • Modello URI: una grammatica semplice che definisce i pattern specifici degli URI che un determinato modello di risorsa può gestire. Ad esempio, il pattern employees/{id} corrisponderà a qualsiasi URI il cui percorso inizia con employees/, ad esempio employees/2560.

  • Handler risorse: fornisce la logica necessaria per il servizio di un metodo HTTP specifico per un modello di risorsa specifico. Ad esempio, la logica del metodo HTTP GET per il modello di risorsa precedente potrebbe essere:

    select empno, ename, dept from emp where empno = :id
    
  • Operazione HTTP: HTTP (HyperText Transport Protocol) definisce i metodi standard supportati in Oracle REST Data Services per la creazione dei servizi RESTful: GET (recuperare il contenuto della risorsa), POST (negoziare una nuova risorsa), PUT (aggiornare una risorsa esistente) e DELETE (rimuovere una risorsa).