:::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::
ATIVIDADE
3 - ESOFT - PROGRAMAÇÃO DE SISTEMAS I - 542023
Precisando de assessoria nos seus TRABALHOS entre em contato com a 2M ASSESSORIA
E-mail: assessoria.academica2m@gmail.com
Whats: (15) 98115-0680
QUESTÃO 1
A
documentação de um programa é fundamental, independentemente da linguagem de
programação utilizada. A documentação tem por objetivo apresentar
esclarecimentos com relação ao código desenvolvido, isso de dá pela escrita de
comentários diretamente no código-fonte. A documentação é essencialmente útil
para a manutenção do sistema, que pode ser realizada por diferentes
desenvolvedores. Dessa forma é fundamental criar uma documentação adequada e
clara do sistema.
A documentação se dá pela inserção de comentários diretamente no código-fonte.
Estes comentários podem ser classificados em dois tipos: o primeiro são os
comentários utilizados para gerar a documentação externa ao código, no caso do
Java com a ferramenta JavaDOC. O segundo são aqueles que estão disponíveis
somente pela leitura direta no código fonte. Os dois tipos de comentários são
ignorados pelo compilador durante o processo da geração do bytecode.
Veja a versão de uma calculadora em Java de forma estruturada. Isso porque os
conceitos de Programação Orientada a Objetos serão vistos em disciplina
posterior:
import java.util.Scanner;
public class CalculadoraEstruturada
{
public
static void main(String[] args) {
Scanner sc = new Scanner(System.in);
double operandoA,
operandoB, resultado;
operandoA = operandoB = resultado = 0;
char operacao;
System.out.println("Escolha a operação: ");
System.out.println("Soma______________: + ");
System.out.println("Subtração_________: - ");
System.out.println("Multiplicação_____: * ");
System.out.println("Divisão___________: / ");
System.out.println("Potência__________: ^ ");
System.out.println("Valor de Pi_______: p ");
System.out.println("Valor de PHI______: f ");
System.out.println("Valor de e________: e ");
System.out.println("----------------------");
System.out.println("Sair______________: s \n");
System.out.println();
operacao = sc.next().charAt(0);
if (operacao == 's') {
} else if (operacao == 'p') {
resultado = getPi();
System.out.printf("pi= %.2f ", resultado);
} else if (operacao == 'f') {
resultado = getFi();
System.out.printf("phi= %.2f ", resultado);
} else if (operacao == 'e') {
resultado = getE();
System.out.printf("e= %.2f ", resultado);
} else if (operacao == '+' || operacao == '-'
|| operacao == '*' || operacao == '/' || operacao == '^') {
System.out.println("Operando A: ");
operandoA = sc.nextDouble();
System.out.println("Operando B: ");
operandoB = sc.nextDouble();
resultado = operacaoesBasicas(operandoA, operacao, operandoB);
System.out.printf("%.2f %c %.2f = %.2f", operandoA, operacao,
operandoB, resultado);
}
}
public static
double operacaoesBasicas(double x, char operador, double y) {
double resultado = 0.0;
switch (operador) {
case '+':
resultado = x + y;
break;
case '-':
resultado = x - y;
break;
case '*':
resultado = x * y;
break;
case '/':
resultado = x / y;
break;
case '^':
resultado = Math.pow(x, y);
}
return resultado;
}
public static
double getPi() {
return Math.PI;
}
public static
double getE() {
return Math.E;
}
public static
double getFi() {
return 1.61803398874989484820;
}
}
A
partir do código-fonte apresentado, efetue as seguintes atividades:
1. Efetue a criação de um arquivo java com o código apresentado.
2. Efetue a documentação do código com o uso de comentários
JavaDoc, incluindo os seguintes itens:
a.
Descrição do programa.
b.
Definir um hiperlink para a documentação do JavaDOC com o endereço <
https://docs.oracle.com/javase/8/docs/technotes/tools/windows/javadoc.html>
(tag @see).
c.
Especificação da autoria do programa (tag @Autor).
d.
Especificação da versão (tag @Version).
e.
Descrição de cada um dos métodos (funções), os parêmtros de entrada (tag
@param) e o retorno (tag @return).
f.
Aperfeiçoe a documentação se achar necessário, com as respectivas tags.
3. Efetue
a criação da documentação JavaDOC para o programa da calculadora. O JavaDOC,
similar ao javac, pode ser executado pela IDE utilizada, ou diretamente pela
linha de comando. O comando JavaDOC tem a seguinte estrutura:
<C:\localDoArquivoJava> javadoc -d [path to javadoc destination
directory] [package name]>, alternativamente a [packabe
name] pode-se usar [javafile name].
Caso a codificação dos caracteres não fique correta, você pode definir a
codificação, como, por exemplo, UTF8, com o argumento <-encoding
utf8>. Para visualizar a documentação gerada, abra o arquivo index.html
na pasta destino especificada.
Como
entregar a atividade:
Você deve entregar um arquivo no formato texto ou PDF, no Template da
atividade, contendo:
-
Código Java do programa com os comentários JavaDOC, conforme solicitado na
questão 2.
-
A captura de tela, para a documentação gerada, na execução do arquivo
index.html, contemplando toda a documentação gerada.
IMPORTANTE:
1. Acesse o link com um vídeo tutorial para ajudá-lo(a) nesse processo de
criação e desenvolvimento. O acesso deverá ser realizado através do fórum
interativo - "Links das Aulas ao Vivo".
2. Disserte a respeito do tema, seguindo, como roteiro, os tópicos elencados.
3. A entrega deve ser feita exclusivamente usando o Template de
entrega da atividade Atividade 3 disponível no material da disciplina.
4. Antes de enviar a sua atividade, certifique-se de que respondeu a todas as
perguntas e realize uma cuidadosa correção ortográfica.
5. Após o envio, não são permitidas alterações ou modificações. Logo, você
tem apenas uma chance de enviar o arquivo corretamente. Revise bem antes de
enviar!
6. Lembre-se de que evidências de cópias de materiais, incluindo de outros
acadêmicos, sem as devidas referências, serão inquestionavelmente zeradas. As
citações e as referências, mesmo que do livro da disciplina, devem ser
realizadas de acordo com as normas da Instituição de Ensino.
7. Não são permitidas correções parciais no decorrer do módulo, ou seja, o
famoso: “professor, veja se minha atividade está certa?”. Isso invalida o seu
processo avaliativo. Lembre-se de que a interpretação da atividade também faz
parte da avaliação.
8. Procure sanar as suas dúvidas junto à mediação em tempo hábil sobre o
conteúdo exigido na atividade, de modo que consiga realizar a sua participação.
9. Atenção ao prazo de entrega. Evite o envio da atividade muito próximo do
prazo. Você pode ter algum problema com a internet, o computador, o software
etc. Os prazos não serão flexibilizados, mesmo em caso de comprovação.
Bons estudos!
Em caso de dúvidas, encaminhe mensagem por meio do Fale com o Mediador.
Precisando de assessoria nos seus TRABALHOS entre em contato com a 2M ASSESSORIA
E-mail: assessoria.academica2m@gmail.com
Facebook: fb.me/ajudaemTrabalhosdeprogramacao
Whats: (15) 98115-0680
Canal do Youtube: youtube/2mAssessoria
0 comentários:
Postar um comentário