Pass through version and revision information

This commit is contained in:
James Allen 2014-05-08 15:43:08 +01:00
parent 0adcf3c140
commit 0dda75c2d5
11 changed files with 96 additions and 40 deletions

View file

@ -21,23 +21,29 @@ module.exports = DocManager =
return callback(error) if error? return callback(error) if error?
return callback null, docs return callback null, docs
updateDoc: (project_id, doc_id, lines, callback = (error, modified) ->) -> updateDoc: (project_id, doc_id, lines, version, callback = (error, modified, rev) ->) ->
DocManager.getDoc project_id, doc_id, (error, doc, mongoPath) -> DocManager.getDoc project_id, doc_id, (error, doc, mongoPath) ->
return callback(error) if error? return callback(error) if error?
return callback new Errors.NotFoundError("No such project/doc: #{project_id}/#{doc_id}") if !doc? return callback new Errors.NotFoundError("No such project/doc: #{project_id}/#{doc_id}") if !doc?
if _.isEqual(doc.lines, lines) if _.isEqual(doc.lines, lines) and doc.version == version
logger.log { logger.log {
project_id: project_id, doc_id: doc_id, rev: doc.rev project_id: project_id, doc_id: doc_id, rev: doc.rev, version: doc.version
}, "doc lines have not changed" }, "doc lines and version have not changed"
return callback null, false return callback null, false, doc.rev
else else
logger.log { logger.log {
project_id: project_id, doc_id: doc_id, oldDocLines: doc.lines, newDocLines: lines, rev: doc.rev project_id: project_id
doc_id: doc_id,
oldDocLines: doc.lines
newDocLines: lines
rev: doc.rev
oldVersion: doc.version
newVersion: version
}, "updating doc lines" }, "updating doc lines"
MongoManager.updateDoc project_id, mongoPath, lines, (error) -> MongoManager.updateDoc project_id, mongoPath, lines, version, (error) ->
return callback(error) if error? return callback(error) if error?
callback null, true callback null, true, doc.rev + 1 # rev will have been incremented in mongo by MongoManager.updateDoc
deleteDoc: (project_id, doc_id, callback = (error) ->) -> deleteDoc: (project_id, doc_id, callback = (error) ->) ->
DocManager.getDoc project_id, doc_id, (error, doc) -> DocManager.getDoc project_id, doc_id, (error, doc) ->

View file

@ -30,17 +30,19 @@ module.exports = HttpController =
project_id = req.params.project_id project_id = req.params.project_id
doc_id = req.params.doc_id doc_id = req.params.doc_id
lines = req.body?.lines lines = req.body?.lines
version = req.body?.version
if !lines? or lines not instanceof Array if !lines? or lines not instanceof Array
logger.error project_id: project_id, doc_id: doc_id, "no doc lines provided" logger.error project_id: project_id, doc_id: doc_id, "no doc lines provided"
res.send 400 # Bad Request res.send 400 # Bad Request
return return
logger.log project_id: project_id, doc_id: doc_id, "updating doc" logger.log project_id: project_id, doc_id: doc_id, version: version, "updating doc"
DocManager.updateDoc project_id, doc_id, lines, (error, modified) -> DocManager.updateDoc project_id, doc_id, lines, version, (error, modified, rev) ->
return next(error) if error? return next(error) if error?
res.json { res.json {
modified: modified modified: modified
rev: rev
} }
deleteDoc: (req, res, next = (error) ->) -> deleteDoc: (req, res, next = (error) ->) ->

View file

@ -5,11 +5,12 @@ module.exports = MongoManager =
db.projects.find _id: ObjectId(project_id.toString()), {}, (error, projects = []) -> db.projects.find _id: ObjectId(project_id.toString()), {}, (error, projects = []) ->
callback error, projects[0] callback error, projects[0]
updateDoc: (project_id, docPath, lines, callback = (error) ->) -> updateDoc: (project_id, docPath, lines, version, callback = (error) ->) ->
update = update =
$set: {} $set: {}
$inc: {} $inc: {}
update.$set["#{docPath}.lines"] = lines update.$set["#{docPath}.lines"] = lines
update.$set["#{docPath}.version"] = version if version?
update.$inc["#{docPath}.rev"] = 1 update.$inc["#{docPath}.rev"] = 1
db.projects.update _id: ObjectId(project_id), update, callback db.projects.update _id: ObjectId(project_id), update, callback

