Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
Newer
Older
100644 82 lines (64 sloc) 5.07 kB
57ed8b4 @subsonic Adding README
subsonic authored
1 Massive is a Single File Database Lover. Move over Bacon - Taste is got a new friend in .NET Land
2 =================================================================================================
3
4
5 I'm sharing this with the world because we need another way to access data - don't you think? Truthfully - I wanted to see if I could flex the C# 4 stuff and
6 run up data access with a single file. I used to have this down to 350 lines, but you also needed to reference WebMatrix.Data. Now you don't - this is ready to roll
7 and weighs in at a lovely 524 lines of code. Most of which is comments.
8
9 How To Install It?
10 ------------------
11 Drop the code file into your app and change it as you wish.
12
13 How Do You Use It?
14 ------------------
15 Massive is a "wrapper" for your DB tables and uses System.Dynamic extensively. If you try to use this with C# 3.5 or below, it will explode and you will be sad. Me too honestly - I like how this doesn't require any DLLs other than what's in the GAC. Yippee.
16
17 * Get a Database. Northwind will work nicely. Add a connection to your database in your web.config (or app.config). Don't forget the providerName! If you don't know what that is - just add providerName = 'System.Data.SqlClient' right after the whole connectionString stuff.
18 * Create a class that wraps a table. You can call it whatever you like, but if you want to be cool just name it the same as your table.
19 * Query away and have fun
20
21 Code Please
22 -----------
23 Let's say we have a table named "Products". You create a class like this:
24
25 public class Products:DynamicModel {
26 public Products():base("northwind") {
27 PrimaryKeyField = "ProductID";
28 }
29
30 }
31
32 This class inherits from DynamicModel, which does all the querying (that's the class you see above). We've told it how to connect (using the "northwind" connectionStringName), we've explicitly told it what the PK name is, and we can also tell it to use a TableName if we like. In addition there are a number of Callbacks you can use - like "AfterInsert()", "BeforeInsert()" and so on that fire ... guess when!
33
34 Now you can query thus:
35 var table = new Products();
36 //grab all the products
37 var products = table.All();
38 //just grab from category 4. This uses named parameters
39 var productsFour = table.All(where: "WHERE categoryID=@0",args: 4);
40
5ea077f @subsonic Fixing markdown weirdness
subsonic authored
41 What you get back is IEnumerable < ExpandoObject > - meaning that it's malleable and exciting. It will take the shape of whatever you return in your query, and it will have properties and so on. You can assign events to it, you can create delegates on the fly. You can give it chocolate, and it will kiss you.
57ed8b4 @subsonic Adding README
subsonic authored
42
43 That's pretty much it. One thing I really like is the groovy DSL that Massive uses - it looks just like SQL. If you want, you can use this DSL to query the database:
44 var table = new Products();
45 var productsThatILike = table.Query("SELECT ProductName, CategoryName FROM Products INNER JOIN Categories ON Categories.CategoryID = Products.CategoryID WHERE CategoryID = @0",5);
46 //get down!
47
48 Some of you might look at that and think it looks suspiciously like inline SQL. It *does* look sort of like it doesn't it! But I think it reads a bit better than Linq to SQL - it's a bit closer to the mark if you will.
49
50 Inserts and Updates
51 -------------------
52 Massive is built on top of dynamics - so if you send an object to a table, it will get parsed into a query. If that object has a property on it that matches the primary key, Massive will think you want to update something. Unless you tell it specifically to update it.
53
54 You can send just about anything into the MassiveTransmoQueryfier and it will magically get turned into SQL:
55 var table = new Products();
56 var poopy = new {ProductName = "Chicken Fingers"};
57 //update Product with ProductID = 12 to have a ProductName of "Chicken Fingers"
58 table.Update(poopy, 12);
59
60 This also works if you have a form on your web page with the name "ProductName" - then you submit it:
61 var table = new Products();
62 //update Product with ProductID = 12 to have a ProductName of whatever was submitted via the form
63 table.Update(poopy, Request.Form);
64
65 Insert works the same way:
66 //pretend we have a class like Products but it's called Categories
67 var table = new Categories();
68 //do it up - the new ID will be returned from the query
69 var newID = table.Insert(new {CategoryName = "Buck Fify Stuff", Description = "Things I like"});
70
71 Yippee Skippy! Now we get to the fun part - and one of the reasons I had to spend 150 more lines of code on something you probably won't care about. What happens when we send a whole bunch of goodies to the database at once!
72 var table = new Products();
73 //OH NO YOU DIDN't just pass in an integer inline without a parameter!
74 //I think I might have... yes
75 var drinks = table.All("WHERE CategoryID = 8");
5ea077f @subsonic Fixing markdown weirdness
subsonic authored
76 //what we get back here is an IEnumerable < ExpandoObject > - we can go to town
57ed8b4 @subsonic Adding README
subsonic authored
77 foreach(var item in drinks){
78 //turn them into Haack Snacks
79 item.CategoryID = 12;
80 }
81 //Let's update these in bulk, in a transaction shall we?
82 table.UpdateMany(drinks);
Something went wrong with that request. Please try again.