THE SPRING.NET FRAMEWORK, Release 3.0.0 (PRE-RELEASE)
The 3.0.0 release of Spring.NET contains
- A full featured Inversion of Control container
- An Aspect Oriented Programming framework
- Expression Language for lightweight scripting
- UI-agnostic validation framework
- ASP.NET Framework
- Dependency Injection for pages and user controls, bi-directional data binding, and more.
- ASP.NET MVC and ASP.NET WebAPI Framework
- Dependency Injection for MVC (includin WebAPI).
- Declarative transaction management abstraction
- Declarative transaction management via use of common XML configuration and attributes across different transaction APIs
- ADO.NET framework
- Simplifies use of ADO.NET. DAO support classes and integration with Spring's declarative transaction management functionality
- Portable Service Abstractions
- Export plain .NET objects via .NET Remoting, Web Service or .NET Serviced Component and create client side proxies based on endpoint URL and service interface.
- NHibernate Integation
- NHibernate 5 integration to simplify use of NHibernate and participate in Spring's declarative transaction management functionality.
- ASP.NET AJAX Integration
- NUnit and MSTest integration
- Provides Dependency Injection of test cases and Spring container loading and caching. . Data access and transaction management features aid with integration testing.
- WCF integration
- Provides Dependency Injection and applicatin of AOP advice to WCF services
- Quartz integration
- Configure Quartz jobs using dependency injection and Spring's transactional support to persist job details
- MSMQ integration
- Simplifies the use MSMQ by providing helper classes for message sending and receiving. Integrates with Spring's transaction management features.
- NMS integration
- Simplifies the use of NMS by providing helper classes for message sending and receiving.
- TIBCO EMS integration
- Simplifies the use of TIBCO EMS by providing helper classes for message sending and receiving.
- NVelocity integration
- Simplifies the use of configuring NVelocity
Spring.NET is a port of the Java based Spring Framework. In turn, the Java/J2EE Spring Framework is based on code published in "Expert One-on-One J2EE Design and Development" by Rod Johnson (Wrox, 2002).
2. SUPPORTED .NET FRAMEWORK VERSIONS
Spring.NET 3.0.0 supports .NET 4.5.2 and .NET Standard 2.0 and later.
3. KNOWN ISSUES
4. RELEASE INFO
- "src" contains the C# source files for the framework
- "test" contains the C# source files for Spring.NET's test suite
- "bin" contains various Spring.NET distribution dll files
- "lib/Net" contains shared third-party libraries needed for building the framework
- "lib/NHibernate3" contains NHibernate 3.3 dlls
- "doc" contains reference documentation, MSDN-style API help, and the Spring.NET xsd.
- "examples" contains sample applications.
- "build-support" contains additonal applications need to build using NAnt as some convenience VS.NET solution files.
- "dev-support" contains 'developer support' tools and code, such as solution templates for VS.NET
debug build is done using /DEBUG:full and release build using /DEBUG:pdbonly flags.
The VS.NET solution for the framework and examples are provided.
Latest info is available at the public website: http://www.springframework.net/
The Spring Framework is released under the terms of the Apache Software License (see license.txt).
5. DISTRIBUTION DLLs
The "bin" directory contains the following distinct dll files for use in applications. Dependencies are those other than on the .NET BCL.
Spring.Core (~765 KB)
- Contents: Inversion of control container. Collection classes.
- Dependencies: Common.Logging
Spring.Aop (~150 KB)
- Contents: Abstract Oriented Programming Framework.
- Dependencies: Spring.Core, Common.Logging
Spring.Data (~320 KB)
- Contents: Transaction and ADO.NET Framework.
- Dependencies: Spring.Core, Spring.Aop
Spring.Data.NHibernate5 (~90 KB)
- Contents: NHibernate 5.x integration
- Dependencies: Spring.Core, Spring.Aop, Spring.Data, NHibernate
Spring.Services (~70 KB)
- Contents: Web Services, Remoting, and Enterprise Component based services.
- Dependencies: Spring.Core, Spring.Aop
Spring.Web (~165 KB)
- Contents: ASP.NET based Web Application Framework.
- Dependencies: Spring.Core, Spring.Aop
Spring.Web.Extensions (~8 KB)
- Contents: ASP.NET AJAX Integartion
- Dependencies: Spring.Core, Spring.Aop, System.Web.Extensions
Spring.Web.Mvc5 (~8 KB)
- Contents: ASP.NET MVC5 and WebAPI Integartion
- Dependencies: Spring.Core, Spring.Web
Spring.Testing.NUnit (~24 KB)
- Contents: NUnit Integration
- Dependencies: Spring.Core, Spring.Data, NUnit
Spring.Testing.Microsoft (~24 KB)
- Contents: MSTest Integration
- Dependencies: Spring.Core, Spring.Data, MSTest
Spring.Messaging (~65 KB)
- Contents: MSMQ Integration
- Dependencies: Spring.Core, Spring.Data, System.Messaging
Spring.Messaging.Nms (~100 KB)
- Contents: NMS Integration
- Dependencies: Spring.Core, Spring.Data, Apache NMS
Spring.Scheduling.Quartz3 (~44 KB)
- Contents: Quartz32.x Integration
- Dependencies: Spring.Core, Spring.Data, Quartz
Spring.Template.Velocity (~44 KB)
- Contents: NVelocity Integration
- Dependencies: Spring.Core, NVelocity
6. WHERE TO START?
Documentation can be found in the "docs" directory:
- The Spring reference documentation
Documented sample applications can be found in "examples":
- IoCQuickStart.MovieFinder - A simple example demonstrating basic IoC container behavior.
- IoCQuickStart.AppContext - Show use of various IApplicationContext features.
- IoCQuickStart.EventRegistry - Show use of loosely coupled eventing features.
- AopQuickStart - Show use of AOP features.
- CachingQuickStart - Show use of Caching abstraction.
- SpringAir - Show use of Spring.Web features.
- Calculator - Show use of Spring.Services features.
- WebQuickStart - Show step by step usage of Spring.Web features.
- Web.Extensions.Example - Show ASP.NET AJAX integartion.
- DataQuickStart - Show use of Spring.Data data access features.
- TxQuickStart - Show use of Spring's transaction features.
- Data.NHibernate.Northwind - Show use of Spring's NHibernate features.
- WCFQuickStart - Show use of DI and AOP with WCF
- NMSQuickStart - Sample application using NMS
- MSMQ QuickStart - Sample application using MSMQ
- Quartz Example - Scheduling using Quartz
- Mvc5QuickStart - Show the configuration of the ASP.NET MVC 5 support
7. How to build
Visual Studio 2017 is required to open and build the solution. The free community version of Visual Studio should suffice.
For the first time you need to execute
Build.cmd which will generate
GenCommonAssemblyInfo.cs file required for builds.
Build scripts are delivered with the download package.
To build the source and run the unit tests type
If you want to run the build to create strongly signed assemblies you can generate a key file by executing the following command (assuming that sn.exe is properly on your search path):
sn -k Spring.Net.snk
You need to place the Spring.NET.snk file into the root folder of the source tree. All builds are strongly named using this key file when executing the following nant command:
InnovaSys Document X! is used to generate the SDK documentation.
The user forums at http://forum.springframework.net/ are available for you to submit questions, support requests, and interact with other Spring.NET users.
Bug and issue tracking can be found at https://jira.springsource.org/browse/SPRNET
A Fisheye repository browser is located at https://fisheye.springframework.org/browse/spring-net
To get the sources, fork us on github at https://github.com/SpringSource/spring-net
We are always happy to receive your feedback on the forums. If you think you found a bug, have an improvement suggestion or feature request, please submit a ticket in JIRA (see link above).
A word on bug reports: If at all possible, try to download one of the nightly snapshots at http://www.springframework.net/downloads/nightly/ and see, if this bug has already been fixed. If the problem still persists, don't forget to mention the version of Spring.NET you are using (check the file versions of Spring.NET dlls), the .NET version you are running on and a description how to reproduce the problem. Ideally attach some sample code reproducing the problem to the JIRA ticket.
InnovaSys Document X!
InnovSys has kindly provided a license to generate the SDK documentation and supporting utilities for integration with Visual Studio.