Skip to content

QWEN.md

Latest commit

 

History

History
45 lines (35 loc) · 2.85 KB

QWEN.md

File metadata and controls

45 lines (35 loc) · 2.85 KB

Qwen Code Context for Druid Project

This document provides essential context for Qwen Code to understand and assist with the Druid project.

Project Overview

This is a Java project. Druid is a high-performance, scalable JDBC connection pool implementation for Java applications. It's designed to provide efficient database connection management and includes features for monitoring and statistics.

Key aspects:

  • Main Technology: Java, built with Maven.
  • Core Functionality: JDBC Connection Pooling (DruidDataSource).
  • Additional Features: SQL monitoring, statistics, and security features like SQL firewall (WallFilter).
  • Integration: Provides Spring Boot starters for easy integration (druid-spring-boot-starter, druid-spring-boot-3-starter).

Project Structure

  • pom.xml: Root Maven project file. Defines parent POM, manages modules, dependencies, and build profiles.
  • core/: Contains the main Druid library source code.
    • core/pom.xml: Maven configuration for the core library.
    • core/src/main/java/com/alibaba/druid/: Main source code for the Druid library.
      • pool/: Core connection pooling logic (e.g., DruidDataSource).
      • sql/: SQL parsing and analysis.
      • stat/: Statistics collection and management.
      • wall/: SQL firewall/filtering logic.
      • filter/: Extensible filter mechanism for connections/statements.
  • druid-spring-boot-starter/: Spring Boot Starter for integrating Druid into Spring Boot 2.x applications.
  • druid-spring-boot-3-starter/: Spring Boot Starter for integrating Druid into Spring Boot 3.x applications.
  • druid-demo-petclinic/: A demo application, likely based on Spring PetClinic, showcasing Druid usage.
  • doc/: Documentation files.
  • README.md: General project introduction and quick start guide.

Building and Running

  • Prerequisites: Java 8+ JDK, Apache Maven.
  • Build Command: mvn clean install (from the project root). This compiles the code, runs tests, and packages the artifacts (JARs).
  • Run Demo: Navigate to druid-demo-petclinic and follow its specific instructions (likely mvn spring-boot:run).

Development Conventions

  • Build Tool: Apache Maven is used for dependency management and building.
  • Language: Java.
  • Testing: Unit and integration tests are likely located within src/test directories of respective modules (e.g., core/src/test). The pom.xml configures the maven-surefire-plugin to run tests.
  • Code Style: Checkstyle is configured (see pom.xml and src/checkstyle/druid-checks.xml) to enforce coding standards.
  • Modularization: The project is a multi-module Maven project, separating the core library from Spring Boot integration modules.
  • Versioning: Version information is managed in the root pom.xml and reflected in core/src/main/java/com/alibaba/druid/VERSION.java.