(→Interacção com o utilizador) |
(→Menu Principal) |
||
| Line 258: | Line 258: | ||
== Menu Principal == | == Menu Principal == | ||
| − | As acções deste menu permitem gerir a salvaguarda do estado da aplicação, abrir submenus | + | As acções deste menu permitem gerir a salvaguarda do estado da aplicação, realizar algumas operações globais e abrir submenus. A lista completa é a seguinte: [[#Salvaguarda do estado actual da aplicação|Criar]], [[#Salvaguarda do estado actual da aplicação|Abrir]], [[#Salvaguarda do estado actual da aplicação|Guardar]], [[#Avançar Estação do Ano|Avançar Estação do Ano]], [[#Ver Estado de Satisfação|Ver Estado de Satisfação]], [[#Menu de Gestão de Animais|Gestão de Animais]], [[#Menu de Gestão de Funcionários|Gestão de Funcionários]], [[#Menu de Gestão de Vacinas|Gestão de Vacinas]], [[#Menu de Gestão de Habitats|Gestão de Habitats]] e [[#Menu de Consultas|Consultas]]. As secções abaixo descrevem pormenorizadamente as acções associadas a estas opções. |
{{CVSCode|As etiquetas das opções deste menu estão definidas na classe '''hva.app.main.Label'''. Todos os métodos correspondentes às mensagens de diálogo para este menu estão definidos em '''hva.app.main.Prompt''' e '''hva.app.main.Message'''.}} | {{CVSCode|As etiquetas das opções deste menu estão definidas na classe '''hva.app.main.Label'''. Todos os métodos correspondentes às mensagens de diálogo para este menu estão definidos em '''hva.app.main.Prompt''' e '''hva.app.main.Message'''.}} | ||
| AVISOS - Avaliação em Época Normal |
|---|
|
Esclarecimento de dúvidas:
|
|
Requisitos para desenvolvimento, material de apoio e actualizações do enunciado (ver informação completa em Projecto de Programação com Objectos):
|
|
Processo de avaliação (ver informação completa em Avaliação do Projecto):
|
| Material de Uso Obrigatório |
|---|
| As bibliotecas po-uilib e o conteúdo inicial do repositório GIT são de uso obrigatório: |
|
| A máquina virtual, fornecida para desenvolvimento do projecto, já contém todo o material de apoio. |
| Uso Obrigatório: Repositório GIT |
| Apenas se consideram para avaliação os projectos existentes no repositório GIT oficial.
Trabalhos não presentes no repositório no final do prazo têm classificação 0 (zero) (não são aceites outras formas de entrega). Não são admitidas justificações para atrasos em sincronizações do repositório. A indisponibilidade temporária do repositório, desde que inferior a 24 horas, não justifica atrasos na submissão de um trabalho. |
EM PREPARAÇÃO
ÉPOCA NORMAL
O objectivo do projecto é desenvolver uma aplicação de gestão de um hotel veterinário que dispõe de tratadores, veterinários e habitats com árvores.
Os animais de várias espécies são mantidos por tratadores que são responsáveis por distribuir a comida e pela limpeza dos habitats, e por veterinários, que têm a responsabilidade de zelar pela saúde dos animais. Quando um animal recebe uma vacina não apropriada à sua espécie, por causa de um erro veterinário, por exemplo, fica com a saúde afectada até ao fim da sua vida. Os habitats têm árvores. É possível calcular o grau de satisfação dos animais e dos funcionários.
Em todos os campos identificadores ou nomes, excepto se indicado o contrário, as diferenças entre maiúsculas e minúsculas são irrelevantes.
As espécies são identificadas por uma chave única (cadeia de caracteres arbitrária definida na altura da criação).
Cada espécie tem um nome (cadeia de caracteres única, i.e., não existem duas espécies distintas com o mesmo nome) e um registo dos animais da espécie.
Os animais são identificados por uma chave única (cadeia de caracteres arbitrária definida na altura da criação).
Cada animal tem um nome (cadeia de caracteres não única) e informação acerca da sua espécie e do estado de saúde.
É possível calcular o nível de satisfação de um animal. Este valor depende de vários factores (ver a seguir).
A satisfação dos animais é afectada positivamente quando existem mais animais da mesma espécie no mesmo habitat e afectada negativamente quando existem animais de outras espécies. O número total de animais no habitat e o próprio habitat também influenciam a satisfação dos animais que lá vivem.
A satisfação de um animal a no seu habitat h é calculada pela fórmula:
Nesta equação, iguais conta o número de animais da mesma espécie no habitat (sem contar com a), diferentes é o número de animais de espécies diferentes da de a no habitat, área é a área do habitat e população é a população total do habitat, adequação é 20 se a influência do habitat for positiva, -20 se for negativa e 0 se a influência for neutra (condição por omissão).
Os habitats são identificados por uma chave única (cadeia de caracteres arbitrária definida na altura da criação).
Cada habitat tem um nome (cadeia de caracteres; não única) e informação sobre a área (número inteiro). Os habitats estão associados a zero ou mais árvores e a zero ou mais animais. Estão ainda associados às espécies cuja satisfação influenciam.
Os habitats podem ser mais (ou menos) adequados para determinadas espécies. A adequação tem impacto no grau de satisfação dos animais. Por omissão, um habitat tem um impacto neutro para cada espécie.
As árvores são identificadas por uma chave única (cadeia de caracteres arbitrária definida na altura da criação). Cada árvore tem ainda nome (cadeia de caracteres; não única) e idade em anos (número inteiro). As árvores podem ser de folha caduca ou perene e são caracterizadas pela dificuldade de limpeza (número inteiro) que induzem no habitat onde estão implantadas (definido no momento da introdução da árvore no habitat).
A vida das árvores segue o ciclo definido pelas estações do ano. Assim, por exemplo, as árvores de folha caduca perdem as folhas principalmente durante o Outono, ficando sem folhas no Inverno. As árvores de folha perene perdem algumas folhas durante todas as estações, mas mais durante o Inverno.
O esforço de limpeza de uma árvore é assim determinado pelo produto de três factores: o primeiro corresponde à dificuldade intrínseca de limpeza da árvore; o segundo depende da estação do ano e do tipo de árvore, tal como indicado na tabela seguinte (função esforço_sazonal); e o terceiro corresponde a um factor que aumenta com a idade da árvore (ver abaixo).
| Estação » | Inverno | Primavera | Verão | Outono |
|---|---|---|---|---|
| Folha caduca » | 0 | 1 | 2 | 5 |
| Folha perene » | 2 | 1 | 1 | 1 |
O esforço de limpeza proporcional à idade da árvore cresce logaritmicamente (i.e., não muito rapidamente): log(idade + 1) (logaritmo natural).
Combinando os vários elementos, obtém-se a fórmula:
Quando uma árvore é criada, fica na estação do ano em que a aplicação estiver no momento da criação. A estação inicial da aplicação é a Primavera.
As árvores envelhecem com as estações, i.e., a idade aumenta em 1 unidade (1 ano) a cada 4 estações (note-se que o incremento não é necessariamente simultâneo em todas as árvores).
Os funcionários são identificados por uma chave única (cadeia de caracteres arbitrária definida na altura da criação). Os funcionários têm um nome (cadeia de caracteres não única).
Existem dois tipos de funcionários: tratadores e veterinários. Cada tratador está associado aos habitats da sua responsabilidade (zero ou mais). Cada veterinário está associado às espécies que sabe vacinar (zero ou mais).
A satisfação dos veterinários é afectada positivamente pela existência de outros veterinários com a mesma responsabilidade (n_veterinários(e)) e negativamente pelo número de animais que estão sob a sua responsabilidade. Apenas se contabilizam as espécies que o veterinário pode tratar (espécies(v)).
A satisfação para um veterinário v é calculada pela fórmula:
A satisfação dos tratadores é afectada negativamente pelo trabalho que lhes é atribuído. Apenas se contabilizam os habitats sob responsabilidade do tratador (habitats(t)). O trabalho é também influenciado pelas árvores existentes no habitat (árvores(h)) (ver também secção sobre habitats e árvores).
A satisfação para um tratador t é calculada pela fórmula:
As vacinas são identificadas por uma chave única (cadeia de caracteres arbitrária definida na altura da criação).
Cada vacina tem um nome (cadeia de caracteres; não única) e está associada às espécies a que pode ser aplicada. Tem ainda o registo de aplicações a cada animal pelos veterinários, por ordem de vacinação.
O estado de saúde de um animal é o histórico de eventos (inicialmente vazio), relacionados com a vacinação do animal, a partir da situação inicial, entre os quais estão os danos causados por más vacinações.
Se a espécie do animal está incluída nas espécies para as quais uma vacina é apropriada, então o valor do dano causado pela vacina é 0 (zero):
Caso contrário, os danos causados pela má administração de uma vacina v a um animal a dependem do máximo do número de letras distintas entre o nome da espécie de a (espécie(a)) e os nomes das espécies a que se destinava v (espécies(v)).
Por exemplo, quando uma ave recebe uma vacina destinada apenas a um mamífero, o dano resultante da má aplicação da vacina é igual a 6.
A seguinte tabela descreve os resultados associados aos potenciais danos causados por vacinações:
| Dano | Termo a adicionar na apresentação do estado de saúde |
|---|---|
| 0 (mesma espécie) | NORMAL |
| 0 (espécies diferentes) | CONFUSÃO |
| 1 a 4 | ACIDENTE |
| 5 ou mais | ERRO |
Por exemplo, um animal que tenha recebido 2 vacinas com um dano entre 1 e 4 (ACIDENTE), três vacinas com um dano igual ou superior a 5 (ERRO) e uma vacina correctamente aplicada, apresenta o seguinte historial de saúde (usa-se a vírgula como separador): ACIDENTE,ACIDENTE,ERRO,ERRO,ERRO,NORMAL (i.e., concatenação ordenada por ordem de ocorrência).
A aplicação permite:
Uma base de dados textual com conceitos pré-definidos pode ser carregada no início da aplicação.
As operações são as seguintes: (i) visualizar todos os animais; (ii) registar um novo animal; (iii) transferir um animal para um habitat; (iv) calcular a satisfação de um animal.
As operações são as seguintes: (i) visualizar todos os funcionários; (ii) registar um novo funcionário; (iii) atribuir uma nova responsabilidade a um funcionário; (iv) retirar uma responsabilidade a um funcionário; (v) calcular a satisfação de um funcionário.
As operações são as seguintes: (i) visualizar todos os habitats; (ii) registar um novo habitat; (iii) alterar a área de um habitat; (iv) alterar influência de um habitat sobre uma espécie; (v) plantar uma nova árvore num habitat; (vi) visualizar todas as árvores de um habitat.
As operações são as seguintes: (i) visualizar todas as vacinas; (ii) registar uma nova vacina; (iii) vacinar um animal; (iv) listar o histórico de vacinações.
É possível efectuar pesquisas sob vários critérios e sobre as diversas entidades: (i) consultar animais de um habitat; (ii) consultar vacinas de um animal; (iii) consultar actos médicos de um veterinário; (iv) consultar vacinas dadas com incúria.
É possível guardar e recuperar o estado actual da aplicação, preservando toda a informação relevante (descrita acima).
A aplicação a desenvolver deve seguir o princípio de desenho aberto-fechado por forma a aumentar a extensibilidade do seu código. Por exemplo, deve ser possível adicionar novos tipos de funcionários com um impacto mínimo no código já existente do domínio.
Aplicação de um padrão de desenho para melhorar a legibilidade do código relacionado com o conceito árvore e permitir ao mesmo tempo que se possam adicionar novos eventos relacionados com as estações sem que isso implique alterar o código relacionado com árvores. O padrão deve ainda poder suportar novas funcionalidades dependentes da estação actual (por exemplo, qual a cor das folhas de uma árvore, que vai depender do tipo de árvore e da estação actual) sem comprometer a legibilidade da solução.
Aplicação de um padrão de desenho que permita novas políticas de cálculo da satisfação dos funcionários sem impacto no código existente. A solução concretizada deve permitir alterar o cálculo da satisfação de um funcionário em tempo de execução. Quando é criado um funcionário, o cálculo da satisfação segue a fórmula descrita neste enunciado.
Deve ser possível introduzir novos métodos de pesquisa com um impacto mínimo na implementação desenvolvida.
Apesar de haver na especificação actual apenas um hotel, o código não deve assumir que não podem existir mais instâncias.
Descreve-se nesta secção a funcionalidade máxima da interface com o utilizador. Em geral, os comandos pedem toda a informação antes de procederem à sua validação (excepto onde indicado). Todos os menus têm automaticamente a opção Sair (fecha o menu).
As operações de pedido e apresentação de informação ao utilizador devem realizar-se através dos objectos form e display, respectivamente, presentes em cada comando. As mensagens são produzidas pelos métodos das bibliotecas de suporte (po-uilib e hva-app). As mensagens não podem ser usadas no núcleo da aplicação (hva-core). Além disso, não podem ser definidas novas. Potenciais omissões devem ser esclarecidas antes de qualquer implementação.
A apresentação de listas (e.g., animais, funcionários, vacinas, etc.) faz-se por ordem crescente da respectiva chave, excepto em caso de indicação contrária. A ordem das chaves alfanuméricas deve ser lexicográfica (UTF-8), não havendo distinção entre maiúsculas e minúsculas.
De um modo geral, sempre que no contexto de uma operação com o utilizador aconteça alguma excepção, então a operação não deve ter qualquer efeito no estado da aplicação, excepto em caso de indicação contrária na operação em causa. As excepções estão na package hva.app.exceptions, excepto em caso de indicação contrária.
As excepções usadas na interacção (subclasses de pt.tecnico.uilib.menus.CommandException), excepto em caso de indicação contrária, são lançadas pelos comandos (subclasses de pt.tecnico.uilib.menus.Command) e tratadas pelos menus (instâncias de subclasses de pt.tecnico.uilib.menus.Menu). Outras excepções não devem substituir as fornecidas nos casos descritos.
Nos pedidos e usos dos vários identificadores, podem ocorrer as seguintes excepções, caso o identificador indicado não corresponda a um objecto conhecido (excepto no processo de registo ou em caso de indicação contrária). Note-se que estas excepções não são utilizáveis no núcleo da aplicação.
| Tipo de dados | Classe | Pedido a apresentar | Excepção a lançar se desconhecido |
|---|---|---|---|
| Animal | Animal | hva.app.animal.Prompt.animalKey() | hva.app.exceptions.UnknownAnimalKeyException |
| Espécie | Species | hva.app.animal.Prompt.speciesKey() | hva.app.exceptions.UnknownSpeciesKeyException |
| Funcionário | Employee | hva.app.employee.Prompt.employeeKey() | hva.app.exceptions.UnknownEmployeeKeyException |
| Habitat | Habitat | hva.app.habitat.Prompt.habitatKey() | hva.app.exceptions.UnknownHabitatKeyException |
| Árvore | Tree | hva.app.habitat.Prompt.treeKey() | hva.app.exceptions.UnknownTreeKeyException |
| Vacina | Vaccine | hva.app.vaccine.Prompt.vaccineKey() | hva.app.exceptions.UnknownVaccineKeyException |
Alguns casos particulares podem usar pedidos específicos não apresentados nesta tabela.
As acções deste menu permitem gerir a salvaguarda do estado da aplicação, realizar algumas operações globais e abrir submenus. A lista completa é a seguinte: Criar, Abrir, Guardar, Avançar Estação do Ano, Ver Estado de Satisfação, Gestão de Animais, Gestão de Funcionários, Gestão de Vacinas, Gestão de Habitats e Consultas. As secções abaixo descrevem pormenorizadamente as acções associadas a estas opções.
Inicialmente, a aplicação não tem qualquer informação, excepto quando usada a propriedade import (ver abaixo) para pré-carregar dados iniciais. O conteúdo da aplicação (toda a informação actualmente em memória) pode ser guardado para posterior recuperação (via serialização Java: java.io.Serializable). Na leitura e escrita do estado da aplicação, devem ser tratadas as excepções associadas. A funcionalidade é a seguinte:
Quando se abandona uma aplicação com modificações não guardadas (porque se cria ou abre outra), deve perguntar-se se se quer guardar a informação actual antes de a abandonar, através de Prompt.saveBeforeExit() (a resposta é obtida invocando readBoolean() ou de Form.confirm()).
Esta opção permite avançar a estação do ano, afectando todas as árvores em todos os habitats.
O comando deve apresentar na saída o código para a estação actual: 0 para Primavera, 1 para Verão, 2 para Outono e 3 para Inverno.
O sistema apresenta, de imediato, o somatório dos estados de satisfação de todas as entidades registadas no hotel: animais e funcionários.
Note-se que o valor a apresentar é o que resulta do arredondamento ao inteiro mais próximo (via Math.round).
Este menu permite operar sobre animais. A lista completa é a seguinte: (i) visualizar todos os animais; (ii) registar um novo animal; (iii) transferir um animal para um habitat; (iv) calcular a satisfação de um animal. As secções abaixo descrevem estas opções.
O formato de apresentação de cada animal é o seguinte:
ANIMAL|idAnimal|nomeAnimal|idEspécie|historialDeSaúde|idHabitat
Se o animal nunca foi vacinado (com ou sem sucesso), o historial de saúde deve ser apresentado como VOID:
ANIMAL|idAnimal|nomeAnimal|idEspécie|VOID|idHabitat
O historial de saúde é apresentado como descrito em Problemas associados à vacinação, i.e., uma sequência de eventos separados por vírgulas.
O sistema pede o identificador do novo animal. De seguida pede o nome do animal (Prompt.animalName()), o identificador da espécie e o identificador do habitat.
Se o identificador da espécie não existe, deve pedir-se o nome da nova espécie (Prompt.speciesName()) (cadeia de caracteres) e registá-la com o identificador indicado.
Se o identificador do animal já existir, lança a excepção DuplicateAnimalKeyException, não se processando o registo.
Para realizar a operação, o sistema pede o identificador do animal e o identificador do habitat de destino.
O sistema pede o identificador do animal, sendo apresentado o valor da sua satisfação (arredondado ao inteiro mais próximo via Math.round).
Este menu permite operar sobre funcionários. A lista completa é a seguinte: (i) visualizar todos os funcionários; (ii) registar um novo funcionário; (iii) atribuir uma nova responsabilidade a um funcionário; (iv) retirar uma responsabilidade a um funcionário; (v) calcular a satisfação de um funcionário. As secções abaixo descrevem estas opções.
O formato de apresentação de cada funcionário é o seguinte:
tipo|id|nome|idResponsabilidades
Os valores para o campo tipo são VET ou TRT. Os valores para o campo idResponsabilidades são os identificadores, separados por vírgulas, dos habitats que um tratador pode limpar ou das espécies de animais que um veterinário pode tratar.
Se o funcionário não tiver responsabilidades atribuídas, o formato de apresentação é o seguinte:
tipo|id|nome
O sistema pede o identificador do novo funcionário, assim como o seu nome (Prompt.employeeName()) (cadeia de caracteres). De seguida, pede-se o tipo de funcionário (Prompt.employeeType()). A resposta deve ser VET (é registado um veterinário) ou TRT (é registado um tratador). Se a resposta não corresponder a nenhum dos dois valores, a pergunta é repetida até se obter uma resposta válida. Quando um funcionário é registado fica sem qualquer responsabilidade.
Se já existir um funcionário com o mesmo identificador, deve ser lançada a excepção DuplicateEmployeeKeyException, não se realizando qualquer acção.
O sistema pede o identificador do funcionário e o identificador da nova responsabilidade (Prompt.responsibilityKey()): o identificador de uma espécie, se for um veterinário; ou o identificador de um habitat, se for um tratador.
Se o funcionário já tinha essa responsabilidade, não é executada nenhuma acção.
Se a responsabilidade não existir, então deve ser lançada a excepção NoResponsibilityException.
O sistema pede o identificador do funcionário e o identificador da responsabilidade a retirar (Prompt.responsibilityKey()): o identificador de uma espécie, se for um veterinário; ou o identificador de um habitat, se for um tratador. Se a responsabilidade não estava atribuída ao funcionário ou não existe, é lançada a excepção NoResponsabilityException.
O sistema pede o identificador do funcionário, sendo apresentado o valor da sua satisfação (arredondado ao inteiro mais próximo via Math.round).
Este menu permite operar sobre habitats. A lista completa é a seguinte: (i) visualizar todos os habitats; (ii) registar um novo habitat; (iii) alterar a área de um habitat; (iv) alterar influência de um habitat sobre uma espécie; (v) plantar uma nova árvore num habitat; (vi) visualizar todas as árvores de um habitat. As secções abaixo descrevem estas opções.
O formato de apresentação para cada habitat é o seguinte:
HABITAT|idHabitat|nome|área|númeroÁrvores
Esta linha inicial pode ser seguida de zero ou mais linhas, cada uma com a descrição de cada árvore pertencente ao habitat usando o seguinte formato:
ÁRVORE|idÁrvore|nomeÁrvore|idadeÁrvore|dificuldadeLimpeza|tipoÁrvore|cicloBiológico
O valor de dificuldadeLimpeza é arredondado ao inteiro mais próximo (via Math.round).
O valores possíveis para tipoÁrvore são PERENE e CADUCA.
Os possíveis valores para o campo cicloBiológico são:
| Tipo de Árvore | Inverno | Primavera | Verão | Outono |
| CADUCA | SEMFOLHAS | GERARFOLHAS | COMFOLHAS | LARGARFOLHAS |
| PERENE | LARGARFOLHAS | GERARFOLHAS | COMFOLHAS | COMFOLHAS |
O sistema pede o identificador, o nome (Prompt.habitatName()) (cadeia de caracteres) e a área do habitat (Prompt.habitatArea()) (número inteiro), sendo registado o novo habitat.
Deve ser lançada a excepção DuplicateHabitatKeyException, se existir um habitat com o mesmo identificador, não se realizando qualquer acção.
O sistema pede o identificador do habitat assim como a nova área desse habitat (Prompt.habitatArea()) (número inteiro).
O sistema pede o identificador do habitat, o identificador da espécie e se a influência do habitat (Prompt.habitatInfluence()) sobre a espécie indicada é positiva (resposta: POS), negativa (resposta: NEG), ou neutra (resposta: NEU). Se a resposta não corresponder a nenhum dos três valores, esta última pergunta é repetida até se obter uma resposta válida.
O sistema pede o identificador do habitat e o identificador da nova árvore a plantar. De seguida, pede-se o nome (Prompt.treeName()) (cadeia de caracteres), a idade da árvore (Prompt.treeAge()), a dificuldade base de limpeza associada à árvore (Prompt.treeDifficulty()) (número inteiro) e o tipo de árvore (Prompt.treeType()) (PER para árvore de folha perene; CAD para árvores de folha caduca), registado-se a nova árvore. Se a resposta relativa ao tipo não corresponder a nenhum dos dois valores, esta última pergunta é repetida até se obter uma resposta válida.
Se já existir uma árvore com o mesmo identificador (em qualquer habitat), é lançada a excepção DuplicateTreeKeyException, não se realizando qualquer acção.
A nova árvore deve ser apresentada na saída. O formato de apresentação é como descrito acima.
O sistema pede o identificador do habitat e apresenta as árvores que nele existem. O formato de apresentação é como descrito acima.
Este menu permite operar sobre vacinas e vacinações. A lista completa é a seguinte: (i) visualizar todas as vacinas; (ii) registar uma nova vacina; (iii) vacinar um animal; (iv) listar o histórico de vacinações. As secções abaixo descrevem estas opções.
O formato de apresentação de cada vacina, uma por linha, é o seguinte:
VACINA|idVacina|nomeVacina|númeroDeAplicações|espécies
O campo espécies contém os identificadores, separados por vírgulas, das espécies de animais que podem receber a vacina.
O sistema pede o identificador da vacina, o nome (Prompt.vaccineName()) (cadeia de caracteres) da vacina e os identificadores das espécies que podem receber esta vacina (Prompt.listOfSpeciesKeys()) (lista de identificadores separados por vírgulas -- os espaços brancos são irrelevantes nesta resposta). De seguida regista a nova vacina.
Deve ser lançada a excepção DuplicateVaccineKeyException, se existir uma vacina com o mesmo identificador, não se realizando qualquer acção.
Se algum dos identificadores de espécies indicados for desconhecido, deve ser lançada a excepção UnknownSpeciesKeyException, não sendo registada a nova vacina.
O sistema pede o identificador da vacina, o identificador do veterinário (Prompt.veterinarianKey()) e o identificador do animal a vacinar. Se o identificador não for de um veterinário, deve ser lançada a excepção UnknownVeterinarianKeyException. Se o veterinário não tiver permissão para ministrar a vacina, deve ser lançada a excepção VeterinarianNotAuthorizedException e o comando não tem qualquer efeito. Se a vacina não for adequada ao animal, deve ser apresentada uma mensagem de aviso (Message.wrongVaccine()). Note-se que, neste caso, a vacinação acontece e os danos para o animal são registados.
O sistema lista todas as vacinas aplicadas, por ordem de aplicação, usando o seguinte formato:
REGISTO-VACINA|idVacina|idVeterinário|idEspécie
O menu de consultas permite efectuar pesquisas sobre as entidades do domínio e suas relações. Sempre que for feita uma consulta e nenhuma entidade satisfizer as condições associadas ao pedido, nada deve ser apresentado.
A lista completa é a seguinte: (i) consultar animais de um habitat; (ii) consultar vacinas de um animal; (iii) consultar actos médicos de um veterinário; (iv) consultar vacinas dadas com incúria. As secções abaixo descrevem estas opções.
O sistema pede o identificador do habitat, apresentando os animais que residem nesse habitat.
O formato de apresentação é como indicado para a listagem de animais.
O sistema pede o identificador do animal, apresentando as vacinações (por ordem de aplicação).
O formato de apresentação é como indicado para a listagem de vacinações.
O sistema pede o identificador de um funcionário. Se o identificador não for de um veterinário, deve ser lançada a excepção UnknownVeterinarianKeyException. Caso contrário, são apresentadas todas as vacinações por ele realizadas (por ordem de aplicação).
O formato de apresentação é como indicado para a listagem de vacinações.
O sistema apresenta todas as ocorrências de vacinações que provocaram problemas de saúde aos animais.
O formato de apresentação é como indicado para a listagem de vacinações (por ordem de aplicação).
Por omissão, quando a aplicação começa, não contém nenhuma informação e está na estação Primavera. No entanto, além das opções de manipulação de ficheiros descritas no menu principal, é possível iniciar exteriormente a aplicação com um ficheiro de texto especificado pela propriedade Java import. Quando se especifica esta propriedade, a aplicação é povoada com os objectos correspondentes ao conteúdo do ficheiro indicado.
No processamento destes dados, assume-se que não existem entradas mal-formadas e assume-se que os identificadores referidos numa entrada já foram previamente descritos. Sugere-se a utilização do método String.split() para dividir uma cadeia de caracteres em campos.
No formato abaixo: para os habitats, só os 4 primeiros campos são obrigatórios, correspondendo os opcionais a árvores implantadas no recinto; para os tratadores, só os 3 primeiros campos são obrigatórios, correspondendo os opcionais a habitats; e, para os veterinários e vacinas, só os 3 primeiros campos são obrigatórios, correspondendo os opcionais a espécies de animais.
| Formato do ficheiro de entrada textual |
|---|
ESPÉCIE|id|nome
ÁRVORE|id|nome|idade|dificuldade|tipo
HABITAT|id|nome|área|idÁrvore1,...,idÁrvoreN
ANIMAL|id|nome|idEspécie|idHabitat
TRATADOR|id|nome|idHabitat1,...,idHabitatN
VETERINÁRIO|id|nome|idEspécie1,...,idEspécieN
VACINA|id|nome|idEspécie1,…,idEspécieN
|
Se alguma das listas for vazia, então não se apresenta o último campo (nem o separador).
No seguinte exemplo, o conteúdo do ficheiro inicial (test.import) correspondente à folha apresentada a seguir.
| Exemplo de ficheiro de entrada textual |
|---|
ESPÉCIE|C10|ave
ESPÉCIE|C8|mamífero
ESPÉCIE|C1|peixe
ÁRVORE|T1|Pinheiro 1|5|20|PERENE
ÁRVORE|T4|Pinheiro 4|60|20|PERENE
ÁRVORE|T2|Oliveira|1200|10|PERENE
ÁRVORE|T6|Figueira|5|10|CADUCA
ÁRVORE|T3|Plátano|300|20|CADUCA
ÁRVORE|P1|Plátano|100|20|CADUCA
ÁRVORE|F30|Figueira|50|20|CADUCA
HABITAT|AR1|Aldeia dos Macacos|20|T3,P1,F30,T2
HABITAT|AR2|Floresta tropical|30|T1,T4,T6
HABITAT|AR3|Deserto|3
ANIMAL|A1|Alex|C10|AR1
ANIMAL|A2|Nemo|C1|AR2
ANIMAL|AA|Bobi|C8|AR1
ANIMAL|MA|Chita|C8|AR2
TRATADOR|W2SO4|John Figueiredo|AR2,AR3
TRATADOR|W2O|Rohit Figueiredo|AR1
TRATADOR|W24|Rohit Figueiredo
VETERINÁRIO|V2|Jorge Figueiredo|C10,C8,C1
VETERINÁRIO|V4|Filomena Figueiredo
VETERINÁRIO|VR|Abdul Figueiredo|C8
VACINA|V3|Tétano|C8
VACINA|V200|Parasitas intestinais|C10,C8,C1
VACINA|V42172|Tétano|C10
VACINA|Vexperimental|Gripe A1|C8
|
Usando os ficheiros test.import, test.in e test.out, é possível verificar automaticamente o resultado correcto do programa. Note-se que é necessária a definição apropriada da variável CLASSPATH (ou da opção equivalente -cp do comando java), para localizar as classes do programa, incluindo a que contém o método correspondente ao ponto de entrada da aplicação (hva.app.App.main). As propriedades são tratadas automaticamente pelo código de apoio (po-uilib).
java -Dimport=test.import -Din=test.in -Dout=test.outhyp hva.app.App
Assumindo que aqueles ficheiros estão no directório onde é dado o comando de execução, o programa produz o ficheiro de saída test.outhyp. Em caso de sucesso, os ficheiros das saídas esperada (test.out) e obtida (test.outhyp) devem ser iguais. A comparação pode ser feita com o comando:
diff -b test.out test.outhyp
Este comando não deve produzir qualquer resultado quando os ficheiros são iguais. Note-se, contudo, que este teste não garante o correcto funcionamento do código desenvolvido, apenas verificando alguns aspectos da sua funcionalidade.