1.3 Zoo Learning Activity

Overview

Methods and Object Collaboration

In this activity, you will continue from Zoo 1.2 and add the fields, methods, controls, and event handlers that make the zoo objects work together.

User Story: Put the Zoo Objects to Work

The zoo manager wants both zoo records to support a current visitor and four daily actions: opening the zoo, feeding the featured animal, preparing the birthing room, and filling the animal snack machine.

Acceptance Criteria

Add complete Guest and Wallet classes.
Add the exact Zoo 1.3 fields and methods to the existing business classes.
Create Julia and Dakota with the checkpoint’s exact wallet balances.
Add eight action buttons and eight matching event handlers.
Run the application and verify the exact object-state changes.

Exact Names and Values Matter

Use the class names, method names, event-handler names, messages, and numeric values exactly as shown. Small differences can prevent XAML from connecting to the code-behind or can produce the wrong checkpoint state.

Before You Begin

Existing-file examples show only the additions. New-file examples show the complete file. Each code display restarts its section-relative numbering at 01; those display numbers are not editor line numbers.

Prepare Your Zoo 1.2 Checkpoint
The Goal
Continue from your completed Zoo 1.2 End project so this activity adds only the 1.3 changes.
1. Make a working copy of your completed Zoo 1.2 End folder.
2. Rename the copied folder and solution for checkpoint 1.3 according to your instructor’s naming directions.
3. Open the solution in Visual Studio and build it before making changes.
4. Confirm that the existing New Como Zoo and New San Diego Zoo buttons still run.
Go to top

Create the Guest Class

The Goal

Add a new business class that represents the visitor currently entering a zoo.

Your Task

In the ZooScenario/Business Classes folder, add Guest.cs. This is a new file, so enter the complete file shown.

ZooScenario/Business Classes/Guest.cs

01 using System;
02 using System.Collections.Generic;
03 using System.Text;
04 
05 namespace ZooScenario
06 {
07     /// <summary>
08     /// The class which is used to represent a guest.
09     /// </summary>
10     [System.Diagnostics.CodeAnalysis.SuppressMessage("Microsoft.StyleCop.CSharp.MaintainabilityRules", "SA1401:FieldsMustBePrivate", Justification = "Encapsulation not yet taught.")]
11     public class Guest
12     {
13         /// <summary>
14         /// The age of the guest.
15         /// </summary>
16         public int Age;
17 
18         /// <summary>
19         /// The name of the guest.
20         /// </summary>
21         public string Name;
22 
23         /// <summary>
24         /// The guest's wallet.
25         /// </summary>
26         public Wallet Wallet;
27 
28         /// <summary>
29         /// Buys a ticket.
30         /// </summary>
31         public void BuyTicket()
32         {
33             this.Wallet.RemoveTicketPrice();
34         }
35 
36         /// <summary>
37         /// Visits the zoo.
38         /// </summary>
39         public void VisitZoo()
40         {
41             this.BuyTicket();
42         }
43     }
44 }

Create Guest.cs in the Business Classes folder.
Enter the complete class exactly as shown, including the public fields and both methods.
Build the solution and correct any naming or brace errors.

Go to top

Create the Wallet Class

The Goal

Give each guest a separate object that stores the guest’s available money.

Your Task

Add Wallet.cs to the same business-class folder. Enter the complete new file.

ZooScenario/Business Classes/Wallet.cs

01 using System;
02 using System.Collections.Generic;
03 using System.Text;
04 
05 namespace ZooScenario
06 {
07     /// <summary>
08     /// The class which is used to represent a wallet.
09     /// </summary>
10     [System.Diagnostics.CodeAnalysis.SuppressMessage("Microsoft.StyleCop.CSharp.MaintainabilityRules", "SA1401:FieldsMustBePrivate", Justification = "Encapsulation not yet taught.")]
11     public class Wallet
12     {
13         /// <summary>
14         /// The amount of money currently contained within the wallet.
15         /// </summary>
16         public decimal MoneyBalance;
17 
18         /// <summary>
19         /// Adds money to the wallet.
20         /// </summary>
21         public void AddMoney()
22         {
23             this.MoneyBalance = this.MoneyBalance + 5.00m;
24         }
25 
26         /// <summary>
27         /// Removes the ticket price from the wallet.
28         /// </summary>
29         public void RemoveTicketPrice()
30         {
31             this.MoneyBalance = this.MoneyBalance - 15.00m;
32         }
33     }
34 }

