Як розробити просту програму Java

Як розробити просту програму Java
Остання редакція: червень 2001 р
(Мак-Кенн)
Здається, студенти завжди мають проблеми з розумінням (або, можливо, просто виконанням) того, що я від них очікую, коли я призначаю програму. Вимоги дійсно дуже прямі; в основному це питання залишити собі достатньо часу, щоб все зробити.

програму

Щоб допомогти вам зрозуміти, що від вас очікується, у цьому документі я візьму простий зразок завдання програмування та проведу вас через основні етапи процесу розробки програми.

(Якщо ви шукаєте детальну інформацію про програмну документацію, ви знайдете дещо тут, але вам дійсно слід відвідати мою сторінку стилю програмування, де є моя колекція стильових документів, включаючи кілька сторінок стилів від інших людей. Програмістів. Цей документ призначений для студентів, які тільки починають вивчати Java.)


Крок No1: Почніть рано
Програмування - це не та діяльність, яку можна надійно запланувати на заздалегідь визначену кількість часу. Навіть програми, схожі на те, що вони мають бути виконані за 2 години, часто вимагають 4–5 годин. Найкраще, що ви можете зробити для себе, це сказати: "Я не уявляю, скільки часу це займе; мені краще почати негайно".

Крок 2: Уважно прочитайте роздатковий матеріал
Мої роздаткові завдання з програмування, як правило, дуже детальні, якщо не ідеально організовані. Все, чого я чекаю від вас, там десь подано, тож уважно прочитайте і виділіть ключові моменти, щоб не пропустити жодного з них.

Наприклад, розглянемо цей приклад призначення:

CS 001 - Інформатика I

Програма №1: Калорії через жир

Дата закінчення: Смерть 36-го, 2028, на початку заняття

Огляд: Будь-який дієтолог скаже вам, що обмеження щоденного споживання жиру до 30% від загальної кількості калорій - це гарна ідея. Але скільки калорій у вашій улюбленій їжі складається з жиру? Харчові ярлики повідомлять вам, скільки грамів жиру в порції, і скільки загальної кількості калорій у цій порції, але решту питань потрібно робити самостійно.

Як це трапляється, грам жиру має близько 9 калорій. Тому, якщо взяти грами жиру в порції певної їжі, помножити його на 9 і розділити на загальну кількість калорій у порції, ви отримаєте частку калорій за рахунок жиру. Щоб отримати результат у відсотках, просто помножте на 100.

Наприклад, розглянемо продукт, який містить 3 грами жиру і 170 калорій на порцію. Є 27 калорій завдяки жиру (3 * 9), і 27/170 = 0,1588. Помноження на 100 дає остаточну відповідь: 15,88 відсотка калорій припадає на жир.

Завдання: Напишіть повну, добре задокументовану програму Java, яка починається з прохання користувача ввести грами жиру та калорії в порцію харчового продукту. Програма обчислить відсоток калорій у їжі, що спричинені жиром, і відобразить вхідну інформацію та відсоток у вигляді повного англійського речення.

Дані: Запустіть програму двічі, один раз для кожного набору даних, показаних у наступній таблиці:

Загальна калорійність

Здайте: У встановлений термін здайте такі пункти: роздруківку документованої програми Java та роздруківку результатів, які ваша програма видала під час запуску на кожному з наборів даних, наведених вище. Обов’язково напишіть своє ім’я у верхньому правому куті роздруківки; це полегшить вам повернення вашої програми, коли я поверну її вам.

Крок 3: Напишіть зовнішню документацію
Я вже чую посмішку ("Напишіть коментарі зараз! Станьте серйозним!"), Але я серйозно: вам слід писати свою документацію під час написання програми, а не пізніше. Зокрема, зовнішня документація повинна бути майже повною, перш ніж ви напишете навіть рядок коду.

Я роздаю однокласний документ (у форматі PDF) своїм класам програмування, де перелічується інформація, яку я очікую побачити у ваших програмах. Зокрема, ось що має містити Зовнішня документація: