2014年5月22日

ASP.NET MVC - ASP.NET MVC vNext ( MVC 6 ) KVM初體驗

這個月根本就是大爆炸,除了公司的案子在本月要交付,所以公司事情大爆炸外;其次就是北美TechED 2014的技術大爆炸…

而這次TechED 2014 非常出乎意料之外,原本以為現在MS因為跑Scrum,所以有甚麼新的東西都會先釋出於Blog…,結果這次沒想到,TechED一口氣釋出了一堆新的技術…尤其是ASP.NET MVC vNext ( 也就是MVC的下一版…,通常下一版都通稱為vNext,所以這邊指的是MVC 6的版本 ),根本是核心大翻修…( 不過對使用者來說,還是有兼容舊版就是了,不用過於擔心~ ),至於翻修了啥東西,有興趣的可以參考資訊界的神人前輩,小朱前輩,第一手已經準備好了很多優良的文章,而今天,小弟我這邊只是簡單的紀錄一下,KVM的初體驗過程(羞),未來有機會當看到那些部分,再逐一補齊~~

另外,請注意,目前這個版本是新到不能再新Alpha版本,請不要使用於正式環境,可以使用Azure的VM,或是虛擬機來玩這個新玩意~。

好,廢話先到這邊,我們就快速地來建立一下。

首先,我們可以到以下的github網站,未來ASP.NET的Source全部都會放到github上…( CodePlex表示…. )

https://github.com/aspnet/Home

這個網站主要是放vNext簡單的範本,我們到時候可以從這範本來玩玩看。

如果我們有裝GitHub的Tools,我們就可以直接使用Clone Desktop將這個Source下載回來,如果沒裝的朋友,就直接Download ZIP吧…那差別在哪邊??..用Tools可以追蹤目前更新的Source狀態=v=..

image_thumb3

另外,如果有要用GitHub Tools,也別忘記要先登入GitHub,那Clone in Desktop才有作用…

我們可以從下圖看到GitHub Tools的功能,可以看到目前的一些更新歷程。

image_thumb6

下載完成之後,我們就要進入到下載好的那個目錄,下 kvmsetup.cmd,他會協助幫我們把一些路徑等等之類的設定,設定好…

image_thumb10

完成之後我們就可以使用以下指令,kvm install 0.1-alpha-build-0421來安裝。

image_thumb13

安裝完成後,我們使用kvm list就可以看到目前我們已經有了這個環境;而未來除了可以讓我們選擇不同的環境外,我們也可以自己準備自己需要的各種不同環境。

image_thumb16

另外,雖然我們準備好環境,但我們還沒有把相關的東西下載下來,所以我們要下kpm restore,下圖因為按下去後,下載太多東西了,所以沒辦法忠實呈現XDDD,只能告訴大家,輸入以下指令後,會如上面依樣,下載很多東西。

image_thumb19

完成之後,因為我們是要啟動的是web,所以要下k web,如果是命令列的應用程式,就是下k run,所以我們可以從下圖看到,下k run的時候,他會和我們說找不到Main這個起始點;因為現在是要run web應用程式…

image_thumb22

完成之後,我們就可以打開瀏覽器,輸入這個範例預設的位置localhost:5001,就可以看到web網頁跑起來了!!!

image_thumb25

那就先到這邊,我們後續再繼續看下去~~~

參考資料

2014年5月17日

AngularJS - AngularJS 與 UI-Bootstrap Scope的陷阱

這幾天,遇雷的狀況,都已經快要變成索爾了…而今天要談的這個問題,其實算是JS加上AngularJS的基本功…牽涉的範圍還滿廣泛的…從UI-Bootstrap這個Directive開始..到AngularJS Scope的範圍,一直到JavaScript的原型繼承…

而這篇的整個概念可以看原文這裡,對岸的高手,也有幫忙翻譯成簡體中文,所以有興趣的可以先看一下上面這些資訊( 沒時間看的朋友也沒關係,可以先聽小弟講完,再回頭看… );而以下的敘述,會依據上面的理論來開始解釋小弟遇到的問題…

問題

首先,我們還是要先來看一下問題…

大家可以從這邊看到原始碼…另外,我也貼一份在Blog…

HTML

<!doctype html>
<html ng-app="plunker">
  <head>
    <script src="//ajax.googleapis.com/ajax/libs/angularjs/1.2.10/angular.js"></script>
    <script src="//angular-ui.github.io/bootstrap/ui-bootstrap-tpls-0.11.0.js"></script>
    <script src="script.js"></script>
    <link href="//netdna.bootstrapcdn.com/bootstrap/3.1.1/css/bootstrap.min.css" rel="stylesheet">
  </head>
  <body>

