![The Indexer Way
• The problem
//Find by „Candy“ or find by „C and Y“?
db.sweets.FindAllByCAndY("Oreo");
• The solution
//Full indexer way
db["sweets"].FindAllBy(Candy: "Oreo");
//Hybrid fluid + indexer
db.sweets.FindAllBy(Candy: "Oreo");
db["city"].FindAllByCityName("Paris");
15](https://image.slidesharecdn.com/simple-140117015652-phpapp02/85/Introduction-to-Simple-Data-13-320.jpg)
![Target Matching
• Sequence
– Exact match
– Case-insensitive - non-alphanumeric chars
– Pluralized/Singularized version
• The following are thus all identical
– Albums.GenreId
– Album.GenreId
– ALBUMS.GENREID
– ALBUM.GENREID
– [ALBUMS].[GENREID]
– [ALBUM].[GENREID]
– AlBuM.geNReId
– Al__*bum.Genr-eId
– ...
16](https://image.slidesharecdn.com/simple-140117015652-phpapp02/85/Introduction-to-Simple-Data-14-320.jpg)
![Testing: InMemoryAdapter
[Test]
public void Should_do_something()
{
var adapter = new InMemoryAdapter();
Database.UseMockAdapter(adapter);
var db = Database.Open();
db.Test.Insert(Id: 1, Name: "Alice");
//...
}
• The InMemoryAdapter supports
– Joins, Transactions, Stored procedures...
43](https://image.slidesharecdn.com/simple-140117015652-phpapp02/85/Introduction-to-Simple-Data-41-320.jpg)
Introduction to Simple.Data
- 1. Simple.Data … an ORM without O, R or M Timothée Bourguignon 1
- 2. What is Simple.Data? An O/RM without O, R or M! 3
- 3. Hands-on! • SQL Server + MvcMusicStore DB – http://mvcmusicstore.codeplex.com/ 4
- 4. What is Simple.Data? • Lightweight way of manipulating data – Based on .NET 4.0's „dynamic“ keyword – Interprets method and property names – Maps them to your underlying data-store – Prevents SQL Injection – Inspired by Ruby’s ActiveRecord and DataMappers – Open Source & runs on Mono – V1.0 rc3 released in Nov. 2012 5
- 5. The Menu • • • • • • • • Generalities Conventions CRUD Operations Objects Returned Joins & Evaluation Strategies Various Functions Tool & Testing Wrap-Up • Hands-ons along the way 6
- 10. Opening a Connection var magicDb = Database .OpenConnection("ConnectString"); var fileDb = Database .OpenConnection("MyDB.sdf"); • Per default connections are aggressively opened and closed for each query • Supports shared connections 12
- 11. Choose your weapon • The „Fluid“ Way – Methods & properties convention-based mapping • The „Indexer“ Way – Identification via an indexer syntax 13
- 12. The Fluid Way Co lu m Pa n ra m et er s an d m Co m Ta bl e/ Vi ew db.album.FindAllByGenreId(3); 14
- 13. The Indexer Way • The problem //Find by „Candy“ or find by „C and Y“? db.sweets.FindAllByCAndY("Oreo"); • The solution //Full indexer way db["sweets"].FindAllBy(Candy: "Oreo"); //Hybrid fluid + indexer db.sweets.FindAllBy(Candy: "Oreo"); db["city"].FindAllByCityName("Paris"); 15
- 14. Target Matching • Sequence – Exact match – Case-insensitive - non-alphanumeric chars – Pluralized/Singularized version • The following are thus all identical – Albums.GenreId – Album.GenreId – ALBUMS.GENREID – ALBUM.GENREID – [ALBUMS].[GENREID] – [ALBUM].[GENREID] – AlBuM.geNReId – Al__*bum.Genr-eId – ... 16
- 15. No IntelliSence • • • • Dynamics => no member / function inferrence Schema analyse planned for Simple.Data v2 Tool: Simple.Data.Pad Still easy to get used to 17
- 17. Create • Insert(object or named parameters) 19
- 18. Read • Read – All() – Find(simple expressions) – Get(primary key) – FindAll(optional condition) – FindAllByXXX(parameter) 20
- 19. Update • Update(object or named parameters) – Update – UpdateByXXX – UpdateAll + optional condition • Upsert e.g. Update or Insert • Some kind of optimistic locking – Update(modifiedObject, originalObject) – Fails if the column(s) you are modifying changed • Nota: does not work with Upsert 21
- 20. Delete • Delete – Delete(object or named parameters) – DeleteByXXX(parameters) – DeleteAll(optional conditions) 22
- 21. Hands-on! • CRUD Operations – Insert – Update – Delete – Read 23
- 23. SimpleRecord • Dynamic object • Contains a property for each of the columns requested whose values are those of the single row retrieved from the data store • „Cast-able“ to a concrete implementation 25
- 24. SimpleQuery • • • • Dynamic object Similar to LINQ structure Executes when enumerated Contains a SimpleRecord object for each row returned 26
- 25. Casting • Casting to objects – Implicit – Explicit: Cast<T>, ToList, ToList<T>, ToArray, ToArray<T> • Hands-On – Implicit casting – Explicit casting 27
- 27. Hands-on! • Lazy natural evaluation • Casting + Lazy? • Eager evaluation 29
- 28. Joins • Lazy loading – Natural Joins / Table chaining • Eager Loading – „With Joins“ • With/WithXXX • WithOne • WithMany Foreign-Key relationship present No Foreign-Key relationship necessary (no referential integrity) – „Explicit Joins“ • Join • LeftJoin • OuterJoin Natural joins can be used as part of an explicit join, the join is then eager loaded 30
- 29. Hands-on! • Eager Joins – Select + Natural Joins + As – With 31
- 31. Ordering Results • OrderBy, OrderByDescending • ThenBy, ThenByDescending db.Albums.All().OrderByGenreId() .ThenByArtistIdDescending(); 33
- 32. Scalar Queries • • • • GetCount GetCountBy Exists, Any ExistsBy, AnyBy int albumCount = db.Albums.GetCount( db.Albums.GenreId == 2); 34
- 33. Query Modifiers • Select – Star & AllColumns db.Albums.All().Select(db.Albums.Title, db.Albums.ArtistId); 35
- 34. Query Modifiers • Column Aliasing: As(string) var albums = db.Albums.All().Select( db.Albums.AlbumId, db.Albums.Title.As("AlbumName")); 36
- 35. Query Modifiers • Where clauses – Operators (+, -, *, /, %) – IN, BETWEEN, LIKE, IS NULL var albums = db.Albums.FindAllByGenreId(1) .Select(db.Albums.Title) .Where(db.Albums.Price < 8); db.Albums.All().Where( db.Albums.Title.Like("%Side Of The%")); 37
- 36. Aggregate Functions • Grouping and Aggregates – Having → Group By / Having – Min, Max, Avg, Sum var cheapAlbums = db.Albums.All() .Having(db.Albums.Price < 9).ToList(); var totalCost = db.Albums.All().Select( db.Albums.Price.Sum().As("TotalCost")); 38
- 37. Stored Procedures • Like a function... CREATE PROCEDURE ProcedureWithParameters @One VARCHAR(MAX), @Two VARCHAR(MAX) AS SELECT * FROM Customers WHERE Firstname = @One and Lastname like @Two db.ProcedureWithParameters(1, 2); 39
- 38. Transactions • Wrap up the calls using (var transaction = db.BeginTransaction()) { transaction.albums.Insert(GenreId: 1...); transaction.Commit(); } 40
- 40. Tool: Simple.Data.Pad • Similar to LINQ-Pad... kind of... – https://github.com/markrendle/Simple.Data.Pad 42
- 41. Testing: InMemoryAdapter [Test] public void Should_do_something() { var adapter = new InMemoryAdapter(); Database.UseMockAdapter(adapter); var db = Database.Open(); db.Test.Insert(Id: 1, Name: "Alice"); //... } • The InMemoryAdapter supports – Joins, Transactions, Stored procedures... 43
- 42. InMemoryAdapter Configuration • Tweaking functions – SetKeyColumn – SetAutoIncrementColumn – AddFunction (stored procedure) – ConfigureJoin – ... 44
- 43. Design 45
- 44. Wrap-Up 46
- 45. Wrap-up • OpenSource, Mono • Everything is dynamic • Fluid-, Indexer Way • CRUD – FindXXX, DeleteXXX, UpdateXXX etc. • Dynamics Objects Returned • Joins, lazy, eager – Natural, WithXXX, Join • Various Functions – Group, Order, Scalar, Modifiers etc. • Tool & Testing • Design 47
- 46. Simple.Data in Short • • • • • Lightweight Readable Compelling Fun to use Interesing design • Dynamics extensive testing • Good understanding upfront • My Recommendation – Try it and study it – Take it for a spin for some tooling and/or prototyping – ...and some projects? 48
- 47. Further Reading • Github – https://github.com/markrendle/Simple.Data • Nuget – http://nuget.org/packages?q=simple.data • GoogleGroup – https://groups.google.com/forum/?fromgroups#! forum/simpledata • Mark Rendle – @MarkRendle – http://blog.markrendle.net/ 49
- 48. Ich freue mich auf Eure Fragen! [email protected] about.me/timbourguignon 50