Money Values

The m suffix makes values such as 5.00m decimal values. Keep the exact amounts shown in the checkpoint.

Create Wallet.cs in the Business Classes folder.
Enter the MoneyBalance field and both methods exactly as shown.
Build the solution before continuing.

Go to top

Add Core Business-Class Behavior

The Goal

Add behavior to the existing animal, room, booth, and employee classes.

Your Task

Place each snippet inside the named class, after the existing fields and before the class closing brace. The snippets show only the additions.

ZooScenario/Business Classes/Animal.cs

01 /// <summary>
02          /// Feeds the animal.
03          /// </summary>
04          public void Eat()
05          {
06              this.Weight = this.Weight + 0.5;
07              this.HappinessLevel = this.HappinessLevel + 2;
08          }
09  
10          /// <summary>
11          /// Makes the animal move.
12          /// </summary>
13          public void Move()
14          {
15              this.HappinessLevel = this.HappinessLevel + 1;
16          }
17  
18          /// <summary>
19          /// Makes the animal wake up and move.
20          /// </summary>
21          public void WakeUp()
22          {
23              this.Move();
24          }

ZooScenario/Business Classes/BirthingRoom.cs

01 /// <summary>
02          /// Warms the birthing room.
03          /// </summary>
04          public void WarmRoom()
05          {
06              this.Temperature = this.Temperature + 0.5;
07          }
08  
09          /// <summary>
10          /// Helps the mother animal rest.
11          /// </summary>
12          public void WakeMotherUp()
13          {
14              this.Mother.WakeUp();
15              this.WarmRoom();
16          }

ZooScenario/Business Classes/Booth.cs

01 /// The amount of money in the booth.
02          /// </summary>
03          public decimal MoneyBalance;
04  
05          /// <summary>
06  
07          /// <summary>
08          /// Sells a ticket from the booth.
09          /// </summary>
10          public void SellTicket()
11          {
12              this.MoneyBalance = this.MoneyBalance + this.TicketPrice;
13              this.Attendant.SellTicket();
14          }

ZooScenario/Business Classes/Employee.cs

01 /// The number of tickets the employee has sold.
02          /// </summary>
03          public int TicketsSold;
04  
05          /// <summary>
06  
07          /// <summary>
08          /// Sells a ticket.
09          /// </summary>
10          public void SellTicket()
11          {
12              this.TicketsSold = this.TicketsSold + 1;
13          }
14  
15          /// <summary>
16          /// Feeds the animal assigned to this employee.
17          /// </summary>
18          public void FeedAnimal()
19          {
20          }

Add Eat, Move, and WakeUp to Animal.
Add WarmRoom and WakeMotherUp to BirthingRoom.
Add MoneyBalance and SellTicket to Booth.
Add TicketsSold, SellTicket, and FeedAnimal to Employee.
Build the solution.

Go to top

Add Vending Machine and Zoo Behavior

The Goal

Finish the checkpoint’s method chain so the zoo can coordinate visitor, animal, room, and vending-machine work.

Your Task

Add the following members inside their existing classes. Keep the exact method calls and values.

ZooScenario/Business Classes/VendingMachine.cs

01 /// <summary>
02          /// Adds a bag of food to the vending machine.
03          /// </summary>
04          public void AddFoodBag()
05          {
06              this.FoodStock = this.FoodStock + 65.0;
07          }
08  
09          /// <summary>
10          /// Fills the vending machine.
11          /// </summary>
12          public void FillVendingMachine()
13          {
14              this.AddFoodBag();
15              this.AddFoodBag();
16          }
17  
18          /// <summary>
19          /// Adds money to the vending machine.
20          /// </summary>
21          public void AddMoney()
22          {
23              this.MoneyBalance = this.MoneyBalance + 5.00m;
24          }

ZooScenario/Business Classes/Zoo.cs

