https://github.com/krkarma777/javelin
A high-performance, lightweight Java Web Application Server powered by Virtual Threads. 🚀
https://github.com/krkarma777/javelin
concurrency high-performance http-server java java21 javelin lightweight modern-java virtual-threads was web-server
Last synced: about 1 month ago
JSON representation
A high-performance, lightweight Java Web Application Server powered by Virtual Threads. 🚀
- Host: GitHub
- URL: https://github.com/krkarma777/javelin
- Owner: krkarma777
- License: apache-2.0
- Created: 2025-02-24T07:01:40.000Z (over 1 year ago)
- Default Branch: master
- Last Pushed: 2025-04-03T08:26:27.000Z (about 1 year ago)
- Last Synced: 2025-04-03T09:30:50.545Z (about 1 year ago)
- Topics: concurrency, high-performance, http-server, java, java21, javelin, lightweight, modern-java, virtual-threads, was, web-server
- Language: Java
- Homepage:
- Size: 1.05 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Javelin WAS - A High-Performance Virtual Thread-Based Web Application Server 🚀
Javelin WAS is a lightweight, high-performance web application server built on Java Virtual Threads.
It aims to provide a modern alternative to traditional Java-based WAS solutions like Tomcat and Jetty, leveraging Virtual Threads for maximum concurrency and efficiency.
---
## 🔥 Features
- **Virtual Thread-Based Concurrency** – Handles thousands of concurrent requests efficiently without blocking OS threads.
- **Lightweight & Fast** – Designed to be minimal and optimized for high performance.
- **Easy Routing** – Supports simple and flexible request handling.
- **Middleware System** – Easily extendable with logging, authentication, and security middleware.
- **JSON Support** – Built-in JSON serialization and deserialization.
- **Static File Serving** – Serves static files efficiently without external dependencies.
- **Designed for Modern Java Applications** – No heavy frameworks required.
---
## ☕ Requirements
- Java **21** or higher (required for Virtual Threads)
- Gradle **7+**
---
## 🛠️ Installation & Running
### 1. Clone the repository
```sh
git clone https://github.com/your-repo/Javelin.git
cd javelin-was
```
### 2. Build & Run (Using Gradle)
```sh
./gradlew run
```
---
## 🚀 Test the Server
Once the server is running, open your browser or use `curl`:
```sh
curl http://localhost:8080
```
✅ **Expected Response:**
```
Hello from Javelin Virtual Thread WAS!
```
#### ✅ Example Code (Minimal)
```java
public class Main {
public static void main(String[] args) {
VirtualThreadServer server = new VirtualThreadServer(8080);
server.get("/", ctx -> ctx.send("Hello from Javelin Virtual Thread WAS!"));
server.start();
}
}
```
---
## 🧪 Example Usage
### 🧩 Middleware
```java
server.use(ctx -> {
System.out.println("Request Path: " + ctx.path());
ctx.next();
});
```
### 📦 JSON Handling
```java
server.post("/echo", ctx -> {
Map data = ctx.body(Map.class);
ctx.json(Map.of("you_sent", data));
});
```
---
## 📁 Serving Static Files
To serve files from a `public/` directory under `/static`:
```java
server.use(new StaticFileHandler("/static", "public"));
```
Then access:
```
http://localhost:8080/static/index.html
```
---
## 🧠 How It Works
Javelin WAS uses **Java 21+ Virtual Threads** to efficiently handle HTTP requests without the overhead of traditional thread pools.
Each request is processed in a lightweight Virtual Thread, allowing **massive concurrency with minimal resource usage**.
---
## 📜 License
This project is licensed under the **Apache License 2.0**.
See the [`LICENSE`](LICENSE) file for more details.
---
## 👥 Contributing
We welcome contributions!
Feel free to submit issues, feature requests, or pull requests.
---
## 📧 Contact
For inquiries or collaboration:
**📩 krkarma777@gmail.com**
---