Skip to content

megadotnet/ironframework

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 

Repository files navigation

Iron Framework

Join the chat at https://gitter.im/IronFramework Build status

Introduction

Domain Driven Design(DDD),Layered architecture,Aspect-oriented programming(AOP) rapid development infrastructure focus on enterprise solution based on Microsoft .Net Framework and .net Core. Combine with Entity Framework/Core, Enterprise Library, WCF, Asp.net MVC

On the Road: .Net Core / ASP.net Core

components implement:

  • Layered Architecture
  • DDD (Domain Driven Design),
  • AOP (Aspect-oriented programming)
  • Service-Oriented Architecture

There architectural styles offer flexible extension and rapid developed infrastructure.

Technology and Software Requirements

Technology

  1. C# with T4 template
  2. WCF
  3. Net framework and .Net Core
  4. Asp.net Core
  5. Silverlight
  6. Visual Studio 2013/2015/2017
  7. TFS 2013/2015/2017 (option)
  8. Web Deployment Server/ IIS 7.5 or later
  9. Windows Server 2012/2016 (option)
  10. SQL Server 2012/2014/2016 Enterprise(option)
  11. OData

Components and libraries:

  1. ADO.Net
  2. Entity Framework
  3. Entity Framework Core
  4. Enterprise Library
  5. Newtonsoft.Json for .net
  6. Moq
  7. NLOG
  8. ASP.NET MVC with MvcScaffolding
  9. WCF Web API Preview framework
  10. ASP.NET WebAPI
  11. The SQL Server AdventureWorks sample database (option)
  12. AutoFixture with xUnit.net
  13. BCrypt.Net
  14. Glimpse

Design Goals and Non-Goals

Goals

Using emerging technique and extremely popular architectural style based on Microsoft .net platform to construct enterprise common rapid developed framework. Demonstrate some reuse library and coding trick and design skill that we have accumulated.

Non-Goals

It is not cover all about Domain Driven Design (DDD). Domain Driven Design is much more than Architecture and Design Patterns. It implies a specific way of working for development teams and their relationship with Domain experts, a good identification of Domain Model elements (Aggregates/Entity Model, etc.) based on the Ubiquitous Language for every Model we can have, identification of Bounded-Contexts related to models, and a long etcetera related to the application life cycle that we are not covering.

Architecture

Design Principles

De-coupling between Components

The de-coupling techniques are based on the Principle of Dependency Inversion, which sets forth a special manner of de-coupling, where the traditional dependency relationship used in object orientation (high-level layers should depend on lower-level layers), is inverted. The goal is to have layers independent from the implementation and specific details of other layers, and therefore, independent from the underlying technologies as well.

There are several techniques and patterns used for this purpose, such as Plug-in, Service Locator, Dependency Injection and IoC (Inversion of Control).

Basically, the main techniques we propose to enable de-coupling between components are:

  • Inversion of control (IoC)
  • Dependency injection (DI)

Architectural Patterns and Design Patterns in project

  • Model View Controller (MVC)
  • Model View View Model (MVVM)
  • Repository
  • Unit of Work/Context (UoW)
  • Lazy Load
  • Eager Load
  • Domain model
  • Server layer
  • Data Mapped
  • Data Transfer Object (DTO)
  • Plain old CLR object (POCO)

Basic Principle

  • SOLID
  • DRP
  • KISS
  • The separation of Concern

You have to know above design patterns and architectural patterns that help you understand architect of framework.

Architectural diagram

Below is a cross-section that shows some of the technologies used and the communication between the layers. The right-hand-side shows some of the key design patterns used in the reference application.

The four tiers or layers are:

  • Presentation layer — handles external interaction with the user
  • Service layer — interactive with presentation layer and provider a data service
  • Business layer — manipulates the information required by the user
  • Database layer — stores the data handled by the system

We have two leveled IOC/DI they are data access layer and business layer in project. Each layer use own DI container. Business object interface register object with xml file to unity container. Data access interface register object in memory to unity container. You may unify one container or nested container to resolve all objects.

For business object we prefer use AOP approach that block executed method here then to do common function. It is usually called crossing concern. We have sample demo in unit test project.