01 /// <summary>
02          /// The zoo's current visitor.
03          /// </summary>
04          public Guest Visitor;
05  
06          /// <summary>
07          /// Opens the zoo for a visitor.
08          /// </summary>
09          public void OpenForVisitor()
10          {
11              this.SellTicket();
12              this.FeaturedAnimal.WakeUp();
13          }
14  
15          /// <summary>
16          /// Sells a ticket to the visitor.
17          /// </summary>
18          public void SellTicket()
19          {
20              this.Visitor.BuyTicket();
21              this.TicketBooth.SellTicket();
22          }
23  
24          /// <summary>
25          /// Feeds the featured animal.
26          /// </summary>
27          public void FeedFeaturedAnimal()
28          {
29              this.FeaturedAnimal.Eat();
30              this.AnimalSnackMachine.AddMoney();
31          }
32  
33          /// <summary>
34          /// Prepares the birthing room.
35          /// </summary>
36          public void PrepareBirthingRoom()
37          {
38              this.BirthArea.WakeMotherUp();
39          }
40  
41          /// <summary>
42          /// Fills the animal snack machine.
43          /// </summary>
44          public void FillAnimalSnackMachine()
45          {
46              this.AnimalSnackMachine.FillVendingMachine();
47          }

Add all three methods to VendingMachine.
Add the Visitor field and all five methods to Zoo.
Build the solution and verify that no method name is misspelled.

Go to top

Create and Initialize the Visitors
The Goal
Connect one visitor and wallet to each zoo and initialize the new money values.
Your Task
In ZooScenario/MainWindow.xaml.cs, add these statements inside the matching newComoZooButton_Click and newSanDiegoZooButton_Click event handlers. Place object creation before field assignments.
Reading the Diagram

Markers identify only the object-state changes made during this task. Use Options to switch between color and lettered markers.
- New: added in this task.
- Changed: updated in this task.
Current object state after this task.
ZooScenario/MainWindow.xaml.cs
```
01 this.ComoZoo.Visitor = new Guest();
02 this.ComoZoo.Visitor.Wallet = new Wallet();
03 
04 this.ComoZoo.Visitor.Age = 12;
05 this.ComoZoo.Visitor.Name = "Julia";
06 this.ComoZoo.Visitor.Wallet.MoneyBalance = 25.00m;
07 
08 this.ComoZoo.TicketBooth.MoneyBalance = 0.00m;
09 
10 this.SanDiegoZoo.Visitor = new Guest();
11 this.SanDiegoZoo.Visitor.Wallet = new Wallet();
12 
13 this.SanDiegoZoo.Visitor.Age = 10;
14 this.SanDiegoZoo.Visitor.Name = "Dakota";
15 this.SanDiegoZoo.Visitor.Wallet.MoneyBalance = 35.00m;
16 
17 this.SanDiegoZoo.TicketBooth.MoneyBalance = 0.00m;
```
1. Inside newComoZooButton_Click, create Julia and her wallet before assigning their values.
2. Set Julia’s age to 12, name to "Julia", and wallet balance to 25.00m.
3. Set the Como Zoo booth balance to 0.00m.
4. Inside newSanDiegoZooButton_Click, create Dakota and the wallet before assigning their values.
5. Set Dakota’s age to 10, name to "Dakota", and wallet balance to 35.00m.
6. Set the San Diego Zoo booth balance to 0.00m.
7. Build and run the project; click both New Zoo buttons once.
Go to top

Add the Zoo Action Buttons

The Goal

Add four action buttons for each zoo while preserving the two existing New Zoo buttons.

Your Task

In ZooScenario/MainWindow.xaml, add the Como buttons inside the Como button panel and the San Diego buttons inside the San Diego button panel. The snippet contains only the eight new buttons.

ZooScenario/MainWindow.xaml

01 <Button x:Name="openComoZooButton" Content="Open Como Zoo" Click="openComoZooButton_Click"/>
02              <Button x:Name="feedComoAnimalButton" Content="Feed Como Animal" Click="feedComoAnimalButton_Click"/>
03              <Button x:Name="prepareComoBirthingRoomButton" Content="Prepare Como Birthing Room" Click="prepareComoBirthingRoomButton_Click"/>
04              <Button x:Name="fillComoVendingMachineButton" Content="Fill Como Vending Machine" Click="fillComoVendingMachineButton_Click"/>
05              <Button x:Name="openSanDiegoZooButton" Content="Open San Diego Zoo" Click="openSanDiegoZooButton_Click"/>
06              <Button x:Name="feedSanDiegoAnimalButton" Content="Feed San Diego Animal" Click="feedSanDiegoAnimalButton_Click"/>
07              <Button x:Name="prepareSanDiegoBirthingRoomButton" Content="Prepare San Diego Birthing Room" Click="prepareSanDiegoBirthingRoomButton_Click"/>
08              <Button x:Name="fillSanDiegoVendingMachineButton" Content="Fill San Diego Vending Machine" Click="fillSanDiegoVendingMachineButton_Click"/>

