Field Management System

A Java Enterprise Edition (Jakarta EE) web application developed as part of a university semester assessment. The application provides an administrative interface for managing and querying field agent records stored in a relational database using Enterprise Java technologies.

The project demonstrates enterprise web application development using Servlets, JSP, Enterprise JavaBeans (EJB), Java Persistence API (JPA), and GlassFish Server.

---

Features

• Register new field agents
• Display all registered agents
• Search agents by gender
• Display married agents
• Find the oldest registered agent
• Search agents within a specified age range
• Input validation and exception handling
• Database persistence using JPA

---

Project Structure

TextSpectaclesAdminWebApp/
├── src/
│   ├── java/
│   │   ├── entity/             # JPA entities
│   │   ├── bl/                 # Enterprise JavaBeans (Business Logic)
│   │   └── web/                # Servlets
│   ├── conf/
│   │   └── persistence.xml
├── web/
│   ├── WEB-INF/
│   ├── *.jsp                   # JSP pages
│   ├── *.html                  # HTML pages
│   └── glassfish-web.xml
├── build.xml
└── README.md

---

Technologies Used

Technology	Purpose
Java	Core programming language
Jakarta EE / Java EE	Enterprise application framework
Servlets	Request handling and controller layer
JSP	Dynamic web pages
Enterprise JavaBeans (EJB)	Business logic layer
Java Persistence API (JPA)	Database persistence
GlassFish Server	Application server
Apache Derby / Java DB	Relational database
HTML & CSS	User interface

---

Application Architecture

The application follows a layered enterprise architecture consisting of:

• Presentation Layer (HTML & JSP)
• Controller Layer (Servlets)
• Business Logic Layer (EJB)
• Persistence Layer (JPA)
• Relational Database

---

Functional Modules

• Add Field Agent
• View All Agents
• Display Married Agents
• Search by Gender
• Find Oldest Agent
• Display Agents Within an Age Range

---

Getting Started

Prerequisites

• JDK 17 or later
• NetBeans IDE
• GlassFish Server
• Apache Derby (Java DB)

Clone the Repository

git clone https://github.com/yourusername/TextSpectaclesAdminWebApp.git

Run the Application

1. Open the project in NetBeans.
2. Configure the GlassFish Server.
3. Ensure the Derby database is running.
4. Build and deploy the project.
5. Access the application through your browser.

---

Learning Outcomes

This project demonstrates practical experience with:

• Enterprise Java development
• MVC architecture
• Java Servlets and JSP
• Enterprise JavaBeans (EJB)
• Java Persistence API (JPA)
• Database integration
• Exception handling
• Layered software architecture

---

Author

Phemelo Kojane

GitHub: https://github.com/kojanephemelo