View file

@ -10,9 +10,10 @@ describe "Deleting a doc", ->
@project_id = ObjectId() @project_id = ObjectId()
@doc_id = ObjectId() @doc_id = ObjectId()
@lines = ["original", "lines"] @lines = ["original", "lines"]
@version = 42
DocstoreClient.createProject @project_id, (error) => DocstoreClient.createProject @project_id, (error) =>
throw error if error? throw error if error?
DocstoreClient.createDoc @project_id, @doc_id, @lines, (error) => DocstoreClient.createDoc @project_id, @doc_id, @lines, @version, (error) =>
throw error if error? throw error if error?
done() done()

View file

@ -29,7 +29,7 @@ describe "Getting all docs", ->
throw error if error? throw error if error?
jobs = for doc in @docs jobs = for doc in @docs
do (doc) => do (doc) =>
(callback) => DocstoreClient.createDoc @project_id, doc._id, doc.lines, callback (callback) => DocstoreClient.createDoc @project_id, doc._id, doc.lines, doc.version, callback
async.series jobs, done async.series jobs, done
afterEach (done) -> afterEach (done) ->

View file

@ -10,9 +10,10 @@ describe "Getting a doc", ->
@project_id = ObjectId() @project_id = ObjectId()
@doc_id = ObjectId() @doc_id = ObjectId()
@lines = ["original", "lines"] @lines = ["original", "lines"]
@version = 42
DocstoreClient.createProject @project_id, (error) => DocstoreClient.createProject @project_id, (error) =>
throw error if error? throw error if error?
DocstoreClient.createDoc @project_id, @doc_id, @lines, (error) => DocstoreClient.createDoc @project_id, @doc_id, @lines, @version, (error) =>
throw error if error? throw error if error?
done() done()
@ -20,9 +21,10 @@ describe "Getting a doc", ->
DocstoreClient.deleteProject @project_id, done DocstoreClient.deleteProject @project_id, done
describe "when the doc exists", -> describe "when the doc exists", ->
it "should get the doc lines", (done) -> it "should get the doc lines and version", (done) ->
DocstoreClient.getDoc @project_id, @doc_id, (error, res, doc) => DocstoreClient.getDoc @project_id, @doc_id, (error, res, doc) =>
doc.lines.should.deep.equal @lines doc.lines.should.deep.equal @lines
doc.version.should.equal @version
done() done()
describe "when the doc does not exist", -> describe "when the doc does not exist", ->

View file