Placeholder for the Zoo 1.3 application controls — Replace this placeholder with a light and dark screenshot of the running Zoo 1.3 application showing all action buttons.

Add all four Como Zoo action buttons in the Como button panel.
Add all four San Diego Zoo action buttons in the San Diego button panel.
Build the solution and confirm every XAML event-handler name is currently reported only if its handler has not yet been added.

Go to top

Add the Eight Event Handlers

The Goal

Connect each new button to the matching Zoo method and display the checkpoint’s exact status message.

Your Task

In ZooScenario/MainWindow.xaml.cs, add these methods inside the MainWindow class, after the existing New Zoo handlers and before the class closing brace.

ZooScenario/MainWindow.xaml.cs

01         /// <summary>
02         /// Opens the Como Zoo for a visitor.
03         /// </summary>
04         /// <param name="sender">The object that initiated the event.</param>
05         /// <param name="e">The event arguments for the event.</param>
06         private void openComoZooButton_Click(object sender, RoutedEventArgs e)
07         {
08             this.ComoZoo.OpenForVisitor();
09             this.informationTextBox.Text = "The Como Zoo is open for " + this.ComoZoo.Visitor.Name + ".";
10         }
11 
12         /// <summary>
13         /// Feeds the Como Zoo's featured animal.
14         /// </summary>
15         /// <param name="sender">The object that initiated the event.</param>
16         /// <param name="e">The event arguments for the event.</param>
17         private void feedComoAnimalButton_Click(object sender, RoutedEventArgs e)
18         {
19             this.ComoZoo.FeedFeaturedAnimal();
20             this.informationTextBox.Text = this.ComoZoo.FeaturedAnimal.Name + " has been fed.";
21         }
22 
23         /// <summary>
24         /// Prepares the Como Zoo's birthing room.
25         /// </summary>
26         /// <param name="sender">The object that initiated the event.</param>
27         /// <param name="e">The event arguments for the event.</param>
28         private void prepareComoBirthingRoomButton_Click(object sender, RoutedEventArgs e)
29         {
30             this.ComoZoo.PrepareBirthingRoom();
31             this.informationTextBox.Text = "The Como Zoo birthing room is ready.";
32         }
33 
34         /// <summary>
35         /// Fills the Como Zoo's animal snack machine.
36         /// </summary>
37         /// <param name="sender">The object that initiated the event.</param>
38         /// <param name="e">The event arguments for the event.</param>
39         private void fillComoVendingMachineButton_Click(object sender, RoutedEventArgs e)
40         {
41             this.ComoZoo.FillAnimalSnackMachine();
42             this.informationTextBox.Text = "The Como Zoo animal snack machine has been filled.";
43         }
44 
45         /// <summary>
46         /// Opens the San Diego Zoo for a visitor.
47         /// </summary>
48         /// <param name="sender">The object that initiated the event.</param>
49         /// <param name="e">The event arguments for the event.</param>
50         private void openSanDiegoZooButton_Click(object sender, RoutedEventArgs e)
51         {
52             this.SanDiegoZoo.OpenForVisitor();
53             this.informationTextBox.Text = "The San Diego Zoo is open for " + this.SanDiegoZoo.Visitor.Name + ".";
54         }
55 
56         /// <summary>
57         /// Feeds the San Diego Zoo's featured animal.
58         /// </summary>
59         /// <param name="sender">The object that initiated the event.</param>
60         /// <param name="e">The event arguments for the event.</param>
61         private void feedSanDiegoAnimalButton_Click(object sender, RoutedEventArgs e)
62         {
63             this.SanDiegoZoo.FeedFeaturedAnimal();
64             this.informationTextBox.Text = this.SanDiegoZoo.FeaturedAnimal.Name + " has been fed.";
65         }
66 
67         /// <summary>
68         /// Prepares the San Diego Zoo's birthing room.
69         /// </summary>
70         /// <param name="sender">The object that initiated the event.</param>
71         /// <param name="e">The event arguments for the event.</param>
72         private void prepareSanDiegoBirthingRoomButton_Click(object sender, RoutedEventArgs e)
73         {
74             this.SanDiegoZoo.PrepareBirthingRoom();
75             this.informationTextBox.Text = "The San Diego Zoo birthing room is ready.";
76         }
77 
78         /// <summary>
79         /// Fills the San Diego Zoo's animal snack machine.
80         /// </summary>
81         /// <param name="sender">The object that initiated the event.</param>
82         /// <param name="e">The event arguments for the event.</param>
83         private void fillSanDiegoVendingMachineButton_Click(object sender, RoutedEventArgs e)
84         {
85             this.SanDiegoZoo.FillAnimalSnackMachine();
86             this.informationTextBox.Text = "The San Diego Zoo animal snack machine has been filled.";
87         }

