Question

All files require Javadoc documentation comments at the top to include a description of the program and an @author tag with your name  only.   
--------------------------------------

Develop an exception class named InvalidMonthException that extends the Exception class.   Instances of the class will be thrown based on the following conditions:

The value for a month number is not between 1 and 12

The value for a month name is not January, February, March, … December

--------------------------------------

Develop a class named Month.  The class should define an integer field named monthNumber that holds the number of a month.  For example, January would be 1, February would be 2, and so forth.  In addition, provide the following methods:

A no-argument constructor that sets the monthNumberto 1.

An overloaded constructor that accepts the number of the month as an argument.  The constructor should set the monthNumberfield to the parameter value if the parameter contains the value 1 – 12.  Otherwise, throw an InvalidMonthException exception back to the caller.  The exception should note that the month number was incorrect.

An overloaded constructor that accepts a string containing the name of the month, such as “January” and sets the monthNumberbased on the parameter string.  When the parameter value does not match a valid name of a month, the constructor throws an  InvalidMonthException exception back to the caller.  The exception should note an invalid month name was used.

Accessor and mutator methods for the monthNumber The mutator method must validate the monthNumber parameter and throw an InvalidMonthException exception back to the caller when an invalid value is given.

A getMonthNamemethod that returns the name of the month based upon the monthNumber

A toStringmethod that returns the same value as the getMonthName

An equalsmethod that accepts a Month object as a parameter and compares the object to the calling object to determine if the objects contain the same value for the monthNumber

--------------------------------------

Develop a test client to thoroughly test the Month class and handle the exceptions thrown. 

Answer 1

Hey There!! Please edit the statement : @author PleaseWriteYourNameHere in all the below mentioned files and write you own name in place of PleaseWriteYourNameHere .

Also, Please comment if you have doubts or need modification.

InvalidMonthException class:

/*
* InvalidMonthException class is an user defined class that hadles invalid month paased
*/

/**
*
* @author PleaseWriteYourNameHere
*/
public class InvalidMonthException extends Exception{
    String error;
    //constructor
    InvalidMonthException(String error){
        this.error=error;
    }
  
    public String toString(){
        return error;
    }
}

Month class:

/*
* Month class handles the month of a calendar and throw excpetion when an invalid mont is handled
*/

/**
*
* @author PleaseWriteYourNameHere
*/
public class Month {
    //integer field
    private int monthNumber ;
  
    //no-argument constructor
    public Month(){
        this.monthNumber=1;
    }
  
    //overloaded constructor that accepts the number of the month as an argument.
    public Month(int number)throws InvalidMonthException{
        //throws exception if monthNumber paased is not valid
        if (number<1 ||number>12) throw new InvalidMonthException("The value for a month number is not between 1 and 12");
        else
        this.monthNumber=number;
      
      
      
    }
  
    //An overloaded constructor that accepts a string containing the name of the month, such as “January” and sets the monthNumberbased on the parameter string.
     public Month(String monthName)throws InvalidMonthException{
        switch (monthName){
            case "January":
                    this.monthNumber=1;
                    break;
            case "February":
                    this.monthNumber=2;
                    break;
            case "March":
                    this.monthNumber=3;
                    break;
            case "April":
                    this.monthNumber=4;
                    break;
            case "May":
                    this.monthNumber=5;
                    break;
            case "June":
                    this.monthNumber=6;
                    break;
            case "July":
                    this.monthNumber=7;
                    break;
            case "August":
                    this.monthNumber=8;
                    break;
            case "September":
                    this.monthNumber=9;
                    break;
            case "October":
                    this.monthNumber=10;
                    break;
            case "November":
                    this.monthNumber=11;
                    break;
            case "Decemeber":
                    this.monthNumber=12;
                    break;
            //throw exception when an inappropriate month is paased i.e. if none of the above case is executed
            default:
                 throw new InvalidMonthException("The value for a month name is not January, February, March, … December");
               
        }
    }
    //accessor
    public int getMonthNumber() {
        return monthNumber;
    }
    //setter
    public void setMonthNumber(int monthNumber)throws InvalidMonthException {
        if (monthNumber<1 ||monthNumber>12) throw new InvalidMonthException("The value for a month number is not between 1 and 12");
        this.monthNumber=monthNumber;
    }
    //accessor
    public String getMonthName(){
        String name="";
  
        switch (monthNumber){
            case 1:
                    name="January";
                    break;
            case 2:
                    name="February";
                    break;
            case 3:
                    name="March";
                    break;
            case 4:
                    name="April";
                    break;
            case 5:
                    name="May";
                    break;
            case 6:
                    name="June";

                    break;
            case 7:
                    name="July";
                    break;
            case 8:
                    name="August";
                    break;
            case 9:
                    name="September";
                    break;
            case 10:
                    name="October";
                    break;
            case 11:
                    name="November";
                    break;
            case 12:
                    name="Decemeber";
                    break;
        }
        return name;
    }
  
    //compares the monthNumber of two objects
    public void equals(Month object){
        if (this.monthNumber==object.monthNumber){
            System.out.println("The object contains the same month number");
        }
        else
            System.out.println("The object does not contains the same month number");
    }
    @Override
    public String toString() {
        return getMonthName();
    }

   
  
  
  
}

MonthTest:

/*
* MonthTest class thoroughly test the execution of Month class and InvalidMonthException class
*/

/**
* @author PleaseWriteYourNameHere
*/
public class MonthTest {

    public static void main(String[] args) {
       //create constructor of Month class that will invoke the default constructor   
        Month obj=new Month();
        //display the month
        System.out.println(obj);
      
        try{
            Month obj1=new Month("January");
            System.out.println(obj1);
          
            //check whether the monthNumber for the two objects is same
            obj.equals(obj1);
          
            Month obj2=new Month(4);
            System.out.println(obj2);
            obj.equals(obj2);
          
          
            //This will throw exception , hence statements after it will not be executed
            Month obj3=new Month("Sep");
            System.out.println(obj3);
            obj.equals(obj3);
        }
        catch (InvalidMonthException ex){
            System.out.println(ex);
          
          
        }
        try{
            //This will throw exception , hence statements after it will not be executed
            Month obj4=new Month(15);
            System.out.println(obj4);
            obj.equals(obj4);
          
       }
      
        catch (InvalidMonthException ex){
            System.out.println(ex);
          
          
        }
      
          
          
        }
      

    }
  

Output: