我們設計資料庫應用時，都會遇到新增資料後產生一個識別代號(ID)的設計需求。但遺憾的是， SQL Standard 並沒有定義任何產生識別代號的型態或函數。但這種需求實在普遍，於是各種資料庫系統都發展了自己的一套做法。

我在「SQL Datatypes 相容性整理」一文中，整理了 SQL Server, PostgreSQL, MySQL, SQLite 四種資料庫各自產生識別代號的方法。這種各家不相容的狀況，使得識別代號這種普遍的設計需求，存在可攜性陷阱。

我在「透過NB-IoT電信模組發送MQTT訊息」說到有些 NB-IoT 模組只提供最基本的 TCP/UDP 封包傳輸指令，不提供 MQTT 等應用協定的傳輸指令。大部份 NB-IoT 模組的也沒有 NTP 指令 (查詢網路時間) 。

本文說明在這種情形之下，取得網路時間的經驗。

NB-IoT 或 LTE-M 都是 3GPP 電信組織針對 IoT 應用制訂的低功耗廣域無線電技術(LPWAN)。NB-IoT 資料透過 LTE/4G 電信網路傳遞。簡單說就是和 LTE/4G 共用基地台。你的手機收得到 LTE/4G 訊號的地方，你的 IoT 裝置就能使用 NB-IoT 電信模組發送資料。而 NB-IoT 模組也可以直接插一般 LTE/4G SIM 卡使用，只是資費比 NB-IoT 貴。

我在前公司接觸過兩家廠商的 NB-IoT 模組，一為 u-blox 的 SARA-N/SARA-R4系列，另一為 SIMCOM 的 SIM7000系列。因為是公司產品，不是我的著作權，所以不能公開程式碼。但可以說使用經驗，以及如何透過 NB-IoT 模組的 AT 指令發送原始的 MQTT 封包。

.NET 平台可以使用套件 System.Net.Mqtt 設計 MQTT 用戶端程式。從套件的名稱空間可知，這是 .NET 平台正式的 MQTT 套件。由微軟旗下的 xamarin 團隊負責開發，專案托管於 System.Net.Mqtt 專案。

MQTT 概觀請看 一、在 Debian 8 安裝 mosquitto。

本文範例使用 C# 語言撰寫。並且說明三點使用須知：

1. client ID
2. 同步方法 Connect
3. 分別主題處理方法

朋友前兩天問了個 C# 語法問題：

問個蠢問題

`public static byte[] xxxxxxxx(this short x)`

這種場合this的用意是甚麼?

第一眼，我的想法是「很像 Python 的語法」。

事實上，打從 C++ 開始，我用過的 OOPL 的 method call ，其隱含的意義都是 method(this) 。 表面上，我們寫成 個體.method() ，但實際上，編譯器是弄成 method(個體) 。「個體」 是函數方法隱含的第一個參數。因為這樣，這個函數才知道操作對象是哪個東西。

CommonGateway 是我多年前設計的迷你框架。我最初用它實作 RESTful API 項目，並沒有放太多用於網頁設計的內容。最近兩年用它設計一些網站專案。為了方便工作，增加了兩項關於網頁設計的功能:

• HTML 公用函數
• 預設首頁控制項

多年前，我寫了一個 PHP 框架 CommonGateway。我一直都用這個迷你框架實作 RESTful API 。只不過，以往都是用在區網內專案，或者 OpenData/OpenAPI 的案子，所以一直都沒想過用戶認證授權的功能。

直到去年，我接了一個案子。案子要求用戶經認證授權後才能存取 API。所以我參考之前使用 ASP.NET Core 的經驗，為 CommonGateway 增加了一個 @authorize 的註記，用於註記控制項或控制項方法是否要求用戶授權。

本文說明以 CommonGateway 框架設計 RESTful API 或網站時，如何使用認證授權功能。

我從過去用到 Promise 的 Web 前端開發案中，挑出兩個具有泛用性的應用函數，作為實際範例。若是不了解 Promise 基礎觀念，請先看「ECMAScript/JavaScript 6 - Promise 學習六步 」。

Promise 的應用函數:

1. JSONRequest
2. Until

Promise 是 ECMAScript 6 訂出的語言規範，用於延遲運算 (deferring) 的場合。 正式說明太難解釋了，所以我根據這兩年的使用經驗，決定換一種比較白話的講法。 ECMAScript 6 的 Promise 就是一種跳躍語法(goto)，但不會執行到它這一行就立即跳躍，而是先上個標記，延至程式區塊結束才跳躍。 Promise 是延遲式跳躍。

雖然現在年輕人可能從來沒用過跳躍(goto) ，但應該不妨礙各位理解跳躍是什麼。 就連 JavaScript 也保留了一部份跳躍語法，那就是 label。

本文將按下列六步，逐步說明 Promise 的使用概念與實例:

1. Promise 建構式必須有一個執行者引數(executor)。
2. Promise 建構式的 executor 可接受兩個引數，分別表示 then 和 catch 兩個跳躍點的名稱。
3. Promise 標記時會保存指定的狀態內容。
4. then/catch 串接實現非同步工作的同步化，且簡化程式的巢狀結構深度。
5. Promise.all 可以一次收集多個 promise 的結果。
6. 用函數包裝 Promise ，提高重用性。

我只整理數值、序號、文字和日期這四種類型。至於 BINARY, BIT, MONEY, 地理位置, XML 等通用性太低的類型，則不使用。

下列是個人使用的資料庫系統，按個人喜好程度排列：

• SQLite 3 (sqlite)
• PostgreSQL 9.6 或更新版本 (pgsql)
• SQL Server 2019 或更新版本 (mssql)
• MariaDB 10.3 或更新版本 (mysql)