@ -11,9 +11,11 @@ describe "Applying updates to a doc", ->
@doc_id = ObjectId() @doc_id = ObjectId()
@originalLines = ["original", "lines"] @originalLines = ["original", "lines"]
@newLines = ["new", "lines"] @newLines = ["new", "lines"]
@originalVersion = 42
@newVersion = 53
DocstoreClient.createProject @project_id, (error) => DocstoreClient.createProject @project_id, (error) =>
throw error if error? throw error if error?
DocstoreClient.createDoc @project_id, @doc_id, @lines, (error) => DocstoreClient.createDoc @project_id, @doc_id, @lines, @version, (error) =>
throw error if error? throw error if error?
done() done()
@ -22,7 +24,7 @@ describe "Applying updates to a doc", ->
describe "when the content has changed", -> describe "when the content has changed", ->
beforeEach (done) -> beforeEach (done) ->
DocstoreClient.updateDoc @project_id, @doc_id, @newLines, (error, res, @body) => DocstoreClient.updateDoc @project_id, @doc_id, @newLines, @newVersion, (error, res, @body) =>
done() done()
it "should return modified = true", -> it "should return modified = true", ->
@ -31,11 +33,12 @@ describe "Applying updates to a doc", ->
it "should update the doc in the API", (done) -> it "should update the doc in the API", (done) ->
DocstoreClient.getDoc @project_id, @doc_id, (error, res, doc) => DocstoreClient.getDoc @project_id, @doc_id, (error, res, doc) =>
doc.lines.should.deep.equal @newLines doc.lines.should.deep.equal @newLines
doc.version.should.deep.equal @newVersion
done() done()
describe "when the content has not been updated", -> describe "when the content has not been updated", ->
beforeEach (done) -> beforeEach (done) ->
DocstoreClient.updateDoc @project_id, @doc_id, @originalLines, (error, res, @body) => DocstoreClient.updateDoc @project_id, @doc_id, @originalLines, @originalVersion, (error, res, @body) =>
done() done()
it "should return modified = false", -> it "should return modified = false", ->
@ -44,12 +47,13 @@ describe "Applying updates to a doc", ->
it "should not update the doc in the API", (done) -> it "should not update the doc in the API", (done) ->
DocstoreClient.getDoc @project_id, @doc_id, (error, res, doc) => DocstoreClient.getDoc @project_id, @doc_id, (error, res, doc) =>
doc.lines.should.deep.equal @originalLines doc.lines.should.deep.equal @originalLines
doc.version.should.deep.equal @originalVersion
done() done()
describe "when the doc does not exist", -> describe "when the doc does not exist", ->
beforeEach (done) -> beforeEach (done) ->
missing_doc_id = ObjectId() missing_doc_id = ObjectId()
DocstoreClient.updateDoc @project_id, missing_doc_id, @originalLines, (error, @res, @body) => DocstoreClient.updateDoc @project_id, missing_doc_id, @originalLines, @newVersion, (error, @res, @body) =>
done() done()
it "should return a 404", -> it "should return a 404", ->
@ -58,7 +62,7 @@ describe "Applying updates to a doc", ->
describe "when the project does not exist", -> describe "when the project does not exist", ->
beforeEach (done) -> beforeEach (done) ->
missing_project_id = ObjectId() missing_project_id = ObjectId()
DocstoreClient.updateDoc missing_project_id, @doc_id, @originalLines, (error, @res, @body) => DocstoreClient.updateDoc missing_project_id, @doc_id, @originalLines, @newVersion, (error, @res, @body) =>
done() done()
it "should return a 404", -> it "should return a 404", ->
@ -67,7 +71,7 @@ describe "Applying updates to a doc", ->
describe "when malformed doc lines are provided", -> describe "when malformed doc lines are provided", ->
describe "when the lines are not an array", -> describe "when the lines are not an array", ->
beforeEach (done) -> beforeEach (done) ->
DocstoreClient.updateDoc @project_id, @doc_id, { foo: "bar" }, (error, @res, @body) => DocstoreClient.updateDoc @project_id, @doc_id, { foo: "bar" }, @newVersion, (error, @res, @body) =>
done() done()
it "should return 400", -> it "should return 400", ->
@ -80,7 +84,7 @@ describe "Applying updates to a doc", ->
describe "when the lines are not present", -> describe "when the lines are not present", ->
beforeEach (done) -> beforeEach (done) ->
DocstoreClient.updateDoc @project_id, @doc_id, null, (error, @res, @body) => DocstoreClient.updateDoc @project_id, @doc_id, null, @newVersion, (error, @res, @body) =>
done() done()
it "should return 400", -> it "should return 400", ->

View file

@ -8,7 +8,7 @@ module.exports = DocstoreClient =
rootFolder: [{ docs: [] }] rootFolder: [{ docs: [] }]
}, callback }, callback
createDoc: (project_id, doc_id, lines, callback = (error) ->) -> createDoc: (project_id, doc_id, lines, version, callback = (error) ->) ->
db.projects.update { db.projects.update {
_id: project_id _id: project_id
}, { }, {
@ -16,6 +16,7 @@ module.exports = DocstoreClient =
"rootFolder.0.docs": { "rootFolder.0.docs": {
_id: doc_id _id: doc_id
lines: lines lines: lines
version: version
} }
} }
}, callback }, callback
@ -35,11 +36,12 @@ module.exports = DocstoreClient =
json: true json: true
}, callback }, callback
updateDoc: (project_id, doc_id, lines, callback = (error, res, body) ->) -> updateDoc: (project_id, doc_id, lines, version, callback = (error, res, body) ->) ->
request.post { request.post {
url: "http://localhost:3016/project/#{project_id}/doc/#{doc_id}" url: "http://localhost:3016/project/#{project_id}/doc/#{doc_id}"
json: json:
lines: lines lines: lines
version: version
}, callback }, callback
deleteDoc: (project_id, doc_id, callback = (error, res, body) ->) -> deleteDoc: (project_id, doc_id, callback = (error, res, body) ->) ->

