今天我發(fā)布了新版本的Apworks，版本號為：2.5.4563.21309。有興趣和有需要的朋友可以直接到Apworks官方站點(diǎn)下載最新的安裝程序或源代碼。

功能更新

Apworks 2.5.4563.21309包含了以下功能更新：

支持Visual Studio 2010的項(xiàng)目模板以及相關(guān)說明書（中英文兩個(gè)版本），下文會(huì)對其進(jìn)行介紹

將整個(gè)框架的ID類型由System.Long換成System.Guid

新增WcfPerRequestLifetimeManager

添加基于Entity Framework Code First的倉儲(chǔ)實(shí)現(xiàn)

倉儲(chǔ)中添加了“饑餓加載”功能，用于在懶加載（Lazy Loading）的環(huán)境下，指定某些需要直接加載的實(shí)體屬性

倉儲(chǔ)中添加了“分頁”功能，能夠支持邏輯相對簡單的分頁效果。如需實(shí)現(xiàn)復(fù)雜的分頁功能，可以參考《Byteart Retail V2 - 基于Entity Framework Code First的領(lǐng)域驅(qū)動(dòng)設(shè)計(jì)實(shí)踐案例》一文中“面向特定需求的倉儲(chǔ)接口”部分的內(nèi)容

新增Apworks.Services.ApplicationServices命名空間，并在此命名空間下實(shí)現(xiàn)了DataTransferObject類型，用以支持?jǐn)?shù)據(jù)傳輸對象的設(shè)計(jì)

所有第三方組件更新到最新穩(wěn)定版本

修復(fù)NHibernateContext中Rollback方法由于try...catch引起的對象回收異常

修復(fù)NHibernateContext提交時(shí)由于異常并且沒有關(guān)閉NHibernate Session而導(dǎo)致的Session不可用問題

對倉儲(chǔ)相關(guān)類的XML文檔進(jìn)行修復(fù)

系統(tǒng)需求

安裝程序需求

如需通過安裝包安裝Apworks，請確保機(jī)器符合以下需求：

• Windows XP Professional SP3或更高版本的Windows操作系統(tǒng)
• Microsoft .NET Framework 4.0完整版（注：不是Client Profile版本）
• Microsoft Visual Studio 2010 SP1 Ultimate/Professional（注：如果需要使用Visual Studio項(xiàng)目模板的話，請安裝此項(xiàng)）

源代碼使用需求

如需使用源代碼，并正常運(yùn)行所有的單元測試用例，請確保機(jī)器符合以下需求：

• Windows XP Professional SP3或更高版本的Windows操作系統(tǒng)
• Microsoft .NET Framework 4.0完整版（注：不是Client Profile版本）
• Microsoft Visual Studio 2010 SP1 Ultimate/Professional
• Microsoft SQL Server (2005/2008/Express/Standard/Enterprise)
• Oracle MySQL
• Configuration Section Designer Visual Studio Extensions
• WiX Toolset v3.6
• InstallShield Limited Edition
• Microsoft MSMQ
• Message Queuing服務(wù)正常運(yùn)行
• Microsoft Distributed Transaction Coordinator服務(wù)正常運(yùn)行

使用安裝程序安裝Apworks

從2.5版本開始，Apworks將使用InstallShield來制作安裝程序，因此您將看到與以前版本Apworks不同的安裝程序界面。

下載setup.exe安裝程序。請【單擊此處】直接下載Apworks v2.5.4563.21309的setup.exe安裝程序

雙擊setup.exe安裝程序，這將打開Apworks的安裝程序：

單擊Next按鈕，選擇“I accept the terms in the license agreement”選項(xiàng)后，單擊Next按鈕。Apworks使用Apache License Version 2.0

選擇安裝路徑后，單擊Next按鈕
|

直接單擊Install按鈕進(jìn)行安裝

安裝完成以后，直接單擊Finish按鈕

在開始菜單中，即可找到與Apworks相關(guān)的快捷方式：

Visual Studio 項(xiàng)目模板的使用

概述