If you do not need the Service layer, UI layer can be directly invoke Business layer that performance would be more efficiently.

Enterprise library 5 has remove caching call handler base on Http Runtime Cache. We have implemented it by .net framework 4 System.Runtime.Caching.

General, exception logging will locate as ErrorRolling.logfilename filename format at BO Service folder. It is at bin folder for Unit test project. It is also specific custom output path.

Technical features:

  • Asp.net MVC Razor engine
  • Dependency injection with Asp.net MVC
  • Asp.net WebForm support the strongly typed data binding model and custom paging data server controls.
  • Hierarchical data model work with JQuery Plug-in.
  • Microsoft .Net Framework 4 new Caching engine support
  • Entity framework POCO and T4 template code generation
  • Cross cutting with Enterprise library application block
  • Dependency injection with Unity DI container
  • WCF RESTful service based on WCF 4 Service
  • HTTP API with ASP.NET WEB API
  • Repository and Unit of work Pattern
  • Unit test with the Moq framework
  • Custom paging data server control
  • Enterprise Library extension

Data Access Infrastructure

Introduction

The Data Layer (DL) handles the persistence of Business Objects. It offers two providers: ADO.NET and ADO.Net Entities Framework. Today the Entity Framework source code is being released under an open source license (Apache 2.0), and the code repository will be hosted on CodePlex to further increase development transparency.

Database First With Entity Framework

Entity Framework provides support for all these development styles and scenarios. We know that Entity Framework operates on the EDM, and lets us create this EDM in three ways in order to cater to the different development styles:

  • Database First: This is the approach that will be used with an existing database schema. In this approach, the EDM will be created from the database schema. This approach is best suited for applications that use an already existing database.

In a Database First approach, the main beneit that the developers have is that if the database is created, they will spend very little time writing the data access layer. The EDM can be created from the database and then we can change it as per our application needs; our data access layer is ready to use. Here are a few scenarios where the Database First approach is very useful:

  • When we are working with a legacy database.
  • When we are working in a scenario where the database design is being done by another team of DBAs, and once the database is ready, the application development starts.
  • When we are working on a data centric application, that is, the application domain model is the database itself, and it is being changed frequently to cater to new requirements. For instance, when the tables are being updated regularly and new columns are being added to it frequently then we can simply use this approach, and the application code will not break. We simply have to write the code to cater to the newly added columns.

IRepository.tt template will generate those data access class. By default, data access type provider work with Entity Framework. AdventureWorks.Context.tt template will generate entity framework data access context type. We have modified the default the ADO.NET DbContext Generator template which from Entity framework 5 then added WCF data member attribute. It is can get it from NuGet.

In the Web.config/App.Config file you may indicate which one to use. ADO.NET implements a 'data provider factory' which uses an abstract factory pattern and returns database specific singleton factories.You may implement your own data access layer with data repository interface.

  <connectionStrings>
    <add name="AdventureWorksEntities" connectionString="metadata=res://*/AdventureWorks.csdl|res://*/AdventureWorks.ssdl|res://*/AdventureWorks.msl;provider=System.Data.SqlClient;provider connection string=&quot;Data Source=.;Initial Catalog=AdventureWorks;Integrated Security=True;MultipleActiveResultSets=True&quot;" providerName="System.Data.EntityClient" />
  </connectionStrings>
 Note: Those templates depend on EDMX file that based on your database model design first.

Database model example (snapshot from AdventureWorks.edmx):

Repository Class Diagram

Data transfer Object layer

Why DTOs? DTOs are simple objects that should not contain any business logic that would require testing. DTOs are most commonly used by the Services layer in an N-Tier application to transfer data between itself and the UI layer. The main benefit here is that it reduces the amount of data that needs to be sent across the wire in distributed applications. They also make great models in the MVC pattern. The framework support transfer the Entity framework model to View Model. DTO Object used to the View Model for presentation. The difference between data transfer objects and business objects or data access objects is that a DTO does not have any behavior except for storage and retrieval of its own data (accessors and mutators).

Business Object layer

Using AdventureWorks.tt T4 template generate entities POCO mode class as business entities. Business object project include business rules and business objects. We put the core business logic in this project.