View file

@ -149,15 +149,15 @@ describe "DocManager", ->
beforeEach -> beforeEach ->
@oldDocLines = ["old", "doc", "lines"] @oldDocLines = ["old", "doc", "lines"]
@newDocLines = ["new", "doc", "lines"] @newDocLines = ["new", "doc", "lines"]
@doc = { _id: @doc_id, lines: @oldDocLines, rev: 42 } @doc = { _id: @doc_id, lines: @oldDocLines, rev: @rev = 5, version: @version = 42 }
@mongoPath = "mock.mongo.path" @mongoPath = "mock.mongo.path"
@MongoManager.updateDoc = sinon.stub().callsArg(3) @MongoManager.updateDoc = sinon.stub().callsArg(4)
describe "when the doc lines have changed", -> describe "when the doc lines have changed", ->
beforeEach -> beforeEach ->
@DocManager.getDoc = sinon.stub().callsArgWith(2, null, @doc, @mongoPath) @DocManager.getDoc = sinon.stub().callsArgWith(2, null, @doc, @mongoPath)
@DocManager.updateDoc @project_id, @doc_id, @newDocLines, @callback @DocManager.updateDoc @project_id, @doc_id, @newDocLines, @version, @callback
it "should get the existing doc", -> it "should get the existing doc", ->
@DocManager.getDoc @DocManager.getDoc
@ -166,7 +166,7 @@ describe "DocManager", ->
it "should update the doc with the new doc lines", -> it "should update the doc with the new doc lines", ->
@MongoManager.updateDoc @MongoManager.updateDoc
.calledWith(@project_id, @mongoPath, @newDocLines) .calledWith(@project_id, @mongoPath, @newDocLines, @version)
.should.equal true .should.equal true
it "should log out the old and new doc lines", -> it "should log out the old and new doc lines", ->
@ -177,28 +177,63 @@ describe "DocManager", ->
oldDocLines: @oldDocLines oldDocLines: @oldDocLines
newDocLines: @newDocLines newDocLines: @newDocLines
rev: @doc.rev rev: @doc.rev
oldVersion: @version
newVersion: @version
"updating doc lines" "updating doc lines"
) )
.should.equal true .should.equal true
it "should return the callback", -> it "should return the callback with the new rev", ->
@callback.calledWith(null, true).should.equal true @callback.calledWith(null, true, @rev + 1).should.equal true
describe "when the version has changed", ->
beforeEach ->
@newVersion = 1003
@DocManager.getDoc = sinon.stub().callsArgWith(2, null, @doc, @mongoPath)
@DocManager.updateDoc @project_id, @doc_id, @oldDocLines, @newVersion, @callback
it "should get the existing doc", ->
@DocManager.getDoc
.calledWith(@project_id, @doc_id)
.should.equal true
it "should update the doc with the new version", ->
@MongoManager.updateDoc
.calledWith(@project_id, @mongoPath, @oldDocLines, @newVersion)
.should.equal true
it "should log out the old and new doc lines", ->
@logger.log
.calledWith(
project_id: @project_id
doc_id: @doc_id
oldDocLines: @oldDocLines
newDocLines: @oldDocLines
rev: @doc.rev
oldVersion: @version
newVersion: @newVersion
"updating doc lines"
)
.should.equal true
it "should return the callback with the new rev", ->
@callback.calledWith(null, true, @rev + 1).should.equal true
describe "when the doc lines have not changed", -> describe "when the doc lines have not changed", ->
beforeEach -> beforeEach ->
@DocManager.getDoc = sinon.stub().callsArgWith(2, null, @doc, @mongoPath) @DocManager.getDoc = sinon.stub().callsArgWith(2, null, @doc, @mongoPath)
@DocManager.updateDoc @project_id, @doc_id, @oldDocLines.slice(), @callback @DocManager.updateDoc @project_id, @doc_id, @oldDocLines.slice(), @version, @callback
it "should not update the doc", -> it "should not update the doc", ->
@MongoManager.updateDoc.called.should.equal false @MongoManager.updateDoc.called.should.equal false
it "should return the callback", -> it "should return the callback with the existing rev", ->
@callback.calledWith(null, false).should.equal true @callback.calledWith(null, false, @rev).should.equal true
describe "when the doc does not exist", -> describe "when the doc does not exist", ->
beforeEach -> beforeEach ->
@DocManager.getDoc = sinon.stub().callsArgWith(2, null, null, null) @DocManager.getDoc = sinon.stub().callsArgWith(2, null, null, null)
@DocManager.updateDoc @project_id, @doc_id, @newDocLines, @callback @DocManager.updateDoc @project_id, @doc_id, @newDocLines, @version, @callback
it "should not try to update the doc", -> it "should not try to update the doc", ->
@MongoManager.updateDoc.called.should.equal false @MongoManager.updateDoc.called.should.equal false