為了幫助開發(fā)人員能夠更快地使用Apworks進(jìn)行應(yīng)用程序開發(fā)，從2.5版開始，Apworks將在其安裝包內(nèi)包含Visual Studio的應(yīng)用程序項(xiàng)目模板。由于Apworks安裝程序是用InstallShield LE（Limited Edition，限制版）創(chuàng)建的，由于許可證的約束，在創(chuàng)建Apworks安裝程序時(shí)并不能完全使用InstallShield所提供的強(qiáng)大功能。為了在Apworks安裝成功后，開發(fā)人員能夠方便地使用Visual Studio應(yīng)用程序項(xiàng)目模板，我們可能需要執(zhí)行一些額外的操作。在本文檔中，將對每個(gè)項(xiàng)目模板進(jìn)行詳細(xì)介紹。

安裝

Apworks安裝程序無法直接安裝包含在Visual Studio擴(kuò)展（VSE）中的項(xiàng)目模板，用戶應(yīng)該通過在開始菜單中訪問Apworks目錄以手動(dòng)安裝Visual Studio擴(kuò)展，如下：?

點(diǎn)擊這個(gè)菜單項(xiàng)后，會(huì)出現(xiàn)VSIX Installer對話框，用戶可以選擇相應(yīng)的Visual Studio版本進(jìn)行安裝。

現(xiàn)在開始安裝Visual Studio擴(kuò)展，通過點(diǎn)擊對話框上的“安裝”按鈕，如果安裝成功完成后，你會(huì)看到以下畫面：

管理

安裝完成后，您可以啟用/禁用擴(kuò)展，通過使用Visual Studio的擴(kuò)展管理器對話框（在Visual Studio中選擇“工具” - >“擴(kuò)展管理器”菜單）。你還可以卸載擴(kuò)展。

使用項(xiàng)目模板創(chuàng)建應(yīng)用程序

在Microsoft Visual Studio中，單擊“文件 - >新建 - >項(xiàng)目”菜單，這將打開“新建項(xiàng)目”對話框。在Installed Templates的Visual C#分類下，你可以找到一個(gè)名為“Apworks”的子類，所有與Apworks相關(guān)的項(xiàng)目模板都在這個(gè)子類下。注意，Apworks項(xiàng)目模板只支持Visual C#編程語言，所以你無法在其它語言的分類下找到Apworks子類。

選擇你想使用的項(xiàng)目模板，像創(chuàng)建其他類型的應(yīng)用一樣，給您的解決方案取個(gè)名稱，并單擊“確定”按鈕。 Visual Studio會(huì)為您創(chuàng)建的項(xiàng)目。

項(xiàng)目模板

在本節(jié)中，將對所有的項(xiàng)目模板進(jìn)行介紹。

Layered Service Application (Entity Framework)?

此項(xiàng)目模板將創(chuàng)建一個(gè)基于傳統(tǒng)的分層架構(gòu)的示例服務(wù)應(yīng)用解決方案。所創(chuàng)建的示例應(yīng)用程序基于一個(gè)非常簡單的場景：用戶能夠維護(hù)他們的筆記條目。這個(gè)應(yīng)用程序?qū)⑹褂梦④浀腁DO.NET Entity Framework作為倉儲(chǔ)的實(shí)現(xiàn)技術(shù)。

請注意，所創(chuàng)建的應(yīng)用程序是一個(gè)WCF服務(wù)應(yīng)用程序，項(xiàng)目模板不提供任何用于呈現(xiàn)應(yīng)用程序界面的GUI邏輯。開發(fā)人員應(yīng)根據(jù)項(xiàng)目的實(shí)際情況將GUI部分的代碼引入解決方案中。這是因?yàn)榕c用戶界面相關(guān)的技術(shù)發(fā)展迅速，開發(fā)平臺以及框架變化多端，版本各異，讓Apworks所創(chuàng)建的應(yīng)用程序綁定到一個(gè)特定的界面技術(shù)顯然不是一個(gè)很好的選擇。

要?jiǎng)?chuàng)建Layered Service Application (Entity Framework)，在“新建項(xiàng)目”對話框中，選擇該模板，并提供項(xiàng)目名稱，然后單擊“確定”，并按照以下步驟：

在“新建項(xiàng)目”對話框中點(diǎn)擊OK按鈕后，出現(xiàn)Create Apworks Application對話框。在此對話框中有三個(gè)標(biāo)簽頁：

• Database - 提供數(shù)據(jù)庫中的信息，該數(shù)據(jù)庫將被新的應(yīng)用程序用作后端數(shù)據(jù)存儲(chǔ)。請注意，目前此項(xiàng)目模板只支持SQL Server數(shù)據(jù)庫。如果你想使用其他數(shù)據(jù)庫（如Oracle，或者是NoSQL數(shù)據(jù)庫），您可以更改Services項(xiàng)目的Web.config文件中的連接字符串。這是項(xiàng)目模板的限制，Apworks框架允許你根據(jù)實(shí)際項(xiàng)目需求使用任何一種數(shù)據(jù)庫
  
  
  
