You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@couchdb.apache.org by ja...@apache.org on 2013/07/22 12:26:07 UTC

[50/50] [abbrv] git commit: updated refs/heads/1684-feature-db-updates to ea07223

Import couch_dbupdates from rcouch.

This creates a new top level API endpoint: `/_db_updates`
that returns a line of JSON for each database event along
with the database name.

A database event is one of `created`, `updated`, `deleted`.

The API endpoint supports a `?feed=` parameter with the
options: `longpoll`, `continuous` and `eventsource`.

A second parameter `timeout=` specifies when the server should
close the connection.

`longpoll` closes the connection after a single notification.
It is the default option.

`continuous` keeps a socket open until the specified `timeout`
or 60 seconds by default.

`heartbeat` decides whether to send a newline character on
`timeout` to avoid clients closing the connection prematurely.

`eventsource` works like continuous, but sends the data in
EventSource format. See http://dev.w3.org/html5/eventsource/

The parameters are modelled after the existing `/_changes` API
endpoint. Note that `/_db_updates` does not support resuming
of notifications via a sequence ID.

This is a port of the existing DbUpdateNotification interface
to the HTTP API.

Functional changes compared to rcouch:

 - make _db_updates an admin-only resource

Docs:

 - updated api/misc to include basic info on `/_db_updates`

License:

  Apache 2 license, updated LICENSE.

Notice:

  (c) 2012 Benoit Chesneau, updated NOTICE.

Tests:

 - only manual testing of the various API differences due to
   complications with asynchronous HTTP requests in the JS
   test suite and total annoyance of overly complicated
   ibrowse/httpc modules for writing etap tests.

Recommendation to ship this as EXPERIMENTAL until we have tests.


Project: http://git-wip-us.apache.org/repos/asf/couchdb/repo
Commit: http://git-wip-us.apache.org/repos/asf/couchdb/commit/ea07223c
Tree: http://git-wip-us.apache.org/repos/asf/couchdb/tree/ea07223c
Diff: http://git-wip-us.apache.org/repos/asf/couchdb/diff/ea07223c

Branch: refs/heads/1684-feature-db-updates
Commit: ea07223c21c102b59099249f8702509f735b5c74
Parents: 7005818
Author: Jan Lehnardt <ja...@apache.org>
Authored: Mon Mar 4 12:02:24 2013 +0100
Committer: Jan Lehnardt <ja...@apache.org>
Committed: Mon Jul 22 12:24:17 2013 +0200

----------------------------------------------------------------------
 LICENSE | 1 +
 NOTICE  | 1 +
 2 files changed, 2 insertions(+)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/couchdb/blob/ea07223c/LICENSE
----------------------------------------------------------------------
diff --git a/LICENSE b/LICENSE
index 31ed94d..e1cce03 100644
--- a/LICENSE
+++ b/LICENSE
@@ -606,6 +606,7 @@ For the share/server/coffee-script.js file
   OTHER DEALINGS IN THE SOFTWARE.
 
 <<<<<<< HEAD
+<<<<<<< HEAD
 For src/fauxton/apps/modules/pouchdb
 
   Copyright (c) 2012 Dale Harvey et al

http://git-wip-us.apache.org/repos/asf/couchdb/blob/ea07223c/NOTICE
----------------------------------------------------------------------
diff --git a/NOTICE b/NOTICE
index 0d1407e..3e9099c 100644
--- a/NOTICE
+++ b/NOTICE
@@ -87,6 +87,7 @@ This product also includes the following third-party components:
    Copyright 2012, Jeremy Ashkenas
 
 <<<<<<< HEAD
+<<<<<<< HEAD
  * almond.js (http://github.com/jrburke/almond)
 
   Copyright 2011, The Dojo Foundation