Business Objects encapsulate business logic in the form of business rules. Business Objects themselves have no knowledge about databases or data persistence, which is handled by the Data access layer.

Service layer

It is implemented by WCF 4 service. It is include data contract interface and service implement. The WCF Service Layer receives messages from the PL. It interprets the message, unpacks the Data Transfer Objects, and orchestrates and coordinates the interaction between Business Objects and Data Access Objects.

We will expose the OData API structure in the future.

WCF Service

Windows Communication Foundation comes with a rich set of security features such as transport level message and transport with message; each security type has its own advantages and overheads as well. The best possible solution is message level security using custom username - password authentication.

Installing the certificate and setup

Download the Pluralsight SelfCert from the link given at the beginning of the article. Run the tool as Administrator;

1.Generate certificate with name: localhost or use IIS Express ssl

2.Then you should update proxy project(ServiceProxy).

3.Copy client identity section from app.config to web.config. Ex:

    <identity>
      <certificate encodedValue="AwAAAAEAAAAUAAAAbPq3/ENbW9Sn901o2naxkhhTVPggAAAAAQAAALQEAAAwggSwMIICmKADAgECAhAXT2zJ/YUhrEk4ipNRbpwtMA0GCSqGSIb3DQEBBQUAMBQxEjAQBgNVBAMTCU15V2NmU2l0ZTAeFw0xNzA2MjIxNjAwMDBaFw0yNzA2MjkxNjAwMDBaMBQxEjAQBgNVBAMTCU15V2NmU2l0ZTCCAiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIBAMDjMDqv+DXmNq3I/tf3ar6UViSc8O7/njE/u/UzmOZkKUrbYkmV0dmJNJHLNeF87SpeI8/BYuuYkK8/We3IrAvyXkTZ3hBH3rwJwrgW+XgrY8c9fNMlLPY+mhJZXbjP63B471whP52E3oaXaXciiYN99f1G7FvfoXvxXfnkUS7CVUofhQDXy5ZwgDZehKEpDKwFbXVospAUjh/Ky607IoUwca5a7VkIynaeBg016pZVyExrFuq4PCA5YOZOXBeYu54luTBRJm7YSLVwVly0L8zMNZmPtJFGXeS464vJvMdG2eO5Vq7kZ+zUC2E0qvHFqsI+nxtWPFkSKbMQ20IN/DLpbN4gFKlAWr+RgJJwtvdv2ZNdw+kV84LFAB0Mb7oq5oG2swsHhqQkPiUa9f4kfCXhXu8dM9qy5y/+4Lei7L59ZfIvBm5RXiix12f0xB3m7ps6N6dxWULdw1SIDbcBvgj0IxlfPyiRUKswOtam1TbHrlQYB+ogReMTtynyqFEXBjrLtLwZpj2CMGlSJbDkuGXO9f45AZ01vjl0UzY8jW7JL0iK804xijLrdcQB2GJTClYeu5XVF1kENKUd5S12USMrTvuL/wXmwZKLUSLMu5lGMRTZXFOpj/5mAUiSGuT0mFAYaxjSLFtTWJA0+m2IJrRh0slzQlpnIBpzYyjFqHIlAgMBAAEwDQYJKoZIhvcNAQEFBQADggIBAGDmbKZ8p5ipeONAipgNUs/uMwJNSR0bQpV38qRZlPo+8WKCmSPZ62KHTIbBpNsdqJzx9bWgSdjbWii4+lfRykts+KwvInuG1Dq9gUea4ICjUULbbXfGUiwPK4Gkr+HtTfCijK63MC+ByMlXCdYlOxMsaWgf50LRx/pTDRmUZTETbTevCKTun9lcZFPAnzOXPiIDsLcLpGfswHpp/R9y/Bn1K00txMuhGumREASZ5xYkM1DVKTBRl1vBmZka+J2cyaV8jR/JJEOyumJvWkn/mviyVSFQFvMjVot32nv1UI1kLurn/sLTR7RpkhytXctFfbM86NH85FQ/fOqbfy6Ughf/INZVj5A/MXMUfKDLXDVDrzIaZ416OSTw6sgdBQeTNwuEhTBXUsnnYpSrWiRSZlyANwYbDPhvdlwoLPpbGuyvRgGFXNZVtXweDiKzOt16SHBV2yTuWXjQeFzYGWpKpFmXWmpV1Dk1nfkDkhGcFOoN3e736acBj7a0w/HfnCz6b732N4xHBfHt1FGxq8Hl9DPx4+29cI2htTkCP6wEGQf1Mti76RE7mBuJ2Stjtmiuc1LwPD+4Y1QTPaczq11ITucWU3XXitEVF2TpY8mfsgNZbIQ1qCuQSX4hZSN+82k4mqcXcLOSoexhmnA24HdAL1r0/GJsuznN8K9hKS0wcnyu" />
    </identity>