• Services –這里提供與WCF服務(wù)相關(guān)的配置。目前，你只需要指定WCF服務(wù)的命名空間。默認(rèn)情況下，它會(huì)使用http://www.XXXX.com作為命名空間，其中XXXX為您的解決方案的名稱
  
  
  
• About – 關(guān)于項(xiàng)目模板
  

在“數(shù)據(jù)庫”選項(xiàng)卡，選擇你想使用的SQL Server數(shù)據(jù)庫：



確保“Enable MARS”選項(xiàng)被選中。
您還可以點(diǎn)擊“測試”按鈕來測試連接：

在“服務(wù)”選項(xiàng)卡，輸入合理的命名空間

點(diǎn)擊OK按鈕，Visual Studio會(huì)為您完成以下任務(wù)：1、在您選定的數(shù)據(jù)庫中創(chuàng)建表和數(shù)據(jù)；2、編譯整個(gè)解決方案 - 這是必需的，因?yàn)樵谵D(zhuǎn)換Services項(xiàng)目下的文本模板時(shí)，需要引用其它幾個(gè)項(xiàng)目的編譯結(jié)果

在解決方案資源管理器中，將創(chuàng)建下列項(xiàng)目：

• ApworksStarter.Application –此C#類庫項(xiàng)目包含應(yīng)用程序接口和應(yīng)用服務(wù)的實(shí)現(xiàn)
• ApworksStarter.Domain – 此C#類庫項(xiàng)目包含領(lǐng)域模型、倉儲(chǔ)接口、規(guī)約和O / R映射架構(gòu)
• ApworksStarter.Domain.Repositories – 此C#類庫項(xiàng)目包含倉儲(chǔ)的實(shí)現(xiàn)
• ApworksStarter.Infrastructure – 此C#項(xiàng)目類庫包含基礎(chǔ)結(jié)構(gòu)層的類型。目前，此項(xiàng)目模板創(chuàng)建的項(xiàng)目只提供了一個(gè)用于定義擴(kuò)展方法的類型。您可以向此項(xiàng)目添加更多的基礎(chǔ)結(jié)構(gòu)類型
• ApworksStarter.Services – WCF服務(wù)應(yīng)用程序，用以初始化應(yīng)用程序，并向客戶端公開服務(wù)接口

在解決方案資源管理器中點(diǎn)擊ApworksStarter.Services項(xiàng)目，然后單擊“轉(zhuǎn)換所有模板”工具箱按鈕，這將轉(zhuǎn)換這一項(xiàng)目下的所有定義的模板：



轉(zhuǎn)換的結(jié)果將顯示在Visual Studio的輸出窗口：

按F5來啟動(dòng)調(diào)試器

啟動(dòng)WCF測試客戶端

在WCF測試客戶端，點(diǎn)擊“文件 - >添加服務(wù)”菜單，將彈出添加服務(wù)的對話框

在添加服務(wù)對話框，輸入endpoint如下：

在Request面板中，雙擊RetrieveUserByID，在“id”字段輸入“c0ece0e5-469f-4AA1-aab4-9037aab2de43”，然后單擊Invoke按鈕：

服務(wù)被成功調(diào)用后，Response面板中顯示如下：

現(xiàn)在你可以在解決方案中創(chuàng)建你的GUI項(xiàng)目，并調(diào)用此服務(wù)提供的功能

Layered Service Application (NHibernate)?

此模板將創(chuàng)建與Layered Service Application (Entity Framework)相同的示例應(yīng)用程序，不同之處在于，此模板所創(chuàng)建的應(yīng)用程序?qū)⑹褂肗Hibernate框架來實(shí)現(xiàn)倉儲(chǔ)架構(gòu)。有關(guān)此項(xiàng)目模板的其他信息，請參閱上面的“Layered Service Application (Entity Framework)”部分。

?

總結(jié)

歡迎廣大讀者提出寶貴意見和建議！

總結(jié)

以上是生活随笔為你收集整理的面向领域驱动的应用开发框架Apworks 2.5发布的全部內(nèi)容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網(wǎng)站內(nèi)容還不錯(cuò)，歡迎將生活随笔推薦給好友。