forked from tpolyak/Sharp-Architecture
-
Notifications
You must be signed in to change notification settings - Fork 152
/
VersionHistory.txt
1197 lines (946 loc) · 75.8 KB
/
VersionHistory.txt
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
994
995
996
997
998
999
1000
========================
vNext
========================
8.0.1
========================
* .NET 6 support (upgrade from RC to release)
8.0.0
========================
BREAKING:
* Drop NetCoreApp 2.1 support.
* NHibernate test setup will not search and execute IAutoPersistenceModelGenerator.
*
NEW FEATURES:
* Add .NET 6 preview support
BUILD:
* Move common dependencies and attributes to Directory.Build.props.
* Tests are executed on both Linux and Windows now.
BUGS:
* TestDatabaseSetup failure on Linux.
PERFORMANCE:
* Improved performance of ApplyTransactionFilterBase.GetTransactionAttribute.
7.0.0
========================
BREAKING:
* Removed EntityWithTypedId<> replaced with Entity<>, removed old entity class. Fix: replace `Entity` with `Entity<int>`.
* Renamed IAsyncRepository to IRepository.
* Added IEquatable<TId> constraint on IEntity<TId>.
* IRavenDbRepository.FindAllAsync now returns Task<TEntity[]>, not Task<IEnumerable<TEntity>>.
* Removed IRavenDbRepository.Session.
IMPROVEMENTS:
* TransactionAttribute now implements Equitable<>
S#arp 6.1.1
========================
FIXES:
* #245: Exception in DependencyList on .NET 5/Linux
========================
S#arp 6.1
========================
NEW FEATURES:
* .NET 5 support.
IMPROVEMENTS:
* Debug information now published as a symbol package to reduce build time and space used.
* Use tokens instead of credentials in build script.
========================
S#arp 6.0
========================
BREAKING CHANGES:
* Removed HasUniqueDomainSignatureWithGuidIdAttribute.
* Removed HasUniqueDomainSignatureWithStringIdAttribute.
* Added IEquatable<TId> constraint on IEntityWithTypedId<TId>.
* Removed synchronous methods from repositories.
NEW FEATURES:
* SharpArch.NHibernate.DependencyInjection package.
* Asynchronous Transaction Manager.
* ASP.NET Core 3 / NetStandard2.1 support.
IMPROVEMENTS:
* More control over NHibernate configuration.
NEW FEATURES:
* SharpArch.NHibernate.DependencyInjection package;
* ASP.NET 3 / NetStandard2.1 support;
========================
S#arp 5.0
========================
BREAKING CHANGES:
* NetStandard2.0 support.
* Dropped Castle.Windsor integration for ASP.NET.
* New package SharpArch.Testing extracted from SharpArch.Testing.NUnit.
* SharpArch.NHibernate: NHibernateRepository.FindAll() now accepts IReadOnlyDictionary<> instead of IDictionary<>.
* SharpArch.Testing.NUnit renamed to SharpArch.Testing.NUnit.NHibernate:
* ISession.FlushAndEvict moved to SharpArch.NHibernate;
* Removed class SharpArch.Domain.FileCache;
* Binary serialization does not work for Type objects, see https://github.com/dotnet/corefx/issues/23213 - using FluentNHibernate for serialization
* TODO: introduce ISessionCache to support file and distributed caches (e.g. Redis)
NEW MODULES
* SharpArch.Testing.Xunit.NHibernate - xUnit test helper for NHibernate;
* TransitentDatabaseTests (RepositoryTestsBase) - base class for tests on transient database (in-memory SQLite database which is created
and initialized for every test);
* LiveDatabaseTests (DatabaseRepositoryTests) - run tests using shared database, every test runs in separate transaction, which is rolled back
after test execution completes.
========================
S#arp 4.0
========================
SharpArch.Web.Http.Castle
* [BREAKING] WindsorControllerExtensions renamed to WindsorHttpExtensions.
* [BREAKING] WindsorPropertyInjectionKernelExtensions replaced with internal SharpArch.Castle.Extensions.WindsorPropertyInjectionExtensions
(shared with SharpArch.Web.Mvc).
SharpArch.Web.Mvc
* [BREAKING] WindsorExtensions renamed to WindsorMvcExtensions.
* [BREAKING] TransactionAttribute will commit Transaction in OnActionExecuted, not in OnResultExecuted().
Recommended approach to access database in Controller, not View.
SharpArch.Testing.NUnit
* RepositoryTestsHelper refactored to TestDatabaseInitializer.
BREAKING CHANGES:
* target platform changed to .NET 4.5.
* #124 removed Command/Query infrastructure
* Now uses C# 6.0 syntax.
* NHibernateSession replaced with ISession constructor injection.
* #145 Removed Design by Contract, TestSyntaxHelpers and CommonServiceLocator code and deoendencies.
FIXES:
* #54 - NHibernate event listeners registered through xml gets removed.
NEW FEATURES:
* ASP.NET MVC Filter property injection with Castle.
* WebAPI Filter property injection (for singleton dependencies only).
SAMPLES:
* Samples are now part of main repository;
INTERNALS:
* Builds moved to Appveyour;
* Use GitVersion (https://github.com/GitTools/GitVersion) to maintain SemVer;
========================
S#arp Architecture 2.1.0
========================
* #60: Updated dependencies
------
Castle.Core 3.2.2^
Castle.Windsor 3.2.1^
FluentNHibernate 1.4^
NHibernate 3.3.3.4001^
RavenDB.Client 2.5.2750^
Iesi.Collections 3.3.3.4001^
Newtonsoft.Json 5.0.8^
Machine.Specifications 0.6.1^
System.Data.SQLite 1.0.90^
NUnit 2.6.3^
Moq 4.2.1312.1622^
------
==================================================
S#arp Architecture 2.1.0RC for Visual Studio 2010
==================================================
* #40: RavenDb support completed
* #44: Add IRepository.Delete(id)
-------
Assembly Dependencies ("^" notes upgraded dependencies):
+ Castle.Core 3.1.0^
+ Castle.Windsor 3.1.0^
+ FluentNHibernate 1.3.0.733^
+ NHibernate 3.3.2.4000^
+ NewtonSoft.Json 4.5.11^
+ RavenDB.Client 2.0.2230+
+ NUnit 2.6.2^
-------
==================================================
S#arp Architecture 2.0.3 for Visual Studio 2010
==================================================
Issues:
* #42: Show the expected/requested TResult in the exception message (Thanks Joel Purra @joelpurra).
* #41: Decorated the attribute classes with the AttributeUsageAttribute, to restrict usage of the attributes to their intended targets. (Thanks Sandor Drieënhuizen @sandord)
-------
Assembly Dependencies ("^" notes upgraded dependencies):
+ NHibernate 3.3^
+ FluentNHibernate 1.3.0.727
-------
==================================================
S#arp Architecture 2.0.0 for Visual Studio 2010
==================================================
Changes:
* Update solution structure and namespaces changed.
(SharpArch.Core => SharpArch.Domain)
(SharpArch.Data => SharpArch.Infrastructure)
(SharpArch.Web => SharpArch.Web.Mvc)
* Improved NuGet packaging.
* CQRS with ICommandHandler, IHandles and DomainEvents and NHibernateQuery abstract class
* Add ILinqRepository<> and query Specifications with implementation SharpArch.NHibernate.LinqRepository<>
* NHibernate runs DataAnnotations validation before persisting.
* EntityIdSetter and RepositoryTestsHelper moved to SharpArch.Testing.NUnit (Thanks Shatel)
* Remove ILMerging, seperate SharpArch packages for different features.
* Changes in the handling of NHibernateSessionFactory keys to allow for multi tenancy.
Issues:
* #36: HasUniqueDomainSignature overrides specified error message.
* #35: ModelBinder does not bind child entities
* #14: EntityDuplicateChecker does not check ValueObject properties with DomainSignature attribute
* #26: Allow the Id field of a form model to be nullable (Thanks @ZekeLv)
* #15: Explicit cast to Entity made on PreUpdate NHibernate listener
* #31: Explicit cast to Entity made on PreInsert NHibernate listener (Thanks @MartinHornagold)
-------
Assembly Dependencies ("^" notes upgraded dependencies):
+ CastleWindsor 3.0^
+ NHibernate 3.2^
+ FluentNHibernate 1.3^
+ NewtonSoft.Json 4.0^
-------
==================================================
S#arp Architecture 1.6.0 for Visual Studio 2008 and Visual Studio 2010
==================================================
New and exciting in this release:
* Added Configuration Caching for NHibernate (thanks Dan - SonOfMofo)
* Fluent NHibernate upgraded to 1.1.0.635. (thanks Seif)
* Added jquery.Validate.js and MicrosoftMvcJQueryValidation.js to generated web project and added references to them in master page. (thanks Igor)
* Generated CRUD forms enable client side validation. (thanks Igor)
* Updated factory assembly qualifier .svc file for Northwind sample Wcf.Web
* Updated invalid config sections in web.config for 2008 and 2010 templates
* Added NHibernateValidatorClientProvider and NHibernateValidatorProvider (thanks Igor)
* Added Parameter to rollback transaction when ModelState is invalid (thanks Inventti)
* Updated model binder to deal correctly with binding empty string to GUID Id types
* Updated the WcfSessionStorage class to automatically fall back to either a default (SimpleSessionStorage) or a session storage implementation of choice
whenever OperationContext.Current is null. This enables usage of NHibernate sessions in WCF host applications outside of WCF Operation methods without hassle.
whenever OperationContext.Current is null. This enables usage of NHibernate sessions in WCF host applications outside of WCF Operation methods without hassle.
-------
Assembly Dependencies ("^" notes upgraded dependencies)
+ FluentNhibernate.dll v1.1.0.635
- FluentNHibernate.dll v1.0.0.636
-------
Required Upgrade Steps and Changes:
Upgrading to S#arp Architecture 1.6 from 1.5.2 RTM requires the following steps:
#) SharpArch: Add the SharpArch.dll to your projects /lib and /tools/lib folders.
#) SharpArch: Add the FluentNHibernate.dll from the /bin to your /lib and /tools/lib folders.
#) SharpArch: Update the references in your project as needed
==================================================
S#arp Architecture 1.5.2 for Visual Studio 2008 and Visual Studio 2010
==================================================
New and exciting in this release:
* Merged the SharpArch.* assemblies into a single assembly (SharpArch.dll)
* Updated both VS 2008 and 2010 templates to reflect the use of the merged assembly
* Updated SharpArch.build with custom script that allows the merging of the assemblies. Copys new merged assembly in to the root /bin folder.
* Updated VS 2010 template to account for changes in T4 Toolbox. It is no longer neccessary to build the CrudScaffolding projects prior to their use. (thanks Igor)
* Updated CRUD scaffolding (both normal and enterprise) to use Html.LabelFor, Html.TextBoxFor, and Html.ValidationMessageFor crud templates. (thanks Igor)
* Updated Northwind sample to use merged assembly
* Fixed issues with BuildUrlFromExpressionForAreas (thanks Dan)
* Fixed issue with NHibernateSession.Init - it was possible to encounter a NullReferenceException. (thanks Dan)
* Added new Build bat file. ClickToBuildAndMerge.bat will build the solution and then merge the assemblies into one.
* Added Moq back to bin
* Updated the VS templates to reflect the proper tools reference in the cs.proj files. VS 2008 is now 3.5 and VS 2010 is now 4.0.
-------
Assembly Dependencies ("^" notes upgraded dependencies):
+ SharpArch.dll
- SharpArch.*.dll
-------
Required Upgrade Steps and Changes:
Upgrading to S#arp Architecture 1.5.2 from 1.5 RTM requires a few steps to accommodate upgraded dependencies (steps also reflected in the Northwind sample project and VS generated projects). For reference, each of the following steps is prefixed with the dependency that that the upgrade step is associated with:
#) SharpArch: Remove the SharpArch.*.dll from your projects /lib and /tools folders.
#) SharpArch: Add the SharpArch.dll to your projects /lib and /tools folders.
#) SharpArch: Remove the references to SharpArch.*.dll from all of your projects.
#) SharpArch: Add reference to SharpArch.dll to the projects that need references to any SharpArch.*.dll
==================================================
S#arp Architecture 1.5 for Visual Studio 2008 and Visual Studio 2010
==================================================
New and exciting in this release:
* Compatible with ASP.NET MVC 2.0 RTM
* Compatible with both Visual Studio 2008 and 2010 (Separate Templates)
* Upgraded dependencies including NHibernate 2.1.2.4, Fluent NHibernate 1.0.0.636, Castle.Core 1.2, Castle Windsor 2.1. See complete list below
* Added Enterprise CRUD scaffolding (thanks Billy)
* Updated CRUD scaffolding (both normal and enterprise) to make use of MVC Areas
* Updated Northwind sample to MVC 2 and updated assemblies.
* New SharpModelBinder.cs (thanks Michael Aird)
* Updated target platform to x86 from Any so that the SQL lite tests will pass
* Upgraded jQuery to 1.4.2
-------
Assembly Dependencies ("^" notes upgraded dependencies):
^ ASP.NET MVC 2.0
^ ASP.NET MVC 2.0 Futures
^ Castle Windsor 2.1
^ Fluent NHibernate 1.0.0.636 built against NHibernate 2.1.2
^ jQuery 1.4.2
* Json.NET 3.5 Beta 4
* log4net 1.2.10.0
* Microsoft.Practices.ServiceLocation 1.0 (aka, "Common Service Locator")
^ MvcContrib 2.0.36.0
^ NHibernate 2.1.2.4000
^ NHibernate.Linq 1.1.0.1001
^ NHibernate.Validator 1.2.0.3001
^ NUnit 2.5.0.9122 (Installer in /tools)
^ Rhino.Mocks 3.6.0.0
* System.Data.SQLite.DLL 1.0.60.0
* T4 Toolbox 10.3 (Installer in /tools)
-------
Required Upgrade Steps and Changes:
#) T4 Toolbox: Uninstall your current version and install the latest found in the /tools directory.
#) Grab the latest dependencies from /bin and copy them to YourProject/lib and YourProject/tools/lib. To make it easy to figure out which DLLs go into which folder, create a new project with the included VS Project Template and copy the DLLs out of the lib folders, respectively.
#) Follow the instructions at http://www.asp.net/learn/whitepapers/aspnet-mvc2-upgrade-notes/ (skip steps 7 and 8) for upgrading your web project to an MVC 2 application.
Upgrading to S#arp Architecture 1.5 RTM from 1.0 RTM requires a few steps to accommodate upgraded dependencies (steps also reflected in the Northwind sample project and VS generated projects). For reference, each of the following steps is prefixed with the dependency that that the upgrade step is associated with:
#) ASP.NET MVC: If you have any previous versions of ASP.NET MVC 2 installed, you must uninstall them and optionally may install ASP.NET MVC 2.0
#) T4 Toolbox: Uninstall any previous version of T4 Toolbox and install T4 Toolbox 10.3 (installer found in /tools)
#) T4 Toolbox: Replace your version of CrudScaffolding with updated version from http://github.com/codai/Sharp-Architecture/tree/master/src/NorthwindSample/tools/CrudScaffolding/
#) Enterprise Crud Scaffolding: Create a new project from the updated templates and add the CrudScaffoldingForEnterpriseApps project located at /<New Project Name>/Tools/CrudScaffoldingForEnterpriseApp to your project. You will then need to create a folder named "schema" under the /db folder.
#) SharpArch: To easily update all the assembly references in your existing project, create a new project using the S#arp Architecture VS project template and copy the assemblies from /lib and /tools/lib to your project's respective folders (You could also copy them from the trunk's /bin folder, but using a generated project is simpler.)
#) SharpArch: Within YourProject.Web/Global.asax.cs, add AreaRegistration.RegisterAllAreas(); just above RouteRegistrar.RegisterRoutesTo(RouteTable.Routes);
#) Castle: Within YourProject.Tests/App.config, configure assemly redirects to reflect the following:
<runtime>
<assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">
<dependentAssembly>
<assemblyIdentity name="Castle.Windsor" publicKeyToken="407dd0808d44fbdc" culture="neutral"/>
<bindingRedirect oldVersion="0.0.0.0-65535.65535.65535.65535" newVersion="2.1.0.0"/>
</dependentAssembly>
</assemblyBinding>
</runtime>
#) Castle: Within YourProject.Web/Web.config, configure assemly redirects to reflect the following:
<runtime>
<assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">
<dependentAssembly>
<assemblyIdentity name="Castle.Windsor" publicKeyToken="407dd0808d44fbdc" culture="neutral"/>
<bindingRedirect oldVersion="0.0.0.0-65535.65535.65535.65535" newVersion="2.1.0.0"/>
</dependentAssembly>
</assemblyBinding>
</runtime>
#) Areas: If you currently use areas, you will need to add an AreaRegistration file. The naming convention is <Area Name>AreaRegistration. To see an example file please go here:
http://github.com/codai/Sharp-Architecture/tree/master/src/NorthwindSample/app/Northwind.Web.Controllers/Organization/OrganizationAreaRegistration.cs
You will need to convert your YourProject.Web.Controllers/RouteRegistrar.cs to use normal MVC 2 Map Routes. If my existing file looks as such:
using System.Web.Mvc;
using System.Web.Routing;
using SharpArch.Web.Areas;
namespace MyProject.Web.Controllers
{
public class RouteRegistrar
{
public static void RegisterRoutesTo(RouteCollection routes)
{
routes.IgnoreRoute("{resource}.axd/{*pathInfo}");
routes.IgnoreRoute("{*favicon}", new { favicon = @"(.*/)?favicon.ico(/.*)?" });
routes.IgnoreRoute("{*xsd}", new { xsd = @"(.*/)?.xsd(/.*)?" });
routes.IgnoreRoute("{*css}", new { css = @"(.*/)?.css(/.*)?" });
routes.CreateArea("Administration/Scaffolding", "MyProject.Web.Controllers.Administration.Scaffolding",
routes.MapRoute(null, "Administration/Scaffolding/{controller}/{action}/{id}", new { action = "Index", id = "" })
);
routes.CreateArea("Administration", "MyProject.Web.Controllers.Administration",
routes.MapRoute(null, "Administration/FacilityOperations/{action}/{id}", new{ controller = "FacilityOperations", action = "Index", id = ""}),
routes.MapRoute(null, "Administration/{controller}/{action}/{id}", new { controller = "Administration", action = "Index", id = "" })
);
//Root Area
routes.CreateArea("Default", "MyProject.Web.Controllers",
routes.MapRoute(null, "Fax/Refax/{faxNumber}/{id}/{message}", new { controller="Fax", action="Refax", faxNumber = "", id = "", message = "" }),
routes.MapRoute("ScheduleGrid", "Schedule/Show/{encId}/{departmentId}", new { controller = "Schedule", action = "Show", encId="", departmentId="" }),
routes.MapRoute("SchedulePopUp", "Schedule/PopUp/{encId}/{departmentId}", new { controller = "Schedule", action = "PopUp", encId = "", departmentId = "" }),
routes.MapRoute(null, "{controller}/{action}/{id}", new { controller = "Home", action = "Index", id = "" })
);
}
}
}
It would look like this after my conversion:
using System.Web.Mvc;
using System.Web.Routing;
using SharpArch.Web.Areas;
namespace MyProject.Web.Controllers
{
public class RouteRegistrar
{
public static void RegisterRoutesTo(RouteCollection routes)
{
routes.IgnoreRoute("{resource}.axd/{*pathInfo}");
routes.IgnoreRoute("{*favicon}", new { favicon = @"(.*/)?favicon.ico(/.*)?" });
routes.IgnoreRoute("{*xsd}", new { xsd = @"(.*/)?.xsd(/.*)?" });
routes.IgnoreRoute("{*css}", new { css = @"(.*/)?.css(/.*)?" });
routes.MapRoute(null, "Fax/Refax/{faxNumber}/{id}/{message}", new { controller="Fax", action="Refax", faxNumber = "", id = UrlParameter.Optional, message = "" });
routes.MapRoute("ScheduleGrid", "Schedule/Show/{encId}/{departmentId}", new { controller = "Schedule", action = "Show", encId=UrlParameter.Optional, departmentId=UrlParameter.Optional });
routes.MapRoute("SchedulePopUp", "Schedule/PopUp/{encId}/{departmentId}", new { controller = "Schedule", action = "PopUp", encId = UrlParameter.Optional, departmentId = UrlParameter.Optional });
routes.MapRoute(null, "{controller}/{action}/{id}", new { controller = "Home", action = "Index", id = UrlParameter.Optional });
}
}
}
-------
Change Log
Due to the amount of changes that occured with the conversion to MVC 2, an accurate record was not kept. This upgrade should be considered as volatile when upgrading a previous version. In most cases, there will be no issues,
while others with large customized projects could encounter issues.
==================================================
S#arp Architecture 1.0 Q3 2009 for Visual Studio 2008
==================================================
New and exciting in this release:
* Upgraded dependencies including NHibernate 2.1.1 GA, Fluent NHibernate 1.0 and NHibernate LINQ 1.0
* New Many-to-Many convention added to VS project template (thanks John Ledger!)
* New DB schema generation (as a unit test) added to VS project template (thanks indomitablehef!)
* VS generated project now uses the HiLo algorithm for identity generation
* S#arp Architecture is now HornGet compatible (http://preview.tinyurl.com/ydoolwh)
* S#arp Architecture has moved to GitHub (http://github.com/codai/Sharp-Architecture)
* The wiki documentation has gotten much more complete (http://wiki.sharparchitecture.net)
* A contrib project, led by Tom Cabanski, is well underway (http://wiki.sharparchitecture.net/SharpArchContrib.ashx)
* WCF support within S#arp Architecture has been deprecated...it's moving to Sharp Contrib
-------
Assembly Dependencies ("^" notes upgraded dependencies):
* ASP.NET MVC 1.0
* ASP.NET MVC 1.0 Futures
^ Castle Windsor 2.0
^ Fluent NHibernate 1.0.0.594 built with NHibernate 2.1.1 GA
* jQuery 1.3.2
^ Json.NET 3.5 Release 5
* log4net 1.2.10.0
* Microsoft.Practices.ServiceLocation 1.0 (aka, "Common Service Locator")
^ MvcContrib 1.0.0.9
^ NHibernate 2.1.1 GA
^ NHibernate.Linq 1.0.0.4000 (rev 1101) built with NHibernate 2.1.1 GA
^ NHibernate.Validator 1.2.0.2003 (rev 1101) built with NHibernate 2.1.1 GA
^ NUnit NUnit-2.5.2.9222.msi (Installer in /tools)
^ Rhino.Mocks 3.6
* System.Data.SQLite.DLL 1.0.60.0
* T4 Toolbox 9.5.20.1 (Installer in /tools - not upgraded to latest available)
-------
Required Upgrade Steps and Changes:
#) Grab the latest dependencies from /bin and copy them to YourProject/lib and YourProject/tools/lib. To make it easy to figure out which DLLs go into which folder, create a new project with the included VS Project Template and copy the DLLs out of the lib folders, respectively.
#) Fluent NHibernate: Some breaking changes were introduced with the latest Fluent NHibernate. With many kudos to Tom Cabanski, he has written three blog posts describing upgrade steps from 1.0 RTM and changes made to the code:
1) http://tomcabanski.spaces.live.com/blog/cns!E0D3617496209F45!124.entry
2) http://tomcabanski.spaces.live.com/blog/cns!E0D3617496209F45!125.entry
3) http://tomcabanski.spaces.live.com/blog/cns!E0D3617496209F45!166.entry
#) NUnit: Install NUnit 2.5.2 using the installer found in /tools (optionally uninstalling previous versions)
#) Castle: Within YourProject.Tests/App.config, you may drop the following assembly redirect if it exists:
<runtime>
<assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">
<dependentAssembly>
<assemblyIdentity name="Castle.Windsor" publicKeyToken="407dd0808d44fbdc" culture="neutral"/>
<bindingRedirect oldVersion="0.0.0.0-65535.65535.65535.65535" newVersion="2.0.0.0"/>
</dependentAssembly>
</assemblyBinding>
</runtime>
-------
Change Log
SharpArch.Core:
* /PersistenceSupport/IDbContext.cs: Modified BeginTransaction to return an IDisposable for use with the "using" statment. (Issue 17)
SharpArch.Data:
* /NHibernate/DbContext.cs: Now returns the ITransaction as IDisposable for use with "using" statements. (Issue 17)
* /NHibernate/NHibernateSession.cs:
- Modified ConfigureNHibernate() to allow configuration of NHibernate without a config file; allows you to use FNH exclusively. (Patch from Kyle)
- GetSessionFactoryFor() now returns null if the supplied factory key was not found; this would previously blow up.
SharpArch.Tests:
* /SharpArch.Data/NHibernateSessionTests.cs: Added this set of tests to demonstrate how to initialize NHibernate with and without a config file.
SharpArch.VsSharpArchTemplate
* Added MvcContrib.FluentHtml to YourProject.Web along with namespace inclusion in its web.config
* Removed WCF assemblies from VS generated project (these are moving to the Contrib project)
* /SharpArchApplicationTemplate/SharpArchProject.Data/NHibernateMaps/Conventions/PrimaryKeyConvention.cs: Changed default Id generation to use the HiLo algorithm. Requires a hibernate_unique_key table with a next_hi int column. (Issue 5)
* /SharpArchApplicationTemplate/SharpArchProject.Data/NHibernateMaps/Conventions/ForeignKeyConvention.cs, HasManyToManyConvention.cs, ManyToManyTableNameConvention.cs: Added classes to support Many-to-Many convention.
* /SharpArchApplicationTemplate/SharpArchProject.Data/NHibernateMaps/AutoPersistenceModelGenerator.cs: Modified GetConventions() to account for new Many-to-Many convention.
* /SharpArchApplicationTemplate/SharpArchProject.Tests/SharpArchProject.Data/NHibernateMaps/MappingIntegrationTests.cs: Added CanGenerateDatabaseSchema() test to output database schema SQL to console.
SharpArch.Web:
* /ModelBinder/EntityCollectionValueProviderResult.cs: Fixed problem with GUID Ids. (Issue 12)
----------------------------------------------
----------------------------------------------
S#arp Architecture 1.0 RTM
----------------------------------------------
----------------------------------------------
New and exciting in this release:
* Compatible with ASP.NET MVC 1.0
* All upgraded dependencies including NHibernate 2.1 CR 1
* We now have a community site at http://www.sharparchitecture.net, still a work in progress (a flippin' ginormous thank you to Kyle Baley for setting this up)
* S#arp Architecture documentation may now be found at http://wiki.sharparchitecture.net, still a work in progress (a huge thanks to Joe Lowrance for migrating the docs)
* Strongly typed action link for areas (SharpArch.Web.Areas.ActionLinkForAreas<> and BuildUrlFromExpressionForAreas<> - thanks Brad Buhrkuhl!)
* Fluent NHibernate now using configuration classes
* (Re)Introduced support for IIS 7 integrated mode
* Support for WCF has been added as SharpArch.Wcf for server support and SharpArch.WcfClient.Castle for auto-closing of the connection on the client (thanks Frank Laub!)
* SharpModelBinder has been introduced for much better form binding, including support for all association types; e.g., one-to-one, one-to-many, and many-to-one Entity associations
* Support for multiple databases outside of WCF communications (thanks Russell Thatcher, David Longnecker, James Broome and Howard van Rooijen for suggestions and input!)
-------
Assembly Dependencies:
* ASP.NET MVC 1.0
* ASP.NET MVC 1.0 Futures
* Castle Windsor 2.0
* Fluent NHibernate 0.1 (rev 539) built against NHibernate 2.1 CR 1
* jQuery 1.3.2
* Json.NET 3.5 Beta 4
* log4net 1.2.10.0
* Microsoft.Practices.ServiceLocation 1.0 (aka, "Common Service Locator")
* MvcContrib for MVC 1.0 (rev 959)
* NHibernate 2.1.0.3001 (2.1 CR 1)
* NHibernate.Linq 1.0 (rev 935)
* NHibernate.Validator 1.2.0.1004 (rev 935)
* NUnit 2.5.0.9122 (Installer in /tools)
* Rhino.Mocks 3.5.0.1337
* System.Data.SQLite.DLL 1.0.60.0
* T4 Toolbox 9.5.20.1 (Installer in /tools)
-------
Required Upgrade Steps
Upgrading to S#arp Architecture 1.0 RTM from RC 2 requires a few steps to accommodate upgraded dependencies (steps also reflected in the Northwind sample project and VS generated projects). For reference, each of the following steps is prefixed with the dependency that that the upgrade step is associated with:
#) ASP.NET MVC: If you have any previous versions of ASP.NET MVC installed, you must uninstall them and optionally may install ASP.NET MVC 1.0
#) NUnit: Install NUnit 2.5 using the installer found within /tools (optionally uninstalling previous versions)
#) NUnit: Drop any usings of "using NUnit.Framework.SyntaxHelpers;" - this namespace no longer exists and has been merged into the NUnit.Framework namespace
#) NUnit: Change any use of ExpectedException attributes to use Assert.Throws instead; see http://mint.litemedia.se/2009/05/30/new-expectedexception-model-in-nunit-25/ for details
#) T4 Toolbox: Uninstall any previous version of T4 Toolbox and install T4 Toolbox 9.5.20.1 (installer found in /tools)
#) T4 Toolbox: Replace your version of CrudScaffolding/EntityScaffoldingDetails.tt and CrudScaffolding/Templates/ScaffoldingGenerator.tt with updated versions from http://sharp-architecture.googlecode.com/svn/trunk/src/NorthwindSample/tools/CrudScaffolding/
#) SharpArch: To easily update all the assembly references in your existing project, create a new project using the S#arp Architecture VS project template and copy the assemblies from /lib and /tools/lib to your project's respective folders (You could also copy them from the trunk's /bin folder, but using a generated project is simpler.)
#) SharpArch: Within YourProject.Tests/YourProject.Data/NHibernateMaps/MappingIntegrationTests.cs, add a reference to "using SharpArch.Testing.NHibernate;" to accommodate the move of RepositoryTestsHelper to the new namespace.
#) SharpArch: Upgrade YourProject.Tests/YourProject.Data/NHibernateMaps/MappingIntegrationTests.cs to accommodate the changes that were made to support multiple databases (if not done, you will likely have breaking unit tests). To do so, compare your MappingIntegrationTests.cs to the one at http://sharp-architecture.googlecode.com/svn/trunk/src/NorthwindSample/tests/Northwind.Tests/Northwind.Data/NHibernateMaps/MappingIntegrationTests.cs. The necessary change is the introduction of the session factory key.
#) SharpArch: Within YourProject.Web/Global.asax.cs, migrate the call to NHibernateSession.Init() from the Global.asax.cs class' Init() method to its Application_BeginRequest() method using the following as an example: http://sharp-architecture.googlecode.com/svn/trunk/src/NorthwindSample/app/Northwind.Web/Global.asax.cs
#) Fluent NHibernate: Within Fluent NHibernate class maps and overrides, replace .WithKeyColumn("YourColumnName") with .KeyColumnNames.Add("YourColumnName")
#) Fluent NHibernate: If you're using Fluent NHibernate Auto Mapping, upgrade to Fluent NHibernate class conventions within YourProject.Data (You can look at the Northwind sample project for implementation examples but the Northwind DB is far from consistent and so there's an assortment of conventions and overrides in the Northwind sample project; accordingly, you'll have better luck having VS generate a S#arp Architecture project and then look at the internals of the generated project.):
*) Add a folder under /NHibernateMaps and add convention classes (see VS generated project for examples)
*) Within /NHibernateMaps/AutoPersistenceModelGenerator.cs, modify mappings setup to use new convention-per-class approach (see VS generated project for example)
*) See http://wiki.fluentnhibernate.org/show/ConvertingToNewStyleConventions for further guidance
#) NHibernate: Within YourProject.Tests.YourProject.Data.NHibernateMaps.MappingIntegrationTests.cs, modify CanConfirmDatabaseMatchesMappings() to reflect the following:
[Test]
public void CanConfirmDatabaseMatchesMappings() {
IDictionary<string, IClassMetadata> allClassMetadata =
NHibernateSession.SessionFactory.GetAllClassMetadata();
foreach (KeyValuePair<string, IClassMetadata> entry in allClassMetadata) {
NHibernateSession.Current.CreateCriteria(entry.Value.GetMappedClass(EntityMode.Poco))
.SetMaxResults(0).List();
}
}
#) NHibernate: Within YourProject.Tests, add a reference to NHibernate.ByteCode.Castle.dll
#) NHibernate: Within YourProject.Web, add a reference to NHibernate.ByteCode.Castle.dll
#) Castle: Within YourProject.Tests/App.config, configure assemly redirects to reflect the following:
<runtime>
<assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">
<dependentAssembly>
<assemblyIdentity name="Castle.Windsor" publicKeyToken="407dd0808d44fbdc" culture="neutral"/>
<bindingRedirect oldVersion="0.0.0.0-65535.65535.65535.65535" newVersion="2.0.0.0"/>
</dependentAssembly>
</assemblyBinding>
</runtime>
#) Castle: Within YourProject.Web/Web.config, configure assemly redirects to reflect the following:
<runtime>
<assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">
<dependentAssembly>
<assemblyIdentity name="Castle.Windsor" publicKeyToken="407dd0808d44fbdc" culture="neutral"/>
<bindingRedirect oldVersion="0.0.0.0-65535.65535.65535.65535" newVersion="2.0.0.0"/>
</dependentAssembly>
</assemblyBinding>
</runtime>
#) NHibernate: Within YourProject.Tests/Hibernate.cfg.xml, add the following property:
<property name="proxyfactory.factory_class">NHibernate.ByteCode.Castle.ProxyFactoryFactory, NHibernate.ByteCode.Castle</property>
#) NHibernate: Within YourProject.Web/NHibernate.config, add the following property:
<property name="proxyfactory.factory_class">NHibernate.ByteCode.Castle.ProxyFactoryFactory, NHibernate.ByteCode.Castle</property>
-------
Change Log
Solution Wide Changes:
* Updated all dependencies; only NHibernate and Fluent NHibernate had breaking changes, which were addresed in the upgrade steps above
=======
Changes to SharpArch:
SharpArch.Core:
* Possibly BREAKING CHANGE (but not likely) ~ /DomainModel/BaseObject.cs: Changed HasSameObjectSignatureAs() to be public instead of protected since GetSignatureProperties() is also public and is a useful method to expose. This will cause a build error if you've overridden this method; to fix, simply change the visibility of the overridden method to public.
* /DomainModel/BaseObjectEqualityComparer.cs: Added this class to provide support for LINQ set operators, such as Intersect.
* /DomainModel/Entity.cs: Modified the GetHashCode to cache the hashcode calculation and to use the object's Id in the calculation for persistent objects. This was done because GetHashCode() was previously ignoring the Id property for Entities; therefore, two Entity instances which didn't have any domain signature properties were returning different hashcode values even if they had the same Id.
SharpArch.Data:
* Possibly BREAKING CHANGE (but not likely) ~ /NHibernate/DbContext.cs: Removed singleton behavior and added constructor parameter for session factory key to support multiple databases.
* /NHibernate/EntityDuplicateChecker.cs: Added factory key lookup for support of multiple databases.
* Possibly BREAKING CHANGE (but not likely) ~ /NHibernate/ISessionStorage.cs: Added FactoryKey property to support look-up for multiple database support and also moved this interface to its own file - I prefer having one class/interface per file.
* /NHibernate/NHibernateInitializer.cs: Added this class to assist with initializing the NHibernate session once and only once; this was introduced to help support running in IIS 7 integrated mode.
* Possibly BREAKING CHANGE (but not likely) ~ /NHibernate/NHibernateSession.cs: Changed SessionFactory and Storage to be Dictionary objects to support multiple databases; added plural named properties of each, accordingly. The singular version remain for backward compatibility and to make it easier to maintain a single database application.
* /NHibernate/NHibernateSession.cs: Within CreateSessionFactoryFor(), added ".ConventionDiscovery.AddAssembly(assembly);" calls after "m.FluentMappings.AddFromAssembly(assembly)" for altering non-automapped conventions. (Issue-101)
* /NHibernate/Repository.cs: Added factory key lookup for support of multiple databases. Also now passing factory key to DB context, accordingly.
* /NHibernate/SessionFactoryAttribute.cs: Introduced this attribute to be used on repositories to designate which session factory its associated with. It does not need to be used for single database scenarios or for your "default" database.
SharpArch.Testing.NUnit/MbUnit:
* /NHibernate/RepositoryTestsHelper.cs: Dropped the previously 4th parameter, a bool for formatting, to support the modified signature of NHibernate's SchemaExport.Execute()
* BREAKING CHANGE ~ /NHibernate/RepositoryTestsHelper.cs: Moved this helper class to SharpArch.Testing.NHibernate as it does not have dependencies on NUnit nor on MbUnit
SharpArch.Web:
* /CommonValidator/MvcValidationAdapter.cs: Added method overload to allow custom prefix to model state errors instead of the class name.
* /ModelBinder/EntityValueProviderResult.cs: Added support for Guid Ids
SharpArch.Wcf:
* Added this class library to support WCF. WCF does NOT currently support multiple databases.
SharpArch.Web
* /Areas/LinkForAreasExtensions.cs: Added this class to provide the strongly typed ActionLinkForAreas<> and BuildUrlFromExpressionForAreas<>.
* /Areas/LinkForAreasExtensions.cs: Added this class to provide the strongly typed ActionLinkForAreas<> and BuildUrlFromExpressionForAreas<>. Accordingly, you can now replace hardcoded links to areas with Html.ActionLinkForAreas<>. You'll also likely want to add the following to your web.config's namespaces tag so that you don't have to import it for every ActionLinkForAreas: <add namespace="SharpArch.Web.Areas" />
* /CommonValidator/ValidatableModelBinder.cs: Marked this as obsolete in favor of using SharpModelBinder (referenced next)
* /ModelBinder/SharpModelBinder.cs: Added this model binder to replace the use of DefaultModelBinder (see documentation for details)
* /ModelBinder/EntityValueProviderResult.cs: Added this support class for SharpModelBinder (see documentation for details)
* /NHibernate/WebSessionStorage: Added overloaded constructor to accept a factory key to support multiple database sessions.
* /NHibernate/TransactionAttribute: Added option for passing in factory key to support multiple database. Also modified this transaction to rollback the transaction if a problem is encountered.
=======
Changes to Northwind (all changes also made to VS project template and Employee CRUD pages):
CrudScaffolding
* /Templates/Tests/Web/Controllers/ControllerTestsTemplate.tt: Modified CanEnsureEntityNameCreationIsValid() to account for fact that ModelState is not being modified during testing (it'll redirect due to invalid entity, but it won't show errors in the ModelState by default)
* /Templates/Web/Controllers/ControllerTemplate.tt:
- Added an EntityNameFormViewModel as a DTO between the controller and the entity form in both the Create/Edit (GET) action methods
- Modified Create/Edit (POST) to account for SharpModelBinder behavior
* /Templates/Web/Views/DomainObjectFormTemplate.tt:
- Replaced "id" hidden input id to be "EntityName.Id" to support SharpModelBinder
- Now inherits from ViewUserControl with a generic parameter of a form view model DTO to make it easier to send other items to the form such as lists for drop down boxes
- Changed hidden "id" input to be named "EntityName.Id" to support binding within SharpModelBinder
- Changed cancel button to use Html.BuildUrlFromExpression instead of hardcoding the back link
* /Templates/Web/Views/EditTemplate.tt:
- Got rid of redundant passing of ViewData to user control
- Added use of enum for looking for page message so that the ViewData index is strongly typed
* /Templates/Web/Views/IndexTemplate.tt: Now using Html.BuildUrlFromExpression for the URL behind the cancel button (more strongly typed)
* /Templates/Web/Views/Show.tt: Wrapped all outputs within Server.HtmlEncode() to protect against JavaScript injection attacks
* /Templates/Web/Views/*.tt: Changed <h2> to <h1> at top of pages since they're primary page titles
Northwind.Tests
* /Northwind.Data/NHibernateMaps/MappingIntegrationTests.cs: Introduced factory key to isolate the integration tests session factory from the other tests. Also set the SessionFactory and Storage to null before and after running the test for backwards compatibility reasons; in this way, existing tests that assume a single database don't have to be modified to account for the fact that a different session factory is being used by the MappingIntegrationTests class.
Northwind.Web
* /Global.asax.cs:
- Added SharpModelBinder as the default binder with "ModelBinders.Binders.DefaultBinder = new SharpModelBinder();"
- Moved initialization of NHibernate session to Application_BeginRequest with new NHibernateInitializer to support IIS 7 integrated mode
Northwind.Web.Controllers
* /ControllerEnums.cs: Added this class to hold, at the very least, a strongly typed enum for global items added to ViewData.
----------------------------------------------
----------------------------------------------
S#arp Architecture 1.0.48.410 RC 2 with ASP.NET MVC RC 2 and NHibernate 2.0.1
----------------------------------------------
----------------------------------------------
Version Acknowledgements:
* A huge thanks goes out to Kyle Baley and Simone Busoli who have been tremendously assistive to the #Arch community and the project during this recent push
New and exciting in this release:
* Compatible with ASP.NET MVC RC 2
* VS template project includes Fluent NHibernate auto persistence mapping by default
* Much more complete and extensible CRUD scaffolding generator - it's completely touch-up free for many scenarios
* Performance of unit tests using SQLite has been improved 20% (thanks Jay Oliver!)
* Added crazy cool anti-forgery voodoo magic to the CRUD scaffolding generator for creating, editing and deleting items (uh, thanks MVC team!)
* New empty class library, called YourProject.ApplicationServices, now gets added to VS generated projects
* S#arp Architecture now has a CI home with http://teamcity.codebetter.com/overview.html (thanks Kyle and Simone!)
-------
Assembly Dependencies:
* ASP.NET MVC RC 2
* ASP.NET MVC RC 1 Futures
* Castle 1.0 RC3 (rev 1038)
* Fluent NHibernate 0.1 (rev 381 - Does NOT include very recent Fluent NHibernate convention interfaces)
* jQuery 1.3.2
* Json.NET 3.5 Beta 2
* Microsoft.Practices.ServiceLocation 1.0 (aka, "Common Service Locator")
* MvcContrib for MVC RC (rev 903)
* NHibernate 2.0.1 GA
* NHibernate.Validator 1.2.0 (rev 809)
* NUnit 2.4.8
* Rhino.Mocks 3.5.0.1337
* System.Data.SQLite.DLL 1.0.60.0
* T4 Toolbox 9.1.20.1
-------
Upgrading to S#arp Architecture RC 2 from Beta (steps also reflected in the Northwind sample project):
#) If you have any previous versions of ASP.NET MVC installed, uninstall them and install ASP.NET MVC RC 2
#) Install NUnit 2.4.8
#) Upgrade T4 Toolbox to 9.1.20.1 AND PATCH IT, following the instructions in the "Installing and Configuring Prerequisites" of the documentation
#) Update assembly dependencies from trunk/bin into your application's lib and /tools/lib folders
#) Modify using statements from "using NHibernate.Validator;" to "using NHibernate.Validator.Constraints;"
#) Change all reference to anyEntity.ID to anyEntity.Id.
#) Add the following assembly redirect to YourProject.Web/web.config and YourProject.Tests/App.config (since some dependencies will be looking for an older version of Iesi.Collections):
<dependentAssembly>
<assemblyIdentity name="Iesi.Collections" publicKeyToken="AA95F207798DFDB4" culture="neutral"/>
<bindingRedirect oldVersion="0.0.0.0-65535.65535.65535.65535" newVersion="1.0.1.0"/>
</dependentAssembly>
#) Within your Fluent NHibernate mapping files, rename .IsInverse() to .Inverse()
#) If you're using Fluent NHibernate auto mapping persistence, do the following account for the fact that you can no longer inherit from AutoMap:
1) For each class that inherits from AutoMap, remove the AutoMap inheritance and implement IAutoMappingOverride<YourEntity> instead.
2) Move the contents of the constructor, which sets up the overrides, to the body of the following, prefixing each line with "map.":
public void Override(AutoMap<YourEntity> mapping) {
// Your mapping overrides; e.g., mapping.Id(...);
}
3) Within YourProject.Data.NHibernateMaps.AutoPersistenceModelGenerator, append the following extension method to the mappings creation:
.MapConventionOverridesFromAssemblyOf<YourEntityClassMapName>();
#) Update YourProject.Web/Scripts/jquery*.js with 1.3.2 versions available in Northwind sample project
#) Update YourProject.Web/Views/web.config to reflect the respective content from the Northwind sample project
#) Within YourProject.Web/Global.asax.cs, change the following line:
container.RegisterControllersByArea(typeof(HomeController).Assembly);
to:
container.RegisterControllers(typeof(HomeController).Assembly);
#) Within YourProject.Web/Global.asax.cs, modify the Init() to reflect the locking mechanism shown within
#) Within YourProject.Tests/App.config, update the nunit assembly redirect to go to version 2.4.8.0
#) Change calls to EntityIdSetter<>.SetIdOf() to EntityIdSetter.SetIdOf<>()
#) Update your Site.master to provide an overwritable title and to account for a known bug in MVC RC 1, described at http://haacked.com/archive/2009/01/27/controls-collection-cannot-be-modified-issue-with-asp.net-mvc-rc1.aspx
#) Either replace your CrudScaffolding project with a duplicate of the one from the Northwind project or use the guidance discussed in the below change log for modifications
#) (Optional) Add the following line to Global.asax.cs to Application_Start if you're client side code looks for dot-notation in generated input names:
HtmlHelper.IdAttributeDotReplacement = ".";
#) (Optional) Add Northwind.Web/Scripts/jquery-1.2.6.min-vsdoc.js and jquery-1.2.6-vsdoc.js to your project to enable jQuery IntelliSense
#) (Optional) Get rid of the code behind pages in favor of ViewMasterPage, ViewPage<Whatever>, ViewUserControl<Whatever> inheritance in the view's Master/Page/Control declaration. E.g.: Inherits="System.Web.Mvc.ViewPage<Employee>". Be sure to include System.Web.Mvc before ViewPage and either move your domain imports ABOVE the page declaration or fully qualify the namespaces of your model object.
#) (Optional) Add MvcBuildViews to YourProject.Web.csproj and alter the Target/AfterBuild, following the details in the ASP.NET MVC RC release notes
-------
Changes to /src:
Solution Wide:
* BREAKING CHANGE ~ Changed Entity.ID to Entity.Id for compliance with naming conventions (When you upgrade, don't do a simple find and replace as you'll change IDictionary, GUID and other such items; also pay attention when updating your IAutoPersistenceModelGenerator)
VS Project Template:
* A CommonAssemblyInfo.cs is now included and added to all projects
* A YourProject.ApplicationServices class libraries now comes automatically with VS generated projects
CrudScaffolding Generator:
* ScaffoldingGeneratorCommand.tt: Commented out "generator.Run()" by default to avoid inadvertent code generation
* Added reference to SharpArch.Core to have design by contract capablities
* Added reference to Inflector.Net.Inflector for pluralizing words
* Added assembly inclusion at the top of /Templates/BaseTemplate.tt and ScaffoldingGenerator.tt
* Replaced all references to "Pluralizer.ToPlural" with "Inflector.Net.Inflector.Pluralize"
* Modified /Templates/Web/Views/*.tt page/control declarations, and added imports where necessary, to support removal of code-behind pages
* Deleted Pluralizer.tt in favor of using Inflector.Net
* Deleted /Templates/Data/NHibernateMaps/ClassMapTemplate.tt due to VS project template and Northwind now using Fluent NHibernate auto persistence model
* Deleted /Templates/Web/Views/GeneralCodeBehindTemplate.tt and GeneralDesignerTemplate.tt because they're no longer necessary (nor recommended)
* Deleted /ScaffoldingEnums.tt as the enum has been moved to the newly added /EntityScaffoldingDetails.tt; had to also drop the include of this file from /Templates/ScaffoldingGenerator.tt
* Within /Templates/ScaffoldingGenerator.tt:
- Dropped import of GeneralCodeBehindTemplate.tt, GeneralDesignerTemplate.tt and Pluralizer.tt
- Dropped move of code behind and designer pages from MoveViewFilesTo()
- Dropped GenerateGeneralCodeBehindAndDesignerForViewPage() and all calls to it
- Dropped all calls to GeneralCodeBehindTemplate and GeneralDesignerTemplate
* Added /EntityScaffoldingDetails.tt to have a more expressive and complete means of generating entities
* Replaced all use of namespaceHierarchy, domainObjectName, properties, and artifactsToGenerate with instance of entityScaffoldingDetails; e.g.,
- Replaced parameter set "domainObjectName, properties, namespaceHierarchy" with "entityScaffoldingDetails"
- Replaced "domainObjectName" with "entityScaffoldingDetails.EntityName"
- Replaced "namespaceHierarchy" with "entityScaffoldingDetails.NamespaceHierarchy"
- Replaced "artifactsToGenerate" with "entityScaffoldingDetails.ArtifactsToGenerate"
- Replaced "DomainObjectNamePlural" with "entityScaffoldingDetails.EntityNamePlural"
* Moved plural and camel case helper methods from /Templates/BaseTemplate.tt to EntityScaffoldingDetails.tt
* Added BaseTemplate.EntityBaseUrl to be able to retrieve the base URL of the entity being generated
* In each template, changed each constructor to accept EntityScaffoldingDetails and pass it to the constructor of BaseTemplate.tt
* Changed constructor of BaseTemplate.tt to accept EntityScaffoldingDetails and share it as a protected value to subclass templates
* Changed templates as follows (in this order):
- Replaced "DomainObjectNamePluralCamelCase" with "EntityScaffoldingDetails.EntityNamePluralCamelCase"
- Replaced "DomainObjectNamePlural" with "EntityScaffoldingDetails.EntityNamePlural"
- Replaced "DomainObjectNameCamelCase" with "EntityScaffoldingDetails.EntityNameCamelCase"
- Replaced "DomainObjectName" with "EntityScaffoldingDetails.EntityName"
- Carefully replaced "NamespaceHierarchy" with "EntityScaffoldingDetails.NamespaceHierarchy"
- Replaced "foreach (string propertyName in Properties.AllKey)" with "foreach (EntityProperty property in EntityScaffoldingDetails.EntityProperties)" and adjusted loop accordingly
* Within /Templates/Tests/Core/Web/Controllers/ControllerTestsTemplate.tt, deleted CanEnsureEntityCreationIsValid() method; it's doesn't prove anything with the new use of ModelState.IsValid on form submissions
SharpArch.Core
* /DomainModel/BaseObject.cs: Modified Equals() to account for the fact that an object may be proxied by NHibernate when compared.
* /DomainModel/Entity.cs: Id is now excluded for XML serialization; see documentation FAQ for work around for Id serialization.
* /DomainModel/ValueObject.cs: == and != operator overloads have been added.
* /DomainModel/ValidatableObject.cs: This new class extracts the concrete validation that was being performed in Entity into a reusable superclass. (Entity now inherits from it.)
* BREAKING CHANGE ~ /PersistenceSupport/IRepository.cs: Changed GetAll and FindAll to return an IList rather than a List to be more loosely coupled.
* BREAKING CHANGE ~ /PersistenceSupport/NHibernate/INHibernateRepository.cs: Changed FindAll to return an IList rather than a List to be more loosely coupled.
SharpArch.Data
* Between RC 1 and 2, added and then removed /NHibernate/FluentNHibernate/IAutoPeristenceModelConventionOverride.cs: In the RC 1 compatible code, I added this interface to serve as a base class for any Fluent NHibernate override classes; this was introduced because it's no longer allowed to inherit from AutoMap<> for overriding conventions. For RC 2, James Gregory, developer of Fluent NHibernate, was kind enough to port these capabilities into Fluent NHibernate itself; so this interface has been dropped in RC 2.
* Between RC 1 and 2, added and then removed /NHibernate/FluentNHibernate/AutoPersistenceModelExtensions.cs: In the RC 1 compatible code, I added this extension to AutoPersistenceModel to automatically apply any override classes from a specific assembly. With James Gregory's port of this functionality to Fluent NHibernate, this class has been dropped in the RC 2 compatible code.
* /NHibernate/Repository.cs: Changed GetAll and FindAll to return an IList rather than a List to be more loosely coupled.
* /NHibernate/NHibernateRepository.cs: Changed FindAll to return an IList rather than a List to be more loosely coupled.
SharpArch.Testing
* BREAKING CHANGE ~ /EntityIdSetter.cs: Changed use of EntityIdSetter from EntityIdSetter<>.SetIdOf() to EntityIdSetter.SetIdOf<>()
SharpArch.Web
* /Areas/AreaViewEngine.cs: Added a needed "useCache" variable to FindPartialView() and FindView() for RC compatibility
* /CommonValidator/ValidatableModelBinder.cs: This new class inherits DefaultModelBinder to introduce domain driven validation to the binding process. (This is in contrast to the MVC IDataErrorInfo which uses exceptions for raising validation issues. See the class comments for more information.)
SharpArch.Web.Castle
* WindsorExtensions.cs: Dropped RegisterController() and RegisterControllersByArea() extension methods; MvCContrib has this fixed now - so need need for the extensions anymore.
Northwind - All Projects
* Added CommonAssemblyInfo.cs to all projects and removed duplicate assembly info attributes.
Northwind.ApplicationServices
* New class library to hold application services (see Evans' Domain Driven Design for more info about application services)
Northwind.Web
* Within Northwind.Web.csproj (and VS project template), added post compiler step as outlined in http://webdevdotnet.blogspot.com/2009/02/aspnet-mvc-rc-compiler-post-build-step.html* Renamed Hibernate.cfg.xml to NHibernate.config so that you can't browse to it on the web server
* Global.asax.cs:
- Passed location of NHibernate.config to NHibernateSession.Init()
- For RC 1, I had within Application_Start, I added "ModelBinders.Binders.DefaultBinder = new ValidatableModelBinder();" to replace the default binder with one that seamlessly integrates CommonValidator capabilities; for RC 2 (the current release), I've removed this again to have more consistent post behavior between Create and Edit
* /Scripts/jquery*.js: Updated to 1.3.2
* /Views/Organization/Employees/Index.aspx: Changed the delete link to an input button within a form which includes an anti-forgery token; deletes should only happen via POST requests for better security
Northwind.Web.Controllers
* /Organization/EmployeesController.cs:
- Replaced validation mechanism with ModelState.IsValid which now leverages ValidatableModelBinder
- Moved transfer of form properties to persistent object to within ModelState.IsValid path
- Dropped RollbackTransaction since it's no longer necessary
- Dropped use of MvcValidationAdapter.TransferValidationMessagesTo since it's done via ValidatableModelBinder
- Added ValidateAntiForgeryToken to the post actions
Northwind.Tests
* /Northwind.Data/NHibernateMaps/MappingIntegrationTests.cs: Renamed "Hibernate.cfg.xml" parameter to "NHibernate.config" (discussed under Northwind.Web changes)
----------------------------------------------
----------------------------------------------
1.0 Beta (rev 337) - S#arp Architecture for ASP.NET MVC Beta with NHibernate 2.0.1
----------------------------------------------
----------------------------------------------
New and exciting in this release:
* CRUD Scaffolding generation is now available
* Added CommonServiceLocator to provide IoC agnosticism to the non-web layers
* You no longer need to register custom repositories to Castle Windsor...it's now done with voodoo magic (thanks Kyle Baley for the voodoo magic!)
* Added formal solution structure to help organize applications
* View "areas" are seamlessly supported as subfolders under the Views folder
* You no longer need to install ASP.NET MVC to create and edit S#arp Architecture projects
* NHibernate auto mapping is now available (thanks Jay Oliver!)
* Validation is now abstracted, similarly to CommonServiceLocator...use NHibernate Validator out of the box or supply your own! (thanks Luis Abreu for being a pain in the arse until this change was made! ;)
-------
Assembly Dependencies:
* ASP.NET MVC Beta
* Castle 1.0 RC3
* Fluent NHibernate 0.1 (rev 207)
* Json.NET 3.5 Beta 2
* Microsoft.Practices.ServiceLocation 1.0 (CommonServiceLocator)
* NHibernate 2.0.1
* NHibernate.Validator 1.0
* MvcContrib Beta (rev 697)
* Rhino.Mocks 3.5.0.1337
* System.Data.SQLite.DLL 1.0.60.0
-------
Changes to /src:
SharpArch Solution
* All projects are now strongly signed with exception of SharpArch.Web.Castle (The MvcContrib dependency isn't signed; there's only one class in this SharpArch library, so you can move it to your project to sign everything.)
* Added support for Fluent NHibernate automapping (see http://groups.google.com/group/sharp-architecture/browse_thread/thread/ef799cfe75835cb4/468c6c18ae1cd239 for patch details which have been applied)
SharpArch.Core
* BaseObject.cs ~ Introduced this base class to consolidate object comparison functionality used by both DomainObject and ValueObject
* BREAKING CHANGE ~ EnumDescription.cs: This class has been dropped from the library; it doesn't have anything to do with S#arp Architecture; if you miss it dearly, you can find it described at http://devlicio.us/blogs/billy_mccafferty/archive/2006/10/16/Show-User_2D00_Friendly-enum-Translations.aspx
* BREAKING CHANGE ~ Renamed IDomainObject.cs to IValidatable.cs to reflect what it's really doing; also simplified IValidatable to contain simply IsValid()
* BREAKING CHANGE ~ Dropped DomainObject.cs and PersistentObject.cs and replaced them with Entity.cs which now exists in /DomainModel namespace. Here are steps to take to accommodate:
1) Do a solution wide find and replace of "PersistentObject" with "Entity"
2) Change every call to ".ValidationMessages" to ".ValidationResults()"
3) Manually add "using SharpArch.Core.DomainModel;" onto every page having an Entity
* ValueObject.cs: Added this value-object base class to support this missing base class for DDD
* See http://groups.google.com/group/sharp-architecture/browse_thread/thread/6c8e626535a47219 for a more thorough summary of the changes to SharpArch.Core and the validation infrastructure
SharpArch.Data
* BREAKING CHANGE ~ Renamed Repository.GetByProperties(), Repository.GetUniqueByProperties(), Repository.GetByExample(), Repository.GetUniqueByExample() to FindAll(properties/example) and FindOne(properties/example)
* BREAKING CHANGE ~ Repository.cs: This now implements the simpler IRepository<> instead of INHibernateRepository<>; Moved the NHibernate specific methods Get(id, lockMode), Load(id), Load(id, lockMode), FindAll(exampleInstance), FindOne(exampleInstance), Save(entity), Update(entity), Evict(entity) to NHibernateRepository<>; If you write a custom repository which needs to implement methods from INHibernateRepository<>, you'll want to inherit from this new NHibernateRepository<> class
* /NHibernate/NHibernateSession.cs: Added RegisterInterceptor(IInterceptor) to be optionally invoked after you've initialized NHibernate configuration
SharpArch.Web
* /Areas/AreaRouteHelper.cs: New class for supporting controller/view "areas"
* /Areas/AreaViewEngine.cs: New class for replacing the default view engine for supporting use of areas
* /JsonNet/JsonNetResult.cs: New ActionResult for returning Json.NET result
* BREAKING CHANGE ~ /CommonValidator/MvcValidationAdapter.cs: Moved from /NHibernate/Validator/MvcValidationAdapter.cs
SharpArch.Web.Castle
* Added this library to house extension methods for Castle related to registering controllers and custom repositories
Northwind Solution
* Modified solution structure to reflect the following
/MyProject - Contains MyProject.sln
/app - Contains the core project layers.
/MyProject.Core
/MyProject.Data
/MyProject.Web
/MyProject.Web.Controllers
/lib - Contains the solution items for the deployable application.
/db - Contains database schema information; e.g., the result of scaffolding and/or NHibernate's schema export.
/docs - Project documents.
/logs - Output location for log files.
/tests
/MyProject.Tests
/tools
/build - Empty folder for housing build related stuff.