RESTful Service

It is implemented REST Service by WCF 4 Web API and Asp.net Web API

WCF Web API history

For several years now the WCF team has been working on adding support for REST. This resulted in several flavors of REST support in WCF: WCF Web HTTP, WCF REST Starter Kit, and then finally WCF Web API. In parallel the ASP.NET MVC team shipped support for building basic web APIs by returning JSON data from a controller. Having multiple ways to do REST at Microsoft was confusing and forced our customers to choose between two partial solutions. So, several months ago the WCF and ASP.NET teams were merged together and tasked with creating a single integrated web API framework. The result is ASP.NET Web API.

Here is a simply CRUD method in it. The Class diagram like this:

We use Fiddler test it, assume you have deployed Service from URL:

http://localhost:20333/RESTEmployeeService.svc

When debug WCF REST service we suggest you set configuration section like this:

<serviceDebugincludeExceptionDetailInFaults="true" />

We also can use WCF Web API to do unit test with REST service.

Web API (Http API)

Authentication

Web API assumes that authentication happens in the host. For web-hosting, the host is IIS, which uses HTTP modules for authentication. You can configure your project to use any of the authentication modules built in to IIS or ASP.NET, or write your own HTTP module to perform custom authentication.

HMAC based authentication

HMAC (hash-based message authentication code) provides a relatively simple way to authenticate HTTP messages using a secret that is known to both client and server. Unlike basic authentication it does not require transport level encryption (HTTPS), which makes its an appealing choice in certain scenarios. Moreover, it guarantees message integrity (prevents malicious third parties from modifying contents of the message).

On the other hand proper HMAC authentication implementation requires slightly more work than basic HTTP authentication and not all client platforms support it out of the box (most of them support cryptographic algorithms required to implement it though).

API Documents

It has integrated swagger for HTTP API.Swagger is the world’s largest framework of API developer tools for the OpenAPI Specification(OAS), enabling development across the entire API lifecycle, from design and documentation, to test and deployment.

http://localhost:3956/swagger/

Presentation layer

The concern of the Presentation Layer (PL) is to present information in a consistent and easy-to-understand manner to the end-user. It includes fully functional implementations of three UI platforms: ASP.NET Web Form 4, ASP.NET MVC 3/4 and WPF (Windows Presentation Foundation). Each of UI platforms consumes the exact same services hosted under WCF. This service-oriented model is an implementation of the Application Facade Design Pattern. Applications designed this way have the ability to expose their Services (Web or otherwise) with no extra work (other than configuring the WCF host). WCF is truly a powerful new platform!

You will find asp.net MVC unit testing project in the solution. We may use the TDD approach develop it through whole life cycle.

Asp.net MVC Application

Razor provides a great new view-engine option that is streamlined for code-focused tempting. It is syntax is compact and reduces typing – while at the same time improving the overall readability of your markup and code.

Asp.net Web Form Application

One of features that implement the strongly typed data binding model and the custom paging data server controls.

Cross cutting

It is implemented by Enterprise library and Unity. We use unity implement interception and Dependency injection then block method to do something that we wanted.

Unity configuration: constructor Parameters with EF DbContext Injection and lifecycle time

  <register  type="IEmployeeBusinessObject" mapTo="EmployeeBusinessObject"   name="NoOLazyloadedAndProxyCreated">
    <!--<lifetime type="singleton" />-->
    <constructor>
      <param name="lazyloaded" value="false"/>
      <param name="proxycreated" value="false"/>
    </constructor>
    <interceptor type="TransparentProxyInterceptor" />
    <policyInjection />
  </register >