<div ng-controller="ModalDemoCtrl">
    <script type="text/ng-template" id="myModalContent.html">
        <div class="modal-header">
            <h3 class="modal-title">I'm a modal!</h3>
        </div>
        <div class="modal-body">
            <ul>
                <li ng-repeat="item in items">
                    <a ng-click="selected.item = item">{{ item }}</a>
                </li>
            </ul>
            Selected: <b>{{ selected.item }}</b>
        </div>
        <input type="text" ng-model="testText"  />
        <div class="modal-footer">
            <button class="btn btn-primary" ng-click="ok()">OK</button>
            <button class="btn btn-warning" ng-click="cancel()">Cancel</button>
        </div>
    </script>

    <button class="btn btn-default" ng-click="open()">Open me!</button>
    <div ng-show="selected">Selection from a modal: {{ selected }}</div>
</div>
  </body>
</html>

JS

angular.module('plunker', ['ui.bootstrap']);
var ModalDemoCtrl = function ($scope, $modal, $log) {

  $scope.items = ['item1', 'item2', 'item3'];

  $scope.open = function (size) {

    var modalInstance = $modal.open({
      templateUrl: 'myModalContent.html',
      controller: ModalInstanceCtrl,
      size: size,
      resolve: {
        items: function () {
          return $scope.items;
        }
      }
    });

    modalInstance.result.then(function (selectedItem) {
      $scope.selected = selectedItem;
    }, function () {
      $log.info('Modal dismissed at: ' + new Date());
    });
  };
};

// Please note that $modalInstance represents a modal window (instance) dependency.
// It is not the same as the $modal service used above.

var ModalInstanceCtrl = function ($scope, $modalInstance, items) {

  $scope.items = items;
  $scope.selected = {
    item: $scope.items[0]
  };

  $scope.ok = function () {
    alert($scope.testTest);
    $modalInstance.close($scope.selected.item);
  };

  $scope.cancel = function () {
    $modalInstance.dismiss('cancel');
  };
};

好,稍微解釋一下這個問題,這個問題主要是使用UI-Bootstrap Modal的時候,如果我們再彈跳視窗的地方,加上一個Textbox,並且用ng-model ( 原始碼上是Bind到testText )來做Bind;最後當我們按下ok按鈕的時候,會用alert($scope.testText)來顯示值…

但實際上,大家玩過後可以發現,是找不到這個值的…而且這個值為定義…

解法

這個解法其實很簡單,我們只要把Text的ng-model改成繫結$parent.testText就可以了…所以會長的如下這樣:

把原本繫結testText改成$parent.testText…

<input type="text" ng-model="$parent.testText"  />

是的,這樣alert就可以順利彈跳出來值…

此外,你也可以改成這樣…變成繫結oo.testText

<input type="text" ng-model="oo.testText"  />

但這時候,JavaScript那邊也要跟調整…我們在一開始的時候設定oo為物件,並且alert改為alert($scope.oo.testText)。

var ModalInstanceCtrl = function ($scope, $modalInstance, items) {
  
  $scope.oo = {};
  $scope.items = items;
  $scope.selected = {
    item: $scope.items[0]
  };

  $scope.ok = function () {
    alert($scope.oo.testText);
    $modalInstance.close($scope.selected.item);
  };

  $scope.cancel = function () {
    $modalInstance.dismiss('cancel');
  };
};

是的,以下兩種方法都可以順利解決這個問題…但是大家一定會覺得很奇怪和納悶…為什麼這樣就可以??

解釋

首先,我們回去思索一下問題。

小弟我使用UI-Bootstrap的Modal,並且定義了這個Modal獨立的Controller,但為什麼這個Modal畫面上的ng-model,在Modal這個Controller上讀不到…反之…加了$Parent或是使用oo.這種寫法就可以讀的到!?

其實原理就是一開始給大家看的那個網址( 如果沒看的朋友也沒關係,可以繼續看下去 );小弟引用了一下原文的一張圖,其實原理就是這張圖上…

image

我們使用的UI-Bootstrap其實是用AngularJS的Directive寫的,這點我相信大家都沒啥問題…而UI-Bootstrap在設定Directive有使用到Transclude ( Transclude 是替換內容的功能 ),而當AngularJS有使用到Transclude時,其實會建立一個獨立的Scope,也就是圖上的TranscludedScope…

其次,除了TranscluedScope外,AngularJS還會建立另外一個Scope…也就是IsolateScope…而IsolateScope會透過的$$nextSibling指向到TranscludedScope…

