IRIS API Nativa para ObjectScript

Artigo

Heloisa Paiva · 12 hr atrás 3min de leitura

Open Exchange

Parece-me que, por alguma razão, isto não chegou à documentação oficial e aparenta ser pouco conhecido, embora já tenha sido implementado no IRIS 2020.1.

Graças a @Dan Pasco, obtive uma pista sobre as classes envolvidas. Usei a sequência recomendada de como utilizá-lo. Tudo foi retirado diretamente da Referência de Classe e eu apenas compilei para criar uma primeira visão geral.

A API Nativa para ObjectScript segue a API utilizada em outras plataformas de linguagem. Começa com uma API estática que permite ao usuário conectar-se a um Namespace do IRIS, seja local ou remoto, usando uma Conexão Iris (Iris Connection). A interface de conexão permite então que o usuário instancie a classe da API Nativa do IRIS (%Net.DB.Iris). Essa instância pode ser usada para acessar Arrays Globais do IRIS, gerenciar transações, invocar funções e métodos implementados em rotinas ou classes, e instanciar iteradores remotos.

%Net.DB.DataSource

Esta classe implementa a interface DataSource da API Nativa do IRIS para Object Script. No momento, essa interface consiste unicamente no método CreateConnection.

CreateConnection aceita os parâmetros url, port, namespace, user e pwd. Consulte %Net.DB.Connection para mais informações sobre esses parâmetros.. CreateConnection() retorna uma instância de %Net.DB.Connection.

host	input	O nome ou endereço do host, padrão é127.0.0.1
port	input	A porta na qual se conectar.
namespace	input	O namespace para se conectar.
user	input	O nome do usuário.
pwd	input	Senha do usuário.
timeout	input	O número de segundos para aguardar que a conexão seja estabelecida. Opcional.
logfile	input	O nome do arquivo a ser usado para logging. Se especificado, a atividade de conexão será registrada nesse arquivo. Opcional.
	return	Uma oref referenciando uma instância de %Net.DB.Connection

%Net.DB.Connection

Esta classe implementa a interface Connection da API Nativa do IRIS para Object Script. Esta classe nunca deve ser instanciada diretamente, apenas através de %Net.DB.DataSource usando a função CreateMethod().

A interface pública para esta classe inclui apenas os itens especificados aqui. Todos os outros membros são internos.

Host	property	O host especificado ao estabelecer a conexão.
Port	property	A porta à qual esta conexão está conectada.
Namespace	property	O namespace ao qual esta conexão está conectada.
Timeout	property	O valor de timeout especificado ao estabelecer a conexão.
IsClosed	method	Retorna true se esta instância de conexão não estiver mais conectada.
Close	method	Fecha esta conexão.
CreateIris	method	Retorna uma instância de %Net.DB.Iris.

%Net.DB.Iris

Esta classe implementa o conjunto primário de funções da API Nativa do IRIS para Object Script.

Os únicos outros membros da API Nativa do IRIS que não são implementados por esta classe são implementados por % Net.DB.DataSource and %Net.DB.Connection.
Esta classe nunca deve ser instanciada diretamente.
A maneira correta de instanciar esta classe é invocar o método CreateIris() usando uma instância de %Net.DB.Connection.

Resumo dos métodos:

GitHub

Confira o aplicativo relacionado no InterSystems Open Exchange

Ir para o posto original escrito por @Robert Cemper

ClassMethodValue	ClassMethodVoid	~~Function~~	Get
GetBoolean	GetNext	GetObject	GetRecordMetadata
GetSchema	GetTLevel	Increment	IsDefined
Kill	Lock	Procedure	ReleaseAllLocks
Set	TCommit	TRollback	TRollbackOne
TStart	Unlock