Şekil Bilgisi

Um ambiente de dados é representado e controlado por um agente

DASEEnvironment. No entanto, para criar um novo ambiente de dados um agente

cliente não tem qualquer contato com agentes DASEEnvironment. Esta tarefa fica a cargo do agente DASEManager, que receberá solicitações de criação de ambiente de dados dos agentes clientes e os criará.

Para que possa solicitar a criação de um ambiente de dados, o agente cliente deve enviar ao DASEManager um descritor de ambiente de dados, representado pelo objeto DASEEnvironmentDescriptor. Entretanto o agente cliente pode ainda solicitar que o agente DASEProxy realize esta tarefa por ele.

O objeto DASEEnvironmentDescriptor contém todos os detalhes sobre o ambiente de dados a ser criado. Há duas formas de o agente cliente definir um descritor de ambiente de dados DASE:

1. Instanciação e configuração de um novo objeto

DASEEnvironmentDescriptor.

2. Criação de um objeto DASEEnvironmentDescriptor a partir de um arquivo XML de configuração que contenha a informação a ser mantida no descritor.

A forma mais indicada para a criação de um descritor de ambiente de dados é a segunda, pois permite maior flexibilidade e manutenibilidade do sistema por parte da aplicação cliente. O trecho de código da figura 23 mostra como um agente cliente solicita a criação de um ambiente de dados utilizando um arquivo XML de configuração e os serviços do DASEProxy.

10 _{Para facilitar a explicação, todas as figuras neste capítulo que representam código de programa}

Figura 23 - Criação de ambiente de dados a partir de arquivo XML.

Na linha 14 o agente cliente obtém uma referência a um agente DASEProxy. Em seguida, o agente cliente solicita ao agente DASEProxy que crie e inicie um ambiente de dados cujo descritor é representado por um arquivo XML de nome

env_descriptor.ded.xml. Isto ocorre na linha 15, sendo, no entanto , especificado env_descriptor. Isso ocorre porque a extensão padrão de arquivos XML para

descritores de ambientes de dados para o DASE é .ded.xml, por isso o DASE assume isso como padrão, não sendo portanto necessário informá-la.

Neste caso o agente DASEProxy, de posse do AID do agente DASEManager, cria um novo objeto descritor de ambiente de dados a partir do arquivo XML. Em seguida, ele verifica se o descritor possui informações consistentes. Isso evita que futuramente uma requisição de criação de ambiente de dados seja enviada ao

DASEManager contendo um descritor inválido, embora o DASEManager sempre

verifique a consistência do descritor antes de processá-lo.

Caso o descritor esteja consistente, uma mensagem ACL é criada e configurada de modo a representar a requisição de criação de um novo ambiente de dados. Esta mensagem é enviada pelo agente DASEProxy ao agente

8.2.1 XML utilizado em um descritor de ambiente de dados

A figura 24 apresenta um exemplo de arquivo XML que representa um descritor de ambiente de dados. Neste exemplo a maioria das propriedades possíveis de um descritor de ambiente de dados é utilizada, no entanto nem todas são obrigatórias.

Figura 24 - Exemplo de um arquivo XML que representa um descritor de ambiente de dados.

Para que um arquivo XML como este possa permitir a criação de um descritor válido, a propriedade label, e a tag driver e ao menos um nó (node) devem ser definidos. As demais tags e propriedades são opcionais ou assumiriam valores padrão. A propriedade label mantém o rótulo do ambiente de dados, conforme explicado na subseção 6.1.5. A tag driver indica qual é o driver JDBC utilizado pelo

ambiente de dados. Consequentemente é possível identificar qual é o SGBD adotado através de seu driver.

A tag node-list representa uma lista de node. Um node, ou nó, deve conter necessariamente as propriedades container e url. As propriedades user e password de um node são obrigatórias somente se as tags duser e dpassword não tiverem sido definidas, já que são opcionais. Este é o caso do exemplo da figura 24. Todas as demais propriedades assumem valores padrão caso não sejam definidas.

A tag sentence-list representa uma lista de sentence. Uma sentence é uma sentença SQL pré-definida que poderá ser utilizada a qualquer momento em qualquer requisição de acesso a dados destinada ao ambiente de dados em questão. Tal tag deve conter necessariamente as propriedades name, que é o identificador da sentença, e sql, que guarda a sentença SQL a ser executada.

Tais sentenças podem ainda conter parâmetros, tornando-as flexíveis e mais úteis. Todo parâmetro é reconhecido através de um identificador precedido de um caractere de dois pontos. Por exemplo, o descritor da figura 24 possui duas sentenças. A sentença chamada update não possui nenhum parâmetro, enquanto que a sentença chamada query_id possui um parâmetro chamado id. O valor deste parâmetro deve ser definido em tempo de execução permitindo que o agente cliente modifique dinamicamente a sentença pré-definida.

A tabela 7 descreve a função e o valor padrão de todas as tags, e suas propriedades, possíveis em um arquivo XML descritor de ambiente de dados DASE. Nesta tabela somente as propriedades opcionais possuem valor padrão. A propriedade path é utilizada para que o próprio sistema gere um arquivo de configuração a partir de um objeto DASEEnvironmentDescriptor. Conforme dito anteriormente, a extensão padrão, embora não obrigatória, de todo arquivo XML que representa um descritor de ambiente de dados é .ded.xml.

Tabela 7 - Tags de um arquivo XML descritor de ambiente de dados.

Tag ou

Propriedade Descrição Valor padrão

label Rótulo do ambiente de dados.

driver Driver JDBC do SGBD adotado para o ambiente de _dados.

cctype Tipo de controle de concorrência adotado. FORWARD lbtype Tipo de balanceamento de carga adotado. ROUND_ROBIN rctype Tipo de controle de recuperação adotado. FORWARD

path Caminho do arquivo de configuração do descritor _{de ambiente de dados.} label.ded.xml

similarity Indica se o sistema permitirá que mais de um nó _{possua a mesma URL.} False

duser Usuário padrão a ser usado em nó, caso o mesmo _{seja definido sem a especificação do usuário.} Null

dpassword Senha padrão a ser usada em nó, caso o mesmo

seja definido sem a especificação da senha. Null node-list Lista que contém a definição dos nós (node) do _{ambiente de dados.} -

node

Representa um nó do ambiente de dados. Esta tag possui as propriedades container, url, user e

password. Dessas, somente container e url são

obrigatórias.

-

container Nome do contêiner JADE que será utilizado como _{um dos nós do ambiente de dados.} url URL que permite a conexão entre o nó do ambiente _{de dados e o nó do SBD.}

user

Utilizada para autenticação no nó do SBD. Esta propriedade é obrigatória somente se duser e

dpassword não estiverem sido definidas.

password

Utilizada para autenticação no nó do SBD. Esta propriedade é obrigatória somente se duser e

dpassword não estiverem sido definidas.

sentence-list Lista que contém a definição das sentenças SQL _{pré-definidas do ambiente de dados.} -

sentence Sentença SQL pré-definida. -

name Nome da sentença SQL pré-definida. sql Código SQL da sentença SQL pré-definida.