因為有隱匿高手把我的 Raccoon 的 UPS 轉換成 SQL 版本，但是實作的讓我說不出話，只好恢復一下自己實作 DICOM UPS 訂閱機制的記憶。不過想了想，UPS Subscription 實在是有點複雜，必須來記錄一下它的概念。

UPS 的操作

首先，我們來看看 UPS 有哪些操作:

不外乎，UPS 就跟一般世界的商業邏輯差不多，擁有 CRUD 的功能，但這個 Subscribe，到底在訂閱什麼？

UPS 的訂閱

節錄自: Subscribe Transaction

This transaction creates a Subscription to a Worklist or Workitem resource. It corresponds to the UPS DIMSE N-ACTION operation "Subscribe to Receive UPS Event Reports".

Once a Subscription has been created the user agent will receive notifications containing Event Reports for events associated with the Subscription's resource. To receive the notifications generated by Subscriptions, the user agent must have first opened a Notification Connection between itself and the origin server using the Open Notification Connection transaction; see Section 8.10.4.

我們主要看第二段，它說明了：當 Subscription 建立時，User 會收到 Subscription 的訊息，而要收到訊息的話，User 必須先建立與 server 的 Open Notification Connection transaction

那這個 Open Notification Connection transaction 又是個什麼鬼？

一點開上面的 Section 8.10.4，你就可以看到熟悉的字眼：The connection uses the WebSocket protocol. The connection can use the same TCP port as the HTTP connection, but they are separate connections.

哦！原來是 WebSocket

這樣一看，腦子就通了，這不就跟 yt 一樣，(1) 訂閱頻道，(2) 頻道有新影片時，傳送通知到帳號。轉換成 UPS 的概念就是 (1) 訂閱 UPS，(2) 進行相關操作，透過 WebSocket 把相關操作的 Subscription DICOM Json 傳送給 User

UPS 的訂閱種類

以下是 UPS 提供的 3 種訂閱種類，那筆者對於不同種類有不同的見解，若有誤，還請大家多多包涵以及指教。

看完後，我腦中所留下的實作內容大概是這樣:

處理單個 WorkItem 的訂閱
處理 Global 的訂閱
不同已連接的 WebSocket 的處理
如何把 Filtered Global Subscription 的查詢儲存起來

我只能說，想那麼多幹嘛，看看 dcm4che，別人都實作好了，拿出來參考吧

訂閱觸發流程

其實上面說那麼多，這邊才是最主要的，不過也是個人紀錄當時的我，是如何實作 Subscription 的。

建立 WorkItem Subscription 觸發流程

我們可能對某個 aeTitle 建立 WorkItem 有興趣，就可以透過 Subscription 去知道某種 WorkItem 被建立了！

那這邊講一下流程:

把相關的 Global Subscription 撈出來
- 迭代 DB 的 Global Subscription (cursor)
  - 沒有 query key 的就等同匹配
  - 如果與 query key 相符 (count > 0，因為我不需要知道 workitem 詳細資料，只需要知道這個 subscription 相符)，就等同匹配
迭代所有相關的 Global Subscription ，並進行單個 workitem 的訂閱建立
尋找所有相關已訂閱的 subscription
對指定 aeTitle 的 websocket 進行訊息傳送

sequenceDiagram
    User->>GlobalSubscriptions: Create Global Subscriptions
    GlobalSubscriptions->>Subscriptions: Find not subscirbed subscriptions with AE Title
    Subscriptions-->>GlobalSubscriptions: return hit subsciptions
    GlobalSubscriptions-->>User: Successful

sequenceDiagram
    Note left of User: global subscriptions already created
    User->>WorkItem: create Work Item
    WorkItem->>GlobalSubscriptions: found matcing global subscriptions
    GlobalSubscriptions->>Subscriptions: Create subscriptions for work item
    Subscriptions-->>GlobalSubscriptions: return
    GlobalSubscriptions-->>WorkItem: return
    WorkItem->>WorkItem: subscribed if any subscription exist
    WorkItem->>WorkItem: trigger event
    WorkItem-->>User: return