Painterino-Online-Paint
Make sure to check out the new version ! Painterino v2
A simple multi-user web paint application made with JavaEE7.
Getting Started
These instructions will get you a copy of the project up and running on your local machine for development and testing purposes. See deployment for notes on how to deploy the project on a live system.
About This Project
- You can draw to canvas and anybody in the room can see!
- You can only delete what you drew.
- You can change the size as well as the color of your pen!
- You can save the image to your local machine.
- This application fully sports scaling and is responsive!
- You can see who is online in the room.
- If you want you can go offline and draw by yourself!
- Your session is tracked so you dont have to login every time.
- Full support for mobile and tablets!
Disclaimer
For this project I used AJAX system. You normally want to use Web Sockets or WebRTC API. If you want to scale this project to bigger audience I highly recommend using a real-time communication API.
Prerequisites
What things you need to install
You need Tomcat server 8 or above installed.
Locally installed MySQL or a MySQL server.
Compatible IDE, Intellij IDEA recommended for this project.
Web application 3.1 ( Configured web.xml is included )
Installing
For MySQL Database
You have to edit paintLogin.java Servlet to handle SQL communications if it is not compatible with your database.
Also you need to configure context data source and fill the necessary blanks.
If you want to use any database other than MySQL, you have to make necessary changes.
For Tomcat Application Server
Use Tomcat 8 or above. If you are running in online server like Amazon Elastic Beanstalk read the steps in paintLogin.java
and make changes to Data Source.
Database
This is a simple application so it has a simple database. SQL Script is below.
CREATE TABLE Users (
UserID int NOT NULL AUTO_INCREMENT,
Username varchar(40) UNIQUE NOT NULL,
UserPassword varchar(40) NOT NULL,
UserEmail varchar(40) NOT NULL,
PRIMARY KEY(UserID),
CONSTRAINT users_unique UNIQUE (Username)
);
Alternatively, with the correct naming conventions.
CREATE TABLE users (
user_id int(11) NOT NULL AUTO_INCREMENT,
username varchar(40) UNIQUE NOT NULL,
password varchar(40) NOT NULL,
email varchar(40) NOT NULL,
PRIMARY KEY(user_id),
CONSTRAINT users_unique UNIQUE (username)
);
Built With
- Maven - Dependency Management
- JSColor - Color selecting
- GSON - JSON Object converting
- Connector/J - Connecting to MySQL Database Server
- Jquery - AJAX Requests
- Bootstrap - UI Components
Known Bugs
- There is a bug on mobile or tablets that prevents you from picking a color, you have to spam the button.
- If the server gets overloaded with data It can crash. See Disclaimer for recommended comminication ways.
Contributing
If you want to contribute to this project you can e-mail me - antkaynak1@gmail.com or you can pull request.
Versioning
This project does not have versioning and made with learning purposes.
Authors
- Ant Kaynak - Initial work - Github
License
This project is licensed under the MIT License - see the LICENSE.md file for details.
JSColor has different license. JSLicense - for details visit their page JSColor
GSON has different license. License - for details visit their page GSON
Connector/J License - for details visit their page MySQL
Bootstrap License
Acknowledgments
- A huge thanks to BalusC for his post
- Another huge thanks to GSON
- Readme template by PurpleBooth
- Login screen Aigars Silkalns
Questions
If you have any questions mail me - antkaynak1@gmail.com