Add all four Como Zoo event handlers.
Add all four San Diego Zoo event handlers.
Confirm that each handler name exactly matches its XAML Click value.
Build the solution with no errors.

Go to top

Run and Verify the New Behavior
The Goal
Use the Como Zoo controls in order and inspect the exact state changes produced by the method calls.
Reading the Diagram

Markers identify only the object-state changes made during this task. Use Options to switch between color and lettered markers.
- New: added in this task.
- Changed: updated in this task.
Current object state after this task.
Replace this placeholder with a debugger screenshot showing Julia wallet 10.00, booth balance 15.00, TicketsSold 1, and Dolly HappinessLevel 1.
Current object state after this task.
1. Run the application and click New Como Zoo once.
2. Set a breakpoint on this.ComoZoo.OpenForVisitor(); inside openComoZooButton_Click.
3. Click Open Como Zoo, continue to the breakpoint, and step over the method call.
4. Verify Julia’s wallet is 10.00m, the booth balance is 15.00m, Sam’s TicketsSold is 1, and Dolly’s HappinessLevel is 1.
5. Click Feed Como Animal and verify Dolly’s weight is 35.8, happiness is 3, and the vending-machine balance is 47.75m.
6. Click Prepare Como Birthing Room and verify the temperature is 77.5 and Dolly’s happiness is 4.
7. Click Fill Como Vending Machine and verify the food stock is 380.0.
8. Repeat the button checks for San Diego Zoo and confirm each information message names the correct zoo or animal.
Go to top
Finish and Submit
Verify Your Work
Replace this placeholder with the completed Zoo 1.3 application running after the new controls have been tested.
1. Build the solution with no errors.
2. Run every new button for both zoos.
3. Confirm that all expected messages appear in the information text box.
4. Stop debugging and save all files.
5. Submit the completed project according to your instructor’s directions.
Submit Your Work
Stop debugging, save your work, and submit according to your instructor’s directions.
Feedback System
Go to top

Checkpoint Summary

Your Zoo 1.3 project now includes guests and wallets, coordinated business methods, new user-interface controls, and event handlers that update and display object state.

Julia begins with 25.00m; Dakota begins with 35.00m.
Opening a zoo sells one ticket and wakes the featured animal.
Feeding, preparing the birthing room, and filling the vending machine update the exact checkpoint values.

Go to top

1.3 Zoo Learning Activity

Overview

Methods and Object Collaboration

User Story: Put the Zoo Objects to Work

Acceptance Criteria

Task List

Prepare Your Zoo 1.2 Checkpoint

The Goal

Create the Guest Class

The Goal

Your Task

Create the Wallet Class

The Goal

Your Task

Add Core Business-Class Behavior

The Goal

Your Task

Add Vending Machine and Zoo Behavior

The Goal

Your Task

Create and Initialize the Visitors

The Goal

Your Task

Add the Zoo Action Buttons

The Goal

Your Task

Add the Eight Event Handlers

The Goal

Your Task

Run and Verify the New Behavior

The Goal

Finish and Submit

Verify Your Work

Submit Your Work

Checkpoint Summary