- From: Melvin Carvalho <melvincarvalho@gmail.com>
- Date: Tue, 30 Jun 2015 19:21:34 +0200
- To: public-rww <public-rww@w3.org>
- Message-ID: <CAKaEYh+rbZ2DfLmCGEKw3je9zu96qtVbS2urTFXisEau69Hfgg@mail.gmail.com>
This specification provides a widely re-usable pattern to make the state of a large paged HTTP resource <http://www.w3.org/TR/2015/NOTE-ldp-paging-20150630/#dfn-paged-resource> available as a list of smaller subset resources (pages <http://www.w3.org/TR/2015/NOTE-ldp-paging-20150630/#dfn-in-sequence-page-resource>) whose representations are less burdensome for servers to form. Paged resources <http://www.w3.org/TR/2015/NOTE-ldp-paging-20150630/#dfn-paged-resource> must be LDP Resources (LDPRs) [LDP <http://www.w3.org/TR/2015/NOTE-ldp-paging-20150630/#bib-LDP>]. Any LDPR can be paged, but certain aspects of paging like ordering are only well-defined for particular sub-classes of LDPRs, like LDP-RSs or LDPCs. When a client attempts to retrieve a paged resource <http://www.w3.org/TR/2015/NOTE-ldp-paging-20150630/#dfn-paged-resource>, the server either redirects the client to a "first page" resource <http://www.w3.org/TR/2015/NOTE-ldp-paging-20150630/#dfn-in-sequence-page-resource> or provides the representation of the "first page" resource <http://www.w3.org/TR/2015/NOTE-ldp-paging-20150630/#dfn-in-sequence-page-resource> in its response, depending on the client's request preferences and the server's capabilities. The response includes links to other page(s) in the sequence, as do subsequent pages. Paging-aware clients <http://www.w3.org/TR/2015/NOTE-ldp-paging-20150630/#dfn-ldp-paging-client> know how to combine pages of an LDP-RS, and possibly (via other specifications) other LDPRs. LDP Paging defines a mechanism by which clients can learn that the paged resource <http://www.w3.org/TR/2015/NOTE-ldp-paging-20150630/#dfn-paged-resource> has been changed so that they can, for example, abandon a page traversal as early as possible. A detailed example of paging is provided in section 4. Example paging message exchanges <http://www.w3.org/TR/2015/NOTE-ldp-paging-20150630/#ldpp-ex-mx>. When a paged resource <http://www.w3.org/TR/2015/NOTE-ldp-paging-20150630/#dfn-paged-resource> is also an LDPC, some additional efficiencies become possible in cases where the server predictably assigns members to pages and is able to communicate its assignment algorithm to clients. The section 7. Linked Data Platform Containers <http://www.w3.org/TR/2015/NOTE-ldp-paging-20150630/#ldpc> defines a facility to communicate the sort order of member-to-page assignments, to handle that common implementation algorithm. For context and background, it could be useful to read Linked Data Platform Use Case and Requirements <http://www.w3.org/TR/2015/NOTE-ldp-paging-20150630/#bib-LDP-UCR> [LDP-UCR <http://www.w3.org/TR/2015/NOTE-ldp-paging-20150630/#bib-LDP-UCR>]. http://www.w3.org/TR/2015/NOTE-ldp-paging-20150630/
Received on Tuesday, 30 June 2015 17:22:05 UTC