Objects

對象類簡介

IRIS 通過以下對象類提供對象技術： %Library.RegisteredObject、 %Library.Persistent``%Library.SerialObject。

下圖展示了這些類之間的繼承關系，以及它們的一些參數和方法。 %Library 包的類名稱可以縮寫，因此（例如） %Persistent 是 %Library.Persistent 的縮寫。這里，全部大寫的項目是參數，以百分號開頭的項目是方法。

在典型的基于類的應用程序中，可以根據這些類（以及專門的系統子類）定義類。所有對象都直接或間接繼承自這些類之一，并且每個對象都是以下類型之一：

• 注冊對象是 %RegisteredObject 或其子類的實例。可以創建這些對象，但無法保存它們。另外兩個類繼承自 %RegisteredObject，因此包含該類的所有參數、方法等。
• 持久對象是 %Persistent 的實例或子類。可以創建、保存、打開和刪除這些對象。

持久類會自動映射到可以通過 SQL 訪問的表。

• 串行對象是 %SerialObject 或其子類的實例。串行類旨在用作另一個對象的屬性。可以創建這些對象，但不能獨立于包含它們的對象來保存或打開它們。

注意：通過類 %DynamicObject 和 %DynamicArray， IRIS 還提供了處理沒有模式的對象和數組的能力。

對象類的基本特征

通過對象類，可以執行以下任務：

• 可以創建一個對象（類的實例）。為此，可以使用該類的 %New() 方法，該方法繼承自 %RegisteredObject。

set myobj=##class(Sample.Person).%New()

myobj = iris.cls("Sample.Person")._New()

Python 方法名稱不能包含百分號 (%)。可以通過將 Python 中的 % 字符替換為下劃線 (_) 來調用任何包含 % 字符的 ObjectScript 方法，如示例中所示。

• 可以使用屬性。

可以在任何類中定義屬性，但它們僅在對象類中有用，因為只有這些類允許創建實例。

任何屬性都包含單個文字值、對象（可能是集合對象）或多維數組（罕見）。以下示例顯示了對象值屬性的定義：

Property Home As Sample.Address;

Sample.Address 是另一個類。下面顯示了設置 Home 屬性值的一種方法：

Set myaddress=##class(Sample.Address).%New()
 Set myaddress.City="Louisville"
 Set myaddress.Street="15 Winding Way"
 Set myaddress.State="Georgia"

 Set myperson=##class(Sample.Person).%New()
 Set myperson.Home=myaddress

import iris
myaddress=iris.cls("Sample.Address")._New()
myaddress.City="Louisville"
myaddress.Street="15 Winding Way"
myaddress.State="Georgia"

myperson=iris.cls("Sample.Person")._New()
myperson.Home=myaddress

• 如果類或其超類定義了實例方法，則可以調用該類實例的方法。例如：

Method PrintPerson() [ Language = objectscript ]
{
 Write !, "Name: ", ..Name
}

Method PrintPerson() [ Language = objectscript ]
{
 Write !, "Name: ", ..Name
}

如果 myobj 是定義此方法的類的實例，則可以按如下方式調用此方法：

Do myobj.PrintPerson()

myobj.PrintPerson()

• 可以驗證屬性值是否符合屬性定義中給出的規則
  • 所有對象都繼承實例方法 %NormalizeObject()，該方法規范化所有對象的屬性值。許多數據類型允許相同值的不同表示。標準化將值轉換為其規范或標準化形式。 %NormalizeObject() 根據此操作是否成功返回 true 或 false。
  • 所有對象都繼承實例方法 %ValidateObject()，該方法根據屬性值是否符合屬性定義返回 true 或 false。
  • 所有持久對象都繼承實例方法%Save()。當使用%Save()實例方法時，系統會首先自動調用%ValidateObject()。

相反，當在例程級別工作并且不使用類時，代碼必須包含用于檢查類型和其他輸入要求的邏輯。

• 可以定義回調方法，以在創建、修改對象等時添加其他自定義行為。

例如，要創建類的實例，可以調用該類的 %New() 方法。如果該類定義了 %OnNew() 方法（回調方法），則 IRIS 也會自動調用該方法。下面展示了一個簡單的例子：

Method %OnNew() As %Status 
{
    Write "hi there"
    Return $$$OK
}

Method %OnNew() As %Status [ Language = python ]
{
    print("hi there")
    return True
}

在實際場景中，此回調可能會執行一些所需的初始化。它還可以通過寫入文件或global文件來執行日志記錄。