Changes for page WebObjects and Squeryl

Summary

• Page properties (1 modified, 0 added, 0 removed)

Details

Page properties

Content

...	...	@@ -1,6 +1,6 @@
1		-= Squeryl ~= //SQL-like// DSL for Scala =
	1	+= Squeryl ~= //SQL-like// DSL in Scala =
2	2
3		-Advantages of Squeryl over EOF:
	3	+Advantages of [[Squeryl>>http://squeryl.org/]] over EOF:
4	4
5	5	* Concurrent
6	6	** Spawns multiple database connections
...	...	@@ -7,21 +7,23 @@
7	7	** Issues database transactions concurrently
8	8	* Scala Actor compatible
9	9	** Immutable object model/graph
10		-* Strongly-typed
	10	+** Explicit transaction control
	11	+* Type Safety
11	11	** Better suited for database/business "logic".
12	12	E.g: Exploits the compiler and IDE to catch exceptions at compile time rather than at run-time.
13		-* Uses Scala (functional) collection classes
	14	+* Uses Scala Collections
14	14
15	15	= Migrating EOF -> Squeryl =
16	16
17		-In keeping with the strong-typed philosophy of Scala, Squeryl has no dynamic component like EOF (i.e an EO model file).
	18	+In contrast to EOF Squeryl maintains its ORM information programmatically - in the classes itself and collectively in a [[schema>>http://squeryl.org/schema-definition.html]]. In keeping with the strongly-typed philosophy of Scala, Squeryl has no dynamic component like EOF (i.e an EO model file).
18	18
19		-EOF has the ability to generate classes in Java (and in Objective-C prior to WebObjects 4.5) as enforcing type has become customary in enterprise environments. We may exploit this feature of EOF to generate a Squeryl schema.
	20	+EOF has the ability to generate classes in Java (and in Objective-C prior to WebObjects 4.5) because enforcing type has become customary in enterprise environments. We may exploit this feature of EOF to generate a Squeryl schema from an EO model.
20	20
21	21	=== Preparing your EO model ===
22	22
23		-1. Make sure **all** EO entities have a class name (including abstract many-To-many "join" tables). There's no support for entities marked as ##EOGenericRecord##.
24		-1. (Temporary) Ensure all the model entities are in the same package. i.e model <-> package corresponds 1-to-1.
	24	+* Make sure **all** EO entities have a class name (including abstract many-To-many "join" tables). FYI: There can be no support for entities classified as ##EOGenericRecord##.
	25	+* Mark the abstract many-To-Many join entities as ##Abstract##.
	26	+* (Temporary) Ensure all the model entities are in the same package. i.e the package is exclusive to the model.
25	25
26	26	=== Generating the Squeryl Schema ===
27	27
...	...	@@ -37,3 +37,43 @@
37	37	Any custom business "logic" will have to be manually re-written in Scala
38	38
39	39	{{/note}}
	42	+
	43	+== Differences Between a Squeryl Schema and EO Model/Classes ==
	44	+
	45	+* Optional attributes (i.e those that ##allowsNull##) are typed as ##OptionWO:T##
	46	+* To one relationships that are not mandatory (i.e optional relationships) are also typed as ##OptionWO:T##
	47	+* To many relationships are represented as a Squeryl iterable (collection class) as opposed to a ##NSArray##.
	48	+
	49	+=== Use of Scala Collections ===
	50	+
	51	+===== 1. Filtering =====
	52	+
	53	+Instead of using EOQualifiers to filter EOs dynamically, you can apply the type safe filter in Scala:
	54	+
	55	+{{code}}
	56	+
	57	+def activeFiles = files.filter(_.active == true)
	58	+
	59	+{{/code}}
	60	+
	61	+===== 2. Iteration =====
	62	+
	63	+Functional language iteration that's become increasingly popular can be used:
	64	+
	65	+{{code}}
	66	+
	67	+activeFiles.foreach(f => {
	68	+ ...
	69	+})
	70	+
	71	+{{/code}}
	72	+
	73	+===== 3. For-Comprehensions =====
	74	+
	75	+Here's just an example use of sequence comprehension:
	76	+
	77	+{{code}}
	78	+
	79	+def activeFiles = for (file <- files if file.active == true) yield file
	80	+
	81	+{{/code}}