Remove duplicate content.
Project: http://git-wip-us.apache.org/repos/asf/couchdb/repo Commit: http://git-wip-us.apache.org/repos/asf/couchdb/commit/a103e74f Tree: http://git-wip-us.apache.org/repos/asf/couchdb/tree/a103e74f Diff: http://git-wip-us.apache.org/repos/asf/couchdb/diff/a103e74f Branch: refs/heads/1781-reorganize-and-improve-docs Commit: a103e74fb7fcccaa8c84837699fb411dbd160e82 Parents: 71ec756 Author: Alexander Shorin <[email protected]> Authored: Sun Aug 25 17:30:35 2013 +0400 Committer: Alexander Shorin <[email protected]> Committed: Fri Sep 27 22:01:47 2013 +0400 ---------------------------------------------------------------------- share/doc/src/api/basics.rst | 65 ++------------------------------------- 1 file changed, 2 insertions(+), 63 deletions(-) ---------------------------------------------------------------------- http://git-wip-us.apache.org/repos/asf/couchdb/blob/a103e74f/share/doc/src/api/basics.rst ---------------------------------------------------------------------- diff --git a/share/doc/src/api/basics.rst b/share/doc/src/api/basics.rst index dd64257..74465b6 100644 --- a/share/doc/src/api/basics.rst +++ b/share/doc/src/api/basics.rst @@ -181,8 +181,8 @@ Request Headers .. code-block:: http - Server: CouchDB/|version| (Erlang OTP/R13B) - Date: Thu, 13 Jan 2011 13:40:11 GMT + Server: CouchDB/1.4.0 (Erlang OTP/R16B) + Date: Thu, 13 Jan 2013 13:40:11 GMT Content-Type: application/json Content-Length: 227 Cache-Control: must-revalidate @@ -589,64 +589,3 @@ corresponding API call reference. The request was invalid, either because the supplied JSON was invalid, or invalid information was supplied as part of the request. - -HTTP Range Requests -=================== - -HTTP allows you to specify byte ranges for requests. This allows the -implementation of resumable downloads and skippable audio and video -streams alike. This is available for all attachments inside CouchDB. - -This is just a real quick run through how this looks under the hood. -Usually, you will have larger binary files to serve from CouchDB, like -MP3s and videos, but to make things a little more obvious, I use a text -file here (Note that I use the ``application/octet-stream`` Content-Type -instead of ``text/plain``). - -.. code-block:: bash - - shell> cat file.txt - My hovercraft is full of eels! - -Now let's store this text file as an attachment in CouchDB. First, we -create a database: - -.. code-block:: bash - - shell> curl -X PUT http://127.0.0.1:5984/test - {"ok":true} - -Then we create a new document and the file attachment in one go: - -.. code-block:: bash - - shell> curl -X PUT http://127.0.0.1:5984/test/doc/file.txt \ - -H "Content-Type: application/octet-stream" [email protected] - {"ok":true,"id":"doc","rev":"1-287a28fa680ae0c7fb4729bf0c6e0cf2"} - -Now we can request the whole file easily: - -.. code-block:: bash - - shell> curl -X GET http://127.0.0.1:5984/test/doc/file.txt - My hovercraft is full of eels! - -But say we only want the first 13 bytes: - -.. code-block:: bash - - shell> curl -X GET http://127.0.0.1:5984/test/doc/file.txt \ - -H "Range: bytes=0-12" - My hovercraft - -HTTP supports many ways to specify single and even multiple byte -ranges. Read all about it in `RFC 2616`_. - -.. note:: - Databases that have been created with CouchDB 1.0.2 or earlier will - support range requests in |version|, but they are using a less-optimal - algorithm. If you plan to make heavy use of this feature, make sure - to compact your database with CouchDB |version| to take advantage of a - better algorithm to find byte ranges. - -.. _RFC 2616: http://tools.ietf.org/html/rfc2616#section-14.27