發現了嗎?..真實的底層,並不是我們想的,只有我們為Modal建立的Controller Scope…除了我們為Modal建立的Controller Scope外,還有兩個Scope!!

所以我們驗證一下,如下圖,我們可以看到他其實不是在我們Modal Controller的Scope,而是自己獨立的Scope….( Modal Controller的Scope為 Scope(004) ),所以可以確定$scope(007)為TranscluedScope

image

我們繼續驗證下去…當我們拉到Scope (006)的時候,我們可以看到$$nextSibling確實指向到了Scope(007),所以可以確定Scope(006)就是IsolateScope

image

也因此,實際上我們的Controller與定義畫面的model的Scope完全不同,自然Controller也呼叫不到…

但那為什麼用$parent.testText就可以呢??..因為$parent是代表上一層的意思(父層),而他的父層就是Controller,所以也就是代表在父層的Controller Scope定義了這個變數…

那oo.testText為什麼可以呢…如果ng-model=”oo.testText"這個變數應該也是會落在TranscluedScope上阿??

那是因為JavaScript原型繼承的特性…如果我們只打ng-model=”oo.testText",那的確還是會落在TranscluedScope上…

image

但如果今天,我們在Controller Scope裡面寫了$Scope.oo = {},則因JavaScript原型繼承的特性,當子物件要去定義oo.testText的時候,會先往上找到父層,看看有沒有oo這個物件,如果有的話,就實作於父層的oo下面,加上textText,若父層沒有,就會在子物件那邊,建立一個oo.testText…

基本上就是這樣…

最後,或許有人會說,那如果父層有oo,那我真的要在子物件去控制oo裡面的東西,不就會找不到oo!?,因為只有父層有oo啊!!?

但實際上,子Scope還是可以找的到oo,那是因為父層和子Scope都是參考到oo這個物件的記憶體位置~~

最後的最後,總之,這次的這個Case的原因,其實就是…我們的Controller實際上是屬於父層..但我們直接用ng-model=”testText”的時候,是在子Scope建立了這個變數,而非父層…,所以解決的方法,第一個就是告訴ng-model,要建立這個變數到父層喔!!,或是使用物件的方式,讓這個物件建立於父層~~

就是這樣!!~

後記

利用上班中午休息時間趕稿趕完XDDD,如有錯誤,也請大家多多包涵~~~

參考資料

2014年5月15日

ASP.NET MVC - 限制CamalCase在特定的Web API Controller下

這個月瘋狂加班中,其實已經沒啥力氣寫Blog了,但今天和好友神人Bruce討論到這個問題,感覺不順手記一下,就太對不起Bruce今天的討論了,所以這篇就獻給Bruce吧XDD。

這個問題的情境大致上是這樣的,大家都知道Web API會透過JSON.NET來將物件序列化成JSON,而我們定義的C#物件,裡面的屬性名稱第一個字慣例上都會用大寫…但在JavaScript上,習慣第一個字為小寫…所以龜毛的小弟我,就會在WebApiConfig.cs或是Global.asax裡面去加上這串。(最底下的參考網址有官方連結 )

var json = GlobalConfiguration.Configuration.Formatters.JsonFormatter;
json.SerializerSettings.ContractResolver = new CamelCasePropertyNamesContractResolver();

簡單的說,這段程式碼會告訴JSON.NET,若序列化的話,要把你讀到的C#物件裡面的屬性名稱的第一個單字,轉到JSON的時候,變成小寫喔…

就如同 Name會變成name,UserOrder會變成userOrder.

但現實上,一定不會那麼順利;如果是新的一個Case,那可以一開始的時候就可以這樣制定下來;但實際上,我相信有很多人是在舊的系統上運作,那加了上面的Code就會天下大亂了…

原因很簡單,那是因為GlobalConfiguration嘛…一套用,就全域都套了…

所以在真實環境中,比較好的做法,就是寫個attribute,來給Controller掛上,只要有掛的Controller都會自動轉第一個字母小寫,沒掛的就維持原本的大寫;這樣也大大的提升了彈性。

那怎麼做呢?.就是下面這段程式碼啦!~內容也滿簡單的,反正就是找出舊的,移除後,在放上新的規則~~ ( 感謝Bruce補充,這邊不要用add.要改用insert,不然會擾亂JSON和XML返回的優先順序~ 詳細內容可以參考底下相關連結,有Bruce針對此撰寫的文章~)

