How jumpserver/chen works
Chen is JumpServer’s Java WebDB connection component: it authenticates a user, establishes a database session (optionally through Wisp), and provides SQL-console, metadata, resource-browsing, and table-editing capabilities across multiple database protocols. The graph highlights those product stages and the execution-plan and transaction-aware edit layers. Some web routing and capability wiring is unsampled; those relationships are omitted or shown as unverified rather than inferred as confirmed calls.
Main entry points: Datasource.java Datasource facade · JmsSessionService.java Session setup · BaseConnectionManager.java Connection manager · SqlAgentToolService.java SQL assistant tools
Components 20
Access and sessions
- Web API
backend/web/src/main/java/org/jumpserver/chen/web/controller - Session setup
backend/web/src/main/java/org/jumpserver/chen/web/service/impl/JmsSessionService.java - Session registry
backend/framework/src/main/java/org/jumpserver/chen/framework/session/SessionManager.java - Database session
backend/framework/src/main/java/org/jumpserver/chen/framework/session/Session.java
SQL console
- SQL assistant tools
backend/web/src/main/java/org/jumpserver/chen/web/ai/SqlAgentToolService.java - Query console
backend/framework/src/main/java/org/jumpserver/chen/framework/console/QueryConsole.java - Plan analysis
backend/framework/src/main/java/org/jumpserver/chen/framework/console/plan/ExecutionPlanService.java
Database access
- Datasource facade
backend/framework/src/main/java/org/jumpserver/chen/framework/datasource/Datasource.java - Connection manager
backend/framework/src/main/java/org/jumpserver/chen/framework/datasource/base/BaseConnectionManager.java - Metadata catalog
backend/framework/src/main/java/org/jumpserver/chen/framework/datasource/metadata/MetadataCatalog.java - SQL metadata
backend/web/src/main/java/org/jumpserver/chen/web/service/SqlMetadataService.java - Resource browsing
backend/web/src/main/java/org/jumpserver/chen/web/service/ResourceService.java
Table editing
- Edit preview
backend/framework/src/main/java/org/jumpserver/chen/framework/datasource/edit/TableChangesPreviewService.java - Change planning
backend/framework/src/main/java/org/jumpserver/chen/framework/datasource/edit/TableChangesPlanBuilder.java - Change saving
backend/framework/src/main/java/org/jumpserver/chen/framework/datasource/edit/TableChangesSaveService.java
Database integrations
- Wisp service
backend/wisp/src/main/java/org/jumpserver/wisp/ServiceGrpc.java - MySQL driver
backend/modules/src/main/java/org.jumpserver.chen.modules/mysql/MysqlConnectionManager.java - Other database modules
backend/modules/src/main/java/org.jumpserver.chen.modules
Other components
- WebDB user
- Database server
Connections 21
- WebDB user → Web API: requests access
- Web API → Session setup: starts session
- Session setup → Wisp service: creates tunnel
backend/web/src/main/java/org/jumpserver/chen/web/service/impl/JmsSessionService.java - Session setup → Datasource facade: builds datasource
backend/web/src/main/java/org/jumpserver/chen/web/service/impl/JmsSessionService.java - Session setup → Database session: creates session
backend/web/src/main/java/org/jumpserver/chen/web/service/impl/JmsSessionService.java - Session registry → Database session: stores sessions
backend/framework/src/main/java/org/jumpserver/chen/framework/session/SessionManager.java - Session registry → Query console: registers console
backend/framework/src/main/java/org/jumpserver/chen/framework/session/SessionManager.java - SQL assistant tools → Query console: uses console
backend/web/src/main/java/org/jumpserver/chen/web/ai/SqlAgentToolService.java - SQL assistant tools → Datasource facade: inspects database
backend/web/src/main/java/org/jumpserver/chen/web/ai/SqlAgentToolService.java - SQL assistant tools → Metadata catalog: reads metadata
backend/web/src/main/java/org/jumpserver/chen/web/ai/SqlAgentToolService.java - Plan analysis → Datasource facade: analyzes SQL
backend/framework/src/main/java/org/jumpserver/chen/framework/console/plan/ExecutionPlanService.java - Datasource facade → Connection manager: provides connections
backend/framework/src/main/java/org/jumpserver/chen/framework/datasource/base/BaseConnectionManager.java - Connection manager → Database server: opens JDBC
- Metadata catalog → Connection manager: sets database context
backend/framework/src/main/java/org/jumpserver/chen/framework/datasource/metadata/MetadataCatalog.java - SQL metadata → Metadata catalog: loads relations
backend/web/src/main/java/org/jumpserver/chen/web/service/SqlMetadataService.java - Resource browsing → Datasource facade: browses resources
backend/web/src/main/java/org/jumpserver/chen/web/service/ResourceService.java - Edit preview → Change planning: builds preview
backend/framework/src/main/java/org/jumpserver/chen/framework/datasource/edit/TableChangesPreviewService.java - Change saving → Change planning: applies plan
backend/framework/src/main/java/org/jumpserver/chen/framework/datasource/edit/TableChangesSaveService.java - MySQL driver → Connection manager: extends manager
backend/modules/src/main/java/org.jumpserver.chen.modules/mysql/MysqlConnectionManager.java - Other database modules → Datasource facade: implements protocols
backend/modules/src/main/java/org.jumpserver.chen.modules/mysql/MysqlConnectionManager.java - Query console → Database session: audited SQL