APÊNDICE C – Especificação de Requisitos – Projeto Conversor de Temperaturas Especificação de Requisitos Projeto Conversor de Temperaturas Elaborado por Bárbara Bivar UNIVERSIDADE FEDERAL FLUMINENSE 2013 Conteúdo 1. Identificação de Serviços Candidatos ................................................................................ 4 2. Detalhamento de serviços candidatos ................................................................................ 4 2.1. Serviço Conversão de Temperaturas ................................................................................. 4 2.1.1. Definições Iniciais do Serviço ..................................................................................... 4 2.1.1.1. Escopo do Serviço ................................................................................................ 4 2.1.1.2. Público Almejado ................................................................................................ 4 2.1.2. Descrição Geral ........................................................................................................... 5 2.1.2.1. Identificação dos objetivos do Serviço ............................................................... 5 2.1.2.2. Aplicações que podem utilizar o serviço (reuso) ............................................... 5 2.1.2.3. Tipo de Serviço .................................................................................................... 5 2.1.3. Requisitos Funcionais ................................................................................................. 5 2.1.4. Requisitos Não Funcionais.......................................................................................... 5 2.1.5. Modelagem do Serviço ................................................................................................ 6 2.1.5.1. Modelo de Classes Conceitual ............................................................................ 6 2.1.5.2. Modelo de Casos de Uso...................................................................................... 6 2.1.5.3. Diagrama de Atividades...................................................................................... 8 2.1.6. Ferramentas (Hardware e Software) ......................................................................... 8 Histórico de Revisão Nome Data Motivo da Alteração Versão Bárbara Bivar 16/03/2013 Versão Inicial 1.0 1. Identificação de Serviços Candidatos Nome Descrição Conversão de Temperaturas (Celsius/Fahrenheit) A partir de uma temperatura informada em Celsius o serviço converterá para Fahrenheit. Ou a partir de uma temperatura informada em Fahrenheit o serviço converterá para Celsius. 2. Detalhamento de serviços candidatos 2.1. Serviço Conversão de Temperaturas 2.1.1. Definições Iniciais do Serviço 2.1.1.1. Escopo do Serviço O serviço de Conversão de Temperaturas é uma funcionalidade de conversão de valores numéricos. O serviço espera receber um valor numérico de temperatura, e sobre esse valor é efetuado um cálculo. Após o calculo, o valor da temperatura convertido é retornado. O cálculo que é aplicado ao número informado como entrada é dado da seguinte maneira: Conversão de Celsius para Fahrenheit: F = C × 1,8 + 32 Onde : F - temperatura em Fahrenheit C - temperatura em Celsius Conversão de Fahrenheit para Celsius: °C = (°F − 32) / 1,8 Onde : F - Temperatura em Fahrenheit C - temperatura em Celsius 2.1.1.2. Público Almejado O serviço poderá ser utilizado por pessoas que necessitam realizar uma conversão de temperatura. 2.1.2. Descrição Geral 2.1.2.1. Identificação dos objetivos do Serviço O objetivo do serviço consiste em retornar um valor numérico de temperatura convertido a partir de outro dado numérico de temperatura informado. 2.1.2.2. Aplicações que podem utilizar o serviço (reuso) O serviço de conversão de temperaturas poderá ser utilizado em aplicações que executam transformação de temperatura. 2.1.2.3. Tipo de Serviço O serviço é Utilitário, porque implementa apenas uma funcionalidade geral, que pode ser utilizada de maneira genérica por vários processos das aplicações. 2.1.3. Requisitos Funcionais REQ01: O valor da temperatura informada deve ser numérico. REQ02: O sistema deverá ser capaz de validar se a temperatura informada é uma temperatura válida. Uma temperatura é dita válida se está em formato numérico. 2.1.4. Requisitos Não Funcionais A seguir são apresentados os requisitos não funcionais: Disponibilidade: DS-1: O serviço ficará disponível 24h por dia, exceto se houver indisponibilidade do servidor. Confiabilidade CF-1: O serviço não retornará valores errados porque o cálculo de conversão é inalterável. Manutenibilidade MN-1: Deverá ser utilizado em todos os casos a anotação padrão @javax.jws. Portabilidade PR-1: O serviço pode ser executado a partir de diversos tipos de aplicações que podem estar rodando em quaisquer sistemas operacionais. 2.1.5. Modelagem do Serviço 2.1.5.1. Modelo de Classes Conceitual 2.1.5.2. Modelo de Casos de Uso Converte Celsius para Fahrenheit Cenário Principal: Conversão de Celsius para Fahrenheit realizada com sucesso 1. A Aplicação informa ao serviço o valor da temperatura a em Celsius; 2. O Serviço recebe o valor de temperatura informado; 3. O Serviço valida o valor da temperatura informado (include - Valida Temperatura) ; 4. O Serviço realiza a conversão do valor para Fahrenheit; 5. O Serviço retorna o valor convertido da temperatura em Fahrenheit; 6. O caso de uso é encerrado. Cenário Alternativo 1: Valor da temperatura Fahrenheit informado não é valido 1. A Aplicação informa ao serviço o valor numérico de temperatura a ser convertido; 2. O Serviço recebe o valor de temperatura informado; 3. O Serviço valida o valor da temperatura informado (include - Valida Temperatura); Os demais passos não são realizados. Converte Fahrenheit paraCelsius Cenário Principal: Conversão de Fahrenheit para Celsius realizada com sucesso 1. A Aplicação informa ao serviço o valor da temperatura a em Fahrenheit ; 2. O Serviço recebe o valor de temperatura informado; 3. O Serviço valida o valor da temperatura informado (include - Valida Temperatura) ; 4. O Serviço realiza a conversão do valor para Celcius; 5. O Serviço retorna o valor convertido da temperatura em Celsius; 6. O caso de uso é encerrado. Cenário Alternativo 1: Valor da temperatura Celcius informado não é valido 1. A Aplicação informa ao serviço o valor numérico de temperatura a ser convertido; 2. O Serviço recebe o valor de temperatura informado; 3. O Serviço valida o valor da temperatura informado(include - Valida Temperatura); Os demais passos não são realizados. Valida temperatura Cenário Principal: Temperatura válida 1. O sistema verifica se a temperatura informada está em um formato válido 2. O caso de uso é encerrado. Cenário Alternativo 1: Temperatura inválida 1. O sistema verifica se a temperatura informatada está em um formato válido; 2. O sistema gera uma exceção, informando que a temperatura é inválida Os demais passos não são executados. 2.1.5.3. Diagrama de Atividades 2.1.6. Ferramentas (Hardware e Software) A ferramenta que será utilizada no desenvolvimento do serviço será o NetBeans IDE, que oferece suporte a Java EE 6 , incluindo padrões de web services JAX-WS 2.2, JAX-RS 1.1 e JAXB 2.2. E também Apache Tomcat para implantação.