How lepat/webapp-hardware-bridge works
WebApp Hardware Bridge is a localhost Java service that lets browser applications print silently and communicate with serial hardware. The principal flow is WebApp WebSocket request → channel routing → printer job preparation/dispatch or serial-port proxying → response or streamed data. Configuration via the Web UI and HTTP API, printer/serial discovery, notifications, and optional TLS are additional capabilities. Arrows follow README statements or shown calls; unsampled HTTP and UI internals are not expanded.
Main entry points: PrinterWebSocketService.java Printer WebSocket handler · Server.java Local server and router · SerialWebSocketService.java Serial WebSocket proxy · ConfigService.java Config persistence
Components 21
Server and configuration
- Local server and router
src/main/java/tigerworkshop/webapphardwarebridge/Server.java - Configuration model
src/main/java/tigerworkshop/webapphardwarebridge/dtos/Config.java - Config persistence
src/main/java/tigerworkshop/webapphardwarebridge/services/ConfigService.java - HTTP config and discovery API
src/main/java/tigerworkshop/webapphardwarebridge/Server.java
Print pipeline
- Printer WebSocket handler
src/main/java/tigerworkshop/webapphardwarebridge/websocketservices/PrinterWebSocketService.java - Print request model
src/main/java/tigerworkshop/webapphardwarebridge/responses/PrintDocument.java - Document download and decode
src/main/java/tigerworkshop/webapphardwarebridge/services/DocumentService.java - Mapped printer dispatch
src/main/java/tigerworkshop/webapphardwarebridge/websocketservices/PrinterWebSocketService.java - Image and annotation rendering
src/main/java/tigerworkshop/webapphardwarebridge/utils/ImagePrintable.java - Annotation rendering
src/main/java/tigerworkshop/webapphardwarebridge/utils/AnnotatedPrintable.java - ESC/POS printer utility
src/main/java/tigerworkshop/webapphardwarebridge/utils/EscPOSPrinter.java - Print result
src/main/java/tigerworkshop/webapphardwarebridge/responses/PrintResult.java
Serial access
- Serial WebSocket proxy
src/main/java/tigerworkshop/webapphardwarebridge/websocketservices/SerialWebSocketService.java - Serial port hardware
UI and shared contracts
- WebSocket service contracts
src/main/java/tigerworkshop/webapphardwarebridge/interfaces/WebSocketServiceInterface.java - Server routing contract
src/main/java/tigerworkshop/webapphardwarebridge/interfaces/WebSocketServerInterface.java - Notification message model
src/main/java/tigerworkshop/webapphardwarebridge/dtos/NotificationDTO.java - System tray and Web UI launcher
src/main/java/tigerworkshop/webapphardwarebridge/GUI.java - TLS certificate generation
src/main/java/tigerworkshop/webapphardwarebridge/utils/CertificateGenerator.java - Thread timing utility
src/main/java/tigerworkshop/webapphardwarebridge/utils/ThreadUtil.java
Other components
- WebApp
Connections 26
- WebApp → Local server and router: connects by WebSocket
README.md - WebApp → HTTP config and discovery API: configures and discovers
README.md - Local server and router → Printer WebSocket handler: routes print channel
src/main/java/tigerworkshop/webapphardwarebridge/Server.java - Local server and router → Serial WebSocket proxy: registers serial channel
src/main/java/tigerworkshop/webapphardwarebridge/Server.java - Local server and router → Config persistence: loads and saves
src/main/java/tigerworkshop/webapphardwarebridge/Server.java - Config persistence → Configuration model: deserializes and persists
src/main/java/tigerworkshop/webapphardwarebridge/services/ConfigService.java - Local server and router → HTTP config and discovery API: serves endpoints
src/main/java/tigerworkshop/webapphardwarebridge/Server.java - Local server and router → WebSocket service contracts: dispatches service calls
src/main/java/tigerworkshop/webapphardwarebridge/Server.java - Printer WebSocket handler → Server routing contract: sends results and notices
src/main/java/tigerworkshop/webapphardwarebridge/websocketservices/PrinterWebSocketService.java - Serial WebSocket proxy → Server routing contract: streams serial data
src/main/java/tigerworkshop/webapphardwarebridge/websocketservices/SerialWebSocketService.java - Server routing contract → WebSocket service contracts: registers services
src/main/java/tigerworkshop/webapphardwarebridge/interfaces/WebSocketServerInterface.java - Printer WebSocket handler → Print request model: parses print request
src/main/java/tigerworkshop/webapphardwarebridge/websocketservices/PrinterWebSocketService.java - Printer WebSocket handler → Document download and decode: prepares documents
src/main/java/tigerworkshop/webapphardwarebridge/websocketservices/PrinterWebSocketService.java - Printer WebSocket handler → Mapped printer dispatch: dispatches print job
src/main/java/tigerworkshop/webapphardwarebridge/websocketservices/PrinterWebSocketService.java - Printer WebSocket handler → Print result: returns job status
src/main/java/tigerworkshop/webapphardwarebridge/websocketservices/PrinterWebSocketService.java - Printer WebSocket handler → Annotation rendering: adds annotations
src/main/java/tigerworkshop/webapphardwarebridge/websocketservices/PrinterWebSocketService.java - Annotation rendering → Image and annotation rendering: wraps printable
- Printer WebSocket handler → ESC/POS printer utility: uses raw printing utility
- Serial WebSocket proxy → Serial port hardware: reads and writes
src/main/java/tigerworkshop/webapphardwarebridge/websocketservices/SerialWebSocketService.java - Serial WebSocket proxy → Thread timing utility: pauses worker loops
src/main/java/tigerworkshop/webapphardwarebridge/websocketservices/SerialWebSocketService.java - Printer WebSocket handler → Config persistence: reads printer mappings
src/main/java/tigerworkshop/webapphardwarebridge/websocketservices/PrinterWebSocketService.java - Serial WebSocket proxy → Notification message model: builds port notices
src/main/java/tigerworkshop/webapphardwarebridge/websocketservices/SerialWebSocketService.java - Printer WebSocket handler → Notification message model: builds print notices
src/main/java/tigerworkshop/webapphardwarebridge/websocketservices/PrinterWebSocketService.java - System tray and Web UI launcher → Local server and router: starts and restarts
src/main/java/tigerworkshop/webapphardwarebridge/GUI.java - System tray and Web UI launcher → Notification message model: parses notifications
src/main/java/tigerworkshop/webapphardwarebridge/GUI.java - Local server and router → TLS certificate generation: uses for TLS setup
src/main/java/tigerworkshop/webapphardwarebridge/Server.java