Registrar Biblioteca

1 Descrição

As bibliotecas são ferramentas empacotadas como classes, que estão disponíveis para uso das aplicações, geralmente na camada model. Uma biblioteca necessita estar registrada para ser conhecida pela fábrica de objetos, que é o padrão escolhido para gerar objetos das bibliotecas. Uma primeira categoria de biblioteca é representada pelas classes estáticas Factory, Security e Settings, que são obrigatoriamente carregadas na inicialização do módulo. Estas classes são conhecidas como classes nativas, porque seu registro não pode ser modificado. A segunda categoria são bibliotecas previamente registradas que fornessem acesso a recursos do Expresso, bem como empacotam softwares de terceiros incorporados ao módulo de aplicações. Existe ainda uma terceira categoria de biblioteca representada pelas classes personalizadas de uma organização, que as desenvolveu para atender a alguma demanda de seu ambiente. Excetuando as classes estáticas, qualquer biblioteca deve ser invocada sob demanda, através da fábrica de objetos.

2 Atores

Administrador do Módulo.

3 Pré-condições

Estar logado no Expresso como administrador do módulo.

4 Eventos

1. Sistema exibe a lista de bibliotecas registradas.
2. Administrador informa os dados de uma nova biblioteca {A1}{A2}
3. Sistema persiste os dados da biblioteca em banco de dados.

5 Eventos Alternativos

{A1} Administrador escolhe manter os dados de uma biblioteca já registrada.

{A2} Administrador escolhe inativar uma biblioteca já registrada.

6 Tratamento de Erros

Uma biblioteca inativa, que venha a ser invocada por alguma aplicação, produzirá um aviso de erro a ser logado na pasta log da aplicação, com a mensagem {M1}

Poderão existir métodos depreciados em um biblioteca, que ao serem invocados produzirão um aviso de erro a ser logado também na pasta de log da aplicação, com a mensagem {M2}

7 Mensagem

{M1} Biblioteca <nome da biblioteca> encontra-se inativa.

{M2} Chamada a método depreciado <nome do método> da biblioteca <nome da biblioteca> deve ser substituído por função equivalente ou suprimido.

8 Pós-condições

Biblioteca registrada em banco de dados

9 Regras de Negócio

Dados obrigatórios para uma biblioteca:

• Nome da Biblioteca
• Descrição
• Caminho da biblioteca
• Nome de arquivo da biblioteca
• Indicativo de atividade

As bibliotecas de sistema terão como caminho padrão a pasta 'bin' relativa à raiz do módulo, e deverão ser previamente registradas na instalação do ambiente.

As bibliotecas nativas Factory, Security e Settings não necessitam registro e devem ficar localizadas a pasta 'lib' relativa à raiz do módulo.

As bibliotecas personalizadas podem ser registradas em qualquer caminho do sistema de arquivos do servidor Expresso, contanto que o caminho escolhido seja acessível pelo módulo PHP, através da configuração da chave open_basedir do arquivo php.ini.

10 Telas Envolvidas

Não relevante.

11 Notas

Algumas bibliotecas de sistema já identificadas como necessárias:

• Ldap
• Orgchart
• Location
• Log
• Mail
• Util
• Login
• Aplication
• Process
• Instance
• Validate