<% end %>
diff --git a/databases/mongo.md b/databases/mongo.md
index b4280e4..0a5d032 100644
--- a/databases/mongo.md
+++ b/databases/mongo.md
@@ -1,10 +1,15 @@
Mongo
-----
-[Mongo][mongo] is a document-oriented database. It is easy to connect your
-applications to a Mongo database without the use of an Object Relational
-Mapper (ORM). The first step is to create a connection to your Mongo instance.
-You can do this in your _configure_ block:
+[Mongo][mongo] is a document-oriented database. Though Object Relational
+Mappers (ORMs) are often used to connect to databases, you will see here
+that it is very easy to connect your applications to a Mongo database
+without the use of an ORM, though several exist. See the
+[Mongo models][mongo_models] page for a discussion of some of the ORMs
+available.
+
+The first step is in connecting your application to an instance of Mongo is
+to create a connection. You can do this in your _configure_ block:
require 'rubygems'
require 'sinatra'
@@ -23,40 +28,54 @@ your Mongo instance.
settings.mongo_db.collection_names
end
-Using the Ruby driver you can find, insert, update, or delete from
-your database (see more documentation at [MongoDB's tutorial][rubydrivertutorial]):
-
helpers do
# a helper method to turn a string ID
# representation into a BSON::ObjectId
def object_id val
BSON::ObjectId.from_string(val)
end
+
+ def document_by_id id
+ id = object_id(id) if String === id
+ settings.mongo_db['test'].
+ find_one(:_id => id).to_json
+ end
end
+
+###Finding Records###
+
# list all documents in the test collection
- get '/list_documents/?' do
+ get '/documents/?' do
content_type :json
settings.mongo_db['test'].find.to_a.to_json
end
+
+ # find a document by its ID
+ get '/document/:id/?' do
+ content_type :json
+ document_by_id(params[:id]).to_json
+ end
+###Inserting Records###
+
# insert a new document from the request parameters,
# then return the full document
post '/new_document/?' do
content_type :json
new_id = settings.mongo_db['test'].insert params
- settings.mongo_db['test'].
- find_one(:_id => new_id).
- to_json
+ document_by_id(new_id).to_json
end
-
+
+###Updating Records###
+
# update the document specified by :id, setting its
# contents to params, then return the full document
put '/update/:id/?' do
content_type :json
id = object_id(params[:id])
settings.mongo_db['test'].update(:_id => id, params)
- settings.mongo_db['test'].find_one(:_id => id).to_json
+ document_by_id(id).to_json
end
# update the document specified by :id, setting just its
@@ -68,9 +87,11 @@ your database (see more documentation at [MongoDB's tutorial][rubydrivertutorial
name = params[:name]
settings.mongo_db['test'].
update(:_id => id, {"$set" => {:name => name}})
- settings.mongo_db['test'].find_one(:_id => id).to_json
+ document_by_id(id).to_json
end
+###Deleting Records###
+
# delete the specified document and return success
delete '/remove/:id' do
content_type :json
@@ -78,6 +99,9 @@ your database (see more documentation at [MongoDB's tutorial][rubydrivertutorial
remove(:_id => object_id(params[:id]))
{:success => true}.to_json
end
-
+
+For more information on using the Ruby driver without an ORM take a look at [MongoDB's tutorial][rubydrivertutorial].
+
[mongo]: http://www.mongodb.org/
-[rubydrivertutorial]: http://api.mongodb.org/ruby/current/file.TUTORIAL.html
\ No newline at end of file
+[rubydrivertutorial]: http://api.mongodb.org/ruby/current/file.TUTORIAL.html
+[mongo_models]: /p/models/mongo.md
\ No newline at end of file
diff --git a/models/mongo.md b/models/mongo.md
new file mode 100644
index 0000000..88dd777
--- /dev/null
+++ b/models/mongo.md
@@ -0,0 +1 @@
+This page is under construction.
\ No newline at end of file