draft-ietf-regext-rdap-sorting-and-paging-19.txt   draft-ietf-regext-rdap-sorting-and-paging-20.txt 
Registration Protocols Extensions M. Loffredo Registration Protocols Extensions M. Loffredo
Internet-Draft M. Martinelli Internet-Draft M. Martinelli
Intended status: Standards Track IIT-CNR/Registro.it Intended status: Standards Track IIT-CNR/Registro.it
Expires: April 7, 2021 S. Hollenbeck Expires: June 3, 2021 S. Hollenbeck
Verisign Labs Verisign Labs
October 4, 2020 November 30, 2020
Registration Data Access Protocol (RDAP) Query Parameters for Result Registration Data Access Protocol (RDAP) Query Parameters for Result
Sorting and Paging Sorting and Paging
draft-ietf-regext-rdap-sorting-and-paging-19 draft-ietf-regext-rdap-sorting-and-paging-20
Abstract Abstract
The Registration Data Access Protocol (RDAP) does not include core The Registration Data Access Protocol (RDAP) does not include core
functionality for clients to provide sorting and paging parameters functionality for clients to provide sorting and paging parameters
for control of large result sets. This omission can lead to for control of large result sets. This omission can lead to
unpredictable server processing of queries and client processing of unpredictable server processing of queries and client processing of
responses. This unpredictability can be greatly reduced if clients responses. This unpredictability can be greatly reduced if clients
can provide servers with their preferences for managing large can provide servers with their preferences for managing large
responses. This document describes RDAP query extensions that allow responses. This document describes RDAP query extensions that allow
skipping to change at page 1, line 41 skipping to change at page 1, line 41
Internet-Drafts are working documents of the Internet Engineering Internet-Drafts are working documents of the Internet Engineering
Task Force (IETF). Note that other groups may also distribute Task Force (IETF). Note that other groups may also distribute
working documents as Internet-Drafts. The list of current Internet- working documents as Internet-Drafts. The list of current Internet-
Drafts is at https://datatracker.ietf.org/drafts/current/. Drafts is at https://datatracker.ietf.org/drafts/current/.
Internet-Drafts are draft documents valid for a maximum of six months Internet-Drafts are draft documents valid for a maximum of six months
and may be updated, replaced, or obsoleted by other documents at any and may be updated, replaced, or obsoleted by other documents at any
time. It is inappropriate to use Internet-Drafts as reference time. It is inappropriate to use Internet-Drafts as reference
material or to cite them other than as "work in progress." material or to cite them other than as "work in progress."
This Internet-Draft will expire on April 7, 2021. This Internet-Draft will expire on June 3, 2021.
Copyright Notice Copyright Notice
Copyright (c) 2020 IETF Trust and the persons identified as the Copyright (c) 2020 IETF Trust and the persons identified as the
document authors. All rights reserved. document authors. All rights reserved.
This document is subject to BCP 78 and the IETF Trust's Legal This document is subject to BCP 78 and the IETF Trust's Legal
Provisions Relating to IETF Documents Provisions Relating to IETF Documents
(https://trustee.ietf.org/license-info) in effect on the date of (https://trustee.ietf.org/license-info) in effect on the date of
publication of this document. Please review these documents publication of this document. Please review these documents
skipping to change at page 22, line 38 skipping to change at page 22, line 38
pagination.html>. pagination.html>.
[GOESSNER-JSON-PATH] [GOESSNER-JSON-PATH]
Goessner, S., "JSONPath - XPath for JSON", 2007, Goessner, S., "JSONPath - XPath for JSON", 2007,
<http://goessner.net/articles/JsonPath/>. <http://goessner.net/articles/JsonPath/>.
[HATEOAS] Jedrzejewski, B., "HATEOAS - a simple explanation", 2018, [HATEOAS] Jedrzejewski, B., "HATEOAS - a simple explanation", 2018,
<https://www.e4developer.com/2018/02/16/hateoas-simple- <https://www.e4developer.com/2018/02/16/hateoas-simple-
explanation/>. explanation/>.
[JSONPATH-COMPARISON]
"JSONPath Comparison", 2020,
<https://cburgmer.github.io/json-path-comparison/>.
[JSONPATH-WG]
"JSON Path (jsonpath)", 2020,
<https://datatracker.ietf.org/wg/jsonpath/documents/>.
[OData-Part1] [OData-Part1]
Pizzo, M., Handl, R., and M. Zurmuehl, "OData Version 4.0. Pizzo, M., Handl, R., and M. Zurmuehl, "OData Version 4.0.
Part 1: Protocol Plus Errata 03", June 2016, Part 1: Protocol Plus Errata 03", June 2016,
<http://docs.oasis- <http://docs.oasis-
open.org/odata/odata/v4.0/errata03/os/complete/part1- open.org/odata/odata/v4.0/errata03/os/complete/part1-
protocol/odata-v4.0-errata03-os-part1-protocol- protocol/odata-v4.0-errata03-os-part1-protocol-
complete.pdf>. complete.pdf>.
[REST] Fielding, R., "Architectural Styles and the Design of [REST] Fielding, R., "Architectural Styles and the Design of
Network-based Software Architectures", 2000, Network-based Software Architectures", 2000,
skipping to change at page 24, line 5 skipping to change at page 23, line 49
Additionally, the specification permits implementations to support Additionally, the specification permits implementations to support
arbitrary script expressions. These can be used to index into an arbitrary script expressions. These can be used to index into an
object or array, or to filter elements from an array. While script object or array, or to filter elements from an array. While script
expression behavior is implementation-defined, most implementations expression behavior is implementation-defined, most implementations
support the basic relational and logical operators, as well as both support the basic relational and logical operators, as well as both
object member and array item access, sufficiently similar for the object member and array item access, sufficiently similar for the
purpose of this document. Commonly-supported operators/functions purpose of this document. Commonly-supported operators/functions
divided into "top-level operators" and "filter operators" are divided into "top-level operators" and "filter operators" are
documented in Table 2 and Table 3 respectively. documented in Table 2 and Table 3 respectively.
For more information on implementation interoperability issues, see
[JSONPATH-COMPARISON]. As at the time of writing, work is beginning
on a standardization effort, too: see [JSONPATH-WG].
+-------------------+-----------------------------------------+ +-------------------+-----------------------------------------+
| Operator | Description | | Operator | Description |
+-------------------+-----------------------------------------+ +-------------------+-----------------------------------------+
| $ | Root element | | $ | Root element |
| .<name> | Object member access (dot-notation) | | .<name> | Object member access (dot-notation) |
| ['<name>'] | Object member access (bracket-notation) | | ['<name>'] | Object member access (bracket-notation) |
| [<number>] | Array item access | | [<number>] | Array item access |
| * | All elements within the specified scope | | * | All elements within the specified scope |
| [?(<expression>)] | Filter expression | | [?(<expression>)] | Filter expression |
+-------------------+-----------------------------------------+ +-------------------+-----------------------------------------+
skipping to change at page 31, line 5 skipping to change at page 31, line 5
* added JSONPath union operator in Table 2 of "Appendix B" * added JSONPath union operator in Table 2 of "Appendix B"
* changed the explanation of offset and limit operators in * changed the explanation of offset and limit operators in
"Appendix B"; "Appendix B";
* converted the figures containing only RDAP queries into texts; * converted the figures containing only RDAP queries into texts;
* changed the wildcard prefixed patterns into wildcard suffixed * changed the wildcard prefixed patterns into wildcard suffixed
in all the RDAP queries; in all the RDAP queries;
* cleaned the text. * cleaned the text.
19: Replaced the words "encryption/encrypt" with "obfuscation/ 19: Replaced the words "encryption/encrypt" with "obfuscation/
obfuscate" in the ""cursor" Parameter" section. obfuscate" in the ""cursor" Parameter" section.
20: Added a final paragraph to Appendix A to reference the
comparison between JSONPath operators and IETF JSONPath WG web
site.
Authors' Addresses Authors' Addresses
Mario Loffredo Mario Loffredo
IIT-CNR/Registro.it IIT-CNR/Registro.it
Via Moruzzi,1 Via Moruzzi,1
Pisa 56124 Pisa 56124
IT IT
Email: mario.loffredo@iit.cnr.it Email: mario.loffredo@iit.cnr.it
URI: http://www.iit.cnr.it URI: http://www.iit.cnr.it
 End of changes. 7 change blocks. 
4 lines changed or deleted 20 lines changed or added

This html diff was produced by rfcdiff 1.48. The latest version is available from http://tools.ietf.org/tools/rfcdiff/