Open ExchangeParece-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:
.jpg)
.png)
.png)