public class CamelCasedJsonAttribute : Attribute, IControllerConfiguration
{
    public void Initialize(HttpControllerSettings controllerSettings, HttpControllerDescriptor controllerDescriptor)
    {
        var formatter = controllerSettings.Formatters.JsonFormatter;
        controllerSettings.Formatters.Remove(formatter);

        formatter = new JsonMediaTypeFormatter
        {
            SerializerSettings = { ContractResolver = new CamelCasePropertyNamesContractResolver() }
        };

        controllerSettings.Formatters.Insert(0,formatter);

    }
}

而Controller怎樣使用呢??只要掛上就好,簡單又有力!!

[CamelCasedJson]
public class HoneController : ApiController

這樣子後,就可以順利的解決了現實生活上的問題了!!~

後記

另外,也可以從Model的地方加上Attribute,來告訴Json.NET序列化後,要變成怎樣的Json屬性名稱,這也是一種方式;但是當然,懶惰的小弟,還是使用以上的方法吧=v=.

參考網址

2014年5月12日

Azure - 實作Azure上的AD與MVC進行驗證 - Azure設定篇 ( 一 )

隔離上次寫文章,竟然整整的拖超過一個月( 連Windows Azure都改名為Microsoft Azure了…)…實在是因為這段時間整個忙到翻掉,上班趕Code…下班查資料…最慘的是,下周起還要進行待在公司的瘋狂加班…來進行衝刺… ( 這大概是我們公司成立以來,第一次破例這樣子了…還好公司方面也覺得Developer很辛苦,所以不會用補修打發我們,而是使用加班費的方式~… ) 但不管怎樣… 還是不想加班阿QQ…

好吧,前面發了一些牢騷後,我們就再偉大的母親節這天,來繼續看一下Microsoft Azure上AD與MVC如何進行整合。

另外,因為整個過程很長,所以會分成好幾篇文章來撰寫…

首先,我們先進入Azure管理介面,然後選擇要使用的AD。

image

接下來,選擇應用程式,並且選擇加入。

image

因為我們是要讓自己寫的應用程式可以通過AD驗證,所以要選擇"加入我的組織正在開發的應用程式",如果要使用第三方應用程式來搭配Azure AD,那就要選擇"從組件庫中新增應用程式"。

image

接下來,我們要給一下名稱;因為我們是要開發Web應用程式,所以自然就是選擇"Web應用程式和/或WEB API"

image

接下來,要填一下登入的URL和應用程式識別碼URI,基本上就是你應用程式的網址,而URI則是網址格式的一段字串,通常都是https://[AD名稱]/[應用程式名稱]。

image

完成之後,還有很多工作要設定,首先,第一個要注意到的是用戶識別碼,這個地方;這個其實也等同於ID,下一篇會用到,所以要特別留意一下。接下來,金鑰的地方,記得去選擇一年或是兩年,並且儲存之後,就會出現金鑰,這個也會在第二篇的時候用到,這也就是所謂的Key ( PW )。

image

接下來,最底下,要設定應用程式權限為Read Directory Data,這樣我們才讀的到資料。

image

到這邊為止,就算是Azure設定完成了。

完成之後,我們就要開始進行MVC的開發…這邊我們要玩就玩大一點,所以就選擇全空的專案…

image

之後,我們要用NuGet進行安裝,基本上,要安裝的有這些套件

  1. System.IdentityModel.Tokens.ValidatingIssuerNameRegistry
  2. Microsoft.IdentityModel.Clients.ActiveDirectory
  3. Microsoft.AspNet.Identity.EntityFramework

首先我們要安裝Token的套件,也就是System.IdentityModel.Tokens.ValidatingIssuerNameRegistry。

image

接下來,要安裝的是Microsoft.IdentityModel.Clients.ActiveDirectory。

image

另外,畢竟是驗證,所以我們要使用Identity套件,而我們這邊使用Identity搭配Entity Framework;這邊或許有人會覺得疑惑,為什麼Azure AD的驗證還要搭配Entity Framework !?..其實不用也是可以啦,在官方現在標準的作法,會使用Entity Framework來將驗證方的相關資訊存放到DB裡面去,而不是早期的Web.config…會這樣做的原因,官方是說,它們實現了一個機制,可以利用Lib去產生驗證方的資訊;而會有這種做法,主要是因為官方覺得,早期寫到web.config的時候,是寫死的,所以當驗證方的資訊改變的時候,變成一定要手動再去調整web.config,而中間的這段時間,就有可能讓程式停擺…所以現在官方是希望透過程式自動產生資訊,並且存放到DB;而這次的文章,主要還是會透過DB,小弟我看了一下機制後,感覺還不錯,所以就繼續沿用這個機制來實作,但原則上因該也是可以透過web.config,但這塊可能就請看官大大們,自己嘗試一下嚕~~

