You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
This repository was archived by the owner on Dec 24, 2022. It is now read-only.
Copy file name to clipboardExpand all lines: README.md
+5-8Lines changed: 5 additions & 8 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -5,11 +5,11 @@ follow [@servicestack](http://twitter.com/servicestack) for updates.
5
5
6
6
# Introduction
7
7
8
-
OrmLite is a set of light-weight C# extension methods around `System.Data.*` interfaces which is designed to persist POCO classes with a minimal amount of intrusion and configuration.
9
-
Another Orm with similar goals is [sqlite-net](https://github.com/praeclarum/sqlite-net) by Frank Krueger.
8
+
OrmLite's goal is to provide a convenient, DRY, config-free, RDBMS-agnostic typed wrapper that retains a high affinity with SQL, exposing intuitive APIs that generate predictable SQL and maps cleanly to (DTO-friendly) disconnected POCO's. This approach makes easier to reason-about your data access making it obvious what SQL is getting executed at what time, whilst mitigating unexpected behavior, implicit N+1 queries and leaky data access prevalent in Heavy ORMs.
10
9
11
10
OrmLite was designed with a focus on the core objectives:
12
11
12
+
* Provide a set of light-weight C# extension methods around .NET's impl-agnostic `System.Data.*` interfaces
13
13
* Map a POCO class 1:1 to an RDBMS table, cleanly by conventions, without any attributes required.
14
14
* Create/Drop DB Table schemas using nothing but POCO class definitions (IOTW a true code-first ORM)
15
15
* Simplicity - typed, wrist friendly API for common data access patterns.
@@ -19,12 +19,11 @@ OrmLite was designed with a focus on the core objectives:
19
19
* Cross platform - supports multiple dbs (currently: Sql Server, Sqlite, MySql, PostgreSQL, Firebird) running on both .NET and Mono platforms.
20
20
21
21
In OrmLite: **1 Class = 1 Table**. There should be no surprising or hidden behaviour.
22
-
Any non-scalar properties (i.e. complex types) are text blobbed in a schema-less text field using [.NET's fastest Text Serializer](http://mono.servicestack.net/mythz_blog/?p=176).
23
-
Effectively this allows you to create a table from any POCO type and it should persist as expected in a DB Table with columns for each of the classes 1st level public properties.
22
+
Any non-scalar properties (i.e. complex types) are by default text blobbed in a schema-less text field using any of the [avilable pluggable text serializers](#pluggable-complex-type-serializers). Support for [POCO-friendly references](#reference-support-poco-style) is also available to provide a convenient API to persist related models. Effectively this allows you to create a table from any POCO type and it should persist as expected in a DB Table with columns for each of the classes 1st level public properties.
24
23
25
24
# Download
26
25
27
-
[](http://nuget.org/List/Packages/ServiceStack.OrmLite.SqlServer)
26
+
Install-Package ServiceStack.OrmLite.SqlServer
28
27
29
28
### 8 flavours of OrmLite is on NuGet:
30
29
@@ -46,7 +45,7 @@ Since September 2013, ServiceStack source code is available under GNU Affero Gen
46
45
47
46
### Contributing
48
47
49
-
Contributors need to approve the [Contributor License Agreement](https://docs.google.com/forms/d/16Op0fmKaqYtxGL4sg7w_g-cXXyCoWjzppgkuqzOeKyk/viewform) before any code will be reviewed, see the [Contributing wiki](https://github.com/ServiceStack/ServiceStack/wiki/Contributing) for more details.
48
+
Contributors need to approve the [Contributor License Agreement](https://docs.google.com/forms/d/16Op0fmKaqYtxGL4sg7w_g-cXXyCoWjzppgkuqzOeKyk/viewform) before submitting pull-requests, see the [Contributing wiki](https://github.com/ServiceStack/ServiceStack/wiki/Contributing) for more details.
50
49
51
50
***
52
51
@@ -418,8 +417,6 @@ var tracks = db.SelectByIds<Track>(new[]{ 1,2,3 });
418
417
419
418
# Features
420
419
421
-
OrmLite's goal is to provide a convenient, DRY, RDBMS-agnostic typed wrapper that retains a high affinity with SQL, exposing an intuitive API that generates predictable SQL and straight-forward mapping to clean, disconnected (DTO-friendly) POCO's. This approach makes easier to reason-about your data access as it's obvious what SQL is getting executed at what time, mitigating unexpected behavior, implicit N+1 queries and leaky data access prevalent in Heavy ORMs.
422
-
423
420
Whilst OrmLite aims to provide a light-weight typed wrapper around SQL, it offers a number of convenient features that makes working with RDBMS's a clean and enjoyable experience:
0 commit comments