Share
Explore
Unitied Earth Space Defense Force
Lecture lab book for the Kotlin-based UESEC Fleet Combat Simulation, focusing on synthetic integration using Companion Object factory methods and the Singleton Design Pattern.
This lab emphasizes object-oriented design principles while aligning with the assignment requirements. It provides a structured walkthrough with explanations and complete code to guide students through building a space battle simulation.
Lecture Lab Book: United Earth Space Defense Command Fleet Operations Combat Simulation
Lab Title: Modeling Space Battles with Kotlin - Companion Objects and Singletons
In this lab, you’ll design and implement a Kotlin-based simulation of a space battle between Federation and Romulan fleets, as part of your assignment for the United Earth Space Defense Command Fleet Operations Combat Simulation.
The primary focus is to demonstrate synthetic integration—the seamless collaboration of multiple classes through method calls and shared field composition—while leveraging Kotlin’s Companion Object factory methods and the Singleton Design Pattern.
By the end of this lab, you’ll have a working combat simulation that:
This lab aligns with the UESEC simulation assignment and emphasizes object-oriented principles such as encapsulation, polymorphism, and modular design.
Learning Objectives
Understand and implement Companion Objects as factory methods to instantiate objects with controlled creation logic.
Apply the Singleton Design Pattern to manage a single, globally accessible combat simulation instance.
Demonstrate synthetic integration by connecting multiple classes (e.g., Starship, Fleet, CombatManager) through method calls and shared fields.
Simulate a space battle with randomized attack selections, energy management, and fleet status updates.
Reinforce Kotlin concepts: classes, mutable lists, randomization, and control structures.
Lab Prerequisites
Lab Structure
Conceptual Overview: Introduction to Companion Objects and Singletons.
Class Design: Define the core classes with UML-inspired relationships.
Implementation: Step-by-step coding with explanations.
Execution: Run and test the simulation.
Reflection: Analyze the design and suggest improvements.
1. Conceptual Overview
Companion Objects as Factory Methods
In Kotlin, a companion object is a static-like construct within a class that can hold methods and properties tied to the class itself, not its instances.
We’ll use it as a factory method to:
Singleton Design Pattern
The Singleton pattern ensures a class has only one instance, providing a global point of access. Here, we’ll use it for the CombatManager to:
Synthetic Integration
This lab integrates several classes:
These classes will collaborate through method calls and shared field updates, showcasing a cohesive, purpose-driven design.
2. Class Design
UML-Inspired Relationships
3. Implementation
Step 1: Define the Starship Class with Companion Object
kotlin.random.Random
(
name: String,
,
,
Int
) {
Factory {
// Factory method to create Federation ships
): Starship {
)
}
// Factory method to create Romulan ships with different energy profiles
): Starship {
)
}
}
) {
) {
)
)
10
{
)
}
}
) {
) {
)
)
20
{
)
}
}
) {
shields -= damage
)
)
}
0
"
}
Explanation:
Step 2: Define the Fleet Class
name: String) {
ships = mutableListOf<Starship>()
) {
ships.add(ship)
}
) {
ships.remove(ship)
}
(): Starship? {
null
}
() = ships.isEmpty()
() {
)
) }
}
() {
ships.removeIf { it.isDestroyed() }
}
}
Explanation:
Step 3: Define the CombatManager Singleton
CombatManager {
federationFleet: Fleet
romulanFleet: Fleet
0
() {
)
)
// Populate Federation fleet using factory methods
))
))
))
// Populate Romulan fleet
))
))
))
)
)
reportStatus()
}
() {
round++
)
// Federation attacks Romulan
fedShip = federationFleet.getRandomShip()
romShip = romulanFleet.getRandomShip()
) {
attackType = Random.nextBoolean()
fedShip.fireTorpedo(romShip)
}
// Romulan attacks Federation
romAttacker = romulanFleet.getRandomShip()
fedTarget = federationFleet.getRandomShip()
) {
attackType = Random.nextBoolean()
romAttacker.fireTorpedo(fedTarget)
}
Want to print your doc?
This is not the way.
This is not the way.
Try clicking the ⋯ next to your doc name or using a keyboard shortcut (
CtrlP
) instead.