image

所以這邊會把Entity Framework通通加進去~

image

裝完之後,我們可以先看一下Web.config,並且刪除掉一些不用的東西,原始是這樣。

<?xml version="1.0" encoding="utf-8"?>
<!--
  如需如何設定 ASP.NET 應用程式的詳細資訊,請瀏覽
  http://go.microsoft.com/fwlink/?LinkId=301880
  -->
<configuration>
  <configSections>
    <!-- For more information on Entity Framework configuration, visit http://go.microsoft.com/fwlink/?LinkID=237468 -->
    <section name="entityFramework" type="System.Data.Entity.Internal.ConfigFile.EntityFrameworkSection, EntityFramework, Version=6.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" requirePermission="false" />
  </configSections>
  <appSettings>
    <add key="webpages:Version" value="3.0.0.0" />
    <add key="webpages:Enabled" value="false" />
    <add key="ClientValidationEnabled" value="true" />
    <add key="UnobtrusiveJavaScriptEnabled" value="true" />
  </appSettings>
  <system.web>
    <compilation debug="true" targetFramework="4.5" />
    <httpRuntime targetFramework="4.5" />
  </system.web>
  <entityFramework>
    <defaultConnectionFactory type="System.Data.Entity.Infrastructure.LocalDbConnectionFactory, EntityFramework">
      <parameters>
        <parameter value="v12.0" />
      </parameters>
    </defaultConnectionFactory>
    <providers>
      <provider invariantName="System.Data.SqlClient" type="System.Data.Entity.SqlServer.SqlProviderServices, EntityFramework.SqlServer" />
    </providers>
  </entityFramework>
</configuration>

最終結果會被我砍成這樣。

<?xml version="1.0" encoding="utf-8"?>
<!--
  如需如何設定 ASP.NET 應用程式的詳細資訊,請瀏覽
  http://go.microsoft.com/fwlink/?LinkId=301880
  -->
<configuration>
  <configSections>
    </configSections>
  <appSettings>
    <add key="webpages:Version" value="3.0.0.0" />
    <add key="webpages:Enabled" value="false" />
    <add key="ClientValidationEnabled" value="true" />
    <add key="UnobtrusiveJavaScriptEnabled" value="true" />
  </appSettings>
  <system.web>
    <compilation debug="true" targetFramework="4.5" />
    <httpRuntime targetFramework="4.5" />
  </system.web>

</configuration>

我們主要是刪除了,configSections裡面的section name = “entityFramework”這個區段。

<configSections>
<!-- For more information on Entity Framework configuration, visit http://go.microsoft.com/fwlink/?LinkID=237468 -->
<section name="entityFramework" type="System.Data.Entity.Internal.ConfigFile.EntityFrameworkSection, EntityFramework, Version=6.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" requirePermission="false" />
</configSections>

和最下面的entityFramework區段…

  <entityFramework>
    <defaultConnectionFactory type="System.Data.Entity.Infrastructure.LocalDbConnectionFactory, EntityFramework">
      <parameters>
        <parameter value="v12.0" />
      </parameters>
    </defaultConnectionFactory>
    <providers>
      <provider invariantName="System.Data.SqlClient" type="System.Data.Entity.SqlServer.SqlProviderServices, EntityFramework.SqlServer" />
    </providers>
  </entityFramework>

這兩個區段主要是用於,當沒有給連線字串的時候,EF會自動的透過LocalDbConnectionFactory來取得localdb,但因為我們會使用connectionString,所以這個兩個設定就顯得多餘了…

接下來,我們還要參考兩個DLL,但這個不用從Nuget下載;分別是System.IdentityModel和System.IdentityModel.Services。

image

基本上,初步的設定就到這邊,下一篇,就會針對Azure AD要使用的Web.config進行撰寫。

參考資料

2014年5月11日

Azure - 刪除Azure上的AD

其實這篇沒甚麼…但實在是想些一篇文章慶祝一下…是的,Azure上的AD終於可以刪除了!!

記得當初第一次使用的時候…想說既然可以使用,隨便測試一下再刪除…所以就創建了以下這個網域XDDDD

image

等了不知道有沒有一年QQ…現在終於可以刪除了…當初國外部提供刪除,也是因為AD這塊牽涉到O365…所以刪除這個動作會格外的複雜,而官方也一再的承諾,未來一定會實作…

image

而如今終於可以刪除了QQ.. (淚奔)…

image

就這樣…

後記

基本上這篇根本就是紀念文阿…