如果使用的是嵌入式 Python
並且需要與 IRIS
交互,可以使用 Python shell
中的 iris
模塊,或者使用 Python
編寫的 IRIS
類中的方法。要遵循本節中的示例,可以使用 ObjectScript
命令 do ##class(%SYS.Python).Shell()
從終端會話啟動 Python shell
。
當啟動終端會話時,將被放置在 IRIS
的 USER
命名空間中,將看到提示 USER>
。但是,如果從 GitHub
加載了示例類,則需要在 SAMPLES
命名空間中才能訪問它們。
在終端中,更改為 SAMPLES
命名空間,然後啟動 Python shell
,如下所示:
USER>set $namespace = "SAMPLES"
SAMPLES>do ##class(%SYS.Python).Shell()
Python 3.9.5 (default, Jul 19 2021, 17:50:44) [MSC v.1927 64 bit (AMD64)] on win32
Type quit() or Ctrl-D to exit this shell.
>>>
當從終端會話啟動 Python shell
時,Python shell
繼承與終端相同的上下文,例如,當前命名空間和用戶。局部變量不被繼承。
要從 Python
訪問 IRIS
類,請使用 iris
模塊來實例化要使用的類。然後,可以像訪問 Python
類一樣使用訪問它的屬性和方法。
注意:可能習慣於在 Python
中導入模塊,然後再使用它,例如:
>>> import iris
但是,在使用 %SYS.Python
類的 Shell()
方法運行 Python shell
時,不需要顯式導入 iris
模塊。繼續使用該模塊。
以下示例使用系統類 %Library.File
的 ManagerDirectory()
方法打印 IRIS
管理器目錄的路徑:
>>> lf = iris.cls('%Library.File')
>>> print(lf.ManagerDirectory())
C:\InterSystems\IRIS\mgr\
此示例使用系統類 %SYSTEM.CPU
的 Dump()
方法來顯示有關正在運行 IRIS
實例的服務器的信息:
>>> cpu = iris.cls('%SYSTEM.CPU')
>>> cpu.Dump()
-- CPU Info for node MYSERVER ----------------------------------------------
Architecture: x86_64
Model: Intel(R) Core(TM) i7-7600U CPU @ 2.80GHz
Vendor: Intel
# of threads: 4
# of cores: 2
# of chips: 1
# of threads per core: 2
# of cores per chip: 2
MT supported: 1
MT enabled: 1
MHz: 2904
------------------------------------------------------------------------------
此示例使用 GitHub
上 Samples-Data
存儲庫中的 Sample.Company
類。雖然可以使用任何命名空間中以百分號 (%
) 開頭的類(如 %SYS.Python
或 %Library.File
)來訪問 Sample.Company
類,但如前所述,必須位於 SAMPLES
命名空間中。
Sample.Company
的類定義如下:
Class Sample.Company Extends (%Persistent, %Populate, %XML.Adaptor)
{
/// The company's name.
Property Name As %String(MAXLEN = 80, POPSPEC = "Company()") [ Required ];
/// The company's mission statement.
Property Mission As %String(MAXLEN = 200, POPSPEC = "Mission()");
/// The unique Tax ID number for the company.
Property TaxID As %String [ Required ];
/// The last reported revenue for the company.
Property Revenue As %Integer;
/// The Employee objects associated with this Company.
Relationship Employees As Employee [ Cardinality = many, Inverse = Company ];
}
此類擴展 %Library.Persistent
(通常縮寫為 %Persistent
),這意味著此類的對象可以持久保存在 IRIS
數據庫中。該類還具有多個屬性,包括 Name
和 TaxID
,這兩個屬性都是保存對象所必需的。
盡管不會在類定義中看到它們,但持久類帶有許多用於操作此類對象的方法,例如 %New()
、%Save()
、%Id()
和 %OpenId()
。但是,Python
方法名稱中不允許使用百分號 (%
),因此請改用下劃線 (_
)。
下面的代碼創建一個新的 Company
對象,設置所需的 Name
和 TaxID
屬性,然後將公司保存在數據庫中:
>>> myCompany = iris.cls('Sample.Company')._New()
>>> myCompany.Name = 'Acme Widgets, Inc.'
>>> myCompany.TaxID = '123456789'
>>> status = myCompany._Save()
>>> print(status)
1
>>> print(myCompany._Id())
22
上面的代碼使用 _New()
方法創建類的實例,並使用 _Save()
將實例保存在數據庫中。 _Save()
方法返回一個狀態碼。在這種情況下,1
表示保存成功。當保存一個對象時, IRIS
會為其分配一個唯一 ID
,可以在以後使用該 ID
從存儲中檢索該對象。 _Id()
方法返回對象的 ID
。
使用類的 _OpenId()
方法將對象從持久存儲中檢索到內存中進行處理:
>>> yourCompany = iris.cls("Sample.Company")._OpenId(22)
>>> print(yourCompany.Name)
Acme Widgets, Inc.
將以下代碼添加到類定義中會創建一個 Print()
方法,該方法打印當前公司的 Name
和 TaxID
。將 Language
關鍵字設置為 python
會告訴類編譯器該方法是用 Python
編寫的。
Method Print() [ Language = python ]
{
print ('\nName: ' + self.Name + ' TaxID: ' + self.TaxID)
}
給定一個 Company
對象,可以調用它的 Print()
方法,如下所示:
>>> yourCompany.Print()
Name: Acme Widgets, Inc. TaxID: 123456789