View file

@ -139,29 +139,30 @@ describe "HttpController", ->
beforeEach -> beforeEach ->
@req.body = @req.body =
lines: @lines = ["hello", "world"] lines: @lines = ["hello", "world"]
@DocManager.updateDoc = sinon.stub().callsArgWith(3, null, true) version: @version = 42
@DocManager.updateDoc = sinon.stub().callsArgWith(4, null, true, @rev = 5)
@HttpController.updateDoc @req, @res, @next @HttpController.updateDoc @req, @res, @next
it "should update the document", -> it "should update the document", ->
@DocManager.updateDoc @DocManager.updateDoc
.calledWith(@project_id, @doc_id, @lines) .calledWith(@project_id, @doc_id, @lines, @version)
.should.equal true .should.equal true
it "should return a modified status", -> it "should return a modified status", ->
@res.json @res.json
.calledWith(modified: true) .calledWith(modified: true, rev: @rev)
.should.equal true .should.equal true
describe "when the doc lines exist and were not updated", -> describe "when the doc lines exist and were not updated", ->
beforeEach -> beforeEach ->
@req.body = @req.body =
lines: @lines = ["hello", "world"] lines: @lines = ["hello", "world"]
@DocManager.updateDoc = sinon.stub().callsArgWith(3, null, false) @DocManager.updateDoc = sinon.stub().callsArgWith(4, null, false, @rev = 5)
@HttpController.updateDoc @req, @res, @next @HttpController.updateDoc @req, @res, @next
it "should return a modified status", -> it "should return a modified status", ->
@res.json @res.json
.calledWith(modified: false) .calledWith(modified: false, rev: @rev)
.should.equal true .should.equal true
describe "when the doc lines are not provided", -> describe "when the doc lines are not provided", ->

View file

@ -31,10 +31,11 @@ describe "MongoManager", ->
describe "updateDoc", -> describe "updateDoc", ->
beforeEach -> beforeEach ->
@version = 42
@lines = ["mock-lines"] @lines = ["mock-lines"]
@docPath = "rootFolder.0.folders.1.docs.0" @docPath = "rootFolder.0.folders.1.docs.0"
@db.projects.update = sinon.stub().callsArg(2) @db.projects.update = sinon.stub().callsArg(2)
@MongoManager.updateDoc @project_id, @docPath, @lines, @callback @MongoManager.updateDoc @project_id, @docPath, @lines, @version, @callback
it "should update the doc lines and increment the TPDS rev", -> it "should update the doc lines and increment the TPDS rev", ->
@db.projects.update @db.projects.update
@ -43,6 +44,7 @@ describe "MongoManager", ->
}, { }, {
$set: $set:
"rootFolder.0.folders.1.docs.0.lines": @lines "rootFolder.0.folders.1.docs.0.lines": @lines
"rootFolder.0.folders.1.docs.0.version": @version
$inc: $inc:
"rootFolder.0.folders.1.docs.0.rev": 1 "rootFolder.0.folders.1.docs.0.rev": 1
}) })