https://github.com/charakamihiranga/javaee-pos
A Java EE-based Point of Sale (POS) system that effectively manages orders, customers, and inventory using servlets, JSON processing, and MySQL.
https://github.com/charakamihiranga/javaee-pos
javaee jndi pos-system sl4j-logback
Last synced: 9 months ago
JSON representation
A Java EE-based Point of Sale (POS) system that effectively manages orders, customers, and inventory using servlets, JSON processing, and MySQL.
- Host: GitHub
- URL: https://github.com/charakamihiranga/javaee-pos
- Owner: charakamihiranga
- License: mit
- Created: 2024-08-06T07:48:16.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2024-08-09T17:56:14.000Z (over 1 year ago)
- Last Synced: 2025-03-14T20:46:55.537Z (about 1 year ago)
- Topics: javaee, jndi, pos-system, sl4j-logback
- Language: Java
- Homepage:
- Size: 237 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Java EE POS System
## Overview
The Java EE POS System is a robust Point of Sale (POS) backend solution that manages orders, customers, and inventory. Built using Java EE technologies, it includes servlets, JSON processing, JNDI for database connectivity, and MySQL for data storage.
## Features
- **Order Management**: Create and retrieve orders.
- **Customer Management**: Add, view, update, and delete customer records.
- **Item Management**: Add, view, update, and delete items in the inventory.
## Technologies Used
- **Java EE**: Backend development with servlets and Java Beans.
- **Jakarta JSON Binding (JSON-B)**: JSON serialization and deserialization.
- **JNDI (Java Naming and Directory Interface)**: Database connection management.
- **MySQL**: Relational database for data storage.
- **SLF4J**: Logging.
## Getting Started
### Prerequisites
- Java Development Kit (JDK) 11 or higher
- Apache Tomcat (or any compatible servlet container)
- MySQL database and JDBC driver
### Installation
1. **Clone the Repository:**
```bash
git clone https://github.com/CharakaMihiranga/JavaEE-POS.git
cd javaee-pos-system
```
2. **Configure Database:**
- **MySQL Setup**: Ensure MySQL is installed and a database is created for the POS system.
- **JNDI Configuration**: Update the JNDI resource configuration in your servlet container (e.g., Tomcat) to include a DataSource resource for MySQL.
Example JNDI configuration for Tomcat:
```xml
```
3. **Build and Deploy:**
- If using Maven:
```bash
mvn clean install
```
- Deploy the generated WAR file to your servlet container (e.g., Tomcat).
4. **Start the Server:**
Start your servlet container and deploy the application.
## API Documentation
The API provides endpoints for managing orders, customers, and items. For detailed API documentation, including request and response formats, please refer to the [API Documentation](https://documenter.getpostman.com/view/35384500/2sA3s3GWG7).
## JNDI Configuration
The project uses JNDI for managing database connections, abstracting connection details from application code for more flexible configuration.
- **JNDI Resource Lookup**: Database connection is obtained through JNDI lookup, configured in the servlet container (e.g., Tomcat).
## MySQL Database
- **Database Setup**: MySQL is used for data storage. Ensure MySQL is properly installed and a database is created for this application.
- **Schema**: Set up the database schema to include tables for customers, items, and orders.
## Logging
Logging is handled using SLF4J with default configuration. Logs are available in server logs and can be adjusted as needed.
## Contributing
Contributions are welcome! Please fork the repository and submit a pull request with your changes, adhering to the project's coding standards and including appropriate tests.
## License
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.