Case1: Cross cutting with Validation, Logging, Caching

    [ValidationCallHandler]
[LogCallHandler(BeforeMessage = &quot;before GetEmployee&quot;, AfterMessage = &quot;after GetEmployee&quot;,IncludeCallStack = true)]
[CachingCallHandler(0, 10, 0, Order = 3)]
Employee GetEmployee([RangeValidator(1, RangeBoundaryType.Inclusive, int.MaxValue, RangeBoundaryType.Inclusive)] int pid);

Common and Utility Library

It is include the DTO class of UI and service factory which is warp unity implement DI, AOP features.

Unit Test

We use the xUnit.net with Unit testing project. So you may also use Test Driven plug-in or the Jetbrains ReSharpr plug-in or working on it conveniently.

Because application block work with plug mode of framework, please verify assemblies have reside against bin folder that test case of unit test work well.

For Asp.net MVC application

It is implementing separated with Model unit test for Controller of the asp.net MVC application. In the future, we will implement unit test with View Model.

For other components

It is including repository and WCF service unit test.

Business Object with Data access object

In DALConfig.xml files, we may switch FakeContextAdapter object, like following xml section:

<register  type="DataAccessObject.IObjectContext, DataAccessObject"
mapTo="DataAccessObject.FakeContextAdapter, DataAccessObject">
    <interceptor type="InterfaceInterceptor"/>
</register >

In Web.config or app.config, also keep App Setting key 'UsingXmlConfigForUnity' as true value

<appSettings>
  <add key="UsingXmlConfigForUnity" value="true" />
</appSettings>

If this appsetting not exist, application will use internal DI configuration.

Finally, we may get results from unit testing:

    [Theory, AutoData, AutoRollback]
public void TestAdd(AddressDto _AddressDto)
{
    var _AddressBO = new AddressBO(new FakeAddressConverter());
    bool hasAdded=_AddressBO.CreateEntiy(_AddressDto);
    Assert.True(hasAdded);
}

1 passed, 0 failed, 0 skipped, took 1.83 seconds (xUnit.net 1.9.2 build 1705).

Code Generation

T4 (Text Template Transformation Toolkit) template

In Visual Studio, a T4 text template is a mixture of text blocks and control logic that can generate a text file. The control logic is written as fragments of program code in Visual C# or Visual Basic. The generated file can be text of any kind, such as a Web page, or a resource file, or program source code in any language.

You will find other t4 template in other project. It is by default generate general simply logic code. You can modify it depends on your requirement.

The IronFramework bases its code generation on entity data models (edmx). Whether or not you are eventually using Entity Framework or another data access technology for interaction with your data sources, you are encouraged to define your data models via edmx.


DAO : IRepository.tt

Busniess Object : IBussinessBase.tt

DTO: : DTOGenerator.tt

HTTPAPI Controller : WebAPIControllerBase.tt

WebController : ControllerBase.tt

Deployment

First you need deploy Business object service as host in IIS or single process.

Then deploy website under IIS application folder.

Building

Command-line

Run this batch file from the directory where IronFramework.sln resides.

Usage: cmdbuild [debug | release] [output_path]

Example: cmdbuild debug c:\Ironframework-debug-build

System Quality Attributes

Reusability

It is intended to design The WCF service layer in a way that it is reusable by other applications as well.

Testability

The amount of effort required to create these tests is directly related to the testability of the underlying software.

Scalability

The system should scale to increased numbers of threads to be handled per unit time as well as when new forums are added.

Maintainability

Maintainability is important and the systems would lend itself to easy maintenance including feature additions and bug fixes due to the clear separation of the components into layers.

Appendix

Source Code

Asp.net MVC RTM framework

Asp.net Web

Entity Framework

Entity Framework Core

Enterprise Library

Glossary/Terms

Term Definition
AOP Aspect-oriented programming
DDD Domain Driven Design
POCO Plain old CLR object
T4 Text Template Transformation Toolkit

Feedbcak

Any feed always welcome. You can post here.

License

(The MIT License)

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the 'Software'), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.