緣起
TypeScript 這些年的發展一直不錯。我們公司在開發新功能時,考量到後續的可維護性,決定用 TypeScript 來撰寫瀏覽器端程式。團隊是從零開始導入的,而我自己對 JavaScript 也只能算半桶水,於是就帶著 C# 的思維去理解 TypeScript,這篇就把過程中的對照心得記錄下來。
說明:本文撰寫時基於 TypeScript 0.8 版本,且屬初學階段,部分內容可能已經過時,最新規範請參考 https://www.typescriptlang.org
身為物件導向開發者,第一個想知道的自然是「類別怎麼定義」。剛好我們專案服務端用 C#、客戶端用 TypeScript,兩邊邏輯幾乎一致,正好拿來做對照。
C# 的宣告方式:
using System;
namespace Digiwin.Mars.VirtualUI.Engine
{
internal sealed class Decoder { }
}
TypeScript 的宣告方式:
///<reference path="../Collections/ICollection.ts" />
module System.Erp.VirtualUI.Engine {
export class Decoder {}
}
第一個感受是:兩邊都有類似命名空間的概念,只是一邊叫 namespace,另一邊叫 module。
第二個差異在依賴方式。C# 要使用別人的類別,得先在專案裡加入 dll 參考,再在檔案頂端 using 對應的命名空間(可選);TypeScript 沒有這層概念,它是直接引用檔案本身。
第三個是存取修飾詞。C# 有 public、internal 等多層級,還有 sealed 這類修飾符;在 TypeScript 裡這些都可以先忘掉,加上 export 大致等同於 public,而抽象類別、值型別這些,當時似乎還沒有對應機制。不過介面是有的。
C# 的方法:
/// <summary>
/// 解碼變更集
/// </summary>
/// <param name="reader"> 一個變更集讀取器對象 </param>
public void DecodeChangeSet(ChangeRecordReader reader)
{
// 解碼上下文對象
var ctx = new DecodeContext();
TypeScript 的方法:
/**
* 傳入變更集,將其解碼到當前的對象容器。
* @param {System.Erp.VirtualUI.Engine.IChangeRecordReader} reader - 提供記錄集。
*/
public Decode(reader: IChangeRecordReader): void {
// 解碼上下文對象
var ctx = new DecodeContext();
可以注意到,C# 的 XML 文件註解在 TypeScript 中同樣支援,只不過改用 JsDoc 規範;普通註解一樣是 //,這點與 JavaScript 完全一致。
語法上最明顯的差異是:TypeScript 把回傳型別放在後面,參數型別也一樣寫在名稱之後;宣告變數時同樣如此:
private _maxId: number; // 在類上定義欄位 var item: VirtualObject; // 在方法裡定義變數
方法的可存取性支援 public,可以選擇公開或不公開。
C# 裡我們習慣用相同名稱搭配不同參數型別來做多載,但 JavaScript 不允許,所以 TypeScript 也不允許。理解了這層底層限制,就能明白為什麼一個類別只能有一個建構子:
constructor( objectContainer: VirtualObjectContainer,
objectBinder: IObjectBinder )
{
this._objectContainer = objectContainer;
this._binder = objectBinder;
}
同理,由於承襲自 JavaScript,這裡沒有 ref、out、in 這類關鍵字,取而代之的是具名參數與可選參數。另外當時也沒找到 override 關鍵字,據說 0.8 之後才補上。
更多細節还是得靠規格文件慢慢摸索。希望這篇對照筆記能幫同样是 C# 背景的讀者快速入門,剩下的就交給各位自己動手實驗了。