CSC/ECE 517 Fall 2023 - E2372. Reimplement QuizQuestion and its child classes

Objectives

There are four methods in QuizQuestion super class. edit, view_question_text, view_completed_question, and complete. These 4 (model) methods will return different html strings depends on the question type.

• edit: What to display` - if an instructor (etc.) is creating or editing a questionnaire (questionnaires_controller.rb)
• view_question_text: What to display if an instructor (etc.) is viewing a questionnaire (questionnaires_controller.rb)
• complete: What to display - if a student is filling out a questionnaire (response_controller.rb)
• view_completed_question: What to display if a student is viewing a filled-out questionnaire (response_controller.rb)

Our goals are

1. Make a complete UML diagram for these classes with their attributes, methods, and class methods.
2. Check all implementations of instance methods, extract duplicated codes, and put them into the highest-level class.
3. Thoroughly test the QuizQuestion class

Overview of the Classes

quiz_question.rb

QuizQuestion is a base class used to represent a question in a quiz. It inherits from the Question class. This class is associated with QuizQuestionChoice objects through a has_many relationship, indicating that a QuizQuestion can have multiple choices. It handles the creation of HTML for different views related to a question, such as editing, completing, and viewing the question text.

Methods:

• edit: to generate the HTML form for editing a question,
• complete: used for completing the question in the quiz
• view_question_text: to display the question and its choices)
• view_completed_question: abstract method used after quiz has been submitted, and
• isvalid: to validate the question, especially ensuring it has text

multiple_choice_radio.rb

This class extends QuizQuestion and represents a multiple-choice question where the participant can select only one answer from a set of radio buttons.

Methods:

• edit: overridden to add HTML for a set of radio buttons that allows the user to select one choice as the correct answer; also includes text inputs for the choices' text
• complete method: renders HTML for the user to complete this type of question in a quiz interface
• view_completed_question: displays the correct answer, the user's answer, and visual feedback on whether the user's answer was correct
• isvalid: extended to ensure that not only does each choice have text, but also that exactly one correct answer is selected

multiple_choice_checkbox.rb

The MultipleChoiceCheckbox class is a subclass of QuizQuestion and represents a multiple-choice question where the participant can select multiple answers through checkboxes.

Methods:

• edit: add HTML input elements for checkboxes, allowing multiple correct answers to be selected, along with text inputs for entering the choices.
• complete: allows users to complete the question, displaying checkboxes for them to select their answers
• view_completed_question: shows correct answers and whether the user's selections were correct
• isvalid: validates the question, ensures there are multiple correct answers if it's a checkbox question.

true_false.rb

This class also extends QuizQuestion and is specialized for true/false questions.

Methods:

• edit: includes HTML radio buttons specifically for 'True' and 'False' options
• complete: render the true/false question for the user to answer
• view_completed_question: displays the correct answer and the user's answer
• isvalid: checks to ensure that the question has text and that a correct answer is designated

Our Solution

• We implemented isvalid() to QuizQuestion

def isvalid(choice_info)
  @valid = 'valid'
  @valid = 'Please make sure all questions have text' if txt == ''
  @valid
end

• We factored out duplicate code in edit() from the subclasses and placed it into the superclass QuizQuestion. Now edit in the subclasses inherit partially from QuizQuestion.
• We reimplemented QuizQuestion class and child classes methods to use @html (an instance variable) instead of html.

UML Diagram

Relevant Links

Github repository: https://github.com/opheliasin/expertiza

Pull request: https://github.com/expertiza/expertiza/pull/2682

Team

Mentor

Aditi Vakeel

Members

Nathan Sudduth (ncsuddut@ncsu.edu)

Ophelia Sin (oysin@ncsu.edu)

Yi Chen (ychen282@ncsu.edu)