diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml new file mode 100644 index 000000000..7086f4139 --- /dev/null +++ b/.github/workflows/ci.yml @@ -0,0 +1,41 @@ +name: CI + +on: + push: + branches: [ main, dev, 2.x, 8.2.x ] + pull_request: + branches: [ main, dev, 2.x, 8.2.x ] + +concurrency: ${{ github.workflow }}-${{ github.ref }} + +jobs: + build: + name: Build & Test + runs-on: ubuntu-latest + steps: + - name: Checkout Repo + uses: actions/checkout@v5 + + - name: Set up JDK 11 + uses: actions/setup-java@v5 + with: + distribution: temurin + java-version: 11 + cache: maven + + - name: Compile + run: ./mvnw clean compile -P travis + + - name: Test + run: ./mvnw test -P travis + + - name: Upload coverage to Codecov + uses: codecov/codecov-action@v5 + with: + token: ${{ secrets.CODECOV_TOKEN }} + files: springboot-starter/target/site/jacoco/jacoco.xml,springboot-starter-script/target/site/jacoco/jacoco.xml,springboot-starter-security/target/site/jacoco/jacoco.xml,springboot-starter-data-fast/target/site/jacoco/jacoco.xml,springboot-starter-data-authorization/target/site/jacoco/jacoco.xml + fail_ci_if_error: true + verbose: true + + - name: Install + run: ./mvnw install -P travis -DskipTests diff --git a/.gitignore b/.gitignore index 9d3ebbe1a..7848252c0 100644 --- a/.gitignore +++ b/.gitignore @@ -33,3 +33,10 @@ build/ .vscode/ *.db *.trace.db + +### Claude Code & CodeGraph ### +.claude/ +.codegraph/ + +.flattened-pom.xml +test.db* diff --git a/.travis.yml b/.travis.yml deleted file mode 100644 index cff239b5b..000000000 --- a/.travis.yml +++ /dev/null @@ -1,21 +0,0 @@ -language: java - -jdk: openjdk20 - -branches: - only: - - main - - dev - -before_install: - - pip install --user codecov - -script: - - mvn clean test -P travis - -after_success: - - bash <(curl -s https://codecov.io/bash) - -env: - global: - - CODECOV_TOKEN=eb1a776c-6802-4c65-90cd-6a8a2791e2f4 diff --git a/CLAUDE.md b/CLAUDE.md new file mode 100644 index 000000000..71613c22a --- /dev/null +++ b/CLAUDE.md @@ -0,0 +1,157 @@ +# CLAUDE.md + +This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository. + +## 项目概述 + +springboot-framework 是一个基于 Spring Boot 2.7.18（Java 8）的多模块企业级开发框架，由 CodingApi 团队维护。核心定位是为领域驱动设计（DDD）与事件风暴提供开箱即用的基础设施。当前开发版本为 `8.2.0-SNAPSHOT`，采用 Maven `${revision}` CI-Friendly 版本机制，正式发布时通过 `-Drevision=x.y.z` 指定正式版本号。版本号含义：8 = 最低 JDK 版本，2 = Spring Boot 大版本，第三位为补丁版本。 + +**回复语言**：请使用中文进行回答。 + +**版本线说明**：本仓库维护两条版本线——`17.3.x`（JDK 17 / Spring Boot 3.x）与 `8.2.x`（JDK 8 / Spring Boot 2.x，当前分支）。两条版本线功能基本一致，主要差异为 JDK 与 Spring Boot 代际：本分支使用 `javax.*` 命名空间（如 `javax.servlet`、`javax.persistence`），**禁止使用** `jakarta.*`。本分支不包含示例工程（example）与前端工程（frontend）。 + +## 常用命令 + +```bash +# 全量构建 +./mvnw clean install + +# 仅运行测试（CI 使用） +./mvnw clean test -P travis + +# 运行单个模块的测试 +./mvnw test -pl springboot-starter +./mvnw test -pl springboot-starter-security + +# 运行单个测试类 +./mvnw test -pl springboot-starter -Dtest=SomeTestClass + +# 正式发布（通过 -Drevision 指定正式版本号，无需修改 pom） +./mvnw clean deploy -P ossrh -Drevision=8.2.0 +``` + +## 模块架构 + +### Starter 模块（框架核心） + +| 模块 | 职责 | +|------|------| +| `springboot-starter` | 核心基础：统一 Response DTO、分页 PageRequest/Filter、事件系统、国际化异常、事务管理 | +| `springboot-starter-security` | Spring Security + JWT 无状态认证 / Redis 有状态认证，加解密支持 | +| `springboot-starter-data-fast` | JPA 增强：FastRepository 支持动态过滤查询、HQL 构建、SearchRequest | +| `springboot-starter-data-authorization` | 数据权限：通过 JDBC Connection/Statement 代理拦截 SQL，透明注入权限条件 | +| `springboot-starter-script` | Groovy 脚本引擎：运行时编译、LRU 缓存、热更新，提供 REST API | + +### 自动配置注册 + +各 starter 模块同时维护 `META-INF/spring.factories`（兼容旧版）和 `META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports`（Spring Boot 2.7+ 支持）。新增 starter 时需同时注册这两种文件。 + +### 模块间依赖关系 + +``` +springboot-starter (核心，无外部依赖) + ├── springboot-starter-security (依赖 starter) + ├── springboot-starter-data-fast (依赖 starter) + ├── springboot-starter-data-authorization (依赖 starter + JSqlParser) + └── springboot-starter-script (依赖 starter + Groovy) +``` + +注意：根 `pom.xml` 默认 `` 中仅包含 `springboot-starter-data-authorization`，完整 5 模块通过 `dev` / `travis` / `ossrh` profile 激活。 + +## 核心架构模式 + +### 事件系统（Event System） + +框架自建的发布-订阅事件机制，是 DDD 领域事件的核心基础设施： + +- **`IEvent`** — 事件标记接口，分为 `ISyncEvent`（同步）和 `IAsyncEvent`（异步） +- **`IHandler`** — 事件处理器，支持 `order()` 排序和 `error()` 异常回调 +- **`EventPusher.push(event, sync)`** — 事件推送入口 +- **`DomainEvent`** — 领域实体事件基类，派生 `DomainCreateEvent`、`DomainChangeEvent`、`DomainDeleteEvent` +- **`DomainChangeInterceptor`** — 通过代理拦截实体字段变更，自动推送 `DomainChangeEvent` + +标注 `@Handler`（或 `@Component`/`@Service`）的处理器会被注册为 Spring Bean；`SpringHandlerConfiguration` 收集容器中所有 `IHandler` Bean，在构造事件处理器时通过 `addHandlers` 统一注册到 `ApplicationHandlerUtils`。 + +### 统一响应封装 + +```java +Response // 基础响应（success / errCode / errMessage） +SingleResponse // 单对象响应 +MultiResponse // 列表响应 +MapResponse // Map 响应 +``` + +### 数据查询（PageRequest + FastRepository） + +`PageRequest` 扩展了 Spring Data 的 `PageRequest`，增加了 `RequestFilter` 动态过滤条件： + +```java +PageRequest request = PageRequest.of(0, 20); +request.addFilter("name", "张三"); +request.addFilter("age", Relation.GREATER_THAN, 18); +Page page = userRepository.findAll(request); +``` + +`FastRepository.findAll(PageRequest)` 全部为等值条件时构建 Example 查询；包含 LIKE/范围/IN/OR 等复杂条件时自动切换 `DynamicSQLBuilder` 构建的 HQL 查询。 + +### 数据权限（SQL 拦截） + +`ConnectionProxy` → `PreparedStatementProxy` / `StatementProxy` 代理链，在 SQL 执行前通过 `SQLRunningContext.intercept(sql)` 注入权限条件，实现透明的行级数据过滤。使用 JSqlParser 解析和改写 SQL。列级脱敏通过 `ResultSetProxy` + `ColumnHandlerContext` 在结果集读取时完成。 + +## 框架配置项 + +在 `application.properties` 中可用的配置前缀： + +```properties +# 安全模块 +codingapi.security.jwt.enable=true # 启用 JWT 认证（必须显式开启） +codingapi.security.redis.enable=true # 启用 Redis 有状态认证（必须显式开启） +codingapi.security.ignore-urls=/open/**,/#/** # 免认证 URL 列表 + +# 框架核心 +codingapi.framework.handler-thread-pool-size=20 # 事件异步线程池大小 + +# 数据权限 +codingapi.data-authorization.show-sql=false # 打印拦截后的 SQL +``` + +## 关键依赖版本 + +见根 `pom.xml` 的 `` 区块。主要版本：Groovy 4.0.24、JSqlParser 5.0、Fastjson 2.0.53、JJWT 0.12.6、H2 1.4.200。 + + +## PKR 知识查阅（编码前必须） + +进入计划模式或实现功能前，**必须按以下优先级查阅**： + +### ⚠️ 开发规范（最高优先级，必须严格遵守） + +1. [docs/conventions/index.md](./docs/conventions/index.md) — 项目开发规范 + +**规范具有最高优先级。** 所有代码必须遵循已注册的 Convention，违反规范的代码视为缺陷。 +编码前必须逐条检查相关规范，确保命名、结构、模式完全符合要求。 + +### 已有能力（必须复用，禁止重复实现） + +2. [docs/capabilities/index.md](./docs/capabilities/index.md) — 已有可复用能力 + +已有能力必须复用，禁止重新实现。优先组合已有能力解决问题。 + +### 计划模式约束 + +计划方案中必须包含： +1. **遵循了哪些规范** — 列出遵守的 Convention（必须首先说明） +2. **复用了哪些已有能力** — 列出从 PKR 中找到并复用的 Capability +3. **是否有新增能力** — 如果本次开发产生了可复用的新能力，完成后通过 `/pkr-add` 注册 + +### 知识管理命令 + +| 命令 | 用途 | +|------|------| +| `/pkr-init` | 扫描项目，发现候选能力和规范（自动跳过已有文档） | +| `/pkr-sync` | 全量同步，对比代码变更 | +| `/pkr-update / [desc]` | 单项更新，可带描述指导更新 | +| `/pkr-add / ` | 从代码/框架扫描注册 | +| `/pkr-add plan / ` | 注册计划中的能力 | +| `/pkr-export ...` | 导出模块文档供其他项目使用 | + diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index a3b1b4b91..93767de84 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -11,7 +11,17 @@ Please make sure to read and observe our [Code of Conduct](./CODE_OF_CONDUCT.md) ### Setting up your development environment -You should have JDK 1.8 or later installed in your system. +You should have JDK 8 or later installed in your system. + +The project ships with the Maven Wrapper, so there is no need to install Maven separately. + +```bash +# Full build +./mvnw clean install + +# Run the tests only (the same command CI uses) +./mvnw clean test -P travis +``` ## Contributing @@ -23,7 +33,13 @@ We are very glad to accept improvements for these aspects. ### GitHub workflow -We use the `dev` branch as the development branch, which indicates that this is a unstable branch. +Development mainly happens on version branches (e.g. `8.2.x`, `17.3.x`) and on the `dev` branch, +which is an unstable branch. The `main` branch stays stable, and CI runs on pushes and pull requests +targeting `main`, `dev`, `2.x` and `8.2.x`. + +The project version (e.g. `8.2.0-SNAPSHOT`, where `8` is the minimum JDK version, `2` is the Spring Boot +major version and the last number is the patch version) is managed with the Maven `${revision}` +CI-Friendly mechanism, so no `pom.xml` needs to be modified during development or for a release. Here are the workflow for contributors: @@ -74,4 +90,4 @@ All code should be well reviewed by one or more committers. Some principles: #### Mailing list -If you have any questions or advice, please contact 1991wangliang@gmail.com. +If you have any questions or advice, please contact wangliang@codingapi.com. diff --git a/DDD_CN.md b/DDD_CN.md new file mode 100644 index 000000000..3cb9c36c4 --- /dev/null +++ b/DDD_CN.md @@ -0,0 +1,143 @@ +# 领域驱动设计（DDD） + +2026-08-18 lorne + +中文 | [English](./DDD_EN.md) + +**DDD让业务决定模型，让模型组织软件，让数据与技术服务于业务。** + +## 它是什么？ + +领域驱动设计是一种以业务为出发点、以领域模型为核心组织软件设计的方法论。它将业务问题抽象为领域模型，通过模型分析业务、表达规则和解决问题，并以此指导业务、数据与技术的组织方式。 + +DDD提供的是软件设计的基本方向和判断标准，而不是一套固定的开发方法。它不规定必须采用某种架构、设计模式、技术框架或实现流程。判断是否符合DDD，关键不在于使用了哪些形式，而在于业务是否得到了准确表达，领域模型是否真正承担了业务职责，以及数据和技术是否围绕业务提供支撑。 + +在本文采用的实践方式中，领域模型通过面向对象设计进行表达，并通过适当的架构设计将业务、数据与技术解耦。这样做不是为了遵守某种DDD规范，而是为了保护领域模型，使数据归数据、技术归技术、业务归业务，各司其职、低耦合协作。 + +以“取消订单”为例，订单能否取消、取消后如何改变状态、是否需要退款，属于业务规则，应当由订单领域模型决定；如何查询和保存订单属于数据问题，应当由数据层负责；如何调用支付平台完成退款属于技术问题，应当由基础设施负责。 + +因此，DDD并不是简单地将数据库表包装成类，而是让领域模型真正承担业务职责。订单不再只是一个保存数据的对象，而是一个能够判断是否允许取消、执行状态变化并产生相应业务结果的业务对象。 + +## 它解决了什么？ + +### 1. 更容易掌控业务复杂度 + +领域驱动设计将业务、数据与技术进行解耦，减少彼此之间的依赖，使复杂度被限制在清晰的边界内。再通过面向对象设计对业务进行抽象和建模，使领域模型具备更好的表达力与适应能力，从而更容易应对复杂且持续变化的业务。 + +例如，订单可能存在“待付款可以直接取消”“已付款取消需要退款”“已发货不能取消”等规则。如果这些判断分散在接口、数据库脚本和流程代码中，规则越多，系统就越难理解和修改。DDD将这些规则集中到订单模型中，使开发者可以直接围绕订单的状态和行为处理变化。 + +DDD并没有消除业务本身的复杂度，而是将原本分散、隐藏的复杂度集中到业务模型中，使其能够被明确地表达、理解和控制。 + +### 2. 更容易保障软件质量 + +持续应对变化的前提，是建立完善的自动化回归测试机制。领域驱动设计将业务、数据和技术进行解耦，使每一部分都可以围绕自身职责进行独立、明确的测试，从而提高整个系统的可测试性。 + +领域模型的测试专注于业务规则，只需要构造业务对象并验证其行为，不需要依赖数据库和外部系统；数据层剥离业务逻辑后，可以专注测试数据的存储、查询、映射和事务；技术层则可以专注测试接口调用、消息传递以及外部系统的集成。 + +例如，在测试“取消订单”时，领域模型负责验证不同状态下是否允许取消；数据层负责验证取消后的订单状态能否被正确保存；技术层负责验证退款请求能否被正确发送到支付平台。 + +这种设计不仅让业务规则更容易测试，也使数据和技术从复杂的业务场景中解放出来，转变为职责清晰的功能性测试。每一部分都能围绕自身职责进行验证，使问题更容易被发现和定位，并共同构成完整的自动化回归测试体系，从而保障软件持续演进的质量。 + +### 3. 更容易沉淀和复用业务能力 + +领域驱动设计在持续落地的过程中，沉淀的是包含业务规则和行为的领域模型，并可以进一步形成独立的业务组件。由于领域模型不直接依赖具体的数据结构和技术框架，因此更容易在业务语义相同的系统中复用和持续演进。 + +例如，经过长期完善的订单模型，可能已经包含金额计算、状态流转、取消、退款和履约等能力。当其他系统需要相同的订单能力时，可以复用这些经过验证的模型和组件，再根据新系统使用的数据库、支付平台和消息系统实现相应的技术适配。 + +需要注意的是，复用的前提是两个系统对业务的定义基本一致。DDD首先复用的是业务知识、模型和规则，在业务语义一致的情况下，才进一步复用具体代码。 + +## 它不是什么？ + +### 1. DDD不是一种技术框架 + +DDD不是某个开发框架、类库或者固定的代码结构，而是一种以业务为核心组织软件的设计思想。 + +技术框架负责解决程序如何运行，DDD负责解决业务如何被理解、建模和实现。框架可以被替换，数据库可以被更换，但领域模型所表达的业务规则应当保持相对稳定。 + +因此，使用了某种分层框架不等于使用了DDD，没有使用特定框架也不代表无法实践DDD。 + +### 2. DDD不是四层架构 + +DDD经常采用用户界面层、应用层、领域层和基础设施层进行架构分层，但DDD本身并不等于四层架构。 + +四层架构的作用，是划分系统职责并隔离技术细节：用户界面层负责接收请求，应用层负责组织业务流程，领域层负责实现业务规则，基础设施层负责数据库、消息和外部系统等技术能力。它是保护领域模型的一种架构手段，而不是DDD的定义。 + +DDD也可以通过六边形架构、整洁架构或者其他架构形式实现。采用哪种架构并不重要，重要的是业务是否由领域模型表达，以及数据和技术是否被限制在清晰的边界之外。 + +因此，项目采用了四层架构，不代表它实现了DDD；项目没有采用标准的四层结构，也不代表它不是DDD。 + +### 3. DDD不是一套规范和标准 + +DDD不是一套必须严格遵守的规范，也不存在一种唯一正确的实现方式。 + +实体、值对象、聚合、仓储、领域服务、四层架构和六边形架构，都是帮助开发者建立或保护领域模型的可选工具，而不是判断一个项目是否采用DDD的标准答案。 + +如果某种更简单的设计已经能够让业务得到准确表达，就没有必要为了形式完整而引入更多概念；如果现有设计无法承载不断增长的业务复杂度，就应当引入更合适的建模和架构手段。 + +判断是否实践了DDD，不应当看项目使用了多少DDD术语，而应当看软件是否真正以业务模型为核心。 + +### 4. DDD不是复杂系统的专属方案 + +很多人认为，简单的CRUD应用不适合DDD，因为它会增加额外的设计和开发成本。我并不完全认同这种观点。 + +无论项目大小，都需要面对代码耦合、质量保障和持续维护的问题。小项目今天可能只有简单的增删改查，但随着业务规则不断增加，如果代码始终围绕数据库组织，同样会逐渐变得难以理解和修改。 + +掌握DDD并不意味着必须在每个项目中使用完全相同的设计。简单项目可以采用轻量的领域模型和分层方式，复杂项目则需要更明确的业务边界和更完整的建模方法。 + +项目大小决定的是DDD落地的深度，而不是是否需要业务建模、职责分离和质量保障。 + +### 5. DDD不是设计模式的堆积 + +实体、值对象、聚合、仓储和领域服务都是实现领域模型的工具，但使用了这些概念并不代表真正实践了DDD。 + +如果只是机械地增加类和接口，却没有用模型准确表达业务，那么这些设计只会增加系统的形式和复杂度。 + +DDD的重点不是使用了多少设计模式，而是业务规则是否得到了清晰、准确和内聚的表达。需要什么就使用什么，不需要的设计不应为了形式完整而强行加入。 + +### 6. DDD不是把数据库表转换成类 + +将一张数据库表对应成一个实体类，本质上仍然是数据建模，而不是领域建模。 + +数据对象表达的是数据如何存储，领域对象表达的是业务如何运行。领域对象不仅包含数据，还应当包含业务规则、状态变化和行为约束。 + +DDD不是围绕数据库表编写业务代码，而是先建立业务模型，再决定如何保存模型产生的数据。 + +### 7. DDD不是一次完成、永不变化的设计 + +领域模型不是在项目开始时一次设计完成的静态产物。随着团队对业务理解的加深，以及业务本身不断变化，领域模型也需要持续调整和演进。 + +因此，DDD不是追求一开始就设计出完美模型，而是在开发过程中不断发现业务、验证模型和修正表达，逐步让软件结构接近真实业务。 + +## Vibe Coding时代，DDD的价值在哪里？ + +Vibe Coding解决了代码快速生成的问题，但要真正用于复杂系统，还必须解决生成结果如何验证、已有能力如何复用，以及系统如何持续演进的问题。 + +DDD在Vibe coding时代提供的核心价值，正是让Vibe Coding具备可测试、可复用和可持续的开发能力。 + +### 1. 可测试：建立自我检测机制 + +Vibe Coding生成的代码是否正确，不能只依赖人工阅读或功能是否能够运行，而需要通过自动化测试进行验证。 + +DDD将业务规则集中在独立的领域模型中，使AI可以针对业务行为生成和执行测试，并根据测试结果持续修正代码。测试由此成为Vibe Coding的自我检测机制，为代码生成建立稳定的质量反馈闭环。 + +### 2. 可复用：同时提升效率与质量 + +如果每次开发都让AI重新生成相同的业务逻辑，不仅浪费效率，也容易产生不同的实现和新的错误。 + +DDD将业务规则沉淀为领域模型和业务组件。经过测试验证的模型可以被重复使用，使AI能够基于已有能力进行组合和扩展。复用减少了重复开发，也减少了重复犯错，因此能够同时提升开发效率和软件质量。 + +### 3. 可持续：支撑复杂系统开发 + +复杂系统不是一次生成完成的，而是在持续变化中逐步演进形成的。 + +DDD通过稳定的领域模型、清晰的业务边界以及业务与技术的分离，控制代码持续生成所带来的混乱和复杂度。它使AI能够在明确的范围内理解、修改和扩展系统，避免局部变化不断影响整体。 + +因此，可持续性是Vibe Coding进入复杂系统开发的关键。没有可持续的模型和边界，Vibe Coding只能快速完成局部功能；具备可持续能力之后，它才可能参与长期、复杂的软件建设。 + +## 总结 + +DDD不是一种固定的架构、规范或者开发流程，而是一种以业务为出发点、以领域模型为核心组织软件设计的方法论。 + +DDD本身不限定具体的实现方式。在工程实践中，可以通过面向对象设计实现领域模型，通过适当的架构设计将业务、数据与技术解耦，并通过自动化测试分别验证各自的职责，从而使业务模型能够被理解、验证、复用和持续演进。 + +进入Vibe Coding时代以后，代码生成会越来越容易，但如何判断代码是否正确、如何避免重复生成，以及如何支撑复杂系统长期演进，将变得更加重要。代码可以快速生成，但经过验证、可以复用并能够持续演进的业务模型，才是软件真正能够长期积累的核心资产。 \ No newline at end of file diff --git a/DDD_EN.md b/DDD_EN.md new file mode 100644 index 000000000..e1039d189 --- /dev/null +++ b/DDD_EN.md @@ -0,0 +1,143 @@ +# Domain-Driven Design (DDD) + +2026-08-18 lorne + +[中文](./DDD_CN.md) | English + +**DDD lets the business define the model, the model organize the software, and data and technology serve the business.** + +## What Is It? + +Domain-Driven Design is a methodology that starts from the business and uses the domain model as the core around which software design is organized. It abstracts business problems into a domain model, uses the model to analyze the business, express rules and solve problems, and thereby guides how business, data and technology are organized. + +DDD provides a fundamental direction and criteria of judgment for software design, not a fixed development method. It does not mandate any particular architecture, design pattern, technical framework or implementation process. Whether a design conforms to DDD is not determined by which forms are used, but by whether the business is accurately expressed, whether the domain model genuinely carries business responsibilities, and whether data and technology are organized around the business to provide support. + +In the practice described in this article, the domain model is expressed through object-oriented design, and appropriate architectural design is used to decouple business, data and technology. This is not done to comply with some DDD specification, but to protect the domain model — so that data stays data, technology stays technology, and business stays business, each fulfilling its own role and collaborating with low coupling. + +Take "cancel order" as an example: whether an order can be cancelled, how its state changes after cancellation, and whether a refund is required are business rules and should be decided by the order domain model; how orders are queried and persisted is a data concern and should be handled by the data layer; how the payment platform is invoked to complete a refund is a technical concern and should be handled by the infrastructure. + +Therefore, DDD is not simply wrapping database tables as classes, but letting the domain model genuinely carry business responsibilities. An order is no longer just an object that stores data, but a business object that can decide whether cancellation is allowed, execute state transitions, and produce the corresponding business outcomes. + +## What Does It Solve? + +### 1. Business Complexity Becomes Manageable + +Domain-Driven Design decouples business, data and technology, reduces the dependencies among them, and confines complexity within clear boundaries. Through object-oriented design, the business is abstracted and modeled so that the domain model gains better expressiveness and adaptability, making it easier to cope with complex and continuously changing business. + +For example, an order may have rules such as "unpaid orders can be cancelled directly", "paid orders require a refund when cancelled", and "shipped orders cannot be cancelled". If these decisions are scattered across APIs, database scripts and process code, the more rules there are, the harder the system becomes to understand and modify. DDD centralizes these rules in the order model, so developers can handle changes directly around the order's states and behaviors. + +DDD does not eliminate the complexity of the business itself; rather, it concentrates complexity that was previously scattered and hidden into the business model, where it can be explicitly expressed, understood and controlled. + +### 2. Software Quality Becomes Easier to Guarantee + +The prerequisite for continuously coping with change is a solid automated regression testing mechanism. Domain-Driven Design decouples business, data and technology so that each part can be tested independently and explicitly around its own responsibility, improving the testability of the whole system. + +Tests of the domain model focus on business rules: they only need to construct business objects and verify their behavior, with no dependency on databases or external systems. Once the data layer is stripped of business logic, it can focus on testing storage, querying, mapping and transactions. The technology layer can focus on testing API calls, message passing and external system integration. + +For example, when testing "cancel order", the domain model verifies whether cancellation is allowed in each state; the data layer verifies that the order state after cancellation can be persisted correctly; the technology layer verifies that the refund request can be sent to the payment platform correctly. + +This design not only makes business rules easier to test, but also frees data and technology from complex business scenarios, turning them into clearly scoped functional tests. Each part can be verified around its own responsibility, making problems easier to find and locate, and together they form a complete automated regression testing system that safeguards quality as the software continuously evolves. + +### 3. Business Capabilities Can Be Accumulated and Reused + +As Domain-Driven Design is continuously practiced, what gets accumulated are domain models containing business rules and behaviors, which can further evolve into independent business components. Because domain models do not directly depend on concrete data structures or technical frameworks, they are easier to reuse and continuously evolve in systems with the same business semantics. + +For example, an order model refined over a long period may already include capabilities such as amount calculation, state transitions, cancellation, refund and fulfillment. When another system needs the same order capabilities, it can reuse these proven models and components, and then implement the corresponding technical adaptations for its own database, payment platform and messaging system. + +Note that the premise of reuse is that the two systems define the business in essentially the same way. What DDD reuses first is business knowledge, models and rules; only when business semantics are consistent does it proceed to reuse concrete code. + +## What Is It Not? + +### 1. DDD Is Not a Technical Framework + +DDD is not some development framework, class library or fixed code structure, but a way of thinking about organizing software with the business at the core. + +Technical frameworks solve how a program runs; DDD solves how the business is understood, modeled and implemented. Frameworks can be replaced and databases can be swapped, but the business rules expressed by the domain model should remain relatively stable. + +Therefore, using a certain layered framework does not mean using DDD, and not using a specific framework does not mean DDD cannot be practiced. + +### 2. DDD Is Not a Four-Layer Architecture + +DDD often adopts a layered architecture of user interface, application, domain and infrastructure, but DDD itself is not equivalent to a four-layer architecture. + +The role of a four-layer architecture is to divide system responsibilities and isolate technical details: the user interface layer receives requests, the application layer orchestrates business processes, the domain layer implements business rules, and the infrastructure layer provides technical capabilities such as databases, messaging and external systems. It is an architectural means of protecting the domain model, not the definition of DDD. + +DDD can also be realized through hexagonal architecture, clean architecture, or other architectural forms. Which architecture is adopted is not what matters; what matters is whether the business is expressed by the domain model, and whether data and technology are kept outside clear boundaries. + +Therefore, a project adopting a four-layer architecture does not mean it has implemented DDD; a project not adopting the standard four-layer structure does not mean it is not DDD either. + +### 3. DDD Is Not a Set of Specifications and Standards + +DDD is not a set of rules that must be strictly followed, nor is there a single correct implementation. + +Entities, value objects, aggregates, repositories, domain services, four-layer architecture and hexagonal architecture are all optional tools that help developers establish or protect the domain model, not standard answers for judging whether a project adopts DDD. + +If a simpler design can already express the business accurately, there is no need to introduce more concepts for the sake of formal completeness; if the current design can no longer carry the growing business complexity, more suitable modeling and architectural means should be introduced. + +Whether DDD is practiced should not be judged by how much DDD terminology a project uses, but by whether the software is genuinely centered on the business model. + +### 4. DDD Is Not Exclusive to Complex Systems + +Many people believe that simple CRUD applications are not suitable for DDD because it adds extra design and development cost. I do not fully agree with this view. + +Regardless of project size, one must face the problems of code coupling, quality assurance and continuous maintenance. A small project may only have simple CRUD today, but as business rules keep growing, if the code is always organized around the database, it will gradually become hard to understand and modify as well. + +Mastering DDD does not mean using exactly the same design in every project. Simple projects can adopt lightweight domain models and layering, while complex projects need more explicit business boundaries and more complete modeling methods. + +Project size determines the depth at which DDD is applied, not whether business modeling, separation of responsibilities and quality assurance are needed. + +### 5. DDD Is Not an Accumulation of Design Patterns + +Entities, value objects, aggregates, repositories and domain services are all tools for implementing the domain model, but using these concepts does not mean truly practicing DDD. + +If classes and interfaces are added mechanically while the model fails to express the business accurately, such designs only add formality and complexity to the system. + +The point of DDD is not how many design patterns are used, but whether business rules are expressed clearly, accurately and cohesively. Use what is needed; designs that are not needed should not be forced in for the sake of formal completeness. + +### 6. DDD Is Not Converting Database Tables into Classes + +Mapping one database table to one entity class is essentially still data modeling, not domain modeling. + +Data objects express how data is stored; domain objects express how the business operates. A domain object contains not only data, but also business rules, state transitions and behavioral constraints. + +DDD is not writing business code around database tables, but first establishing the business model and then deciding how to persist the data the model produces. + +### 7. DDD Is Not a One-Time, Never-Changing Design + +The domain model is not a static artifact designed once at the beginning of a project. As the team's understanding of the business deepens and the business itself keeps changing, the domain model also needs continuous adjustment and evolution. + +Therefore, DDD is not about pursuing a perfect model from the start, but about continuously discovering the business, validating the model and correcting its expression during development, gradually bringing the software structure closer to the real business. + +## In the Era of Vibe Coding, Where Is the Value of DDD? + +Vibe Coding solves the problem of rapid code generation, but to be truly used in complex systems, it must also solve how generated results are verified, how existing capabilities are reused, and how the system continuously evolves. + +The core value DDD provides in the era of Vibe Coding is precisely making Vibe Coding testable, reusable and sustainable. + +### 1. Testable: Establishing a Self-Verification Mechanism + +Whether the code generated by Vibe Coding is correct cannot rely solely on manual reading or on whether the functionality runs; it must be verified through automated tests. + +DDD centralizes business rules in independent domain models, allowing AI to generate and execute tests against business behavior and continuously correct the code based on test results. Tests thus become the self-verification mechanism of Vibe Coding, establishing a stable quality feedback loop for code generation. + +### 2. Reusable: Improving Both Efficiency and Quality + +If every development session lets AI regenerate the same business logic from scratch, it not only wastes efficiency but also easily produces divergent implementations and new errors. + +DDD accumulates business rules into domain models and business components. Models verified by tests can be reused, enabling AI to compose and extend based on existing capabilities. Reuse reduces repeated development and repeated mistakes, thus improving both development efficiency and software quality. + +### 3. Sustainable: Supporting Complex System Development + +Complex systems are not generated in one shot, but evolve gradually amid continuous change. + +Through stable domain models, clear business boundaries, and the separation of business from technology, DDD controls the chaos and complexity brought by continuous code generation. It enables AI to understand, modify and extend the system within explicit boundaries, preventing local changes from constantly affecting the whole. + +Therefore, sustainability is the key for Vibe Coding to enter complex system development. Without sustainable models and boundaries, Vibe Coding can only quickly complete isolated features; only with sustainable capabilities can it participate in long-term, complex software construction. + +## Conclusion + +DDD is not a fixed architecture, specification or development process, but a methodology that starts from the business and organizes software design around the domain model. + +DDD itself does not prescribe concrete implementation approaches. In engineering practice, the domain model can be realized through object-oriented design, business, data and technology can be decoupled through appropriate architectural design, and each responsibility can be verified separately through automated tests, so that the business model can be understood, verified, reused and continuously evolved. + +In the era of Vibe Coding, generating code will become ever easier, but judging whether code is correct, avoiding repeated generation, and supporting the long-term evolution of complex systems will become ever more important. Code can be generated quickly, but business models that are verified, reusable and capable of continuous evolution are the true core assets that software can accumulate over the long term. diff --git a/LICENSE b/LICENSE index 71f43b0f6..aa13fb87c 100644 --- a/LICENSE +++ b/LICENSE @@ -186,7 +186,7 @@ same "printed page" as the copyright notice for easier identification within third-party archives. - Copyright 2021-2022 copyright codingapi + Copyright 2021-2026 copyright codingapi Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. diff --git a/README.md b/README.md index 149c9aa51..4e4c6eef4 100644 --- a/README.md +++ b/README.md @@ -1,86 +1,109 @@ [![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://github.com/codingapi/springboot-framework/blob/main/LICENSE) [![Maven Central](https://img.shields.io/maven-central/v/com.codingapi.springboot/springboot-starter.svg?label=Maven%20Central)](https://search.maven.org/search?q=g:%22com.codingapi.springboot%22%20AND%20a:%22springboot-starter%22) -[![Build Status](https://app.travis-ci.com/codingapi/springboot-framework.svg?branch=main)](https://app.travis-ci.com/codingapi/springboot-framework) -[![codecov](https://codecov.io/gh/codingapi/springboot-framework/branch/main/graph/badge.svg?token=Gl9LjJV6y4)](https://codecov.io/gh/codingapi/springboot-framework) +[![Build](https://img.shields.io/github/actions/workflow/status/codingapi/springboot-framework/ci.yml?label=Build&logo=github)](https://github.com/codingapi/springboot-framework/actions) +[![Codecov](https://codecov.io/gh/codingapi/springboot-framework/branch/8.2.x/graph/badge.svg)](https://codecov.io/gh/codingapi/springboot-framework) -# springboot-framework | Springboot领域驱动开发 +# springboot-framework | Spring Boot 领域驱动开发框架 > 当你无意间推开这一扇门，将会感叹原来生活可以如此的美好。 -本框架基于springboot为提供领域驱动设计与事件风暴开发落地，提供的范式开源框架。 +springboot-framework 是基于 Spring Boot 的领域驱动设计（DDD）与事件风暴落地框架，提供统一响应封装、动态分页查询、领域事件、数据权限、脚本引擎、认证授权等开箱即用能力。 -## Project Modules Description | 项目模块介绍 +## DDD 观点分享 | DDD Perspectives -* springboot-starter | Springboot领域驱动框架 -* springboot-starter-data-fast | 快速数据呈现框架 -* springboot-starter-id-generator | Id自增策略框架 -* springboot-starter-security-jwt | security&jwt权限框架 +本框架以领域驱动设计为核心方法论。我们沉淀了一篇关于 DDD 的实践思考，欢迎交流： -## SpringBoot DDD Architecture | SpringBoot DDD 框架图 +> **DDD 让业务决定模型，让模型组织软件，让数据与技术服务于业务。** -![](./docs/img/ddd_architecture.png) +核心观点： -## maven install +* DDD 不是技术框架、不是四层架构、也不是一套规范，而是一种以业务为出发点、以领域模型为核心组织软件设计的方法论； +* 通过业务、数据、技术解耦，让业务复杂度可控、软件质量可测、业务能力可复用； +* DDD 不是复杂系统的专属方案，项目大小决定的是落地深度，而不是是否需要业务建模与职责分离； +* 在 Vibe Coding 时代，代码可以快速生成，但经过验证、可以复用并能够持续演进的业务模型，才是软件真正能够长期积累的核心资产。 -``` - - - com.codingapi.springboot - springboot-starter - ${last.version} - - - - - com.codingapi.springboot - springboot-starter-data-fast - ${last.version} - - - - - com.codingapi.springboot - springboot-starter-id-generator - ${last.version} - - - - - com.codingapi.springboot - springboot-starter-security-jwt - ${last.version} - - -``` +阅读完整文章：[中文版](./DDD_CN.md) | [English](./DDD_EN.md) + +## 版本说明 | Versions + +项目当前维护两条版本线： + +| 版本线 | 最低 JDK 要求 | Spring Boot 版本 | 开发版本号 | +|--------|--------------|------------------|-----------| +| [17.3.x](https://github.com/codingapi/springboot-framework/tree/17.3.x) | JDK 17 | Spring Boot 3.x | `17.3.0-SNAPSHOT` | +| [8.2.x](https://github.com/codingapi/springboot-framework/tree/8.2.x) | JDK 8 | Spring Boot 2.x | `8.2.0-SNAPSHOT` | + +版本号含义：第一位为最低 JDK 版本，第二位为 Spring Boot 大版本，第三位为补丁版本。项目采用 Maven `${revision}` CI-Friendly 版本机制，正式发布时通过 `-Drevision=x.y.z` 指定版本号，无需修改 pom。 + +Version lines: **17.3.x** requires JDK 17+ and Spring Boot 3.x; **8.2.x** requires JDK 8+ and Spring Boot 2.x. + +## 核心模块 | Modules -## CONTRIBUTING +| 模块 | 说明 | +|------|------| +| `springboot-starter` | DDD 核心：统一响应封装、动态分页查询、领域事件系统、国际化异常、事务管理 | +| `springboot-starter-script` | Groovy 脚本引擎（运行时编译、缓存、热更新、REST API） | +| `springboot-starter-data-fast` | JPA 增强，动态过滤查询与 HQL 构建 | +| `springboot-starter-data-authorization` | 数据权限，SQL 拦截透明注入行级/列级权限条件 | +| `springboot-starter-security` | JWT 无状态认证 / Redis 有状态认证 | -Welcome to springboot-framework ! This document is a guideline about how to contribute to springboot-framework. -If you find something incorrect or missing, please leave comments / suggestions. +## 快速开始 | Getting Started -[CONTRIBUTING](./CONTRIBUTING.md) +Maven 引入（以正式发布版本为例，最新版本见上方 Maven Central 徽章；开发快照请使用 `8.2.0-SNAPSHOT`）： + +```xml + + + com.codingapi.springboot + springboot-starter + 8.2.0 + + + + + com.codingapi.springboot + springboot-starter-script + 8.2.0 + + + + + com.codingapi.springboot + springboot-starter-data-fast + 8.2.0 + + + + + com.codingapi.springboot + springboot-starter-data-authorization + 8.2.0 + + + + + com.codingapi.springboot + springboot-starter-security + 8.2.0 + +``` + +## SpringBoot DDD Architecture | 框架结构图 + +![](./docs/img/ddd_architecture.png) -## Documentation +## 文档 | Documentation -https://github.com/codingapi/springboot-framework/wiki +* [Wiki](https://github.com/codingapi/springboot-framework/wiki) +* [开发规范](./docs/conventions/index.md) +* [能力清单](./docs/capabilities/index.md) -## Example +## 流程引擎迁移说明 | Flow Engine Migration -见 [springboot-example](https://github.com/codingapi/springboot-example) +工作流引擎（springboot-starter-flow）已从本框架移除，重构为独立仓库维护：[codingapi/flow-engine](https://github.com/codingapi/flow-engine)。需要使用流程引擎的项目请改用独立仓库。 -## Reference Documentation +The workflow engine (springboot-starter-flow) has been moved to a standalone repository: [codingapi/flow-engine](https://github.com/codingapi/flow-engine). -For further reference, please consider the following sections: +## 贡献 | Contributing -* [Official Apache Maven documentation](https://maven.apache.org/guides/index.html) -* [Spring Boot Maven Plugin Reference Guide](https://docs.spring.io/spring-boot/docs/2.7.1/maven-plugin/reference/html/) -* [Create an OCI image](https://docs.spring.io/spring-boot/docs/2.7.1/maven-plugin/reference/html/#build-image) -* [Spring Security](https://docs.spring.io/spring-boot/docs/2.7.1/reference/htmlsingle/#web.security) -* [Spring Configuration Processor](https://docs.spring.io/spring-boot/docs/2.7.1/reference/htmlsingle/#appendix.configuration-metadata.annotation-processor) -* [Spring Web](https://docs.spring.io/spring-boot/docs/2.7.1/reference/htmlsingle/#web) -* [securing-web](https://spring.io/guides/gs/securing-web/) -* [spring-security-without-the-websecurityconfigureradapter](https://spring.io/blog/2022/02/21/spring-security-without-the-websecurityconfigureradapter) -* [springboot-security&jwt](https://blog.csdn.net/u014553029/article/details/112759382) -* [Meituan-Dianping/Leaf](https://github.com/Meituan-Dianping/Leaf) -* [SpringBoot Test](https://spring.io/guides/gs/testing-web/) -* [SpringBoot Web Test](https://spring.io/guides/gs/testing-web/) +详见 [CONTRIBUTING](./CONTRIBUTING.md)。 diff --git a/docs/agents/capabilities/springboot-starter-data-authorization/sql-interception.md b/docs/agents/capabilities/springboot-starter-data-authorization/sql-interception.md new file mode 100644 index 000000000..dabcceb47 --- /dev/null +++ b/docs/agents/capabilities/springboot-starter-data-authorization/sql-interception.md @@ -0,0 +1,223 @@ +--- +name: springboot-starter-data-authorization/sql-interception +module: springboot-starter-data-authorization +description: SQL 拦截数据权限，通过 JDBC 代理透明注入权限条件实现行级数据过滤 +status: 已实现 +scope: 后端 +source: 框架:springboot-starter-data-authorization +import: "com.codingapi.springboot:springboot-starter-data-authorization" +framework_version: "8.2.0-SNAPSHOT" +--- + +## 解决什么问题 + +在企业级应用中，不同角色的用户只能看到自己有权限访问的数据（行级数据权限）。传统实现方式存在以下痛点： + +- **侵入性强**：需要在每个 Service/Repository 方法中手动拼接权限条件，代码散落各处 +- **容易遗漏**：新增查询接口时可能忘记添加权限过滤，导致数据泄露 +- **维护困难**：权限规则变更时需要修改大量业务代码 +- **与业务耦合**：权限逻辑与业务查询逻辑混杂，违反单一职责原则 + +SQL 拦截数据权限通过 JDBC 代理层实现了完全透明的权限注入： + +- **零侵入**：业务代码无需任何修改，所有 SELECT 查询自动注入权限条件 +- **全覆盖**：无论通过 JPA、MyBatis、原生 JDBC 还是其他 ORM 框架执行的 SQL，都会被统一拦截 +- **灵活配置**：通过 `RowHandler` 接口按表名自定义权限规则，支持 WHERE 条件和 JOIN 关联两种注入模式 +- **可跳过**：提供 `skipDataAuthorization()` API，允许特定场景下临时绕过权限检查 +- **SQL 解析增强**：使用 JSqlParser 解析 SQL AST，精确识别表名和别名，支持子查询、UNION、JOIN 等复杂 SQL 结构 + +## 如何使用 + +### 1. 引入依赖 + +```xml + + com.codingapi.springboot + springboot-starter-data-authorization + +``` + +### 2. 架构概览 + +整个拦截链路由以下组件构成： + +``` +JDBC Driver(AuthorizationJdbcDriver) → ConnectionProxy → PreparedStatementProxy / StatementProxy + ↓ + SQLRunningContext.intercept(sql) + ↓ + SQLInterceptor (DefaultSQLInterceptor) + ↓ + DataPermissionSQLEnhancer (JSqlParser) + ↓ + RowHandler.handler(tableName, alias) + ↓ + Condition (WHERE / JOIN 条件注入) +``` + +Connection 的包装实际发生在 `AuthorizationJdbcDriver.connect()`。该类是一个 JDBC Driver 装饰器，类加载时自动向 `DriverManager` 注册；建立连接时根据 JDBC URL 查找真实的数据库驱动并委托建连，再将返回的 `Connection` 包装为 `ConnectionProxy`。使用时需将数据源的 driver 指向该类（JDBC URL 保持不变）： + +```properties +spring.datasource.driver-class-name=com.codingapi.springboot.authorization.jdbc.AuthorizationJdbcDriver +``` + +### 3. 核心组件说明 + +#### ConnectionProxy + +JDBC `Connection` 的代理实现。在 `prepareStatement()`、`createStatement()`、`prepareCall()` 等方法中拦截 SQL，调用 `SQLRunningContext.intercept(sql)` 获取改写后的 SQL，并将 `SQLExecuteState` 传递给下游的 Statement 代理。 + +#### PreparedStatementProxy / StatementProxy + +JDBC `PreparedStatement` 和 `Statement` 的代理实现。在执行 `executeQuery()`、`execute()` 等方法时，确保使用经过权限改写的 SQL。对于直接传入 SQL 字符串的方法（如 `executeQuery(String sql)`），会再次调用 `SQLRunningContext.intercept()` 进行拦截。查询结果通过 `ResultSetProxy` 包装返回。 + +#### SQLRunningContext + +SQL 拦截的核心调度器（单例模式），负责： +- 从 `SQLInterceptorContext` 获取当前 `SQLInterceptor` 实例 +- 通过 `ThreadLocal skipInterceptor` 控制是否跳过拦截 +- 调用 `SQLInterceptor.beforeHandler()` 判断是否需要拦截（默认仅拦截 SELECT 语句） +- 调用 `SQLInterceptor.postHandler()` 执行 SQL 改写 +- 提供 `skipDataAuthorization(Supplier/Runnable)` API 临时跳过权限检查 + +#### DefaultSQLInterceptor + +默认的 SQL 拦截器实现，包含三个阶段的处理： +- `beforeHandler(sql)`：通过 `SQLUtils.isQuerySql()` 判断是否为查询语句，仅 SELECT 会被拦截 +- `postHandler(sql)`：创建 `DataPermissionSQLEnhancer`，使用 JSqlParser 解析 SQL 并通过 `RowHandler` 获取权限条件，返回增强后的 SQL +- `afterHandler(sql, newSql, exception)`：日志记录，当配置 `codingapi.data-authorization.show-sql=true` 时输出改写后的 SQL + +#### RowHandler + +行级权限处理器接口，由业务方实现： + +```java +public interface RowHandler { + Condition handler(String subSql, String tableName, String tableAlias); +} +``` + +返回值 `Condition` 支持两种注入模式： +- **WHERE 条件**：`Condition.customCondition("dept_id IN (1,2,3)")` — 在 WHERE 子句中追加 AND 条件 +- **JOIN 关联**：通过 `JoinConditionSQL` 添加 INNER/LEFT/RIGHT JOIN 关联表 + +### 4. 跳过数据权限 + +在某些管理操作或系统任务中需要绕过数据权限： + +```java +// 方式一：Lambda 表达式 +List allUsers = SQLRunningContext.getInstance() + .skipDataAuthorization(() -> userRepository.findAll()); + +// 方式二：Runnable +SQLRunningContext.getInstance() + .skipDataAuthorization(() -> { + reportService.generateMonthlyReport(); + }); +``` + +## 使用实例 + +### 示例一：按部门过滤数据 + +```java +@Component +public class DeptRowHandler implements RowHandler { + + @Override + public Condition handler(String subSql, String tableName, String tableAlias) { + // 仅对 employee 表注入权限条件 + if ("employee".equalsIgnoreCase(tableName)) { + List deptIds = SecurityContext.getCurrentDeptIds(); + if (deptIds == null || deptIds.isEmpty()) { + return Condition.emptyCondition(); // 无权限，返回 null 不注入 + } + String inClause = deptIds.stream() + .map(String::valueOf) + .collect(Collectors.joining(",")); + return Condition.customCondition( + String.format("%s.dept_id IN (%s)", tableAlias, inClause) + ); + } + // 其他表不注入权限条件 + return Condition.emptyCondition(); + } +} +``` + +效果：原始 SQL `SELECT * FROM employee WHERE status = 'active'` 被改写为： +```sql +SELECT * FROM employee WHERE dept_id IN (1,2,3) AND status = 'active' +``` + +### 示例二：通过 JOIN 关联实现跨表权限 + +```java +@Component +public class ProjectRowHandler implements RowHandler { + + @Override + public Condition handler(String subSql, String tableName, String tableAlias) { + if ("project".equalsIgnoreCase(tableName)) { + Condition condition = new Condition(); + // 通过 JOIN 关联成员表，只查询当前用户参与的项目 + // 构造器参数顺序：(Type type, String tableName, String tableAlias, String onCondition) + JoinConditionSQL joinSQL = new JoinConditionSQL( + JoinConditionSQL.Type.INNER, + "project_member", + "pm", + String.format("pm.project_id = %s.id AND pm.user_id = %d", + tableAlias, SecurityContext.getCurrentUserId()) + ); + condition.addConditionSQL(joinSQL); + return condition; + } + return Condition.emptyCondition(); + } +} +``` + +效果：原始 SQL `SELECT * FROM project WHERE status = 'open'` 被改写为： +```sql +SELECT * FROM project +INNER JOIN project_member pm ON pm.project_id = project.id AND pm.user_id = 1001 +WHERE status = 'open' +``` + +### 示例三：自定义 SQLInterceptor + +如需替换默认的拦截逻辑（例如增加缓存或审计），可实现 `SQLInterceptor` 接口并注册为 Spring Bean： + +```java +@Component +public class AuditSQLInterceptor implements SQLInterceptor { + + @Override + public boolean beforeHandler(String sql) { + // 仅拦截 SELECT 且不包含系统表的查询 + return SQLUtils.isQuerySql(sql) && !sql.contains("sys_config"); + } + + @Override + public DataPermissionSQL postHandler(String sql) throws SQLException { + RowHandler rowHandler = RowHandlerContext.getInstance().getRowHandler(); + DataPermissionSQLEnhancer enhancer = new DataPermissionSQLEnhancer(sql, rowHandler); + return new DataPermissionSQL(sql, enhancer.getNewSQL(), enhancer.getTableAlias()); + } + + @Override + public void afterHandler(String sql, String newSql, SQLException exception) { + // 记录审计日志 + AuditLog.record(sql, newSql, exception); + } +} +``` + +### 内部工作原理 + +1. **连接代理**：`AuthorizationJdbcDriver.connect()` 将真实驱动返回的 `Connection` 包装为 `ConnectionProxy` +2. **SQL 拦截时机**：当调用 `connection.prepareStatement(sql)` 时，`ConnectionProxy` 立即调用 `SQLRunningContext.intercept(sql)` 对 SQL 进行改写 +3. **递归解析**：`DataPermissionSQLEnhancer` 使用 JSqlParser 解析 SQL AST，深度遍历 PlainSelect、SetOperationList（UNION）、子查询、JOIN 中的子 Select，对每个涉及的表调用 `RowHandler` +4. **条件注入**：`WhereConditionSQLHandler` 将 WHERE 条件通过 AND 拼接到原有 WHERE 子句；`JoinConditionSQLHandler` 向 FROM 子句追加 JOIN 关联 +5. **防重入**：`SQLRunningContext` 使用 ThreadLocal 标记，在拦截器内部执行的查询不会被二次拦截 diff --git a/docs/agents/capabilities/springboot-starter-data-fast/fast-repository.md b/docs/agents/capabilities/springboot-starter-data-fast/fast-repository.md new file mode 100644 index 000000000..a9a3779cd --- /dev/null +++ b/docs/agents/capabilities/springboot-starter-data-fast/fast-repository.md @@ -0,0 +1,175 @@ +--- +name: springboot-starter-data-fast/fast-repository +module: springboot-starter-data-fast +description: JPA 增强 Repository，支持 PageRequest 动态过滤查询和 HQL 构建 +status: 已实现 +scope: 后端 +source: 框架:springboot-starter-data-fast +import: "com.codingapi.springboot:springboot-starter-data-fast" +framework_version: "8.2.0-SNAPSHOT" +--- + +## 解决什么问题 + +在标准 Spring Data JPA 开发中，动态条件查询通常需要手动编写 `Specification`、`QueryDSL` 或拼接 HQL，代码冗长且难以维护。当业务列表页面需要支持多字段组合筛选（等于、模糊、范围、IN 等）时，开发者往往要为每种查询场景编写独立的 Repository 方法或复杂的 Specification 构建逻辑。 + +`FastRepository` 通过扩展 `JpaRepository` 和 `JpaSpecificationExecutor`，提供了基于 `PageRequest` 的声明式动态查询能力： + +- **findAll → Example/HQL 自动切换**：`findAll(PageRequest)` 有 Filter 条件时，全部为简单等值条件则构建 Spring Data `Example` 查询；包含 LIKE/范围/IN/OR 等复杂条件时自动切换参数化 HQL，零额外代码 +- **pageRequest → HQL 动态构建**：需要 LIKE、范围、IN、OR 等复杂条件时，必须显式调用 `pageRequest(PageRequest)`，由 `DynamicSQLBuilder` 构建参数化 HQL，避免 SQL 注入风险 +- **SearchRequest 集成**：支持从 HTTP 请求参数中自动解析 filter、sort 条件，适用于前端列表页的通用查询接口 +- **OR/AND 组合过滤**：支持嵌套的 OR/AND 条件组合，满足复杂业务筛选需求 + +## 如何使用 + +### 1. 定义 Repository 接口 + +继承 `FastRepository` 即可获得全部动态查询能力： + +```java +public interface UserEntityRepository extends FastRepository { + // 标准 JpaRepository 方法仍然可用 + UserEntity getUserEntityByUsername(String username); +} +``` + +### 2. 使用 PageRequest 进行动态过滤查询 + +```java +// 创建分页请求并添加等值过滤条件 +PageRequest request = PageRequest.of(0, 20); +request.addFilter("name", "张三"); // 等值匹配（默认 EQUAL） +request.addFilter("status", "active"); // 等值匹配 + +// 方式一：findAll —— 等值条件走 Example 查询，复杂条件自动切换 HQL +Page page = repository.findAll(request); + +// 方式二：pageRequest —— 需要 LIKE/范围/IN/OR 等复杂条件时必须显式调用，走 HQL +PageRequest hqlRequest = PageRequest.of(0, 20); +hqlRequest.addFilter("age", Relation.GREATER_THAN, 18); // 大于 +hqlRequest.addFilter("email", Relation.LIKE, "gmail"); // 模糊查询 +Page page2 = repository.pageRequest(hqlRequest); +``` + +### 3. 支持的过滤关系（Relation） + +| Relation | 说明 | HQL 示例 | +|----------|------|----------| +| EQUAL（默认） | 等于 | `name = ?1` | +| NOT_EQUAL | 不等于 | `name != ?1` | +| GREATER_THAN | 大于 | `age > ?1` | +| LESS_THAN | 小于 | `age < ?1` | +| GREATER_THAN_EQUAL | 大于等于 | `age >= ?1` | +| LESS_THAN_EQUAL | 小于等于 | `age <= ?1` | +| LIKE | 全模糊 | `name LIKE ?1`（自动加 `%value%`） | +| LEFT_LIKE | 左模糊 | `name LIKE ?1`（自动加 `%value`） | +| RIGHT_LIKE | 右模糊 | `name LIKE ?1`（自动加 `value%`） | +| IN | 包含 | `id IN (?1)` | +| NOT_IN | 不包含 | `id NOT IN (?1)` | +| BETWEEN | 区间 | `age BETWEEN ?1 AND ?2` | +| IS_NULL | 为空 | `name IS NULL` | +| IS_NOT_NULL | 非空 | `name IS NOT NULL` | + +> 注意：以上 Relation 在 `pageRequest()` / `searchRequest()` 中完整生效；`findAll()` 会按条件类型自动选择——全部等值条件走 Example 查询，包含 LIKE/范围/IN/OR 等复杂条件时自动切换 HQL。 + +### 4. 使用 SearchRequest 从 HTTP 请求自动解析 + +```java +// 在 Controller 中使用 SearchRequest，自动从 URL 参数解析 filter 和 sort +@GetMapping("/users") +public MultiResponse list() { + SearchRequest searchRequest = new SearchRequest(); + searchRequest.addFilter("status", "active"); // 追加服务端固定条件 + Page page = userRepository.searchRequest(searchRequest); + return MultiResponse.of(page.getContent()); +} +``` + +前端通过 URL 参数传递动态条件： +- `?filter=eyJuYW1lIjpbIuW8oCJdfQ==`（Base64 编码的 JSON：`{"name":["张"]}`) +- `?sort=eyJjcmVhdGVUaW1lIjoiZGVzY2VuZCJ9`（Base64 编码的 JSON：`{"createTime":"descend"}`) + +### 5. OR / AND 组合条件 + +```java +PageRequest request = PageRequest.of(0, 20); + +// OR 条件：name = '张三' OR name = '李四' +request.orFilters( + new Filter("name", "张三"), + new Filter("name", "李四") +); + +// AND 条件组 +request.andFilter( + new Filter("age", Relation.GREATER_THAN_EQUAL, 18), + new Filter("status", "active") +); +``` + +## 使用实例 + +### 完整示例：用户列表查询 + +```java +@Service +public class UserQueryService { + + @Resource + private UserEntityRepository userRepository; + + /** + * 基础动态查询 - 包含 LIKE/范围条件，显式使用 pageRequest 走 HQL + */ + public Page findUsers(String name, Integer minAge, String status) { + PageRequest request = PageRequest.of(0, 20); + if (name != null) { + request.addFilter("name", Relation.LIKE, name); + } + if (minAge != null) { + request.addFilter("age", Relation.GREATER_THAN_EQUAL, minAge); + } + if (status != null) { + request.addFilter("status", status); + } + return userRepository.pageRequest(request); + } + + /** + * 复杂 HQL 查询 - 带排序 + */ + public Page findActiveUsersWithSort() { + PageRequest request = PageRequest.of(0, 20, Sort.by("createTime").descending()); + request.addFilter("status", "active"); + request.addFilter("age", Relation.BETWEEN, 18, 65); + return userRepository.pageRequest(request); + } + + /** + * 前端驱动的通用查询接口 + */ + public Page searchFromHttpRequest() { + SearchRequest searchRequest = new SearchRequest(); + // 追加服务端安全条件，防止越权查询 + searchRequest.addFilter("deleted", false); + return userRepository.searchRequest(searchRequest); + } +} +``` + +### 内部工作原理 + +`FastRepository.findAll(PageRequest)` 的执行流程： + +1. 检查 `request.hasFilter()` — 无过滤条件时直接委托给 Spring Data 的标准 `findAll(PageRequest)` +2. 有过滤条件时，通过 `RequestFilter.isAllEqualFilter()` 判断是否全部为简单等值条件 +3. 全部等值条件：通过 `ExampleBuilder` 构建 `Example` 对象（按实体属性名匹配 Filter，取 `value[0]` 写入实体字段），传入 `findAll(Example, Pageable)` 执行查询 +4. 包含复杂条件（LIKE、范围、IN、NOT_EQUAL、IS_NULL、OR/AND 组合等）：自动转发 `pageRequest()`，由 `DynamicSQLBuilder` 构建参数化 HQL 执行查询 + +> 说明：`ExampleBuilder` 只处理 EQUAL 等值条件；过滤条件写入实体属性失败（如类型转换失败）时显式抛出 `IllegalStateException`，不再静默忽略。 + +`FastRepository.pageRequest(PageRequest)` 的执行流程： + +1. 通过 `DynamicSQLBuilder` 根据 Filter 列表动态构建 HQL 语句和 COUNT 语句 +2. 所有值通过参数化绑定（`?1`, `?2`...），防止 SQL 注入 +3. 调用 `dynamicPageQuery(hql, countHql, request, params)` 执行分页查询 diff --git a/docs/agents/capabilities/springboot-starter-script/groovy-runtime.md b/docs/agents/capabilities/springboot-starter-script/groovy-runtime.md new file mode 100644 index 000000000..01a3a383c --- /dev/null +++ b/docs/agents/capabilities/springboot-starter-script/groovy-runtime.md @@ -0,0 +1,157 @@ +--- +name: springboot-starter-script/groovy-runtime +module: springboot-starter-script +description: Groovy 脚本运行时引擎，支持运行时编译、LRU 缓存、热更新和 REST API +status: 已实现 +scope: 后端 +source: 框架:springboot-starter-script +import: "com.codingapi.springboot:springboot-starter-script" +framework_version: "8.2.0-SNAPSHOT" +--- + +## 解决什么问题 + +在企业应用中，部分业务逻辑需要频繁调整但不希望每次都经历"改代码→编译→部署"的完整周期。典型场景包括： + +- **动态规则计算**：促销折扣、费率计算、风控阈值等业务规则经常变化 +- **自定义报表/导出**：不同租户或部门的报表格式差异大，用脚本比硬编码更灵活 +- **临时数据处理**：运维脚本、数据修复等一次性任务 + +`groovy-runtime` 提供了嵌入式的 Groovy 脚本执行引擎，具备以下特性： + +- **运行时编译执行**：无需重启应用即可加载和执行新脚本 +- **LRU 编译缓存**：基于 SHA256 指纹缓存已编译的 Script 对象，避免重复编译开销 +- **三级存储**：内存缓存 → 临时存储 → 持久化仓库，兼顾性能和可靠性 +- **事务集成**：支持只读（READONLY）和提交（COMMIT）两种事务模式 +- **REST API**：内置 Controller 提供脚本编译、查询、保存接口，方便管理端对接 + +## 如何使用 + +### 核心组件 + +| 组件 | 职责 | +|------|------| +| `GroovyScriptRuntime` | 底层执行引擎：GroovyShell 封装、LRU 编译缓存、invoke/run 方法、事务控制 | +| `GroovyScriptRuntimeContext` | Runtime 的单例上下文，从配置读取 `shellMaxCacheSize` 初始化 | +| `GroovyScript` | 脚本领域对象：封装 key/script/method/returnType/binds 等元信息，提供 compile/run/invoke 快捷方法 | +| `GroovyScriptCacheContext` | 脚本对象的 LRU 缓存（最大 10240 条），三级查找：缓存 → 临时存储 → Repository | +| `GroovyScriptController` | REST 端点 `/api/groovy-script/*`，提供 compile/getScript/getMetadata/save 接口 | + +### 直接执行脚本 + +通过 `GroovyScriptRuntimeContext` 单例直接运行脚本： + +```java +GroovyScriptRuntimeContext ctx = GroovyScriptRuntimeContext.getInstance(); + +// 简单执行 +String result = ctx.run("'hello ' + name", String.class, + TransactionMode.DEFAULT, Map.of("name", "world")); + +// 调用脚本中的函数 +int sum = ctx.invoke("add", "def add(a,b){ a + b }", int.class, + TransactionMode.DEFAULT, null, 3, 5); +``` + +### 使用 GroovyScript 对象 + +对于需要持久化和复用的脚本，使用 `GroovyScript` 封装： + +```java +GroovyScript script = GroovyScript.builder("discount_calc") + .script(""" + def calculate(price, rate) { + return price * rate + } + """) + .method("calculate") + .returnType(BigDecimal.class) + .description("折扣计算脚本") + .tag("pricing") + .build(); + +// 编译并缓存 +script.compile(true); + +// 执行 +BigDecimal result = script.invoke(Map.of(), new BigDecimal("100"), new BigDecimal("0.85")); + +// 持久化到仓库 +script.save(); +``` + +### 事务模式 + +`TransactionMode` 支持三种模式： + +| 模式 | 行为 | +|------|------| +| `DEFAULT` | 不参与事务，由调用方自行控制 | +| `READONLY` | 在只读事务中执行，适合查询类脚本 | +| `COMMIT` | 在可提交事务中执行，适合写入类脚本 | + +### REST API + +内置的 `GroovyScriptController` 提供以下端点： + +| 方法 | 路径 | 说明 | +|------|------|------| +| POST | `/api/groovy-script/compile` | 编译脚本（body: `{script, cache}`) | +| GET | `/api/groovy-script/getScript?key=` | 获取脚本内容 | +| GET | `/api/groovy-script/getMetadata?key=` | 获取脚本元数据 | +| POST | `/api/groovy-script/save` | 保存脚本（编译+持久化） | + +## 使用实例 + +以下示例展示一个完整的动态折扣计算场景： + +```java +// 1. 创建并保存折扣计算脚本 +GroovyScript discountScript = GroovyScript.builder("member_discount") + .script(""" + def calcDiscount(amount, memberLevel) { + switch(memberLevel) { + case 'GOLD': return amount * 0.8 + case 'SILVER': return amount * 0.9 + default: return amount + } + } + """) + .method("calcDiscount") + .returnType(BigDecimal.class) + .description("会员折扣计算") + .typeOne("pricing") + .typeTwo("discount") + .build(); + +// 编译并持久化 +discountScript.compile(true); +discountScript.save(); + +// 2. 后续使用时直接从缓存获取 +GroovyScript cached = GroovyScriptCacheContext.getInstance() + .getGroovyScript("member_discount"); + +// 3. 执行业务计算 +BigDecimal originalAmount = new BigDecimal("500"); +BigDecimal finalPrice = cached.invoke( + TransactionMode.READONLY, null, originalAmount, "GOLD"); +// finalPrice = 400.0 + +// 4. 热更新：修改脚本后重新保存即可生效 +cached.setScript(""" + def calcDiscount(amount, memberLevel) { + switch(memberLevel) { + case 'DIAMOND': return amount * 0.7 + case 'GOLD': return amount * 0.8 + case 'SILVER': return amount * 0.9 + default: return amount + } + } +"""); +cached.compile(true); +cached.save(); +// 下次 invoke 自动使用新版本 +``` + +缓存机制说明：`GroovyScriptRuntime` 内部以脚本内容的 SHA256 作为缓存 key，相同内容的脚本不会重复编译。当脚本内容变更后，SHA256 值改变，自动触发重新编译。LRU 策略确保内存占用可控，默认上限可通过配置项调整。 diff --git a/docs/agents/capabilities/springboot-starter-security/auth-gateway.md b/docs/agents/capabilities/springboot-starter-security/auth-gateway.md new file mode 100644 index 000000000..153bf91dd --- /dev/null +++ b/docs/agents/capabilities/springboot-starter-security/auth-gateway.md @@ -0,0 +1,195 @@ +--- +name: springboot-starter-security/auth-gateway +module: springboot-starter-security +description: 安全认证网关，支持 JWT 无状态认证和 Redis 有状态认证两种模式 +status: 已实现 +scope: 后端 +source: 框架:springboot-starter-security +import: "com.codingapi.springboot:springboot-starter-security" +framework_version: "8.2.0-SNAPSHOT" +--- + +## 解决什么问题 + +在企业级 Web 应用中，用户认证是安全体系的第一道防线。Spring Security 原生提供的表单登录和 Session 机制不适合前后端分离架构，开发者通常需要自行实现以下能力： + +- **Token 生命周期管理**：创建、解析、过期校验、自动续期 +- **多认证模式切换**：JWT 无状态模式适合微服务和移动端，Redis 有状态模式适合需要服务端主动踢人的管理后台 +- **登录流程定制**：在认证前后插入自定义逻辑（验证码校验、登录日志、额外业务数据注入等） +- **统一 JSON 响应**：认证成功/失败均返回标准 `Response` 格式，而非 Spring Security 默认的重定向或 HTML 页面 + +auth-gateway 将上述能力封装为开箱即用的安全网关层，通过 `TokenGateway` 策略接口抽象 Token 的创建与解析，配合 `MyLoginFilter`（登录拦截）和 `MyAuthenticationFilter`（请求鉴权拦截）两个 Servlet Filter，实现完整的认证闭环。开发者只需通过配置选择 JWT 或 Redis 模式，即可零代码获得生产级认证能力。 + +## 如何使用 + +### 1. 引入依赖 + +```xml + + com.codingapi.springboot + springboot-starter-security + +``` + +### 2. 选择认证模式 + +通过 `application.properties` 启用其中一种模式（二选一）： + +**JWT 无状态模式：** + +```properties +codingapi.security.jwt.enable=true +codingapi.security.jwt.secret-key=your-secret-key-must-be-at-least-32-chars +codingapi.security.jwt.valid-time=900000 # Token 有效期 15 分钟（毫秒） +codingapi.security.jwt.rest-time=600000 # 10 分钟后自动续期（毫秒） +``` + +**Redis 有状态模式：** + +```properties +codingapi.security.redis.enable=true +codingapi.security.redis.valid-time=900000 +codingapi.security.redis.rest-time=600000 +``` + +### 3. 配置安全策略 + +```properties +# 需要认证的 URL 模式（逗号分隔） +codingapi.security.authenticated-urls=/api/** + +# 免认证 URL 模式 +codingapi.security.ignore-urls=/open/**,/#/** + +# 登录接口地址 +codingapi.security.login-processing-url=/user/login + +# 登出接口地址 +codingapi.security.logout-url=/user/logout +``` + +### 4. 核心 API + +| 类 | 说明 | +|---|---| +| `TokenGateway` | Token 策略接口，提供 `create()` 和 `parser()` 方法。框架根据配置自动注入 `JWTTokenGatewayImpl` 或 `RedisTokenGatewayImpl` | +| `Token` | Token 数据对象，包含 username、authorities、extra、expireTime、remindTime 等字段，支持 `verify()` 过期校验和 `canRestToken()` 自动续期判断 | +| `TokenContext` | 线程安全的 Token 上下文工具类。`TokenContext.current()` 获取当前登录用户的 Token；`TokenContext.pushExtra()` / `getExtra()` 传递额外业务数据 | +| `SecurityLoginHandler` | 登录扩展点接口。实现 `preHandle()` 可在认证前做自定义校验；实现 `postHandle()` 可定制登录成功响应 | +| `AuthenticationTokenFilter` | 鉴权后扩展点接口。每次请求通过 Token 验证后回调，可用于刷新用户缓存等场景 | + +### 5. 自定义 UserDetailsService + +框架默认提供内存用户（admin/user），生产环境需自行实现： + +```java +@Service +public class CustomUserDetailsService implements UserDetailsService { + @Override + public UserDetails loadUserByUsername(String username) throws UsernameNotFoundException { + // 从数据库加载用户信息 + } +} +``` + +## 使用实例 + +### 示例 1：自定义登录处理器 + +在登录前校验验证码，登录后返回额外的用户信息： + +```java +@Component +public class CustomSecurityLoginHandler implements SecurityLoginHandler { + + @Override + public void preHandle(HttpServletRequest request, HttpServletResponse response, + LoginRequest loginRequest) throws Exception { + // 校验验证码 + String captcha = loginRequest.getString("captcha"); + if (captcha == null || !captchaService.verify(captcha)) { + throw new AuthenticationServiceException("验证码错误"); + } + } + + @Override + public LoginResponse postHandle(HttpServletRequest request, HttpServletResponse response, + LoginRequest loginRequest, UserDetails user, Token token) { + LoginResponse loginResponse = new LoginResponse(); + loginResponse.setToken(token.getToken()); + loginResponse.setUsername(token.getUsername()); + loginResponse.setAuthorities(token.getAuthorities()); + // 附加用户头像等信息 + Map data = new HashMap<>(); + data.put("avatar", "/static/avatar/default.png"); + loginResponse.setData(data); + return loginResponse; + } +} +``` + +### 示例 2：在业务代码中获取当前用户 + +```java +@RestController +@RequestMapping("/api/profile") +public class ProfileController { + + @GetMapping + public SingleResponse> getProfile() { + // 从 SecurityContext 获取当前 Token + Token token = TokenContext.current(); + String username = token.getUsername(); + List roles = token.getAuthorities(); + + // 解析 extra 中的自定义数据 + UserInfo extra = token.parseExtra(UserInfo.class); + + Map profile = new HashMap<>(); + profile.put("username", username); + profile.put("roles", roles); + profile.put("department", extra != null ? extra.getDepartment() : null); + return SingleResponse.of(profile); + } +} +``` + +### 示例 3：鉴权后刷新用户缓存 + +```java +@Component +public class CacheRefreshFilter implements AuthenticationTokenFilter { + + private final UserService userService; + + public CacheRefreshFilter(UserService userService) { + this.userService = userService; + } + + @Override + public void doFilter(HttpServletRequest request, HttpServletResponse response) + throws IOException, ServletException { + Token token = TokenContext.current(); + // 每次认证通过后刷新用户权限缓存 + userService.refreshPermissionCache(token.getUsername()); + } +} +``` + +### 前端调用示例 + +```javascript +// 登录 +const res = await fetch('/user/login', { + method: 'POST', + headers: { 'Content-Type': 'application/json' }, + body: JSON.stringify({ username: 'admin', password: 'admin' }) +}); +const { data } = await res.json(); +// data.token → 保存 Token + +// 携带 Token 访问受保护接口 +const profile = await fetch('/api/profile', { + headers: { 'Authorization': data.token } +}); +``` diff --git a/docs/agents/capabilities/springboot-starter/domain-proxy.md b/docs/agents/capabilities/springboot-starter/domain-proxy.md new file mode 100644 index 000000000..e2739e18b --- /dev/null +++ b/docs/agents/capabilities/springboot-starter/domain-proxy.md @@ -0,0 +1,126 @@ +--- +name: springboot-starter/domain-proxy +module: springboot-starter +description: 领域实体变更代理，通过 CGLIB 代理拦截实体字段变更并自动推送领域事件 +status: 已实现 +scope: 后端 +source: 框架:springboot-starter +import: "com.codingapi.springboot:springboot-starter" +framework_version: "8.2.0-SNAPSHOT" +--- + +## 解决什么问题 + +在 DDD（领域驱动设计）实践中，领域实体的状态变更需要产生对应的领域事件（创建、变更、删除、持久化），以便下游处理器执行副作用操作（如发送通知、更新缓存等）。然而手动在每个 setter 方法中编写事件推送代码存在以下痛点： + +1. **侵入性强**：每个实体类的修改方法都需要显式调用 `EventPusher.push()`，业务逻辑与事件机制耦合。 +2. **容易遗漏**：开发者可能忘记在某些字段变更后推送事件，导致数据不一致。 +3. **变更追踪困难**：无法自动获取字段的旧值与新值，手动记录增加出错风险。 +4. **嵌套对象变更不可见**：当实体包含子对象时，子对象字段的变更更难被感知和追踪。 + +`domain-proxy` 能力通过 CGLIB 动态代理透明地拦截实体方法调用，自动比较字段值变化并推送 `DomainChangeEvent`，同时提供完整的实体生命周期事件（创建、持久化、删除），让领域事件的发布对业务代码零侵入。 + +## 如何使用 + +### 核心组件 + +| 组件 | 说明 | +|------|------| +| `IDomain` | 领域实体标记接口，提供 `persist()` 和 `delete()` 默认方法，分别推送 `DomainPersistEvent` 和 `DomainDeleteEvent` | +| `DomainProxyFactory` | 静态工厂类，通过 `create(Class, Object... args)` 创建代理实例，同时自动推送 `DomainCreateEvent` | +| `DomainChangeInterceptor` | CGLIB `MethodInterceptor` 实现，拦截带参数的方法调用，对比执行前后字段值差异，自动推送 `DomainChangeEvent` | +| `DomainEvent` | 领域事件基类，携带实体引用、实体类型和时间戳 | +| `DomainCreateEvent` | 实体创建事件，由 `DomainProxyFactory.create()` 自动推送 | +| `DomainChangeEvent` | 实体字段变更事件，包含 `fieldName`、`oldValue`、`newValue` | +| `DomainDeleteEvent` | 实体删除事件，通过 `IDomain.delete()` 推送 | +| `DomainPersistEvent` | 实体持久化事件，通过 `IDomain.persist()` 推送 | + +### 使用步骤 + +1. **定义领域实体**：创建实体类并实现 `IDomain` 接口。实体类需要有公开的构造函数供代理工厂反射调用。 + +2. **通过工厂创建实例**：使用 `DomainProxyFactory.create(EntityClass.class, constructorArgs...)` 代替 `new` 关键字创建实体。工厂会自动创建 CGLIB 代理并推送 `DomainCreateEvent`。 + +3. **正常调用业务方法**：对代理对象调用任何带参数的方法后，拦截器会自动比较所有字段（包括嵌套对象）的值变化，若有变更则推送 `DomainChangeEvent`。 + +4. **触发生命周期事件**：在适当时机调用 `entity.persist()` 推送持久化事件，或调用 `entity.delete()` 推送删除事件。 + +5. **注册事件处理器**：编写 `IHandler`、`IHandler` 等处理器 Bean，框架会自动扫描并注册。 + +### 注意事项 + +- 代理仅拦截**带参数**的方法调用，无参方法（如 getter）不会触发变更检测。 +- 支持基本类型（String、数值、布尔、枚举等）的直接比较，以及嵌套对象的递归字段比较。 +- 事件推送通过 `EventPusher` 进入框架的事件系统，遵循同步/异步分发和循环检测机制。 + +## 使用实例 + +### 定义领域实体 + +```java +public class User implements IDomain { + + @Getter + private final long id; + + @Getter + private String name; + + @Getter + private String email; + + public User(String name, String email) { + this.id = System.currentTimeMillis(); + this.name = name; + this.email = email; + } + + public void changeName(String name) { + this.name = name; + } + + public void changeEmail(String email) { + this.email = email; + } +} +``` + +### 创建代理并触发事件 + +```java +// 通过工厂创建代理实例，自动推送 DomainCreateEvent +User user = DomainProxyFactory.create(User.class, "张三", "zhangsan@example.com"); + +// 调用带参方法后，拦截器自动检测字段变更并推送 DomainChangeEvent +user.changeName("李四"); // → DomainChangeEvent(fieldName="name", oldValue="张三", newValue="李四") +user.changeEmail("li@example.com"); // → DomainChangeEvent(fieldName="email", ...) + +// 手动触发持久化事件 +user.persist(); // → DomainPersistEvent + +// 手动触发删除事件 +user.delete(); // → DomainDeleteEvent +``` + +### 编写事件处理器 + +```java +@Component +public class UserChangeHandler implements IHandler { + + @Override + public void handler(DomainChangeEvent event) { + log.info("用户字段变更: {} = {} → {}", + event.getFieldName(), event.getOldValue(), event.getNewValue()); + } +} + +@Component +public class UserCreateHandler implements IHandler { + + @Override + public void handler(DomainCreateEvent event) { + log.info("新用户创建: {}", event.getEntity().getClass().getSimpleName()); + } +} +``` diff --git a/docs/agents/capabilities/springboot-starter/event-system.md b/docs/agents/capabilities/springboot-starter/event-system.md new file mode 100644 index 000000000..f74099dd3 --- /dev/null +++ b/docs/agents/capabilities/springboot-starter/event-system.md @@ -0,0 +1,272 @@ +--- +name: springboot-starter/event-system +module: springboot-starter +description: 事件发布-订阅系统，支持同步/异步事件、事件循环检测、事务事件 +status: 已实现 +scope: 后端 +source: 框架:springboot-starter +import: "com.codingapi.springboot:springboot-starter" +framework_version: "8.2.0-SNAPSHOT" +--- + +## 解决什么问题 + +在 DDD（领域驱动设计）架构中，领域事件是实现聚合间解耦、触发副作用的核心机制。然而在实际开发中，事件系统面临以下痛点： + +1. **事件与主业务事务的边界模糊**：开发者容易将事件处理与主业务强绑定，导致事务范围膨胀、性能下降。框架需要明确"事件对主业务可成功可失败"的设计原则。 +2. **同步与异步事件的区分困难**：部分场景要求事件在同一事务内同步执行（如数据校验），部分场景则需异步解耦（如发送通知）。手动管理线程池和执行模式增加复杂度。 +3. **事件循环调用风险**：当 Handler A 处理 EventX 时又推送了 EventY，而 EventY 的 Handler 又推送了 EventX，就会形成无限循环。缺乏自动检测机制会导致栈溢出或系统挂起。 +4. **多 Handler 执行的异常隔离**：同一事件可能被多个 Handler 订阅，某个 Handler 抛异常不应影响其他 Handler 的执行，同时需要收集所有异常统一上报。 +5. **Handler 注册与排序繁琐**：手动注册处理器、维护执行顺序的代码分散且易出错。 + +本模块提供了一套完整的发布-订阅事件基础设施，通过 `EventPusher` 统一入口、`IEvent` 类型体系区分同步/异步、`EventTraceContext` + `EventStackContext` 实现事件链路追踪与循环检测、`ApplicationHandlerUtils` 自动匹配并按序分发 Handler，以及可选的事务提交后触发模式（`SpringTransactionEventHandler`）。 + +## 如何使用 + +### 核心接口 + +| 接口/类 | 说明 | +|---------|------| +| `IEvent` | 事件标记接口，继承 `Serializable`。默认视为同步事件 | +| `ISyncEvent` | 同步事件标记接口，继承 `IEvent`。事件在当前线程同步执行 | +| `IAsyncEvent` | 异步事件标记接口，继承 `IEvent`。事件在线程池中异步执行 | +| `IHandler` | 事件处理器接口，泛型 `T` 指定订阅的事件类型 | +| `EventPusher` | 事件推送静态工具类，是发布事件的唯一入口 | +| `@Handler` | 注解，标记一个类为事件处理器 Bean（也可使用 `@Component`/`@Service`） | + +### IHandler 接口方法 + +```java +public interface IHandler { + // 执行顺序，数值越小越先执行，默认为 0 + default int order() { return 0; } + + // 事件处理逻辑 + void handler(T event); + + // 异常回调，默认重新抛出异常（阻止后续 Handler 执行） + // 可覆盖此方法实现异常吞没或自定义处理 + default void error(Exception exception) throws Exception { + throw exception; + } +} +``` + +### 事件推送 + +```java +// 推送事件（自动根据 IEvent 子接口判断同步/异步） +EventPusher.push(new MyEvent(data)); + +// 显式声明允许循环事件（跳过循环检测） +EventPusher.push(new MyEvent(data), true); +``` + +事件类型的判定规则： +- 实现 `IAsyncEvent` → 异步执行（线程池） +- 实现 `ISyncEvent` → 同步执行（当前线程） +- 仅实现 `IEvent` → 默认同步执行 + +### 配置项 + +```properties +# 启用事务事件模式（事件在事务提交后触发） +codingapi.framework.event.transaction.enable=true + +# 异步事件线程池大小（默认值 20） +codingapi.framework.handler-thread-pool-size=20 +``` + +### 事件分发模式 + +框架通过 `SpringHandlerConfiguration` 自动装配事件分发器： + +- **默认模式**（`SpringDefaultEventHandler`）：使用 Spring `@EventListener` 即时触发，同步事件在当前线程执行，异步事件提交到固定大小线程池。 +- **事务模式**（`SpringTransactionEventHandler`）：当配置 `codingapi.framework.event.transaction.enable=true` 时激活，使用 `@TransactionalEventListener(phase = AFTER_COMMIT)` 确保事件在事务提交后才触发，避免读取到未提交的数据。设置 `fallbackExecution = true` 保证无事务上下文时也能正常执行。 + +两种模式互斥，事务模式优先（`@ConditionalOnMissingBean` 兜底默认模式）。 + +### 事件循环检测 + +框架通过 `EventTraceContext` 和 `EventStackContext` 实现同一条事件链路内的循环检测： + +1. 每次推送事件时生成/复用 traceId，将事件类压入该 traceId 对应的事件栈。 +2. 若同一 traceId 下出现相同事件类，立即抛出 `EventLoopException`，并附带完整的事件调用栈信息。 +3. 事件处理完成后自动清理 traceId 和事件栈。 +4. 若确实需要允许循环（如状态机重试），可调用 `EventPusher.push(event, true)` 跳过检测。 + +### Handler 异常处理策略 + +当某个 Handler 抛出异常时： +1. 若异常为 `EventLoopException`，直接向上抛出，终止后续所有 Handler。 +2. 否则调用该 Handler 的 `error(exception)` 回调。 +3. 若 `error()` 也抛出异常，标记为"有异常"并继续执行下一个 Handler。 +4. 所有 Handler 执行完毕后，若存在异常，统一包装为 `EventException` 抛出。 + +## 使用实例 + +### 1. 定义事件 + +```java +package com.example.domain.order.event; + +import com.codingapi.springboot.framework.event.ISyncEvent; +import lombok.Getter; +import lombok.AllArgsConstructor; + +/** + * 订单创建事件（同步） + */ +@Getter +@AllArgsConstructor +public class OrderCreatedEvent implements ISyncEvent { + private final String orderId; + private final String userId; + private final long amount; +} +``` + +```java +package com.example.domain.order.event; + +import com.codingapi.springboot.framework.event.IAsyncEvent; +import lombok.Getter; +import lombok.AllArgsConstructor; + +/** + * 订单通知事件（异步） + */ +@Getter +@AllArgsConstructor +public class OrderNotifyEvent implements IAsyncEvent { + private final String orderId; + private final String message; +} +``` + +### 2. 编写事件处理器 + +```java +package com.example.handler; + +import com.codingapi.springboot.framework.event.IHandler; +import com.example.domain.order.event.OrderCreatedEvent; +import lombok.extern.slf4j.Slf4j; +import org.springframework.stereotype.Service; + +/** + * 订单创建后扣减库存（优先执行） + */ +@Slf4j +@Service +public class InventoryDeductHandler implements IHandler { + + @Override + public int order() { + return 1; // 最先执行 + } + + @Override + public void handler(OrderCreatedEvent event) { + log.info("扣减库存, orderId={}, amount={}", event.getOrderId(), event.getAmount()); + // inventoryService.deduct(event.getOrderId(), event.getAmount()); + } +} +``` + +```java +package com.example.handler; + +import com.codingapi.springboot.framework.event.IHandler; +import com.example.domain.order.event.OrderCreatedEvent; +import lombok.extern.slf4j.Slf4j; +import org.springframework.stereotype.Service; + +/** + * 订单创建后记录积分（其次执行） + */ +@Slf4j +@Service +public class PointsRecordHandler implements IHandler { + + @Override + public int order() { + return 2; + } + + @Override + public void handler(OrderCreatedEvent event) { + log.info("记录积分, userId={}", event.getUserId()); + // pointsService.record(event.getUserId(), event.getAmount()); + } + + @Override + public void error(Exception exception) { + // 积分记录失败不影响其他 Handler，仅记录日志 + log.error("积分记录失败, 但不阻断流程", exception); + } +} +``` + +```java +package com.example.handler; + +import com.codingapi.springboot.framework.event.IHandler; +import com.example.domain.order.event.OrderNotifyEvent; +import lombok.extern.slf4j.Slf4j; +import org.springframework.stereotype.Service; + +/** + * 异步发送订单通知 + */ +@Slf4j +@Service +public class OrderNotifyHandler implements IHandler { + + @Override + public void handler(OrderNotifyEvent event) { + log.info("发送通知, orderId={}, message={}", event.getOrderId(), event.getMessage()); + // notificationService.send(event.getOrderId(), event.getMessage()); + } +} +``` + +### 3. 在领域服务中推送事件 + +```java +package com.example.domain.order.service; + +import com.codingapi.springboot.framework.event.EventPusher; +import com.example.domain.order.event.OrderCreatedEvent; +import com.example.domain.order.event.OrderNotifyEvent; +import org.springframework.stereotype.Service; +import org.springframework.transaction.annotation.Transactional; + +@Service +public class OrderService { + + @Transactional + public String createOrder(String userId, long amount) { + String orderId = generateOrderId(); + // ... 持久化订单实体 ... + + // 同步事件：在当前事务内执行库存扣减、积分记录 + EventPusher.push(new OrderCreatedEvent(orderId, userId, amount)); + + // 异步事件：事务外异步发送通知 + EventPusher.push(new OrderNotifyEvent(orderId, "您的订单已创建")); + + return orderId; + } +} +``` + +### 4. 启用事务事件模式（可选） + +若希望所有事件都在事务提交后再触发（避免 Handler 读到未提交数据），在 `application.properties` 中添加： + +```properties +codingapi.framework.event.transaction.enable=true +``` + +此时 `SpringTransactionEventHandler` 替代默认的 `SpringDefaultEventHandler`，所有事件将在 `AFTER_COMMIT` 阶段触发。 diff --git a/docs/agents/capabilities/springboot-starter/exception-handling.md b/docs/agents/capabilities/springboot-starter/exception-handling.md new file mode 100644 index 000000000..dff6a9b56 --- /dev/null +++ b/docs/agents/capabilities/springboot-starter/exception-handling.md @@ -0,0 +1,139 @@ +--- +name: springboot-starter/exception-handling +module: springboot-starter +description: 全局异常处理，统一拦截 Controller 层异常并返回标准 Response +status: 已实现 +scope: 后端 +source: 框架:springboot-starter +import: "com.codingapi.springboot:springboot-starter" +framework_version: "8.2.0-SNAPSHOT" +--- + +## 解决什么问题 + +在 Spring MVC 项目中，Controller 层抛出的异常如果不做统一处理，会导致以下问题： + +- **响应格式不一致**：不同接口返回的错误结构各异（有的返回 HTML 错误页、有的返回纯文本、有的返回自定义 JSON），前端难以统一解析。 +- **错误码缺失**：原生异常只有 message，没有业务错误码（errCode），前端无法根据错误码做多语言提示或差异化逻辑。 +- **国际化困难**：错误信息硬编码在代码中，无法根据用户 Locale 动态切换语言。 +- **敏感信息泄露**：未捕获的异常可能将堆栈信息直接暴露给客户端。 + +`springboot-starter` 的异常处理能力通过 `HandlerExceptionResolver` 机制，在 Servlet 层面统一拦截所有 Controller 异常，将其转换为标准的 `{success, errCode, errMessage}` JSON 响应，同时结合 `LocaleMessageException` 和 `MessageSource` 实现错误信息的国际化管理。 + +## 如何使用 + +### 自动生效 + +引入 `springboot-starter` 依赖后，异常处理自动配置即可生效，无需额外注解或配置： + +```xml + + com.codingapi.springboot + springboot-starter + +``` + +框架通过以下两个配置类自动注册： + +- **`ExceptionConfiguration`**：注册 `LocaleMessage` Bean，绑定 Spring `MessageSource`，在初始化时将自身注入 `MessageContext` 单例，为 `LocaleMessageException` 提供国际化消息解析能力。 +- **`BasicHandlerExceptionResolverConfiguration`**：当 classpath 中存在 `HandlerExceptionResolver`（即 Spring MVC 环境）时，注册 `ServletExceptionHandler` 作为全局异常解析器。 + +### 异常类型与响应映射 + +| 异常类型 | errCode | errMessage | 说明 | +|---------|---------|------------|------| +| `LocaleMessageException` | 异常中指定的 errCode | 国际化解析后的消息 | 业务异常，推荐使用 | +| 其他 `Exception` | `system.err` | `ex.getMessage()` | 未预期的系统异常 | + +### 抛出业务异常 + +在 Service 或 Controller 中抛出 `LocaleMessageException`，支持三种构造方式： + +```java +// 1. 直接使用错误码（从 messages.properties 中解析消息） +throw new LocaleMessageException("user.not.found"); + +// 2. 错误码 + 占位符参数 +throw LocaleMessageException.of("order.amount.exceed", maxAmount); + +// 3. 错误码 + 自定义消息（不走国际化） +throw new LocaleMessageException("custom.error", "自定义错误描述"); +``` + +### 配置国际化消息 + +在 `src/main/resources/messages.properties`（及对应的多语言文件）中定义错误消息： + +```properties +# messages.properties +user.not.found=用户不存在 +order.amount.exceed=订单金额超出限制，最大金额为 {0} + +# messages_en.properties +user.not.found=User not found +order.amount.exceed=Order amount exceeds limit, maximum is {0} +``` + +## 使用实例 + +### 完整示例：Controller 中抛出业务异常 + +```java +@RestController +@RequestMapping("/api/users") +public class UserController { + + @Autowired + private UserService userService; + + @GetMapping("/{id}") + public SingleResponse getUser(@PathVariable Long id) { + User user = userService.findById(id); + if (user == null) { + // 抛出国际化业务异常 + throw new LocaleMessageException("user.not.found"); + } + return SingleResponse.of(user); + } + + @PostMapping + public Response createUser(@RequestBody CreateUserRequest request) { + if (request.getAmount().compareTo(MAX_AMOUNT) > 0) { + // 带占位符参数的异常 + throw LocaleMessageException.of("order.amount.exceed", MAX_AMOUNT); + } + userService.create(request); + return Response.buildSuccess(); + } +} +``` + +当请求触发异常时，框架自动返回统一格式的 JSON 响应： + +```json +{ + "success": false, + "errCode": "user.not.found", + "errMessage": "用户不存在" +} +``` + +若当前请求的 Locale 为英文，则自动返回： + +```json +{ + "success": false, + "errCode": "user.not.found", + "errMessage": "User not found" +} +``` + +对于未预期的系统异常（如 NullPointerException），返回： + +```json +{ + "success": false, + "errCode": "system.err", + "errMessage": "Cannot invoke method on null object" +} +``` diff --git a/docs/agents/capabilities/springboot-starter/locale-message.md b/docs/agents/capabilities/springboot-starter/locale-message.md new file mode 100644 index 000000000..b579a06c9 --- /dev/null +++ b/docs/agents/capabilities/springboot-starter/locale-message.md @@ -0,0 +1,117 @@ +--- +name: springboot-starter/locale-message +module: springboot-starter +description: 国际化异常消息，支持多语言异常信息和本地化消息解析 +status: 已实现 +scope: 后端 +source: 框架:springboot-starter +import: "com.codingapi.springboot:springboot-starter" +framework_version: "8.2.0-SNAPSHOT" +--- + +## 解决什么问题 + +在企业级应用中，异常消息往往需要面向不同语言和地区的用户展示本地化内容。直接在代码中硬编码中文或英文错误提示存在以下痛点： + +- **多语言维护困难**：错误消息散落在业务代码各处，新增语言时需要逐一修改源码。 +- **异常与消息耦合**：`RuntimeException` 只接受字符串消息，无法携带错误码进行统一拦截和翻译。 +- **占位符参数化缺失**：部分错误消息需要动态插入变量（如用户名、金额），拼接字符串容易出错且不利于翻译。 + +`locale-message` 能力通过 `LocaleMessageException` + Spring `MessageSource` 的组合，将错误码作为异常的语义标识，在抛出时自动根据当前请求的 `Locale` 从 `messages.properties` 资源文件中解析出对应的本地化消息，从而实现异常消息与业务代码的解耦和多语言支持。 + +## 如何使用 + +### 核心组件 + +| 类 | 职责 | +|----|------| +| `LocaleMessageException` | 国际化异常，支持仅传错误码、错误码+占位符参数、错误码+自定义消息等多种构造方式 | +| `LocaleMessage` | 封装 Spring `MessageSource`，提供按 code + args + locale 解析消息的能力 | +| `MessageContext` | 单例上下文，持有 `LocaleMessage` 实例，供异常类在静态上下文中获取本地化消息 | + +### 配置消息资源文件 + +在 `src/main/resources/` 下创建标准 Spring 消息资源文件： + +```properties +# messages.properties（默认/回退） +error.user.not.found=User not found: {0} +error.param.invalid=Invalid parameter: {0}, expected {1} + +# messages_zh_CN.properties +error.user.not.found=用户不存在: {0} +error.param.invalid=参数无效: {0}，期望值 {1} +``` + +Spring Boot 会自动加载这些文件作为 `MessageSource`。 + +### 抛出国际化异常 + +`LocaleMessageException` 提供多种构造方式和静态工厂方法： + +```java +// 1. 仅传错误码 —— 自动从 messages.properties 解析消息 +throw new LocaleMessageException("error.user.not.found"); + +// 2. 错误码 + 占位符参数 +throw LocaleMessageException.of("error.user.not.found", "zhangsan"); + +// 3. 错误码 + 多个占位符参数 +throw LocaleMessageException.of("error.param.invalid", "age", "Integer"); + +// 4. 错误码 + 自定义消息（不走 MessageSource） +throw new LocaleMessageException("ERR_CUSTOM", "自定义错误消息"); + +// 5. 携带原始异常 +throw new LocaleMessageException("error.user.not.found", cause); +``` + +### 自动装配 + +框架启动时，`LocaleMessage` Bean 会被创建并调用 `init()` 方法，将自身注册到 `MessageContext` 单例中。`LocaleMessageException` 在构造时通过 `MessageContext.getInstance().getErrorMsg(errCode, args)` 获取本地化消息，整个过程对业务代码透明，无需手动注入任何 Bean。 + +当前请求的 `Locale` 由 Spring 的 `LocaleContextHolder` 提供（通常通过 `Accept-Language` 请求头或 `LocaleChangeInterceptor` 设置）。 + +## 使用实例 + +### 完整示例：用户查询服务 + +```java +@Service +public class UserService { + + @Autowired + private UserRepository userRepository; + + public User getUser(String username) { + return userRepository.findByUsername(username) + .orElseThrow(() -> + LocaleMessageException.of("error.user.not.found", username) + ); + } + + public void updateUserAge(String username, int age) { + if (age < 0 || age > 150) { + throw LocaleMessageException.of("error.param.invalid", "age", "0~150"); + } + // ... + } +} +``` + +当客户端发送 `Accept-Language: zh-CN` 请求时，若用户不存在，返回的异常消息为 `"用户不存在: zhangsan"`；若未指定语言或使用默认 locale，则返回 `"User not found: zhangsan"`。 + +### 在全局异常处理器中统一捕获 + +```java +@RestControllerAdvice +public class GlobalExceptionHandler { + + @ExceptionHandler(LocaleMessageException.class) + public Response handleLocaleException(LocaleMessageException e) { + return Response.buildFailure(e.getErrCode(), e.getErrMessage()); + } +} +``` + +由于异常对象已经携带了本地化后的 `errMessage`，全局处理器只需直接提取即可，无需再做二次翻译。 diff --git a/docs/agents/capabilities/springboot-starter/page-request.md b/docs/agents/capabilities/springboot-starter/page-request.md new file mode 100644 index 000000000..a9ac94118 --- /dev/null +++ b/docs/agents/capabilities/springboot-starter/page-request.md @@ -0,0 +1,177 @@ +--- +name: springboot-starter/page-request +module: springboot-starter +description: 动态分页查询请求，扩展 Spring PageRequest 支持 RequestFilter 动态过滤条件 +status: 已实现 +scope: 后端 +source: 框架:springboot-starter +import: "com.codingapi.springboot:springboot-starter" +framework_version: "8.2.0-SNAPSHOT" +--- + +## 解决什么问题 + +在企业级后台管理系统中，列表查询是最常见的业务场景之一。Spring Data 原生的 `PageRequest` 仅支持分页参数（页码、大小、排序），无法携带动态过滤条件。开发者通常需要为每个查询接口手动编写 Specification、QueryDSL 或自定义 HQL，导致大量重复的查询构建代码。 + +`PageRequest` 能力解决了以下痛点： + +- **动态过滤**：在分页请求对象上直接附加任意字段、任意比较关系的过滤条件，无需为每种查询组合编写独立方法。 +- **前端驱动查询**：通过 `SearchRequest` 自动解析 HTTP 请求参数（包括 Base64 编码的 `filter`、`sort`、`params` JSON），将前端传入的筛选/排序规则转换为类型安全的过滤条件，减少 Controller 层样板代码。 +- **复杂条件组合**：支持 AND/OR 嵌套组合过滤，满足多条件联合查询需求。 +- **与 FastRepository 无缝集成**：`FastRepository.findAll(PageRequest)` 和 `pageRequest(PageRequest)` 自动根据过滤条件构建 Example 或 HQL 查询，开发者只需关注业务逻辑。 + +## 如何使用 + +### 核心类说明 + +| 类 | 职责 | +|---|------| +| `PageRequest` | 继承 Spring `PageRequest`，增加 `RequestFilter` 和链式 `addFilter` API | +| `RequestFilter` | 过滤条件容器，管理 `Filter` 列表并提供按 key 读取过滤值的快捷方法 | +| `Filter` | 单个过滤条件，包含字段名（key）、比较关系（Relation）和值 | +| `Relation` | 枚举，定义了 14 种比较关系：EQUAL、NOT_EQUAL、LIKE、LEFT_LIKE、RIGHT_LIKE、BETWEEN、IN、NOT_IN、IS_NULL、IS_NOT_NULL、GREATER_THAN、LESS_THAN、GREATER_THAN_EQUAL、LESS_THAN_EQUAL | +| `SearchRequest` | 从当前 `HttpServletRequest` 自动解析分页、排序、过滤参数并生成 `PageRequest` | + +### 创建 PageRequest + +```java +// 基本分页（第 0 页，每页 20 条） +PageRequest request = PageRequest.of(0, 20); + +// 带排序 +PageRequest request = PageRequest.of(0, 20, Sort.by("createTime").descending()); +``` + +### 添加过滤条件 + +```java +// 等值过滤（默认 EQUAL） +request.addFilter("name", "张三"); + +// 指定比较关系 +request.addFilter("age", Relation.GREATER_THAN, 18); +request.addFilter("createTime", Relation.BETWEEN, startDate, endDate); +request.addFilter("status", Relation.IN, "ACTIVE", "PENDING"); + +// AND / OR 组合 +request.andFilter( + Filter.as("deptId", 1), + Filter.as("roleId", 2) +); + +request.orFilters( + Filter.as("name", Relation.LIKE, "张"), + Filter.as("email", Relation.LIKE, "zhang") +); +``` + +### 读取过滤值 + +```java +String name = request.getStringFilter("name"); +int age = request.getIntFilter("age", 0); +boolean hasConditions = request.hasFilter(); +``` + +### 配合 FastRepository 使用 + +```java +// findAll — 简单过滤走 Example 查询 +Page page = userRepository.findAll(request); + +// pageRequest — 复杂过滤走 HQL 动态查询 +Page page = userRepository.pageRequest(request); + +// searchRequest — 从 HTTP 请求自动解析 +Page page = userRepository.searchRequest(searchRequest); +``` + +### SearchRequest 自动解析 + +`SearchRequest` 从当前 HTTP 请求中提取以下参数： + +| 参数 | 格式 | 说明 | +|------|------|------| +| `current` | int | 页码（从 0 开始） | +| `pageSize` | int | 每页大小 | +| `sort` | Base64(JSON) | 排序规则，如 `{"createTime":"descend"}` | +| `filter` | Base64(JSON) | 过滤条件，如 `{"status":["ACTIVE"]}` | +| `params` | Base64(JSON Array) | 指定字段的比较关系，如 `[{"key":"age","type":"GREATER_THAN"}]` | +| 其他参数 | string | 作为 EQUAL 过滤条件自动添加 | + +## 使用实例 + +### 示例 1：Service 层手动构建动态查询 + +```java +@Service +public class UserQueryService { + + @Autowired + private UserRepository userRepository; + + public Page searchUsers(String keyword, Integer minAge, String status) { + PageRequest request = PageRequest.of(0, 20); + request.addSort(Sort.by("createTime").descending()); + + if (keyword != null) { + request.addFilter("name", Relation.LIKE, keyword); + } + if (minAge != null) { + request.addFilter("age", Relation.GREATER_THAN_EQUAL, minAge); + } + if (status != null) { + request.addFilter("status", status); + } + + return userRepository.findAll(request); + } +} +``` + +### 示例 2：Controller 层使用 SearchRequest 自动绑定 + +```java +@RestController +@RequestMapping("/api/users") +public class UserController { + + @Autowired + private UserRepository userRepository; + + @GetMapping + public MultiResponse list(SearchRequest searchRequest) { + // 自动从 HTTP 参数解析 current、pageSize、sort、filter + Page page = userRepository.searchRequest(searchRequest); + return MultiResponse.of(page.getContent(), (int) page.getTotalElements()); + } +} +``` + +前端请求示例： +``` +GET /api/users?current=0&pageSize=20 + &sort=eyJjcmVhdGVUaW1lIjoiZGVzY2VuZCJ9 + &filter=eyJzdGF0dXMiOlsiQUNUSVZFIiwiUEVORElORyJdfQ== + ¶ms=W3sia2V5IjoiYWdlIiwidHlwZSI6IkdSRUFURVJfVEhBTiJ9XQ== + &deptId=1 +``` + +其中 `filter` 解码后为 `{"status":["ACTIVE","PENDING"]}`，`params` 解码后为 `[{"key":"age","type":"GREATER_THAN"}]`，`deptId` 作为额外 EQUAL 条件自动加入。 + +### 示例 3：AND/OR 组合过滤 + +```java +PageRequest request = PageRequest.of(0, 20); + +// (deptId=1 AND roleId=2) OR (name LIKE '%admin%') +request.orFilters( + Filter.and( + Filter.as("deptId", 1), + Filter.as("roleId", 2) + ), + Filter.as("name", Relation.LIKE, "admin") +); + +Page page = userRepository.pageRequest(request); +``` diff --git a/docs/agents/capabilities/springboot-starter/response-dto.md b/docs/agents/capabilities/springboot-starter/response-dto.md new file mode 100644 index 000000000..53777921c --- /dev/null +++ b/docs/agents/capabilities/springboot-starter/response-dto.md @@ -0,0 +1,172 @@ +--- +name: springboot-starter/response-dto +module: springboot-starter +description: 统一响应封装，提供 Response/SingleResponse/MultiResponse/MapResponse 四种响应类型 +status: 已实现 +scope: 后端 +source: 框架:springboot-starter +import: "com.codingapi.springboot:springboot-starter" +framework_version: "8.2.0-SNAPSHOT" +--- + +## 解决什么问题 + +在企业级 REST API 开发中，前后端交互需要统一的响应契约。若每个接口各自定义返回结构，会导致以下问题： + +- **前端解析复杂**：不同接口的成功/失败字段命名不一致，前端需逐接口适配 +- **错误处理分散**：缺乏统一的 `errCode` / `errMessage` 规范，全局异常拦截难以标准化 +- **分页结构不统一**：列表接口的总数、数据字段名各异，通用分页组件无法复用 +- **序列化行为不可控**：响应对象在缓存、消息队列等场景下需要可靠的 JSON 序列化能力 + +`response-dto` 提供了四种标准响应类型，覆盖无数据、单对象、列表/分页、键值对四类返回场景，使所有 API 输出遵循同一契约。基类 `Response` 实现了 `JsonSerializable` 接口，支持通过 Fastjson 进行一致的 JSON 序列化。 + +## 如何使用 + +### 类层次结构 + +``` +JsonSerializable (interface) + └── Response — 基础响应（success / errCode / errMessage） + ├── SingleResponse — 单对象响应，data 字段为泛型 T + ├── MultiResponse — 列表响应，data 字段包含 total + list + └── MapResponse — 键值对响应，data 字段为 Map +``` + +### 核心 API + +| 类 | 静态工厂方法 | 说明 | +|---|---|---| +| `Response` | `buildSuccess()` | 构建成功响应（无业务数据） | +| `Response` | `buildFailure(errCode, errMessage)` | 构建失败响应 | +| `SingleResponse` | `of(T data)` | 包装单个业务对象 | +| `SingleResponse` | `empty()` | 返回 data=null 的成功响应 | +| `MultiResponse` | `of(Collection data, long total)` | 包装集合 + 总数 | +| `MultiResponse` | `of(Page page)` | 直接包装 Spring Data Page 对象 | +| `MultiResponse` | `of(Collection data)` | 包装集合，total 自动取 size | +| `MultiResponse` | `empty()` | 返回空列表的成功响应 | +| `MapResponse` | `create()` | 创建空的键值对响应 | +| `MapResponse` | `empty()` | 返回 data=null 的键值对响应 | +| `MapResponse` | `add(key, value)` | 链式添加键值对 | + +### JSON 序列化 + +所有响应类均继承自 `Response`，而 `Response` 实现了 `JsonSerializable` 接口，可直接调用 `toJson()` 方法获取 JSON 字符串： + +```java +String json = response.toJson(); // 使用 Fastjson 序列化 +``` + +### Maven 依赖 + +```xml + + com.codingapi.springboot + springboot-starter + +``` + +## 使用实例 + +### 1. 无数据的操作响应 + +```java +@PostMapping("/save") +public Response save(@RequestBody UserRequest request) { + userService.save(request); + return Response.buildSuccess(); +} +``` + +返回 JSON： +```json +{ "success": true, "errCode": null, "errMessage": null } +``` + +### 2. 返回单个对象 + +```java +@GetMapping("/detail") +public SingleResponse detail(@RequestParam Long id) { + UserVO user = userQueryService.getById(id); + return SingleResponse.of(user); +} +``` + +返回 JSON： +```json +{ + "success": true, + "errCode": null, + "errMessage": null, + "data": { "id": 1, "name": "张三", "email": "zhangsan@example.com" } +} +``` + +### 3. 返回列表（含分页） + +```java +@GetMapping("/list") +public MultiResponse list(SearchRequest searchRequest) { + Page page = userQueryService.page(searchRequest); + return MultiResponse.of(page); +} +``` + +返回 JSON： +```json +{ + "success": true, + "errCode": null, + "errMessage": null, + "data": { + "total": 100, + "list": [ + { "id": 1, "name": "张三" }, + { "id": 2, "name": "李四" } + ] + } +} +``` + +### 4. 返回键值对数据 + +```java +@GetMapping("/dashboard/stats") +public MapResponse dashboardStats() { + return MapResponse.create() + .add("userCount", 1024) + .add("orderCount", 5678) + .add("todayRevenue", 99800.50); +} +``` + +返回 JSON： +```json +{ + "success": true, + "errCode": null, + "errMessage": null, + "data": { + "userCount": 1024, + "orderCount": 5678, + "todayRevenue": 99800.50 + } +} +``` + +### 5. 返回错误响应 + +```java +@PostMapping("/login") +public Response login(@RequestBody LoginRequest request) { + if (!userService.authenticate(request)) { + return Response.buildFailure("AUTH_FAILED", "用户名或密码错误"); + } + return Response.buildSuccess(); +} +``` + +返回 JSON： +```json +{ "success": false, "errCode": "AUTH_FAILED", "errMessage": "用户名或密码错误" } +``` diff --git a/docs/agents/capabilities/springboot-starter/rest-client.md b/docs/agents/capabilities/springboot-starter/rest-client.md new file mode 100644 index 000000000..fd76ad27d --- /dev/null +++ b/docs/agents/capabilities/springboot-starter/rest-client.md @@ -0,0 +1,108 @@ +--- +name: springboot-starter/rest-client +module: springboot-starter +description: REST 客户端封装，提供 RestTemplate 上下文管理和 HTTPS 信任所有证书支持 +status: 已实现 +scope: 后端 +source: 框架:springboot-starter +import: "com.codingapi.springboot:springboot-starter" +framework_version: "8.2.0-SNAPSHOT" +--- + +## 解决什么问题 + +在企业内部系统集成和第三方 API 对接场景中，经常需要调用外部 HTTPS 服务。这些服务的证书可能由私有 CA 签发、已过期或主机名不匹配，导致标准 HTTP 客户端抛出 SSL 握手异常。同时，项目中多处使用 `RestTemplate` 时，如果每次都手动创建实例并配置底层 HttpClient，会导致代码重复且难以统一维护。 + +本能力通过两个核心类解决上述问题： + +- **TrustAnyHttpClientFactory** — 创建信任所有证书的 Apache HttpClient 5 实例，跳过服务端证书校验和主机名验证，适用于开发调试及内网可信环境下的 HTTPS 调用。 +- **RestTemplateContext** — 以单例模式持有预配置好的 `RestTemplate`（底层使用 TrustAnyHttpClientFactory），为全应用提供统一的 REST 客户端访问入口，避免重复创建和配置。 + +## 如何使用 + +### 依赖引入 + +在 Maven 项目中添加 springboot-starter 依赖即可： + +```xml + + com.codingapi.springboot + springboot-starter + +``` + +### 获取 RestTemplate 实例 + +通过 `RestTemplateContext` 的单例方法获取已配置好 HTTPS 信任策略的 `RestTemplate`： + +```java +RestTemplate restTemplate = RestTemplateContext.getInstance().getRestTemplate(); +``` + +该实例底层使用 Apache HttpComponents 5 作为传输层，并已启用以下特性： + +- TLS 协议下信任所有服务端证书（`TrustAnyTrustManager`） +- 禁用主机名验证（`NoopHostnameVerifier`） +- 允许循环重定向 + +### 自定义 ClientHttpRequestFactory + +如果需要替换默认的请求工厂，可以使用 `restTemplate(ClientHttpRequestFactory)` 方法创建新的 `RestTemplate` 实例： + +```java +ClientHttpRequestFactory customFactory = new HttpComponentsClientHttpRequestFactory(customHttpClient); +RestTemplate customTemplate = RestTemplateContext.getInstance().restTemplate(customFactory); +``` + +### 直接使用 TrustAnyHttpClientFactory + +若仅需创建信任所有证书的 HttpClient 而不使用 RestTemplateContext 封装，可直接调用静态工厂方法： + +```java +HttpClient httpClient = TrustAnyHttpClientFactory.createTrustAnyHttpClient(); +``` + +返回的 `HttpClient` 基于 Apache HttpClient 5，可用于任何需要绕过 SSL 校验的场景。 + +## 使用实例 + +### 示例 1：调用外部 HTTPS 接口 + +```java +@Service +public class ExternalApiService { + + private final RestTemplate restTemplate; + + public ExternalApiService() { + this.restTemplate = RestTemplateContext.getInstance().getRestTemplate(); + } + + public String fetchRemoteData(String url) { + ResponseEntity response = restTemplate.getForEntity(url, String.class); + return response.getBody(); + } + + public T postJson(String url, Object request, Class responseType) { + return restTemplate.postForObject(url, request, responseType); + } +} +``` + +### 示例 2：独立使用 TrustAnyHttpClientFactory + +```java +// 在不依赖 RestTemplateContext 的场景下，单独创建信任所有证书的 HttpClient +HttpClient httpClient = TrustAnyHttpClientFactory.createTrustAnyHttpClient(); + +// 配合 Spring 的 HttpComponentsClientHttpRequestFactory 构建自定义 RestTemplate +HttpComponentsClientHttpRequestFactory factory = + new HttpComponentsClientHttpRequestFactory(httpClient); +factory.setConnectTimeout(Duration.ofSeconds(5)); +factory.setReadTimeout(Duration.ofSeconds(30)); + +RestTemplate restTemplate = new RestTemplate(factory); +String result = restTemplate.getForObject("https://internal-api.example.com/data", String.class); +``` + +> ⚠️ **安全提示**：信任所有证书仅适用于开发调试和内网可信环境。在生产环境中应正确配置受信任的 CA 证书链，避免中间人攻击风险。 diff --git a/docs/agents/conventions/springboot-starter-data-fast/dynamic-query-convention.md b/docs/agents/conventions/springboot-starter-data-fast/dynamic-query-convention.md new file mode 100644 index 000000000..ec233f5dc --- /dev/null +++ b/docs/agents/conventions/springboot-starter-data-fast/dynamic-query-convention.md @@ -0,0 +1,152 @@ +--- +name: springboot-starter-data-fast/dynamic-query-convention +module: springboot-starter-data-fast +description: 动态查询规范，定义 PageRequest + RequestFilter + FastRepository 的使用模式 +status: 已实现 +scope: 后端 +source: 框架:springboot-starter-data-fast +import: "com.codingapi.springboot:springboot-starter-data-fast" +framework_version: "8.2.0-SNAPSHOT" +--- + +## 解决什么问题 + +在企业级应用中，列表查询往往需要根据前端传入的动态条件进行过滤。如果不遵守本规范，会导致以下问题： + +1. **SQL 注入风险**：在 Service 层手动拼接 SQL 字符串实现动态查询，极易引入 SQL 注入漏洞。 +2. **代码重复与维护困难**：每个实体的动态查询都手写 `if-else` 判断和原生 SQL，导致大量重复代码，新增过滤字段需修改多处。 +3. **分页逻辑不一致**：各模块自行处理分页参数（偏移量计算、排序），缺乏统一标准，容易出现边界错误。 +4. **CQRS 职责混乱**：查询逻辑与命令逻辑耦合在同一 Service 中，违反读写分离原则，增加系统复杂度。 +5. **类型安全缺失**：使用 Map 或 JSON 传递查询条件时，缺乏编译期检查，运行时才发现字段名拼写错误或类型不匹配。 +6. **框架能力浪费**：不使用 `FastRepository` 提供的自动 Example/HQL 构建能力，绕过框架自建查询机制，失去统一的 SQL 拦截（如数据权限）支持。 + +## 如何使用 + +### 核心规则 + +1. **列表查询统一使用 `PageRequest` 构建分页参数** + - 通过 `PageRequest.of(page, size)` 或 `new PageRequest()` 创建请求对象。 + - 禁止直接使用 Spring Data 原生 `org.springframework.data.domain.PageRequest` 来承载业务过滤条件。 + +2. **动态过滤条件通过 `PageRequest.addFilter()` 方法添加** + - 简单等值过滤：`pageRequest.addFilter("name", "张三")`，默认使用 `Relation.EQUAL`。 + - 指定关系过滤：`pageRequest.addFilter("age", Relation.GREATER_THAN, 18)`。 + - 组合过滤：使用 `andFilter(Filter...)` 和 `orFilters(Filter...)` 构建复杂条件。 + +3. **过滤关系使用 `Relation` 枚举** + - 枚举位于 `com.codingapi.springboot.framework.dto.request.Relation`，使用前必须显式导入（`import com.codingapi.springboot.framework.dto.request.Relation;`）。 + - 可用关系共 14 种：`EQUAL`、`NOT_EQUAL`、`LIKE`、`LEFT_LIKE`、`RIGHT_LIKE`、`BETWEEN`、`IN`、`NOT_IN`、`IS_NULL`、`IS_NOT_NULL`、`GREATER_THAN`、`LESS_THAN`、`GREATER_THAN_EQUAL`、`LESS_THAN_EQUAL`。 + - 所有过滤关系必须通过枚举表达，禁止硬编码字符串比较运算符。 + +4. **Repository 接口需继承 `FastRepository`** + - 实体 Repository 必须扩展 `FastRepository` 以获得动态查询能力。 + - `FastRepository` 同时继承了 `JpaRepository`、`JpaSpecificationExecutor`、`DynamicRepository` 和 `DynamicNativeRepository`。 + +5. **调用 `FastRepository.findAll(PageRequest)` 执行动态查询** + - 当 `PageRequest` 包含 Filter 时，自动通过 `ExampleBuilder` 构建 Example 查询。 + - 需要 HQL 级别查询时，使用 `pageRequest(PageRequest)` 方法，自动通过 `DynamicSQLBuilder` 生成 HQL。 + - 禁止绕过 `FastRepository` 提供的默认方法自行编写动态查询逻辑。 + +6. **禁止在 Service 层手写原生 SQL 实现动态查询** + - 不允许使用 `@Query(nativeQuery = true)` 或 `EntityManager.createNativeQuery()` 拼接动态条件。 + - 所有动态过滤必须委托给 `FastRepository` 的 Filter 机制完成。 + +7. **查询服务（CQRS Query 侧）应独立于命令服务** + - 查询服务放在 `*-app-query` 模块中，仅负责读取操作。 + - 命令服务放在 `*-app-cmd-*` 模块中，负责写入与领域编排。 + - 两者不得互相依赖或合并为同一个类。 + +### 命名约定 + +- 查询服务类命名：`{Entity}QueryService`，位于 `*.query` 包下。 +- 命令服务类命名：`{Entity}CmdService`，位于 `*.cmd` 包下。 +- Controller 中的列表查询方法参数类型统一为 `PageRequest`。 + +## 使用实例 + +### ✅ 正确示例 + +```java +import com.codingapi.springboot.framework.dto.request.Relation; +import com.codingapi.springboot.framework.dto.response.MultiResponse; + +// 1. Repository 继承 FastRepository +public interface UserRepository extends FastRepository { +} + +// 2. 查询服务独立于命令服务 +@Service +public class UserQueryService { + + @Autowired + private UserRepository userRepository; + + public Page listUsers(String name, Integer minAge, int page, int size) { + PageRequest request = PageRequest.of(page, size); + + // 动态添加过滤条件 + if (StringUtils.hasText(name)) { + request.addFilter("name", Relation.LIKE, name); + } + if (minAge != null) { + request.addFilter("age", Relation.GREATER_THAN_EQUAL, minAge); + } + + // 委托 FastRepository 自动构建查询 + return userRepository.findAll(request); + } +} + +// 3. Controller 接收 PageRequest +@GetMapping("/users") +public MultiResponse list( + @RequestParam(required = false) String name, + @RequestParam(required = false) Integer minAge, + @RequestParam(defaultValue = "0") int page, + @RequestParam(defaultValue = "20") int size) { + Page result = userQueryService.listUsers(name, minAge, page, size); + return MultiResponse.of(result); +} +``` + +### ❌ 错误示例 + +```java +// 错误 1: Repository 未继承 FastRepository，丧失动态查询能力 +public interface UserRepository extends JpaRepository { +} + +// 错误 2: Service 中手写原生 SQL 拼接动态条件 +@Service +public class UserService { + + @PersistenceContext + private EntityManager entityManager; + + public List listUsers(String name, Integer minAge) { + StringBuilder sql = new StringBuilder("SELECT * FROM users WHERE 1=1"); + if (name != null) { + sql.append(" AND name LIKE '%").append(name).append("%'"); // SQL 注入风险！ + } + if (minAge != null) { + sql.append(" AND age >= ").append(minAge); + } + return entityManager.createNativeQuery(sql.toString(), User.class).getResultList(); + } +} + +// 错误 3: 查询与命令逻辑混合在同一个 Service 中 +@Service +public class UserService { + public Page list(...) { /* 查询逻辑 */ } + public void createUser(...) { /* 命令逻辑 */ } + public void deleteUser(...) { /* 命令逻辑 */ } +} + +// 错误 4: 使用 Spring Data 原生 PageRequest，无法承载 Filter +@GetMapping("/users") +public Page list(org.springframework.data.domain.PageRequest pageable) { + // 丢失了框架的动态过滤能力 + return userRepository.findAll(pageable); +} +``` diff --git a/docs/agents/conventions/springboot-starter/ddd-layered-architecture.md b/docs/agents/conventions/springboot-starter/ddd-layered-architecture.md new file mode 100644 index 000000000..94211d5c8 --- /dev/null +++ b/docs/agents/conventions/springboot-starter/ddd-layered-architecture.md @@ -0,0 +1,225 @@ +--- +name: springboot-starter/ddd-layered-architecture +module: springboot-starter +description: DDD 分层架构规范，定义 interface/app/domain/infra 四层的依赖规则和职责划分 +status: 已实现 +scope: 后端 +source: 框架:springboot-starter +import: "com.codingapi.springboot:springboot-starter" +framework_version: "8.2.0-SNAPSHOT" +--- + +## 解决什么问题 + +不遵守 DDD 分层架构规范会导致以下问题： + +1. **领域逻辑污染**：domain 层直接引用 infra 层实现类（如 JPA Repository、Redis Client），导致业务规则与基础设施耦合，无法独立演进和测试。 +2. **依赖方向混乱**：若 domain 反向依赖 app 或 interface，修改一个 API 接口可能牵连整个领域模型重构，变更成本指数级增长。 +3. **CQRS 读写混淆**：查询服务与命令服务混杂在同一模块中，复杂查询被迫走聚合根加载全量数据，性能瓶颈难以定位和优化。 +4. **接口层职责膨胀**：Controller 中直接编排业务流程、拼装 DTO、处理事件，导致接口层成为"上帝类"，复用性和可维护性急剧下降。 +5. **Repository 契约缺失**：domain 层直接使用具体持久化实现而非接口，切换存储方案（如从 MySQL 迁移到 MongoDB）需要改动所有调用方代码。 + +## 如何使用 + +### 四层架构与依赖方向 + +``` +interface → app → domain ← infra +``` + +| 层级 | 模块命名约定 | 核心职责 | 允许依赖 | +|------|-------------|---------|---------| +| **interface**（接口层） | `*-interface` | Controller（REST API）、Handler（事件处理器）、Runner（启动任务） | app | +| **app**（应用层） | `*-app-query` / `*-app-cmd-*` | query：CQRS 查询服务；cmd：命令服务与领域编排 | domain | +| **domain**（领域层） | `*-domain-*` | Entity、ValueObject、DomainService、Repository 接口、DomainEvent | 无外部框架 | +| **infra**（基础设施层） | `*-infra-*` | Repository 实现、Gateway 实现、外部服务适配、持久化配置 | domain | + +### 核心规则 + +1. **依赖方向严格单向**：`interface → app → domain ← infra`。禁止反向依赖和跨层依赖。 +2. **domain 层纯业务**：domain 层只包含领域模型和业务逻辑，不依赖 Spring、JPA、Redis 等任何外部框架。 +3. **Repository 接口在 domain，实现在 infra**：domain 层定义 Repository 接口，infra 层提供具体实现并通过 Spring Bean 注入。 +4. **app 层按 CQRS 拆分**：查询服务（query）与命令服务（cmd）分模块，query 侧可直接读取视图/DTO，cmd 侧通过聚合根执行业务操作。 +5. **interface 层仅做适配**：Controller 只做参数校验、权限检查和响应封装，业务编排委托给 app 层；Handler 只负责事件监听与转发。 +6. **禁止 domain 引用 infra 实现类**：domain 层不得 import infra 包下的任何类，包括具体的 Repository 实现、DAO、Client 等。 + +### 包结构约定 + +``` +{bounded-context}/ + {context}-interface/ # 接口层 + controller/ + handler/ + runner/ + {context}-app/ # 应用层 + {context}-app-query/ # CQRS Query 侧 + {context}-app-cmd-domain/ # CQRS Command 侧（领域编排） + {context}-domain/ # 领域层 + model/ # Entity, ValueObject + repository/ # Repository 接口 + service/ # DomainService + event/ # DomainEvent + {context}-infra/ # 基础设施层 + jpa/ # Repository 实现 + gateway/ # 外部服务适配 +``` + +## 使用实例 + +### ✅ 正确示例 + +**domain 层定义 Repository 接口：** + +```java +// example-domain-user/src/.../repository/UserRepository.java +package com.example.domain.user.repository; + +public interface UserRepository { + User findById(Long id); + void save(User user); +} +``` + +**infra 层提供 Repository 实现：** + +```java +// example-infra-jpa/src/.../jpa/UserRepositoryImpl.java +package com.example.infra.jpa; + +import com.example.domain.user.repository.UserRepository; +import org.springframework.stereotype.Repository; + +@Repository +public class UserRepositoryImpl implements UserRepository { + private final UserJpaDao userJpaDao; + + @Override + public User findById(Long id) { + return userJpaDao.findById(id).map(UserConverter::toDomain).orElse(null); + } + + @Override + public void save(User user) { + userJpaDao.save(UserConverter.toEntity(user)); + } +} +``` + +**app 层按 CQRS 拆分：** + +```java +// example-app-query: 查询服务，直接返回 DTO +@Service +public class UserQueryService { + private final UserReadDao userReadDao; // 可直接读视图 + + public SingleResponse getUser(Long id) { + return SingleResponse.of(userReadDao.findUserDTO(id)); + } +} + +// example-app-cmd-domain: 命令服务，通过聚合根操作 +@Service +public class UserCommandService { + private final UserRepository userRepository; // domain 层接口 + + @Transactional + public Response createUser(CreateUserCmd cmd) { + User user = User.create(cmd.getName(), cmd.getEmail()); + userRepository.save(user); + return Response.success(); + } +} +``` + +**interface 层仅做适配：** + +```java +@RestController +@RequestMapping("/api/users") +public class UserController { + private final UserQueryService queryService; + private final UserCommandService commandService; + + @GetMapping("/{id}") + public SingleResponse getUser(@PathVariable Long id) { + return queryService.getUser(id); // 委托 app 层 + } + + @PostMapping + public Response createUser(@Valid @RequestBody CreateUserCmd cmd) { + return commandService.createUser(cmd); // 委托 app 层 + } +} +``` + +### ❌ 错误示例 + +**domain 层直接引用 infra 实现类：** + +```java +// ❌ domain 层 import 了 infra 包的类 +package com.example.domain.user.service; + +import com.example.infra.jpa.UserJpaDao; // 违规！domain 不应依赖 infra + +@Service +public class UserService { + private final UserJpaDao userJpaDao; // 应使用 UserRepository 接口 + + public User findUser(Long id) { + return userJpaDao.findById(id).orElse(null); + } +} +``` + +**依赖方向反转：** + +```java +// ❌ domain 层反向依赖 app 层 +package com.example.domain.user.model; + +import com.example.app.cmd.domain.UserService; // 违规！domain 不应依赖 app + +public class User { + public void activate() { + UserService userService = ...; // 领域对象不应调用应用服务 + userService.sendActivationEmail(this); + } +} +``` + +**app 层未拆分 CQRS，查询走聚合根：** + +```java +// ❌ 查询和命令混在一起，列表查询加载完整聚合根 +@Service +public class UserService { + private final UserRepository userRepository; + + // 列表查询不应加载完整 User 聚合根 + public List listUsers(String keyword) { + return userRepository.findAll().stream() + .filter(u -> u.getName().contains(keyword)) + .collect(Collectors.toList()); // 内存过滤，性能灾难 + } +} +``` + +**Controller 中直接编排业务逻辑：** + +```java +// ❌ Controller 承担了本应属于 app 层的职责 +@PostMapping("/orders") +public Response createOrder(@RequestBody OrderCmd cmd) { + User user = userRepository.findById(cmd.getUserId()); // 应在 app 层 + Product product = productRepository.findById(cmd.getProductId()); // 应在 app 层 + if (product.getStock() < cmd.getQuantity()) { // 业务校验应在 domain + return Response.error("库存不足"); + } + Order order = new Order(user, product, cmd.getQuantity()); // 领域创建应在 app/cmd + orderRepository.save(order); // 应在 app 层 + eventPusher.push(new OrderCreatedEvent(order)); // 事件推送应在 app 层 + return Response.success(order.getId()); +} +``` diff --git a/docs/agents/conventions/springboot-starter/event-driven-convention.md b/docs/agents/conventions/springboot-starter/event-driven-convention.md new file mode 100644 index 000000000..4303cdd18 --- /dev/null +++ b/docs/agents/conventions/springboot-starter/event-driven-convention.md @@ -0,0 +1,217 @@ +--- +name: springboot-starter/event-driven-convention +module: springboot-starter +description: 事件驱动开发规范，定义 IEvent/IHandler 的使用约定和事件处理模式 +status: 已实现 +scope: 后端 +source: 框架:springboot-starter +import: "com.codingapi.springboot:springboot-starter" +framework_version: "8.2.0-SNAPSHOT" +--- + +## 解决什么问题 + +不遵守事件驱动开发规范会导致以下问题： + +1. **事务耦合风险**：将事件处理与主业务事务强绑定，导致分支业务的失败回滚整个主事务，破坏领域事件的独立性原则。当分支逻辑（如通知、日志、缓存更新）出错时，不应影响核心业务流程的提交。 + +2. **事件类型混乱**：不区分同步事件与异步事件，导致关键业务事件被异步执行产生时序问题，或非关键事件被同步阻塞影响主流程性能。 + +3. **Handler 注册失效**：未通过 `@Service` 注解将 Handler 注册为 Spring Bean，导致框架无法自动发现处理器，事件推送后无响应且难以排查。 + +4. **执行顺序不可控**：多个 Handler 订阅同一事件时未指定 `order()`，导致处理顺序依赖 Bean 加载顺序，在不同环境或重启后行为不一致。 + +5. **异常处理缺失**：未实现 `error()` 回调或直接在 `handler()` 中抛出未捕获异常，导致后续 Handler 被跳过且错误信息丢失，事件链中断而无法感知。 + +6. **绕过 EventPusher 直接调用**：手动实例化 Handler 或直接调用处理方法，绕过框架的循环检测、线程池调度和上下文传递机制，引发循环事件死锁或丢失链路追踪信息。 + +## 如何使用 + +### 规则 1：事件类必须实现 IEvent 接口 + +所有事件类必须实现 `IEvent` 接口。根据执行方式选择子接口： + +- **同步事件**：实现 `ISyncEvent`，在当前线程内按顺序执行所有 Handler +- **异步事件**：实现 `IAsyncEvent`，由框架线程池异步调度执行 + +事件类应为纯数据载体，不包含业务逻辑，并实现 `Serializable` 以支持序列化传输。 + +### 规则 2：事件处理器必须实现 IHandler 接口 + +Handler 通过泛型参数声明订阅的事件类型。框架的 Handler 注册机制分为两个阶段：① `HandlerBeanDefinitionRegistrar` 只扫描带 `@Handler` 注解的类并注册为 Spring BeanDefinition（使用 `@Component`/`@Service` 标注的 Handler 则由 Spring 组件扫描注册为 Bean）；② `SpringHandlerConfiguration` 收集容器中所有 `IHandler` Bean，在构造 `SpringDefaultEventHandler`/`SpringTransactionEventHandler` 时通过 `addHandlers` 统一注册到 `ApplicationHandlerUtils`。 + +```java +public interface IHandler { + default int order() { return 0; } + void handler(T event); + default void error(Exception exception) throws Exception { throw exception; } +} +``` + +### 规则 3：事件处理器通过 @Service 注解注册为 Spring Bean + +Handler 必须标注 `@Service`（或 `@Component`）注解，确保被 Spring 容器管理。未注册为 Bean 的 Handler 不会被框架发现和调用。 + +### 规则 4：事件推送统一使用 EventPusher.push() 静态方法 + +所有事件推送必须通过 `EventPusher.push(event)` 发起，禁止手动调用 Handler。框架内置循环事件检测机制，当检测到事件循环推送时自动抛出异常。若确认需要允许循环事件，可使用 `EventPusher.push(event, true)` 关闭检测。 + +### 规则 5：事件不应与主业务强耦合事务绑定 + +事件处理的核心理念是**解耦**。事件对于主业务来说可成功可失败，成功与失败都不应强关联主体业务。若分支逻辑必须与主事务保持一致，应直接使用服务调用而非事件机制。 + +### 规则 6：多个 Handler 通过 order() 方法控制执行顺序 + +当多个 Handler 订阅同一事件时，通过重写 `order()` 方法指定执行优先级。数值越小越先执行，默认值为 0。相同 order 值的 Handler 执行顺序不确定。 + +### 规则 7：Handler 的 error() 回调处理异常 + +`error()` 方法接收 Handler 执行过程中抛出的异常。默认实现会重新抛出异常，这将**阻止后续 Handler 的执行**。若希望某个 Handler 的失败不影响其他 Handler，应在 `error()` 中记录日志而不重新抛出。 + +## 使用实例 + +### ✅ 正确示例 + +```java +// 1. 定义同步事件 +public class UserCreatedEvent implements ISyncEvent { + private final String userId; + private final String username; + + public UserCreatedEvent(String userId, String username) { + this.userId = userId; + this.username = username; + } + + public String getUserId() { return userId; } + public String getUsername() { return username; } +} + +// 2. 定义异步事件 +public class UserNotificationEvent implements IAsyncEvent { + private final String userId; + private final String message; + + public UserNotificationEvent(String userId, String message) { + this.userId = userId; + this.message = message; + } + + public String getUserId() { return userId; } + public String getMessage() { return message; } +} + +// 3. 注册 Handler 并指定执行顺序 +@Service +public class UserCacheRefreshHandler implements IHandler { + + @Override + public int order() { + return 1; // 优先刷新缓存 + } + + @Override + public void handler(UserCreatedEvent event) { + cacheService.refreshUserCache(event.getUserId()); + } + + @Override + public void error(Exception exception) { + // 缓存刷新失败不影响后续 Handler，仅记录日志 + log.warn("缓存刷新失败: {}", exception.getMessage()); + } +} + +@Service +public class UserAuditLogHandler implements IHandler { + + @Override + public int order() { + return 2; // 缓存之后写审计日志 + } + + @Override + public void handler(UserCreatedEvent event) { + auditService.logUserCreation(event.getUserId(), event.getUsername()); + } +} + +// 4. 在业务中推送事件 +@Service +public class UserService { + + public User createUser(CreateUserCommand command) { + User user = userRepository.save(command.toEntity()); + // 通过 EventPusher 推送，不直接调用 Handler + EventPusher.push(new UserCreatedEvent(user.getId(), user.getUsername())); + return user; + } +} +``` + +### ❌ 错误示例 + +```java +// 错误 1：事件未实现 IEvent 接口 +public class UserCreatedEvent { // ❌ 缺少 ISyncEvent / IAsyncEvent + private String userId; +} + +// 错误 2：Handler 未注册为 Spring Bean +public class UserCacheHandler implements IHandler { // ❌ 缺少 @Service + @Override + public void handler(UserCreatedEvent event) { + cacheService.refreshUserCache(event.getUserId()); + } +} + +// 错误 3：在事务中强绑定事件结果 +@Transactional +public User createUser(CreateUserCommand command) { + User user = userRepository.save(command.toEntity()); + try { + EventPusher.push(new UserCreatedEvent(user.getId(), user.getUsername())); + } catch (Exception e) { + throw new RuntimeException("事件处理失败，回滚事务", e); // ❌ 事件失败不应回滚主事务 + } + return user; +} + +// 错误 4：手动调用 Handler 绕过框架 +@Service +public class UserService { + @Autowired + private UserCacheRefreshHandler cacheHandler; + + public User createUser(CreateUserCommand command) { + User user = userRepository.save(command.toEntity()); + cacheHandler.handler(new UserCreatedEvent(user.getId(), user.getUsername())); // ❌ 绕过 EventPusher + return user; + } +} + +// 错误 5：未处理异常导致事件链中断 +@Service +public class FragileHandler implements IHandler { + @Override + public void handler(UserCreatedEvent event) { + externalService.notify(event.getUserId()); // 可能抛出异常 + } + // ❌ 未重写 error()，默认重新抛出异常，阻止后续 Handler 执行 +} + +// 错误 6：多个 Handler 未指定 order，执行顺序不可预测 +@Service +public class HandlerA implements IHandler { + @Override + public void handler(UserCreatedEvent event) { /* ... */ } + // ❌ 未重写 order()，默认 0，与 HandlerB 顺序不确定 +} + +@Service +public class HandlerB implements IHandler { + @Override + public void handler(UserCreatedEvent event) { /* ... */ } + // ❌ 未重写 order()，默认 0，与 HandlerA 顺序不确定 +} +``` diff --git a/docs/agents/conventions/springboot-starter/exception-handling-convention.md b/docs/agents/conventions/springboot-starter/exception-handling-convention.md new file mode 100644 index 000000000..e7931aa83 --- /dev/null +++ b/docs/agents/conventions/springboot-starter/exception-handling-convention.md @@ -0,0 +1,156 @@ +--- +name: springboot-starter/exception-handling-convention +module: springboot-starter +description: 全局异常处理规范，定义异常抛出和捕获的标准模式 +status: 已实现 +scope: 后端 +source: 框架:springboot-starter +import: "com.codingapi.springboot:springboot-starter" +framework_version: "8.2.0-SNAPSHOT" +--- + +## 解决什么问题 + +不遵守此规范会导致以下问题： + +1. **错误响应格式不一致**：不同开发者在 Controller 中自行 try-catch 并返回自定义格式的错误信息，导致前端无法统一解析 `errCode` / `errMessage` 字段，增加联调和维护成本。 +2. **缺失国际化支持**：直接抛出 `RuntimeException` 或硬编码中文消息，无法根据请求 Locale 切换语言，多语言场景下用户体验差且需要大量改造。 +3. **异常被吞没**：Controller 层使用 try-catch 捕获异常后仅打印日志或返回 null，调用方无法感知业务失败原因，排查线上问题时缺少关键上下文。 +4. **错误码体系混乱**：各模块自行定义错误码常量或直接拼接字符串，缺乏统一的 key → message 映射机制，同一个业务含义可能出现多个不同的 errCode。 +5. **全局拦截失效**：绕过框架的 `HandlerExceptionResolver` 机制手动处理异常，导致日志记录、监控埋点等横切关注点被跳过。 + +## 如何使用 + +### 规则 1：业务异常统一使用 LocaleMessageException + +所有业务校验失败、参数非法、权限不足等场景，必须抛出 `LocaleMessageException`，禁止直接使用 `RuntimeException`、`IllegalArgumentException` 等原生异常。 + +```java +// 构造方式一（推荐）：仅 errCode，消息从 message.properties 中按当前 Locale 自动解析 +throw new LocaleMessageException("user.not.found"); + +// 构造方式二：errCode + 占位符参数，对应 properties 中 user.duplicate=用户名 {0} 已存在 +throw LocaleMessageException.of("user.duplicate", username); + +// 构造方式三：errCode + 自定义消息，第二个参数直接使用、不走国际化（仅用于无需 i18n 的场景） +throw new LocaleMessageException("custom.error", "自定义错误描述"); +``` + +**需要国际化消息时，必须使用单参构造 `LocaleMessageException(errCode)` 或静态工厂 `LocaleMessageException.of(errCode, args)`**，消息由框架从 message.properties 中按请求 Locale 解析。 + +### 规则 2：异常消息通过 message key 国际化解析 + +- 第一个参数为 **errCode**（即 i18n message key），用于前端匹配和国际化查找。 +- 需要国际化的消息使用单参构造 `LocaleMessageException(errCode)` 或 `LocaleMessageException.of(errCode, args)`，消息从 message.properties 中按当前请求 Locale 解析。 +- 两参构造 `LocaleMessageException(errCode, errMessage)` 的第二个参数是**直接使用、不走国际化的自定义消息**：该构造函数直接以 errMessage 构造异常，**不会查询 MessageSource / message.properties，也不随 Locale 切换**，并非 "key 未配置时的兜底默认消息"。仅在确定无需国际化的场景使用。 +- errCode 命名采用 **点分隔小写** 格式，如 `order.status.invalid`、`auth.token.expired`。 + +### 规则 3：依赖 ExceptionConfiguration 全局拦截 + +框架通过 `ExceptionConfiguration` 注册 `LocaleMessage` Bean，并由 `BasicHandlerExceptionResolverConfiguration` 中的 `ServletExceptionHandler` 统一拦截所有 Controller 层异常： + +- `LocaleMessageException` → 提取 `errCode` 和 `errMessage`，返回标准 Response 格式。 +- 其他未知异常 → 使用默认 errCode `system.err`，返回异常原始消息。 + +**无需在任何 Controller 中添加额外的 @ExceptionHandler。** + +### 规则 4：异常响应统一返回 Response 格式 + +全局拦截器返回的 JSON 结构如下： + +```json +{ + "success": false, + "errCode": "user.not.found", + "errMessage": "用户不存在" +} +``` + +前端只需判断 `success === false` 即可进入统一错误处理流程。 + +### 规则 5：禁止在 Controller 中使用 try-catch 吞掉异常 + +Controller 方法应保持简洁，让异常自然向上抛出由全局处理器接管。如需对特定异常做差异化处理（如参数校验），应在 Service 层完成转换后再抛出 `LocaleMessageException`。 + +### 规则 6：禁止直接抛出 RuntimeException + +`RuntimeException` 没有 `errCode` 字段，全局拦截器只能将其归入 `system.err`，丢失了业务语义。所有可预见的业务异常都必须使用 `LocaleMessageException`。 + +## 使用实例 + +### ✅ 正确示例 + +```java +@Service +public class UserService { + + public User getUser(Long id) { + return userRepository.findById(id) + // 单参构造：消息从 messages.properties 中按 Locale 自动解析 + .orElseThrow(() -> new LocaleMessageException("user.not.found")); + } + + public void createUser(String username) { + if (userRepository.existsByUsername(username)) { + // 使用静态工厂方法 + 占位符参数 + throw LocaleMessageException.of("user.duplicate", username); + } + // ... + } +} + +@RestController +@RequestMapping("/users") +public class UserController { + + @GetMapping("/{id}") + public SingleResponse getUser(@PathVariable Long id) { + // 不需要 try-catch，异常由全局处理器接管 + return SingleResponse.of(userService.getUser(id)); + } +} +``` + +对应的 `messages_zh_CN.properties`： + +```properties +user.not.found=用户不存在 +user.duplicate=用户名 {0} 已存在 +``` + +### ❌ 错误示例 + +```java +// 错误 1：直接抛出 RuntimeException，缺少 errCode +public User getUser(Long id) { + return userRepository.findById(id) + .orElseThrow(() -> new RuntimeException("用户不存在")); +} + +// 错误 2：Controller 中 try-catch 吞掉异常 +@GetMapping("/{id}") +public SingleResponse getUser(@PathVariable Long id) { + try { + return SingleResponse.of(userService.getUser(id)); + } catch (Exception e) { + log.error("查询失败", e); + return null; // 前端收到 null，无法区分成功与失败 + } +} + +// 错误 3：Controller 中自行构建错误响应，绕过全局拦截 +@GetMapping("/{id}") +public ResponseEntity getUser(@PathVariable Long id) { + try { + return ResponseEntity.ok(SingleResponse.of(userService.getUser(id))); + } catch (Exception e) { + Map error = new HashMap<>(); + error.put("code", 500); + error.put("msg", e.getMessage()); + return ResponseEntity.status(500).body(error); + } +} + +// 错误 4：硬编码中文消息，两参构造的第二个参数直接使用、不走国际化 +throw new LocaleMessageException("err001", "这个用户找不到啊"); +``` diff --git a/docs/agents/conventions/springboot-starter/response-convention.md b/docs/agents/conventions/springboot-starter/response-convention.md new file mode 100644 index 000000000..1ac49488c --- /dev/null +++ b/docs/agents/conventions/springboot-starter/response-convention.md @@ -0,0 +1,156 @@ +--- +name: springboot-starter/response-convention +module: springboot-starter +description: 统一响应格式规范，定义 Controller 层返回值的标准格式 +status: 已实现 +scope: 后端 +source: 框架:springboot-starter +import: "com.codingapi.springboot:springboot-starter" +framework_version: "8.2.0-SNAPSHOT" +--- + +## 解决什么问题 + +在 REST API 开发中，如果不对响应格式做统一约束，会导致以下问题： + +- **前端解析困难**：不同接口返回结构不一致（有的直接返回对象、有的返回 Map、有的包裹在自定义结构中），前端需要为每个接口单独适配，增加维护成本。 +- **错误处理碎片化**：没有统一的 `success` / `errCode` / `errMessage` 字段，前端无法用一套逻辑判断请求是否成功、展示错误提示。 +- **分页结构不统一**：列表接口各自定义分页字段名（`total` / `count` / `records` / `items`），前端分页组件难以复用。 +- **API 契约不稳定**：随意返回裸 Map 或临时 DTO，字段增减无感知，容易引发线上联调故障。 +- **国际化与监控缺失基础**：缺少标准化的错误码字段，后续接入国际化、链路追踪、告警分类时改造成本极高。 + +本规范通过强制使用框架提供的 Response 体系，确保所有 API 输出结构一致、可预测、可机器解析。 + +## 如何使用 + +### 核心规则 + +1. **Controller 方法返回值必须使用 Response 体系**：只能返回 `Response`、`SingleResponse`、`MultiResponse` 或 `MapResponse` 之一，禁止返回其他类型。 +2. **单个对象返回**：使用 `SingleResponse.of(data)`。 +3. **列表返回**：使用 `MultiResponse.of(list)` 或 `MultiResponse.of(page)`（接受 Spring Data `Page` 对象）。 +4. **无数据操作成功返回**：使用 `Response.buildSuccess()`。 +5. **失败返回**：使用 `Response.buildFailure(errCode, errMessage)`。 +6. **禁止直接返回 Map 或自定义 DTO 作为 API 响应**。 +7. **响应 JSON 结构固定包含**：`success`（boolean）、`errCode`（string）、`errMessage`（string）、`data`（业务数据，仅 SingleResponse/MultiResponse/MapResponse 携带，`Response` 本身不携带）。 + +### 补充说明 + +- `SingleResponse.empty()` 用于查询可能为空但语义上成功的场景，返回 `{ success: true, data: null }`。 +- `MultiResponse.of(collection, total)` 用于手动分页场景；`MultiResponse.of(page)` 自动从 Spring Data Page 提取 total。 +- `MultiResponse.empty()` 返回空结果 `{ success: true, data: { total: 0, list: null } }`（注意：内部 `Content.list` 未初始化，序列化结果为 `null` 而非空数组；如需空数组语义，可改用 `MultiResponse.of(Collections.emptyList())`）。 +- 异常处理应通过全局异常处理器统一转换为 `Response.buildFailure(...)`，Controller 内不要 try-catch 后自行拼装错误响应。 + +## 使用实例 + +### ✅ 正确示例 + +```java +// 1. 单对象查询 +@GetMapping("/users/{id}") +public SingleResponse getUser(@PathVariable Long id) { + UserDTO user = userService.findById(id); + return SingleResponse.of(user); +} + +// 2. 分页列表查询 +@GetMapping("/users") +public MultiResponse listUsers(PageRequest pageRequest) { + Page page = userService.findAll(pageRequest); + return MultiResponse.of(page); +} + +// 3. 非分页列表查询 +@GetMapping("/roles") +public MultiResponse listRoles() { + List roles = roleService.findAll(); + return MultiResponse.of(roles); +} + +// 4. 写操作成功（无返回数据） +@PostMapping("/users") +public Response createUser(@RequestBody CreateUserCmd cmd) { + userService.create(cmd); + return Response.buildSuccess(); +} + +// 5. 业务校验失败 +@PostMapping("/orders") +public Response createOrder(@RequestBody CreateOrderCmd cmd) { + if (cmd.getQuantity() <= 0) { + return Response.buildFailure("INVALID_QUANTITY", "订单数量必须大于0"); + } + orderService.create(cmd); + return Response.buildSuccess(); +} +``` + +正确返回的 JSON 结构： + +```json +{ + "success": true, + "errCode": null, + "errMessage": null, + "data": { "id": 1, "name": "张三" } +} +``` + +```json +{ + "success": true, + "errCode": null, + "errMessage": null, + "data": { + "total": 100, + "list": [{ "id": 1, "name": "张三" }] + } +} +``` + +### ❌ 错误示例 + +```java +// 错误1：直接返回实体对象 +@GetMapping("/users/{id}") +public UserDTO getUser(@PathVariable Long id) { + return userService.findById(id); +} + +// 错误2：返回裸 Map +@GetMapping("/users/{id}") +public Map getUser(@PathVariable Long id) { + Map result = new HashMap<>(); + result.put("code", 200); + result.put("data", userService.findById(id)); + return result; +} + +// 错误3：自定义响应结构 +@GetMapping("/users/{id}") +public Result getUser(@PathVariable Long id) { + return new Result<>(userService.findById(id)); +} + +// 错误4：Controller 内 try-catch 自行拼装错误 +@PostMapping("/users") +public Response createUser(@RequestBody CreateUserCmd cmd) { + try { + userService.create(cmd); + return Response.buildSuccess(); + } catch (Exception e) { + // 不应在 Controller 中捕获并手动构建错误响应 + Response resp = new Response(); + resp.setSuccess(false); + resp.setErrMessage(e.getMessage()); + return resp; + } +} + +// 错误5：列表接口不使用 MultiResponse +@GetMapping("/users") +public List listUsers() { + return userService.findAll(); +} +``` + +以上错误写法会导致前端无法统一解析响应、错误处理逻辑分散、API 契约不可靠等问题。 diff --git a/docs/capabilities/alibaba/fastjson.md b/docs/capabilities/alibaba/fastjson.md new file mode 100644 index 000000000..14ff82970 --- /dev/null +++ b/docs/capabilities/alibaba/fastjson.md @@ -0,0 +1,172 @@ +--- +name: alibaba/fastjson +module: alibaba +description: Fastjson JSON 序列化库，提供高性能 JSON 解析和序列化 +status: 已实现 +scope: 后端 +source: 框架:alibaba +import: "com.alibaba:fastjson" +framework_version: 2.0.53 +--- + +## 解决什么问题 + +在企业级 Java 应用中，JSON 是最常用的数据交换格式。Fastjson 解决了以下核心痛点： + +- **高性能序列化/反序列化**：相比 JDK 原生或其他 JSON 库，Fastjson 在解析速度和内存占用上具有显著优势，适合高并发、大数据量的接口场景 +- **灵活的类型转换**：支持将 JSON 字符串直接转换为 Java Bean、Map、List 等复杂对象，也支持泛型集合的反序列化 +- **丰富的定制能力**：通过注解和过滤器机制，可以精确控制字段的序列化/反序列化行为（如字段重命名、忽略空值、日期格式化等） +- **与 Spring Boot 无缝集成**：可作为 Spring MVC 的 HttpMessageConverter，替代默认的 Jackson 进行请求/响应的自动 JSON 处理 + +在本框架中，Fastjson 2.x（2.0.53）被用作底层 JSON 工具，为统一响应封装、事件系统数据传递、脚本引擎参数绑定等模块提供高效的序列化支撑。 + +## 如何使用 + +### Maven 依赖 + +```xml + + com.alibaba.fastjson2 + fastjson2 + 2.0.53 + +``` + +### 核心 API + +| 方法 | 说明 | +|------|------| +| `JSON.toJSONString(object)` | 将 Java 对象序列化为 JSON 字符串 | +| `JSON.parseObject(json, Class)` | 将 JSON 字符串反序列化为指定类型的 Java 对象 | +| `JSON.parseArray(json, Class)` | 将 JSON 数组字符串反序列化为 List | +| `JSON.toJSONBytes(object)` | 将 Java 对象序列化为 byte[]（适合网络传输/缓存存储） | +| `JSONObject.parseObject(json)` | 解析为 JSONObject（类似 Map 的动态访问） | + +### 常用特性控制 + +通过 `JSONWriter.Feature` 和 `JSONReader.Feature` 枚举控制序列化/反序列化行为： + +- `JSONWriter.Feature.WriteMapNullValue` — 序列化时保留 null 值字段 +- `JSONWriter.Feature.PrettyFormat` — 格式化输出（带缩进换行） +- `JSONWriter.Feature.WriteEnumsUsingToString` — 枚举使用 toString() 而非 ordinal +- `JSONReader.Feature.SupportSmartMatch` — 智能匹配（忽略大小写和下划线差异） +- `JSONReader.Feature.IgnoreCheckClose` — 宽松解析，容忍非标准 JSON + +### 注解定制 + +- `@JSONField(name = "...")` — 自定义 JSON 字段名 +- `@JSONField(format = "yyyy-MM-dd HH:mm:ss")` — 日期格式化 +- `@JSONField(serialize = false)` — 排除该字段不参与序列化 +- `@JSONField(deserialize = false)` — 排除该字段不参与反序列化 + +## 使用实例 + +### 基础序列化与反序列化 + +```java +import com.alibaba.fastjson2.JSON; + +// 序列化 +User user = new User(); +user.setId(1L); +user.setName("张三"); +user.setAge(28); + +String json = JSON.toJSONString(user); +// {"age":28,"id":1,"name":"张三"} + +// 反序列化 +User parsed = JSON.parseObject(json, User.class); +System.out.println(parsed.getName()); // 张三 +``` + +### 泛型集合反序列化 + +```java +import com.alibaba.fastjson2.JSON; +import com.alibaba.fastjson2.TypeReference; +import java.util.List; + +String jsonArray = "[{\"id\":1,\"name\":\"张三\"},{\"id\":2,\"name\":\"李四\"}]"; + +// 使用 TypeReference 保留泛型信息 +List users = JSON.parseObject(jsonArray, new TypeReference>() {}); +System.out.println(users.size()); // 2 +``` + +### 带特性的序列化 + +```java +import com.alibaba.fastjson2.JSON; +import com.alibaba.fastjson2.JSONWriter; + +User user = new User(); +user.setId(1L); +user.setName(null); + +// 默认不输出 null 字段 +String compact = JSON.toJSONString(user); +// {"id":1} + +// 保留 null 值 + 格式化输出 +String pretty = JSON.toJSONString(user, + JSONWriter.Feature.WriteMapNullValue, + JSONWriter.Feature.PrettyFormat); +// { +// "age":null, +// "id":1, +// "name":null +// } +``` + +### 使用注解定制字段 + +```java +import com.alibaba.fastjson2.annotation.JSONField; +import java.time.LocalDateTime; + +public class Order { + + @JSONField(name = "order_id") + private Long orderId; + + @JSONField(format = "yyyy-MM-dd HH:mm:ss") + private LocalDateTime createTime; + + @JSONField(serialize = false) + private String internalCode; // 不参与序列化 + + // getter/setter ... +} + +Order order = new Order(); +order.setOrderId(1001L); +order.setCreateTime(LocalDateTime.now()); +order.setInternalCode("INTERNAL"); + +String json = JSON.toJSONString(order); +// {"createTime":"2026-06-08 14:30:00","order_id":1001} +// 注意：internalCode 未出现，orderId 被重命名为 order_id +``` + +### 动态 JSONObject 操作 + +```java +import com.alibaba.fastjson2.JSONObject; + +// 从字符串解析 +String json = "{\"name\":\"张三\",\"address\":{\"city\":\"杭州\",\"zip\":\"310000\"}}"; +JSONObject obj = JSONObject.parseObject(json); + +// 读取嵌套字段 +String city = obj.getJSONObject("address").getString("city"); +System.out.println(city); // 杭州 + +// 动态构建并输出 +JSONObject result = new JSONObject(); +result.put("code", 200); +result.put("message", "success"); +result.put("data", obj); + +System.out.println(result.toJSONString()); +``` diff --git a/docs/capabilities/apache/groovy.md b/docs/capabilities/apache/groovy.md new file mode 100644 index 000000000..cb666deda --- /dev/null +++ b/docs/capabilities/apache/groovy.md @@ -0,0 +1,178 @@ +--- +name: apache/groovy +module: apache +description: Groovy 动态脚本语言，运行在 JVM 上，支持动态类型和脚本化编程 +status: 已实现 +scope: 后端 +source: 框架:apache +import: "org.apache.groovy:groovy" +framework_version: 4.0.24 +--- + +## 解决什么问题 + +在企业级应用中，许多业务逻辑需要在不重启服务的前提下进行动态调整，例如： + +- **动态规则引擎**：促销折扣、风控策略、审批条件等频繁变更的业务规则，硬编码会导致频繁发版。 +- **可配置的计算逻辑**：报表字段计算、数据转换、自定义校验等逻辑需要由运营人员或实施人员灵活配置。 +- **热更新与灰度验证**：线上问题修复或新逻辑验证时，希望以脚本方式快速下发并即时生效，而非走完整的发布流程。 +- **降低扩展门槛**：让非核心开发人员（如实施顾问、数据分析师）也能通过简洁的 DSL 参与业务逻辑编写。 + +Groovy 作为运行在 JVM 上的动态语言，与 Java 完全兼容且语法更简洁。springboot-framework 的 `springboot-starter-script` 模块在此基础上封装了完整的脚本运行时，提供了编译缓存、LRU 淘汰、事务绑定、变量注入等企业级能力，使 Groovy 脚本能够安全、高效地嵌入到 Spring Boot 应用中。 + +## 如何使用 + +### 1. 引入依赖 + +在需要使用脚本能力的模块中添加 `springboot-starter-script` 依赖，该模块已包含 `org.apache.groovy:groovy:4.0.24`： + +```xml + + com.codingapi.springboot + springboot-starter-script + +``` + +### 2. 核心 API + +框架通过 `GroovyScriptRuntimeContext` 单例提供脚本运行时入口，主要方法如下： + +| 方法 | 说明 | +|------|------| +| `compile(script, cache)` | 编译脚本，`cache=true` 时使用 SHA256 作为 key 进行 LRU 缓存 | +| `run(script, returnType, transactionMode, binds)` | 执行整段脚本并返回结果 | +| `invoke(method, script, returnType, transactionMode, binds, args)` | 执行脚本中指定函数并返回结果 | +| `clearCache()` | 清空已编译的脚本缓存 | +| `cacheSize()` | 获取当前缓存中的脚本数量 | + +### 3. 高级封装：GroovyScript + +对于需要持久化管理的脚本，可使用 `GroovyScript` Builder 构建脚本对象，它集成了编译、执行、存储、元数据扫描等完整生命周期： + +```java +GroovyScript script = GroovyScript.builder("discount-rule-v1") + .script("def calculate(price, rate) { return price * rate }") + .method("calculate") + .returnType(BigDecimal.class) + .description("折扣计算脚本") + .tag("promotion") + .build(); +``` + +关键操作： + +- `script.compile(true)` — 预编译并缓存 +- `script.invoke(binds, args...)` — 调用指定函数 +- `script.run(binds)` — 执行整段脚本 +- `script.save()` — 持久化到 Repository +- `script.temp()` — 存入临时上下文（定时清理） +- `script.toMetadata()` — 提取脚本元数据信息 + +### 4. 事务模式 + +脚本执行支持三种事务模式，通过 `TransactionMode` 枚举控制： + +- `DEFAULT` — 不参与事务管理，直接执行 +- `READONLY` — 在只读事务中执行，适用于查询类脚本 +- `COMMIT` — 在可提交事务中执行，适用于涉及数据写入的脚本 + +### 5. 变量绑定 + +通过 `binds` Map 向脚本注入外部变量，脚本内可直接按变量名访问： + +```java +Map binds = new HashMap<>(); +binds.put("userService", userService); +binds.put("orderId", orderId); + +Object result = script.invoke(binds, param1, param2); +``` + +### 6. 缓存机制 + +- **编译缓存**：`GroovyScriptRuntime` 内部使用 `LinkedHashMap` 实现 LRU 缓存，最大容量通过配置项 `shellMaxCacheSize` 控制，超出时自动淘汰最久未使用的脚本。 +- **脚本对象缓存**：`GroovyScriptCacheContext` 维护脚本定义的 LRU 缓存（上限 10240），查找顺序为：内存缓存 → 临时上下文 → Repository 持久层。 + +## 使用实例 + +### 示例 1：执行简单计算脚本 + +```java +// 直接运行一段 Groovy 脚本 +String script = """ + def total = items.stream() + .mapToDouble { it.price * it.quantity } + .sum() + return BigDecimal.valueOf(total).setScale(2, RoundingMode.HALF_UP) + """; + +Map binds = Map.of("items", orderItems); +BigDecimal total = GroovyScriptRuntimeContext.getInstance() + .run(script, BigDecimal.class, TransactionMode.READONLY, binds); +``` + +### 示例 2：调用脚本中的函数 + +```java +String script = """ + def checkEligibility(user, minScore) { + return user.score >= minScore && user.status == 'ACTIVE' + } + """; + +Map binds = Map.of("minScore", 80); +Boolean eligible = GroovyScriptRuntimeContext.getInstance() + .invoke("checkEligibility", script, Boolean.class, + TransactionMode.DEFAULT, binds, currentUser); +``` + +### 示例 3：使用 GroovyScript 管理持久化脚本 + +```java +// 构建并保存脚本 +GroovyScript script = GroovyScript.builder("tax-calc-2024") + .script(""" + def calcTax(amount, region) { + def rate = region == 'CN' ? 0.13 : 0.08 + return (amount * rate).setScale(2, RoundingMode.HALF_UP) + } + """) + .method("calcTax") + .returnType(BigDecimal.class) + .description("2024年税率计算") + .tag("finance") + .build(); + +script.save(); // 持久化 +script.compile(true); // 预编译并缓存 + +// 后续使用时从缓存获取并执行 +GroovyScript cached = GroovyScriptCacheContext.getInstance() + .getGroovyScript("tax-calc-2024"); +BigDecimal tax = cached.invoke(TransactionMode.READONLY, null, + new BigDecimal("10000"), "CN"); +// tax = 1300.00 +``` + +### 示例 4：在事务中执行数据写入脚本 + +```java +String script = """ + def user = userRepository.findByUsername(username) + if (user != null) { + user.lastLoginTime = new Date() + user.loginCount += 1 + userRepository.save(user) + return true + } + return false + """; + +Map binds = Map.of( + "userRepository", userRepository, + "username", "admin" +); + +Boolean updated = GroovyScriptRuntimeContext.getInstance() + .run(script, Boolean.class, TransactionMode.COMMIT, binds); +``` diff --git a/docs/capabilities/index.md b/docs/capabilities/index.md new file mode 100644 index 000000000..13f602f2c --- /dev/null +++ b/docs/capabilities/index.md @@ -0,0 +1,30 @@ +# 能力（Capabilities） + +> 🔄 此文件由 `rebuild_pkr_index.py` 自动生成，请勿手动编辑。 + +## ✅ 已实现 + +| 名称 | 模块 | 描述 | 范围 | 来源 | +|------|------|------|------|------| +| [alibaba/fastjson](./alibaba/fastjson.md) | alibaba | Fastjson JSON 序列化库，提供高性能 JSON 解析和序列化 | 后端 | 框架:alibaba | +| [apache/groovy](./apache/groovy.md) | apache | Groovy 动态脚本语言，运行在 JVM 上，支持动态类型和脚本化编程 | 后端 | 框架:apache | +| [jsonwebtoken/jjwt](./jsonwebtoken/jjwt.md) | jsonwebtoken | JJWT 库，提供 JWT 令牌生成、验证和解析 | 后端 | 框架:jsonwebtoken | +| [jsqlparser/jsqlparser](./jsqlparser/jsqlparser.md) | jsqlparser | JSqlParser SQL 解析器，支持 SQL 语句解析和改写 | 后端 | 框架:jsqlparser | +| [springboot/data-jpa](./springboot/data-jpa.md) | springboot | Spring Data JPA，提供 ORM 映射、Repository 抽象和分页支持 | 后端 | 框架:springboot | +| [springboot/ioc-container](./springboot/ioc-container.md) | springboot | Spring IoC 容器，提供依赖注入、AOP、事件发布等核心功能 | 后端 | 框架:springboot | +| [springboot/security](./springboot/security.md) | springboot | Spring Security，提供认证、授权和 CSRF 防护 | 后端 | 框架:springboot | +| [springboot-starter/domain-proxy](./springboot-starter/domain-proxy.md) | springboot-starter | 领域实体变更代理，通过 CGLIB 代理拦截实体字段变更并自动推送领域事件 | 后端 | 项目自有 | +| [springboot-starter/event-system](./springboot-starter/event-system.md) | springboot-starter | 事件发布-订阅系统，支持同步/异步事件、事件循环检测、事务事件 | 后端 | 项目自有 | +| [springboot-starter/exception-handling](./springboot-starter/exception-handling.md) | springboot-starter | 全局异常处理，统一拦截 Controller 层异常并返回标准 Response | 后端 | 项目自有 | +| [springboot-starter/locale-message](./springboot-starter/locale-message.md) | springboot-starter | 国际化异常消息，支持多语言异常信息和本地化消息解析 | 后端 | 项目自有 | +| [springboot-starter/page-request](./springboot-starter/page-request.md) | springboot-starter | 动态分页查询请求，扩展 Spring PageRequest 支持 RequestFilter 动态过滤条件 | 后端 | 项目自有 | +| [springboot-starter/response-dto](./springboot-starter/response-dto.md) | springboot-starter | 统一响应封装，提供 Response/SingleResponse/MultiResponse/MapResponse 四种响应类型 | 后端 | 项目自有 | +| [springboot-starter/rest-client](./springboot-starter/rest-client.md) | springboot-starter | REST 客户端封装，提供 RestTemplate 上下文管理和 HTTPS 信任所有证书支持 | 后端 | 项目自有 | +| [springboot-starter-data-authorization/sql-interception](./springboot-starter-data-authorization/sql-interception.md) | springboot-starter-data-authorization | SQL 拦截数据权限，通过 JDBC 代理透明注入权限条件实现行级数据过滤 | 后端 | 项目自有 | +| [springboot-starter-data-fast/fast-repository](./springboot-starter-data-fast/fast-repository.md) | springboot-starter-data-fast | JPA 增强 Repository，支持 PageRequest 动态过滤查询和 HQL 构建 | 后端 | 项目自有 | +| [springboot-starter-script/groovy-runtime](./springboot-starter-script/groovy-runtime.md) | springboot-starter-script | Groovy 脚本运行时引擎，支持运行时编译、LRU 缓存、热更新和 REST API | 后端 | 项目自有 | +| [springboot-starter-security/auth-gateway](./springboot-starter-security/auth-gateway.md) | springboot-starter-security | 安全认证网关，支持 JWT 无状态认证和 Redis 有状态认证两种模式 | 后端 | 项目自有 | + +--- + +**统计**: 共 18 篇 — 已实现 18 / 计划中 0 / 已废弃 0 diff --git a/docs/capabilities/jsonwebtoken/jjwt.md b/docs/capabilities/jsonwebtoken/jjwt.md new file mode 100644 index 000000000..78f63f6fb --- /dev/null +++ b/docs/capabilities/jsonwebtoken/jjwt.md @@ -0,0 +1,188 @@ +--- +name: jsonwebtoken/jjwt +module: jsonwebtoken +description: JJWT 库，提供 JWT 令牌生成、验证和解析 +status: 已实现 +scope: 后端 +source: 框架:jsonwebtoken +import: "io.jsonwebtoken:jjwt-api" +framework_version: 0.12.6 +--- + +## 解决什么问题 + +在微服务与前后端分离架构中，服务端需要一种无状态的认证机制来识别用户身份。传统 Session 方案依赖服务端存储，难以水平扩展且不适合移动端场景。 + +JJWT（Java JSON Web Token）提供了标准的 JWT 令牌生成、签名与解析能力，解决以下核心问题： + +- **无状态认证**：将用户信息（用户名、权限、额外数据）编码进自包含的 JWT 令牌中，服务端无需维护会话存储即可验证请求身份。 +- **防篡改签名**：通过 HMAC-SHA 算法对令牌进行签名，确保令牌内容在传输过程中不被伪造或修改。 +- **令牌生命周期管理**：支持配置有效期与续期提醒时间，配合框架的 `Token.canRestToken()` 机制实现自动续期，避免用户在活跃操作中频繁重新登录。 +- **统一令牌抽象**：框架通过 `TokenGateway` 接口封装了 JWT 与 Redis 两种令牌策略，业务层只需面向接口编程，切换认证模式无需改动业务代码。 + +## 如何使用 + +### 依赖引入 + +JJWT 作为 `springboot-starter-security` 模块的传递依赖自动引入，无需单独声明： + +```xml + + com.codingapi.springboot + springboot-starter-security + +``` + +### 启用 JWT 认证 + +在 `application.properties` 中开启 JWT 并配置参数： + +```properties +# 启用 JWT 认证（默认 true） +codingapi.security.jwt.enable=true + +# HMAC 签名密钥（需大于 32 位字符串） +codingapi.security.jwt.secret-key=your-secret-key-at-least-32-characters + +# 令牌有效期（毫秒），默认 15 分钟 +codingapi.security.jwt.valid-time=900000 + +# 令牌续期提醒阈值（毫秒），默认 10 分钟后触发续期 +codingapi.security.jwt.rest-time=600000 +``` + +### 核心 API + +框架通过 `TokenGateway` 接口对外暴露令牌操作，JWT 模式下由 `JWTTokenGatewayImpl` → `JwtTokenGateway` 实现： + +| 方法 | 说明 | +|------|------| +| `create(username, authorities)` | 创建基础令牌，仅包含用户名和权限列表 | +| `create(username, authorities, extra)` | 创建带额外数据的令牌，extra 以 JSON 字符串存入 subject | +| `create(username, iv, authorities)` | 创建带加密向量（iv）的令牌，用于加解密场景 | +| `create(username, iv, authorities, extra)` | 完整创建方法，同时携带 iv 和额外数据 | +| `parser(sign)` | 解析并验证 JWT 签名，返回 `Token` 对象；签名无效或格式错误时抛出 `LocaleMessageException` | + +`Token` 对象提供以下辅助方法： + +| 方法 | 说明 | +|------|------| +| `verify()` | 校验令牌是否过期，过期则抛出 `TokenExpiredException` | +| `isExpire()` | 判断令牌是否已过期 | +| `canRestToken()` | 判断是否需要续期（未过期但已超过 restTime 阈值） | +| `parseExtra(Class)` | 将 extra 字段反序列化为指定类型 | +| `decodeIv()` | AES 解密 iv 字段 | +| `getAuthenticationToken()` | 转换为 Spring Security 的 `UsernamePasswordAuthenticationToken` | + +### 自动装配 + +当 `codingapi.security.jwt.enable=true` 时，`JWTSecurityConfiguration` 自动注册以下 Bean： + +- `SecurityJWTProperties` — JWT 配置属性 +- `JwtTokenGateway` — JWT 令牌生成与解析的核心组件 +- `TokenGateway`（`JWTTokenGatewayImpl`）— 统一的令牌网关接口实现 + +若项目中已存在自定义 `TokenGateway` Bean，自动装配不会覆盖（`@ConditionalOnMissingBean`）。 + +## 使用实例 + +### 注入 TokenGateway 创建与解析令牌 + +```java +@Service +public class AuthService { + + private final TokenGateway tokenGateway; + + public AuthService(TokenGateway tokenGateway) { + this.tokenGateway = tokenGateway; + } + + /** + * 用户登录后签发 JWT 令牌 + */ + public Token login(String username, List authorities) { + // 基础令牌 + return tokenGateway.create(username, authorities); + } + + /** + * 签发携带额外业务数据的令牌 + */ + public Token loginWithExtra(String username, List authorities, String tenantId) { + String extra = "{\"tenantId\":\"" + tenantId + "\"}"; + return tokenGateway.create(username, authorities, extra); + } + + /** + * 从请求头解析并验证令牌 + */ + public Token validateToken(String jwtSign) { + // 验签 + 解析，失败抛出 LocaleMessageException + Token token = tokenGateway.parser(jwtSign); + // 检查是否过期 + token.verify(); + return token; + } +} +``` + +### 在过滤器中使用令牌 + +```java +@Component +public class JwtAuthFilter extends OncePerRequestFilter { + + private final TokenGateway tokenGateway; + + public JwtAuthFilter(TokenGateway tokenGateway) { + this.tokenGateway = tokenGateway; + } + + @Override + protected void doFilterInternal(HttpServletRequest request, + HttpServletResponse response, + FilterChain chain) throws ServletException, IOException { + String authHeader = request.getHeader("Authorization"); + if (authHeader != null && authHeader.startsWith("Bearer ")) { + String sign = authHeader.substring(7); + try { + Token token = tokenGateway.parser(sign); + token.verify(); + + // 检查是否需要续期 + if (token.canRestToken()) { + // 重新签发令牌并通过响应头返回 + Token newToken = tokenGateway.create( + token.getUsername(), token.getAuthorities(), token.getExtra()); + response.setHeader("X-New-Token", newToken.getToken()); + } + + // 设置 Spring Security 认证上下文 + SecurityContextHolder.getContext() + .setAuthentication(token.getAuthenticationToken()); + } catch (Exception e) { + response.setStatus(HttpServletResponse.SC_UNAUTHORIZED); + return; + } + } + chain.doFilter(request, response); + } +} +``` + +### 解析令牌中的额外数据 + +```java +// 定义业务数据结构 +public class UserContext { + private String tenantId; + private String department; + // getter/setter +} + +// 从令牌中提取 +Token token = tokenGateway.parser(jwtSign); +UserContext ctx = token.parseExtra(UserContext.class); +String tenantId = ctx.getTenantId(); +``` diff --git a/docs/capabilities/jsqlparser/jsqlparser.md b/docs/capabilities/jsqlparser/jsqlparser.md new file mode 100644 index 000000000..67392c83a --- /dev/null +++ b/docs/capabilities/jsqlparser/jsqlparser.md @@ -0,0 +1,138 @@ +--- +name: jsqlparser/jsqlparser +module: jsqlparser +description: JSqlParser SQL 解析器，支持 SQL 语句解析和改写 +status: 已实现 +scope: 后端 +source: 框架:jsqlparser +import: "com.github.jsqlparser:jsqlparser" +framework_version: 5.0 +--- + +## 解决什么问题 + +在企业级应用中，经常需要在运行时对 SQL 语句进行动态分析和改写，典型场景包括： + +- **数据权限过滤**：在 SQL 执行前透明注入行级权限条件（如 `WHERE dept_id IN (...)`），无需修改业务代码 +- **SQL 审计与监控**：解析 SQL 结构以提取表名、操作类型等元信息 +- **多租户隔离**：自动为查询追加租户过滤条件 +- **SQL 合法性校验**：判断传入的 SQL 是否为合法的 SELECT 查询，防止误操作 + +JSqlParser 提供了完整的 SQL 语法树解析能力，使上述场景可以在不依赖特定数据库方言的前提下，以统一的方式对 SQL 进行结构化访问和改写。在本框架中，它作为 `springboot-starter-data-authorization` 模块的核心依赖，支撑了数据权限 SQL 增强器的实现。 + +## 如何使用 + +### Maven 依赖 + +```xml + + com.github.jsqlparser + jsqlparser + 5.0 + +``` + +### 核心 API + +| 类 / 接口 | 说明 | +|-----------|------| +| `CCJSqlParserUtil.parse(sql)` | 将 SQL 字符串解析为 `Statement` 语法树对象 | +| `Statement` | SQL 语句的顶层抽象，可向下转型为 `Select`、`Insert`、`Update`、`Delete` 等 | +| `Select` / `PlainSelect` | 查询语句节点，提供 `getFromItem()`、`getWhere()`、`getJoins()` 等方法访问子句 | +| `Expression` | WHERE / ON 条件表达式树，支持 `AndExpression`、`OrExpression`、`InExpression` 等 | +| `Table` | 表引用节点，包含表名和别名信息 | +| `Join` | JOIN 子句节点，可通过 `getRightItem()` 获取关联表或子查询 | +| `statement.toString()` | 将修改后的语法树重新序列化为 SQL 字符串 | + +### 典型使用流程 + +1. 调用 `CCJSqlParserUtil.parse(sql)` 获得 `Statement` 对象 +2. 通过 `instanceof` 判断语句类型并向下转型 +3. 遍历语法树节点，读取或修改表名、条件、JOIN 等信息 +4. 调用 `toString()` 输出改写后的 SQL + +## 使用实例 + +### 示例 1：判断 SQL 是否为 SELECT 查询 + +```java +import net.sf.jsqlparser.parser.CCJSqlParserUtil; +import net.sf.jsqlparser.statement.Statement; +import net.sf.jsqlparser.statement.select.Select; + +public class SQLUtils { + + public static boolean isQuerySql(String sql) { + if (sql == null || sql.trim().isEmpty()) { + return false; + } + try { + Statement statement = CCJSqlParserUtil.parse(sql); + return statement instanceof Select; + } catch (Exception e) { + return false; + } + } +} +``` + +### 示例 2：解析 SQL 并向 WHERE 子句注入权限条件 + +以下示例展示了框架中 `DataPermissionSQLEnhancer` 的核心思路——解析 SQL 后遍历所有表和 JOIN，按需追加数据权限过滤条件： + +```java +import net.sf.jsqlparser.expression.Expression; +import net.sf.jsqlparser.expression.operators.conditional.AndExpression; +import net.sf.jsqlparser.parser.CCJSqlParserUtil; +import net.sf.jsqlparser.schema.Table; +import net.sf.jsqlparser.statement.Statement; +import net.sf.jsqlparser.statement.select.*; + +public class DataPermissionExample { + + public String enhanceWithPermission(String sql, Expression permissionCondition) throws Exception { + // 1. 解析 SQL + Statement statement = CCJSqlParserUtil.parse(sql); + + if (statement instanceof Select) { + PlainSelect plainSelect = ((Select) statement).getPlainSelect(); + + // 2. 获取原有 WHERE 条件 + Expression existingWhere = plainSelect.getWhere(); + + // 3. 用 AND 拼接权限条件 + if (existingWhere != null) { + plainSelect.setWhere(new AndExpression(existingWhere, permissionCondition)); + } else { + plainSelect.setWhere(permissionCondition); + } + + // 4. 处理 JOIN 中的表（类似逻辑，此处省略） + } + + // 5. 返回改写后的 SQL + return statement.toString(); + } +} +``` + +### 示例 3：递归处理子查询和 UNION + +对于包含子查询或 `UNION` 的复杂 SQL，需要递归遍历语法树以确保权限条件被注入到每一层查询中： + +```java +private void deepMatch(Select select) throws Exception { + if (select instanceof PlainSelect) { + PlainSelect plainSelect = select.getPlainSelect(); + enhanceDataPermissionInSelect(plainSelect); + } + if (select instanceof SetOperationList) { + SetOperationList setOperationList = select.getSetOperationList(); + for (Select subSelect : setOperationList.getSelects()) { + deepMatch(subSelect.getPlainSelect()); + } + } +} +``` + +> **注意**：JSqlParser 5.0 对 API 进行了部分调整（如 `ParenthesedSelect` 替代旧版 `SubSelect`），升级时请参考官方迁移指南。 diff --git a/docs/capabilities/springboot-starter-data-authorization/sql-interception.md b/docs/capabilities/springboot-starter-data-authorization/sql-interception.md new file mode 100644 index 000000000..b2584477a --- /dev/null +++ b/docs/capabilities/springboot-starter-data-authorization/sql-interception.md @@ -0,0 +1,229 @@ +--- +name: springboot-starter-data-authorization/sql-interception +module: springboot-starter-data-authorization +description: SQL 拦截数据权限，通过 JDBC 代理透明注入权限条件实现行级数据过滤 +status: 已实现 +scope: 后端 +source: 项目自有 +import: "com.codingapi.springboot:springboot-starter-data-authorization" +symbols: + - SQLRunningContext + - ConnectionProxy + - PreparedStatementProxy + - StatementProxy + - DefaultSQLInterceptor +content_hash: d1ffbdc7fb8d45d6cc91248e02de5373e4ac8f0b417ecf34cd62ecf6709a2641 +--- + +## 解决什么问题 + +在企业级应用中，不同角色的用户只能看到自己有权限访问的数据（行级数据权限）。传统实现方式存在以下痛点： + +- **侵入性强**：需要在每个 Service/Repository 方法中手动拼接权限条件，代码散落各处 +- **容易遗漏**：新增查询接口时可能忘记添加权限过滤，导致数据泄露 +- **维护困难**：权限规则变更时需要修改大量业务代码 +- **与业务耦合**：权限逻辑与业务查询逻辑混杂，违反单一职责原则 + +SQL 拦截数据权限通过 JDBC 代理层实现了完全透明的权限注入： + +- **零侵入**：业务代码无需任何修改，所有 SELECT 查询自动注入权限条件 +- **全覆盖**：无论通过 JPA、MyBatis、原生 JDBC 还是其他 ORM 框架执行的 SQL，都会被统一拦截 +- **灵活配置**：通过 `RowHandler` 接口按表名自定义权限规则，支持 WHERE 条件和 JOIN 关联两种注入模式 +- **可跳过**：提供 `skipDataAuthorization()` API，允许特定场景下临时绕过权限检查 +- **SQL 解析增强**：使用 JSqlParser 解析 SQL AST，精确识别表名和别名，支持子查询、UNION、JOIN 等复杂 SQL 结构 + +## 如何使用 + +### 1. 引入依赖 + +```xml + + com.codingapi.springboot + springboot-starter-data-authorization + +``` + +### 2. 架构概览 + +整个拦截链路由以下组件构成： + +``` +JDBC Driver(AuthorizationJdbcDriver) → ConnectionProxy → PreparedStatementProxy / StatementProxy + ↓ + SQLRunningContext.intercept(sql) + ↓ + SQLInterceptor (DefaultSQLInterceptor) + ↓ + DataPermissionSQLEnhancer (JSqlParser) + ↓ + RowHandler.handler(tableName, alias) + ↓ + Condition (WHERE / JOIN 条件注入) +``` + +Connection 的包装实际发生在 `AuthorizationJdbcDriver.connect()`。该类是一个 JDBC Driver 装饰器，类加载时自动向 `DriverManager` 注册；建立连接时根据 JDBC URL 查找真实的数据库驱动并委托建连，再将返回的 `Connection` 包装为 `ConnectionProxy`。使用时需将数据源的 driver 指向该类（JDBC URL 保持不变）： + +```properties +spring.datasource.driver-class-name=com.codingapi.springboot.authorization.jdbc.AuthorizationJdbcDriver +``` + +### 3. 核心组件说明 + +#### ConnectionProxy + +JDBC `Connection` 的代理实现。在 `prepareStatement()`、`createStatement()`、`prepareCall()` 等方法中拦截 SQL，调用 `SQLRunningContext.intercept(sql)` 获取改写后的 SQL，并将 `SQLExecuteState` 传递给下游的 Statement 代理。 + +#### PreparedStatementProxy / StatementProxy + +JDBC `PreparedStatement` 和 `Statement` 的代理实现。在执行 `executeQuery()`、`execute()` 等方法时，确保使用经过权限改写的 SQL。对于直接传入 SQL 字符串的方法（如 `executeQuery(String sql)`），会再次调用 `SQLRunningContext.intercept()` 进行拦截。查询结果通过 `ResultSetProxy` 包装返回。 + +#### SQLRunningContext + +SQL 拦截的核心调度器（单例模式），负责： +- 从 `SQLInterceptorContext` 获取当前 `SQLInterceptor` 实例 +- 通过 `ThreadLocal skipInterceptor` 控制是否跳过拦截 +- 调用 `SQLInterceptor.beforeHandler()` 判断是否需要拦截（默认仅拦截 SELECT 语句） +- 调用 `SQLInterceptor.postHandler()` 执行 SQL 改写 +- 提供 `skipDataAuthorization(Supplier/Runnable)` API 临时跳过权限检查 + +#### DefaultSQLInterceptor + +默认的 SQL 拦截器实现，包含三个阶段的处理： +- `beforeHandler(sql)`：通过 `SQLUtils.isQuerySql()` 判断是否为查询语句，仅 SELECT 会被拦截 +- `postHandler(sql)`：创建 `DataPermissionSQLEnhancer`，使用 JSqlParser 解析 SQL 并通过 `RowHandler` 获取权限条件，返回增强后的 SQL +- `afterHandler(sql, newSql, exception)`：日志记录，当配置 `codingapi.data-authorization.show-sql=true` 时输出改写后的 SQL + +#### RowHandler + +行级权限处理器接口，由业务方实现： + +```java +public interface RowHandler { + Condition handler(String subSql, String tableName, String tableAlias); +} +``` + +返回值 `Condition` 支持两种注入模式： +- **WHERE 条件**：`Condition.customCondition("dept_id IN (1,2,3)")` — 在 WHERE 子句中追加 AND 条件 +- **JOIN 关联**：通过 `JoinConditionSQL` 添加 INNER/LEFT/RIGHT JOIN 关联表 + +### 4. 跳过数据权限 + +在某些管理操作或系统任务中需要绕过数据权限： + +```java +// 方式一：Lambda 表达式 +List allUsers = SQLRunningContext.getInstance() + .skipDataAuthorization(() -> userRepository.findAll()); + +// 方式二：Runnable +SQLRunningContext.getInstance() + .skipDataAuthorization(() -> { + reportService.generateMonthlyReport(); + }); +``` + +## 使用实例 + +### 示例一：按部门过滤数据 + +```java +@Component +public class DeptRowHandler implements RowHandler { + + @Override + public Condition handler(String subSql, String tableName, String tableAlias) { + // 仅对 employee 表注入权限条件 + if ("employee".equalsIgnoreCase(tableName)) { + List deptIds = SecurityContext.getCurrentDeptIds(); + if (deptIds == null || deptIds.isEmpty()) { + return Condition.emptyCondition(); // 无权限，返回 null 不注入 + } + String inClause = deptIds.stream() + .map(String::valueOf) + .collect(Collectors.joining(",")); + return Condition.customCondition( + String.format("%s.dept_id IN (%s)", tableAlias, inClause) + ); + } + // 其他表不注入权限条件 + return Condition.emptyCondition(); + } +} +``` + +效果：原始 SQL `SELECT * FROM employee WHERE status = 'active'` 被改写为： +```sql +SELECT * FROM employee WHERE dept_id IN (1,2,3) AND status = 'active' +``` + +### 示例二：通过 JOIN 关联实现跨表权限 + +```java +@Component +public class ProjectRowHandler implements RowHandler { + + @Override + public Condition handler(String subSql, String tableName, String tableAlias) { + if ("project".equalsIgnoreCase(tableName)) { + Condition condition = new Condition(); + // 通过 JOIN 关联成员表，只查询当前用户参与的项目 + // 构造器参数顺序：(Type type, String tableName, String tableAlias, String onCondition) + JoinConditionSQL joinSQL = new JoinConditionSQL( + JoinConditionSQL.Type.INNER, + "project_member", + "pm", + String.format("pm.project_id = %s.id AND pm.user_id = %d", + tableAlias, SecurityContext.getCurrentUserId()) + ); + condition.addConditionSQL(joinSQL); + return condition; + } + return Condition.emptyCondition(); + } +} +``` + +效果：原始 SQL `SELECT * FROM project WHERE status = 'open'` 被改写为： +```sql +SELECT * FROM project +INNER JOIN project_member pm ON pm.project_id = project.id AND pm.user_id = 1001 +WHERE status = 'open' +``` + +### 示例三：自定义 SQLInterceptor + +如需替换默认的拦截逻辑（例如增加缓存或审计），可实现 `SQLInterceptor` 接口并注册为 Spring Bean： + +```java +@Component +public class AuditSQLInterceptor implements SQLInterceptor { + + @Override + public boolean beforeHandler(String sql) { + // 仅拦截 SELECT 且不包含系统表的查询 + return SQLUtils.isQuerySql(sql) && !sql.contains("sys_config"); + } + + @Override + public DataPermissionSQL postHandler(String sql) throws SQLException { + RowHandler rowHandler = RowHandlerContext.getInstance().getRowHandler(); + DataPermissionSQLEnhancer enhancer = new DataPermissionSQLEnhancer(sql, rowHandler); + return new DataPermissionSQL(sql, enhancer.getNewSQL(), enhancer.getTableAlias()); + } + + @Override + public void afterHandler(String sql, String newSql, SQLException exception) { + // 记录审计日志 + AuditLog.record(sql, newSql, exception); + } +} +``` + +### 内部工作原理 + +1. **连接代理**：`AuthorizationJdbcDriver.connect()` 将真实驱动返回的 `Connection` 包装为 `ConnectionProxy` +2. **SQL 拦截时机**：当调用 `connection.prepareStatement(sql)` 时，`ConnectionProxy` 立即调用 `SQLRunningContext.intercept(sql)` 对 SQL 进行改写 +3. **递归解析**：`DataPermissionSQLEnhancer` 使用 JSqlParser 解析 SQL AST，深度遍历 PlainSelect、SetOperationList（UNION）、子查询、JOIN 中的子 Select，对每个涉及的表调用 `RowHandler` +4. **条件注入**：`WhereConditionSQLHandler` 将 WHERE 条件通过 AND 拼接到原有 WHERE 子句；`JoinConditionSQLHandler` 向 FROM 子句追加 JOIN 关联 +5. **防重入**：`SQLRunningContext` 使用 ThreadLocal 标记，在拦截器内部执行的查询不会被二次拦截 diff --git a/docs/capabilities/springboot-starter-data-fast/fast-repository.md b/docs/capabilities/springboot-starter-data-fast/fast-repository.md new file mode 100644 index 000000000..d58486bdb --- /dev/null +++ b/docs/capabilities/springboot-starter-data-fast/fast-repository.md @@ -0,0 +1,177 @@ +--- +name: springboot-starter-data-fast/fast-repository +module: springboot-starter-data-fast +description: JPA 增强 Repository，支持 PageRequest 动态过滤查询和 HQL 构建 +status: 已实现 +scope: 后端 +source: 项目自有 +import: "com.codingapi.springboot:springboot-starter-data-fast" +symbols: + - FastRepository +content_hash: f840da63a739c7b4e23172d900dd2347480547290e1f947bc45f54f3e9916a53 +--- + +## 解决什么问题 + +在标准 Spring Data JPA 开发中，动态条件查询通常需要手动编写 `Specification`、`QueryDSL` 或拼接 HQL，代码冗长且难以维护。当业务列表页面需要支持多字段组合筛选（等于、模糊、范围、IN 等）时，开发者往往要为每种查询场景编写独立的 Repository 方法或复杂的 Specification 构建逻辑。 + +`FastRepository` 通过扩展 `JpaRepository` 和 `JpaSpecificationExecutor`，提供了基于 `PageRequest` 的声明式动态查询能力： + +- **findAll → Example/HQL 自动切换**：`findAll(PageRequest)` 有 Filter 条件时，全部为简单等值条件则构建 Spring Data `Example` 查询；包含 LIKE/范围/IN/OR 等复杂条件时自动切换参数化 HQL，零额外代码 +- **pageRequest → HQL 动态构建**：需要 LIKE、范围、IN、OR 等复杂条件时，必须显式调用 `pageRequest(PageRequest)`，由 `DynamicSQLBuilder` 构建参数化 HQL，避免 SQL 注入风险 +- **SearchRequest 集成**：支持从 HTTP 请求参数中自动解析 filter、sort 条件，适用于前端列表页的通用查询接口 +- **OR/AND 组合过滤**：支持嵌套的 OR/AND 条件组合，满足复杂业务筛选需求 + +## 如何使用 + +### 1. 定义 Repository 接口 + +继承 `FastRepository` 即可获得全部动态查询能力： + +```java +public interface UserEntityRepository extends FastRepository { + // 标准 JpaRepository 方法仍然可用 + UserEntity getUserEntityByUsername(String username); +} +``` + +### 2. 使用 PageRequest 进行动态过滤查询 + +```java +// 创建分页请求并添加等值过滤条件 +PageRequest request = PageRequest.of(0, 20); +request.addFilter("name", "张三"); // 等值匹配（默认 EQUAL） +request.addFilter("status", "active"); // 等值匹配 + +// 方式一：findAll —— 等值条件走 Example 查询，复杂条件自动切换 HQL +Page page = repository.findAll(request); + +// 方式二：pageRequest —— 需要 LIKE/范围/IN/OR 等复杂条件时必须显式调用，走 HQL +PageRequest hqlRequest = PageRequest.of(0, 20); +hqlRequest.addFilter("age", Relation.GREATER_THAN, 18); // 大于 +hqlRequest.addFilter("email", Relation.LIKE, "gmail"); // 模糊查询 +Page page2 = repository.pageRequest(hqlRequest); +``` + +### 3. 支持的过滤关系（Relation） + +| Relation | 说明 | HQL 示例 | +|----------|------|----------| +| EQUAL（默认） | 等于 | `name = ?1` | +| NOT_EQUAL | 不等于 | `name != ?1` | +| GREATER_THAN | 大于 | `age > ?1` | +| LESS_THAN | 小于 | `age < ?1` | +| GREATER_THAN_EQUAL | 大于等于 | `age >= ?1` | +| LESS_THAN_EQUAL | 小于等于 | `age <= ?1` | +| LIKE | 全模糊 | `name LIKE ?1`（自动加 `%value%`） | +| LEFT_LIKE | 左模糊 | `name LIKE ?1`（自动加 `%value`） | +| RIGHT_LIKE | 右模糊 | `name LIKE ?1`（自动加 `value%`） | +| IN | 包含 | `id IN (?1)` | +| NOT_IN | 不包含 | `id NOT IN (?1)` | +| BETWEEN | 区间 | `age BETWEEN ?1 AND ?2` | +| IS_NULL | 为空 | `name IS NULL` | +| IS_NOT_NULL | 非空 | `name IS NOT NULL` | + +> 注意：以上 Relation 在 `pageRequest()` / `searchRequest()` 中完整生效；`findAll()` 会按条件类型自动选择——全部等值条件走 Example 查询，包含 LIKE/范围/IN/OR 等复杂条件时自动切换 HQL。 + +### 4. 使用 SearchRequest 从 HTTP 请求自动解析 + +```java +// 在 Controller 中使用 SearchRequest，自动从 URL 参数解析 filter 和 sort +@GetMapping("/users") +public MultiResponse list() { + SearchRequest searchRequest = new SearchRequest(); + searchRequest.addFilter("status", "active"); // 追加服务端固定条件 + Page page = userRepository.searchRequest(searchRequest); + return MultiResponse.of(page.getContent()); +} +``` + +前端通过 URL 参数传递动态条件： +- `?filter=eyJuYW1lIjpbIuW8oCJdfQ==`（Base64 编码的 JSON：`{"name":["张"]}`) +- `?sort=eyJjcmVhdGVUaW1lIjoiZGVzY2VuZCJ9`（Base64 编码的 JSON：`{"createTime":"descend"}`) + +### 5. OR / AND 组合条件 + +```java +PageRequest request = PageRequest.of(0, 20); + +// OR 条件：name = '张三' OR name = '李四' +request.orFilters( + new Filter("name", "张三"), + new Filter("name", "李四") +); + +// AND 条件组 +request.andFilter( + new Filter("age", Relation.GREATER_THAN_EQUAL, 18), + new Filter("status", "active") +); +``` + +## 使用实例 + +### 完整示例：用户列表查询 + +```java +@Service +public class UserQueryService { + + @Resource + private UserEntityRepository userRepository; + + /** + * 基础动态查询 - 包含 LIKE/范围条件，显式使用 pageRequest 走 HQL + */ + public Page findUsers(String name, Integer minAge, String status) { + PageRequest request = PageRequest.of(0, 20); + if (name != null) { + request.addFilter("name", Relation.LIKE, name); + } + if (minAge != null) { + request.addFilter("age", Relation.GREATER_THAN_EQUAL, minAge); + } + if (status != null) { + request.addFilter("status", status); + } + return userRepository.pageRequest(request); + } + + /** + * 复杂 HQL 查询 - 带排序 + */ + public Page findActiveUsersWithSort() { + PageRequest request = PageRequest.of(0, 20, Sort.by("createTime").descending()); + request.addFilter("status", "active"); + request.addFilter("age", Relation.BETWEEN, 18, 65); + return userRepository.pageRequest(request); + } + + /** + * 前端驱动的通用查询接口 + */ + public Page searchFromHttpRequest() { + SearchRequest searchRequest = new SearchRequest(); + // 追加服务端安全条件，防止越权查询 + searchRequest.addFilter("deleted", false); + return userRepository.searchRequest(searchRequest); + } +} +``` + +### 内部工作原理 + +`FastRepository.findAll(PageRequest)` 的执行流程： + +1. 检查 `request.hasFilter()` — 无过滤条件时直接委托给 Spring Data 的标准 `findAll(PageRequest)` +2. 有过滤条件时，通过 `RequestFilter.isAllEqualFilter()` 判断是否全部为简单等值条件 +3. 全部等值条件：通过 `ExampleBuilder` 构建 `Example` 对象（按实体属性名匹配 Filter，取 `value[0]` 写入实体字段），传入 `findAll(Example, Pageable)` 执行查询 +4. 包含复杂条件（LIKE、范围、IN、NOT_EQUAL、IS_NULL、OR/AND 组合等）：自动转发 `pageRequest()`，由 `DynamicSQLBuilder` 构建参数化 HQL 执行查询 + +> 说明：`ExampleBuilder` 只处理 EQUAL 等值条件；过滤条件写入实体属性失败（如类型转换失败）时显式抛出 `IllegalStateException`，不再静默忽略。 + +`FastRepository.pageRequest(PageRequest)` 的执行流程： + +1. 通过 `DynamicSQLBuilder` 根据 Filter 列表动态构建 HQL 语句和 COUNT 语句 +2. 所有值通过参数化绑定（`?1`, `?2`...），防止 SQL 注入 +3. 调用 `dynamicPageQuery(hql, countHql, request, params)` 执行分页查询 diff --git a/docs/capabilities/springboot-starter-script/groovy-runtime.md b/docs/capabilities/springboot-starter-script/groovy-runtime.md new file mode 100644 index 000000000..1331673c8 --- /dev/null +++ b/docs/capabilities/springboot-starter-script/groovy-runtime.md @@ -0,0 +1,163 @@ +--- +name: springboot-starter-script/groovy-runtime +module: springboot-starter-script +description: Groovy 脚本运行时引擎，支持运行时编译、LRU 缓存、热更新和 REST API +status: 已实现 +scope: 后端 +source: 项目自有 +import: "com.codingapi.springboot:springboot-starter-script" +symbols: + - GroovyScriptRuntime + - GroovyScript + - GroovyScriptCacheContext + - GroovyScriptRuntimeContext + - GroovyScriptController +content_hash: deddb103b5a58509ca7c08ace4195760e618f5b07782cfcb857fc1326d4ae526 +--- + +## 解决什么问题 + +在企业应用中，部分业务逻辑需要频繁调整但不希望每次都经历"改代码→编译→部署"的完整周期。典型场景包括： + +- **动态规则计算**：促销折扣、费率计算、风控阈值等业务规则经常变化 +- **自定义报表/导出**：不同租户或部门的报表格式差异大，用脚本比硬编码更灵活 +- **临时数据处理**：运维脚本、数据修复等一次性任务 + +`groovy-runtime` 提供了嵌入式的 Groovy 脚本执行引擎，具备以下特性： + +- **运行时编译执行**：无需重启应用即可加载和执行新脚本 +- **LRU 编译缓存**：基于 SHA256 指纹缓存已编译的 Script 对象，避免重复编译开销 +- **三级存储**：内存缓存 → 临时存储 → 持久化仓库，兼顾性能和可靠性 +- **事务集成**：支持只读（READONLY）和提交（COMMIT）两种事务模式 +- **REST API**：内置 Controller 提供脚本编译、查询、保存接口，方便管理端对接 + +## 如何使用 + +### 核心组件 + +| 组件 | 职责 | +|------|------| +| `GroovyScriptRuntime` | 底层执行引擎：GroovyShell 封装、LRU 编译缓存、invoke/run 方法、事务控制 | +| `GroovyScriptRuntimeContext` | Runtime 的单例上下文，从配置读取 `shellMaxCacheSize` 初始化 | +| `GroovyScript` | 脚本领域对象：封装 key/script/method/returnType/binds 等元信息，提供 compile/run/invoke 快捷方法 | +| `GroovyScriptCacheContext` | 脚本对象的 LRU 缓存（最大 10240 条），三级查找：缓存 → 临时存储 → Repository | +| `GroovyScriptController` | REST 端点 `/api/groovy-script/*`，提供 compile/getScript/getMetadata/save 接口 | + +### 直接执行脚本 + +通过 `GroovyScriptRuntimeContext` 单例直接运行脚本： + +```java +GroovyScriptRuntimeContext ctx = GroovyScriptRuntimeContext.getInstance(); + +// 简单执行 +String result = ctx.run("'hello ' + name", String.class, + TransactionMode.DEFAULT, Map.of("name", "world")); + +// 调用脚本中的函数 +int sum = ctx.invoke("add", "def add(a,b){ a + b }", int.class, + TransactionMode.DEFAULT, null, 3, 5); +``` + +### 使用 GroovyScript 对象 + +对于需要持久化和复用的脚本，使用 `GroovyScript` 封装： + +```java +GroovyScript script = GroovyScript.builder("discount_calc") + .script(""" + def calculate(price, rate) { + return price * rate + } + """) + .method("calculate") + .returnType(BigDecimal.class) + .description("折扣计算脚本") + .tag("pricing") + .build(); + +// 编译并缓存 +script.compile(true); + +// 执行 +BigDecimal result = script.invoke(Map.of(), new BigDecimal("100"), new BigDecimal("0.85")); + +// 持久化到仓库 +script.save(); +``` + +### 事务模式 + +`TransactionMode` 支持三种模式： + +| 模式 | 行为 | +|------|------| +| `DEFAULT` | 不参与事务，由调用方自行控制 | +| `READONLY` | 在只读事务中执行，适合查询类脚本 | +| `COMMIT` | 在可提交事务中执行，适合写入类脚本 | + +### REST API + +内置的 `GroovyScriptController` 提供以下端点： + +| 方法 | 路径 | 说明 | +|------|------|------| +| POST | `/api/groovy-script/compile` | 编译脚本（body: `{script, cache}`) | +| GET | `/api/groovy-script/getScript?key=` | 获取脚本内容 | +| GET | `/api/groovy-script/getMetadata?key=` | 获取脚本元数据 | +| POST | `/api/groovy-script/save` | 保存脚本（编译+持久化） | + +## 使用实例 + +以下示例展示一个完整的动态折扣计算场景： + +```java +// 1. 创建并保存折扣计算脚本 +GroovyScript discountScript = GroovyScript.builder("member_discount") + .script(""" + def calcDiscount(amount, memberLevel) { + switch(memberLevel) { + case 'GOLD': return amount * 0.8 + case 'SILVER': return amount * 0.9 + default: return amount + } + } + """) + .method("calcDiscount") + .returnType(BigDecimal.class) + .description("会员折扣计算") + .typeOne("pricing") + .typeTwo("discount") + .build(); + +// 编译并持久化 +discountScript.compile(true); +discountScript.save(); + +// 2. 后续使用时直接从缓存获取 +GroovyScript cached = GroovyScriptCacheContext.getInstance() + .getGroovyScript("member_discount"); + +// 3. 执行业务计算 +BigDecimal originalAmount = new BigDecimal("500"); +BigDecimal finalPrice = cached.invoke( + TransactionMode.READONLY, null, originalAmount, "GOLD"); +// finalPrice = 400.0 + +// 4. 热更新：修改脚本后重新保存即可生效 +cached.setScript(""" + def calcDiscount(amount, memberLevel) { + switch(memberLevel) { + case 'DIAMOND': return amount * 0.7 + case 'GOLD': return amount * 0.8 + case 'SILVER': return amount * 0.9 + default: return amount + } + } +"""); +cached.compile(true); +cached.save(); +// 下次 invoke 自动使用新版本 +``` + +缓存机制说明：`GroovyScriptRuntime` 内部以脚本内容的 SHA256 作为缓存 key，相同内容的脚本不会重复编译。当脚本内容变更后，SHA256 值改变，自动触发重新编译。LRU 策略确保内存占用可控，默认上限可通过配置项调整。 diff --git a/docs/capabilities/springboot-starter-security/auth-gateway.md b/docs/capabilities/springboot-starter-security/auth-gateway.md new file mode 100644 index 000000000..f3161fd1d --- /dev/null +++ b/docs/capabilities/springboot-starter-security/auth-gateway.md @@ -0,0 +1,201 @@ +--- +name: springboot-starter-security/auth-gateway +module: springboot-starter-security +description: 安全认证网关，支持 JWT 无状态认证和 Redis 有状态认证两种模式 +status: 已实现 +scope: 后端 +source: 项目自有 +import: "com.codingapi.springboot:springboot-starter-security" +symbols: + - TokenGateway + - TokenContext + - Token + - MyLoginFilter + - MyAuthenticationFilter +content_hash: f387cbcf0fa1de5a7c51bf0d2afb16e342b53d42ad2031f6741cb6db4e4e2625 +--- + +## 解决什么问题 + +在企业级 Web 应用中，用户认证是安全体系的第一道防线。Spring Security 原生提供的表单登录和 Session 机制不适合前后端分离架构，开发者通常需要自行实现以下能力： + +- **Token 生命周期管理**：创建、解析、过期校验、自动续期 +- **多认证模式切换**：JWT 无状态模式适合微服务和移动端，Redis 有状态模式适合需要服务端主动踢人的管理后台 +- **登录流程定制**：在认证前后插入自定义逻辑（验证码校验、登录日志、额外业务数据注入等） +- **统一 JSON 响应**：认证成功/失败均返回标准 `Response` 格式，而非 Spring Security 默认的重定向或 HTML 页面 + +auth-gateway 将上述能力封装为开箱即用的安全网关层，通过 `TokenGateway` 策略接口抽象 Token 的创建与解析，配合 `MyLoginFilter`（登录拦截）和 `MyAuthenticationFilter`（请求鉴权拦截）两个 Servlet Filter，实现完整的认证闭环。开发者只需通过配置选择 JWT 或 Redis 模式，即可零代码获得生产级认证能力。 + +## 如何使用 + +### 1. 引入依赖 + +```xml + + com.codingapi.springboot + springboot-starter-security + +``` + +### 2. 选择认证模式 + +通过 `application.properties` 启用其中一种模式（二选一）： + +**JWT 无状态模式：** + +```properties +codingapi.security.jwt.enable=true +codingapi.security.jwt.secret-key=your-secret-key-must-be-at-least-32-chars +codingapi.security.jwt.valid-time=900000 # Token 有效期 15 分钟（毫秒） +codingapi.security.jwt.rest-time=600000 # 10 分钟后自动续期（毫秒） +``` + +**Redis 有状态模式：** + +```properties +codingapi.security.redis.enable=true +codingapi.security.redis.valid-time=900000 +codingapi.security.redis.rest-time=600000 +``` + +### 3. 配置安全策略 + +```properties +# 需要认证的 URL 模式（逗号分隔） +codingapi.security.authenticated-urls=/api/** + +# 免认证 URL 模式 +codingapi.security.ignore-urls=/open/**,/#/** + +# 登录接口地址 +codingapi.security.login-processing-url=/user/login + +# 登出接口地址 +codingapi.security.logout-url=/user/logout +``` + +### 4. 核心 API + +| 类 | 说明 | +|---|---| +| `TokenGateway` | Token 策略接口，提供 `create()` 和 `parser()` 方法。框架根据配置自动注入 `JWTTokenGatewayImpl` 或 `RedisTokenGatewayImpl` | +| `Token` | Token 数据对象，包含 username、authorities、extra、expireTime、remindTime 等字段，支持 `verify()` 过期校验和 `canRestToken()` 自动续期判断 | +| `TokenContext` | 线程安全的 Token 上下文工具类。`TokenContext.current()` 获取当前登录用户的 Token；`TokenContext.pushExtra()` / `getExtra()` 传递额外业务数据 | +| `SecurityLoginHandler` | 登录扩展点接口。实现 `preHandle()` 可在认证前做自定义校验；实现 `postHandle()` 可定制登录成功响应 | +| `AuthenticationTokenFilter` | 鉴权后扩展点接口。每次请求通过 Token 验证后回调，可用于刷新用户缓存等场景 | + +### 5. 自定义 UserDetailsService + +框架默认提供内存用户（admin/user），生产环境需自行实现： + +```java +@Service +public class CustomUserDetailsService implements UserDetailsService { + @Override + public UserDetails loadUserByUsername(String username) throws UsernameNotFoundException { + // 从数据库加载用户信息 + } +} +``` + +## 使用实例 + +### 示例 1：自定义登录处理器 + +在登录前校验验证码，登录后返回额外的用户信息： + +```java +@Component +public class CustomSecurityLoginHandler implements SecurityLoginHandler { + + @Override + public void preHandle(HttpServletRequest request, HttpServletResponse response, + LoginRequest loginRequest) throws Exception { + // 校验验证码 + String captcha = loginRequest.getString("captcha"); + if (captcha == null || !captchaService.verify(captcha)) { + throw new AuthenticationServiceException("验证码错误"); + } + } + + @Override + public LoginResponse postHandle(HttpServletRequest request, HttpServletResponse response, + LoginRequest loginRequest, UserDetails user, Token token) { + LoginResponse loginResponse = new LoginResponse(); + loginResponse.setToken(token.getToken()); + loginResponse.setUsername(token.getUsername()); + loginResponse.setAuthorities(token.getAuthorities()); + // 附加用户头像等信息 + Map data = new HashMap<>(); + data.put("avatar", "/static/avatar/default.png"); + loginResponse.setData(data); + return loginResponse; + } +} +``` + +### 示例 2：在业务代码中获取当前用户 + +```java +@RestController +@RequestMapping("/api/profile") +public class ProfileController { + + @GetMapping + public SingleResponse> getProfile() { + // 从 SecurityContext 获取当前 Token + Token token = TokenContext.current(); + String username = token.getUsername(); + List roles = token.getAuthorities(); + + // 解析 extra 中的自定义数据 + UserInfo extra = token.parseExtra(UserInfo.class); + + Map profile = new HashMap<>(); + profile.put("username", username); + profile.put("roles", roles); + profile.put("department", extra != null ? extra.getDepartment() : null); + return SingleResponse.of(profile); + } +} +``` + +### 示例 3：鉴权后刷新用户缓存 + +```java +@Component +public class CacheRefreshFilter implements AuthenticationTokenFilter { + + private final UserService userService; + + public CacheRefreshFilter(UserService userService) { + this.userService = userService; + } + + @Override + public void doFilter(HttpServletRequest request, HttpServletResponse response) + throws IOException, ServletException { + Token token = TokenContext.current(); + // 每次认证通过后刷新用户权限缓存 + userService.refreshPermissionCache(token.getUsername()); + } +} +``` + +### 前端调用示例 + +```javascript +// 登录 +const res = await fetch('/user/login', { + method: 'POST', + headers: { 'Content-Type': 'application/json' }, + body: JSON.stringify({ username: 'admin', password: 'admin' }) +}); +const { data } = await res.json(); +// data.token → 保存 Token + +// 携带 Token 访问受保护接口 +const profile = await fetch('/api/profile', { + headers: { 'Authorization': data.token } +}); +``` diff --git a/docs/capabilities/springboot-starter/domain-proxy.md b/docs/capabilities/springboot-starter/domain-proxy.md new file mode 100644 index 000000000..8644fe0a1 --- /dev/null +++ b/docs/capabilities/springboot-starter/domain-proxy.md @@ -0,0 +1,134 @@ +--- +name: springboot-starter/domain-proxy +module: springboot-starter +description: 领域实体变更代理，通过 CGLIB 代理拦截实体字段变更并自动推送领域事件 +status: 已实现 +scope: 后端 +source: 项目自有 +import: "com.codingapi.springboot:springboot-starter" +symbols: + - DomainProxyFactory + - DomainChangeInterceptor + - IDomain + - DomainCreateEvent + - DomainChangeEvent + - DomainDeleteEvent + - DomainPersistEvent +content_hash: 94b780644f3676986d6041a009a7bf58e42543180ab2f6e1c0349244ea62032e +--- + +## 解决什么问题 + +在 DDD（领域驱动设计）实践中，领域实体的状态变更需要产生对应的领域事件（创建、变更、删除、持久化），以便下游处理器执行副作用操作（如发送通知、更新缓存等）。然而手动在每个 setter 方法中编写事件推送代码存在以下痛点： + +1. **侵入性强**：每个实体类的修改方法都需要显式调用 `EventPusher.push()`，业务逻辑与事件机制耦合。 +2. **容易遗漏**：开发者可能忘记在某些字段变更后推送事件，导致数据不一致。 +3. **变更追踪困难**：无法自动获取字段的旧值与新值，手动记录增加出错风险。 +4. **嵌套对象变更不可见**：当实体包含子对象时，子对象字段的变更更难被感知和追踪。 + +`domain-proxy` 能力通过 CGLIB 动态代理透明地拦截实体方法调用，自动比较字段值变化并推送 `DomainChangeEvent`，同时提供完整的实体生命周期事件（创建、持久化、删除），让领域事件的发布对业务代码零侵入。 + +## 如何使用 + +### 核心组件 + +| 组件 | 说明 | +|------|------| +| `IDomain` | 领域实体标记接口，提供 `persist()` 和 `delete()` 默认方法，分别推送 `DomainPersistEvent` 和 `DomainDeleteEvent` | +| `DomainProxyFactory` | 静态工厂类，通过 `create(Class, Object... args)` 创建代理实例，同时自动推送 `DomainCreateEvent` | +| `DomainChangeInterceptor` | CGLIB `MethodInterceptor` 实现，拦截带参数的方法调用，对比执行前后字段值差异，自动推送 `DomainChangeEvent` | +| `DomainEvent` | 领域事件基类，携带实体引用、实体类型和时间戳 | +| `DomainCreateEvent` | 实体创建事件，由 `DomainProxyFactory.create()` 自动推送 | +| `DomainChangeEvent` | 实体字段变更事件，包含 `fieldName`、`oldValue`、`newValue` | +| `DomainDeleteEvent` | 实体删除事件，通过 `IDomain.delete()` 推送 | +| `DomainPersistEvent` | 实体持久化事件，通过 `IDomain.persist()` 推送 | + +### 使用步骤 + +1. **定义领域实体**：创建实体类并实现 `IDomain` 接口。实体类需要有公开的构造函数供代理工厂反射调用。 + +2. **通过工厂创建实例**：使用 `DomainProxyFactory.create(EntityClass.class, constructorArgs...)` 代替 `new` 关键字创建实体。工厂会自动创建 CGLIB 代理并推送 `DomainCreateEvent`。 + +3. **正常调用业务方法**：对代理对象调用任何带参数的方法后，拦截器会自动比较所有字段（包括嵌套对象）的值变化，若有变更则推送 `DomainChangeEvent`。 + +4. **触发生命周期事件**：在适当时机调用 `entity.persist()` 推送持久化事件，或调用 `entity.delete()` 推送删除事件。 + +5. **注册事件处理器**：编写 `IHandler`、`IHandler` 等处理器 Bean，框架会自动扫描并注册。 + +### 注意事项 + +- 代理仅拦截**带参数**的方法调用，无参方法（如 getter）不会触发变更检测。 +- 支持基本类型（String、数值、布尔、枚举等）的直接比较，以及嵌套对象的递归字段比较。 +- 事件推送通过 `EventPusher` 进入框架的事件系统，遵循同步/异步分发和循环检测机制。 + +## 使用实例 + +### 定义领域实体 + +```java +public class User implements IDomain { + + @Getter + private final long id; + + @Getter + private String name; + + @Getter + private String email; + + public User(String name, String email) { + this.id = System.currentTimeMillis(); + this.name = name; + this.email = email; + } + + public void changeName(String name) { + this.name = name; + } + + public void changeEmail(String email) { + this.email = email; + } +} +``` + +### 创建代理并触发事件 + +```java +// 通过工厂创建代理实例，自动推送 DomainCreateEvent +User user = DomainProxyFactory.create(User.class, "张三", "zhangsan@example.com"); + +// 调用带参方法后，拦截器自动检测字段变更并推送 DomainChangeEvent +user.changeName("李四"); // → DomainChangeEvent(fieldName="name", oldValue="张三", newValue="李四") +user.changeEmail("li@example.com"); // → DomainChangeEvent(fieldName="email", ...) + +// 手动触发持久化事件 +user.persist(); // → DomainPersistEvent + +// 手动触发删除事件 +user.delete(); // → DomainDeleteEvent +``` + +### 编写事件处理器 + +```java +@Component +public class UserChangeHandler implements IHandler { + + @Override + public void handler(DomainChangeEvent event) { + log.info("用户字段变更: {} = {} → {}", + event.getFieldName(), event.getOldValue(), event.getNewValue()); + } +} + +@Component +public class UserCreateHandler implements IHandler { + + @Override + public void handler(DomainCreateEvent event) { + log.info("新用户创建: {}", event.getEntity().getClass().getSimpleName()); + } +} +``` diff --git a/docs/capabilities/springboot-starter/event-system.md b/docs/capabilities/springboot-starter/event-system.md new file mode 100644 index 000000000..e50a945f6 --- /dev/null +++ b/docs/capabilities/springboot-starter/event-system.md @@ -0,0 +1,283 @@ +--- +name: springboot-starter/event-system +module: springboot-starter +description: 事件发布-订阅系统，支持同步/异步事件、事件循环检测、事务事件 +status: 已实现 +scope: 后端 +source: 项目自有 +import: "com.codingapi.springboot:springboot-starter" +symbols: + - EventPusher + - IEvent + - IHandler + - ISyncEvent + - IAsyncEvent + - DomainEventContext + - ApplicationHandlerUtils + - SpringHandlerConfiguration + - EventTraceContext + - EventStackContext +content_hash: f911f56fe4d24daddc91a560d340759aa3c208f085ebc0aca84954d8b8d4ae9a +--- + +## 解决什么问题 + +在 DDD（领域驱动设计）架构中，领域事件是实现聚合间解耦、触发副作用的核心机制。然而在实际开发中，事件系统面临以下痛点： + +1. **事件与主业务事务的边界模糊**：开发者容易将事件处理与主业务强绑定，导致事务范围膨胀、性能下降。框架需要明确"事件对主业务可成功可失败"的设计原则。 +2. **同步与异步事件的区分困难**：部分场景要求事件在同一事务内同步执行（如数据校验），部分场景则需异步解耦（如发送通知）。手动管理线程池和执行模式增加复杂度。 +3. **事件循环调用风险**：当 Handler A 处理 EventX 时又推送了 EventY，而 EventY 的 Handler 又推送了 EventX，就会形成无限循环。缺乏自动检测机制会导致栈溢出或系统挂起。 +4. **多 Handler 执行的异常隔离**：同一事件可能被多个 Handler 订阅，某个 Handler 抛异常不应影响其他 Handler 的执行，同时需要收集所有异常统一上报。 +5. **Handler 注册与排序繁琐**：手动注册处理器、维护执行顺序的代码分散且易出错。 + +本模块提供了一套完整的发布-订阅事件基础设施，通过 `EventPusher` 统一入口、`IEvent` 类型体系区分同步/异步、`EventTraceContext` + `EventStackContext` 实现事件链路追踪与循环检测、`ApplicationHandlerUtils` 自动匹配并按序分发 Handler，以及可选的事务提交后触发模式（`SpringTransactionEventHandler`）。 + +## 如何使用 + +### 核心接口 + +| 接口/类 | 说明 | +|---------|------| +| `IEvent` | 事件标记接口，继承 `Serializable`。默认视为同步事件 | +| `ISyncEvent` | 同步事件标记接口，继承 `IEvent`。事件在当前线程同步执行 | +| `IAsyncEvent` | 异步事件标记接口，继承 `IEvent`。事件在线程池中异步执行 | +| `IHandler` | 事件处理器接口，泛型 `T` 指定订阅的事件类型 | +| `EventPusher` | 事件推送静态工具类，是发布事件的唯一入口 | +| `@Handler` | 注解，标记一个类为事件处理器 Bean（也可使用 `@Component`/`@Service`） | + +### IHandler 接口方法 + +```java +public interface IHandler { + // 执行顺序，数值越小越先执行，默认为 0 + default int order() { return 0; } + + // 事件处理逻辑 + void handler(T event); + + // 异常回调，默认重新抛出异常（阻止后续 Handler 执行） + // 可覆盖此方法实现异常吞没或自定义处理 + default void error(Exception exception) throws Exception { + throw exception; + } +} +``` + +### 事件推送 + +```java +// 推送事件（自动根据 IEvent 子接口判断同步/异步） +EventPusher.push(new MyEvent(data)); + +// 显式声明允许循环事件（跳过循环检测） +EventPusher.push(new MyEvent(data), true); +``` + +事件类型的判定规则： +- 实现 `IAsyncEvent` → 异步执行（线程池） +- 实现 `ISyncEvent` → 同步执行（当前线程） +- 仅实现 `IEvent` → 默认同步执行 + +### 配置项 + +```properties +# 启用事务事件模式（事件在事务提交后触发） +codingapi.framework.event.transaction.enable=true + +# 异步事件线程池大小（默认值 20） +codingapi.framework.handler-thread-pool-size=20 +``` + +### 事件分发模式 + +框架通过 `SpringHandlerConfiguration` 自动装配事件分发器： + +- **默认模式**（`SpringDefaultEventHandler`）：使用 Spring `@EventListener` 即时触发，同步事件在当前线程执行，异步事件提交到固定大小线程池。 +- **事务模式**（`SpringTransactionEventHandler`）：当配置 `codingapi.framework.event.transaction.enable=true` 时激活，使用 `@TransactionalEventListener(phase = AFTER_COMMIT)` 确保事件在事务提交后才触发，避免读取到未提交的数据。设置 `fallbackExecution = true` 保证无事务上下文时也能正常执行。 + +两种模式互斥，事务模式优先（`@ConditionalOnMissingBean` 兜底默认模式）。 + +### 事件循环检测 + +框架通过 `EventTraceContext` 和 `EventStackContext` 实现同一条事件链路内的循环检测： + +1. 每次推送事件时生成/复用 traceId，将事件类压入该 traceId 对应的事件栈。 +2. 若同一 traceId 下出现相同事件类，立即抛出 `EventLoopException`，并附带完整的事件调用栈信息。 +3. 事件处理完成后自动清理 traceId 和事件栈。 +4. 若确实需要允许循环（如状态机重试），可调用 `EventPusher.push(event, true)` 跳过检测。 + +### Handler 异常处理策略 + +当某个 Handler 抛出异常时： +1. 若异常为 `EventLoopException`，直接向上抛出，终止后续所有 Handler。 +2. 否则调用该 Handler 的 `error(exception)` 回调。 +3. 若 `error()` 也抛出异常，标记为"有异常"并继续执行下一个 Handler。 +4. 所有 Handler 执行完毕后，若存在异常，统一包装为 `EventException` 抛出。 + +## 使用实例 + +### 1. 定义事件 + +```java +package com.example.domain.order.event; + +import com.codingapi.springboot.framework.event.ISyncEvent; +import lombok.Getter; +import lombok.AllArgsConstructor; + +/** + * 订单创建事件（同步） + */ +@Getter +@AllArgsConstructor +public class OrderCreatedEvent implements ISyncEvent { + private final String orderId; + private final String userId; + private final long amount; +} +``` + +```java +package com.example.domain.order.event; + +import com.codingapi.springboot.framework.event.IAsyncEvent; +import lombok.Getter; +import lombok.AllArgsConstructor; + +/** + * 订单通知事件（异步） + */ +@Getter +@AllArgsConstructor +public class OrderNotifyEvent implements IAsyncEvent { + private final String orderId; + private final String message; +} +``` + +### 2. 编写事件处理器 + +```java +package com.example.handler; + +import com.codingapi.springboot.framework.event.IHandler; +import com.example.domain.order.event.OrderCreatedEvent; +import lombok.extern.slf4j.Slf4j; +import org.springframework.stereotype.Service; + +/** + * 订单创建后扣减库存（优先执行） + */ +@Slf4j +@Service +public class InventoryDeductHandler implements IHandler { + + @Override + public int order() { + return 1; // 最先执行 + } + + @Override + public void handler(OrderCreatedEvent event) { + log.info("扣减库存, orderId={}, amount={}", event.getOrderId(), event.getAmount()); + // inventoryService.deduct(event.getOrderId(), event.getAmount()); + } +} +``` + +```java +package com.example.handler; + +import com.codingapi.springboot.framework.event.IHandler; +import com.example.domain.order.event.OrderCreatedEvent; +import lombok.extern.slf4j.Slf4j; +import org.springframework.stereotype.Service; + +/** + * 订单创建后记录积分（其次执行） + */ +@Slf4j +@Service +public class PointsRecordHandler implements IHandler { + + @Override + public int order() { + return 2; + } + + @Override + public void handler(OrderCreatedEvent event) { + log.info("记录积分, userId={}", event.getUserId()); + // pointsService.record(event.getUserId(), event.getAmount()); + } + + @Override + public void error(Exception exception) { + // 积分记录失败不影响其他 Handler，仅记录日志 + log.error("积分记录失败, 但不阻断流程", exception); + } +} +``` + +```java +package com.example.handler; + +import com.codingapi.springboot.framework.event.IHandler; +import com.example.domain.order.event.OrderNotifyEvent; +import lombok.extern.slf4j.Slf4j; +import org.springframework.stereotype.Service; + +/** + * 异步发送订单通知 + */ +@Slf4j +@Service +public class OrderNotifyHandler implements IHandler { + + @Override + public void handler(OrderNotifyEvent event) { + log.info("发送通知, orderId={}, message={}", event.getOrderId(), event.getMessage()); + // notificationService.send(event.getOrderId(), event.getMessage()); + } +} +``` + +### 3. 在领域服务中推送事件 + +```java +package com.example.domain.order.service; + +import com.codingapi.springboot.framework.event.EventPusher; +import com.example.domain.order.event.OrderCreatedEvent; +import com.example.domain.order.event.OrderNotifyEvent; +import org.springframework.stereotype.Service; +import org.springframework.transaction.annotation.Transactional; + +@Service +public class OrderService { + + @Transactional + public String createOrder(String userId, long amount) { + String orderId = generateOrderId(); + // ... 持久化订单实体 ... + + // 同步事件：在当前事务内执行库存扣减、积分记录 + EventPusher.push(new OrderCreatedEvent(orderId, userId, amount)); + + // 异步事件：事务外异步发送通知 + EventPusher.push(new OrderNotifyEvent(orderId, "您的订单已创建")); + + return orderId; + } +} +``` + +### 4. 启用事务事件模式（可选） + +若希望所有事件都在事务提交后再触发（避免 Handler 读到未提交数据），在 `application.properties` 中添加： + +```properties +codingapi.framework.event.transaction.enable=true +``` + +此时 `SpringTransactionEventHandler` 替代默认的 `SpringDefaultEventHandler`，所有事件将在 `AFTER_COMMIT` 阶段触发。 diff --git a/docs/capabilities/springboot-starter/exception-handling.md b/docs/capabilities/springboot-starter/exception-handling.md new file mode 100644 index 000000000..fa5dd32e4 --- /dev/null +++ b/docs/capabilities/springboot-starter/exception-handling.md @@ -0,0 +1,142 @@ +--- +name: springboot-starter/exception-handling +module: springboot-starter +description: 全局异常处理，统一拦截 Controller 层异常并返回标准 Response +status: 已实现 +scope: 后端 +source: 项目自有 +import: "com.codingapi.springboot:springboot-starter" +symbols: + - ExceptionConfiguration + - BasicHandlerExceptionResolverConfiguration +content_hash: e2cf2bcf396be0bf0a00caf77f61e89c1f00b90213d98196d70971b61a7e0f54 +--- + +## 解决什么问题 + +在 Spring MVC 项目中，Controller 层抛出的异常如果不做统一处理，会导致以下问题： + +- **响应格式不一致**：不同接口返回的错误结构各异（有的返回 HTML 错误页、有的返回纯文本、有的返回自定义 JSON），前端难以统一解析。 +- **错误码缺失**：原生异常只有 message，没有业务错误码（errCode），前端无法根据错误码做多语言提示或差异化逻辑。 +- **国际化困难**：错误信息硬编码在代码中，无法根据用户 Locale 动态切换语言。 +- **敏感信息泄露**：未捕获的异常可能将堆栈信息直接暴露给客户端。 + +`springboot-starter` 的异常处理能力通过 `HandlerExceptionResolver` 机制，在 Servlet 层面统一拦截所有 Controller 异常，将其转换为标准的 `{success, errCode, errMessage}` JSON 响应，同时结合 `LocaleMessageException` 和 `MessageSource` 实现错误信息的国际化管理。 + +## 如何使用 + +### 自动生效 + +引入 `springboot-starter` 依赖后，异常处理自动配置即可生效，无需额外注解或配置： + +```xml + + com.codingapi.springboot + springboot-starter + +``` + +框架通过以下两个配置类自动注册： + +- **`ExceptionConfiguration`**：注册 `LocaleMessage` Bean，绑定 Spring `MessageSource`，在初始化时将自身注入 `MessageContext` 单例，为 `LocaleMessageException` 提供国际化消息解析能力。 +- **`BasicHandlerExceptionResolverConfiguration`**：当 classpath 中存在 `HandlerExceptionResolver`（即 Spring MVC 环境）时，注册 `ServletExceptionHandler` 作为全局异常解析器。 + +### 异常类型与响应映射 + +| 异常类型 | errCode | errMessage | 说明 | +|---------|---------|------------|------| +| `LocaleMessageException` | 异常中指定的 errCode | 国际化解析后的消息 | 业务异常，推荐使用 | +| 其他 `Exception` | `system.err` | `ex.getMessage()` | 未预期的系统异常 | + +### 抛出业务异常 + +在 Service 或 Controller 中抛出 `LocaleMessageException`，支持三种构造方式： + +```java +// 1. 直接使用错误码（从 messages.properties 中解析消息） +throw new LocaleMessageException("user.not.found"); + +// 2. 错误码 + 占位符参数 +throw LocaleMessageException.of("order.amount.exceed", maxAmount); + +// 3. 错误码 + 自定义消息（不走国际化） +throw new LocaleMessageException("custom.error", "自定义错误描述"); +``` + +### 配置国际化消息 + +在 `src/main/resources/messages.properties`（及对应的多语言文件）中定义错误消息： + +```properties +# messages.properties +user.not.found=用户不存在 +order.amount.exceed=订单金额超出限制，最大金额为 {0} + +# messages_en.properties +user.not.found=User not found +order.amount.exceed=Order amount exceeds limit, maximum is {0} +``` + +## 使用实例 + +### 完整示例：Controller 中抛出业务异常 + +```java +@RestController +@RequestMapping("/api/users") +public class UserController { + + @Autowired + private UserService userService; + + @GetMapping("/{id}") + public SingleResponse getUser(@PathVariable Long id) { + User user = userService.findById(id); + if (user == null) { + // 抛出国际化业务异常 + throw new LocaleMessageException("user.not.found"); + } + return SingleResponse.of(user); + } + + @PostMapping + public Response createUser(@RequestBody CreateUserRequest request) { + if (request.getAmount().compareTo(MAX_AMOUNT) > 0) { + // 带占位符参数的异常 + throw LocaleMessageException.of("order.amount.exceed", MAX_AMOUNT); + } + userService.create(request); + return Response.buildSuccess(); + } +} +``` + +当请求触发异常时，框架自动返回统一格式的 JSON 响应： + +```json +{ + "success": false, + "errCode": "user.not.found", + "errMessage": "用户不存在" +} +``` + +若当前请求的 Locale 为英文，则自动返回： + +```json +{ + "success": false, + "errCode": "user.not.found", + "errMessage": "User not found" +} +``` + +对于未预期的系统异常（如 NullPointerException），返回： + +```json +{ + "success": false, + "errCode": "system.err", + "errMessage": "Cannot invoke method on null object" +} +``` diff --git a/docs/capabilities/springboot-starter/locale-message.md b/docs/capabilities/springboot-starter/locale-message.md new file mode 100644 index 000000000..d4fca5f3c --- /dev/null +++ b/docs/capabilities/springboot-starter/locale-message.md @@ -0,0 +1,121 @@ +--- +name: springboot-starter/locale-message +module: springboot-starter +description: 国际化异常消息，支持多语言异常信息和本地化消息解析 +status: 已实现 +scope: 后端 +source: 项目自有 +import: "com.codingapi.springboot:springboot-starter" +symbols: + - LocaleMessageException + - LocaleMessage + - MessageContext +content_hash: 1480d3ed2cf99ad0eb3cd955540f5bc263adcf0196bc8f0b3f79e713eb16b6ad +--- + +## 解决什么问题 + +在企业级应用中，异常消息往往需要面向不同语言和地区的用户展示本地化内容。直接在代码中硬编码中文或英文错误提示存在以下痛点： + +- **多语言维护困难**：错误消息散落在业务代码各处，新增语言时需要逐一修改源码。 +- **异常与消息耦合**：`RuntimeException` 只接受字符串消息，无法携带错误码进行统一拦截和翻译。 +- **占位符参数化缺失**：部分错误消息需要动态插入变量（如用户名、金额），拼接字符串容易出错且不利于翻译。 + +`locale-message` 能力通过 `LocaleMessageException` + Spring `MessageSource` 的组合，将错误码作为异常的语义标识，在抛出时自动根据当前请求的 `Locale` 从 `messages.properties` 资源文件中解析出对应的本地化消息，从而实现异常消息与业务代码的解耦和多语言支持。 + +## 如何使用 + +### 核心组件 + +| 类 | 职责 | +|----|------| +| `LocaleMessageException` | 国际化异常，支持仅传错误码、错误码+占位符参数、错误码+自定义消息等多种构造方式 | +| `LocaleMessage` | 封装 Spring `MessageSource`，提供按 code + args + locale 解析消息的能力 | +| `MessageContext` | 单例上下文，持有 `LocaleMessage` 实例，供异常类在静态上下文中获取本地化消息 | + +### 配置消息资源文件 + +在 `src/main/resources/` 下创建标准 Spring 消息资源文件： + +```properties +# messages.properties（默认/回退） +error.user.not.found=User not found: {0} +error.param.invalid=Invalid parameter: {0}, expected {1} + +# messages_zh_CN.properties +error.user.not.found=用户不存在: {0} +error.param.invalid=参数无效: {0}，期望值 {1} +``` + +Spring Boot 会自动加载这些文件作为 `MessageSource`。 + +### 抛出国际化异常 + +`LocaleMessageException` 提供多种构造方式和静态工厂方法： + +```java +// 1. 仅传错误码 —— 自动从 messages.properties 解析消息 +throw new LocaleMessageException("error.user.not.found"); + +// 2. 错误码 + 占位符参数 +throw LocaleMessageException.of("error.user.not.found", "zhangsan"); + +// 3. 错误码 + 多个占位符参数 +throw LocaleMessageException.of("error.param.invalid", "age", "Integer"); + +// 4. 错误码 + 自定义消息（不走 MessageSource） +throw new LocaleMessageException("ERR_CUSTOM", "自定义错误消息"); + +// 5. 携带原始异常 +throw new LocaleMessageException("error.user.not.found", cause); +``` + +### 自动装配 + +框架启动时，`LocaleMessage` Bean 会被创建并调用 `init()` 方法，将自身注册到 `MessageContext` 单例中。`LocaleMessageException` 在构造时通过 `MessageContext.getInstance().getErrorMsg(errCode, args)` 获取本地化消息，整个过程对业务代码透明，无需手动注入任何 Bean。 + +当前请求的 `Locale` 由 Spring 的 `LocaleContextHolder` 提供（通常通过 `Accept-Language` 请求头或 `LocaleChangeInterceptor` 设置）。 + +## 使用实例 + +### 完整示例：用户查询服务 + +```java +@Service +public class UserService { + + @Autowired + private UserRepository userRepository; + + public User getUser(String username) { + return userRepository.findByUsername(username) + .orElseThrow(() -> + LocaleMessageException.of("error.user.not.found", username) + ); + } + + public void updateUserAge(String username, int age) { + if (age < 0 || age > 150) { + throw LocaleMessageException.of("error.param.invalid", "age", "0~150"); + } + // ... + } +} +``` + +当客户端发送 `Accept-Language: zh-CN` 请求时，若用户不存在，返回的异常消息为 `"用户不存在: zhangsan"`；若未指定语言或使用默认 locale，则返回 `"User not found: zhangsan"`。 + +### 在全局异常处理器中统一捕获 + +```java +@RestControllerAdvice +public class GlobalExceptionHandler { + + @ExceptionHandler(LocaleMessageException.class) + public Response handleLocaleException(LocaleMessageException e) { + return Response.buildFailure(e.getErrCode(), e.getErrMessage()); + } +} +``` + +由于异常对象已经携带了本地化后的 `errMessage`，全局处理器只需直接提取即可，无需再做二次翻译。 diff --git a/docs/capabilities/springboot-starter/page-request.md b/docs/capabilities/springboot-starter/page-request.md new file mode 100644 index 000000000..bf94c95a5 --- /dev/null +++ b/docs/capabilities/springboot-starter/page-request.md @@ -0,0 +1,182 @@ +--- +name: springboot-starter/page-request +module: springboot-starter +description: 动态分页查询请求，扩展 Spring PageRequest 支持 RequestFilter 动态过滤条件 +status: 已实现 +scope: 后端 +source: 项目自有 +import: "com.codingapi.springboot:springboot-starter" +symbols: + - PageRequest + - RequestFilter + - SearchRequest + - Filter +content_hash: c4302ccd858320110405285846ca4d4087b4844a4334452fa63ee34b68fffa5f +--- + +## 解决什么问题 + +在企业级后台管理系统中，列表查询是最常见的业务场景之一。Spring Data 原生的 `PageRequest` 仅支持分页参数（页码、大小、排序），无法携带动态过滤条件。开发者通常需要为每个查询接口手动编写 Specification、QueryDSL 或自定义 HQL，导致大量重复的查询构建代码。 + +`PageRequest` 能力解决了以下痛点： + +- **动态过滤**：在分页请求对象上直接附加任意字段、任意比较关系的过滤条件，无需为每种查询组合编写独立方法。 +- **前端驱动查询**：通过 `SearchRequest` 自动解析 HTTP 请求参数（包括 Base64 编码的 `filter`、`sort`、`params` JSON），将前端传入的筛选/排序规则转换为类型安全的过滤条件，减少 Controller 层样板代码。 +- **复杂条件组合**：支持 AND/OR 嵌套组合过滤，满足多条件联合查询需求。 +- **与 FastRepository 无缝集成**：`FastRepository.findAll(PageRequest)` 和 `pageRequest(PageRequest)` 自动根据过滤条件构建 Example 或 HQL 查询，开发者只需关注业务逻辑。 + +## 如何使用 + +### 核心类说明 + +| 类 | 职责 | +|---|------| +| `PageRequest` | 继承 Spring `PageRequest`，增加 `RequestFilter` 和链式 `addFilter` API | +| `RequestFilter` | 过滤条件容器，管理 `Filter` 列表并提供按 key 读取过滤值的快捷方法 | +| `Filter` | 单个过滤条件，包含字段名（key）、比较关系（Relation）和值 | +| `Relation` | 枚举，定义了 14 种比较关系：EQUAL、NOT_EQUAL、LIKE、LEFT_LIKE、RIGHT_LIKE、BETWEEN、IN、NOT_IN、IS_NULL、IS_NOT_NULL、GREATER_THAN、LESS_THAN、GREATER_THAN_EQUAL、LESS_THAN_EQUAL | +| `SearchRequest` | 从当前 `HttpServletRequest` 自动解析分页、排序、过滤参数并生成 `PageRequest` | + +### 创建 PageRequest + +```java +// 基本分页（第 0 页，每页 20 条） +PageRequest request = PageRequest.of(0, 20); + +// 带排序 +PageRequest request = PageRequest.of(0, 20, Sort.by("createTime").descending()); +``` + +### 添加过滤条件 + +```java +// 等值过滤（默认 EQUAL） +request.addFilter("name", "张三"); + +// 指定比较关系 +request.addFilter("age", Relation.GREATER_THAN, 18); +request.addFilter("createTime", Relation.BETWEEN, startDate, endDate); +request.addFilter("status", Relation.IN, "ACTIVE", "PENDING"); + +// AND / OR 组合 +request.andFilter( + Filter.as("deptId", 1), + Filter.as("roleId", 2) +); + +request.orFilters( + Filter.as("name", Relation.LIKE, "张"), + Filter.as("email", Relation.LIKE, "zhang") +); +``` + +### 读取过滤值 + +```java +String name = request.getStringFilter("name"); +int age = request.getIntFilter("age", 0); +boolean hasConditions = request.hasFilter(); +``` + +### 配合 FastRepository 使用 + +```java +// findAll — 简单过滤走 Example 查询 +Page page = userRepository.findAll(request); + +// pageRequest — 复杂过滤走 HQL 动态查询 +Page page = userRepository.pageRequest(request); + +// searchRequest — 从 HTTP 请求自动解析 +Page page = userRepository.searchRequest(searchRequest); +``` + +### SearchRequest 自动解析 + +`SearchRequest` 从当前 HTTP 请求中提取以下参数： + +| 参数 | 格式 | 说明 | +|------|------|------| +| `current` | int | 页码（从 0 开始） | +| `pageSize` | int | 每页大小 | +| `sort` | Base64(JSON) | 排序规则，如 `{"createTime":"descend"}` | +| `filter` | Base64(JSON) | 过滤条件，如 `{"status":["ACTIVE"]}` | +| `params` | Base64(JSON Array) | 指定字段的比较关系，如 `[{"key":"age","type":"GREATER_THAN"}]` | +| 其他参数 | string | 作为 EQUAL 过滤条件自动添加 | + +## 使用实例 + +### 示例 1：Service 层手动构建动态查询 + +```java +@Service +public class UserQueryService { + + @Autowired + private UserRepository userRepository; + + public Page searchUsers(String keyword, Integer minAge, String status) { + PageRequest request = PageRequest.of(0, 20); + request.addSort(Sort.by("createTime").descending()); + + if (keyword != null) { + request.addFilter("name", Relation.LIKE, keyword); + } + if (minAge != null) { + request.addFilter("age", Relation.GREATER_THAN_EQUAL, minAge); + } + if (status != null) { + request.addFilter("status", status); + } + + return userRepository.findAll(request); + } +} +``` + +### 示例 2：Controller 层使用 SearchRequest 自动绑定 + +```java +@RestController +@RequestMapping("/api/users") +public class UserController { + + @Autowired + private UserRepository userRepository; + + @GetMapping + public MultiResponse list(SearchRequest searchRequest) { + // 自动从 HTTP 参数解析 current、pageSize、sort、filter + Page page = userRepository.searchRequest(searchRequest); + return MultiResponse.of(page.getContent(), (int) page.getTotalElements()); + } +} +``` + +前端请求示例： +``` +GET /api/users?current=0&pageSize=20 + &sort=eyJjcmVhdGVUaW1lIjoiZGVzY2VuZCJ9 + &filter=eyJzdGF0dXMiOlsiQUNUSVZFIiwiUEVORElORyJdfQ== + ¶ms=W3sia2V5IjoiYWdlIiwidHlwZSI6IkdSRUFURVJfVEhBTiJ9XQ== + &deptId=1 +``` + +其中 `filter` 解码后为 `{"status":["ACTIVE","PENDING"]}`，`params` 解码后为 `[{"key":"age","type":"GREATER_THAN"}]`，`deptId` 作为额外 EQUAL 条件自动加入。 + +### 示例 3：AND/OR 组合过滤 + +```java +PageRequest request = PageRequest.of(0, 20); + +// (deptId=1 AND roleId=2) OR (name LIKE '%admin%') +request.orFilters( + Filter.and( + Filter.as("deptId", 1), + Filter.as("roleId", 2) + ), + Filter.as("name", Relation.LIKE, "admin") +); + +Page page = userRepository.pageRequest(request); +``` diff --git a/docs/capabilities/springboot-starter/response-dto.md b/docs/capabilities/springboot-starter/response-dto.md new file mode 100644 index 000000000..3794043fd --- /dev/null +++ b/docs/capabilities/springboot-starter/response-dto.md @@ -0,0 +1,177 @@ +--- +name: springboot-starter/response-dto +module: springboot-starter +description: 统一响应封装，提供 Response/SingleResponse/MultiResponse/MapResponse 四种响应类型 +status: 已实现 +scope: 后端 +source: 项目自有 +import: "com.codingapi.springboot:springboot-starter" +symbols: + - Response + - SingleResponse + - MultiResponse + - MapResponse +content_hash: 1dfe2559a6b514effb51735ca8ca49aba308959e02814c5862b842eed3b04fb1 +--- + +## 解决什么问题 + +在企业级 REST API 开发中，前后端交互需要统一的响应契约。若每个接口各自定义返回结构，会导致以下问题： + +- **前端解析复杂**：不同接口的成功/失败字段命名不一致，前端需逐接口适配 +- **错误处理分散**：缺乏统一的 `errCode` / `errMessage` 规范，全局异常拦截难以标准化 +- **分页结构不统一**：列表接口的总数、数据字段名各异，通用分页组件无法复用 +- **序列化行为不可控**：响应对象在缓存、消息队列等场景下需要可靠的 JSON 序列化能力 + +`response-dto` 提供了四种标准响应类型，覆盖无数据、单对象、列表/分页、键值对四类返回场景，使所有 API 输出遵循同一契约。基类 `Response` 实现了 `JsonSerializable` 接口，支持通过 Fastjson 进行一致的 JSON 序列化。 + +## 如何使用 + +### 类层次结构 + +``` +JsonSerializable (interface) + └── Response — 基础响应（success / errCode / errMessage） + ├── SingleResponse — 单对象响应，data 字段为泛型 T + ├── MultiResponse — 列表响应，data 字段包含 total + list + └── MapResponse — 键值对响应，data 字段为 Map +``` + +### 核心 API + +| 类 | 静态工厂方法 | 说明 | +|---|---|---| +| `Response` | `buildSuccess()` | 构建成功响应（无业务数据） | +| `Response` | `buildFailure(errCode, errMessage)` | 构建失败响应 | +| `SingleResponse` | `of(T data)` | 包装单个业务对象 | +| `SingleResponse` | `empty()` | 返回 data=null 的成功响应 | +| `MultiResponse` | `of(Collection data, long total)` | 包装集合 + 总数 | +| `MultiResponse` | `of(Page page)` | 直接包装 Spring Data Page 对象 | +| `MultiResponse` | `of(Collection data)` | 包装集合，total 自动取 size | +| `MultiResponse` | `empty()` | 返回空列表的成功响应 | +| `MapResponse` | `create()` | 创建空的键值对响应 | +| `MapResponse` | `empty()` | 返回 data=null 的键值对响应 | +| `MapResponse` | `add(key, value)` | 链式添加键值对 | + +### JSON 序列化 + +所有响应类均继承自 `Response`，而 `Response` 实现了 `JsonSerializable` 接口，可直接调用 `toJson()` 方法获取 JSON 字符串： + +```java +String json = response.toJson(); // 使用 Fastjson 序列化 +``` + +### Maven 依赖 + +```xml + + com.codingapi.springboot + springboot-starter + +``` + +## 使用实例 + +### 1. 无数据的操作响应 + +```java +@PostMapping("/save") +public Response save(@RequestBody UserRequest request) { + userService.save(request); + return Response.buildSuccess(); +} +``` + +返回 JSON： +```json +{ "success": true, "errCode": null, "errMessage": null } +``` + +### 2. 返回单个对象 + +```java +@GetMapping("/detail") +public SingleResponse detail(@RequestParam Long id) { + UserVO user = userQueryService.getById(id); + return SingleResponse.of(user); +} +``` + +返回 JSON： +```json +{ + "success": true, + "errCode": null, + "errMessage": null, + "data": { "id": 1, "name": "张三", "email": "zhangsan@example.com" } +} +``` + +### 3. 返回列表（含分页） + +```java +@GetMapping("/list") +public MultiResponse list(SearchRequest searchRequest) { + Page page = userQueryService.page(searchRequest); + return MultiResponse.of(page); +} +``` + +返回 JSON： +```json +{ + "success": true, + "errCode": null, + "errMessage": null, + "data": { + "total": 100, + "list": [ + { "id": 1, "name": "张三" }, + { "id": 2, "name": "李四" } + ] + } +} +``` + +### 4. 返回键值对数据 + +```java +@GetMapping("/dashboard/stats") +public MapResponse dashboardStats() { + return MapResponse.create() + .add("userCount", 1024) + .add("orderCount", 5678) + .add("todayRevenue", 99800.50); +} +``` + +返回 JSON： +```json +{ + "success": true, + "errCode": null, + "errMessage": null, + "data": { + "userCount": 1024, + "orderCount": 5678, + "todayRevenue": 99800.50 + } +} +``` + +### 5. 返回错误响应 + +```java +@PostMapping("/login") +public Response login(@RequestBody LoginRequest request) { + if (!userService.authenticate(request)) { + return Response.buildFailure("AUTH_FAILED", "用户名或密码错误"); + } + return Response.buildSuccess(); +} +``` + +返回 JSON： +```json +{ "success": false, "errCode": "AUTH_FAILED", "errMessage": "用户名或密码错误" } +``` diff --git a/docs/capabilities/springboot-starter/rest-client.md b/docs/capabilities/springboot-starter/rest-client.md new file mode 100644 index 000000000..579c94726 --- /dev/null +++ b/docs/capabilities/springboot-starter/rest-client.md @@ -0,0 +1,111 @@ +--- +name: springboot-starter/rest-client +module: springboot-starter +description: REST 客户端封装，提供 RestTemplate 上下文管理和 HTTPS 信任所有证书支持 +status: 已实现 +scope: 后端 +source: 项目自有 +import: "com.codingapi.springboot:springboot-starter" +symbols: + - RestTemplateContext + - TrustAnyHttpClientFactory +content_hash: 70d327e5685d61447513a8df011bccc1c0ab9153b4b1c1d3763096d86fd90e9c +--- + +## 解决什么问题 + +在企业内部系统集成和第三方 API 对接场景中，经常需要调用外部 HTTPS 服务。这些服务的证书可能由私有 CA 签发、已过期或主机名不匹配，导致标准 HTTP 客户端抛出 SSL 握手异常。同时，项目中多处使用 `RestTemplate` 时，如果每次都手动创建实例并配置底层 HttpClient，会导致代码重复且难以统一维护。 + +本能力通过两个核心类解决上述问题： + +- **TrustAnyHttpClientFactory** — 创建信任所有证书的 Apache HttpClient 5 实例，跳过服务端证书校验和主机名验证，适用于开发调试及内网可信环境下的 HTTPS 调用。 +- **RestTemplateContext** — 以单例模式持有预配置好的 `RestTemplate`（底层使用 TrustAnyHttpClientFactory），为全应用提供统一的 REST 客户端访问入口，避免重复创建和配置。 + +## 如何使用 + +### 依赖引入 + +在 Maven 项目中添加 springboot-starter 依赖即可： + +```xml + + com.codingapi.springboot + springboot-starter + +``` + +### 获取 RestTemplate 实例 + +通过 `RestTemplateContext` 的单例方法获取已配置好 HTTPS 信任策略的 `RestTemplate`： + +```java +RestTemplate restTemplate = RestTemplateContext.getInstance().getRestTemplate(); +``` + +该实例底层使用 Apache HttpComponents 5 作为传输层，并已启用以下特性： + +- TLS 协议下信任所有服务端证书（`TrustAnyTrustManager`） +- 禁用主机名验证（`NoopHostnameVerifier`） +- 允许循环重定向 + +### 自定义 ClientHttpRequestFactory + +如果需要替换默认的请求工厂，可以使用 `restTemplate(ClientHttpRequestFactory)` 方法创建新的 `RestTemplate` 实例： + +```java +ClientHttpRequestFactory customFactory = new HttpComponentsClientHttpRequestFactory(customHttpClient); +RestTemplate customTemplate = RestTemplateContext.getInstance().restTemplate(customFactory); +``` + +### 直接使用 TrustAnyHttpClientFactory + +若仅需创建信任所有证书的 HttpClient 而不使用 RestTemplateContext 封装，可直接调用静态工厂方法： + +```java +HttpClient httpClient = TrustAnyHttpClientFactory.createTrustAnyHttpClient(); +``` + +返回的 `HttpClient` 基于 Apache HttpClient 5，可用于任何需要绕过 SSL 校验的场景。 + +## 使用实例 + +### 示例 1：调用外部 HTTPS 接口 + +```java +@Service +public class ExternalApiService { + + private final RestTemplate restTemplate; + + public ExternalApiService() { + this.restTemplate = RestTemplateContext.getInstance().getRestTemplate(); + } + + public String fetchRemoteData(String url) { + ResponseEntity response = restTemplate.getForEntity(url, String.class); + return response.getBody(); + } + + public T postJson(String url, Object request, Class responseType) { + return restTemplate.postForObject(url, request, responseType); + } +} +``` + +### 示例 2：独立使用 TrustAnyHttpClientFactory + +```java +// 在不依赖 RestTemplateContext 的场景下，单独创建信任所有证书的 HttpClient +HttpClient httpClient = TrustAnyHttpClientFactory.createTrustAnyHttpClient(); + +// 配合 Spring 的 HttpComponentsClientHttpRequestFactory 构建自定义 RestTemplate +HttpComponentsClientHttpRequestFactory factory = + new HttpComponentsClientHttpRequestFactory(httpClient); +factory.setConnectTimeout(Duration.ofSeconds(5)); +factory.setReadTimeout(Duration.ofSeconds(30)); + +RestTemplate restTemplate = new RestTemplate(factory); +String result = restTemplate.getForObject("https://internal-api.example.com/data", String.class); +``` + +> ⚠️ **安全提示**：信任所有证书仅适用于开发调试和内网可信环境。在生产环境中应正确配置受信任的 CA 证书链，避免中间人攻击风险。 diff --git a/docs/capabilities/springboot/data-jpa.md b/docs/capabilities/springboot/data-jpa.md new file mode 100644 index 000000000..989b5f60b --- /dev/null +++ b/docs/capabilities/springboot/data-jpa.md @@ -0,0 +1,211 @@ +--- +name: springboot/data-jpa +module: springboot +description: Spring Data JPA，提供 ORM 映射、Repository 抽象和分页支持 +status: 已实现 +scope: 后端 +source: 框架:springboot +import: "org.springframework.boot:spring-boot-starter-data-jpa" +framework_version: 3.3.5 +--- + +## 解决什么问题 + +在企业级 Java 应用中，数据持久化是核心基础设施需求。直接使用 JDBC 或原生 JPA API 存在以下痛点： + +- **样板代码冗余**：每个实体都需要手动编写 CRUD 操作、SQL 拼接、结果集映射，重复劳动量大 +- **ORM 配置复杂**：原生 Hibernate/JPA 的 XML 或注解配置繁琐，事务管理和 EntityManager 生命周期需要手工控制 +- **分页与排序缺乏统一抽象**：不同数据库的分页语法差异大，业务层需要自行处理 offset/limit 逻辑 +- **查询方法命名约定缺失**：简单的条件查询也需要手写 JPQL/SQL，无法通过方法名自动推导 + +Spring Data JPA 通过 Repository 抽象层和自动实现机制，将上述问题封装为声明式接口，开发者只需定义接口和方法签名即可获得完整的持久化能力，大幅降低数据访问层的开发和维护成本。 + +## 如何使用 + +### 1. 添加依赖 + +在 `pom.xml` 中引入 Spring Boot Data JPA Starter： + +```xml + + org.springframework.boot + spring-boot-starter-data-jpa + +``` + +### 2. 配置数据源 + +在 `application.properties` 中配置数据库连接和 JPA 行为： + +```properties +spring.datasource.url=jdbc:h2:file:./data/demo +spring.datasource.driver-class-name=org.h2.Driver +spring.jpa.hibernate.ddl-auto=update +spring.jpa.show-sql=true +``` + +### 3. 定义实体类 + +使用 JPA 注解将 POJO 映射到数据库表： + +```java +@Entity +@Table(name = "t_user") +public class User { + + @Id + @GeneratedValue(strategy = GenerationType.IDENTITY) + private Long id; + + @Column(nullable = false, length = 64) + private String username; + + private String email; + + // getters & setters +} +``` + +### 4. 定义 Repository 接口 + +继承 `JpaRepository` 即可获得标准 CRUD、分页、排序等能力；通过方法命名约定可自动生成查询： + +```java +public interface UserRepository extends JpaRepository { + + List findByUsername(String username); + + Page findByEmailContaining(String keyword, Pageable pageable); + + Optional findByUsernameAndEmail(String username, String email); +} +``` + +### 5. 核心接口说明 + +| 接口 | 说明 | +|------|------| +| `CrudRepository` | 基础 CRUD 操作（save、findById、delete 等） | +| `PagingAndSortingRepository` | 继承 CrudRepository，增加分页和排序支持 | +| `JpaRepository` | 继承上述两者，增加批量操作、flush、Example 查询等 JPA 特有能力 | +| `Specification` | 用于构建动态查询条件的函数式接口 | +| `Pageable` / `PageRequest` | 分页参数抽象（页码、每页大小、排序） | +| `Page` | 分页结果封装（内容列表、总记录数、总页数） | + +### 6. 事务管理 + +Spring Data JPA 默认集成 Spring 声明式事务。Service 层方法添加 `@Transactional` 即可自动管理事务边界： + +```java +@Service +public class UserService { + + @Transactional + public User createUser(User user) { + return userRepository.save(user); + } +} +``` + +## 使用实例 + +### 基本 CRUD 操作 + +```java +@Service +@RequiredArgsConstructor +public class UserService { + + private final UserRepository userRepository; + + public User create(String username, String email) { + User user = new User(); + user.setUsername(username); + user.setEmail(email); + return userRepository.save(user); + } + + public Optional getById(Long id) { + return userRepository.findById(id); + } + + public void delete(Long id) { + userRepository.deleteById(id); + } +} +``` + +### 分页与排序查询 + +```java +@RestController +@RequestMapping("/api/users") +@RequiredArgsConstructor +public class UserController { + + private final UserRepository userRepository; + + @GetMapping + public Page list( + @RequestParam(defaultValue = "0") int page, + @RequestParam(defaultValue = "20") int size, + @RequestParam(required = false) String keyword) { + + Pageable pageable = PageRequest.of(page, size, Sort.by("id").descending()); + + if (keyword != null && !keyword.isBlank()) { + return userRepository.findByEmailContaining(keyword, pageable); + } + return userRepository.findAll(pageable); + } +} +``` + +### Specification 动态查询 + +适用于多条件组合筛选场景，避免为每种组合定义单独的 Repository 方法： + +```java +public class UserSpecifications { + + public static Specification hasUsername(String username) { + return (root, query, cb) -> + username == null ? null : cb.equal(root.get("username"), username); + } + + public static Specification emailContains(String email) { + return (root, query, cb) -> + email == null ? null : cb.like(root.get("email"), "%" + email + "%"); + } +} + +// 在 Service 中组合使用 +@Service +@RequiredArgsConstructor +public class UserSearchService { + + private final UserRepository userRepository; + + public Page search(String username, String email, Pageable pageable) { + Specification spec = Specification + .where(UserSpecifications.hasUsername(username)) + .and(UserSpecifications.emailContains(email)); + return userRepository.findAll(spec, pageable); + } +} +``` + +### Example 查询 + +基于实体对象字段值自动匹配，适合简单等值条件查询： + +```java +User probe = new User(); +probe.setUsername("zhangsan"); + +ExampleMatcher matcher = ExampleMatcher.matching() + .withIgnoreCase() + .withStringMatcher(ExampleMatcher.StringMatcher.CONTAINING); + +List results = userRepository.findAll(Example.of(probe, matcher)); +``` diff --git a/docs/capabilities/springboot/ioc-container.md b/docs/capabilities/springboot/ioc-container.md new file mode 100644 index 000000000..243e11bab --- /dev/null +++ b/docs/capabilities/springboot/ioc-container.md @@ -0,0 +1,218 @@ +--- +name: springboot/ioc-container +module: springboot +description: Spring IoC 容器，提供依赖注入、AOP、事件发布等核心功能 +status: 已实现 +scope: 后端 +source: 框架:springboot +import: "org.springframework.boot:spring-boot-starter" +framework_version: 3.3.5 +--- + +## 解决什么问题 + +在企业级 Java 应用开发中，对象之间的依赖关系往往错综复杂。如果由开发者手动创建和管理所有对象及其依赖，会导致代码高度耦合、难以测试、难以维护。Spring IoC（Inversion of Control）容器通过以下机制解决这些核心痛点： + +- **依赖注入（DI）**：将对象的创建和组装交由容器统一管理，业务代码无需关心依赖的来源与生命周期，从而实现组件间的解耦。 +- **声明式配置**：通过注解或 Java Config 描述 Bean 的定义与装配规则，替代冗长的工厂模式或手动 new 对象的方式。 +- **AOP 支持**：在不修改业务代码的前提下，以切面方式织入事务管理、日志记录、权限校验等横切关注点。 +- **事件驱动**：提供 `ApplicationEventPublisher` 发布-订阅机制，使模块间可以通过事件进行松耦合通信，这也是本项目 DDD 领域事件基础设施的底层支撑。 +- **生命周期管理**：容器负责 Bean 的初始化、回调（如 `@PostConstruct`）和销毁，简化资源管理逻辑。 + +典型复用场景包括：Service 层注入 Repository、Controller 注入 Service、通过 AOP 统一处理异常与日志、使用 `ApplicationListener` 监听启动完成事件等。 + +## 如何使用 + +### 引入依赖 + +在 Maven 项目的 `pom.xml` 中添加： + +```xml + + org.springframework.boot + spring-boot-starter + +``` + +该 starter 已包含 `spring-context`、`spring-aop`、`spring-beans` 等 IoC 核心模块。在本项目中，`springboot-starter` 及其他所有 starter 均已传递依赖此包，无需额外声明。 + +### Bean 定义与注入 + +| 方式 | 说明 | +|------|------| +| `@Component` / `@Service` / `@Repository` / `@Controller` | 类级别注解，标记为 Spring 管理的 Bean | +| `@Bean` | 在 `@Configuration` 类的方法上声明第三方或非注解类的 Bean | +| `@Autowired` | 按类型自动注入（推荐用于构造器注入） | +| `@Qualifier("beanName")` | 当同类型存在多个 Bean 时，指定具体名称 | +| `@Value("${key}")` | 注入配置文件中的属性值 | +| `@Scope("prototype")` | 改变 Bean 作用域，默认为 `singleton` | + +### AOP 使用 + +1. 添加 `spring-boot-starter-aop` 依赖（或使用 AspectJ）。 +2. 编写切面类，使用 `@Aspect` + `@Component` 标注。 +3. 通过 `@Around`、`@Before`、`@After` 等通知注解定义切入点与增强逻辑。 + +### 事件发布与监听 + +- 注入 `ApplicationEventPublisher`，调用 `publishEvent()` 发布自定义事件。 +- 使用 `@EventListener` 注解或实现 `ApplicationListener` 接口监听事件。 +- 配合 `@TransactionalEventListener` 可在事务提交后再触发处理逻辑。 + +### 配置方式 + +Spring Boot 优先使用基于注解的配置风格： + +- `@SpringBootApplication` 组合了 `@Configuration`、`@EnableAutoConfiguration`、`@ComponentScan`。 +- `@Import` 可导入额外的配置类。 +- `application.properties` / `application.yml` 提供外部化配置，通过 `@ConfigurationProperties` 绑定到 Bean。 + +## 使用实例 + +### 基本依赖注入 + +```java +@Service +public class UserService { + + private final UserRepository userRepository; + + // 构造器注入（推荐方式，Spring 4.3+ 单构造器可省略 @Autowired） + public UserService(UserRepository userRepository) { + this.userRepository = userRepository; + } + + public User findById(Long id) { + return userRepository.findById(id) + .orElseThrow(() -> new EntityNotFoundException("User not found: " + id)); + } +} + +@RestController +@RequestMapping("/api/users") +public class UserController { + + private final UserService userService; + + public UserController(UserService userService) { + this.userService = userService; + } + + @GetMapping("/{id}") + public SingleResponse getUser(@PathVariable Long id) { + return Response.ok(userService.findById(id)); + } +} +``` + +### 通过 @Bean 注册第三方组件 + +```java +@Configuration +public class AppConfig { + + @Bean + public RestTemplate restTemplate(RestTemplateBuilder builder) { + return builder + .setConnectTimeout(Duration.ofSeconds(5)) + .setReadTimeout(Duration.ofSeconds(10)) + .build(); + } +} +``` + +### AOP 切面示例 + +```java +@Aspect +@Component +@Slf4j +public class MethodExecutionLogAspect { + + @Around("@annotation(org.springframework.stereotype.Service)") + public Object logMethodExecution(ProceedingJoinPoint joinPoint) throws Throwable { + String methodName = joinPoint.getSignature().toShortString(); + long start = System.currentTimeMillis(); + + try { + Object result = joinPoint.proceed(); + log.info("{} executed in {}ms", methodName, System.currentTimeMillis() - start); + return result; + } catch (Throwable ex) { + log.error("{} failed after {}ms", methodName, System.currentTimeMillis() - start, ex); + throw ex; + } + } +} +``` + +### 事件发布与监听 + +```java +// 定义事件 +public class UserCreatedEvent extends ApplicationEvent { + private final User user; + + public UserCreatedEvent(Object source, User user) { + super(source); + this.user = user; + } + + public User getUser() { + return user; + } +} + +// 发布事件 +@Service +public class UserService { + + private final ApplicationEventPublisher eventPublisher; + + public UserService(ApplicationEventPublisher eventPublisher) { + this.eventPublisher = eventPublisher; + } + + @Transactional + public User createUser(CreateUserCommand command) { + User user = new User(command.getName(), command.getEmail()); + userRepository.save(user); + eventPublisher.publishEvent(new UserCreatedEvent(this, user)); + return user; + } +} + +// 监听事件 +@Component +@Slf4j +public class UserCreatedNotificationHandler { + + @EventListener + public void onUserCreated(UserCreatedEvent event) { + log.info("New user created: {}, sending welcome notification", event.getUser().getName()); + // 发送欢迎邮件或消息... + } +} +``` + +### 生命周期回调 + +```java +@Component +public class CacheWarmupService { + + @PostConstruct + public void warmupCache() { + // 容器初始化完成后预热缓存 + log.info("Warming up application cache..."); + } + + @PreDestroy + public void cleanup() { + // 容器关闭前释放资源 + log.info("Cleaning up resources before shutdown..."); + } +} +``` + +以上示例展示了 Spring IoC 容器在日常开发中最常用的能力。在本项目中，框架的事件系统（`IEvent`、`EventPusher`）、数据权限 SQL 拦截等高级特性均构建于 IoC 容器之上，理解 IoC 是掌握整个框架的基础。 diff --git a/docs/capabilities/springboot/security.md b/docs/capabilities/springboot/security.md new file mode 100644 index 000000000..d30523bac --- /dev/null +++ b/docs/capabilities/springboot/security.md @@ -0,0 +1,231 @@ +--- +name: springboot/security +module: springboot +description: Spring Security，提供认证、授权和 CSRF 防护 +status: 已实现 +scope: 后端 +source: 框架:springboot +import: "org.springframework.boot:spring-boot-starter-security" +framework_version: 3.3.5 +--- + +## 解决什么问题 + +在企业级 Web 应用中，安全是最基础且最复杂的横切关注点。开发者通常需要面对以下痛点： + +- **认证机制繁琐**：手动实现 JWT / Redis Token 的签发、解析、续期和过期校验逻辑，代码重复且容易出错。 +- **授权规则分散**：URL 级别的访问控制散落在各个 Controller 或拦截器中，缺乏统一的安全策略配置入口。 +- **登录/登出流程耦合**：JSON API 场景下的登录成功/失败响应、Token 返回格式、登出清理等逻辑与业务代码高度耦合。 +- **安全防护遗漏**：CSRF、CORS、Frame Options 等浏览器安全头需要逐一配置，默认值往往不适合前后端分离架构。 +- **扩展困难**：当需要在认证前后插入自定义逻辑（如验证码校验、审计日志、多因子认证）时，缺少标准化的扩展点。 + +`springboot-starter-security` 模块在 Spring Security 6.x 基础上进行了二次封装，通过 `TokenGateway` 抽象令牌存储（JWT / Redis 双模式）、`SecurityLoginHandler` 开放登录生命周期钩子、`HttpSecurityCustomer` 允许自定义安全链配置，将上述问题收敛到统一的自动配置体系中，使业务项目只需声明少量配置即可获得生产级的安全基础设施。 + +## 如何使用 + +### 1. 引入依赖 + +```xml + + com.codingapi.springboot + springboot-starter-security + +``` + +该 starter 会自动引入 `spring-boot-starter-security` 并注册 `AutoConfiguration`。 + +### 2. 核心配置项 + +在 `application.properties` 中通过 `codingapi.security.*` 前缀进行配置： + +```properties +# 需要认证的 URL 模式（逗号分隔），匹配后必须携带有效 Token +codingapi.security.authenticated-urls=/api/** + +# 免认证的 URL 模式（逗号分隔） +codingapi.security.ignore-urls=/open/**,/public/** + +# 登录接口地址（POST） +codingapi.security.login-processing-url=/user/login + +# 登出接口地址 +codingapi.security.logout-url=/user/logout + +# 禁用 CSRF（前后端分离场景通常为 true） +codingapi.security.disable-csrf=true + +# 禁用 CORS 内置处理（由框架自动配置 CORS 映射） +codingapi.security.disable-cors=true + +# 禁用 Basic Auth +codingapi.security.disable-basic-auth=true + +# 禁用 Frame Options +codingapi.security.disable-frame-options=true +``` + +### 3. 核心接口 + +| 接口 | 职责 | 扩展方式 | +|------|------|----------| +| `TokenGateway` | 令牌的创建（`create`）与解析（`parser`） | 实现该接口或使用内置的 `JWTTokenGatewayImpl` / `RedisTokenGatewayImpl` | +| `SecurityLoginHandler` | 登录前置校验（`preHandle`）与后置响应构建（`postHandle`） | 实现该接口并注册为 Bean，替换默认行为 | +| `AuthenticationTokenFilter` | Token 验证通过后的附加过滤逻辑 | 实现该接口并注册为 Bean | +| `HttpSecurityCustomer` | 自定义 `HttpSecurity` 配置链 | 实现 `customize(HttpSecurity)` 方法 | +| `UserDetailsService` | 用户加载 | 注册自定义 Bean 替换默认的内存用户 | +| `PasswordEncoder` | 密码编码 | 注册自定义 Bean 替换默认的 DelegatingPasswordEncoder | + +所有接口均标注 `@ConditionalOnMissingBean`，业务项目注册同名 Bean 即可无缝替换默认实现。 + +### 4. Token 模型 + +`Token` 对象封装了完整的令牌信息： + +- `username` — 用户名 +- `authorities` — 权限列表 +- `extra` — 业务扩展字段（JSON 字符串，可通过 `parseExtra(Class)` 反序列化） +- `expireTime` / `remindTime` — 过期时间与续期提醒时间 +- `canRestToken()` — 判断是否需要自动续期 +- `getAuthenticationToken()` — 转换为 Spring Security 的 `UsernamePasswordAuthenticationToken` + +### 5. 自动装配链路 + +`AutoConfiguration` 自动完成以下装配： + +1. 注册 `SecurityFilterChain`，配置 URL 授权规则、异常处理、登录/登出端点 +2. 通过 `HttpSecurityConfigurer` 注入 `MyLoginFilter`（登录）和 `MyAuthenticationFilter`（Token 鉴权） +3. 注册 `DaoAuthenticationProvider` 绑定 `UserDetailsService` 和 `PasswordEncoder` +4. 根据 `disableCors` 配置自动注册 CORS 映射 + +## 使用实例 + +### 示例 1：自定义 UserDetailsService 对接数据库 + +```java +@Service +public class DatabaseUserDetailsService implements UserDetailsService { + + private final UserRepository userRepository; + private final PasswordEncoder passwordEncoder; + + public DatabaseUserDetailsService(UserRepository userRepository, + PasswordEncoder passwordEncoder) { + this.userRepository = userRepository; + this.passwordEncoder = passwordEncoder; + } + + @Override + public UserDetails loadUserByUsername(String username) throws UsernameNotFoundException { + UserEntity entity = userRepository.findByUsername(username) + .orElseThrow(() -> new UsernameNotFoundException("用户不存在: " + username)); + + return User.withUsername(entity.getUsername()) + .password(entity.getPassword()) + .roles(entity.getRole()) + .build(); + } +} +``` + +注册此 Bean 后，框架自动替换默认的内存用户管理器。 + +### 示例 2：自定义登录处理器（增加验证码校验） + +```java +@Component +public class CaptchaSecurityLoginHandler implements SecurityLoginHandler { + + private final CaptchaService captchaService; + + public CaptchaSecurityLoginHandler(CaptchaService captchaService) { + this.captchaService = captchaService; + } + + @Override + public void preHandle(HttpServletRequest request, HttpServletResponse response, + LoginRequest loginRequest) throws Exception { + String captchaCode = loginRequest.getString("captcha"); + String captchaKey = loginRequest.getString("captchaKey"); + if (!captchaService.verify(captchaKey, captchaCode)) { + throw new AuthenticationServiceException("验证码错误"); + } + } + + @Override + public LoginResponse postHandle(HttpServletRequest request, HttpServletResponse response, + LoginRequest loginRequest, UserDetails user, Token token) { + LoginResponse loginResponse = new LoginResponse(); + loginResponse.setToken(token.getToken()); + loginResponse.setUsername(token.getUsername()); + loginResponse.setAuthorities(token.getAuthorities()); + // 可在此处追加额外的响应字段 + return loginResponse; + } +} +``` + +### 示例 3：Token 验证后注入上下文 + +```java +@Component +public class TenantAuthenticationTokenFilter implements AuthenticationTokenFilter { + + @Override + public void doFilter(HttpServletRequest request, HttpServletResponse response) + throws IOException, ServletException { + Authentication auth = SecurityContextHolder.getContext().getAuthentication(); + if (auth != null && auth.getPrincipal() instanceof Token token) { + // 从 Token extra 中提取租户 ID 并放入线程上下文 + TenantContext context = token.parseExtra(TenantContext.class); + if (context != null) { + TenantHolder.set(context.getTenantId()); + } + } + } +} +``` + +### 示例 4：自定义 HttpSecurity 配置 + +```java +@Component +public class CustomHttpSecurityCustomer implements HttpSecurityCustomer { + + @Override + public void customize(HttpSecurity security) throws Exception { + // 启用 OAuth2 Resource Server + security.oauth2ResourceServer(oauth2 -> oauth2.jwt(Customizer.withDefaults())); + // 添加自定义 Header + security.headers(headers -> headers + .contentSecurityPolicy(csp -> csp.policyDirectives("default-src 'self'"))); + } +} +``` + +### 示例 5：前端调用登录接口 + +```bash +curl -X POST http://localhost:8090/user/login \ + -H "Content-Type: application/json" \ + -d '{"username":"admin","password":"admin"}' +``` + +成功响应： + +```json +{ + "success": true, + "data": { + "token": "eyJhbGciOiJIUzI1NiJ9...", + "username": "admin", + "authorities": ["ROLE_ADMIN"] + } +} +``` + +后续请求携带 Token： + +```bash +curl http://localhost:8090/api/users \ + -H "Authorization: eyJhbGciOiJIUzI1NiJ9..." +``` diff --git a/docs/conventions/index.md b/docs/conventions/index.md new file mode 100644 index 000000000..df2f11ffb --- /dev/null +++ b/docs/conventions/index.md @@ -0,0 +1,17 @@ +# 规范（Conventions） + +> 🔄 此文件由 `rebuild_pkr_index.py` 自动生成，请勿手动编辑。 + +## ✅ 已实现 + +| 名称 | 模块 | 描述 | 范围 | 来源 | +|------|------|------|------|------| +| [springboot-starter/ddd-layered-architecture](./springboot-starter/ddd-layered-architecture.md) | springboot-starter | DDD 分层架构规范，定义 interface/app/domain/infra 四层的依赖规则和职责划分 | 后端 | 项目自有 | +| [springboot-starter/event-driven-convention](./springboot-starter/event-driven-convention.md) | springboot-starter | 事件驱动开发规范，定义 IEvent/IHandler 的使用约定和事件处理模式 | 后端 | 项目自有 | +| [springboot-starter/exception-handling-convention](./springboot-starter/exception-handling-convention.md) | springboot-starter | 全局异常处理规范，定义异常抛出和捕获的标准模式 | 后端 | 项目自有 | +| [springboot-starter/response-convention](./springboot-starter/response-convention.md) | springboot-starter | 统一响应格式规范，定义 Controller 层返回值的标准格式 | 后端 | 项目自有 | +| [springboot-starter-data-fast/dynamic-query-convention](./springboot-starter-data-fast/dynamic-query-convention.md) | springboot-starter-data-fast | 动态查询规范，定义 PageRequest + RequestFilter + FastRepository 的使用模式 | 后端 | 项目自有 | + +--- + +**统计**: 共 5 篇 — 已实现 5 / 计划中 0 / 已废弃 0 diff --git a/docs/conventions/springboot-starter-data-fast/dynamic-query-convention.md b/docs/conventions/springboot-starter-data-fast/dynamic-query-convention.md new file mode 100644 index 000000000..54039a8c7 --- /dev/null +++ b/docs/conventions/springboot-starter-data-fast/dynamic-query-convention.md @@ -0,0 +1,152 @@ +--- +name: springboot-starter-data-fast/dynamic-query-convention +module: springboot-starter-data-fast +description: 动态查询规范，定义 PageRequest + RequestFilter + FastRepository 的使用模式 +status: 已实现 +scope: 后端 +source: 项目自有 +import: "com.codingapi.springboot:springboot-starter-data-fast" +content_hash: 0369b4e3ba19d679dea69480cf4c5f6e4687c186c515e56883c004884711ab83 +--- + +## 解决什么问题 + +在企业级应用中，列表查询往往需要根据前端传入的动态条件进行过滤。如果不遵守本规范，会导致以下问题： + +1. **SQL 注入风险**：在 Service 层手动拼接 SQL 字符串实现动态查询，极易引入 SQL 注入漏洞。 +2. **代码重复与维护困难**：每个实体的动态查询都手写 `if-else` 判断和原生 SQL，导致大量重复代码，新增过滤字段需修改多处。 +3. **分页逻辑不一致**：各模块自行处理分页参数（偏移量计算、排序），缺乏统一标准，容易出现边界错误。 +4. **CQRS 职责混乱**：查询逻辑与命令逻辑耦合在同一 Service 中，违反读写分离原则，增加系统复杂度。 +5. **类型安全缺失**：使用 Map 或 JSON 传递查询条件时，缺乏编译期检查，运行时才发现字段名拼写错误或类型不匹配。 +6. **框架能力浪费**：不使用 `FastRepository` 提供的自动 Example/HQL 构建能力，绕过框架自建查询机制，失去统一的 SQL 拦截（如数据权限）支持。 + +## 如何使用 + +### 核心规则 + +1. **列表查询统一使用 `PageRequest` 构建分页参数** + - 通过 `PageRequest.of(page, size)` 或 `new PageRequest()` 创建请求对象。 + - 禁止直接使用 Spring Data 原生 `org.springframework.data.domain.PageRequest` 来承载业务过滤条件。 + +2. **动态过滤条件通过 `PageRequest.addFilter()` 方法添加** + - 简单等值过滤：`pageRequest.addFilter("name", "张三")`，默认使用 `Relation.EQUAL`。 + - 指定关系过滤：`pageRequest.addFilter("age", Relation.GREATER_THAN, 18)`。 + - 组合过滤：使用 `andFilter(Filter...)` 和 `orFilters(Filter...)` 构建复杂条件。 + +3. **过滤关系使用 `Relation` 枚举** + - 枚举位于 `com.codingapi.springboot.framework.dto.request.Relation`，使用前必须显式导入（`import com.codingapi.springboot.framework.dto.request.Relation;`）。 + - 可用关系共 14 种：`EQUAL`、`NOT_EQUAL`、`LIKE`、`LEFT_LIKE`、`RIGHT_LIKE`、`BETWEEN`、`IN`、`NOT_IN`、`IS_NULL`、`IS_NOT_NULL`、`GREATER_THAN`、`LESS_THAN`、`GREATER_THAN_EQUAL`、`LESS_THAN_EQUAL`。 + - 所有过滤关系必须通过枚举表达，禁止硬编码字符串比较运算符。 + +4. **Repository 接口需继承 `FastRepository`** + - 实体 Repository 必须扩展 `FastRepository` 以获得动态查询能力。 + - `FastRepository` 同时继承了 `JpaRepository`、`JpaSpecificationExecutor`、`DynamicRepository` 和 `DynamicNativeRepository`。 + +5. **调用 `FastRepository.findAll(PageRequest)` 执行动态查询** + - 当 `PageRequest` 包含 Filter 时，自动通过 `ExampleBuilder` 构建 Example 查询。 + - 需要 HQL 级别查询时，使用 `pageRequest(PageRequest)` 方法，自动通过 `DynamicSQLBuilder` 生成 HQL。 + - 禁止绕过 `FastRepository` 提供的默认方法自行编写动态查询逻辑。 + +6. **禁止在 Service 层手写原生 SQL 实现动态查询** + - 不允许使用 `@Query(nativeQuery = true)` 或 `EntityManager.createNativeQuery()` 拼接动态条件。 + - 所有动态过滤必须委托给 `FastRepository` 的 Filter 机制完成。 + +7. **查询服务（CQRS Query 侧）应独立于命令服务** + - 查询服务放在 `*-app-query` 模块中，仅负责读取操作。 + - 命令服务放在 `*-app-cmd-*` 模块中，负责写入与领域编排。 + - 两者不得互相依赖或合并为同一个类。 + +### 命名约定 + +- 查询服务类命名：`{Entity}QueryService`，位于 `*.query` 包下。 +- 命令服务类命名：`{Entity}CmdService`，位于 `*.cmd` 包下。 +- Controller 中的列表查询方法参数类型统一为 `PageRequest`。 + +## 使用实例 + +### ✅ 正确示例 + +```java +import com.codingapi.springboot.framework.dto.request.Relation; +import com.codingapi.springboot.framework.dto.response.MultiResponse; + +// 1. Repository 继承 FastRepository +public interface UserRepository extends FastRepository { +} + +// 2. 查询服务独立于命令服务 +@Service +public class UserQueryService { + + @Autowired + private UserRepository userRepository; + + public Page listUsers(String name, Integer minAge, int page, int size) { + PageRequest request = PageRequest.of(page, size); + + // 动态添加过滤条件 + if (StringUtils.hasText(name)) { + request.addFilter("name", Relation.LIKE, name); + } + if (minAge != null) { + request.addFilter("age", Relation.GREATER_THAN_EQUAL, minAge); + } + + // 委托 FastRepository 自动构建查询 + return userRepository.findAll(request); + } +} + +// 3. Controller 接收 PageRequest +@GetMapping("/users") +public MultiResponse list( + @RequestParam(required = false) String name, + @RequestParam(required = false) Integer minAge, + @RequestParam(defaultValue = "0") int page, + @RequestParam(defaultValue = "20") int size) { + Page result = userQueryService.listUsers(name, minAge, page, size); + return MultiResponse.of(result); +} +``` + +### ❌ 错误示例 + +```java +// 错误 1: Repository 未继承 FastRepository，丧失动态查询能力 +public interface UserRepository extends JpaRepository { +} + +// 错误 2: Service 中手写原生 SQL 拼接动态条件 +@Service +public class UserService { + + @PersistenceContext + private EntityManager entityManager; + + public List listUsers(String name, Integer minAge) { + StringBuilder sql = new StringBuilder("SELECT * FROM users WHERE 1=1"); + if (name != null) { + sql.append(" AND name LIKE '%").append(name).append("%'"); // SQL 注入风险！ + } + if (minAge != null) { + sql.append(" AND age >= ").append(minAge); + } + return entityManager.createNativeQuery(sql.toString(), User.class).getResultList(); + } +} + +// 错误 3: 查询与命令逻辑混合在同一个 Service 中 +@Service +public class UserService { + public Page list(...) { /* 查询逻辑 */ } + public void createUser(...) { /* 命令逻辑 */ } + public void deleteUser(...) { /* 命令逻辑 */ } +} + +// 错误 4: 使用 Spring Data 原生 PageRequest，无法承载 Filter +@GetMapping("/users") +public Page list(org.springframework.data.domain.PageRequest pageable) { + // 丢失了框架的动态过滤能力 + return userRepository.findAll(pageable); +} +``` diff --git a/docs/conventions/springboot-starter/ddd-layered-architecture.md b/docs/conventions/springboot-starter/ddd-layered-architecture.md new file mode 100644 index 000000000..c1a97a8cd --- /dev/null +++ b/docs/conventions/springboot-starter/ddd-layered-architecture.md @@ -0,0 +1,224 @@ +--- +name: springboot-starter/ddd-layered-architecture +module: springboot-starter +description: DDD 分层架构规范，定义 interface/app/domain/infra 四层的依赖规则和职责划分 +status: 已实现 +scope: 后端 +source: 项目自有 +import: "com.codingapi.springboot:springboot-starter" +--- + +## 解决什么问题 + +不遵守 DDD 分层架构规范会导致以下问题： + +1. **领域逻辑污染**：domain 层直接引用 infra 层实现类（如 JPA Repository、Redis Client），导致业务规则与基础设施耦合，无法独立演进和测试。 +2. **依赖方向混乱**：若 domain 反向依赖 app 或 interface，修改一个 API 接口可能牵连整个领域模型重构，变更成本指数级增长。 +3. **CQRS 读写混淆**：查询服务与命令服务混杂在同一模块中，复杂查询被迫走聚合根加载全量数据，性能瓶颈难以定位和优化。 +4. **接口层职责膨胀**：Controller 中直接编排业务流程、拼装 DTO、处理事件，导致接口层成为"上帝类"，复用性和可维护性急剧下降。 +5. **Repository 契约缺失**：domain 层直接使用具体持久化实现而非接口，切换存储方案（如从 MySQL 迁移到 MongoDB）需要改动所有调用方代码。 + +## 如何使用 + +### 四层架构与依赖方向 + +``` +interface → app → domain ← infra +``` + +| 层级 | 模块命名约定 | 核心职责 | 允许依赖 | +|------|-------------|---------|---------| +| **interface**（接口层） | `*-interface` | Controller（REST API）、Handler（事件处理器）、Runner（启动任务） | app | +| **app**（应用层） | `*-app-query` / `*-app-cmd-*` | query：CQRS 查询服务；cmd：命令服务与领域编排 | domain | +| **domain**（领域层） | `*-domain-*` | Entity、ValueObject、DomainService、Repository 接口、DomainEvent | 无外部框架 | +| **infra**（基础设施层） | `*-infra-*` | Repository 实现、Gateway 实现、外部服务适配、持久化配置 | domain | + +### 核心规则 + +1. **依赖方向严格单向**：`interface → app → domain ← infra`。禁止反向依赖和跨层依赖。 +2. **domain 层纯业务**：domain 层只包含领域模型和业务逻辑，不依赖 Spring、JPA、Redis 等任何外部框架。 +3. **Repository 接口在 domain，实现在 infra**：domain 层定义 Repository 接口，infra 层提供具体实现并通过 Spring Bean 注入。 +4. **app 层按 CQRS 拆分**：查询服务（query）与命令服务（cmd）分模块，query 侧可直接读取视图/DTO，cmd 侧通过聚合根执行业务操作。 +5. **interface 层仅做适配**：Controller 只做参数校验、权限检查和响应封装，业务编排委托给 app 层；Handler 只负责事件监听与转发。 +6. **禁止 domain 引用 infra 实现类**：domain 层不得 import infra 包下的任何类，包括具体的 Repository 实现、DAO、Client 等。 + +### 包结构约定 + +``` +{bounded-context}/ + {context}-interface/ # 接口层 + controller/ + handler/ + runner/ + {context}-app/ # 应用层 + {context}-app-query/ # CQRS Query 侧 + {context}-app-cmd-domain/ # CQRS Command 侧（领域编排） + {context}-domain/ # 领域层 + model/ # Entity, ValueObject + repository/ # Repository 接口 + service/ # DomainService + event/ # DomainEvent + {context}-infra/ # 基础设施层 + jpa/ # Repository 实现 + gateway/ # 外部服务适配 +``` + +## 使用实例 + +### ✅ 正确示例 + +**domain 层定义 Repository 接口：** + +```java +// example-domain-user/src/.../repository/UserRepository.java +package com.example.domain.user.repository; + +public interface UserRepository { + User findById(Long id); + void save(User user); +} +``` + +**infra 层提供 Repository 实现：** + +```java +// example-infra-jpa/src/.../jpa/UserRepositoryImpl.java +package com.example.infra.jpa; + +import com.example.domain.user.repository.UserRepository; +import org.springframework.stereotype.Repository; + +@Repository +public class UserRepositoryImpl implements UserRepository { + private final UserJpaDao userJpaDao; + + @Override + public User findById(Long id) { + return userJpaDao.findById(id).map(UserConverter::toDomain).orElse(null); + } + + @Override + public void save(User user) { + userJpaDao.save(UserConverter.toEntity(user)); + } +} +``` + +**app 层按 CQRS 拆分：** + +```java +// example-app-query: 查询服务，直接返回 DTO +@Service +public class UserQueryService { + private final UserReadDao userReadDao; // 可直接读视图 + + public SingleResponse getUser(Long id) { + return SingleResponse.of(userReadDao.findUserDTO(id)); + } +} + +// example-app-cmd-domain: 命令服务，通过聚合根操作 +@Service +public class UserCommandService { + private final UserRepository userRepository; // domain 层接口 + + @Transactional + public Response createUser(CreateUserCmd cmd) { + User user = User.create(cmd.getName(), cmd.getEmail()); + userRepository.save(user); + return Response.success(); + } +} +``` + +**interface 层仅做适配：** + +```java +@RestController +@RequestMapping("/api/users") +public class UserController { + private final UserQueryService queryService; + private final UserCommandService commandService; + + @GetMapping("/{id}") + public SingleResponse getUser(@PathVariable Long id) { + return queryService.getUser(id); // 委托 app 层 + } + + @PostMapping + public Response createUser(@Valid @RequestBody CreateUserCmd cmd) { + return commandService.createUser(cmd); // 委托 app 层 + } +} +``` + +### ❌ 错误示例 + +**domain 层直接引用 infra 实现类：** + +```java +// ❌ domain 层 import 了 infra 包的类 +package com.example.domain.user.service; + +import com.example.infra.jpa.UserJpaDao; // 违规！domain 不应依赖 infra + +@Service +public class UserService { + private final UserJpaDao userJpaDao; // 应使用 UserRepository 接口 + + public User findUser(Long id) { + return userJpaDao.findById(id).orElse(null); + } +} +``` + +**依赖方向反转：** + +```java +// ❌ domain 层反向依赖 app 层 +package com.example.domain.user.model; + +import com.example.app.cmd.domain.UserService; // 违规！domain 不应依赖 app + +public class User { + public void activate() { + UserService userService = ...; // 领域对象不应调用应用服务 + userService.sendActivationEmail(this); + } +} +``` + +**app 层未拆分 CQRS，查询走聚合根：** + +```java +// ❌ 查询和命令混在一起，列表查询加载完整聚合根 +@Service +public class UserService { + private final UserRepository userRepository; + + // 列表查询不应加载完整 User 聚合根 + public List listUsers(String keyword) { + return userRepository.findAll().stream() + .filter(u -> u.getName().contains(keyword)) + .collect(Collectors.toList()); // 内存过滤，性能灾难 + } +} +``` + +**Controller 中直接编排业务逻辑：** + +```java +// ❌ Controller 承担了本应属于 app 层的职责 +@PostMapping("/orders") +public Response createOrder(@RequestBody OrderCmd cmd) { + User user = userRepository.findById(cmd.getUserId()); // 应在 app 层 + Product product = productRepository.findById(cmd.getProductId()); // 应在 app 层 + if (product.getStock() < cmd.getQuantity()) { // 业务校验应在 domain + return Response.error("库存不足"); + } + Order order = new Order(user, product, cmd.getQuantity()); // 领域创建应在 app/cmd + orderRepository.save(order); // 应在 app 层 + eventPusher.push(new OrderCreatedEvent(order)); // 事件推送应在 app 层 + return Response.success(order.getId()); +} +``` diff --git a/docs/conventions/springboot-starter/event-driven-convention.md b/docs/conventions/springboot-starter/event-driven-convention.md new file mode 100644 index 000000000..267f9e5c4 --- /dev/null +++ b/docs/conventions/springboot-starter/event-driven-convention.md @@ -0,0 +1,217 @@ +--- +name: springboot-starter/event-driven-convention +module: springboot-starter +description: 事件驱动开发规范，定义 IEvent/IHandler 的使用约定和事件处理模式 +status: 已实现 +scope: 后端 +source: 项目自有 +import: "com.codingapi.springboot:springboot-starter" +content_hash: 02975087ebd599ed5978c834297c16c37ae4e31ec37d964d753353b1de9fb07d +--- + +## 解决什么问题 + +不遵守事件驱动开发规范会导致以下问题： + +1. **事务耦合风险**：将事件处理与主业务事务强绑定，导致分支业务的失败回滚整个主事务，破坏领域事件的独立性原则。当分支逻辑（如通知、日志、缓存更新）出错时，不应影响核心业务流程的提交。 + +2. **事件类型混乱**：不区分同步事件与异步事件，导致关键业务事件被异步执行产生时序问题，或非关键事件被同步阻塞影响主流程性能。 + +3. **Handler 注册失效**：未通过 `@Service` 注解将 Handler 注册为 Spring Bean，导致框架无法自动发现处理器，事件推送后无响应且难以排查。 + +4. **执行顺序不可控**：多个 Handler 订阅同一事件时未指定 `order()`，导致处理顺序依赖 Bean 加载顺序，在不同环境或重启后行为不一致。 + +5. **异常处理缺失**：未实现 `error()` 回调或直接在 `handler()` 中抛出未捕获异常，导致后续 Handler 被跳过且错误信息丢失，事件链中断而无法感知。 + +6. **绕过 EventPusher 直接调用**：手动实例化 Handler 或直接调用处理方法，绕过框架的循环检测、线程池调度和上下文传递机制，引发循环事件死锁或丢失链路追踪信息。 + +## 如何使用 + +### 规则 1：事件类必须实现 IEvent 接口 + +所有事件类必须实现 `IEvent` 接口。根据执行方式选择子接口： + +- **同步事件**：实现 `ISyncEvent`，在当前线程内按顺序执行所有 Handler +- **异步事件**：实现 `IAsyncEvent`，由框架线程池异步调度执行 + +事件类应为纯数据载体，不包含业务逻辑，并实现 `Serializable` 以支持序列化传输。 + +### 规则 2：事件处理器必须实现 IHandler 接口 + +Handler 通过泛型参数声明订阅的事件类型。框架的 Handler 注册机制分为两个阶段：① `HandlerBeanDefinitionRegistrar` 只扫描带 `@Handler` 注解的类并注册为 Spring BeanDefinition（使用 `@Component`/`@Service` 标注的 Handler 则由 Spring 组件扫描注册为 Bean）；② `SpringHandlerConfiguration` 收集容器中所有 `IHandler` Bean，在构造 `SpringDefaultEventHandler`/`SpringTransactionEventHandler` 时通过 `addHandlers` 统一注册到 `ApplicationHandlerUtils`。 + +```java +public interface IHandler { + default int order() { return 0; } + void handler(T event); + default void error(Exception exception) throws Exception { throw exception; } +} +``` + +### 规则 3：事件处理器通过 @Service 注解注册为 Spring Bean + +Handler 必须标注 `@Service`（或 `@Component`）注解，确保被 Spring 容器管理。未注册为 Bean 的 Handler 不会被框架发现和调用。 + +### 规则 4：事件推送统一使用 EventPusher.push() 静态方法 + +所有事件推送必须通过 `EventPusher.push(event)` 发起，禁止手动调用 Handler。框架内置循环事件检测机制，当检测到事件循环推送时自动抛出异常。若确认需要允许循环事件，可使用 `EventPusher.push(event, true)` 关闭检测。 + +### 规则 5：事件不应与主业务强耦合事务绑定 + +事件处理的核心理念是**解耦**。事件对于主业务来说可成功可失败，成功与失败都不应强关联主体业务。若分支逻辑必须与主事务保持一致，应直接使用服务调用而非事件机制。 + +### 规则 6：多个 Handler 通过 order() 方法控制执行顺序 + +当多个 Handler 订阅同一事件时，通过重写 `order()` 方法指定执行优先级。数值越小越先执行，默认值为 0。相同 order 值的 Handler 执行顺序不确定。 + +### 规则 7：Handler 的 error() 回调处理异常 + +`error()` 方法接收 Handler 执行过程中抛出的异常。默认实现会重新抛出异常，这将**阻止后续 Handler 的执行**。若希望某个 Handler 的失败不影响其他 Handler，应在 `error()` 中记录日志而不重新抛出。 + +## 使用实例 + +### ✅ 正确示例 + +```java +// 1. 定义同步事件 +public class UserCreatedEvent implements ISyncEvent { + private final String userId; + private final String username; + + public UserCreatedEvent(String userId, String username) { + this.userId = userId; + this.username = username; + } + + public String getUserId() { return userId; } + public String getUsername() { return username; } +} + +// 2. 定义异步事件 +public class UserNotificationEvent implements IAsyncEvent { + private final String userId; + private final String message; + + public UserNotificationEvent(String userId, String message) { + this.userId = userId; + this.message = message; + } + + public String getUserId() { return userId; } + public String getMessage() { return message; } +} + +// 3. 注册 Handler 并指定执行顺序 +@Service +public class UserCacheRefreshHandler implements IHandler { + + @Override + public int order() { + return 1; // 优先刷新缓存 + } + + @Override + public void handler(UserCreatedEvent event) { + cacheService.refreshUserCache(event.getUserId()); + } + + @Override + public void error(Exception exception) { + // 缓存刷新失败不影响后续 Handler，仅记录日志 + log.warn("缓存刷新失败: {}", exception.getMessage()); + } +} + +@Service +public class UserAuditLogHandler implements IHandler { + + @Override + public int order() { + return 2; // 缓存之后写审计日志 + } + + @Override + public void handler(UserCreatedEvent event) { + auditService.logUserCreation(event.getUserId(), event.getUsername()); + } +} + +// 4. 在业务中推送事件 +@Service +public class UserService { + + public User createUser(CreateUserCommand command) { + User user = userRepository.save(command.toEntity()); + // 通过 EventPusher 推送，不直接调用 Handler + EventPusher.push(new UserCreatedEvent(user.getId(), user.getUsername())); + return user; + } +} +``` + +### ❌ 错误示例 + +```java +// 错误 1：事件未实现 IEvent 接口 +public class UserCreatedEvent { // ❌ 缺少 ISyncEvent / IAsyncEvent + private String userId; +} + +// 错误 2：Handler 未注册为 Spring Bean +public class UserCacheHandler implements IHandler { // ❌ 缺少 @Service + @Override + public void handler(UserCreatedEvent event) { + cacheService.refreshUserCache(event.getUserId()); + } +} + +// 错误 3：在事务中强绑定事件结果 +@Transactional +public User createUser(CreateUserCommand command) { + User user = userRepository.save(command.toEntity()); + try { + EventPusher.push(new UserCreatedEvent(user.getId(), user.getUsername())); + } catch (Exception e) { + throw new RuntimeException("事件处理失败，回滚事务", e); // ❌ 事件失败不应回滚主事务 + } + return user; +} + +// 错误 4：手动调用 Handler 绕过框架 +@Service +public class UserService { + @Autowired + private UserCacheRefreshHandler cacheHandler; + + public User createUser(CreateUserCommand command) { + User user = userRepository.save(command.toEntity()); + cacheHandler.handler(new UserCreatedEvent(user.getId(), user.getUsername())); // ❌ 绕过 EventPusher + return user; + } +} + +// 错误 5：未处理异常导致事件链中断 +@Service +public class FragileHandler implements IHandler { + @Override + public void handler(UserCreatedEvent event) { + externalService.notify(event.getUserId()); // 可能抛出异常 + } + // ❌ 未重写 error()，默认重新抛出异常，阻止后续 Handler 执行 +} + +// 错误 6：多个 Handler 未指定 order，执行顺序不可预测 +@Service +public class HandlerA implements IHandler { + @Override + public void handler(UserCreatedEvent event) { /* ... */ } + // ❌ 未重写 order()，默认 0，与 HandlerB 顺序不确定 +} + +@Service +public class HandlerB implements IHandler { + @Override + public void handler(UserCreatedEvent event) { /* ... */ } + // ❌ 未重写 order()，默认 0，与 HandlerA 顺序不确定 +} +``` diff --git a/docs/conventions/springboot-starter/exception-handling-convention.md b/docs/conventions/springboot-starter/exception-handling-convention.md new file mode 100644 index 000000000..b96238e83 --- /dev/null +++ b/docs/conventions/springboot-starter/exception-handling-convention.md @@ -0,0 +1,156 @@ +--- +name: springboot-starter/exception-handling-convention +module: springboot-starter +description: 全局异常处理规范，定义异常抛出和捕获的标准模式 +status: 已实现 +scope: 后端 +source: 项目自有 +import: "com.codingapi.springboot:springboot-starter" +content_hash: 669e54861ccb844ae926652bdd6b30a9a1b8bbc9f9a55ce145d19c283d499596 +--- + +## 解决什么问题 + +不遵守此规范会导致以下问题： + +1. **错误响应格式不一致**：不同开发者在 Controller 中自行 try-catch 并返回自定义格式的错误信息，导致前端无法统一解析 `errCode` / `errMessage` 字段，增加联调和维护成本。 +2. **缺失国际化支持**：直接抛出 `RuntimeException` 或硬编码中文消息，无法根据请求 Locale 切换语言，多语言场景下用户体验差且需要大量改造。 +3. **异常被吞没**：Controller 层使用 try-catch 捕获异常后仅打印日志或返回 null，调用方无法感知业务失败原因，排查线上问题时缺少关键上下文。 +4. **错误码体系混乱**：各模块自行定义错误码常量或直接拼接字符串，缺乏统一的 key → message 映射机制，同一个业务含义可能出现多个不同的 errCode。 +5. **全局拦截失效**：绕过框架的 `HandlerExceptionResolver` 机制手动处理异常，导致日志记录、监控埋点等横切关注点被跳过。 + +## 如何使用 + +### 规则 1：业务异常统一使用 LocaleMessageException + +所有业务校验失败、参数非法、权限不足等场景，必须抛出 `LocaleMessageException`，禁止直接使用 `RuntimeException`、`IllegalArgumentException` 等原生异常。 + +```java +// 构造方式一（推荐）：仅 errCode，消息从 message.properties 中按当前 Locale 自动解析 +throw new LocaleMessageException("user.not.found"); + +// 构造方式二：errCode + 占位符参数，对应 properties 中 user.duplicate=用户名 {0} 已存在 +throw LocaleMessageException.of("user.duplicate", username); + +// 构造方式三：errCode + 自定义消息，第二个参数直接使用、不走国际化（仅用于无需 i18n 的场景） +throw new LocaleMessageException("custom.error", "自定义错误描述"); +``` + +**需要国际化消息时，必须使用单参构造 `LocaleMessageException(errCode)` 或静态工厂 `LocaleMessageException.of(errCode, args)`**，消息由框架从 message.properties 中按请求 Locale 解析。 + +### 规则 2：异常消息通过 message key 国际化解析 + +- 第一个参数为 **errCode**（即 i18n message key），用于前端匹配和国际化查找。 +- 需要国际化的消息使用单参构造 `LocaleMessageException(errCode)` 或 `LocaleMessageException.of(errCode, args)`，消息从 message.properties 中按当前请求 Locale 解析。 +- 两参构造 `LocaleMessageException(errCode, errMessage)` 的第二个参数是**直接使用、不走国际化的自定义消息**：该构造函数直接以 errMessage 构造异常，**不会查询 MessageSource / message.properties，也不随 Locale 切换**，并非 "key 未配置时的兜底默认消息"。仅在确定无需国际化的场景使用。 +- errCode 命名采用 **点分隔小写** 格式，如 `order.status.invalid`、`auth.token.expired`。 + +### 规则 3：依赖 ExceptionConfiguration 全局拦截 + +框架通过 `ExceptionConfiguration` 注册 `LocaleMessage` Bean，并由 `BasicHandlerExceptionResolverConfiguration` 中的 `ServletExceptionHandler` 统一拦截所有 Controller 层异常： + +- `LocaleMessageException` → 提取 `errCode` 和 `errMessage`，返回标准 Response 格式。 +- 其他未知异常 → 使用默认 errCode `system.err`，返回异常原始消息。 + +**无需在任何 Controller 中添加额外的 @ExceptionHandler。** + +### 规则 4：异常响应统一返回 Response 格式 + +全局拦截器返回的 JSON 结构如下： + +```json +{ + "success": false, + "errCode": "user.not.found", + "errMessage": "用户不存在" +} +``` + +前端只需判断 `success === false` 即可进入统一错误处理流程。 + +### 规则 5：禁止在 Controller 中使用 try-catch 吞掉异常 + +Controller 方法应保持简洁，让异常自然向上抛出由全局处理器接管。如需对特定异常做差异化处理（如参数校验），应在 Service 层完成转换后再抛出 `LocaleMessageException`。 + +### 规则 6：禁止直接抛出 RuntimeException + +`RuntimeException` 没有 `errCode` 字段，全局拦截器只能将其归入 `system.err`，丢失了业务语义。所有可预见的业务异常都必须使用 `LocaleMessageException`。 + +## 使用实例 + +### ✅ 正确示例 + +```java +@Service +public class UserService { + + public User getUser(Long id) { + return userRepository.findById(id) + // 单参构造：消息从 messages.properties 中按 Locale 自动解析 + .orElseThrow(() -> new LocaleMessageException("user.not.found")); + } + + public void createUser(String username) { + if (userRepository.existsByUsername(username)) { + // 使用静态工厂方法 + 占位符参数 + throw LocaleMessageException.of("user.duplicate", username); + } + // ... + } +} + +@RestController +@RequestMapping("/users") +public class UserController { + + @GetMapping("/{id}") + public SingleResponse getUser(@PathVariable Long id) { + // 不需要 try-catch，异常由全局处理器接管 + return SingleResponse.of(userService.getUser(id)); + } +} +``` + +对应的 `messages_zh_CN.properties`： + +```properties +user.not.found=用户不存在 +user.duplicate=用户名 {0} 已存在 +``` + +### ❌ 错误示例 + +```java +// 错误 1：直接抛出 RuntimeException，缺少 errCode +public User getUser(Long id) { + return userRepository.findById(id) + .orElseThrow(() -> new RuntimeException("用户不存在")); +} + +// 错误 2：Controller 中 try-catch 吞掉异常 +@GetMapping("/{id}") +public SingleResponse getUser(@PathVariable Long id) { + try { + return SingleResponse.of(userService.getUser(id)); + } catch (Exception e) { + log.error("查询失败", e); + return null; // 前端收到 null，无法区分成功与失败 + } +} + +// 错误 3：Controller 中自行构建错误响应，绕过全局拦截 +@GetMapping("/{id}") +public ResponseEntity getUser(@PathVariable Long id) { + try { + return ResponseEntity.ok(SingleResponse.of(userService.getUser(id))); + } catch (Exception e) { + Map error = new HashMap<>(); + error.put("code", 500); + error.put("msg", e.getMessage()); + return ResponseEntity.status(500).body(error); + } +} + +// 错误 4：硬编码中文消息，两参构造的第二个参数直接使用、不走国际化 +throw new LocaleMessageException("err001", "这个用户找不到啊"); +``` diff --git a/docs/conventions/springboot-starter/response-convention.md b/docs/conventions/springboot-starter/response-convention.md new file mode 100644 index 000000000..bbb739d63 --- /dev/null +++ b/docs/conventions/springboot-starter/response-convention.md @@ -0,0 +1,156 @@ +--- +name: springboot-starter/response-convention +module: springboot-starter +description: 统一响应格式规范，定义 Controller 层返回值的标准格式 +status: 已实现 +scope: 后端 +source: 项目自有 +import: "com.codingapi.springboot:springboot-starter" +content_hash: f34034d99b0e32ca0ef9f72cf98793135fd15e335facfaca548ab3caa9e14cc1 +--- + +## 解决什么问题 + +在 REST API 开发中，如果不对响应格式做统一约束，会导致以下问题： + +- **前端解析困难**：不同接口返回结构不一致（有的直接返回对象、有的返回 Map、有的包裹在自定义结构中），前端需要为每个接口单独适配，增加维护成本。 +- **错误处理碎片化**：没有统一的 `success` / `errCode` / `errMessage` 字段，前端无法用一套逻辑判断请求是否成功、展示错误提示。 +- **分页结构不统一**：列表接口各自定义分页字段名（`total` / `count` / `records` / `items`），前端分页组件难以复用。 +- **API 契约不稳定**：随意返回裸 Map 或临时 DTO，字段增减无感知，容易引发线上联调故障。 +- **国际化与监控缺失基础**：缺少标准化的错误码字段，后续接入国际化、链路追踪、告警分类时改造成本极高。 + +本规范通过强制使用框架提供的 Response 体系，确保所有 API 输出结构一致、可预测、可机器解析。 + +## 如何使用 + +### 核心规则 + +1. **Controller 方法返回值必须使用 Response 体系**：只能返回 `Response`、`SingleResponse`、`MultiResponse` 或 `MapResponse` 之一，禁止返回其他类型。 +2. **单个对象返回**：使用 `SingleResponse.of(data)`。 +3. **列表返回**：使用 `MultiResponse.of(list)` 或 `MultiResponse.of(page)`（接受 Spring Data `Page` 对象）。 +4. **无数据操作成功返回**：使用 `Response.buildSuccess()`。 +5. **失败返回**：使用 `Response.buildFailure(errCode, errMessage)`。 +6. **禁止直接返回 Map 或自定义 DTO 作为 API 响应**。 +7. **响应 JSON 结构固定包含**：`success`（boolean）、`errCode`（string）、`errMessage`（string）、`data`（业务数据，仅 SingleResponse/MultiResponse/MapResponse 携带，`Response` 本身不携带）。 + +### 补充说明 + +- `SingleResponse.empty()` 用于查询可能为空但语义上成功的场景，返回 `{ success: true, data: null }`。 +- `MultiResponse.of(collection, total)` 用于手动分页场景；`MultiResponse.of(page)` 自动从 Spring Data Page 提取 total。 +- `MultiResponse.empty()` 返回空结果 `{ success: true, data: { total: 0, list: null } }`（注意：内部 `Content.list` 未初始化，序列化结果为 `null` 而非空数组；如需空数组语义，可改用 `MultiResponse.of(Collections.emptyList())`）。 +- 异常处理应通过全局异常处理器统一转换为 `Response.buildFailure(...)`，Controller 内不要 try-catch 后自行拼装错误响应。 + +## 使用实例 + +### ✅ 正确示例 + +```java +// 1. 单对象查询 +@GetMapping("/users/{id}") +public SingleResponse getUser(@PathVariable Long id) { + UserDTO user = userService.findById(id); + return SingleResponse.of(user); +} + +// 2. 分页列表查询 +@GetMapping("/users") +public MultiResponse listUsers(PageRequest pageRequest) { + Page page = userService.findAll(pageRequest); + return MultiResponse.of(page); +} + +// 3. 非分页列表查询 +@GetMapping("/roles") +public MultiResponse listRoles() { + List roles = roleService.findAll(); + return MultiResponse.of(roles); +} + +// 4. 写操作成功（无返回数据） +@PostMapping("/users") +public Response createUser(@RequestBody CreateUserCmd cmd) { + userService.create(cmd); + return Response.buildSuccess(); +} + +// 5. 业务校验失败 +@PostMapping("/orders") +public Response createOrder(@RequestBody CreateOrderCmd cmd) { + if (cmd.getQuantity() <= 0) { + return Response.buildFailure("INVALID_QUANTITY", "订单数量必须大于0"); + } + orderService.create(cmd); + return Response.buildSuccess(); +} +``` + +正确返回的 JSON 结构： + +```json +{ + "success": true, + "errCode": null, + "errMessage": null, + "data": { "id": 1, "name": "张三" } +} +``` + +```json +{ + "success": true, + "errCode": null, + "errMessage": null, + "data": { + "total": 100, + "list": [{ "id": 1, "name": "张三" }] + } +} +``` + +### ❌ 错误示例 + +```java +// 错误1：直接返回实体对象 +@GetMapping("/users/{id}") +public UserDTO getUser(@PathVariable Long id) { + return userService.findById(id); +} + +// 错误2：返回裸 Map +@GetMapping("/users/{id}") +public Map getUser(@PathVariable Long id) { + Map result = new HashMap<>(); + result.put("code", 200); + result.put("data", userService.findById(id)); + return result; +} + +// 错误3：自定义响应结构 +@GetMapping("/users/{id}") +public Result getUser(@PathVariable Long id) { + return new Result<>(userService.findById(id)); +} + +// 错误4：Controller 内 try-catch 自行拼装错误 +@PostMapping("/users") +public Response createUser(@RequestBody CreateUserCmd cmd) { + try { + userService.create(cmd); + return Response.buildSuccess(); + } catch (Exception e) { + // 不应在 Controller 中捕获并手动构建错误响应 + Response resp = new Response(); + resp.setSuccess(false); + resp.setErrMessage(e.getMessage()); + return resp; + } +} + +// 错误5：列表接口不使用 MultiResponse +@GetMapping("/users") +public List listUsers() { + return userService.findAll(); +} +``` + +以上错误写法会导致前端无法统一解析响应、错误处理逻辑分散、API 契约不可靠等问题。 diff --git a/docs/wiki/home.md b/docs/wiki/home.md index df4ad0679..fe9cb5ace 100644 --- a/docs/wiki/home.md +++ b/docs/wiki/home.md @@ -3,39 +3,51 @@ Welcome to the springboot-framework ! maven install + +以下示例使用正式发布版本（如 `8.2.0`，最新发布版见上方 Maven Central 徽章）；如需体验开发快照版本，请使用 `8.2.0-SNAPSHOT`。 + +The examples below use an official release version (e.g. `8.2.0`; see the Maven Central badge above for the latest release). Use `8.2.0-SNAPSHOT` for the development snapshot. + ``` com.codingapi.springboot springboot-starter - ${last.version} + 8.2.0 + + + com.codingapi.springboot + springboot-starter-script + 8.2.0 + + com.codingapi.springboot springboot-starter-data-fast - ${last.version} + 8.2.0 - - + + com.codingapi.springboot - springboot-starter-id-generator - ${last.version} - + springboot-starter-data-authorization + 8.2.0 + com.codingapi.springboot - springboot-starter-security-jwt - ${last.version} + springboot-starter-security + 8.2.0 ``` -[springboot-starter](./springboot-starter) -[springboot-starter-security-jwt](./springboot-starter-security-jwt) -[springboot-starter-id-generator](./springboot-starter-id-generator) -[springboot-starter-data-fast](./springboot-starter-data-fast.md) - \ No newline at end of file +[springboot-starter](./springboot-starter.md) +[springboot-starter-script](./springboot-starter-script.md) +[springboot-starter-security](./springboot-starter-security.md) +[springboot-starter-data-fast](./springboot-starter-data-fast.md) +[springboot-starter-data-authorization](./springboot-starter-data-authorization.md) diff --git a/docs/wiki/springboot-starter-data-authorization.md b/docs/wiki/springboot-starter-data-authorization.md new file mode 100644 index 000000000..978a153f0 --- /dev/null +++ b/docs/wiki/springboot-starter-data-authorization.md @@ -0,0 +1,157 @@ +springboot-starter-data-authorization + +数据权限框架 + +## 框架介绍 + +基于JDBC的拦截机制实现对数据表列与行的数据查询权限控制。 + +## 使用教程 + +1. 配置数据库的JDBC驱动地址为 `com.codingapi.springboot.authorization.jdbc.AuthorizationJdbcDriver` +``` +spring.datasource.driver-class-name=com.codingapi.springboot.authorization.jdbc.AuthorizationJdbcDriver +spring.datasource.url=jdbc:h2:file:./test.db +spring.jpa.database-platform=org.hibernate.dialect.H2Dialect +spring.jpa.hibernate.ddl-auto=create-drop +spring.jpa.show-sql=true + +``` +2. 配置数据权限DataAuthorizationFilter的实现 +接口定义 +```java + +/** + * 数据权限过滤器 + */ +public interface DataAuthorizationFilter { + + /** + * 列权限过滤 + * @param tableName 表名 + * @param columnName 列名 + * @param value 值 + * @return 过滤后的值 + * @param T + */ + T columnAuthorization(String tableName, String columnName,T value); + + /** + * 行权限过滤 + * @param tableName 表名 + * @param tableAlias 表别名 + * @return 过滤后拦截sql条件 + */ + Condition rowAuthorization(String tableName, String tableAlias); + + /** + * 是否支持列权限过滤 + * @param tableName 表名 + * @param columnName 列名 + * @param value 值 + * @return 是否支持 + */ + boolean supportColumnAuthorization(String tableName, String columnName, Object value); + + /** + * 是否支持行权限过滤 + * @param tableName 表名 + * @param tableAlias 表别名 + * @return 是否支持 + */ + boolean supportRowAuthorization(String tableName, String tableAlias); +} + + +``` +实例实现： +``` + +ColumnMaskContext.getInstance().addColumnMask(new IDCardMask()); +ColumnMaskContext.getInstance().addColumnMask(new PhoneMask()); +ColumnMaskContext.getInstance().addColumnMask(new BankCardMask()); + +DataAuthorizationContext.getInstance().addDataAuthorizationFilter(new DataAuthorizationFilter() { + @Override + public T columnAuthorization(String tableName, String columnName, T value) { + return ColumnMaskContext.getInstance().mask(value); + } + + @Override + public Condition rowAuthorization(String tableName, String tableAlias) { + if (tableName.equalsIgnoreCase("t_user")) { + String conditionTemplate = "%s.id > 1 "; + return Condition.formatCondition(conditionTemplate, tableAlias); + } + return null; + } + + @Override + public boolean supportColumnAuthorization(String tableName, String columnName, Object value) { + return true; + } + + @Override + public boolean supportRowAuthorization(String tableName, String tableAlias) { + return true; + } +}); +``` + +实现的拦截器，需要添加到DataAuthorizationContext.getInstance()中才可以使用。可以通过上述实例的手动模式添加， +也可以通过定义DataAuthorizationFilter的@Bean方式添加，当设置为@Bean时既可以自动加入到DataAuthorizationContext.getInstance()中。 + +## 配置项 + +在`application.properties`中可用的配置项（配置前缀为`codingapi.data-authorization`）： + +```properties +# 是否打印拦截后的SQL，便于调试数据权限条件，默认false +codingapi.data-authorization.show-sql=false +``` + +| 配置项 | 对应字段 | 默认值 | 说明 | +|--------|----------|--------|------| +| `codingapi.data-authorization.show-sql` | `DataAuthorizationProperties.showSql` | `false` | 设置为`true`时，SQL被拦截改写后会以INFO日志打印拦截后的SQL（`newSql`），便于调试数据权限条件 | + +## 扩展点 + +### 跳过特定SQL的拦截 + +`DataAuthorizationContext`支持设置跳过拦截时的SQL处理器`SkipAuthorizationFilter`，默认为`DefaultSkipAuthorizationFilter`（原样返回SQL不做任何处理）。 +配合`SQLRunningContext.getInstance().skipDataAuthorization()`使用时，被跳过拦截的SQL会先经过`SkipAuthorizationFilter.filter(sql)`处理， +可以通过自定义实现跳过特定SQL的拦截或对SQL进行改写，例如： + +```java +DataAuthorizationContext.getInstance().setSkipAuthorizationFilter(sql -> sql); + +SQLRunningContext.getInstance().skipDataAuthorization(() -> { + // 该代码块内的SQL查询不会经过数据权限拦截 + List> data = jdbcTemplate.queryForList(sql); +}); +``` + +### 自定义处理器（@Bean自动注册） + +在`DataAuthorizationConfiguration`中，通过定义以下类型的`@Bean`即可自动替换框架的默认实现（均以`@Autowired(required = false)`方式注入，未提供时使用默认实现）： + +| Bean类型 | 默认实现 | 职责 | +|----------|----------|------| +| `RowHandler` | `DefaultRowHandler` | 行权限处理器，负责为查询SQL构建行级权限过滤条件 | +| `ColumnHandler` | `DefaultColumnHandler` | 列权限处理器，负责对结果集（ResultSet）的列值进行拦截处理 | +| `SQLInterceptor` | `DefaultSQLInterceptor` | SQL拦截器，负责SQL的前置判断（`beforeHandler`）、改写（`postHandler`）与后置处理（`afterHandler`） | + +示例： + +```java +@Bean +public RowHandler rowHandler() { + return (subSql, tableName, tableAlias) -> { + if (tableName.equalsIgnoreCase("t_user")) { + return Condition.formatCondition("%s.id > 1 ", tableAlias); + } + return null; + }; +} +``` + diff --git a/docs/wiki/springboot-starter-data-fast.md b/docs/wiki/springboot-starter-data-fast.md index 0466431df..e915b3ac7 100644 --- a/docs/wiki/springboot-starter-data-fast.md +++ b/docs/wiki/springboot-starter-data-fast.md @@ -2,46 +2,286 @@ springboot-starter-data-fast 基于JPA的快速API能力服务 +## FastRepository 的使用教程 + +继承FastRepository接口，实现自定义的接口，即可使用FastRepository的能力 ```java -package com.codingapi.springboot.example.query; -import com.codingapi.springboot.example.infrastructure.jpa.entity.DemoEntity; -import com.codingapi.springboot.example.infrastructure.jpa.pojo.PageSearch; -import com.codingapi.springboot.fast.annotation.FastController; -import com.codingapi.springboot.fast.annotation.FastMapping; -import com.codingapi.springboot.framework.dto.response.MultiResponse; -import org.springframework.security.access.prepost.PreAuthorize; -import org.springframework.web.bind.annotation.RequestMethod; -@FastController -public interface FastDemoApi { +import com.codingapi.springboot.fast.entity.Demo; +import com.codingapi.springboot.fast.jpa.repository.FastRepository; + +public interface DemoRepository extends FastRepository { + +} + + +``` + +> 注：示例中的 `com.codingapi.springboot.fast.entity.Demo` 是模块的测试用示例实体，位于 `springboot-starter-data-fast` 的 `src/test/java` 目录下（对应表 `t_demo`）。实际使用时请定义自己的 `@Entity` 实体类并替换。 + +### FastRepository 能力概览 + +`FastRepository` 继承了 `JpaRepository`、`JpaSpecificationExecutor`、`DynamicRepository`（HQL 动态查询）与 `DynamicNativeRepository`（原生 SQL 查询），除 JPA 标准能力外还提供： + +| 能力 | 方法 | 说明 | +|------|------|------| +| 条件过滤查询 | `findAll(PageRequest)` / `pageRequest(PageRequest)` | 根据 Filter 自动构建 Example 或动态 HQL 查询 | +| 高级搜索 | `searchRequest(SearchRequest)` | 基于 `SearchRequest`（前端检索条件对象）的分页查询 | +| 动态 HQL 查询 | `dynamicListQuery(...)` / `dynamicPageQuery(...)` | HQL 列表 / 分页查询，可配合 `SQLBuilder` 映射 DTO | +| Map 视图查询 | `dynamicMapListQuery(QueryColumns, sql, params...)` / `dynamicMapPageQuery(QueryColumns, sql, countSql, request, params...)` | 通过 `QueryColumns` 指定投影列，返回 `MapViewResult` | +| 原生 SQL 查询 | `dynamicNativeListQuery(...)` / `dynamicNativePageQuery(...)` / `dynamicNativeListMapQuery(...)` / `dynamicNativeMapPageMapQuery(...)` | `DynamicNativeRepository` 提供的原生 SQL 查询，支持实体映射或 `Map` 结果 | + +动态FastRepository的能力展示 + +``` + + // 重写findAll，通过Example查询 + @Test + void findAll() { + demoRepository.deleteAll(); + Demo demo1 = new Demo(); + demo1.setName("123"); + demoRepository.save(demo1); + + Demo demo2 = new Demo(); + demo2.setName("456"); + demoRepository.save(demo2); + + PageRequest request = new PageRequest(); + request.setCurrent(1); + request.setPageSize(10); + request.addFilter("name", "123"); + + Page page = demoRepository.findAll(request); + assertEquals(1, page.getTotalElements()); + } + + + // pageRequest 自定义条件查询 + @Test + void pageRequest1() { + demoRepository.deleteAll(); + Demo demo1 = new Demo(); + demo1.setName("123"); + demoRepository.save(demo1); + + Demo demo2 = new Demo(); + demo2.setName("456"); + demoRepository.save(demo2); + + PageRequest request = new PageRequest(); + request.setCurrent(1); + request.setPageSize(10); + request.addFilter("name", Relation.LIKE, "%2%"); + //sql: select demo0_.id as id1_0_, demo0_.name as name2_0_, demo0_.sort as sort3_0_ from t_demo demo0_ where demo0_.name like ? limit ? + + Page page = demoRepository.pageRequest(request); + assertEquals(1, page.getTotalElements()); + } + + // pageRequest 自定义条件查询 + @Test + void pageRequest2() { + demoRepository.deleteAll(); + Demo demo1 = new Demo(); + demo1.setName("123"); + demoRepository.save(demo1); + + Demo demo2 = new Demo(); + demo2.setName("456"); + demoRepository.save(demo2); + + PageRequest request = new PageRequest(); + request.setCurrent(1); + request.setPageSize(10); + request.orFilters(Filter.as("name","123"),Filter.as("name","456")); + //sql: select demo0_.id as id1_0_, demo0_.name as name2_0_, demo0_.sort as sort3_0_ from t_demo demo0_ where demo0_.name=? or demo0_.name=? limit ? + + Page page = demoRepository.pageRequest(request); + assertEquals(1, page.getTotalElements()); + } + + + // 动态sql的List查询 + @Test + void dynamicListQuery() { + demoRepository.deleteAll(); + Demo demo1 = new Demo(); + demo1.setName("123"); + demoRepository.save(demo1); + + Demo demo2 = new Demo(); + demo2.setName("456"); + demoRepository.save(demo2); + + List list = demoRepository.dynamicListQuery("from Demo where name = ?1", "123"); + assertEquals(1, list.size()); + } - @PreAuthorize(value = "hasRole('ROLE_ADMIN')") - @FastMapping( - method = RequestMethod.GET, - mapping = "/api/demo/findByName1", - value = "select d from DemoEntity d where name = :name", - countQuery = "select count(d) from DemoEntity d where name = :name") - MultiResponse findByName1(PageSearch query); + // 动态sql的分页查询 + @Test + void dynamicPageQuery() { + demoRepository.deleteAll(); + Demo demo1 = new Demo(); + demo1.setName("123"); + demoRepository.save(demo1); + Demo demo2 = new Demo(); + demo2.setName("456"); + demoRepository.save(demo2); + Page page = demoRepository.dynamicPageQuery("from Demo where name = ?1", PageRequest.of(1, 2), "123"); + assertEquals(1, page.getTotalElements()); + } - @PreAuthorize(value = "hasRole('ROLE_USER')") - @FastMapping( - method = RequestMethod.GET, - mapping = "/api/demo/findByName2", - value = "select d from DemoEntity d where name = :name", - countQuery = "select count(d) from DemoEntity d where name = :name") - MultiResponse findByName2(PageSearch query); + // 增加排序查询 + @Test + void sortQuery() { + demoRepository.deleteAll(); + Demo demo1 = new Demo(); + demo1.setName("123"); + demoRepository.save(demo1); + Demo demo2 = new Demo(); + demo2.setName("456"); + demoRepository.save(demo2); + + PageRequest request = new PageRequest(); + request.setCurrent(1); + request.setPageSize(10); + + request.addSort(Sort.by("id").descending()); + Page page = demoRepository.findAll(request); + assertEquals(page.getContent().get(0).getName(), "456"); + assertEquals(2, page.getTotalElements()); + } + +``` + +> 说明：示例中的 `PageRequest`、`Relation`、`Filter` 均来自核心模块 `springboot-starter`，需导入 +> `com.codingapi.springboot.framework.dto.request.PageRequest` / `Relation` / `Filter`。 +> 条件关系使用独立枚举 `com.codingapi.springboot.framework.dto.request.Relation`（如 `Relation.LIKE`、`Relation.IN`）， +> 而非 `PageRequest` 的内部枚举。 + +## ScriptMapping 教程 + +通过动态添加mvc mapping实现查询功能. + + +构造签名：`ScriptMapping(String mapping, ScriptMethod scriptMethod, String script)` + +* mapping 是mvc接口的访问地址 +* scriptMethod 是mvc接口的请求方式，为枚举 `ScriptMethod.GET` / `ScriptMethod.POST` +* script 是接口执行的 Groovy 查询脚本内容 + +```java +import com.codingapi.springboot.fast.script.ScriptMapping; +import com.codingapi.springboot.fast.script.ScriptMethod; + +// 定义接口执行的 Groovy 脚本 +String script = """ + var name = $request.getParameter("name",""); + var sql = "select * from api_mapping where 1=1 "; + var params = []; + if(!"".equals(name)){ + sql += " and name = ? "; + params.add(name); + } + return $jdbc.queryForMapList(sql, params.toArray()); + """; + +// 注册一个 GET 方式的 /api/demo/list 查询接口 +ScriptMapping scriptMapping = new ScriptMapping("/api/demo/list", ScriptMethod.GET, script); +fastScriptMappingRegister.addMapping(scriptMapping); +``` + +其中 `fastScriptMappingRegister` 为 `FastScriptMappingRegister` Bean，`addMapping(ScriptMapping)` 会将脚本动态注册为 MVC 接口；脚本执行结果会自动封装为 `Response`（List / Page 结果返回 `MultiResponse`，其余返回 `SingleResponse`）。 + +脚本实例代码： +* 动态分页查询 +``` +// 获取name的请求参数 +var name = $request.getParameter("name",""); +var pageNumber = $request.getParameter("pageNumber",0); +var pageSize = $request.getParameter("pageSize",10); +// 创建分页对象 +var pageRequest = $request.pageRequest(pageNumber,pageSize); +// 动态组织sql +var sql = "select * from api_mapping where 1 =1 "; +var countSql = "select count(1) from api_mapping where 1 =1 "; +// 动态组织参数 +var params = []; +if(!"".equals(name)){ + sql += " and name = ? "; + countSql += " and name = ? "; + params.push(name); } +sql += " limit ?,?"; +// 添加分页参数 +params.add(pageRequest.getOffset()); +params.add(pageRequest.getPageSize()); +// 执行分页查询（结果为 Map 列表，使用 queryForMapPage） +return $jdbc.queryForMapPage(sql,countSql,pageRequest,params.toArray()); +``` +* 动态条件查询 +``` +// 获取name的请求参数 +var name = $request.getParameter("name",""); +// 动态组织sql +String sql = "select * from api_mapping where 1=1 "; +// 动态组织参数 +var params = []; +if(!"".equals(name)){ + sql += " and name = ? "; + params.add(name); +} +// 执行查询（结果为 Map 列表，使用 queryForMapList） +return $jdbc.queryForMapList(sql,params.toArray()); +``` +脚本语法介绍： +* $request +``` +// 获取参数name的值，如果参数不存在，则返回默认值 +var name = $request.getParameter("name",""); +// 获取分页对象 +var pageRequest = $request.pageRequest(0,10); +// 获取分页对象的页码 +var pageNumber = pageRequest.getPageNumber(); +// 获取分页对象的每页记录数 +var pageSize = pageRequest.getPageSize(); +// 获取分页对象的偏移量 +var offset = pageRequest.getOffset(); +``` +* $jdbc（`JdbcQuery` 实例，常用方法签名） +``` +// Map 列表查询：$jdbc.queryForMapList({sql}, {params}...)，结果列名自动转驼峰 +// 实体映射列表查询：$jdbc.queryForList({sql}, {clazz}, {params}...) +// Map 分页查询：$jdbc.queryForMapPage({sql}, {countSql}, {pageRequest}, {params}...) +// 实体映射分页查询：$jdbc.queryForPage({sql}, {countSql}, {clazz}, {pageRequest}, {params}...) + +// 查询无条件的数据（返回 List>） +var res = $jdbc.queryForMapList("select * from api_mapping"); +// 查询有条件的数据 +var res = $jdbc.queryForMapList("select * from api_mapping where name = ?",name); +// 查询多条件的数据 +var res = $jdbc.queryForMapList("select * from api_mapping where name = ? and url = ?",name,url); + +// 需要将结果映射为实体类时，使用 queryForList(sql, Class, params...) +var res = $jdbc.queryForList("select * from api_mapping where name = ?",com.example.entity.ApiMapping.class,name); + +// 分页查询（Map 结果） $jdbc.queryForMapPage({sql},{countSql},{pageRequest},{params}...) +var res = $jdbc.queryForMapPage("select * from api_mapping where name = ? and url = ?", +"select count(1) from api_mapping where name = ? and url = ?",pageRequest,name,url); +``` +* $jpa ``` -@FastController 用于标记当前接口为Fast接口 -@FastMapping 用于标记当前接口的映射关系 -mapping为接口映射路径，method为接口请求方法 -value为查询语句，countQuery为查询总数语句，query为查询参数，支持分页查询，排序查询，查询参数等等 -MultiResponse为返回结果 -@PreAuthorize(value = "hasRole('ROLE_USER')") 用于标记当前接口的权限，如果不需要权限可以不用添加 +// 查询jpa $jpa.listQuery({clazz},{sql},{params}) +// 查询无条件的数据 +var res = $jpa.listQuery(com.example.entity.NodeEntity.class,"from NodeEntity"); +// 查询有条件的数据 +var res = $jpa.listQuery(com.example.entity.NodeEntity.class,"from NodeEntity where name = ?",name); +``` \ No newline at end of file diff --git a/docs/wiki/springboot-starter-id-generator.md b/docs/wiki/springboot-starter-id-generator.md deleted file mode 100644 index 27bb96a91..000000000 --- a/docs/wiki/springboot-starter-id-generator.md +++ /dev/null @@ -1,34 +0,0 @@ -springboot-starter-id-generator - -一个单服务下的id自增构造器，为了解决id由数据库生成的问题，如果是分布式服务，可以使用snowflake算法生成id，如果是单服务，可以使用这个构造器生成id - -```java - -import com.codingapi.springboot.generator.IdGenerate; -import lombok.Getter; - -/** - * @author lorne - * @since 1.0.0 - */ -public class Demo implements IdGenerate { - - @Getter - private Integer id; - - @Getter - private String name; - - public Demo(String name) { - this.id = generateIntId(); - this.name = name; - } - -} - -``` - -只需要实现IdGenerate接口即可，然后调用generateIntId()方法即可生成id。 - -IdGenerate接口提供了两个方法，generateIntId()和generateLongId()，分别用于生成int类型和long类型的id。 -也可以使用generateStringId()方法生成String类型的id。 \ No newline at end of file diff --git a/docs/wiki/springboot-starter-script.md b/docs/wiki/springboot-starter-script.md new file mode 100644 index 000000000..4d6c47cd7 --- /dev/null +++ b/docs/wiki/springboot-starter-script.md @@ -0,0 +1,416 @@ +springboot-starter-script 功能介绍 + +## 模块定位 + +`springboot-starter-script` 是框架的 Groovy 脚本引擎模块，提供以下核心能力： + +1. **运行时编译**：基于 `GroovyShell` 在应用运行时动态编译 Groovy 脚本，无需重启即可变更业务逻辑； +2. **缓存**：编译后的脚本对象按脚本内容的 SHA256 摘要做 LRU 缓存，重复执行时直接命中缓存，避免重复编译； +3. **热更新**：通过 REST API 或 `GroovyScript.save()` 更新脚本内容并重新编译，实现脚本的热更新； +4. **REST API**：内置 `GroovyScriptController`，提供脚本编译、查询、保存（热更新）的 HTTP 端点； +5. **元数据扫描**：通过注解（`@ScriptType`/`@ScriptField`/`@ScriptFunction`/`@ScriptParameter`）自动扫描脚本的请求参数、绑定对象与返回类型，生成结构化的元数据，便于前端渲染脚本调用表单； +6. **事务支持**：脚本执行支持 `DEFAULT`/`COMMIT`/`READONLY` 三种事务模式。 + +Maven 依赖： + +```xml + + + com.codingapi.springboot + springboot-starter-script + 8.2.0 + +``` + +模块依赖 `springboot-starter`、`spring-boot-starter-web` 以及 Groovy 4.x（`groovy`、`groovy-json`、`groovy-xml`）。自动配置类为 `com.codingapi.springboot.script.AutoConfiguration`，同时注册在 `META-INF/spring.factories` 与 `META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports` 中。 + +### 配置项 + +配置前缀为 `codingapi.script`（绑定 `GroovyScriptProperties`）： + +```properties +# 临时脚本到期时间（毫秒），默认15分钟 1000*60*15=900000 +codingapi.script.temp-valid-time=900000 +# 脚本执行对象（编译后的Script）最大缓存大小，默认 10*1024 +codingapi.script.shell-max-cache-size=10240 +``` + +## 核心类与用法 + +### GroovyScriptRuntime（脚本运行时） + +`GroovyScriptRuntime` 是脚本的编译与执行入口，内部持有 `GroovyShell` 与一个 LRU 缓存（基于 `LinkedHashMap` 的访问顺序模式，容量由构造参数 `maxCacheSize` 控制，超出容量时自动淘汰最久未访问的条目）。 + +主要方法： + +```java +// 按最大缓存容量构造运行时 +public GroovyScriptRuntime(int maxCacheSize) + +// 编译脚本；cache=true 时以脚本内容的 SHA256 为 key 缓存编译结果 +public void compile(String script, boolean cache) +public void compile(String script) + +// 执行脚本中的函数（method），binds 为绑定对象，args 为函数参数 +public T invoke(String method, String script, Class returnType, + Map binds, Object... args) +public T invoke(String method, String script, Class returnType, Object... args) +public T invoke(String method, String script, Class returnType, + TransactionMode transactionMode, Map binds, Object... args) + +// 直接执行整个脚本（脚本顶层语句作为执行体） +public T run(String script, Class returnType, Map binds) +public T run(String script, Class returnType, TransactionMode transactionMode, Map binds) + +// 缓存维护 +public void clearCache() +public int cacheSize() +public int getMaxCacheSize() +``` + +说明： + +- `invoke`/`run` 执行时会先按 SHA256 查找缓存，未命中则编译并写入缓存，因此执行路径天然具备编译缓存能力； +- `binds` 中的每个键值会通过 `Script.setProperty(key, value)` 注入脚本，脚本中可直接以该键名访问（如 `$request`、`$repository`）； +- 事务模式由 `TransactionMode` 枚举控制，底层委托 `springboot-starter` 的 `TransactionManagerContext` 实现： + - `DEFAULT`：不做事务处理； + - `COMMIT`：在新事务（`PROPAGATION_REQUIRES_NEW`）中执行，正常结束提交、异常回滚； + - `READONLY`：以只读新事务执行，结束时回滚，保证数据不被修改。 + +`GroovyScriptRuntimeContext` 是 `GroovyScriptRuntime` 的单例持有者（`GroovyScriptRuntimeContext.getInstance()`），运行时容量取自配置项 `codingapi.script.shell-max-cache-size`，并对外暴露 `compile`/`invoke`/`run`/`clearCache`/`cacheSize` 等委托方法。 + +### GroovyScript 与 Builder（脚本对象） + +`GroovyScript` 是脚本的领域对象，字段如下： + +| 字段 | 类型 | 说明 | +|------|------|------| +| `key` | `String`（final） | 脚本唯一编码 | +| `script` | `String` | 脚本内容 | +| `description` | `String` | 脚本描述信息 | +| `method` | `String` | 脚本主函数名称 | +| `returnType` | `Class` | 返回数据类型 | +| `binds` | `Map>` | 绑定对象（键为脚本内变量名，值为类型） | +| `requests` | `Map>` | 请求参数对象（键为参数名，值为类型） | +| `typeOne` / `typeTwo` | `String` | 一级 / 二级分类 | +| `tag` | `String` | 标记参数 | +| `remark` | `String` | 备注信息 | +| `createTime` / `updateTime` | `long` | 创建 / 更新时间戳 | + +通过 `GroovyScript.builder(String key)` 链式构建： + +```java +String script = """ + def run(request){ + return request; + } + """; + +GroovyScript groovyScript = + GroovyScript.builder("invoke") + .script(script) + .description("返回入参本身") + .method("run") + .tag("123") + .returnType(Integer.class) + .requests(Map.of("request", Integer.class)) + .binds(Map.of("$repository", SomeRepository.class)) + .typeOne("demo").typeTwo("test").remark("备注") + .build(); +``` + +行为方法： + +```java +// 编译（委托 GroovyScriptRuntimeContext） +groovyScript.compile(); // 编译，不缓存 +groovyScript.compile(true); // 编译并缓存 + +// 执行整个脚本 +groovyScript.run(); +groovyScript.run(Map.of("$request", 100)); +groovyScript.run(TransactionMode.READONLY); + +// 执行脚本主函数（method 字段指定的函数） +groovyScript.invoke(100); +groovyScript.invoke(Map.of("$repository", repository), request); +groovyScript.invoke(TransactionMode.COMMIT, Map.of("$repository", repository), request); + +// 生命周期 +groovyScript.temp(); // 存入临时缓存，到期自动清理 +groovyScript.save(); // 持久化到仓储（并清理对应的临时数据） +groovyScript.remove(); // 从仓储与临时缓存中删除 +GroovyScript copy = groovyScript.copy("newKey"); // 复制为新 key 的脚本对象 + +// 生成元数据 +GroovyMetadata metadata = groovyScript.toMetadata(); +``` + +### GroovyScriptCacheContext（脚本数据 LRU 缓存） + +`GroovyScriptCacheContext` 是 `GroovyScript` 脚本对象的内存缓存上下文（单例），内部同样是基于访问顺序的 LRU `LinkedHashMap`，容量上限为常量 `MAX_CACHE_SIZE = 10 * 1024`，超出后自动淘汰最久未访问的脚本。 + +获取脚本时的查找链路为：**内存缓存 → 临时缓存（TempGroovyScriptContext） → 仓储（GroovyScriptRepositoryContext）**；从仓储命中后会回填内存缓存（临时数据不回填）。 + +主要方法： + +```java +GroovyScriptCacheContext.getInstance().getGroovyScript(key); // 按查找链路获取脚本 +GroovyScriptCacheContext.getInstance().getScript(key); // 获取脚本内容，不存在返回 "" +GroovyScriptCacheContext.getInstance().getGroovyMetadata(key); // 获取脚本元数据 +GroovyScriptCacheContext.getInstance().save(script); // 写入缓存 +GroovyScriptCacheContext.getInstance().cache(script); // 写入缓存 +GroovyScriptCacheContext.getInstance().remove(key); // 删除缓存 +GroovyScriptCacheContext.getInstance().keys(); // 所有缓存 key +GroovyScriptCacheContext.getInstance().count(); // 缓存数量 +GroovyScriptCacheContext.getInstance().setBatchCache(list); // 批量写入缓存 +GroovyScriptCacheContext.getInstance().compileAll(true); // 批量编译缓存中的脚本 +GroovyScriptCacheContext.getInstance().clear(); // 清空缓存 +``` + +### TempGroovyScriptContext（临时脚本） + +临时脚本用于"编辑中尚未保存"的草稿场景：脚本通过 `groovyScript.temp()` 进入临时缓存后，会在到期时间（配置项 `codingapi.script.temp-valid-time`，默认 15 分钟）后被自动清理。 + +实现要点： + +- `TempGroovyScript` 包装了 `GroovyScript` 与到期时间戳 `clearTime`，提供 `isExpired()` 判断； +- `TempGroovyScriptContext` 所有临时脚本共用**一个** daemon 调度线程（`temp-groovy-script-clear` 的 `ScheduledExecutorService`）执行到期清理，避免为每个脚本创建线程造成线程泄漏； +- 重复 `save` 同一 key 时会取消旧的清理任务、重新计时；到期清理采用原子的 `remove(key, value)` 判断，防止误删已被刷新的脚本。 + +主要方法： + +```java +TempGroovyScriptContext.getInstance().save(groovyScript); // 写入临时缓存并开始计时 +TempGroovyScriptContext.getInstance().getGroovyScript(key); // 获取临时脚本（不存在或已过期返回 null） +TempGroovyScriptContext.getInstance().count(); // 当前临时脚本数量 +TempGroovyScriptContext.getInstance().findAll(); // 所有临时脚本（含到期时间） +TempGroovyScriptContext.getInstance().remove(key); // 删除临时脚本（并取消清理任务） +TempGroovyScriptContext.getInstance().loadAll(list); // 启动时批量加载（过期的直接剔除） +TempGroovyScriptContext.getInstance().clear(); // 清空 +``` + +### GroovyMetadataScannerUtils（元数据与注解扫描） + +`GroovyMetadataScannerUtils.scanner(GroovyScript)` 用于为脚本生成元数据 `GroovyMetadata`，`GroovyScript.toMetadata()` 即委托该工具。扫描流程： + +1. 先尝试自定义元数据策略 `GroovyMetadataGenerateStrategyContext`，若存在匹配策略则直接返回策略生成的元数据； +2. 否则通过反射扫描 `requests`（请求参数）、`binds`（绑定对象）、`returnType`（返回类型）涉及的 Java 类型，递归收集类型上声明的脚本注解信息；简单类型（如 `Integer`、`String`）不展开，并通过扫描历史防止循环引用。 + +扫描依赖的注解（位于 `com.codingapi.springboot.script.annotation` 包）： + +| 注解 | 作用目标 | 属性 | 说明 | +|------|----------|------|------| +| `@ScriptType` | 类型（TYPE） | `description` | 描述一个参与脚本交互的 Java 类型 | +| `@ScriptField` | 字段 / 方法（FIELD, METHOD） | `name`、`description` | 声明该字段可被脚本访问 | +| `@ScriptFunction` | 方法（METHOD） | `name`（必填）、`description` | 声明该方法可被脚本调用 | +| `@ScriptParameter` | 参数（PARAMETER） | `name`、`description` | 描述 `@ScriptFunction` 方法的参数 | + +注解使用示例（取自模块测试代码）： + +```java +@ScriptType(description = "test") +public class MyTest { + + @ScriptField(name = "id", description = "id") + private Long id; + + @ScriptField(name = "name", description = "name") + private String name; +} + +public class MyScriptRequest extends BaseRequest { + + @ScriptField(name = "count", description = "总数量") + private final int count; + + @ScriptFunction(name = "isSupport", description = "是否匹配") + public boolean isSupport(@ScriptParameter(description = "总数") int count) { + return this.count == count; + } +} +``` + +生成的 `GroovyMetadata` 结构： + +```java +public class GroovyMetadata { + private final List requests; // 请求参数列表 + private final List binds; // 绑定对象列表 + private final String mainMethod; // 主函数名称 + private final String returnType; // 返回类型名称 + private final Map types; // 涉及的数据类型（含 fields 与 functions） + private final String description; // 脚本说明 +} +``` + +其中 `GroovyType` 描述一个数据类型（含 `fields` 字段列表与 `functions` 函数列表），`GroovyField` 描述单个字段/参数（`name`、`description`、`dataType`），`GroovyFunction` 描述可调用的函数（`name`、`description`、`returnType`、`parameters`）。 + +元数据扫描提供三个扩展点（均为单例上下文 + 策略接口）： + +| 扩展点 | 接口 | 注册方法 | 用途 | +|--------|------|----------|------| +| 类型映射 | `ScriptTypeMapping`（`support` / `mapping`） | `ScriptTypeMappingContext.getInstance().addMapping(...)` | 将元数据中的类型映射为其他类型，例如把 `Integer` 显示为 `int` | +| 元数据调整 | `GroovyTypeFixStrategy`（`support` / `fix(GroovyScript, GroovyType)`） | `GroovyTypeFixStrategyContext.getInstance().addFixStrategy(...)` | 在类型扫描完成后调整/补充该类型的元数据 | +| 元数据生成 | `GroovyMetadataGenerateStrategy`（`support` / `generate`） | `GroovyMetadataGenerateStrategyContext.getInstance().addGenerateStrategy(...)` | 完全自定义元数据，命中后跳过注解扫描 | + +### @GroovyScript 注解与字段扫描 + +`@GroovyScript`（作用于字段）用于标记对象中"存放脚本 key"的字段。`GroovyScriptAnnotationScannerUtils.findGroovyScriptFields(Object target)` 可以递归收集对象下所有被 `@GroovyScript` 标记字段的值（即脚本 key 列表），并支持批量更新： + +```java +// Node.script 字段标注了 @GroovyScript +List keys = GroovyScriptAnnotationScannerUtils + .findGroovyScriptFields(workflow).getKeys(); + +// 批量更新脚本 key +GroovyScriptFieldResult result = GroovyScriptAnnotationScannerUtils + .findGroovyScriptFields(workflow); +result.update(value -> "K123456"); +``` + +该能力可用于工作流等场景：业务对象持有若干脚本 key 引用，保存/复制业务对象时可以整体迁移其关联的脚本。 + +### GroovyScriptEngineRunner（启动加载与停机持久化） + +`GroovyScriptEngineRunner` 实现了 `InitializingBean` 与 `DisposableBean`，由 `AutoConfiguration` 以 `tempClearRunner` 名称注册为 Bean： + +- **启动时**（`afterPropertiesSet`）：从 `TempGroovyScriptRepositoryContext` 分页读取临时脚本数据，批量加载到 `TempGroovyScriptContext`（已过期的数据在加载时剔除），恢复停机前的临时脚本； +- **停机时**（`destroy`）：将 `TempGroovyScriptContext` 中仍有效的临时脚本写回仓储，保证临时脚本跨重启不丢失。 + +## REST API + +`GroovyScriptController` 提供脚本管理的 HTTP 端点，基础路径为 `/api/groovy-script`： + +| 端点 | 方法 | 请求 | 响应 | 说明 | +|------|------|------|------|------| +| `/api/groovy-script/compile` | POST | `ScriptCompileRequest`：`{"cache": true, "script": "脚本内容"}` | `Response` | 编译脚本；`cache=true` 时缓存编译结果。编译失败抛出 `LocaleMessageException("script.compile.error")` | +| `/api/groovy-script/getScript` | GET | Query 参数 `key` | `SingleResponse` | 按 key 获取脚本内容；不存在抛出 `LocaleMessageException("script.null")` | +| `/api/groovy-script/getMetadata` | GET | Query 参数 `key` | `SingleResponse` | 按 key 获取脚本元数据；不存在抛出 `LocaleMessageException("script.null")` | +| `/api/groovy-script/save` | POST | `ScriptSaveRequest`：`{"key": "脚本key", "script": "新脚本内容"}` | `Response` | 热更新脚本（见下文流程） | + +`save` 接口的热更新流程： + +1. 先在临时缓存中查找该 key：命中则更新脚本内容 → `compile(true)` 编译并缓存 → `temp()` 继续作为临时脚本保存； +2. 临时缓存未命中则在脚本缓存/仓储中查找：命中则更新脚本内容 → `compile(true)` → `save()` 持久化； +3. 两处均未命中则抛出 `LocaleMessageException("script.null", "脚本对象不存在")`；编译异常统一抛出 `LocaleMessageException("script.compile.error")`。 + +## 仓储扩展 + +脚本的持久化通过仓储接口抽象，默认提供内存实现，可按需替换为数据库等自定义实现。 + +### GroovyScriptRepository（正式脚本仓储） + +```java +public interface GroovyScriptRepository { + + void save(GroovyScript groovyScript); + + void delete(String key); + + GroovyScript get(String key); +} +``` + +默认实现 `DefaultGroovyScriptRepository` 基于内存 `HashMap` 存储。通过 `GroovyScriptRepositoryContext`（单例）访问与替换： + +```java +// 获取脚本（GroovyScript.save()/remove() 内部也走该上下文） +GroovyScript script = GroovyScriptRepositoryContext.getInstance().get(key); + +// 替换为自定义实现（如 JPA 持久化） +GroovyScriptRepositoryContext.getInstance() + .setGroovyScriptRepository(new MyJpaGroovyScriptRepository()); +``` + +### TempGroovyScriptRepository（临时脚本仓储） + +```java +public interface TempGroovyScriptRepository { + + void save(TempGroovyScript tempGroovyScript); + + void delete(String key); + + TempGroovyScript get(String key); + + Page find(PageRequest request); +} +``` + +默认实现 `DefaultTempGroovyScriptRepository` 基于内存 `HashMap` 存储，`find` 按 `clearTime` 排序并返回 `PageImpl` 分页结果。通过 `TempGroovyScriptRepositoryContext`（单例）访问与替换： + +```java +TempGroovyScriptRepositoryContext.getInstance() + .setTempGroovyScriptRepository(new MyTempGroovyScriptRepository()); +``` + +`GroovyScriptEngineRunner` 启动时即通过该上下文分页加载临时脚本（每页 100 条）。 + +## 与其他模块的关系 + +- 依赖 `springboot-starter`：统一响应封装（`Response`/`SingleResponse`）、国际化异常（`LocaleMessageException`）、分页（`PageRequest`）、事务管理（`TransactionManagerContext`）、SHA256 摘要与反射注解扫描工具等基础能力均来自核心模块； +- `springboot-starter-data-fast` 模块中的 `ScriptRuntime` 会为本模块的脚本运行时绑定 `$request`/`$jdbc`/`$jpa` 等数据访问对象，属于 data-fast 的能力范畴，此处不再展开。 + +## 完整示例 + +以下示例参考模块测试代码（`GroovyScriptRuntimeContextTest`），无需 Spring 上下文即可编译运行： + +```java +import com.codingapi.springboot.script.GroovyScript; + +public class GroovyScriptDemo { + + public static void main(String[] args) { + // 1. 函数式脚本：通过 invoke 调用脚本中的 run 函数 + String invokeScript = """ + def run(request){ + return request; + } + """; + + GroovyScript invokeDemo = + GroovyScript.builder("invoke-demo") + .script(invokeScript) + .description("返回入参本身") + .method("run") + .returnType(Integer.class) + .build(); + + int result = invokeDemo.invoke(100); + System.out.println(result); // 100 + + // 2. 直接执行脚本：通过 run 执行整个脚本，binds 注入变量 + String runScript = " return $request; "; + + GroovyScript runDemo = + GroovyScript.builder("run-demo") + .script(runScript) + .returnType(Integer.class) + .build(); + + int value = runDemo.run(java.util.Map.of("$request", 100)); + System.out.println(value); // 100 + } +} +``` + +在 Spring Boot 环境中（例如需要事务模式或 JPA 仓储绑定时），可参考测试类 `TransactionGroovyScriptRuntimeContextTest` 的写法： + +```java +GroovyScript groovyScript = + GroovyScript.builder("transactionCommitRun") + .script(""" + def run(request){ + request.addData($repository); + } + """) + .method("run") + .returnType(Void.class) + .binds(Map.of("$repository", myTestRepository.getClass())) + .requests(Map.of("request", MyScriptRequest.class)) + .build(); + +// 在新事务中提交执行 +groovyScript.invoke(TransactionMode.COMMIT, Map.of("$repository", myTestRepository), request); +``` diff --git a/docs/wiki/springboot-starter-security-jwt.md b/docs/wiki/springboot-starter-security-jwt.md deleted file mode 100644 index dd984683a..000000000 --- a/docs/wiki/springboot-starter-security-jwt.md +++ /dev/null @@ -1,80 +0,0 @@ -springboot-starter-security-jwt 功能介绍 - -配置文件,默认参数即说明 -```properties -# JWT密钥 需大于32位的字符串 -codingapi.security.jwt-secret=codingapi.security.jwt.secretkey -# JWT AES密钥 -codingapi.security.ase-key=QUNEWCQlXiYqJCNYQ1phc0FDRFgkJV4mKiQjWENaYXM= -# JWT AES IV -codingapi.security.aes-iv=QUNYRkdIQEVEUyNYQ1phcw== - -# JWT 有效时间(毫秒) 15分钟有效期 1000*60*15=900000 -codingapi.security.jwt-time=900000 -# JWT 更换令牌时间(毫秒) 10分钟后更换令牌 1000*60*10=600000 -codingapi.security.jwt-rest-time=600000 - -# Security 配置 请求权限拦截地址 -codingapi.security.authenticated-urls=/api/** -# Security 配置 登录地址 -codingapi.security.login-processing-url=/user/login -# Security 配置 登出地址 -codingapi.security.logout-url=/user/logout -# Security 配置 不拦截的地址 -codingapi.security.ignore-urls=/open/** -# 禁用CSRF -codingapi.security.disable-csrf=true -# 禁用CORS -codingapi.security.disable-cors=true -``` - -## 默认账户密码 -security默认的账户密码为admin/admin，可以通过重写UserDetailsService来实现自定义账户密码 -```java - @Bean - public UserDetailsService userDetailsService(PasswordEncoder passwordEncoder) { - String password = passwordEncoder.encode("12345678"); - - UserDetails admin = User.withUsername("admin") - .password(password) - .roles("ADMIN") - .build(); - - UserDetails user = User.withUsername("user") - .password(password) - .roles("USER") - .build(); - - return new InMemoryUserDetailsManager(admin, user); - } -``` -也可以通过数据库账户获取账户数据，请自己实现UserDetailsService接口 - -## 登录拦截 -可以通过重写SecurityLoginHandler来实现自定义登录拦截 -```java - @Bean - public SecurityLoginHandler securityLoginHandler(){ - return (request, response, handler) -> { - //TODO 自定义登录拦截 - }; - } -``` - -## 获取当前用户 - -通过TokenContext获取当前用户信息 -```java - @GetMapping("/user") - public String user(){ - return TokenContext.current().getUsername(); - } -``` - -可以通过Token的extra字段来存储用户的更多信息，然后通过TokenContext获取 -```java - @GetMapping("/user") - public String user(){ - return TokenContext.current().getExtra("user"); - } -``` diff --git a/docs/wiki/springboot-starter-security.md b/docs/wiki/springboot-starter-security.md new file mode 100644 index 000000000..a8d7a3077 --- /dev/null +++ b/docs/wiki/springboot-starter-security.md @@ -0,0 +1,150 @@ +springboot-starter-security 功能介绍 + +支持无状态的JWT和有状态的redis两种不同的token机制 + +配置文件及默认参数说明 +```properties +# JWT开关，必须显式配置为true才会启用JWT认证（默认不开启） +codingapi.security.jwt.enable=true +# JWT密钥 需大于32位的字符串 +codingapi.security.jwt.secret-key=codingapi.security.jwt.secretkey + +# JWT 有效时间(毫秒) 15分钟有效期 1000*60*15=900000 +codingapi.security.jwt.valid-time=900000 +# JWT 更换令牌时间(毫秒) 10分钟后更换令牌 1000*60*10=600000 +codingapi.security.jwt.rest-time=600000 + +# JWT AES密钥 +codingapi.security.ase-key=QUNEWCQlXiYqJCNYQ1phc0FDRFgkJV4mKiQjWENaYXM= +# JWT AES IV +codingapi.security.ase-iv=QUNYRkdIQEVEUyNYQ1phcw== + +# Redis开关，必须显式配置为true才会启用Redis有状态认证（默认不开启） +#codingapi.security.redis.enable=true +# Redis token 有效时间(毫秒)，默认15分钟 1000*60*15=900000 +#codingapi.security.redis.valid-time=900000 +# Redis 更换令牌时间(毫秒)，默认10分钟后更换令牌 1000*60*10=600000 +#codingapi.security.redis.rest-time=600000 +#spring.data.redis.host=localhost +#spring.data.redis.port=6379 + +# Security 配置 请求权限拦截地址 +codingapi.security.authenticated-urls=/api/** +# Security 配置 登录地址 +codingapi.security.login-processing-url=/user/login +# Security 配置 登出地址 +codingapi.security.logout-url=/user/logout +# Security 配置 不拦截的地址 +codingapi.security.ignore-urls=/open/** +# 禁用CSRF（默认true） +codingapi.security.disable-csrf=true +# 禁用CORS（默认true） +codingapi.security.disable-cors=true +# 禁用Basic Auth（默认true） +codingapi.security.disable-basic-auth=true +# 禁用FrameOptions（默认true） +codingapi.security.disable-frame-options=true +``` + +> **注意**：JWT 与 Redis 两种认证模式均通过 `@ConditionalOnProperty(havingValue = "true")` 条件装配，且未设置 `matchIfMissing`，因此**必须显式配置** `codingapi.security.jwt.enable=true` 或 `codingapi.security.redis.enable=true` 才会启用对应的认证方式，默认均不开启。 + +## 默认账户密码 +security默认创建了两个账户（见 `AutoConfiguration.userDetailsService()`，仅在未自定义 `UserDetailsService` 时生效）： + +| 账户 | 密码 | 角色 | +|------|------|------| +| admin | admin | ADMIN | +| user | admin | USER | + +可以通过重写UserDetailsService来实现自定义账户密码 +```java + @Bean + public UserDetailsService userDetailsService(PasswordEncoder passwordEncoder) { + String password = passwordEncoder.encode("12345678"); + + UserDetails admin = User.withUsername("admin") + .password(password) + .roles("ADMIN") + .build(); + + UserDetails user = User.withUsername("user") + .password(password) + .roles("USER") + .build(); + + return new InMemoryUserDetailsManager(admin, user); + } +``` +也可以通过数据库账户获取账户数据，请自己实现UserDetailsService接口 + +## 登录拦截 +可以通过重写SecurityLoginHandler来实现自定义登录拦截，preHandle登录前的拦截处理，postHandle登录后的拦截处理（返回值为登录响应对象）。 + +> 说明：本版本线（Spring Boot 2.x）使用 `javax.servlet` 命名空间，以下 import 为 `javax.servlet.http.*`；Spring Boot 3（框架 17.3.x）需替换为 `jakarta.servlet.http.*`。 + +```java +import com.codingapi.springboot.security.dto.request.LoginRequest; +import com.codingapi.springboot.security.dto.response.LoginResponse; +import com.codingapi.springboot.security.filter.SecurityLoginHandler; +import com.codingapi.springboot.security.gateway.Token; +import javax.servlet.http.HttpServletRequest; +import javax.servlet.http.HttpServletResponse; +import org.springframework.context.annotation.Bean; +import org.springframework.context.annotation.Configuration; +import org.springframework.security.core.userdetails.UserDetails; + +@Configuration +public class SecurityConfiguration { + + @Bean + public SecurityLoginHandler securityLoginHandler() { + return new SecurityLoginHandler() { + @Override + public void preHandle(HttpServletRequest request, HttpServletResponse response, LoginRequest loginRequest) throws Exception { + + } + + @Override + public LoginResponse postHandle(HttpServletRequest request, HttpServletResponse response, + LoginRequest loginRequest, UserDetails user, Token token) { + LoginResponse loginResponse = new LoginResponse(); + loginResponse.setToken(token.getToken()); + loginResponse.setUsername(token.getUsername()); + loginResponse.setAuthorities(token.getAuthorities()); + return loginResponse; + } + }; + } +} +``` + +以上 `postHandle` 即框架默认实现（见 `AutoConfiguration.securityLoginHandler()`），自定义时可在此基础上补充业务数据（通过 `loginResponse.setData(...)` 返回）。 + +## 获取当前用户 + +通过TokenContext获取当前用户信息 +```java + @GetMapping("/user") + public String user(){ + return TokenContext.current().getUsername(); + } +``` + +可以通过Token的extra字段来存储用户的更多信息（extra 存储的是 JSON 字符串），然后通过TokenContext获取： + +- `TokenContext.current().getExtra()` 获取原始的 extra JSON 字符串 +- `TokenContext.current().parseExtra(UserInfo.class)` 将 extra JSON 字符串反序列化为指定类型的对象 + +```java + @GetMapping("/user") + public String user(){ + // 获取原始的 extra JSON 字符串 + return TokenContext.current().getExtra(); + } + + @GetMapping("/user/info") + public UserInfo userInfo(){ + // 将 extra JSON 字符串反序列化为 UserInfo 对象 + return TokenContext.current().parseExtra(UserInfo.class); + } +``` diff --git a/docs/wiki/springboot-starter.md b/docs/wiki/springboot-starter.md index 1cd9fd047..7bed37594 100644 --- a/docs/wiki/springboot-starter.md +++ b/docs/wiki/springboot-starter.md @@ -177,11 +177,11 @@ class DomainProxyFactoryTest { void createEntity() { // 在domain对象创建的时候会触发DomainCreateEvent事件 Demo demo = DomainProxyFactory.create(Demo.class, "test"); - //这里将会抛出FieldChangeEvent事件 + //这里将会抛出DomainChangeEvent事件 demo.changeAnimalName("123"); //这里将不会触发事件，因为name值还是test demo.changeName("test"); - //这里将会抛出FieldChangeEvent事件 + //这里将会抛出DomainChangeEvent事件 demo.changeName("test123"); //这里将会抛出DomainPersistEvent事件 demo.persist(); @@ -195,12 +195,13 @@ class DomainProxyFactoryTest { 执行的打印如下： ``` 2023-05-28T08:57:00.505+08:00 INFO 13748 --- [ main] c.c.s.f.handler.DemoCreateHandler : create domain -> com.codingapi.springboot.framework.domain.Demo@4cc12db2 -2023-05-28T08:57:00.507+08:00 INFO 13748 --- [ main] c.c.s.f.h.EntityFiledChangeHandler : field change event -> FieldChangeEvent(simpleName=Demo, timestamp=1685235420507, fieldName=animal.name, oldValue=cat, newValue=123) -2023-05-28T08:57:00.512+08:00 INFO 13748 --- [ main] c.c.s.f.h.EntityFiledChangeHandler : field change event -> FieldChangeEvent(simpleName=Demo, timestamp=1685235420512, fieldName=name, oldValue=test, newValue=test123) -2023-05-28T08:57:00.513+08:00 INFO 13748 --- [ main] c.c.s.f.handler.DemoPersistEventHandler : DomainPersistEvent handler DomainPersistEvent(entity=com.codingapi.springboot.framework.domain.Demo@4cc12db2, simpleName=Demo, timestamp=1685235420513) +2023-05-28T08:57:00.507+08:00 INFO 13748 --- [ main] c.c.s.f.h.EntityFiledChangeHandler : field change event -> DomainChangeEvent(super=DomainEvent(entityClass=class com.codingapi.springboot.framework.domain.Demo, timestamp=1685235420507), fieldName=animal.name, oldValue=cat, newValue=123) +2023-05-28T08:57:00.512+08:00 INFO 13748 --- [ main] c.c.s.f.h.EntityFiledChangeHandler : field change event -> DomainChangeEvent(super=DomainEvent(entityClass=class com.codingapi.springboot.framework.domain.Demo, timestamp=1685235420512), fieldName=name, oldValue=test, newValue=test123) +2023-05-28T08:57:00.513+08:00 INFO 13748 --- [ main] c.c.s.f.handler.DemoPersistEventHandler : DomainPersistEvent handler DomainEvent(entityClass=class com.codingapi.springboot.framework.domain.Demo, timestamp=1685235420513) 2023-05-28T08:57:00.516+08:00 INFO 13748 --- [ main] c.c.s.f.handler.DemoDeleteHandler : delete domain -> com.codingapi.springboot.framework.domain.Demo@4cc12db2 ``` +以上输出与事件的`toString()`行为一致：`DomainEvent`基类包含`entityClass`、`timestamp`、`entity`三个字段，且通过`@ToString(exclude = "entity")`排除了`entity`；`DomainChangeEvent`在此基础上通过`@ToString(callSuper = true)`追加了`fieldName`、`oldValue`、`newValue`字段，因此输出形如`DomainChangeEvent(super=DomainEvent(entityClass=class ...Demo, timestamp=...), fieldName=..., oldValue=..., newValue=...)`。`DomainCreateEvent`、`DomainPersistEvent`、`DomainDeleteEvent`未重写`toString()`，输出继承自`DomainEvent`。 ## 转换工具 该框架提供了一系列的转换工具，将BeanA转换为BeanB，转换工具的使用方式如下： @@ -210,12 +211,24 @@ class DomainProxyFactoryTest { ``` ## 序列化能力 -该框架提供了一系列的序列化工具，将对象转换为JSON对象，序列化工具的使用方式如下： +该框架提供了一系列的序列化工具，将对象转换为JSON对象。`toJson()`是`com.codingapi.springboot.framework.serializable.JsonSerializable`接口提供的默认方法（基于Fastjson实现），`Demo`类需要实现该接口后才可调用，如下： +```java +public class Demo implements JsonSerializable { + // ... +} +``` +使用方式如下： ```java Demo demo = new Demo("xiaoming"); JSONObject json = JSONObject.parseObject(demo.toJson()); ``` -将对象转换为Map对象，序列化工具的使用方式如下： +将对象转换为Map对象。`toMap()`是`com.codingapi.springboot.framework.serializable.MapSerializable`接口提供的默认方法，`Demo`类需要实现该接口后才可调用，如下： +```java +public class Demo implements MapSerializable { + // ... +} +``` +使用方式如下： ```java Demo demo = new Demo("xiaoming"); Map map = demo.toMap(); @@ -432,7 +445,7 @@ class ArithmeticTest { @Test void test() { - // 1 + 1 x 3 / 4 = 1.25 + // ((1 + 1) x 3) / 4 = 1.5 assertEquals(Arithmetic.one().add(1).mul(3).div(4).getDoubleValue(),1.5); // 0.1+0.2=0.3 @@ -516,3 +529,12 @@ public class FrameWorkApplication { ``` 只要当前运行环境的./jars路径下存在第三方的jar，可以通过执行`DynamicApplication.restart()`方法，动态的加载第三方的jar包，实现动态的服务能力。 + +## 框架配置项 + +在`application.properties`中可用的配置项如下： + +| 配置项 | 说明 | 默认值 | +|--------|------|--------| +| `codingapi.framework.handler-thread-pool-size` | 事件异步线程池大小，对应`FrameworkProperties.handlerThreadPoolSize`（绑定前缀`codingapi.framework`） | 20 | +| `codingapi.framework.event.transaction.enable` | 开启事务事件处理器。配置为`true`时，`SpringHandlerConfiguration`通过`@ConditionalOnProperty`注册`SpringTransactionEventHandler`，否则使用默认的`SpringDefaultEventHandler` | 不开启 | diff --git a/pom.xml b/pom.xml index 3ba9ed9b6..452218d17 100644 --- a/pom.xml +++ b/pom.xml @@ -3,43 +3,53 @@ xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd"> 4.0.0 pom + + springboot-starter-data-authorization + org.springframework.boot spring-boot-starter-parent - 3.1.2 + 2.7.18 com.codingapi.springboot springboot-parent - 2.1.11 + ${revision} - https://github.com/codingapi/springboot-framewrok + https://github.com/codingapi/springboot-framework springboot-parent springboot-parent project for Spring Boot - 17 + + 8.2.0-SNAPSHOT + 8 yyyy-MM-dd HH:mm:ss - 17 - 17 + 8 + 8 3.0.1 3.11.0 - 2.10.3 - 1.6.3 - 1.6 + 3.6.1 + 1.6.13 + 3.1.0 ${project.version} - 2.0.28 - 0.11.5 - 2.11.0 - 1.7 + 2.0.53 + 0.12.6 + 2.17.0 + 3.17.0 + 1.8.1 + 1.12.0 0.10.2 0.9.16 - 1.70 + 1.79 1.2.0 - 2.0 + 2.2 + 4.0.24 + 1.4.200 + 5.0 @@ -72,10 +82,16 @@ + + com.h2database + h2 + ${h2.version} + + org.bouncycastle - bcprov-jdk15on - ${bcprov-jdk15on.version} + bcprov-jdk18on + ${bcprov-jdk18on.version} @@ -90,6 +106,18 @@ ${commons-crypto.version} + + commons-io + commons-io + ${commons-io.version} + + + + org.apache.commons + commons-lang3 + ${commons-lang3.version} + + org.perf4j perf4j @@ -134,13 +162,13 @@ com.codingapi.springboot - springboot-starter-security-jwt + springboot-starter-script ${codingapi.framework.version} com.codingapi.springboot - springboot-starter-id-generator + springboot-starter-security ${codingapi.framework.version} @@ -156,11 +184,67 @@ ${commons-dbutils.version} + + org.apache.commons + commons-text + ${commons-text.version} + + + + org.apache.groovy + groovy + ${apache-groovy.version} + + + + org.apache.groovy + groovy-json + ${apache-groovy.version} + + + + org.apache.groovy + groovy-xml + ${apache-groovy.version} + + + + com.github.jsqlparser + jsqlparser + ${jsqlparser.version} + + + + org.codehaus.mojo + flatten-maven-plugin + 1.6.0 + + true + resolveCiFriendliesOnly + + + + flatten + process-resources + + flatten + + + + flatten.clean + clean + + clean + + + + + org.apache.maven.plugins maven-compiler-plugin @@ -172,6 +256,20 @@ -Xlint:deprecation + + + org.apache.maven.plugins + maven-jar-plugin + ${maven-jar-plugin.version} + + + + ${project.version} + ${project.name} + + + + @@ -216,9 +314,10 @@ springboot-starter - springboot-starter-security-jwt + springboot-starter-script + springboot-starter-security + springboot-starter-data-authorization springboot-starter-data-fast - springboot-starter-id-generator @@ -228,9 +327,10 @@ springboot-starter - springboot-starter-security-jwt + springboot-starter-script + springboot-starter-security + springboot-starter-data-authorization springboot-starter-data-fast - springboot-starter-id-generator @@ -238,7 +338,7 @@ org.jacoco jacoco-maven-plugin - 0.8.9 + 0.8.12 @@ -258,7 +358,7 @@ org.openclover clover-maven-plugin - 4.4.1 + 4.5.2 true true @@ -270,7 +370,8 @@ - + + @@ -278,27 +379,15 @@ springboot-starter - springboot-starter-security-jwt + springboot-starter-script + springboot-starter-security + springboot-starter-data-authorization springboot-starter-data-fast - springboot-starter-id-generator - - - - org.apache.maven.plugins - maven-compiler-plugin - ${maven-compiler-plugin.version} - - ${maven.compile.source} - ${maven.compile.target} - ${project.build.sourceEncoding} - -Xlint:deprecation - - org.apache.maven.plugins maven-source-plugin @@ -312,20 +401,18 @@ - - org.sonatype.plugins - nexus-staging-maven-plugin - 1.6.13 + org.sonatype.central + central-publishing-maven-plugin + 0.8.0 true - ossrh - https://oss.sonatype.org/ - true + central + true + published - org.apache.maven.plugins maven-javadoc-plugin @@ -344,7 +431,6 @@ - org.apache.maven.plugins maven-gpg-plugin @@ -363,8 +449,6 @@ - - diff --git a/springboot-starter-data-authorization/pom.xml b/springboot-starter-data-authorization/pom.xml new file mode 100644 index 000000000..b401db745 --- /dev/null +++ b/springboot-starter-data-authorization/pom.xml @@ -0,0 +1,78 @@ + + + 4.0.0 + + springboot-parent + com.codingapi.springboot + ${revision} + + + springboot-starter-data-authorization + springboot-starter-data-authorization + springboot-starter-data-authorization project for Spring Boot + + + 8 + + + + + + com.github.jsqlparser + jsqlparser + + + + org.springframework.boot + spring-boot-starter-data-jpa + test + + + + org.springframework.boot + spring-boot-starter-data-jdbc + test + + + + com.h2database + h2 + test + + + + com.mysql + mysql-connector-j + test + + + + + + + + + org.jacoco + jacoco-maven-plugin + 0.8.12 + + + + prepare-agent + + + + report + test + + report + + + + + + + + diff --git a/springboot-starter-data-authorization/src/main/java/com/codingapi/springboot/authorization/DataAuthorizationConfiguration.java b/springboot-starter-data-authorization/src/main/java/com/codingapi/springboot/authorization/DataAuthorizationConfiguration.java new file mode 100644 index 000000000..e36e604ab --- /dev/null +++ b/springboot-starter-data-authorization/src/main/java/com/codingapi/springboot/authorization/DataAuthorizationConfiguration.java @@ -0,0 +1,48 @@ +package com.codingapi.springboot.authorization; + + +import com.codingapi.springboot.authorization.filter.DataAuthorizationFilter; +import com.codingapi.springboot.authorization.handler.ColumnHandler; +import com.codingapi.springboot.authorization.handler.RowHandler; +import com.codingapi.springboot.authorization.interceptor.SQLInterceptor; +import com.codingapi.springboot.authorization.properties.DataAuthorizationProperties; +import com.codingapi.springboot.authorization.register.ConditionHandlerRegister; +import com.codingapi.springboot.authorization.register.DataAuthorizationContextRegister; +import com.codingapi.springboot.authorization.register.ResultSetHandlerRegister; +import com.codingapi.springboot.authorization.register.SQLInterceptorRegister; +import org.springframework.beans.factory.annotation.Autowired; +import org.springframework.boot.context.properties.ConfigurationProperties; +import org.springframework.context.annotation.Bean; +import org.springframework.context.annotation.Configuration; + +import java.util.List; + +@Configuration +public class DataAuthorizationConfiguration { + + @Bean + @ConfigurationProperties(prefix = "codingapi.data-authorization") + public DataAuthorizationProperties dataAuthorizationProperties(){ + return new DataAuthorizationProperties(); + } + + @Bean + public ConditionHandlerRegister conditionHandlerRegister(@Autowired(required = false) RowHandler rowHandler) { + return new ConditionHandlerRegister(rowHandler); + } + + @Bean + public ResultSetHandlerRegister resultSetHandlerRegister(@Autowired(required = false) ColumnHandler columnHandler) { + return new ResultSetHandlerRegister(columnHandler); + } + + @Bean + public SQLInterceptorRegister sqlInterceptorRegister(@Autowired(required = false) SQLInterceptor sqlInterceptor) { + return new SQLInterceptorRegister(sqlInterceptor); + } + + @Bean + public DataAuthorizationContextRegister dataAuthorizationContextRegister(@Autowired(required = false) List dataAuthorizationFilters) { + return new DataAuthorizationContextRegister(dataAuthorizationFilters); + } +} diff --git a/springboot-starter-data-authorization/src/main/java/com/codingapi/springboot/authorization/DataAuthorizationContext.java b/springboot-starter-data-authorization/src/main/java/com/codingapi/springboot/authorization/DataAuthorizationContext.java new file mode 100644 index 000000000..9a710fb5f --- /dev/null +++ b/springboot-starter-data-authorization/src/main/java/com/codingapi/springboot/authorization/DataAuthorizationContext.java @@ -0,0 +1,97 @@ +package com.codingapi.springboot.authorization; + +import com.codingapi.springboot.authorization.filter.DataAuthorizationFilter; +import com.codingapi.springboot.authorization.filter.DefaultSkipAuthorizationFilter; +import com.codingapi.springboot.authorization.filter.SkipAuthorizationFilter; +import com.codingapi.springboot.authorization.handler.Condition; +import com.codingapi.springboot.authorization.interceptor.SQLExecuteState; +import lombok.Getter; +import lombok.Setter; +import org.springframework.util.StringUtils; + +import java.util.ArrayList; +import java.util.List; + +/** + * 数据权限上下文 + */ +public class DataAuthorizationContext { + + @Getter + private final static DataAuthorizationContext instance = new DataAuthorizationContext(); + + private final List filters; + + @Setter + private SkipAuthorizationFilter skipAuthorizationFilter; + + private DataAuthorizationContext() { + this.filters = new ArrayList<>(); + this.skipAuthorizationFilter = new DefaultSkipAuthorizationFilter(); + } + + /** + * 跳过拦截的处理机制 + */ + public String skipSQLFilter(String sql){ + return this.skipAuthorizationFilter.filter(sql); + } + + + /** + * 添加数据权限过滤器 + * @param filter 数据权限过滤器 + */ + public void addDataAuthorizationFilter(DataAuthorizationFilter filter) { + this.filters.add(filter); + } + + /** + * 清空数据权限过滤器 + */ + public void clearDataAuthorizationFilters() { + this.filters.clear(); + } + + /** + * 列权限 + * @param interceptState 拦截状态 + * @param tableName 表名（或别名） + * @param columnName 列名 （或别名） + * @param value 值 + * @return T + * @param 泛型 + */ + public T columnAuthorization(SQLExecuteState interceptState, String tableName, String columnName, T value) { + if (interceptState != null && interceptState.hasIntercept()) { + String[] resolved = interceptState.resolveTableNameAndColumn(tableName, columnName); + String realTableName = resolved[0]; + String realColumnName = resolved[1]; + + for (DataAuthorizationFilter filter : filters) { + if (filter.supportColumnAuthorization(realTableName, realColumnName, value)) { + return filter.columnAuthorization(realTableName, realColumnName, value); + } + } + } + return value; + } + + /** + * 行权限 + * @param tableName 表名 + * @param tableAlias 别名 + * @return Condition 增加的过滤条件 + */ + public Condition rowAuthorization(String tableName, String tableAlias) { + if (StringUtils.hasText(tableName) && StringUtils.hasText(tableAlias)) { + for (DataAuthorizationFilter filter : filters) { + if (filter.supportRowAuthorization(tableName, tableAlias)) { + return filter.rowAuthorization(tableName, tableAlias); + } + } + } + return null; + } + +} diff --git a/springboot-starter-data-authorization/src/main/java/com/codingapi/springboot/authorization/condition/IConditionSQL.java b/springboot-starter-data-authorization/src/main/java/com/codingapi/springboot/authorization/condition/IConditionSQL.java new file mode 100644 index 000000000..9fc5dbfad --- /dev/null +++ b/springboot-starter-data-authorization/src/main/java/com/codingapi/springboot/authorization/condition/IConditionSQL.java @@ -0,0 +1,4 @@ +package com.codingapi.springboot.authorization.condition; + +public interface IConditionSQL { +} diff --git a/springboot-starter-data-authorization/src/main/java/com/codingapi/springboot/authorization/condition/JoinConditionSQL.java b/springboot-starter-data-authorization/src/main/java/com/codingapi/springboot/authorization/condition/JoinConditionSQL.java new file mode 100644 index 000000000..8662091fd --- /dev/null +++ b/springboot-starter-data-authorization/src/main/java/com/codingapi/springboot/authorization/condition/JoinConditionSQL.java @@ -0,0 +1,41 @@ +package com.codingapi.springboot.authorization.condition; + +import lombok.AllArgsConstructor; +import lombok.Getter; +import lombok.NoArgsConstructor; +import lombok.Setter; +import net.sf.jsqlparser.expression.Alias; +import net.sf.jsqlparser.schema.Table; +import org.springframework.util.StringUtils; + +@Setter +@Getter +@AllArgsConstructor +@NoArgsConstructor +public class JoinConditionSQL implements IConditionSQL { + + private Type type; + private String tableName; + private String tableAlias; + private String onCondition; + + + + public static enum Type{ + INNER, + LEFT, + RIGHT + } + + + public Table toJoinTable(){ + if(StringUtils.hasText(tableAlias)){ + Table table = new Table(this.tableName); + table.setAlias(new Alias(tableAlias)); + return table; + }else { + return new Table(this.tableName); + } + } + +} \ No newline at end of file diff --git a/springboot-starter-data-authorization/src/main/java/com/codingapi/springboot/authorization/condition/WhereConditionSQL.java b/springboot-starter-data-authorization/src/main/java/com/codingapi/springboot/authorization/condition/WhereConditionSQL.java new file mode 100644 index 000000000..0a9a1de83 --- /dev/null +++ b/springboot-starter-data-authorization/src/main/java/com/codingapi/springboot/authorization/condition/WhereConditionSQL.java @@ -0,0 +1,18 @@ +package com.codingapi.springboot.authorization.condition; + +import lombok.AllArgsConstructor; +import lombok.Data; +import lombok.NoArgsConstructor; + +@Data +@AllArgsConstructor +@NoArgsConstructor +public class WhereConditionSQL implements IConditionSQL { + + private String condition; + + public WhereConditionSQL(String condition,Object... args){ + this.condition = String.format(condition, args); + } + +} \ No newline at end of file diff --git a/springboot-starter-data-authorization/src/main/java/com/codingapi/springboot/authorization/enhancer/DataPermissionSQLEnhancer.java b/springboot-starter-data-authorization/src/main/java/com/codingapi/springboot/authorization/enhancer/DataPermissionSQLEnhancer.java new file mode 100644 index 000000000..e79ee7d7c --- /dev/null +++ b/springboot-starter-data-authorization/src/main/java/com/codingapi/springboot/authorization/enhancer/DataPermissionSQLEnhancer.java @@ -0,0 +1,166 @@ +package com.codingapi.springboot.authorization.enhancer; + + +import com.codingapi.springboot.authorization.condition.IConditionSQL; +import com.codingapi.springboot.authorization.enhancer.handler.ConditionSQLHandlerContext; +import com.codingapi.springboot.authorization.handler.Condition; +import com.codingapi.springboot.authorization.handler.RowHandler; +import net.sf.jsqlparser.expression.Expression; +import net.sf.jsqlparser.expression.operators.conditional.AndExpression; +import net.sf.jsqlparser.expression.operators.conditional.OrExpression; +import net.sf.jsqlparser.expression.operators.relational.InExpression; +import net.sf.jsqlparser.parser.CCJSqlParserUtil; +import net.sf.jsqlparser.schema.Table; +import net.sf.jsqlparser.statement.Statement; +import net.sf.jsqlparser.statement.select.*; + +import java.sql.SQLException; +import java.util.List; + +/** + * 数据权限 SQL 增强器 + */ +public class DataPermissionSQLEnhancer { + + private final String sql; + private final RowHandler rowHandler; + private final TableColumnAliasHolder tableColumnAliasHolder; + private final Statement statement; + + + // 构造函数 + public DataPermissionSQLEnhancer(String sql, RowHandler rowHandler) throws SQLException { + try { + // 如何sql中存在? 则在?后面添加空格 + this.sql = sql.replaceAll("\\?", " ? "); + this.rowHandler = rowHandler; + this.statement = CCJSqlParserUtil.parse(this.sql); + this.tableColumnAliasHolder = new TableColumnAliasHolder(statement); + } catch (Exception e) { + throw new SQLException(e); + } + } + + // 获取增强后的SQL + public String getNewSQL() throws SQLException { + try { + if (statement instanceof Select) { + tableColumnAliasHolder.holderAlias(); + Select select = (Select) statement; + this.deepMatch(select); + return statement.toString(); + } + } catch (Exception e) { + throw new SQLException(e); + } + return sql; + } + + + private void deepMatch(Select select) throws Exception { + if (select instanceof PlainSelect) { + PlainSelect plainSelect = select.getPlainSelect(); + this.enhanceDataPermissionInSelect(plainSelect); + } + if (select instanceof SetOperationList) { + SetOperationList setOperationList = select.getSetOperationList(); + List selectList = setOperationList.getSelects(); + for (Select selectItem : selectList) { + this.deepSearch(selectItem); + } + } + } + + + // 增强 SELECT 语句 + private void searchSubSelect(String parent, PlainSelect plainSelect) { + FromItem fromItem = plainSelect.getFromItem(); + + // FROM 项是表 + if (fromItem instanceof Table) { + this.appendTableAlias(fromItem); + Table table = (Table) fromItem; + this.appendColumnAlias(parent, table.getName(), plainSelect.getSelectItems()); + } + + + // FROM是子查询 + if (fromItem instanceof Select) { + PlainSelect subPlainSelect = ((Select) fromItem).getPlainSelect(); + this.appendColumnAlias(parent, null, plainSelect.getSelectItems()); + parent = fromItem.getAlias()!=null?fromItem.getAlias().getName():null; + this.searchSubSelect(parent, subPlainSelect); + // 递归完成后子查询内的表/派生表均已注册，可构建其投影映射 + this.buildProjection(parent, subPlainSelect); + } + + // 处理JOIN或关联子查询 + if (plainSelect.getJoins() != null) { + for (Join join : plainSelect.getJoins()) { + if (join.getRightItem() instanceof Select) { + FromItem currentItem = join.getRightItem(); + PlainSelect subPlainSelect = ((Select) currentItem).getPlainSelect(); + this.appendColumnAlias(parent, null, plainSelect.getSelectItems()); + parent = currentItem.getAlias()!=null?currentItem.getAlias().getName():null; + this.searchSubSelect(parent, subPlainSelect); + this.buildProjection(parent, subPlainSelect); + } + if (join.getRightItem() instanceof Table) { + FromItem currentItem = join.getRightItem(); + this.appendTableAlias(currentItem); + Table table = (Table) currentItem; + this.appendColumnAlias(parent, table.getName(), plainSelect.getSelectItems()); + } + } + } + } + + + /** + * 构建派生表（子查询）输出列到物理表字段的投影映射（Issue #212）。 + * 需在递归处理子查询之后调用，保证其引用的表/派生表均已注册。 + * + * @param alias 派生表别名 + * @param subPlainSelect 子查询 + */ + private void buildProjection(String alias, PlainSelect subPlainSelect) { + if (alias == null || subPlainSelect == null) { + return; + } + DerivedTableProjection projection = new DerivedTableProjection(); + List> selectItems = subPlainSelect.getSelectItems(); + if (selectItems != null) { + for (SelectItem selectItem : selectItems) { + Expression expression = selectItem.getExpression(); + String aliasName = selectItem.getAlias() != null ? selectItem.getAlias().getName() : null; + if (expression instanceof AllTableColumns) { + // 注意：AllTableColumns(emp.*) 是 AllColumns(*) 的子类，必须先判断 + projection.addStarTable(this.starTableOf(((AllTableColumns) expression).getTable())); + } else if (expression instanceof AllColumns) { + // SELECT * ：仅当子查询只有一个来源时可归因 + FromItem singleSource = this.singleSource(subPlainSelect); + projection.addStarTable(singleSource != null ? this.starTableOf(singleSource) : null); + } else if (expression instanceof Column) { + this.putProjectionColumn(projection, subPlainSelect, (Column) expression, aliasName); + } else if (aliasName != null) { + // 表达式/函数 AS 别名：非物理列，不参与归因 + projection.markExpression(aliasName.toLowerCase()); + } + } + } + aliasContext.addDerivedTable(alias, projection); + } + + private void putProjectionColumn(DerivedTableProjection projection, PlainSelect subPlainSelect, + Column column, String aliasName) { + String tableRef = column.getTable() != null ? column.getTable().getName() : ""; + if (tableRef.isEmpty()) { + // 裸列：仅当子查询只有一个来源时可归因 + FromItem singleSource = this.singleSource(subPlainSelect); + tableRef = singleSource != null ? this.sourceName(singleSource) : null; + } + String[] reference = this.resolveColumnReference(tableRef, column.getColumnName()); + if (reference != null) { + String outName = aliasName != null ? aliasName : column.getColumnName(); + projection.putExplicit(outName.toLowerCase(), reference[0], reference[1]); + } else if (aliasName != null) { + projection.markExpression(aliasName.toLowerCase()); + } + } + + /** + * 将 tableRef.column 解析到物理表字段（支持表别名、物理表名、派生表链式解析） + */ + private String[] resolveColumnReference(String tableRef, String columnName) { + if (tableRef == null || tableRef.isEmpty()) { + return null; + } + String physicalTable = aliasContext.resolvePhysicalTable(tableRef); + if (physicalTable != null) { + return new String[]{physicalTable, columnName}; + } + DerivedTableProjection derived = aliasContext.getDerivedTable(tableRef); + if (derived != null) { + return derived.find(columnName.toLowerCase(), columnName); + } + return null; + } + + /** + * 获取 * 展开来源的物理表名（Table 直接来源或派生表链式来源），歧义/未知返回 null + */ + private String starTableOf(FromItem fromItem) { + if (fromItem == null) { + return null; + } + String refName = this.sourceName(fromItem); + if (refName == null) { + return null; + } + String physicalTable = aliasContext.resolvePhysicalTable(refName); + if (physicalTable != null) { + return physicalTable; + } + DerivedTableProjection derived = aliasContext.getDerivedTable(refName); + if (derived != null && !derived.isStarAmbiguous()) { + return derived.getStarTable(); + } + return null; + } + + /** + * 子查询的唯一来源（无 JOIN 时的 FROM 项） + */ + private FromItem singleSource(PlainSelect plainSelect) { + if (plainSelect.getJoins() != null && !plainSelect.getJoins().isEmpty()) { + return null; + } + return plainSelect.getFromItem(); + } + + /** + * 来源的引用名（优先别名，其次表名；子查询取别名） + */ + private String sourceName(FromItem fromItem) { + if (fromItem instanceof Table) { + Table table = (Table) fromItem; + if (table.getAlias() != null) { + return table.getAlias().getName(); + } + return table.getName(); + } + if (fromItem.getAlias() != null) { + return fromItem.getAlias().getName(); + } + return null; + } + + + /** + * 添加表别名 + * + * @param fromItem 表 + */ + private void appendTableAlias(FromItem fromItem) { + Table table = (Table) fromItem; + Alias alias = table.getAlias(); + String aliasName = alias != null ? alias.getName() : table.getName(); + aliasContext.addTable(aliasName, table.getName()); + } + + + /** + * 添加列别名 + * + * @param parent 父表别名 + * @param selectItems 列 + */ + private void appendColumnAlias(String parent, String tableName, List> selectItems) { + if (selectItems != null) { + for (SelectItem selectItem : selectItems) { + if (selectItem.getExpression() instanceof Column) { + Column column = (Column) selectItem.getExpression(); + if (column.getTable() != null) { + tableName = column.getTable().getName(); + } + String columnName = column.getColumnName(); + Alias columnAlias = selectItem.getAlias(); + String aliasName = columnAlias != null ? selectItem.getAlias().getName() : columnName; + aliasContext.addColumn(parent, tableName, columnName, aliasName); + } + } + } + } + +} \ No newline at end of file diff --git a/springboot-starter-data-authorization/src/main/java/com/codingapi/springboot/authorization/enhancer/handler/ConditionSQLHandlerContext.java b/springboot-starter-data-authorization/src/main/java/com/codingapi/springboot/authorization/enhancer/handler/ConditionSQLHandlerContext.java new file mode 100644 index 000000000..ffa42eea5 --- /dev/null +++ b/springboot-starter-data-authorization/src/main/java/com/codingapi/springboot/authorization/enhancer/handler/ConditionSQLHandlerContext.java @@ -0,0 +1,38 @@ +package com.codingapi.springboot.authorization.enhancer.handler; + +import com.codingapi.springboot.authorization.condition.IConditionSQL; +import lombok.Getter; +import net.sf.jsqlparser.expression.Expression; +import net.sf.jsqlparser.schema.Table; +import net.sf.jsqlparser.statement.select.PlainSelect; + +import java.util.ArrayList; +import java.util.List; + +public class ConditionSQLHandlerContext { + + private final List handlers; + + @Getter + private final static ConditionSQLHandlerContext instance = new ConditionSQLHandlerContext(); + + private ConditionSQLHandlerContext() { + this.handlers = new ArrayList<>(); + this.registerHandlers(); + } + + + private void registerHandlers(){ + this.handlers.add(new WhereConditionSQLHandler()); + this.handlers.add(new JoinConditionSQLHandler()); + } + + + public void handler(IConditionSQL dynamicSQL, PlainSelect plainSelect, Table table, Expression where) { + for (IConditionSQLHandler handler:handlers){ + if (handler.support(dynamicSQL)){ + handler.handler(dynamicSQL,plainSelect, table, where); + } + } + } +} \ No newline at end of file diff --git a/springboot-starter-data-authorization/src/main/java/com/codingapi/springboot/authorization/enhancer/handler/IConditionSQLHandler.java b/springboot-starter-data-authorization/src/main/java/com/codingapi/springboot/authorization/enhancer/handler/IConditionSQLHandler.java new file mode 100644 index 000000000..a24de4f65 --- /dev/null +++ b/springboot-starter-data-authorization/src/main/java/com/codingapi/springboot/authorization/enhancer/handler/IConditionSQLHandler.java @@ -0,0 +1,15 @@ +package com.codingapi.springboot.authorization.enhancer.handler; + +import com.codingapi.springboot.authorization.condition.IConditionSQL; +import net.sf.jsqlparser.expression.Expression; +import net.sf.jsqlparser.schema.Table; +import net.sf.jsqlparser.statement.select.PlainSelect; + +public interface IConditionSQLHandler { + + boolean support(IConditionSQL conditionSQL); + + void handler(IConditionSQL conditionSQL, PlainSelect plainSelect, Table table, Expression where); + + +} \ No newline at end of file diff --git a/springboot-starter-data-authorization/src/main/java/com/codingapi/springboot/authorization/enhancer/handler/JoinConditionSQLHandler.java b/springboot-starter-data-authorization/src/main/java/com/codingapi/springboot/authorization/enhancer/handler/JoinConditionSQLHandler.java new file mode 100644 index 000000000..9f1af38d1 --- /dev/null +++ b/springboot-starter-data-authorization/src/main/java/com/codingapi/springboot/authorization/enhancer/handler/JoinConditionSQLHandler.java @@ -0,0 +1,52 @@ +package com.codingapi.springboot.authorization.enhancer.handler; + +import com.codingapi.springboot.authorization.condition.IConditionSQL; +import com.codingapi.springboot.authorization.condition.JoinConditionSQL; +import lombok.SneakyThrows; +import net.sf.jsqlparser.expression.Expression; +import net.sf.jsqlparser.parser.CCJSqlParserUtil; +import net.sf.jsqlparser.schema.Table; +import net.sf.jsqlparser.statement.select.Join; +import net.sf.jsqlparser.statement.select.PlainSelect; + +import java.util.ArrayList; +import java.util.Collection; + +public class JoinConditionSQLHandler implements IConditionSQLHandler { + + @Override + public boolean support(IConditionSQL conditionSQL) { + return conditionSQL instanceof JoinConditionSQL; + } + + @SneakyThrows + @Override + public void handler(IConditionSQL conditionSQL, PlainSelect plainSelect, Table table, Expression where) { + JoinConditionSQL joinConditionSQL = (JoinConditionSQL) conditionSQL; + + if(plainSelect.getJoins()==null){ + plainSelect.setJoins(new ArrayList<>()); + } + + Join join = new Join(); + join.setFromItem(joinConditionSQL.toJoinTable()); + + if(joinConditionSQL.getType()== JoinConditionSQL.Type.INNER){ + join.setInner(true); + } + + if(joinConditionSQL.getType()== JoinConditionSQL.Type.RIGHT){ + join.setRight(true); + } + + if(joinConditionSQL.getType()== JoinConditionSQL.Type.LEFT){ + join.setLeft(true); + } + + Collection expressions = new ArrayList<>(); + Expression expression = CCJSqlParserUtil.parseCondExpression(joinConditionSQL.getOnCondition()); + expressions.add(expression); + join.setOnExpressions(expressions); + plainSelect.addJoins(join); + } +} \ No newline at end of file diff --git a/springboot-starter-data-authorization/src/main/java/com/codingapi/springboot/authorization/enhancer/handler/WhereConditionSQLHandler.java b/springboot-starter-data-authorization/src/main/java/com/codingapi/springboot/authorization/enhancer/handler/WhereConditionSQLHandler.java new file mode 100644 index 000000000..57c34e0ae --- /dev/null +++ b/springboot-starter-data-authorization/src/main/java/com/codingapi/springboot/authorization/enhancer/handler/WhereConditionSQLHandler.java @@ -0,0 +1,31 @@ +package com.codingapi.springboot.authorization.enhancer.handler; + +import com.codingapi.springboot.authorization.condition.IConditionSQL; +import com.codingapi.springboot.authorization.condition.WhereConditionSQL; +import lombok.SneakyThrows; +import net.sf.jsqlparser.expression.Expression; +import net.sf.jsqlparser.expression.operators.conditional.AndExpression; +import net.sf.jsqlparser.parser.CCJSqlParserUtil; +import net.sf.jsqlparser.schema.Table; +import net.sf.jsqlparser.statement.select.PlainSelect; + +public class WhereConditionSQLHandler implements IConditionSQLHandler { + + @Override + public boolean support(IConditionSQL conditionSQL) { + return conditionSQL instanceof WhereConditionSQL; + } + + @SneakyThrows + @Override + public void handler(IConditionSQL conditionSQL, PlainSelect plainSelect, Table table, Expression where) { + String whereSQL = ((WhereConditionSQL) conditionSQL).getCondition(); + // 添加自定义条件 + Expression customExpression = CCJSqlParserUtil.parseCondExpression(whereSQL); + if (where != null) { + plainSelect.setWhere(new AndExpression(customExpression, where)); + } else { + plainSelect.setWhere(customExpression); + } + } +} \ No newline at end of file diff --git a/springboot-starter-data-authorization/src/main/java/com/codingapi/springboot/authorization/exception/NotAuthorizationException.java b/springboot-starter-data-authorization/src/main/java/com/codingapi/springboot/authorization/exception/NotAuthorizationException.java new file mode 100644 index 000000000..29a7f385b --- /dev/null +++ b/springboot-starter-data-authorization/src/main/java/com/codingapi/springboot/authorization/exception/NotAuthorizationException.java @@ -0,0 +1,13 @@ +package com.codingapi.springboot.authorization.exception; + +import java.sql.SQLException; + +public class NotAuthorizationException extends SQLException { + + public NotAuthorizationException() { + } + + public NotAuthorizationException(String reason) { + super(reason); + } +} diff --git a/springboot-starter-data-authorization/src/main/java/com/codingapi/springboot/authorization/filter/DataAuthorizationFilter.java b/springboot-starter-data-authorization/src/main/java/com/codingapi/springboot/authorization/filter/DataAuthorizationFilter.java new file mode 100644 index 000000000..697899289 --- /dev/null +++ b/springboot-starter-data-authorization/src/main/java/com/codingapi/springboot/authorization/filter/DataAuthorizationFilter.java @@ -0,0 +1,44 @@ +package com.codingapi.springboot.authorization.filter; + +import com.codingapi.springboot.authorization.handler.Condition; + +/** + * 数据权限过滤器 + */ +public interface DataAuthorizationFilter { + + /** + * 列权限过滤 + * @param tableName 表名 + * @param columnName 列名 + * @param value 值 + * @return 过滤后的值 + * @param T + */ + T columnAuthorization(String tableName, String columnName,T value); + + /** + * 行权限过滤 + * @param tableName 表名 + * @param tableAlias 表别名 + * @return 过滤后拦截sql条件 + */ + Condition rowAuthorization(String tableName, String tableAlias); + + /** + * 是否支持列权限过滤 + * @param tableName 表名 + * @param columnName 列名 + * @param value 值 + * @return 是否支持 + */ + boolean supportColumnAuthorization(String tableName, String columnName, Object value); + + /** + * 是否支持行权限过滤 + * @param tableName 表名 + * @param tableAlias 表别名 + * @return 是否支持 + */ + boolean supportRowAuthorization(String tableName, String tableAlias); +} diff --git a/springboot-starter-data-authorization/src/main/java/com/codingapi/springboot/authorization/filter/DefaultDataAuthorizationFilter.java b/springboot-starter-data-authorization/src/main/java/com/codingapi/springboot/authorization/filter/DefaultDataAuthorizationFilter.java new file mode 100644 index 000000000..ecc268818 --- /dev/null +++ b/springboot-starter-data-authorization/src/main/java/com/codingapi/springboot/authorization/filter/DefaultDataAuthorizationFilter.java @@ -0,0 +1,27 @@ +package com.codingapi.springboot.authorization.filter; + +import com.codingapi.springboot.authorization.handler.Condition; + +public class DefaultDataAuthorizationFilter implements DataAuthorizationFilter{ + + @Override + public T columnAuthorization(String tableName, String columnName, T value) { + return value; + } + + @Override + public Condition rowAuthorization(String tableName, String tableAlias) { + return null; + } + + @Override + public boolean supportColumnAuthorization(String tableName, String columnName, Object value) { + return false; + } + + @Override + public boolean supportRowAuthorization(String tableName, String tableAlias) { + return false; + } + +} diff --git a/springboot-starter-data-authorization/src/main/java/com/codingapi/springboot/authorization/filter/DefaultSkipAuthorizationFilter.java b/springboot-starter-data-authorization/src/main/java/com/codingapi/springboot/authorization/filter/DefaultSkipAuthorizationFilter.java new file mode 100644 index 000000000..253dc0c17 --- /dev/null +++ b/springboot-starter-data-authorization/src/main/java/com/codingapi/springboot/authorization/filter/DefaultSkipAuthorizationFilter.java @@ -0,0 +1,9 @@ +package com.codingapi.springboot.authorization.filter; + +public class DefaultSkipAuthorizationFilter implements SkipAuthorizationFilter{ + + @Override + public String filter(String sql) { + return sql; + } +} diff --git a/springboot-starter-data-authorization/src/main/java/com/codingapi/springboot/authorization/filter/SkipAuthorizationFilter.java b/springboot-starter-data-authorization/src/main/java/com/codingapi/springboot/authorization/filter/SkipAuthorizationFilter.java new file mode 100644 index 000000000..f27614728 --- /dev/null +++ b/springboot-starter-data-authorization/src/main/java/com/codingapi/springboot/authorization/filter/SkipAuthorizationFilter.java @@ -0,0 +1,11 @@ +package com.codingapi.springboot.authorization.filter; + + +/** + * 跳过数据权限拦截处理机制 + */ +public interface SkipAuthorizationFilter { + + String filter(String sql); + +} \ No newline at end of file diff --git a/springboot-starter-data-authorization/src/main/java/com/codingapi/springboot/authorization/handler/ColumnHandler.java b/springboot-starter-data-authorization/src/main/java/com/codingapi/springboot/authorization/handler/ColumnHandler.java new file mode 100644 index 000000000..2867f1b25 --- /dev/null +++ b/springboot-starter-data-authorization/src/main/java/com/codingapi/springboot/authorization/handler/ColumnHandler.java @@ -0,0 +1,74 @@ +package com.codingapi.springboot.authorization.handler; + +import com.codingapi.springboot.authorization.interceptor.SQLExecuteState; + +import java.io.InputStream; +import java.io.Reader; +import java.math.BigDecimal; +import java.net.URL; +import java.sql.*; + +/** + * 列表拦截器 + */ +public interface ColumnHandler { + + String getString(SQLExecuteState interceptState, int columnIndex, String tableName, String columnName, String value); + + boolean getBoolean(SQLExecuteState interceptState, int columnIndex, String tableName, String columnName, boolean value); + + byte getByte(SQLExecuteState interceptState, int columnIndex, String tableName, String columnName, byte value); + + short getShort(SQLExecuteState interceptState, int columnIndex, String tableName, String columnName, short value); + + int getInt(SQLExecuteState interceptState, int columnIndex, String tableName, String columnName, int value); + + long getLong(SQLExecuteState interceptState, int columnIndex, String tableName, String columnName, long value); + + float getFloat(SQLExecuteState interceptState, int columnIndex, String tableName, String columnName, float value); + + double getDouble(SQLExecuteState interceptState, int columnIndex, String tableName, String columnName, double value); + + BigDecimal getBigDecimal(SQLExecuteState interceptState, int columnIndex, String tableName, String columnName, BigDecimal value); + + byte[] getBytes(SQLExecuteState interceptState, int columnIndex, String tableName, String columnName, byte[] value); + + Date getDate(SQLExecuteState interceptState, int columnIndex, String tableName, String columnName, Date value); + + Time getTime(SQLExecuteState interceptState, int columnIndex, String tableName, String columnName, Time value); + + Timestamp getTimestamp(SQLExecuteState interceptState, int columnIndex, String tableName, String columnName, Timestamp value); + + InputStream getAsciiStream(SQLExecuteState interceptState, int columnIndex, String tableName, String columnName, InputStream value); + + InputStream getUnicodeStream(SQLExecuteState interceptState, int columnIndex, String tableName, String columnName, InputStream value); + + InputStream getBinaryStream(SQLExecuteState interceptState, int columnIndex, String tableName, String columnName, InputStream value); + + Object getObject(SQLExecuteState interceptState, int columnIndex, String tableName, String columnName, Object value); + + Reader getCharacterStream(SQLExecuteState interceptState, int columnIndex, String tableName, String columnName, Reader value); + + Ref getRef(SQLExecuteState interceptState, int columnIndex, String tableName, String columnName, Ref value); + + Blob getBlob(SQLExecuteState interceptState, int columnIndex, String tableName, String columnName, Blob value); + + Clob getClob(SQLExecuteState interceptState, int columnIndex, String tableName, String columnName, Clob value); + + Array getArray(SQLExecuteState interceptState, int columnIndex, String tableName, String columnName, Array value); + + URL getURL(SQLExecuteState interceptState, int columnIndex, String tableName, String columnName, URL value); + + NClob getNClob(SQLExecuteState interceptState, int columnIndex, String tableName, String columnName, NClob value); + + SQLXML getSQLXML(SQLExecuteState interceptState, int columnIndex, String tableName, String columnName, SQLXML value); + + String getNString(SQLExecuteState interceptState, int columnIndex, String tableName, String columnName, String value); + + Reader getNCharacterStream(SQLExecuteState interceptState, int columnIndex, String tableName, String columnName, Reader value); + + RowId getRowId(SQLExecuteState interceptState, int columnIndex, String tableName, String columnName, RowId value); + + T getObject(SQLExecuteState interceptState, int columnIndex, String tableName, String columnName, T value, Class type); + +} diff --git a/springboot-starter-data-authorization/src/main/java/com/codingapi/springboot/authorization/handler/ColumnHandlerContext.java b/springboot-starter-data-authorization/src/main/java/com/codingapi/springboot/authorization/handler/ColumnHandlerContext.java new file mode 100644 index 000000000..f591eaf1b --- /dev/null +++ b/springboot-starter-data-authorization/src/main/java/com/codingapi/springboot/authorization/handler/ColumnHandlerContext.java @@ -0,0 +1,144 @@ +package com.codingapi.springboot.authorization.handler; + +import com.codingapi.springboot.authorization.interceptor.SQLExecuteState; +import lombok.Getter; +import lombok.Setter; + +import java.io.InputStream; +import java.io.Reader; +import java.math.BigDecimal; +import java.net.URL; +import java.sql.*; + +/** + * ResultSet 拦截器 + */ +@Setter +public class ColumnHandlerContext { + + @Getter + private final static ColumnHandlerContext instance = new ColumnHandlerContext(); + + private ColumnHandlerContext() { + this.columnHandler = new DefaultColumnHandler(); + } + + private ColumnHandler columnHandler; + + + public String getString(SQLExecuteState interceptState, int columnIndex, String tableName, String columnName, String value) { + return columnHandler.getString(interceptState, columnIndex, tableName, columnName, value); + } + + public short getShort(SQLExecuteState interceptState, int columnIndex, String tableName, String columnName, short value) { + return columnHandler.getShort(interceptState, columnIndex, tableName, columnName, value); + } + + public boolean getBoolean(SQLExecuteState interceptState, int columnIndex, String tableName, String columnName, boolean value) { + return columnHandler.getBoolean(interceptState, columnIndex, tableName, columnName, value); + } + + public byte getByte(SQLExecuteState interceptState, int columnIndex, String tableName, String columnName, byte value) { + return columnHandler.getByte(interceptState, columnIndex, tableName, columnName, value); + } + + public int getInt(SQLExecuteState interceptState, int columnIndex, String tableName, String columnName, int value) { + return columnHandler.getInt(interceptState, columnIndex, tableName, columnName, value); + } + + public long getLong(SQLExecuteState interceptState, int columnIndex, String tableName, String columnName, long value) { + return columnHandler.getLong(interceptState, columnIndex, tableName, columnName, value); + } + + public float getFloat(SQLExecuteState interceptState, int columnIndex, String tableName, String columnName, float value) { + return columnHandler.getFloat(interceptState, columnIndex, tableName, columnName, value); + } + + public double getDouble(SQLExecuteState interceptState, int columnIndex, String tableName, String columnName, double value) { + return columnHandler.getDouble(interceptState, columnIndex, tableName, columnName, value); + } + + public BigDecimal getBigDecimal(SQLExecuteState interceptState, int columnIndex, String tableName, String columnName, BigDecimal value) { + return columnHandler.getBigDecimal(interceptState, columnIndex, tableName, columnName, value); + } + + public byte[] getBytes(SQLExecuteState interceptState, int columnIndex, String tableName, String columnName, byte[] value) { + return columnHandler.getBytes(interceptState, columnIndex, tableName, columnName, value); + } + + public Timestamp getTimestamp(SQLExecuteState interceptState, int columnIndex, String tableName, String columnName, Timestamp value) { + return columnHandler.getTimestamp(interceptState, columnIndex, tableName, columnName, value); + } + + public Time getTime(SQLExecuteState interceptState, int columnIndex, String tableName, String columnName, Time value) { + return columnHandler.getTime(interceptState, columnIndex, tableName, columnName, value); + } + + public Date getDate(SQLExecuteState interceptState, int columnIndex, String tableName, String columnName, Date value) { + return columnHandler.getDate(interceptState, columnIndex, tableName, columnName, value); + } + + public InputStream getAsciiStream(SQLExecuteState interceptState, int columnIndex, String tableName, String columnName, InputStream value) { + return columnHandler.getAsciiStream(interceptState, columnIndex, tableName, columnName, value); + } + + public InputStream getUnicodeStream(SQLExecuteState interceptState, int columnIndex, String tableName, String columnName, InputStream value) { + return columnHandler.getUnicodeStream(interceptState, columnIndex, tableName, columnName, value); + } + + public InputStream getBinaryStream(SQLExecuteState interceptState, int columnIndex, String tableName, String columnName, InputStream value) { + return columnHandler.getBinaryStream(interceptState, columnIndex, tableName, columnName, value); + } + + public Object getObject(SQLExecuteState interceptState, int columnIndex, String tableName, String columnName, Object value) { + return columnHandler.getObject(interceptState, columnIndex, tableName, columnName, value); + } + + public Reader getCharacterStream(SQLExecuteState interceptState, int columnIndex, String tableName, String columnName, Reader value) { + return columnHandler.getCharacterStream(interceptState, columnIndex, tableName, columnName, value); + } + + public Ref getRef(SQLExecuteState interceptState, int columnIndex, String tableName, String columnName, Ref value) { + return columnHandler.getRef(interceptState, columnIndex, tableName, columnName, value); + } + + public Blob getBlob(SQLExecuteState interceptState, int columnIndex, String tableName, String columnName, Blob value) { + return columnHandler.getBlob(interceptState, columnIndex, tableName, columnName, value); + } + + public Clob getClob(SQLExecuteState interceptState, int columnIndex, String tableName, String columnName, Clob value) { + return columnHandler.getClob(interceptState, columnIndex, tableName, columnName, value); + } + + public Array getArray(SQLExecuteState interceptState, int columnIndex, String tableName, String columnName, Array value) { + return columnHandler.getArray(interceptState, columnIndex, tableName, columnName, value); + } + + public URL getURL(SQLExecuteState interceptState, int columnIndex, String tableName, String columnName, URL value) { + return columnHandler.getURL(interceptState, columnIndex, tableName, columnName, value); + } + + public NClob getNClob(SQLExecuteState interceptState, int columnIndex, String tableName, String columnName, NClob value) { + return columnHandler.getNClob(interceptState, columnIndex, tableName, columnName, value); + } + + public SQLXML getSQLXML(SQLExecuteState interceptState, int columnIndex, String tableName, String columnName, SQLXML value) { + return columnHandler.getSQLXML(interceptState, columnIndex, tableName, columnName, value); + } + + public String getNString(SQLExecuteState interceptState, int columnIndex, String tableName, String columnName, String value) { + return columnHandler.getNString(interceptState, columnIndex, tableName, columnName, value); + } + + public Reader getNCharacterStream(SQLExecuteState interceptState, int columnIndex, String tableName, String columnName, Reader value) { + return columnHandler.getNCharacterStream(interceptState, columnIndex, tableName, columnName, value); + } + + public RowId getRowId(SQLExecuteState interceptState, int columnIndex, String tableName, String columnName, RowId value) { + return columnHandler.getRowId(interceptState, columnIndex, tableName, columnName, value); + } + + public T getObject(SQLExecuteState interceptState, int columnIndex, String tableName, String columnName, T value, Class type) { + return columnHandler.getObject(interceptState, columnIndex, tableName, columnName, value, type); + } +} diff --git a/springboot-starter-data-authorization/src/main/java/com/codingapi/springboot/authorization/handler/Condition.java b/springboot-starter-data-authorization/src/main/java/com/codingapi/springboot/authorization/handler/Condition.java new file mode 100644 index 000000000..c743b91a5 --- /dev/null +++ b/springboot-starter-data-authorization/src/main/java/com/codingapi/springboot/authorization/handler/Condition.java @@ -0,0 +1,49 @@ +package com.codingapi.springboot.authorization.handler; + +import com.codingapi.springboot.authorization.condition.IConditionSQL; +import com.codingapi.springboot.authorization.condition.WhereConditionSQL; +import lombok.Getter; + +import java.util.ArrayList; +import java.util.List; + +/** + * 查询条件 + */ +@Getter +public class Condition { + + private final List conditionList; + + public Condition() { + this.conditionList = new ArrayList<>(); + } + + public Condition(String condition) { + this.conditionList = new ArrayList<>(); + this.addConditionSQL(new WhereConditionSQL(condition)); + } + + public void addConditionSQL(IConditionSQL dynamicSQL){ + this.conditionList.add(dynamicSQL); + } + + public static Condition customCondition(String condition) { + Condition dynamicSQLContent = new Condition(); + dynamicSQLContent.addConditionSQL(new WhereConditionSQL(condition)); + return dynamicSQLContent; + } + + public static Condition formatCondition(String condition, Object... args) { + return customCondition(String.format(condition, args)); + } + + public static Condition emptyCondition() { + return null; + } + + public static Condition defaultCondition() { + return customCondition("1=1"); + } + +} diff --git a/springboot-starter-data-authorization/src/main/java/com/codingapi/springboot/authorization/handler/DefaultColumnHandler.java b/springboot-starter-data-authorization/src/main/java/com/codingapi/springboot/authorization/handler/DefaultColumnHandler.java new file mode 100644 index 000000000..ea6282abb --- /dev/null +++ b/springboot-starter-data-authorization/src/main/java/com/codingapi/springboot/authorization/handler/DefaultColumnHandler.java @@ -0,0 +1,161 @@ +package com.codingapi.springboot.authorization.handler; + +import com.codingapi.springboot.authorization.DataAuthorizationContext; +import com.codingapi.springboot.authorization.interceptor.SQLExecuteState; + +import java.io.InputStream; +import java.io.Reader; +import java.math.BigDecimal; +import java.net.URL; +import java.sql.*; + +/** + * 默认ResultSet 拦截器 + */ +public class DefaultColumnHandler implements ColumnHandler { + + @Override + public String getString(SQLExecuteState interceptState, int columnIndex, String tableName, String columnName, String value) { + return DataAuthorizationContext.getInstance().columnAuthorization(interceptState,tableName, columnName, value); + } + + @Override + public boolean getBoolean(SQLExecuteState interceptState, int columnIndex, String tableName, String columnName, boolean value) { + return DataAuthorizationContext.getInstance().columnAuthorization(interceptState,tableName, columnName, value); + } + + @Override + public byte getByte(SQLExecuteState interceptState, int columnIndex, String tableName, String columnName, byte value) { + return DataAuthorizationContext.getInstance().columnAuthorization(interceptState,tableName, columnName, value); + } + + @Override + public short getShort(SQLExecuteState interceptState, int columnIndex, String tableName, String columnName, short value) { + return DataAuthorizationContext.getInstance().columnAuthorization(interceptState,tableName, columnName, value); + } + + @Override + public int getInt(SQLExecuteState interceptState, int columnIndex, String tableName, String columnName, int value) { + return DataAuthorizationContext.getInstance().columnAuthorization(interceptState,tableName, columnName, value); + } + + @Override + public long getLong(SQLExecuteState interceptState, int columnIndex, String tableName, String columnName, long value) { + return DataAuthorizationContext.getInstance().columnAuthorization(interceptState,tableName, columnName, value); + } + + @Override + public float getFloat(SQLExecuteState interceptState, int columnIndex, String tableName, String columnName, float value) { + return DataAuthorizationContext.getInstance().columnAuthorization(interceptState,tableName, columnName, value); + } + + @Override + public double getDouble(SQLExecuteState interceptState, int columnIndex, String tableName, String columnName, double value) { + return DataAuthorizationContext.getInstance().columnAuthorization(interceptState,tableName, columnName, value); + } + + @Override + public BigDecimal getBigDecimal(SQLExecuteState interceptState, int columnIndex, String tableName, String columnName, BigDecimal value) { + return DataAuthorizationContext.getInstance().columnAuthorization(interceptState,tableName, columnName, value); + } + + @Override + public byte[] getBytes(SQLExecuteState interceptState, int columnIndex, String tableName, String columnName, byte[] value) { + return DataAuthorizationContext.getInstance().columnAuthorization(interceptState,tableName, columnName, value); + } + + @Override + public Date getDate(SQLExecuteState interceptState, int columnIndex, String tableName, String columnName, Date value) { + return DataAuthorizationContext.getInstance().columnAuthorization(interceptState,tableName, columnName, value); + } + + @Override + public Time getTime(SQLExecuteState interceptState, int columnIndex, String tableName, String columnName, Time value) { + return DataAuthorizationContext.getInstance().columnAuthorization(interceptState,tableName, columnName, value); + } + + @Override + public Timestamp getTimestamp(SQLExecuteState interceptState, int columnIndex, String tableName, String columnName, Timestamp value) { + return DataAuthorizationContext.getInstance().columnAuthorization(interceptState,tableName, columnName, value); + } + + @Override + public InputStream getAsciiStream(SQLExecuteState interceptState, int columnIndex, String tableName, String columnName, InputStream value) { + return DataAuthorizationContext.getInstance().columnAuthorization(interceptState,tableName, columnName, value); + } + + @Override + public InputStream getUnicodeStream(SQLExecuteState interceptState, int columnIndex, String tableName, String columnName, InputStream value) { + return DataAuthorizationContext.getInstance().columnAuthorization(interceptState,tableName, columnName, value); + } + + @Override + public InputStream getBinaryStream(SQLExecuteState interceptState, int columnIndex, String tableName, String columnName, InputStream value) { + return DataAuthorizationContext.getInstance().columnAuthorization(interceptState,tableName, columnName, value); + } + + @Override + public Object getObject(SQLExecuteState interceptState, int columnIndex, String tableName, String columnName, Object value) { + return DataAuthorizationContext.getInstance().columnAuthorization(interceptState,tableName, columnName, value); + } + + @Override + public Reader getCharacterStream(SQLExecuteState interceptState, int columnIndex, String tableName, String columnName, Reader value) { + return DataAuthorizationContext.getInstance().columnAuthorization(interceptState,tableName, columnName, value); + } + + @Override + public Ref getRef(SQLExecuteState interceptState, int columnIndex, String tableName, String columnName, Ref value) { + return DataAuthorizationContext.getInstance().columnAuthorization(interceptState,tableName, columnName, value); + } + + @Override + public Blob getBlob(SQLExecuteState interceptState, int columnIndex, String tableName, String columnName, Blob value) { + return DataAuthorizationContext.getInstance().columnAuthorization(interceptState,tableName, columnName, value); + } + + @Override + public Clob getClob(SQLExecuteState interceptState, int columnIndex, String tableName, String columnName, Clob value) { + return DataAuthorizationContext.getInstance().columnAuthorization(interceptState,tableName, columnName, value); + } + + @Override + public Array getArray(SQLExecuteState interceptState, int columnIndex, String tableName, String columnName, Array value) { + return DataAuthorizationContext.getInstance().columnAuthorization(interceptState,tableName, columnName, value); + } + + @Override + public URL getURL(SQLExecuteState interceptState, int columnIndex, String tableName, String columnName, URL value) { + return DataAuthorizationContext.getInstance().columnAuthorization(interceptState,tableName, columnName, value); + } + + @Override + public NClob getNClob(SQLExecuteState interceptState, int columnIndex, String tableName, String columnName, NClob value) { + return DataAuthorizationContext.getInstance().columnAuthorization(interceptState,tableName, columnName, value); + } + + @Override + public SQLXML getSQLXML(SQLExecuteState interceptState, int columnIndex, String tableName, String columnName, SQLXML value) { + return DataAuthorizationContext.getInstance().columnAuthorization(interceptState,tableName, columnName, value); + } + + @Override + public String getNString(SQLExecuteState interceptState, int columnIndex, String tableName, String columnName, String value) { + return DataAuthorizationContext.getInstance().columnAuthorization(interceptState,tableName, columnName, value); + } + + @Override + public Reader getNCharacterStream(SQLExecuteState interceptState, int columnIndex, String tableName, String columnName, Reader value) { + return DataAuthorizationContext.getInstance().columnAuthorization(interceptState,tableName, columnName, value); + } + + @Override + public RowId getRowId(SQLExecuteState interceptState, int columnIndex, String tableName, String columnName, RowId value) { + return DataAuthorizationContext.getInstance().columnAuthorization(interceptState,tableName, columnName, value); + } + + @Override + public T getObject(SQLExecuteState interceptState, int columnIndex, String tableName, String columnName, T value, Class type) { + return DataAuthorizationContext.getInstance().columnAuthorization(interceptState,tableName, columnName, value); + } +} diff --git a/springboot-starter-data-authorization/src/main/java/com/codingapi/springboot/authorization/handler/DefaultRowHandler.java b/springboot-starter-data-authorization/src/main/java/com/codingapi/springboot/authorization/handler/DefaultRowHandler.java new file mode 100644 index 000000000..972075cf6 --- /dev/null +++ b/springboot-starter-data-authorization/src/main/java/com/codingapi/springboot/authorization/handler/DefaultRowHandler.java @@ -0,0 +1,11 @@ +package com.codingapi.springboot.authorization.handler; + +import com.codingapi.springboot.authorization.DataAuthorizationContext; + +public class DefaultRowHandler implements RowHandler { + + @Override + public Condition handler(String subSql, String tableName, String tableAlias) { + return DataAuthorizationContext.getInstance().rowAuthorization(tableName, tableAlias); + } +} diff --git a/springboot-starter-data-authorization/src/main/java/com/codingapi/springboot/authorization/handler/RowHandler.java b/springboot-starter-data-authorization/src/main/java/com/codingapi/springboot/authorization/handler/RowHandler.java new file mode 100644 index 000000000..7262d5c49 --- /dev/null +++ b/springboot-starter-data-authorization/src/main/java/com/codingapi/springboot/authorization/handler/RowHandler.java @@ -0,0 +1,19 @@ +package com.codingapi.springboot.authorization.handler; + +/** + * 行数据权限处理器 + */ +public interface RowHandler { + + /** + * 查询条件拦截 + * + * @param subSql 查询子SQL语句 + * @param tableName 表名 + * @param tableAlias 表别名 + * @return 条件语句 + */ + Condition handler(String subSql, String tableName, String tableAlias); + + +} diff --git a/springboot-starter-data-authorization/src/main/java/com/codingapi/springboot/authorization/handler/RowHandlerContext.java b/springboot-starter-data-authorization/src/main/java/com/codingapi/springboot/authorization/handler/RowHandlerContext.java new file mode 100644 index 000000000..5d096177f --- /dev/null +++ b/springboot-starter-data-authorization/src/main/java/com/codingapi/springboot/authorization/handler/RowHandlerContext.java @@ -0,0 +1,18 @@ +package com.codingapi.springboot.authorization.handler; + +import lombok.Getter; +import lombok.Setter; + +@Setter +public class RowHandlerContext { + + @Getter + private final static RowHandlerContext instance = new RowHandlerContext(); + + @Getter + private RowHandler rowHandler; + + private RowHandlerContext() { + this.rowHandler = new DefaultRowHandler(); + } +} diff --git a/springboot-starter-data-authorization/src/main/java/com/codingapi/springboot/authorization/interceptor/DataPermissionSQL.java b/springboot-starter-data-authorization/src/main/java/com/codingapi/springboot/authorization/interceptor/DataPermissionSQL.java new file mode 100644 index 000000000..b0b47df8d --- /dev/null +++ b/springboot-starter-data-authorization/src/main/java/com/codingapi/springboot/authorization/interceptor/DataPermissionSQL.java @@ -0,0 +1,18 @@ +package com.codingapi.springboot.authorization.interceptor; + +import com.codingapi.springboot.authorization.enhancer.TableColumnAliasContext; +import lombok.Getter; + +@Getter +public class DataPermissionSQL { + + private final String sql; + private final String newSql; + private final TableColumnAliasContext aliasContext; + + public DataPermissionSQL(String sql, String newSql, TableColumnAliasContext aliasContext) { + this.sql = sql; + this.newSql = newSql; + this.aliasContext = aliasContext; + } +} diff --git a/springboot-starter-data-authorization/src/main/java/com/codingapi/springboot/authorization/interceptor/DefaultSQLInterceptor.java b/springboot-starter-data-authorization/src/main/java/com/codingapi/springboot/authorization/interceptor/DefaultSQLInterceptor.java new file mode 100644 index 000000000..47bb18bfc --- /dev/null +++ b/springboot-starter-data-authorization/src/main/java/com/codingapi/springboot/authorization/interceptor/DefaultSQLInterceptor.java @@ -0,0 +1,40 @@ +package com.codingapi.springboot.authorization.interceptor; + + +import com.codingapi.springboot.authorization.enhancer.DataPermissionSQLEnhancer; +import com.codingapi.springboot.authorization.handler.RowHandler; +import com.codingapi.springboot.authorization.handler.RowHandlerContext; +import com.codingapi.springboot.authorization.properties.DataAuthorizationPropertyContext; +import com.codingapi.springboot.authorization.utils.SQLUtils; +import lombok.extern.slf4j.Slf4j; + +import java.sql.SQLException; + +@Slf4j +public class DefaultSQLInterceptor implements SQLInterceptor { + + @Override + public boolean beforeHandler(String sql) { + return SQLUtils.isQuerySql(sql); + } + + + @Override + public void afterHandler(String sql, String newSql, SQLException exception) { + if(exception!=null){ + log.error("sql:{}",sql); + log.error("newSql:{}",newSql); + log.error(exception.getMessage(),exception); + } + if (DataAuthorizationPropertyContext.getInstance().showSql()) { + log.info("newSql:{}", newSql); + } + } + + @Override + public DataPermissionSQL postHandler(String sql) throws SQLException { + RowHandler rowHandler = RowHandlerContext.getInstance().getRowHandler(); + DataPermissionSQLEnhancer sqlEnhancer = new DataPermissionSQLEnhancer(sql, rowHandler); + return new DataPermissionSQL(sql, sqlEnhancer.getNewSQL(), sqlEnhancer.getTableAlias()); + } +} diff --git a/springboot-starter-data-authorization/src/main/java/com/codingapi/springboot/authorization/interceptor/SQLExecuteState.java b/springboot-starter-data-authorization/src/main/java/com/codingapi/springboot/authorization/interceptor/SQLExecuteState.java new file mode 100644 index 000000000..b5413d94f --- /dev/null +++ b/springboot-starter-data-authorization/src/main/java/com/codingapi/springboot/authorization/interceptor/SQLExecuteState.java @@ -0,0 +1,83 @@ +package com.codingapi.springboot.authorization.interceptor; + +import com.codingapi.springboot.authorization.enhancer.TableColumnAliasContext; + +/** + * SQL拦截状态 + */ +public class SQLExecuteState { + + /** + * 是否拦截SQL + */ + private final boolean intercept; + + /** + * 原始SQL + */ + private final String sql; + + /** + * 处理后的SQL + */ + private final String newSql; + + /** + * 表字段别名对象 + */ + private final TableColumnAliasContext aliasContext; + + private SQLExecuteState(boolean intercept, String sql, String newSql, TableColumnAliasContext aliasContext) { + this.intercept = intercept; + this.sql = sql; + this.newSql = newSql; + this.aliasContext = aliasContext; + } + + /** + * 拦截 + */ + public static SQLExecuteState intercept(String sql, String newSql, TableColumnAliasContext aliasContext) { + return new SQLExecuteState(true, sql, newSql, aliasContext); + } + + /** + * 不拦截 + */ + public static SQLExecuteState unIntercept(String sql) { + return new SQLExecuteState(false, sql, sql, null); + } + + public String getTableName(String tableName) { + return aliasContext.getTableName(tableName); + } + + public String getColumnName(String tableName, String columnName) { + return aliasContext.getColumnName(tableName, columnName); + } + + /** + * 联合解析结果集列的（表名, 字段名）到物理表字段（含派生表归因，见 Issue #212） + * + * @param tableName 元数据表名（或别名） + * @param columnName 元数据字段名（或别名） + * @return [物理表名, 物理字段名] + */ + public String[] resolveTableNameAndColumn(String tableName, String columnName) { + return aliasContext.resolveTableNameAndColumn(tableName, columnName); + } + + public String getSql() { + if (intercept) { + return newSql; + } else { + return sql; + } + } + + public boolean hasIntercept() { + return intercept; + } + + +} diff --git a/springboot-starter-data-authorization/src/main/java/com/codingapi/springboot/authorization/interceptor/SQLInterceptor.java b/springboot-starter-data-authorization/src/main/java/com/codingapi/springboot/authorization/interceptor/SQLInterceptor.java new file mode 100644 index 000000000..dd627f5d3 --- /dev/null +++ b/springboot-starter-data-authorization/src/main/java/com/codingapi/springboot/authorization/interceptor/SQLInterceptor.java @@ -0,0 +1,39 @@ +package com.codingapi.springboot.authorization.interceptor; + +import java.sql.SQLException; + +/** + * SQL查询条件处理器 + */ +public interface SQLInterceptor { + + + /** + * 前置处理 + * + * @param sql sql + * @return 是否处理 + */ + boolean beforeHandler(String sql); + + + /** + * 处理sql + * + * @param sql sql + * @return 处理后的sql newSql + * @throws SQLException + */ + DataPermissionSQL postHandler(String sql) throws SQLException; + + + /** + * 后置处理 + * @param sql sql + * @param newSql newSql + * @param exception exception + */ + void afterHandler(String sql, String newSql, SQLException exception); + + +} diff --git a/springboot-starter-data-authorization/src/main/java/com/codingapi/springboot/authorization/interceptor/SQLInterceptorContext.java b/springboot-starter-data-authorization/src/main/java/com/codingapi/springboot/authorization/interceptor/SQLInterceptorContext.java new file mode 100644 index 000000000..178de534a --- /dev/null +++ b/springboot-starter-data-authorization/src/main/java/com/codingapi/springboot/authorization/interceptor/SQLInterceptorContext.java @@ -0,0 +1,20 @@ +package com.codingapi.springboot.authorization.interceptor; + +import lombok.Getter; +import lombok.Setter; + +@Setter +public class SQLInterceptorContext { + + @Getter + private final static SQLInterceptorContext instance = new SQLInterceptorContext(); + + @Getter + private SQLInterceptor sqlInterceptor; + + private SQLInterceptorContext() { + this.sqlInterceptor = new DefaultSQLInterceptor(); + } + + +} diff --git a/springboot-starter-data-authorization/src/main/java/com/codingapi/springboot/authorization/interceptor/SQLRunningContext.java b/springboot-starter-data-authorization/src/main/java/com/codingapi/springboot/authorization/interceptor/SQLRunningContext.java new file mode 100644 index 000000000..d23bb4cf7 --- /dev/null +++ b/springboot-starter-data-authorization/src/main/java/com/codingapi/springboot/authorization/interceptor/SQLRunningContext.java @@ -0,0 +1,85 @@ +package com.codingapi.springboot.authorization.interceptor; + +import com.codingapi.springboot.authorization.DataAuthorizationContext; +import lombok.Getter; + +import java.sql.SQLException; +import java.util.function.Supplier; + +/** + * SQLRunningContext SQL执行拦截上下文 + */ +public class SQLRunningContext { + + @Getter + private final static SQLRunningContext instance = new SQLRunningContext(); + + private final ThreadLocal skipInterceptor = ThreadLocal.withInitial(() -> false); + + private SQLRunningContext() { + } + + /** + * 拦截SQL + * + * @param sql sql + * @return SQLInterceptState + * @throws SQLException SQLException + */ + public SQLExecuteState intercept(String sql) throws SQLException { + SQLInterceptor sqlInterceptor = SQLInterceptorContext.getInstance().getSqlInterceptor(); + + if (skipInterceptor.get()) { + sql = DataAuthorizationContext.getInstance().skipSQLFilter(sql); + return SQLExecuteState.unIntercept(sql); + } + try { + if (sqlInterceptor.beforeHandler(sql)) { + // 在拦截器中执行的查询操作将不会被拦截 + skipInterceptor.set(true); + DataPermissionSQL dataPermissionSQL = sqlInterceptor.postHandler(sql); + sqlInterceptor.afterHandler(sql, dataPermissionSQL.getNewSql(), null); + return SQLExecuteState.intercept(sql, dataPermissionSQL.getNewSql(), dataPermissionSQL.getAliasContext()); + } + } catch (SQLException exception) { + sqlInterceptor.afterHandler(sql, null, exception); + } finally { + // 重置拦截器状态 + skipInterceptor.set(false); + } + return SQLExecuteState.unIntercept(sql); + } + + + /** + * 跳过数据权限拦截 + * + * @param supplier 业务逻辑 + * @param T + * @return T + */ + public T skipDataAuthorization(Supplier supplier) { + try { + skipInterceptor.set(true); + return (T) supplier.get(); + } finally { + skipInterceptor.set(false); + } + } + + + /** + * 跳过数据权限拦截 + * + * @param runnable 业务逻辑 + */ + public void skipDataAuthorization(Runnable runnable) { + try { + skipInterceptor.set(true); + runnable.run(); + } finally { + skipInterceptor.set(false); + } + } + +} diff --git a/springboot-starter-data-authorization/src/main/java/com/codingapi/springboot/authorization/jdbc/AuthorizationJdbcDriver.java b/springboot-starter-data-authorization/src/main/java/com/codingapi/springboot/authorization/jdbc/AuthorizationJdbcDriver.java new file mode 100644 index 000000000..be81fe5a9 --- /dev/null +++ b/springboot-starter-data-authorization/src/main/java/com/codingapi/springboot/authorization/jdbc/AuthorizationJdbcDriver.java @@ -0,0 +1,135 @@ +package com.codingapi.springboot.authorization.jdbc; + + +import com.codingapi.springboot.authorization.jdbc.proxy.ConnectionProxy; + +import java.sql.*; +import java.util.Enumeration; +import java.util.Properties; +import java.util.concurrent.ConcurrentHashMap; +import java.util.concurrent.ConcurrentMap; +import java.util.logging.Level; +import java.util.logging.Logger; + +public class AuthorizationJdbcDriver implements Driver { + + private static final ConcurrentMap DRIVER_CACHE = new ConcurrentHashMap<>(); + private static final Logger LOGGER = Logger.getLogger(AuthorizationJdbcDriver.class.getName()); + + static { + try { + DriverManager.registerDriver(new AuthorizationJdbcDriver()); + } catch (Exception e) { + LOGGER.log(Level.SEVERE, "Failed to register AuthorizationJdbcDriver", e); + throw new RuntimeException("Failed to register AuthorizationJdbcDriver", e); + } + LOGGER.info("AuthorizationJdbcDriver initialized and registered"); + } + + + @Override + public Connection connect(String url, Properties info) throws SQLException { + if (url == null) { + throw new SQLException("URL cannot be null"); + } + + Driver driver = findDriver(url); + if (driver == null) { + throw new SQLException("No suitable driver found for " + url); + } + return new ConnectionProxy(driver.connect(url, info)); + } + + + /** + * 查找接受指定 URL 的真实 JDBC 驱动 + * + * @param url JDBC URL + * @return 真实的 JDBC 驱动，如果未找到则返回 null + */ + private Driver findDriver(String url) throws SQLException { + if (url == null) { + return null; + } + + // 从缓存中查找（使用 URL 前缀作为 key） + Driver cachedDriver = DRIVER_CACHE.get(url); + if (cachedDriver != null) { + try { + // 验证缓存的驱动仍然接受该 URL + if (cachedDriver.acceptsURL(url)) { + return cachedDriver; + } else { + // 如果缓存的驱动不再接受该 URL，从缓存中移除 + DRIVER_CACHE.remove(url, cachedDriver); + } + } catch (SQLException e) { + // 如果验证失败，从缓存中移除并继续查找 + DRIVER_CACHE.remove(url, cachedDriver); + LOGGER.log(Level.FINE, "Cached driver no longer accepts URL: " + url, e); + } + } + + // 遍历所有已注册的驱动 + Enumeration drivers = DriverManager.getDrivers(); + while (drivers.hasMoreElements()) { + Driver driver = drivers.nextElement(); + if (driver.getClass().equals(AuthorizationJdbcDriver.class)) { + continue; + } + try { + if (driver.acceptsURL(url)) { + // 缓存驱动（使用 URL 的前缀作为 key，因为同一个数据库类型的 URL 前缀相同） + DRIVER_CACHE.putIfAbsent(url, driver); + return driver; + } + } catch (SQLException e) { + // 忽略单个驱动的异常，继续查找 + LOGGER.log(Level.FINE, "Driver " + driver.getClass().getName() + " does not accept URL: " + url, e); + } + } + return null; + } + + @Override + public boolean acceptsURL(String url) throws SQLException { + if (url == null) { + return false; + } + Driver driver = findDriver(url); + return driver != null; + } + + @Override + public DriverPropertyInfo[] getPropertyInfo(String url, Properties info) throws SQLException { + Driver driver = findDriver(url); + if (driver == null) { + throw new SQLException("No suitable driver found for " + url); + } + return driver.getPropertyInfo(url, info); + } + + @Override + public int getMajorVersion() { + // 返回代理驱动的主版本号 + return 1; + } + + @Override + public int getMinorVersion() { + // 返回代理驱动的次版本号 + return 0; + } + + @Override + public boolean jdbcCompliant() { + // 代理驱动本身不直接兼容 JDBC，它依赖于底层驱动 + return false; + } + + + @Override + public Logger getParentLogger() throws SQLFeatureNotSupportedException { + return LOGGER; + } +} diff --git a/springboot-starter-data-authorization/src/main/java/com/codingapi/springboot/authorization/jdbc/proxy/CallableStatementProxy.java b/springboot-starter-data-authorization/src/main/java/com/codingapi/springboot/authorization/jdbc/proxy/CallableStatementProxy.java new file mode 100644 index 000000000..93004f6d0 --- /dev/null +++ b/springboot-starter-data-authorization/src/main/java/com/codingapi/springboot/authorization/jdbc/proxy/CallableStatementProxy.java @@ -0,0 +1,1191 @@ +package com.codingapi.springboot.authorization.jdbc.proxy; + +import com.codingapi.springboot.authorization.interceptor.SQLExecuteState; +import com.codingapi.springboot.authorization.interceptor.SQLRunningContext; +import lombok.AllArgsConstructor; + +import java.io.InputStream; +import java.io.Reader; +import java.math.BigDecimal; +import java.net.URL; +import java.sql.*; +import java.util.Calendar; +import java.util.Map; + +@AllArgsConstructor +public class CallableStatementProxy implements CallableStatement { + + private final CallableStatement callableStatement; + + private SQLExecuteState interceptState; + + @Override + public void registerOutParameter(int parameterIndex, int sqlType) throws SQLException { + callableStatement.registerOutParameter(parameterIndex, sqlType); + } + + @Override + public void registerOutParameter(int parameterIndex, int sqlType, int scale) throws SQLException { + callableStatement.registerOutParameter(parameterIndex, sqlType, scale); + } + + @Override + public boolean wasNull() throws SQLException { + return callableStatement.wasNull(); + } + + @Override + public String getString(int parameterIndex) throws SQLException { + return callableStatement.getString(parameterIndex); + } + + @Override + public boolean getBoolean(int parameterIndex) throws SQLException { + return callableStatement.getBoolean(parameterIndex); + } + + @Override + public byte getByte(int parameterIndex) throws SQLException { + return callableStatement.getByte(parameterIndex); + } + + @Override + public short getShort(int parameterIndex) throws SQLException { + return callableStatement.getShort(parameterIndex); + } + + @Override + public int getInt(int parameterIndex) throws SQLException { + return callableStatement.getInt(parameterIndex); + } + + @Override + public long getLong(int parameterIndex) throws SQLException { + return callableStatement.getLong(parameterIndex); + } + + @Override + public float getFloat(int parameterIndex) throws SQLException { + return callableStatement.getFloat(parameterIndex); + } + + @Override + public double getDouble(int parameterIndex) throws SQLException { + return callableStatement.getDouble(parameterIndex); + } + + @Override + public BigDecimal getBigDecimal(int parameterIndex, int scale) throws SQLException { + return callableStatement.getBigDecimal(parameterIndex, scale); + } + + @Override + public byte[] getBytes(int parameterIndex) throws SQLException { + return callableStatement.getBytes(parameterIndex); + } + + @Override + public Date getDate(int parameterIndex) throws SQLException { + return callableStatement.getDate(parameterIndex); + } + + @Override + public Time getTime(int parameterIndex) throws SQLException { + return callableStatement.getTime(parameterIndex); + } + + @Override + public Timestamp getTimestamp(int parameterIndex) throws SQLException { + return callableStatement.getTimestamp(parameterIndex); + } + + @Override + public Object getObject(int parameterIndex) throws SQLException { + return callableStatement.getObject(parameterIndex); + } + + @Override + public BigDecimal getBigDecimal(int parameterIndex) throws SQLException { + return callableStatement.getBigDecimal(parameterIndex); + } + + @Override + public Object getObject(int parameterIndex, Map> map) throws SQLException { + return callableStatement.getObject(parameterIndex, map); + } + + @Override + public Ref getRef(int parameterIndex) throws SQLException { + return callableStatement.getRef(parameterIndex); + } + + @Override + public Blob getBlob(int parameterIndex) throws SQLException { + return callableStatement.getBlob(parameterIndex); + } + + @Override + public Clob getClob(int parameterIndex) throws SQLException { + return callableStatement.getClob(parameterIndex); + } + + @Override + public Array getArray(int parameterIndex) throws SQLException { + return callableStatement.getArray(parameterIndex); + } + + @Override + public Date getDate(int parameterIndex, Calendar cal) throws SQLException { + return callableStatement.getDate(parameterIndex, cal); + } + + @Override + public Time getTime(int parameterIndex, Calendar cal) throws SQLException { + return callableStatement.getTime(parameterIndex, cal); + } + + @Override + public Timestamp getTimestamp(int parameterIndex, Calendar cal) throws SQLException { + return callableStatement.getTimestamp(parameterIndex, cal); + } + + @Override + public void registerOutParameter(int parameterIndex, int sqlType, String typeName) throws SQLException { + callableStatement.registerOutParameter(parameterIndex, sqlType, typeName); + } + + @Override + public void registerOutParameter(String parameterName, int sqlType) throws SQLException { + callableStatement.registerOutParameter(parameterName, sqlType); + } + + @Override + public void registerOutParameter(String parameterName, int sqlType, int scale) throws SQLException { + callableStatement.registerOutParameter(parameterName, sqlType, scale); + } + + @Override + public void registerOutParameter(String parameterName, int sqlType, String typeName) throws SQLException { + callableStatement.registerOutParameter(parameterName, sqlType, typeName); + } + + @Override + public URL getURL(int parameterIndex) throws SQLException { + return callableStatement.getURL(parameterIndex); + } + + @Override + public void setURL(String parameterName, URL val) throws SQLException { + callableStatement.setURL(parameterName, val); + } + + @Override + public void setNull(String parameterName, int sqlType) throws SQLException { + callableStatement.setNull(parameterName, sqlType); + } + + @Override + public void setBoolean(String parameterName, boolean x) throws SQLException { + callableStatement.setBoolean(parameterName, x); + } + + @Override + public void setByte(String parameterName, byte x) throws SQLException { + callableStatement.setByte(parameterName, x); + } + + @Override + public void setShort(String parameterName, short x) throws SQLException { + callableStatement.setShort(parameterName, x); + } + + @Override + public void setInt(String parameterName, int x) throws SQLException { + callableStatement.setInt(parameterName, x); + } + + @Override + public void setLong(String parameterName, long x) throws SQLException { + callableStatement.setLong(parameterName, x); + } + + @Override + public void setFloat(String parameterName, float x) throws SQLException { + callableStatement.setFloat(parameterName, x); + } + + @Override + public void setDouble(String parameterName, double x) throws SQLException { + callableStatement.setDouble(parameterName, x); + } + + @Override + public void setBigDecimal(String parameterName, BigDecimal x) throws SQLException { + callableStatement.setBigDecimal(parameterName, x); + } + + @Override + public void setString(String parameterName, String x) throws SQLException { + callableStatement.setString(parameterName, x); + } + + @Override + public void setBytes(String parameterName, byte[] x) throws SQLException { + callableStatement.setBytes(parameterName, x); + } + + @Override + public void setDate(String parameterName, Date x) throws SQLException { + callableStatement.setDate(parameterName, x); + } + + @Override + public void setTime(String parameterName, Time x) throws SQLException { + callableStatement.setTime(parameterName, x); + } + + @Override + public void setTimestamp(String parameterName, Timestamp x) throws SQLException { + callableStatement.setTimestamp(parameterName, x); + } + + @Override + public void setAsciiStream(String parameterName, InputStream x, int length) throws SQLException { + callableStatement.setAsciiStream(parameterName, x, length); + } + + @Override + public void setBinaryStream(String parameterName, InputStream x, int length) throws SQLException { + callableStatement.setBinaryStream(parameterName, x, length); + } + + @Override + public void setObject(String parameterName, Object x, int targetSqlType, int scale) throws SQLException { + callableStatement.setObject(parameterName, x, targetSqlType, scale); + } + + @Override + public void setObject(String parameterName, Object x, int targetSqlType) throws SQLException { + callableStatement.setObject(parameterName, x, targetSqlType); + } + + @Override + public void setObject(String parameterName, Object x) throws SQLException { + callableStatement.setObject(parameterName, x); + } + + @Override + public void setCharacterStream(String parameterName, Reader reader, int length) throws SQLException { + callableStatement.setCharacterStream(parameterName, reader, length); + } + + @Override + public void setDate(String parameterName, Date x, Calendar cal) throws SQLException { + callableStatement.setDate(parameterName, x, cal); + } + + @Override + public void setTime(String parameterName, Time x, Calendar cal) throws SQLException { + callableStatement.setTime(parameterName, x, cal); + } + + @Override + public void setTimestamp(String parameterName, Timestamp x, Calendar cal) throws SQLException { + callableStatement.setTimestamp(parameterName, x, cal); + } + + @Override + public void setNull(String parameterName, int sqlType, String typeName) throws SQLException { + callableStatement.setNull(parameterName, sqlType, typeName); + } + + @Override + public String getString(String parameterName) throws SQLException { + return callableStatement.getString(parameterName); + } + + @Override + public boolean getBoolean(String parameterName) throws SQLException { + return callableStatement.getBoolean(parameterName); + } + + @Override + public byte getByte(String parameterName) throws SQLException { + return callableStatement.getByte(parameterName); + } + + @Override + public short getShort(String parameterName) throws SQLException { + return callableStatement.getShort(parameterName); + } + + @Override + public int getInt(String parameterName) throws SQLException { + return callableStatement.getInt(parameterName); + } + + @Override + public long getLong(String parameterName) throws SQLException { + return callableStatement.getLong(parameterName); + } + + @Override + public float getFloat(String parameterName) throws SQLException { + return callableStatement.getFloat(parameterName); + } + + @Override + public double getDouble(String parameterName) throws SQLException { + return callableStatement.getDouble(parameterName); + } + + @Override + public byte[] getBytes(String parameterName) throws SQLException { + return callableStatement.getBytes(parameterName); + } + + @Override + public Date getDate(String parameterName) throws SQLException { + return callableStatement.getDate(parameterName); + } + + @Override + public Time getTime(String parameterName) throws SQLException { + return callableStatement.getTime(parameterName); + } + + @Override + public Timestamp getTimestamp(String parameterName) throws SQLException { + return callableStatement.getTimestamp(parameterName); + } + + @Override + public Object getObject(String parameterName) throws SQLException { + return callableStatement.getObject(parameterName); + } + + @Override + public BigDecimal getBigDecimal(String parameterName) throws SQLException { + return callableStatement.getBigDecimal(parameterName); + } + + @Override + public Object getObject(String parameterName, Map> map) throws SQLException { + return callableStatement.getObject(parameterName, map); + } + + @Override + public Ref getRef(String parameterName) throws SQLException { + return callableStatement.getRef(parameterName); + } + + @Override + public Blob getBlob(String parameterName) throws SQLException { + return callableStatement.getBlob(parameterName); + } + + @Override + public Clob getClob(String parameterName) throws SQLException { + return callableStatement.getClob(parameterName); + } + + @Override + public Array getArray(String parameterName) throws SQLException { + return callableStatement.getArray(parameterName); + } + + @Override + public Date getDate(String parameterName, Calendar cal) throws SQLException { + return callableStatement.getDate(parameterName, cal); + } + + @Override + public Time getTime(String parameterName, Calendar cal) throws SQLException { + return callableStatement.getTime(parameterName, cal); + } + + @Override + public Timestamp getTimestamp(String parameterName, Calendar cal) throws SQLException { + return callableStatement.getTimestamp(parameterName, cal); + } + + @Override + public URL getURL(String parameterName) throws SQLException { + return callableStatement.getURL(parameterName); + } + + @Override + public RowId getRowId(int parameterIndex) throws SQLException { + return callableStatement.getRowId(parameterIndex); + } + + @Override + public RowId getRowId(String parameterName) throws SQLException { + return callableStatement.getRowId(parameterName); + } + + @Override + public void setRowId(String parameterName, RowId x) throws SQLException { + callableStatement.setRowId(parameterName, x); + } + + @Override + public void setNString(String parameterName, String value) throws SQLException { + callableStatement.setNString(parameterName, value); + } + + @Override + public void setNCharacterStream(String parameterName, Reader value, long length) throws SQLException { + callableStatement.setNCharacterStream(parameterName, value, length); + } + + @Override + public void setNClob(String parameterName, NClob value) throws SQLException { + callableStatement.setNClob(parameterName, value); + } + + @Override + public void setClob(String parameterName, Reader reader, long length) throws SQLException { + callableStatement.setClob(parameterName, reader, length); + } + + @Override + public void setBlob(String parameterName, InputStream inputStream, long length) throws SQLException { + callableStatement.setBlob(parameterName, inputStream, length); + } + + @Override + public void setNClob(String parameterName, Reader reader, long length) throws SQLException { + callableStatement.setNClob(parameterName, reader, length); + } + + @Override + public NClob getNClob(int parameterIndex) throws SQLException { + return callableStatement.getNClob(parameterIndex); + } + + @Override + public NClob getNClob(String parameterName) throws SQLException { + return callableStatement.getNClob(parameterName); + } + + @Override + public void setSQLXML(String parameterName, SQLXML xmlObject) throws SQLException { + callableStatement.setSQLXML(parameterName, xmlObject); + } + + @Override + public SQLXML getSQLXML(int parameterIndex) throws SQLException { + return callableStatement.getSQLXML(parameterIndex); + } + + @Override + public SQLXML getSQLXML(String parameterName) throws SQLException { + return callableStatement.getSQLXML(parameterName); + } + + @Override + public String getNString(int parameterIndex) throws SQLException { + return callableStatement.getNString(parameterIndex); + } + + @Override + public String getNString(String parameterName) throws SQLException { + return callableStatement.getNString(parameterName); + } + + @Override + public Reader getNCharacterStream(int parameterIndex) throws SQLException { + return callableStatement.getNCharacterStream(parameterIndex); + } + + @Override + public Reader getNCharacterStream(String parameterName) throws SQLException { + return callableStatement.getNCharacterStream(parameterName); + } + + @Override + public Reader getCharacterStream(int parameterIndex) throws SQLException { + return callableStatement.getCharacterStream(parameterIndex); + } + + @Override + public Reader getCharacterStream(String parameterName) throws SQLException { + return callableStatement.getCharacterStream(parameterName); + } + + @Override + public void setBlob(String parameterName, Blob x) throws SQLException { + callableStatement.setBlob(parameterName, x); + } + + @Override + public void setClob(String parameterName, Clob x) throws SQLException { + callableStatement.setClob(parameterName, x); + } + + @Override + public void setAsciiStream(String parameterName, InputStream x, long length) throws SQLException { + callableStatement.setAsciiStream(parameterName, x, length); + } + + @Override + public void setBinaryStream(String parameterName, InputStream x, long length) throws SQLException { + callableStatement.setBinaryStream(parameterName, x, length); + } + + @Override + public void setCharacterStream(String parameterName, Reader reader, long length) throws SQLException { + callableStatement.setCharacterStream(parameterName, reader, length); + } + + @Override + public void setAsciiStream(String parameterName, InputStream x) throws SQLException { + callableStatement.setAsciiStream(parameterName, x); + } + + @Override + public void setBinaryStream(String parameterName, InputStream x) throws SQLException { + callableStatement.setBinaryStream(parameterName, x); + } + + @Override + public void setCharacterStream(String parameterName, Reader reader) throws SQLException { + callableStatement.setCharacterStream(parameterName, reader); + } + + @Override + public void setNCharacterStream(String parameterName, Reader value) throws SQLException { + callableStatement.setNCharacterStream(parameterName, value); + } + + @Override + public void setClob(String parameterName, Reader reader) throws SQLException { + callableStatement.setClob(parameterName, reader); + } + + @Override + public void setBlob(String parameterName, InputStream inputStream) throws SQLException { + callableStatement.setBlob(parameterName, inputStream); + } + + @Override + public void setNClob(String parameterName, Reader reader) throws SQLException { + callableStatement.setNClob(parameterName, reader); + } + + @Override + public T getObject(int parameterIndex, Class type) throws SQLException { + return callableStatement.getObject(parameterIndex, type); + } + + @Override + public T getObject(String parameterName, Class type) throws SQLException { + return callableStatement.getObject(parameterName, type); + } + + @Override + public void setObject(String parameterName, Object x, SQLType targetSqlType, int scaleOrLength) throws SQLException { + callableStatement.setObject(parameterName, x, targetSqlType, scaleOrLength); + } + + @Override + public void setObject(String parameterName, Object x, SQLType targetSqlType) throws SQLException { + callableStatement.setObject(parameterName, x, targetSqlType); + } + + @Override + public void registerOutParameter(int parameterIndex, SQLType sqlType) throws SQLException { + callableStatement.registerOutParameter(parameterIndex, sqlType); + } + + @Override + public void registerOutParameter(int parameterIndex, SQLType sqlType, int scale) throws SQLException { + callableStatement.registerOutParameter(parameterIndex, sqlType, scale); + } + + @Override + public void registerOutParameter(int parameterIndex, SQLType sqlType, String typeName) throws SQLException { + callableStatement.registerOutParameter(parameterIndex, sqlType, typeName); + } + + @Override + public void registerOutParameter(String parameterName, SQLType sqlType) throws SQLException { + callableStatement.registerOutParameter(parameterName, sqlType); + } + + @Override + public void registerOutParameter(String parameterName, SQLType sqlType, int scale) throws SQLException { + callableStatement.registerOutParameter(parameterName, sqlType, scale); + } + + @Override + public void registerOutParameter(String parameterName, SQLType sqlType, String typeName) throws SQLException { + callableStatement.registerOutParameter(parameterName, sqlType, typeName); + } + + @Override + public ResultSet executeQuery() throws SQLException { + return new ResultSetProxy(callableStatement.executeQuery(),this.interceptState); + } + + @Override + public int executeUpdate() throws SQLException { + return callableStatement.executeUpdate(); + } + + @Override + public void setNull(int parameterIndex, int sqlType) throws SQLException { + callableStatement.setNull(parameterIndex, sqlType); + } + + @Override + public void setBoolean(int parameterIndex, boolean x) throws SQLException { + callableStatement.setBoolean(parameterIndex, x); + } + + @Override + public void setByte(int parameterIndex, byte x) throws SQLException { + callableStatement.setByte(parameterIndex, x); + } + + @Override + public void setShort(int parameterIndex, short x) throws SQLException { + callableStatement.setShort(parameterIndex, x); + } + + @Override + public void setInt(int parameterIndex, int x) throws SQLException { + callableStatement.setInt(parameterIndex, x); + } + + @Override + public void setLong(int parameterIndex, long x) throws SQLException { + callableStatement.setLong(parameterIndex, x); + } + + @Override + public void setFloat(int parameterIndex, float x) throws SQLException { + callableStatement.setFloat(parameterIndex, x); + } + + @Override + public void setDouble(int parameterIndex, double x) throws SQLException { + callableStatement.setDouble(parameterIndex, x); + } + + @Override + public void setBigDecimal(int parameterIndex, BigDecimal x) throws SQLException { + callableStatement.setBigDecimal(parameterIndex, x); + } + + @Override + public void setString(int parameterIndex, String x) throws SQLException { + callableStatement.setString(parameterIndex, x); + } + + @Override + public void setBytes(int parameterIndex, byte[] x) throws SQLException { + callableStatement.setBytes(parameterIndex, x); + } + + @Override + public void setDate(int parameterIndex, Date x) throws SQLException { + callableStatement.setDate(parameterIndex, x); + } + + @Override + public void setTime(int parameterIndex, Time x) throws SQLException { + callableStatement.setTime(parameterIndex, x); + } + + @Override + public void setTimestamp(int parameterIndex, Timestamp x) throws SQLException { + callableStatement.setTimestamp(parameterIndex, x); + } + + @Override + public void setAsciiStream(int parameterIndex, InputStream x, int length) throws SQLException { + callableStatement.setAsciiStream(parameterIndex, x, length); + } + + @Override + public void setUnicodeStream(int parameterIndex, InputStream x, int length) throws SQLException { + callableStatement.setUnicodeStream(parameterIndex, x, length); + } + + @Override + public void setBinaryStream(int parameterIndex, InputStream x, int length) throws SQLException { + callableStatement.setBinaryStream(parameterIndex, x, length); + } + + @Override + public void clearParameters() throws SQLException { + callableStatement.clearParameters(); + } + + @Override + public void setObject(int parameterIndex, Object x, int targetSqlType) throws SQLException { + callableStatement.setObject(parameterIndex, x, targetSqlType); + } + + @Override + public void setObject(int parameterIndex, Object x) throws SQLException { + callableStatement.setObject(parameterIndex, x); + } + + @Override + public boolean execute() throws SQLException { + return callableStatement.execute(); + } + + @Override + public void addBatch() throws SQLException { + callableStatement.addBatch(); + } + + @Override + public void setCharacterStream(int parameterIndex, Reader reader, int length) throws SQLException { + callableStatement.setCharacterStream(parameterIndex, reader, length); + } + + @Override + public void setRef(int parameterIndex, Ref x) throws SQLException { + callableStatement.setRef(parameterIndex, x); + } + + @Override + public void setBlob(int parameterIndex, Blob x) throws SQLException { + callableStatement.setBlob(parameterIndex, x); + } + + @Override + public void setClob(int parameterIndex, Clob x) throws SQLException { + callableStatement.setClob(parameterIndex, x); + } + + @Override + public void setArray(int parameterIndex, Array x) throws SQLException { + callableStatement.setArray(parameterIndex, x); + } + + @Override + public ResultSetMetaData getMetaData() throws SQLException { + return callableStatement.getMetaData(); + } + + @Override + public void setDate(int parameterIndex, Date x, Calendar cal) throws SQLException { + callableStatement.setDate(parameterIndex, x, cal); + } + + @Override + public void setTime(int parameterIndex, Time x, Calendar cal) throws SQLException { + callableStatement.setTime(parameterIndex, x, cal); + } + + @Override + public void setTimestamp(int parameterIndex, Timestamp x, Calendar cal) throws SQLException { + callableStatement.setTimestamp(parameterIndex, x, cal); + } + + @Override + public void setNull(int parameterIndex, int sqlType, String typeName) throws SQLException { + callableStatement.setNull(parameterIndex, sqlType, typeName); + } + + @Override + public void setURL(int parameterIndex, URL x) throws SQLException { + callableStatement.setURL(parameterIndex, x); + } + + @Override + public ParameterMetaData getParameterMetaData() throws SQLException { + return callableStatement.getParameterMetaData(); + } + + @Override + public void setRowId(int parameterIndex, RowId x) throws SQLException { + callableStatement.setRowId(parameterIndex, x); + } + + @Override + public void setNString(int parameterIndex, String value) throws SQLException { + callableStatement.setNString(parameterIndex, value); + } + + @Override + public void setNCharacterStream(int parameterIndex, Reader value, long length) throws SQLException { + callableStatement.setNCharacterStream(parameterIndex, value, length); + } + + @Override + public void setNClob(int parameterIndex, NClob value) throws SQLException { + callableStatement.setNClob(parameterIndex, value); + } + + @Override + public void setClob(int parameterIndex, Reader reader, long length) throws SQLException { + callableStatement.setClob(parameterIndex, reader, length); + } + + @Override + public void setBlob(int parameterIndex, InputStream inputStream, long length) throws SQLException { + callableStatement.setBlob(parameterIndex, inputStream, length); + } + + @Override + public void setNClob(int parameterIndex, Reader reader, long length) throws SQLException { + callableStatement.setNClob(parameterIndex, reader, length); + } + + @Override + public void setSQLXML(int parameterIndex, SQLXML xmlObject) throws SQLException { + callableStatement.setSQLXML(parameterIndex, xmlObject); + } + + @Override + public void setObject(int parameterIndex, Object x, int targetSqlType, int scaleOrLength) throws SQLException { + callableStatement.setObject(parameterIndex, x, targetSqlType, scaleOrLength); + } + + @Override + public void setAsciiStream(int parameterIndex, InputStream x, long length) throws SQLException { + callableStatement.setAsciiStream(parameterIndex, x, length); + } + + @Override + public void setBinaryStream(int parameterIndex, InputStream x, long length) throws SQLException { + callableStatement.setBinaryStream(parameterIndex, x, length); + } + + @Override + public void setCharacterStream(int parameterIndex, Reader reader, long length) throws SQLException { + callableStatement.setCharacterStream(parameterIndex, reader, length); + } + + @Override + public void setAsciiStream(int parameterIndex, InputStream x) throws SQLException { + callableStatement.setAsciiStream(parameterIndex, x); + } + + @Override + public void setBinaryStream(int parameterIndex, InputStream x) throws SQLException { + callableStatement.setBinaryStream(parameterIndex, x); + } + + @Override + public void setCharacterStream(int parameterIndex, Reader reader) throws SQLException { + callableStatement.setCharacterStream(parameterIndex, reader); + } + + @Override + public void setNCharacterStream(int parameterIndex, Reader value) throws SQLException { + callableStatement.setNCharacterStream(parameterIndex, value); + } + + @Override + public void setClob(int parameterIndex, Reader reader) throws SQLException { + callableStatement.setClob(parameterIndex, reader); + } + + @Override + public void setBlob(int parameterIndex, InputStream inputStream) throws SQLException { + callableStatement.setBlob(parameterIndex, inputStream); + } + + @Override + public void setNClob(int parameterIndex, Reader reader) throws SQLException { + callableStatement.setNClob(parameterIndex, reader); + } + + @Override + public void setObject(int parameterIndex, Object x, SQLType targetSqlType, int scaleOrLength) throws SQLException { + callableStatement.setObject(parameterIndex, x, targetSqlType, scaleOrLength); + } + + @Override + public void setObject(int parameterIndex, Object x, SQLType targetSqlType) throws SQLException { + callableStatement.setObject(parameterIndex, x, targetSqlType); + } + + @Override + public long executeLargeUpdate() throws SQLException { + return callableStatement.executeLargeUpdate(); + } + + @Override + public ResultSet executeQuery(String sql) throws SQLException { + this.interceptState = SQLRunningContext.getInstance().intercept(sql); + return new ResultSetProxy(callableStatement.executeQuery(interceptState.getSql()),this.interceptState); + } + + @Override + public int executeUpdate(String sql) throws SQLException { + this.interceptState = SQLRunningContext.getInstance().intercept(sql); + return callableStatement.executeUpdate(interceptState.getSql()); + } + + @Override + public void close() throws SQLException { + callableStatement.close(); + } + + @Override + public int getMaxFieldSize() throws SQLException { + return callableStatement.getMaxFieldSize(); + } + + @Override + public void setMaxFieldSize(int max) throws SQLException { + callableStatement.setMaxFieldSize(max); + } + + @Override + public int getMaxRows() throws SQLException { + return callableStatement.getMaxRows(); + } + + @Override + public void setMaxRows(int max) throws SQLException { + callableStatement.setMaxRows(max); + } + + @Override + public void setEscapeProcessing(boolean enable) throws SQLException { + callableStatement.setEscapeProcessing(enable); + } + + @Override + public int getQueryTimeout() throws SQLException { + return callableStatement.getQueryTimeout(); + } + + @Override + public void setQueryTimeout(int seconds) throws SQLException { + callableStatement.setQueryTimeout(seconds); + } + + @Override + public void cancel() throws SQLException { + callableStatement.cancel(); + } + + @Override + public SQLWarning getWarnings() throws SQLException { + return callableStatement.getWarnings(); + } + + @Override + public void clearWarnings() throws SQLException { + callableStatement.clearWarnings(); + } + + @Override + public void setCursorName(String name) throws SQLException { + callableStatement.setCursorName(name); + } + + @Override + public boolean execute(String sql) throws SQLException { + this.interceptState = SQLRunningContext.getInstance().intercept(sql); + return callableStatement.execute(interceptState.getSql()); + } + + @Override + public ResultSet getResultSet() throws SQLException { + return new ResultSetProxy(callableStatement.getResultSet(),this.interceptState); + } + + @Override + public int getUpdateCount() throws SQLException { + return callableStatement.getUpdateCount(); + } + + @Override + public boolean getMoreResults() throws SQLException { + return callableStatement.getMoreResults(); + } + + @Override + public void setFetchDirection(int direction) throws SQLException { + callableStatement.setFetchDirection(direction); + } + + @Override + public int getFetchDirection() throws SQLException { + return callableStatement.getFetchDirection(); + } + + @Override + public void setFetchSize(int rows) throws SQLException { + callableStatement.setFetchSize(rows); + } + + @Override + public int getFetchSize() throws SQLException { + return callableStatement.getFetchSize(); + } + + @Override + public int getResultSetConcurrency() throws SQLException { + return callableStatement.getResultSetConcurrency(); + } + + @Override + public int getResultSetType() throws SQLException { + return callableStatement.getResultSetType(); + } + + @Override + public void addBatch(String sql) throws SQLException { + this.interceptState = SQLRunningContext.getInstance().intercept(sql); + callableStatement.addBatch(interceptState.getSql()); + } + + @Override + public void clearBatch() throws SQLException { + callableStatement.clearBatch(); + } + + @Override + public int[] executeBatch() throws SQLException { + return callableStatement.executeBatch(); + } + + @Override + public Connection getConnection() throws SQLException { + return new ConnectionProxy(callableStatement.getConnection()); + } + + @Override + public boolean getMoreResults(int current) throws SQLException { + return callableStatement.getMoreResults(current); + } + + @Override + public ResultSet getGeneratedKeys() throws SQLException { + return callableStatement.getGeneratedKeys(); + } + + @Override + public int executeUpdate(String sql, int autoGeneratedKeys) throws SQLException { + this.interceptState = SQLRunningContext.getInstance().intercept(sql); + return callableStatement.executeUpdate(interceptState.getSql(), autoGeneratedKeys); + } + + @Override + public int executeUpdate(String sql, int[] columnIndexes) throws SQLException { + this.interceptState = SQLRunningContext.getInstance().intercept(sql); + return callableStatement.executeUpdate(interceptState.getSql(), columnIndexes); + } + + @Override + public int executeUpdate(String sql, String[] columnNames) throws SQLException { + this.interceptState = SQLRunningContext.getInstance().intercept(sql); + return callableStatement.executeUpdate(interceptState.getSql(), columnNames); + } + + @Override + public boolean execute(String sql, int autoGeneratedKeys) throws SQLException { + this.interceptState = SQLRunningContext.getInstance().intercept(sql); + return callableStatement.execute(interceptState.getSql(), autoGeneratedKeys); + } + + @Override + public boolean execute(String sql, int[] columnIndexes) throws SQLException { + this.interceptState = SQLRunningContext.getInstance().intercept(sql); + return callableStatement.execute(interceptState.getSql(), columnIndexes); + } + + @Override + public boolean execute(String sql, String[] columnNames) throws SQLException { + this.interceptState = SQLRunningContext.getInstance().intercept(sql); + return callableStatement.execute(interceptState.getSql(), columnNames); + } + + @Override + public int getResultSetHoldability() throws SQLException { + return callableStatement.getResultSetHoldability(); + } + + @Override + public boolean isClosed() throws SQLException { + return callableStatement.isClosed(); + } + + @Override + public void setPoolable(boolean poolable) throws SQLException { + callableStatement.setPoolable(poolable); + } + + @Override + public boolean isPoolable() throws SQLException { + return callableStatement.isPoolable(); + } + + @Override + public void closeOnCompletion() throws SQLException { + callableStatement.closeOnCompletion(); + } + + @Override + public boolean isCloseOnCompletion() throws SQLException { + return callableStatement.isCloseOnCompletion(); + } + + @Override + public long getLargeUpdateCount() throws SQLException { + return callableStatement.getLargeUpdateCount(); + } + + @Override + public void setLargeMaxRows(long max) throws SQLException { + callableStatement.setLargeMaxRows(max); + } + + @Override + public long getLargeMaxRows() throws SQLException { + return callableStatement.getLargeMaxRows(); + } + + @Override + public long[] executeLargeBatch() throws SQLException { + return callableStatement.executeLargeBatch(); + } + + @Override + public long executeLargeUpdate(String sql) throws SQLException { + this.interceptState = SQLRunningContext.getInstance().intercept(sql); + return callableStatement.executeLargeUpdate(interceptState.getSql()); + } + + @Override + public long executeLargeUpdate(String sql, int autoGeneratedKeys) throws SQLException { + this.interceptState = SQLRunningContext.getInstance().intercept(sql); + return callableStatement.executeLargeUpdate(interceptState.getSql(), autoGeneratedKeys); + } + + @Override + public long executeLargeUpdate(String sql, int[] columnIndexes) throws SQLException { + this.interceptState = SQLRunningContext.getInstance().intercept(sql); + return callableStatement.executeLargeUpdate(interceptState.getSql(), columnIndexes); + } + + @Override + public long executeLargeUpdate(String sql, String[] columnNames) throws SQLException { + this.interceptState = SQLRunningContext.getInstance().intercept(sql); + return callableStatement.executeLargeUpdate(interceptState.getSql(), columnNames); + } + + + @Override + public T unwrap(Class iface) throws SQLException { + return callableStatement.unwrap(iface); + } + + @Override + public boolean isWrapperFor(Class iface) throws SQLException { + return callableStatement.isWrapperFor(iface); + } +} diff --git a/springboot-starter-data-authorization/src/main/java/com/codingapi/springboot/authorization/jdbc/proxy/ConnectionProxy.java b/springboot-starter-data-authorization/src/main/java/com/codingapi/springboot/authorization/jdbc/proxy/ConnectionProxy.java new file mode 100644 index 000000000..75620f947 --- /dev/null +++ b/springboot-starter-data-authorization/src/main/java/com/codingapi/springboot/authorization/jdbc/proxy/ConnectionProxy.java @@ -0,0 +1,300 @@ +package com.codingapi.springboot.authorization.jdbc.proxy; + +import com.codingapi.springboot.authorization.interceptor.SQLExecuteState; +import com.codingapi.springboot.authorization.interceptor.SQLRunningContext; + +import java.sql.*; +import java.util.Map; +import java.util.Properties; +import java.util.concurrent.Executor; + +public class ConnectionProxy implements Connection { + + private final Connection connection; + + public ConnectionProxy(Connection connection) { + this.connection = connection; + } + + private SQLExecuteState interceptState; + + @Override + public Statement createStatement() throws SQLException { + return new StatementProxy(connection.createStatement(), interceptState); + } + + @Override + public PreparedStatement prepareStatement(String sql) throws SQLException { + this.interceptState = SQLRunningContext.getInstance().intercept(sql); + return new PreparedStatementProxy(connection.prepareStatement(interceptState.getSql()),interceptState); + } + + @Override + public CallableStatement prepareCall(String sql) throws SQLException { + this.interceptState = SQLRunningContext.getInstance().intercept(sql); + return new CallableStatementProxy(connection.prepareCall(interceptState.getSql()), interceptState); + } + + @Override + public String nativeSQL(String sql) throws SQLException { + this.interceptState = SQLRunningContext.getInstance().intercept(sql); + return connection.nativeSQL(interceptState.getSql()); + } + + @Override + public void setAutoCommit(boolean autoCommit) throws SQLException { + connection.setAutoCommit(autoCommit); + } + + @Override + public boolean getAutoCommit() throws SQLException { + return connection.getAutoCommit(); + } + + @Override + public void commit() throws SQLException { + connection.commit(); + } + + @Override + public void rollback() throws SQLException { + connection.rollback(); + } + + @Override + public void close() throws SQLException { + connection.close(); + } + + @Override + public boolean isClosed() throws SQLException { + return connection.isClosed(); + } + + @Override + public DatabaseMetaData getMetaData() throws SQLException { + return connection.getMetaData(); + } + + @Override + public void setReadOnly(boolean readOnly) throws SQLException { + connection.setReadOnly(readOnly); + } + + @Override + public boolean isReadOnly() throws SQLException { + return connection.isReadOnly(); + } + + @Override + public void setCatalog(String catalog) throws SQLException { + connection.setCatalog(catalog); + } + + @Override + public String getCatalog() throws SQLException { + return connection.getCatalog(); + } + + @Override + public void setTransactionIsolation(int level) throws SQLException { + connection.setTransactionIsolation(level); + } + + @Override + public int getTransactionIsolation() throws SQLException { + return connection.getTransactionIsolation(); + } + + @Override + public SQLWarning getWarnings() throws SQLException { + return connection.getWarnings(); + } + + @Override + public void clearWarnings() throws SQLException { + connection.clearWarnings(); + } + + @Override + public Statement createStatement(int resultSetType, int resultSetConcurrency) throws SQLException { + return new StatementProxy(connection.createStatement(resultSetType, resultSetConcurrency),this.interceptState); + } + + @Override + public PreparedStatement prepareStatement(String sql, int resultSetType, int resultSetConcurrency) throws SQLException { + this.interceptState = SQLRunningContext.getInstance().intercept(sql); + return new PreparedStatementProxy(connection.prepareStatement(interceptState.getSql(), resultSetType, resultSetConcurrency),interceptState); + } + + @Override + public CallableStatement prepareCall(String sql, int resultSetType, int resultSetConcurrency) throws SQLException { + this.interceptState = SQLRunningContext.getInstance().intercept(sql); + return new CallableStatementProxy(connection.prepareCall(interceptState.getSql(), resultSetType, resultSetConcurrency),interceptState); + } + + @Override + public Map> getTypeMap() throws SQLException { + return connection.getTypeMap(); + } + + @Override + public void setTypeMap(Map> map) throws SQLException { + connection.setTypeMap(map); + } + + @Override + public void setHoldability(int holdability) throws SQLException { + connection.setHoldability(holdability); + } + + @Override + public int getHoldability() throws SQLException { + return connection.getHoldability(); + } + + @Override + public Savepoint setSavepoint() throws SQLException { + return connection.setSavepoint(); + } + + @Override + public Savepoint setSavepoint(String name) throws SQLException { + return connection.setSavepoint(name); + } + + @Override + public void rollback(Savepoint savepoint) throws SQLException { + connection.rollback(savepoint); + } + + @Override + public void releaseSavepoint(Savepoint savepoint) throws SQLException { + connection.releaseSavepoint(savepoint); + } + + @Override + public Statement createStatement(int resultSetType, int resultSetConcurrency, int resultSetHoldability) throws SQLException { + return new StatementProxy(connection.createStatement(resultSetType, resultSetConcurrency, resultSetHoldability),interceptState); + } + + @Override + public PreparedStatement prepareStatement(String sql, int resultSetType, int resultSetConcurrency, int resultSetHoldability) throws SQLException { + this.interceptState = SQLRunningContext.getInstance().intercept(sql); + return new PreparedStatementProxy(connection.prepareStatement(interceptState.getSql(), resultSetType, resultSetConcurrency, resultSetHoldability),interceptState); + } + + @Override + public CallableStatement prepareCall(String sql, int resultSetType, int resultSetConcurrency, int resultSetHoldability) throws SQLException { + this.interceptState = SQLRunningContext.getInstance().intercept(sql); + return new CallableStatementProxy(connection.prepareCall(interceptState.getSql(), resultSetType, resultSetConcurrency, resultSetHoldability),interceptState); + } + + @Override + public PreparedStatement prepareStatement(String sql, int autoGeneratedKeys) throws SQLException { + this.interceptState = SQLRunningContext.getInstance().intercept(sql); + return new PreparedStatementProxy(connection.prepareStatement(interceptState.getSql(), autoGeneratedKeys),interceptState); + } + + @Override + public PreparedStatement prepareStatement(String sql, int[] columnIndexes) throws SQLException { + this.interceptState = SQLRunningContext.getInstance().intercept(sql); + return new PreparedStatementProxy(connection.prepareStatement(interceptState.getSql(), columnIndexes),interceptState); + } + + @Override + public PreparedStatement prepareStatement(String sql, String[] columnNames) throws SQLException { + this.interceptState = SQLRunningContext.getInstance().intercept(sql); + return new PreparedStatementProxy(connection.prepareStatement(interceptState.getSql(), columnNames),interceptState); + } + + @Override + public Clob createClob() throws SQLException { + return connection.createClob(); + } + + @Override + public Blob createBlob() throws SQLException { + return connection.createBlob(); + } + + @Override + public NClob createNClob() throws SQLException { + return connection.createNClob(); + } + + @Override + public SQLXML createSQLXML() throws SQLException { + return connection.createSQLXML(); + } + + @Override + public boolean isValid(int timeout) throws SQLException { + return connection.isValid(timeout); + } + + @Override + public void setClientInfo(String name, String value) throws SQLClientInfoException { + connection.setClientInfo(name, value); + } + + @Override + public void setClientInfo(Properties properties) throws SQLClientInfoException { + connection.setClientInfo(properties); + } + + @Override + public String getClientInfo(String name) throws SQLException { + return connection.getClientInfo(name); + } + + @Override + public Properties getClientInfo() throws SQLException { + return connection.getClientInfo(); + } + + @Override + public Array createArrayOf(String typeName, Object[] elements) throws SQLException { + return connection.createArrayOf(typeName, elements); + } + + @Override + public Struct createStruct(String typeName, Object[] attributes) throws SQLException { + return connection.createStruct(typeName, attributes); + } + + @Override + public void setSchema(String schema) throws SQLException { + connection.setSchema(schema); + } + + @Override + public String getSchema() throws SQLException { + return connection.getSchema(); + } + + @Override + public void abort(Executor executor) throws SQLException { + connection.abort(executor); + } + + @Override + public void setNetworkTimeout(Executor executor, int milliseconds) throws SQLException { + connection.setNetworkTimeout(executor, milliseconds); + } + + @Override + public int getNetworkTimeout() throws SQLException { + return connection.getNetworkTimeout(); + } + + @Override + public T unwrap(Class iface) throws SQLException { + return connection.unwrap(iface); + } + + @Override + public boolean isWrapperFor(Class iface) throws SQLException { + return connection.isWrapperFor(iface); + } +} diff --git a/springboot-starter-data-authorization/src/main/java/com/codingapi/springboot/authorization/jdbc/proxy/PreparedStatementProxy.java b/springboot-starter-data-authorization/src/main/java/com/codingapi/springboot/authorization/jdbc/proxy/PreparedStatementProxy.java new file mode 100644 index 000000000..99df3bc74 --- /dev/null +++ b/springboot-starter-data-authorization/src/main/java/com/codingapi/springboot/authorization/jdbc/proxy/PreparedStatementProxy.java @@ -0,0 +1,585 @@ +package com.codingapi.springboot.authorization.jdbc.proxy; + +import com.codingapi.springboot.authorization.interceptor.SQLExecuteState; +import com.codingapi.springboot.authorization.interceptor.SQLRunningContext; +import lombok.AllArgsConstructor; + +import java.io.InputStream; +import java.io.Reader; +import java.math.BigDecimal; +import java.net.URL; +import java.sql.*; +import java.util.Calendar; + +@AllArgsConstructor +public class PreparedStatementProxy implements PreparedStatement { + + private final PreparedStatement preparedStatement; + + private SQLExecuteState interceptState; + + + @Override + public ResultSet executeQuery() throws SQLException { + return new ResultSetProxy(preparedStatement.executeQuery(),interceptState); + } + + @Override + public int executeUpdate() throws SQLException { + return preparedStatement.executeUpdate(); + } + + @Override + public void setNull(int parameterIndex, int sqlType) throws SQLException { + preparedStatement.setNull(parameterIndex, sqlType); + } + + @Override + public void setBoolean(int parameterIndex, boolean x) throws SQLException { + preparedStatement.setBoolean(parameterIndex, x); + } + + @Override + public void setByte(int parameterIndex, byte x) throws SQLException { + preparedStatement.setByte(parameterIndex, x); + } + + @Override + public void setShort(int parameterIndex, short x) throws SQLException { + preparedStatement.setShort(parameterIndex, x); + } + + @Override + public void setInt(int parameterIndex, int x) throws SQLException { + preparedStatement.setInt(parameterIndex, x); + } + + @Override + public void setLong(int parameterIndex, long x) throws SQLException { + preparedStatement.setLong(parameterIndex, x); + } + + @Override + public void setFloat(int parameterIndex, float x) throws SQLException { + preparedStatement.setFloat(parameterIndex, x); + } + + @Override + public void setDouble(int parameterIndex, double x) throws SQLException { + preparedStatement.setDouble(parameterIndex, x); + } + + @Override + public void setBigDecimal(int parameterIndex, BigDecimal x) throws SQLException { + preparedStatement.setBigDecimal(parameterIndex, x); + } + + @Override + public void setString(int parameterIndex, String x) throws SQLException { + preparedStatement.setString(parameterIndex, x); + } + + @Override + public void setBytes(int parameterIndex, byte[] x) throws SQLException { + preparedStatement.setBytes(parameterIndex, x); + } + + @Override + public void setDate(int parameterIndex, Date x) throws SQLException { + preparedStatement.setDate(parameterIndex, x); + } + + @Override + public void setTime(int parameterIndex, Time x) throws SQLException { + preparedStatement.setTime(parameterIndex, x); + } + + @Override + public void setTimestamp(int parameterIndex, Timestamp x) throws SQLException { + preparedStatement.setTimestamp(parameterIndex, x); + } + + @Override + public void setAsciiStream(int parameterIndex, InputStream x, int length) throws SQLException { + preparedStatement.setAsciiStream(parameterIndex, x, length); + } + + @Override + public void setUnicodeStream(int parameterIndex, InputStream x, int length) throws SQLException { + preparedStatement.setUnicodeStream(parameterIndex, x, length); + } + + @Override + public void setBinaryStream(int parameterIndex, InputStream x, int length) throws SQLException { + preparedStatement.setBinaryStream(parameterIndex, x, length); + } + + @Override + public void clearParameters() throws SQLException { + preparedStatement.clearParameters(); + } + + @Override + public void setObject(int parameterIndex, Object x, int targetSqlType) throws SQLException { + preparedStatement.setObject(parameterIndex, x, targetSqlType); + } + + @Override + public void setObject(int parameterIndex, Object x) throws SQLException { + preparedStatement.setObject(parameterIndex, x); + } + + @Override + public boolean execute() throws SQLException { + return preparedStatement.execute(); + } + + @Override + public void addBatch() throws SQLException { + preparedStatement.addBatch(); + } + + @Override + public void setCharacterStream(int parameterIndex, Reader reader, int length) throws SQLException { + preparedStatement.setCharacterStream(parameterIndex, reader, length); + } + + @Override + public void setRef(int parameterIndex, Ref x) throws SQLException { + preparedStatement.setRef(parameterIndex, x); + } + + @Override + public void setBlob(int parameterIndex, Blob x) throws SQLException { + preparedStatement.setBlob(parameterIndex, x); + } + + @Override + public void setClob(int parameterIndex, Clob x) throws SQLException { + preparedStatement.setClob(parameterIndex, x); + } + + @Override + public void setArray(int parameterIndex, Array x) throws SQLException { + preparedStatement.setArray(parameterIndex, x); + } + + @Override + public ResultSetMetaData getMetaData() throws SQLException { + return preparedStatement.getMetaData(); + } + + @Override + public void setDate(int parameterIndex, Date x, Calendar cal) throws SQLException { + preparedStatement.setDate(parameterIndex, x, cal); + } + + @Override + public void setTime(int parameterIndex, Time x, Calendar cal) throws SQLException { + preparedStatement.setTime(parameterIndex, x, cal); + } + + @Override + public void setTimestamp(int parameterIndex, Timestamp x, Calendar cal) throws SQLException { + preparedStatement.setTimestamp(parameterIndex, x, cal); + } + + @Override + public void setNull(int parameterIndex, int sqlType, String typeName) throws SQLException { + preparedStatement.setNull(parameterIndex, sqlType, typeName); + } + + @Override + public void setURL(int parameterIndex, URL x) throws SQLException { + preparedStatement.setURL(parameterIndex, x); + } + + @Override + public ParameterMetaData getParameterMetaData() throws SQLException { + return preparedStatement.getParameterMetaData(); + } + + @Override + public void setRowId(int parameterIndex, RowId x) throws SQLException { + preparedStatement.setRowId(parameterIndex, x); + } + + @Override + public void setNString(int parameterIndex, String value) throws SQLException { + preparedStatement.setNString(parameterIndex, value); + } + + @Override + public void setNCharacterStream(int parameterIndex, Reader value, long length) throws SQLException { + preparedStatement.setNCharacterStream(parameterIndex, value, length); + } + + @Override + public void setNClob(int parameterIndex, NClob value) throws SQLException { + preparedStatement.setNClob(parameterIndex, value); + } + + @Override + public void setClob(int parameterIndex, Reader reader, long length) throws SQLException { + preparedStatement.setClob(parameterIndex, reader, length); + } + + @Override + public void setBlob(int parameterIndex, InputStream inputStream, long length) throws SQLException { + preparedStatement.setBlob(parameterIndex, inputStream, length); + } + + @Override + public void setNClob(int parameterIndex, Reader reader, long length) throws SQLException { + preparedStatement.setNClob(parameterIndex, reader, length); + } + + @Override + public void setSQLXML(int parameterIndex, SQLXML xmlObject) throws SQLException { + preparedStatement.setSQLXML(parameterIndex, xmlObject); + } + + @Override + public void setObject(int parameterIndex, Object x, int targetSqlType, int scaleOrLength) throws SQLException { + preparedStatement.setObject(parameterIndex, x, targetSqlType, scaleOrLength); + } + + @Override + public void setAsciiStream(int parameterIndex, InputStream x, long length) throws SQLException { + preparedStatement.setAsciiStream(parameterIndex, x, length); + } + + @Override + public void setBinaryStream(int parameterIndex, InputStream x, long length) throws SQLException { + preparedStatement.setBinaryStream(parameterIndex, x, length); + } + + @Override + public void setCharacterStream(int parameterIndex, Reader reader, long length) throws SQLException { + preparedStatement.setCharacterStream(parameterIndex, reader, length); + } + + @Override + public void setAsciiStream(int parameterIndex, InputStream x) throws SQLException { + preparedStatement.setAsciiStream(parameterIndex, x); + } + + @Override + public void setBinaryStream(int parameterIndex, InputStream x) throws SQLException { + preparedStatement.setBinaryStream(parameterIndex, x); + } + + @Override + public void setCharacterStream(int parameterIndex, Reader reader) throws SQLException { + preparedStatement.setCharacterStream(parameterIndex, reader); + } + + @Override + public void setNCharacterStream(int parameterIndex, Reader value) throws SQLException { + preparedStatement.setNCharacterStream(parameterIndex, value); + } + + @Override + public void setClob(int parameterIndex, Reader reader) throws SQLException { + preparedStatement.setClob(parameterIndex, reader); + } + + @Override + public void setBlob(int parameterIndex, InputStream inputStream) throws SQLException { + preparedStatement.setBlob(parameterIndex, inputStream); + } + + @Override + public void setNClob(int parameterIndex, Reader reader) throws SQLException { + preparedStatement.setNClob(parameterIndex, reader); + } + + @Override + public void setObject(int parameterIndex, Object x, SQLType targetSqlType, int scaleOrLength) throws SQLException { + preparedStatement.setObject(parameterIndex, x, targetSqlType, scaleOrLength); + } + + @Override + public void setObject(int parameterIndex, Object x, SQLType targetSqlType) throws SQLException { + preparedStatement.setObject(parameterIndex, x, targetSqlType); + } + + @Override + public long executeLargeUpdate() throws SQLException { + return preparedStatement.executeLargeUpdate(); + } + + @Override + public ResultSet executeQuery(String sql) throws SQLException { + this.interceptState = SQLRunningContext.getInstance().intercept(sql); + return new ResultSetProxy(preparedStatement.executeQuery(interceptState.getSql()),interceptState); + } + + @Override + public int executeUpdate(String sql) throws SQLException { + this.interceptState = SQLRunningContext.getInstance().intercept(sql); + return preparedStatement.executeUpdate(interceptState.getSql()); + } + + @Override + public void close() throws SQLException { + preparedStatement.close(); + } + + @Override + public int getMaxFieldSize() throws SQLException { + return preparedStatement.getMaxFieldSize(); + } + + @Override + public void setMaxFieldSize(int max) throws SQLException { + preparedStatement.setMaxFieldSize(max); + } + + @Override + public int getMaxRows() throws SQLException { + return preparedStatement.getMaxRows(); + } + + @Override + public void setMaxRows(int max) throws SQLException { + preparedStatement.setMaxRows(max); + } + + @Override + public void setEscapeProcessing(boolean enable) throws SQLException { + preparedStatement.setEscapeProcessing(enable); + } + + @Override + public int getQueryTimeout() throws SQLException { + return preparedStatement.getQueryTimeout(); + } + + @Override + public void setQueryTimeout(int seconds) throws SQLException { + preparedStatement.setQueryTimeout(seconds); + } + + @Override + public void cancel() throws SQLException { + preparedStatement.cancel(); + } + + @Override + public SQLWarning getWarnings() throws SQLException { + return preparedStatement.getWarnings(); + } + + @Override + public void clearWarnings() throws SQLException { + preparedStatement.clearWarnings(); + } + + @Override + public void setCursorName(String name) throws SQLException { + preparedStatement.setCursorName(name); + } + + @Override + public boolean execute(String sql) throws SQLException { + this.interceptState = SQLRunningContext.getInstance().intercept(sql); + return preparedStatement.execute(interceptState.getSql()); + } + + @Override + public ResultSet getResultSet() throws SQLException { + return new ResultSetProxy(preparedStatement.getResultSet(),interceptState); + } + + @Override + public int getUpdateCount() throws SQLException { + return preparedStatement.getUpdateCount(); + } + + @Override + public boolean getMoreResults() throws SQLException { + return preparedStatement.getMoreResults(); + } + + @Override + public void setFetchDirection(int direction) throws SQLException { + preparedStatement.setFetchDirection(direction); + } + + @Override + public int getFetchDirection() throws SQLException { + return preparedStatement.getFetchDirection(); + } + + @Override + public void setFetchSize(int rows) throws SQLException { + preparedStatement.setFetchSize(rows); + } + + @Override + public int getFetchSize() throws SQLException { + return preparedStatement.getFetchSize(); + } + + @Override + public int getResultSetConcurrency() throws SQLException { + return preparedStatement.getResultSetConcurrency(); + } + + @Override + public int getResultSetType() throws SQLException { + return preparedStatement.getResultSetType(); + } + + @Override + public void addBatch(String sql) throws SQLException { + this.interceptState = SQLRunningContext.getInstance().intercept(sql); + preparedStatement.addBatch(interceptState.getSql()); + } + + @Override + public void clearBatch() throws SQLException { + preparedStatement.clearBatch(); + } + + @Override + public int[] executeBatch() throws SQLException { + return preparedStatement.executeBatch(); + } + + @Override + public Connection getConnection() throws SQLException { + return new ConnectionProxy(preparedStatement.getConnection()); + } + + @Override + public boolean getMoreResults(int current) throws SQLException { + return preparedStatement.getMoreResults(current); + } + + @Override + public ResultSet getGeneratedKeys() throws SQLException { + return new ResultSetProxy(preparedStatement.getGeneratedKeys(),interceptState); + } + + @Override + public int executeUpdate(String sql, int autoGeneratedKeys) throws SQLException { + this.interceptState = SQLRunningContext.getInstance().intercept(sql); + return preparedStatement.executeUpdate(interceptState.getSql(), autoGeneratedKeys); + } + + @Override + public int executeUpdate(String sql, int[] columnIndexes) throws SQLException { + this.interceptState = SQLRunningContext.getInstance().intercept(sql); + return preparedStatement.executeUpdate(interceptState.getSql(), columnIndexes); + } + + @Override + public int executeUpdate(String sql, String[] columnNames) throws SQLException { + this.interceptState = SQLRunningContext.getInstance().intercept(sql); + return preparedStatement.executeUpdate(interceptState.getSql(), columnNames); + } + + @Override + public boolean execute(String sql, int autoGeneratedKeys) throws SQLException { + this.interceptState = SQLRunningContext.getInstance().intercept(sql); + return preparedStatement.execute(interceptState.getSql(), autoGeneratedKeys); + } + + @Override + public boolean execute(String sql, int[] columnIndexes) throws SQLException { + this.interceptState = SQLRunningContext.getInstance().intercept(sql); + return preparedStatement.execute(interceptState.getSql(), columnIndexes); + } + + @Override + public boolean execute(String sql, String[] columnNames) throws SQLException { + this.interceptState = SQLRunningContext.getInstance().intercept(sql); + return preparedStatement.execute(interceptState.getSql(), columnNames); + } + + @Override + public int getResultSetHoldability() throws SQLException { + return preparedStatement.getResultSetHoldability(); + } + + @Override + public boolean isClosed() throws SQLException { + return preparedStatement.isClosed(); + } + + @Override + public void setPoolable(boolean poolable) throws SQLException { + preparedStatement.setPoolable(poolable); + } + + @Override + public boolean isPoolable() throws SQLException { + return preparedStatement.isPoolable(); + } + + @Override + public void closeOnCompletion() throws SQLException { + preparedStatement.closeOnCompletion(); + } + + @Override + public boolean isCloseOnCompletion() throws SQLException { + return preparedStatement.isCloseOnCompletion(); + } + + @Override + public long getLargeUpdateCount() throws SQLException { + return preparedStatement.getLargeUpdateCount(); + } + + @Override + public void setLargeMaxRows(long max) throws SQLException { + preparedStatement.setLargeMaxRows(max); + } + + @Override + public long getLargeMaxRows() throws SQLException { + return preparedStatement.getLargeMaxRows(); + } + + @Override + public long[] executeLargeBatch() throws SQLException { + return preparedStatement.executeLargeBatch(); + } + + @Override + public long executeLargeUpdate(String sql) throws SQLException { + this.interceptState = SQLRunningContext.getInstance().intercept(sql); + return preparedStatement.executeLargeUpdate(interceptState.getSql()); + } + + @Override + public long executeLargeUpdate(String sql, int autoGeneratedKeys) throws SQLException { + this.interceptState = SQLRunningContext.getInstance().intercept(sql); + return preparedStatement.executeLargeUpdate(interceptState.getSql(), autoGeneratedKeys); + } + + @Override + public long executeLargeUpdate(String sql, int[] columnIndexes) throws SQLException { + this.interceptState = SQLRunningContext.getInstance().intercept(sql); + return preparedStatement.executeLargeUpdate(interceptState.getSql(), columnIndexes); + } + + @Override + public long executeLargeUpdate(String sql, String[] columnNames) throws SQLException { + this.interceptState = SQLRunningContext.getInstance().intercept(sql); + return preparedStatement.executeLargeUpdate(interceptState.getSql(), columnNames); + } + + @Override + public T unwrap(Class iface) throws SQLException { + return preparedStatement.unwrap(iface); + } + + @Override + public boolean isWrapperFor(Class iface) throws SQLException { + return preparedStatement.isWrapperFor(iface); + } +} diff --git a/springboot-starter-data-authorization/src/main/java/com/codingapi/springboot/authorization/jdbc/proxy/ResultSetProxy.java b/springboot-starter-data-authorization/src/main/java/com/codingapi/springboot/authorization/jdbc/proxy/ResultSetProxy.java new file mode 100644 index 000000000..293e78cc4 --- /dev/null +++ b/springboot-starter-data-authorization/src/main/java/com/codingapi/springboot/authorization/jdbc/proxy/ResultSetProxy.java @@ -0,0 +1,1180 @@ +package com.codingapi.springboot.authorization.jdbc.proxy; + +import com.codingapi.springboot.authorization.handler.ColumnHandlerContext; +import com.codingapi.springboot.authorization.interceptor.SQLExecuteState; +import lombok.extern.slf4j.Slf4j; + +import java.io.InputStream; +import java.io.Reader; +import java.math.BigDecimal; +import java.net.URL; +import java.sql.*; +import java.util.Calendar; +import java.util.HashMap; +import java.util.Map; + +@Slf4j +public class ResultSetProxy implements ResultSet { + + private final ResultSet resultSet; + private final ResultSetMetaData metaData; + private final SQLExecuteState interceptState; + + private final Map columnLabelMap = new HashMap<>(); + + public ResultSetProxy(ResultSet resultSet, SQLExecuteState interceptState) throws SQLException { + this.resultSet = resultSet; + this.metaData = resultSet.getMetaData(); + this.interceptState = interceptState; + int columnCount = metaData.getColumnCount(); + for (int i = 1; i <= columnCount; i++) { + String columnLabel = metaData.getColumnLabel(i); + columnLabelMap.put(columnLabel.toUpperCase(), i); + } + } + + @Override + public boolean next() throws SQLException { + return resultSet.next(); + } + + @Override + public void close() throws SQLException { + resultSet.close(); + } + + @Override + public boolean wasNull() throws SQLException { + return resultSet.wasNull(); + } + + @Override + public String getString(int columnIndex) throws SQLException { + String tableName = metaData.getTableName(columnIndex); + String columnName = metaData.getColumnName(columnIndex); + return ColumnHandlerContext.getInstance().getString(interceptState, columnIndex, tableName, columnName, resultSet.getString(columnIndex)); + } + + @Override + public boolean getBoolean(int columnIndex) throws SQLException { + String tableName = metaData.getTableName(columnIndex); + String columnName = metaData.getColumnName(columnIndex); + return ColumnHandlerContext.getInstance().getBoolean(interceptState, columnIndex, tableName, columnName, resultSet.getBoolean(columnIndex)); + } + + @Override + public byte getByte(int columnIndex) throws SQLException { + String tableName = metaData.getTableName(columnIndex); + String columnName = metaData.getColumnName(columnIndex); + return ColumnHandlerContext.getInstance().getByte(interceptState, columnIndex, tableName, columnName, resultSet.getByte(columnIndex)); + } + + @Override + public short getShort(int columnIndex) throws SQLException { + String tableName = metaData.getTableName(columnIndex); + String columnName = metaData.getColumnName(columnIndex); + return ColumnHandlerContext.getInstance().getShort(interceptState, columnIndex, tableName, columnName, resultSet.getShort(columnIndex)); + } + + @Override + public int getInt(int columnIndex) throws SQLException { + String tableName = metaData.getTableName(columnIndex); + String columnName = metaData.getColumnName(columnIndex); + return ColumnHandlerContext.getInstance().getInt(interceptState, columnIndex, tableName, columnName, resultSet.getInt(columnIndex)); + } + + @Override + public long getLong(int columnIndex) throws SQLException { + String tableName = metaData.getTableName(columnIndex); + String columnName = metaData.getColumnName(columnIndex); + return ColumnHandlerContext.getInstance().getLong(interceptState, columnIndex, tableName, columnName, resultSet.getLong(columnIndex)); + } + + @Override + public float getFloat(int columnIndex) throws SQLException { + String tableName = metaData.getTableName(columnIndex); + String columnName = metaData.getColumnName(columnIndex); + return ColumnHandlerContext.getInstance().getFloat(interceptState, columnIndex, tableName, columnName, resultSet.getFloat(columnIndex)); + } + + @Override + public double getDouble(int columnIndex) throws SQLException { + String tableName = metaData.getTableName(columnIndex); + String columnName = metaData.getColumnName(columnIndex); + return ColumnHandlerContext.getInstance().getDouble(interceptState, columnIndex, tableName, columnName, resultSet.getDouble(columnIndex)); + } + + @Override + public BigDecimal getBigDecimal(int columnIndex, int scale) throws SQLException { + String tableName = metaData.getTableName(columnIndex); + String columnName = metaData.getColumnName(columnIndex); + return ColumnHandlerContext.getInstance().getBigDecimal(interceptState, columnIndex, tableName, columnName, resultSet.getBigDecimal(columnIndex, scale)); + } + + @Override + public byte[] getBytes(int columnIndex) throws SQLException { + String tableName = metaData.getTableName(columnIndex); + String columnName = metaData.getColumnName(columnIndex); + return ColumnHandlerContext.getInstance().getBytes(interceptState, columnIndex, tableName, columnName, resultSet.getBytes(columnIndex)); + } + + @Override + public Date getDate(int columnIndex) throws SQLException { + String tableName = metaData.getTableName(columnIndex); + String columnName = metaData.getColumnName(columnIndex); + return ColumnHandlerContext.getInstance().getDate(interceptState, columnIndex, tableName, columnName, resultSet.getDate(columnIndex)); + } + + @Override + public Time getTime(int columnIndex) throws SQLException { + String tableName = metaData.getTableName(columnIndex); + String columnName = metaData.getColumnName(columnIndex); + return ColumnHandlerContext.getInstance().getTime(interceptState, columnIndex, tableName, columnName, resultSet.getTime(columnIndex)); + } + + @Override + public Timestamp getTimestamp(int columnIndex) throws SQLException { + String tableName = metaData.getTableName(columnIndex); + String columnName = metaData.getColumnName(columnIndex); + return ColumnHandlerContext.getInstance().getTimestamp(interceptState, columnIndex, tableName, columnName, resultSet.getTimestamp(columnIndex)); + } + + @Override + public InputStream getAsciiStream(int columnIndex) throws SQLException { + String tableName = metaData.getTableName(columnIndex); + String columnName = metaData.getColumnName(columnIndex); + return ColumnHandlerContext.getInstance().getAsciiStream(interceptState, columnIndex, tableName, columnName, resultSet.getAsciiStream(columnIndex)); + } + + @Override + public InputStream getUnicodeStream(int columnIndex) throws SQLException { + String tableName = metaData.getTableName(columnIndex); + String columnName = metaData.getColumnName(columnIndex); + return ColumnHandlerContext.getInstance().getUnicodeStream(interceptState, columnIndex, tableName, columnName, resultSet.getUnicodeStream(columnIndex)); + } + + @Override + public InputStream getBinaryStream(int columnIndex) throws SQLException { + String tableName = metaData.getTableName(columnIndex); + String columnName = metaData.getColumnName(columnIndex); + return ColumnHandlerContext.getInstance().getBinaryStream(interceptState, columnIndex, tableName, columnName, resultSet.getBinaryStream(columnIndex)); + } + + @Override + public String getString(String columnLabel) throws SQLException { + int columnIndex = columnLabelMap.get(columnLabel.toUpperCase()); + String tableName = metaData.getTableName(columnIndex); + String columnName = metaData.getColumnName(columnIndex); + return ColumnHandlerContext.getInstance().getString(interceptState, columnIndex, tableName, columnName, resultSet.getString(columnIndex)); + } + + @Override + public boolean getBoolean(String columnLabel) throws SQLException { + int columnIndex = columnLabelMap.get(columnLabel.toUpperCase()); + String tableName = metaData.getTableName(columnIndex); + String columnName = metaData.getColumnName(columnIndex); + return ColumnHandlerContext.getInstance().getBoolean(interceptState, columnIndex, tableName, columnName, resultSet.getBoolean(columnIndex)); + } + + @Override + public byte getByte(String columnLabel) throws SQLException { + int columnIndex = columnLabelMap.get(columnLabel.toUpperCase()); + String tableName = metaData.getTableName(columnIndex); + String columnName = metaData.getColumnName(columnIndex); + return ColumnHandlerContext.getInstance().getByte(interceptState, columnIndex, tableName, columnName, resultSet.getByte(columnIndex)); + } + + @Override + public short getShort(String columnLabel) throws SQLException { + int columnIndex = columnLabelMap.get(columnLabel.toUpperCase()); + String tableName = metaData.getTableName(columnIndex); + String columnName = metaData.getColumnName(columnIndex); + return ColumnHandlerContext.getInstance().getShort(interceptState, columnIndex, tableName, columnName, resultSet.getShort(columnIndex)); + } + + @Override + public int getInt(String columnLabel) throws SQLException { + int columnIndex = columnLabelMap.get(columnLabel.toUpperCase()); + String tableName = metaData.getTableName(columnIndex); + String columnName = metaData.getColumnName(columnIndex); + return ColumnHandlerContext.getInstance().getInt(interceptState, columnIndex, tableName, columnName, resultSet.getInt(columnIndex)); + } + + @Override + public long getLong(String columnLabel) throws SQLException { + int columnIndex = columnLabelMap.get(columnLabel.toUpperCase()); + String tableName = metaData.getTableName(columnIndex); + String columnName = metaData.getColumnName(columnIndex); + return ColumnHandlerContext.getInstance().getLong(interceptState, columnIndex, tableName, columnName, resultSet.getLong(columnIndex)); + } + + @Override + public float getFloat(String columnLabel) throws SQLException { + int columnIndex = columnLabelMap.get(columnLabel.toUpperCase()); + String tableName = metaData.getTableName(columnIndex); + String columnName = metaData.getColumnName(columnIndex); + return ColumnHandlerContext.getInstance().getFloat(interceptState, columnIndex, tableName, columnName, resultSet.getFloat(columnIndex)); + } + + @Override + public double getDouble(String columnLabel) throws SQLException { + int columnIndex = columnLabelMap.get(columnLabel.toUpperCase()); + String tableName = metaData.getTableName(columnIndex); + String columnName = metaData.getColumnName(columnIndex); + return ColumnHandlerContext.getInstance().getDouble(interceptState, columnIndex, tableName, columnName, resultSet.getDouble(columnIndex)); + } + + @Override + public BigDecimal getBigDecimal(String columnLabel, int scale) throws SQLException { + int columnIndex = columnLabelMap.get(columnLabel.toUpperCase()); + String tableName = metaData.getTableName(columnIndex); + String columnName = metaData.getColumnName(columnIndex); + return ColumnHandlerContext.getInstance().getBigDecimal(interceptState, columnIndex, tableName, columnName, resultSet.getBigDecimal(columnIndex, scale)); + } + + @Override + public byte[] getBytes(String columnLabel) throws SQLException { + int columnIndex = columnLabelMap.get(columnLabel.toUpperCase()); + String tableName = metaData.getTableName(columnIndex); + String columnName = metaData.getColumnName(columnIndex); + return ColumnHandlerContext.getInstance().getBytes(interceptState, columnIndex, tableName, columnName, resultSet.getBytes(columnIndex)); + } + + @Override + public Date getDate(String columnLabel) throws SQLException { + int columnIndex = columnLabelMap.get(columnLabel.toUpperCase()); + String tableName = metaData.getTableName(columnIndex); + String columnName = metaData.getColumnName(columnIndex); + return ColumnHandlerContext.getInstance().getDate(interceptState, columnIndex, tableName, columnName, resultSet.getDate(columnIndex)); + } + + @Override + public Time getTime(String columnLabel) throws SQLException { + int columnIndex = columnLabelMap.get(columnLabel.toUpperCase()); + String tableName = metaData.getTableName(columnIndex); + String columnName = metaData.getColumnName(columnIndex); + return ColumnHandlerContext.getInstance().getTime(interceptState, columnIndex, tableName, columnName, resultSet.getTime(columnIndex)); + } + + @Override + public Timestamp getTimestamp(String columnLabel) throws SQLException { + int columnIndex = columnLabelMap.get(columnLabel.toUpperCase()); + String tableName = metaData.getTableName(columnIndex); + String columnName = metaData.getColumnName(columnIndex); + return ColumnHandlerContext.getInstance().getTimestamp(interceptState, columnIndex, tableName, columnName, resultSet.getTimestamp(columnIndex)); + } + + @Override + public InputStream getAsciiStream(String columnLabel) throws SQLException { + int columnIndex = columnLabelMap.get(columnLabel.toUpperCase()); + String tableName = metaData.getTableName(columnIndex); + String columnName = metaData.getColumnName(columnIndex); + return ColumnHandlerContext.getInstance().getAsciiStream(interceptState, columnIndex, tableName, columnName, resultSet.getAsciiStream(columnIndex)); + } + + @Override + public InputStream getUnicodeStream(String columnLabel) throws SQLException { + int columnIndex = columnLabelMap.get(columnLabel.toUpperCase()); + String tableName = metaData.getTableName(columnIndex); + String columnName = metaData.getColumnName(columnIndex); + return ColumnHandlerContext.getInstance().getUnicodeStream(interceptState, columnIndex, tableName, columnName, resultSet.getUnicodeStream(columnIndex)); + } + + @Override + public InputStream getBinaryStream(String columnLabel) throws SQLException { + int columnIndex = columnLabelMap.get(columnLabel.toUpperCase()); + String tableName = metaData.getTableName(columnIndex); + String columnName = metaData.getColumnName(columnIndex); + return ColumnHandlerContext.getInstance().getBinaryStream(interceptState, columnIndex, tableName, columnName, resultSet.getBinaryStream(columnIndex)); + } + + @Override + public SQLWarning getWarnings() throws SQLException { + return resultSet.getWarnings(); + } + + @Override + public void clearWarnings() throws SQLException { + resultSet.clearWarnings(); + } + + @Override + public String getCursorName() throws SQLException { + return resultSet.getCursorName(); + } + + @Override + public ResultSetMetaData getMetaData() throws SQLException { + return resultSet.getMetaData(); + } + + @Override + public Object getObject(int columnIndex) throws SQLException { + String tableName = metaData.getTableName(columnIndex); + String columnName = metaData.getColumnName(columnIndex); + return ColumnHandlerContext.getInstance().getObject(interceptState, columnIndex, tableName, columnName, resultSet.getObject(columnIndex)); + } + + @Override + public Object getObject(String columnLabel) throws SQLException { + int columnIndex = columnLabelMap.get(columnLabel.toUpperCase()); + String tableName = metaData.getTableName(columnIndex); + String columnName = metaData.getColumnName(columnIndex); + return ColumnHandlerContext.getInstance().getObject(interceptState, columnIndex, tableName, columnName, resultSet.getObject(columnIndex)); + } + + @Override + public int findColumn(String columnLabel) throws SQLException { + return resultSet.findColumn(columnLabel); + } + + @Override + public Reader getCharacterStream(int columnIndex) throws SQLException { + String tableName = metaData.getTableName(columnIndex); + String columnName = metaData.getColumnName(columnIndex); + return ColumnHandlerContext.getInstance().getCharacterStream(interceptState, columnIndex, tableName, columnName, resultSet.getCharacterStream(columnIndex)); + } + + @Override + public Reader getCharacterStream(String columnLabel) throws SQLException { + int columnIndex = columnLabelMap.get(columnLabel.toUpperCase()); + String tableName = metaData.getTableName(columnIndex); + String columnName = metaData.getColumnName(columnIndex); + return ColumnHandlerContext.getInstance().getCharacterStream(interceptState, columnIndex, tableName, columnName, resultSet.getCharacterStream(columnIndex)); + } + + @Override + public BigDecimal getBigDecimal(int columnIndex) throws SQLException { + String tableName = metaData.getTableName(columnIndex); + String columnName = metaData.getColumnName(columnIndex); + return ColumnHandlerContext.getInstance().getBigDecimal(interceptState, columnIndex, tableName, columnName, resultSet.getBigDecimal(columnIndex)); + } + + @Override + public BigDecimal getBigDecimal(String columnLabel) throws SQLException { + int columnIndex = columnLabelMap.get(columnLabel.toUpperCase()); + String tableName = metaData.getTableName(columnIndex); + String columnName = metaData.getColumnName(columnIndex); + return ColumnHandlerContext.getInstance().getBigDecimal(interceptState, columnIndex, tableName, columnName, resultSet.getBigDecimal(columnIndex)); + } + + @Override + public boolean isBeforeFirst() throws SQLException { + return resultSet.isBeforeFirst(); + } + + @Override + public boolean isAfterLast() throws SQLException { + return resultSet.isAfterLast(); + } + + @Override + public boolean isFirst() throws SQLException { + return resultSet.isFirst(); + } + + @Override + public boolean isLast() throws SQLException { + return resultSet.isLast(); + } + + @Override + public void beforeFirst() throws SQLException { + resultSet.beforeFirst(); + } + + @Override + public void afterLast() throws SQLException { + resultSet.afterLast(); + } + + @Override + public boolean first() throws SQLException { + return resultSet.first(); + } + + @Override + public boolean last() throws SQLException { + return resultSet.last(); + } + + @Override + public int getRow() throws SQLException { + return resultSet.getRow(); + } + + @Override + public boolean absolute(int row) throws SQLException { + return resultSet.absolute(row); + } + + @Override + public boolean relative(int rows) throws SQLException { + return resultSet.relative(rows); + } + + @Override + public boolean previous() throws SQLException { + return resultSet.previous(); + } + + @Override + public void setFetchDirection(int direction) throws SQLException { + resultSet.setFetchDirection(direction); + } + + @Override + public int getFetchDirection() throws SQLException { + return resultSet.getFetchDirection(); + } + + @Override + public void setFetchSize(int rows) throws SQLException { + resultSet.setFetchSize(rows); + } + + @Override + public int getFetchSize() throws SQLException { + return resultSet.getFetchSize(); + } + + @Override + public int getType() throws SQLException { + return resultSet.getType(); + } + + @Override + public int getConcurrency() throws SQLException { + return resultSet.getConcurrency(); + } + + @Override + public boolean rowUpdated() throws SQLException { + return resultSet.rowUpdated(); + } + + @Override + public boolean rowInserted() throws SQLException { + return resultSet.rowInserted(); + } + + @Override + public boolean rowDeleted() throws SQLException { + return resultSet.rowDeleted(); + } + + @Override + public void updateNull(int columnIndex) throws SQLException { + resultSet.updateNull(columnIndex); + } + + @Override + public void updateBoolean(int columnIndex, boolean x) throws SQLException { + resultSet.updateBoolean(columnIndex, x); + } + + @Override + public void updateByte(int columnIndex, byte x) throws SQLException { + resultSet.updateByte(columnIndex, x); + } + + @Override + public void updateShort(int columnIndex, short x) throws SQLException { + resultSet.updateShort(columnIndex, x); + } + + @Override + public void updateInt(int columnIndex, int x) throws SQLException { + resultSet.updateInt(columnIndex, x); + } + + @Override + public void updateLong(int columnIndex, long x) throws SQLException { + resultSet.updateLong(columnIndex, x); + } + + @Override + public void updateFloat(int columnIndex, float x) throws SQLException { + resultSet.updateFloat(columnIndex, x); + } + + @Override + public void updateDouble(int columnIndex, double x) throws SQLException { + resultSet.updateDouble(columnIndex, x); + } + + @Override + public void updateBigDecimal(int columnIndex, BigDecimal x) throws SQLException { + resultSet.updateBigDecimal(columnIndex, x); + } + + @Override + public void updateString(int columnIndex, String x) throws SQLException { + resultSet.updateString(columnIndex, x); + } + + @Override + public void updateBytes(int columnIndex, byte[] x) throws SQLException { + resultSet.updateBytes(columnIndex, x); + } + + @Override + public void updateDate(int columnIndex, Date x) throws SQLException { + resultSet.updateDate(columnIndex, x); + } + + @Override + public void updateTime(int columnIndex, Time x) throws SQLException { + resultSet.updateTime(columnIndex, x); + } + + @Override + public void updateTimestamp(int columnIndex, Timestamp x) throws SQLException { + resultSet.updateTimestamp(columnIndex, x); + } + + @Override + public void updateAsciiStream(int columnIndex, InputStream x, int length) throws SQLException { + resultSet.updateAsciiStream(columnIndex, x, length); + } + + @Override + public void updateBinaryStream(int columnIndex, InputStream x, int length) throws SQLException { + resultSet.updateBinaryStream(columnIndex, x, length); + } + + @Override + public void updateCharacterStream(int columnIndex, Reader x, int length) throws SQLException { + resultSet.updateCharacterStream(columnIndex, x, length); + } + + @Override + public void updateObject(int columnIndex, Object x, int scaleOrLength) throws SQLException { + resultSet.updateObject(columnIndex, x, scaleOrLength); + } + + @Override + public void updateObject(int columnIndex, Object x) throws SQLException { + resultSet.updateObject(columnIndex, x); + } + + @Override + public void updateNull(String columnLabel) throws SQLException { + resultSet.updateNull(columnLabel); + } + + @Override + public void updateBoolean(String columnLabel, boolean x) throws SQLException { + resultSet.updateBoolean(columnLabel, x); + } + + @Override + public void updateByte(String columnLabel, byte x) throws SQLException { + resultSet.updateByte(columnLabel, x); + } + + @Override + public void updateShort(String columnLabel, short x) throws SQLException { + resultSet.updateShort(columnLabel, x); + } + + @Override + public void updateInt(String columnLabel, int x) throws SQLException { + resultSet.updateInt(columnLabel, x); + } + + @Override + public void updateLong(String columnLabel, long x) throws SQLException { + resultSet.updateLong(columnLabel, x); + } + + @Override + public void updateFloat(String columnLabel, float x) throws SQLException { + resultSet.updateFloat(columnLabel, x); + } + + @Override + public void updateDouble(String columnLabel, double x) throws SQLException { + resultSet.updateDouble(columnLabel, x); + } + + @Override + public void updateBigDecimal(String columnLabel, BigDecimal x) throws SQLException { + resultSet.updateBigDecimal(columnLabel, x); + } + + @Override + public void updateString(String columnLabel, String x) throws SQLException { + resultSet.updateString(columnLabel, x); + } + + @Override + public void updateBytes(String columnLabel, byte[] x) throws SQLException { + resultSet.updateBytes(columnLabel, x); + } + + @Override + public void updateDate(String columnLabel, Date x) throws SQLException { + resultSet.updateDate(columnLabel, x); + } + + @Override + public void updateTime(String columnLabel, Time x) throws SQLException { + resultSet.updateTime(columnLabel, x); + } + + @Override + public void updateTimestamp(String columnLabel, Timestamp x) throws SQLException { + resultSet.updateTimestamp(columnLabel, x); + } + + @Override + public void updateAsciiStream(String columnLabel, InputStream x, int length) throws SQLException { + resultSet.updateAsciiStream(columnLabel, x, length); + } + + @Override + public void updateBinaryStream(String columnLabel, InputStream x, int length) throws SQLException { + resultSet.updateBinaryStream(columnLabel, x, length); + } + + @Override + public void updateCharacterStream(String columnLabel, Reader reader, int length) throws SQLException { + resultSet.updateCharacterStream(columnLabel, reader, length); + } + + @Override + public void updateObject(String columnLabel, Object x, int scaleOrLength) throws SQLException { + resultSet.updateObject(columnLabel, x, scaleOrLength); + } + + @Override + public void updateObject(String columnLabel, Object x) throws SQLException { + resultSet.updateObject(columnLabel, x); + } + + @Override + public void insertRow() throws SQLException { + resultSet.insertRow(); + } + + @Override + public void updateRow() throws SQLException { + resultSet.updateRow(); + } + + @Override + public void deleteRow() throws SQLException { + resultSet.deleteRow(); + } + + @Override + public void refreshRow() throws SQLException { + resultSet.refreshRow(); + } + + @Override + public void cancelRowUpdates() throws SQLException { + resultSet.cancelRowUpdates(); + } + + @Override + public void moveToInsertRow() throws SQLException { + resultSet.moveToInsertRow(); + } + + @Override + public void moveToCurrentRow() throws SQLException { + resultSet.moveToCurrentRow(); + } + + @Override + public Statement getStatement() throws SQLException { + return resultSet.getStatement(); + } + + @Override + public Object getObject(int columnIndex, Map> map) throws SQLException { + String tableName = metaData.getTableName(columnIndex); + String columnName = metaData.getColumnName(columnIndex); + return ColumnHandlerContext.getInstance().getObject(interceptState, columnIndex, tableName, columnName, resultSet.getDate(columnIndex)); + } + + @Override + public Ref getRef(int columnIndex) throws SQLException { + String tableName = metaData.getTableName(columnIndex); + String columnName = metaData.getColumnName(columnIndex); + return ColumnHandlerContext.getInstance().getRef(interceptState, columnIndex, tableName, columnName, resultSet.getRef(columnIndex)); + } + + @Override + public Blob getBlob(int columnIndex) throws SQLException { + String tableName = metaData.getTableName(columnIndex); + String columnName = metaData.getColumnName(columnIndex); + return ColumnHandlerContext.getInstance().getBlob(interceptState, columnIndex, tableName, columnName, resultSet.getBlob(columnIndex)); + } + + @Override + public Clob getClob(int columnIndex) throws SQLException { + String tableName = metaData.getTableName(columnIndex); + String columnName = metaData.getColumnName(columnIndex); + return ColumnHandlerContext.getInstance().getClob(interceptState, columnIndex, tableName, columnName, resultSet.getClob(columnIndex)); + } + + @Override + public Array getArray(int columnIndex) throws SQLException { + String tableName = metaData.getTableName(columnIndex); + String columnName = metaData.getColumnName(columnIndex); + return ColumnHandlerContext.getInstance().getArray(interceptState, columnIndex, tableName, columnName, resultSet.getArray(columnIndex)); + } + + @Override + public Object getObject(String columnLabel, Map> map) throws SQLException { + int columnIndex = columnLabelMap.get(columnLabel.toUpperCase()); + String tableName = metaData.getTableName(columnIndex); + String columnName = metaData.getColumnName(columnIndex); + return ColumnHandlerContext.getInstance().getObject(interceptState, columnIndex, tableName, columnName, resultSet.getObject(columnIndex)); + } + + @Override + public Ref getRef(String columnLabel) throws SQLException { + int columnIndex = columnLabelMap.get(columnLabel.toUpperCase()); + String tableName = metaData.getTableName(columnIndex); + String columnName = metaData.getColumnName(columnIndex); + return ColumnHandlerContext.getInstance().getRef(interceptState, columnIndex, tableName, columnName, resultSet.getRef(columnIndex)); + } + + @Override + public Blob getBlob(String columnLabel) throws SQLException { + int columnIndex = columnLabelMap.get(columnLabel.toUpperCase()); + String tableName = metaData.getTableName(columnIndex); + String columnName = metaData.getColumnName(columnIndex); + return ColumnHandlerContext.getInstance().getBlob(interceptState, columnIndex, tableName, columnName, resultSet.getBlob(columnIndex)); + } + + @Override + public Clob getClob(String columnLabel) throws SQLException { + int columnIndex = columnLabelMap.get(columnLabel.toUpperCase()); + String tableName = metaData.getTableName(columnIndex); + String columnName = metaData.getColumnName(columnIndex); + return ColumnHandlerContext.getInstance().getClob(interceptState, columnIndex, tableName, columnName, resultSet.getClob(columnIndex)); + } + + @Override + public Array getArray(String columnLabel) throws SQLException { + int columnIndex = columnLabelMap.get(columnLabel.toUpperCase()); + String tableName = metaData.getTableName(columnIndex); + String columnName = metaData.getColumnName(columnIndex); + return ColumnHandlerContext.getInstance().getArray(interceptState, columnIndex, tableName, columnName, resultSet.getArray(columnIndex)); + } + + @Override + public Date getDate(int columnIndex, Calendar cal) throws SQLException { + String tableName = metaData.getTableName(columnIndex); + String columnName = metaData.getColumnName(columnIndex); + return ColumnHandlerContext.getInstance().getDate(interceptState, columnIndex, tableName, columnName, resultSet.getDate(columnIndex, cal)); + } + + @Override + public Date getDate(String columnLabel, Calendar cal) throws SQLException { + int columnIndex = columnLabelMap.get(columnLabel.toUpperCase()); + String tableName = metaData.getTableName(columnIndex); + String columnName = metaData.getColumnName(columnIndex); + return ColumnHandlerContext.getInstance().getDate(interceptState, columnIndex, tableName, columnName, resultSet.getDate(columnIndex, cal)); + } + + @Override + public Time getTime(int columnIndex, Calendar cal) throws SQLException { + String tableName = metaData.getTableName(columnIndex); + String columnName = metaData.getColumnName(columnIndex); + return ColumnHandlerContext.getInstance().getTime(interceptState, columnIndex, tableName, columnName, resultSet.getTime(columnIndex, cal)); + } + + @Override + public Time getTime(String columnLabel, Calendar cal) throws SQLException { + int columnIndex = columnLabelMap.get(columnLabel.toUpperCase()); + String tableName = metaData.getTableName(columnIndex); + String columnName = metaData.getColumnName(columnIndex); + return ColumnHandlerContext.getInstance().getTime(interceptState, columnIndex, tableName, columnName, resultSet.getTime(columnIndex, cal)); + } + + @Override + public Timestamp getTimestamp(int columnIndex, Calendar cal) throws SQLException { + String tableName = metaData.getTableName(columnIndex); + String columnName = metaData.getColumnName(columnIndex); + return ColumnHandlerContext.getInstance().getTimestamp(interceptState, columnIndex, tableName, columnName, resultSet.getTimestamp(columnIndex, cal)); + } + + @Override + public Timestamp getTimestamp(String columnLabel, Calendar cal) throws SQLException { + int columnIndex = columnLabelMap.get(columnLabel.toUpperCase()); + String tableName = metaData.getTableName(columnIndex); + String columnName = metaData.getColumnName(columnIndex); + return ColumnHandlerContext.getInstance().getTimestamp(interceptState, columnIndex, tableName, columnName, resultSet.getTimestamp(columnIndex, cal)); + } + + @Override + public URL getURL(int columnIndex) throws SQLException { + String tableName = metaData.getTableName(columnIndex); + String columnName = metaData.getColumnName(columnIndex); + return ColumnHandlerContext.getInstance().getURL(interceptState, columnIndex, tableName, columnName, resultSet.getURL(columnIndex)); + } + + @Override + public URL getURL(String columnLabel) throws SQLException { + int columnIndex = columnLabelMap.get(columnLabel.toUpperCase()); + String tableName = metaData.getTableName(columnIndex); + String columnName = metaData.getColumnName(columnIndex); + return ColumnHandlerContext.getInstance().getURL(interceptState, columnIndex, tableName, columnName, resultSet.getURL(columnIndex)); + } + + @Override + public void updateRef(int columnIndex, Ref x) throws SQLException { + resultSet.updateRef(columnIndex, x); + } + + @Override + public void updateRef(String columnLabel, Ref x) throws SQLException { + resultSet.updateRef(columnLabel, x); + } + + @Override + public void updateBlob(int columnIndex, Blob x) throws SQLException { + resultSet.updateBlob(columnIndex, x); + } + + @Override + public void updateBlob(String columnLabel, Blob x) throws SQLException { + resultSet.updateBlob(columnLabel, x); + } + + @Override + public void updateClob(int columnIndex, Clob x) throws SQLException { + resultSet.updateClob(columnIndex, x); + } + + @Override + public void updateClob(String columnLabel, Clob x) throws SQLException { + resultSet.updateClob(columnLabel, x); + } + + @Override + public void updateArray(int columnIndex, Array x) throws SQLException { + resultSet.updateArray(columnIndex, x); + } + + @Override + public void updateArray(String columnLabel, Array x) throws SQLException { + resultSet.updateArray(columnLabel, x); + } + + @Override + public RowId getRowId(int columnIndex) throws SQLException { + String tableName = metaData.getTableName(columnIndex); + String columnName = metaData.getColumnName(columnIndex); + return ColumnHandlerContext.getInstance().getRowId(interceptState, columnIndex, tableName, columnName, resultSet.getRowId(columnIndex)); + } + + @Override + public RowId getRowId(String columnLabel) throws SQLException { + int columnIndex = columnLabelMap.get(columnLabel.toUpperCase()); + String tableName = metaData.getTableName(columnIndex); + String columnName = metaData.getColumnName(columnIndex); + return ColumnHandlerContext.getInstance().getRowId(interceptState, columnIndex, tableName, columnName, resultSet.getRowId(columnIndex)); + } + + @Override + public void updateRowId(int columnIndex, RowId x) throws SQLException { + resultSet.updateRowId(columnIndex, x); + } + + @Override + public void updateRowId(String columnLabel, RowId x) throws SQLException { + resultSet.updateRowId(columnLabel, x); + } + + @Override + public int getHoldability() throws SQLException { + return resultSet.getHoldability(); + } + + @Override + public boolean isClosed() throws SQLException { + return resultSet.isClosed(); + } + + @Override + public void updateNString(int columnIndex, String nString) throws SQLException { + resultSet.updateNString(columnIndex, nString); + } + + @Override + public void updateNString(String columnLabel, String nString) throws SQLException { + resultSet.updateNString(columnLabel, nString); + } + + @Override + public void updateNClob(int columnIndex, NClob nClob) throws SQLException { + resultSet.updateNClob(columnIndex, nClob); + } + + @Override + public void updateNClob(String columnLabel, NClob nClob) throws SQLException { + resultSet.updateNClob(columnLabel, nClob); + } + + @Override + public NClob getNClob(int columnIndex) throws SQLException { + String tableName = metaData.getTableName(columnIndex); + String columnName = metaData.getColumnName(columnIndex); + return ColumnHandlerContext.getInstance().getNClob(interceptState, columnIndex, tableName, columnName, resultSet.getNClob(columnIndex)); + } + + @Override + public NClob getNClob(String columnLabel) throws SQLException { + int columnIndex = columnLabelMap.get(columnLabel.toUpperCase()); + String tableName = metaData.getTableName(columnIndex); + String columnName = metaData.getColumnName(columnIndex); + return ColumnHandlerContext.getInstance().getNClob(interceptState, columnIndex, tableName, columnName, resultSet.getNClob(columnIndex)); + } + + @Override + public SQLXML getSQLXML(int columnIndex) throws SQLException { + String tableName = metaData.getTableName(columnIndex); + String columnName = metaData.getColumnName(columnIndex); + return ColumnHandlerContext.getInstance().getSQLXML(interceptState, columnIndex, tableName, columnName, resultSet.getSQLXML(columnIndex)); + } + + @Override + public SQLXML getSQLXML(String columnLabel) throws SQLException { + int columnIndex = columnLabelMap.get(columnLabel.toUpperCase()); + String tableName = metaData.getTableName(columnIndex); + String columnName = metaData.getColumnName(columnIndex); + return ColumnHandlerContext.getInstance().getSQLXML(interceptState, columnIndex, tableName, columnName, resultSet.getSQLXML(columnIndex)); + } + + @Override + public void updateSQLXML(int columnIndex, SQLXML xmlObject) throws SQLException { + resultSet.updateSQLXML(columnIndex, xmlObject); + } + + @Override + public void updateSQLXML(String columnLabel, SQLXML xmlObject) throws SQLException { + resultSet.updateSQLXML(columnLabel, xmlObject); + } + + @Override + public String getNString(int columnIndex) throws SQLException { + String tableName = metaData.getTableName(columnIndex); + String columnName = metaData.getColumnName(columnIndex); + return ColumnHandlerContext.getInstance().getNString(interceptState, columnIndex, tableName, columnName, resultSet.getNString(columnIndex)); + } + + @Override + public String getNString(String columnLabel) throws SQLException { + int columnIndex = columnLabelMap.get(columnLabel.toUpperCase()); + String tableName = metaData.getTableName(columnIndex); + String columnName = metaData.getColumnName(columnIndex); + return ColumnHandlerContext.getInstance().getNString(interceptState, columnIndex, tableName, columnName, resultSet.getNString(columnIndex)); + } + + @Override + public Reader getNCharacterStream(int columnIndex) throws SQLException { + String tableName = metaData.getTableName(columnIndex); + String columnName = metaData.getColumnName(columnIndex); + return ColumnHandlerContext.getInstance().getNCharacterStream(interceptState, columnIndex, tableName, columnName, resultSet.getNCharacterStream(columnIndex)); + } + + @Override + public Reader getNCharacterStream(String columnLabel) throws SQLException { + int columnIndex = columnLabelMap.get(columnLabel.toUpperCase()); + String tableName = metaData.getTableName(columnIndex); + String columnName = metaData.getColumnName(columnIndex); + return ColumnHandlerContext.getInstance().getNCharacterStream(interceptState, columnIndex, tableName, columnName, resultSet.getNCharacterStream(columnIndex)); + } + + @Override + public void updateNCharacterStream(int columnIndex, Reader x, long length) throws SQLException { + resultSet.updateNCharacterStream(columnIndex, x, length); + } + + @Override + public void updateNCharacterStream(String columnLabel, Reader reader, long length) throws SQLException { + resultSet.updateNCharacterStream(columnLabel, reader, length); + } + + @Override + public void updateAsciiStream(int columnIndex, InputStream x, long length) throws SQLException { + resultSet.updateAsciiStream(columnIndex, x, length); + } + + @Override + public void updateBinaryStream(int columnIndex, InputStream x, long length) throws SQLException { + resultSet.updateBinaryStream(columnIndex, x, length); + } + + @Override + public void updateCharacterStream(int columnIndex, Reader x, long length) throws SQLException { + resultSet.updateCharacterStream(columnIndex, x, length); + } + + @Override + public void updateAsciiStream(String columnLabel, InputStream x, long length) throws SQLException { + resultSet.updateAsciiStream(columnLabel, x, length); + } + + @Override + public void updateBinaryStream(String columnLabel, InputStream x, long length) throws SQLException { + resultSet.updateBinaryStream(columnLabel, x, length); + } + + @Override + public void updateCharacterStream(String columnLabel, Reader reader, long length) throws SQLException { + resultSet.updateCharacterStream(columnLabel, reader, length); + } + + @Override + public void updateBlob(int columnIndex, InputStream inputStream, long length) throws SQLException { + resultSet.updateBlob(columnIndex, inputStream, length); + } + + @Override + public void updateBlob(String columnLabel, InputStream inputStream, long length) throws SQLException { + resultSet.updateBlob(columnLabel, inputStream, length); + } + + @Override + public void updateClob(int columnIndex, Reader reader, long length) throws SQLException { + resultSet.updateClob(columnIndex, reader, length); + } + + @Override + public void updateClob(String columnLabel, Reader reader, long length) throws SQLException { + resultSet.updateClob(columnLabel, reader, length); + } + + @Override + public void updateNClob(int columnIndex, Reader reader, long length) throws SQLException { + resultSet.updateNClob(columnIndex, reader, length); + } + + @Override + public void updateNClob(String columnLabel, Reader reader, long length) throws SQLException { + resultSet.updateNClob(columnLabel, reader, length); + } + + @Override + public void updateNCharacterStream(int columnIndex, Reader x) throws SQLException { + resultSet.updateNCharacterStream(columnIndex, x); + } + + @Override + public void updateNCharacterStream(String columnLabel, Reader reader) throws SQLException { + resultSet.updateNCharacterStream(columnLabel, reader); + } + + @Override + public void updateAsciiStream(int columnIndex, InputStream x) throws SQLException { + resultSet.updateAsciiStream(columnIndex, x); + } + + @Override + public void updateBinaryStream(int columnIndex, InputStream x) throws SQLException { + resultSet.updateBinaryStream(columnIndex, x); + } + + @Override + public void updateCharacterStream(int columnIndex, Reader x) throws SQLException { + resultSet.updateCharacterStream(columnIndex, x); + } + + @Override + public void updateAsciiStream(String columnLabel, InputStream x) throws SQLException { + resultSet.updateAsciiStream(columnLabel, x); + } + + @Override + public void updateBinaryStream(String columnLabel, InputStream x) throws SQLException { + resultSet.updateBinaryStream(columnLabel, x); + } + + @Override + public void updateCharacterStream(String columnLabel, Reader reader) throws SQLException { + resultSet.updateCharacterStream(columnLabel, reader); + } + + @Override + public void updateBlob(int columnIndex, InputStream inputStream) throws SQLException { + resultSet.updateBlob(columnIndex, inputStream); + } + + @Override + public void updateBlob(String columnLabel, InputStream inputStream) throws SQLException { + resultSet.updateBlob(columnLabel, inputStream); + } + + @Override + public void updateClob(int columnIndex, Reader reader) throws SQLException { + resultSet.updateClob(columnIndex, reader); + } + + @Override + public void updateClob(String columnLabel, Reader reader) throws SQLException { + resultSet.updateClob(columnLabel, reader); + } + + @Override + public void updateNClob(int columnIndex, Reader reader) throws SQLException { + resultSet.updateNClob(columnIndex, reader); + } + + @Override + public void updateNClob(String columnLabel, Reader reader) throws SQLException { + resultSet.updateNClob(columnLabel, reader); + } + + @Override + public T getObject(int columnIndex, Class type) throws SQLException { + String tableName = metaData.getTableName(columnIndex); + String columnName = metaData.getColumnName(columnIndex); + return ColumnHandlerContext.getInstance().getObject(interceptState, columnIndex, tableName, columnName, resultSet.getObject(columnIndex, type), type); + } + + @Override + public T getObject(String columnLabel, Class type) throws SQLException { + int columnIndex = columnLabelMap.get(columnLabel.toUpperCase()); + String tableName = metaData.getTableName(columnIndex); + String columnName = metaData.getColumnName(columnIndex); + return ColumnHandlerContext.getInstance().getObject(interceptState, columnIndex, tableName, columnName, resultSet.getObject(columnIndex, type), type); + } + + @Override + public void updateObject(int columnIndex, Object x, SQLType targetSqlType, int scaleOrLength) throws SQLException { + resultSet.updateObject(columnIndex, x, targetSqlType, scaleOrLength); + } + + @Override + public void updateObject(String columnLabel, Object x, SQLType targetSqlType, int scaleOrLength) throws SQLException { + resultSet.updateObject(columnLabel, x, targetSqlType, scaleOrLength); + } + + @Override + public void updateObject(int columnIndex, Object x, SQLType targetSqlType) throws SQLException { + resultSet.updateObject(columnIndex, x, targetSqlType); + } + + @Override + public void updateObject(String columnLabel, Object x, SQLType targetSqlType) throws SQLException { + resultSet.updateObject(columnLabel, x, targetSqlType); + } + + @Override + public T unwrap(Class iface) throws SQLException { + return resultSet.unwrap(iface); + } + + @Override + public boolean isWrapperFor(Class iface) throws SQLException { + return resultSet.isWrapperFor(iface); + } +} diff --git a/springboot-starter-data-authorization/src/main/java/com/codingapi/springboot/authorization/jdbc/proxy/StatementProxy.java b/springboot-starter-data-authorization/src/main/java/com/codingapi/springboot/authorization/jdbc/proxy/StatementProxy.java new file mode 100644 index 000000000..5f91ff78a --- /dev/null +++ b/springboot-starter-data-authorization/src/main/java/com/codingapi/springboot/authorization/jdbc/proxy/StatementProxy.java @@ -0,0 +1,290 @@ +package com.codingapi.springboot.authorization.jdbc.proxy; + +import com.codingapi.springboot.authorization.interceptor.SQLExecuteState; +import com.codingapi.springboot.authorization.interceptor.SQLRunningContext; +import lombok.AllArgsConstructor; + +import java.sql.*; + +@AllArgsConstructor +public class StatementProxy implements Statement { + + private final Statement statement; + private SQLExecuteState interceptState; + + + + @Override + public ResultSet executeQuery(String sql) throws SQLException { + this.interceptState = SQLRunningContext.getInstance().intercept(sql); + return new ResultSetProxy(statement.executeQuery(interceptState.getSql()), interceptState); + } + + @Override + public int executeUpdate(String sql) throws SQLException { + this.interceptState = SQLRunningContext.getInstance().intercept(sql); + return statement.executeUpdate(interceptState.getSql()); + } + + @Override + public void close() throws SQLException { + statement.close(); + } + + @Override + public int getMaxFieldSize() throws SQLException { + return statement.getMaxFieldSize(); + } + + @Override + public void setMaxFieldSize(int max) throws SQLException { + statement.setMaxFieldSize(max); + } + + @Override + public int getMaxRows() throws SQLException { + return statement.getMaxRows(); + } + + @Override + public void setMaxRows(int max) throws SQLException { + statement.setMaxRows(max); + } + + @Override + public void setEscapeProcessing(boolean enable) throws SQLException { + statement.setEscapeProcessing(enable); + } + + @Override + public int getQueryTimeout() throws SQLException { + return statement.getQueryTimeout(); + } + + @Override + public void setQueryTimeout(int seconds) throws SQLException { + statement.setQueryTimeout(seconds); + } + + @Override + public void cancel() throws SQLException { + statement.cancel(); + } + + @Override + public SQLWarning getWarnings() throws SQLException { + return statement.getWarnings(); + } + + @Override + public void clearWarnings() throws SQLException { + statement.clearWarnings(); + } + + @Override + public void setCursorName(String name) throws SQLException { + statement.setCursorName(name); + } + + @Override + public boolean execute(String sql) throws SQLException { + this.interceptState = SQLRunningContext.getInstance().intercept(sql); + return statement.execute(interceptState.getSql()); + } + + @Override + public ResultSet getResultSet() throws SQLException { + return new ResultSetProxy(statement.getResultSet(), interceptState); + } + + @Override + public int getUpdateCount() throws SQLException { + return statement.getUpdateCount(); + } + + @Override + public boolean getMoreResults() throws SQLException { + return statement.getMoreResults(); + } + + @Override + public void setFetchDirection(int direction) throws SQLException { + statement.setFetchDirection(direction); + } + + @Override + public int getFetchDirection() throws SQLException { + return statement.getFetchDirection(); + } + + @Override + public void setFetchSize(int rows) throws SQLException { + statement.setFetchSize(rows); + } + + @Override + public int getFetchSize() throws SQLException { + return statement.getFetchSize(); + } + + @Override + public int getResultSetConcurrency() throws SQLException { + return statement.getResultSetConcurrency(); + } + + @Override + public int getResultSetType() throws SQLException { + return statement.getResultSetType(); + } + + @Override + public void addBatch(String sql) throws SQLException { + this.interceptState = SQLRunningContext.getInstance().intercept(sql); + statement.addBatch(interceptState.getSql()); + } + + @Override + public void clearBatch() throws SQLException { + statement.clearBatch(); + } + + @Override + public int[] executeBatch() throws SQLException { + return statement.executeBatch(); + } + + @Override + public Connection getConnection() throws SQLException { + return new ConnectionProxy(statement.getConnection()); + } + + @Override + public boolean getMoreResults(int current) throws SQLException { + return statement.getMoreResults(current); + } + + @Override + public ResultSet getGeneratedKeys() throws SQLException { + return new ResultSetProxy(statement.getGeneratedKeys(),this.interceptState); + } + + @Override + public int executeUpdate(String sql, int autoGeneratedKeys) throws SQLException { + this.interceptState = SQLRunningContext.getInstance().intercept(sql); + return statement.executeUpdate(interceptState.getSql(), autoGeneratedKeys); + } + + @Override + public int executeUpdate(String sql, int[] columnIndexes) throws SQLException { + this.interceptState = SQLRunningContext.getInstance().intercept(sql); + return statement.executeUpdate(interceptState.getSql(), columnIndexes); + } + + @Override + public int executeUpdate(String sql, String[] columnNames) throws SQLException { + this.interceptState = SQLRunningContext.getInstance().intercept(sql); + return statement.executeUpdate(interceptState.getSql(), columnNames); + } + + @Override + public boolean execute(String sql, int autoGeneratedKeys) throws SQLException { + this.interceptState = SQLRunningContext.getInstance().intercept(sql); + return statement.execute(interceptState.getSql(), autoGeneratedKeys); + } + + @Override + public boolean execute(String sql, int[] columnIndexes) throws SQLException { + this.interceptState = SQLRunningContext.getInstance().intercept(sql); + return statement.execute(interceptState.getSql(), columnIndexes); + } + + @Override + public boolean execute(String sql, String[] columnNames) throws SQLException { + this.interceptState = SQLRunningContext.getInstance().intercept(sql); + return statement.execute(interceptState.getSql(), columnNames); + } + + @Override + public int getResultSetHoldability() throws SQLException { + return statement.getResultSetHoldability(); + } + + @Override + public boolean isClosed() throws SQLException { + return statement.isClosed(); + } + + @Override + public void setPoolable(boolean poolable) throws SQLException { + statement.setPoolable(poolable); + } + + @Override + public boolean isPoolable() throws SQLException { + return statement.isPoolable(); + } + + @Override + public void closeOnCompletion() throws SQLException { + statement.closeOnCompletion(); + } + + @Override + public boolean isCloseOnCompletion() throws SQLException { + return statement.isCloseOnCompletion(); + } + + @Override + public long getLargeUpdateCount() throws SQLException { + return statement.getLargeUpdateCount(); + } + + @Override + public void setLargeMaxRows(long max) throws SQLException { + statement.setLargeMaxRows(max); + } + + @Override + public long getLargeMaxRows() throws SQLException { + return statement.getLargeMaxRows(); + } + + @Override + public long[] executeLargeBatch() throws SQLException { + return statement.executeLargeBatch(); + } + + @Override + public long executeLargeUpdate(String sql) throws SQLException { + this.interceptState = SQLRunningContext.getInstance().intercept(sql); + return statement.executeLargeUpdate(interceptState.getSql()); + } + + @Override + public long executeLargeUpdate(String sql, int autoGeneratedKeys) throws SQLException { + this.interceptState = SQLRunningContext.getInstance().intercept(sql); + return statement.executeLargeUpdate(interceptState.getSql(), autoGeneratedKeys); + } + + @Override + public long executeLargeUpdate(String sql, int[] columnIndexes) throws SQLException { + this.interceptState = SQLRunningContext.getInstance().intercept(sql); + return statement.executeLargeUpdate(interceptState.getSql(), columnIndexes); + } + + @Override + public long executeLargeUpdate(String sql, String[] columnNames) throws SQLException { + this.interceptState = SQLRunningContext.getInstance().intercept(sql); + return statement.executeLargeUpdate(interceptState.getSql(), columnNames); + } + + @Override + public T unwrap(Class iface) throws SQLException { + return statement.unwrap(iface); + } + + @Override + public boolean isWrapperFor(Class iface) throws SQLException { + return statement.isWrapperFor(iface); + } +} diff --git a/springboot-starter-data-authorization/src/main/java/com/codingapi/springboot/authorization/mask/ColumnMask.java b/springboot-starter-data-authorization/src/main/java/com/codingapi/springboot/authorization/mask/ColumnMask.java new file mode 100644 index 000000000..c0721ad02 --- /dev/null +++ b/springboot-starter-data-authorization/src/main/java/com/codingapi/springboot/authorization/mask/ColumnMask.java @@ -0,0 +1,12 @@ +package com.codingapi.springboot.authorization.mask; + +/** + * 列数据脱敏 + */ +public interface ColumnMask { + + boolean support(Object value); + + Object mask(Object value); + +} diff --git a/springboot-starter-data-authorization/src/main/java/com/codingapi/springboot/authorization/mask/ColumnMaskContext.java b/springboot-starter-data-authorization/src/main/java/com/codingapi/springboot/authorization/mask/ColumnMaskContext.java new file mode 100644 index 000000000..5e84d63a7 --- /dev/null +++ b/springboot-starter-data-authorization/src/main/java/com/codingapi/springboot/authorization/mask/ColumnMaskContext.java @@ -0,0 +1,34 @@ +package com.codingapi.springboot.authorization.mask; + +import lombok.Getter; + +import java.util.ArrayList; +import java.util.List; + +public class ColumnMaskContext { + + private final List columnMasks; + + private ColumnMaskContext() { + this.columnMasks = new ArrayList<>(); + } + + public void addColumnMask(ColumnMask columnMask) { + this.columnMasks.add(columnMask); + } + + @Getter + private final static ColumnMaskContext instance = new ColumnMaskContext(); + + + public T mask(T value) { + for (ColumnMask columnMask : columnMasks) { + if (columnMask.support(value)) { + return (T)columnMask.mask(value); + } + } + return value; + } + + +} diff --git a/springboot-starter-data-authorization/src/main/java/com/codingapi/springboot/authorization/mask/impl/BankCardMask.java b/springboot-starter-data-authorization/src/main/java/com/codingapi/springboot/authorization/mask/impl/BankCardMask.java new file mode 100644 index 000000000..2aba7e1b3 --- /dev/null +++ b/springboot-starter-data-authorization/src/main/java/com/codingapi/springboot/authorization/mask/impl/BankCardMask.java @@ -0,0 +1,43 @@ +package com.codingapi.springboot.authorization.mask.impl; + +import com.codingapi.springboot.authorization.mask.ColumnMask; + +import java.util.regex.Pattern; + +/** + * 银行卡脱敏 + */ +public class BankCardMask implements ColumnMask { + + private final static Pattern BANK_CARD_MATCHER_PATTERN = Pattern.compile("^\\d{13,19}$"); + private final static Pattern BANK_CARD_MASK_PATTERN = Pattern.compile("(\\d{6})\\d{3,9}(\\d{4})"); + + @Override + public boolean support(Object value) { + if (value instanceof String) { + return BANK_CARD_MATCHER_PATTERN.matcher((String) value).matches(); + } + return false; + } + + @Override + public Object mask(Object value) { + if (value instanceof String) { + String bankCard = (String) value; + int length = bankCard.length(); + // 获取字符串的长度 + int maskLength = length - 10; + + // 手动构造星号部分 + StringBuilder maskedPart = new StringBuilder(maskLength); + for (int i = 0; i < maskLength; i++) { + maskedPart.append("*"); + } + + // 用构造好的星号替换原始字符串中的部分内容 + return BANK_CARD_MASK_PATTERN.matcher((String) value) + .replaceAll("$1" + maskedPart + "$2"); + } + return value; + } +} diff --git a/springboot-starter-data-authorization/src/main/java/com/codingapi/springboot/authorization/mask/impl/IDCardMask.java b/springboot-starter-data-authorization/src/main/java/com/codingapi/springboot/authorization/mask/impl/IDCardMask.java new file mode 100644 index 000000000..51541ad93 --- /dev/null +++ b/springboot-starter-data-authorization/src/main/java/com/codingapi/springboot/authorization/mask/impl/IDCardMask.java @@ -0,0 +1,29 @@ +package com.codingapi.springboot.authorization.mask.impl; + +import com.codingapi.springboot.authorization.mask.ColumnMask; + +import java.util.regex.Pattern; + +/** + * 身份证脱敏 + */ +public class IDCardMask implements ColumnMask { + private final static Pattern ID_CARD_MATCHER_PATTERN = Pattern.compile("^(\\d{15}|\\d{18}|\\d{17}[Xx])$"); + private final static Pattern ID_CARD_MASK_PATTERN = Pattern.compile("(\\d{6})\\d{8}(\\w{4})"); + + @Override + public boolean support(Object value) { + if (value instanceof String) { + return ID_CARD_MATCHER_PATTERN.matcher((String) value).matches(); + } + return false; + } + + @Override + public Object mask(Object value) { + if (value instanceof String) { + return ID_CARD_MASK_PATTERN.matcher( (String) value).replaceAll("$1********$2"); + } + return value; + } +} diff --git a/springboot-starter-data-authorization/src/main/java/com/codingapi/springboot/authorization/mask/impl/PhoneMask.java b/springboot-starter-data-authorization/src/main/java/com/codingapi/springboot/authorization/mask/impl/PhoneMask.java new file mode 100644 index 000000000..3903a82f6 --- /dev/null +++ b/springboot-starter-data-authorization/src/main/java/com/codingapi/springboot/authorization/mask/impl/PhoneMask.java @@ -0,0 +1,31 @@ +package com.codingapi.springboot.authorization.mask.impl; + +import com.codingapi.springboot.authorization.mask.ColumnMask; + +import java.util.regex.Pattern; + +/** + * 电话号码脱敏 + */ +public class PhoneMask implements ColumnMask { + + private static final Pattern PHONE_MATCHER_PATTERN = Pattern.compile("^1[3-9]\\d{9}$"); + private static final Pattern PHONE_MASK_PATTERN = Pattern.compile("(\\d{3})\\d{4}(\\d{4})"); + + @Override + public boolean support(Object value) { + if (value instanceof String) { + return PHONE_MATCHER_PATTERN.matcher((String) value).matches(); + } + return false; + } + + @Override + public Object mask(Object value) { + if (value instanceof String) { + return PHONE_MASK_PATTERN.matcher((String) value).replaceAll("$1****$2"); + } + return value; + } + +} diff --git a/springboot-starter-data-authorization/src/main/java/com/codingapi/springboot/authorization/properties/DataAuthorizationProperties.java b/springboot-starter-data-authorization/src/main/java/com/codingapi/springboot/authorization/properties/DataAuthorizationProperties.java new file mode 100644 index 000000000..48bfe7719 --- /dev/null +++ b/springboot-starter-data-authorization/src/main/java/com/codingapi/springboot/authorization/properties/DataAuthorizationProperties.java @@ -0,0 +1,17 @@ +package com.codingapi.springboot.authorization.properties; + + +import lombok.Getter; +import lombok.Setter; + +@Setter +@Getter +public class DataAuthorizationProperties { + + private boolean showSql = false; + + public DataAuthorizationProperties() { + DataAuthorizationPropertyContext.getInstance().setDataAuthorizationProperties(this); + } + +} diff --git a/springboot-starter-data-authorization/src/main/java/com/codingapi/springboot/authorization/properties/DataAuthorizationPropertyContext.java b/springboot-starter-data-authorization/src/main/java/com/codingapi/springboot/authorization/properties/DataAuthorizationPropertyContext.java new file mode 100644 index 000000000..dcb5f5824 --- /dev/null +++ b/springboot-starter-data-authorization/src/main/java/com/codingapi/springboot/authorization/properties/DataAuthorizationPropertyContext.java @@ -0,0 +1,24 @@ +package com.codingapi.springboot.authorization.properties; + +import lombok.Getter; + +public class DataAuthorizationPropertyContext { + + @Getter + private final static DataAuthorizationPropertyContext instance = new DataAuthorizationPropertyContext(); + + private DataAuthorizationPropertyContext(){} + + private DataAuthorizationProperties dataAuthorizationProperties; + + protected void setDataAuthorizationProperties(DataAuthorizationProperties dataAuthorizationProperties){ + this.dataAuthorizationProperties = dataAuthorizationProperties; + } + + public boolean showSql(){ + if(dataAuthorizationProperties!=null) { + return dataAuthorizationProperties.isShowSql(); + } + return false; + } +} diff --git a/springboot-starter-data-authorization/src/main/java/com/codingapi/springboot/authorization/register/ConditionHandlerRegister.java b/springboot-starter-data-authorization/src/main/java/com/codingapi/springboot/authorization/register/ConditionHandlerRegister.java new file mode 100644 index 000000000..d39fb34d3 --- /dev/null +++ b/springboot-starter-data-authorization/src/main/java/com/codingapi/springboot/authorization/register/ConditionHandlerRegister.java @@ -0,0 +1,14 @@ +package com.codingapi.springboot.authorization.register; + + +import com.codingapi.springboot.authorization.handler.RowHandler; +import com.codingapi.springboot.authorization.handler.RowHandlerContext; + +public class ConditionHandlerRegister { + + public ConditionHandlerRegister(RowHandler rowHandler) { + if (rowHandler != null) { + RowHandlerContext.getInstance().setRowHandler(rowHandler); + } + } +} diff --git a/springboot-starter-data-authorization/src/main/java/com/codingapi/springboot/authorization/register/DataAuthorizationContextRegister.java b/springboot-starter-data-authorization/src/main/java/com/codingapi/springboot/authorization/register/DataAuthorizationContextRegister.java new file mode 100644 index 000000000..39ca70969 --- /dev/null +++ b/springboot-starter-data-authorization/src/main/java/com/codingapi/springboot/authorization/register/DataAuthorizationContextRegister.java @@ -0,0 +1,17 @@ +package com.codingapi.springboot.authorization.register; + +import com.codingapi.springboot.authorization.DataAuthorizationContext; +import com.codingapi.springboot.authorization.filter.DataAuthorizationFilter; + +import java.util.List; + +public class DataAuthorizationContextRegister { + + public DataAuthorizationContextRegister(List dataAuthorizationFilters) { + if(dataAuthorizationFilters!=null) { + for (DataAuthorizationFilter filter : dataAuthorizationFilters) { + DataAuthorizationContext.getInstance().addDataAuthorizationFilter(filter); + } + } + } +} diff --git a/springboot-starter-data-authorization/src/main/java/com/codingapi/springboot/authorization/register/ResultSetHandlerRegister.java b/springboot-starter-data-authorization/src/main/java/com/codingapi/springboot/authorization/register/ResultSetHandlerRegister.java new file mode 100644 index 000000000..6070269a4 --- /dev/null +++ b/springboot-starter-data-authorization/src/main/java/com/codingapi/springboot/authorization/register/ResultSetHandlerRegister.java @@ -0,0 +1,15 @@ +package com.codingapi.springboot.authorization.register; + + +import com.codingapi.springboot.authorization.handler.ColumnHandler; +import com.codingapi.springboot.authorization.handler.ColumnHandlerContext; + +public class ResultSetHandlerRegister { + + public ResultSetHandlerRegister(ColumnHandler columnHandler){ + if(columnHandler !=null) { + ColumnHandlerContext.getInstance().setColumnHandler(columnHandler); + } + } + +} diff --git a/springboot-starter-data-authorization/src/main/java/com/codingapi/springboot/authorization/register/SQLInterceptorRegister.java b/springboot-starter-data-authorization/src/main/java/com/codingapi/springboot/authorization/register/SQLInterceptorRegister.java new file mode 100644 index 000000000..57534f0de --- /dev/null +++ b/springboot-starter-data-authorization/src/main/java/com/codingapi/springboot/authorization/register/SQLInterceptorRegister.java @@ -0,0 +1,14 @@ +package com.codingapi.springboot.authorization.register; + + +import com.codingapi.springboot.authorization.interceptor.SQLInterceptor; +import com.codingapi.springboot.authorization.interceptor.SQLInterceptorContext; + +public class SQLInterceptorRegister { + + public SQLInterceptorRegister(SQLInterceptor sqlInterceptor) { + if(sqlInterceptor!=null) { + SQLInterceptorContext.getInstance().setSqlInterceptor(sqlInterceptor); + } + } +} diff --git a/springboot-starter-data-authorization/src/main/java/com/codingapi/springboot/authorization/utils/SQLUtils.java b/springboot-starter-data-authorization/src/main/java/com/codingapi/springboot/authorization/utils/SQLUtils.java new file mode 100644 index 000000000..817da94c6 --- /dev/null +++ b/springboot-starter-data-authorization/src/main/java/com/codingapi/springboot/authorization/utils/SQLUtils.java @@ -0,0 +1,25 @@ +package com.codingapi.springboot.authorization.utils; + +import net.sf.jsqlparser.parser.CCJSqlParserUtil; +import net.sf.jsqlparser.statement.Statement; +import net.sf.jsqlparser.statement.select.Select; + +public class SQLUtils { + + /** + * 判断是否为查询 + */ + public static boolean isQuerySql(String sql) { + if (sql == null || sql.trim().isEmpty()) { + return false; // 空字符串或 null 不是有效 SQL + } + try { + Statement statement = CCJSqlParserUtil.parse(sql); + return statement instanceof Select; + } catch (Exception e) { + return false; + } + } + + +} diff --git a/springboot-starter-data-authorization/src/main/resources/META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports b/springboot-starter-data-authorization/src/main/resources/META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports new file mode 100644 index 000000000..77aba71de --- /dev/null +++ b/springboot-starter-data-authorization/src/main/resources/META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports @@ -0,0 +1 @@ +com.codingapi.springboot.authorization.DataAuthorizationConfiguration diff --git a/springboot-starter-data-authorization/src/test/java/com/codingapi/springboot/authorization/DataAuthorizationContextTest.java b/springboot-starter-data-authorization/src/test/java/com/codingapi/springboot/authorization/DataAuthorizationContextTest.java new file mode 100644 index 000000000..1338bd6c3 --- /dev/null +++ b/springboot-starter-data-authorization/src/test/java/com/codingapi/springboot/authorization/DataAuthorizationContextTest.java @@ -0,0 +1,465 @@ +package com.codingapi.springboot.authorization; + +import com.codingapi.springboot.authorization.condition.JoinConditionSQL; +import com.codingapi.springboot.authorization.condition.WhereConditionSQL; +import com.codingapi.springboot.authorization.current.CurrentUser; +import com.codingapi.springboot.authorization.entity.Depart; +import com.codingapi.springboot.authorization.entity.Unit; +import com.codingapi.springboot.authorization.entity.User; +import com.codingapi.springboot.authorization.filter.DefaultDataAuthorizationFilter; +import com.codingapi.springboot.authorization.filter.SkipAuthorizationFilter; +import com.codingapi.springboot.authorization.handler.Condition; +import com.codingapi.springboot.authorization.interceptor.SQLRunningContext; +import com.codingapi.springboot.authorization.mask.ColumnMaskContext; +import com.codingapi.springboot.authorization.mask.impl.BankCardMask; +import com.codingapi.springboot.authorization.mask.impl.IDCardMask; +import com.codingapi.springboot.authorization.mask.impl.PhoneMask; +import com.codingapi.springboot.authorization.repository.DepartRepository; +import com.codingapi.springboot.authorization.repository.UnitRepository; +import com.codingapi.springboot.authorization.repository.UserRepository; +import lombok.extern.slf4j.Slf4j; +import org.junit.jupiter.api.MethodOrderer; +import org.junit.jupiter.api.Order; +import org.junit.jupiter.api.Test; +import org.junit.jupiter.api.TestMethodOrder; +import org.springframework.beans.factory.annotation.Autowired; +import org.springframework.boot.test.context.SpringBootTest; +import org.springframework.data.domain.Page; +import org.springframework.data.domain.PageRequest; +import org.springframework.jdbc.core.JdbcTemplate; +import org.springframework.test.annotation.Rollback; + +import java.time.LocalDate; +import java.util.List; +import java.util.Map; + +import static org.junit.jupiter.api.Assertions.assertEquals; +import static org.junit.jupiter.api.Assertions.assertTrue; + +@Slf4j +@SpringBootTest +@TestMethodOrder(MethodOrderer.OrderAnnotation.class) +@Rollback(value = false) +public class DataAuthorizationContextTest { + + @Autowired + private UserRepository userRepository; + @Autowired + private DepartRepository departRepository; + @Autowired + private UnitRepository unitRepository; + @Autowired + private JdbcTemplate jdbcTemplate; + + @Test + @Order(1) + void test1() { + + unitRepository.deleteAll(); + departRepository.deleteAll(); + userRepository.deleteAll(); + + + DataAuthorizationContext.getInstance().clearDataAuthorizationFilters(); + + DataAuthorizationContext.getInstance().addDataAuthorizationFilter(new DefaultDataAuthorizationFilter() { + + @Override + public boolean supportRowAuthorization(String tableName, String tableAlias) { + User user = CurrentUser.getInstance().getUser(); + // 模拟仅当用户为lorne时，才进行行级过滤 + return user.getName().equalsIgnoreCase("bob"); + } + + @Override + public Condition rowAuthorization(String tableName, String tableAlias) { + if (tableName.equalsIgnoreCase("t_unit")) { + long unitId = CurrentUser.getInstance().getUser().getUnitId(); + String conditionTemplate = "%s.id = " + unitId; + return Condition.formatCondition(conditionTemplate, tableAlias); + } + if (tableName.equalsIgnoreCase("t_depart")) { + long departId = CurrentUser.getInstance().getUser().getDepartId(); + String conditionTemplate = "%s.id = " + departId; + + // 在条件处理的过程中，执行的查询都将不会被拦截 + List departs = departRepository.findAll(); + log.info("departs:{}", departs); + assertEquals(2, departs.size()); + + return Condition.formatCondition(conditionTemplate, tableAlias); + } + if (tableName.equalsIgnoreCase("t_user")) { + long departId = CurrentUser.getInstance().getUser().getDepartId(); + String conditionTemplate = "%s.depart_id = " + departId; + return Condition.formatCondition(conditionTemplate, tableAlias); + } + return null; + } + + }); + + Unit rootUnit = new Unit("Coding总公司"); + unitRepository.save(rootUnit); + + Unit sdUnit = new Unit("Coding山东分公司", rootUnit.getId()); + unitRepository.save(sdUnit); + + Depart jgbDepart = new Depart("Coding架构部", rootUnit.getId()); + departRepository.save(jgbDepart); + + Depart xmbDepart = new Depart("Coding项目部", sdUnit.getId()); + departRepository.save(xmbDepart); + + + User lorne = new User("lorne", LocalDate.parse("1991-01-01"), "beijing", "110105199003078999", "13812345678", jgbDepart); + User bob = new User("bob", LocalDate.parse("1991-01-01"), "beijing", "110105199003078999", "13812345678", xmbDepart); + User tom = new User("tom", LocalDate.parse("1991-01-01"), "beijing", "110105199003078999", "13812345678", xmbDepart); + + userRepository.save(lorne); + userRepository.save(bob); + userRepository.save(tom); + + + CurrentUser.getInstance().setUser(bob); + + + PageRequest request = PageRequest.of(0, 100); + Page users = userRepository.findAll(request); + + + System.out.println(users.getTotalElements()); + users.forEach(System.out::println); + + + assertEquals(2, users.getTotalElements()); + assertEquals(2, userRepository.count()); + assertEquals(1, departRepository.count()); + assertEquals(1, unitRepository.count()); + + } + + + @Test + @Order(2) + void test2() { + + unitRepository.deleteAll(); + departRepository.deleteAll(); + userRepository.deleteAll(); + + + ColumnMaskContext.getInstance().addColumnMask(new IDCardMask()); + ColumnMaskContext.getInstance().addColumnMask(new PhoneMask()); + ColumnMaskContext.getInstance().addColumnMask(new BankCardMask()); + + DataAuthorizationContext.getInstance().clearDataAuthorizationFilters(); + + DataAuthorizationContext.getInstance().addDataAuthorizationFilter(new DefaultDataAuthorizationFilter() { + @Override + public T columnAuthorization(String tableName, String columnName, T value) { + return ColumnMaskContext.getInstance().mask(value); + } + + @Override + public boolean supportColumnAuthorization(String tableName, String columnName, Object value) { + User user = CurrentUser.getInstance().getUser(); + return user != null && user.getName().equalsIgnoreCase("bob"); + } + + }); + + Unit rootUnit = new Unit("Coding总公司"); + unitRepository.save(rootUnit); + + Unit sdUnit = new Unit("Coding山东分公司", rootUnit.getId()); + unitRepository.save(sdUnit); + + Depart jgbDepart = new Depart("Coding架构部", rootUnit.getId()); + departRepository.save(jgbDepart); + + Depart xmbDepart = new Depart("Coding项目部", sdUnit.getId()); + departRepository.save(xmbDepart); + + + User lorne = new User("lorne", LocalDate.parse("1991-01-01"), "beijing", "110105199003078999", "13812345678", jgbDepart); + User bob = new User("bob", LocalDate.parse("1991-01-01"), "beijing", "110105199003078999", "13812345678", xmbDepart); + User tom = new User("tom", LocalDate.parse("1991-01-01"), "beijing", "110105199003078999", "13812345678", xmbDepart); + + userRepository.save(lorne); + userRepository.save(bob); + userRepository.save(tom); + + assertTrue(SQLRunningContext.getInstance().skipDataAuthorization(() -> userRepository.findAll()).size() >= 3); + + CurrentUser.getInstance().setUser(bob); + + PageRequest request = PageRequest.of(0, 100); + Page users = userRepository.findAll(request); + assertTrue(users.getTotalElements() >= 3); + + for (User user : users) { + assertEquals("138****5678", user.getPhone()); + } + + CurrentUser.getInstance().setUser(lorne); + + users = userRepository.findAll(request); + assertTrue(users.getTotalElements() >= 3); + + for (User user : users) { + assertEquals("13812345678", user.getPhone()); + } + + + } + + + @Test + @Order(3) + void test3() { + + unitRepository.deleteAll(); + departRepository.deleteAll(); + userRepository.deleteAll(); + + ColumnMaskContext.getInstance().addColumnMask(new IDCardMask()); + ColumnMaskContext.getInstance().addColumnMask(new PhoneMask()); + ColumnMaskContext.getInstance().addColumnMask(new BankCardMask()); + + DataAuthorizationContext.getInstance().clearDataAuthorizationFilters(); + + DataAuthorizationContext.getInstance().addDataAuthorizationFilter(new DefaultDataAuthorizationFilter() { + @Override + public T columnAuthorization(String tableName, String columnName, T value) { + return ColumnMaskContext.getInstance().mask(value); + } + + @Override + public boolean supportColumnAuthorization(String tableName, String columnName, Object value) { + return true; + } + + }); + + Unit rootUnit = new Unit("Coding总公司"); + unitRepository.save(rootUnit); + + Unit sdUnit = new Unit("Coding山东分公司", rootUnit.getId()); + unitRepository.save(sdUnit); + + Depart jgbDepart = new Depart("Coding架构部", rootUnit.getId()); + departRepository.save(jgbDepart); + + Depart xmbDepart = new Depart("Coding项目部", sdUnit.getId()); + departRepository.save(xmbDepart); + + User lorne = new User("lorne", LocalDate.parse("1991-01-01"), "beijing", "110105199003078999", "13812345678", jgbDepart); + User bob = new User("bob", LocalDate.parse("1991-01-01"), "beijing", "110105199003078999", "13812345678", xmbDepart); + User tom = new User("tom", LocalDate.parse("1991-01-01"), "beijing", "110105199003078999", "13812345678", xmbDepart); + + userRepository.save(lorne); + userRepository.save(bob); + userRepository.save(tom); + + List> users = jdbcTemplate.queryForList("select * from t_user"); + System.out.println(users); + assertEquals(3, users.size()); + + for (Map user : users) { + assertEquals("138****5678", user.get("phone")); + } + + } + + @Test + @Order(4) + void test4() throws Exception { + + unitRepository.deleteAll(); + departRepository.deleteAll(); + userRepository.deleteAll(); + + Unit rootUnit = new Unit("Coding总公司"); + unitRepository.save(rootUnit); + + Unit sdUnit = new Unit("Coding山东分公司", rootUnit.getId()); + unitRepository.save(sdUnit); + + Depart jgbDepart = new Depart("Coding架构部", rootUnit.getId()); + departRepository.save(jgbDepart); + + Depart xmbDepart = new Depart("Coding项目部", sdUnit.getId()); + departRepository.save(xmbDepart); + + User lorne = new User("lorne", LocalDate.parse("1991-01-01"), "beijing", "110105199003078999", "13812345678", jgbDepart); + User bob = new User("bob", LocalDate.parse("1991-01-01"), "beijing", "110105199003078999", "13812345678", xmbDepart); + User tom = new User("tom", LocalDate.parse("1991-01-01"), "beijing", "110105199003078999", "13812345678", xmbDepart); + + userRepository.save(lorne); + userRepository.save(bob); + userRepository.save(tom); + + String sql = "select * from t_user where phone like '%1%' and id > 1 and depart_id in (select id from t_depart where id > 0)"; + + + DataAuthorizationContext.getInstance().clearDataAuthorizationFilters(); + DataAuthorizationContext.getInstance().addDataAuthorizationFilter(new DefaultDataAuthorizationFilter() { + @Override + public Condition rowAuthorization(String tableName, String tableAlias) { + String conditionTemplate = "%s.id > -100 "; + return Condition.formatCondition(conditionTemplate, tableAlias); + } + + @Override + public T columnAuthorization(String tableName, String columnName, T value) { + System.out.println("tableName:" + tableName + ",columnName:" + columnName + ",value:" + value); + return value; + } + + @Override + public boolean supportColumnAuthorization(String tableName, String columnName, Object value) { + if ("t_depart".equalsIgnoreCase(tableName)) { + return true; + } + return false; + } + + @Override + public boolean supportRowAuthorization(String tableName, String tableAlias) { + if ("t_depart".equalsIgnoreCase(tableName)) { + return true; + } + return false; + } + }); + + List> data = jdbcTemplate.queryForList(sql); + System.out.println(data); + } + + + + @Test + @Order(5) + void test5() throws Exception{ + + unitRepository.deleteAll(); + departRepository.deleteAll(); + userRepository.deleteAll(); + + Unit rootUnit = new Unit("Coding总公司"); + unitRepository.save(rootUnit); + + Unit sdUnit = new Unit("Coding山东分公司", rootUnit.getId()); + unitRepository.save(sdUnit); + + Depart jgbDepart = new Depart("Coding架构部", rootUnit.getId()); + departRepository.save(jgbDepart); + + Depart xmbDepart = new Depart("Coding项目部", sdUnit.getId()); + departRepository.save(xmbDepart); + + User lorne = new User("lorne", LocalDate.parse("1991-01-01"), "beijing", "110105199003078999", "13812345678", jgbDepart); + User bob = new User("bob", LocalDate.parse("1991-01-01"), "beijing", "110105199003078999", "13812345678", xmbDepart); + User tom = new User("tom", LocalDate.parse("1991-01-01"), "beijing", "110105199003078999", "13812345678", xmbDepart); + + userRepository.save(lorne); + userRepository.save(bob); + userRepository.save(tom); + + String sql = "select * from t_user where phone like '%1%' and id > 1 and depart_id in (select id from t_depart where id > 0) "; + + DataAuthorizationContext.getInstance().clearDataAuthorizationFilters(); + + DataAuthorizationContext.getInstance().setSkipAuthorizationFilter(new SkipAuthorizationFilter(){ + @Override + public String filter(String sql) { + return sql.replace("and depart_id in (select id from t_depart where id > 0) ",""); + } + }); + + SQLRunningContext.getInstance().skipDataAuthorization(()->{ + List> data = jdbcTemplate.queryForList(sql); + System.out.println(data); + }); + + } + + + + @Test + @Order(6) + void test6() throws Exception{ + + unitRepository.deleteAll(); + departRepository.deleteAll(); + userRepository.deleteAll(); + + Unit rootUnit = new Unit("Coding总公司"); + unitRepository.save(rootUnit); + + Unit sdUnit = new Unit("Coding山东分公司", rootUnit.getId()); + unitRepository.save(sdUnit); + + Depart jgbDepart = new Depart("Coding架构部", rootUnit.getId()); + departRepository.save(jgbDepart); + + Depart xmbDepart = new Depart("Coding项目部", sdUnit.getId()); + departRepository.save(xmbDepart); + + User lorne = new User("lorne", LocalDate.parse("1991-01-01"), "beijing", "110105199003078999", "13812345678", jgbDepart); + User bob = new User("bob", LocalDate.parse("1991-01-01"), "beijing", "110105199003078999", "13812345678", xmbDepart); + User tom = new User("tom", LocalDate.parse("1991-01-01"), "beijing", "110105199003078999", "13812345678", xmbDepart); + + userRepository.save(lorne); + userRepository.save(bob); + userRepository.save(tom); + + String sql = "select u.* from t_user u where u.phone like '%1%' and u.id > 1 and u.depart_id in (select d.id from t_depart d where d.id > 0) "; + + DataAuthorizationContext.getInstance().clearDataAuthorizationFilters(); + DataAuthorizationContext.getInstance().addDataAuthorizationFilter(new DefaultDataAuthorizationFilter() { + @Override + public Condition rowAuthorization(String tableName, String tableAlias) { + String conditionTemplate = "%s.id > -100 "; + Condition condition = new Condition(); + condition.addConditionSQL(new WhereConditionSQL(conditionTemplate, tableAlias)); + condition.addConditionSQL(new JoinConditionSQL( + JoinConditionSQL.Type.INNER, + "t_unit", + "u", + "u.id = "+tableAlias+".id")); + return condition; + } + + @Override + public T columnAuthorization(String tableName, String columnName, T value) { + System.out.println("tableName:" + tableName + ",columnName:" + columnName + ",value:" + value); + return value; + } + + @Override + public boolean supportColumnAuthorization(String tableName, String columnName, Object value) { + if ("t_depart".equalsIgnoreCase(tableName)) { + return true; + } + return false; + } + + @Override + public boolean supportRowAuthorization(String tableName, String tableAlias) { + if ("t_depart".equalsIgnoreCase(tableName)) { + return true; + } + return false; + } + }); + + List> data = jdbcTemplate.queryForList(sql); + System.out.println(data); + + } + + +} diff --git a/springboot-starter-data-authorization/src/test/java/com/codingapi/springboot/authorization/DataAuthorizationTestApplication.java b/springboot-starter-data-authorization/src/test/java/com/codingapi/springboot/authorization/DataAuthorizationTestApplication.java new file mode 100644 index 000000000..0760ec6a3 --- /dev/null +++ b/springboot-starter-data-authorization/src/test/java/com/codingapi/springboot/authorization/DataAuthorizationTestApplication.java @@ -0,0 +1,13 @@ +package com.codingapi.springboot.authorization; + +import org.springframework.boot.SpringApplication; +import org.springframework.boot.autoconfigure.SpringBootApplication; + +@SpringBootApplication +public class DataAuthorizationTestApplication { + + public static void main(String[] args) { + SpringApplication.run(DataAuthorizationConfiguration.class,args); + } + +} diff --git a/springboot-starter-data-authorization/src/test/java/com/codingapi/springboot/authorization/analyzer/Issue212ResultSetColumnTest.java b/springboot-starter-data-authorization/src/test/java/com/codingapi/springboot/authorization/analyzer/Issue212ResultSetColumnTest.java new file mode 100644 index 000000000..74c6fc783 --- /dev/null +++ b/springboot-starter-data-authorization/src/test/java/com/codingapi/springboot/authorization/analyzer/Issue212ResultSetColumnTest.java @@ -0,0 +1,174 @@ +package com.codingapi.springboot.authorization.analyzer; + +import com.codingapi.springboot.authorization.DataAuthorizationContext; +import com.codingapi.springboot.authorization.enhancer.DataPermissionSQLEnhancer; +import com.codingapi.springboot.authorization.filter.DataAuthorizationFilter; +import com.codingapi.springboot.authorization.handler.Condition; +import com.codingapi.springboot.authorization.interceptor.SQLExecuteState; +import com.codingapi.springboot.authorization.jdbc.proxy.ResultSetProxy; +import org.junit.jupiter.api.AfterAll; +import org.junit.jupiter.api.BeforeEach; +import org.junit.jupiter.api.Test; + +import java.sql.Connection; +import java.sql.DriverManager; +import java.sql.PreparedStatement; +import java.sql.ResultSet; +import java.sql.SQLException; +import java.sql.Statement; +import java.util.ArrayList; +import java.util.List; + +import static org.junit.jupiter.api.Assertions.*; + +/** + * GitHub Issue #212 复现测试（ResultSet 列元数据 → 物理表/字段解析）。 + *

+ * 场景：查询引擎将业务 SQL 包装为分页 SQL + * 

SELECT ... FROM ( ... ) AS __base__ WHERE 1 = 1 LIMIT ? OFFSET ?
+ * 此时候选结果集列的 ResultSetMetaData.getTableName() 不再是物理表名 + * （为空串或派生表别名），列又没有表限定符，导致框架无法把结果列 + * （如 CARD_NO）映射回物理表 T_DYNAMIC_BIZ_PBM_EMP_BASIC_INFO.card_no， + * DataAuthorizationFilter.supportColumnAuthorization 收到 tableName=""， + * 列权限/脱敏失效（见 issue 截图调试现场）。 + */ +class Issue212ResultSetColumnTest { + + private static final String EMP_TABLE = "T_DYNAMIC_BIZ_PBM_EMP_BASIC_INFO"; + private static final String ID_CARD = "522101196612113210"; + + /** + * 与 issue #212 相同结构的分页包装 SQL（列做了裁剪，结构与问题一致： + * 外层裸列名投影 + FROM 派生表 AS __base__ + LIMIT ? OFFSET ?） + */ + private static final String WRAPPER_SQL = String.join("\n", + "SELECT", + " id,", + " unit_name,", + " card_no", + "FROM", + " (", + " SELECT", + " emp.*,", + " org.SYSTEM_CODE AS orgCode", + " FROM", + " T_DYNAMIC_BIZ_PBM_EMP_BASIC_INFO emp", + " LEFT JOIN BIZ_PBM_ORGANIZATION org ON org.id = emp.department_id", + " WHERE", + " emp.sys_deleted = 0", + " ) AS __base__", + "WHERE", + " 1 = 1", + "LIMIT", + " ?", + "OFFSET", + " ?"); + + /** 记录框架回调 DataAuthorizationFilter 时传入的表名/列名 */ + static class RecordingFilter implements DataAuthorizationFilter { + + final List invocations = new ArrayList<>(); + + @Override + public T columnAuthorization(String tableName, String columnName, T value) { + return value; + } + + @Override + public Condition rowAuthorization(String tableName, String tableAlias) { + return null; + } + + @Override + public boolean supportColumnAuthorization(String tableName, String columnName, Object value) { + invocations.add(new String[]{tableName, columnName}); + return false; + } + + @Override + public boolean supportRowAuthorization(String tableName, String tableAlias) { + return false; + } + } + + private Connection connection; + + @BeforeEach + void setUp() throws SQLException { + connection = DriverManager.getConnection("jdbc:h2:mem:issue212_rs;DB_CLOSE_DELAY=-1"); + try (Statement statement = connection.createStatement()) { + statement.execute("DROP ALL OBJECTS"); + statement.execute("CREATE TABLE " + EMP_TABLE + " (" + + "id BIGINT PRIMARY KEY," + + "unit_name VARCHAR(64)," + + "card_no VARCHAR(32)," + + "department_id BIGINT," + + "sys_deleted INT)"); + statement.execute("CREATE TABLE BIZ_PBM_ORGANIZATION (" + + "id BIGINT PRIMARY KEY," + + "SYSTEM_CODE VARCHAR(32)," + + "tree_sort VARCHAR(64))"); + try (PreparedStatement ps = connection.prepareStatement( + "INSERT INTO " + EMP_TABLE + " VALUES (1, '单位A', ?, 10, 0)")) { + ps.setString(1, ID_CARD); + ps.executeUpdate(); + } + try (PreparedStatement ps = connection.prepareStatement( + "INSERT INTO BIZ_PBM_ORGANIZATION VALUES (10, 'ORG001', '1')")) { + ps.executeUpdate(); + } + } + } + + @AfterAll + static void tearDownAll() throws SQLException { + try (Connection conn = DriverManager.getConnection("jdbc:h2:mem:issue212_rs;DB_CLOSE_DELAY=-1"); + Statement st = conn.createStatement()) { + st.execute("DROP ALL OBJECTS"); + } + } + + @Test + void shouldResolvePhysicalTableAndColumnForPagingWrappedSQL() throws Exception { + // 1. 走框架真实链路：增强器提取表/字段别名 → SQLExecuteState → ResultSetProxy + DataPermissionSQLEnhancer enhancer = + new DataPermissionSQLEnhancer(WRAPPER_SQL, (subSql, tableName, tableAlias) -> null); + String newSql = enhancer.getNewSQL(); + SQLExecuteState executeState = SQLExecuteState.intercept(WRAPPER_SQL, newSql, enhancer.getTableAlias()); + + RecordingFilter filter = new RecordingFilter(); + DataAuthorizationContext context = DataAuthorizationContext.getInstance(); + context.addDataAuthorizationFilter(filter); + try { + try (PreparedStatement ps = connection.prepareStatement(executeState.getSql())) { + ps.setInt(1, 10); + ps.setInt(2, 0); + try (ResultSet rs = ps.executeQuery()) { + ResultSetProxy proxy = new ResultSetProxy(rs, executeState); + assertTrue(proxy.next(), "应查询到测试数据"); + + // 读取 CARD_NO 列（触发列权限回调） + String value = proxy.getString("card_no"); + assertEquals(ID_CARD, value); + } + } + } finally { + context.clearDataAuthorizationFilters(); + } + + assertFalse(filter.invocations.isEmpty(), "列权限回调未触发"); + String[] cardNoInvocation = filter.invocations.stream() + .filter(inv -> inv[1] != null && inv[1].equalsIgnoreCase("card_no")) + .findFirst() + .orElseThrow(() -> new AssertionError("未捕获到 card_no 列回调: " + + filter.invocations.stream().map(inv -> inv[0] + "." + inv[1]) + .collect(java.util.stream.Collectors.toList()))); + + // 2. 期望：框架应将派生表 __base__ 的裸列解析回物理表/字段 + // （issue 现场为 tableName=""，列脱敏/权限因此失效） + assertEquals(EMP_TABLE, cardNoInvocation[0], + "Issue #212: 分页包装 SQL 的结果列未能解析出物理表名"); + assertTrue("card_no".equalsIgnoreCase(cardNoInvocation[1]), + "Issue #212: 分页包装 SQL 的结果列未能解析出物理字段名, 实际: " + cardNoInvocation[1]); + } +} diff --git a/springboot-starter-data-authorization/src/test/java/com/codingapi/springboot/authorization/analyzer/Issue212SQLTest.java b/springboot-starter-data-authorization/src/test/java/com/codingapi/springboot/authorization/analyzer/Issue212SQLTest.java new file mode 100644 index 000000000..ac30d1aa5 --- /dev/null +++ b/springboot-starter-data-authorization/src/test/java/com/codingapi/springboot/authorization/analyzer/Issue212SQLTest.java @@ -0,0 +1,119 @@ +package com.codingapi.springboot.authorization.analyzer; + +import com.codingapi.springboot.authorization.enhancer.DataPermissionSQLEnhancer; +import com.codingapi.springboot.authorization.enhancer.TableColumnAliasContext; +import com.codingapi.springboot.authorization.handler.Condition; +import com.codingapi.springboot.authorization.handler.RowHandler; +import org.junit.jupiter.api.Test; + +import java.io.ByteArrayOutputStream; +import java.io.IOException; +import java.io.InputStream; +import java.io.UncheckedIOException; +import java.nio.charset.StandardCharsets; +import java.sql.SQLException; + +import static org.junit.jupiter.api.Assertions.*; + +/** + * GitHub Issue #212 复现测试 + *

+ * 如下SQL无法正常的提取到表名和字段数据信息（原始SQL见 test resources issue212.sql）： + * 外层为分页包装的子查询（FROM ( ... ) AS __base__），内层为多表 LEFT JOIN， + * 且 JOIN 对象包含 ROW_NUMBER() OVER (PARTITION BY ...) 窗口函数派生表、 + * CAST、CASE WHEN、ORDER BY ... NULLS LAST 等复杂表达式。 + */ +class Issue212SQLTest { + + private static final String SQL = loadResource("issue212.sql"); + + private static String loadResource(String name) { + try (InputStream in = Issue212SQLTest.class.getClassLoader().getResourceAsStream(name)) { + assertNotNull(in, "测试资源缺失: " + name); + ByteArrayOutputStream out = new ByteArrayOutputStream(); + byte[] buffer = new byte[4096]; + int len; + while ((len = in.read(buffer)) != -1) { + out.write(buffer, 0, len); + } + return new String(out.toByteArray(), StandardCharsets.UTF_8); + } catch (IOException e) { + throw new UncheckedIOException(e); + } + } + + /** + * 对员工基础信息表注入行权限条件：%s.unit_id = 1000 + */ + private static RowHandler rowHandler() { + return (subSql, tableName, tableAlias) -> { + if (tableName.equalsIgnoreCase("T_DYNAMIC_BIZ_PBM_EMP_BASIC_INFO")) { + return Condition.formatCondition("%s.unit_id = 1000", tableAlias); + } + return null; + }; + } + + @Test + void complexSQLShouldBeParsed() throws SQLException { + DataPermissionSQLEnhancer builder = new DataPermissionSQLEnhancer(SQL, rowHandler()); + assertNotNull(builder.getTableAlias(), "表别名上下文不应为空"); + } + + @Test + void shouldExtractAllPhysicalTables() throws SQLException { + DataPermissionSQLEnhancer builder = new DataPermissionSQLEnhancer(SQL, rowHandler()); + builder.getNewSQL(); + TableColumnAliasContext context = builder.getTableAlias(); + System.out.println("tableAlias = " + context.getTableAlias()); + + // 嵌套 LEFT JOIN 子查询中的物理表都应被提取到 + assertEquals("T_DYNAMIC_BIZ_PBM_EMP_BASIC_INFO", context.getTableName("emp")); + assertEquals("BIZ_PBM_ORGANIZATION", context.getTableName("org")); + assertEquals("BIZ_PBM_POST", context.getTableName("post")); + assertEquals("T_DYNAMIC_BIZ_PBM_EMP_EDUCATION_HIGHEST", context.getTableName("e")); + assertEquals("T_DYNAMIC_BIZ_PBM_EMP_TECHNOLOGY_HIGHEST", context.getTableName("t")); + assertEquals("T_DYNAMIC_BIZ_PBM_EMP_SKILL_HIGHEST", context.getTableName("s")); + assertEquals("T_DYNAMIC_BIZ_PBM_EMP_POSITION", context.getTableName("p")); + } + + @Test + void shouldInjectPermissionConditionIntoNestedTable() throws SQLException { + DataPermissionSQLEnhancer builder = new DataPermissionSQLEnhancer(SQL, rowHandler()); + String newSql = builder.getNewSQL(); + System.out.println("newSql = " + newSql); + + // 权限条件必须被注入到内层 emp 表的 WHERE 中 + assertTrue(newSql.contains("emp.unit_id = 1000"), + "行权限条件未注入到嵌套子查询的 emp 表，提取/增强失败"); + } + + @Test + void shouldResolveDerivedColumnsOnIssueSQL() throws SQLException { + DataPermissionSQLEnhancer builder = new DataPermissionSQLEnhancer(SQL, rowHandler()); + builder.getNewSQL(); + TableColumnAliasContext context = builder.getTableAlias(); + + // 元数据表名为派生别名 __base__（H2 等）或空串（PG，issue 截图现场）时， + // 裸列应能沿多层派生链归因到物理表字段： + + // emp.* 单星展开归因 + assertArrayEquals(new String[]{"T_DYNAMIC_BIZ_PBM_EMP_BASIC_INFO", "card_no"}, + context.resolveTableNameAndColumn("__base__", "card_no")); + // 二级派生链：curpos -> c -> p + assertArrayEquals(new String[]{"T_DYNAMIC_BIZ_PBM_EMP_POSITION", "position_hierarchy_code"}, + context.resolveTableNameAndColumn("", "position_hierarchy_code")); + // 一层派生：skill 子查询 + assertArrayEquals(new String[]{"T_DYNAMIC_BIZ_PBM_EMP_SKILL_HIGHEST", "highest_skill_name"}, + context.resolveTableNameAndColumn("__BASE__", "highest_skill_name")); + // 显式别名投影：org.SYSTEM_CODE AS orgCode + assertArrayEquals(new String[]{"BIZ_PBM_ORGANIZATION", "SYSTEM_CODE"}, + context.resolveTableNameAndColumn("", "orgCode")); + // JOIN 直连表：post.post_type_code + assertArrayEquals(new String[]{"BIZ_PBM_POST", "post_type_code"}, + context.resolveTableNameAndColumn("__base__", "post_type_code")); + // 多义列（多个派生表均含 employee_id 且归属不同物理表）：保守回退，不误归因 + assertArrayEquals(new String[]{"", "employee_id"}, + context.resolveTableNameAndColumn("", "employee_id")); + } +} diff --git a/springboot-starter-data-authorization/src/test/java/com/codingapi/springboot/authorization/analyzer/SelectSQLAnalyzerTest.java b/springboot-starter-data-authorization/src/test/java/com/codingapi/springboot/authorization/analyzer/SelectSQLAnalyzerTest.java new file mode 100644 index 000000000..01b95158e --- /dev/null +++ b/springboot-starter-data-authorization/src/test/java/com/codingapi/springboot/authorization/analyzer/SelectSQLAnalyzerTest.java @@ -0,0 +1,266 @@ +package com.codingapi.springboot.authorization.analyzer; + +import com.codingapi.springboot.authorization.enhancer.DataPermissionSQLEnhancer; +import com.codingapi.springboot.authorization.handler.Condition; +import com.codingapi.springboot.authorization.handler.RowHandler; +import org.junit.jupiter.api.Order; +import org.junit.jupiter.api.Test; + +import java.sql.SQLException; + +import static org.junit.jupiter.api.Assertions.*; + +class SelectSQLAnalyzerTest { + + + @Test + void test1() throws SQLException { + String sql = "select t1.*,t2.* from (SELECT * FROM t_employee as a2 WHERE id = 100 ) t1 ," + + " (SELECT * FROM t_employee as a1 ) t2 ," + + " (select * from t_employee a3 left join t_unit u on a3.unit_id = u.id ) t3 ," + + " (select 1 =1 ) as t4 " + + " limit 100"; + + RowHandler rowHandler = (subSql, tableName, tableAlias) -> { + if (tableName.equalsIgnoreCase("t_employee")) { + String conditionTemplate = "%s.id > 100 "; + return Condition.formatCondition(conditionTemplate, tableAlias); + } + return null; + }; + + DataPermissionSQLEnhancer builder = new DataPermissionSQLEnhancer(sql, rowHandler); + String newSql = builder.getNewSQL(); + System.out.println(newSql); + //SELECT t1.*, t2.* FROM (SELECT * FROM t_employee AS a2 WHERE a2.id > 100 AND id = 100) t1, + // (SELECT * FROM t_employee AS a1 WHERE a1.id > 100) t2, + // (SELECT * FROM t_employee a3 LEFT JOIN t_unit u ON a3.unit_id = u.id WHERE a3.id > 100) t3, + // (SELECT 1 = 1) AS t4 LIMIT 100 + assertEquals( + "SELECT t1.*, t2.* FROM (SELECT * FROM t_employee AS a2 WHERE a2.id > 100 AND id = 100) t1," + + " (SELECT * FROM t_employee AS a1 WHERE a1.id > 100) t2, " + + "(SELECT * FROM t_employee a3 LEFT JOIN t_unit u ON a3.unit_id = u.id WHERE a3.id > 100) t3, " + + "(SELECT 1 = 1) AS t4 LIMIT 100", newSql); + } + + @Test + void test2() throws SQLException { + String sql = "select e1_0.id,e1_0.address,e1_0.birth_date,e1_0.depart_id,e1_0.id_card,e1_0.name,e1_0.phone,e1_0.post_id,e1_0.work_id from t_employee e1_0 limit ?,?"; + + RowHandler rowHandler = (subSql, tableName, tableAlias) -> { + if (tableName.equalsIgnoreCase("t_employee")) { + String conditionTemplate = "%s.id > 100 "; + return Condition.formatCondition(conditionTemplate, tableAlias); + } + return null; + }; + + DataPermissionSQLEnhancer builder = new DataPermissionSQLEnhancer(sql, rowHandler); + String newSql = builder.getNewSQL(); + System.out.println(newSql); + assertEquals("SELECT e1_0.id, e1_0.address, e1_0.birth_date, e1_0.depart_id, e1_0.id_card, e1_0.name, e1_0.phone, e1_0.post_id, e1_0.work_id FROM t_employee e1_0 WHERE e1_0.id > 100 LIMIT ?, ?", newSql); } + + + @Test + void test3() throws SQLException { + String sql = "select aue1_0.ba_org_code from ba03_administrative_unit aue1_0 where aue1_0.ba_org_code like (?||'__') order by aue1_0.ba_org_code desc"; + + RowHandler rowHandler = (subSql, tableName, tableAlias) -> { + if (tableName.equalsIgnoreCase("ba03_administrative_unit")) { + String conditionTemplate = "%s.id > 100 "; + return Condition.formatCondition(conditionTemplate, tableAlias); + } + return null; + }; + + DataPermissionSQLEnhancer builder = new DataPermissionSQLEnhancer(sql, rowHandler); + String newSql = builder.getNewSQL(); + System.out.println(newSql); + assertEquals("SELECT aue1_0.ba_org_code FROM ba03_administrative_unit aue1_0 WHERE aue1_0.id > 100 AND aue1_0.ba_org_code LIKE (? || '__') ORDER BY aue1_0.ba_org_code DESC", newSql); + } + + @Test + void test4() throws SQLException{ + String sql = "SELECT\n" + + "\tUNYiV.id AS '历史工作经历编号',\n" + + "\tUNYiV.company_name AS '历史工作单位',\n" + + "\tUNYiV.depart_name AS '历史工作部门',\n" + + "\tUNYiV.post_name AS '历史工作岗位',\n" + + "\tUNYiV.start_date AS '开始时间',\n" + + "\tUNYiV.end_date AS '结束时间',\n" + + "\towasH.员工编号 AS '员工编号',\n" + + "\towasH.员工姓名 AS '员工姓名',\n" + + "\towasH.员工生日 AS '员工生日',\n" + + "\towasH.员工地址 AS '员工地址',\n" + + "\towasH.身份证号码 AS '身份证号码',\n" + + "\towasH.手机号 AS '手机号',\n" + + "\towasH.部门编号 AS '部门编号',\n" + + "\towasH.岗位编号 AS '岗位编号',\n" + + "\towasH.任现职编号 AS '任现职编号',\n" + + "\towasH.社团编号 AS '社团编号',\n" + + "\towasH.社团名称 AS '社团名称',\n" + + "\towasH.创建时间 AS '创建时间' \n" + + "FROM\n" + + "\tt_work AS pehMS,\n" + + "\tt_employee AS OGwG7,\n" + + "\tt_work_history AS UNYiV,\n" + + "\t(\n" + + "\t\tSELECT\n" + + "\t\t\tWXJj8.id AS '员工编号',\n" + + "\t\t\tWXJj8.NAME AS '员工姓名',\n" + + "\t\t\tWXJj8.birth_date AS '员工生日',\n" + + "\t\t\tWXJj8.address AS '员工地址',\n" + + "\t\t\tWXJj8.id_card AS '身份证号码',\n" + + "\t\t\tWXJj8.phone AS '手机号',\n" + + "\t\t\tWXJj8.depart_id AS '部门编号',\n" + + "\t\t\tWXJj8.post_id AS '岗位编号',\n" + + "\t\t\tWXJj8.work_id AS '任现职编号',\n" + + "\t\t\trnGD4.id AS '社团编号',\n" + + "\t\t\trnGD4.NAME AS '社团名称',\n" + + "\t\t\trnGD4.create_date AS '创建时间' \n" + + "\t\tFROM\n" + + "\t\t\tt_employee AS WXJj8,\n" + + "\t\t\tt_league_employee AS dEj96,\n" + + "\t\t\tt_league AS rnGD4 \n" + + "\t\tWHERE\n" + + "\t\t\tdEj96.employee_id = WXJj8.id \n" + + "\t\t\tAND dEj96.league_id = rnGD4.id \n" + + "\t\t\tAND 1 = 1 \n" + + "\t) AS owasH \n" + + "WHERE\n" + + "\tUNYiV.employee_id = OGwG7.id \n" + + "\tAND OGwG7.work_id = pehMS.id \n" + + "\tAND owasH.任现职编号 = pehMS.id \n" + + "\tAND 1 = 1"; + + + RowHandler rowHandler = (subSql, tableName, tableAlias) -> { + if (tableName.equalsIgnoreCase("t_league")) { + String conditionTemplate = "%s.id < 100 "; + return Condition.formatCondition(conditionTemplate, tableAlias); + } + return null; + }; + + DataPermissionSQLEnhancer builder = new DataPermissionSQLEnhancer(sql, rowHandler); + System.out.println(builder.getNewSQL()); + System.out.println(builder.getTableAlias());; + } + + @Test + @Order(5) + void test5() throws Exception{ + String sql = "SELECT next_val AS id_val FROM t_league_seq FOR UPDATE"; + RowHandler rowHandler = (subSql, tableName, tableAlias) -> { + if (tableName.equalsIgnoreCase("t_league")) { + String conditionTemplate = "%s.id < 100 "; + return Condition.formatCondition(conditionTemplate, tableAlias); + } + return null; + }; + DataPermissionSQLEnhancer builder = new DataPermissionSQLEnhancer(sql, rowHandler); + System.out.println(builder.getNewSQL()); + System.out.println(builder.getTableAlias());; + } + + + @Test + @Order(6) + void test6() throws Exception{ + String sql = "SELECT 1=1"; + RowHandler rowHandler = (subSql, tableName, tableAlias) -> { + if (tableName.equalsIgnoreCase("t_league")) { + String conditionTemplate = "%s.id < 100 "; + return Condition.formatCondition(conditionTemplate, tableAlias); + } + return null; + }; + DataPermissionSQLEnhancer builder = new DataPermissionSQLEnhancer(sql, rowHandler); + System.out.println(builder.getNewSQL()); + System.out.println(builder.getTableAlias());; + } + + @Test + @Order(7) + void test7() throws Exception{ + String sql = "SELECT * from t_employee"; + RowHandler rowHandler = (subSql, tableName, tableAlias) -> { + if (tableName.equalsIgnoreCase("t_employee")) { + String conditionTemplate = "%s.id < 100 "; + return Condition.formatCondition(conditionTemplate, tableAlias); + } + return null; + }; + DataPermissionSQLEnhancer builder = new DataPermissionSQLEnhancer(sql, rowHandler); + System.out.println(builder.getNewSQL()); + System.out.println(builder.getTableAlias());; + } + + @Test + @Order(8) + void test8() throws Exception{ + String sql = "select ade1_0.id,ade1_0.ba_dept_name,ade1_0.ba_org_shortname,ade1_0.ba_dept_code,ade1_0.ba_code,ade1_0.ba_dept_property_code,ade1_0.ba_parent_type,ade1_0.ba_real_super_org_id,ade1_0.ba_org_is_avoidance_dept,ade1_0.ba_real_super_org_id,ade1_0.ba_super_org_name " + + "from ba04_administrative_department ade1_0 where ade1_0.ba_parent_type=0" + + " union all select ade2_0.id,ade2_0.ba_dept_name,ade2_0.ba_org_shortname,ade2_0.ba_dept_code,ade2_0.ba_code,ade2_0.ba_dept_property_code,ade2_0.ba_parent_type,ade2_0.ba_real_super_org_id,ade2_0.ba_org_is_avoidance_dept,ade3_0.ba_real_super_org_id,ade3_0.ba_super_org_name" + + " from ba04_administrative_department ade2_0 left join ba04_administrative_department ade3_0 on ade2_0.ba_real_super_org_id=ade3_0.id " + + "where ade2_0.ba_real_super_org_id=1"; + + + + RowHandler rowHandler = (subSql, tableName, tableAlias) -> { + if (tableName.equalsIgnoreCase("ba04_administrative_department")) { + String conditionTemplate = "%s.id < 100 "; + return Condition.formatCondition(conditionTemplate, tableAlias); + } + return null; + }; + DataPermissionSQLEnhancer builder = new DataPermissionSQLEnhancer(sql, rowHandler); + String newSQL = builder.getNewSQL(); + System.out.println(newSQL); + System.out.println(builder.getTableAlias()); + assertEquals("SELECT ade1_0.id, ade1_0.ba_dept_name, ade1_0.ba_org_shortname, ade1_0.ba_dept_code, ade1_0.ba_code, ade1_0.ba_dept_property_code, ade1_0.ba_parent_type, ade1_0.ba_real_super_org_id, ade1_0.ba_org_is_avoidance_dept, ade1_0.ba_real_super_org_id, ade1_0.ba_super_org_name FROM ba04_administrative_department ade1_0 WHERE ade1_0.id < 100 AND ade1_0.ba_parent_type = 0 " + + "UNION ALL SELECT ade2_0.id, ade2_0.ba_dept_name, ade2_0.ba_org_shortname, ade2_0.ba_dept_code, ade2_0.ba_code, ade2_0.ba_dept_property_code, ade2_0.ba_parent_type, ade2_0.ba_real_super_org_id, ade2_0.ba_org_is_avoidance_dept, ade3_0.ba_real_super_org_id, ade3_0.ba_super_org_name FROM ba04_administrative_department ade2_0 LEFT JOIN ba04_administrative_department ade3_0 ON ade2_0.ba_real_super_org_id = ade3_0.id WHERE ade3_0.id < 100 AND ade2_0.id < 100 AND ade2_0.ba_real_super_org_id = 1", newSQL); + } + + + @Test + @Order(9) + void test9() throws Exception{ + String sql = "select cd.id,cd.name,cd.parent_id from depart cd join depart pd on cd.id = pd.parent_id where cd.id = ?"; + + RowHandler rowHandler = (subSql, tableName, tableAlias) -> { + if (tableName.equalsIgnoreCase("depart") && tableAlias.equalsIgnoreCase("cd")) { + String conditionTemplate = "%s.id = 100 "; + return Condition.formatCondition(conditionTemplate, tableAlias); + } + return null; + }; + DataPermissionSQLEnhancer builder = new DataPermissionSQLEnhancer(sql, rowHandler); + String newSQL = builder.getNewSQL(); + System.out.println(newSQL); + System.out.println(builder.getTableAlias().getTableAlias()); + assertEquals("SELECT cd.id, cd.name, cd.parent_id FROM depart cd JOIN depart pd ON cd.id = pd.parent_id WHERE cd.id = 100 AND cd.id = ?",newSQL); + } + + + + @Test + @Order(10) + void test10() throws Exception{ + String sql = "SELECT * FROM ( SELECT TMP.*, ROWNUM ROW_ID FROM ( SELECT t.id,t.parent_id,t.type,t.target_id,t.system_code,t.full_name,t.short_name,t.system_short_name,t.full_name_tair,t.short_name_tair,t.system_short_name_tair,t.tree_sort,t.sys_creator_id,t.sys_updater_id,t.sys_create_time,t.sys_update_time,t.sys_deleted,t.sys_enabled,parent.short_name AS parentName,parent.type AS parentType,if(parent.type=0,'单位','部门') AS parentTypeText FROM sys_u_organization t LEFT JOIN sys_u_organization parent ON (parent.id = t.parent_id AND parent.sys_deleted=0) LEFT JOIN sys_u_company t2 ON (t2.organization_id = t.id AND t2.sys_deleted=0) WHERE t.sys_deleted=0 AND (t.id <> ? AND t.type = ? AND t.system_code LIKE ?) ORDER BY t.tree_sort ASC,t.tree_sort ASC ) TMP WHERE ROWNUM <=?) WHERE ROW_ID > ?"; + + RowHandler rowHandler = (subSql, tableName, tableAlias) -> { + if (tableName.equalsIgnoreCase("sys_u_organization")) { + String conditionTemplate = "%s.id < 100 "; + return Condition.formatCondition(conditionTemplate, tableAlias); + } + return null; + }; + DataPermissionSQLEnhancer builder = new DataPermissionSQLEnhancer(sql, rowHandler); + String newSQL = builder.getNewSQL(); + System.out.println(newSQL); + System.out.println(builder.getTableAlias().getTableAlias()); + assertEquals("SELECT * FROM (SELECT TMP.*, ROWNUM ROW_ID FROM (SELECT t.id, t.parent_id, t.type, t.target_id, t.system_code, t.full_name, t.short_name, t.system_short_name, t.full_name_tair, t.short_name_tair, t.system_short_name_tair, t.tree_sort, t.sys_creator_id, t.sys_updater_id, t.sys_create_time, t.sys_update_time, t.sys_deleted, t.sys_enabled, parent.short_name AS parentName, parent.type AS parentType, if(parent.type = 0, '单位', '部门') AS parentTypeText FROM sys_u_organization t LEFT JOIN sys_u_organization parent ON (parent.id = t.parent_id AND parent.sys_deleted = 0) LEFT JOIN sys_u_company t2 ON (t2.organization_id = t.id AND t2.sys_deleted = 0) WHERE parent.id < 100 AND t.id < 100 AND t.sys_deleted = 0 AND (t.id <> ? AND t.type = ? AND t.system_code LIKE ?) ORDER BY t.tree_sort ASC, t.tree_sort ASC) TMP WHERE ROWNUM <= ?) WHERE ROW_ID > ?", newSQL); + } + +} \ No newline at end of file diff --git a/springboot-starter-data-authorization/src/test/java/com/codingapi/springboot/authorization/current/CurrentUser.java b/springboot-starter-data-authorization/src/test/java/com/codingapi/springboot/authorization/current/CurrentUser.java new file mode 100644 index 000000000..186c3d007 --- /dev/null +++ b/springboot-starter-data-authorization/src/test/java/com/codingapi/springboot/authorization/current/CurrentUser.java @@ -0,0 +1,27 @@ +package com.codingapi.springboot.authorization.current; + +import com.codingapi.springboot.authorization.entity.User; +import lombok.Getter; + +public class CurrentUser { + + @Getter + private final static CurrentUser instance = new CurrentUser(); + + private final ThreadLocal threadLocal = new ThreadLocal<>(); + + private CurrentUser(){ + } + + public void setUser(User user){ + threadLocal.set(user); + } + + public User getUser(){ + return threadLocal.get(); + } + + public void remove(){ + threadLocal.remove(); + } +} diff --git a/springboot-starter-data-authorization/src/test/java/com/codingapi/springboot/authorization/entity/Depart.java b/springboot-starter-data-authorization/src/test/java/com/codingapi/springboot/authorization/entity/Depart.java new file mode 100644 index 000000000..865d88011 --- /dev/null +++ b/springboot-starter-data-authorization/src/test/java/com/codingapi/springboot/authorization/entity/Depart.java @@ -0,0 +1,38 @@ +package com.codingapi.springboot.authorization.entity; + +import lombok.Getter; +import lombok.NoArgsConstructor; +import lombok.Setter; + +import javax.persistence.Entity; +import javax.persistence.GeneratedValue; +import javax.persistence.Id; +import javax.persistence.Table; + +@Setter +@Getter +@Entity +@Table(name = "t_depart") +@NoArgsConstructor +public class Depart { + + @Id + @GeneratedValue + private long id; + + private String name; + + private long parentId; + + private long unitId; + + public Depart(String name, long unitId,long parentId) { + this.name = name; + this.parentId = parentId; + this.unitId = unitId; + } + + public Depart(String name,long unitId) { + this(name,unitId,0); + } +} diff --git a/springboot-starter-data-authorization/src/test/java/com/codingapi/springboot/authorization/entity/Unit.java b/springboot-starter-data-authorization/src/test/java/com/codingapi/springboot/authorization/entity/Unit.java new file mode 100644 index 000000000..4ea4b0a78 --- /dev/null +++ b/springboot-starter-data-authorization/src/test/java/com/codingapi/springboot/authorization/entity/Unit.java @@ -0,0 +1,34 @@ +package com.codingapi.springboot.authorization.entity; + +import javax.persistence.Entity; +import javax.persistence.GeneratedValue; +import javax.persistence.Id; +import javax.persistence.Table; +import lombok.Getter; +import lombok.NoArgsConstructor; +import lombok.Setter; + +@Setter +@Getter +@Entity +@Table(name = "t_unit") +@NoArgsConstructor +public class Unit { + + @Id + @GeneratedValue + private long id; + + private String name; + + private long parentId; + + public Unit(String name, long parentId) { + this.name = name; + this.parentId = parentId; + } + + public Unit(String name) { + this(name,0); + } +} diff --git a/springboot-starter-data-authorization/src/test/java/com/codingapi/springboot/authorization/entity/User.java b/springboot-starter-data-authorization/src/test/java/com/codingapi/springboot/authorization/entity/User.java new file mode 100644 index 000000000..04fca1f3f --- /dev/null +++ b/springboot-starter-data-authorization/src/test/java/com/codingapi/springboot/authorization/entity/User.java @@ -0,0 +1,49 @@ +package com.codingapi.springboot.authorization.entity; + +import javax.persistence.Entity; +import javax.persistence.GeneratedValue; +import javax.persistence.Id; +import javax.persistence.Table; +import lombok.Getter; +import lombok.NoArgsConstructor; +import lombok.Setter; +import lombok.ToString; + +import java.time.LocalDate; + +@Setter +@Getter +@Entity +@Table(name = "t_user") +@NoArgsConstructor +@ToString +public class User { + + @Id + @GeneratedValue + private long id; + + private String name; + + private LocalDate birthDate; + + private String address; + + private String idCard; + + private String phone; + + private long unitId; + + private long departId; + + public User(String name, LocalDate birthDate, String address, String idCard, String phone,Depart depart) { + this.name = name; + this.birthDate = birthDate; + this.address = address; + this.idCard = idCard; + this.phone = phone; + this.unitId = depart.getUnitId(); + this.departId = depart.getId(); + } +} diff --git a/springboot-starter-data-authorization/src/test/java/com/codingapi/springboot/authorization/exception/NotAuthorizationExceptionTest.java b/springboot-starter-data-authorization/src/test/java/com/codingapi/springboot/authorization/exception/NotAuthorizationExceptionTest.java new file mode 100644 index 000000000..7ab129c9d --- /dev/null +++ b/springboot-starter-data-authorization/src/test/java/com/codingapi/springboot/authorization/exception/NotAuthorizationExceptionTest.java @@ -0,0 +1,29 @@ +package com.codingapi.springboot.authorization.exception; + +import org.junit.jupiter.api.Test; + +import java.sql.SQLException; + +import static org.junit.jupiter.api.Assertions.assertEquals; +import static org.junit.jupiter.api.Assertions.assertNull; +import static org.junit.jupiter.api.Assertions.assertTrue; + +/** + * NotAuthorizationException 单元测试 + */ +class NotAuthorizationExceptionTest { + + @Test + void testDefaultConstructor() { + NotAuthorizationException exception = new NotAuthorizationException(); + assertTrue(exception instanceof SQLException); + assertNull(exception.getMessage()); + } + + @Test + void testConstructorWithReason() { + NotAuthorizationException exception = new NotAuthorizationException("no permission"); + assertTrue(exception instanceof SQLException); + assertEquals("no permission", exception.getMessage()); + } +} diff --git a/springboot-starter-data-authorization/src/test/java/com/codingapi/springboot/authorization/handler/ColumnHandlerContextTest.java b/springboot-starter-data-authorization/src/test/java/com/codingapi/springboot/authorization/handler/ColumnHandlerContextTest.java new file mode 100644 index 000000000..ab5baad4a --- /dev/null +++ b/springboot-starter-data-authorization/src/test/java/com/codingapi/springboot/authorization/handler/ColumnHandlerContextTest.java @@ -0,0 +1,165 @@ +package com.codingapi.springboot.authorization.handler; + +import com.codingapi.springboot.authorization.interceptor.SQLExecuteState; +import org.junit.jupiter.api.AfterEach; +import org.junit.jupiter.api.BeforeEach; +import org.junit.jupiter.api.Test; + +import java.io.InputStream; +import java.io.Reader; +import java.math.BigDecimal; +import java.net.URL; +import java.sql.Array; +import java.sql.Blob; +import java.sql.Clob; +import java.sql.Date; +import java.sql.NClob; +import java.sql.Ref; +import java.sql.RowId; +import java.sql.SQLXML; +import java.sql.Time; +import java.sql.Timestamp; + +import static org.junit.jupiter.api.Assertions.assertEquals; +import static org.junit.jupiter.api.Assertions.assertSame; +import static org.mockito.ArgumentMatchers.any; +import static org.mockito.ArgumentMatchers.anyBoolean; +import static org.mockito.ArgumentMatchers.anyByte; +import static org.mockito.ArgumentMatchers.anyDouble; +import static org.mockito.ArgumentMatchers.anyFloat; +import static org.mockito.ArgumentMatchers.anyInt; +import static org.mockito.ArgumentMatchers.anyLong; +import static org.mockito.ArgumentMatchers.anyShort; +import static org.mockito.ArgumentMatchers.anyString; +import static org.mockito.ArgumentMatchers.eq; +import static org.mockito.Mockito.mock; +import static org.mockito.Mockito.verify; +import static org.mockito.Mockito.when; + +/** + * ColumnHandlerContext 单元测试 + * 验证上下文将各类 get 请求委托给注册的 ColumnHandler + */ +class ColumnHandlerContextTest { + + private ColumnHandler columnHandler; + private SQLExecuteState state; + + @BeforeEach + void setUp() { + columnHandler = mock(ColumnHandler.class); + ColumnHandlerContext.getInstance().setColumnHandler(columnHandler); + state = SQLExecuteState.unIntercept("select 1"); + } + + @AfterEach + void tearDown() { + // 恢复默认处理器，避免影响其他测试 + ColumnHandlerContext.getInstance().setColumnHandler(new DefaultColumnHandler()); + } + + @Test + void testDelegatesToColumnHandler() throws Exception { + when(columnHandler.getString(any(), anyInt(), anyString(), anyString(), anyString())).thenReturn("s"); + when(columnHandler.getShort(any(), anyInt(), anyString(), anyString(), anyShort())).thenReturn((short) 1); + when(columnHandler.getBoolean(any(), anyInt(), anyString(), anyString(), anyBoolean())).thenReturn(true); + when(columnHandler.getByte(any(), anyInt(), anyString(), anyString(), anyByte())).thenReturn((byte) 2); + when(columnHandler.getInt(any(), anyInt(), anyString(), anyString(), anyInt())).thenReturn(3); + when(columnHandler.getLong(any(), anyInt(), anyString(), anyString(), anyLong())).thenReturn(4L); + when(columnHandler.getFloat(any(), anyInt(), anyString(), anyString(), anyFloat())).thenReturn(5.0f); + when(columnHandler.getDouble(any(), anyInt(), anyString(), anyString(), anyDouble())).thenReturn(6.0d); + when(columnHandler.getBigDecimal(any(), anyInt(), anyString(), anyString(), any(BigDecimal.class))) + .thenReturn(BigDecimal.ONE); + when(columnHandler.getBytes(any(), anyInt(), anyString(), anyString(), any())) + .thenReturn(new byte[]{1}); + Timestamp timestamp = new Timestamp(1000L); + when(columnHandler.getTimestamp(any(), anyInt(), anyString(), anyString(), any())) + .thenReturn(timestamp); + Time time = new Time(1000L); + when(columnHandler.getTime(any(), anyInt(), anyString(), anyString(), any())).thenReturn(time); + Date date = new Date(1000L); + when(columnHandler.getDate(any(), anyInt(), anyString(), anyString(), any())).thenReturn(date); + InputStream inputStream = mock(InputStream.class); + when(columnHandler.getAsciiStream(any(), anyInt(), anyString(), anyString(), any())) + .thenReturn(inputStream); + when(columnHandler.getUnicodeStream(any(), anyInt(), anyString(), anyString(), any())) + .thenReturn(inputStream); + when(columnHandler.getBinaryStream(any(), anyInt(), anyString(), anyString(), any())) + .thenReturn(inputStream); + when(columnHandler.getObject(any(), anyInt(), anyString(), anyString(), any())).thenReturn("obj"); + Reader reader = mock(Reader.class); + when(columnHandler.getCharacterStream(any(), anyInt(), anyString(), anyString(), any())) + .thenReturn(reader); + when(columnHandler.getNCharacterStream(any(), anyInt(), anyString(), anyString(), any())) + .thenReturn(reader); + Ref ref = mock(Ref.class); + when(columnHandler.getRef(any(), anyInt(), anyString(), anyString(), any())).thenReturn(ref); + Blob blob = mock(Blob.class); + when(columnHandler.getBlob(any(), anyInt(), anyString(), anyString(), any())).thenReturn(blob); + Clob clob = mock(Clob.class); + when(columnHandler.getClob(any(), anyInt(), anyString(), anyString(), any())).thenReturn(clob); + Array array = mock(Array.class); + when(columnHandler.getArray(any(), anyInt(), anyString(), anyString(), any())).thenReturn(array); + URL url = toUrl(); + when(columnHandler.getURL(any(), anyInt(), anyString(), anyString(), any())).thenReturn(url); + NClob nClob = mock(NClob.class); + when(columnHandler.getNClob(any(), anyInt(), anyString(), anyString(), any())).thenReturn(nClob); + SQLXML sqlxml = mock(SQLXML.class); + when(columnHandler.getSQLXML(any(), anyInt(), anyString(), anyString(), any())) + .thenReturn(sqlxml); + when(columnHandler.getNString(any(), anyInt(), anyString(), anyString(), anyString())).thenReturn("ns"); + RowId rowId = mock(RowId.class); + when(columnHandler.getRowId(any(), anyInt(), anyString(), anyString(), any())).thenReturn(rowId); + when(columnHandler.getObject(any(), anyInt(), anyString(), anyString(), any(), eq(String.class))) + .thenReturn("typed"); + + ColumnHandlerContext context = ColumnHandlerContext.getInstance(); + + assertEquals("s", context.getString(state, 1, "t", "c", "v")); + assertEquals((short) 1, context.getShort(state, 1, "t", "c", (short) 0)); + assertEquals(true, context.getBoolean(state, 1, "t", "c", false)); + assertEquals((byte) 2, context.getByte(state, 1, "t", "c", (byte) 0)); + assertEquals(3, context.getInt(state, 1, "t", "c", 0)); + assertEquals(4L, context.getLong(state, 1, "t", "c", 0L)); + assertEquals(5.0f, context.getFloat(state, 1, "t", "c", 0f)); + assertEquals(6.0d, context.getDouble(state, 1, "t", "c", 0d)); + assertEquals(BigDecimal.ONE, context.getBigDecimal(state, 1, "t", "c", BigDecimal.ZERO)); + assertSame(timestamp, context.getTimestamp(state, 1, "t", "c", null)); + assertSame(time, context.getTime(state, 1, "t", "c", null)); + assertSame(date, context.getDate(state, 1, "t", "c", null)); + assertSame(inputStream, context.getAsciiStream(state, 1, "t", "c", null)); + assertSame(inputStream, context.getUnicodeStream(state, 1, "t", "c", null)); + assertSame(inputStream, context.getBinaryStream(state, 1, "t", "c", null)); + assertEquals("obj", context.getObject(state, 1, "t", "c", null)); + assertSame(reader, context.getCharacterStream(state, 1, "t", "c", null)); + assertSame(reader, context.getNCharacterStream(state, 1, "t", "c", null)); + assertSame(ref, context.getRef(state, 1, "t", "c", null)); + assertSame(blob, context.getBlob(state, 1, "t", "c", null)); + assertSame(clob, context.getClob(state, 1, "t", "c", null)); + assertSame(array, context.getArray(state, 1, "t", "c", null)); + assertSame(url, context.getURL(state, 1, "t", "c", null)); + assertSame(nClob, context.getNClob(state, 1, "t", "c", null)); + assertSame(sqlxml, context.getSQLXML(state, 1, "t", "c", null)); + assertEquals("ns", context.getNString(state, 1, "t", "c", "v")); + assertSame(rowId, context.getRowId(state, 1, "t", "c", null)); + assertEquals("typed", context.getObject(state, 1, "t", "c", "v", String.class)); + assertEquals(1, context.getBytes(state, 1, "t", "c", null).length); + + // 验证委托时参数透传 + verify(columnHandler).getString(state, 1, "t", "c", "v"); + verify(columnHandler).getInt(state, 1, "t", "c", 0); + verify(columnHandler).getObject(state, 1, "t", "c", "v", String.class); + } + + /** + * JDK 8 兼容: 构造真实 URL 代替 mock(URL.class)(final 类在 Mockito 4 默认不可 mock) + */ + private static URL toUrl() { + try { + return new URL("http://mock.local/"); + } catch (java.net.MalformedURLException e) { + throw new IllegalStateException(e); + } + } + +} diff --git a/springboot-starter-data-authorization/src/test/java/com/codingapi/springboot/authorization/handler/ConditionTest.java b/springboot-starter-data-authorization/src/test/java/com/codingapi/springboot/authorization/handler/ConditionTest.java new file mode 100644 index 000000000..a896f37c9 --- /dev/null +++ b/springboot-starter-data-authorization/src/test/java/com/codingapi/springboot/authorization/handler/ConditionTest.java @@ -0,0 +1,68 @@ +package com.codingapi.springboot.authorization.handler; + +import com.codingapi.springboot.authorization.condition.IConditionSQL; +import com.codingapi.springboot.authorization.condition.JoinConditionSQL; +import com.codingapi.springboot.authorization.condition.WhereConditionSQL; +import org.junit.jupiter.api.Test; + +import static org.junit.jupiter.api.Assertions.assertEquals; +import static org.junit.jupiter.api.Assertions.assertNotNull; +import static org.junit.jupiter.api.Assertions.assertNull; +import static org.junit.jupiter.api.Assertions.assertTrue; + +/** + * Condition 单元测试 + */ +class ConditionTest { + + @Test + void testEmptyConstructor() { + Condition condition = new Condition(); + assertNotNull(condition.getConditionList()); + assertEquals(0, condition.getConditionList().size()); + } + + @Test + void testConditionWithWhereSql() { + Condition condition = new Condition("t.id = 1"); + assertEquals(1, condition.getConditionList().size()); + IConditionSQL conditionSQL = condition.getConditionList().get(0); + assertTrue(conditionSQL instanceof WhereConditionSQL); + assertEquals("t.id = 1", ((WhereConditionSQL) conditionSQL).getCondition()); + } + + @Test + void testAddConditionSql() { + Condition condition = new Condition(); + condition.addConditionSQL(new WhereConditionSQL("t.id = 1")); + condition.addConditionSQL(new JoinConditionSQL(JoinConditionSQL.Type.INNER, "t_unit", "u", "u.id = t.id")); + assertEquals(2, condition.getConditionList().size()); + } + + @Test + void testCustomCondition() { + Condition condition = Condition.customCondition("t.id = 1"); + assertEquals(1, condition.getConditionList().size()); + WhereConditionSQL whereConditionSQL = (WhereConditionSQL) condition.getConditionList().get(0); + assertEquals("t.id = 1", whereConditionSQL.getCondition()); + } + + @Test + void testFormatCondition() { + Condition condition = Condition.formatCondition("%s.id = %d", "u", 10); + WhereConditionSQL whereConditionSQL = (WhereConditionSQL) condition.getConditionList().get(0); + assertEquals("u.id = 10", whereConditionSQL.getCondition()); + } + + @Test + void testEmptyConditionReturnsNull() { + assertNull(Condition.emptyCondition()); + } + + @Test + void testDefaultCondition() { + Condition condition = Condition.defaultCondition(); + WhereConditionSQL whereConditionSQL = (WhereConditionSQL) condition.getConditionList().get(0); + assertEquals("1=1", whereConditionSQL.getCondition()); + } +} diff --git a/springboot-starter-data-authorization/src/test/java/com/codingapi/springboot/authorization/handler/DefaultColumnHandlerTest.java b/springboot-starter-data-authorization/src/test/java/com/codingapi/springboot/authorization/handler/DefaultColumnHandlerTest.java new file mode 100644 index 000000000..c3e4d1978 --- /dev/null +++ b/springboot-starter-data-authorization/src/test/java/com/codingapi/springboot/authorization/handler/DefaultColumnHandlerTest.java @@ -0,0 +1,152 @@ +package com.codingapi.springboot.authorization.handler; + +import com.codingapi.springboot.authorization.DataAuthorizationContext; +import com.codingapi.springboot.authorization.filter.DefaultDataAuthorizationFilter; +import com.codingapi.springboot.authorization.interceptor.SQLExecuteState; +import com.codingapi.springboot.authorization.interceptor.SQLRunningContext; +import org.junit.jupiter.api.AfterEach; +import org.junit.jupiter.api.BeforeEach; +import org.junit.jupiter.api.Test; + +import java.io.InputStream; +import java.io.Reader; +import java.math.BigDecimal; +import java.net.URL; +import java.sql.Array; +import java.sql.Blob; +import java.sql.Clob; +import java.sql.Date; +import java.sql.NClob; +import java.sql.Ref; +import java.sql.RowId; +import java.sql.SQLXML; +import java.sql.Time; +import java.sql.Timestamp; + +import static org.junit.jupiter.api.Assertions.assertEquals; +import static org.junit.jupiter.api.Assertions.assertSame; +import static org.junit.jupiter.api.Assertions.assertTrue; +import static org.mockito.Mockito.mock; + +/** + * DefaultColumnHandler 单元测试 + * 验证默认列处理器将请求委托给 DataAuthorizationContext.columnAuthorization： + * 未拦截时原值返回；拦截且过滤器支持时返回加工后的值 + */ +class DefaultColumnHandlerTest { + + private DefaultColumnHandler handler; + + @BeforeEach + void setUp() { + DataAuthorizationContext.getInstance().clearDataAuthorizationFilters(); + handler = new DefaultColumnHandler(); + } + + @AfterEach + void tearDown() { + DataAuthorizationContext.getInstance().clearDataAuthorizationFilters(); + } + + @Test + void testUnInterceptStateReturnsOriginalValues() throws Exception { + SQLExecuteState state = SQLExecuteState.unIntercept("select 1"); + InputStream inputStream = mock(InputStream.class); + Reader reader = mock(Reader.class); + Ref ref = mock(Ref.class); + Blob blob = mock(Blob.class); + Clob clob = mock(Clob.class); + Array array = mock(Array.class); + URL url = toUrl(); + NClob nClob = mock(NClob.class); + SQLXML sqlxml = mock(SQLXML.class); + RowId rowId = mock(RowId.class); + Date date = new Date(1000L); + Time time = new Time(1000L); + Timestamp timestamp = new Timestamp(1000L); + byte[] bytes = new byte[]{1}; + + assertEquals("v", handler.getString(state, 1, "t", "c", "v")); + assertEquals(true, handler.getBoolean(state, 1, "t", "c", true)); + assertEquals((byte) 1, handler.getByte(state, 1, "t", "c", (byte) 1)); + assertEquals((short) 1, handler.getShort(state, 1, "t", "c", (short) 1)); + assertEquals(1, handler.getInt(state, 1, "t", "c", 1)); + assertEquals(1L, handler.getLong(state, 1, "t", "c", 1L)); + assertEquals(1.0f, handler.getFloat(state, 1, "t", "c", 1.0f)); + assertEquals(1.0d, handler.getDouble(state, 1, "t", "c", 1.0d)); + assertEquals(BigDecimal.ONE, handler.getBigDecimal(state, 1, "t", "c", BigDecimal.ONE)); + assertSame(bytes, handler.getBytes(state, 1, "t", "c", bytes)); + assertSame(date, handler.getDate(state, 1, "t", "c", date)); + assertSame(time, handler.getTime(state, 1, "t", "c", time)); + assertSame(timestamp, handler.getTimestamp(state, 1, "t", "c", timestamp)); + assertSame(inputStream, handler.getAsciiStream(state, 1, "t", "c", inputStream)); + assertSame(inputStream, handler.getUnicodeStream(state, 1, "t", "c", inputStream)); + assertSame(inputStream, handler.getBinaryStream(state, 1, "t", "c", inputStream)); + assertEquals("obj", handler.getObject(state, 1, "t", "c", "obj")); + assertSame(reader, handler.getCharacterStream(state, 1, "t", "c", reader)); + assertSame(ref, handler.getRef(state, 1, "t", "c", ref)); + assertSame(blob, handler.getBlob(state, 1, "t", "c", blob)); + assertSame(clob, handler.getClob(state, 1, "t", "c", clob)); + assertSame(array, handler.getArray(state, 1, "t", "c", array)); + assertSame(url, handler.getURL(state, 1, "t", "c", url)); + assertSame(nClob, handler.getNClob(state, 1, "t", "c", nClob)); + assertSame(sqlxml, handler.getSQLXML(state, 1, "t", "c", sqlxml)); + assertEquals("nv", handler.getNString(state, 1, "t", "c", "nv")); + assertSame(reader, handler.getNCharacterStream(state, 1, "t", "c", reader)); + assertSame(rowId, handler.getRowId(state, 1, "t", "c", rowId)); + assertEquals("typed", handler.getObject(state, 1, "t", "c", "typed", String.class)); + } + + @Test + void testInterceptStateAppliesColumnAuthorization() throws Exception { + DataAuthorizationContext.getInstance().addDataAuthorizationFilter(new DefaultDataAuthorizationFilter() { + @Override + public boolean supportRowAuthorization(String tableName, String tableAlias) { + return "t_user".equalsIgnoreCase(tableName); + } + + @Override + public Condition rowAuthorization(String tableName, String tableAlias) { + return Condition.formatCondition("%s.id > 100", tableAlias); + } + + @Override + public boolean supportColumnAuthorization(String tableName, String columnName, Object value) { + return "t_user".equalsIgnoreCase(tableName); + } + + @SuppressWarnings("unchecked") + @Override + public T columnAuthorization(String tableName, String columnName, T value) { + if (value instanceof String) { + return (T) ("MASKED-" + value); + } + if (value instanceof Integer) { + return (T) Integer.valueOf(-1); + } + return value; + } + }); + + SQLExecuteState state = SQLRunningContext.getInstance().intercept("select name from t_user"); + assertTrue(state.hasIntercept()); + + assertEquals("MASKED-raw", handler.getString(state, 1, "t_user", "name", "raw")); + assertEquals(Integer.valueOf(-1), Integer.valueOf(handler.getInt(state, 1, "t_user", "id", 1))); + assertEquals("MASKED-nv", handler.getNString(state, 1, "t_user", "name", "nv")); + assertEquals("MASKED-obj", handler.getObject(state, 1, "t_user", "name", "obj")); + assertEquals("MASKED-typed", handler.getObject(state, 1, "t_user", "name", "typed", String.class)); + } + + /** + * JDK 8 兼容: 构造真实 URL 代替 mock(URL.class)(final 类在 Mockito 4 默认不可 mock) + */ + private static URL toUrl() { + try { + return new URL("http://mock.local/"); + } catch (java.net.MalformedURLException e) { + throw new IllegalStateException(e); + } + } + +} diff --git a/springboot-starter-data-authorization/src/test/java/com/codingapi/springboot/authorization/jdbc/AuthorizationJdbcDriverTest.java b/springboot-starter-data-authorization/src/test/java/com/codingapi/springboot/authorization/jdbc/AuthorizationJdbcDriverTest.java new file mode 100644 index 000000000..63d581d0a --- /dev/null +++ b/springboot-starter-data-authorization/src/test/java/com/codingapi/springboot/authorization/jdbc/AuthorizationJdbcDriverTest.java @@ -0,0 +1,121 @@ +package com.codingapi.springboot.authorization.jdbc; + +import com.codingapi.springboot.authorization.DataAuthorizationContext; +import com.codingapi.springboot.authorization.jdbc.proxy.ConnectionProxy; +import org.junit.jupiter.api.AfterEach; +import org.junit.jupiter.api.BeforeAll; +import org.junit.jupiter.api.BeforeEach; +import org.junit.jupiter.api.Test; + +import java.sql.Connection; +import java.sql.Driver; +import java.sql.ResultSet; +import java.sql.SQLException; +import java.sql.Statement; +import java.util.Properties; +import java.util.logging.Logger; + +import static org.junit.jupiter.api.Assertions.assertEquals; +import static org.junit.jupiter.api.Assertions.assertNotNull; +import static org.junit.jupiter.api.Assertions.assertThrows; +import static org.junit.jupiter.api.Assertions.assertTrue; + +/** + * AuthorizationJdbcDriver 单元测试 + * 验证代理驱动的查找、包装与元信息行为（使用 H2 内存库，无外网依赖） + */ +class AuthorizationJdbcDriverTest { + + private AuthorizationJdbcDriver driver; + + @BeforeAll + static void loadH2Driver() throws ClassNotFoundException { + // 确保 H2 驱动已注册到 DriverManager + Class.forName("org.h2.Driver"); + } + + @BeforeEach + void setUp() { + DataAuthorizationContext.getInstance().clearDataAuthorizationFilters(); + driver = new AuthorizationJdbcDriver(); + } + + @AfterEach + void tearDown() { + DataAuthorizationContext.getInstance().clearDataAuthorizationFilters(); + } + + @Test + void testAcceptsUrl() throws SQLException { + assertEquals(false, driver.acceptsURL(null)); + assertTrue(driver.acceptsURL("jdbc:h2:mem:acceptsUrlTest")); + assertEquals(false, driver.acceptsURL("jdbc:not-exists:xyz")); + } + + @Test + void testConnectWithNullUrl() { + SQLException exception = assertThrows(SQLException.class, () -> driver.connect(null, new Properties())); + assertTrue(exception.getMessage().contains("URL cannot be null")); + } + + @Test + void testConnectWithNoSuitableDriver() { + SQLException exception = assertThrows(SQLException.class, + () -> driver.connect("jdbc:not-exists:xyz", new Properties())); + assertTrue(exception.getMessage().contains("No suitable driver")); + } + + @Test + void testConnectReturnsConnectionProxyAndWorks() throws SQLException { + String url = "jdbc:h2:mem:authorizationDriverTest"; + Connection connection = driver.connect(url, new Properties()); + try { + assertNotNull(connection); + assertTrue(connection instanceof ConnectionProxy); + + // 第二次使用相同 URL，命中驱动缓存分支 + Connection cachedConnection = driver.connect(url, new Properties()); + assertTrue(cachedConnection instanceof ConnectionProxy); + cachedConnection.close(); + + // 通过代理连接执行真实查询 + Statement statement = connection.createStatement(); + ResultSet resultSet = statement.executeQuery("SELECT 1"); + assertTrue(resultSet.next()); + assertEquals(1, resultSet.getInt(1)); + resultSet.close(); + statement.close(); + } finally { + connection.close(); + } + } + + @Test + void testGetPropertyInfo() throws SQLException { + assertNotNull(driver.getPropertyInfo("jdbc:h2:mem:propertyInfoTest", new Properties())); + assertThrows(SQLException.class, () -> driver.getPropertyInfo("jdbc:not-exists:xyz", new Properties())); + } + + @Test + void testDriverMetaInfo() throws SQLException { + assertEquals(1, driver.getMajorVersion()); + assertEquals(0, driver.getMinorVersion()); + assertEquals(false, driver.jdbcCompliant()); + Logger parentLogger = driver.getParentLogger(); + assertNotNull(parentLogger); + } + + @Test + void testDriverRegisteredInDriverManager() { + boolean found = false; + java.util.Enumeration drivers = java.sql.DriverManager.getDrivers(); + while (drivers.hasMoreElements()) { + Driver candidate = drivers.nextElement(); + if (candidate instanceof AuthorizationJdbcDriver) { + found = true; + break; + } + } + assertTrue(found); + } +} diff --git a/springboot-starter-data-authorization/src/test/java/com/codingapi/springboot/authorization/jdbc/proxy/CallableStatementProxyTest.java b/springboot-starter-data-authorization/src/test/java/com/codingapi/springboot/authorization/jdbc/proxy/CallableStatementProxyTest.java new file mode 100644 index 000000000..9fb411c2d --- /dev/null +++ b/springboot-starter-data-authorization/src/test/java/com/codingapi/springboot/authorization/jdbc/proxy/CallableStatementProxyTest.java @@ -0,0 +1,645 @@ +package com.codingapi.springboot.authorization.jdbc.proxy; + +import com.codingapi.springboot.authorization.DataAuthorizationContext; +import com.codingapi.springboot.authorization.interceptor.SQLExecuteState; +import org.junit.jupiter.api.AfterEach; +import org.junit.jupiter.api.BeforeEach; +import org.junit.jupiter.api.Test; +import org.mockito.ArgumentCaptor; + +import java.io.ByteArrayInputStream; +import java.io.InputStream; +import java.io.Reader; +import java.io.StringReader; +import java.math.BigDecimal; +import java.net.URL; +import java.sql.Array; +import java.sql.Blob; +import java.sql.CallableStatement; +import java.sql.Clob; +import java.sql.Connection; +import java.sql.Date; +import java.sql.JDBCType; +import java.sql.NClob; +import java.sql.ParameterMetaData; +import java.sql.Ref; +import java.sql.ResultSet; +import java.sql.ResultSetMetaData; +import java.sql.RowId; +import java.sql.SQLException; +import java.sql.SQLType; +import java.sql.SQLWarning; +import java.sql.SQLXML; +import java.sql.Time; +import java.sql.Timestamp; +import java.sql.Types; +import java.util.Calendar; +import java.util.HashMap; +import java.util.Map; + +import static org.junit.jupiter.api.Assertions.assertEquals; +import static org.junit.jupiter.api.Assertions.assertSame; +import static org.junit.jupiter.api.Assertions.assertTrue; +import static org.mockito.ArgumentMatchers.any; +import static org.mockito.ArgumentMatchers.anyInt; +import static org.mockito.ArgumentMatchers.anyString; +import static org.mockito.Mockito.mock; +import static org.mockito.Mockito.verify; +import static org.mockito.Mockito.when; + +/** + * CallableStatementProxy 单元测试 + * 验证方法委托以及 SQL 拦截行为 + */ +class CallableStatementProxyTest { + + private CallableStatement callableStatement; + private CallableStatementProxy proxy; + + @BeforeEach + void setUp() { + DataAuthorizationContext.getInstance().clearDataAuthorizationFilters(); + ResultSetProxyTest.registerTestFilter(); + + callableStatement = mock(CallableStatement.class); + proxy = new CallableStatementProxy(callableStatement, SQLExecuteState.unIntercept("select 1")); + } + + @AfterEach + void tearDown() { + DataAuthorizationContext.getInstance().clearDataAuthorizationFilters(); + } + + private ResultSet mockEmptyResultSet() throws SQLException { + ResultSet resultSet = mock(ResultSet.class); + ResultSetMetaData metaData = mock(ResultSetMetaData.class); + when(resultSet.getMetaData()).thenReturn(metaData); + when(metaData.getColumnCount()).thenReturn(0); + return resultSet; + } + + @Test + void testRegisterOutParameterDelegates() throws SQLException { + SQLType sqlType = JDBCType.VARCHAR; + + proxy.registerOutParameter(1, Types.VARCHAR); + proxy.registerOutParameter(1, Types.VARCHAR, 2); + proxy.registerOutParameter(1, Types.VARCHAR, "VARCHAR"); + proxy.registerOutParameter("p", Types.VARCHAR); + proxy.registerOutParameter("p", Types.VARCHAR, 2); + proxy.registerOutParameter("p", Types.VARCHAR, "VARCHAR"); + proxy.registerOutParameter(1, sqlType); + proxy.registerOutParameter(1, sqlType, 2); + proxy.registerOutParameter(1, sqlType, "VARCHAR"); + proxy.registerOutParameter("p", sqlType); + proxy.registerOutParameter("p", sqlType, 2); + proxy.registerOutParameter("p", sqlType, "VARCHAR"); + + verify(callableStatement).registerOutParameter(1, Types.VARCHAR); + verify(callableStatement).registerOutParameter(1, Types.VARCHAR, 2); + verify(callableStatement).registerOutParameter(1, Types.VARCHAR, "VARCHAR"); + verify(callableStatement).registerOutParameter("p", Types.VARCHAR); + verify(callableStatement).registerOutParameter("p", Types.VARCHAR, 2); + verify(callableStatement).registerOutParameter("p", Types.VARCHAR, "VARCHAR"); + verify(callableStatement).registerOutParameter(1, sqlType); + verify(callableStatement).registerOutParameter(1, sqlType, 2); + verify(callableStatement).registerOutParameter(1, sqlType, "VARCHAR"); + verify(callableStatement).registerOutParameter("p", sqlType); + verify(callableStatement).registerOutParameter("p", sqlType, 2); + verify(callableStatement).registerOutParameter("p", sqlType, "VARCHAR"); + } + + @Test + void testGettersByIndexDelegate() throws SQLException { + Calendar calendar = Calendar.getInstance(); + Date date = new Date(1000L); + Time time = new Time(2000L); + Timestamp timestamp = new Timestamp(3000L); + Ref ref = mock(Ref.class); + Blob blob = mock(Blob.class); + Clob clob = mock(Clob.class); + Array array = mock(Array.class); + NClob nClob = mock(NClob.class); + SQLXML sqlxml = mock(SQLXML.class); + RowId rowId = mock(RowId.class); + URL url = toUrl(); + Reader reader = new StringReader("x"); + Map> map = new HashMap<>(); + + when(callableStatement.wasNull()).thenReturn(true); + when(callableStatement.getString(1)).thenReturn("v"); + when(callableStatement.getBoolean(1)).thenReturn(true); + when(callableStatement.getByte(1)).thenReturn((byte) 1); + when(callableStatement.getShort(1)).thenReturn((short) 2); + when(callableStatement.getInt(1)).thenReturn(3); + when(callableStatement.getLong(1)).thenReturn(4L); + when(callableStatement.getFloat(1)).thenReturn(5.0f); + when(callableStatement.getDouble(1)).thenReturn(6.0d); + when(callableStatement.getBigDecimal(1, 2)).thenReturn(BigDecimal.ONE); + when(callableStatement.getBigDecimal(1)).thenReturn(BigDecimal.TEN); + when(callableStatement.getBytes(1)).thenReturn(new byte[]{1}); + when(callableStatement.getDate(1)).thenReturn(date); + when(callableStatement.getTime(1)).thenReturn(time); + when(callableStatement.getTimestamp(1)).thenReturn(timestamp); + when(callableStatement.getObject(1)).thenReturn("obj"); + when(callableStatement.getObject(1, map)).thenReturn("mapObj"); + when(callableStatement.getRef(1)).thenReturn(ref); + when(callableStatement.getBlob(1)).thenReturn(blob); + when(callableStatement.getClob(1)).thenReturn(clob); + when(callableStatement.getArray(1)).thenReturn(array); + when(callableStatement.getDate(1, calendar)).thenReturn(date); + when(callableStatement.getTime(1, calendar)).thenReturn(time); + when(callableStatement.getTimestamp(1, calendar)).thenReturn(timestamp); + when(callableStatement.getURL(1)).thenReturn(url); + when(callableStatement.getRowId(1)).thenReturn(rowId); + when(callableStatement.getNClob(1)).thenReturn(nClob); + when(callableStatement.getSQLXML(1)).thenReturn(sqlxml); + when(callableStatement.getNString(1)).thenReturn("ns"); + when(callableStatement.getNCharacterStream(1)).thenReturn(reader); + when(callableStatement.getCharacterStream(1)).thenReturn(reader); + when(callableStatement.getObject(1, String.class)).thenReturn("typed"); + + assertTrue(proxy.wasNull()); + assertEquals("v", proxy.getString(1)); + assertTrue(proxy.getBoolean(1)); + assertEquals((byte) 1, proxy.getByte(1)); + assertEquals((short) 2, proxy.getShort(1)); + assertEquals(3, proxy.getInt(1)); + assertEquals(4L, proxy.getLong(1)); + assertEquals(5.0f, proxy.getFloat(1)); + assertEquals(6.0d, proxy.getDouble(1)); + assertEquals(BigDecimal.ONE, proxy.getBigDecimal(1, 2)); + assertEquals(BigDecimal.TEN, proxy.getBigDecimal(1)); + assertEquals(1, proxy.getBytes(1).length); + assertSame(date, proxy.getDate(1)); + assertSame(time, proxy.getTime(1)); + assertSame(timestamp, proxy.getTimestamp(1)); + assertEquals("obj", proxy.getObject(1)); + assertEquals("mapObj", proxy.getObject(1, map)); + assertSame(ref, proxy.getRef(1)); + assertSame(blob, proxy.getBlob(1)); + assertSame(clob, proxy.getClob(1)); + assertSame(array, proxy.getArray(1)); + assertSame(date, proxy.getDate(1, calendar)); + assertSame(time, proxy.getTime(1, calendar)); + assertSame(timestamp, proxy.getTimestamp(1, calendar)); + assertSame(url, proxy.getURL(1)); + assertSame(rowId, proxy.getRowId(1)); + assertSame(nClob, proxy.getNClob(1)); + assertSame(sqlxml, proxy.getSQLXML(1)); + assertEquals("ns", proxy.getNString(1)); + assertSame(reader, proxy.getNCharacterStream(1)); + assertSame(reader, proxy.getCharacterStream(1)); + assertEquals("typed", proxy.getObject(1, String.class)); + } + + @Test + void testGettersByNameDelegate() throws SQLException { + Calendar calendar = Calendar.getInstance(); + Date date = new Date(1000L); + Time time = new Time(2000L); + Timestamp timestamp = new Timestamp(3000L); + Ref ref = mock(Ref.class); + Blob blob = mock(Blob.class); + Clob clob = mock(Clob.class); + Array array = mock(Array.class); + NClob nClob = mock(NClob.class); + SQLXML sqlxml = mock(SQLXML.class); + RowId rowId = mock(RowId.class); + URL url = toUrl(); + Reader reader = new StringReader("x"); + Map> map = new HashMap<>(); + + when(callableStatement.getString("p")).thenReturn("v"); + when(callableStatement.getBoolean("p")).thenReturn(true); + when(callableStatement.getByte("p")).thenReturn((byte) 1); + when(callableStatement.getShort("p")).thenReturn((short) 2); + when(callableStatement.getInt("p")).thenReturn(3); + when(callableStatement.getLong("p")).thenReturn(4L); + when(callableStatement.getFloat("p")).thenReturn(5.0f); + when(callableStatement.getDouble("p")).thenReturn(6.0d); + when(callableStatement.getBytes("p")).thenReturn(new byte[]{1}); + when(callableStatement.getDate("p")).thenReturn(date); + when(callableStatement.getTime("p")).thenReturn(time); + when(callableStatement.getTimestamp("p")).thenReturn(timestamp); + when(callableStatement.getObject("p")).thenReturn("obj"); + when(callableStatement.getBigDecimal("p")).thenReturn(BigDecimal.TEN); + when(callableStatement.getObject("p", map)).thenReturn("mapObj"); + when(callableStatement.getRef("p")).thenReturn(ref); + when(callableStatement.getBlob("p")).thenReturn(blob); + when(callableStatement.getClob("p")).thenReturn(clob); + when(callableStatement.getArray("p")).thenReturn(array); + when(callableStatement.getDate("p", calendar)).thenReturn(date); + when(callableStatement.getTime("p", calendar)).thenReturn(time); + when(callableStatement.getTimestamp("p", calendar)).thenReturn(timestamp); + when(callableStatement.getURL("p")).thenReturn(url); + when(callableStatement.getRowId("p")).thenReturn(rowId); + when(callableStatement.getNClob("p")).thenReturn(nClob); + when(callableStatement.getSQLXML("p")).thenReturn(sqlxml); + when(callableStatement.getNString("p")).thenReturn("ns"); + when(callableStatement.getNCharacterStream("p")).thenReturn(reader); + when(callableStatement.getCharacterStream("p")).thenReturn(reader); + when(callableStatement.getObject("p", String.class)).thenReturn("typed"); + + assertEquals("v", proxy.getString("p")); + assertTrue(proxy.getBoolean("p")); + assertEquals((byte) 1, proxy.getByte("p")); + assertEquals((short) 2, proxy.getShort("p")); + assertEquals(3, proxy.getInt("p")); + assertEquals(4L, proxy.getLong("p")); + assertEquals(5.0f, proxy.getFloat("p")); + assertEquals(6.0d, proxy.getDouble("p")); + assertEquals(1, proxy.getBytes("p").length); + assertSame(date, proxy.getDate("p")); + assertSame(time, proxy.getTime("p")); + assertSame(timestamp, proxy.getTimestamp("p")); + assertEquals("obj", proxy.getObject("p")); + assertEquals(BigDecimal.TEN, proxy.getBigDecimal("p")); + assertEquals("mapObj", proxy.getObject("p", map)); + assertSame(ref, proxy.getRef("p")); + assertSame(blob, proxy.getBlob("p")); + assertSame(clob, proxy.getClob("p")); + assertSame(array, proxy.getArray("p")); + assertSame(date, proxy.getDate("p", calendar)); + assertSame(time, proxy.getTime("p", calendar)); + assertSame(timestamp, proxy.getTimestamp("p", calendar)); + assertSame(url, proxy.getURL("p")); + assertSame(rowId, proxy.getRowId("p")); + assertSame(nClob, proxy.getNClob("p")); + assertSame(sqlxml, proxy.getSQLXML("p")); + assertEquals("ns", proxy.getNString("p")); + assertSame(reader, proxy.getNCharacterStream("p")); + assertSame(reader, proxy.getCharacterStream("p")); + assertEquals("typed", proxy.getObject("p", String.class)); + } + + @Test + void testSettersByNameDelegate() throws SQLException { + InputStream inputStream = new ByteArrayInputStream(new byte[]{1}); + Reader reader = new StringReader("x"); + Calendar calendar = Calendar.getInstance(); + Date date = new Date(1000L); + Time time = new Time(2000L); + Timestamp timestamp = new Timestamp(3000L); + Blob blob = mock(Blob.class); + Clob clob = mock(Clob.class); + NClob nClob = mock(NClob.class); + SQLXML sqlxml = mock(SQLXML.class); + RowId rowId = mock(RowId.class); + URL url = toUrl(); + SQLType sqlType = JDBCType.VARCHAR; + + proxy.setURL("p", url); + proxy.setNull("p", Types.VARCHAR); + proxy.setBoolean("p", true); + proxy.setByte("p", (byte) 1); + proxy.setShort("p", (short) 1); + proxy.setInt("p", 1); + proxy.setLong("p", 1L); + proxy.setFloat("p", 1.0f); + proxy.setDouble("p", 1.0d); + proxy.setBigDecimal("p", BigDecimal.ONE); + proxy.setString("p", "x"); + proxy.setBytes("p", new byte[]{1}); + proxy.setDate("p", date); + proxy.setTime("p", time); + proxy.setTimestamp("p", timestamp); + proxy.setAsciiStream("p", inputStream, 1); + proxy.setBinaryStream("p", inputStream, 1); + proxy.setObject("p", "x", Types.VARCHAR, 1); + proxy.setObject("p", "x", Types.VARCHAR); + proxy.setObject("p", "x"); + proxy.setCharacterStream("p", reader, 1); + proxy.setDate("p", date, calendar); + proxy.setTime("p", time, calendar); + proxy.setTimestamp("p", timestamp, calendar); + proxy.setNull("p", Types.VARCHAR, "VARCHAR"); + proxy.setRowId("p", rowId); + proxy.setNString("p", "x"); + proxy.setNCharacterStream("p", reader, 1L); + proxy.setNClob("p", nClob); + proxy.setClob("p", reader, 1L); + proxy.setBlob("p", inputStream, 1L); + proxy.setNClob("p", reader, 1L); + proxy.setSQLXML("p", sqlxml); + proxy.setBlob("p", blob); + proxy.setClob("p", clob); + proxy.setAsciiStream("p", inputStream, 1L); + proxy.setBinaryStream("p", inputStream, 1L); + proxy.setCharacterStream("p", reader, 1L); + proxy.setAsciiStream("p", inputStream); + proxy.setBinaryStream("p", inputStream); + proxy.setCharacterStream("p", reader); + proxy.setNCharacterStream("p", reader); + proxy.setClob("p", reader); + proxy.setBlob("p", inputStream); + proxy.setNClob("p", reader); + proxy.setObject("p", "x", sqlType, 1); + proxy.setObject("p", "x", sqlType); + + verify(callableStatement).setURL("p", url); + verify(callableStatement).setNull("p", Types.VARCHAR); + verify(callableStatement).setBoolean("p", true); + verify(callableStatement).setByte("p", (byte) 1); + verify(callableStatement).setShort("p", (short) 1); + verify(callableStatement).setInt("p", 1); + verify(callableStatement).setLong("p", 1L); + verify(callableStatement).setFloat("p", 1.0f); + verify(callableStatement).setDouble("p", 1.0d); + verify(callableStatement).setBigDecimal("p", BigDecimal.ONE); + verify(callableStatement).setString("p", "x"); + verify(callableStatement).setDate("p", date); + verify(callableStatement).setTime("p", time); + verify(callableStatement).setTimestamp("p", timestamp); + verify(callableStatement).setAsciiStream("p", inputStream, 1); + verify(callableStatement).setBinaryStream("p", inputStream, 1); + verify(callableStatement).setObject("p", "x", Types.VARCHAR, 1); + verify(callableStatement).setObject("p", "x", Types.VARCHAR); + verify(callableStatement).setObject("p", "x"); + verify(callableStatement).setCharacterStream("p", reader, 1); + verify(callableStatement).setDate("p", date, calendar); + verify(callableStatement).setTime("p", time, calendar); + verify(callableStatement).setTimestamp("p", timestamp, calendar); + verify(callableStatement).setNull("p", Types.VARCHAR, "VARCHAR"); + verify(callableStatement).setRowId("p", rowId); + verify(callableStatement).setNString("p", "x"); + verify(callableStatement).setNCharacterStream("p", reader, 1L); + verify(callableStatement).setNClob("p", nClob); + verify(callableStatement).setClob("p", reader, 1L); + verify(callableStatement).setBlob("p", inputStream, 1L); + verify(callableStatement).setNClob("p", reader, 1L); + verify(callableStatement).setSQLXML("p", sqlxml); + verify(callableStatement).setBlob("p", blob); + verify(callableStatement).setClob("p", clob); + verify(callableStatement).setAsciiStream("p", inputStream, 1L); + verify(callableStatement).setBinaryStream("p", inputStream, 1L); + verify(callableStatement).setCharacterStream("p", reader, 1L); + verify(callableStatement).setAsciiStream("p", inputStream); + verify(callableStatement).setBinaryStream("p", inputStream); + verify(callableStatement).setCharacterStream("p", reader); + verify(callableStatement).setNCharacterStream("p", reader); + verify(callableStatement).setClob("p", reader); + verify(callableStatement).setBlob("p", inputStream); + verify(callableStatement).setNClob("p", reader); + verify(callableStatement).setObject("p", "x", sqlType, 1); + verify(callableStatement).setObject("p", "x", sqlType); + } + + @Test + void testPreparedStatementLevelSettersDelegate() throws SQLException { + InputStream inputStream = new ByteArrayInputStream(new byte[]{1}); + Reader reader = new StringReader("x"); + Calendar calendar = Calendar.getInstance(); + Date date = new Date(1000L); + Time time = new Time(2000L); + Timestamp timestamp = new Timestamp(3000L); + Ref ref = mock(Ref.class); + Blob blob = mock(Blob.class); + Clob clob = mock(Clob.class); + Array array = mock(Array.class); + NClob nClob = mock(NClob.class); + SQLXML sqlxml = mock(SQLXML.class); + RowId rowId = mock(RowId.class); + URL url = toUrl(); + SQLType sqlType = JDBCType.VARCHAR; + + proxy.setNull(1, Types.VARCHAR); + proxy.setBoolean(1, true); + proxy.setByte(1, (byte) 1); + proxy.setShort(1, (short) 1); + proxy.setInt(1, 1); + proxy.setLong(1, 1L); + proxy.setFloat(1, 1.0f); + proxy.setDouble(1, 1.0d); + proxy.setBigDecimal(1, BigDecimal.ONE); + proxy.setString(1, "x"); + proxy.setBytes(1, new byte[]{1}); + proxy.setDate(1, date); + proxy.setTime(1, time); + proxy.setTimestamp(1, timestamp); + proxy.setAsciiStream(1, inputStream, 1); + proxy.setUnicodeStream(1, inputStream, 1); + proxy.setBinaryStream(1, inputStream, 1); + proxy.clearParameters(); + proxy.setObject(1, "x", Types.VARCHAR); + proxy.setObject(1, "x"); + proxy.setCharacterStream(1, reader, 1); + proxy.setRef(1, ref); + proxy.setBlob(1, blob); + proxy.setClob(1, clob); + proxy.setArray(1, array); + proxy.setDate(1, date, calendar); + proxy.setTime(1, time, calendar); + proxy.setTimestamp(1, timestamp, calendar); + proxy.setNull(1, Types.VARCHAR, "VARCHAR"); + proxy.setURL(1, url); + proxy.setRowId(1, rowId); + proxy.setNString(1, "x"); + proxy.setNCharacterStream(1, reader, 1L); + proxy.setNClob(1, nClob); + proxy.setClob(1, reader, 1L); + proxy.setBlob(1, inputStream, 1L); + proxy.setNClob(1, reader, 1L); + proxy.setSQLXML(1, sqlxml); + proxy.setObject(1, "x", Types.VARCHAR, 1); + proxy.setAsciiStream(1, inputStream, 1L); + proxy.setBinaryStream(1, inputStream, 1L); + proxy.setCharacterStream(1, reader, 1L); + proxy.setAsciiStream(1, inputStream); + proxy.setBinaryStream(1, inputStream); + proxy.setCharacterStream(1, reader); + proxy.setNCharacterStream(1, reader); + proxy.setClob(1, reader); + proxy.setBlob(1, inputStream); + proxy.setNClob(1, reader); + proxy.setObject(1, "x", sqlType, 1); + proxy.setObject(1, "x", sqlType); + proxy.addBatch(); + + verify(callableStatement).setNull(1, Types.VARCHAR); + verify(callableStatement).setBoolean(1, true); + verify(callableStatement).setInt(1, 1); + verify(callableStatement).setString(1, "x"); + verify(callableStatement).setUnicodeStream(1, inputStream, 1); + verify(callableStatement).clearParameters(); + verify(callableStatement).setRef(1, ref); + verify(callableStatement).setBlob(1, blob); + verify(callableStatement).setClob(1, clob); + verify(callableStatement).setArray(1, array); + verify(callableStatement).setSQLXML(1, sqlxml); + verify(callableStatement).setObject(1, "x", sqlType, 1); + verify(callableStatement).setObject(1, "x", sqlType); + verify(callableStatement).addBatch(); + } + + @Test + void testExecuteMethods() throws SQLException { + ResultSet resultSet = mockEmptyResultSet(); + when(callableStatement.executeQuery()).thenReturn(resultSet); + when(callableStatement.executeUpdate()).thenReturn(1); + when(callableStatement.execute()).thenReturn(true); + when(callableStatement.executeLargeUpdate()).thenReturn(2L); + ResultSetMetaData metaData = mock(ResultSetMetaData.class); + ParameterMetaData parameterMetaData = mock(ParameterMetaData.class); + when(callableStatement.getMetaData()).thenReturn(metaData); + when(callableStatement.getParameterMetaData()).thenReturn(parameterMetaData); + ResultSet generatedKeys = mockEmptyResultSet(); + when(callableStatement.getGeneratedKeys()).thenReturn(generatedKeys); + + assertTrue(proxy.executeQuery() instanceof ResultSetProxy); + assertEquals(1, proxy.executeUpdate()); + assertTrue(proxy.execute()); + assertEquals(2L, proxy.executeLargeUpdate()); + assertSame(metaData, proxy.getMetaData()); + assertSame(parameterMetaData, proxy.getParameterMetaData()); + assertSame(generatedKeys, proxy.getGeneratedKeys()); + } + + @Test + void testStatementLevelSqlMethodsIntercept() throws SQLException { + ResultSet resultSet = mockEmptyResultSet(); + when(callableStatement.executeQuery(anyString())).thenReturn(resultSet); + when(callableStatement.executeUpdate(anyString())).thenReturn(1); + when(callableStatement.executeUpdate(anyString(), anyInt())).thenReturn(1); + when(callableStatement.executeUpdate(anyString(), (int[]) any())).thenReturn(1); + when(callableStatement.executeUpdate(anyString(), (String[]) any())).thenReturn(1); + when(callableStatement.execute(anyString())).thenReturn(true); + when(callableStatement.execute(anyString(), anyInt())).thenReturn(true); + when(callableStatement.execute(anyString(), (int[]) any())).thenReturn(true); + when(callableStatement.execute(anyString(), (String[]) any())).thenReturn(true); + when(callableStatement.executeLargeUpdate(anyString())).thenReturn(2L); + when(callableStatement.executeLargeUpdate(anyString(), anyInt())).thenReturn(2L); + when(callableStatement.executeLargeUpdate(anyString(), (int[]) any())).thenReturn(2L); + when(callableStatement.executeLargeUpdate(anyString(), (String[]) any())).thenReturn(2L); + ResultSet rawResultSet = mockEmptyResultSet(); + when(callableStatement.getResultSet()).thenReturn(rawResultSet); + Connection connection = mock(Connection.class); + when(callableStatement.getConnection()).thenReturn(connection); + + String sql = "select name from t_user"; + + assertTrue(proxy.executeQuery(sql) instanceof ResultSetProxy); + assertEquals(1, proxy.executeUpdate(sql)); + assertTrue(proxy.execute(sql)); + proxy.addBatch(sql); + assertEquals(2L, proxy.executeLargeUpdate(sql)); + assertEquals(1, proxy.executeUpdate(sql, java.sql.Statement.RETURN_GENERATED_KEYS)); + assertEquals(1, proxy.executeUpdate(sql, new int[]{1})); + assertEquals(1, proxy.executeUpdate(sql, new String[]{"id"})); + assertTrue(proxy.execute(sql, java.sql.Statement.RETURN_GENERATED_KEYS)); + assertTrue(proxy.execute(sql, new int[]{1})); + assertTrue(proxy.execute(sql, new String[]{"id"})); + assertEquals(2L, proxy.executeLargeUpdate(sql, java.sql.Statement.RETURN_GENERATED_KEYS)); + assertEquals(2L, proxy.executeLargeUpdate(sql, new int[]{1})); + assertEquals(2L, proxy.executeLargeUpdate(sql, new String[]{"id"})); + assertTrue(proxy.getResultSet() instanceof ResultSetProxy); + assertTrue(proxy.getConnection() instanceof ConnectionProxy); + + ArgumentCaptor captor = ArgumentCaptor.forClass(String.class); + verify(callableStatement).executeQuery(captor.capture()); + assertTrue(captor.getValue().contains("id > 100")); + } + + @Test + void testAttributeDelegates() throws SQLException { + when(callableStatement.getMaxFieldSize()).thenReturn(1); + when(callableStatement.getMaxRows()).thenReturn(2); + when(callableStatement.getQueryTimeout()).thenReturn(3); + SQLWarning warning = mock(SQLWarning.class); + when(callableStatement.getWarnings()).thenReturn(warning); + when(callableStatement.getUpdateCount()).thenReturn(4); + when(callableStatement.getMoreResults()).thenReturn(true); + when(callableStatement.getFetchDirection()).thenReturn(ResultSet.FETCH_FORWARD); + when(callableStatement.getFetchSize()).thenReturn(5); + when(callableStatement.getResultSetConcurrency()).thenReturn(ResultSet.CONCUR_READ_ONLY); + when(callableStatement.getResultSetType()).thenReturn(ResultSet.TYPE_FORWARD_ONLY); + when(callableStatement.getMoreResults(java.sql.Statement.CLOSE_CURRENT_RESULT)).thenReturn(false); + when(callableStatement.getResultSetHoldability()).thenReturn(ResultSet.HOLD_CURSORS_OVER_COMMIT); + when(callableStatement.isClosed()).thenReturn(false); + when(callableStatement.isPoolable()).thenReturn(true); + when(callableStatement.isCloseOnCompletion()).thenReturn(false); + when(callableStatement.getLargeUpdateCount()).thenReturn(6L); + when(callableStatement.getLargeMaxRows()).thenReturn(7L); + when(callableStatement.executeBatch()).thenReturn(new int[]{1}); + when(callableStatement.executeLargeBatch()).thenReturn(new long[]{2L}); + + assertEquals(1, proxy.getMaxFieldSize()); + assertEquals(2, proxy.getMaxRows()); + assertEquals(3, proxy.getQueryTimeout()); + assertSame(warning, proxy.getWarnings()); + assertEquals(4, proxy.getUpdateCount()); + assertTrue(proxy.getMoreResults()); + assertEquals(ResultSet.FETCH_FORWARD, proxy.getFetchDirection()); + assertEquals(5, proxy.getFetchSize()); + assertEquals(ResultSet.CONCUR_READ_ONLY, proxy.getResultSetConcurrency()); + assertEquals(ResultSet.TYPE_FORWARD_ONLY, proxy.getResultSetType()); + assertEquals(false, proxy.getMoreResults(java.sql.Statement.CLOSE_CURRENT_RESULT)); + assertEquals(ResultSet.HOLD_CURSORS_OVER_COMMIT, proxy.getResultSetHoldability()); + assertEquals(false, proxy.isClosed()); + assertTrue(proxy.isPoolable()); + assertEquals(false, proxy.isCloseOnCompletion()); + assertEquals(6L, proxy.getLargeUpdateCount()); + assertEquals(7L, proxy.getLargeMaxRows()); + assertEquals(1, proxy.executeBatch().length); + assertEquals(1, proxy.executeLargeBatch().length); + + proxy.setMaxFieldSize(10); + proxy.setMaxRows(20); + proxy.setEscapeProcessing(true); + proxy.setQueryTimeout(30); + proxy.setFetchDirection(ResultSet.FETCH_REVERSE); + proxy.setFetchSize(40); + proxy.setPoolable(false); + proxy.setLargeMaxRows(50L); + proxy.clearWarnings(); + proxy.clearBatch(); + proxy.closeOnCompletion(); + proxy.close(); + proxy.cancel(); + proxy.setCursorName("cursor"); + + verify(callableStatement).setMaxFieldSize(10); + verify(callableStatement).setMaxRows(20); + verify(callableStatement).setEscapeProcessing(true); + verify(callableStatement).setQueryTimeout(30); + verify(callableStatement).setFetchDirection(ResultSet.FETCH_REVERSE); + verify(callableStatement).setFetchSize(40); + verify(callableStatement).setPoolable(false); + verify(callableStatement).setLargeMaxRows(50L); + verify(callableStatement).clearWarnings(); + verify(callableStatement).clearBatch(); + verify(callableStatement).closeOnCompletion(); + verify(callableStatement).close(); + verify(callableStatement).cancel(); + verify(callableStatement).setCursorName("cursor"); + } + + @Test + void testEnquoteAndWrapperDelegates() throws SQLException { + when(callableStatement.enquoteLiteral("v")).thenReturn("'v'"); + when(callableStatement.enquoteIdentifier("id", true)).thenReturn("\"id\""); + when(callableStatement.isSimpleIdentifier("id")).thenReturn(true); + when(callableStatement.enquoteNCharLiteral("v")).thenReturn("N'v'"); + when(callableStatement.unwrap(String.class)).thenReturn("unwrapped"); + when(callableStatement.isWrapperFor(String.class)).thenReturn(true); + + assertEquals("'v'", proxy.enquoteLiteral("v")); + assertEquals("\"id\"", proxy.enquoteIdentifier("id", true)); + assertTrue(proxy.isSimpleIdentifier("id")); + assertEquals("N'v'", proxy.enquoteNCharLiteral("v")); + assertEquals("unwrapped", proxy.unwrap(String.class)); + assertTrue(proxy.isWrapperFor(String.class)); + } + + /** + * JDK 8 兼容: 构造真实 URL 代替 mock(URL.class)(final 类在 Mockito 4 默认不可 mock) + */ + private static URL toUrl() { + try { + return new URL("http://mock.local/"); + } catch (java.net.MalformedURLException e) { + throw new IllegalStateException(e); + } + } + +} diff --git a/springboot-starter-data-authorization/src/test/java/com/codingapi/springboot/authorization/jdbc/proxy/ConnectionProxyTest.java b/springboot-starter-data-authorization/src/test/java/com/codingapi/springboot/authorization/jdbc/proxy/ConnectionProxyTest.java new file mode 100644 index 000000000..885840793 --- /dev/null +++ b/springboot-starter-data-authorization/src/test/java/com/codingapi/springboot/authorization/jdbc/proxy/ConnectionProxyTest.java @@ -0,0 +1,266 @@ +package com.codingapi.springboot.authorization.jdbc.proxy; + +import com.codingapi.springboot.authorization.DataAuthorizationContext; +import org.junit.jupiter.api.AfterEach; +import org.junit.jupiter.api.BeforeEach; +import org.junit.jupiter.api.Test; +import org.mockito.ArgumentCaptor; + +import java.sql.Array; +import java.sql.Blob; +import java.sql.CallableStatement; +import java.sql.Clob; +import java.sql.Connection; +import java.sql.DatabaseMetaData; +import java.sql.NClob; +import java.sql.PreparedStatement; +import java.sql.ResultSet; +import java.sql.SQLException; +import java.sql.SQLWarning; +import java.sql.Savepoint; +import java.sql.SQLXML; +import java.sql.Statement; +import java.sql.Struct; +import java.util.HashMap; +import java.util.Map; +import java.util.Properties; +import java.util.concurrent.Executor; + +import static org.junit.jupiter.api.Assertions.assertEquals; +import static org.junit.jupiter.api.Assertions.assertSame; +import static org.junit.jupiter.api.Assertions.assertTrue; +import static org.mockito.ArgumentMatchers.anyInt; +import static org.mockito.ArgumentMatchers.anyString; +import static org.mockito.Mockito.mock; +import static org.mockito.Mockito.verify; +import static org.mockito.Mockito.when; + +/** + * ConnectionProxy 单元测试 + * 验证方法委托以及 prepareStatement/prepareCall 的 SQL 拦截行为 + */ +class ConnectionProxyTest { + + private Connection connection; + private ConnectionProxy proxy; + + @BeforeEach + void setUp() { + DataAuthorizationContext.getInstance().clearDataAuthorizationFilters(); + ResultSetProxyTest.registerTestFilter(); + + connection = mock(Connection.class); + proxy = new ConnectionProxy(connection); + } + + @AfterEach + void tearDown() { + DataAuthorizationContext.getInstance().clearDataAuthorizationFilters(); + } + + @Test + void testCreateStatementReturnsStatementProxy() throws SQLException { + Statement statement = mock(Statement.class); + when(connection.createStatement()).thenReturn(statement); + when(connection.createStatement(anyInt(), anyInt())).thenReturn(statement); + when(connection.createStatement(anyInt(), anyInt(), anyInt())).thenReturn(statement); + + assertTrue(proxy.createStatement() instanceof StatementProxy); + assertTrue(proxy.createStatement(ResultSet.TYPE_FORWARD_ONLY, ResultSet.CONCUR_READ_ONLY) instanceof StatementProxy); + assertTrue(proxy.createStatement(ResultSet.TYPE_FORWARD_ONLY, ResultSet.CONCUR_READ_ONLY, + ResultSet.HOLD_CURSORS_OVER_COMMIT) instanceof StatementProxy); + + verify(connection).createStatement(); + verify(connection).createStatement(ResultSet.TYPE_FORWARD_ONLY, ResultSet.CONCUR_READ_ONLY); + verify(connection).createStatement(ResultSet.TYPE_FORWARD_ONLY, ResultSet.CONCUR_READ_ONLY, + ResultSet.HOLD_CURSORS_OVER_COMMIT); + } + + @Test + void testPrepareStatementInterceptsSql() throws SQLException { + PreparedStatement preparedStatement = mock(PreparedStatement.class); + when(connection.prepareStatement(anyString())).thenReturn(preparedStatement); + when(connection.prepareStatement(anyString(), anyInt())).thenReturn(preparedStatement); + when(connection.prepareStatement(anyString(), (int[]) org.mockito.ArgumentMatchers.any())).thenReturn(preparedStatement); + when(connection.prepareStatement(anyString(), (String[]) org.mockito.ArgumentMatchers.any())).thenReturn(preparedStatement); + when(connection.prepareStatement(anyString(), anyInt(), anyInt())).thenReturn(preparedStatement); + when(connection.prepareStatement(anyString(), anyInt(), anyInt(), anyInt())).thenReturn(preparedStatement); + + String sql = "select name from t_user"; + + assertTrue(proxy.prepareStatement(sql) instanceof PreparedStatementProxy); + assertTrue(proxy.prepareStatement(sql, Statement.RETURN_GENERATED_KEYS) instanceof PreparedStatementProxy); + assertTrue(proxy.prepareStatement(sql, new int[]{1}) instanceof PreparedStatementProxy); + assertTrue(proxy.prepareStatement(sql, new String[]{"id"}) instanceof PreparedStatementProxy); + assertTrue(proxy.prepareStatement(sql, ResultSet.TYPE_FORWARD_ONLY, ResultSet.CONCUR_READ_ONLY) + instanceof PreparedStatementProxy); + assertTrue(proxy.prepareStatement(sql, ResultSet.TYPE_FORWARD_ONLY, ResultSet.CONCUR_READ_ONLY, + ResultSet.HOLD_CURSORS_OVER_COMMIT) instanceof PreparedStatementProxy); + + ArgumentCaptor captor = ArgumentCaptor.forClass(String.class); + verify(connection).prepareStatement(captor.capture()); + assertTrue(captor.getValue().contains("id > 100")); + } + + @Test + void testPrepareCallInterceptsSql() throws SQLException { + CallableStatement callableStatement = mock(CallableStatement.class); + when(connection.prepareCall(anyString())).thenReturn(callableStatement); + when(connection.prepareCall(anyString(), anyInt(), anyInt())).thenReturn(callableStatement); + when(connection.prepareCall(anyString(), anyInt(), anyInt(), anyInt())).thenReturn(callableStatement); + + String sql = "select name from t_user"; + + assertTrue(proxy.prepareCall(sql) instanceof CallableStatementProxy); + assertTrue(proxy.prepareCall(sql, ResultSet.TYPE_FORWARD_ONLY, ResultSet.CONCUR_READ_ONLY) + instanceof CallableStatementProxy); + assertTrue(proxy.prepareCall(sql, ResultSet.TYPE_FORWARD_ONLY, ResultSet.CONCUR_READ_ONLY, + ResultSet.HOLD_CURSORS_OVER_COMMIT) instanceof CallableStatementProxy); + + ArgumentCaptor captor = ArgumentCaptor.forClass(String.class); + verify(connection).prepareCall(captor.capture()); + assertTrue(captor.getValue().contains("id > 100")); + } + + @Test + void testNativeSqlInterceptsSql() throws SQLException { + when(connection.nativeSQL(anyString())).thenReturn("native"); + assertEquals("native", proxy.nativeSQL("select name from t_user")); + + ArgumentCaptor captor = ArgumentCaptor.forClass(String.class); + verify(connection).nativeSQL(captor.capture()); + assertTrue(captor.getValue().contains("id > 100")); + } + + @Test + void testTransactionDelegates() throws SQLException { + when(connection.getAutoCommit()).thenReturn(true); + when(connection.isClosed()).thenReturn(false); + when(connection.isReadOnly()).thenReturn(false); + when(connection.getTransactionIsolation()).thenReturn(Connection.TRANSACTION_READ_COMMITTED); + SQLWarning warning = mock(SQLWarning.class); + when(connection.getWarnings()).thenReturn(warning); + Savepoint savepoint = mock(Savepoint.class); + when(connection.setSavepoint()).thenReturn(savepoint); + when(connection.setSavepoint("sp")).thenReturn(savepoint); + + proxy.setAutoCommit(false); + verify(connection).setAutoCommit(false); + assertTrue(connection.getAutoCommit()); + assertEquals(true, proxy.getAutoCommit()); + + proxy.commit(); + verify(connection).commit(); + proxy.rollback(); + verify(connection).rollback(); + proxy.rollback(savepoint); + verify(connection).rollback(savepoint); + proxy.releaseSavepoint(savepoint); + verify(connection).releaseSavepoint(savepoint); + + proxy.close(); + verify(connection).close(); + assertEquals(false, proxy.isClosed()); + + DatabaseMetaData metaData = mock(DatabaseMetaData.class); + when(connection.getMetaData()).thenReturn(metaData); + assertSame(metaData, proxy.getMetaData()); + + proxy.setReadOnly(true); + verify(connection).setReadOnly(true); + assertEquals(false, proxy.isReadOnly()); + + proxy.setCatalog("catalog"); + verify(connection).setCatalog("catalog"); + when(connection.getCatalog()).thenReturn("catalog"); + assertEquals("catalog", proxy.getCatalog()); + + proxy.setTransactionIsolation(Connection.TRANSACTION_SERIALIZABLE); + verify(connection).setTransactionIsolation(Connection.TRANSACTION_SERIALIZABLE); + assertEquals(Connection.TRANSACTION_READ_COMMITTED, proxy.getTransactionIsolation()); + + assertSame(warning, proxy.getWarnings()); + proxy.clearWarnings(); + verify(connection).clearWarnings(); + + assertSame(savepoint, proxy.setSavepoint()); + assertSame(savepoint, proxy.setSavepoint("sp")); + } + + @Test + void testTypeMapAndHoldabilityDelegates() throws SQLException { + Map> typeMap = new HashMap<>(); + when(connection.getTypeMap()).thenReturn(typeMap); + when(connection.getHoldability()).thenReturn(ResultSet.HOLD_CURSORS_OVER_COMMIT); + + assertSame(typeMap, proxy.getTypeMap()); + proxy.setTypeMap(typeMap); + verify(connection).setTypeMap(typeMap); + + proxy.setHoldability(ResultSet.CLOSE_CURSORS_AT_COMMIT); + verify(connection).setHoldability(ResultSet.CLOSE_CURSORS_AT_COMMIT); + assertEquals(ResultSet.HOLD_CURSORS_OVER_COMMIT, proxy.getHoldability()); + } + + @Test + void testLobAndMiscDelegates() throws SQLException { + Clob clob = mock(Clob.class); + Blob blob = mock(Blob.class); + NClob nClob = mock(NClob.class); + SQLXML sqlxml = mock(SQLXML.class); + Array array = mock(Array.class); + Struct struct = mock(Struct.class); + + when(connection.createClob()).thenReturn(clob); + when(connection.createBlob()).thenReturn(blob); + when(connection.createNClob()).thenReturn(nClob); + when(connection.createSQLXML()).thenReturn(sqlxml); + when(connection.isValid(1)).thenReturn(true); + when(connection.getClientInfo("k")).thenReturn("v"); + Properties properties = new Properties(); + when(connection.getClientInfo()).thenReturn(properties); + when(connection.createArrayOf("VARCHAR", new Object[]{"a"})).thenReturn(array); + when(connection.createStruct("STRUCT", new Object[]{"a"})).thenReturn(struct); + when(connection.getSchema()).thenReturn("schema"); + when(connection.getNetworkTimeout()).thenReturn(100); + + assertSame(clob, proxy.createClob()); + assertSame(blob, proxy.createBlob()); + assertSame(nClob, proxy.createNClob()); + assertSame(sqlxml, proxy.createSQLXML()); + assertTrue(proxy.isValid(1)); + + proxy.setClientInfo("k", "v"); + verify(connection).setClientInfo("k", "v"); + proxy.setClientInfo(properties); + verify(connection).setClientInfo(properties); + assertEquals("v", proxy.getClientInfo("k")); + assertSame(properties, proxy.getClientInfo()); + + assertSame(array, proxy.createArrayOf("VARCHAR", new Object[]{"a"})); + assertSame(struct, proxy.createStruct("STRUCT", new Object[]{"a"})); + + proxy.setSchema("schema"); + verify(connection).setSchema("schema"); + assertEquals("schema", proxy.getSchema()); + + Executor executor = mock(Executor.class); + proxy.abort(executor); + verify(connection).abort(executor); + proxy.setNetworkTimeout(executor, 100); + verify(connection).setNetworkTimeout(executor, 100); + assertEquals(100, proxy.getNetworkTimeout()); + + // 注：beginRequest/endRequest/setShardingKey* 为 JDK 9+ 的 JDBC 方法， + // 8.2.x（JDK 8）的 ConnectionProxy 未覆写，故不做委托验证 + } + + @Test + void testWrapperDelegates() throws SQLException { + when(connection.unwrap(String.class)).thenReturn("unwrapped"); + when(connection.isWrapperFor(String.class)).thenReturn(true); + + assertEquals("unwrapped", proxy.unwrap(String.class)); + assertTrue(proxy.isWrapperFor(String.class)); + } +} diff --git a/springboot-starter-data-authorization/src/test/java/com/codingapi/springboot/authorization/jdbc/proxy/PreparedStatementProxyTest.java b/springboot-starter-data-authorization/src/test/java/com/codingapi/springboot/authorization/jdbc/proxy/PreparedStatementProxyTest.java new file mode 100644 index 000000000..4ca4f8c55 --- /dev/null +++ b/springboot-starter-data-authorization/src/test/java/com/codingapi/springboot/authorization/jdbc/proxy/PreparedStatementProxyTest.java @@ -0,0 +1,393 @@ +package com.codingapi.springboot.authorization.jdbc.proxy; + +import com.codingapi.springboot.authorization.DataAuthorizationContext; +import com.codingapi.springboot.authorization.interceptor.SQLExecuteState; +import org.junit.jupiter.api.AfterEach; +import org.junit.jupiter.api.BeforeEach; +import org.junit.jupiter.api.Test; +import org.mockito.ArgumentCaptor; + +import java.io.ByteArrayInputStream; +import java.io.InputStream; +import java.io.Reader; +import java.io.StringReader; +import java.math.BigDecimal; +import java.net.URL; +import java.sql.Array; +import java.sql.Blob; +import java.sql.Clob; +import java.sql.Connection; +import java.sql.Date; +import java.sql.JDBCType; +import java.sql.NClob; +import java.sql.ParameterMetaData; +import java.sql.PreparedStatement; +import java.sql.Ref; +import java.sql.ResultSet; +import java.sql.ResultSetMetaData; +import java.sql.RowId; +import java.sql.SQLException; +import java.sql.SQLType; +import java.sql.SQLWarning; +import java.sql.SQLXML; +import java.sql.Time; +import java.sql.Timestamp; +import java.util.Calendar; + +import static org.junit.jupiter.api.Assertions.assertEquals; +import static org.junit.jupiter.api.Assertions.assertSame; +import static org.junit.jupiter.api.Assertions.assertTrue; +import static org.mockito.ArgumentMatchers.any; +import static org.mockito.ArgumentMatchers.anyInt; +import static org.mockito.ArgumentMatchers.anyString; +import static org.mockito.Mockito.mock; +import static org.mockito.Mockito.verify; +import static org.mockito.Mockito.when; + +/** + * PreparedStatementProxy 单元测试 + * 验证方法委托以及 SQL 拦截行为 + */ +class PreparedStatementProxyTest { + + private PreparedStatement preparedStatement; + private PreparedStatementProxy proxy; + + @BeforeEach + void setUp() { + DataAuthorizationContext.getInstance().clearDataAuthorizationFilters(); + ResultSetProxyTest.registerTestFilter(); + + preparedStatement = mock(PreparedStatement.class); + proxy = new PreparedStatementProxy(preparedStatement, SQLExecuteState.unIntercept("select 1")); + } + + @AfterEach + void tearDown() { + DataAuthorizationContext.getInstance().clearDataAuthorizationFilters(); + } + + private ResultSet mockEmptyResultSet() throws SQLException { + ResultSet resultSet = mock(ResultSet.class); + ResultSetMetaData metaData = mock(ResultSetMetaData.class); + when(resultSet.getMetaData()).thenReturn(metaData); + when(metaData.getColumnCount()).thenReturn(0); + return resultSet; + } + + @Test + void testExecuteMethods() throws SQLException { + ResultSet resultSet = mockEmptyResultSet(); + when(preparedStatement.executeQuery()).thenReturn(resultSet); + when(preparedStatement.executeUpdate()).thenReturn(1); + when(preparedStatement.execute()).thenReturn(true); + when(preparedStatement.executeLargeUpdate()).thenReturn(2L); + + assertTrue(proxy.executeQuery() instanceof ResultSetProxy); + assertEquals(1, proxy.executeUpdate()); + assertTrue(proxy.execute()); + assertEquals(2L, proxy.executeLargeUpdate()); + + verify(preparedStatement).executeQuery(); + verify(preparedStatement).executeUpdate(); + verify(preparedStatement).execute(); + verify(preparedStatement).executeLargeUpdate(); + } + + @Test + void testParameterSettersDelegate() throws SQLException { + InputStream inputStream = new ByteArrayInputStream(new byte[]{1}); + Reader reader = new StringReader("x"); + Calendar calendar = Calendar.getInstance(); + Date date = new Date(1000L); + Time time = new Time(2000L); + Timestamp timestamp = new Timestamp(3000L); + Ref ref = mock(Ref.class); + Blob blob = mock(Blob.class); + Clob clob = mock(Clob.class); + Array array = mock(Array.class); + NClob nClob = mock(NClob.class); + SQLXML sqlxml = mock(SQLXML.class); + RowId rowId = mock(RowId.class); + URL url = toUrl(); + + proxy.setNull(1, java.sql.Types.VARCHAR); + proxy.setBoolean(1, true); + proxy.setByte(1, (byte) 1); + proxy.setShort(1, (short) 1); + proxy.setInt(1, 1); + proxy.setLong(1, 1L); + proxy.setFloat(1, 1.0f); + proxy.setDouble(1, 1.0d); + proxy.setBigDecimal(1, BigDecimal.ONE); + proxy.setString(1, "x"); + proxy.setBytes(1, new byte[]{1}); + proxy.setDate(1, date); + proxy.setTime(1, time); + proxy.setTimestamp(1, timestamp); + proxy.setAsciiStream(1, inputStream, 1); + proxy.setUnicodeStream(1, inputStream, 1); + proxy.setBinaryStream(1, inputStream, 1); + proxy.clearParameters(); + proxy.setObject(1, "x", java.sql.Types.VARCHAR); + proxy.setObject(1, "x"); + proxy.setCharacterStream(1, reader, 1); + proxy.setRef(1, ref); + proxy.setBlob(1, blob); + proxy.setClob(1, clob); + proxy.setArray(1, array); + proxy.setDate(1, date, calendar); + proxy.setTime(1, time, calendar); + proxy.setTimestamp(1, timestamp, calendar); + proxy.setNull(1, java.sql.Types.VARCHAR, "VARCHAR"); + proxy.setURL(1, url); + proxy.setRowId(1, rowId); + proxy.setNString(1, "x"); + proxy.setNCharacterStream(1, reader, 1L); + proxy.setNClob(1, nClob); + proxy.setClob(1, reader, 1L); + proxy.setBlob(1, inputStream, 1L); + proxy.setNClob(1, reader, 1L); + proxy.setSQLXML(1, sqlxml); + proxy.setObject(1, "x", java.sql.Types.VARCHAR, 1); + proxy.setAsciiStream(1, inputStream, 1L); + proxy.setBinaryStream(1, inputStream, 1L); + proxy.setCharacterStream(1, reader, 1L); + proxy.setAsciiStream(1, inputStream); + proxy.setBinaryStream(1, inputStream); + proxy.setCharacterStream(1, reader); + proxy.setNCharacterStream(1, reader); + proxy.setClob(1, reader); + proxy.setBlob(1, inputStream); + proxy.setNClob(1, reader); + SQLType sqlType = JDBCType.VARCHAR; + proxy.setObject(1, "x", sqlType, 1); + proxy.setObject(1, "x", sqlType); + proxy.addBatch(); + + verify(preparedStatement).setNull(1, java.sql.Types.VARCHAR); + verify(preparedStatement).setBoolean(1, true); + verify(preparedStatement).setByte(1, (byte) 1); + verify(preparedStatement).setShort(1, (short) 1); + verify(preparedStatement).setInt(1, 1); + verify(preparedStatement).setLong(1, 1L); + verify(preparedStatement).setFloat(1, 1.0f); + verify(preparedStatement).setDouble(1, 1.0d); + verify(preparedStatement).setBigDecimal(1, BigDecimal.ONE); + verify(preparedStatement).setString(1, "x"); + verify(preparedStatement).setDate(1, date); + verify(preparedStatement).setTime(1, time); + verify(preparedStatement).setTimestamp(1, timestamp); + verify(preparedStatement).setAsciiStream(1, inputStream, 1); + verify(preparedStatement).setUnicodeStream(1, inputStream, 1); + verify(preparedStatement).setBinaryStream(1, inputStream, 1); + verify(preparedStatement).clearParameters(); + verify(preparedStatement).setObject(1, "x", java.sql.Types.VARCHAR); + verify(preparedStatement).setObject(1, "x"); + verify(preparedStatement).setCharacterStream(1, reader, 1); + verify(preparedStatement).setRef(1, ref); + verify(preparedStatement).setBlob(1, blob); + verify(preparedStatement).setClob(1, clob); + verify(preparedStatement).setArray(1, array); + verify(preparedStatement).setDate(1, date, calendar); + verify(preparedStatement).setTime(1, time, calendar); + verify(preparedStatement).setTimestamp(1, timestamp, calendar); + verify(preparedStatement).setNull(1, java.sql.Types.VARCHAR, "VARCHAR"); + verify(preparedStatement).setURL(1, url); + verify(preparedStatement).setRowId(1, rowId); + verify(preparedStatement).setNString(1, "x"); + verify(preparedStatement).setNCharacterStream(1, reader, 1L); + verify(preparedStatement).setNClob(1, nClob); + verify(preparedStatement).setClob(1, reader, 1L); + verify(preparedStatement).setBlob(1, inputStream, 1L); + verify(preparedStatement).setNClob(1, reader, 1L); + verify(preparedStatement).setSQLXML(1, sqlxml); + verify(preparedStatement).setObject(1, "x", java.sql.Types.VARCHAR, 1); + verify(preparedStatement).setAsciiStream(1, inputStream, 1L); + verify(preparedStatement).setBinaryStream(1, inputStream, 1L); + verify(preparedStatement).setCharacterStream(1, reader, 1L); + verify(preparedStatement).setAsciiStream(1, inputStream); + verify(preparedStatement).setBinaryStream(1, inputStream); + verify(preparedStatement).setCharacterStream(1, reader); + verify(preparedStatement).setNCharacterStream(1, reader); + verify(preparedStatement).setClob(1, reader); + verify(preparedStatement).setBlob(1, inputStream); + verify(preparedStatement).setNClob(1, reader); + verify(preparedStatement).setObject(1, "x", sqlType, 1); + verify(preparedStatement).setObject(1, "x", sqlType); + verify(preparedStatement).addBatch(); + } + + @Test + void testMetaDataDelegates() throws SQLException { + ResultSetMetaData resultSetMetaData = mock(ResultSetMetaData.class); + ParameterMetaData parameterMetaData = mock(ParameterMetaData.class); + when(preparedStatement.getMetaData()).thenReturn(resultSetMetaData); + when(preparedStatement.getParameterMetaData()).thenReturn(parameterMetaData); + + assertSame(resultSetMetaData, proxy.getMetaData()); + assertSame(parameterMetaData, proxy.getParameterMetaData()); + } + + @Test + void testStatementLevelSqlMethodsIntercept() throws SQLException { + ResultSet resultSet = mockEmptyResultSet(); + when(preparedStatement.executeQuery(anyString())).thenReturn(resultSet); + when(preparedStatement.executeUpdate(anyString())).thenReturn(1); + when(preparedStatement.executeUpdate(anyString(), anyInt())).thenReturn(1); + when(preparedStatement.executeUpdate(anyString(), (int[]) any())).thenReturn(1); + when(preparedStatement.executeUpdate(anyString(), (String[]) any())).thenReturn(1); + when(preparedStatement.execute(anyString())).thenReturn(true); + when(preparedStatement.execute(anyString(), anyInt())).thenReturn(true); + when(preparedStatement.execute(anyString(), (int[]) any())).thenReturn(true); + when(preparedStatement.execute(anyString(), (String[]) any())).thenReturn(true); + when(preparedStatement.executeLargeUpdate(anyString())).thenReturn(2L); + when(preparedStatement.executeLargeUpdate(anyString(), anyInt())).thenReturn(2L); + when(preparedStatement.executeLargeUpdate(anyString(), (int[]) any())).thenReturn(2L); + when(preparedStatement.executeLargeUpdate(anyString(), (String[]) any())).thenReturn(2L); + + String sql = "select name from t_user"; + + assertTrue(proxy.executeQuery(sql) instanceof ResultSetProxy); + assertEquals(1, proxy.executeUpdate(sql)); + assertTrue(proxy.execute(sql)); + proxy.addBatch(sql); + assertEquals(2L, proxy.executeLargeUpdate(sql)); + assertEquals(1, proxy.executeUpdate(sql, java.sql.Statement.RETURN_GENERATED_KEYS)); + assertEquals(1, proxy.executeUpdate(sql, new int[]{1})); + assertEquals(1, proxy.executeUpdate(sql, new String[]{"id"})); + assertTrue(proxy.execute(sql, java.sql.Statement.RETURN_GENERATED_KEYS)); + assertTrue(proxy.execute(sql, new int[]{1})); + assertTrue(proxy.execute(sql, new String[]{"id"})); + assertEquals(2L, proxy.executeLargeUpdate(sql, java.sql.Statement.RETURN_GENERATED_KEYS)); + assertEquals(2L, proxy.executeLargeUpdate(sql, new int[]{1})); + assertEquals(2L, proxy.executeLargeUpdate(sql, new String[]{"id"})); + + ArgumentCaptor captor = ArgumentCaptor.forClass(String.class); + verify(preparedStatement).executeQuery(captor.capture()); + assertTrue(captor.getValue().contains("id > 100")); + verify(preparedStatement).addBatch(captor.capture()); + assertTrue(captor.getValue().contains("id > 100")); + } + + @Test + void testResultSetWrapping() throws SQLException { + ResultSet resultSet = mockEmptyResultSet(); + ResultSet generatedKeys = mockEmptyResultSet(); + when(preparedStatement.getResultSet()).thenReturn(resultSet); + when(preparedStatement.getGeneratedKeys()).thenReturn(generatedKeys); + + assertTrue(proxy.getResultSet() instanceof ResultSetProxy); + assertTrue(proxy.getGeneratedKeys() instanceof ResultSetProxy); + } + + @Test + void testGetConnectionReturnsConnectionProxy() throws SQLException { + Connection connection = mock(Connection.class); + when(preparedStatement.getConnection()).thenReturn(connection); + assertTrue(proxy.getConnection() instanceof ConnectionProxy); + } + + @Test + void testAttributeDelegates() throws SQLException { + when(preparedStatement.getMaxFieldSize()).thenReturn(1); + when(preparedStatement.getMaxRows()).thenReturn(2); + when(preparedStatement.getQueryTimeout()).thenReturn(3); + SQLWarning warning = mock(SQLWarning.class); + when(preparedStatement.getWarnings()).thenReturn(warning); + when(preparedStatement.getUpdateCount()).thenReturn(4); + when(preparedStatement.getMoreResults()).thenReturn(true); + when(preparedStatement.getFetchDirection()).thenReturn(ResultSet.FETCH_FORWARD); + when(preparedStatement.getFetchSize()).thenReturn(5); + when(preparedStatement.getResultSetConcurrency()).thenReturn(ResultSet.CONCUR_READ_ONLY); + when(preparedStatement.getResultSetType()).thenReturn(ResultSet.TYPE_FORWARD_ONLY); + when(preparedStatement.getMoreResults(java.sql.Statement.CLOSE_CURRENT_RESULT)).thenReturn(false); + when(preparedStatement.getResultSetHoldability()).thenReturn(ResultSet.HOLD_CURSORS_OVER_COMMIT); + when(preparedStatement.isClosed()).thenReturn(false); + when(preparedStatement.isPoolable()).thenReturn(true); + when(preparedStatement.isCloseOnCompletion()).thenReturn(false); + when(preparedStatement.getLargeUpdateCount()).thenReturn(6L); + when(preparedStatement.getLargeMaxRows()).thenReturn(7L); + when(preparedStatement.executeBatch()).thenReturn(new int[]{1}); + when(preparedStatement.executeLargeBatch()).thenReturn(new long[]{2L}); + + assertEquals(1, proxy.getMaxFieldSize()); + assertEquals(2, proxy.getMaxRows()); + assertEquals(3, proxy.getQueryTimeout()); + assertSame(warning, proxy.getWarnings()); + assertEquals(4, proxy.getUpdateCount()); + assertTrue(proxy.getMoreResults()); + assertEquals(ResultSet.FETCH_FORWARD, proxy.getFetchDirection()); + assertEquals(5, proxy.getFetchSize()); + assertEquals(ResultSet.CONCUR_READ_ONLY, proxy.getResultSetConcurrency()); + assertEquals(ResultSet.TYPE_FORWARD_ONLY, proxy.getResultSetType()); + assertEquals(false, proxy.getMoreResults(java.sql.Statement.CLOSE_CURRENT_RESULT)); + assertEquals(ResultSet.HOLD_CURSORS_OVER_COMMIT, proxy.getResultSetHoldability()); + assertEquals(false, proxy.isClosed()); + assertTrue(proxy.isPoolable()); + assertEquals(false, proxy.isCloseOnCompletion()); + assertEquals(6L, proxy.getLargeUpdateCount()); + assertEquals(7L, proxy.getLargeMaxRows()); + assertEquals(1, proxy.executeBatch().length); + assertEquals(1, proxy.executeLargeBatch().length); + + proxy.setMaxFieldSize(10); + proxy.setMaxRows(20); + proxy.setEscapeProcessing(true); + proxy.setQueryTimeout(30); + proxy.setFetchDirection(ResultSet.FETCH_REVERSE); + proxy.setFetchSize(40); + proxy.setPoolable(false); + proxy.setLargeMaxRows(50L); + proxy.clearWarnings(); + proxy.clearBatch(); + proxy.closeOnCompletion(); + proxy.close(); + proxy.cancel(); + proxy.setCursorName("cursor"); + + verify(preparedStatement).setMaxFieldSize(10); + verify(preparedStatement).setMaxRows(20); + verify(preparedStatement).setEscapeProcessing(true); + verify(preparedStatement).setQueryTimeout(30); + verify(preparedStatement).setFetchDirection(ResultSet.FETCH_REVERSE); + verify(preparedStatement).setFetchSize(40); + verify(preparedStatement).setPoolable(false); + verify(preparedStatement).setLargeMaxRows(50L); + verify(preparedStatement).clearWarnings(); + verify(preparedStatement).clearBatch(); + verify(preparedStatement).closeOnCompletion(); + verify(preparedStatement).close(); + verify(preparedStatement).cancel(); + verify(preparedStatement).setCursorName("cursor"); + } + + @Test + void testEnquoteAndWrapperDelegates() throws SQLException { + when(preparedStatement.enquoteLiteral("v")).thenReturn("'v'"); + when(preparedStatement.enquoteIdentifier("id", true)).thenReturn("\"id\""); + when(preparedStatement.isSimpleIdentifier("id")).thenReturn(true); + when(preparedStatement.enquoteNCharLiteral("v")).thenReturn("N'v'"); + when(preparedStatement.unwrap(String.class)).thenReturn("unwrapped"); + when(preparedStatement.isWrapperFor(String.class)).thenReturn(true); + + assertEquals("'v'", proxy.enquoteLiteral("v")); + assertEquals("\"id\"", proxy.enquoteIdentifier("id", true)); + assertTrue(proxy.isSimpleIdentifier("id")); + assertEquals("N'v'", proxy.enquoteNCharLiteral("v")); + assertEquals("unwrapped", proxy.unwrap(String.class)); + assertTrue(proxy.isWrapperFor(String.class)); + } + + /** + * JDK 8 兼容: 构造真实 URL 代替 mock(URL.class)(final 类在 Mockito 4 默认不可 mock) + */ + private static URL toUrl() { + try { + return new URL("http://mock.local/"); + } catch (java.net.MalformedURLException e) { + throw new IllegalStateException(e); + } + } + +} diff --git a/springboot-starter-data-authorization/src/test/java/com/codingapi/springboot/authorization/jdbc/proxy/ResultSetProxyTest.java b/springboot-starter-data-authorization/src/test/java/com/codingapi/springboot/authorization/jdbc/proxy/ResultSetProxyTest.java new file mode 100644 index 000000000..5229d99af --- /dev/null +++ b/springboot-starter-data-authorization/src/test/java/com/codingapi/springboot/authorization/jdbc/proxy/ResultSetProxyTest.java @@ -0,0 +1,648 @@ +package com.codingapi.springboot.authorization.jdbc.proxy; + +import com.codingapi.springboot.authorization.DataAuthorizationContext; +import com.codingapi.springboot.authorization.filter.DefaultDataAuthorizationFilter; +import com.codingapi.springboot.authorization.handler.Condition; +import com.codingapi.springboot.authorization.interceptor.SQLExecuteState; +import com.codingapi.springboot.authorization.interceptor.SQLRunningContext; +import org.junit.jupiter.api.AfterEach; +import org.junit.jupiter.api.BeforeEach; +import org.junit.jupiter.api.Test; + +import java.io.ByteArrayInputStream; +import java.io.InputStream; +import java.io.Reader; +import java.io.StringReader; +import java.math.BigDecimal; +import java.net.URL; +import java.sql.Array; +import java.sql.Blob; +import java.sql.Clob; +import java.sql.Date; +import java.sql.NClob; +import java.sql.Ref; +import java.sql.ResultSet; +import java.sql.ResultSetMetaData; +import java.sql.RowId; +import java.sql.SQLException; +import java.sql.SQLWarning; +import java.sql.SQLXML; +import java.sql.Statement; +import java.sql.Time; +import java.sql.Timestamp; +import java.util.Calendar; +import java.util.HashMap; +import java.util.Map; + +import static org.junit.jupiter.api.Assertions.assertEquals; +import static org.junit.jupiter.api.Assertions.assertSame; +import static org.junit.jupiter.api.Assertions.assertTrue; +import static org.mockito.Mockito.mock; +import static org.mockito.Mockito.verify; +import static org.mockito.Mockito.when; + +/** + * ResultSetProxy 单元测试 + * 验证所有方法正确委托到底层 ResultSet，以及列权限拦截逻辑生效 + */ +class ResultSetProxyTest { + + private ResultSet resultSet; + private ResultSetMetaData metaData; + private ResultSetProxy proxy; + + /** + * 构造一个 t_user 表的行权限过滤器（id > 100）以及 name 列的列权限过滤器 + */ + static void registerTestFilter() { + DataAuthorizationContext.getInstance().addDataAuthorizationFilter(new DefaultDataAuthorizationFilter() { + @Override + public boolean supportRowAuthorization(String tableName, String tableAlias) { + return "t_user".equalsIgnoreCase(tableName); + } + + @Override + public Condition rowAuthorization(String tableName, String tableAlias) { + return Condition.formatCondition("%s.id > 100", tableAlias); + } + + @Override + public boolean supportColumnAuthorization(String tableName, String columnName, Object value) { + return "t_user".equalsIgnoreCase(tableName) && "name".equalsIgnoreCase(columnName); + } + + @SuppressWarnings("unchecked") + @Override + public T columnAuthorization(String tableName, String columnName, T value) { + if (value instanceof String) { + return (T) ("MASKED-" + value); + } + return value; + } + }); + } + + @BeforeEach + void setUp() throws SQLException { + DataAuthorizationContext.getInstance().clearDataAuthorizationFilters(); + registerTestFilter(); + + resultSet = mock(ResultSet.class); + metaData = mock(ResultSetMetaData.class); + when(resultSet.getMetaData()).thenReturn(metaData); + when(metaData.getColumnCount()).thenReturn(1); + when(metaData.getColumnLabel(1)).thenReturn("name"); + when(metaData.getTableName(1)).thenReturn("t_user"); + when(metaData.getColumnName(1)).thenReturn("name"); + // 默认使用未拦截状态，列权限不生效，直接透传底层值 + proxy = new ResultSetProxy(resultSet, SQLExecuteState.unIntercept("select 1")); + } + + @AfterEach + void tearDown() { + DataAuthorizationContext.getInstance().clearDataAuthorizationFilters(); + } + + @Test + void testNavigationAndCloseDelegates() throws SQLException { + when(resultSet.next()).thenReturn(true); + when(resultSet.wasNull()).thenReturn(true); + when(resultSet.isBeforeFirst()).thenReturn(true); + when(resultSet.isAfterLast()).thenReturn(false); + when(resultSet.isFirst()).thenReturn(true); + when(resultSet.isLast()).thenReturn(false); + when(resultSet.first()).thenReturn(true); + when(resultSet.last()).thenReturn(true); + when(resultSet.getRow()).thenReturn(5); + when(resultSet.absolute(3)).thenReturn(true); + when(resultSet.relative(2)).thenReturn(true); + when(resultSet.previous()).thenReturn(false); + when(resultSet.isClosed()).thenReturn(false); + when(resultSet.getHoldability()).thenReturn(ResultSet.HOLD_CURSORS_OVER_COMMIT); + when(resultSet.getType()).thenReturn(ResultSet.TYPE_FORWARD_ONLY); + when(resultSet.getConcurrency()).thenReturn(ResultSet.CONCUR_READ_ONLY); + when(resultSet.getFetchDirection()).thenReturn(ResultSet.FETCH_FORWARD); + when(resultSet.getFetchSize()).thenReturn(10); + when(resultSet.rowUpdated()).thenReturn(true); + when(resultSet.rowInserted()).thenReturn(false); + when(resultSet.rowDeleted()).thenReturn(false); + + assertTrue(proxy.next()); + verify(resultSet).next(); + assertTrue(proxy.wasNull()); + verify(resultSet).wasNull(); + + proxy.close(); + verify(resultSet).close(); + + assertTrue(proxy.isBeforeFirst()); + assertFalseNoImport(proxy.isAfterLast()); + assertTrue(proxy.isFirst()); + assertFalseNoImport(proxy.isLast()); + assertTrue(proxy.first()); + assertTrue(proxy.last()); + assertEquals(5, proxy.getRow()); + assertTrue(proxy.absolute(3)); + assertTrue(proxy.relative(2)); + assertFalseNoImport(proxy.previous()); + assertFalseNoImport(proxy.isClosed()); + assertEquals(ResultSet.HOLD_CURSORS_OVER_COMMIT, proxy.getHoldability()); + assertEquals(ResultSet.TYPE_FORWARD_ONLY, proxy.getType()); + assertEquals(ResultSet.CONCUR_READ_ONLY, proxy.getConcurrency()); + assertEquals(ResultSet.FETCH_FORWARD, proxy.getFetchDirection()); + assertEquals(10, proxy.getFetchSize()); + assertTrue(proxy.rowUpdated()); + assertFalseNoImport(proxy.rowInserted()); + assertFalseNoImport(proxy.rowDeleted()); + + proxy.beforeFirst(); + verify(resultSet).beforeFirst(); + proxy.afterLast(); + verify(resultSet).afterLast(); + proxy.setFetchDirection(ResultSet.FETCH_REVERSE); + verify(resultSet).setFetchDirection(ResultSet.FETCH_REVERSE); + proxy.setFetchSize(20); + verify(resultSet).setFetchSize(20); + } + + private static void assertFalseNoImport(boolean value) { + assertEquals(false, value); + } + + @Test + void testGettersByColumnIndexDelegate() throws SQLException { + when(resultSet.getString(1)).thenReturn("value"); + when(resultSet.getBoolean(1)).thenReturn(true); + when(resultSet.getByte(1)).thenReturn((byte) 1); + when(resultSet.getShort(1)).thenReturn((short) 2); + when(resultSet.getInt(1)).thenReturn(3); + when(resultSet.getLong(1)).thenReturn(4L); + when(resultSet.getFloat(1)).thenReturn(5.0f); + when(resultSet.getDouble(1)).thenReturn(6.0d); + when(resultSet.getBigDecimal(1)).thenReturn(BigDecimal.ONE); + when(resultSet.getBigDecimal(1, 2)).thenReturn(BigDecimal.TEN); + when(resultSet.getBytes(1)).thenReturn(new byte[]{1, 2}); + Date date = new Date(1000L); + when(resultSet.getDate(1)).thenReturn(date); + Time time = new Time(2000L); + when(resultSet.getTime(1)).thenReturn(time); + Timestamp timestamp = new Timestamp(3000L); + when(resultSet.getTimestamp(1)).thenReturn(timestamp); + InputStream asciiStream = new ByteArrayInputStream(new byte[]{1}); + when(resultSet.getAsciiStream(1)).thenReturn(asciiStream); + InputStream unicodeStream = new ByteArrayInputStream(new byte[]{2}); + when(resultSet.getUnicodeStream(1)).thenReturn(unicodeStream); + InputStream binaryStream = new ByteArrayInputStream(new byte[]{3}); + when(resultSet.getBinaryStream(1)).thenReturn(binaryStream); + when(resultSet.getObject(1)).thenReturn("object"); + Reader characterReader = new StringReader("char"); + when(resultSet.getCharacterStream(1)).thenReturn(characterReader); + + // 未拦截状态下，所有值原样返回 + assertEquals("value", proxy.getString(1)); + assertEquals(true, proxy.getBoolean(1)); + assertEquals((byte) 1, proxy.getByte(1)); + assertEquals((short) 2, proxy.getShort(1)); + assertEquals(3, proxy.getInt(1)); + assertEquals(4L, proxy.getLong(1)); + assertEquals(5.0f, proxy.getFloat(1)); + assertEquals(6.0d, proxy.getDouble(1)); + assertEquals(BigDecimal.ONE, proxy.getBigDecimal(1)); + assertEquals(BigDecimal.TEN, proxy.getBigDecimal(1, 2)); + assertSame(date, proxy.getDate(1)); + assertSame(time, proxy.getTime(1)); + assertSame(timestamp, proxy.getTimestamp(1)); + assertSame(asciiStream, proxy.getAsciiStream(1)); + assertSame(unicodeStream, proxy.getUnicodeStream(1)); + assertSame(binaryStream, proxy.getBinaryStream(1)); + assertEquals("object", proxy.getObject(1)); + assertSame(characterReader, proxy.getCharacterStream(1)); + + verify(resultSet).getString(1); + verify(resultSet).getInt(1); + } + + @Test + void testGettersByColumnLabelDelegate() throws SQLException { + when(resultSet.getString(1)).thenReturn("value"); + when(resultSet.getBoolean(1)).thenReturn(true); + when(resultSet.getByte(1)).thenReturn((byte) 1); + when(resultSet.getShort(1)).thenReturn((short) 2); + when(resultSet.getInt(1)).thenReturn(3); + when(resultSet.getLong(1)).thenReturn(4L); + when(resultSet.getFloat(1)).thenReturn(5.0f); + when(resultSet.getDouble(1)).thenReturn(6.0d); + when(resultSet.getBigDecimal(1)).thenReturn(BigDecimal.ONE); + when(resultSet.getBigDecimal(1, 2)).thenReturn(BigDecimal.TEN); + when(resultSet.getBytes(1)).thenReturn(new byte[]{1}); + Date date = new Date(1000L); + when(resultSet.getDate(1)).thenReturn(date); + Time time = new Time(2000L); + when(resultSet.getTime(1)).thenReturn(time); + Timestamp timestamp = new Timestamp(3000L); + when(resultSet.getTimestamp(1)).thenReturn(timestamp); + InputStream asciiStream = new ByteArrayInputStream(new byte[]{1}); + when(resultSet.getAsciiStream(1)).thenReturn(asciiStream); + InputStream unicodeStream = new ByteArrayInputStream(new byte[]{2}); + when(resultSet.getUnicodeStream(1)).thenReturn(unicodeStream); + InputStream binaryStream = new ByteArrayInputStream(new byte[]{3}); + when(resultSet.getBinaryStream(1)).thenReturn(binaryStream); + when(resultSet.getObject(1)).thenReturn("object"); + Reader characterReader = new StringReader("char"); + when(resultSet.getCharacterStream(1)).thenReturn(characterReader); + + // 通过列标签访问，内部根据 columnLabelMap 转换为索引 1 + assertEquals("value", proxy.getString("name")); + assertEquals("value", proxy.getString("NAME")); + assertEquals(true, proxy.getBoolean("name")); + assertEquals((byte) 1, proxy.getByte("name")); + assertEquals((short) 2, proxy.getShort("name")); + assertEquals(3, proxy.getInt("name")); + assertEquals(4L, proxy.getLong("name")); + assertEquals(5.0f, proxy.getFloat("name")); + assertEquals(6.0d, proxy.getDouble("name")); + assertEquals(BigDecimal.ONE, proxy.getBigDecimal("name")); + assertEquals(BigDecimal.TEN, proxy.getBigDecimal("name", 2)); + assertSame(date, proxy.getDate("name")); + assertSame(time, proxy.getTime("name")); + assertSame(timestamp, proxy.getTimestamp("name")); + assertSame(asciiStream, proxy.getAsciiStream("name")); + assertSame(unicodeStream, proxy.getUnicodeStream("name")); + assertSame(binaryStream, proxy.getBinaryStream("name")); + assertEquals("object", proxy.getObject("name")); + assertSame(characterReader, proxy.getCharacterStream("name")); + } + + @Test + void testColumnAuthorizationWithInterceptState() throws SQLException { + // 使用真实拦截流程构造拦截状态：select name from t_user 会被注入 t_user.id > 100 + SQLExecuteState interceptState = SQLRunningContext.getInstance().intercept("select name from t_user"); + assertTrue(interceptState.hasIntercept()); + ResultSetProxy interceptProxy = new ResultSetProxy(resultSet, interceptState); + + when(resultSet.getString(1)).thenReturn("raw"); + // 列权限过滤器生效，t_user.name 的值被加工 + assertEquals("MASKED-raw", interceptProxy.getString(1)); + assertEquals("MASKED-raw", interceptProxy.getString("name")); + + when(resultSet.getNString(1)).thenReturn("nraw"); + assertEquals("MASKED-nraw", interceptProxy.getNString(1)); + assertEquals("MASKED-nraw", interceptProxy.getNString("name")); + + when(resultSet.getObject(1)).thenReturn("oraw"); + assertEquals("MASKED-oraw", interceptProxy.getObject(1)); + assertEquals("MASKED-oraw", interceptProxy.getObject("name")); + } + + @Test + void testSimpleDelegates() throws SQLException { + SQLWarning warning = mock(SQLWarning.class); + when(resultSet.getWarnings()).thenReturn(warning); + when(resultSet.getCursorName()).thenReturn("cursor"); + when(resultSet.findColumn("name")).thenReturn(1); + Statement statement = mock(Statement.class); + when(resultSet.getStatement()).thenReturn(statement); + + assertSame(warning, proxy.getWarnings()); + proxy.clearWarnings(); + verify(resultSet).clearWarnings(); + assertEquals("cursor", proxy.getCursorName()); + assertSame(metaData, proxy.getMetaData()); + assertEquals(1, proxy.findColumn("name")); + assertSame(statement, proxy.getStatement()); + } + + @Test + void testObjectAndLobGettersByIndex() throws SQLException { + Ref ref = mock(Ref.class); + Blob blob = mock(Blob.class); + Clob clob = mock(Clob.class); + Array array = mock(Array.class); + NClob nClob = mock(NClob.class); + SQLXML sqlxml = mock(SQLXML.class); + RowId rowId = mock(RowId.class); + URL url = toUrl(); + Date date = new Date(1000L); + + when(resultSet.getRef(1)).thenReturn(ref); + when(resultSet.getBlob(1)).thenReturn(blob); + when(resultSet.getClob(1)).thenReturn(clob); + when(resultSet.getArray(1)).thenReturn(array); + when(resultSet.getNClob(1)).thenReturn(nClob); + when(resultSet.getSQLXML(1)).thenReturn(sqlxml); + when(resultSet.getRowId(1)).thenReturn(rowId); + when(resultSet.getURL(1)).thenReturn(url); + when(resultSet.getDate(1)).thenReturn(date); + when(resultSet.getObject(1)).thenReturn("obj"); + when(resultSet.getObject(1, String.class)).thenReturn("typed"); + + Map> map = new HashMap<>(); + // 注意：getObject(int, Map) 当前实现内部调用的是 resultSet.getDate(columnIndex) + // 此处断言的是当前（有缺陷的）行为，详见测试报告 + assertSame(date, proxy.getObject(1, map)); + assertSame(ref, proxy.getRef(1)); + assertSame(blob, proxy.getBlob(1)); + assertSame(clob, proxy.getClob(1)); + assertSame(array, proxy.getArray(1)); + assertSame(nClob, proxy.getNClob(1)); + assertSame(sqlxml, proxy.getSQLXML(1)); + assertSame(rowId, proxy.getRowId(1)); + assertSame(url, proxy.getURL(1)); + assertEquals("typed", proxy.getObject(1, String.class)); + } + + @Test + void testObjectAndLobGettersByLabel() throws SQLException { + Ref ref = mock(Ref.class); + Blob blob = mock(Blob.class); + Clob clob = mock(Clob.class); + Array array = mock(Array.class); + NClob nClob = mock(NClob.class); + SQLXML sqlxml = mock(SQLXML.class); + RowId rowId = mock(RowId.class); + URL url = toUrl(); + Date date = new Date(1000L); + + when(resultSet.getRef(1)).thenReturn(ref); + when(resultSet.getBlob(1)).thenReturn(blob); + when(resultSet.getClob(1)).thenReturn(clob); + when(resultSet.getArray(1)).thenReturn(array); + when(resultSet.getNClob(1)).thenReturn(nClob); + when(resultSet.getSQLXML(1)).thenReturn(sqlxml); + when(resultSet.getRowId(1)).thenReturn(rowId); + when(resultSet.getURL(1)).thenReturn(url); + when(resultSet.getDate(1)).thenReturn(date); + when(resultSet.getObject(1)).thenReturn("obj"); + when(resultSet.getObject(1, String.class)).thenReturn("typed"); + + Map> map = new HashMap<>(); + // getObject(String, Map) 内部调用的是 getObject(columnIndex)，忽略了 map 参数 + assertEquals("obj", proxy.getObject("name", map)); + assertSame(ref, proxy.getRef("name")); + assertSame(blob, proxy.getBlob("name")); + assertSame(clob, proxy.getClob("name")); + assertSame(array, proxy.getArray("name")); + assertSame(nClob, proxy.getNClob("name")); + assertSame(sqlxml, proxy.getSQLXML("name")); + assertSame(rowId, proxy.getRowId("name")); + assertSame(url, proxy.getURL("name")); + assertEquals("typed", proxy.getObject("name", String.class)); + } + + @Test + void testCalendarGetters() throws SQLException { + Calendar calendar = Calendar.getInstance(); + Date date = new Date(1000L); + Time time = new Time(2000L); + Timestamp timestamp = new Timestamp(3000L); + + when(resultSet.getDate(1, calendar)).thenReturn(date); + when(resultSet.getTime(1, calendar)).thenReturn(time); + when(resultSet.getTimestamp(1, calendar)).thenReturn(timestamp); + + assertSame(date, proxy.getDate(1, calendar)); + assertSame(date, proxy.getDate("name", calendar)); + assertSame(time, proxy.getTime(1, calendar)); + assertSame(time, proxy.getTime("name", calendar)); + assertSame(timestamp, proxy.getTimestamp(1, calendar)); + assertSame(timestamp, proxy.getTimestamp("name", calendar)); + } + + @Test + void testNCharacterStreamGetters() throws SQLException { + Reader reader = new StringReader("nchar"); + when(resultSet.getNCharacterStream(1)).thenReturn(reader); + assertSame(reader, proxy.getNCharacterStream(1)); + assertSame(reader, proxy.getNCharacterStream("name")); + } + + @Test + void testUpdateMethodsByIndex() throws SQLException { + InputStream inputStream = new ByteArrayInputStream(new byte[]{1}); + Reader reader = new StringReader("x"); + Date date = new Date(1000L); + Time time = new Time(2000L); + Timestamp timestamp = new Timestamp(3000L); + Ref ref = mock(Ref.class); + Blob blob = mock(Blob.class); + Clob clob = mock(Clob.class); + Array array = mock(Array.class); + RowId rowId = mock(RowId.class); + NClob nClob = mock(NClob.class); + SQLXML sqlxml = mock(SQLXML.class); + + proxy.updateNull(1); + proxy.updateBoolean(1, true); + proxy.updateByte(1, (byte) 1); + proxy.updateShort(1, (short) 1); + proxy.updateInt(1, 1); + proxy.updateLong(1, 1L); + proxy.updateFloat(1, 1.0f); + proxy.updateDouble(1, 1.0d); + proxy.updateBigDecimal(1, BigDecimal.ONE); + proxy.updateString(1, "x"); + proxy.updateBytes(1, new byte[]{1}); + proxy.updateDate(1, date); + proxy.updateTime(1, time); + proxy.updateTimestamp(1, timestamp); + proxy.updateAsciiStream(1, inputStream, 1); + proxy.updateBinaryStream(1, inputStream, 1); + proxy.updateCharacterStream(1, reader, 1); + proxy.updateObject(1, "x", 1); + proxy.updateObject(1, "x"); + proxy.updateRef(1, ref); + proxy.updateBlob(1, blob); + proxy.updateClob(1, clob); + proxy.updateArray(1, array); + proxy.updateRowId(1, rowId); + proxy.updateNString(1, "x"); + proxy.updateNClob(1, nClob); + proxy.updateSQLXML(1, sqlxml); + proxy.updateNCharacterStream(1, reader, 1L); + proxy.updateAsciiStream(1, inputStream, 1L); + proxy.updateBinaryStream(1, inputStream, 1L); + proxy.updateCharacterStream(1, reader, 1L); + proxy.updateBlob(1, inputStream, 1L); + proxy.updateClob(1, reader, 1L); + proxy.updateNClob(1, reader, 1L); + proxy.updateNCharacterStream(1, reader); + proxy.updateAsciiStream(1, inputStream); + proxy.updateBinaryStream(1, inputStream); + proxy.updateCharacterStream(1, reader); + proxy.updateBlob(1, inputStream); + proxy.updateClob(1, reader); + proxy.updateNClob(1, reader); + proxy.updateObject(1, "x", java.sql.JDBCType.VARCHAR, 1); + proxy.updateObject(1, "x", java.sql.JDBCType.VARCHAR); + + verify(resultSet).updateNull(1); + verify(resultSet).updateBoolean(1, true); + verify(resultSet).updateByte(1, (byte) 1); + verify(resultSet).updateShort(1, (short) 1); + verify(resultSet).updateInt(1, 1); + verify(resultSet).updateLong(1, 1L); + verify(resultSet).updateFloat(1, 1.0f); + verify(resultSet).updateDouble(1, 1.0d); + verify(resultSet).updateBigDecimal(1, BigDecimal.ONE); + verify(resultSet).updateString(1, "x"); + verify(resultSet).updateDate(1, date); + verify(resultSet).updateTime(1, time); + verify(resultSet).updateTimestamp(1, timestamp); + verify(resultSet).updateAsciiStream(1, inputStream, 1); + verify(resultSet).updateBinaryStream(1, inputStream, 1); + verify(resultSet).updateCharacterStream(1, reader, 1); + verify(resultSet).updateObject(1, "x", 1); + verify(resultSet).updateObject(1, "x"); + verify(resultSet).updateRef(1, ref); + verify(resultSet).updateBlob(1, blob); + verify(resultSet).updateClob(1, clob); + verify(resultSet).updateArray(1, array); + verify(resultSet).updateRowId(1, rowId); + verify(resultSet).updateNString(1, "x"); + verify(resultSet).updateNClob(1, nClob); + verify(resultSet).updateSQLXML(1, sqlxml); + verify(resultSet).updateNCharacterStream(1, reader, 1L); + verify(resultSet).updateAsciiStream(1, inputStream, 1L); + verify(resultSet).updateBinaryStream(1, inputStream, 1L); + verify(resultSet).updateCharacterStream(1, reader, 1L); + verify(resultSet).updateBlob(1, inputStream, 1L); + verify(resultSet).updateClob(1, reader, 1L); + verify(resultSet).updateNClob(1, reader, 1L); + verify(resultSet).updateNCharacterStream(1, reader); + verify(resultSet).updateAsciiStream(1, inputStream); + verify(resultSet).updateBinaryStream(1, inputStream); + verify(resultSet).updateCharacterStream(1, reader); + verify(resultSet).updateBlob(1, inputStream); + verify(resultSet).updateClob(1, reader); + verify(resultSet).updateNClob(1, reader); + verify(resultSet).updateObject(1, "x", java.sql.JDBCType.VARCHAR, 1); + verify(resultSet).updateObject(1, "x", java.sql.JDBCType.VARCHAR); + } + + @Test + void testUpdateMethodsByLabel() throws SQLException { + InputStream inputStream = new ByteArrayInputStream(new byte[]{1}); + Reader reader = new StringReader("x"); + Date date = new Date(1000L); + Time time = new Time(2000L); + Timestamp timestamp = new Timestamp(3000L); + Ref ref = mock(Ref.class); + Blob blob = mock(Blob.class); + Clob clob = mock(Clob.class); + Array array = mock(Array.class); + RowId rowId = mock(RowId.class); + NClob nClob = mock(NClob.class); + SQLXML sqlxml = mock(SQLXML.class); + + proxy.updateNull("name"); + proxy.updateBoolean("name", true); + proxy.updateByte("name", (byte) 1); + proxy.updateShort("name", (short) 1); + proxy.updateInt("name", 1); + proxy.updateLong("name", 1L); + proxy.updateFloat("name", 1.0f); + proxy.updateDouble("name", 1.0d); + proxy.updateBigDecimal("name", BigDecimal.ONE); + proxy.updateString("name", "x"); + proxy.updateBytes("name", new byte[]{1}); + proxy.updateDate("name", date); + proxy.updateTime("name", time); + proxy.updateTimestamp("name", timestamp); + proxy.updateAsciiStream("name", inputStream, 1); + proxy.updateBinaryStream("name", inputStream, 1); + proxy.updateCharacterStream("name", reader, 1); + proxy.updateObject("name", "x", 1); + proxy.updateObject("name", "x"); + proxy.updateRef("name", ref); + proxy.updateBlob("name", blob); + proxy.updateClob("name", clob); + proxy.updateArray("name", array); + proxy.updateRowId("name", rowId); + proxy.updateNString("name", "x"); + proxy.updateNClob("name", nClob); + proxy.updateSQLXML("name", sqlxml); + proxy.updateNCharacterStream("name", reader, 1L); + proxy.updateAsciiStream("name", inputStream, 1L); + proxy.updateBinaryStream("name", inputStream, 1L); + proxy.updateCharacterStream("name", reader, 1L); + proxy.updateBlob("name", inputStream, 1L); + proxy.updateClob("name", reader, 1L); + proxy.updateNClob("name", reader, 1L); + proxy.updateNCharacterStream("name", reader); + proxy.updateAsciiStream("name", inputStream); + proxy.updateBinaryStream("name", inputStream); + proxy.updateCharacterStream("name", reader); + proxy.updateBlob("name", inputStream); + proxy.updateClob("name", reader); + proxy.updateNClob("name", reader); + proxy.updateObject("name", "x", java.sql.JDBCType.VARCHAR, 1); + proxy.updateObject("name", "x", java.sql.JDBCType.VARCHAR); + + verify(resultSet).updateNull("name"); + verify(resultSet).updateBoolean("name", true); + verify(resultSet).updateString("name", "x"); + verify(resultSet).updateDate("name", date); + verify(resultSet).updateTime("name", time); + verify(resultSet).updateTimestamp("name", timestamp); + verify(resultSet).updateRef("name", ref); + verify(resultSet).updateBlob("name", blob); + verify(resultSet).updateClob("name", clob); + verify(resultSet).updateArray("name", array); + verify(resultSet).updateRowId("name", rowId); + verify(resultSet).updateNString("name", "x"); + verify(resultSet).updateNClob("name", nClob); + verify(resultSet).updateSQLXML("name", sqlxml); + verify(resultSet).updateObject("name", "x", java.sql.JDBCType.VARCHAR, 1); + verify(resultSet).updateObject("name", "x", java.sql.JDBCType.VARCHAR); + } + + @Test + void testRowManipulationDelegates() throws SQLException { + proxy.insertRow(); + proxy.updateRow(); + proxy.deleteRow(); + proxy.refreshRow(); + proxy.cancelRowUpdates(); + proxy.moveToInsertRow(); + proxy.moveToCurrentRow(); + + verify(resultSet).insertRow(); + verify(resultSet).updateRow(); + verify(resultSet).deleteRow(); + verify(resultSet).refreshRow(); + verify(resultSet).cancelRowUpdates(); + verify(resultSet).moveToInsertRow(); + verify(resultSet).moveToCurrentRow(); + } + + @Test + void testWrapperDelegates() throws SQLException { + when(resultSet.unwrap(String.class)).thenReturn("unwrapped"); + when(resultSet.isWrapperFor(String.class)).thenReturn(true); + + assertEquals("unwrapped", proxy.unwrap(String.class)); + assertTrue(proxy.isWrapperFor(String.class)); + } + + @Test + void testGetStringWithUnrelatedColumnNotMasked() throws SQLException { + // 拦截状态下，非受管列（columnName 非 name）不触发列权限，值原样返回 + SQLExecuteState interceptState = SQLRunningContext.getInstance().intercept("select name from t_user"); + when(metaData.getColumnName(1)).thenReturn("other_column"); + when(resultSet.getString(1)).thenReturn("plain"); + ResultSetProxy interceptProxy = new ResultSetProxy(resultSet, interceptState); + assertEquals("plain", interceptProxy.getString(1)); + } + + /** + * JDK 8 兼容: 构造真实 URL 代替 mock(URL.class)(final 类在 Mockito 4 默认不可 mock) + */ + private static URL toUrl() { + try { + return new URL("http://mock.local/"); + } catch (java.net.MalformedURLException e) { + throw new IllegalStateException(e); + } + } + +} diff --git a/springboot-starter-data-authorization/src/test/java/com/codingapi/springboot/authorization/jdbc/proxy/StatementProxyTest.java b/springboot-starter-data-authorization/src/test/java/com/codingapi/springboot/authorization/jdbc/proxy/StatementProxyTest.java new file mode 100644 index 000000000..aa1fafab3 --- /dev/null +++ b/springboot-starter-data-authorization/src/test/java/com/codingapi/springboot/authorization/jdbc/proxy/StatementProxyTest.java @@ -0,0 +1,246 @@ +package com.codingapi.springboot.authorization.jdbc.proxy; + +import com.codingapi.springboot.authorization.DataAuthorizationContext; +import com.codingapi.springboot.authorization.interceptor.SQLExecuteState; +import org.junit.jupiter.api.AfterEach; +import org.junit.jupiter.api.BeforeEach; +import org.junit.jupiter.api.Test; +import org.mockito.ArgumentCaptor; + +import java.sql.Connection; +import java.sql.ResultSet; +import java.sql.ResultSetMetaData; +import java.sql.SQLException; +import java.sql.SQLWarning; +import java.sql.Statement; + +import static org.junit.jupiter.api.Assertions.assertEquals; +import static org.junit.jupiter.api.Assertions.assertSame; +import static org.junit.jupiter.api.Assertions.assertTrue; +import static org.mockito.ArgumentMatchers.anyInt; +import static org.mockito.ArgumentMatchers.anyString; +import static org.mockito.Mockito.mock; +import static org.mockito.Mockito.verify; +import static org.mockito.Mockito.when; + +/** + * StatementProxy 单元测试 + * 验证方法委托以及 SQL 拦截行为 + */ +class StatementProxyTest { + + private Statement statement; + private StatementProxy proxy; + + @BeforeEach + void setUp() throws SQLException { + DataAuthorizationContext.getInstance().clearDataAuthorizationFilters(); + ResultSetProxyTest.registerTestFilter(); + + statement = mock(Statement.class); + proxy = new StatementProxy(statement, SQLExecuteState.unIntercept("select 1")); + } + + @AfterEach + void tearDown() { + DataAuthorizationContext.getInstance().clearDataAuthorizationFilters(); + } + + private ResultSet mockEmptyResultSet() throws SQLException { + ResultSet resultSet = mock(ResultSet.class); + ResultSetMetaData metaData = mock(ResultSetMetaData.class); + when(resultSet.getMetaData()).thenReturn(metaData); + when(metaData.getColumnCount()).thenReturn(0); + return resultSet; + } + + @Test + void testExecuteQueryInterceptsSql() throws SQLException { + ResultSet resultSet = mockEmptyResultSet(); + when(statement.executeQuery(anyString())).thenReturn(resultSet); + + ResultSet result = proxy.executeQuery("select name from t_user"); + + assertTrue(result instanceof ResultSetProxy); + ArgumentCaptor captor = ArgumentCaptor.forClass(String.class); + verify(statement).executeQuery(captor.capture()); + // SQL 被注入了行权限条件 + assertTrue(captor.getValue().contains("id > 100")); + } + + @Test + void testExecuteQueryWithoutInterception() throws SQLException { + ResultSet resultSet = mockEmptyResultSet(); + when(statement.executeQuery(anyString())).thenReturn(resultSet); + + // t_other 表未配置权限条件, 不会注入过滤条件; 但 SQL 仍会经 JSqlParser 解析并重新序列化(大小写可能变化) + proxy.executeQuery("select name from t_other"); + + ArgumentCaptor captor = ArgumentCaptor.forClass(String.class); + verify(statement).executeQuery(captor.capture()); + assertEquals("SELECT name FROM t_other", captor.getValue()); + } + + @Test + void testExecuteUpdateVariantsInterceptSql() throws SQLException { + when(statement.executeUpdate(anyString())).thenReturn(1); + when(statement.executeUpdate(anyString(), anyInt())).thenReturn(2); + when(statement.executeUpdate(anyString(), (int[]) org.mockito.ArgumentMatchers.any())).thenReturn(3); + when(statement.executeUpdate(anyString(), (String[]) org.mockito.ArgumentMatchers.any())).thenReturn(4); + when(statement.executeLargeUpdate(anyString())).thenReturn(5L); + when(statement.executeLargeUpdate(anyString(), anyInt())).thenReturn(6L); + when(statement.executeLargeUpdate(anyString(), (int[]) org.mockito.ArgumentMatchers.any())).thenReturn(7L); + when(statement.executeLargeUpdate(anyString(), (String[]) org.mockito.ArgumentMatchers.any())).thenReturn(8L); + + String sql = "select name from t_user"; + assertEquals(1, proxy.executeUpdate(sql)); + assertEquals(2, proxy.executeUpdate(sql, Statement.RETURN_GENERATED_KEYS)); + assertEquals(3, proxy.executeUpdate(sql, new int[]{1})); + assertEquals(4, proxy.executeUpdate(sql, new String[]{"id"})); + assertEquals(5L, proxy.executeLargeUpdate(sql)); + assertEquals(6L, proxy.executeLargeUpdate(sql, Statement.RETURN_GENERATED_KEYS)); + assertEquals(7L, proxy.executeLargeUpdate(sql, new int[]{1})); + assertEquals(8L, proxy.executeLargeUpdate(sql, new String[]{"id"})); + + ArgumentCaptor captor = ArgumentCaptor.forClass(String.class); + verify(statement).executeUpdate(captor.capture()); + assertTrue(captor.getValue().contains("id > 100")); + } + + @Test + void testExecuteVariantsInterceptSql() throws SQLException { + when(statement.execute(anyString())).thenReturn(true); + when(statement.execute(anyString(), anyInt())).thenReturn(true); + when(statement.execute(anyString(), (int[]) org.mockito.ArgumentMatchers.any())).thenReturn(true); + when(statement.execute(anyString(), (String[]) org.mockito.ArgumentMatchers.any())).thenReturn(true); + + String sql = "select name from t_user"; + assertTrue(proxy.execute(sql)); + assertTrue(proxy.execute(sql, Statement.RETURN_GENERATED_KEYS)); + assertTrue(proxy.execute(sql, new int[]{1})); + assertTrue(proxy.execute(sql, new String[]{"id"})); + + ArgumentCaptor captor = ArgumentCaptor.forClass(String.class); + verify(statement).execute(captor.capture()); + assertTrue(captor.getValue().contains("id > 100")); + } + + @Test + void testAddBatchInterceptsSql() throws SQLException { + proxy.addBatch("select name from t_user"); + ArgumentCaptor captor = ArgumentCaptor.forClass(String.class); + verify(statement).addBatch(captor.capture()); + assertTrue(captor.getValue().contains("id > 100")); + } + + @Test + void testResultSetWrapping() throws SQLException { + ResultSet resultSet = mockEmptyResultSet(); + ResultSet generatedKeys = mockEmptyResultSet(); + when(statement.getResultSet()).thenReturn(resultSet); + when(statement.getGeneratedKeys()).thenReturn(generatedKeys); + + assertTrue(proxy.getResultSet() instanceof ResultSetProxy); + assertTrue(proxy.getGeneratedKeys() instanceof ResultSetProxy); + verify(statement).getResultSet(); + verify(statement).getGeneratedKeys(); + } + + @Test + void testGetConnectionReturnsConnectionProxy() throws SQLException { + Connection connection = mock(Connection.class); + when(statement.getConnection()).thenReturn(connection); + assertTrue(proxy.getConnection() instanceof ConnectionProxy); + } + + @Test + void testAttributeDelegates() throws SQLException { + when(statement.getMaxFieldSize()).thenReturn(1); + when(statement.getMaxRows()).thenReturn(2); + when(statement.getQueryTimeout()).thenReturn(3); + SQLWarning warning = mock(SQLWarning.class); + when(statement.getWarnings()).thenReturn(warning); + when(statement.getUpdateCount()).thenReturn(4); + when(statement.getMoreResults()).thenReturn(true); + when(statement.getFetchDirection()).thenReturn(ResultSet.FETCH_FORWARD); + when(statement.getFetchSize()).thenReturn(5); + when(statement.getResultSetConcurrency()).thenReturn(ResultSet.CONCUR_READ_ONLY); + when(statement.getResultSetType()).thenReturn(ResultSet.TYPE_FORWARD_ONLY); + when(statement.getMoreResults(Statement.CLOSE_CURRENT_RESULT)).thenReturn(false); + when(statement.getResultSetHoldability()).thenReturn(ResultSet.HOLD_CURSORS_OVER_COMMIT); + when(statement.isClosed()).thenReturn(false); + when(statement.isPoolable()).thenReturn(true); + when(statement.isCloseOnCompletion()).thenReturn(false); + when(statement.getLargeUpdateCount()).thenReturn(6L); + when(statement.getLargeMaxRows()).thenReturn(7L); + when(statement.executeBatch()).thenReturn(new int[]{1, 2}); + when(statement.executeLargeBatch()).thenReturn(new long[]{3L, 4L}); + + assertEquals(1, proxy.getMaxFieldSize()); + assertEquals(2, proxy.getMaxRows()); + assertEquals(3, proxy.getQueryTimeout()); + assertSame(warning, proxy.getWarnings()); + assertEquals(4, proxy.getUpdateCount()); + assertTrue(proxy.getMoreResults()); + assertEquals(ResultSet.FETCH_FORWARD, proxy.getFetchDirection()); + assertEquals(5, proxy.getFetchSize()); + assertEquals(ResultSet.CONCUR_READ_ONLY, proxy.getResultSetConcurrency()); + assertEquals(ResultSet.TYPE_FORWARD_ONLY, proxy.getResultSetType()); + assertEquals(false, proxy.getMoreResults(Statement.CLOSE_CURRENT_RESULT)); + assertEquals(ResultSet.HOLD_CURSORS_OVER_COMMIT, proxy.getResultSetHoldability()); + assertEquals(false, proxy.isClosed()); + assertTrue(proxy.isPoolable()); + assertEquals(false, proxy.isCloseOnCompletion()); + assertEquals(6L, proxy.getLargeUpdateCount()); + assertEquals(7L, proxy.getLargeMaxRows()); + assertEquals(2, proxy.executeBatch().length); + assertEquals(2, proxy.executeLargeBatch().length); + + proxy.setMaxFieldSize(10); + proxy.setMaxRows(20); + proxy.setEscapeProcessing(true); + proxy.setQueryTimeout(30); + proxy.setFetchDirection(ResultSet.FETCH_REVERSE); + proxy.setFetchSize(40); + proxy.setPoolable(false); + proxy.setLargeMaxRows(50L); + proxy.clearWarnings(); + proxy.clearBatch(); + proxy.closeOnCompletion(); + proxy.close(); + proxy.cancel(); + proxy.setCursorName("cursor"); + + verify(statement).setMaxFieldSize(10); + verify(statement).setMaxRows(20); + verify(statement).setEscapeProcessing(true); + verify(statement).setQueryTimeout(30); + verify(statement).setFetchDirection(ResultSet.FETCH_REVERSE); + verify(statement).setFetchSize(40); + verify(statement).setPoolable(false); + verify(statement).setLargeMaxRows(50L); + verify(statement).clearWarnings(); + verify(statement).clearBatch(); + verify(statement).closeOnCompletion(); + verify(statement).close(); + verify(statement).cancel(); + verify(statement).setCursorName("cursor"); + } + + @Test + void testEnquoteAndWrapperDelegates() throws SQLException { + when(statement.enquoteLiteral("v")).thenReturn("'v'"); + when(statement.enquoteIdentifier("id", true)).thenReturn("\"id\""); + when(statement.isSimpleIdentifier("id")).thenReturn(true); + when(statement.enquoteNCharLiteral("v")).thenReturn("N'v'"); + when(statement.unwrap(String.class)).thenReturn("unwrapped"); + when(statement.isWrapperFor(String.class)).thenReturn(true); + + assertEquals("'v'", proxy.enquoteLiteral("v")); + assertEquals("\"id\"", proxy.enquoteIdentifier("id", true)); + assertTrue(proxy.isSimpleIdentifier("id")); + assertEquals("N'v'", proxy.enquoteNCharLiteral("v")); + assertEquals("unwrapped", proxy.unwrap(String.class)); + assertTrue(proxy.isWrapperFor(String.class)); + } +} diff --git a/springboot-starter-data-authorization/src/test/java/com/codingapi/springboot/authorization/mask/impl/BankCardMaskTest.java b/springboot-starter-data-authorization/src/test/java/com/codingapi/springboot/authorization/mask/impl/BankCardMaskTest.java new file mode 100644 index 000000000..0b75e2e4a --- /dev/null +++ b/springboot-starter-data-authorization/src/test/java/com/codingapi/springboot/authorization/mask/impl/BankCardMaskTest.java @@ -0,0 +1,17 @@ +package com.codingapi.springboot.authorization.mask.impl; + +import org.junit.jupiter.api.Test; + +import static org.junit.jupiter.api.Assertions.assertEquals; +import static org.junit.jupiter.api.Assertions.assertTrue; + +class BankCardMaskTest { + + @Test + void test() { + String bankCard = "6222021001111111111"; + BankCardMask mask = new BankCardMask(); + assertTrue(mask.support(bankCard)); + assertEquals("622202*********1111", mask.mask(bankCard)); + } +} diff --git a/springboot-starter-data-authorization/src/test/java/com/codingapi/springboot/authorization/mask/impl/IDCardMaskTest.java b/springboot-starter-data-authorization/src/test/java/com/codingapi/springboot/authorization/mask/impl/IDCardMaskTest.java new file mode 100644 index 000000000..3e7584521 --- /dev/null +++ b/springboot-starter-data-authorization/src/test/java/com/codingapi/springboot/authorization/mask/impl/IDCardMaskTest.java @@ -0,0 +1,16 @@ +package com.codingapi.springboot.authorization.mask.impl; + +import org.junit.jupiter.api.Test; + +import static org.junit.jupiter.api.Assertions.*; + +class IDCardMaskTest { + + @Test + void test(){ + String idCard = "110101199003074012"; + IDCardMask mask = new IDCardMask(); + assertTrue(mask.support(idCard)); + assertEquals("110101********4012", mask.mask(idCard)); + } +} diff --git a/springboot-starter-data-authorization/src/test/java/com/codingapi/springboot/authorization/mask/impl/PhoneMaskTest.java b/springboot-starter-data-authorization/src/test/java/com/codingapi/springboot/authorization/mask/impl/PhoneMaskTest.java new file mode 100644 index 000000000..d5c8d4f53 --- /dev/null +++ b/springboot-starter-data-authorization/src/test/java/com/codingapi/springboot/authorization/mask/impl/PhoneMaskTest.java @@ -0,0 +1,17 @@ +package com.codingapi.springboot.authorization.mask.impl; + +import org.junit.jupiter.api.Test; + +import static org.junit.jupiter.api.Assertions.*; + +class PhoneMaskTest { + + @Test + void test(){ + String phone = "15562581234"; + PhoneMask phoneMask = new PhoneMask(); + assertTrue(phoneMask.support(phone)); + assertEquals("155****1234", phoneMask.mask(phone)); + } + +} diff --git a/springboot-starter-data-authorization/src/test/java/com/codingapi/springboot/authorization/repository/DepartRepository.java b/springboot-starter-data-authorization/src/test/java/com/codingapi/springboot/authorization/repository/DepartRepository.java new file mode 100644 index 000000000..b9c00b843 --- /dev/null +++ b/springboot-starter-data-authorization/src/test/java/com/codingapi/springboot/authorization/repository/DepartRepository.java @@ -0,0 +1,8 @@ +package com.codingapi.springboot.authorization.repository; + +import com.codingapi.springboot.authorization.entity.Depart; +import org.springframework.data.jpa.repository.JpaRepository; + +public interface DepartRepository extends JpaRepository { + +} diff --git a/springboot-starter-data-authorization/src/test/java/com/codingapi/springboot/authorization/repository/UnitRepository.java b/springboot-starter-data-authorization/src/test/java/com/codingapi/springboot/authorization/repository/UnitRepository.java new file mode 100644 index 000000000..0bc6416d7 --- /dev/null +++ b/springboot-starter-data-authorization/src/test/java/com/codingapi/springboot/authorization/repository/UnitRepository.java @@ -0,0 +1,8 @@ +package com.codingapi.springboot.authorization.repository; + +import com.codingapi.springboot.authorization.entity.Unit; +import org.springframework.data.jpa.repository.JpaRepository; + +public interface UnitRepository extends JpaRepository { + +} diff --git a/springboot-starter-data-authorization/src/test/java/com/codingapi/springboot/authorization/repository/UserRepository.java b/springboot-starter-data-authorization/src/test/java/com/codingapi/springboot/authorization/repository/UserRepository.java new file mode 100644 index 000000000..f36df2478 --- /dev/null +++ b/springboot-starter-data-authorization/src/test/java/com/codingapi/springboot/authorization/repository/UserRepository.java @@ -0,0 +1,12 @@ +package com.codingapi.springboot.authorization.repository; + +import com.codingapi.springboot.authorization.entity.User; +import org.springframework.data.jpa.repository.JpaRepository; + +import java.util.List; + +public interface UserRepository extends JpaRepository { + + + List findUserByDepartId(long departId); +} diff --git a/springboot-starter-data-authorization/src/test/java/com/codingapi/springboot/authorization/utils/SQLUtilsTest.java b/springboot-starter-data-authorization/src/test/java/com/codingapi/springboot/authorization/utils/SQLUtilsTest.java new file mode 100644 index 000000000..2b8531c75 --- /dev/null +++ b/springboot-starter-data-authorization/src/test/java/com/codingapi/springboot/authorization/utils/SQLUtilsTest.java @@ -0,0 +1,37 @@ +package com.codingapi.springboot.authorization.utils; + +import org.junit.jupiter.api.Test; + +import static org.junit.jupiter.api.Assertions.assertFalse; +import static org.junit.jupiter.api.Assertions.assertTrue; + +/** + * SQLUtils 单元测试 + */ +class SQLUtilsTest { + + @Test + void testIsQuerySqlWithSelect() { + assertTrue(SQLUtils.isQuerySql("select * from t_user")); + assertTrue(SQLUtils.isQuerySql("SELECT id, name FROM t_user WHERE id = 1")); + } + + @Test + void testIsQuerySqlWithNonSelect() { + assertFalse(SQLUtils.isQuerySql("update t_user set name = 'x'")); + assertFalse(SQLUtils.isQuerySql("delete from t_user")); + assertFalse(SQLUtils.isQuerySql("insert into t_user(name) values('x')")); + } + + @Test + void testIsQuerySqlWithNullOrBlank() { + assertFalse(SQLUtils.isQuerySql(null)); + assertFalse(SQLUtils.isQuerySql("")); + assertFalse(SQLUtils.isQuerySql(" ")); + } + + @Test + void testIsQuerySqlWithInvalidSql() { + assertFalse(SQLUtils.isQuerySql("this is not a sql")); + } +} diff --git a/springboot-starter-data-authorization/src/test/resources/application.properties b/springboot-starter-data-authorization/src/test/resources/application.properties new file mode 100644 index 000000000..f5ac25190 --- /dev/null +++ b/springboot-starter-data-authorization/src/test/resources/application.properties @@ -0,0 +1,15 @@ + +spring.datasource.driver-class-name=com.codingapi.springboot.authorization.jdbc.AuthorizationJdbcDriver +spring.datasource.url=jdbc:h2:file:./test.db +spring.jpa.database-platform=org.hibernate.dialect.H2Dialect +spring.jpa.hibernate.ddl-auto=create-drop +spring.jpa.show-sql=true + +#spring.datasource.driver-class-name=com.codingapi.springboot.authorization.jdbc.AuthorizationJdbcDriver +#spring.datasource.url=jdbc:mysql://localhost:3306/example?createDatabaseIfNotExist=true&useUnicode=true&characterEncoding=utf-8&useSSL=false&serverTimezone=Asia/Shanghai&allowPublicKeyRetrieval=true +#spring.datasource.username=root +#spring.datasource.password=lorne4j#2024 + +logging.level.com.codingapi.springboot.authorization=debug + +codingapi.data-authorization.show-sql=true \ No newline at end of file diff --git a/springboot-starter-data-authorization/src/test/resources/issue212.sql b/springboot-starter-data-authorization/src/test/resources/issue212.sql new file mode 100644 index 000000000..0be156c1b --- /dev/null +++ b/springboot-starter-data-authorization/src/test/resources/issue212.sql @@ -0,0 +1,193 @@ +SELECT + id, + unit_name, + department_name, + employee_name, + sex, + former_name, + nationality_code, + person_nation_code, + card_type_code, + card_no, + card_birth_date, + present_address, + bron_place_desc, + native_place_desc, + household_type_code, + household_local, + political_affiliation_code, + join_date, + join_org_name, + introducer, + health_status_code, + marital_status_code, + whether_disabled, + staff_speciality, + sap_number, + remarks, + telephone, + email, + emergency_contact, + emergency_contact_relation_code, + emergency_contact_phone, + archive_birth_date, + orig_policy_retire_age_code, + is_use_new_policy_retire_age, + new_policy_retire_age, + start_work_date, + industry_entry_date, + entry_date, + company_entry_date, + industry_entry_type_code, + company_entry_type_code, + archival_custodian_code, + unit_center_record, + labor_type_code, + employment_form_code, + eoh_person_category_code, + whether_register, + contract_sign_unit, + full_time_diploma_code, + full_time_degree_code, + on_job_diploma_code, + on_job_degree_code, + highest_technology_name, + highest_technology_level_code, + highest_skill_name, + highest_skill_level_code, + employee_code, + person_code, + person_status_code, + post_type_code, + position_hierarchy_code +FROM + ( + SELECT + emp.*, + org.SYSTEM_CODE AS orgCode, + edu.highest_diploma_code, + edu.highest_degree_code, + edu.full_time_diploma_code, + edu.full_time_degree_code, + edu.on_job_diploma_code, + edu.on_job_degree_code, + tech.highest_technology_name, + tech.highest_technology_level_code, + skill.highest_skill_name, + skill.highest_skill_level_code, + post.post_type_code AS post_type_code, + curpos.position_hierarchy_code AS position_hierarchy_code + FROM + T_DYNAMIC_BIZ_PBM_EMP_BASIC_INFO emp + LEFT JOIN BIZ_PBM_ORGANIZATION org ON org.id = emp.department_id + LEFT JOIN ( + SELECT + e.employee_id, + e.highest_diploma_code, + e.highest_degree_code, + e.full_time_diploma_code, + e.full_time_degree_code, + e.on_job_diploma_code, + e.on_job_degree_code, + ROW_NUMBER() OVER ( + PARTITION BY + e.employee_id + ORDER BY + e.id DESC + ) AS rn + FROM + T_DYNAMIC_BIZ_PBM_EMP_EDUCATION_HIGHEST e + ) edu ON edu.employee_id = emp.id + AND edu.rn = 1 + LEFT JOIN ( + SELECT + t.employee_id, + t.highest_technology_name, + t.highest_technology_level_code, + ROW_NUMBER() OVER ( + PARTITION BY + t.employee_id + ORDER BY + t.id DESC + ) AS rn + FROM + T_DYNAMIC_BIZ_PBM_EMP_TECHNOLOGY_HIGHEST t + ) tech ON tech.employee_id = emp.id + AND tech.rn = 1 + LEFT JOIN ( + SELECT + s.employee_id, + s.highest_skill_name, + s.highest_skill_level_code, + ROW_NUMBER() OVER ( + PARTITION BY + s.employee_id + ORDER BY + s.id DESC + ) AS rn + FROM + T_DYNAMIC_BIZ_PBM_EMP_SKILL_HIGHEST s + ) skill ON skill.employee_id = emp.id + AND skill.rn = 1 + LEFT JOIN BIZ_PBM_POST post ON post.id = CAST(emp.post_id AS BIGINT) + LEFT JOIN ( + SELECT + c.employee_id, + c.position_hierarchy_code, + c.current_hierarchy_date + FROM + ( + SELECT + p.employee_id, + p.position_hierarchy_code, + p.current_hierarchy_date, + ROW_NUMBER() OVER ( + PARTITION BY + p.employee_id + ORDER BY + p.current_position_date DESC NULLS LAST, + p.id DESC + ) AS rn + FROM + T_DYNAMIC_BIZ_PBM_EMP_POSITION p + WHERE + p.whether_current = 1 + ) c + WHERE + c.rn = 1 + ) curpos ON curpos.employee_id = emp.id + WHERE + emp.sys_deleted = 0 + ORDER BY + CASE + WHEN org.SYSTEM_CODE IS NULL THEN 1 + ELSE 0 + END, + org.tree_sort, + CASE + WHEN curpos.position_hierarchy_code IS NULL THEN 1 + ELSE 0 + END, + CASE + WHEN curpos.position_hierarchy_code LIKE 'dict_u_w_p_layer%' THEN CAST( + REPLACE ( + curpos.position_hierarchy_code, + 'dict_u_w_p_layer_', + '' + ) AS INT + ) + ELSE 999 + END, + CASE + WHEN curpos.current_hierarchy_date IS NULL THEN 1 + ELSE 0 + END, + curpos.current_hierarchy_date, + emp.id + ) AS __base__ +WHERE + 1 = 1 +LIMIT + ? +OFFSET + ? diff --git a/springboot-starter-data-fast/pom.xml b/springboot-starter-data-fast/pom.xml index 141c3862c..b8d409681 100644 --- a/springboot-starter-data-fast/pom.xml +++ b/springboot-starter-data-fast/pom.xml @@ -5,19 +5,26 @@ springboot-parent com.codingapi.springboot - 2.1.11 + ${revision} 4.0.0 + springboot-starter-data-fast springboot-starter-data-fast + springboot-starter-data-fast project for Spring Boot - 17 + 8 + + net.bytebuddy + byte-buddy + + org.springframework.boot spring-boot-starter-web @@ -28,6 +35,17 @@ springboot-starter + + com.codingapi.springboot + springboot-starter-script + + + + jakarta.servlet + jakarta.servlet-api + provided + + org.springframework.boot spring-boot-starter-data-jpa @@ -39,6 +57,26 @@ test + + org.apache.commons + commons-text + + + + org.apache.groovy + groovy + + + + org.apache.groovy + groovy-json + + + + org.apache.groovy + groovy-xml + + - \ No newline at end of file + diff --git a/springboot-starter-data-fast/src/main/java/com/codingapi/springboot/fast/DataFastConfiguration.java b/springboot-starter-data-fast/src/main/java/com/codingapi/springboot/fast/DataFastConfiguration.java index 0dcf42687..33136595f 100644 --- a/springboot-starter-data-fast/src/main/java/com/codingapi/springboot/fast/DataFastConfiguration.java +++ b/springboot-starter-data-fast/src/main/java/com/codingapi/springboot/fast/DataFastConfiguration.java @@ -1,10 +1,9 @@ package com.codingapi.springboot.fast; -import com.codingapi.springboot.fast.executor.JpaExecutor; import com.codingapi.springboot.fast.manager.EntityManagerInitializer; -import com.codingapi.springboot.fast.mapping.MvcEndpointMapping; -import com.codingapi.springboot.fast.registrar.MvcMappingRegistrar; -import org.springframework.aop.Advisor; +import com.codingapi.springboot.fast.mapping.FastMvcMappingRegister; +import com.codingapi.springboot.fast.script.FastScriptMappingRegister; +import org.springframework.beans.factory.annotation.Qualifier; import org.springframework.boot.autoconfigure.condition.ConditionalOnClass; import org.springframework.boot.autoconfigure.condition.ConditionalOnMissingBean; import org.springframework.context.annotation.Bean; @@ -12,8 +11,7 @@ import org.springframework.web.servlet.config.annotation.WebMvcConfigurer; import org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerMapping; -import jakarta.persistence.EntityManager; -import java.util.List; +import javax.persistence.EntityManager; @Configuration @ConditionalOnClass(WebMvcConfigurer.class) @@ -22,28 +20,21 @@ public class DataFastConfiguration { @Bean @ConditionalOnMissingBean - public MvcEndpointMapping mvcEndpointMapping(RequestMappingHandlerMapping handlerMapping) { - return new MvcEndpointMapping(handlerMapping); + public FastMvcMappingRegister mvcMappingRegister(@Qualifier("requestMappingHandlerMapping") RequestMappingHandlerMapping handlerMapping) { + return new FastMvcMappingRegister(handlerMapping); } - @Bean(initMethod = "registerMvcMapping") - @ConditionalOnMissingBean - public MvcMappingRegistrar mappingRegistrar(MvcEndpointMapping mvcEndpointMapping, - JpaExecutor jpaExecutor, - List advisors) { - return new MvcMappingRegistrar(mvcEndpointMapping, jpaExecutor,advisors); - } @Bean @ConditionalOnMissingBean - public EntityManagerInitializer entityManagerInitializer(EntityManager entityManager){ + public EntityManagerInitializer entityManagerInitializer(EntityManager entityManager) { return new EntityManagerInitializer(entityManager); } + @Bean - @ConditionalOnMissingBean - public JpaExecutor jpaExecutor(EntityManager entityManager) { - return new JpaExecutor(entityManager); + public FastScriptMappingRegister scriptMappingRegister(FastMvcMappingRegister fastMvcMappingRegister) { + return new FastScriptMappingRegister(fastMvcMappingRegister); } } diff --git a/springboot-starter-data-fast/src/main/java/com/codingapi/springboot/fast/annotation/FastController.java b/springboot-starter-data-fast/src/main/java/com/codingapi/springboot/fast/annotation/FastController.java deleted file mode 100644 index e566cf7b3..000000000 --- a/springboot-starter-data-fast/src/main/java/com/codingapi/springboot/fast/annotation/FastController.java +++ /dev/null @@ -1,11 +0,0 @@ -package com.codingapi.springboot.fast.annotation; - -import java.lang.annotation.*; - -@Target(ElementType.TYPE) -@Retention(RetentionPolicy.RUNTIME) -@Documented -public @interface FastController { - - -} diff --git a/springboot-starter-data-fast/src/main/java/com/codingapi/springboot/fast/annotation/FastMapping.java b/springboot-starter-data-fast/src/main/java/com/codingapi/springboot/fast/annotation/FastMapping.java deleted file mode 100644 index 1b1d8bb21..000000000 --- a/springboot-starter-data-fast/src/main/java/com/codingapi/springboot/fast/annotation/FastMapping.java +++ /dev/null @@ -1,38 +0,0 @@ -package com.codingapi.springboot.fast.annotation; - - -import org.springframework.web.bind.annotation.RequestMethod; -import org.springframework.web.bind.annotation.ResponseBody; - -import java.lang.annotation.ElementType; -import java.lang.annotation.Retention; -import java.lang.annotation.RetentionPolicy; -import java.lang.annotation.Target; - -@Retention(RetentionPolicy.RUNTIME) -@Target(ElementType.METHOD) -@ResponseBody -public @interface FastMapping { - - /** - * execute jpa hql - */ - String value() default ""; - - - /** - * execute jpa count hql - */ - String countQuery() default ""; - - /** - * mvc request method - */ - RequestMethod method() default RequestMethod.GET; - - /** - * mvc request url - */ - String mapping() default ""; - -} diff --git a/springboot-starter-data-fast/src/main/java/com/codingapi/springboot/fast/classloader/DynamicTableClassLoader.java b/springboot-starter-data-fast/src/main/java/com/codingapi/springboot/fast/classloader/DynamicTableClassLoader.java new file mode 100644 index 000000000..243634e69 --- /dev/null +++ b/springboot-starter-data-fast/src/main/java/com/codingapi/springboot/fast/classloader/DynamicTableClassLoader.java @@ -0,0 +1,161 @@ +package com.codingapi.springboot.fast.classloader; + +import lombok.Getter; + +import java.util.Collection; +import java.util.Map; +import java.util.Set; +import java.util.concurrent.ConcurrentHashMap; + +/** + * 动态表的 ClassLoader + */ +public class DynamicTableClassLoader { + + @Getter + private final static DynamicTableClassLoader instance = new DynamicTableClassLoader(); + + private final $DynamicTableClassLoader dynamicTableClassLoader; + + private DynamicTableClassLoader() { + dynamicTableClassLoader = new $DynamicTableClassLoader(Thread.currentThread().getContextClassLoader() != null + ? Thread.currentThread().getContextClassLoader() + : getClass().getClassLoader()); + Thread.currentThread().setContextClassLoader(dynamicTableClassLoader); + } + + /** + * 注册类 + * @param className name + * @param clazz class + */ + public void registerClass(String className, Class clazz) { + dynamicTableClassLoader.registerClass(className, clazz); + Thread.currentThread().setContextClassLoader(dynamicTableClassLoader); + } + + /** + * 注册类 + * @param clazz class + */ + public void registerClass(Class clazz) { + dynamicTableClassLoader.registerClass(clazz); + Thread.currentThread().setContextClassLoader(dynamicTableClassLoader); + } + + /** + * 获取类 + * @param name className + * @return class + */ + public Class findClass(String name) throws ClassNotFoundException { + return dynamicTableClassLoader.findClass(name); + } + + /** + * 加载类 + * @param name className + * @param resolve resolve + * @return class + */ + public Class loadClass(String name, boolean resolve) throws ClassNotFoundException { + return dynamicTableClassLoader.loadClass(name, resolve); + } + + /** + * 清空动态类 + * @param name 类名称 + */ + public void cleanDynamicClass(String name) { + dynamicTableClassLoader.cleanClass(name); + Thread.currentThread().setContextClassLoader(dynamicTableClassLoader); + } + + /** + * 获取全部的动态类 + */ + public Collection> getDynamicClasses(){ + return dynamicTableClassLoader.getDynamicClasses(); + } + + /** + * 获取全部动态类的名称 + */ + public Set getDynamicClassNames(){ + return dynamicTableClassLoader.getDynamicClassNames(); + } + + + /** + * $DynamicTableClassLoader + */ + private static class $DynamicTableClassLoader extends ClassLoader { + + private final Map> dynamicClasses = new ConcurrentHashMap<>(); + + public $DynamicTableClassLoader(ClassLoader parent) { + super(parent); + } + + public void registerClass(String className, Class clazz) { + dynamicClasses.put(className, clazz); + } + + public void registerClass(Class clazz) { + this.registerClass(clazz.getName(), clazz); + } + + public void cleanClass(String className) { + this.dynamicClasses.remove(className); + } + + public Collection> getDynamicClasses(){ + return dynamicClasses.values(); + } + + public Set getDynamicClassNames(){ + return dynamicClasses.keySet(); + } + + + @Override + protected Class findClass(String name) throws ClassNotFoundException { + // 首先检查已加载的动态类 + if (dynamicClasses.containsKey(name)) { + return dynamicClasses.get(name); + } + // 委托给父类 + return super.findClass(name); + } + + @Override + public Class loadClass(String name) throws ClassNotFoundException { + return loadClass(name, false); + } + + @Override + protected Class loadClass(String name, boolean resolve) throws ClassNotFoundException { + synchronized (getClassLoadingLock(name)) { + // 首先检查是否已经加载 + Class c = findLoadedClass(name); + if (c == null) { + // 检查是否是动态类 + if (dynamicClasses.containsKey(name)) { + c = dynamicClasses.get(name); + } else { + // 委托给父类 + c = super.loadClass(name, resolve); + } + } + + if (resolve) { + resolveClass(c); + } + return c; + } + } + + } + + +} diff --git a/springboot-starter-data-fast/src/main/java/com/codingapi/springboot/fast/exception/FastMappingErrorException.java b/springboot-starter-data-fast/src/main/java/com/codingapi/springboot/fast/exception/FastMappingErrorException.java deleted file mode 100644 index ce41c99c6..000000000 --- a/springboot-starter-data-fast/src/main/java/com/codingapi/springboot/fast/exception/FastMappingErrorException.java +++ /dev/null @@ -1,8 +0,0 @@ -package com.codingapi.springboot.fast.exception; - -public class FastMappingErrorException extends Exception { - - public FastMappingErrorException(String message) { - super(message); - } -} diff --git a/springboot-starter-data-fast/src/main/java/com/codingapi/springboot/fast/executor/JpaExecutor.java b/springboot-starter-data-fast/src/main/java/com/codingapi/springboot/fast/executor/JpaExecutor.java deleted file mode 100644 index 04067091f..000000000 --- a/springboot-starter-data-fast/src/main/java/com/codingapi/springboot/fast/executor/JpaExecutor.java +++ /dev/null @@ -1,39 +0,0 @@ -package com.codingapi.springboot.fast.executor; - -import com.codingapi.springboot.framework.dto.response.MultiResponse; -import com.codingapi.springboot.framework.dto.response.SingleResponse; -import lombok.AllArgsConstructor; -import org.springframework.data.domain.Page; - -import jakarta.persistence.EntityManager; -import java.util.Collection; -import java.util.List; - -@AllArgsConstructor -public class JpaExecutor { - - private final EntityManager entityManager; - - public Object execute(String hql, String countHql, Object[] args, Class returnType) { - //only execute query sql - JpaQuery query = new JpaQuery(hql, countHql, args, entityManager); - - if (returnType.equals(SingleResponse.class)) { - List list = (List) query.getResultList(); - return list == null && list.size() > 0 ? SingleResponse.of(list.get(0)) : SingleResponse.empty(); - } - - if (returnType.equals(MultiResponse.class)) { - Object returnData = query.getResultList(); - if (Page.class.isAssignableFrom(returnData.getClass())) { - return MultiResponse.of((Page) returnData); - } - - if (Collection.class.isAssignableFrom(returnData.getClass())) { - return MultiResponse.of((Collection) returnData); - } - } - - return query.getResultList(); - } -} diff --git a/springboot-starter-data-fast/src/main/java/com/codingapi/springboot/fast/executor/JpaQuery.java b/springboot-starter-data-fast/src/main/java/com/codingapi/springboot/fast/executor/JpaQuery.java deleted file mode 100644 index dbc4e1188..000000000 --- a/springboot-starter-data-fast/src/main/java/com/codingapi/springboot/fast/executor/JpaQuery.java +++ /dev/null @@ -1,114 +0,0 @@ -package com.codingapi.springboot.fast.executor; - -import lombok.SneakyThrows; -import lombok.extern.slf4j.Slf4j; -import org.springframework.data.domain.PageImpl; -import org.springframework.data.domain.Pageable; -import org.springframework.util.ReflectionUtils; -import org.springframework.util.StringUtils; - -import jakarta.persistence.EntityManager; -import jakarta.persistence.Parameter; -import jakarta.persistence.Query; -import java.lang.reflect.Field; -import java.util.Set; - -@Slf4j -public class JpaQuery { - private final Object[] args; - private final Query query; - private final String hql; - private final String countHql; - - private final EntityManager entityManager; - - public JpaQuery(String hql, String countHql, Object[] args, EntityManager entityManager) { - this.hql = hql; - this.countHql = countHql; - this.args = args; - this.entityManager = entityManager; - this.query = entityManager.createQuery(hql); - this.initParameter(query); - } - - /** - * init query parameter - */ - @SneakyThrows - private void initParameter(Query query) { - if (args != null && args.length > 0) { - Set> parameters = query.getParameters(); - for (Parameter parameter : parameters) { - Integer position = parameter.getPosition(); - if (position != null) { - query.setParameter(position, args[position - 1]); - } - if (StringUtils.hasText(parameter.getName())) { - String name = parameter.getName(); - Object obj = args[0]; - Field field = ReflectionUtils.findField(obj.getClass(), name); - if (field != null) { - field.setAccessible(true); - query.setParameter(name, field.get(obj)); - } - } - } - } - } - - /** - * is Page Request - */ - private boolean isPageable() { - if (args != null && args.length > 0 && StringUtils.hasText(countHql)) { - Object lastObj = args[args.length - 1]; - return lastObj instanceof Pageable; - } - return false; - } - - /** - * get PageRequest - */ - private Pageable getPageable() { - if (isPageable()) { - Object lastObj = args[args.length - 1]; - return (Pageable) lastObj; - } - return null; - } - - /** - * execute get list result data - */ - public Object getResultList() { - if (isPageable()) { - Pageable pageable = getPageable(); - query.setFirstResult((int) pageable.getOffset()); - query.setMaxResults(pageable.getPageSize()); - long total = getCount(); - return new PageImpl<>(query.getResultList(), pageable, total); - } - return query.getResultList(); - } - - - /** - * get sql execute data count - */ - private long getCount() { - Query countQuery = entityManager.createQuery(countHql); - initParameter(countQuery); - return (Long) countQuery.getSingleResult(); - } - - - /** - * get single result data - */ - public Object getSingleResult() { - return query.getSingleResult(); - } - - -} diff --git a/springboot-starter-data-fast/src/main/java/com/codingapi/springboot/fast/executor/MvcMethodInterceptor.java b/springboot-starter-data-fast/src/main/java/com/codingapi/springboot/fast/executor/MvcMethodInterceptor.java deleted file mode 100644 index fba74734c..000000000 --- a/springboot-starter-data-fast/src/main/java/com/codingapi/springboot/fast/executor/MvcMethodInterceptor.java +++ /dev/null @@ -1,39 +0,0 @@ -package com.codingapi.springboot.fast.executor; - -import com.codingapi.springboot.fast.annotation.FastMapping; -import lombok.AllArgsConstructor; -import org.aopalliance.intercept.MethodInterceptor; -import org.aopalliance.intercept.MethodInvocation; - -import java.lang.reflect.Method; - -@AllArgsConstructor -public class MvcMethodInterceptor implements MethodInterceptor { - - private final JpaExecutor jpaExecutor; - - @Override - public Object invoke(MethodInvocation invocation) - throws Throwable { - Method method = invocation.getMethod(); - Object[] args = invocation.getArguments(); - - if (method.equals(Object.class.getMethod("equals", Object.class))) { - return false; - } - - if (method.equals(Object.class.getMethod("hashCode"))) { - return hashCode(); - } - - FastMapping fastMapping = method.getAnnotation(FastMapping.class); - if (fastMapping != null) { - Class returnType = method.getReturnType(); - return jpaExecutor.execute(fastMapping.value(), fastMapping.countQuery(), args, returnType); - } - // mvc mapping proxy can't execute return null. - return null; - } - - -} \ No newline at end of file diff --git a/springboot-starter-data-fast/src/main/java/com/codingapi/springboot/fast/generator/DynamicTableGenerator.java b/springboot-starter-data-fast/src/main/java/com/codingapi/springboot/fast/generator/DynamicTableGenerator.java new file mode 100644 index 000000000..91231ab81 --- /dev/null +++ b/springboot-starter-data-fast/src/main/java/com/codingapi/springboot/fast/generator/DynamicTableGenerator.java @@ -0,0 +1,251 @@ +package com.codingapi.springboot.fast.generator; + +import org.hibernate.boot.Metadata; +import org.hibernate.boot.MetadataSources; +import org.hibernate.boot.registry.StandardServiceRegistry; +import org.hibernate.boot.registry.StandardServiceRegistryBuilder; +import org.hibernate.cfg.AvailableSettings; +import org.hibernate.tool.hbm2ddl.ImportSqlCommandExtractor; +import org.hibernate.tool.schema.SourceType; +import org.hibernate.tool.schema.TargetType; +import org.hibernate.tool.schema.internal.ExceptionHandlerCollectingImpl; +import org.hibernate.tool.schema.spi.*; +import org.springframework.util.StringUtils; + +import java.util.*; + +/** + * DynamicTableGenerator 数据库表动态构建器 + */ +public class DynamicTableGenerator { + + /** + * 数据库方言 + */ + private final Class dialect; + private final StandardServiceRegistry serviceRegistry; + private final SchemaManagementTool managementTool; + + public DynamicTableGenerator(Class dialectClass, String jdbcUrl) { + this(dialectClass,jdbcUrl,null,null); + } + + public DynamicTableGenerator(Class dialectClass, String jdbcUrl, String username, String password) { + this.dialect = dialectClass; + StandardServiceRegistryBuilder builder = new StandardServiceRegistryBuilder() + .applySetting(AvailableSettings.DIALECT, dialect.getName()) + .applySetting("hibernate.connection.url", jdbcUrl); + if (StringUtils.hasText(username)) { + builder.applySetting("hibernate.connection.username", username); + } + if (StringUtils.hasText(password)) { + builder.applySetting("hibernate.connection.password", password); + } + this.serviceRegistry = builder.build(); + this.managementTool = serviceRegistry.getService(SchemaManagementTool.class); + } + + private class ExecutionOptionsImpl implements ExecutionOptions { + + @Override + public Map getConfigurationValues() { + Map config = new HashMap<>(); + config.put(AvailableSettings.DIALECT, dialect.getName()); + return config; + } + + @Override + public boolean shouldManageNamespaces() { + return false; + } + + @Override + public ExceptionHandler getExceptionHandler() { + return new ExceptionHandlerCollectingImpl(); + } + } + + private static class SourceDescriptorImpl implements SourceDescriptor { + + @Override + public SourceType getSourceType() { + return SourceType.METADATA; + } + + @Override + public ScriptSourceInput getScriptSourceInput() { + return new ScriptSourceInput() { + @Override + public void prepare() { + + } + + @Override + public List read(ImportSqlCommandExtractor importSqlCommandExtractor) { + return new ArrayList<>(); + } + + @Override + public void release() { + + } + }; + } + } + + private static class TargetDescriptorImpl implements TargetDescriptor { + private final List sqlCommands = new ArrayList<>(); + private final boolean executable; + + public TargetDescriptorImpl(boolean executable) { + this.executable = executable; + } + + @Override + public EnumSet getTargetTypes() { + EnumSet targetTypes = EnumSet.of(TargetType.SCRIPT); + if(executable) { + // 在数据库中执行 + targetTypes.add(TargetType.DATABASE); + } + return targetTypes; + } + + @Override + public ScriptTargetOutput getScriptTargetOutput() { + return new ScriptTargetOutput() { + @Override + public void prepare() { + + } + + @Override + public void accept(String command) { + sqlCommands.add(command); + } + + @Override + public void release() { + + } + }; + } + + public String getDDL() { + return String.join("\n", sqlCommands); + } + } + + /** + * 创建删除DDL语句 + * @param entityClass entity class对象 + * @return DDL + */ + public String generateDropTableDDL(Class entityClass) { + return this.generateDropTableDDL(entityClass,false); + } + + /** + * 创建删除DDL语句 + * @param entityClass entity class对象 + * @param executable 是否数据中执行 + * @return DDL + */ + public String generateDropTableDDL(Class entityClass,boolean executable) { + MetadataSources metadataSources = new MetadataSources(serviceRegistry); + metadataSources.addAnnotatedClass(entityClass); + Metadata metadata = metadataSources.buildMetadata(); + TargetDescriptorImpl targetDescriptor = new TargetDescriptorImpl(executable); + + managementTool.getSchemaDropper(Collections.emptyMap()).doDrop(metadata, + new ExecutionOptionsImpl(), + new SourceDescriptorImpl(), + targetDescriptor); + + return targetDescriptor.getDDL(); + } + + /** + * 创建创建DDL语句 + * @param entityClass entity class对象 + * @return DDL + */ + public String generateCreateTableDDL(Class entityClass) { + return this.generateCreateTableDDL(entityClass,false); + } + + /** + * 创建创建DDL语句 + * @param entityClass entity class对象 + * @param executable 是否数据中执行 + * @return DDL + */ + public String generateCreateTableDDL(Class entityClass,boolean executable) { + MetadataSources metadataSources = new MetadataSources(serviceRegistry); + metadataSources.addAnnotatedClass(entityClass); + Metadata metadata = metadataSources.buildMetadata(); + + TargetDescriptorImpl targetDescriptor = new TargetDescriptorImpl(executable); + + managementTool.getSchemaCreator(Collections.emptyMap()).doCreation(metadata, + new ExecutionOptionsImpl(), + new SourceDescriptorImpl(), + targetDescriptor); + return targetDescriptor.getDDL(); + } + + /** + * 创建变更DDL语句，当数据不存在时则为创建，当数据中的表对象与entityClass不一致时则创建调整DDL + * @param entityClass entity class对象 + * @return DDL + */ + public String generateMigratorTableDDL(Class entityClass) { + return this.generateMigratorTableDDL(entityClass,false); + } + + /** + * 创建变更DDL语句，当数据不存在时则为创建，当数据中的表对象与entityClass不一致时则创建调整DDL + * @param entityClass entity class对象 + * @param executable 是否数据中执行 + * @return DDL + */ + public String generateMigratorTableDDL(Class entityClass,boolean executable) { + MetadataSources metadataSources = new MetadataSources(serviceRegistry); + metadataSources.addAnnotatedClass(entityClass); + Metadata metadata = metadataSources.buildMetadata(); + + TargetDescriptorImpl targetDescriptor = new TargetDescriptorImpl(executable); + + managementTool.getSchemaMigrator(Collections.emptyMap()).doMigration(metadata, + new ExecutionOptionsImpl(), + targetDescriptor); + return targetDescriptor.getDDL(); + } + + /** + * 检验对象与数据库是否一致，一致时无异常信息 + * @param entityClass entity class对象 + * @return 异常列表 + */ + public List validatorTable(Class entityClass) { + ExceptionHandlerCollectingImpl exceptionHandler = new ExceptionHandlerCollectingImpl(); + MetadataSources metadataSources = new MetadataSources(serviceRegistry); + metadataSources.addAnnotatedClass(entityClass); + Metadata metadata = metadataSources.buildMetadata(); + List exceptionList = new ArrayList<>(); + try { + managementTool.getSchemaValidator(Collections.emptyMap()).doValidation(metadata, + new ExecutionOptionsImpl() { + @Override + public ExceptionHandler getExceptionHandler() { + return exceptionHandler; + } + }); + } catch (Exception e) { + exceptionList.add(e); + } + exceptionList.addAll(exceptionHandler.getExceptions()); + return exceptionList; + } + +} diff --git a/springboot-starter-data-fast/src/main/java/com/codingapi/springboot/fast/jdbc/JdbcQuery.java b/springboot-starter-data-fast/src/main/java/com/codingapi/springboot/fast/jdbc/JdbcQuery.java new file mode 100644 index 000000000..8c05221da --- /dev/null +++ b/springboot-starter-data-fast/src/main/java/com/codingapi/springboot/fast/jdbc/JdbcQuery.java @@ -0,0 +1,102 @@ +package com.codingapi.springboot.fast.jdbc; + +import com.codingapi.springboot.fast.jpa.SQLBuilder; +import org.apache.commons.text.CaseUtils; +import org.springframework.data.domain.Page; +import org.springframework.data.domain.PageImpl; +import org.springframework.data.domain.PageRequest; +import org.springframework.jdbc.core.BeanPropertyRowMapper; +import org.springframework.jdbc.core.RowMapper; + +import java.sql.ResultSet; +import java.sql.ResultSetMetaData; +import java.sql.SQLException; +import java.util.HashMap; +import java.util.List; +import java.util.Map; + +public class JdbcQuery { + + private final org.springframework.jdbc.core.JdbcTemplate jdbcTemplate; + + public JdbcQuery(org.springframework.jdbc.core.JdbcTemplate jdbcTemplate) { + this.jdbcTemplate = jdbcTemplate; + } + + private static class CamelCaseRowMapper implements RowMapper> { + + @Override + public Map mapRow(ResultSet rs, int rowNum) throws SQLException { + ResultSetMetaData metaData = rs.getMetaData(); + int columnCount = metaData.getColumnCount(); + Map map = new HashMap<>(columnCount); + for (int i = 1; i <= columnCount; i++) { + String columnName = metaData.getColumnLabel(i); + // 修复：必须显式指定下划线分隔符，否则 CaseUtils 不做任何驼峰转换 + map.put(CaseUtils.toCamelCase(columnName, false, '_'), rs.getObject(i)); + } + return map; + } + } + + public List> queryForMapList(SQLBuilder builder) { + return queryForMapList(builder.getSQL(), builder.getParams()); + } + + public List> queryForMapList(String sql, Object... params) { + return jdbcTemplate.query(sql, new CamelCaseRowMapper(), params); + } + + public List queryForList(SQLBuilder builder) { + return queryForList(builder.getSQL(), builder.getClazz(), builder.getParams()); + } + + public List queryForList(String sql, Class clazz, Object... params) { + return jdbcTemplate.query(sql, new BeanPropertyRowMapper<>(clazz), params); + } + + public Page queryForPage(SQLBuilder builder, PageRequest pageRequest) { + return queryForPage(builder.getSQL(), builder.getCountSQL(), builder.getClazz(), pageRequest, builder.getParams()); + } + + public Page queryForPage(String sql, String countSql, Class clazz, PageRequest pageRequest, Object... params) { + List list = jdbcTemplate.query(sql, new BeanPropertyRowMapper<>(clazz), params); + long count = this.countQuery(countSql, params); + return new PageImpl<>(list, pageRequest, count); + } + + public Page queryForPage(String sql, Class clazz, PageRequest pageRequest, Object... params) { + String countSql = "SELECT COUNT(1) " + sql; + return this.queryForPage(sql, countSql, clazz, pageRequest, params); + } + + public Page> queryForMapPage(SQLBuilder builder, PageRequest pageRequest) { + return queryForMapPage(builder.getSQL(), builder.getCountSQL(), pageRequest, builder.getParams()); + } + + public Page> queryForMapPage(String sql, String countSql, PageRequest pageRequest, Object... params) { + List> list = jdbcTemplate.query(sql, new CamelCaseRowMapper(), params); + long count = this.countQuery(countSql, params); + return new PageImpl<>(list, pageRequest, count); + } + + public Page> queryForMapPage(String sql, PageRequest pageRequest, Object... params) { + String countSql = "SELECT COUNT(1) " + sql; + return this.queryForMapPage(sql, countSql, pageRequest, params); + } + + + private long countQuery(String sql, Object... params) { + int countSqlParamsLength = sql.split("\\?", -1).length - 1; + Long count; + if (countSqlParamsLength <= 0) { + count = jdbcTemplate.queryForObject(sql, Long.class); + } else { + Object[] newParams = new Object[countSqlParamsLength]; + // 修复：原实现仅在 params 数量大于占位符数量时才拷贝，数量相等时参数全部丢失导致 SQL 参数未绑定 + System.arraycopy(params, 0, newParams, 0, Math.min(params.length, countSqlParamsLength)); + count = jdbcTemplate.queryForObject(sql, Long.class, newParams); + } + return count == null ? 0L : count; + } +} diff --git a/springboot-starter-data-fast/src/main/java/com/codingapi/springboot/fast/jdbc/JdbcQueryConfiguration.java b/springboot-starter-data-fast/src/main/java/com/codingapi/springboot/fast/jdbc/JdbcQueryConfiguration.java new file mode 100644 index 000000000..aa05bd84d --- /dev/null +++ b/springboot-starter-data-fast/src/main/java/com/codingapi/springboot/fast/jdbc/JdbcQueryConfiguration.java @@ -0,0 +1,22 @@ +package com.codingapi.springboot.fast.jdbc; + +import org.springframework.context.annotation.Bean; +import org.springframework.context.annotation.Configuration; +import org.springframework.jdbc.core.JdbcTemplate; + + +@Configuration +public class JdbcQueryConfiguration { + + @Bean + public JdbcQuery jdbcQuery(JdbcTemplate jdbcTemplate) { + return new JdbcQuery(jdbcTemplate); + } + + @Bean + public JdbcQueryContextRegister jdbcQueryContextRegister(JdbcQuery jdbcQuery){ + return new JdbcQueryContextRegister(jdbcQuery); + } + + +} diff --git a/springboot-starter-data-fast/src/main/java/com/codingapi/springboot/fast/jdbc/JdbcQueryContext.java b/springboot-starter-data-fast/src/main/java/com/codingapi/springboot/fast/jdbc/JdbcQueryContext.java new file mode 100644 index 000000000..7aaa455e9 --- /dev/null +++ b/springboot-starter-data-fast/src/main/java/com/codingapi/springboot/fast/jdbc/JdbcQueryContext.java @@ -0,0 +1,23 @@ +package com.codingapi.springboot.fast.jdbc; + + +import lombok.Getter; + +public class JdbcQueryContext { + + @Getter + private static final JdbcQueryContext instance = new JdbcQueryContext(); + + private JdbcQueryContext() { + + } + + @Getter + private JdbcQuery jdbcQuery; + + void setJdbcQuery(JdbcQuery jdbcQuery) { + this.jdbcQuery = jdbcQuery; + } + + +} diff --git a/springboot-starter-data-fast/src/main/java/com/codingapi/springboot/fast/jdbc/JdbcQueryContextRegister.java b/springboot-starter-data-fast/src/main/java/com/codingapi/springboot/fast/jdbc/JdbcQueryContextRegister.java new file mode 100644 index 000000000..47ab903d8 --- /dev/null +++ b/springboot-starter-data-fast/src/main/java/com/codingapi/springboot/fast/jdbc/JdbcQueryContextRegister.java @@ -0,0 +1,16 @@ +package com.codingapi.springboot.fast.jdbc; + +import lombok.AllArgsConstructor; +import org.springframework.beans.factory.InitializingBean; + +@AllArgsConstructor +public class JdbcQueryContextRegister implements InitializingBean { + + private JdbcQuery jdbcQuery; + + @Override + public void afterPropertiesSet() throws Exception { + JdbcQueryContext.getInstance().setJdbcQuery(jdbcQuery); + } + +} diff --git a/springboot-starter-data-fast/src/main/java/com/codingapi/springboot/fast/jpa/JpaQuery.java b/springboot-starter-data-fast/src/main/java/com/codingapi/springboot/fast/jpa/JpaQuery.java new file mode 100644 index 000000000..37bc40bcb --- /dev/null +++ b/springboot-starter-data-fast/src/main/java/com/codingapi/springboot/fast/jpa/JpaQuery.java @@ -0,0 +1,80 @@ +package com.codingapi.springboot.fast.jpa; + +import com.codingapi.springboot.fast.jpa.map.QueryColumnsContext; +import com.codingapi.springboot.fast.jpa.map.QueryColumns; +import com.codingapi.springboot.fast.jpa.map.MapViewResult; +import lombok.AllArgsConstructor; +import org.springframework.data.domain.Page; +import org.springframework.data.domain.PageImpl; +import org.springframework.data.domain.PageRequest; + +import javax.persistence.EntityManager; +import javax.persistence.TypedQuery; +import java.util.List; + +@AllArgsConstructor +public class JpaQuery { + + private final EntityManager entityManager; + + public List listQuery(SQLBuilder builder) { + return listQuery(builder.getClazz(),builder.getSQL(),builder.getParams()); + } + + public List listQuery(Class clazz, String sql, Object... params) { + TypedQuery query = entityManager.createQuery(sql, clazz); + if (params != null) { + for (int i = 0; i < params.length; i++) { + query.setParameter(i + 1, params[i]); + } + } + return query.getResultList(); + } + + public Page pageQuery(SQLBuilder builder,PageRequest pageRequest) { + return pageQuery(builder.getClazz(), builder.getSQL(), builder.getCountSQL(),pageRequest,builder.getParams()); + } + + + public Page pageQuery(Class clazz, String sql, PageRequest pageRequest, Object... params) { + return pageQuery(clazz,sql,"SELECT COUNT(1) " + sql,pageRequest,params); + } + + public Page pageQuery(Class clazz, String sql, String countSql, PageRequest pageRequest, Object... params) { + TypedQuery query = entityManager.createQuery(sql, clazz); + if (params != null) { + for (int i = 0; i < params.length; i++) { + query.setParameter(i + 1, params[i]); + } + } + query.setFirstResult(pageRequest.getPageNumber() * pageRequest.getPageSize()); + query.setMaxResults(pageRequest.getPageSize()); + return new PageImpl(query.getResultList(), pageRequest, countQuery(countSql, params)); + } + + + private long countQuery(String sql, Object... params) { + TypedQuery query = entityManager.createQuery(sql, Long.class); + if (params != null) { + for (int i = 0; i < params.length; i++) { + query.setParameter(i + 1, params[i]); + } + } + return query.getSingleResult(); + } + + public Page pageMapQuery(QueryColumns columns, String sql, String countSql, PageRequest pageRequest, Object... params) { + String querySql = "SELECT new com.codingapi.springboot.fast.jpa.map.MapViewResult('"+columns.getKey()+"',"+ String.join(",", columns.getColumnSql()) + ") " + sql; + String countQuerySql = "SELECT COUNT(1) " + countSql; + Page result = pageQuery(MapViewResult.class,querySql,countQuerySql,pageRequest,params); + QueryColumnsContext.getInstance().clearCache(columns.getKey()); + return result; + } + + public List listMapQuery(QueryColumns columns, String sql, Object... params) { + String querySql = "SELECT new com.codingapi.springboot.fast.jpa.map.MapViewResult('"+columns.getKey()+"',"+ String.join(",", columns.getColumnSql()) + ") " + sql; + List result = listQuery(MapViewResult.class,querySql,params); + QueryColumnsContext.getInstance().clearCache(columns.getKey()); + return result; + } +} diff --git a/springboot-starter-data-fast/src/main/java/com/codingapi/springboot/fast/jpa/JpaQueryConfiguration.java b/springboot-starter-data-fast/src/main/java/com/codingapi/springboot/fast/jpa/JpaQueryConfiguration.java new file mode 100644 index 000000000..81a771740 --- /dev/null +++ b/springboot-starter-data-fast/src/main/java/com/codingapi/springboot/fast/jpa/JpaQueryConfiguration.java @@ -0,0 +1,21 @@ +package com.codingapi.springboot.fast.jpa; + +import javax.persistence.EntityManager; +import org.springframework.context.annotation.Bean; +import org.springframework.context.annotation.Configuration; + + +@Configuration +public class JpaQueryConfiguration { + + @Bean + public JpaQuery dynamicQuery(EntityManager entityManager){ + return new JpaQuery(entityManager); + } + + @Bean + public JpaQueryContextRegister jpaQueryContextRegister(JpaQuery JPAQuery){ + return new JpaQueryContextRegister(JPAQuery); + } + +} diff --git a/springboot-starter-data-fast/src/main/java/com/codingapi/springboot/fast/jpa/JpaQueryContext.java b/springboot-starter-data-fast/src/main/java/com/codingapi/springboot/fast/jpa/JpaQueryContext.java new file mode 100644 index 000000000..e103db081 --- /dev/null +++ b/springboot-starter-data-fast/src/main/java/com/codingapi/springboot/fast/jpa/JpaQueryContext.java @@ -0,0 +1,23 @@ +package com.codingapi.springboot.fast.jpa; + + +import lombok.Getter; + +public class JpaQueryContext { + + @Getter + private static final JpaQueryContext instance = new JpaQueryContext(); + + private JpaQueryContext() { + + } + + @Getter + private JpaQuery jpaQuery; + + void setJpaQuery(JpaQuery jpaQuery) { + this.jpaQuery = jpaQuery; + } + + +} diff --git a/springboot-starter-data-fast/src/main/java/com/codingapi/springboot/fast/jpa/JpaQueryContextRegister.java b/springboot-starter-data-fast/src/main/java/com/codingapi/springboot/fast/jpa/JpaQueryContextRegister.java new file mode 100644 index 000000000..e50c137e1 --- /dev/null +++ b/springboot-starter-data-fast/src/main/java/com/codingapi/springboot/fast/jpa/JpaQueryContextRegister.java @@ -0,0 +1,16 @@ +package com.codingapi.springboot.fast.jpa; + +import lombok.AllArgsConstructor; +import org.springframework.beans.factory.InitializingBean; + +@AllArgsConstructor +public class JpaQueryContextRegister implements InitializingBean { + + private final JpaQuery JPAQuery; + + @Override + public void afterPropertiesSet() throws Exception { + JpaQueryContext.getInstance().setJpaQuery(JPAQuery); + } + +} diff --git a/springboot-starter-data-fast/src/main/java/com/codingapi/springboot/fast/jpa/SQLBuilder.java b/springboot-starter-data-fast/src/main/java/com/codingapi/springboot/fast/jpa/SQLBuilder.java new file mode 100644 index 000000000..2639d6140 --- /dev/null +++ b/springboot-starter-data-fast/src/main/java/com/codingapi/springboot/fast/jpa/SQLBuilder.java @@ -0,0 +1,80 @@ +package com.codingapi.springboot.fast.jpa; + +import lombok.Getter; + +import java.util.ArrayList; +import java.util.List; + +public class SQLBuilder { + + private final StringBuilder querySqlBuilder; + private final StringBuilder countSQLBuilder; + @Getter + private int index; + private final List params; + @Getter + private final Class clazz; + + public SQLBuilder(String sql) { + this(null, sql, "select count(1) from " + sql); + } + + public SQLBuilder(String sql,String countSql) { + this(null, sql, countSql); + } + + public SQLBuilder(Class clazz, String sql) { + this(clazz, sql, "select count(1) from " + sql); + } + + public SQLBuilder(Class clazz, String sql, String countSQL) { + this.countSQLBuilder = new StringBuilder(countSQL); + this.querySqlBuilder = new StringBuilder(sql); + this.index = 1; + this.params = new ArrayList<>(); + this.clazz = clazz; + } + + /** + * Append SQL condition with a value.sql end value must be a placeholder (e.g., "?"). + * @param sql the SQL condition to append, e.g., "where id = ?" + * @param value the value to bind to the SQL condition + */ + public void append(String sql, Object value) { + if (value != null) { + querySqlBuilder.append(" ").append(sql).append(index).append(" "); + countSQLBuilder.append(" ").append(sql).append(index).append(" "); + params.add(value); + index++; + } + } + + public void addParam(Object value){ + params.add(value); + index++; + } + + public void addParam(Object value,int index){ + params.add(value); + this.index = index; + } + + public void appendSql(String sql){ + querySqlBuilder.append(" ").append(sql).append(" "); + countSQLBuilder.append(" ").append(sql).append(" "); + } + + public String getSQL() { + return querySqlBuilder.toString(); + } + + public String getCountSQL() { + return countSQLBuilder.toString(); + } + + public Object[] getParams() { + return params.toArray(); + } + + +} diff --git a/springboot-starter-data-fast/src/main/java/com/codingapi/springboot/fast/jpa/map/MapViewResult.java b/springboot-starter-data-fast/src/main/java/com/codingapi/springboot/fast/jpa/map/MapViewResult.java new file mode 100644 index 000000000..36d36f933 --- /dev/null +++ b/springboot-starter-data-fast/src/main/java/com/codingapi/springboot/fast/jpa/map/MapViewResult.java @@ -0,0 +1,1029 @@ +package com.codingapi.springboot.fast.jpa.map; + +import java.util.HashMap; +import java.util.List; + +public class MapViewResult extends HashMap { + + public MapViewResult(String key, Object o1) { + this.build(key, o1); + } + + public MapViewResult(String key, Object o1, Object o2) { + this.build(key, o1, o2); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3) { + this.build(key, o1, o2, o3); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4) { + this.build(key, o1, o2, o3, o4); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5) { + this.build(key, o1, o2, o3, o4, o5); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6) { + this.build(key, o1, o2, o3, o4, o5, o6); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7) { + this.build(key, o1, o2, o3, o4, o5, o6, o7); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80, Object o81) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80, o81); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80, Object o81, Object o82) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80, o81, o82); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80, Object o81, Object o82, Object o83) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80, o81, o82, o83); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80, Object o81, Object o82, Object o83, Object o84) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80, o81, o82, o83, o84); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80, Object o81, Object o82, Object o83, Object o84, Object o85) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80, o81, o82, o83, o84, o85); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80, Object o81, Object o82, Object o83, Object o84, Object o85, Object o86) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80, o81, o82, o83, o84, o85, o86); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80, Object o81, Object o82, Object o83, Object o84, Object o85, Object o86, Object o87) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80, o81, o82, o83, o84, o85, o86, o87); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80, Object o81, Object o82, Object o83, Object o84, Object o85, Object o86, Object o87, Object o88) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80, o81, o82, o83, o84, o85, o86, o87, o88); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80, Object o81, Object o82, Object o83, Object o84, Object o85, Object o86, Object o87, Object o88, Object o89) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80, o81, o82, o83, o84, o85, o86, o87, o88, o89); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80, Object o81, Object o82, Object o83, Object o84, Object o85, Object o86, Object o87, Object o88, Object o89, Object o90) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80, o81, o82, o83, o84, o85, o86, o87, o88, o89, o90); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80, Object o81, Object o82, Object o83, Object o84, Object o85, Object o86, Object o87, Object o88, Object o89, Object o90, Object o91) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80, o81, o82, o83, o84, o85, o86, o87, o88, o89, o90, o91); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80, Object o81, Object o82, Object o83, Object o84, Object o85, Object o86, Object o87, Object o88, Object o89, Object o90, Object o91, Object o92) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80, o81, o82, o83, o84, o85, o86, o87, o88, o89, o90, o91, o92); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80, Object o81, Object o82, Object o83, Object o84, Object o85, Object o86, Object o87, Object o88, Object o89, Object o90, Object o91, Object o92, Object o93) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80, o81, o82, o83, o84, o85, o86, o87, o88, o89, o90, o91, o92, o93); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80, Object o81, Object o82, Object o83, Object o84, Object o85, Object o86, Object o87, Object o88, Object o89, Object o90, Object o91, Object o92, Object o93, Object o94) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80, o81, o82, o83, o84, o85, o86, o87, o88, o89, o90, o91, o92, o93, o94); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80, Object o81, Object o82, Object o83, Object o84, Object o85, Object o86, Object o87, Object o88, Object o89, Object o90, Object o91, Object o92, Object o93, Object o94, Object o95) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80, o81, o82, o83, o84, o85, o86, o87, o88, o89, o90, o91, o92, o93, o94, o95); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80, Object o81, Object o82, Object o83, Object o84, Object o85, Object o86, Object o87, Object o88, Object o89, Object o90, Object o91, Object o92, Object o93, Object o94, Object o95, Object o96) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80, o81, o82, o83, o84, o85, o86, o87, o88, o89, o90, o91, o92, o93, o94, o95, o96); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80, Object o81, Object o82, Object o83, Object o84, Object o85, Object o86, Object o87, Object o88, Object o89, Object o90, Object o91, Object o92, Object o93, Object o94, Object o95, Object o96, Object o97) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80, o81, o82, o83, o84, o85, o86, o87, o88, o89, o90, o91, o92, o93, o94, o95, o96, o97); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80, Object o81, Object o82, Object o83, Object o84, Object o85, Object o86, Object o87, Object o88, Object o89, Object o90, Object o91, Object o92, Object o93, Object o94, Object o95, Object o96, Object o97, Object o98) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80, o81, o82, o83, o84, o85, o86, o87, o88, o89, o90, o91, o92, o93, o94, o95, o96, o97, o98); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80, Object o81, Object o82, Object o83, Object o84, Object o85, Object o86, Object o87, Object o88, Object o89, Object o90, Object o91, Object o92, Object o93, Object o94, Object o95, Object o96, Object o97, Object o98, Object o99) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80, o81, o82, o83, o84, o85, o86, o87, o88, o89, o90, o91, o92, o93, o94, o95, o96, o97, o98, o99); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80, Object o81, Object o82, Object o83, Object o84, Object o85, Object o86, Object o87, Object o88, Object o89, Object o90, Object o91, Object o92, Object o93, Object o94, Object o95, Object o96, Object o97, Object o98, Object o99, Object o100) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80, o81, o82, o83, o84, o85, o86, o87, o88, o89, o90, o91, o92, o93, o94, o95, o96, o97, o98, o99, o100); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80, Object o81, Object o82, Object o83, Object o84, Object o85, Object o86, Object o87, Object o88, Object o89, Object o90, Object o91, Object o92, Object o93, Object o94, Object o95, Object o96, Object o97, Object o98, Object o99, Object o100, Object o101) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80, o81, o82, o83, o84, o85, o86, o87, o88, o89, o90, o91, o92, o93, o94, o95, o96, o97, o98, o99, o100, o101); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80, Object o81, Object o82, Object o83, Object o84, Object o85, Object o86, Object o87, Object o88, Object o89, Object o90, Object o91, Object o92, Object o93, Object o94, Object o95, Object o96, Object o97, Object o98, Object o99, Object o100, Object o101, Object o102) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80, o81, o82, o83, o84, o85, o86, o87, o88, o89, o90, o91, o92, o93, o94, o95, o96, o97, o98, o99, o100, o101, o102); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80, Object o81, Object o82, Object o83, Object o84, Object o85, Object o86, Object o87, Object o88, Object o89, Object o90, Object o91, Object o92, Object o93, Object o94, Object o95, Object o96, Object o97, Object o98, Object o99, Object o100, Object o101, Object o102, Object o103) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80, o81, o82, o83, o84, o85, o86, o87, o88, o89, o90, o91, o92, o93, o94, o95, o96, o97, o98, o99, o100, o101, o102, o103); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80, Object o81, Object o82, Object o83, Object o84, Object o85, Object o86, Object o87, Object o88, Object o89, Object o90, Object o91, Object o92, Object o93, Object o94, Object o95, Object o96, Object o97, Object o98, Object o99, Object o100, Object o101, Object o102, Object o103, Object o104) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80, o81, o82, o83, o84, o85, o86, o87, o88, o89, o90, o91, o92, o93, o94, o95, o96, o97, o98, o99, o100, o101, o102, o103, o104); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80, Object o81, Object o82, Object o83, Object o84, Object o85, Object o86, Object o87, Object o88, Object o89, Object o90, Object o91, Object o92, Object o93, Object o94, Object o95, Object o96, Object o97, Object o98, Object o99, Object o100, Object o101, Object o102, Object o103, Object o104, Object o105) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80, o81, o82, o83, o84, o85, o86, o87, o88, o89, o90, o91, o92, o93, o94, o95, o96, o97, o98, o99, o100, o101, o102, o103, o104, o105); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80, Object o81, Object o82, Object o83, Object o84, Object o85, Object o86, Object o87, Object o88, Object o89, Object o90, Object o91, Object o92, Object o93, Object o94, Object o95, Object o96, Object o97, Object o98, Object o99, Object o100, Object o101, Object o102, Object o103, Object o104, Object o105, Object o106) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80, o81, o82, o83, o84, o85, o86, o87, o88, o89, o90, o91, o92, o93, o94, o95, o96, o97, o98, o99, o100, o101, o102, o103, o104, o105, o106); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80, Object o81, Object o82, Object o83, Object o84, Object o85, Object o86, Object o87, Object o88, Object o89, Object o90, Object o91, Object o92, Object o93, Object o94, Object o95, Object o96, Object o97, Object o98, Object o99, Object o100, Object o101, Object o102, Object o103, Object o104, Object o105, Object o106, Object o107) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80, o81, o82, o83, o84, o85, o86, o87, o88, o89, o90, o91, o92, o93, o94, o95, o96, o97, o98, o99, o100, o101, o102, o103, o104, o105, o106, o107); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80, Object o81, Object o82, Object o83, Object o84, Object o85, Object o86, Object o87, Object o88, Object o89, Object o90, Object o91, Object o92, Object o93, Object o94, Object o95, Object o96, Object o97, Object o98, Object o99, Object o100, Object o101, Object o102, Object o103, Object o104, Object o105, Object o106, Object o107, Object o108) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80, o81, o82, o83, o84, o85, o86, o87, o88, o89, o90, o91, o92, o93, o94, o95, o96, o97, o98, o99, o100, o101, o102, o103, o104, o105, o106, o107, o108); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80, Object o81, Object o82, Object o83, Object o84, Object o85, Object o86, Object o87, Object o88, Object o89, Object o90, Object o91, Object o92, Object o93, Object o94, Object o95, Object o96, Object o97, Object o98, Object o99, Object o100, Object o101, Object o102, Object o103, Object o104, Object o105, Object o106, Object o107, Object o108, Object o109) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80, o81, o82, o83, o84, o85, o86, o87, o88, o89, o90, o91, o92, o93, o94, o95, o96, o97, o98, o99, o100, o101, o102, o103, o104, o105, o106, o107, o108, o109); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80, Object o81, Object o82, Object o83, Object o84, Object o85, Object o86, Object o87, Object o88, Object o89, Object o90, Object o91, Object o92, Object o93, Object o94, Object o95, Object o96, Object o97, Object o98, Object o99, Object o100, Object o101, Object o102, Object o103, Object o104, Object o105, Object o106, Object o107, Object o108, Object o109, Object o110) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80, o81, o82, o83, o84, o85, o86, o87, o88, o89, o90, o91, o92, o93, o94, o95, o96, o97, o98, o99, o100, o101, o102, o103, o104, o105, o106, o107, o108, o109, o110); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80, Object o81, Object o82, Object o83, Object o84, Object o85, Object o86, Object o87, Object o88, Object o89, Object o90, Object o91, Object o92, Object o93, Object o94, Object o95, Object o96, Object o97, Object o98, Object o99, Object o100, Object o101, Object o102, Object o103, Object o104, Object o105, Object o106, Object o107, Object o108, Object o109, Object o110, Object o111) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80, o81, o82, o83, o84, o85, o86, o87, o88, o89, o90, o91, o92, o93, o94, o95, o96, o97, o98, o99, o100, o101, o102, o103, o104, o105, o106, o107, o108, o109, o110, o111); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80, Object o81, Object o82, Object o83, Object o84, Object o85, Object o86, Object o87, Object o88, Object o89, Object o90, Object o91, Object o92, Object o93, Object o94, Object o95, Object o96, Object o97, Object o98, Object o99, Object o100, Object o101, Object o102, Object o103, Object o104, Object o105, Object o106, Object o107, Object o108, Object o109, Object o110, Object o111, Object o112) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80, o81, o82, o83, o84, o85, o86, o87, o88, o89, o90, o91, o92, o93, o94, o95, o96, o97, o98, o99, o100, o101, o102, o103, o104, o105, o106, o107, o108, o109, o110, o111, o112); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80, Object o81, Object o82, Object o83, Object o84, Object o85, Object o86, Object o87, Object o88, Object o89, Object o90, Object o91, Object o92, Object o93, Object o94, Object o95, Object o96, Object o97, Object o98, Object o99, Object o100, Object o101, Object o102, Object o103, Object o104, Object o105, Object o106, Object o107, Object o108, Object o109, Object o110, Object o111, Object o112, Object o113) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80, o81, o82, o83, o84, o85, o86, o87, o88, o89, o90, o91, o92, o93, o94, o95, o96, o97, o98, o99, o100, o101, o102, o103, o104, o105, o106, o107, o108, o109, o110, o111, o112, o113); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80, Object o81, Object o82, Object o83, Object o84, Object o85, Object o86, Object o87, Object o88, Object o89, Object o90, Object o91, Object o92, Object o93, Object o94, Object o95, Object o96, Object o97, Object o98, Object o99, Object o100, Object o101, Object o102, Object o103, Object o104, Object o105, Object o106, Object o107, Object o108, Object o109, Object o110, Object o111, Object o112, Object o113, Object o114) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80, o81, o82, o83, o84, o85, o86, o87, o88, o89, o90, o91, o92, o93, o94, o95, o96, o97, o98, o99, o100, o101, o102, o103, o104, o105, o106, o107, o108, o109, o110, o111, o112, o113, o114); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80, Object o81, Object o82, Object o83, Object o84, Object o85, Object o86, Object o87, Object o88, Object o89, Object o90, Object o91, Object o92, Object o93, Object o94, Object o95, Object o96, Object o97, Object o98, Object o99, Object o100, Object o101, Object o102, Object o103, Object o104, Object o105, Object o106, Object o107, Object o108, Object o109, Object o110, Object o111, Object o112, Object o113, Object o114, Object o115) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80, o81, o82, o83, o84, o85, o86, o87, o88, o89, o90, o91, o92, o93, o94, o95, o96, o97, o98, o99, o100, o101, o102, o103, o104, o105, o106, o107, o108, o109, o110, o111, o112, o113, o114, o115); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80, Object o81, Object o82, Object o83, Object o84, Object o85, Object o86, Object o87, Object o88, Object o89, Object o90, Object o91, Object o92, Object o93, Object o94, Object o95, Object o96, Object o97, Object o98, Object o99, Object o100, Object o101, Object o102, Object o103, Object o104, Object o105, Object o106, Object o107, Object o108, Object o109, Object o110, Object o111, Object o112, Object o113, Object o114, Object o115, Object o116) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80, o81, o82, o83, o84, o85, o86, o87, o88, o89, o90, o91, o92, o93, o94, o95, o96, o97, o98, o99, o100, o101, o102, o103, o104, o105, o106, o107, o108, o109, o110, o111, o112, o113, o114, o115, o116); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80, Object o81, Object o82, Object o83, Object o84, Object o85, Object o86, Object o87, Object o88, Object o89, Object o90, Object o91, Object o92, Object o93, Object o94, Object o95, Object o96, Object o97, Object o98, Object o99, Object o100, Object o101, Object o102, Object o103, Object o104, Object o105, Object o106, Object o107, Object o108, Object o109, Object o110, Object o111, Object o112, Object o113, Object o114, Object o115, Object o116, Object o117) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80, o81, o82, o83, o84, o85, o86, o87, o88, o89, o90, o91, o92, o93, o94, o95, o96, o97, o98, o99, o100, o101, o102, o103, o104, o105, o106, o107, o108, o109, o110, o111, o112, o113, o114, o115, o116, o117); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80, Object o81, Object o82, Object o83, Object o84, Object o85, Object o86, Object o87, Object o88, Object o89, Object o90, Object o91, Object o92, Object o93, Object o94, Object o95, Object o96, Object o97, Object o98, Object o99, Object o100, Object o101, Object o102, Object o103, Object o104, Object o105, Object o106, Object o107, Object o108, Object o109, Object o110, Object o111, Object o112, Object o113, Object o114, Object o115, Object o116, Object o117, Object o118) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80, o81, o82, o83, o84, o85, o86, o87, o88, o89, o90, o91, o92, o93, o94, o95, o96, o97, o98, o99, o100, o101, o102, o103, o104, o105, o106, o107, o108, o109, o110, o111, o112, o113, o114, o115, o116, o117, o118); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80, Object o81, Object o82, Object o83, Object o84, Object o85, Object o86, Object o87, Object o88, Object o89, Object o90, Object o91, Object o92, Object o93, Object o94, Object o95, Object o96, Object o97, Object o98, Object o99, Object o100, Object o101, Object o102, Object o103, Object o104, Object o105, Object o106, Object o107, Object o108, Object o109, Object o110, Object o111, Object o112, Object o113, Object o114, Object o115, Object o116, Object o117, Object o118, Object o119) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80, o81, o82, o83, o84, o85, o86, o87, o88, o89, o90, o91, o92, o93, o94, o95, o96, o97, o98, o99, o100, o101, o102, o103, o104, o105, o106, o107, o108, o109, o110, o111, o112, o113, o114, o115, o116, o117, o118, o119); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80, Object o81, Object o82, Object o83, Object o84, Object o85, Object o86, Object o87, Object o88, Object o89, Object o90, Object o91, Object o92, Object o93, Object o94, Object o95, Object o96, Object o97, Object o98, Object o99, Object o100, Object o101, Object o102, Object o103, Object o104, Object o105, Object o106, Object o107, Object o108, Object o109, Object o110, Object o111, Object o112, Object o113, Object o114, Object o115, Object o116, Object o117, Object o118, Object o119, Object o120) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80, o81, o82, o83, o84, o85, o86, o87, o88, o89, o90, o91, o92, o93, o94, o95, o96, o97, o98, o99, o100, o101, o102, o103, o104, o105, o106, o107, o108, o109, o110, o111, o112, o113, o114, o115, o116, o117, o118, o119, o120); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80, Object o81, Object o82, Object o83, Object o84, Object o85, Object o86, Object o87, Object o88, Object o89, Object o90, Object o91, Object o92, Object o93, Object o94, Object o95, Object o96, Object o97, Object o98, Object o99, Object o100, Object o101, Object o102, Object o103, Object o104, Object o105, Object o106, Object o107, Object o108, Object o109, Object o110, Object o111, Object o112, Object o113, Object o114, Object o115, Object o116, Object o117, Object o118, Object o119, Object o120, Object o121) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80, o81, o82, o83, o84, o85, o86, o87, o88, o89, o90, o91, o92, o93, o94, o95, o96, o97, o98, o99, o100, o101, o102, o103, o104, o105, o106, o107, o108, o109, o110, o111, o112, o113, o114, o115, o116, o117, o118, o119, o120, o121); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80, Object o81, Object o82, Object o83, Object o84, Object o85, Object o86, Object o87, Object o88, Object o89, Object o90, Object o91, Object o92, Object o93, Object o94, Object o95, Object o96, Object o97, Object o98, Object o99, Object o100, Object o101, Object o102, Object o103, Object o104, Object o105, Object o106, Object o107, Object o108, Object o109, Object o110, Object o111, Object o112, Object o113, Object o114, Object o115, Object o116, Object o117, Object o118, Object o119, Object o120, Object o121, Object o122) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80, o81, o82, o83, o84, o85, o86, o87, o88, o89, o90, o91, o92, o93, o94, o95, o96, o97, o98, o99, o100, o101, o102, o103, o104, o105, o106, o107, o108, o109, o110, o111, o112, o113, o114, o115, o116, o117, o118, o119, o120, o121, o122); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80, Object o81, Object o82, Object o83, Object o84, Object o85, Object o86, Object o87, Object o88, Object o89, Object o90, Object o91, Object o92, Object o93, Object o94, Object o95, Object o96, Object o97, Object o98, Object o99, Object o100, Object o101, Object o102, Object o103, Object o104, Object o105, Object o106, Object o107, Object o108, Object o109, Object o110, Object o111, Object o112, Object o113, Object o114, Object o115, Object o116, Object o117, Object o118, Object o119, Object o120, Object o121, Object o122, Object o123) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80, o81, o82, o83, o84, o85, o86, o87, o88, o89, o90, o91, o92, o93, o94, o95, o96, o97, o98, o99, o100, o101, o102, o103, o104, o105, o106, o107, o108, o109, o110, o111, o112, o113, o114, o115, o116, o117, o118, o119, o120, o121, o122, o123); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80, Object o81, Object o82, Object o83, Object o84, Object o85, Object o86, Object o87, Object o88, Object o89, Object o90, Object o91, Object o92, Object o93, Object o94, Object o95, Object o96, Object o97, Object o98, Object o99, Object o100, Object o101, Object o102, Object o103, Object o104, Object o105, Object o106, Object o107, Object o108, Object o109, Object o110, Object o111, Object o112, Object o113, Object o114, Object o115, Object o116, Object o117, Object o118, Object o119, Object o120, Object o121, Object o122, Object o123, Object o124) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80, o81, o82, o83, o84, o85, o86, o87, o88, o89, o90, o91, o92, o93, o94, o95, o96, o97, o98, o99, o100, o101, o102, o103, o104, o105, o106, o107, o108, o109, o110, o111, o112, o113, o114, o115, o116, o117, o118, o119, o120, o121, o122, o123, o124); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80, Object o81, Object o82, Object o83, Object o84, Object o85, Object o86, Object o87, Object o88, Object o89, Object o90, Object o91, Object o92, Object o93, Object o94, Object o95, Object o96, Object o97, Object o98, Object o99, Object o100, Object o101, Object o102, Object o103, Object o104, Object o105, Object o106, Object o107, Object o108, Object o109, Object o110, Object o111, Object o112, Object o113, Object o114, Object o115, Object o116, Object o117, Object o118, Object o119, Object o120, Object o121, Object o122, Object o123, Object o124, Object o125) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80, o81, o82, o83, o84, o85, o86, o87, o88, o89, o90, o91, o92, o93, o94, o95, o96, o97, o98, o99, o100, o101, o102, o103, o104, o105, o106, o107, o108, o109, o110, o111, o112, o113, o114, o115, o116, o117, o118, o119, o120, o121, o122, o123, o124, o125); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80, Object o81, Object o82, Object o83, Object o84, Object o85, Object o86, Object o87, Object o88, Object o89, Object o90, Object o91, Object o92, Object o93, Object o94, Object o95, Object o96, Object o97, Object o98, Object o99, Object o100, Object o101, Object o102, Object o103, Object o104, Object o105, Object o106, Object o107, Object o108, Object o109, Object o110, Object o111, Object o112, Object o113, Object o114, Object o115, Object o116, Object o117, Object o118, Object o119, Object o120, Object o121, Object o122, Object o123, Object o124, Object o125, Object o126) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80, o81, o82, o83, o84, o85, o86, o87, o88, o89, o90, o91, o92, o93, o94, o95, o96, o97, o98, o99, o100, o101, o102, o103, o104, o105, o106, o107, o108, o109, o110, o111, o112, o113, o114, o115, o116, o117, o118, o119, o120, o121, o122, o123, o124, o125, o126); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80, Object o81, Object o82, Object o83, Object o84, Object o85, Object o86, Object o87, Object o88, Object o89, Object o90, Object o91, Object o92, Object o93, Object o94, Object o95, Object o96, Object o97, Object o98, Object o99, Object o100, Object o101, Object o102, Object o103, Object o104, Object o105, Object o106, Object o107, Object o108, Object o109, Object o110, Object o111, Object o112, Object o113, Object o114, Object o115, Object o116, Object o117, Object o118, Object o119, Object o120, Object o121, Object o122, Object o123, Object o124, Object o125, Object o126, Object o127) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80, o81, o82, o83, o84, o85, o86, o87, o88, o89, o90, o91, o92, o93, o94, o95, o96, o97, o98, o99, o100, o101, o102, o103, o104, o105, o106, o107, o108, o109, o110, o111, o112, o113, o114, o115, o116, o117, o118, o119, o120, o121, o122, o123, o124, o125, o126, o127); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80, Object o81, Object o82, Object o83, Object o84, Object o85, Object o86, Object o87, Object o88, Object o89, Object o90, Object o91, Object o92, Object o93, Object o94, Object o95, Object o96, Object o97, Object o98, Object o99, Object o100, Object o101, Object o102, Object o103, Object o104, Object o105, Object o106, Object o107, Object o108, Object o109, Object o110, Object o111, Object o112, Object o113, Object o114, Object o115, Object o116, Object o117, Object o118, Object o119, Object o120, Object o121, Object o122, Object o123, Object o124, Object o125, Object o126, Object o127, Object o128) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80, o81, o82, o83, o84, o85, o86, o87, o88, o89, o90, o91, o92, o93, o94, o95, o96, o97, o98, o99, o100, o101, o102, o103, o104, o105, o106, o107, o108, o109, o110, o111, o112, o113, o114, o115, o116, o117, o118, o119, o120, o121, o122, o123, o124, o125, o126, o127, o128); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80, Object o81, Object o82, Object o83, Object o84, Object o85, Object o86, Object o87, Object o88, Object o89, Object o90, Object o91, Object o92, Object o93, Object o94, Object o95, Object o96, Object o97, Object o98, Object o99, Object o100, Object o101, Object o102, Object o103, Object o104, Object o105, Object o106, Object o107, Object o108, Object o109, Object o110, Object o111, Object o112, Object o113, Object o114, Object o115, Object o116, Object o117, Object o118, Object o119, Object o120, Object o121, Object o122, Object o123, Object o124, Object o125, Object o126, Object o127, Object o128, Object o129) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80, o81, o82, o83, o84, o85, o86, o87, o88, o89, o90, o91, o92, o93, o94, o95, o96, o97, o98, o99, o100, o101, o102, o103, o104, o105, o106, o107, o108, o109, o110, o111, o112, o113, o114, o115, o116, o117, o118, o119, o120, o121, o122, o123, o124, o125, o126, o127, o128, o129); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80, Object o81, Object o82, Object o83, Object o84, Object o85, Object o86, Object o87, Object o88, Object o89, Object o90, Object o91, Object o92, Object o93, Object o94, Object o95, Object o96, Object o97, Object o98, Object o99, Object o100, Object o101, Object o102, Object o103, Object o104, Object o105, Object o106, Object o107, Object o108, Object o109, Object o110, Object o111, Object o112, Object o113, Object o114, Object o115, Object o116, Object o117, Object o118, Object o119, Object o120, Object o121, Object o122, Object o123, Object o124, Object o125, Object o126, Object o127, Object o128, Object o129, Object o130) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80, o81, o82, o83, o84, o85, o86, o87, o88, o89, o90, o91, o92, o93, o94, o95, o96, o97, o98, o99, o100, o101, o102, o103, o104, o105, o106, o107, o108, o109, o110, o111, o112, o113, o114, o115, o116, o117, o118, o119, o120, o121, o122, o123, o124, o125, o126, o127, o128, o129, o130); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80, Object o81, Object o82, Object o83, Object o84, Object o85, Object o86, Object o87, Object o88, Object o89, Object o90, Object o91, Object o92, Object o93, Object o94, Object o95, Object o96, Object o97, Object o98, Object o99, Object o100, Object o101, Object o102, Object o103, Object o104, Object o105, Object o106, Object o107, Object o108, Object o109, Object o110, Object o111, Object o112, Object o113, Object o114, Object o115, Object o116, Object o117, Object o118, Object o119, Object o120, Object o121, Object o122, Object o123, Object o124, Object o125, Object o126, Object o127, Object o128, Object o129, Object o130, Object o131) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80, o81, o82, o83, o84, o85, o86, o87, o88, o89, o90, o91, o92, o93, o94, o95, o96, o97, o98, o99, o100, o101, o102, o103, o104, o105, o106, o107, o108, o109, o110, o111, o112, o113, o114, o115, o116, o117, o118, o119, o120, o121, o122, o123, o124, o125, o126, o127, o128, o129, o130, o131); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80, Object o81, Object o82, Object o83, Object o84, Object o85, Object o86, Object o87, Object o88, Object o89, Object o90, Object o91, Object o92, Object o93, Object o94, Object o95, Object o96, Object o97, Object o98, Object o99, Object o100, Object o101, Object o102, Object o103, Object o104, Object o105, Object o106, Object o107, Object o108, Object o109, Object o110, Object o111, Object o112, Object o113, Object o114, Object o115, Object o116, Object o117, Object o118, Object o119, Object o120, Object o121, Object o122, Object o123, Object o124, Object o125, Object o126, Object o127, Object o128, Object o129, Object o130, Object o131, Object o132) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80, o81, o82, o83, o84, o85, o86, o87, o88, o89, o90, o91, o92, o93, o94, o95, o96, o97, o98, o99, o100, o101, o102, o103, o104, o105, o106, o107, o108, o109, o110, o111, o112, o113, o114, o115, o116, o117, o118, o119, o120, o121, o122, o123, o124, o125, o126, o127, o128, o129, o130, o131, o132); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80, Object o81, Object o82, Object o83, Object o84, Object o85, Object o86, Object o87, Object o88, Object o89, Object o90, Object o91, Object o92, Object o93, Object o94, Object o95, Object o96, Object o97, Object o98, Object o99, Object o100, Object o101, Object o102, Object o103, Object o104, Object o105, Object o106, Object o107, Object o108, Object o109, Object o110, Object o111, Object o112, Object o113, Object o114, Object o115, Object o116, Object o117, Object o118, Object o119, Object o120, Object o121, Object o122, Object o123, Object o124, Object o125, Object o126, Object o127, Object o128, Object o129, Object o130, Object o131, Object o132, Object o133) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80, o81, o82, o83, o84, o85, o86, o87, o88, o89, o90, o91, o92, o93, o94, o95, o96, o97, o98, o99, o100, o101, o102, o103, o104, o105, o106, o107, o108, o109, o110, o111, o112, o113, o114, o115, o116, o117, o118, o119, o120, o121, o122, o123, o124, o125, o126, o127, o128, o129, o130, o131, o132, o133); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80, Object o81, Object o82, Object o83, Object o84, Object o85, Object o86, Object o87, Object o88, Object o89, Object o90, Object o91, Object o92, Object o93, Object o94, Object o95, Object o96, Object o97, Object o98, Object o99, Object o100, Object o101, Object o102, Object o103, Object o104, Object o105, Object o106, Object o107, Object o108, Object o109, Object o110, Object o111, Object o112, Object o113, Object o114, Object o115, Object o116, Object o117, Object o118, Object o119, Object o120, Object o121, Object o122, Object o123, Object o124, Object o125, Object o126, Object o127, Object o128, Object o129, Object o130, Object o131, Object o132, Object o133, Object o134) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80, o81, o82, o83, o84, o85, o86, o87, o88, o89, o90, o91, o92, o93, o94, o95, o96, o97, o98, o99, o100, o101, o102, o103, o104, o105, o106, o107, o108, o109, o110, o111, o112, o113, o114, o115, o116, o117, o118, o119, o120, o121, o122, o123, o124, o125, o126, o127, o128, o129, o130, o131, o132, o133, o134); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80, Object o81, Object o82, Object o83, Object o84, Object o85, Object o86, Object o87, Object o88, Object o89, Object o90, Object o91, Object o92, Object o93, Object o94, Object o95, Object o96, Object o97, Object o98, Object o99, Object o100, Object o101, Object o102, Object o103, Object o104, Object o105, Object o106, Object o107, Object o108, Object o109, Object o110, Object o111, Object o112, Object o113, Object o114, Object o115, Object o116, Object o117, Object o118, Object o119, Object o120, Object o121, Object o122, Object o123, Object o124, Object o125, Object o126, Object o127, Object o128, Object o129, Object o130, Object o131, Object o132, Object o133, Object o134, Object o135) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80, o81, o82, o83, o84, o85, o86, o87, o88, o89, o90, o91, o92, o93, o94, o95, o96, o97, o98, o99, o100, o101, o102, o103, o104, o105, o106, o107, o108, o109, o110, o111, o112, o113, o114, o115, o116, o117, o118, o119, o120, o121, o122, o123, o124, o125, o126, o127, o128, o129, o130, o131, o132, o133, o134, o135); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80, Object o81, Object o82, Object o83, Object o84, Object o85, Object o86, Object o87, Object o88, Object o89, Object o90, Object o91, Object o92, Object o93, Object o94, Object o95, Object o96, Object o97, Object o98, Object o99, Object o100, Object o101, Object o102, Object o103, Object o104, Object o105, Object o106, Object o107, Object o108, Object o109, Object o110, Object o111, Object o112, Object o113, Object o114, Object o115, Object o116, Object o117, Object o118, Object o119, Object o120, Object o121, Object o122, Object o123, Object o124, Object o125, Object o126, Object o127, Object o128, Object o129, Object o130, Object o131, Object o132, Object o133, Object o134, Object o135, Object o136) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80, o81, o82, o83, o84, o85, o86, o87, o88, o89, o90, o91, o92, o93, o94, o95, o96, o97, o98, o99, o100, o101, o102, o103, o104, o105, o106, o107, o108, o109, o110, o111, o112, o113, o114, o115, o116, o117, o118, o119, o120, o121, o122, o123, o124, o125, o126, o127, o128, o129, o130, o131, o132, o133, o134, o135, o136); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80, Object o81, Object o82, Object o83, Object o84, Object o85, Object o86, Object o87, Object o88, Object o89, Object o90, Object o91, Object o92, Object o93, Object o94, Object o95, Object o96, Object o97, Object o98, Object o99, Object o100, Object o101, Object o102, Object o103, Object o104, Object o105, Object o106, Object o107, Object o108, Object o109, Object o110, Object o111, Object o112, Object o113, Object o114, Object o115, Object o116, Object o117, Object o118, Object o119, Object o120, Object o121, Object o122, Object o123, Object o124, Object o125, Object o126, Object o127, Object o128, Object o129, Object o130, Object o131, Object o132, Object o133, Object o134, Object o135, Object o136, Object o137) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80, o81, o82, o83, o84, o85, o86, o87, o88, o89, o90, o91, o92, o93, o94, o95, o96, o97, o98, o99, o100, o101, o102, o103, o104, o105, o106, o107, o108, o109, o110, o111, o112, o113, o114, o115, o116, o117, o118, o119, o120, o121, o122, o123, o124, o125, o126, o127, o128, o129, o130, o131, o132, o133, o134, o135, o136, o137); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80, Object o81, Object o82, Object o83, Object o84, Object o85, Object o86, Object o87, Object o88, Object o89, Object o90, Object o91, Object o92, Object o93, Object o94, Object o95, Object o96, Object o97, Object o98, Object o99, Object o100, Object o101, Object o102, Object o103, Object o104, Object o105, Object o106, Object o107, Object o108, Object o109, Object o110, Object o111, Object o112, Object o113, Object o114, Object o115, Object o116, Object o117, Object o118, Object o119, Object o120, Object o121, Object o122, Object o123, Object o124, Object o125, Object o126, Object o127, Object o128, Object o129, Object o130, Object o131, Object o132, Object o133, Object o134, Object o135, Object o136, Object o137, Object o138) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80, o81, o82, o83, o84, o85, o86, o87, o88, o89, o90, o91, o92, o93, o94, o95, o96, o97, o98, o99, o100, o101, o102, o103, o104, o105, o106, o107, o108, o109, o110, o111, o112, o113, o114, o115, o116, o117, o118, o119, o120, o121, o122, o123, o124, o125, o126, o127, o128, o129, o130, o131, o132, o133, o134, o135, o136, o137, o138); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80, Object o81, Object o82, Object o83, Object o84, Object o85, Object o86, Object o87, Object o88, Object o89, Object o90, Object o91, Object o92, Object o93, Object o94, Object o95, Object o96, Object o97, Object o98, Object o99, Object o100, Object o101, Object o102, Object o103, Object o104, Object o105, Object o106, Object o107, Object o108, Object o109, Object o110, Object o111, Object o112, Object o113, Object o114, Object o115, Object o116, Object o117, Object o118, Object o119, Object o120, Object o121, Object o122, Object o123, Object o124, Object o125, Object o126, Object o127, Object o128, Object o129, Object o130, Object o131, Object o132, Object o133, Object o134, Object o135, Object o136, Object o137, Object o138, Object o139) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80, o81, o82, o83, o84, o85, o86, o87, o88, o89, o90, o91, o92, o93, o94, o95, o96, o97, o98, o99, o100, o101, o102, o103, o104, o105, o106, o107, o108, o109, o110, o111, o112, o113, o114, o115, o116, o117, o118, o119, o120, o121, o122, o123, o124, o125, o126, o127, o128, o129, o130, o131, o132, o133, o134, o135, o136, o137, o138, o139); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80, Object o81, Object o82, Object o83, Object o84, Object o85, Object o86, Object o87, Object o88, Object o89, Object o90, Object o91, Object o92, Object o93, Object o94, Object o95, Object o96, Object o97, Object o98, Object o99, Object o100, Object o101, Object o102, Object o103, Object o104, Object o105, Object o106, Object o107, Object o108, Object o109, Object o110, Object o111, Object o112, Object o113, Object o114, Object o115, Object o116, Object o117, Object o118, Object o119, Object o120, Object o121, Object o122, Object o123, Object o124, Object o125, Object o126, Object o127, Object o128, Object o129, Object o130, Object o131, Object o132, Object o133, Object o134, Object o135, Object o136, Object o137, Object o138, Object o139, Object o140) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80, o81, o82, o83, o84, o85, o86, o87, o88, o89, o90, o91, o92, o93, o94, o95, o96, o97, o98, o99, o100, o101, o102, o103, o104, o105, o106, o107, o108, o109, o110, o111, o112, o113, o114, o115, o116, o117, o118, o119, o120, o121, o122, o123, o124, o125, o126, o127, o128, o129, o130, o131, o132, o133, o134, o135, o136, o137, o138, o139, o140); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80, Object o81, Object o82, Object o83, Object o84, Object o85, Object o86, Object o87, Object o88, Object o89, Object o90, Object o91, Object o92, Object o93, Object o94, Object o95, Object o96, Object o97, Object o98, Object o99, Object o100, Object o101, Object o102, Object o103, Object o104, Object o105, Object o106, Object o107, Object o108, Object o109, Object o110, Object o111, Object o112, Object o113, Object o114, Object o115, Object o116, Object o117, Object o118, Object o119, Object o120, Object o121, Object o122, Object o123, Object o124, Object o125, Object o126, Object o127, Object o128, Object o129, Object o130, Object o131, Object o132, Object o133, Object o134, Object o135, Object o136, Object o137, Object o138, Object o139, Object o140, Object o141) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80, o81, o82, o83, o84, o85, o86, o87, o88, o89, o90, o91, o92, o93, o94, o95, o96, o97, o98, o99, o100, o101, o102, o103, o104, o105, o106, o107, o108, o109, o110, o111, o112, o113, o114, o115, o116, o117, o118, o119, o120, o121, o122, o123, o124, o125, o126, o127, o128, o129, o130, o131, o132, o133, o134, o135, o136, o137, o138, o139, o140, o141); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80, Object o81, Object o82, Object o83, Object o84, Object o85, Object o86, Object o87, Object o88, Object o89, Object o90, Object o91, Object o92, Object o93, Object o94, Object o95, Object o96, Object o97, Object o98, Object o99, Object o100, Object o101, Object o102, Object o103, Object o104, Object o105, Object o106, Object o107, Object o108, Object o109, Object o110, Object o111, Object o112, Object o113, Object o114, Object o115, Object o116, Object o117, Object o118, Object o119, Object o120, Object o121, Object o122, Object o123, Object o124, Object o125, Object o126, Object o127, Object o128, Object o129, Object o130, Object o131, Object o132, Object o133, Object o134, Object o135, Object o136, Object o137, Object o138, Object o139, Object o140, Object o141, Object o142) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80, o81, o82, o83, o84, o85, o86, o87, o88, o89, o90, o91, o92, o93, o94, o95, o96, o97, o98, o99, o100, o101, o102, o103, o104, o105, o106, o107, o108, o109, o110, o111, o112, o113, o114, o115, o116, o117, o118, o119, o120, o121, o122, o123, o124, o125, o126, o127, o128, o129, o130, o131, o132, o133, o134, o135, o136, o137, o138, o139, o140, o141, o142); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80, Object o81, Object o82, Object o83, Object o84, Object o85, Object o86, Object o87, Object o88, Object o89, Object o90, Object o91, Object o92, Object o93, Object o94, Object o95, Object o96, Object o97, Object o98, Object o99, Object o100, Object o101, Object o102, Object o103, Object o104, Object o105, Object o106, Object o107, Object o108, Object o109, Object o110, Object o111, Object o112, Object o113, Object o114, Object o115, Object o116, Object o117, Object o118, Object o119, Object o120, Object o121, Object o122, Object o123, Object o124, Object o125, Object o126, Object o127, Object o128, Object o129, Object o130, Object o131, Object o132, Object o133, Object o134, Object o135, Object o136, Object o137, Object o138, Object o139, Object o140, Object o141, Object o142, Object o143) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80, o81, o82, o83, o84, o85, o86, o87, o88, o89, o90, o91, o92, o93, o94, o95, o96, o97, o98, o99, o100, o101, o102, o103, o104, o105, o106, o107, o108, o109, o110, o111, o112, o113, o114, o115, o116, o117, o118, o119, o120, o121, o122, o123, o124, o125, o126, o127, o128, o129, o130, o131, o132, o133, o134, o135, o136, o137, o138, o139, o140, o141, o142, o143); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80, Object o81, Object o82, Object o83, Object o84, Object o85, Object o86, Object o87, Object o88, Object o89, Object o90, Object o91, Object o92, Object o93, Object o94, Object o95, Object o96, Object o97, Object o98, Object o99, Object o100, Object o101, Object o102, Object o103, Object o104, Object o105, Object o106, Object o107, Object o108, Object o109, Object o110, Object o111, Object o112, Object o113, Object o114, Object o115, Object o116, Object o117, Object o118, Object o119, Object o120, Object o121, Object o122, Object o123, Object o124, Object o125, Object o126, Object o127, Object o128, Object o129, Object o130, Object o131, Object o132, Object o133, Object o134, Object o135, Object o136, Object o137, Object o138, Object o139, Object o140, Object o141, Object o142, Object o143, Object o144) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80, o81, o82, o83, o84, o85, o86, o87, o88, o89, o90, o91, o92, o93, o94, o95, o96, o97, o98, o99, o100, o101, o102, o103, o104, o105, o106, o107, o108, o109, o110, o111, o112, o113, o114, o115, o116, o117, o118, o119, o120, o121, o122, o123, o124, o125, o126, o127, o128, o129, o130, o131, o132, o133, o134, o135, o136, o137, o138, o139, o140, o141, o142, o143, o144); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80, Object o81, Object o82, Object o83, Object o84, Object o85, Object o86, Object o87, Object o88, Object o89, Object o90, Object o91, Object o92, Object o93, Object o94, Object o95, Object o96, Object o97, Object o98, Object o99, Object o100, Object o101, Object o102, Object o103, Object o104, Object o105, Object o106, Object o107, Object o108, Object o109, Object o110, Object o111, Object o112, Object o113, Object o114, Object o115, Object o116, Object o117, Object o118, Object o119, Object o120, Object o121, Object o122, Object o123, Object o124, Object o125, Object o126, Object o127, Object o128, Object o129, Object o130, Object o131, Object o132, Object o133, Object o134, Object o135, Object o136, Object o137, Object o138, Object o139, Object o140, Object o141, Object o142, Object o143, Object o144, Object o145) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80, o81, o82, o83, o84, o85, o86, o87, o88, o89, o90, o91, o92, o93, o94, o95, o96, o97, o98, o99, o100, o101, o102, o103, o104, o105, o106, o107, o108, o109, o110, o111, o112, o113, o114, o115, o116, o117, o118, o119, o120, o121, o122, o123, o124, o125, o126, o127, o128, o129, o130, o131, o132, o133, o134, o135, o136, o137, o138, o139, o140, o141, o142, o143, o144, o145); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80, Object o81, Object o82, Object o83, Object o84, Object o85, Object o86, Object o87, Object o88, Object o89, Object o90, Object o91, Object o92, Object o93, Object o94, Object o95, Object o96, Object o97, Object o98, Object o99, Object o100, Object o101, Object o102, Object o103, Object o104, Object o105, Object o106, Object o107, Object o108, Object o109, Object o110, Object o111, Object o112, Object o113, Object o114, Object o115, Object o116, Object o117, Object o118, Object o119, Object o120, Object o121, Object o122, Object o123, Object o124, Object o125, Object o126, Object o127, Object o128, Object o129, Object o130, Object o131, Object o132, Object o133, Object o134, Object o135, Object o136, Object o137, Object o138, Object o139, Object o140, Object o141, Object o142, Object o143, Object o144, Object o145, Object o146) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80, o81, o82, o83, o84, o85, o86, o87, o88, o89, o90, o91, o92, o93, o94, o95, o96, o97, o98, o99, o100, o101, o102, o103, o104, o105, o106, o107, o108, o109, o110, o111, o112, o113, o114, o115, o116, o117, o118, o119, o120, o121, o122, o123, o124, o125, o126, o127, o128, o129, o130, o131, o132, o133, o134, o135, o136, o137, o138, o139, o140, o141, o142, o143, o144, o145, o146); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80, Object o81, Object o82, Object o83, Object o84, Object o85, Object o86, Object o87, Object o88, Object o89, Object o90, Object o91, Object o92, Object o93, Object o94, Object o95, Object o96, Object o97, Object o98, Object o99, Object o100, Object o101, Object o102, Object o103, Object o104, Object o105, Object o106, Object o107, Object o108, Object o109, Object o110, Object o111, Object o112, Object o113, Object o114, Object o115, Object o116, Object o117, Object o118, Object o119, Object o120, Object o121, Object o122, Object o123, Object o124, Object o125, Object o126, Object o127, Object o128, Object o129, Object o130, Object o131, Object o132, Object o133, Object o134, Object o135, Object o136, Object o137, Object o138, Object o139, Object o140, Object o141, Object o142, Object o143, Object o144, Object o145, Object o146, Object o147) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80, o81, o82, o83, o84, o85, o86, o87, o88, o89, o90, o91, o92, o93, o94, o95, o96, o97, o98, o99, o100, o101, o102, o103, o104, o105, o106, o107, o108, o109, o110, o111, o112, o113, o114, o115, o116, o117, o118, o119, o120, o121, o122, o123, o124, o125, o126, o127, o128, o129, o130, o131, o132, o133, o134, o135, o136, o137, o138, o139, o140, o141, o142, o143, o144, o145, o146, o147); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80, Object o81, Object o82, Object o83, Object o84, Object o85, Object o86, Object o87, Object o88, Object o89, Object o90, Object o91, Object o92, Object o93, Object o94, Object o95, Object o96, Object o97, Object o98, Object o99, Object o100, Object o101, Object o102, Object o103, Object o104, Object o105, Object o106, Object o107, Object o108, Object o109, Object o110, Object o111, Object o112, Object o113, Object o114, Object o115, Object o116, Object o117, Object o118, Object o119, Object o120, Object o121, Object o122, Object o123, Object o124, Object o125, Object o126, Object o127, Object o128, Object o129, Object o130, Object o131, Object o132, Object o133, Object o134, Object o135, Object o136, Object o137, Object o138, Object o139, Object o140, Object o141, Object o142, Object o143, Object o144, Object o145, Object o146, Object o147, Object o148) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80, o81, o82, o83, o84, o85, o86, o87, o88, o89, o90, o91, o92, o93, o94, o95, o96, o97, o98, o99, o100, o101, o102, o103, o104, o105, o106, o107, o108, o109, o110, o111, o112, o113, o114, o115, o116, o117, o118, o119, o120, o121, o122, o123, o124, o125, o126, o127, o128, o129, o130, o131, o132, o133, o134, o135, o136, o137, o138, o139, o140, o141, o142, o143, o144, o145, o146, o147, o148); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80, Object o81, Object o82, Object o83, Object o84, Object o85, Object o86, Object o87, Object o88, Object o89, Object o90, Object o91, Object o92, Object o93, Object o94, Object o95, Object o96, Object o97, Object o98, Object o99, Object o100, Object o101, Object o102, Object o103, Object o104, Object o105, Object o106, Object o107, Object o108, Object o109, Object o110, Object o111, Object o112, Object o113, Object o114, Object o115, Object o116, Object o117, Object o118, Object o119, Object o120, Object o121, Object o122, Object o123, Object o124, Object o125, Object o126, Object o127, Object o128, Object o129, Object o130, Object o131, Object o132, Object o133, Object o134, Object o135, Object o136, Object o137, Object o138, Object o139, Object o140, Object o141, Object o142, Object o143, Object o144, Object o145, Object o146, Object o147, Object o148, Object o149) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80, o81, o82, o83, o84, o85, o86, o87, o88, o89, o90, o91, o92, o93, o94, o95, o96, o97, o98, o99, o100, o101, o102, o103, o104, o105, o106, o107, o108, o109, o110, o111, o112, o113, o114, o115, o116, o117, o118, o119, o120, o121, o122, o123, o124, o125, o126, o127, o128, o129, o130, o131, o132, o133, o134, o135, o136, o137, o138, o139, o140, o141, o142, o143, o144, o145, o146, o147, o148, o149); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80, Object o81, Object o82, Object o83, Object o84, Object o85, Object o86, Object o87, Object o88, Object o89, Object o90, Object o91, Object o92, Object o93, Object o94, Object o95, Object o96, Object o97, Object o98, Object o99, Object o100, Object o101, Object o102, Object o103, Object o104, Object o105, Object o106, Object o107, Object o108, Object o109, Object o110, Object o111, Object o112, Object o113, Object o114, Object o115, Object o116, Object o117, Object o118, Object o119, Object o120, Object o121, Object o122, Object o123, Object o124, Object o125, Object o126, Object o127, Object o128, Object o129, Object o130, Object o131, Object o132, Object o133, Object o134, Object o135, Object o136, Object o137, Object o138, Object o139, Object o140, Object o141, Object o142, Object o143, Object o144, Object o145, Object o146, Object o147, Object o148, Object o149, Object o150) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80, o81, o82, o83, o84, o85, o86, o87, o88, o89, o90, o91, o92, o93, o94, o95, o96, o97, o98, o99, o100, o101, o102, o103, o104, o105, o106, o107, o108, o109, o110, o111, o112, o113, o114, o115, o116, o117, o118, o119, o120, o121, o122, o123, o124, o125, o126, o127, o128, o129, o130, o131, o132, o133, o134, o135, o136, o137, o138, o139, o140, o141, o142, o143, o144, o145, o146, o147, o148, o149, o150); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80, Object o81, Object o82, Object o83, Object o84, Object o85, Object o86, Object o87, Object o88, Object o89, Object o90, Object o91, Object o92, Object o93, Object o94, Object o95, Object o96, Object o97, Object o98, Object o99, Object o100, Object o101, Object o102, Object o103, Object o104, Object o105, Object o106, Object o107, Object o108, Object o109, Object o110, Object o111, Object o112, Object o113, Object o114, Object o115, Object o116, Object o117, Object o118, Object o119, Object o120, Object o121, Object o122, Object o123, Object o124, Object o125, Object o126, Object o127, Object o128, Object o129, Object o130, Object o131, Object o132, Object o133, Object o134, Object o135, Object o136, Object o137, Object o138, Object o139, Object o140, Object o141, Object o142, Object o143, Object o144, Object o145, Object o146, Object o147, Object o148, Object o149, Object o150, Object o151) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80, o81, o82, o83, o84, o85, o86, o87, o88, o89, o90, o91, o92, o93, o94, o95, o96, o97, o98, o99, o100, o101, o102, o103, o104, o105, o106, o107, o108, o109, o110, o111, o112, o113, o114, o115, o116, o117, o118, o119, o120, o121, o122, o123, o124, o125, o126, o127, o128, o129, o130, o131, o132, o133, o134, o135, o136, o137, o138, o139, o140, o141, o142, o143, o144, o145, o146, o147, o148, o149, o150, o151); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80, Object o81, Object o82, Object o83, Object o84, Object o85, Object o86, Object o87, Object o88, Object o89, Object o90, Object o91, Object o92, Object o93, Object o94, Object o95, Object o96, Object o97, Object o98, Object o99, Object o100, Object o101, Object o102, Object o103, Object o104, Object o105, Object o106, Object o107, Object o108, Object o109, Object o110, Object o111, Object o112, Object o113, Object o114, Object o115, Object o116, Object o117, Object o118, Object o119, Object o120, Object o121, Object o122, Object o123, Object o124, Object o125, Object o126, Object o127, Object o128, Object o129, Object o130, Object o131, Object o132, Object o133, Object o134, Object o135, Object o136, Object o137, Object o138, Object o139, Object o140, Object o141, Object o142, Object o143, Object o144, Object o145, Object o146, Object o147, Object o148, Object o149, Object o150, Object o151, Object o152) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80, o81, o82, o83, o84, o85, o86, o87, o88, o89, o90, o91, o92, o93, o94, o95, o96, o97, o98, o99, o100, o101, o102, o103, o104, o105, o106, o107, o108, o109, o110, o111, o112, o113, o114, o115, o116, o117, o118, o119, o120, o121, o122, o123, o124, o125, o126, o127, o128, o129, o130, o131, o132, o133, o134, o135, o136, o137, o138, o139, o140, o141, o142, o143, o144, o145, o146, o147, o148, o149, o150, o151, o152); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80, Object o81, Object o82, Object o83, Object o84, Object o85, Object o86, Object o87, Object o88, Object o89, Object o90, Object o91, Object o92, Object o93, Object o94, Object o95, Object o96, Object o97, Object o98, Object o99, Object o100, Object o101, Object o102, Object o103, Object o104, Object o105, Object o106, Object o107, Object o108, Object o109, Object o110, Object o111, Object o112, Object o113, Object o114, Object o115, Object o116, Object o117, Object o118, Object o119, Object o120, Object o121, Object o122, Object o123, Object o124, Object o125, Object o126, Object o127, Object o128, Object o129, Object o130, Object o131, Object o132, Object o133, Object o134, Object o135, Object o136, Object o137, Object o138, Object o139, Object o140, Object o141, Object o142, Object o143, Object o144, Object o145, Object o146, Object o147, Object o148, Object o149, Object o150, Object o151, Object o152, Object o153) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80, o81, o82, o83, o84, o85, o86, o87, o88, o89, o90, o91, o92, o93, o94, o95, o96, o97, o98, o99, o100, o101, o102, o103, o104, o105, o106, o107, o108, o109, o110, o111, o112, o113, o114, o115, o116, o117, o118, o119, o120, o121, o122, o123, o124, o125, o126, o127, o128, o129, o130, o131, o132, o133, o134, o135, o136, o137, o138, o139, o140, o141, o142, o143, o144, o145, o146, o147, o148, o149, o150, o151, o152, o153); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80, Object o81, Object o82, Object o83, Object o84, Object o85, Object o86, Object o87, Object o88, Object o89, Object o90, Object o91, Object o92, Object o93, Object o94, Object o95, Object o96, Object o97, Object o98, Object o99, Object o100, Object o101, Object o102, Object o103, Object o104, Object o105, Object o106, Object o107, Object o108, Object o109, Object o110, Object o111, Object o112, Object o113, Object o114, Object o115, Object o116, Object o117, Object o118, Object o119, Object o120, Object o121, Object o122, Object o123, Object o124, Object o125, Object o126, Object o127, Object o128, Object o129, Object o130, Object o131, Object o132, Object o133, Object o134, Object o135, Object o136, Object o137, Object o138, Object o139, Object o140, Object o141, Object o142, Object o143, Object o144, Object o145, Object o146, Object o147, Object o148, Object o149, Object o150, Object o151, Object o152, Object o153, Object o154) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80, o81, o82, o83, o84, o85, o86, o87, o88, o89, o90, o91, o92, o93, o94, o95, o96, o97, o98, o99, o100, o101, o102, o103, o104, o105, o106, o107, o108, o109, o110, o111, o112, o113, o114, o115, o116, o117, o118, o119, o120, o121, o122, o123, o124, o125, o126, o127, o128, o129, o130, o131, o132, o133, o134, o135, o136, o137, o138, o139, o140, o141, o142, o143, o144, o145, o146, o147, o148, o149, o150, o151, o152, o153, o154); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80, Object o81, Object o82, Object o83, Object o84, Object o85, Object o86, Object o87, Object o88, Object o89, Object o90, Object o91, Object o92, Object o93, Object o94, Object o95, Object o96, Object o97, Object o98, Object o99, Object o100, Object o101, Object o102, Object o103, Object o104, Object o105, Object o106, Object o107, Object o108, Object o109, Object o110, Object o111, Object o112, Object o113, Object o114, Object o115, Object o116, Object o117, Object o118, Object o119, Object o120, Object o121, Object o122, Object o123, Object o124, Object o125, Object o126, Object o127, Object o128, Object o129, Object o130, Object o131, Object o132, Object o133, Object o134, Object o135, Object o136, Object o137, Object o138, Object o139, Object o140, Object o141, Object o142, Object o143, Object o144, Object o145, Object o146, Object o147, Object o148, Object o149, Object o150, Object o151, Object o152, Object o153, Object o154, Object o155) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80, o81, o82, o83, o84, o85, o86, o87, o88, o89, o90, o91, o92, o93, o94, o95, o96, o97, o98, o99, o100, o101, o102, o103, o104, o105, o106, o107, o108, o109, o110, o111, o112, o113, o114, o115, o116, o117, o118, o119, o120, o121, o122, o123, o124, o125, o126, o127, o128, o129, o130, o131, o132, o133, o134, o135, o136, o137, o138, o139, o140, o141, o142, o143, o144, o145, o146, o147, o148, o149, o150, o151, o152, o153, o154, o155); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80, Object o81, Object o82, Object o83, Object o84, Object o85, Object o86, Object o87, Object o88, Object o89, Object o90, Object o91, Object o92, Object o93, Object o94, Object o95, Object o96, Object o97, Object o98, Object o99, Object o100, Object o101, Object o102, Object o103, Object o104, Object o105, Object o106, Object o107, Object o108, Object o109, Object o110, Object o111, Object o112, Object o113, Object o114, Object o115, Object o116, Object o117, Object o118, Object o119, Object o120, Object o121, Object o122, Object o123, Object o124, Object o125, Object o126, Object o127, Object o128, Object o129, Object o130, Object o131, Object o132, Object o133, Object o134, Object o135, Object o136, Object o137, Object o138, Object o139, Object o140, Object o141, Object o142, Object o143, Object o144, Object o145, Object o146, Object o147, Object o148, Object o149, Object o150, Object o151, Object o152, Object o153, Object o154, Object o155, Object o156) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80, o81, o82, o83, o84, o85, o86, o87, o88, o89, o90, o91, o92, o93, o94, o95, o96, o97, o98, o99, o100, o101, o102, o103, o104, o105, o106, o107, o108, o109, o110, o111, o112, o113, o114, o115, o116, o117, o118, o119, o120, o121, o122, o123, o124, o125, o126, o127, o128, o129, o130, o131, o132, o133, o134, o135, o136, o137, o138, o139, o140, o141, o142, o143, o144, o145, o146, o147, o148, o149, o150, o151, o152, o153, o154, o155, o156); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80, Object o81, Object o82, Object o83, Object o84, Object o85, Object o86, Object o87, Object o88, Object o89, Object o90, Object o91, Object o92, Object o93, Object o94, Object o95, Object o96, Object o97, Object o98, Object o99, Object o100, Object o101, Object o102, Object o103, Object o104, Object o105, Object o106, Object o107, Object o108, Object o109, Object o110, Object o111, Object o112, Object o113, Object o114, Object o115, Object o116, Object o117, Object o118, Object o119, Object o120, Object o121, Object o122, Object o123, Object o124, Object o125, Object o126, Object o127, Object o128, Object o129, Object o130, Object o131, Object o132, Object o133, Object o134, Object o135, Object o136, Object o137, Object o138, Object o139, Object o140, Object o141, Object o142, Object o143, Object o144, Object o145, Object o146, Object o147, Object o148, Object o149, Object o150, Object o151, Object o152, Object o153, Object o154, Object o155, Object o156, Object o157) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80, o81, o82, o83, o84, o85, o86, o87, o88, o89, o90, o91, o92, o93, o94, o95, o96, o97, o98, o99, o100, o101, o102, o103, o104, o105, o106, o107, o108, o109, o110, o111, o112, o113, o114, o115, o116, o117, o118, o119, o120, o121, o122, o123, o124, o125, o126, o127, o128, o129, o130, o131, o132, o133, o134, o135, o136, o137, o138, o139, o140, o141, o142, o143, o144, o145, o146, o147, o148, o149, o150, o151, o152, o153, o154, o155, o156, o157); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80, Object o81, Object o82, Object o83, Object o84, Object o85, Object o86, Object o87, Object o88, Object o89, Object o90, Object o91, Object o92, Object o93, Object o94, Object o95, Object o96, Object o97, Object o98, Object o99, Object o100, Object o101, Object o102, Object o103, Object o104, Object o105, Object o106, Object o107, Object o108, Object o109, Object o110, Object o111, Object o112, Object o113, Object o114, Object o115, Object o116, Object o117, Object o118, Object o119, Object o120, Object o121, Object o122, Object o123, Object o124, Object o125, Object o126, Object o127, Object o128, Object o129, Object o130, Object o131, Object o132, Object o133, Object o134, Object o135, Object o136, Object o137, Object o138, Object o139, Object o140, Object o141, Object o142, Object o143, Object o144, Object o145, Object o146, Object o147, Object o148, Object o149, Object o150, Object o151, Object o152, Object o153, Object o154, Object o155, Object o156, Object o157, Object o158) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80, o81, o82, o83, o84, o85, o86, o87, o88, o89, o90, o91, o92, o93, o94, o95, o96, o97, o98, o99, o100, o101, o102, o103, o104, o105, o106, o107, o108, o109, o110, o111, o112, o113, o114, o115, o116, o117, o118, o119, o120, o121, o122, o123, o124, o125, o126, o127, o128, o129, o130, o131, o132, o133, o134, o135, o136, o137, o138, o139, o140, o141, o142, o143, o144, o145, o146, o147, o148, o149, o150, o151, o152, o153, o154, o155, o156, o157, o158); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80, Object o81, Object o82, Object o83, Object o84, Object o85, Object o86, Object o87, Object o88, Object o89, Object o90, Object o91, Object o92, Object o93, Object o94, Object o95, Object o96, Object o97, Object o98, Object o99, Object o100, Object o101, Object o102, Object o103, Object o104, Object o105, Object o106, Object o107, Object o108, Object o109, Object o110, Object o111, Object o112, Object o113, Object o114, Object o115, Object o116, Object o117, Object o118, Object o119, Object o120, Object o121, Object o122, Object o123, Object o124, Object o125, Object o126, Object o127, Object o128, Object o129, Object o130, Object o131, Object o132, Object o133, Object o134, Object o135, Object o136, Object o137, Object o138, Object o139, Object o140, Object o141, Object o142, Object o143, Object o144, Object o145, Object o146, Object o147, Object o148, Object o149, Object o150, Object o151, Object o152, Object o153, Object o154, Object o155, Object o156, Object o157, Object o158, Object o159) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80, o81, o82, o83, o84, o85, o86, o87, o88, o89, o90, o91, o92, o93, o94, o95, o96, o97, o98, o99, o100, o101, o102, o103, o104, o105, o106, o107, o108, o109, o110, o111, o112, o113, o114, o115, o116, o117, o118, o119, o120, o121, o122, o123, o124, o125, o126, o127, o128, o129, o130, o131, o132, o133, o134, o135, o136, o137, o138, o139, o140, o141, o142, o143, o144, o145, o146, o147, o148, o149, o150, o151, o152, o153, o154, o155, o156, o157, o158, o159); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80, Object o81, Object o82, Object o83, Object o84, Object o85, Object o86, Object o87, Object o88, Object o89, Object o90, Object o91, Object o92, Object o93, Object o94, Object o95, Object o96, Object o97, Object o98, Object o99, Object o100, Object o101, Object o102, Object o103, Object o104, Object o105, Object o106, Object o107, Object o108, Object o109, Object o110, Object o111, Object o112, Object o113, Object o114, Object o115, Object o116, Object o117, Object o118, Object o119, Object o120, Object o121, Object o122, Object o123, Object o124, Object o125, Object o126, Object o127, Object o128, Object o129, Object o130, Object o131, Object o132, Object o133, Object o134, Object o135, Object o136, Object o137, Object o138, Object o139, Object o140, Object o141, Object o142, Object o143, Object o144, Object o145, Object o146, Object o147, Object o148, Object o149, Object o150, Object o151, Object o152, Object o153, Object o154, Object o155, Object o156, Object o157, Object o158, Object o159, Object o160) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80, o81, o82, o83, o84, o85, o86, o87, o88, o89, o90, o91, o92, o93, o94, o95, o96, o97, o98, o99, o100, o101, o102, o103, o104, o105, o106, o107, o108, o109, o110, o111, o112, o113, o114, o115, o116, o117, o118, o119, o120, o121, o122, o123, o124, o125, o126, o127, o128, o129, o130, o131, o132, o133, o134, o135, o136, o137, o138, o139, o140, o141, o142, o143, o144, o145, o146, o147, o148, o149, o150, o151, o152, o153, o154, o155, o156, o157, o158, o159, o160); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80, Object o81, Object o82, Object o83, Object o84, Object o85, Object o86, Object o87, Object o88, Object o89, Object o90, Object o91, Object o92, Object o93, Object o94, Object o95, Object o96, Object o97, Object o98, Object o99, Object o100, Object o101, Object o102, Object o103, Object o104, Object o105, Object o106, Object o107, Object o108, Object o109, Object o110, Object o111, Object o112, Object o113, Object o114, Object o115, Object o116, Object o117, Object o118, Object o119, Object o120, Object o121, Object o122, Object o123, Object o124, Object o125, Object o126, Object o127, Object o128, Object o129, Object o130, Object o131, Object o132, Object o133, Object o134, Object o135, Object o136, Object o137, Object o138, Object o139, Object o140, Object o141, Object o142, Object o143, Object o144, Object o145, Object o146, Object o147, Object o148, Object o149, Object o150, Object o151, Object o152, Object o153, Object o154, Object o155, Object o156, Object o157, Object o158, Object o159, Object o160, Object o161) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80, o81, o82, o83, o84, o85, o86, o87, o88, o89, o90, o91, o92, o93, o94, o95, o96, o97, o98, o99, o100, o101, o102, o103, o104, o105, o106, o107, o108, o109, o110, o111, o112, o113, o114, o115, o116, o117, o118, o119, o120, o121, o122, o123, o124, o125, o126, o127, o128, o129, o130, o131, o132, o133, o134, o135, o136, o137, o138, o139, o140, o141, o142, o143, o144, o145, o146, o147, o148, o149, o150, o151, o152, o153, o154, o155, o156, o157, o158, o159, o160, o161); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80, Object o81, Object o82, Object o83, Object o84, Object o85, Object o86, Object o87, Object o88, Object o89, Object o90, Object o91, Object o92, Object o93, Object o94, Object o95, Object o96, Object o97, Object o98, Object o99, Object o100, Object o101, Object o102, Object o103, Object o104, Object o105, Object o106, Object o107, Object o108, Object o109, Object o110, Object o111, Object o112, Object o113, Object o114, Object o115, Object o116, Object o117, Object o118, Object o119, Object o120, Object o121, Object o122, Object o123, Object o124, Object o125, Object o126, Object o127, Object o128, Object o129, Object o130, Object o131, Object o132, Object o133, Object o134, Object o135, Object o136, Object o137, Object o138, Object o139, Object o140, Object o141, Object o142, Object o143, Object o144, Object o145, Object o146, Object o147, Object o148, Object o149, Object o150, Object o151, Object o152, Object o153, Object o154, Object o155, Object o156, Object o157, Object o158, Object o159, Object o160, Object o161, Object o162) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80, o81, o82, o83, o84, o85, o86, o87, o88, o89, o90, o91, o92, o93, o94, o95, o96, o97, o98, o99, o100, o101, o102, o103, o104, o105, o106, o107, o108, o109, o110, o111, o112, o113, o114, o115, o116, o117, o118, o119, o120, o121, o122, o123, o124, o125, o126, o127, o128, o129, o130, o131, o132, o133, o134, o135, o136, o137, o138, o139, o140, o141, o142, o143, o144, o145, o146, o147, o148, o149, o150, o151, o152, o153, o154, o155, o156, o157, o158, o159, o160, o161, o162); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80, Object o81, Object o82, Object o83, Object o84, Object o85, Object o86, Object o87, Object o88, Object o89, Object o90, Object o91, Object o92, Object o93, Object o94, Object o95, Object o96, Object o97, Object o98, Object o99, Object o100, Object o101, Object o102, Object o103, Object o104, Object o105, Object o106, Object o107, Object o108, Object o109, Object o110, Object o111, Object o112, Object o113, Object o114, Object o115, Object o116, Object o117, Object o118, Object o119, Object o120, Object o121, Object o122, Object o123, Object o124, Object o125, Object o126, Object o127, Object o128, Object o129, Object o130, Object o131, Object o132, Object o133, Object o134, Object o135, Object o136, Object o137, Object o138, Object o139, Object o140, Object o141, Object o142, Object o143, Object o144, Object o145, Object o146, Object o147, Object o148, Object o149, Object o150, Object o151, Object o152, Object o153, Object o154, Object o155, Object o156, Object o157, Object o158, Object o159, Object o160, Object o161, Object o162, Object o163) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80, o81, o82, o83, o84, o85, o86, o87, o88, o89, o90, o91, o92, o93, o94, o95, o96, o97, o98, o99, o100, o101, o102, o103, o104, o105, o106, o107, o108, o109, o110, o111, o112, o113, o114, o115, o116, o117, o118, o119, o120, o121, o122, o123, o124, o125, o126, o127, o128, o129, o130, o131, o132, o133, o134, o135, o136, o137, o138, o139, o140, o141, o142, o143, o144, o145, o146, o147, o148, o149, o150, o151, o152, o153, o154, o155, o156, o157, o158, o159, o160, o161, o162, o163); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80, Object o81, Object o82, Object o83, Object o84, Object o85, Object o86, Object o87, Object o88, Object o89, Object o90, Object o91, Object o92, Object o93, Object o94, Object o95, Object o96, Object o97, Object o98, Object o99, Object o100, Object o101, Object o102, Object o103, Object o104, Object o105, Object o106, Object o107, Object o108, Object o109, Object o110, Object o111, Object o112, Object o113, Object o114, Object o115, Object o116, Object o117, Object o118, Object o119, Object o120, Object o121, Object o122, Object o123, Object o124, Object o125, Object o126, Object o127, Object o128, Object o129, Object o130, Object o131, Object o132, Object o133, Object o134, Object o135, Object o136, Object o137, Object o138, Object o139, Object o140, Object o141, Object o142, Object o143, Object o144, Object o145, Object o146, Object o147, Object o148, Object o149, Object o150, Object o151, Object o152, Object o153, Object o154, Object o155, Object o156, Object o157, Object o158, Object o159, Object o160, Object o161, Object o162, Object o163, Object o164) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80, o81, o82, o83, o84, o85, o86, o87, o88, o89, o90, o91, o92, o93, o94, o95, o96, o97, o98, o99, o100, o101, o102, o103, o104, o105, o106, o107, o108, o109, o110, o111, o112, o113, o114, o115, o116, o117, o118, o119, o120, o121, o122, o123, o124, o125, o126, o127, o128, o129, o130, o131, o132, o133, o134, o135, o136, o137, o138, o139, o140, o141, o142, o143, o144, o145, o146, o147, o148, o149, o150, o151, o152, o153, o154, o155, o156, o157, o158, o159, o160, o161, o162, o163, o164); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80, Object o81, Object o82, Object o83, Object o84, Object o85, Object o86, Object o87, Object o88, Object o89, Object o90, Object o91, Object o92, Object o93, Object o94, Object o95, Object o96, Object o97, Object o98, Object o99, Object o100, Object o101, Object o102, Object o103, Object o104, Object o105, Object o106, Object o107, Object o108, Object o109, Object o110, Object o111, Object o112, Object o113, Object o114, Object o115, Object o116, Object o117, Object o118, Object o119, Object o120, Object o121, Object o122, Object o123, Object o124, Object o125, Object o126, Object o127, Object o128, Object o129, Object o130, Object o131, Object o132, Object o133, Object o134, Object o135, Object o136, Object o137, Object o138, Object o139, Object o140, Object o141, Object o142, Object o143, Object o144, Object o145, Object o146, Object o147, Object o148, Object o149, Object o150, Object o151, Object o152, Object o153, Object o154, Object o155, Object o156, Object o157, Object o158, Object o159, Object o160, Object o161, Object o162, Object o163, Object o164, Object o165) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80, o81, o82, o83, o84, o85, o86, o87, o88, o89, o90, o91, o92, o93, o94, o95, o96, o97, o98, o99, o100, o101, o102, o103, o104, o105, o106, o107, o108, o109, o110, o111, o112, o113, o114, o115, o116, o117, o118, o119, o120, o121, o122, o123, o124, o125, o126, o127, o128, o129, o130, o131, o132, o133, o134, o135, o136, o137, o138, o139, o140, o141, o142, o143, o144, o145, o146, o147, o148, o149, o150, o151, o152, o153, o154, o155, o156, o157, o158, o159, o160, o161, o162, o163, o164, o165); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80, Object o81, Object o82, Object o83, Object o84, Object o85, Object o86, Object o87, Object o88, Object o89, Object o90, Object o91, Object o92, Object o93, Object o94, Object o95, Object o96, Object o97, Object o98, Object o99, Object o100, Object o101, Object o102, Object o103, Object o104, Object o105, Object o106, Object o107, Object o108, Object o109, Object o110, Object o111, Object o112, Object o113, Object o114, Object o115, Object o116, Object o117, Object o118, Object o119, Object o120, Object o121, Object o122, Object o123, Object o124, Object o125, Object o126, Object o127, Object o128, Object o129, Object o130, Object o131, Object o132, Object o133, Object o134, Object o135, Object o136, Object o137, Object o138, Object o139, Object o140, Object o141, Object o142, Object o143, Object o144, Object o145, Object o146, Object o147, Object o148, Object o149, Object o150, Object o151, Object o152, Object o153, Object o154, Object o155, Object o156, Object o157, Object o158, Object o159, Object o160, Object o161, Object o162, Object o163, Object o164, Object o165, Object o166) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80, o81, o82, o83, o84, o85, o86, o87, o88, o89, o90, o91, o92, o93, o94, o95, o96, o97, o98, o99, o100, o101, o102, o103, o104, o105, o106, o107, o108, o109, o110, o111, o112, o113, o114, o115, o116, o117, o118, o119, o120, o121, o122, o123, o124, o125, o126, o127, o128, o129, o130, o131, o132, o133, o134, o135, o136, o137, o138, o139, o140, o141, o142, o143, o144, o145, o146, o147, o148, o149, o150, o151, o152, o153, o154, o155, o156, o157, o158, o159, o160, o161, o162, o163, o164, o165, o166); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80, Object o81, Object o82, Object o83, Object o84, Object o85, Object o86, Object o87, Object o88, Object o89, Object o90, Object o91, Object o92, Object o93, Object o94, Object o95, Object o96, Object o97, Object o98, Object o99, Object o100, Object o101, Object o102, Object o103, Object o104, Object o105, Object o106, Object o107, Object o108, Object o109, Object o110, Object o111, Object o112, Object o113, Object o114, Object o115, Object o116, Object o117, Object o118, Object o119, Object o120, Object o121, Object o122, Object o123, Object o124, Object o125, Object o126, Object o127, Object o128, Object o129, Object o130, Object o131, Object o132, Object o133, Object o134, Object o135, Object o136, Object o137, Object o138, Object o139, Object o140, Object o141, Object o142, Object o143, Object o144, Object o145, Object o146, Object o147, Object o148, Object o149, Object o150, Object o151, Object o152, Object o153, Object o154, Object o155, Object o156, Object o157, Object o158, Object o159, Object o160, Object o161, Object o162, Object o163, Object o164, Object o165, Object o166, Object o167) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80, o81, o82, o83, o84, o85, o86, o87, o88, o89, o90, o91, o92, o93, o94, o95, o96, o97, o98, o99, o100, o101, o102, o103, o104, o105, o106, o107, o108, o109, o110, o111, o112, o113, o114, o115, o116, o117, o118, o119, o120, o121, o122, o123, o124, o125, o126, o127, o128, o129, o130, o131, o132, o133, o134, o135, o136, o137, o138, o139, o140, o141, o142, o143, o144, o145, o146, o147, o148, o149, o150, o151, o152, o153, o154, o155, o156, o157, o158, o159, o160, o161, o162, o163, o164, o165, o166, o167); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80, Object o81, Object o82, Object o83, Object o84, Object o85, Object o86, Object o87, Object o88, Object o89, Object o90, Object o91, Object o92, Object o93, Object o94, Object o95, Object o96, Object o97, Object o98, Object o99, Object o100, Object o101, Object o102, Object o103, Object o104, Object o105, Object o106, Object o107, Object o108, Object o109, Object o110, Object o111, Object o112, Object o113, Object o114, Object o115, Object o116, Object o117, Object o118, Object o119, Object o120, Object o121, Object o122, Object o123, Object o124, Object o125, Object o126, Object o127, Object o128, Object o129, Object o130, Object o131, Object o132, Object o133, Object o134, Object o135, Object o136, Object o137, Object o138, Object o139, Object o140, Object o141, Object o142, Object o143, Object o144, Object o145, Object o146, Object o147, Object o148, Object o149, Object o150, Object o151, Object o152, Object o153, Object o154, Object o155, Object o156, Object o157, Object o158, Object o159, Object o160, Object o161, Object o162, Object o163, Object o164, Object o165, Object o166, Object o167, Object o168) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80, o81, o82, o83, o84, o85, o86, o87, o88, o89, o90, o91, o92, o93, o94, o95, o96, o97, o98, o99, o100, o101, o102, o103, o104, o105, o106, o107, o108, o109, o110, o111, o112, o113, o114, o115, o116, o117, o118, o119, o120, o121, o122, o123, o124, o125, o126, o127, o128, o129, o130, o131, o132, o133, o134, o135, o136, o137, o138, o139, o140, o141, o142, o143, o144, o145, o146, o147, o148, o149, o150, o151, o152, o153, o154, o155, o156, o157, o158, o159, o160, o161, o162, o163, o164, o165, o166, o167, o168); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80, Object o81, Object o82, Object o83, Object o84, Object o85, Object o86, Object o87, Object o88, Object o89, Object o90, Object o91, Object o92, Object o93, Object o94, Object o95, Object o96, Object o97, Object o98, Object o99, Object o100, Object o101, Object o102, Object o103, Object o104, Object o105, Object o106, Object o107, Object o108, Object o109, Object o110, Object o111, Object o112, Object o113, Object o114, Object o115, Object o116, Object o117, Object o118, Object o119, Object o120, Object o121, Object o122, Object o123, Object o124, Object o125, Object o126, Object o127, Object o128, Object o129, Object o130, Object o131, Object o132, Object o133, Object o134, Object o135, Object o136, Object o137, Object o138, Object o139, Object o140, Object o141, Object o142, Object o143, Object o144, Object o145, Object o146, Object o147, Object o148, Object o149, Object o150, Object o151, Object o152, Object o153, Object o154, Object o155, Object o156, Object o157, Object o158, Object o159, Object o160, Object o161, Object o162, Object o163, Object o164, Object o165, Object o166, Object o167, Object o168, Object o169) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80, o81, o82, o83, o84, o85, o86, o87, o88, o89, o90, o91, o92, o93, o94, o95, o96, o97, o98, o99, o100, o101, o102, o103, o104, o105, o106, o107, o108, o109, o110, o111, o112, o113, o114, o115, o116, o117, o118, o119, o120, o121, o122, o123, o124, o125, o126, o127, o128, o129, o130, o131, o132, o133, o134, o135, o136, o137, o138, o139, o140, o141, o142, o143, o144, o145, o146, o147, o148, o149, o150, o151, o152, o153, o154, o155, o156, o157, o158, o159, o160, o161, o162, o163, o164, o165, o166, o167, o168, o169); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80, Object o81, Object o82, Object o83, Object o84, Object o85, Object o86, Object o87, Object o88, Object o89, Object o90, Object o91, Object o92, Object o93, Object o94, Object o95, Object o96, Object o97, Object o98, Object o99, Object o100, Object o101, Object o102, Object o103, Object o104, Object o105, Object o106, Object o107, Object o108, Object o109, Object o110, Object o111, Object o112, Object o113, Object o114, Object o115, Object o116, Object o117, Object o118, Object o119, Object o120, Object o121, Object o122, Object o123, Object o124, Object o125, Object o126, Object o127, Object o128, Object o129, Object o130, Object o131, Object o132, Object o133, Object o134, Object o135, Object o136, Object o137, Object o138, Object o139, Object o140, Object o141, Object o142, Object o143, Object o144, Object o145, Object o146, Object o147, Object o148, Object o149, Object o150, Object o151, Object o152, Object o153, Object o154, Object o155, Object o156, Object o157, Object o158, Object o159, Object o160, Object o161, Object o162, Object o163, Object o164, Object o165, Object o166, Object o167, Object o168, Object o169, Object o170) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80, o81, o82, o83, o84, o85, o86, o87, o88, o89, o90, o91, o92, o93, o94, o95, o96, o97, o98, o99, o100, o101, o102, o103, o104, o105, o106, o107, o108, o109, o110, o111, o112, o113, o114, o115, o116, o117, o118, o119, o120, o121, o122, o123, o124, o125, o126, o127, o128, o129, o130, o131, o132, o133, o134, o135, o136, o137, o138, o139, o140, o141, o142, o143, o144, o145, o146, o147, o148, o149, o150, o151, o152, o153, o154, o155, o156, o157, o158, o159, o160, o161, o162, o163, o164, o165, o166, o167, o168, o169, o170); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80, Object o81, Object o82, Object o83, Object o84, Object o85, Object o86, Object o87, Object o88, Object o89, Object o90, Object o91, Object o92, Object o93, Object o94, Object o95, Object o96, Object o97, Object o98, Object o99, Object o100, Object o101, Object o102, Object o103, Object o104, Object o105, Object o106, Object o107, Object o108, Object o109, Object o110, Object o111, Object o112, Object o113, Object o114, Object o115, Object o116, Object o117, Object o118, Object o119, Object o120, Object o121, Object o122, Object o123, Object o124, Object o125, Object o126, Object o127, Object o128, Object o129, Object o130, Object o131, Object o132, Object o133, Object o134, Object o135, Object o136, Object o137, Object o138, Object o139, Object o140, Object o141, Object o142, Object o143, Object o144, Object o145, Object o146, Object o147, Object o148, Object o149, Object o150, Object o151, Object o152, Object o153, Object o154, Object o155, Object o156, Object o157, Object o158, Object o159, Object o160, Object o161, Object o162, Object o163, Object o164, Object o165, Object o166, Object o167, Object o168, Object o169, Object o170, Object o171) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80, o81, o82, o83, o84, o85, o86, o87, o88, o89, o90, o91, o92, o93, o94, o95, o96, o97, o98, o99, o100, o101, o102, o103, o104, o105, o106, o107, o108, o109, o110, o111, o112, o113, o114, o115, o116, o117, o118, o119, o120, o121, o122, o123, o124, o125, o126, o127, o128, o129, o130, o131, o132, o133, o134, o135, o136, o137, o138, o139, o140, o141, o142, o143, o144, o145, o146, o147, o148, o149, o150, o151, o152, o153, o154, o155, o156, o157, o158, o159, o160, o161, o162, o163, o164, o165, o166, o167, o168, o169, o170, o171); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80, Object o81, Object o82, Object o83, Object o84, Object o85, Object o86, Object o87, Object o88, Object o89, Object o90, Object o91, Object o92, Object o93, Object o94, Object o95, Object o96, Object o97, Object o98, Object o99, Object o100, Object o101, Object o102, Object o103, Object o104, Object o105, Object o106, Object o107, Object o108, Object o109, Object o110, Object o111, Object o112, Object o113, Object o114, Object o115, Object o116, Object o117, Object o118, Object o119, Object o120, Object o121, Object o122, Object o123, Object o124, Object o125, Object o126, Object o127, Object o128, Object o129, Object o130, Object o131, Object o132, Object o133, Object o134, Object o135, Object o136, Object o137, Object o138, Object o139, Object o140, Object o141, Object o142, Object o143, Object o144, Object o145, Object o146, Object o147, Object o148, Object o149, Object o150, Object o151, Object o152, Object o153, Object o154, Object o155, Object o156, Object o157, Object o158, Object o159, Object o160, Object o161, Object o162, Object o163, Object o164, Object o165, Object o166, Object o167, Object o168, Object o169, Object o170, Object o171, Object o172) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80, o81, o82, o83, o84, o85, o86, o87, o88, o89, o90, o91, o92, o93, o94, o95, o96, o97, o98, o99, o100, o101, o102, o103, o104, o105, o106, o107, o108, o109, o110, o111, o112, o113, o114, o115, o116, o117, o118, o119, o120, o121, o122, o123, o124, o125, o126, o127, o128, o129, o130, o131, o132, o133, o134, o135, o136, o137, o138, o139, o140, o141, o142, o143, o144, o145, o146, o147, o148, o149, o150, o151, o152, o153, o154, o155, o156, o157, o158, o159, o160, o161, o162, o163, o164, o165, o166, o167, o168, o169, o170, o171, o172); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80, Object o81, Object o82, Object o83, Object o84, Object o85, Object o86, Object o87, Object o88, Object o89, Object o90, Object o91, Object o92, Object o93, Object o94, Object o95, Object o96, Object o97, Object o98, Object o99, Object o100, Object o101, Object o102, Object o103, Object o104, Object o105, Object o106, Object o107, Object o108, Object o109, Object o110, Object o111, Object o112, Object o113, Object o114, Object o115, Object o116, Object o117, Object o118, Object o119, Object o120, Object o121, Object o122, Object o123, Object o124, Object o125, Object o126, Object o127, Object o128, Object o129, Object o130, Object o131, Object o132, Object o133, Object o134, Object o135, Object o136, Object o137, Object o138, Object o139, Object o140, Object o141, Object o142, Object o143, Object o144, Object o145, Object o146, Object o147, Object o148, Object o149, Object o150, Object o151, Object o152, Object o153, Object o154, Object o155, Object o156, Object o157, Object o158, Object o159, Object o160, Object o161, Object o162, Object o163, Object o164, Object o165, Object o166, Object o167, Object o168, Object o169, Object o170, Object o171, Object o172, Object o173) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80, o81, o82, o83, o84, o85, o86, o87, o88, o89, o90, o91, o92, o93, o94, o95, o96, o97, o98, o99, o100, o101, o102, o103, o104, o105, o106, o107, o108, o109, o110, o111, o112, o113, o114, o115, o116, o117, o118, o119, o120, o121, o122, o123, o124, o125, o126, o127, o128, o129, o130, o131, o132, o133, o134, o135, o136, o137, o138, o139, o140, o141, o142, o143, o144, o145, o146, o147, o148, o149, o150, o151, o152, o153, o154, o155, o156, o157, o158, o159, o160, o161, o162, o163, o164, o165, o166, o167, o168, o169, o170, o171, o172, o173); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80, Object o81, Object o82, Object o83, Object o84, Object o85, Object o86, Object o87, Object o88, Object o89, Object o90, Object o91, Object o92, Object o93, Object o94, Object o95, Object o96, Object o97, Object o98, Object o99, Object o100, Object o101, Object o102, Object o103, Object o104, Object o105, Object o106, Object o107, Object o108, Object o109, Object o110, Object o111, Object o112, Object o113, Object o114, Object o115, Object o116, Object o117, Object o118, Object o119, Object o120, Object o121, Object o122, Object o123, Object o124, Object o125, Object o126, Object o127, Object o128, Object o129, Object o130, Object o131, Object o132, Object o133, Object o134, Object o135, Object o136, Object o137, Object o138, Object o139, Object o140, Object o141, Object o142, Object o143, Object o144, Object o145, Object o146, Object o147, Object o148, Object o149, Object o150, Object o151, Object o152, Object o153, Object o154, Object o155, Object o156, Object o157, Object o158, Object o159, Object o160, Object o161, Object o162, Object o163, Object o164, Object o165, Object o166, Object o167, Object o168, Object o169, Object o170, Object o171, Object o172, Object o173, Object o174) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80, o81, o82, o83, o84, o85, o86, o87, o88, o89, o90, o91, o92, o93, o94, o95, o96, o97, o98, o99, o100, o101, o102, o103, o104, o105, o106, o107, o108, o109, o110, o111, o112, o113, o114, o115, o116, o117, o118, o119, o120, o121, o122, o123, o124, o125, o126, o127, o128, o129, o130, o131, o132, o133, o134, o135, o136, o137, o138, o139, o140, o141, o142, o143, o144, o145, o146, o147, o148, o149, o150, o151, o152, o153, o154, o155, o156, o157, o158, o159, o160, o161, o162, o163, o164, o165, o166, o167, o168, o169, o170, o171, o172, o173, o174); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80, Object o81, Object o82, Object o83, Object o84, Object o85, Object o86, Object o87, Object o88, Object o89, Object o90, Object o91, Object o92, Object o93, Object o94, Object o95, Object o96, Object o97, Object o98, Object o99, Object o100, Object o101, Object o102, Object o103, Object o104, Object o105, Object o106, Object o107, Object o108, Object o109, Object o110, Object o111, Object o112, Object o113, Object o114, Object o115, Object o116, Object o117, Object o118, Object o119, Object o120, Object o121, Object o122, Object o123, Object o124, Object o125, Object o126, Object o127, Object o128, Object o129, Object o130, Object o131, Object o132, Object o133, Object o134, Object o135, Object o136, Object o137, Object o138, Object o139, Object o140, Object o141, Object o142, Object o143, Object o144, Object o145, Object o146, Object o147, Object o148, Object o149, Object o150, Object o151, Object o152, Object o153, Object o154, Object o155, Object o156, Object o157, Object o158, Object o159, Object o160, Object o161, Object o162, Object o163, Object o164, Object o165, Object o166, Object o167, Object o168, Object o169, Object o170, Object o171, Object o172, Object o173, Object o174, Object o175) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80, o81, o82, o83, o84, o85, o86, o87, o88, o89, o90, o91, o92, o93, o94, o95, o96, o97, o98, o99, o100, o101, o102, o103, o104, o105, o106, o107, o108, o109, o110, o111, o112, o113, o114, o115, o116, o117, o118, o119, o120, o121, o122, o123, o124, o125, o126, o127, o128, o129, o130, o131, o132, o133, o134, o135, o136, o137, o138, o139, o140, o141, o142, o143, o144, o145, o146, o147, o148, o149, o150, o151, o152, o153, o154, o155, o156, o157, o158, o159, o160, o161, o162, o163, o164, o165, o166, o167, o168, o169, o170, o171, o172, o173, o174, o175); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80, Object o81, Object o82, Object o83, Object o84, Object o85, Object o86, Object o87, Object o88, Object o89, Object o90, Object o91, Object o92, Object o93, Object o94, Object o95, Object o96, Object o97, Object o98, Object o99, Object o100, Object o101, Object o102, Object o103, Object o104, Object o105, Object o106, Object o107, Object o108, Object o109, Object o110, Object o111, Object o112, Object o113, Object o114, Object o115, Object o116, Object o117, Object o118, Object o119, Object o120, Object o121, Object o122, Object o123, Object o124, Object o125, Object o126, Object o127, Object o128, Object o129, Object o130, Object o131, Object o132, Object o133, Object o134, Object o135, Object o136, Object o137, Object o138, Object o139, Object o140, Object o141, Object o142, Object o143, Object o144, Object o145, Object o146, Object o147, Object o148, Object o149, Object o150, Object o151, Object o152, Object o153, Object o154, Object o155, Object o156, Object o157, Object o158, Object o159, Object o160, Object o161, Object o162, Object o163, Object o164, Object o165, Object o166, Object o167, Object o168, Object o169, Object o170, Object o171, Object o172, Object o173, Object o174, Object o175, Object o176) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80, o81, o82, o83, o84, o85, o86, o87, o88, o89, o90, o91, o92, o93, o94, o95, o96, o97, o98, o99, o100, o101, o102, o103, o104, o105, o106, o107, o108, o109, o110, o111, o112, o113, o114, o115, o116, o117, o118, o119, o120, o121, o122, o123, o124, o125, o126, o127, o128, o129, o130, o131, o132, o133, o134, o135, o136, o137, o138, o139, o140, o141, o142, o143, o144, o145, o146, o147, o148, o149, o150, o151, o152, o153, o154, o155, o156, o157, o158, o159, o160, o161, o162, o163, o164, o165, o166, o167, o168, o169, o170, o171, o172, o173, o174, o175, o176); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80, Object o81, Object o82, Object o83, Object o84, Object o85, Object o86, Object o87, Object o88, Object o89, Object o90, Object o91, Object o92, Object o93, Object o94, Object o95, Object o96, Object o97, Object o98, Object o99, Object o100, Object o101, Object o102, Object o103, Object o104, Object o105, Object o106, Object o107, Object o108, Object o109, Object o110, Object o111, Object o112, Object o113, Object o114, Object o115, Object o116, Object o117, Object o118, Object o119, Object o120, Object o121, Object o122, Object o123, Object o124, Object o125, Object o126, Object o127, Object o128, Object o129, Object o130, Object o131, Object o132, Object o133, Object o134, Object o135, Object o136, Object o137, Object o138, Object o139, Object o140, Object o141, Object o142, Object o143, Object o144, Object o145, Object o146, Object o147, Object o148, Object o149, Object o150, Object o151, Object o152, Object o153, Object o154, Object o155, Object o156, Object o157, Object o158, Object o159, Object o160, Object o161, Object o162, Object o163, Object o164, Object o165, Object o166, Object o167, Object o168, Object o169, Object o170, Object o171, Object o172, Object o173, Object o174, Object o175, Object o176, Object o177) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80, o81, o82, o83, o84, o85, o86, o87, o88, o89, o90, o91, o92, o93, o94, o95, o96, o97, o98, o99, o100, o101, o102, o103, o104, o105, o106, o107, o108, o109, o110, o111, o112, o113, o114, o115, o116, o117, o118, o119, o120, o121, o122, o123, o124, o125, o126, o127, o128, o129, o130, o131, o132, o133, o134, o135, o136, o137, o138, o139, o140, o141, o142, o143, o144, o145, o146, o147, o148, o149, o150, o151, o152, o153, o154, o155, o156, o157, o158, o159, o160, o161, o162, o163, o164, o165, o166, o167, o168, o169, o170, o171, o172, o173, o174, o175, o176, o177); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80, Object o81, Object o82, Object o83, Object o84, Object o85, Object o86, Object o87, Object o88, Object o89, Object o90, Object o91, Object o92, Object o93, Object o94, Object o95, Object o96, Object o97, Object o98, Object o99, Object o100, Object o101, Object o102, Object o103, Object o104, Object o105, Object o106, Object o107, Object o108, Object o109, Object o110, Object o111, Object o112, Object o113, Object o114, Object o115, Object o116, Object o117, Object o118, Object o119, Object o120, Object o121, Object o122, Object o123, Object o124, Object o125, Object o126, Object o127, Object o128, Object o129, Object o130, Object o131, Object o132, Object o133, Object o134, Object o135, Object o136, Object o137, Object o138, Object o139, Object o140, Object o141, Object o142, Object o143, Object o144, Object o145, Object o146, Object o147, Object o148, Object o149, Object o150, Object o151, Object o152, Object o153, Object o154, Object o155, Object o156, Object o157, Object o158, Object o159, Object o160, Object o161, Object o162, Object o163, Object o164, Object o165, Object o166, Object o167, Object o168, Object o169, Object o170, Object o171, Object o172, Object o173, Object o174, Object o175, Object o176, Object o177, Object o178) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80, o81, o82, o83, o84, o85, o86, o87, o88, o89, o90, o91, o92, o93, o94, o95, o96, o97, o98, o99, o100, o101, o102, o103, o104, o105, o106, o107, o108, o109, o110, o111, o112, o113, o114, o115, o116, o117, o118, o119, o120, o121, o122, o123, o124, o125, o126, o127, o128, o129, o130, o131, o132, o133, o134, o135, o136, o137, o138, o139, o140, o141, o142, o143, o144, o145, o146, o147, o148, o149, o150, o151, o152, o153, o154, o155, o156, o157, o158, o159, o160, o161, o162, o163, o164, o165, o166, o167, o168, o169, o170, o171, o172, o173, o174, o175, o176, o177, o178); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80, Object o81, Object o82, Object o83, Object o84, Object o85, Object o86, Object o87, Object o88, Object o89, Object o90, Object o91, Object o92, Object o93, Object o94, Object o95, Object o96, Object o97, Object o98, Object o99, Object o100, Object o101, Object o102, Object o103, Object o104, Object o105, Object o106, Object o107, Object o108, Object o109, Object o110, Object o111, Object o112, Object o113, Object o114, Object o115, Object o116, Object o117, Object o118, Object o119, Object o120, Object o121, Object o122, Object o123, Object o124, Object o125, Object o126, Object o127, Object o128, Object o129, Object o130, Object o131, Object o132, Object o133, Object o134, Object o135, Object o136, Object o137, Object o138, Object o139, Object o140, Object o141, Object o142, Object o143, Object o144, Object o145, Object o146, Object o147, Object o148, Object o149, Object o150, Object o151, Object o152, Object o153, Object o154, Object o155, Object o156, Object o157, Object o158, Object o159, Object o160, Object o161, Object o162, Object o163, Object o164, Object o165, Object o166, Object o167, Object o168, Object o169, Object o170, Object o171, Object o172, Object o173, Object o174, Object o175, Object o176, Object o177, Object o178, Object o179) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80, o81, o82, o83, o84, o85, o86, o87, o88, o89, o90, o91, o92, o93, o94, o95, o96, o97, o98, o99, o100, o101, o102, o103, o104, o105, o106, o107, o108, o109, o110, o111, o112, o113, o114, o115, o116, o117, o118, o119, o120, o121, o122, o123, o124, o125, o126, o127, o128, o129, o130, o131, o132, o133, o134, o135, o136, o137, o138, o139, o140, o141, o142, o143, o144, o145, o146, o147, o148, o149, o150, o151, o152, o153, o154, o155, o156, o157, o158, o159, o160, o161, o162, o163, o164, o165, o166, o167, o168, o169, o170, o171, o172, o173, o174, o175, o176, o177, o178, o179); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80, Object o81, Object o82, Object o83, Object o84, Object o85, Object o86, Object o87, Object o88, Object o89, Object o90, Object o91, Object o92, Object o93, Object o94, Object o95, Object o96, Object o97, Object o98, Object o99, Object o100, Object o101, Object o102, Object o103, Object o104, Object o105, Object o106, Object o107, Object o108, Object o109, Object o110, Object o111, Object o112, Object o113, Object o114, Object o115, Object o116, Object o117, Object o118, Object o119, Object o120, Object o121, Object o122, Object o123, Object o124, Object o125, Object o126, Object o127, Object o128, Object o129, Object o130, Object o131, Object o132, Object o133, Object o134, Object o135, Object o136, Object o137, Object o138, Object o139, Object o140, Object o141, Object o142, Object o143, Object o144, Object o145, Object o146, Object o147, Object o148, Object o149, Object o150, Object o151, Object o152, Object o153, Object o154, Object o155, Object o156, Object o157, Object o158, Object o159, Object o160, Object o161, Object o162, Object o163, Object o164, Object o165, Object o166, Object o167, Object o168, Object o169, Object o170, Object o171, Object o172, Object o173, Object o174, Object o175, Object o176, Object o177, Object o178, Object o179, Object o180) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80, o81, o82, o83, o84, o85, o86, o87, o88, o89, o90, o91, o92, o93, o94, o95, o96, o97, o98, o99, o100, o101, o102, o103, o104, o105, o106, o107, o108, o109, o110, o111, o112, o113, o114, o115, o116, o117, o118, o119, o120, o121, o122, o123, o124, o125, o126, o127, o128, o129, o130, o131, o132, o133, o134, o135, o136, o137, o138, o139, o140, o141, o142, o143, o144, o145, o146, o147, o148, o149, o150, o151, o152, o153, o154, o155, o156, o157, o158, o159, o160, o161, o162, o163, o164, o165, o166, o167, o168, o169, o170, o171, o172, o173, o174, o175, o176, o177, o178, o179, o180); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80, Object o81, Object o82, Object o83, Object o84, Object o85, Object o86, Object o87, Object o88, Object o89, Object o90, Object o91, Object o92, Object o93, Object o94, Object o95, Object o96, Object o97, Object o98, Object o99, Object o100, Object o101, Object o102, Object o103, Object o104, Object o105, Object o106, Object o107, Object o108, Object o109, Object o110, Object o111, Object o112, Object o113, Object o114, Object o115, Object o116, Object o117, Object o118, Object o119, Object o120, Object o121, Object o122, Object o123, Object o124, Object o125, Object o126, Object o127, Object o128, Object o129, Object o130, Object o131, Object o132, Object o133, Object o134, Object o135, Object o136, Object o137, Object o138, Object o139, Object o140, Object o141, Object o142, Object o143, Object o144, Object o145, Object o146, Object o147, Object o148, Object o149, Object o150, Object o151, Object o152, Object o153, Object o154, Object o155, Object o156, Object o157, Object o158, Object o159, Object o160, Object o161, Object o162, Object o163, Object o164, Object o165, Object o166, Object o167, Object o168, Object o169, Object o170, Object o171, Object o172, Object o173, Object o174, Object o175, Object o176, Object o177, Object o178, Object o179, Object o180, Object o181) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80, o81, o82, o83, o84, o85, o86, o87, o88, o89, o90, o91, o92, o93, o94, o95, o96, o97, o98, o99, o100, o101, o102, o103, o104, o105, o106, o107, o108, o109, o110, o111, o112, o113, o114, o115, o116, o117, o118, o119, o120, o121, o122, o123, o124, o125, o126, o127, o128, o129, o130, o131, o132, o133, o134, o135, o136, o137, o138, o139, o140, o141, o142, o143, o144, o145, o146, o147, o148, o149, o150, o151, o152, o153, o154, o155, o156, o157, o158, o159, o160, o161, o162, o163, o164, o165, o166, o167, o168, o169, o170, o171, o172, o173, o174, o175, o176, o177, o178, o179, o180, o181); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80, Object o81, Object o82, Object o83, Object o84, Object o85, Object o86, Object o87, Object o88, Object o89, Object o90, Object o91, Object o92, Object o93, Object o94, Object o95, Object o96, Object o97, Object o98, Object o99, Object o100, Object o101, Object o102, Object o103, Object o104, Object o105, Object o106, Object o107, Object o108, Object o109, Object o110, Object o111, Object o112, Object o113, Object o114, Object o115, Object o116, Object o117, Object o118, Object o119, Object o120, Object o121, Object o122, Object o123, Object o124, Object o125, Object o126, Object o127, Object o128, Object o129, Object o130, Object o131, Object o132, Object o133, Object o134, Object o135, Object o136, Object o137, Object o138, Object o139, Object o140, Object o141, Object o142, Object o143, Object o144, Object o145, Object o146, Object o147, Object o148, Object o149, Object o150, Object o151, Object o152, Object o153, Object o154, Object o155, Object o156, Object o157, Object o158, Object o159, Object o160, Object o161, Object o162, Object o163, Object o164, Object o165, Object o166, Object o167, Object o168, Object o169, Object o170, Object o171, Object o172, Object o173, Object o174, Object o175, Object o176, Object o177, Object o178, Object o179, Object o180, Object o181, Object o182) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80, o81, o82, o83, o84, o85, o86, o87, o88, o89, o90, o91, o92, o93, o94, o95, o96, o97, o98, o99, o100, o101, o102, o103, o104, o105, o106, o107, o108, o109, o110, o111, o112, o113, o114, o115, o116, o117, o118, o119, o120, o121, o122, o123, o124, o125, o126, o127, o128, o129, o130, o131, o132, o133, o134, o135, o136, o137, o138, o139, o140, o141, o142, o143, o144, o145, o146, o147, o148, o149, o150, o151, o152, o153, o154, o155, o156, o157, o158, o159, o160, o161, o162, o163, o164, o165, o166, o167, o168, o169, o170, o171, o172, o173, o174, o175, o176, o177, o178, o179, o180, o181, o182); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80, Object o81, Object o82, Object o83, Object o84, Object o85, Object o86, Object o87, Object o88, Object o89, Object o90, Object o91, Object o92, Object o93, Object o94, Object o95, Object o96, Object o97, Object o98, Object o99, Object o100, Object o101, Object o102, Object o103, Object o104, Object o105, Object o106, Object o107, Object o108, Object o109, Object o110, Object o111, Object o112, Object o113, Object o114, Object o115, Object o116, Object o117, Object o118, Object o119, Object o120, Object o121, Object o122, Object o123, Object o124, Object o125, Object o126, Object o127, Object o128, Object o129, Object o130, Object o131, Object o132, Object o133, Object o134, Object o135, Object o136, Object o137, Object o138, Object o139, Object o140, Object o141, Object o142, Object o143, Object o144, Object o145, Object o146, Object o147, Object o148, Object o149, Object o150, Object o151, Object o152, Object o153, Object o154, Object o155, Object o156, Object o157, Object o158, Object o159, Object o160, Object o161, Object o162, Object o163, Object o164, Object o165, Object o166, Object o167, Object o168, Object o169, Object o170, Object o171, Object o172, Object o173, Object o174, Object o175, Object o176, Object o177, Object o178, Object o179, Object o180, Object o181, Object o182, Object o183) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80, o81, o82, o83, o84, o85, o86, o87, o88, o89, o90, o91, o92, o93, o94, o95, o96, o97, o98, o99, o100, o101, o102, o103, o104, o105, o106, o107, o108, o109, o110, o111, o112, o113, o114, o115, o116, o117, o118, o119, o120, o121, o122, o123, o124, o125, o126, o127, o128, o129, o130, o131, o132, o133, o134, o135, o136, o137, o138, o139, o140, o141, o142, o143, o144, o145, o146, o147, o148, o149, o150, o151, o152, o153, o154, o155, o156, o157, o158, o159, o160, o161, o162, o163, o164, o165, o166, o167, o168, o169, o170, o171, o172, o173, o174, o175, o176, o177, o178, o179, o180, o181, o182, o183); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80, Object o81, Object o82, Object o83, Object o84, Object o85, Object o86, Object o87, Object o88, Object o89, Object o90, Object o91, Object o92, Object o93, Object o94, Object o95, Object o96, Object o97, Object o98, Object o99, Object o100, Object o101, Object o102, Object o103, Object o104, Object o105, Object o106, Object o107, Object o108, Object o109, Object o110, Object o111, Object o112, Object o113, Object o114, Object o115, Object o116, Object o117, Object o118, Object o119, Object o120, Object o121, Object o122, Object o123, Object o124, Object o125, Object o126, Object o127, Object o128, Object o129, Object o130, Object o131, Object o132, Object o133, Object o134, Object o135, Object o136, Object o137, Object o138, Object o139, Object o140, Object o141, Object o142, Object o143, Object o144, Object o145, Object o146, Object o147, Object o148, Object o149, Object o150, Object o151, Object o152, Object o153, Object o154, Object o155, Object o156, Object o157, Object o158, Object o159, Object o160, Object o161, Object o162, Object o163, Object o164, Object o165, Object o166, Object o167, Object o168, Object o169, Object o170, Object o171, Object o172, Object o173, Object o174, Object o175, Object o176, Object o177, Object o178, Object o179, Object o180, Object o181, Object o182, Object o183, Object o184) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80, o81, o82, o83, o84, o85, o86, o87, o88, o89, o90, o91, o92, o93, o94, o95, o96, o97, o98, o99, o100, o101, o102, o103, o104, o105, o106, o107, o108, o109, o110, o111, o112, o113, o114, o115, o116, o117, o118, o119, o120, o121, o122, o123, o124, o125, o126, o127, o128, o129, o130, o131, o132, o133, o134, o135, o136, o137, o138, o139, o140, o141, o142, o143, o144, o145, o146, o147, o148, o149, o150, o151, o152, o153, o154, o155, o156, o157, o158, o159, o160, o161, o162, o163, o164, o165, o166, o167, o168, o169, o170, o171, o172, o173, o174, o175, o176, o177, o178, o179, o180, o181, o182, o183, o184); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80, Object o81, Object o82, Object o83, Object o84, Object o85, Object o86, Object o87, Object o88, Object o89, Object o90, Object o91, Object o92, Object o93, Object o94, Object o95, Object o96, Object o97, Object o98, Object o99, Object o100, Object o101, Object o102, Object o103, Object o104, Object o105, Object o106, Object o107, Object o108, Object o109, Object o110, Object o111, Object o112, Object o113, Object o114, Object o115, Object o116, Object o117, Object o118, Object o119, Object o120, Object o121, Object o122, Object o123, Object o124, Object o125, Object o126, Object o127, Object o128, Object o129, Object o130, Object o131, Object o132, Object o133, Object o134, Object o135, Object o136, Object o137, Object o138, Object o139, Object o140, Object o141, Object o142, Object o143, Object o144, Object o145, Object o146, Object o147, Object o148, Object o149, Object o150, Object o151, Object o152, Object o153, Object o154, Object o155, Object o156, Object o157, Object o158, Object o159, Object o160, Object o161, Object o162, Object o163, Object o164, Object o165, Object o166, Object o167, Object o168, Object o169, Object o170, Object o171, Object o172, Object o173, Object o174, Object o175, Object o176, Object o177, Object o178, Object o179, Object o180, Object o181, Object o182, Object o183, Object o184, Object o185) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80, o81, o82, o83, o84, o85, o86, o87, o88, o89, o90, o91, o92, o93, o94, o95, o96, o97, o98, o99, o100, o101, o102, o103, o104, o105, o106, o107, o108, o109, o110, o111, o112, o113, o114, o115, o116, o117, o118, o119, o120, o121, o122, o123, o124, o125, o126, o127, o128, o129, o130, o131, o132, o133, o134, o135, o136, o137, o138, o139, o140, o141, o142, o143, o144, o145, o146, o147, o148, o149, o150, o151, o152, o153, o154, o155, o156, o157, o158, o159, o160, o161, o162, o163, o164, o165, o166, o167, o168, o169, o170, o171, o172, o173, o174, o175, o176, o177, o178, o179, o180, o181, o182, o183, o184, o185); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80, Object o81, Object o82, Object o83, Object o84, Object o85, Object o86, Object o87, Object o88, Object o89, Object o90, Object o91, Object o92, Object o93, Object o94, Object o95, Object o96, Object o97, Object o98, Object o99, Object o100, Object o101, Object o102, Object o103, Object o104, Object o105, Object o106, Object o107, Object o108, Object o109, Object o110, Object o111, Object o112, Object o113, Object o114, Object o115, Object o116, Object o117, Object o118, Object o119, Object o120, Object o121, Object o122, Object o123, Object o124, Object o125, Object o126, Object o127, Object o128, Object o129, Object o130, Object o131, Object o132, Object o133, Object o134, Object o135, Object o136, Object o137, Object o138, Object o139, Object o140, Object o141, Object o142, Object o143, Object o144, Object o145, Object o146, Object o147, Object o148, Object o149, Object o150, Object o151, Object o152, Object o153, Object o154, Object o155, Object o156, Object o157, Object o158, Object o159, Object o160, Object o161, Object o162, Object o163, Object o164, Object o165, Object o166, Object o167, Object o168, Object o169, Object o170, Object o171, Object o172, Object o173, Object o174, Object o175, Object o176, Object o177, Object o178, Object o179, Object o180, Object o181, Object o182, Object o183, Object o184, Object o185, Object o186) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80, o81, o82, o83, o84, o85, o86, o87, o88, o89, o90, o91, o92, o93, o94, o95, o96, o97, o98, o99, o100, o101, o102, o103, o104, o105, o106, o107, o108, o109, o110, o111, o112, o113, o114, o115, o116, o117, o118, o119, o120, o121, o122, o123, o124, o125, o126, o127, o128, o129, o130, o131, o132, o133, o134, o135, o136, o137, o138, o139, o140, o141, o142, o143, o144, o145, o146, o147, o148, o149, o150, o151, o152, o153, o154, o155, o156, o157, o158, o159, o160, o161, o162, o163, o164, o165, o166, o167, o168, o169, o170, o171, o172, o173, o174, o175, o176, o177, o178, o179, o180, o181, o182, o183, o184, o185, o186); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80, Object o81, Object o82, Object o83, Object o84, Object o85, Object o86, Object o87, Object o88, Object o89, Object o90, Object o91, Object o92, Object o93, Object o94, Object o95, Object o96, Object o97, Object o98, Object o99, Object o100, Object o101, Object o102, Object o103, Object o104, Object o105, Object o106, Object o107, Object o108, Object o109, Object o110, Object o111, Object o112, Object o113, Object o114, Object o115, Object o116, Object o117, Object o118, Object o119, Object o120, Object o121, Object o122, Object o123, Object o124, Object o125, Object o126, Object o127, Object o128, Object o129, Object o130, Object o131, Object o132, Object o133, Object o134, Object o135, Object o136, Object o137, Object o138, Object o139, Object o140, Object o141, Object o142, Object o143, Object o144, Object o145, Object o146, Object o147, Object o148, Object o149, Object o150, Object o151, Object o152, Object o153, Object o154, Object o155, Object o156, Object o157, Object o158, Object o159, Object o160, Object o161, Object o162, Object o163, Object o164, Object o165, Object o166, Object o167, Object o168, Object o169, Object o170, Object o171, Object o172, Object o173, Object o174, Object o175, Object o176, Object o177, Object o178, Object o179, Object o180, Object o181, Object o182, Object o183, Object o184, Object o185, Object o186, Object o187) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80, o81, o82, o83, o84, o85, o86, o87, o88, o89, o90, o91, o92, o93, o94, o95, o96, o97, o98, o99, o100, o101, o102, o103, o104, o105, o106, o107, o108, o109, o110, o111, o112, o113, o114, o115, o116, o117, o118, o119, o120, o121, o122, o123, o124, o125, o126, o127, o128, o129, o130, o131, o132, o133, o134, o135, o136, o137, o138, o139, o140, o141, o142, o143, o144, o145, o146, o147, o148, o149, o150, o151, o152, o153, o154, o155, o156, o157, o158, o159, o160, o161, o162, o163, o164, o165, o166, o167, o168, o169, o170, o171, o172, o173, o174, o175, o176, o177, o178, o179, o180, o181, o182, o183, o184, o185, o186, o187); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80, Object o81, Object o82, Object o83, Object o84, Object o85, Object o86, Object o87, Object o88, Object o89, Object o90, Object o91, Object o92, Object o93, Object o94, Object o95, Object o96, Object o97, Object o98, Object o99, Object o100, Object o101, Object o102, Object o103, Object o104, Object o105, Object o106, Object o107, Object o108, Object o109, Object o110, Object o111, Object o112, Object o113, Object o114, Object o115, Object o116, Object o117, Object o118, Object o119, Object o120, Object o121, Object o122, Object o123, Object o124, Object o125, Object o126, Object o127, Object o128, Object o129, Object o130, Object o131, Object o132, Object o133, Object o134, Object o135, Object o136, Object o137, Object o138, Object o139, Object o140, Object o141, Object o142, Object o143, Object o144, Object o145, Object o146, Object o147, Object o148, Object o149, Object o150, Object o151, Object o152, Object o153, Object o154, Object o155, Object o156, Object o157, Object o158, Object o159, Object o160, Object o161, Object o162, Object o163, Object o164, Object o165, Object o166, Object o167, Object o168, Object o169, Object o170, Object o171, Object o172, Object o173, Object o174, Object o175, Object o176, Object o177, Object o178, Object o179, Object o180, Object o181, Object o182, Object o183, Object o184, Object o185, Object o186, Object o187, Object o188) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80, o81, o82, o83, o84, o85, o86, o87, o88, o89, o90, o91, o92, o93, o94, o95, o96, o97, o98, o99, o100, o101, o102, o103, o104, o105, o106, o107, o108, o109, o110, o111, o112, o113, o114, o115, o116, o117, o118, o119, o120, o121, o122, o123, o124, o125, o126, o127, o128, o129, o130, o131, o132, o133, o134, o135, o136, o137, o138, o139, o140, o141, o142, o143, o144, o145, o146, o147, o148, o149, o150, o151, o152, o153, o154, o155, o156, o157, o158, o159, o160, o161, o162, o163, o164, o165, o166, o167, o168, o169, o170, o171, o172, o173, o174, o175, o176, o177, o178, o179, o180, o181, o182, o183, o184, o185, o186, o187, o188); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80, Object o81, Object o82, Object o83, Object o84, Object o85, Object o86, Object o87, Object o88, Object o89, Object o90, Object o91, Object o92, Object o93, Object o94, Object o95, Object o96, Object o97, Object o98, Object o99, Object o100, Object o101, Object o102, Object o103, Object o104, Object o105, Object o106, Object o107, Object o108, Object o109, Object o110, Object o111, Object o112, Object o113, Object o114, Object o115, Object o116, Object o117, Object o118, Object o119, Object o120, Object o121, Object o122, Object o123, Object o124, Object o125, Object o126, Object o127, Object o128, Object o129, Object o130, Object o131, Object o132, Object o133, Object o134, Object o135, Object o136, Object o137, Object o138, Object o139, Object o140, Object o141, Object o142, Object o143, Object o144, Object o145, Object o146, Object o147, Object o148, Object o149, Object o150, Object o151, Object o152, Object o153, Object o154, Object o155, Object o156, Object o157, Object o158, Object o159, Object o160, Object o161, Object o162, Object o163, Object o164, Object o165, Object o166, Object o167, Object o168, Object o169, Object o170, Object o171, Object o172, Object o173, Object o174, Object o175, Object o176, Object o177, Object o178, Object o179, Object o180, Object o181, Object o182, Object o183, Object o184, Object o185, Object o186, Object o187, Object o188, Object o189) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80, o81, o82, o83, o84, o85, o86, o87, o88, o89, o90, o91, o92, o93, o94, o95, o96, o97, o98, o99, o100, o101, o102, o103, o104, o105, o106, o107, o108, o109, o110, o111, o112, o113, o114, o115, o116, o117, o118, o119, o120, o121, o122, o123, o124, o125, o126, o127, o128, o129, o130, o131, o132, o133, o134, o135, o136, o137, o138, o139, o140, o141, o142, o143, o144, o145, o146, o147, o148, o149, o150, o151, o152, o153, o154, o155, o156, o157, o158, o159, o160, o161, o162, o163, o164, o165, o166, o167, o168, o169, o170, o171, o172, o173, o174, o175, o176, o177, o178, o179, o180, o181, o182, o183, o184, o185, o186, o187, o188, o189); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80, Object o81, Object o82, Object o83, Object o84, Object o85, Object o86, Object o87, Object o88, Object o89, Object o90, Object o91, Object o92, Object o93, Object o94, Object o95, Object o96, Object o97, Object o98, Object o99, Object o100, Object o101, Object o102, Object o103, Object o104, Object o105, Object o106, Object o107, Object o108, Object o109, Object o110, Object o111, Object o112, Object o113, Object o114, Object o115, Object o116, Object o117, Object o118, Object o119, Object o120, Object o121, Object o122, Object o123, Object o124, Object o125, Object o126, Object o127, Object o128, Object o129, Object o130, Object o131, Object o132, Object o133, Object o134, Object o135, Object o136, Object o137, Object o138, Object o139, Object o140, Object o141, Object o142, Object o143, Object o144, Object o145, Object o146, Object o147, Object o148, Object o149, Object o150, Object o151, Object o152, Object o153, Object o154, Object o155, Object o156, Object o157, Object o158, Object o159, Object o160, Object o161, Object o162, Object o163, Object o164, Object o165, Object o166, Object o167, Object o168, Object o169, Object o170, Object o171, Object o172, Object o173, Object o174, Object o175, Object o176, Object o177, Object o178, Object o179, Object o180, Object o181, Object o182, Object o183, Object o184, Object o185, Object o186, Object o187, Object o188, Object o189, Object o190) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80, o81, o82, o83, o84, o85, o86, o87, o88, o89, o90, o91, o92, o93, o94, o95, o96, o97, o98, o99, o100, o101, o102, o103, o104, o105, o106, o107, o108, o109, o110, o111, o112, o113, o114, o115, o116, o117, o118, o119, o120, o121, o122, o123, o124, o125, o126, o127, o128, o129, o130, o131, o132, o133, o134, o135, o136, o137, o138, o139, o140, o141, o142, o143, o144, o145, o146, o147, o148, o149, o150, o151, o152, o153, o154, o155, o156, o157, o158, o159, o160, o161, o162, o163, o164, o165, o166, o167, o168, o169, o170, o171, o172, o173, o174, o175, o176, o177, o178, o179, o180, o181, o182, o183, o184, o185, o186, o187, o188, o189, o190); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80, Object o81, Object o82, Object o83, Object o84, Object o85, Object o86, Object o87, Object o88, Object o89, Object o90, Object o91, Object o92, Object o93, Object o94, Object o95, Object o96, Object o97, Object o98, Object o99, Object o100, Object o101, Object o102, Object o103, Object o104, Object o105, Object o106, Object o107, Object o108, Object o109, Object o110, Object o111, Object o112, Object o113, Object o114, Object o115, Object o116, Object o117, Object o118, Object o119, Object o120, Object o121, Object o122, Object o123, Object o124, Object o125, Object o126, Object o127, Object o128, Object o129, Object o130, Object o131, Object o132, Object o133, Object o134, Object o135, Object o136, Object o137, Object o138, Object o139, Object o140, Object o141, Object o142, Object o143, Object o144, Object o145, Object o146, Object o147, Object o148, Object o149, Object o150, Object o151, Object o152, Object o153, Object o154, Object o155, Object o156, Object o157, Object o158, Object o159, Object o160, Object o161, Object o162, Object o163, Object o164, Object o165, Object o166, Object o167, Object o168, Object o169, Object o170, Object o171, Object o172, Object o173, Object o174, Object o175, Object o176, Object o177, Object o178, Object o179, Object o180, Object o181, Object o182, Object o183, Object o184, Object o185, Object o186, Object o187, Object o188, Object o189, Object o190, Object o191) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80, o81, o82, o83, o84, o85, o86, o87, o88, o89, o90, o91, o92, o93, o94, o95, o96, o97, o98, o99, o100, o101, o102, o103, o104, o105, o106, o107, o108, o109, o110, o111, o112, o113, o114, o115, o116, o117, o118, o119, o120, o121, o122, o123, o124, o125, o126, o127, o128, o129, o130, o131, o132, o133, o134, o135, o136, o137, o138, o139, o140, o141, o142, o143, o144, o145, o146, o147, o148, o149, o150, o151, o152, o153, o154, o155, o156, o157, o158, o159, o160, o161, o162, o163, o164, o165, o166, o167, o168, o169, o170, o171, o172, o173, o174, o175, o176, o177, o178, o179, o180, o181, o182, o183, o184, o185, o186, o187, o188, o189, o190, o191); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80, Object o81, Object o82, Object o83, Object o84, Object o85, Object o86, Object o87, Object o88, Object o89, Object o90, Object o91, Object o92, Object o93, Object o94, Object o95, Object o96, Object o97, Object o98, Object o99, Object o100, Object o101, Object o102, Object o103, Object o104, Object o105, Object o106, Object o107, Object o108, Object o109, Object o110, Object o111, Object o112, Object o113, Object o114, Object o115, Object o116, Object o117, Object o118, Object o119, Object o120, Object o121, Object o122, Object o123, Object o124, Object o125, Object o126, Object o127, Object o128, Object o129, Object o130, Object o131, Object o132, Object o133, Object o134, Object o135, Object o136, Object o137, Object o138, Object o139, Object o140, Object o141, Object o142, Object o143, Object o144, Object o145, Object o146, Object o147, Object o148, Object o149, Object o150, Object o151, Object o152, Object o153, Object o154, Object o155, Object o156, Object o157, Object o158, Object o159, Object o160, Object o161, Object o162, Object o163, Object o164, Object o165, Object o166, Object o167, Object o168, Object o169, Object o170, Object o171, Object o172, Object o173, Object o174, Object o175, Object o176, Object o177, Object o178, Object o179, Object o180, Object o181, Object o182, Object o183, Object o184, Object o185, Object o186, Object o187, Object o188, Object o189, Object o190, Object o191, Object o192) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80, o81, o82, o83, o84, o85, o86, o87, o88, o89, o90, o91, o92, o93, o94, o95, o96, o97, o98, o99, o100, o101, o102, o103, o104, o105, o106, o107, o108, o109, o110, o111, o112, o113, o114, o115, o116, o117, o118, o119, o120, o121, o122, o123, o124, o125, o126, o127, o128, o129, o130, o131, o132, o133, o134, o135, o136, o137, o138, o139, o140, o141, o142, o143, o144, o145, o146, o147, o148, o149, o150, o151, o152, o153, o154, o155, o156, o157, o158, o159, o160, o161, o162, o163, o164, o165, o166, o167, o168, o169, o170, o171, o172, o173, o174, o175, o176, o177, o178, o179, o180, o181, o182, o183, o184, o185, o186, o187, o188, o189, o190, o191, o192); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80, Object o81, Object o82, Object o83, Object o84, Object o85, Object o86, Object o87, Object o88, Object o89, Object o90, Object o91, Object o92, Object o93, Object o94, Object o95, Object o96, Object o97, Object o98, Object o99, Object o100, Object o101, Object o102, Object o103, Object o104, Object o105, Object o106, Object o107, Object o108, Object o109, Object o110, Object o111, Object o112, Object o113, Object o114, Object o115, Object o116, Object o117, Object o118, Object o119, Object o120, Object o121, Object o122, Object o123, Object o124, Object o125, Object o126, Object o127, Object o128, Object o129, Object o130, Object o131, Object o132, Object o133, Object o134, Object o135, Object o136, Object o137, Object o138, Object o139, Object o140, Object o141, Object o142, Object o143, Object o144, Object o145, Object o146, Object o147, Object o148, Object o149, Object o150, Object o151, Object o152, Object o153, Object o154, Object o155, Object o156, Object o157, Object o158, Object o159, Object o160, Object o161, Object o162, Object o163, Object o164, Object o165, Object o166, Object o167, Object o168, Object o169, Object o170, Object o171, Object o172, Object o173, Object o174, Object o175, Object o176, Object o177, Object o178, Object o179, Object o180, Object o181, Object o182, Object o183, Object o184, Object o185, Object o186, Object o187, Object o188, Object o189, Object o190, Object o191, Object o192, Object o193) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80, o81, o82, o83, o84, o85, o86, o87, o88, o89, o90, o91, o92, o93, o94, o95, o96, o97, o98, o99, o100, o101, o102, o103, o104, o105, o106, o107, o108, o109, o110, o111, o112, o113, o114, o115, o116, o117, o118, o119, o120, o121, o122, o123, o124, o125, o126, o127, o128, o129, o130, o131, o132, o133, o134, o135, o136, o137, o138, o139, o140, o141, o142, o143, o144, o145, o146, o147, o148, o149, o150, o151, o152, o153, o154, o155, o156, o157, o158, o159, o160, o161, o162, o163, o164, o165, o166, o167, o168, o169, o170, o171, o172, o173, o174, o175, o176, o177, o178, o179, o180, o181, o182, o183, o184, o185, o186, o187, o188, o189, o190, o191, o192, o193); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80, Object o81, Object o82, Object o83, Object o84, Object o85, Object o86, Object o87, Object o88, Object o89, Object o90, Object o91, Object o92, Object o93, Object o94, Object o95, Object o96, Object o97, Object o98, Object o99, Object o100, Object o101, Object o102, Object o103, Object o104, Object o105, Object o106, Object o107, Object o108, Object o109, Object o110, Object o111, Object o112, Object o113, Object o114, Object o115, Object o116, Object o117, Object o118, Object o119, Object o120, Object o121, Object o122, Object o123, Object o124, Object o125, Object o126, Object o127, Object o128, Object o129, Object o130, Object o131, Object o132, Object o133, Object o134, Object o135, Object o136, Object o137, Object o138, Object o139, Object o140, Object o141, Object o142, Object o143, Object o144, Object o145, Object o146, Object o147, Object o148, Object o149, Object o150, Object o151, Object o152, Object o153, Object o154, Object o155, Object o156, Object o157, Object o158, Object o159, Object o160, Object o161, Object o162, Object o163, Object o164, Object o165, Object o166, Object o167, Object o168, Object o169, Object o170, Object o171, Object o172, Object o173, Object o174, Object o175, Object o176, Object o177, Object o178, Object o179, Object o180, Object o181, Object o182, Object o183, Object o184, Object o185, Object o186, Object o187, Object o188, Object o189, Object o190, Object o191, Object o192, Object o193, Object o194) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80, o81, o82, o83, o84, o85, o86, o87, o88, o89, o90, o91, o92, o93, o94, o95, o96, o97, o98, o99, o100, o101, o102, o103, o104, o105, o106, o107, o108, o109, o110, o111, o112, o113, o114, o115, o116, o117, o118, o119, o120, o121, o122, o123, o124, o125, o126, o127, o128, o129, o130, o131, o132, o133, o134, o135, o136, o137, o138, o139, o140, o141, o142, o143, o144, o145, o146, o147, o148, o149, o150, o151, o152, o153, o154, o155, o156, o157, o158, o159, o160, o161, o162, o163, o164, o165, o166, o167, o168, o169, o170, o171, o172, o173, o174, o175, o176, o177, o178, o179, o180, o181, o182, o183, o184, o185, o186, o187, o188, o189, o190, o191, o192, o193, o194); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80, Object o81, Object o82, Object o83, Object o84, Object o85, Object o86, Object o87, Object o88, Object o89, Object o90, Object o91, Object o92, Object o93, Object o94, Object o95, Object o96, Object o97, Object o98, Object o99, Object o100, Object o101, Object o102, Object o103, Object o104, Object o105, Object o106, Object o107, Object o108, Object o109, Object o110, Object o111, Object o112, Object o113, Object o114, Object o115, Object o116, Object o117, Object o118, Object o119, Object o120, Object o121, Object o122, Object o123, Object o124, Object o125, Object o126, Object o127, Object o128, Object o129, Object o130, Object o131, Object o132, Object o133, Object o134, Object o135, Object o136, Object o137, Object o138, Object o139, Object o140, Object o141, Object o142, Object o143, Object o144, Object o145, Object o146, Object o147, Object o148, Object o149, Object o150, Object o151, Object o152, Object o153, Object o154, Object o155, Object o156, Object o157, Object o158, Object o159, Object o160, Object o161, Object o162, Object o163, Object o164, Object o165, Object o166, Object o167, Object o168, Object o169, Object o170, Object o171, Object o172, Object o173, Object o174, Object o175, Object o176, Object o177, Object o178, Object o179, Object o180, Object o181, Object o182, Object o183, Object o184, Object o185, Object o186, Object o187, Object o188, Object o189, Object o190, Object o191, Object o192, Object o193, Object o194, Object o195) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80, o81, o82, o83, o84, o85, o86, o87, o88, o89, o90, o91, o92, o93, o94, o95, o96, o97, o98, o99, o100, o101, o102, o103, o104, o105, o106, o107, o108, o109, o110, o111, o112, o113, o114, o115, o116, o117, o118, o119, o120, o121, o122, o123, o124, o125, o126, o127, o128, o129, o130, o131, o132, o133, o134, o135, o136, o137, o138, o139, o140, o141, o142, o143, o144, o145, o146, o147, o148, o149, o150, o151, o152, o153, o154, o155, o156, o157, o158, o159, o160, o161, o162, o163, o164, o165, o166, o167, o168, o169, o170, o171, o172, o173, o174, o175, o176, o177, o178, o179, o180, o181, o182, o183, o184, o185, o186, o187, o188, o189, o190, o191, o192, o193, o194, o195); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80, Object o81, Object o82, Object o83, Object o84, Object o85, Object o86, Object o87, Object o88, Object o89, Object o90, Object o91, Object o92, Object o93, Object o94, Object o95, Object o96, Object o97, Object o98, Object o99, Object o100, Object o101, Object o102, Object o103, Object o104, Object o105, Object o106, Object o107, Object o108, Object o109, Object o110, Object o111, Object o112, Object o113, Object o114, Object o115, Object o116, Object o117, Object o118, Object o119, Object o120, Object o121, Object o122, Object o123, Object o124, Object o125, Object o126, Object o127, Object o128, Object o129, Object o130, Object o131, Object o132, Object o133, Object o134, Object o135, Object o136, Object o137, Object o138, Object o139, Object o140, Object o141, Object o142, Object o143, Object o144, Object o145, Object o146, Object o147, Object o148, Object o149, Object o150, Object o151, Object o152, Object o153, Object o154, Object o155, Object o156, Object o157, Object o158, Object o159, Object o160, Object o161, Object o162, Object o163, Object o164, Object o165, Object o166, Object o167, Object o168, Object o169, Object o170, Object o171, Object o172, Object o173, Object o174, Object o175, Object o176, Object o177, Object o178, Object o179, Object o180, Object o181, Object o182, Object o183, Object o184, Object o185, Object o186, Object o187, Object o188, Object o189, Object o190, Object o191, Object o192, Object o193, Object o194, Object o195, Object o196) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80, o81, o82, o83, o84, o85, o86, o87, o88, o89, o90, o91, o92, o93, o94, o95, o96, o97, o98, o99, o100, o101, o102, o103, o104, o105, o106, o107, o108, o109, o110, o111, o112, o113, o114, o115, o116, o117, o118, o119, o120, o121, o122, o123, o124, o125, o126, o127, o128, o129, o130, o131, o132, o133, o134, o135, o136, o137, o138, o139, o140, o141, o142, o143, o144, o145, o146, o147, o148, o149, o150, o151, o152, o153, o154, o155, o156, o157, o158, o159, o160, o161, o162, o163, o164, o165, o166, o167, o168, o169, o170, o171, o172, o173, o174, o175, o176, o177, o178, o179, o180, o181, o182, o183, o184, o185, o186, o187, o188, o189, o190, o191, o192, o193, o194, o195, o196); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80, Object o81, Object o82, Object o83, Object o84, Object o85, Object o86, Object o87, Object o88, Object o89, Object o90, Object o91, Object o92, Object o93, Object o94, Object o95, Object o96, Object o97, Object o98, Object o99, Object o100, Object o101, Object o102, Object o103, Object o104, Object o105, Object o106, Object o107, Object o108, Object o109, Object o110, Object o111, Object o112, Object o113, Object o114, Object o115, Object o116, Object o117, Object o118, Object o119, Object o120, Object o121, Object o122, Object o123, Object o124, Object o125, Object o126, Object o127, Object o128, Object o129, Object o130, Object o131, Object o132, Object o133, Object o134, Object o135, Object o136, Object o137, Object o138, Object o139, Object o140, Object o141, Object o142, Object o143, Object o144, Object o145, Object o146, Object o147, Object o148, Object o149, Object o150, Object o151, Object o152, Object o153, Object o154, Object o155, Object o156, Object o157, Object o158, Object o159, Object o160, Object o161, Object o162, Object o163, Object o164, Object o165, Object o166, Object o167, Object o168, Object o169, Object o170, Object o171, Object o172, Object o173, Object o174, Object o175, Object o176, Object o177, Object o178, Object o179, Object o180, Object o181, Object o182, Object o183, Object o184, Object o185, Object o186, Object o187, Object o188, Object o189, Object o190, Object o191, Object o192, Object o193, Object o194, Object o195, Object o196, Object o197) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80, o81, o82, o83, o84, o85, o86, o87, o88, o89, o90, o91, o92, o93, o94, o95, o96, o97, o98, o99, o100, o101, o102, o103, o104, o105, o106, o107, o108, o109, o110, o111, o112, o113, o114, o115, o116, o117, o118, o119, o120, o121, o122, o123, o124, o125, o126, o127, o128, o129, o130, o131, o132, o133, o134, o135, o136, o137, o138, o139, o140, o141, o142, o143, o144, o145, o146, o147, o148, o149, o150, o151, o152, o153, o154, o155, o156, o157, o158, o159, o160, o161, o162, o163, o164, o165, o166, o167, o168, o169, o170, o171, o172, o173, o174, o175, o176, o177, o178, o179, o180, o181, o182, o183, o184, o185, o186, o187, o188, o189, o190, o191, o192, o193, o194, o195, o196, o197); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80, Object o81, Object o82, Object o83, Object o84, Object o85, Object o86, Object o87, Object o88, Object o89, Object o90, Object o91, Object o92, Object o93, Object o94, Object o95, Object o96, Object o97, Object o98, Object o99, Object o100, Object o101, Object o102, Object o103, Object o104, Object o105, Object o106, Object o107, Object o108, Object o109, Object o110, Object o111, Object o112, Object o113, Object o114, Object o115, Object o116, Object o117, Object o118, Object o119, Object o120, Object o121, Object o122, Object o123, Object o124, Object o125, Object o126, Object o127, Object o128, Object o129, Object o130, Object o131, Object o132, Object o133, Object o134, Object o135, Object o136, Object o137, Object o138, Object o139, Object o140, Object o141, Object o142, Object o143, Object o144, Object o145, Object o146, Object o147, Object o148, Object o149, Object o150, Object o151, Object o152, Object o153, Object o154, Object o155, Object o156, Object o157, Object o158, Object o159, Object o160, Object o161, Object o162, Object o163, Object o164, Object o165, Object o166, Object o167, Object o168, Object o169, Object o170, Object o171, Object o172, Object o173, Object o174, Object o175, Object o176, Object o177, Object o178, Object o179, Object o180, Object o181, Object o182, Object o183, Object o184, Object o185, Object o186, Object o187, Object o188, Object o189, Object o190, Object o191, Object o192, Object o193, Object o194, Object o195, Object o196, Object o197, Object o198) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80, o81, o82, o83, o84, o85, o86, o87, o88, o89, o90, o91, o92, o93, o94, o95, o96, o97, o98, o99, o100, o101, o102, o103, o104, o105, o106, o107, o108, o109, o110, o111, o112, o113, o114, o115, o116, o117, o118, o119, o120, o121, o122, o123, o124, o125, o126, o127, o128, o129, o130, o131, o132, o133, o134, o135, o136, o137, o138, o139, o140, o141, o142, o143, o144, o145, o146, o147, o148, o149, o150, o151, o152, o153, o154, o155, o156, o157, o158, o159, o160, o161, o162, o163, o164, o165, o166, o167, o168, o169, o170, o171, o172, o173, o174, o175, o176, o177, o178, o179, o180, o181, o182, o183, o184, o185, o186, o187, o188, o189, o190, o191, o192, o193, o194, o195, o196, o197, o198); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80, Object o81, Object o82, Object o83, Object o84, Object o85, Object o86, Object o87, Object o88, Object o89, Object o90, Object o91, Object o92, Object o93, Object o94, Object o95, Object o96, Object o97, Object o98, Object o99, Object o100, Object o101, Object o102, Object o103, Object o104, Object o105, Object o106, Object o107, Object o108, Object o109, Object o110, Object o111, Object o112, Object o113, Object o114, Object o115, Object o116, Object o117, Object o118, Object o119, Object o120, Object o121, Object o122, Object o123, Object o124, Object o125, Object o126, Object o127, Object o128, Object o129, Object o130, Object o131, Object o132, Object o133, Object o134, Object o135, Object o136, Object o137, Object o138, Object o139, Object o140, Object o141, Object o142, Object o143, Object o144, Object o145, Object o146, Object o147, Object o148, Object o149, Object o150, Object o151, Object o152, Object o153, Object o154, Object o155, Object o156, Object o157, Object o158, Object o159, Object o160, Object o161, Object o162, Object o163, Object o164, Object o165, Object o166, Object o167, Object o168, Object o169, Object o170, Object o171, Object o172, Object o173, Object o174, Object o175, Object o176, Object o177, Object o178, Object o179, Object o180, Object o181, Object o182, Object o183, Object o184, Object o185, Object o186, Object o187, Object o188, Object o189, Object o190, Object o191, Object o192, Object o193, Object o194, Object o195, Object o196, Object o197, Object o198, Object o199) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80, o81, o82, o83, o84, o85, o86, o87, o88, o89, o90, o91, o92, o93, o94, o95, o96, o97, o98, o99, o100, o101, o102, o103, o104, o105, o106, o107, o108, o109, o110, o111, o112, o113, o114, o115, o116, o117, o118, o119, o120, o121, o122, o123, o124, o125, o126, o127, o128, o129, o130, o131, o132, o133, o134, o135, o136, o137, o138, o139, o140, o141, o142, o143, o144, o145, o146, o147, o148, o149, o150, o151, o152, o153, o154, o155, o156, o157, o158, o159, o160, o161, o162, o163, o164, o165, o166, o167, o168, o169, o170, o171, o172, o173, o174, o175, o176, o177, o178, o179, o180, o181, o182, o183, o184, o185, o186, o187, o188, o189, o190, o191, o192, o193, o194, o195, o196, o197, o198, o199); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80, Object o81, Object o82, Object o83, Object o84, Object o85, Object o86, Object o87, Object o88, Object o89, Object o90, Object o91, Object o92, Object o93, Object o94, Object o95, Object o96, Object o97, Object o98, Object o99, Object o100, Object o101, Object o102, Object o103, Object o104, Object o105, Object o106, Object o107, Object o108, Object o109, Object o110, Object o111, Object o112, Object o113, Object o114, Object o115, Object o116, Object o117, Object o118, Object o119, Object o120, Object o121, Object o122, Object o123, Object o124, Object o125, Object o126, Object o127, Object o128, Object o129, Object o130, Object o131, Object o132, Object o133, Object o134, Object o135, Object o136, Object o137, Object o138, Object o139, Object o140, Object o141, Object o142, Object o143, Object o144, Object o145, Object o146, Object o147, Object o148, Object o149, Object o150, Object o151, Object o152, Object o153, Object o154, Object o155, Object o156, Object o157, Object o158, Object o159, Object o160, Object o161, Object o162, Object o163, Object o164, Object o165, Object o166, Object o167, Object o168, Object o169, Object o170, Object o171, Object o172, Object o173, Object o174, Object o175, Object o176, Object o177, Object o178, Object o179, Object o180, Object o181, Object o182, Object o183, Object o184, Object o185, Object o186, Object o187, Object o188, Object o189, Object o190, Object o191, Object o192, Object o193, Object o194, Object o195, Object o196, Object o197, Object o198, Object o199, Object o200) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80, o81, o82, o83, o84, o85, o86, o87, o88, o89, o90, o91, o92, o93, o94, o95, o96, o97, o98, o99, o100, o101, o102, o103, o104, o105, o106, o107, o108, o109, o110, o111, o112, o113, o114, o115, o116, o117, o118, o119, o120, o121, o122, o123, o124, o125, o126, o127, o128, o129, o130, o131, o132, o133, o134, o135, o136, o137, o138, o139, o140, o141, o142, o143, o144, o145, o146, o147, o148, o149, o150, o151, o152, o153, o154, o155, o156, o157, o158, o159, o160, o161, o162, o163, o164, o165, o166, o167, o168, o169, o170, o171, o172, o173, o174, o175, o176, o177, o178, o179, o180, o181, o182, o183, o184, o185, o186, o187, o188, o189, o190, o191, o192, o193, o194, o195, o196, o197, o198, o199, o200); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80, Object o81, Object o82, Object o83, Object o84, Object o85, Object o86, Object o87, Object o88, Object o89, Object o90, Object o91, Object o92, Object o93, Object o94, Object o95, Object o96, Object o97, Object o98, Object o99, Object o100, Object o101, Object o102, Object o103, Object o104, Object o105, Object o106, Object o107, Object o108, Object o109, Object o110, Object o111, Object o112, Object o113, Object o114, Object o115, Object o116, Object o117, Object o118, Object o119, Object o120, Object o121, Object o122, Object o123, Object o124, Object o125, Object o126, Object o127, Object o128, Object o129, Object o130, Object o131, Object o132, Object o133, Object o134, Object o135, Object o136, Object o137, Object o138, Object o139, Object o140, Object o141, Object o142, Object o143, Object o144, Object o145, Object o146, Object o147, Object o148, Object o149, Object o150, Object o151, Object o152, Object o153, Object o154, Object o155, Object o156, Object o157, Object o158, Object o159, Object o160, Object o161, Object o162, Object o163, Object o164, Object o165, Object o166, Object o167, Object o168, Object o169, Object o170, Object o171, Object o172, Object o173, Object o174, Object o175, Object o176, Object o177, Object o178, Object o179, Object o180, Object o181, Object o182, Object o183, Object o184, Object o185, Object o186, Object o187, Object o188, Object o189, Object o190, Object o191, Object o192, Object o193, Object o194, Object o195, Object o196, Object o197, Object o198, Object o199, Object o200, Object o201) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80, o81, o82, o83, o84, o85, o86, o87, o88, o89, o90, o91, o92, o93, o94, o95, o96, o97, o98, o99, o100, o101, o102, o103, o104, o105, o106, o107, o108, o109, o110, o111, o112, o113, o114, o115, o116, o117, o118, o119, o120, o121, o122, o123, o124, o125, o126, o127, o128, o129, o130, o131, o132, o133, o134, o135, o136, o137, o138, o139, o140, o141, o142, o143, o144, o145, o146, o147, o148, o149, o150, o151, o152, o153, o154, o155, o156, o157, o158, o159, o160, o161, o162, o163, o164, o165, o166, o167, o168, o169, o170, o171, o172, o173, o174, o175, o176, o177, o178, o179, o180, o181, o182, o183, o184, o185, o186, o187, o188, o189, o190, o191, o192, o193, o194, o195, o196, o197, o198, o199, o200, o201); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80, Object o81, Object o82, Object o83, Object o84, Object o85, Object o86, Object o87, Object o88, Object o89, Object o90, Object o91, Object o92, Object o93, Object o94, Object o95, Object o96, Object o97, Object o98, Object o99, Object o100, Object o101, Object o102, Object o103, Object o104, Object o105, Object o106, Object o107, Object o108, Object o109, Object o110, Object o111, Object o112, Object o113, Object o114, Object o115, Object o116, Object o117, Object o118, Object o119, Object o120, Object o121, Object o122, Object o123, Object o124, Object o125, Object o126, Object o127, Object o128, Object o129, Object o130, Object o131, Object o132, Object o133, Object o134, Object o135, Object o136, Object o137, Object o138, Object o139, Object o140, Object o141, Object o142, Object o143, Object o144, Object o145, Object o146, Object o147, Object o148, Object o149, Object o150, Object o151, Object o152, Object o153, Object o154, Object o155, Object o156, Object o157, Object o158, Object o159, Object o160, Object o161, Object o162, Object o163, Object o164, Object o165, Object o166, Object o167, Object o168, Object o169, Object o170, Object o171, Object o172, Object o173, Object o174, Object o175, Object o176, Object o177, Object o178, Object o179, Object o180, Object o181, Object o182, Object o183, Object o184, Object o185, Object o186, Object o187, Object o188, Object o189, Object o190, Object o191, Object o192, Object o193, Object o194, Object o195, Object o196, Object o197, Object o198, Object o199, Object o200, Object o201, Object o202) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80, o81, o82, o83, o84, o85, o86, o87, o88, o89, o90, o91, o92, o93, o94, o95, o96, o97, o98, o99, o100, o101, o102, o103, o104, o105, o106, o107, o108, o109, o110, o111, o112, o113, o114, o115, o116, o117, o118, o119, o120, o121, o122, o123, o124, o125, o126, o127, o128, o129, o130, o131, o132, o133, o134, o135, o136, o137, o138, o139, o140, o141, o142, o143, o144, o145, o146, o147, o148, o149, o150, o151, o152, o153, o154, o155, o156, o157, o158, o159, o160, o161, o162, o163, o164, o165, o166, o167, o168, o169, o170, o171, o172, o173, o174, o175, o176, o177, o178, o179, o180, o181, o182, o183, o184, o185, o186, o187, o188, o189, o190, o191, o192, o193, o194, o195, o196, o197, o198, o199, o200, o201, o202); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80, Object o81, Object o82, Object o83, Object o84, Object o85, Object o86, Object o87, Object o88, Object o89, Object o90, Object o91, Object o92, Object o93, Object o94, Object o95, Object o96, Object o97, Object o98, Object o99, Object o100, Object o101, Object o102, Object o103, Object o104, Object o105, Object o106, Object o107, Object o108, Object o109, Object o110, Object o111, Object o112, Object o113, Object o114, Object o115, Object o116, Object o117, Object o118, Object o119, Object o120, Object o121, Object o122, Object o123, Object o124, Object o125, Object o126, Object o127, Object o128, Object o129, Object o130, Object o131, Object o132, Object o133, Object o134, Object o135, Object o136, Object o137, Object o138, Object o139, Object o140, Object o141, Object o142, Object o143, Object o144, Object o145, Object o146, Object o147, Object o148, Object o149, Object o150, Object o151, Object o152, Object o153, Object o154, Object o155, Object o156, Object o157, Object o158, Object o159, Object o160, Object o161, Object o162, Object o163, Object o164, Object o165, Object o166, Object o167, Object o168, Object o169, Object o170, Object o171, Object o172, Object o173, Object o174, Object o175, Object o176, Object o177, Object o178, Object o179, Object o180, Object o181, Object o182, Object o183, Object o184, Object o185, Object o186, Object o187, Object o188, Object o189, Object o190, Object o191, Object o192, Object o193, Object o194, Object o195, Object o196, Object o197, Object o198, Object o199, Object o200, Object o201, Object o202, Object o203) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80, o81, o82, o83, o84, o85, o86, o87, o88, o89, o90, o91, o92, o93, o94, o95, o96, o97, o98, o99, o100, o101, o102, o103, o104, o105, o106, o107, o108, o109, o110, o111, o112, o113, o114, o115, o116, o117, o118, o119, o120, o121, o122, o123, o124, o125, o126, o127, o128, o129, o130, o131, o132, o133, o134, o135, o136, o137, o138, o139, o140, o141, o142, o143, o144, o145, o146, o147, o148, o149, o150, o151, o152, o153, o154, o155, o156, o157, o158, o159, o160, o161, o162, o163, o164, o165, o166, o167, o168, o169, o170, o171, o172, o173, o174, o175, o176, o177, o178, o179, o180, o181, o182, o183, o184, o185, o186, o187, o188, o189, o190, o191, o192, o193, o194, o195, o196, o197, o198, o199, o200, o201, o202, o203); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80, Object o81, Object o82, Object o83, Object o84, Object o85, Object o86, Object o87, Object o88, Object o89, Object o90, Object o91, Object o92, Object o93, Object o94, Object o95, Object o96, Object o97, Object o98, Object o99, Object o100, Object o101, Object o102, Object o103, Object o104, Object o105, Object o106, Object o107, Object o108, Object o109, Object o110, Object o111, Object o112, Object o113, Object o114, Object o115, Object o116, Object o117, Object o118, Object o119, Object o120, Object o121, Object o122, Object o123, Object o124, Object o125, Object o126, Object o127, Object o128, Object o129, Object o130, Object o131, Object o132, Object o133, Object o134, Object o135, Object o136, Object o137, Object o138, Object o139, Object o140, Object o141, Object o142, Object o143, Object o144, Object o145, Object o146, Object o147, Object o148, Object o149, Object o150, Object o151, Object o152, Object o153, Object o154, Object o155, Object o156, Object o157, Object o158, Object o159, Object o160, Object o161, Object o162, Object o163, Object o164, Object o165, Object o166, Object o167, Object o168, Object o169, Object o170, Object o171, Object o172, Object o173, Object o174, Object o175, Object o176, Object o177, Object o178, Object o179, Object o180, Object o181, Object o182, Object o183, Object o184, Object o185, Object o186, Object o187, Object o188, Object o189, Object o190, Object o191, Object o192, Object o193, Object o194, Object o195, Object o196, Object o197, Object o198, Object o199, Object o200, Object o201, Object o202, Object o203, Object o204) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80, o81, o82, o83, o84, o85, o86, o87, o88, o89, o90, o91, o92, o93, o94, o95, o96, o97, o98, o99, o100, o101, o102, o103, o104, o105, o106, o107, o108, o109, o110, o111, o112, o113, o114, o115, o116, o117, o118, o119, o120, o121, o122, o123, o124, o125, o126, o127, o128, o129, o130, o131, o132, o133, o134, o135, o136, o137, o138, o139, o140, o141, o142, o143, o144, o145, o146, o147, o148, o149, o150, o151, o152, o153, o154, o155, o156, o157, o158, o159, o160, o161, o162, o163, o164, o165, o166, o167, o168, o169, o170, o171, o172, o173, o174, o175, o176, o177, o178, o179, o180, o181, o182, o183, o184, o185, o186, o187, o188, o189, o190, o191, o192, o193, o194, o195, o196, o197, o198, o199, o200, o201, o202, o203, o204); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80, Object o81, Object o82, Object o83, Object o84, Object o85, Object o86, Object o87, Object o88, Object o89, Object o90, Object o91, Object o92, Object o93, Object o94, Object o95, Object o96, Object o97, Object o98, Object o99, Object o100, Object o101, Object o102, Object o103, Object o104, Object o105, Object o106, Object o107, Object o108, Object o109, Object o110, Object o111, Object o112, Object o113, Object o114, Object o115, Object o116, Object o117, Object o118, Object o119, Object o120, Object o121, Object o122, Object o123, Object o124, Object o125, Object o126, Object o127, Object o128, Object o129, Object o130, Object o131, Object o132, Object o133, Object o134, Object o135, Object o136, Object o137, Object o138, Object o139, Object o140, Object o141, Object o142, Object o143, Object o144, Object o145, Object o146, Object o147, Object o148, Object o149, Object o150, Object o151, Object o152, Object o153, Object o154, Object o155, Object o156, Object o157, Object o158, Object o159, Object o160, Object o161, Object o162, Object o163, Object o164, Object o165, Object o166, Object o167, Object o168, Object o169, Object o170, Object o171, Object o172, Object o173, Object o174, Object o175, Object o176, Object o177, Object o178, Object o179, Object o180, Object o181, Object o182, Object o183, Object o184, Object o185, Object o186, Object o187, Object o188, Object o189, Object o190, Object o191, Object o192, Object o193, Object o194, Object o195, Object o196, Object o197, Object o198, Object o199, Object o200, Object o201, Object o202, Object o203, Object o204, Object o205) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80, o81, o82, o83, o84, o85, o86, o87, o88, o89, o90, o91, o92, o93, o94, o95, o96, o97, o98, o99, o100, o101, o102, o103, o104, o105, o106, o107, o108, o109, o110, o111, o112, o113, o114, o115, o116, o117, o118, o119, o120, o121, o122, o123, o124, o125, o126, o127, o128, o129, o130, o131, o132, o133, o134, o135, o136, o137, o138, o139, o140, o141, o142, o143, o144, o145, o146, o147, o148, o149, o150, o151, o152, o153, o154, o155, o156, o157, o158, o159, o160, o161, o162, o163, o164, o165, o166, o167, o168, o169, o170, o171, o172, o173, o174, o175, o176, o177, o178, o179, o180, o181, o182, o183, o184, o185, o186, o187, o188, o189, o190, o191, o192, o193, o194, o195, o196, o197, o198, o199, o200, o201, o202, o203, o204, o205); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80, Object o81, Object o82, Object o83, Object o84, Object o85, Object o86, Object o87, Object o88, Object o89, Object o90, Object o91, Object o92, Object o93, Object o94, Object o95, Object o96, Object o97, Object o98, Object o99, Object o100, Object o101, Object o102, Object o103, Object o104, Object o105, Object o106, Object o107, Object o108, Object o109, Object o110, Object o111, Object o112, Object o113, Object o114, Object o115, Object o116, Object o117, Object o118, Object o119, Object o120, Object o121, Object o122, Object o123, Object o124, Object o125, Object o126, Object o127, Object o128, Object o129, Object o130, Object o131, Object o132, Object o133, Object o134, Object o135, Object o136, Object o137, Object o138, Object o139, Object o140, Object o141, Object o142, Object o143, Object o144, Object o145, Object o146, Object o147, Object o148, Object o149, Object o150, Object o151, Object o152, Object o153, Object o154, Object o155, Object o156, Object o157, Object o158, Object o159, Object o160, Object o161, Object o162, Object o163, Object o164, Object o165, Object o166, Object o167, Object o168, Object o169, Object o170, Object o171, Object o172, Object o173, Object o174, Object o175, Object o176, Object o177, Object o178, Object o179, Object o180, Object o181, Object o182, Object o183, Object o184, Object o185, Object o186, Object o187, Object o188, Object o189, Object o190, Object o191, Object o192, Object o193, Object o194, Object o195, Object o196, Object o197, Object o198, Object o199, Object o200, Object o201, Object o202, Object o203, Object o204, Object o205, Object o206) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80, o81, o82, o83, o84, o85, o86, o87, o88, o89, o90, o91, o92, o93, o94, o95, o96, o97, o98, o99, o100, o101, o102, o103, o104, o105, o106, o107, o108, o109, o110, o111, o112, o113, o114, o115, o116, o117, o118, o119, o120, o121, o122, o123, o124, o125, o126, o127, o128, o129, o130, o131, o132, o133, o134, o135, o136, o137, o138, o139, o140, o141, o142, o143, o144, o145, o146, o147, o148, o149, o150, o151, o152, o153, o154, o155, o156, o157, o158, o159, o160, o161, o162, o163, o164, o165, o166, o167, o168, o169, o170, o171, o172, o173, o174, o175, o176, o177, o178, o179, o180, o181, o182, o183, o184, o185, o186, o187, o188, o189, o190, o191, o192, o193, o194, o195, o196, o197, o198, o199, o200, o201, o202, o203, o204, o205, o206); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80, Object o81, Object o82, Object o83, Object o84, Object o85, Object o86, Object o87, Object o88, Object o89, Object o90, Object o91, Object o92, Object o93, Object o94, Object o95, Object o96, Object o97, Object o98, Object o99, Object o100, Object o101, Object o102, Object o103, Object o104, Object o105, Object o106, Object o107, Object o108, Object o109, Object o110, Object o111, Object o112, Object o113, Object o114, Object o115, Object o116, Object o117, Object o118, Object o119, Object o120, Object o121, Object o122, Object o123, Object o124, Object o125, Object o126, Object o127, Object o128, Object o129, Object o130, Object o131, Object o132, Object o133, Object o134, Object o135, Object o136, Object o137, Object o138, Object o139, Object o140, Object o141, Object o142, Object o143, Object o144, Object o145, Object o146, Object o147, Object o148, Object o149, Object o150, Object o151, Object o152, Object o153, Object o154, Object o155, Object o156, Object o157, Object o158, Object o159, Object o160, Object o161, Object o162, Object o163, Object o164, Object o165, Object o166, Object o167, Object o168, Object o169, Object o170, Object o171, Object o172, Object o173, Object o174, Object o175, Object o176, Object o177, Object o178, Object o179, Object o180, Object o181, Object o182, Object o183, Object o184, Object o185, Object o186, Object o187, Object o188, Object o189, Object o190, Object o191, Object o192, Object o193, Object o194, Object o195, Object o196, Object o197, Object o198, Object o199, Object o200, Object o201, Object o202, Object o203, Object o204, Object o205, Object o206, Object o207) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80, o81, o82, o83, o84, o85, o86, o87, o88, o89, o90, o91, o92, o93, o94, o95, o96, o97, o98, o99, o100, o101, o102, o103, o104, o105, o106, o107, o108, o109, o110, o111, o112, o113, o114, o115, o116, o117, o118, o119, o120, o121, o122, o123, o124, o125, o126, o127, o128, o129, o130, o131, o132, o133, o134, o135, o136, o137, o138, o139, o140, o141, o142, o143, o144, o145, o146, o147, o148, o149, o150, o151, o152, o153, o154, o155, o156, o157, o158, o159, o160, o161, o162, o163, o164, o165, o166, o167, o168, o169, o170, o171, o172, o173, o174, o175, o176, o177, o178, o179, o180, o181, o182, o183, o184, o185, o186, o187, o188, o189, o190, o191, o192, o193, o194, o195, o196, o197, o198, o199, o200, o201, o202, o203, o204, o205, o206, o207); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80, Object o81, Object o82, Object o83, Object o84, Object o85, Object o86, Object o87, Object o88, Object o89, Object o90, Object o91, Object o92, Object o93, Object o94, Object o95, Object o96, Object o97, Object o98, Object o99, Object o100, Object o101, Object o102, Object o103, Object o104, Object o105, Object o106, Object o107, Object o108, Object o109, Object o110, Object o111, Object o112, Object o113, Object o114, Object o115, Object o116, Object o117, Object o118, Object o119, Object o120, Object o121, Object o122, Object o123, Object o124, Object o125, Object o126, Object o127, Object o128, Object o129, Object o130, Object o131, Object o132, Object o133, Object o134, Object o135, Object o136, Object o137, Object o138, Object o139, Object o140, Object o141, Object o142, Object o143, Object o144, Object o145, Object o146, Object o147, Object o148, Object o149, Object o150, Object o151, Object o152, Object o153, Object o154, Object o155, Object o156, Object o157, Object o158, Object o159, Object o160, Object o161, Object o162, Object o163, Object o164, Object o165, Object o166, Object o167, Object o168, Object o169, Object o170, Object o171, Object o172, Object o173, Object o174, Object o175, Object o176, Object o177, Object o178, Object o179, Object o180, Object o181, Object o182, Object o183, Object o184, Object o185, Object o186, Object o187, Object o188, Object o189, Object o190, Object o191, Object o192, Object o193, Object o194, Object o195, Object o196, Object o197, Object o198, Object o199, Object o200, Object o201, Object o202, Object o203, Object o204, Object o205, Object o206, Object o207, Object o208) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80, o81, o82, o83, o84, o85, o86, o87, o88, o89, o90, o91, o92, o93, o94, o95, o96, o97, o98, o99, o100, o101, o102, o103, o104, o105, o106, o107, o108, o109, o110, o111, o112, o113, o114, o115, o116, o117, o118, o119, o120, o121, o122, o123, o124, o125, o126, o127, o128, o129, o130, o131, o132, o133, o134, o135, o136, o137, o138, o139, o140, o141, o142, o143, o144, o145, o146, o147, o148, o149, o150, o151, o152, o153, o154, o155, o156, o157, o158, o159, o160, o161, o162, o163, o164, o165, o166, o167, o168, o169, o170, o171, o172, o173, o174, o175, o176, o177, o178, o179, o180, o181, o182, o183, o184, o185, o186, o187, o188, o189, o190, o191, o192, o193, o194, o195, o196, o197, o198, o199, o200, o201, o202, o203, o204, o205, o206, o207, o208); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80, Object o81, Object o82, Object o83, Object o84, Object o85, Object o86, Object o87, Object o88, Object o89, Object o90, Object o91, Object o92, Object o93, Object o94, Object o95, Object o96, Object o97, Object o98, Object o99, Object o100, Object o101, Object o102, Object o103, Object o104, Object o105, Object o106, Object o107, Object o108, Object o109, Object o110, Object o111, Object o112, Object o113, Object o114, Object o115, Object o116, Object o117, Object o118, Object o119, Object o120, Object o121, Object o122, Object o123, Object o124, Object o125, Object o126, Object o127, Object o128, Object o129, Object o130, Object o131, Object o132, Object o133, Object o134, Object o135, Object o136, Object o137, Object o138, Object o139, Object o140, Object o141, Object o142, Object o143, Object o144, Object o145, Object o146, Object o147, Object o148, Object o149, Object o150, Object o151, Object o152, Object o153, Object o154, Object o155, Object o156, Object o157, Object o158, Object o159, Object o160, Object o161, Object o162, Object o163, Object o164, Object o165, Object o166, Object o167, Object o168, Object o169, Object o170, Object o171, Object o172, Object o173, Object o174, Object o175, Object o176, Object o177, Object o178, Object o179, Object o180, Object o181, Object o182, Object o183, Object o184, Object o185, Object o186, Object o187, Object o188, Object o189, Object o190, Object o191, Object o192, Object o193, Object o194, Object o195, Object o196, Object o197, Object o198, Object o199, Object o200, Object o201, Object o202, Object o203, Object o204, Object o205, Object o206, Object o207, Object o208, Object o209) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80, o81, o82, o83, o84, o85, o86, o87, o88, o89, o90, o91, o92, o93, o94, o95, o96, o97, o98, o99, o100, o101, o102, o103, o104, o105, o106, o107, o108, o109, o110, o111, o112, o113, o114, o115, o116, o117, o118, o119, o120, o121, o122, o123, o124, o125, o126, o127, o128, o129, o130, o131, o132, o133, o134, o135, o136, o137, o138, o139, o140, o141, o142, o143, o144, o145, o146, o147, o148, o149, o150, o151, o152, o153, o154, o155, o156, o157, o158, o159, o160, o161, o162, o163, o164, o165, o166, o167, o168, o169, o170, o171, o172, o173, o174, o175, o176, o177, o178, o179, o180, o181, o182, o183, o184, o185, o186, o187, o188, o189, o190, o191, o192, o193, o194, o195, o196, o197, o198, o199, o200, o201, o202, o203, o204, o205, o206, o207, o208, o209); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80, Object o81, Object o82, Object o83, Object o84, Object o85, Object o86, Object o87, Object o88, Object o89, Object o90, Object o91, Object o92, Object o93, Object o94, Object o95, Object o96, Object o97, Object o98, Object o99, Object o100, Object o101, Object o102, Object o103, Object o104, Object o105, Object o106, Object o107, Object o108, Object o109, Object o110, Object o111, Object o112, Object o113, Object o114, Object o115, Object o116, Object o117, Object o118, Object o119, Object o120, Object o121, Object o122, Object o123, Object o124, Object o125, Object o126, Object o127, Object o128, Object o129, Object o130, Object o131, Object o132, Object o133, Object o134, Object o135, Object o136, Object o137, Object o138, Object o139, Object o140, Object o141, Object o142, Object o143, Object o144, Object o145, Object o146, Object o147, Object o148, Object o149, Object o150, Object o151, Object o152, Object o153, Object o154, Object o155, Object o156, Object o157, Object o158, Object o159, Object o160, Object o161, Object o162, Object o163, Object o164, Object o165, Object o166, Object o167, Object o168, Object o169, Object o170, Object o171, Object o172, Object o173, Object o174, Object o175, Object o176, Object o177, Object o178, Object o179, Object o180, Object o181, Object o182, Object o183, Object o184, Object o185, Object o186, Object o187, Object o188, Object o189, Object o190, Object o191, Object o192, Object o193, Object o194, Object o195, Object o196, Object o197, Object o198, Object o199, Object o200, Object o201, Object o202, Object o203, Object o204, Object o205, Object o206, Object o207, Object o208, Object o209, Object o210) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80, o81, o82, o83, o84, o85, o86, o87, o88, o89, o90, o91, o92, o93, o94, o95, o96, o97, o98, o99, o100, o101, o102, o103, o104, o105, o106, o107, o108, o109, o110, o111, o112, o113, o114, o115, o116, o117, o118, o119, o120, o121, o122, o123, o124, o125, o126, o127, o128, o129, o130, o131, o132, o133, o134, o135, o136, o137, o138, o139, o140, o141, o142, o143, o144, o145, o146, o147, o148, o149, o150, o151, o152, o153, o154, o155, o156, o157, o158, o159, o160, o161, o162, o163, o164, o165, o166, o167, o168, o169, o170, o171, o172, o173, o174, o175, o176, o177, o178, o179, o180, o181, o182, o183, o184, o185, o186, o187, o188, o189, o190, o191, o192, o193, o194, o195, o196, o197, o198, o199, o200, o201, o202, o203, o204, o205, o206, o207, o208, o209, o210); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80, Object o81, Object o82, Object o83, Object o84, Object o85, Object o86, Object o87, Object o88, Object o89, Object o90, Object o91, Object o92, Object o93, Object o94, Object o95, Object o96, Object o97, Object o98, Object o99, Object o100, Object o101, Object o102, Object o103, Object o104, Object o105, Object o106, Object o107, Object o108, Object o109, Object o110, Object o111, Object o112, Object o113, Object o114, Object o115, Object o116, Object o117, Object o118, Object o119, Object o120, Object o121, Object o122, Object o123, Object o124, Object o125, Object o126, Object o127, Object o128, Object o129, Object o130, Object o131, Object o132, Object o133, Object o134, Object o135, Object o136, Object o137, Object o138, Object o139, Object o140, Object o141, Object o142, Object o143, Object o144, Object o145, Object o146, Object o147, Object o148, Object o149, Object o150, Object o151, Object o152, Object o153, Object o154, Object o155, Object o156, Object o157, Object o158, Object o159, Object o160, Object o161, Object o162, Object o163, Object o164, Object o165, Object o166, Object o167, Object o168, Object o169, Object o170, Object o171, Object o172, Object o173, Object o174, Object o175, Object o176, Object o177, Object o178, Object o179, Object o180, Object o181, Object o182, Object o183, Object o184, Object o185, Object o186, Object o187, Object o188, Object o189, Object o190, Object o191, Object o192, Object o193, Object o194, Object o195, Object o196, Object o197, Object o198, Object o199, Object o200, Object o201, Object o202, Object o203, Object o204, Object o205, Object o206, Object o207, Object o208, Object o209, Object o210, Object o211) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80, o81, o82, o83, o84, o85, o86, o87, o88, o89, o90, o91, o92, o93, o94, o95, o96, o97, o98, o99, o100, o101, o102, o103, o104, o105, o106, o107, o108, o109, o110, o111, o112, o113, o114, o115, o116, o117, o118, o119, o120, o121, o122, o123, o124, o125, o126, o127, o128, o129, o130, o131, o132, o133, o134, o135, o136, o137, o138, o139, o140, o141, o142, o143, o144, o145, o146, o147, o148, o149, o150, o151, o152, o153, o154, o155, o156, o157, o158, o159, o160, o161, o162, o163, o164, o165, o166, o167, o168, o169, o170, o171, o172, o173, o174, o175, o176, o177, o178, o179, o180, o181, o182, o183, o184, o185, o186, o187, o188, o189, o190, o191, o192, o193, o194, o195, o196, o197, o198, o199, o200, o201, o202, o203, o204, o205, o206, o207, o208, o209, o210, o211); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80, Object o81, Object o82, Object o83, Object o84, Object o85, Object o86, Object o87, Object o88, Object o89, Object o90, Object o91, Object o92, Object o93, Object o94, Object o95, Object o96, Object o97, Object o98, Object o99, Object o100, Object o101, Object o102, Object o103, Object o104, Object o105, Object o106, Object o107, Object o108, Object o109, Object o110, Object o111, Object o112, Object o113, Object o114, Object o115, Object o116, Object o117, Object o118, Object o119, Object o120, Object o121, Object o122, Object o123, Object o124, Object o125, Object o126, Object o127, Object o128, Object o129, Object o130, Object o131, Object o132, Object o133, Object o134, Object o135, Object o136, Object o137, Object o138, Object o139, Object o140, Object o141, Object o142, Object o143, Object o144, Object o145, Object o146, Object o147, Object o148, Object o149, Object o150, Object o151, Object o152, Object o153, Object o154, Object o155, Object o156, Object o157, Object o158, Object o159, Object o160, Object o161, Object o162, Object o163, Object o164, Object o165, Object o166, Object o167, Object o168, Object o169, Object o170, Object o171, Object o172, Object o173, Object o174, Object o175, Object o176, Object o177, Object o178, Object o179, Object o180, Object o181, Object o182, Object o183, Object o184, Object o185, Object o186, Object o187, Object o188, Object o189, Object o190, Object o191, Object o192, Object o193, Object o194, Object o195, Object o196, Object o197, Object o198, Object o199, Object o200, Object o201, Object o202, Object o203, Object o204, Object o205, Object o206, Object o207, Object o208, Object o209, Object o210, Object o211, Object o212) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80, o81, o82, o83, o84, o85, o86, o87, o88, o89, o90, o91, o92, o93, o94, o95, o96, o97, o98, o99, o100, o101, o102, o103, o104, o105, o106, o107, o108, o109, o110, o111, o112, o113, o114, o115, o116, o117, o118, o119, o120, o121, o122, o123, o124, o125, o126, o127, o128, o129, o130, o131, o132, o133, o134, o135, o136, o137, o138, o139, o140, o141, o142, o143, o144, o145, o146, o147, o148, o149, o150, o151, o152, o153, o154, o155, o156, o157, o158, o159, o160, o161, o162, o163, o164, o165, o166, o167, o168, o169, o170, o171, o172, o173, o174, o175, o176, o177, o178, o179, o180, o181, o182, o183, o184, o185, o186, o187, o188, o189, o190, o191, o192, o193, o194, o195, o196, o197, o198, o199, o200, o201, o202, o203, o204, o205, o206, o207, o208, o209, o210, o211, o212); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80, Object o81, Object o82, Object o83, Object o84, Object o85, Object o86, Object o87, Object o88, Object o89, Object o90, Object o91, Object o92, Object o93, Object o94, Object o95, Object o96, Object o97, Object o98, Object o99, Object o100, Object o101, Object o102, Object o103, Object o104, Object o105, Object o106, Object o107, Object o108, Object o109, Object o110, Object o111, Object o112, Object o113, Object o114, Object o115, Object o116, Object o117, Object o118, Object o119, Object o120, Object o121, Object o122, Object o123, Object o124, Object o125, Object o126, Object o127, Object o128, Object o129, Object o130, Object o131, Object o132, Object o133, Object o134, Object o135, Object o136, Object o137, Object o138, Object o139, Object o140, Object o141, Object o142, Object o143, Object o144, Object o145, Object o146, Object o147, Object o148, Object o149, Object o150, Object o151, Object o152, Object o153, Object o154, Object o155, Object o156, Object o157, Object o158, Object o159, Object o160, Object o161, Object o162, Object o163, Object o164, Object o165, Object o166, Object o167, Object o168, Object o169, Object o170, Object o171, Object o172, Object o173, Object o174, Object o175, Object o176, Object o177, Object o178, Object o179, Object o180, Object o181, Object o182, Object o183, Object o184, Object o185, Object o186, Object o187, Object o188, Object o189, Object o190, Object o191, Object o192, Object o193, Object o194, Object o195, Object o196, Object o197, Object o198, Object o199, Object o200, Object o201, Object o202, Object o203, Object o204, Object o205, Object o206, Object o207, Object o208, Object o209, Object o210, Object o211, Object o212, Object o213) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80, o81, o82, o83, o84, o85, o86, o87, o88, o89, o90, o91, o92, o93, o94, o95, o96, o97, o98, o99, o100, o101, o102, o103, o104, o105, o106, o107, o108, o109, o110, o111, o112, o113, o114, o115, o116, o117, o118, o119, o120, o121, o122, o123, o124, o125, o126, o127, o128, o129, o130, o131, o132, o133, o134, o135, o136, o137, o138, o139, o140, o141, o142, o143, o144, o145, o146, o147, o148, o149, o150, o151, o152, o153, o154, o155, o156, o157, o158, o159, o160, o161, o162, o163, o164, o165, o166, o167, o168, o169, o170, o171, o172, o173, o174, o175, o176, o177, o178, o179, o180, o181, o182, o183, o184, o185, o186, o187, o188, o189, o190, o191, o192, o193, o194, o195, o196, o197, o198, o199, o200, o201, o202, o203, o204, o205, o206, o207, o208, o209, o210, o211, o212, o213); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80, Object o81, Object o82, Object o83, Object o84, Object o85, Object o86, Object o87, Object o88, Object o89, Object o90, Object o91, Object o92, Object o93, Object o94, Object o95, Object o96, Object o97, Object o98, Object o99, Object o100, Object o101, Object o102, Object o103, Object o104, Object o105, Object o106, Object o107, Object o108, Object o109, Object o110, Object o111, Object o112, Object o113, Object o114, Object o115, Object o116, Object o117, Object o118, Object o119, Object o120, Object o121, Object o122, Object o123, Object o124, Object o125, Object o126, Object o127, Object o128, Object o129, Object o130, Object o131, Object o132, Object o133, Object o134, Object o135, Object o136, Object o137, Object o138, Object o139, Object o140, Object o141, Object o142, Object o143, Object o144, Object o145, Object o146, Object o147, Object o148, Object o149, Object o150, Object o151, Object o152, Object o153, Object o154, Object o155, Object o156, Object o157, Object o158, Object o159, Object o160, Object o161, Object o162, Object o163, Object o164, Object o165, Object o166, Object o167, Object o168, Object o169, Object o170, Object o171, Object o172, Object o173, Object o174, Object o175, Object o176, Object o177, Object o178, Object o179, Object o180, Object o181, Object o182, Object o183, Object o184, Object o185, Object o186, Object o187, Object o188, Object o189, Object o190, Object o191, Object o192, Object o193, Object o194, Object o195, Object o196, Object o197, Object o198, Object o199, Object o200, Object o201, Object o202, Object o203, Object o204, Object o205, Object o206, Object o207, Object o208, Object o209, Object o210, Object o211, Object o212, Object o213, Object o214) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80, o81, o82, o83, o84, o85, o86, o87, o88, o89, o90, o91, o92, o93, o94, o95, o96, o97, o98, o99, o100, o101, o102, o103, o104, o105, o106, o107, o108, o109, o110, o111, o112, o113, o114, o115, o116, o117, o118, o119, o120, o121, o122, o123, o124, o125, o126, o127, o128, o129, o130, o131, o132, o133, o134, o135, o136, o137, o138, o139, o140, o141, o142, o143, o144, o145, o146, o147, o148, o149, o150, o151, o152, o153, o154, o155, o156, o157, o158, o159, o160, o161, o162, o163, o164, o165, o166, o167, o168, o169, o170, o171, o172, o173, o174, o175, o176, o177, o178, o179, o180, o181, o182, o183, o184, o185, o186, o187, o188, o189, o190, o191, o192, o193, o194, o195, o196, o197, o198, o199, o200, o201, o202, o203, o204, o205, o206, o207, o208, o209, o210, o211, o212, o213, o214); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80, Object o81, Object o82, Object o83, Object o84, Object o85, Object o86, Object o87, Object o88, Object o89, Object o90, Object o91, Object o92, Object o93, Object o94, Object o95, Object o96, Object o97, Object o98, Object o99, Object o100, Object o101, Object o102, Object o103, Object o104, Object o105, Object o106, Object o107, Object o108, Object o109, Object o110, Object o111, Object o112, Object o113, Object o114, Object o115, Object o116, Object o117, Object o118, Object o119, Object o120, Object o121, Object o122, Object o123, Object o124, Object o125, Object o126, Object o127, Object o128, Object o129, Object o130, Object o131, Object o132, Object o133, Object o134, Object o135, Object o136, Object o137, Object o138, Object o139, Object o140, Object o141, Object o142, Object o143, Object o144, Object o145, Object o146, Object o147, Object o148, Object o149, Object o150, Object o151, Object o152, Object o153, Object o154, Object o155, Object o156, Object o157, Object o158, Object o159, Object o160, Object o161, Object o162, Object o163, Object o164, Object o165, Object o166, Object o167, Object o168, Object o169, Object o170, Object o171, Object o172, Object o173, Object o174, Object o175, Object o176, Object o177, Object o178, Object o179, Object o180, Object o181, Object o182, Object o183, Object o184, Object o185, Object o186, Object o187, Object o188, Object o189, Object o190, Object o191, Object o192, Object o193, Object o194, Object o195, Object o196, Object o197, Object o198, Object o199, Object o200, Object o201, Object o202, Object o203, Object o204, Object o205, Object o206, Object o207, Object o208, Object o209, Object o210, Object o211, Object o212, Object o213, Object o214, Object o215) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80, o81, o82, o83, o84, o85, o86, o87, o88, o89, o90, o91, o92, o93, o94, o95, o96, o97, o98, o99, o100, o101, o102, o103, o104, o105, o106, o107, o108, o109, o110, o111, o112, o113, o114, o115, o116, o117, o118, o119, o120, o121, o122, o123, o124, o125, o126, o127, o128, o129, o130, o131, o132, o133, o134, o135, o136, o137, o138, o139, o140, o141, o142, o143, o144, o145, o146, o147, o148, o149, o150, o151, o152, o153, o154, o155, o156, o157, o158, o159, o160, o161, o162, o163, o164, o165, o166, o167, o168, o169, o170, o171, o172, o173, o174, o175, o176, o177, o178, o179, o180, o181, o182, o183, o184, o185, o186, o187, o188, o189, o190, o191, o192, o193, o194, o195, o196, o197, o198, o199, o200, o201, o202, o203, o204, o205, o206, o207, o208, o209, o210, o211, o212, o213, o214, o215); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80, Object o81, Object o82, Object o83, Object o84, Object o85, Object o86, Object o87, Object o88, Object o89, Object o90, Object o91, Object o92, Object o93, Object o94, Object o95, Object o96, Object o97, Object o98, Object o99, Object o100, Object o101, Object o102, Object o103, Object o104, Object o105, Object o106, Object o107, Object o108, Object o109, Object o110, Object o111, Object o112, Object o113, Object o114, Object o115, Object o116, Object o117, Object o118, Object o119, Object o120, Object o121, Object o122, Object o123, Object o124, Object o125, Object o126, Object o127, Object o128, Object o129, Object o130, Object o131, Object o132, Object o133, Object o134, Object o135, Object o136, Object o137, Object o138, Object o139, Object o140, Object o141, Object o142, Object o143, Object o144, Object o145, Object o146, Object o147, Object o148, Object o149, Object o150, Object o151, Object o152, Object o153, Object o154, Object o155, Object o156, Object o157, Object o158, Object o159, Object o160, Object o161, Object o162, Object o163, Object o164, Object o165, Object o166, Object o167, Object o168, Object o169, Object o170, Object o171, Object o172, Object o173, Object o174, Object o175, Object o176, Object o177, Object o178, Object o179, Object o180, Object o181, Object o182, Object o183, Object o184, Object o185, Object o186, Object o187, Object o188, Object o189, Object o190, Object o191, Object o192, Object o193, Object o194, Object o195, Object o196, Object o197, Object o198, Object o199, Object o200, Object o201, Object o202, Object o203, Object o204, Object o205, Object o206, Object o207, Object o208, Object o209, Object o210, Object o211, Object o212, Object o213, Object o214, Object o215, Object o216) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80, o81, o82, o83, o84, o85, o86, o87, o88, o89, o90, o91, o92, o93, o94, o95, o96, o97, o98, o99, o100, o101, o102, o103, o104, o105, o106, o107, o108, o109, o110, o111, o112, o113, o114, o115, o116, o117, o118, o119, o120, o121, o122, o123, o124, o125, o126, o127, o128, o129, o130, o131, o132, o133, o134, o135, o136, o137, o138, o139, o140, o141, o142, o143, o144, o145, o146, o147, o148, o149, o150, o151, o152, o153, o154, o155, o156, o157, o158, o159, o160, o161, o162, o163, o164, o165, o166, o167, o168, o169, o170, o171, o172, o173, o174, o175, o176, o177, o178, o179, o180, o181, o182, o183, o184, o185, o186, o187, o188, o189, o190, o191, o192, o193, o194, o195, o196, o197, o198, o199, o200, o201, o202, o203, o204, o205, o206, o207, o208, o209, o210, o211, o212, o213, o214, o215, o216); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80, Object o81, Object o82, Object o83, Object o84, Object o85, Object o86, Object o87, Object o88, Object o89, Object o90, Object o91, Object o92, Object o93, Object o94, Object o95, Object o96, Object o97, Object o98, Object o99, Object o100, Object o101, Object o102, Object o103, Object o104, Object o105, Object o106, Object o107, Object o108, Object o109, Object o110, Object o111, Object o112, Object o113, Object o114, Object o115, Object o116, Object o117, Object o118, Object o119, Object o120, Object o121, Object o122, Object o123, Object o124, Object o125, Object o126, Object o127, Object o128, Object o129, Object o130, Object o131, Object o132, Object o133, Object o134, Object o135, Object o136, Object o137, Object o138, Object o139, Object o140, Object o141, Object o142, Object o143, Object o144, Object o145, Object o146, Object o147, Object o148, Object o149, Object o150, Object o151, Object o152, Object o153, Object o154, Object o155, Object o156, Object o157, Object o158, Object o159, Object o160, Object o161, Object o162, Object o163, Object o164, Object o165, Object o166, Object o167, Object o168, Object o169, Object o170, Object o171, Object o172, Object o173, Object o174, Object o175, Object o176, Object o177, Object o178, Object o179, Object o180, Object o181, Object o182, Object o183, Object o184, Object o185, Object o186, Object o187, Object o188, Object o189, Object o190, Object o191, Object o192, Object o193, Object o194, Object o195, Object o196, Object o197, Object o198, Object o199, Object o200, Object o201, Object o202, Object o203, Object o204, Object o205, Object o206, Object o207, Object o208, Object o209, Object o210, Object o211, Object o212, Object o213, Object o214, Object o215, Object o216, Object o217) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80, o81, o82, o83, o84, o85, o86, o87, o88, o89, o90, o91, o92, o93, o94, o95, o96, o97, o98, o99, o100, o101, o102, o103, o104, o105, o106, o107, o108, o109, o110, o111, o112, o113, o114, o115, o116, o117, o118, o119, o120, o121, o122, o123, o124, o125, o126, o127, o128, o129, o130, o131, o132, o133, o134, o135, o136, o137, o138, o139, o140, o141, o142, o143, o144, o145, o146, o147, o148, o149, o150, o151, o152, o153, o154, o155, o156, o157, o158, o159, o160, o161, o162, o163, o164, o165, o166, o167, o168, o169, o170, o171, o172, o173, o174, o175, o176, o177, o178, o179, o180, o181, o182, o183, o184, o185, o186, o187, o188, o189, o190, o191, o192, o193, o194, o195, o196, o197, o198, o199, o200, o201, o202, o203, o204, o205, o206, o207, o208, o209, o210, o211, o212, o213, o214, o215, o216, o217); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80, Object o81, Object o82, Object o83, Object o84, Object o85, Object o86, Object o87, Object o88, Object o89, Object o90, Object o91, Object o92, Object o93, Object o94, Object o95, Object o96, Object o97, Object o98, Object o99, Object o100, Object o101, Object o102, Object o103, Object o104, Object o105, Object o106, Object o107, Object o108, Object o109, Object o110, Object o111, Object o112, Object o113, Object o114, Object o115, Object o116, Object o117, Object o118, Object o119, Object o120, Object o121, Object o122, Object o123, Object o124, Object o125, Object o126, Object o127, Object o128, Object o129, Object o130, Object o131, Object o132, Object o133, Object o134, Object o135, Object o136, Object o137, Object o138, Object o139, Object o140, Object o141, Object o142, Object o143, Object o144, Object o145, Object o146, Object o147, Object o148, Object o149, Object o150, Object o151, Object o152, Object o153, Object o154, Object o155, Object o156, Object o157, Object o158, Object o159, Object o160, Object o161, Object o162, Object o163, Object o164, Object o165, Object o166, Object o167, Object o168, Object o169, Object o170, Object o171, Object o172, Object o173, Object o174, Object o175, Object o176, Object o177, Object o178, Object o179, Object o180, Object o181, Object o182, Object o183, Object o184, Object o185, Object o186, Object o187, Object o188, Object o189, Object o190, Object o191, Object o192, Object o193, Object o194, Object o195, Object o196, Object o197, Object o198, Object o199, Object o200, Object o201, Object o202, Object o203, Object o204, Object o205, Object o206, Object o207, Object o208, Object o209, Object o210, Object o211, Object o212, Object o213, Object o214, Object o215, Object o216, Object o217, Object o218) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80, o81, o82, o83, o84, o85, o86, o87, o88, o89, o90, o91, o92, o93, o94, o95, o96, o97, o98, o99, o100, o101, o102, o103, o104, o105, o106, o107, o108, o109, o110, o111, o112, o113, o114, o115, o116, o117, o118, o119, o120, o121, o122, o123, o124, o125, o126, o127, o128, o129, o130, o131, o132, o133, o134, o135, o136, o137, o138, o139, o140, o141, o142, o143, o144, o145, o146, o147, o148, o149, o150, o151, o152, o153, o154, o155, o156, o157, o158, o159, o160, o161, o162, o163, o164, o165, o166, o167, o168, o169, o170, o171, o172, o173, o174, o175, o176, o177, o178, o179, o180, o181, o182, o183, o184, o185, o186, o187, o188, o189, o190, o191, o192, o193, o194, o195, o196, o197, o198, o199, o200, o201, o202, o203, o204, o205, o206, o207, o208, o209, o210, o211, o212, o213, o214, o215, o216, o217, o218); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80, Object o81, Object o82, Object o83, Object o84, Object o85, Object o86, Object o87, Object o88, Object o89, Object o90, Object o91, Object o92, Object o93, Object o94, Object o95, Object o96, Object o97, Object o98, Object o99, Object o100, Object o101, Object o102, Object o103, Object o104, Object o105, Object o106, Object o107, Object o108, Object o109, Object o110, Object o111, Object o112, Object o113, Object o114, Object o115, Object o116, Object o117, Object o118, Object o119, Object o120, Object o121, Object o122, Object o123, Object o124, Object o125, Object o126, Object o127, Object o128, Object o129, Object o130, Object o131, Object o132, Object o133, Object o134, Object o135, Object o136, Object o137, Object o138, Object o139, Object o140, Object o141, Object o142, Object o143, Object o144, Object o145, Object o146, Object o147, Object o148, Object o149, Object o150, Object o151, Object o152, Object o153, Object o154, Object o155, Object o156, Object o157, Object o158, Object o159, Object o160, Object o161, Object o162, Object o163, Object o164, Object o165, Object o166, Object o167, Object o168, Object o169, Object o170, Object o171, Object o172, Object o173, Object o174, Object o175, Object o176, Object o177, Object o178, Object o179, Object o180, Object o181, Object o182, Object o183, Object o184, Object o185, Object o186, Object o187, Object o188, Object o189, Object o190, Object o191, Object o192, Object o193, Object o194, Object o195, Object o196, Object o197, Object o198, Object o199, Object o200, Object o201, Object o202, Object o203, Object o204, Object o205, Object o206, Object o207, Object o208, Object o209, Object o210, Object o211, Object o212, Object o213, Object o214, Object o215, Object o216, Object o217, Object o218, Object o219) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80, o81, o82, o83, o84, o85, o86, o87, o88, o89, o90, o91, o92, o93, o94, o95, o96, o97, o98, o99, o100, o101, o102, o103, o104, o105, o106, o107, o108, o109, o110, o111, o112, o113, o114, o115, o116, o117, o118, o119, o120, o121, o122, o123, o124, o125, o126, o127, o128, o129, o130, o131, o132, o133, o134, o135, o136, o137, o138, o139, o140, o141, o142, o143, o144, o145, o146, o147, o148, o149, o150, o151, o152, o153, o154, o155, o156, o157, o158, o159, o160, o161, o162, o163, o164, o165, o166, o167, o168, o169, o170, o171, o172, o173, o174, o175, o176, o177, o178, o179, o180, o181, o182, o183, o184, o185, o186, o187, o188, o189, o190, o191, o192, o193, o194, o195, o196, o197, o198, o199, o200, o201, o202, o203, o204, o205, o206, o207, o208, o209, o210, o211, o212, o213, o214, o215, o216, o217, o218, o219); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80, Object o81, Object o82, Object o83, Object o84, Object o85, Object o86, Object o87, Object o88, Object o89, Object o90, Object o91, Object o92, Object o93, Object o94, Object o95, Object o96, Object o97, Object o98, Object o99, Object o100, Object o101, Object o102, Object o103, Object o104, Object o105, Object o106, Object o107, Object o108, Object o109, Object o110, Object o111, Object o112, Object o113, Object o114, Object o115, Object o116, Object o117, Object o118, Object o119, Object o120, Object o121, Object o122, Object o123, Object o124, Object o125, Object o126, Object o127, Object o128, Object o129, Object o130, Object o131, Object o132, Object o133, Object o134, Object o135, Object o136, Object o137, Object o138, Object o139, Object o140, Object o141, Object o142, Object o143, Object o144, Object o145, Object o146, Object o147, Object o148, Object o149, Object o150, Object o151, Object o152, Object o153, Object o154, Object o155, Object o156, Object o157, Object o158, Object o159, Object o160, Object o161, Object o162, Object o163, Object o164, Object o165, Object o166, Object o167, Object o168, Object o169, Object o170, Object o171, Object o172, Object o173, Object o174, Object o175, Object o176, Object o177, Object o178, Object o179, Object o180, Object o181, Object o182, Object o183, Object o184, Object o185, Object o186, Object o187, Object o188, Object o189, Object o190, Object o191, Object o192, Object o193, Object o194, Object o195, Object o196, Object o197, Object o198, Object o199, Object o200, Object o201, Object o202, Object o203, Object o204, Object o205, Object o206, Object o207, Object o208, Object o209, Object o210, Object o211, Object o212, Object o213, Object o214, Object o215, Object o216, Object o217, Object o218, Object o219, Object o220) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80, o81, o82, o83, o84, o85, o86, o87, o88, o89, o90, o91, o92, o93, o94, o95, o96, o97, o98, o99, o100, o101, o102, o103, o104, o105, o106, o107, o108, o109, o110, o111, o112, o113, o114, o115, o116, o117, o118, o119, o120, o121, o122, o123, o124, o125, o126, o127, o128, o129, o130, o131, o132, o133, o134, o135, o136, o137, o138, o139, o140, o141, o142, o143, o144, o145, o146, o147, o148, o149, o150, o151, o152, o153, o154, o155, o156, o157, o158, o159, o160, o161, o162, o163, o164, o165, o166, o167, o168, o169, o170, o171, o172, o173, o174, o175, o176, o177, o178, o179, o180, o181, o182, o183, o184, o185, o186, o187, o188, o189, o190, o191, o192, o193, o194, o195, o196, o197, o198, o199, o200, o201, o202, o203, o204, o205, o206, o207, o208, o209, o210, o211, o212, o213, o214, o215, o216, o217, o218, o219, o220); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80, Object o81, Object o82, Object o83, Object o84, Object o85, Object o86, Object o87, Object o88, Object o89, Object o90, Object o91, Object o92, Object o93, Object o94, Object o95, Object o96, Object o97, Object o98, Object o99, Object o100, Object o101, Object o102, Object o103, Object o104, Object o105, Object o106, Object o107, Object o108, Object o109, Object o110, Object o111, Object o112, Object o113, Object o114, Object o115, Object o116, Object o117, Object o118, Object o119, Object o120, Object o121, Object o122, Object o123, Object o124, Object o125, Object o126, Object o127, Object o128, Object o129, Object o130, Object o131, Object o132, Object o133, Object o134, Object o135, Object o136, Object o137, Object o138, Object o139, Object o140, Object o141, Object o142, Object o143, Object o144, Object o145, Object o146, Object o147, Object o148, Object o149, Object o150, Object o151, Object o152, Object o153, Object o154, Object o155, Object o156, Object o157, Object o158, Object o159, Object o160, Object o161, Object o162, Object o163, Object o164, Object o165, Object o166, Object o167, Object o168, Object o169, Object o170, Object o171, Object o172, Object o173, Object o174, Object o175, Object o176, Object o177, Object o178, Object o179, Object o180, Object o181, Object o182, Object o183, Object o184, Object o185, Object o186, Object o187, Object o188, Object o189, Object o190, Object o191, Object o192, Object o193, Object o194, Object o195, Object o196, Object o197, Object o198, Object o199, Object o200, Object o201, Object o202, Object o203, Object o204, Object o205, Object o206, Object o207, Object o208, Object o209, Object o210, Object o211, Object o212, Object o213, Object o214, Object o215, Object o216, Object o217, Object o218, Object o219, Object o220, Object o221) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80, o81, o82, o83, o84, o85, o86, o87, o88, o89, o90, o91, o92, o93, o94, o95, o96, o97, o98, o99, o100, o101, o102, o103, o104, o105, o106, o107, o108, o109, o110, o111, o112, o113, o114, o115, o116, o117, o118, o119, o120, o121, o122, o123, o124, o125, o126, o127, o128, o129, o130, o131, o132, o133, o134, o135, o136, o137, o138, o139, o140, o141, o142, o143, o144, o145, o146, o147, o148, o149, o150, o151, o152, o153, o154, o155, o156, o157, o158, o159, o160, o161, o162, o163, o164, o165, o166, o167, o168, o169, o170, o171, o172, o173, o174, o175, o176, o177, o178, o179, o180, o181, o182, o183, o184, o185, o186, o187, o188, o189, o190, o191, o192, o193, o194, o195, o196, o197, o198, o199, o200, o201, o202, o203, o204, o205, o206, o207, o208, o209, o210, o211, o212, o213, o214, o215, o216, o217, o218, o219, o220, o221); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80, Object o81, Object o82, Object o83, Object o84, Object o85, Object o86, Object o87, Object o88, Object o89, Object o90, Object o91, Object o92, Object o93, Object o94, Object o95, Object o96, Object o97, Object o98, Object o99, Object o100, Object o101, Object o102, Object o103, Object o104, Object o105, Object o106, Object o107, Object o108, Object o109, Object o110, Object o111, Object o112, Object o113, Object o114, Object o115, Object o116, Object o117, Object o118, Object o119, Object o120, Object o121, Object o122, Object o123, Object o124, Object o125, Object o126, Object o127, Object o128, Object o129, Object o130, Object o131, Object o132, Object o133, Object o134, Object o135, Object o136, Object o137, Object o138, Object o139, Object o140, Object o141, Object o142, Object o143, Object o144, Object o145, Object o146, Object o147, Object o148, Object o149, Object o150, Object o151, Object o152, Object o153, Object o154, Object o155, Object o156, Object o157, Object o158, Object o159, Object o160, Object o161, Object o162, Object o163, Object o164, Object o165, Object o166, Object o167, Object o168, Object o169, Object o170, Object o171, Object o172, Object o173, Object o174, Object o175, Object o176, Object o177, Object o178, Object o179, Object o180, Object o181, Object o182, Object o183, Object o184, Object o185, Object o186, Object o187, Object o188, Object o189, Object o190, Object o191, Object o192, Object o193, Object o194, Object o195, Object o196, Object o197, Object o198, Object o199, Object o200, Object o201, Object o202, Object o203, Object o204, Object o205, Object o206, Object o207, Object o208, Object o209, Object o210, Object o211, Object o212, Object o213, Object o214, Object o215, Object o216, Object o217, Object o218, Object o219, Object o220, Object o221, Object o222) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80, o81, o82, o83, o84, o85, o86, o87, o88, o89, o90, o91, o92, o93, o94, o95, o96, o97, o98, o99, o100, o101, o102, o103, o104, o105, o106, o107, o108, o109, o110, o111, o112, o113, o114, o115, o116, o117, o118, o119, o120, o121, o122, o123, o124, o125, o126, o127, o128, o129, o130, o131, o132, o133, o134, o135, o136, o137, o138, o139, o140, o141, o142, o143, o144, o145, o146, o147, o148, o149, o150, o151, o152, o153, o154, o155, o156, o157, o158, o159, o160, o161, o162, o163, o164, o165, o166, o167, o168, o169, o170, o171, o172, o173, o174, o175, o176, o177, o178, o179, o180, o181, o182, o183, o184, o185, o186, o187, o188, o189, o190, o191, o192, o193, o194, o195, o196, o197, o198, o199, o200, o201, o202, o203, o204, o205, o206, o207, o208, o209, o210, o211, o212, o213, o214, o215, o216, o217, o218, o219, o220, o221, o222); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80, Object o81, Object o82, Object o83, Object o84, Object o85, Object o86, Object o87, Object o88, Object o89, Object o90, Object o91, Object o92, Object o93, Object o94, Object o95, Object o96, Object o97, Object o98, Object o99, Object o100, Object o101, Object o102, Object o103, Object o104, Object o105, Object o106, Object o107, Object o108, Object o109, Object o110, Object o111, Object o112, Object o113, Object o114, Object o115, Object o116, Object o117, Object o118, Object o119, Object o120, Object o121, Object o122, Object o123, Object o124, Object o125, Object o126, Object o127, Object o128, Object o129, Object o130, Object o131, Object o132, Object o133, Object o134, Object o135, Object o136, Object o137, Object o138, Object o139, Object o140, Object o141, Object o142, Object o143, Object o144, Object o145, Object o146, Object o147, Object o148, Object o149, Object o150, Object o151, Object o152, Object o153, Object o154, Object o155, Object o156, Object o157, Object o158, Object o159, Object o160, Object o161, Object o162, Object o163, Object o164, Object o165, Object o166, Object o167, Object o168, Object o169, Object o170, Object o171, Object o172, Object o173, Object o174, Object o175, Object o176, Object o177, Object o178, Object o179, Object o180, Object o181, Object o182, Object o183, Object o184, Object o185, Object o186, Object o187, Object o188, Object o189, Object o190, Object o191, Object o192, Object o193, Object o194, Object o195, Object o196, Object o197, Object o198, Object o199, Object o200, Object o201, Object o202, Object o203, Object o204, Object o205, Object o206, Object o207, Object o208, Object o209, Object o210, Object o211, Object o212, Object o213, Object o214, Object o215, Object o216, Object o217, Object o218, Object o219, Object o220, Object o221, Object o222, Object o223) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80, o81, o82, o83, o84, o85, o86, o87, o88, o89, o90, o91, o92, o93, o94, o95, o96, o97, o98, o99, o100, o101, o102, o103, o104, o105, o106, o107, o108, o109, o110, o111, o112, o113, o114, o115, o116, o117, o118, o119, o120, o121, o122, o123, o124, o125, o126, o127, o128, o129, o130, o131, o132, o133, o134, o135, o136, o137, o138, o139, o140, o141, o142, o143, o144, o145, o146, o147, o148, o149, o150, o151, o152, o153, o154, o155, o156, o157, o158, o159, o160, o161, o162, o163, o164, o165, o166, o167, o168, o169, o170, o171, o172, o173, o174, o175, o176, o177, o178, o179, o180, o181, o182, o183, o184, o185, o186, o187, o188, o189, o190, o191, o192, o193, o194, o195, o196, o197, o198, o199, o200, o201, o202, o203, o204, o205, o206, o207, o208, o209, o210, o211, o212, o213, o214, o215, o216, o217, o218, o219, o220, o221, o222, o223); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80, Object o81, Object o82, Object o83, Object o84, Object o85, Object o86, Object o87, Object o88, Object o89, Object o90, Object o91, Object o92, Object o93, Object o94, Object o95, Object o96, Object o97, Object o98, Object o99, Object o100, Object o101, Object o102, Object o103, Object o104, Object o105, Object o106, Object o107, Object o108, Object o109, Object o110, Object o111, Object o112, Object o113, Object o114, Object o115, Object o116, Object o117, Object o118, Object o119, Object o120, Object o121, Object o122, Object o123, Object o124, Object o125, Object o126, Object o127, Object o128, Object o129, Object o130, Object o131, Object o132, Object o133, Object o134, Object o135, Object o136, Object o137, Object o138, Object o139, Object o140, Object o141, Object o142, Object o143, Object o144, Object o145, Object o146, Object o147, Object o148, Object o149, Object o150, Object o151, Object o152, Object o153, Object o154, Object o155, Object o156, Object o157, Object o158, Object o159, Object o160, Object o161, Object o162, Object o163, Object o164, Object o165, Object o166, Object o167, Object o168, Object o169, Object o170, Object o171, Object o172, Object o173, Object o174, Object o175, Object o176, Object o177, Object o178, Object o179, Object o180, Object o181, Object o182, Object o183, Object o184, Object o185, Object o186, Object o187, Object o188, Object o189, Object o190, Object o191, Object o192, Object o193, Object o194, Object o195, Object o196, Object o197, Object o198, Object o199, Object o200, Object o201, Object o202, Object o203, Object o204, Object o205, Object o206, Object o207, Object o208, Object o209, Object o210, Object o211, Object o212, Object o213, Object o214, Object o215, Object o216, Object o217, Object o218, Object o219, Object o220, Object o221, Object o222, Object o223, Object o224) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80, o81, o82, o83, o84, o85, o86, o87, o88, o89, o90, o91, o92, o93, o94, o95, o96, o97, o98, o99, o100, o101, o102, o103, o104, o105, o106, o107, o108, o109, o110, o111, o112, o113, o114, o115, o116, o117, o118, o119, o120, o121, o122, o123, o124, o125, o126, o127, o128, o129, o130, o131, o132, o133, o134, o135, o136, o137, o138, o139, o140, o141, o142, o143, o144, o145, o146, o147, o148, o149, o150, o151, o152, o153, o154, o155, o156, o157, o158, o159, o160, o161, o162, o163, o164, o165, o166, o167, o168, o169, o170, o171, o172, o173, o174, o175, o176, o177, o178, o179, o180, o181, o182, o183, o184, o185, o186, o187, o188, o189, o190, o191, o192, o193, o194, o195, o196, o197, o198, o199, o200, o201, o202, o203, o204, o205, o206, o207, o208, o209, o210, o211, o212, o213, o214, o215, o216, o217, o218, o219, o220, o221, o222, o223, o224); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80, Object o81, Object o82, Object o83, Object o84, Object o85, Object o86, Object o87, Object o88, Object o89, Object o90, Object o91, Object o92, Object o93, Object o94, Object o95, Object o96, Object o97, Object o98, Object o99, Object o100, Object o101, Object o102, Object o103, Object o104, Object o105, Object o106, Object o107, Object o108, Object o109, Object o110, Object o111, Object o112, Object o113, Object o114, Object o115, Object o116, Object o117, Object o118, Object o119, Object o120, Object o121, Object o122, Object o123, Object o124, Object o125, Object o126, Object o127, Object o128, Object o129, Object o130, Object o131, Object o132, Object o133, Object o134, Object o135, Object o136, Object o137, Object o138, Object o139, Object o140, Object o141, Object o142, Object o143, Object o144, Object o145, Object o146, Object o147, Object o148, Object o149, Object o150, Object o151, Object o152, Object o153, Object o154, Object o155, Object o156, Object o157, Object o158, Object o159, Object o160, Object o161, Object o162, Object o163, Object o164, Object o165, Object o166, Object o167, Object o168, Object o169, Object o170, Object o171, Object o172, Object o173, Object o174, Object o175, Object o176, Object o177, Object o178, Object o179, Object o180, Object o181, Object o182, Object o183, Object o184, Object o185, Object o186, Object o187, Object o188, Object o189, Object o190, Object o191, Object o192, Object o193, Object o194, Object o195, Object o196, Object o197, Object o198, Object o199, Object o200, Object o201, Object o202, Object o203, Object o204, Object o205, Object o206, Object o207, Object o208, Object o209, Object o210, Object o211, Object o212, Object o213, Object o214, Object o215, Object o216, Object o217, Object o218, Object o219, Object o220, Object o221, Object o222, Object o223, Object o224, Object o225) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80, o81, o82, o83, o84, o85, o86, o87, o88, o89, o90, o91, o92, o93, o94, o95, o96, o97, o98, o99, o100, o101, o102, o103, o104, o105, o106, o107, o108, o109, o110, o111, o112, o113, o114, o115, o116, o117, o118, o119, o120, o121, o122, o123, o124, o125, o126, o127, o128, o129, o130, o131, o132, o133, o134, o135, o136, o137, o138, o139, o140, o141, o142, o143, o144, o145, o146, o147, o148, o149, o150, o151, o152, o153, o154, o155, o156, o157, o158, o159, o160, o161, o162, o163, o164, o165, o166, o167, o168, o169, o170, o171, o172, o173, o174, o175, o176, o177, o178, o179, o180, o181, o182, o183, o184, o185, o186, o187, o188, o189, o190, o191, o192, o193, o194, o195, o196, o197, o198, o199, o200, o201, o202, o203, o204, o205, o206, o207, o208, o209, o210, o211, o212, o213, o214, o215, o216, o217, o218, o219, o220, o221, o222, o223, o224, o225); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80, Object o81, Object o82, Object o83, Object o84, Object o85, Object o86, Object o87, Object o88, Object o89, Object o90, Object o91, Object o92, Object o93, Object o94, Object o95, Object o96, Object o97, Object o98, Object o99, Object o100, Object o101, Object o102, Object o103, Object o104, Object o105, Object o106, Object o107, Object o108, Object o109, Object o110, Object o111, Object o112, Object o113, Object o114, Object o115, Object o116, Object o117, Object o118, Object o119, Object o120, Object o121, Object o122, Object o123, Object o124, Object o125, Object o126, Object o127, Object o128, Object o129, Object o130, Object o131, Object o132, Object o133, Object o134, Object o135, Object o136, Object o137, Object o138, Object o139, Object o140, Object o141, Object o142, Object o143, Object o144, Object o145, Object o146, Object o147, Object o148, Object o149, Object o150, Object o151, Object o152, Object o153, Object o154, Object o155, Object o156, Object o157, Object o158, Object o159, Object o160, Object o161, Object o162, Object o163, Object o164, Object o165, Object o166, Object o167, Object o168, Object o169, Object o170, Object o171, Object o172, Object o173, Object o174, Object o175, Object o176, Object o177, Object o178, Object o179, Object o180, Object o181, Object o182, Object o183, Object o184, Object o185, Object o186, Object o187, Object o188, Object o189, Object o190, Object o191, Object o192, Object o193, Object o194, Object o195, Object o196, Object o197, Object o198, Object o199, Object o200, Object o201, Object o202, Object o203, Object o204, Object o205, Object o206, Object o207, Object o208, Object o209, Object o210, Object o211, Object o212, Object o213, Object o214, Object o215, Object o216, Object o217, Object o218, Object o219, Object o220, Object o221, Object o222, Object o223, Object o224, Object o225, Object o226) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80, o81, o82, o83, o84, o85, o86, o87, o88, o89, o90, o91, o92, o93, o94, o95, o96, o97, o98, o99, o100, o101, o102, o103, o104, o105, o106, o107, o108, o109, o110, o111, o112, o113, o114, o115, o116, o117, o118, o119, o120, o121, o122, o123, o124, o125, o126, o127, o128, o129, o130, o131, o132, o133, o134, o135, o136, o137, o138, o139, o140, o141, o142, o143, o144, o145, o146, o147, o148, o149, o150, o151, o152, o153, o154, o155, o156, o157, o158, o159, o160, o161, o162, o163, o164, o165, o166, o167, o168, o169, o170, o171, o172, o173, o174, o175, o176, o177, o178, o179, o180, o181, o182, o183, o184, o185, o186, o187, o188, o189, o190, o191, o192, o193, o194, o195, o196, o197, o198, o199, o200, o201, o202, o203, o204, o205, o206, o207, o208, o209, o210, o211, o212, o213, o214, o215, o216, o217, o218, o219, o220, o221, o222, o223, o224, o225, o226); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80, Object o81, Object o82, Object o83, Object o84, Object o85, Object o86, Object o87, Object o88, Object o89, Object o90, Object o91, Object o92, Object o93, Object o94, Object o95, Object o96, Object o97, Object o98, Object o99, Object o100, Object o101, Object o102, Object o103, Object o104, Object o105, Object o106, Object o107, Object o108, Object o109, Object o110, Object o111, Object o112, Object o113, Object o114, Object o115, Object o116, Object o117, Object o118, Object o119, Object o120, Object o121, Object o122, Object o123, Object o124, Object o125, Object o126, Object o127, Object o128, Object o129, Object o130, Object o131, Object o132, Object o133, Object o134, Object o135, Object o136, Object o137, Object o138, Object o139, Object o140, Object o141, Object o142, Object o143, Object o144, Object o145, Object o146, Object o147, Object o148, Object o149, Object o150, Object o151, Object o152, Object o153, Object o154, Object o155, Object o156, Object o157, Object o158, Object o159, Object o160, Object o161, Object o162, Object o163, Object o164, Object o165, Object o166, Object o167, Object o168, Object o169, Object o170, Object o171, Object o172, Object o173, Object o174, Object o175, Object o176, Object o177, Object o178, Object o179, Object o180, Object o181, Object o182, Object o183, Object o184, Object o185, Object o186, Object o187, Object o188, Object o189, Object o190, Object o191, Object o192, Object o193, Object o194, Object o195, Object o196, Object o197, Object o198, Object o199, Object o200, Object o201, Object o202, Object o203, Object o204, Object o205, Object o206, Object o207, Object o208, Object o209, Object o210, Object o211, Object o212, Object o213, Object o214, Object o215, Object o216, Object o217, Object o218, Object o219, Object o220, Object o221, Object o222, Object o223, Object o224, Object o225, Object o226, Object o227) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80, o81, o82, o83, o84, o85, o86, o87, o88, o89, o90, o91, o92, o93, o94, o95, o96, o97, o98, o99, o100, o101, o102, o103, o104, o105, o106, o107, o108, o109, o110, o111, o112, o113, o114, o115, o116, o117, o118, o119, o120, o121, o122, o123, o124, o125, o126, o127, o128, o129, o130, o131, o132, o133, o134, o135, o136, o137, o138, o139, o140, o141, o142, o143, o144, o145, o146, o147, o148, o149, o150, o151, o152, o153, o154, o155, o156, o157, o158, o159, o160, o161, o162, o163, o164, o165, o166, o167, o168, o169, o170, o171, o172, o173, o174, o175, o176, o177, o178, o179, o180, o181, o182, o183, o184, o185, o186, o187, o188, o189, o190, o191, o192, o193, o194, o195, o196, o197, o198, o199, o200, o201, o202, o203, o204, o205, o206, o207, o208, o209, o210, o211, o212, o213, o214, o215, o216, o217, o218, o219, o220, o221, o222, o223, o224, o225, o226, o227); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80, Object o81, Object o82, Object o83, Object o84, Object o85, Object o86, Object o87, Object o88, Object o89, Object o90, Object o91, Object o92, Object o93, Object o94, Object o95, Object o96, Object o97, Object o98, Object o99, Object o100, Object o101, Object o102, Object o103, Object o104, Object o105, Object o106, Object o107, Object o108, Object o109, Object o110, Object o111, Object o112, Object o113, Object o114, Object o115, Object o116, Object o117, Object o118, Object o119, Object o120, Object o121, Object o122, Object o123, Object o124, Object o125, Object o126, Object o127, Object o128, Object o129, Object o130, Object o131, Object o132, Object o133, Object o134, Object o135, Object o136, Object o137, Object o138, Object o139, Object o140, Object o141, Object o142, Object o143, Object o144, Object o145, Object o146, Object o147, Object o148, Object o149, Object o150, Object o151, Object o152, Object o153, Object o154, Object o155, Object o156, Object o157, Object o158, Object o159, Object o160, Object o161, Object o162, Object o163, Object o164, Object o165, Object o166, Object o167, Object o168, Object o169, Object o170, Object o171, Object o172, Object o173, Object o174, Object o175, Object o176, Object o177, Object o178, Object o179, Object o180, Object o181, Object o182, Object o183, Object o184, Object o185, Object o186, Object o187, Object o188, Object o189, Object o190, Object o191, Object o192, Object o193, Object o194, Object o195, Object o196, Object o197, Object o198, Object o199, Object o200, Object o201, Object o202, Object o203, Object o204, Object o205, Object o206, Object o207, Object o208, Object o209, Object o210, Object o211, Object o212, Object o213, Object o214, Object o215, Object o216, Object o217, Object o218, Object o219, Object o220, Object o221, Object o222, Object o223, Object o224, Object o225, Object o226, Object o227, Object o228) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80, o81, o82, o83, o84, o85, o86, o87, o88, o89, o90, o91, o92, o93, o94, o95, o96, o97, o98, o99, o100, o101, o102, o103, o104, o105, o106, o107, o108, o109, o110, o111, o112, o113, o114, o115, o116, o117, o118, o119, o120, o121, o122, o123, o124, o125, o126, o127, o128, o129, o130, o131, o132, o133, o134, o135, o136, o137, o138, o139, o140, o141, o142, o143, o144, o145, o146, o147, o148, o149, o150, o151, o152, o153, o154, o155, o156, o157, o158, o159, o160, o161, o162, o163, o164, o165, o166, o167, o168, o169, o170, o171, o172, o173, o174, o175, o176, o177, o178, o179, o180, o181, o182, o183, o184, o185, o186, o187, o188, o189, o190, o191, o192, o193, o194, o195, o196, o197, o198, o199, o200, o201, o202, o203, o204, o205, o206, o207, o208, o209, o210, o211, o212, o213, o214, o215, o216, o217, o218, o219, o220, o221, o222, o223, o224, o225, o226, o227, o228); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80, Object o81, Object o82, Object o83, Object o84, Object o85, Object o86, Object o87, Object o88, Object o89, Object o90, Object o91, Object o92, Object o93, Object o94, Object o95, Object o96, Object o97, Object o98, Object o99, Object o100, Object o101, Object o102, Object o103, Object o104, Object o105, Object o106, Object o107, Object o108, Object o109, Object o110, Object o111, Object o112, Object o113, Object o114, Object o115, Object o116, Object o117, Object o118, Object o119, Object o120, Object o121, Object o122, Object o123, Object o124, Object o125, Object o126, Object o127, Object o128, Object o129, Object o130, Object o131, Object o132, Object o133, Object o134, Object o135, Object o136, Object o137, Object o138, Object o139, Object o140, Object o141, Object o142, Object o143, Object o144, Object o145, Object o146, Object o147, Object o148, Object o149, Object o150, Object o151, Object o152, Object o153, Object o154, Object o155, Object o156, Object o157, Object o158, Object o159, Object o160, Object o161, Object o162, Object o163, Object o164, Object o165, Object o166, Object o167, Object o168, Object o169, Object o170, Object o171, Object o172, Object o173, Object o174, Object o175, Object o176, Object o177, Object o178, Object o179, Object o180, Object o181, Object o182, Object o183, Object o184, Object o185, Object o186, Object o187, Object o188, Object o189, Object o190, Object o191, Object o192, Object o193, Object o194, Object o195, Object o196, Object o197, Object o198, Object o199, Object o200, Object o201, Object o202, Object o203, Object o204, Object o205, Object o206, Object o207, Object o208, Object o209, Object o210, Object o211, Object o212, Object o213, Object o214, Object o215, Object o216, Object o217, Object o218, Object o219, Object o220, Object o221, Object o222, Object o223, Object o224, Object o225, Object o226, Object o227, Object o228, Object o229) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80, o81, o82, o83, o84, o85, o86, o87, o88, o89, o90, o91, o92, o93, o94, o95, o96, o97, o98, o99, o100, o101, o102, o103, o104, o105, o106, o107, o108, o109, o110, o111, o112, o113, o114, o115, o116, o117, o118, o119, o120, o121, o122, o123, o124, o125, o126, o127, o128, o129, o130, o131, o132, o133, o134, o135, o136, o137, o138, o139, o140, o141, o142, o143, o144, o145, o146, o147, o148, o149, o150, o151, o152, o153, o154, o155, o156, o157, o158, o159, o160, o161, o162, o163, o164, o165, o166, o167, o168, o169, o170, o171, o172, o173, o174, o175, o176, o177, o178, o179, o180, o181, o182, o183, o184, o185, o186, o187, o188, o189, o190, o191, o192, o193, o194, o195, o196, o197, o198, o199, o200, o201, o202, o203, o204, o205, o206, o207, o208, o209, o210, o211, o212, o213, o214, o215, o216, o217, o218, o219, o220, o221, o222, o223, o224, o225, o226, o227, o228, o229); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80, Object o81, Object o82, Object o83, Object o84, Object o85, Object o86, Object o87, Object o88, Object o89, Object o90, Object o91, Object o92, Object o93, Object o94, Object o95, Object o96, Object o97, Object o98, Object o99, Object o100, Object o101, Object o102, Object o103, Object o104, Object o105, Object o106, Object o107, Object o108, Object o109, Object o110, Object o111, Object o112, Object o113, Object o114, Object o115, Object o116, Object o117, Object o118, Object o119, Object o120, Object o121, Object o122, Object o123, Object o124, Object o125, Object o126, Object o127, Object o128, Object o129, Object o130, Object o131, Object o132, Object o133, Object o134, Object o135, Object o136, Object o137, Object o138, Object o139, Object o140, Object o141, Object o142, Object o143, Object o144, Object o145, Object o146, Object o147, Object o148, Object o149, Object o150, Object o151, Object o152, Object o153, Object o154, Object o155, Object o156, Object o157, Object o158, Object o159, Object o160, Object o161, Object o162, Object o163, Object o164, Object o165, Object o166, Object o167, Object o168, Object o169, Object o170, Object o171, Object o172, Object o173, Object o174, Object o175, Object o176, Object o177, Object o178, Object o179, Object o180, Object o181, Object o182, Object o183, Object o184, Object o185, Object o186, Object o187, Object o188, Object o189, Object o190, Object o191, Object o192, Object o193, Object o194, Object o195, Object o196, Object o197, Object o198, Object o199, Object o200, Object o201, Object o202, Object o203, Object o204, Object o205, Object o206, Object o207, Object o208, Object o209, Object o210, Object o211, Object o212, Object o213, Object o214, Object o215, Object o216, Object o217, Object o218, Object o219, Object o220, Object o221, Object o222, Object o223, Object o224, Object o225, Object o226, Object o227, Object o228, Object o229, Object o230) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80, o81, o82, o83, o84, o85, o86, o87, o88, o89, o90, o91, o92, o93, o94, o95, o96, o97, o98, o99, o100, o101, o102, o103, o104, o105, o106, o107, o108, o109, o110, o111, o112, o113, o114, o115, o116, o117, o118, o119, o120, o121, o122, o123, o124, o125, o126, o127, o128, o129, o130, o131, o132, o133, o134, o135, o136, o137, o138, o139, o140, o141, o142, o143, o144, o145, o146, o147, o148, o149, o150, o151, o152, o153, o154, o155, o156, o157, o158, o159, o160, o161, o162, o163, o164, o165, o166, o167, o168, o169, o170, o171, o172, o173, o174, o175, o176, o177, o178, o179, o180, o181, o182, o183, o184, o185, o186, o187, o188, o189, o190, o191, o192, o193, o194, o195, o196, o197, o198, o199, o200, o201, o202, o203, o204, o205, o206, o207, o208, o209, o210, o211, o212, o213, o214, o215, o216, o217, o218, o219, o220, o221, o222, o223, o224, o225, o226, o227, o228, o229, o230); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80, Object o81, Object o82, Object o83, Object o84, Object o85, Object o86, Object o87, Object o88, Object o89, Object o90, Object o91, Object o92, Object o93, Object o94, Object o95, Object o96, Object o97, Object o98, Object o99, Object o100, Object o101, Object o102, Object o103, Object o104, Object o105, Object o106, Object o107, Object o108, Object o109, Object o110, Object o111, Object o112, Object o113, Object o114, Object o115, Object o116, Object o117, Object o118, Object o119, Object o120, Object o121, Object o122, Object o123, Object o124, Object o125, Object o126, Object o127, Object o128, Object o129, Object o130, Object o131, Object o132, Object o133, Object o134, Object o135, Object o136, Object o137, Object o138, Object o139, Object o140, Object o141, Object o142, Object o143, Object o144, Object o145, Object o146, Object o147, Object o148, Object o149, Object o150, Object o151, Object o152, Object o153, Object o154, Object o155, Object o156, Object o157, Object o158, Object o159, Object o160, Object o161, Object o162, Object o163, Object o164, Object o165, Object o166, Object o167, Object o168, Object o169, Object o170, Object o171, Object o172, Object o173, Object o174, Object o175, Object o176, Object o177, Object o178, Object o179, Object o180, Object o181, Object o182, Object o183, Object o184, Object o185, Object o186, Object o187, Object o188, Object o189, Object o190, Object o191, Object o192, Object o193, Object o194, Object o195, Object o196, Object o197, Object o198, Object o199, Object o200, Object o201, Object o202, Object o203, Object o204, Object o205, Object o206, Object o207, Object o208, Object o209, Object o210, Object o211, Object o212, Object o213, Object o214, Object o215, Object o216, Object o217, Object o218, Object o219, Object o220, Object o221, Object o222, Object o223, Object o224, Object o225, Object o226, Object o227, Object o228, Object o229, Object o230, Object o231) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80, o81, o82, o83, o84, o85, o86, o87, o88, o89, o90, o91, o92, o93, o94, o95, o96, o97, o98, o99, o100, o101, o102, o103, o104, o105, o106, o107, o108, o109, o110, o111, o112, o113, o114, o115, o116, o117, o118, o119, o120, o121, o122, o123, o124, o125, o126, o127, o128, o129, o130, o131, o132, o133, o134, o135, o136, o137, o138, o139, o140, o141, o142, o143, o144, o145, o146, o147, o148, o149, o150, o151, o152, o153, o154, o155, o156, o157, o158, o159, o160, o161, o162, o163, o164, o165, o166, o167, o168, o169, o170, o171, o172, o173, o174, o175, o176, o177, o178, o179, o180, o181, o182, o183, o184, o185, o186, o187, o188, o189, o190, o191, o192, o193, o194, o195, o196, o197, o198, o199, o200, o201, o202, o203, o204, o205, o206, o207, o208, o209, o210, o211, o212, o213, o214, o215, o216, o217, o218, o219, o220, o221, o222, o223, o224, o225, o226, o227, o228, o229, o230, o231); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80, Object o81, Object o82, Object o83, Object o84, Object o85, Object o86, Object o87, Object o88, Object o89, Object o90, Object o91, Object o92, Object o93, Object o94, Object o95, Object o96, Object o97, Object o98, Object o99, Object o100, Object o101, Object o102, Object o103, Object o104, Object o105, Object o106, Object o107, Object o108, Object o109, Object o110, Object o111, Object o112, Object o113, Object o114, Object o115, Object o116, Object o117, Object o118, Object o119, Object o120, Object o121, Object o122, Object o123, Object o124, Object o125, Object o126, Object o127, Object o128, Object o129, Object o130, Object o131, Object o132, Object o133, Object o134, Object o135, Object o136, Object o137, Object o138, Object o139, Object o140, Object o141, Object o142, Object o143, Object o144, Object o145, Object o146, Object o147, Object o148, Object o149, Object o150, Object o151, Object o152, Object o153, Object o154, Object o155, Object o156, Object o157, Object o158, Object o159, Object o160, Object o161, Object o162, Object o163, Object o164, Object o165, Object o166, Object o167, Object o168, Object o169, Object o170, Object o171, Object o172, Object o173, Object o174, Object o175, Object o176, Object o177, Object o178, Object o179, Object o180, Object o181, Object o182, Object o183, Object o184, Object o185, Object o186, Object o187, Object o188, Object o189, Object o190, Object o191, Object o192, Object o193, Object o194, Object o195, Object o196, Object o197, Object o198, Object o199, Object o200, Object o201, Object o202, Object o203, Object o204, Object o205, Object o206, Object o207, Object o208, Object o209, Object o210, Object o211, Object o212, Object o213, Object o214, Object o215, Object o216, Object o217, Object o218, Object o219, Object o220, Object o221, Object o222, Object o223, Object o224, Object o225, Object o226, Object o227, Object o228, Object o229, Object o230, Object o231, Object o232) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80, o81, o82, o83, o84, o85, o86, o87, o88, o89, o90, o91, o92, o93, o94, o95, o96, o97, o98, o99, o100, o101, o102, o103, o104, o105, o106, o107, o108, o109, o110, o111, o112, o113, o114, o115, o116, o117, o118, o119, o120, o121, o122, o123, o124, o125, o126, o127, o128, o129, o130, o131, o132, o133, o134, o135, o136, o137, o138, o139, o140, o141, o142, o143, o144, o145, o146, o147, o148, o149, o150, o151, o152, o153, o154, o155, o156, o157, o158, o159, o160, o161, o162, o163, o164, o165, o166, o167, o168, o169, o170, o171, o172, o173, o174, o175, o176, o177, o178, o179, o180, o181, o182, o183, o184, o185, o186, o187, o188, o189, o190, o191, o192, o193, o194, o195, o196, o197, o198, o199, o200, o201, o202, o203, o204, o205, o206, o207, o208, o209, o210, o211, o212, o213, o214, o215, o216, o217, o218, o219, o220, o221, o222, o223, o224, o225, o226, o227, o228, o229, o230, o231, o232); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80, Object o81, Object o82, Object o83, Object o84, Object o85, Object o86, Object o87, Object o88, Object o89, Object o90, Object o91, Object o92, Object o93, Object o94, Object o95, Object o96, Object o97, Object o98, Object o99, Object o100, Object o101, Object o102, Object o103, Object o104, Object o105, Object o106, Object o107, Object o108, Object o109, Object o110, Object o111, Object o112, Object o113, Object o114, Object o115, Object o116, Object o117, Object o118, Object o119, Object o120, Object o121, Object o122, Object o123, Object o124, Object o125, Object o126, Object o127, Object o128, Object o129, Object o130, Object o131, Object o132, Object o133, Object o134, Object o135, Object o136, Object o137, Object o138, Object o139, Object o140, Object o141, Object o142, Object o143, Object o144, Object o145, Object o146, Object o147, Object o148, Object o149, Object o150, Object o151, Object o152, Object o153, Object o154, Object o155, Object o156, Object o157, Object o158, Object o159, Object o160, Object o161, Object o162, Object o163, Object o164, Object o165, Object o166, Object o167, Object o168, Object o169, Object o170, Object o171, Object o172, Object o173, Object o174, Object o175, Object o176, Object o177, Object o178, Object o179, Object o180, Object o181, Object o182, Object o183, Object o184, Object o185, Object o186, Object o187, Object o188, Object o189, Object o190, Object o191, Object o192, Object o193, Object o194, Object o195, Object o196, Object o197, Object o198, Object o199, Object o200, Object o201, Object o202, Object o203, Object o204, Object o205, Object o206, Object o207, Object o208, Object o209, Object o210, Object o211, Object o212, Object o213, Object o214, Object o215, Object o216, Object o217, Object o218, Object o219, Object o220, Object o221, Object o222, Object o223, Object o224, Object o225, Object o226, Object o227, Object o228, Object o229, Object o230, Object o231, Object o232, Object o233) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80, o81, o82, o83, o84, o85, o86, o87, o88, o89, o90, o91, o92, o93, o94, o95, o96, o97, o98, o99, o100, o101, o102, o103, o104, o105, o106, o107, o108, o109, o110, o111, o112, o113, o114, o115, o116, o117, o118, o119, o120, o121, o122, o123, o124, o125, o126, o127, o128, o129, o130, o131, o132, o133, o134, o135, o136, o137, o138, o139, o140, o141, o142, o143, o144, o145, o146, o147, o148, o149, o150, o151, o152, o153, o154, o155, o156, o157, o158, o159, o160, o161, o162, o163, o164, o165, o166, o167, o168, o169, o170, o171, o172, o173, o174, o175, o176, o177, o178, o179, o180, o181, o182, o183, o184, o185, o186, o187, o188, o189, o190, o191, o192, o193, o194, o195, o196, o197, o198, o199, o200, o201, o202, o203, o204, o205, o206, o207, o208, o209, o210, o211, o212, o213, o214, o215, o216, o217, o218, o219, o220, o221, o222, o223, o224, o225, o226, o227, o228, o229, o230, o231, o232, o233); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80, Object o81, Object o82, Object o83, Object o84, Object o85, Object o86, Object o87, Object o88, Object o89, Object o90, Object o91, Object o92, Object o93, Object o94, Object o95, Object o96, Object o97, Object o98, Object o99, Object o100, Object o101, Object o102, Object o103, Object o104, Object o105, Object o106, Object o107, Object o108, Object o109, Object o110, Object o111, Object o112, Object o113, Object o114, Object o115, Object o116, Object o117, Object o118, Object o119, Object o120, Object o121, Object o122, Object o123, Object o124, Object o125, Object o126, Object o127, Object o128, Object o129, Object o130, Object o131, Object o132, Object o133, Object o134, Object o135, Object o136, Object o137, Object o138, Object o139, Object o140, Object o141, Object o142, Object o143, Object o144, Object o145, Object o146, Object o147, Object o148, Object o149, Object o150, Object o151, Object o152, Object o153, Object o154, Object o155, Object o156, Object o157, Object o158, Object o159, Object o160, Object o161, Object o162, Object o163, Object o164, Object o165, Object o166, Object o167, Object o168, Object o169, Object o170, Object o171, Object o172, Object o173, Object o174, Object o175, Object o176, Object o177, Object o178, Object o179, Object o180, Object o181, Object o182, Object o183, Object o184, Object o185, Object o186, Object o187, Object o188, Object o189, Object o190, Object o191, Object o192, Object o193, Object o194, Object o195, Object o196, Object o197, Object o198, Object o199, Object o200, Object o201, Object o202, Object o203, Object o204, Object o205, Object o206, Object o207, Object o208, Object o209, Object o210, Object o211, Object o212, Object o213, Object o214, Object o215, Object o216, Object o217, Object o218, Object o219, Object o220, Object o221, Object o222, Object o223, Object o224, Object o225, Object o226, Object o227, Object o228, Object o229, Object o230, Object o231, Object o232, Object o233, Object o234) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80, o81, o82, o83, o84, o85, o86, o87, o88, o89, o90, o91, o92, o93, o94, o95, o96, o97, o98, o99, o100, o101, o102, o103, o104, o105, o106, o107, o108, o109, o110, o111, o112, o113, o114, o115, o116, o117, o118, o119, o120, o121, o122, o123, o124, o125, o126, o127, o128, o129, o130, o131, o132, o133, o134, o135, o136, o137, o138, o139, o140, o141, o142, o143, o144, o145, o146, o147, o148, o149, o150, o151, o152, o153, o154, o155, o156, o157, o158, o159, o160, o161, o162, o163, o164, o165, o166, o167, o168, o169, o170, o171, o172, o173, o174, o175, o176, o177, o178, o179, o180, o181, o182, o183, o184, o185, o186, o187, o188, o189, o190, o191, o192, o193, o194, o195, o196, o197, o198, o199, o200, o201, o202, o203, o204, o205, o206, o207, o208, o209, o210, o211, o212, o213, o214, o215, o216, o217, o218, o219, o220, o221, o222, o223, o224, o225, o226, o227, o228, o229, o230, o231, o232, o233, o234); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80, Object o81, Object o82, Object o83, Object o84, Object o85, Object o86, Object o87, Object o88, Object o89, Object o90, Object o91, Object o92, Object o93, Object o94, Object o95, Object o96, Object o97, Object o98, Object o99, Object o100, Object o101, Object o102, Object o103, Object o104, Object o105, Object o106, Object o107, Object o108, Object o109, Object o110, Object o111, Object o112, Object o113, Object o114, Object o115, Object o116, Object o117, Object o118, Object o119, Object o120, Object o121, Object o122, Object o123, Object o124, Object o125, Object o126, Object o127, Object o128, Object o129, Object o130, Object o131, Object o132, Object o133, Object o134, Object o135, Object o136, Object o137, Object o138, Object o139, Object o140, Object o141, Object o142, Object o143, Object o144, Object o145, Object o146, Object o147, Object o148, Object o149, Object o150, Object o151, Object o152, Object o153, Object o154, Object o155, Object o156, Object o157, Object o158, Object o159, Object o160, Object o161, Object o162, Object o163, Object o164, Object o165, Object o166, Object o167, Object o168, Object o169, Object o170, Object o171, Object o172, Object o173, Object o174, Object o175, Object o176, Object o177, Object o178, Object o179, Object o180, Object o181, Object o182, Object o183, Object o184, Object o185, Object o186, Object o187, Object o188, Object o189, Object o190, Object o191, Object o192, Object o193, Object o194, Object o195, Object o196, Object o197, Object o198, Object o199, Object o200, Object o201, Object o202, Object o203, Object o204, Object o205, Object o206, Object o207, Object o208, Object o209, Object o210, Object o211, Object o212, Object o213, Object o214, Object o215, Object o216, Object o217, Object o218, Object o219, Object o220, Object o221, Object o222, Object o223, Object o224, Object o225, Object o226, Object o227, Object o228, Object o229, Object o230, Object o231, Object o232, Object o233, Object o234, Object o235) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80, o81, o82, o83, o84, o85, o86, o87, o88, o89, o90, o91, o92, o93, o94, o95, o96, o97, o98, o99, o100, o101, o102, o103, o104, o105, o106, o107, o108, o109, o110, o111, o112, o113, o114, o115, o116, o117, o118, o119, o120, o121, o122, o123, o124, o125, o126, o127, o128, o129, o130, o131, o132, o133, o134, o135, o136, o137, o138, o139, o140, o141, o142, o143, o144, o145, o146, o147, o148, o149, o150, o151, o152, o153, o154, o155, o156, o157, o158, o159, o160, o161, o162, o163, o164, o165, o166, o167, o168, o169, o170, o171, o172, o173, o174, o175, o176, o177, o178, o179, o180, o181, o182, o183, o184, o185, o186, o187, o188, o189, o190, o191, o192, o193, o194, o195, o196, o197, o198, o199, o200, o201, o202, o203, o204, o205, o206, o207, o208, o209, o210, o211, o212, o213, o214, o215, o216, o217, o218, o219, o220, o221, o222, o223, o224, o225, o226, o227, o228, o229, o230, o231, o232, o233, o234, o235); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80, Object o81, Object o82, Object o83, Object o84, Object o85, Object o86, Object o87, Object o88, Object o89, Object o90, Object o91, Object o92, Object o93, Object o94, Object o95, Object o96, Object o97, Object o98, Object o99, Object o100, Object o101, Object o102, Object o103, Object o104, Object o105, Object o106, Object o107, Object o108, Object o109, Object o110, Object o111, Object o112, Object o113, Object o114, Object o115, Object o116, Object o117, Object o118, Object o119, Object o120, Object o121, Object o122, Object o123, Object o124, Object o125, Object o126, Object o127, Object o128, Object o129, Object o130, Object o131, Object o132, Object o133, Object o134, Object o135, Object o136, Object o137, Object o138, Object o139, Object o140, Object o141, Object o142, Object o143, Object o144, Object o145, Object o146, Object o147, Object o148, Object o149, Object o150, Object o151, Object o152, Object o153, Object o154, Object o155, Object o156, Object o157, Object o158, Object o159, Object o160, Object o161, Object o162, Object o163, Object o164, Object o165, Object o166, Object o167, Object o168, Object o169, Object o170, Object o171, Object o172, Object o173, Object o174, Object o175, Object o176, Object o177, Object o178, Object o179, Object o180, Object o181, Object o182, Object o183, Object o184, Object o185, Object o186, Object o187, Object o188, Object o189, Object o190, Object o191, Object o192, Object o193, Object o194, Object o195, Object o196, Object o197, Object o198, Object o199, Object o200, Object o201, Object o202, Object o203, Object o204, Object o205, Object o206, Object o207, Object o208, Object o209, Object o210, Object o211, Object o212, Object o213, Object o214, Object o215, Object o216, Object o217, Object o218, Object o219, Object o220, Object o221, Object o222, Object o223, Object o224, Object o225, Object o226, Object o227, Object o228, Object o229, Object o230, Object o231, Object o232, Object o233, Object o234, Object o235, Object o236) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80, o81, o82, o83, o84, o85, o86, o87, o88, o89, o90, o91, o92, o93, o94, o95, o96, o97, o98, o99, o100, o101, o102, o103, o104, o105, o106, o107, o108, o109, o110, o111, o112, o113, o114, o115, o116, o117, o118, o119, o120, o121, o122, o123, o124, o125, o126, o127, o128, o129, o130, o131, o132, o133, o134, o135, o136, o137, o138, o139, o140, o141, o142, o143, o144, o145, o146, o147, o148, o149, o150, o151, o152, o153, o154, o155, o156, o157, o158, o159, o160, o161, o162, o163, o164, o165, o166, o167, o168, o169, o170, o171, o172, o173, o174, o175, o176, o177, o178, o179, o180, o181, o182, o183, o184, o185, o186, o187, o188, o189, o190, o191, o192, o193, o194, o195, o196, o197, o198, o199, o200, o201, o202, o203, o204, o205, o206, o207, o208, o209, o210, o211, o212, o213, o214, o215, o216, o217, o218, o219, o220, o221, o222, o223, o224, o225, o226, o227, o228, o229, o230, o231, o232, o233, o234, o235, o236); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80, Object o81, Object o82, Object o83, Object o84, Object o85, Object o86, Object o87, Object o88, Object o89, Object o90, Object o91, Object o92, Object o93, Object o94, Object o95, Object o96, Object o97, Object o98, Object o99, Object o100, Object o101, Object o102, Object o103, Object o104, Object o105, Object o106, Object o107, Object o108, Object o109, Object o110, Object o111, Object o112, Object o113, Object o114, Object o115, Object o116, Object o117, Object o118, Object o119, Object o120, Object o121, Object o122, Object o123, Object o124, Object o125, Object o126, Object o127, Object o128, Object o129, Object o130, Object o131, Object o132, Object o133, Object o134, Object o135, Object o136, Object o137, Object o138, Object o139, Object o140, Object o141, Object o142, Object o143, Object o144, Object o145, Object o146, Object o147, Object o148, Object o149, Object o150, Object o151, Object o152, Object o153, Object o154, Object o155, Object o156, Object o157, Object o158, Object o159, Object o160, Object o161, Object o162, Object o163, Object o164, Object o165, Object o166, Object o167, Object o168, Object o169, Object o170, Object o171, Object o172, Object o173, Object o174, Object o175, Object o176, Object o177, Object o178, Object o179, Object o180, Object o181, Object o182, Object o183, Object o184, Object o185, Object o186, Object o187, Object o188, Object o189, Object o190, Object o191, Object o192, Object o193, Object o194, Object o195, Object o196, Object o197, Object o198, Object o199, Object o200, Object o201, Object o202, Object o203, Object o204, Object o205, Object o206, Object o207, Object o208, Object o209, Object o210, Object o211, Object o212, Object o213, Object o214, Object o215, Object o216, Object o217, Object o218, Object o219, Object o220, Object o221, Object o222, Object o223, Object o224, Object o225, Object o226, Object o227, Object o228, Object o229, Object o230, Object o231, Object o232, Object o233, Object o234, Object o235, Object o236, Object o237) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80, o81, o82, o83, o84, o85, o86, o87, o88, o89, o90, o91, o92, o93, o94, o95, o96, o97, o98, o99, o100, o101, o102, o103, o104, o105, o106, o107, o108, o109, o110, o111, o112, o113, o114, o115, o116, o117, o118, o119, o120, o121, o122, o123, o124, o125, o126, o127, o128, o129, o130, o131, o132, o133, o134, o135, o136, o137, o138, o139, o140, o141, o142, o143, o144, o145, o146, o147, o148, o149, o150, o151, o152, o153, o154, o155, o156, o157, o158, o159, o160, o161, o162, o163, o164, o165, o166, o167, o168, o169, o170, o171, o172, o173, o174, o175, o176, o177, o178, o179, o180, o181, o182, o183, o184, o185, o186, o187, o188, o189, o190, o191, o192, o193, o194, o195, o196, o197, o198, o199, o200, o201, o202, o203, o204, o205, o206, o207, o208, o209, o210, o211, o212, o213, o214, o215, o216, o217, o218, o219, o220, o221, o222, o223, o224, o225, o226, o227, o228, o229, o230, o231, o232, o233, o234, o235, o236, o237); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80, Object o81, Object o82, Object o83, Object o84, Object o85, Object o86, Object o87, Object o88, Object o89, Object o90, Object o91, Object o92, Object o93, Object o94, Object o95, Object o96, Object o97, Object o98, Object o99, Object o100, Object o101, Object o102, Object o103, Object o104, Object o105, Object o106, Object o107, Object o108, Object o109, Object o110, Object o111, Object o112, Object o113, Object o114, Object o115, Object o116, Object o117, Object o118, Object o119, Object o120, Object o121, Object o122, Object o123, Object o124, Object o125, Object o126, Object o127, Object o128, Object o129, Object o130, Object o131, Object o132, Object o133, Object o134, Object o135, Object o136, Object o137, Object o138, Object o139, Object o140, Object o141, Object o142, Object o143, Object o144, Object o145, Object o146, Object o147, Object o148, Object o149, Object o150, Object o151, Object o152, Object o153, Object o154, Object o155, Object o156, Object o157, Object o158, Object o159, Object o160, Object o161, Object o162, Object o163, Object o164, Object o165, Object o166, Object o167, Object o168, Object o169, Object o170, Object o171, Object o172, Object o173, Object o174, Object o175, Object o176, Object o177, Object o178, Object o179, Object o180, Object o181, Object o182, Object o183, Object o184, Object o185, Object o186, Object o187, Object o188, Object o189, Object o190, Object o191, Object o192, Object o193, Object o194, Object o195, Object o196, Object o197, Object o198, Object o199, Object o200, Object o201, Object o202, Object o203, Object o204, Object o205, Object o206, Object o207, Object o208, Object o209, Object o210, Object o211, Object o212, Object o213, Object o214, Object o215, Object o216, Object o217, Object o218, Object o219, Object o220, Object o221, Object o222, Object o223, Object o224, Object o225, Object o226, Object o227, Object o228, Object o229, Object o230, Object o231, Object o232, Object o233, Object o234, Object o235, Object o236, Object o237, Object o238) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80, o81, o82, o83, o84, o85, o86, o87, o88, o89, o90, o91, o92, o93, o94, o95, o96, o97, o98, o99, o100, o101, o102, o103, o104, o105, o106, o107, o108, o109, o110, o111, o112, o113, o114, o115, o116, o117, o118, o119, o120, o121, o122, o123, o124, o125, o126, o127, o128, o129, o130, o131, o132, o133, o134, o135, o136, o137, o138, o139, o140, o141, o142, o143, o144, o145, o146, o147, o148, o149, o150, o151, o152, o153, o154, o155, o156, o157, o158, o159, o160, o161, o162, o163, o164, o165, o166, o167, o168, o169, o170, o171, o172, o173, o174, o175, o176, o177, o178, o179, o180, o181, o182, o183, o184, o185, o186, o187, o188, o189, o190, o191, o192, o193, o194, o195, o196, o197, o198, o199, o200, o201, o202, o203, o204, o205, o206, o207, o208, o209, o210, o211, o212, o213, o214, o215, o216, o217, o218, o219, o220, o221, o222, o223, o224, o225, o226, o227, o228, o229, o230, o231, o232, o233, o234, o235, o236, o237, o238); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80, Object o81, Object o82, Object o83, Object o84, Object o85, Object o86, Object o87, Object o88, Object o89, Object o90, Object o91, Object o92, Object o93, Object o94, Object o95, Object o96, Object o97, Object o98, Object o99, Object o100, Object o101, Object o102, Object o103, Object o104, Object o105, Object o106, Object o107, Object o108, Object o109, Object o110, Object o111, Object o112, Object o113, Object o114, Object o115, Object o116, Object o117, Object o118, Object o119, Object o120, Object o121, Object o122, Object o123, Object o124, Object o125, Object o126, Object o127, Object o128, Object o129, Object o130, Object o131, Object o132, Object o133, Object o134, Object o135, Object o136, Object o137, Object o138, Object o139, Object o140, Object o141, Object o142, Object o143, Object o144, Object o145, Object o146, Object o147, Object o148, Object o149, Object o150, Object o151, Object o152, Object o153, Object o154, Object o155, Object o156, Object o157, Object o158, Object o159, Object o160, Object o161, Object o162, Object o163, Object o164, Object o165, Object o166, Object o167, Object o168, Object o169, Object o170, Object o171, Object o172, Object o173, Object o174, Object o175, Object o176, Object o177, Object o178, Object o179, Object o180, Object o181, Object o182, Object o183, Object o184, Object o185, Object o186, Object o187, Object o188, Object o189, Object o190, Object o191, Object o192, Object o193, Object o194, Object o195, Object o196, Object o197, Object o198, Object o199, Object o200, Object o201, Object o202, Object o203, Object o204, Object o205, Object o206, Object o207, Object o208, Object o209, Object o210, Object o211, Object o212, Object o213, Object o214, Object o215, Object o216, Object o217, Object o218, Object o219, Object o220, Object o221, Object o222, Object o223, Object o224, Object o225, Object o226, Object o227, Object o228, Object o229, Object o230, Object o231, Object o232, Object o233, Object o234, Object o235, Object o236, Object o237, Object o238, Object o239) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80, o81, o82, o83, o84, o85, o86, o87, o88, o89, o90, o91, o92, o93, o94, o95, o96, o97, o98, o99, o100, o101, o102, o103, o104, o105, o106, o107, o108, o109, o110, o111, o112, o113, o114, o115, o116, o117, o118, o119, o120, o121, o122, o123, o124, o125, o126, o127, o128, o129, o130, o131, o132, o133, o134, o135, o136, o137, o138, o139, o140, o141, o142, o143, o144, o145, o146, o147, o148, o149, o150, o151, o152, o153, o154, o155, o156, o157, o158, o159, o160, o161, o162, o163, o164, o165, o166, o167, o168, o169, o170, o171, o172, o173, o174, o175, o176, o177, o178, o179, o180, o181, o182, o183, o184, o185, o186, o187, o188, o189, o190, o191, o192, o193, o194, o195, o196, o197, o198, o199, o200, o201, o202, o203, o204, o205, o206, o207, o208, o209, o210, o211, o212, o213, o214, o215, o216, o217, o218, o219, o220, o221, o222, o223, o224, o225, o226, o227, o228, o229, o230, o231, o232, o233, o234, o235, o236, o237, o238, o239); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80, Object o81, Object o82, Object o83, Object o84, Object o85, Object o86, Object o87, Object o88, Object o89, Object o90, Object o91, Object o92, Object o93, Object o94, Object o95, Object o96, Object o97, Object o98, Object o99, Object o100, Object o101, Object o102, Object o103, Object o104, Object o105, Object o106, Object o107, Object o108, Object o109, Object o110, Object o111, Object o112, Object o113, Object o114, Object o115, Object o116, Object o117, Object o118, Object o119, Object o120, Object o121, Object o122, Object o123, Object o124, Object o125, Object o126, Object o127, Object o128, Object o129, Object o130, Object o131, Object o132, Object o133, Object o134, Object o135, Object o136, Object o137, Object o138, Object o139, Object o140, Object o141, Object o142, Object o143, Object o144, Object o145, Object o146, Object o147, Object o148, Object o149, Object o150, Object o151, Object o152, Object o153, Object o154, Object o155, Object o156, Object o157, Object o158, Object o159, Object o160, Object o161, Object o162, Object o163, Object o164, Object o165, Object o166, Object o167, Object o168, Object o169, Object o170, Object o171, Object o172, Object o173, Object o174, Object o175, Object o176, Object o177, Object o178, Object o179, Object o180, Object o181, Object o182, Object o183, Object o184, Object o185, Object o186, Object o187, Object o188, Object o189, Object o190, Object o191, Object o192, Object o193, Object o194, Object o195, Object o196, Object o197, Object o198, Object o199, Object o200, Object o201, Object o202, Object o203, Object o204, Object o205, Object o206, Object o207, Object o208, Object o209, Object o210, Object o211, Object o212, Object o213, Object o214, Object o215, Object o216, Object o217, Object o218, Object o219, Object o220, Object o221, Object o222, Object o223, Object o224, Object o225, Object o226, Object o227, Object o228, Object o229, Object o230, Object o231, Object o232, Object o233, Object o234, Object o235, Object o236, Object o237, Object o238, Object o239, Object o240) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80, o81, o82, o83, o84, o85, o86, o87, o88, o89, o90, o91, o92, o93, o94, o95, o96, o97, o98, o99, o100, o101, o102, o103, o104, o105, o106, o107, o108, o109, o110, o111, o112, o113, o114, o115, o116, o117, o118, o119, o120, o121, o122, o123, o124, o125, o126, o127, o128, o129, o130, o131, o132, o133, o134, o135, o136, o137, o138, o139, o140, o141, o142, o143, o144, o145, o146, o147, o148, o149, o150, o151, o152, o153, o154, o155, o156, o157, o158, o159, o160, o161, o162, o163, o164, o165, o166, o167, o168, o169, o170, o171, o172, o173, o174, o175, o176, o177, o178, o179, o180, o181, o182, o183, o184, o185, o186, o187, o188, o189, o190, o191, o192, o193, o194, o195, o196, o197, o198, o199, o200, o201, o202, o203, o204, o205, o206, o207, o208, o209, o210, o211, o212, o213, o214, o215, o216, o217, o218, o219, o220, o221, o222, o223, o224, o225, o226, o227, o228, o229, o230, o231, o232, o233, o234, o235, o236, o237, o238, o239, o240); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80, Object o81, Object o82, Object o83, Object o84, Object o85, Object o86, Object o87, Object o88, Object o89, Object o90, Object o91, Object o92, Object o93, Object o94, Object o95, Object o96, Object o97, Object o98, Object o99, Object o100, Object o101, Object o102, Object o103, Object o104, Object o105, Object o106, Object o107, Object o108, Object o109, Object o110, Object o111, Object o112, Object o113, Object o114, Object o115, Object o116, Object o117, Object o118, Object o119, Object o120, Object o121, Object o122, Object o123, Object o124, Object o125, Object o126, Object o127, Object o128, Object o129, Object o130, Object o131, Object o132, Object o133, Object o134, Object o135, Object o136, Object o137, Object o138, Object o139, Object o140, Object o141, Object o142, Object o143, Object o144, Object o145, Object o146, Object o147, Object o148, Object o149, Object o150, Object o151, Object o152, Object o153, Object o154, Object o155, Object o156, Object o157, Object o158, Object o159, Object o160, Object o161, Object o162, Object o163, Object o164, Object o165, Object o166, Object o167, Object o168, Object o169, Object o170, Object o171, Object o172, Object o173, Object o174, Object o175, Object o176, Object o177, Object o178, Object o179, Object o180, Object o181, Object o182, Object o183, Object o184, Object o185, Object o186, Object o187, Object o188, Object o189, Object o190, Object o191, Object o192, Object o193, Object o194, Object o195, Object o196, Object o197, Object o198, Object o199, Object o200, Object o201, Object o202, Object o203, Object o204, Object o205, Object o206, Object o207, Object o208, Object o209, Object o210, Object o211, Object o212, Object o213, Object o214, Object o215, Object o216, Object o217, Object o218, Object o219, Object o220, Object o221, Object o222, Object o223, Object o224, Object o225, Object o226, Object o227, Object o228, Object o229, Object o230, Object o231, Object o232, Object o233, Object o234, Object o235, Object o236, Object o237, Object o238, Object o239, Object o240, Object o241) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80, o81, o82, o83, o84, o85, o86, o87, o88, o89, o90, o91, o92, o93, o94, o95, o96, o97, o98, o99, o100, o101, o102, o103, o104, o105, o106, o107, o108, o109, o110, o111, o112, o113, o114, o115, o116, o117, o118, o119, o120, o121, o122, o123, o124, o125, o126, o127, o128, o129, o130, o131, o132, o133, o134, o135, o136, o137, o138, o139, o140, o141, o142, o143, o144, o145, o146, o147, o148, o149, o150, o151, o152, o153, o154, o155, o156, o157, o158, o159, o160, o161, o162, o163, o164, o165, o166, o167, o168, o169, o170, o171, o172, o173, o174, o175, o176, o177, o178, o179, o180, o181, o182, o183, o184, o185, o186, o187, o188, o189, o190, o191, o192, o193, o194, o195, o196, o197, o198, o199, o200, o201, o202, o203, o204, o205, o206, o207, o208, o209, o210, o211, o212, o213, o214, o215, o216, o217, o218, o219, o220, o221, o222, o223, o224, o225, o226, o227, o228, o229, o230, o231, o232, o233, o234, o235, o236, o237, o238, o239, o240, o241); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80, Object o81, Object o82, Object o83, Object o84, Object o85, Object o86, Object o87, Object o88, Object o89, Object o90, Object o91, Object o92, Object o93, Object o94, Object o95, Object o96, Object o97, Object o98, Object o99, Object o100, Object o101, Object o102, Object o103, Object o104, Object o105, Object o106, Object o107, Object o108, Object o109, Object o110, Object o111, Object o112, Object o113, Object o114, Object o115, Object o116, Object o117, Object o118, Object o119, Object o120, Object o121, Object o122, Object o123, Object o124, Object o125, Object o126, Object o127, Object o128, Object o129, Object o130, Object o131, Object o132, Object o133, Object o134, Object o135, Object o136, Object o137, Object o138, Object o139, Object o140, Object o141, Object o142, Object o143, Object o144, Object o145, Object o146, Object o147, Object o148, Object o149, Object o150, Object o151, Object o152, Object o153, Object o154, Object o155, Object o156, Object o157, Object o158, Object o159, Object o160, Object o161, Object o162, Object o163, Object o164, Object o165, Object o166, Object o167, Object o168, Object o169, Object o170, Object o171, Object o172, Object o173, Object o174, Object o175, Object o176, Object o177, Object o178, Object o179, Object o180, Object o181, Object o182, Object o183, Object o184, Object o185, Object o186, Object o187, Object o188, Object o189, Object o190, Object o191, Object o192, Object o193, Object o194, Object o195, Object o196, Object o197, Object o198, Object o199, Object o200, Object o201, Object o202, Object o203, Object o204, Object o205, Object o206, Object o207, Object o208, Object o209, Object o210, Object o211, Object o212, Object o213, Object o214, Object o215, Object o216, Object o217, Object o218, Object o219, Object o220, Object o221, Object o222, Object o223, Object o224, Object o225, Object o226, Object o227, Object o228, Object o229, Object o230, Object o231, Object o232, Object o233, Object o234, Object o235, Object o236, Object o237, Object o238, Object o239, Object o240, Object o241, Object o242) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80, o81, o82, o83, o84, o85, o86, o87, o88, o89, o90, o91, o92, o93, o94, o95, o96, o97, o98, o99, o100, o101, o102, o103, o104, o105, o106, o107, o108, o109, o110, o111, o112, o113, o114, o115, o116, o117, o118, o119, o120, o121, o122, o123, o124, o125, o126, o127, o128, o129, o130, o131, o132, o133, o134, o135, o136, o137, o138, o139, o140, o141, o142, o143, o144, o145, o146, o147, o148, o149, o150, o151, o152, o153, o154, o155, o156, o157, o158, o159, o160, o161, o162, o163, o164, o165, o166, o167, o168, o169, o170, o171, o172, o173, o174, o175, o176, o177, o178, o179, o180, o181, o182, o183, o184, o185, o186, o187, o188, o189, o190, o191, o192, o193, o194, o195, o196, o197, o198, o199, o200, o201, o202, o203, o204, o205, o206, o207, o208, o209, o210, o211, o212, o213, o214, o215, o216, o217, o218, o219, o220, o221, o222, o223, o224, o225, o226, o227, o228, o229, o230, o231, o232, o233, o234, o235, o236, o237, o238, o239, o240, o241, o242); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80, Object o81, Object o82, Object o83, Object o84, Object o85, Object o86, Object o87, Object o88, Object o89, Object o90, Object o91, Object o92, Object o93, Object o94, Object o95, Object o96, Object o97, Object o98, Object o99, Object o100, Object o101, Object o102, Object o103, Object o104, Object o105, Object o106, Object o107, Object o108, Object o109, Object o110, Object o111, Object o112, Object o113, Object o114, Object o115, Object o116, Object o117, Object o118, Object o119, Object o120, Object o121, Object o122, Object o123, Object o124, Object o125, Object o126, Object o127, Object o128, Object o129, Object o130, Object o131, Object o132, Object o133, Object o134, Object o135, Object o136, Object o137, Object o138, Object o139, Object o140, Object o141, Object o142, Object o143, Object o144, Object o145, Object o146, Object o147, Object o148, Object o149, Object o150, Object o151, Object o152, Object o153, Object o154, Object o155, Object o156, Object o157, Object o158, Object o159, Object o160, Object o161, Object o162, Object o163, Object o164, Object o165, Object o166, Object o167, Object o168, Object o169, Object o170, Object o171, Object o172, Object o173, Object o174, Object o175, Object o176, Object o177, Object o178, Object o179, Object o180, Object o181, Object o182, Object o183, Object o184, Object o185, Object o186, Object o187, Object o188, Object o189, Object o190, Object o191, Object o192, Object o193, Object o194, Object o195, Object o196, Object o197, Object o198, Object o199, Object o200, Object o201, Object o202, Object o203, Object o204, Object o205, Object o206, Object o207, Object o208, Object o209, Object o210, Object o211, Object o212, Object o213, Object o214, Object o215, Object o216, Object o217, Object o218, Object o219, Object o220, Object o221, Object o222, Object o223, Object o224, Object o225, Object o226, Object o227, Object o228, Object o229, Object o230, Object o231, Object o232, Object o233, Object o234, Object o235, Object o236, Object o237, Object o238, Object o239, Object o240, Object o241, Object o242, Object o243) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80, o81, o82, o83, o84, o85, o86, o87, o88, o89, o90, o91, o92, o93, o94, o95, o96, o97, o98, o99, o100, o101, o102, o103, o104, o105, o106, o107, o108, o109, o110, o111, o112, o113, o114, o115, o116, o117, o118, o119, o120, o121, o122, o123, o124, o125, o126, o127, o128, o129, o130, o131, o132, o133, o134, o135, o136, o137, o138, o139, o140, o141, o142, o143, o144, o145, o146, o147, o148, o149, o150, o151, o152, o153, o154, o155, o156, o157, o158, o159, o160, o161, o162, o163, o164, o165, o166, o167, o168, o169, o170, o171, o172, o173, o174, o175, o176, o177, o178, o179, o180, o181, o182, o183, o184, o185, o186, o187, o188, o189, o190, o191, o192, o193, o194, o195, o196, o197, o198, o199, o200, o201, o202, o203, o204, o205, o206, o207, o208, o209, o210, o211, o212, o213, o214, o215, o216, o217, o218, o219, o220, o221, o222, o223, o224, o225, o226, o227, o228, o229, o230, o231, o232, o233, o234, o235, o236, o237, o238, o239, o240, o241, o242, o243); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80, Object o81, Object o82, Object o83, Object o84, Object o85, Object o86, Object o87, Object o88, Object o89, Object o90, Object o91, Object o92, Object o93, Object o94, Object o95, Object o96, Object o97, Object o98, Object o99, Object o100, Object o101, Object o102, Object o103, Object o104, Object o105, Object o106, Object o107, Object o108, Object o109, Object o110, Object o111, Object o112, Object o113, Object o114, Object o115, Object o116, Object o117, Object o118, Object o119, Object o120, Object o121, Object o122, Object o123, Object o124, Object o125, Object o126, Object o127, Object o128, Object o129, Object o130, Object o131, Object o132, Object o133, Object o134, Object o135, Object o136, Object o137, Object o138, Object o139, Object o140, Object o141, Object o142, Object o143, Object o144, Object o145, Object o146, Object o147, Object o148, Object o149, Object o150, Object o151, Object o152, Object o153, Object o154, Object o155, Object o156, Object o157, Object o158, Object o159, Object o160, Object o161, Object o162, Object o163, Object o164, Object o165, Object o166, Object o167, Object o168, Object o169, Object o170, Object o171, Object o172, Object o173, Object o174, Object o175, Object o176, Object o177, Object o178, Object o179, Object o180, Object o181, Object o182, Object o183, Object o184, Object o185, Object o186, Object o187, Object o188, Object o189, Object o190, Object o191, Object o192, Object o193, Object o194, Object o195, Object o196, Object o197, Object o198, Object o199, Object o200, Object o201, Object o202, Object o203, Object o204, Object o205, Object o206, Object o207, Object o208, Object o209, Object o210, Object o211, Object o212, Object o213, Object o214, Object o215, Object o216, Object o217, Object o218, Object o219, Object o220, Object o221, Object o222, Object o223, Object o224, Object o225, Object o226, Object o227, Object o228, Object o229, Object o230, Object o231, Object o232, Object o233, Object o234, Object o235, Object o236, Object o237, Object o238, Object o239, Object o240, Object o241, Object o242, Object o243, Object o244) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80, o81, o82, o83, o84, o85, o86, o87, o88, o89, o90, o91, o92, o93, o94, o95, o96, o97, o98, o99, o100, o101, o102, o103, o104, o105, o106, o107, o108, o109, o110, o111, o112, o113, o114, o115, o116, o117, o118, o119, o120, o121, o122, o123, o124, o125, o126, o127, o128, o129, o130, o131, o132, o133, o134, o135, o136, o137, o138, o139, o140, o141, o142, o143, o144, o145, o146, o147, o148, o149, o150, o151, o152, o153, o154, o155, o156, o157, o158, o159, o160, o161, o162, o163, o164, o165, o166, o167, o168, o169, o170, o171, o172, o173, o174, o175, o176, o177, o178, o179, o180, o181, o182, o183, o184, o185, o186, o187, o188, o189, o190, o191, o192, o193, o194, o195, o196, o197, o198, o199, o200, o201, o202, o203, o204, o205, o206, o207, o208, o209, o210, o211, o212, o213, o214, o215, o216, o217, o218, o219, o220, o221, o222, o223, o224, o225, o226, o227, o228, o229, o230, o231, o232, o233, o234, o235, o236, o237, o238, o239, o240, o241, o242, o243, o244); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80, Object o81, Object o82, Object o83, Object o84, Object o85, Object o86, Object o87, Object o88, Object o89, Object o90, Object o91, Object o92, Object o93, Object o94, Object o95, Object o96, Object o97, Object o98, Object o99, Object o100, Object o101, Object o102, Object o103, Object o104, Object o105, Object o106, Object o107, Object o108, Object o109, Object o110, Object o111, Object o112, Object o113, Object o114, Object o115, Object o116, Object o117, Object o118, Object o119, Object o120, Object o121, Object o122, Object o123, Object o124, Object o125, Object o126, Object o127, Object o128, Object o129, Object o130, Object o131, Object o132, Object o133, Object o134, Object o135, Object o136, Object o137, Object o138, Object o139, Object o140, Object o141, Object o142, Object o143, Object o144, Object o145, Object o146, Object o147, Object o148, Object o149, Object o150, Object o151, Object o152, Object o153, Object o154, Object o155, Object o156, Object o157, Object o158, Object o159, Object o160, Object o161, Object o162, Object o163, Object o164, Object o165, Object o166, Object o167, Object o168, Object o169, Object o170, Object o171, Object o172, Object o173, Object o174, Object o175, Object o176, Object o177, Object o178, Object o179, Object o180, Object o181, Object o182, Object o183, Object o184, Object o185, Object o186, Object o187, Object o188, Object o189, Object o190, Object o191, Object o192, Object o193, Object o194, Object o195, Object o196, Object o197, Object o198, Object o199, Object o200, Object o201, Object o202, Object o203, Object o204, Object o205, Object o206, Object o207, Object o208, Object o209, Object o210, Object o211, Object o212, Object o213, Object o214, Object o215, Object o216, Object o217, Object o218, Object o219, Object o220, Object o221, Object o222, Object o223, Object o224, Object o225, Object o226, Object o227, Object o228, Object o229, Object o230, Object o231, Object o232, Object o233, Object o234, Object o235, Object o236, Object o237, Object o238, Object o239, Object o240, Object o241, Object o242, Object o243, Object o244, Object o245) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80, o81, o82, o83, o84, o85, o86, o87, o88, o89, o90, o91, o92, o93, o94, o95, o96, o97, o98, o99, o100, o101, o102, o103, o104, o105, o106, o107, o108, o109, o110, o111, o112, o113, o114, o115, o116, o117, o118, o119, o120, o121, o122, o123, o124, o125, o126, o127, o128, o129, o130, o131, o132, o133, o134, o135, o136, o137, o138, o139, o140, o141, o142, o143, o144, o145, o146, o147, o148, o149, o150, o151, o152, o153, o154, o155, o156, o157, o158, o159, o160, o161, o162, o163, o164, o165, o166, o167, o168, o169, o170, o171, o172, o173, o174, o175, o176, o177, o178, o179, o180, o181, o182, o183, o184, o185, o186, o187, o188, o189, o190, o191, o192, o193, o194, o195, o196, o197, o198, o199, o200, o201, o202, o203, o204, o205, o206, o207, o208, o209, o210, o211, o212, o213, o214, o215, o216, o217, o218, o219, o220, o221, o222, o223, o224, o225, o226, o227, o228, o229, o230, o231, o232, o233, o234, o235, o236, o237, o238, o239, o240, o241, o242, o243, o244, o245); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80, Object o81, Object o82, Object o83, Object o84, Object o85, Object o86, Object o87, Object o88, Object o89, Object o90, Object o91, Object o92, Object o93, Object o94, Object o95, Object o96, Object o97, Object o98, Object o99, Object o100, Object o101, Object o102, Object o103, Object o104, Object o105, Object o106, Object o107, Object o108, Object o109, Object o110, Object o111, Object o112, Object o113, Object o114, Object o115, Object o116, Object o117, Object o118, Object o119, Object o120, Object o121, Object o122, Object o123, Object o124, Object o125, Object o126, Object o127, Object o128, Object o129, Object o130, Object o131, Object o132, Object o133, Object o134, Object o135, Object o136, Object o137, Object o138, Object o139, Object o140, Object o141, Object o142, Object o143, Object o144, Object o145, Object o146, Object o147, Object o148, Object o149, Object o150, Object o151, Object o152, Object o153, Object o154, Object o155, Object o156, Object o157, Object o158, Object o159, Object o160, Object o161, Object o162, Object o163, Object o164, Object o165, Object o166, Object o167, Object o168, Object o169, Object o170, Object o171, Object o172, Object o173, Object o174, Object o175, Object o176, Object o177, Object o178, Object o179, Object o180, Object o181, Object o182, Object o183, Object o184, Object o185, Object o186, Object o187, Object o188, Object o189, Object o190, Object o191, Object o192, Object o193, Object o194, Object o195, Object o196, Object o197, Object o198, Object o199, Object o200, Object o201, Object o202, Object o203, Object o204, Object o205, Object o206, Object o207, Object o208, Object o209, Object o210, Object o211, Object o212, Object o213, Object o214, Object o215, Object o216, Object o217, Object o218, Object o219, Object o220, Object o221, Object o222, Object o223, Object o224, Object o225, Object o226, Object o227, Object o228, Object o229, Object o230, Object o231, Object o232, Object o233, Object o234, Object o235, Object o236, Object o237, Object o238, Object o239, Object o240, Object o241, Object o242, Object o243, Object o244, Object o245, Object o246) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80, o81, o82, o83, o84, o85, o86, o87, o88, o89, o90, o91, o92, o93, o94, o95, o96, o97, o98, o99, o100, o101, o102, o103, o104, o105, o106, o107, o108, o109, o110, o111, o112, o113, o114, o115, o116, o117, o118, o119, o120, o121, o122, o123, o124, o125, o126, o127, o128, o129, o130, o131, o132, o133, o134, o135, o136, o137, o138, o139, o140, o141, o142, o143, o144, o145, o146, o147, o148, o149, o150, o151, o152, o153, o154, o155, o156, o157, o158, o159, o160, o161, o162, o163, o164, o165, o166, o167, o168, o169, o170, o171, o172, o173, o174, o175, o176, o177, o178, o179, o180, o181, o182, o183, o184, o185, o186, o187, o188, o189, o190, o191, o192, o193, o194, o195, o196, o197, o198, o199, o200, o201, o202, o203, o204, o205, o206, o207, o208, o209, o210, o211, o212, o213, o214, o215, o216, o217, o218, o219, o220, o221, o222, o223, o224, o225, o226, o227, o228, o229, o230, o231, o232, o233, o234, o235, o236, o237, o238, o239, o240, o241, o242, o243, o244, o245, o246); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80, Object o81, Object o82, Object o83, Object o84, Object o85, Object o86, Object o87, Object o88, Object o89, Object o90, Object o91, Object o92, Object o93, Object o94, Object o95, Object o96, Object o97, Object o98, Object o99, Object o100, Object o101, Object o102, Object o103, Object o104, Object o105, Object o106, Object o107, Object o108, Object o109, Object o110, Object o111, Object o112, Object o113, Object o114, Object o115, Object o116, Object o117, Object o118, Object o119, Object o120, Object o121, Object o122, Object o123, Object o124, Object o125, Object o126, Object o127, Object o128, Object o129, Object o130, Object o131, Object o132, Object o133, Object o134, Object o135, Object o136, Object o137, Object o138, Object o139, Object o140, Object o141, Object o142, Object o143, Object o144, Object o145, Object o146, Object o147, Object o148, Object o149, Object o150, Object o151, Object o152, Object o153, Object o154, Object o155, Object o156, Object o157, Object o158, Object o159, Object o160, Object o161, Object o162, Object o163, Object o164, Object o165, Object o166, Object o167, Object o168, Object o169, Object o170, Object o171, Object o172, Object o173, Object o174, Object o175, Object o176, Object o177, Object o178, Object o179, Object o180, Object o181, Object o182, Object o183, Object o184, Object o185, Object o186, Object o187, Object o188, Object o189, Object o190, Object o191, Object o192, Object o193, Object o194, Object o195, Object o196, Object o197, Object o198, Object o199, Object o200, Object o201, Object o202, Object o203, Object o204, Object o205, Object o206, Object o207, Object o208, Object o209, Object o210, Object o211, Object o212, Object o213, Object o214, Object o215, Object o216, Object o217, Object o218, Object o219, Object o220, Object o221, Object o222, Object o223, Object o224, Object o225, Object o226, Object o227, Object o228, Object o229, Object o230, Object o231, Object o232, Object o233, Object o234, Object o235, Object o236, Object o237, Object o238, Object o239, Object o240, Object o241, Object o242, Object o243, Object o244, Object o245, Object o246, Object o247) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80, o81, o82, o83, o84, o85, o86, o87, o88, o89, o90, o91, o92, o93, o94, o95, o96, o97, o98, o99, o100, o101, o102, o103, o104, o105, o106, o107, o108, o109, o110, o111, o112, o113, o114, o115, o116, o117, o118, o119, o120, o121, o122, o123, o124, o125, o126, o127, o128, o129, o130, o131, o132, o133, o134, o135, o136, o137, o138, o139, o140, o141, o142, o143, o144, o145, o146, o147, o148, o149, o150, o151, o152, o153, o154, o155, o156, o157, o158, o159, o160, o161, o162, o163, o164, o165, o166, o167, o168, o169, o170, o171, o172, o173, o174, o175, o176, o177, o178, o179, o180, o181, o182, o183, o184, o185, o186, o187, o188, o189, o190, o191, o192, o193, o194, o195, o196, o197, o198, o199, o200, o201, o202, o203, o204, o205, o206, o207, o208, o209, o210, o211, o212, o213, o214, o215, o216, o217, o218, o219, o220, o221, o222, o223, o224, o225, o226, o227, o228, o229, o230, o231, o232, o233, o234, o235, o236, o237, o238, o239, o240, o241, o242, o243, o244, o245, o246, o247); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80, Object o81, Object o82, Object o83, Object o84, Object o85, Object o86, Object o87, Object o88, Object o89, Object o90, Object o91, Object o92, Object o93, Object o94, Object o95, Object o96, Object o97, Object o98, Object o99, Object o100, Object o101, Object o102, Object o103, Object o104, Object o105, Object o106, Object o107, Object o108, Object o109, Object o110, Object o111, Object o112, Object o113, Object o114, Object o115, Object o116, Object o117, Object o118, Object o119, Object o120, Object o121, Object o122, Object o123, Object o124, Object o125, Object o126, Object o127, Object o128, Object o129, Object o130, Object o131, Object o132, Object o133, Object o134, Object o135, Object o136, Object o137, Object o138, Object o139, Object o140, Object o141, Object o142, Object o143, Object o144, Object o145, Object o146, Object o147, Object o148, Object o149, Object o150, Object o151, Object o152, Object o153, Object o154, Object o155, Object o156, Object o157, Object o158, Object o159, Object o160, Object o161, Object o162, Object o163, Object o164, Object o165, Object o166, Object o167, Object o168, Object o169, Object o170, Object o171, Object o172, Object o173, Object o174, Object o175, Object o176, Object o177, Object o178, Object o179, Object o180, Object o181, Object o182, Object o183, Object o184, Object o185, Object o186, Object o187, Object o188, Object o189, Object o190, Object o191, Object o192, Object o193, Object o194, Object o195, Object o196, Object o197, Object o198, Object o199, Object o200, Object o201, Object o202, Object o203, Object o204, Object o205, Object o206, Object o207, Object o208, Object o209, Object o210, Object o211, Object o212, Object o213, Object o214, Object o215, Object o216, Object o217, Object o218, Object o219, Object o220, Object o221, Object o222, Object o223, Object o224, Object o225, Object o226, Object o227, Object o228, Object o229, Object o230, Object o231, Object o232, Object o233, Object o234, Object o235, Object o236, Object o237, Object o238, Object o239, Object o240, Object o241, Object o242, Object o243, Object o244, Object o245, Object o246, Object o247, Object o248) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80, o81, o82, o83, o84, o85, o86, o87, o88, o89, o90, o91, o92, o93, o94, o95, o96, o97, o98, o99, o100, o101, o102, o103, o104, o105, o106, o107, o108, o109, o110, o111, o112, o113, o114, o115, o116, o117, o118, o119, o120, o121, o122, o123, o124, o125, o126, o127, o128, o129, o130, o131, o132, o133, o134, o135, o136, o137, o138, o139, o140, o141, o142, o143, o144, o145, o146, o147, o148, o149, o150, o151, o152, o153, o154, o155, o156, o157, o158, o159, o160, o161, o162, o163, o164, o165, o166, o167, o168, o169, o170, o171, o172, o173, o174, o175, o176, o177, o178, o179, o180, o181, o182, o183, o184, o185, o186, o187, o188, o189, o190, o191, o192, o193, o194, o195, o196, o197, o198, o199, o200, o201, o202, o203, o204, o205, o206, o207, o208, o209, o210, o211, o212, o213, o214, o215, o216, o217, o218, o219, o220, o221, o222, o223, o224, o225, o226, o227, o228, o229, o230, o231, o232, o233, o234, o235, o236, o237, o238, o239, o240, o241, o242, o243, o244, o245, o246, o247, o248); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80, Object o81, Object o82, Object o83, Object o84, Object o85, Object o86, Object o87, Object o88, Object o89, Object o90, Object o91, Object o92, Object o93, Object o94, Object o95, Object o96, Object o97, Object o98, Object o99, Object o100, Object o101, Object o102, Object o103, Object o104, Object o105, Object o106, Object o107, Object o108, Object o109, Object o110, Object o111, Object o112, Object o113, Object o114, Object o115, Object o116, Object o117, Object o118, Object o119, Object o120, Object o121, Object o122, Object o123, Object o124, Object o125, Object o126, Object o127, Object o128, Object o129, Object o130, Object o131, Object o132, Object o133, Object o134, Object o135, Object o136, Object o137, Object o138, Object o139, Object o140, Object o141, Object o142, Object o143, Object o144, Object o145, Object o146, Object o147, Object o148, Object o149, Object o150, Object o151, Object o152, Object o153, Object o154, Object o155, Object o156, Object o157, Object o158, Object o159, Object o160, Object o161, Object o162, Object o163, Object o164, Object o165, Object o166, Object o167, Object o168, Object o169, Object o170, Object o171, Object o172, Object o173, Object o174, Object o175, Object o176, Object o177, Object o178, Object o179, Object o180, Object o181, Object o182, Object o183, Object o184, Object o185, Object o186, Object o187, Object o188, Object o189, Object o190, Object o191, Object o192, Object o193, Object o194, Object o195, Object o196, Object o197, Object o198, Object o199, Object o200, Object o201, Object o202, Object o203, Object o204, Object o205, Object o206, Object o207, Object o208, Object o209, Object o210, Object o211, Object o212, Object o213, Object o214, Object o215, Object o216, Object o217, Object o218, Object o219, Object o220, Object o221, Object o222, Object o223, Object o224, Object o225, Object o226, Object o227, Object o228, Object o229, Object o230, Object o231, Object o232, Object o233, Object o234, Object o235, Object o236, Object o237, Object o238, Object o239, Object o240, Object o241, Object o242, Object o243, Object o244, Object o245, Object o246, Object o247, Object o248, Object o249) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80, o81, o82, o83, o84, o85, o86, o87, o88, o89, o90, o91, o92, o93, o94, o95, o96, o97, o98, o99, o100, o101, o102, o103, o104, o105, o106, o107, o108, o109, o110, o111, o112, o113, o114, o115, o116, o117, o118, o119, o120, o121, o122, o123, o124, o125, o126, o127, o128, o129, o130, o131, o132, o133, o134, o135, o136, o137, o138, o139, o140, o141, o142, o143, o144, o145, o146, o147, o148, o149, o150, o151, o152, o153, o154, o155, o156, o157, o158, o159, o160, o161, o162, o163, o164, o165, o166, o167, o168, o169, o170, o171, o172, o173, o174, o175, o176, o177, o178, o179, o180, o181, o182, o183, o184, o185, o186, o187, o188, o189, o190, o191, o192, o193, o194, o195, o196, o197, o198, o199, o200, o201, o202, o203, o204, o205, o206, o207, o208, o209, o210, o211, o212, o213, o214, o215, o216, o217, o218, o219, o220, o221, o222, o223, o224, o225, o226, o227, o228, o229, o230, o231, o232, o233, o234, o235, o236, o237, o238, o239, o240, o241, o242, o243, o244, o245, o246, o247, o248, o249); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80, Object o81, Object o82, Object o83, Object o84, Object o85, Object o86, Object o87, Object o88, Object o89, Object o90, Object o91, Object o92, Object o93, Object o94, Object o95, Object o96, Object o97, Object o98, Object o99, Object o100, Object o101, Object o102, Object o103, Object o104, Object o105, Object o106, Object o107, Object o108, Object o109, Object o110, Object o111, Object o112, Object o113, Object o114, Object o115, Object o116, Object o117, Object o118, Object o119, Object o120, Object o121, Object o122, Object o123, Object o124, Object o125, Object o126, Object o127, Object o128, Object o129, Object o130, Object o131, Object o132, Object o133, Object o134, Object o135, Object o136, Object o137, Object o138, Object o139, Object o140, Object o141, Object o142, Object o143, Object o144, Object o145, Object o146, Object o147, Object o148, Object o149, Object o150, Object o151, Object o152, Object o153, Object o154, Object o155, Object o156, Object o157, Object o158, Object o159, Object o160, Object o161, Object o162, Object o163, Object o164, Object o165, Object o166, Object o167, Object o168, Object o169, Object o170, Object o171, Object o172, Object o173, Object o174, Object o175, Object o176, Object o177, Object o178, Object o179, Object o180, Object o181, Object o182, Object o183, Object o184, Object o185, Object o186, Object o187, Object o188, Object o189, Object o190, Object o191, Object o192, Object o193, Object o194, Object o195, Object o196, Object o197, Object o198, Object o199, Object o200, Object o201, Object o202, Object o203, Object o204, Object o205, Object o206, Object o207, Object o208, Object o209, Object o210, Object o211, Object o212, Object o213, Object o214, Object o215, Object o216, Object o217, Object o218, Object o219, Object o220, Object o221, Object o222, Object o223, Object o224, Object o225, Object o226, Object o227, Object o228, Object o229, Object o230, Object o231, Object o232, Object o233, Object o234, Object o235, Object o236, Object o237, Object o238, Object o239, Object o240, Object o241, Object o242, Object o243, Object o244, Object o245, Object o246, Object o247, Object o248, Object o249, Object o250) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80, o81, o82, o83, o84, o85, o86, o87, o88, o89, o90, o91, o92, o93, o94, o95, o96, o97, o98, o99, o100, o101, o102, o103, o104, o105, o106, o107, o108, o109, o110, o111, o112, o113, o114, o115, o116, o117, o118, o119, o120, o121, o122, o123, o124, o125, o126, o127, o128, o129, o130, o131, o132, o133, o134, o135, o136, o137, o138, o139, o140, o141, o142, o143, o144, o145, o146, o147, o148, o149, o150, o151, o152, o153, o154, o155, o156, o157, o158, o159, o160, o161, o162, o163, o164, o165, o166, o167, o168, o169, o170, o171, o172, o173, o174, o175, o176, o177, o178, o179, o180, o181, o182, o183, o184, o185, o186, o187, o188, o189, o190, o191, o192, o193, o194, o195, o196, o197, o198, o199, o200, o201, o202, o203, o204, o205, o206, o207, o208, o209, o210, o211, o212, o213, o214, o215, o216, o217, o218, o219, o220, o221, o222, o223, o224, o225, o226, o227, o228, o229, o230, o231, o232, o233, o234, o235, o236, o237, o238, o239, o240, o241, o242, o243, o244, o245, o246, o247, o248, o249, o250); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80, Object o81, Object o82, Object o83, Object o84, Object o85, Object o86, Object o87, Object o88, Object o89, Object o90, Object o91, Object o92, Object o93, Object o94, Object o95, Object o96, Object o97, Object o98, Object o99, Object o100, Object o101, Object o102, Object o103, Object o104, Object o105, Object o106, Object o107, Object o108, Object o109, Object o110, Object o111, Object o112, Object o113, Object o114, Object o115, Object o116, Object o117, Object o118, Object o119, Object o120, Object o121, Object o122, Object o123, Object o124, Object o125, Object o126, Object o127, Object o128, Object o129, Object o130, Object o131, Object o132, Object o133, Object o134, Object o135, Object o136, Object o137, Object o138, Object o139, Object o140, Object o141, Object o142, Object o143, Object o144, Object o145, Object o146, Object o147, Object o148, Object o149, Object o150, Object o151, Object o152, Object o153, Object o154, Object o155, Object o156, Object o157, Object o158, Object o159, Object o160, Object o161, Object o162, Object o163, Object o164, Object o165, Object o166, Object o167, Object o168, Object o169, Object o170, Object o171, Object o172, Object o173, Object o174, Object o175, Object o176, Object o177, Object o178, Object o179, Object o180, Object o181, Object o182, Object o183, Object o184, Object o185, Object o186, Object o187, Object o188, Object o189, Object o190, Object o191, Object o192, Object o193, Object o194, Object o195, Object o196, Object o197, Object o198, Object o199, Object o200, Object o201, Object o202, Object o203, Object o204, Object o205, Object o206, Object o207, Object o208, Object o209, Object o210, Object o211, Object o212, Object o213, Object o214, Object o215, Object o216, Object o217, Object o218, Object o219, Object o220, Object o221, Object o222, Object o223, Object o224, Object o225, Object o226, Object o227, Object o228, Object o229, Object o230, Object o231, Object o232, Object o233, Object o234, Object o235, Object o236, Object o237, Object o238, Object o239, Object o240, Object o241, Object o242, Object o243, Object o244, Object o245, Object o246, Object o247, Object o248, Object o249, Object o250, Object o251) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80, o81, o82, o83, o84, o85, o86, o87, o88, o89, o90, o91, o92, o93, o94, o95, o96, o97, o98, o99, o100, o101, o102, o103, o104, o105, o106, o107, o108, o109, o110, o111, o112, o113, o114, o115, o116, o117, o118, o119, o120, o121, o122, o123, o124, o125, o126, o127, o128, o129, o130, o131, o132, o133, o134, o135, o136, o137, o138, o139, o140, o141, o142, o143, o144, o145, o146, o147, o148, o149, o150, o151, o152, o153, o154, o155, o156, o157, o158, o159, o160, o161, o162, o163, o164, o165, o166, o167, o168, o169, o170, o171, o172, o173, o174, o175, o176, o177, o178, o179, o180, o181, o182, o183, o184, o185, o186, o187, o188, o189, o190, o191, o192, o193, o194, o195, o196, o197, o198, o199, o200, o201, o202, o203, o204, o205, o206, o207, o208, o209, o210, o211, o212, o213, o214, o215, o216, o217, o218, o219, o220, o221, o222, o223, o224, o225, o226, o227, o228, o229, o230, o231, o232, o233, o234, o235, o236, o237, o238, o239, o240, o241, o242, o243, o244, o245, o246, o247, o248, o249, o250, o251); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80, Object o81, Object o82, Object o83, Object o84, Object o85, Object o86, Object o87, Object o88, Object o89, Object o90, Object o91, Object o92, Object o93, Object o94, Object o95, Object o96, Object o97, Object o98, Object o99, Object o100, Object o101, Object o102, Object o103, Object o104, Object o105, Object o106, Object o107, Object o108, Object o109, Object o110, Object o111, Object o112, Object o113, Object o114, Object o115, Object o116, Object o117, Object o118, Object o119, Object o120, Object o121, Object o122, Object o123, Object o124, Object o125, Object o126, Object o127, Object o128, Object o129, Object o130, Object o131, Object o132, Object o133, Object o134, Object o135, Object o136, Object o137, Object o138, Object o139, Object o140, Object o141, Object o142, Object o143, Object o144, Object o145, Object o146, Object o147, Object o148, Object o149, Object o150, Object o151, Object o152, Object o153, Object o154, Object o155, Object o156, Object o157, Object o158, Object o159, Object o160, Object o161, Object o162, Object o163, Object o164, Object o165, Object o166, Object o167, Object o168, Object o169, Object o170, Object o171, Object o172, Object o173, Object o174, Object o175, Object o176, Object o177, Object o178, Object o179, Object o180, Object o181, Object o182, Object o183, Object o184, Object o185, Object o186, Object o187, Object o188, Object o189, Object o190, Object o191, Object o192, Object o193, Object o194, Object o195, Object o196, Object o197, Object o198, Object o199, Object o200, Object o201, Object o202, Object o203, Object o204, Object o205, Object o206, Object o207, Object o208, Object o209, Object o210, Object o211, Object o212, Object o213, Object o214, Object o215, Object o216, Object o217, Object o218, Object o219, Object o220, Object o221, Object o222, Object o223, Object o224, Object o225, Object o226, Object o227, Object o228, Object o229, Object o230, Object o231, Object o232, Object o233, Object o234, Object o235, Object o236, Object o237, Object o238, Object o239, Object o240, Object o241, Object o242, Object o243, Object o244, Object o245, Object o246, Object o247, Object o248, Object o249, Object o250, Object o251, Object o252) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80, o81, o82, o83, o84, o85, o86, o87, o88, o89, o90, o91, o92, o93, o94, o95, o96, o97, o98, o99, o100, o101, o102, o103, o104, o105, o106, o107, o108, o109, o110, o111, o112, o113, o114, o115, o116, o117, o118, o119, o120, o121, o122, o123, o124, o125, o126, o127, o128, o129, o130, o131, o132, o133, o134, o135, o136, o137, o138, o139, o140, o141, o142, o143, o144, o145, o146, o147, o148, o149, o150, o151, o152, o153, o154, o155, o156, o157, o158, o159, o160, o161, o162, o163, o164, o165, o166, o167, o168, o169, o170, o171, o172, o173, o174, o175, o176, o177, o178, o179, o180, o181, o182, o183, o184, o185, o186, o187, o188, o189, o190, o191, o192, o193, o194, o195, o196, o197, o198, o199, o200, o201, o202, o203, o204, o205, o206, o207, o208, o209, o210, o211, o212, o213, o214, o215, o216, o217, o218, o219, o220, o221, o222, o223, o224, o225, o226, o227, o228, o229, o230, o231, o232, o233, o234, o235, o236, o237, o238, o239, o240, o241, o242, o243, o244, o245, o246, o247, o248, o249, o250, o251, o252); + } + + public MapViewResult(String key, Object o1, Object o2, Object o3, Object o4, Object o5, Object o6, Object o7, Object o8, Object o9, Object o10, Object o11, Object o12, Object o13, Object o14, Object o15, Object o16, Object o17, Object o18, Object o19, Object o20, Object o21, Object o22, Object o23, Object o24, Object o25, Object o26, Object o27, Object o28, Object o29, Object o30, Object o31, Object o32, Object o33, Object o34, Object o35, Object o36, Object o37, Object o38, Object o39, Object o40, Object o41, Object o42, Object o43, Object o44, Object o45, Object o46, Object o47, Object o48, Object o49, Object o50, Object o51, Object o52, Object o53, Object o54, Object o55, Object o56, Object o57, Object o58, Object o59, Object o60, Object o61, Object o62, Object o63, Object o64, Object o65, Object o66, Object o67, Object o68, Object o69, Object o70, Object o71, Object o72, Object o73, Object o74, Object o75, Object o76, Object o77, Object o78, Object o79, Object o80, Object o81, Object o82, Object o83, Object o84, Object o85, Object o86, Object o87, Object o88, Object o89, Object o90, Object o91, Object o92, Object o93, Object o94, Object o95, Object o96, Object o97, Object o98, Object o99, Object o100, Object o101, Object o102, Object o103, Object o104, Object o105, Object o106, Object o107, Object o108, Object o109, Object o110, Object o111, Object o112, Object o113, Object o114, Object o115, Object o116, Object o117, Object o118, Object o119, Object o120, Object o121, Object o122, Object o123, Object o124, Object o125, Object o126, Object o127, Object o128, Object o129, Object o130, Object o131, Object o132, Object o133, Object o134, Object o135, Object o136, Object o137, Object o138, Object o139, Object o140, Object o141, Object o142, Object o143, Object o144, Object o145, Object o146, Object o147, Object o148, Object o149, Object o150, Object o151, Object o152, Object o153, Object o154, Object o155, Object o156, Object o157, Object o158, Object o159, Object o160, Object o161, Object o162, Object o163, Object o164, Object o165, Object o166, Object o167, Object o168, Object o169, Object o170, Object o171, Object o172, Object o173, Object o174, Object o175, Object o176, Object o177, Object o178, Object o179, Object o180, Object o181, Object o182, Object o183, Object o184, Object o185, Object o186, Object o187, Object o188, Object o189, Object o190, Object o191, Object o192, Object o193, Object o194, Object o195, Object o196, Object o197, Object o198, Object o199, Object o200, Object o201, Object o202, Object o203, Object o204, Object o205, Object o206, Object o207, Object o208, Object o209, Object o210, Object o211, Object o212, Object o213, Object o214, Object o215, Object o216, Object o217, Object o218, Object o219, Object o220, Object o221, Object o222, Object o223, Object o224, Object o225, Object o226, Object o227, Object o228, Object o229, Object o230, Object o231, Object o232, Object o233, Object o234, Object o235, Object o236, Object o237, Object o238, Object o239, Object o240, Object o241, Object o242, Object o243, Object o244, Object o245, Object o246, Object o247, Object o248, Object o249, Object o250, Object o251, Object o252, Object o253) { + this.build(key, o1, o2, o3, o4, o5, o6, o7, o8, o9, o10, o11, o12, o13, o14, o15, o16, o17, o18, o19, o20, o21, o22, o23, o24, o25, o26, o27, o28, o29, o30, o31, o32, o33, o34, o35, o36, o37, o38, o39, o40, o41, o42, o43, o44, o45, o46, o47, o48, o49, o50, o51, o52, o53, o54, o55, o56, o57, o58, o59, o60, o61, o62, o63, o64, o65, o66, o67, o68, o69, o70, o71, o72, o73, o74, o75, o76, o77, o78, o79, o80, o81, o82, o83, o84, o85, o86, o87, o88, o89, o90, o91, o92, o93, o94, o95, o96, o97, o98, o99, o100, o101, o102, o103, o104, o105, o106, o107, o108, o109, o110, o111, o112, o113, o114, o115, o116, o117, o118, o119, o120, o121, o122, o123, o124, o125, o126, o127, o128, o129, o130, o131, o132, o133, o134, o135, o136, o137, o138, o139, o140, o141, o142, o143, o144, o145, o146, o147, o148, o149, o150, o151, o152, o153, o154, o155, o156, o157, o158, o159, o160, o161, o162, o163, o164, o165, o166, o167, o168, o169, o170, o171, o172, o173, o174, o175, o176, o177, o178, o179, o180, o181, o182, o183, o184, o185, o186, o187, o188, o189, o190, o191, o192, o193, o194, o195, o196, o197, o198, o199, o200, o201, o202, o203, o204, o205, o206, o207, o208, o209, o210, o211, o212, o213, o214, o215, o216, o217, o218, o219, o220, o221, o222, o223, o224, o225, o226, o227, o228, o229, o230, o231, o232, o233, o234, o235, o236, o237, o238, o239, o240, o241, o242, o243, o244, o245, o246, o247, o248, o249, o250, o251, o252, o253); + } + + private void build(String key, Object... values) { + QueryColumns queryColumns = QueryColumnsContext.getInstance().getQueryColumns(key); + List columns = queryColumns.getColumnAlias(); + for (int i = 0; i < columns.size(); i++) { + String column = columns.get(i); + Object value = values[i]; + this.put(column, value); + } + } +} diff --git a/springboot-starter-data-fast/src/main/java/com/codingapi/springboot/fast/jpa/map/QueryColumns.java b/springboot-starter-data-fast/src/main/java/com/codingapi/springboot/fast/jpa/map/QueryColumns.java new file mode 100644 index 000000000..c63d0214c --- /dev/null +++ b/springboot-starter-data-fast/src/main/java/com/codingapi/springboot/fast/jpa/map/QueryColumns.java @@ -0,0 +1,53 @@ +package com.codingapi.springboot.fast.jpa.map; + +import com.codingapi.springboot.framework.utils.RandomGenerator; +import lombok.Getter; + +import java.util.ArrayList; +import java.util.List; + +@Getter +public class QueryColumns { + private final String key; + private final List columns; + + QueryColumns() { + this.key = RandomGenerator.randomString(8); + this.columns = new ArrayList<>(); + } + + public QueryColumns addColumn(String column) { + this.columns.add(column); + return this; + } + + List getColumnAlias(){ + List columnAlias = new ArrayList<>(); + for (String column : columns) { + if(column.contains("as ") ) { + String[] parts = column.split("as "); + String alias = parts[parts.length - 1]; + columnAlias.add(alias.trim()); + continue; + } + if(column.contains("AS ") ) { + String[] parts = column.split("AS "); + String alias = parts[parts.length - 1]; + columnAlias.add(alias.trim()); + continue; + } + if(column.contains(".") ) { + String[] parts = column.split("\\."); + String alias = parts[parts.length - 1]; + columnAlias.add(alias.trim()); + continue; + } + columnAlias.add(column.trim()); + } + return columnAlias; + } + + public String getColumnSql() { + return String.join(",", columns); + } +} diff --git a/springboot-starter-data-fast/src/main/java/com/codingapi/springboot/fast/jpa/map/QueryColumnsContext.java b/springboot-starter-data-fast/src/main/java/com/codingapi/springboot/fast/jpa/map/QueryColumnsContext.java new file mode 100644 index 000000000..f2b8d50a7 --- /dev/null +++ b/springboot-starter-data-fast/src/main/java/com/codingapi/springboot/fast/jpa/map/QueryColumnsContext.java @@ -0,0 +1,35 @@ +package com.codingapi.springboot.fast.jpa.map; + +import lombok.Getter; + +import java.util.HashMap; +import java.util.Map; + +@Getter +public class QueryColumnsContext { + private final Map cache = new HashMap<>(); + @Getter + private final static QueryColumnsContext instance = new QueryColumnsContext(); + + private QueryColumnsContext() { + + } + + public static QueryColumns build(String ... columns) { + QueryColumns mapColumn = new QueryColumns(); + for (String column : columns) { + mapColumn.addColumn(column); + } + QueryColumnsContext.getInstance().cache.put(mapColumn.getKey(), mapColumn); + return mapColumn; + } + + + QueryColumns getQueryColumns(String key) { + return this.cache.get(key); + } + + public void clearCache(String key) { + this.cache.remove(key); + } +} diff --git a/springboot-starter-data-fast/src/main/java/com/codingapi/springboot/fast/jpa/repository/BaseRepository.java b/springboot-starter-data-fast/src/main/java/com/codingapi/springboot/fast/jpa/repository/BaseRepository.java new file mode 100644 index 000000000..b4200b97f --- /dev/null +++ b/springboot-starter-data-fast/src/main/java/com/codingapi/springboot/fast/jpa/repository/BaseRepository.java @@ -0,0 +1,16 @@ +package com.codingapi.springboot.fast.jpa.repository; + +import org.springframework.core.ResolvableType; +import org.springframework.data.jpa.repository.JpaRepository; +import org.springframework.data.repository.NoRepositoryBean; + +@NoRepositoryBean +public interface BaseRepository extends JpaRepository { + + @SuppressWarnings("unchecked") + default Class getEntityClass() { + ResolvableType resolvableType = ResolvableType.forClass(getClass()).as(BaseRepository.class); + return (Class) resolvableType.getGeneric(0).resolve(); + } + +} diff --git a/springboot-starter-data-fast/src/main/java/com/codingapi/springboot/fast/jpa/repository/DynamicNativeRepository.java b/springboot-starter-data-fast/src/main/java/com/codingapi/springboot/fast/jpa/repository/DynamicNativeRepository.java new file mode 100644 index 000000000..3adf38542 --- /dev/null +++ b/springboot-starter-data-fast/src/main/java/com/codingapi/springboot/fast/jpa/repository/DynamicNativeRepository.java @@ -0,0 +1,67 @@ +package com.codingapi.springboot.fast.jpa.repository; + +import com.codingapi.springboot.fast.jdbc.JdbcQueryContext; +import com.codingapi.springboot.fast.jpa.SQLBuilder; +import org.springframework.data.domain.Page; +import org.springframework.data.domain.PageRequest; +import org.springframework.data.repository.NoRepositoryBean; + +import java.util.List; +import java.util.Map; + +@NoRepositoryBean +public interface DynamicNativeRepository extends BaseRepository { + + default List> dynamicNativeListMapQuery(SQLBuilder builder) { + return JdbcQueryContext.getInstance().getJdbcQuery().queryForMapList(builder); + } + + default List> dynamicNativeListMapQuery(String sql, Object... params) { + return JdbcQueryContext.getInstance().getJdbcQuery().queryForMapList(sql, params); + } + + default List dynamicNativeListQuery(String sql, Object... params) { + return dynamicNativeListQuery(getEntityClass(), sql, params); + } + + default List dynamicNativeListQuery(Class clazz, String sql, Object... params) { + return JdbcQueryContext.getInstance().getJdbcQuery().queryForList(sql, clazz, params); + } + + default List dynamicNativeListQuery(SQLBuilder sqlBuilder) { + return JdbcQueryContext.getInstance().getJdbcQuery().queryForList(sqlBuilder); + } + + default Page dynamicNativePageQuery(String sql, String countSql, PageRequest request, Object... params) { + return dynamicNativePageQuery(getEntityClass(), sql, countSql, request, params); + } + + default Page dynamicNativePageQuery(String sql, PageRequest request, Object... params) { + return dynamicNativePageQuery(getEntityClass(), sql, request, params); + } + + default Page dynamicNativePageQuery(Class clazz, String sql, String countSql, PageRequest request, Object... params) { + return JdbcQueryContext.getInstance().getJdbcQuery().queryForPage(sql, countSql, clazz, request, params); + } + + default Page dynamicNativePageQuery(Class clazz, String sql, PageRequest request, Object... params) { + return JdbcQueryContext.getInstance().getJdbcQuery().queryForPage(sql, clazz, request, params); + } + + default Page dynamicNativePageQuery(SQLBuilder sqlBuilder, PageRequest request) { + return JdbcQueryContext.getInstance().getJdbcQuery().queryForPage(sqlBuilder, request); + } + + default Page> dynamicNativeMapPageMapQuery(SQLBuilder sqlBuilder,PageRequest request) { + return JdbcQueryContext.getInstance().getJdbcQuery().queryForMapPage(sqlBuilder,request); + } + + default Page> dynamicNativeMapPageMapQuery(String sql, String countSql, PageRequest request, Object... params) { + return JdbcQueryContext.getInstance().getJdbcQuery().queryForMapPage(sql, countSql, request, params); + } + + default Page> dynamicNativeMapPageMapQuery(String sql, PageRequest request, Object... params) { + return JdbcQueryContext.getInstance().getJdbcQuery().queryForMapPage(sql, request, params); + } + +} diff --git a/springboot-starter-data-fast/src/main/java/com/codingapi/springboot/fast/jpa/repository/DynamicRepository.java b/springboot-starter-data-fast/src/main/java/com/codingapi/springboot/fast/jpa/repository/DynamicRepository.java new file mode 100644 index 000000000..77f1758df --- /dev/null +++ b/springboot-starter-data-fast/src/main/java/com/codingapi/springboot/fast/jpa/repository/DynamicRepository.java @@ -0,0 +1,52 @@ +package com.codingapi.springboot.fast.jpa.repository; + +import com.codingapi.springboot.fast.jpa.JpaQueryContext; +import com.codingapi.springboot.fast.jpa.SQLBuilder; +import com.codingapi.springboot.fast.jpa.map.MapViewResult; +import com.codingapi.springboot.fast.jpa.map.QueryColumns; +import org.springframework.data.domain.Page; +import org.springframework.data.domain.PageRequest; +import org.springframework.data.repository.NoRepositoryBean; + +import java.util.List; + +@NoRepositoryBean +public interface DynamicRepository extends BaseRepository { + + default List dynamicListQuery(SQLBuilder builder) { + return JpaQueryContext.getInstance().getJpaQuery().listQuery(builder); + } + + default List dynamicListQuery(String sql, Object... params) { + return JpaQueryContext.getInstance().getJpaQuery().listQuery(getEntityClass(), sql, params); + } + + default List dynamicListQuery(Class clazz, String sql, Object... params) { + return JpaQueryContext.getInstance().getJpaQuery().listQuery(clazz, sql, params); + } + + default Page dynamicPageQuery(SQLBuilder builder, PageRequest request) { + return JpaQueryContext.getInstance().getJpaQuery().pageQuery(builder, request); + } + + default Page dynamicPageQuery(String sql, String countSql, PageRequest request, Object... params) { + return JpaQueryContext.getInstance().getJpaQuery().pageQuery(getEntityClass(), sql, countSql, request, params); + } + + default Page dynamicPageQuery(String sql, PageRequest request, Object... params) { + return JpaQueryContext.getInstance().getJpaQuery().pageQuery(getEntityClass(), sql, request, params); + } + + default Page dynamicPageQuery(Class clazz, String sql, String countSql, PageRequest request, Object... params) { + return JpaQueryContext.getInstance().getJpaQuery().pageQuery(clazz, sql, countSql, request, params); + } + + default Page dynamicMapPageQuery(QueryColumns columns, String sql, String countSql, PageRequest request, Object... params) { + return JpaQueryContext.getInstance().getJpaQuery().pageMapQuery(columns, sql, countSql, request, params); + } + + default List dynamicMapListQuery(QueryColumns columns, String sql, Object... params) { + return JpaQueryContext.getInstance().getJpaQuery().listMapQuery(columns, sql, params); + } + +} diff --git a/springboot-starter-data-fast/src/main/java/com/codingapi/springboot/fast/jpa/repository/DynamicSQLBuilder.java b/springboot-starter-data-fast/src/main/java/com/codingapi/springboot/fast/jpa/repository/DynamicSQLBuilder.java new file mode 100644 index 000000000..7e159a840 --- /dev/null +++ b/springboot-starter-data-fast/src/main/java/com/codingapi/springboot/fast/jpa/repository/DynamicSQLBuilder.java @@ -0,0 +1,193 @@ +package com.codingapi.springboot.fast.jpa.repository; + +import com.codingapi.springboot.framework.dto.request.Filter; +import com.codingapi.springboot.framework.dto.request.PageRequest; +import com.codingapi.springboot.framework.dto.request.RequestFilter; +import lombok.extern.slf4j.Slf4j; +import org.springframework.data.domain.Sort; + +import java.util.ArrayList; +import java.util.Arrays; +import java.util.List; + +/** + * 动态条件查询组装 + */ +@Slf4j +class DynamicSQLBuilder { + + private final PageRequest request; + + private final List params = new ArrayList<>(); + private int paramIndex = 1; + private final StringBuilder hql; + private final StringBuilder countHql ; + + public DynamicSQLBuilder(PageRequest request, Class clazz) { + this.request = request; + this.hql = new StringBuilder("FROM " + clazz.getSimpleName() + " WHERE "); + this.countHql = new StringBuilder("SELECT COUNT(1) FROM " + clazz.getSimpleName() + " WHERE "); + this.build(); + } + + public String getHQL(){ + return this.hql.toString(); + } + + public String getCountHQL(){ + return this.countHql.toString(); + } + + private void build() { + StringBuilder querySQL = new StringBuilder(); + StringBuilder orderSQL = new StringBuilder(); + RequestFilter requestFilter = request.getRequestFilter(); + if (requestFilter.hasFilter()) { + List filters = requestFilter.getFilters(); + // 逐条构建后过滤空片段（如空的 OR/AND 组合），避免拼出 "WHERE AND " 这类非法 HQL + List segments = new ArrayList<>(); + for (Filter filter : filters) { + StringBuilder segmentSQL = new StringBuilder(); + this.buildSQL(filter, segmentSQL); + if (segmentSQL.length() > 0) { + segments.add(segmentSQL.toString()); + } + } + querySQL.append(String.join(" AND ", segments)); + } + + Sort sort = request.getSort(); + if (sort.isSorted()) { + orderSQL.append(" ORDER BY "); + List orders = sort.toList(); + for (int i = 0; i < orders.size(); i++) { + Sort.Order order = orders.get(i); + orderSQL.append(order.getProperty()).append(" ").append(order.getDirection().name()); + if (i != orders.size() - 1) { + orderSQL.append(","); + } + } + } + + this.hql.append(querySQL); + this.hql.append(orderSQL); + this.countHql.append(querySQL); + + log.debug("hql:{}", hql); + log.debug("params:{}", params); + + } + + + private void buildSQL(Filter filter, StringBuilder hql) { + if (filter.isOrFilters()) { + Filter[] orFilters = (Filter[]) filter.getValue(); + if (orFilters.length > 0) { + hql.append(" ( "); + for (int i = 0; i < orFilters.length; i++) { + Filter orFilter = orFilters[i]; + this.buildSQL(orFilter, hql); + if (i != orFilters.length - 1) { + hql.append(" OR "); + } + + } + hql.append(" )"); + } + } + + if (filter.isAndFilters()) { + Filter[] andFilters = (Filter[]) filter.getValue(); + if (andFilters.length > 0) { + hql.append(" ( "); + for (int i = 0; i < andFilters.length; i++) { + Filter andFilter = andFilters[i]; + this.buildSQL(andFilter, hql); + if (i != andFilters.length - 1) { + hql.append(" AND "); + } + } + hql.append(" )"); + } + } + + if (filter.isEqual()) { + hql.append(filter.getKey()).append(" = ?").append(paramIndex); + params.add(filter.getValue()[0]); + paramIndex++; + } + + if (filter.isNull()) { + hql.append(filter.getKey()).append(" IS NULL "); + } + + if (filter.isNotNull()) { + hql.append(filter.getKey()).append(" IS NOT NULL "); + } + + if (filter.isNotEqual()) { + hql.append(filter.getKey()).append(" != ?").append(paramIndex); + params.add(filter.getValue()[0]); + paramIndex++; + } + + if (filter.isLike()) { + hql.append(filter.getKey()).append(" LIKE ?").append(paramIndex); + params.add("%" + filter.getValue()[0] + "%"); + paramIndex++; + } + if (filter.isLeftLike()) { + hql.append(filter.getKey()).append(" LIKE ?").append(paramIndex); + params.add("%" + filter.getValue()[0]); + paramIndex++; + } + if (filter.isRightLike()) { + hql.append(filter.getKey()).append(" LIKE ?").append(paramIndex); + params.add(filter.getValue()[0] + "%"); + paramIndex++; + } + if (filter.isIn()) { + hql.append(filter.getKey()).append(" IN (").append("?").append(paramIndex).append(")"); + params.add(Arrays.asList(filter.getValue())); + paramIndex++; + } + + if (filter.isNotIn()) { + hql.append(filter.getKey()).append(" NOT IN (").append("?").append(paramIndex).append(")"); + params.add(Arrays.asList(filter.getValue())); + paramIndex++; + } + if (filter.isGreaterThan()) { + hql.append(filter.getKey()).append(" > ?").append(paramIndex); + params.add(filter.getValue()[0]); + paramIndex++; + } + if (filter.isLessThan()) { + hql.append(filter.getKey()).append(" < ?").append(paramIndex); + params.add(filter.getValue()[0]); + paramIndex++; + } + if (filter.isGreaterThanEqual()) { + hql.append(filter.getKey()).append(" >= ?").append(paramIndex); + params.add(filter.getValue()[0]); + paramIndex++; + } + if (filter.isLessThanEqual()) { + hql.append(filter.getKey()).append(" <= ?").append(paramIndex); + params.add(filter.getValue()[0]); + paramIndex++; + } + if (filter.isBetween()) { + hql.append(filter.getKey()).append(" BETWEEN ?").append(paramIndex).append(" AND ?").append(paramIndex + 1); + params.add(filter.getValue()[0]); + params.add(filter.getValue()[1]); + paramIndex += 2; + } + } + + + public Object[] getParams() { + return params.toArray(); + } + +} diff --git a/springboot-starter-data-fast/src/main/java/com/codingapi/springboot/fast/jpa/repository/ExampleBuilder.java b/springboot-starter-data-fast/src/main/java/com/codingapi/springboot/fast/jpa/repository/ExampleBuilder.java new file mode 100644 index 000000000..743f23139 --- /dev/null +++ b/springboot-starter-data-fast/src/main/java/com/codingapi/springboot/fast/jpa/repository/ExampleBuilder.java @@ -0,0 +1,51 @@ +package com.codingapi.springboot.fast.jpa.repository; + +import com.codingapi.springboot.framework.dto.request.Filter; +import com.codingapi.springboot.framework.dto.request.PageRequest; +import com.codingapi.springboot.framework.dto.request.RequestFilter; +import org.springframework.beans.BeanUtils; +import org.springframework.data.domain.Example; + +import java.beans.PropertyDescriptor; + +/** + * Example组装 + */ +class ExampleBuilder { + + private final PageRequest request; + private final Class clazz; + + public ExampleBuilder(PageRequest request, Class clazz) { + this.request = request; + this.clazz = clazz; + } + + public Example getExample() { + RequestFilter requestFilter = request.getRequestFilter(); + if (!requestFilter.hasFilter()) { + return null; + } + Object entity = null; + try { + entity = clazz.getDeclaredConstructor().newInstance(); + } catch (Exception e) { + throw new RuntimeException(e); + } + PropertyDescriptor[] descriptors = BeanUtils.getPropertyDescriptors(clazz); + for (PropertyDescriptor descriptor : descriptors) { + String name = descriptor.getName(); + Filter value = requestFilter.getFilter(name); + if (value != null && descriptor.getWriteMethod() != null) { + try { + descriptor.getWriteMethod().invoke(entity, value.getFilterValue(descriptor.getPropertyType())); + } catch (Exception e) { + // 不再静默吞掉异常：过滤条件写入失败会导致查询结果错误，必须显式暴露 + throw new IllegalStateException("Build Example filter failed for property '" + name + "': " + e.getMessage(), e); + } + } + } + return (Example) Example.of(entity); + } + +} \ No newline at end of file diff --git a/springboot-starter-data-fast/src/main/java/com/codingapi/springboot/fast/jpa/repository/FastRepository.java b/springboot-starter-data-fast/src/main/java/com/codingapi/springboot/fast/jpa/repository/FastRepository.java new file mode 100644 index 000000000..6975dcf8e --- /dev/null +++ b/springboot-starter-data-fast/src/main/java/com/codingapi/springboot/fast/jpa/repository/FastRepository.java @@ -0,0 +1,48 @@ +package com.codingapi.springboot.fast.jpa.repository; + +import com.codingapi.springboot.framework.dto.request.PageRequest; +import com.codingapi.springboot.framework.dto.request.SearchRequest; +import org.springframework.data.domain.Page; +import org.springframework.data.jpa.repository.JpaRepository; +import org.springframework.data.jpa.repository.JpaSpecificationExecutor; +import org.springframework.data.repository.NoRepositoryBean; + +/** + * 更强大的Repository对象 + * + * @param + * @param + */ +@NoRepositoryBean +public interface FastRepository extends JpaRepository, JpaSpecificationExecutor, DynamicRepository, DynamicNativeRepository { + + default Page findAll(PageRequest request) { + if (request.hasFilter()) { + // 全部为简单等值条件时走 Example 查询；包含 LIKE/范围/IN/OR 等复杂条件时自动切换 HQL 动态查询， + // 避免非等值条件被 Example 静默降级为等值匹配 + if (request.getRequestFilter().isAllEqualFilter()) { + Class clazz = getEntityClass(); + ExampleBuilder exampleBuilder = new ExampleBuilder(request, clazz); + return findAll(exampleBuilder.getExample(), request); + } + return pageRequest(request); + } + return findAll((org.springframework.data.domain.PageRequest) request); + } + + default Page pageRequest(PageRequest request) { + if (request.hasFilter()) { + Class clazz = getEntityClass(); + DynamicSQLBuilder dynamicSQLBuilder = new DynamicSQLBuilder(request, clazz); + return dynamicPageQuery(dynamicSQLBuilder.getHQL(),dynamicSQLBuilder.getCountHQL(), request, dynamicSQLBuilder.getParams()); + } + return findAll((org.springframework.data.domain.PageRequest) request); + } + + + default Page searchRequest(SearchRequest request) { + Class clazz = getEntityClass(); + return pageRequest(request.toPageRequest(clazz)); + } + +} diff --git a/springboot-starter-data-fast/src/main/java/com/codingapi/springboot/fast/jpa/repository/SortRepository.java b/springboot-starter-data-fast/src/main/java/com/codingapi/springboot/fast/jpa/repository/SortRepository.java new file mode 100644 index 000000000..a47a0650a --- /dev/null +++ b/springboot-starter-data-fast/src/main/java/com/codingapi/springboot/fast/jpa/repository/SortRepository.java @@ -0,0 +1,39 @@ +package com.codingapi.springboot.fast.jpa.repository; + +import com.codingapi.springboot.framework.domain.ISort; +import com.codingapi.springboot.framework.dto.request.SortRequest; +import org.springframework.data.jpa.repository.JpaRepository; +import org.springframework.data.repository.NoRepositoryBean; + +import java.util.ArrayList; +import java.util.List; + +@NoRepositoryBean +public interface SortRepository extends JpaRepository { + + + default void reSort(SortRequest request) { + if (request != null && !request.getIds().isEmpty()) { + List list = new ArrayList<>(); + int minSort = Integer.MAX_VALUE; + for (Object objectId : request.getIds()) { + ID id = (ID) objectId; + T t = getReferenceById(id); + if (t.getSort() == null) { + minSort = 0; + } else { + if (t.getSort() < minSort) { + minSort = t.getSort(); + } + } + list.add(t); + } + for (T t : list) { + t.setSort(minSort++); + } + saveAll(list); + } + } + + +} diff --git a/springboot-starter-data-fast/src/main/java/com/codingapi/springboot/fast/manager/EntityManagerContent.java b/springboot-starter-data-fast/src/main/java/com/codingapi/springboot/fast/manager/EntityManagerContent.java index 3d7d5c59d..3fd6ab672 100644 --- a/springboot-starter-data-fast/src/main/java/com/codingapi/springboot/fast/manager/EntityManagerContent.java +++ b/springboot-starter-data-fast/src/main/java/com/codingapi/springboot/fast/manager/EntityManagerContent.java @@ -1,6 +1,6 @@ package com.codingapi.springboot.fast.manager; -import jakarta.persistence.EntityManager; +import javax.persistence.EntityManager; import lombok.Getter; public class EntityManagerContent { diff --git a/springboot-starter-data-fast/src/main/java/com/codingapi/springboot/fast/manager/EntityManagerInitializer.java b/springboot-starter-data-fast/src/main/java/com/codingapi/springboot/fast/manager/EntityManagerInitializer.java index ea87bea42..e77dd8b80 100644 --- a/springboot-starter-data-fast/src/main/java/com/codingapi/springboot/fast/manager/EntityManagerInitializer.java +++ b/springboot-starter-data-fast/src/main/java/com/codingapi/springboot/fast/manager/EntityManagerInitializer.java @@ -1,6 +1,6 @@ package com.codingapi.springboot.fast.manager; -import jakarta.persistence.EntityManager; +import javax.persistence.EntityManager; import lombok.AllArgsConstructor; import org.springframework.beans.factory.InitializingBean; diff --git a/springboot-starter-data-fast/src/main/java/com/codingapi/springboot/fast/mapping/MvcEndpointMapping.java b/springboot-starter-data-fast/src/main/java/com/codingapi/springboot/fast/mapping/FastMvcMappingRegister.java similarity index 65% rename from springboot-starter-data-fast/src/main/java/com/codingapi/springboot/fast/mapping/MvcEndpointMapping.java rename to springboot-starter-data-fast/src/main/java/com/codingapi/springboot/fast/mapping/FastMvcMappingRegister.java index cf2eff3ba..35d95f1e6 100644 --- a/springboot-starter-data-fast/src/main/java/com/codingapi/springboot/fast/mapping/MvcEndpointMapping.java +++ b/springboot-starter-data-fast/src/main/java/com/codingapi/springboot/fast/mapping/FastMvcMappingRegister.java @@ -10,10 +10,11 @@ import java.lang.reflect.Method; @AllArgsConstructor -public class MvcEndpointMapping { +public class FastMvcMappingRegister { private final RequestMappingHandlerMapping handlerMapping; + /** * add mvc mapping * @@ -37,4 +38,25 @@ public void addMapping(String url, RequestMethod requestMethod, Object handler, handlerMapping.registerMapping(mappingInfo, handler, method); } + /** + * remove mvc mapping + * + * @param url mapping url + * @param requestMethod request method + */ + public void removeMapping(String url, RequestMethod requestMethod) { + RequestMappingInfo.BuilderConfiguration options = new RequestMappingInfo.BuilderConfiguration(); + options.setPatternParser(new PathPatternParser()); + + RequestMappingInfo mappingInfo = RequestMappingInfo + .paths(url) + .methods(requestMethod) + .produces(MediaType.APPLICATION_JSON_VALUE) + .options(options) + .build(); + + handlerMapping.unregisterMapping(mappingInfo); + } + + } diff --git a/springboot-starter-data-fast/src/main/java/com/codingapi/springboot/fast/metadata/TableEntityClassBuilder.java b/springboot-starter-data-fast/src/main/java/com/codingapi/springboot/fast/metadata/TableEntityClassBuilder.java new file mode 100644 index 000000000..bf6f6e589 --- /dev/null +++ b/springboot-starter-data-fast/src/main/java/com/codingapi/springboot/fast/metadata/TableEntityClassBuilder.java @@ -0,0 +1,230 @@ +package com.codingapi.springboot.fast.metadata; + +import com.codingapi.springboot.fast.classloader.DynamicTableClassLoader; +import javax.persistence.*; +import net.bytebuddy.ByteBuddy; +import net.bytebuddy.description.annotation.AnnotationDescription; +import net.bytebuddy.description.modifier.Visibility; +import net.bytebuddy.dynamic.DynamicType; +import net.bytebuddy.dynamic.loading.ClassLoadingStrategy; +import net.bytebuddy.implementation.FieldAccessor; +import org.hibernate.annotations.Comment; +import org.springframework.util.StringUtils; + +import java.io.Serializable; +import java.lang.annotation.Annotation; +import java.util.ArrayList; +import java.util.List; + +/** + * 动态实体构建器 - 基于 TableEntityMetadata 元数据 + */ +class TableEntityClassBuilder { + + private final TableEntityMetadata metadata; + private DynamicType.Builder builder; + + public TableEntityClassBuilder(TableEntityMetadata metadata) { + if (metadata == null || metadata.getClassName() == null) { + throw new IllegalArgumentException("Entity metadata cannot be null"); + } + this.metadata = metadata; + this.builder = new ByteBuddy() + .subclass(Object.class) + .name(metadata.getClassName()) + .implement(Serializable.class) + .annotateType(buildEntityAnnotations()); + } + + public Class build() { + try { + this.buildColumns(); + Class clazz = builder.make() + .load(TableEntityClassBuilder.class.getClassLoader(), + ClassLoadingStrategy.Default.WRAPPER) + .getLoaded(); + DynamicTableClassLoader.getInstance().registerClass(clazz); + return clazz; + + } catch (Exception e) { + throw new RuntimeException("Failed to build dynamic entity: " + + metadata.getClassName(), e); + } + } + + + private void buildColumns() { + for (TableEntityMetadata.ColumnMeta column : metadata.getColumns()) { + this.addColumnField(column); + } + } + + + /** + * 构建实体类注解 + */ + private AnnotationDescription[] buildEntityAnnotations() { + List annotations = new ArrayList<>(); + + // @Entity 注解 + annotations.add(AnnotationDescription.Builder.ofType(Entity.class).build()); + + // @Table 注解 + if (metadata.getTable() != null) { + AnnotationDescription.Builder tableBuilder = + AnnotationDescription.Builder.ofType(Table.class); + + TableEntityMetadata.TableMeta tableMeta = metadata.getTable(); + if (tableMeta.getName() != null && !tableMeta.getName().isEmpty()) { + tableBuilder = tableBuilder.define("name", tableMeta.getName()); + } + if (tableMeta.getCatalog() != null && !tableMeta.getCatalog().isEmpty()) { + tableBuilder = tableBuilder.define("catalog", tableMeta.getCatalog()); + } + if (tableMeta.getSchema() != null && !tableMeta.getSchema().isEmpty()) { + tableBuilder = tableBuilder.define("schema", tableMeta.getSchema()); + } + + annotations.add(tableBuilder.build()); + } + + // @Comment 注解 - 注释应该放在类上，而不是表注解上 + if (metadata.getTable() != null && StringUtils.hasText(metadata.getTable().getComment())) { + AnnotationDescription.Builder commentBuilder = + AnnotationDescription.Builder.ofType(Comment.class); + + TableEntityMetadata.TableMeta tableMeta = metadata.getTable(); + commentBuilder = commentBuilder.define("value", tableMeta.getComment()); + annotations.add(commentBuilder.build()); + } + + return annotations.toArray(new AnnotationDescription[0]); + } + + /** + * 添加字段 + */ + private void addColumnField(TableEntityMetadata.ColumnMeta columnMeta) { + // 确定字段类型 + Class fieldType = columnMeta.getType(); + + // 构建字段名 + String fieldName = columnMeta.getFieldName(); + + // 构建字段注解 + List fieldAnnotations = this.buildFieldAnnotations(columnMeta); + + if (fieldAnnotations.isEmpty()) { + builder = builder.defineField(fieldName, fieldType, Visibility.PRIVATE); + } else { + builder = builder.defineField(fieldName, fieldType, Visibility.PRIVATE) + .annotateField(fieldAnnotations.toArray(new AnnotationDescription[0])); + } + + // 添加 getter 和 setter + String capitalizedFieldName = capitalize(fieldName); + String getterName = "get" + capitalizedFieldName; + String setterName = "set" + capitalizedFieldName; + + // 布尔类型特殊处理 + if (fieldType == Boolean.class || fieldType == Boolean.TYPE) { + getterName = "is" + capitalizedFieldName; + } + + builder = builder.defineMethod(getterName, fieldType, Visibility.PUBLIC) + .intercept(FieldAccessor.ofField(fieldName)); + + builder = builder.defineMethod(setterName, void.class, Visibility.PUBLIC) + .withParameter(fieldType) + .intercept(FieldAccessor.ofField(fieldName)); + + } + + /** + * 构建字段注解 + */ + private List buildFieldAnnotations( + TableEntityMetadata.ColumnMeta columnMeta) { + List annotations = new ArrayList<>(); + + if (columnMeta.getAnnotationClasses() != null) { + for(Class annotaionClass: columnMeta.getAnnotationClasses()) { + annotations.add(AnnotationDescription.Builder.ofType(annotaionClass).build()); + } + } + + // @Id 注解 + if (columnMeta.isPrimaryKey()) { + annotations.add(AnnotationDescription.Builder.ofType(Id.class).build()); + + // @GeneratedValue 注解 + if (columnMeta.getGeneratedValue() != null) { + TableEntityMetadata.GeneratedValueMeta genMeta = columnMeta.getGeneratedValue(); + AnnotationDescription.Builder genBuilder = + AnnotationDescription.Builder.ofType(GeneratedValue.class); + + if (genMeta.getStrategy() != null) { + genBuilder = genBuilder.define("strategy", genMeta.getStrategy()); + } + + if (genMeta.getGenerator() != null && !genMeta.getGenerator().isEmpty()) { + genBuilder = genBuilder.define("generator", genMeta.getGenerator()); + } + + annotations.add(genBuilder.build()); + } + } + + // @Lob 注解 + if (columnMeta.isLob()) { + AnnotationDescription.Builder logBuilder = + AnnotationDescription.Builder.ofType(Lob.class); + annotations.add(logBuilder.build()); + } + + // @Column 注解 + AnnotationDescription.Builder columnBuilder = + AnnotationDescription.Builder.ofType(Column.class); + + columnBuilder = columnBuilder + .define("name", columnMeta.getColumnName()) + .define("nullable", columnMeta.isNullable()) + .define("unique", columnMeta.isUnique()) + .define("insertable", columnMeta.isInsertable()) + .define("updatable", columnMeta.isUpdatable()); + + if (columnMeta.getLength() > 0) { + columnBuilder = columnBuilder.define("length", columnMeta.getLength()); + } + if (columnMeta.getPrecision() > 0) { + columnBuilder = columnBuilder.define("precision", columnMeta.getPrecision()); + } + if (columnMeta.getScale() > 0) { + columnBuilder = columnBuilder.define("scale", columnMeta.getScale()); + } + if (columnMeta.getColumnDefinition() != null && + !columnMeta.getColumnDefinition().isEmpty()) { + columnBuilder = columnBuilder.define("columnDefinition", + columnMeta.getColumnDefinition()); + } + + annotations.add(columnBuilder.build()); + + // @Comment 注解 + if (StringUtils.hasText(columnMeta.getComment())) { + annotations.add(AnnotationDescription.Builder.ofType(Comment.class) + .define("value", columnMeta.getComment()) + .build()); + } + + return annotations; + } + + + private String capitalize(String str) { + if (str == null || str.isEmpty()) { + return str; + } + return Character.toUpperCase(str.charAt(0)) + str.substring(1); + } +} \ No newline at end of file diff --git a/springboot-starter-data-fast/src/main/java/com/codingapi/springboot/fast/metadata/TableEntityMetadata.java b/springboot-starter-data-fast/src/main/java/com/codingapi/springboot/fast/metadata/TableEntityMetadata.java new file mode 100644 index 000000000..32d13f89b --- /dev/null +++ b/springboot-starter-data-fast/src/main/java/com/codingapi/springboot/fast/metadata/TableEntityMetadata.java @@ -0,0 +1,272 @@ +package com.codingapi.springboot.fast.metadata; + +import javax.persistence.GenerationType; +import lombok.Getter; +import lombok.Setter; +import org.springframework.util.StringUtils; + +import java.lang.annotation.Annotation; +import java.util.ArrayList; +import java.util.List; +import java.util.Set; + +/** + * 表实体元数据 + */ +@Getter +public class TableEntityMetadata { + + /** + * 类名称 + */ + private final String className; + /** + * 数据库表信息 + */ + private final TableMeta table; + /** + * 字段信息 + */ + private final List columns; + + @Setter + @Getter + public static class TableMeta { + /** + * 数据库名称 + */ + private String name; + private String catalog; + private String schema; + /** + * 备注信息 + */ + private String comment; + } + + @Setter + @Getter + public static class ColumnMeta { + /** + * 字段类型 + */ + private Class type; + /** + * 表字段名称 + */ + private String columnName; + /** + * 类字段名称 + */ + private String fieldName; + /** + * 是否主键 + */ + private boolean isPrimaryKey; + /** + * 主键自增策略 + */ + private GeneratedValueMeta generatedValue; + /** + * 字段注解 + */ + private Set> annotationClasses; + /** + * 备注 + */ + private String comment; + + /** + * 是否为lob 对应长内容 + */ + private boolean isLob; + + /** + * 是否唯一 + */ + private boolean unique; + /** + * 是否为空 + */ + private boolean nullable; + /** + * 是否可以插入数据 + */ + private boolean insertable; + /** + * 是否可以更新数据 + */ + private boolean updatable; + /** + * 字段定义 + */ + private String columnDefinition; + /** + * 字段长度 + */ + private int length; + /** + * 字段精度 + */ + private int precision; + /** + * 字段缩放 + */ + private int scale; + } + + @Setter + @Getter + public static class GeneratedValueMeta { + /** + * 自增长策略 + */ + private GenerationType strategy; + /** + * 自定义 + */ + private String generator; + } + + + /** + * 类名称 + * + * @param className 类名称 + */ + public TableEntityMetadata(String className) { + this.className = className; + this.table = new TableMeta(); + this.columns = new ArrayList<>(); + } + + + public void setTable(String name, String catalog, String schema, String comment) { + this.table.setName(name); + this.table.setCatalog(catalog); + this.table.setSchema(schema); + this.table.setComment(comment); + } + + public void setTable(String name, String comment) { + this.setTable(name, null, null, comment); + } + + public void setTable(String name) { + this.setTable(name, null, null, null); + } + + public void addColumn(ColumnMeta column) { + this.columns.add(column); + } + + public void addPrimaryKeyColumn(Class type, String fieldName, String columnName, GenerationType strategy, + String generator, Set> annotationClasses, String comment, boolean isLob, boolean unique, boolean nullable, + boolean insertable, boolean updatable, String columnDefinition, + int length, int precision, int scale) { + ColumnMeta column = new ColumnMeta(); + column.setType(type); + column.setFieldName(fieldName); + column.setColumnName(columnName); + column.setPrimaryKey(true); + if (strategy != null || StringUtils.hasText(generator)) { + GeneratedValueMeta generatedValueMeta = new GeneratedValueMeta(); + generatedValueMeta.setGenerator(generator); + generatedValueMeta.setStrategy(strategy); + column.setGeneratedValue(generatedValueMeta); + } + column.setAnnotationClasses(annotationClasses); + column.setLob(isLob); + column.setComment(comment); + column.setUnique(unique); + column.setNullable(nullable); + column.setInsertable(insertable); + column.setUpdatable(updatable); + column.setColumnDefinition(columnDefinition); + column.setLength(length); + column.setPrecision(precision); + column.setScale(scale); + this.addColumn(column); + } + + public void addColumn(Class type, String fieldName, String columnName, String comment, boolean isLob, + boolean unique, boolean nullable, boolean insertable, + boolean updatable, String columnDefinition, int length, + int precision, int scale) { + ColumnMeta column = new ColumnMeta(); + column.setPrimaryKey(false); + column.setType(type); + column.setFieldName(fieldName); + column.setColumnName(columnName); + column.setComment(comment); + column.setLob(isLob); + column.setUnique(unique); + column.setNullable(nullable); + column.setInsertable(insertable); + column.setUpdatable(updatable); + column.setColumnDefinition(columnDefinition); + column.setLength(length); + column.setPrecision(precision); + column.setScale(scale); + this.addColumn(column); + } + + public void addColumn(Class type, String name, String comment) { + this.addColumn(type, name, name, comment, false, false, true, false, false, null, 255, 0, 0); + } + + public void addColumn(Class type, String name, String comment, boolean isLob) { + this.addColumn(type, name, name, comment, isLob, false, true, false, false, null, 255, 0, 0); + } + + public void addColumn(Class type, String name, boolean isLob) { + this.addColumn(type, name, name, null, isLob, false, true, false, false, null, 255, 0, 0); + } + + public void addColumn(Class type, String name) { + this.addColumn(type, name, name, null, false, false, true, false, false, null, 255, 0, 0); + } + + public void addPrimaryKeyColumn(Class type, String name) { + this.addPrimaryKeyColumn(type, name, name, null, null, null, null, false, false, false, false, false, null, 255, 0, 0); + } + + public void addPrimaryKeyColumn(Class type, String name, String comment) { + this.addPrimaryKeyColumn(type, name, name, null, null, null, comment, false, false, false, false, false, null, 255, 0, 0); + } + + public void addPrimaryKeyColumn(Class type, String name, GenerationType strategy) { + this.addPrimaryKeyColumn(type, name, name, strategy, null, null, null, false, false, false, false, false, null, 255, 0, 0); + } + + public void addPrimaryKeyColumn(Class type, String name, GenerationType strategy, String comment) { + this.addPrimaryKeyColumn(type, name, name, strategy, null, null, comment, false, false, false, false, false, null, 255, 0, 0); + } + + public void addPrimaryKeyColumn(Class type, String name, Set> annotationClasses, String comment) { + this.addPrimaryKeyColumn(type, name, name, null, null, annotationClasses, comment, false, false, false, false, false, null, 255, 0, 0); + } + + public void verify() { + if (columns.isEmpty()) { + throw new IllegalArgumentException("columns must not null."); + } + boolean hasPrimaryKey = false; + for (ColumnMeta column : columns) { + if (column.isPrimaryKey) { + hasPrimaryKey = true; + } + } + if (!hasPrimaryKey) { + throw new IllegalArgumentException("columns must has primaryKey."); + } + } + + public Class buildClass() { + this.verify(); + TableEntityClassBuilder builder = new TableEntityClassBuilder(this); + return builder.build(); + } + + +} diff --git a/springboot-starter-data-fast/src/main/java/com/codingapi/springboot/fast/query/FastRepository.java b/springboot-starter-data-fast/src/main/java/com/codingapi/springboot/fast/query/FastRepository.java deleted file mode 100644 index 71eeb9aec..000000000 --- a/springboot-starter-data-fast/src/main/java/com/codingapi/springboot/fast/query/FastRepository.java +++ /dev/null @@ -1,28 +0,0 @@ -package com.codingapi.springboot.fast.query; - -import com.codingapi.springboot.framework.dto.request.PageRequest; -import org.springframework.core.ResolvableType; -import org.springframework.data.domain.Page; -import org.springframework.data.jpa.repository.JpaRepository; -import org.springframework.data.jpa.repository.JpaSpecificationExecutor; -import org.springframework.data.repository.NoRepositoryBean; - -@NoRepositoryBean -public interface FastRepository extends JpaRepository, JpaSpecificationExecutor { - - default Page findAll(PageRequest request){ - if(request.hasFilter()){ - Class clazz = getDomainClass(); - return findAll(request.getExample(clazz),request); - } - return findAll((org.springframework.data.domain.PageRequest)request); - } - - - @SuppressWarnings("unchecked") - default Class getDomainClass() { - ResolvableType resolvableType = ResolvableType.forClass(getClass()).as(FastRepository.class); - return (Class) resolvableType.getGeneric(0).resolve(); - } - -} diff --git a/springboot-starter-data-fast/src/main/java/com/codingapi/springboot/fast/registrar/DataFastBeanDefinitionRegistrar.java b/springboot-starter-data-fast/src/main/java/com/codingapi/springboot/fast/registrar/DataFastBeanDefinitionRegistrar.java deleted file mode 100644 index 0a733ab79..000000000 --- a/springboot-starter-data-fast/src/main/java/com/codingapi/springboot/fast/registrar/DataFastBeanDefinitionRegistrar.java +++ /dev/null @@ -1,33 +0,0 @@ -package com.codingapi.springboot.fast.registrar; - -import com.codingapi.springboot.fast.annotation.FastController; -import com.codingapi.springboot.framework.registrar.RegisterBeanScanner; -import lombok.SneakyThrows; -import lombok.extern.slf4j.Slf4j; -import org.springframework.beans.factory.support.BeanDefinitionRegistry; -import org.springframework.context.annotation.Configuration; -import org.springframework.context.annotation.ImportBeanDefinitionRegistrar; -import org.springframework.core.type.AnnotationMetadata; - -import java.util.Set; - -@Slf4j -@Configuration -public class DataFastBeanDefinitionRegistrar implements ImportBeanDefinitionRegistrar { - - - @SneakyThrows - @Override - public void registerBeanDefinitions(AnnotationMetadata importingClassMetadata, BeanDefinitionRegistry registry) { - RegisterBeanScanner registerBeanScanner = new RegisterBeanScanner(importingClassMetadata, FastController.class); - Set> classSet = registerBeanScanner.findTypes(); - - //register bean - for (Class clazz : classSet) { - log.info("scanner @FastController class:{}", clazz); - MvcMappingRegistrar.classSet.add(clazz); - } - } - - -} diff --git a/springboot-starter-data-fast/src/main/java/com/codingapi/springboot/fast/registrar/MvcMappingRegistrar.java b/springboot-starter-data-fast/src/main/java/com/codingapi/springboot/fast/registrar/MvcMappingRegistrar.java deleted file mode 100644 index e6a154b87..000000000 --- a/springboot-starter-data-fast/src/main/java/com/codingapi/springboot/fast/registrar/MvcMappingRegistrar.java +++ /dev/null @@ -1,94 +0,0 @@ -package com.codingapi.springboot.fast.registrar; - -import com.codingapi.springboot.fast.annotation.FastMapping; -import com.codingapi.springboot.fast.exception.FastMappingErrorException; -import com.codingapi.springboot.fast.executor.JpaExecutor; -import com.codingapi.springboot.fast.executor.MvcMethodInterceptor; -import com.codingapi.springboot.fast.mapping.MvcEndpointMapping; -import lombok.SneakyThrows; -import lombok.extern.slf4j.Slf4j; -import org.springframework.aop.Advisor; -import org.springframework.aop.framework.AdvisedSupport; -import org.springframework.aop.framework.AopProxy; -import org.springframework.aop.framework.AopProxyFactory; -import org.springframework.aop.framework.DefaultAopProxyFactory; -import org.springframework.data.domain.Pageable; -import org.springframework.util.StringUtils; - -import java.lang.reflect.Method; -import java.util.HashSet; -import java.util.List; -import java.util.Set; - -@Slf4j -public class MvcMappingRegistrar { - protected final static Set> classSet = new HashSet<>(); - private final MvcEndpointMapping mvcEndpointMapping; - - private final AopProxyFactory proxyFactory; - - private final List advisors; - - private final MvcMethodInterceptor interceptor; - - public MvcMappingRegistrar(MvcEndpointMapping mvcEndpointMapping, - JpaExecutor jpaExecutor, - List advisors) { - this.mvcEndpointMapping = mvcEndpointMapping; - this.advisors = advisors; - this.interceptor = new MvcMethodInterceptor(jpaExecutor); - this.proxyFactory = new DefaultAopProxyFactory(); - } - - @SneakyThrows - public void registerMvcMapping() { - for (Class clazz : classSet) { - Method[] methods = clazz.getDeclaredMethods(); - for (Method method : methods) { - FastMapping fastMapping = method.getAnnotation(FastMapping.class); - if (verify(fastMapping, method)) { - AdvisedSupport advisedSupport = createAdvisedSupport(clazz); - AopProxy proxy = proxyFactory.createAopProxy(advisedSupport); - mvcEndpointMapping.addMapping(fastMapping.mapping(), fastMapping.method(), - proxy.getProxy(), method); - } - } - } - } - - private AdvisedSupport createAdvisedSupport(Class clazz) { - AdvisedSupport advisedSupport = new AdvisedSupport(clazz); - advisedSupport.setTarget(interceptor); - advisedSupport.addAdvisors(advisors); - advisedSupport.addAdvice(interceptor); - return advisedSupport; - } - - private boolean verify(FastMapping fastMapping, Method method) throws FastMappingErrorException { - if (fastMapping == null) { - return false; - } - - if (!StringUtils.hasText(fastMapping.mapping())) { - throw new FastMappingErrorException(String.format("fast method %s missing mapping .", - method.getName())); - } - - if (!StringUtils.hasText(fastMapping.value())) { - throw new FastMappingErrorException(String.format("fast mapping %s missing value .", - fastMapping.mapping())); - } - - Class[] parameterTypes = method.getParameterTypes(); - for (Class parameter : parameterTypes) { - if (Pageable.class.isAssignableFrom(parameter)) { - if (!StringUtils.hasText(fastMapping.countQuery())) { - throw new FastMappingErrorException(String.format("fast mapping %s missing countQuery .", - fastMapping.mapping())); - } - } - } - return true; - } - -} diff --git a/springboot-starter-data-fast/src/main/java/com/codingapi/springboot/fast/script/FastScriptMappingRegister.java b/springboot-starter-data-fast/src/main/java/com/codingapi/springboot/fast/script/FastScriptMappingRegister.java new file mode 100644 index 000000000..9dc8583f2 --- /dev/null +++ b/springboot-starter-data-fast/src/main/java/com/codingapi/springboot/fast/script/FastScriptMappingRegister.java @@ -0,0 +1,46 @@ +package com.codingapi.springboot.fast.script; + +import com.codingapi.springboot.fast.mapping.FastMvcMappingRegister; +import com.codingapi.springboot.framework.dto.response.Response; +import lombok.AllArgsConstructor; + +@AllArgsConstructor +public class FastScriptMappingRegister { + + private final FastMvcMappingRegister mappingRegister; + + /** + * test dynamic mapping + * + * @param scriptMapping dynamic mapping + **/ + public void addMapping(ScriptMapping scriptMapping) { + mappingRegister.addMapping(scriptMapping.getMapping(), scriptMapping.getScriptMethod().toRequestMethod(), + scriptMapping, scriptMapping.getExecuteMethod()); + } + + + /** + * test dynamic mapping + * + * @param scriptMapping dynamic mapping + * @return result + */ + public Response test(ScriptMapping scriptMapping) { + return scriptMapping.execute(); + } + + + /** + * remove mvc mapping + * + * @param url mapping url + * @param requestMethod request method + */ + public void removeMapping(String url, ScriptMethod scriptMethod){ + mappingRegister.removeMapping(url, scriptMethod.toRequestMethod()); + } + + + +} diff --git a/springboot-starter-data-fast/src/main/java/com/codingapi/springboot/fast/script/ScriptMapping.java b/springboot-starter-data-fast/src/main/java/com/codingapi/springboot/fast/script/ScriptMapping.java new file mode 100644 index 000000000..c59640b2b --- /dev/null +++ b/springboot-starter-data-fast/src/main/java/com/codingapi/springboot/fast/script/ScriptMapping.java @@ -0,0 +1,56 @@ +package com.codingapi.springboot.fast.script; + +import com.codingapi.springboot.framework.dto.response.MultiResponse; +import com.codingapi.springboot.framework.dto.response.Response; +import com.codingapi.springboot.framework.dto.response.SingleResponse; +import lombok.Getter; +import lombok.Setter; +import org.springframework.data.domain.Page; +import org.springframework.web.bind.annotation.ResponseBody; + +import java.lang.reflect.Method; +import java.util.List; + + +@Setter +@Getter +public class ScriptMapping { + + private String mapping; + private ScriptMethod scriptMethod; + private String script; + + + public ScriptMapping(String mapping, ScriptMethod scriptMethod, String script) { + this.mapping = mapping; + this.scriptMethod = scriptMethod; + this.script = script; + } + + @ResponseBody + Response execute() { + Object result = ScriptRuntime.getInstance().running(script); + if (result instanceof List || result.getClass().isArray()) { + return SingleResponse.of(result); + } else { + if (result instanceof MultiResponse) { + return (MultiResponse) result; + } + if (result instanceof Page) { + return MultiResponse.of((Page) result); + } + return SingleResponse.of(result); + } + } + + + Method getExecuteMethod() { + try { + return this.getClass().getDeclaredMethod("execute"); + } catch (NoSuchMethodException e) { + throw new RuntimeException(e); + } + } + + +} diff --git a/springboot-starter-data-fast/src/main/java/com/codingapi/springboot/fast/script/ScriptMethod.java b/springboot-starter-data-fast/src/main/java/com/codingapi/springboot/fast/script/ScriptMethod.java new file mode 100644 index 000000000..8dfb44b6c --- /dev/null +++ b/springboot-starter-data-fast/src/main/java/com/codingapi/springboot/fast/script/ScriptMethod.java @@ -0,0 +1,18 @@ +package com.codingapi.springboot.fast.script; + +import org.springframework.web.bind.annotation.RequestMethod; + +public enum ScriptMethod { + + GET, POST; + + + public RequestMethod toRequestMethod() { + if (this == GET) { + return RequestMethod.GET; + } else { + return RequestMethod.POST; + } + } + +} diff --git a/springboot-starter-data-fast/src/main/java/com/codingapi/springboot/fast/script/ScriptRequest.java b/springboot-starter-data-fast/src/main/java/com/codingapi/springboot/fast/script/ScriptRequest.java new file mode 100644 index 000000000..9b9f0e78c --- /dev/null +++ b/springboot-starter-data-fast/src/main/java/com/codingapi/springboot/fast/script/ScriptRequest.java @@ -0,0 +1,46 @@ +package com.codingapi.springboot.fast.script; + +import javax.servlet.http.HttpServletRequest; +import com.codingapi.springboot.framework.dto.request.PageRequest; +import lombok.AllArgsConstructor; + +@AllArgsConstructor +public class ScriptRequest { + + private final HttpServletRequest request; + + public String getParameter(String key, String defaultValue) { + String result = request.getParameter(key); + return result == null ? defaultValue : result; + } + + public int getParameter(String key, int defaultValue) { + String result = request.getParameter(key); + return result == null ? defaultValue : Integer.parseInt(result); + } + + public float getParameter(String key, float defaultValue) { + String result = request.getParameter(key); + return result == null ? defaultValue : Float.parseFloat(result); + } + + public double getParameter(String key, double defaultValue) { + String result = request.getParameter(key); + return result == null ? defaultValue : Double.parseDouble(result); + } + + public long getParameter(String key, long defaultValue) { + String result = request.getParameter(key); + return result == null ? defaultValue : Long.parseLong(result); + } + + public boolean getParameter(String key, boolean defaultValue) { + String result = request.getParameter(key); + return result == null ? defaultValue : Boolean.parseBoolean(result); + } + + public PageRequest pageRequest(int pageNumber, int pageSize) { + return PageRequest.of(pageNumber, pageSize); + } + +} diff --git a/springboot-starter-data-fast/src/main/java/com/codingapi/springboot/fast/script/ScriptRuntime.java b/springboot-starter-data-fast/src/main/java/com/codingapi/springboot/fast/script/ScriptRuntime.java new file mode 100644 index 000000000..c6d997292 --- /dev/null +++ b/springboot-starter-data-fast/src/main/java/com/codingapi/springboot/fast/script/ScriptRuntime.java @@ -0,0 +1,41 @@ +package com.codingapi.springboot.fast.script; + +import com.codingapi.springboot.fast.jdbc.JdbcQuery; +import com.codingapi.springboot.fast.jdbc.JdbcQueryContext; +import com.codingapi.springboot.fast.jpa.JpaQuery; +import com.codingapi.springboot.fast.jpa.JpaQueryContext; +import com.codingapi.springboot.script.GroovyScriptRuntime; +import lombok.Getter; +import org.springframework.web.context.request.RequestContextHolder; +import org.springframework.web.context.request.ServletRequestAttributes; + +import java.util.HashMap; +import java.util.Map; + + +public class ScriptRuntime { + + + @Getter + private final static ScriptRuntime instance = new ScriptRuntime(); + + private final GroovyScriptRuntime scriptRunner; + + private ScriptRuntime(){ + this.scriptRunner = new GroovyScriptRuntime(1000); + } + + Object running(String script) { + ServletRequestAttributes attributes = (ServletRequestAttributes) RequestContextHolder.currentRequestAttributes(); + ScriptRequest request = new ScriptRequest(attributes.getRequest()); + JdbcQuery jdbcQuery = JdbcQueryContext.getInstance().getJdbcQuery(); + JpaQuery jpaQuery = JpaQueryContext.getInstance().getJpaQuery(); + + Map bindBuilder = new HashMap<>(); + bindBuilder.put("$request", request); + bindBuilder.put("$jpa", jpaQuery); + bindBuilder.put("$jdbc", jdbcQuery); + + return this.scriptRunner.run(script,Object.class,bindBuilder); + } +} diff --git a/springboot-starter-data-fast/src/main/resources/META-INF/spring.factories b/springboot-starter-data-fast/src/main/resources/META-INF/spring.factories index 545e7ce2b..25372a67a 100644 --- a/springboot-starter-data-fast/src/main/resources/META-INF/spring.factories +++ b/springboot-starter-data-fast/src/main/resources/META-INF/spring.factories @@ -1,3 +1,4 @@ org.springframework.boot.autoconfigure.EnableAutoConfiguration=\ com.codingapi.springboot.fast.DataFastConfiguration,\ -com.codingapi.springboot.fast.registrar.DataFastBeanDefinitionRegistrar \ No newline at end of file +com.codingapi.springboot.fast.jpa.JpaQueryConfiguration,\ +com.codingapi.springboot.fast.jdbc.JdbcQueryConfiguration \ No newline at end of file diff --git a/springboot-starter-data-fast/src/main/resources/META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports b/springboot-starter-data-fast/src/main/resources/META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports index c1debcb6c..526c33d91 100644 --- a/springboot-starter-data-fast/src/main/resources/META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports +++ b/springboot-starter-data-fast/src/main/resources/META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports @@ -1,2 +1,3 @@ com.codingapi.springboot.fast.DataFastConfiguration -com.codingapi.springboot.fast.registrar.DataFastBeanDefinitionRegistrar \ No newline at end of file +com.codingapi.springboot.fast.jpa.JpaQueryConfiguration +com.codingapi.springboot.fast.jdbc.JdbcQueryConfiguration \ No newline at end of file diff --git a/springboot-starter-data-fast/src/test/java/com/codingapi/springboot/fast/DataFastApplicationTest.java b/springboot-starter-data-fast/src/test/java/com/codingapi/springboot/fast/DataFastApplicationTest.java deleted file mode 100644 index 1870f2c42..000000000 --- a/springboot-starter-data-fast/src/test/java/com/codingapi/springboot/fast/DataFastApplicationTest.java +++ /dev/null @@ -1,34 +0,0 @@ -package com.codingapi.springboot.fast; - -import org.junit.jupiter.api.Test; -import org.springframework.beans.factory.annotation.Autowired; -import org.springframework.boot.test.autoconfigure.web.servlet.AutoConfigureMockMvc; -import org.springframework.boot.test.context.SpringBootTest; -import org.springframework.http.MediaType; -import org.springframework.test.web.servlet.MockMvc; - -import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.get; -import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.status; - -@AutoConfigureMockMvc -@SpringBootTest -public class DataFastApplicationTest { - - @Autowired - private MockMvc mockMvc; - - @Test - void findAll() throws Exception { - mockMvc.perform(get("/demo/findAll").contentType(MediaType.APPLICATION_JSON)).andExpect(status().isOk()); - } - - @Test - void findById() throws Exception { - mockMvc.perform(get("/demo/getById").param("id", "1").contentType(MediaType.APPLICATION_JSON)).andExpect(status().isOk()); - } - - @Test - void findPage() throws Exception { - mockMvc.perform(get("/demo/findPage").param("pageSize", "20").param("current", "1").contentType(MediaType.APPLICATION_JSON)).andExpect(status().isOk()); - } -} diff --git a/springboot-starter-data-fast/src/test/java/com/codingapi/springboot/fast/DemoRepositoryTest.java b/springboot-starter-data-fast/src/test/java/com/codingapi/springboot/fast/DemoRepositoryTest.java index 283fd3184..99a5305d9 100644 --- a/springboot-starter-data-fast/src/test/java/com/codingapi/springboot/fast/DemoRepositoryTest.java +++ b/springboot-starter-data-fast/src/test/java/com/codingapi/springboot/fast/DemoRepositoryTest.java @@ -1,17 +1,24 @@ package com.codingapi.springboot.fast; import com.codingapi.springboot.fast.entity.Demo; +import com.codingapi.springboot.fast.jpa.SQLBuilder; import com.codingapi.springboot.fast.repository.DemoRepository; +import com.codingapi.springboot.framework.dto.request.Filter; import com.codingapi.springboot.framework.dto.request.PageRequest; +import com.codingapi.springboot.framework.dto.request.Relation; +import lombok.extern.slf4j.Slf4j; import org.junit.jupiter.api.Test; import org.springframework.beans.factory.annotation.Autowired; import org.springframework.boot.test.context.SpringBootTest; import org.springframework.data.domain.Page; import org.springframework.data.domain.Sort; +import java.util.List; + import static org.junit.jupiter.api.Assertions.assertEquals; import static org.junit.jupiter.api.Assertions.assertTrue; +@Slf4j @SpringBootTest public class DemoRepositoryTest { @@ -20,17 +27,176 @@ public class DemoRepositoryTest { @Test - void test(){ + void test() { demoRepository.deleteAll(); Demo demo = new Demo(); demo.setName("123"); demoRepository.save(demo); - assertTrue(demo.getId()>0); + assertTrue(demo.getId() > 0); + } + + + @Test + void findAll() { + demoRepository.deleteAll(); + Demo demo1 = new Demo(); + demo1.setName("123"); + demoRepository.save(demo1); + + Demo demo2 = new Demo(); + demo2.setName("456"); + demoRepository.save(demo2); + + PageRequest request = new PageRequest(); + request.setCurrent(1); + request.setPageSize(10); + request.addFilter("name", "123"); + + Page page = demoRepository.findAll(request); + assertEquals(1, page.getTotalElements()); + } + + /** + * findAll 遇到 LIKE 等复杂条件时自动切换 HQL 查询，而非被 Example 降级为等值匹配 + */ + @Test + void findAllWithLikeFilterSwitchesToHql() { + demoRepository.deleteAll(); + Demo demo1 = new Demo(); + demo1.setName("123"); + demoRepository.save(demo1); + + Demo demo2 = new Demo(); + demo2.setName("456"); + demoRepository.save(demo2); + + PageRequest request = new PageRequest(); + request.setCurrent(0); + request.setPageSize(10); + request.addFilter("name", Relation.LIKE, "%2%"); + + Page page = demoRepository.findAll(request); + assertEquals(1, page.getTotalElements()); + assertEquals("123", page.getContent().get(0).getName()); } + /** + * findAll 遇到范围条件时自动切换 HQL 查询 + */ + @Test + void findAllWithGreaterThanFilterSwitchesToHql() { + demoRepository.deleteAll(); + Demo demo1 = new Demo(); + demo1.setName("a"); + demo1.setSort(10); + demoRepository.save(demo1); + + Demo demo2 = new Demo(); + demo2.setName("b"); + demo2.setSort(20); + demoRepository.save(demo2); + + Demo demo3 = new Demo(); + demo3.setName("c"); + demo3.setSort(30); + demoRepository.save(demo3); + + PageRequest request = new PageRequest(); + request.setCurrent(0); + request.setPageSize(10); + request.addFilter("sort", Relation.GREATER_THAN, 15); + + Page page = demoRepository.findAll(request); + assertEquals(2, page.getTotalElements()); + } + + /** + * findAll 遇到 OR 组合条件时自动切换 HQL 查询 + */ + @Test + void findAllWithOrFiltersSwitchesToHql() { + demoRepository.deleteAll(); + Demo demo1 = new Demo(); + demo1.setName("123"); + demoRepository.save(demo1); + + Demo demo2 = new Demo(); + demo2.setName("456"); + demoRepository.save(demo2); + + Demo demo3 = new Demo(); + demo3.setName("789"); + demoRepository.save(demo3); + + PageRequest request = new PageRequest(); + request.setCurrent(0); + request.setPageSize(10); + request.orFilters(Filter.as("name", "123"), Filter.as("name", "456")); + + Page page = demoRepository.findAll(request); + assertEquals(2, page.getTotalElements()); + } + + @Test + void pageRequestIsNull() { + demoRepository.deleteAll(); + Demo demo1 = new Demo(); + demo1.setName("123"); + demo1 = demoRepository.save(demo1); + + Demo demo2 = new Demo(); + demoRepository.save(demo2); + + PageRequest request = new PageRequest(); + request.setCurrent(1); + request.setPageSize(10); + request.addFilter("name", Relation.IS_NULL); + + Page page = demoRepository.pageRequest(request); + assertEquals(1, page.getTotalElements()); + } + + @Test + void pageRequestIsNotNull() { + demoRepository.deleteAll(); + Demo demo1 = new Demo(); + demo1.setName("123"); + demo1 = demoRepository.save(demo1); + + Demo demo2 = new Demo(); + demoRepository.save(demo2); + + PageRequest request = new PageRequest(); + request.setCurrent(1); + request.setPageSize(10); + request.addFilter("name", Relation.IS_NOT_NULL); + + Page page = demoRepository.pageRequest(request); + assertEquals(1, page.getTotalElements()); + } + + @Test + void pageRequestNotEqual() { + demoRepository.deleteAll(); + Demo demo1 = new Demo(); + demo1.setName("123"); + demo1 = demoRepository.save(demo1); + + Demo demo2 = new Demo(); + demo2.setName("456"); + demoRepository.save(demo2); + + PageRequest request = new PageRequest(); + request.setCurrent(1); + request.setPageSize(10); + request.addFilter("id", Relation.NOT_EQUAL, demo1.getId()); + + Page page = demoRepository.pageRequest(request); + assertEquals(1, page.getTotalElements()); + } @Test - void query(){ + void pageRequest() { demoRepository.deleteAll(); Demo demo1 = new Demo(); demo1.setName("123"); @@ -43,15 +209,15 @@ void query(){ PageRequest request = new PageRequest(); request.setCurrent(1); request.setPageSize(10); - request.addFilter("name","123"); + request.addFilter("name", Relation.LIKE, "%2%"); - Page page = demoRepository.findAll(request); + Page page = demoRepository.pageRequest(request); assertEquals(1, page.getTotalElements()); } @Test - void sort(){ + void customInSearch() { demoRepository.deleteAll(); Demo demo1 = new Demo(); demo1.setName("123"); @@ -65,9 +231,143 @@ void sort(){ request.setCurrent(1); request.setPageSize(10); + request.addFilter("id", Relation.IN, 1, 2, 3); + + Page page = demoRepository.pageRequest(request); + System.out.println(page.getContent()); + } + + + @Test + void customNotInSearch() { + demoRepository.deleteAll(); + Demo demo1 = new Demo(); + demo1.setName("123"); + demoRepository.save(demo1); + + Demo demo2 = new Demo(); + demo2.setName("456"); + demoRepository.save(demo2); + + PageRequest request = new PageRequest(); + request.setCurrent(1); + request.setPageSize(10); + + request.addFilter("id", Relation.NOT_IN, 3); + + Page page = demoRepository.pageRequest(request); + assertEquals(2, page.getTotalElements()); + } + + + @Test + void customOrSearch() { + demoRepository.deleteAll(); + Demo demo1 = new Demo(); + demo1.setName("123"); + demoRepository.save(demo1); + + Demo demo2 = new Demo(); + demo2.setName("456"); + demoRepository.save(demo2); + + PageRequest request = new PageRequest(); + request.setCurrent(0); + request.setPageSize(10); + + +// request.andFilter(Filter.as("id", Relation.IN, 1, 2, 3), Filter.as("name", "123")); + request.addFilter("name", "456").orFilters(Filter.as("id", Relation.IN, 1, 2, 3), Filter.as("name", "123")); + request.addSort(Sort.by("id").descending()); - Page page = demoRepository.findAll(request); - assertEquals(page.getContent().get(0).getName(),"456"); + + + + Page page = demoRepository.pageRequest(request); + log.info("demo:{}", page.getContent()); +// assertEquals(2, page.getTotalElements()); + } + + @Test + void dynamicListQuery() { + demoRepository.deleteAll(); + Demo demo1 = new Demo(); + demo1.setName("123"); + demoRepository.save(demo1); + + Demo demo2 = new Demo(); + demo2.setName("456"); + demoRepository.save(demo2); + + SQLBuilder builder = new SQLBuilder(Demo.class,"from Demo where 1=1"); + String search = "12"; + builder.append("and name like ?","%"+search+"%"); + + List list = demoRepository.dynamicListQuery(builder); + assertEquals(1, list.size()); + } + + + + @Test + void dynamicNativeListQuery() { + demoRepository.deleteAll(); + Demo demo1 = new Demo(); + demo1.setName("123"); + demoRepository.save(demo1); + + Demo demo2 = new Demo(); + demo2.setName("456"); + demoRepository.save(demo2); + + SQLBuilder builder = new SQLBuilder(Demo.class,"select * from t_demo where 1=1"); + String search = "12"; + builder.append("and name like ?","%"+search+"%"); + + List list = demoRepository.dynamicNativeListQuery(builder); + assertEquals(1, list.size()); + } + + + @Test + void dynamicPageQuery() { + demoRepository.deleteAll(); + Demo demo1 = new Demo(); + demo1.setName("123"); + demoRepository.save(demo1); + + Demo demo2 = new Demo(); + demo2.setName("456"); + demoRepository.save(demo2); + + SQLBuilder builder = new SQLBuilder(Demo.class,"select d from Demo d where 1=1","select count(1) from Demo d where 1=1"); + String search = "12"; + builder.append("and d.name like ?","%"+search+"%"); + + Page page = demoRepository.dynamicPageQuery(builder,PageRequest.of(1, 2)); + assertEquals(1, page.getTotalElements()); + } + + + @Test + void sortQuery() { + demoRepository.deleteAll(); + Demo demo1 = new Demo(); + demo1.setName("123"); + demoRepository.save(demo1); + + Demo demo2 = new Demo(); + demo2.setName("456"); + demoRepository.save(demo2); + + PageRequest request = new PageRequest(); + request.setCurrent(0); + request.setPageSize(10); + + request.addSort(Sort.by("id").descending()); + Page page = demoRepository.findAll(request); + assertEquals(page.getContent().get(0).getName(), "456"); assertEquals(2, page.getTotalElements()); } + } diff --git a/springboot-starter-data-fast/src/test/java/com/codingapi/springboot/fast/JdbcQueryTest.java b/springboot-starter-data-fast/src/test/java/com/codingapi/springboot/fast/JdbcQueryTest.java new file mode 100644 index 000000000..daa71d4a1 --- /dev/null +++ b/springboot-starter-data-fast/src/test/java/com/codingapi/springboot/fast/JdbcQueryTest.java @@ -0,0 +1,44 @@ +package com.codingapi.springboot.fast; + +import com.codingapi.springboot.fast.entity.Demo; +import com.codingapi.springboot.fast.repository.DemoRepository; +import org.junit.jupiter.api.Test; +import org.springframework.beans.factory.annotation.Autowired; +import org.springframework.boot.test.context.SpringBootTest; +import org.springframework.data.domain.Page; +import org.springframework.data.domain.PageRequest; + +import java.util.Arrays; +import java.util.List; +import java.util.Map; + +import static org.junit.jupiter.api.Assertions.assertEquals; +import static org.junit.jupiter.api.Assertions.assertTrue; + +@SpringBootTest +public class JdbcQueryTest { + + @Autowired + private DemoRepository demoRepository; + + + @Test + void test() { + demoRepository.deleteAll(); + Demo demo = new Demo(); + demo.setName("123"); + demoRepository.save(demo); + assertTrue(demo.getId() > 0); + + String sql = "select d.* from t_demo as d where d.id in (d.id,?,?)"; + String countSql = "select count(d.id) from t_demo as d where d.id in (d.id,?,?)"; + PageRequest pageRequest = PageRequest.of(0, 10); + + List params = Arrays.asList(demo.getId(), demo.getId()); + Page> page = demoRepository.dynamicNativeMapPageMapQuery( + sql, countSql, pageRequest, params.toArray() + ); + assertEquals(page.getTotalElements(), page.getContent().size()); + } + +} diff --git a/springboot-starter-data-fast/src/test/java/com/codingapi/springboot/fast/MenuRepositoryTest.java b/springboot-starter-data-fast/src/test/java/com/codingapi/springboot/fast/MenuRepositoryTest.java new file mode 100644 index 000000000..00cfe07c6 --- /dev/null +++ b/springboot-starter-data-fast/src/test/java/com/codingapi/springboot/fast/MenuRepositoryTest.java @@ -0,0 +1,60 @@ +package com.codingapi.springboot.fast; + +import com.codingapi.springboot.fast.entity.Menu; +import com.codingapi.springboot.fast.repository.MenuRepository; +import com.codingapi.springboot.framework.dto.request.PageRequest; +import org.junit.jupiter.api.Test; +import org.springframework.beans.factory.annotation.Autowired; +import org.springframework.boot.test.context.SpringBootTest; +import org.springframework.data.domain.Page; + +import java.util.Arrays; +import java.util.List; + +@SpringBootTest +public class MenuRepositoryTest { + + @Autowired + private MenuRepository menuRepository; + + @Test + void test() { + + Menu parent = new Menu(); + parent.setName("parent"); + parent = menuRepository.save(parent); + + + Menu menu = new Menu(); + menu.setName("test"); + menu.setParent(parent); + menuRepository.save(menu); + + + PageRequest request = PageRequest.of(0, 10); + request.addFilter("parent.id", 1); + Page page = menuRepository.pageRequest(request); + System.out.println(page.getTotalElements()); + System.out.println(page.getContent()); + } + + + @Test + void test1() { + + Menu parent = new Menu(); + parent.setName("parent"); + parent = menuRepository.save(parent); + + + Menu menu = new Menu(); + menu.setName("test"); + menu.setParent(parent); + menuRepository.save(menu); + + + List menuList = menuRepository.dynamicListQuery("from Menu m where m.id in (?1)", Arrays.asList(1, 2)); + System.out.println(menuList); + } +} + diff --git a/springboot-starter-data-fast/src/test/java/com/codingapi/springboot/fast/UserRepositoryTest.java b/springboot-starter-data-fast/src/test/java/com/codingapi/springboot/fast/UserRepositoryTest.java new file mode 100644 index 000000000..166916919 --- /dev/null +++ b/springboot-starter-data-fast/src/test/java/com/codingapi/springboot/fast/UserRepositoryTest.java @@ -0,0 +1,163 @@ +package com.codingapi.springboot.fast; + +import com.codingapi.springboot.fast.entity.Demo; +import com.codingapi.springboot.fast.entity.Profile; +import com.codingapi.springboot.fast.entity.User; +import com.codingapi.springboot.fast.jpa.map.MapViewResult; +import com.codingapi.springboot.fast.jpa.map.QueryColumnsContext; +import com.codingapi.springboot.fast.repository.DemoRepository; +import com.codingapi.springboot.fast.repository.ProfileRepository; +import com.codingapi.springboot.fast.repository.UserRepository; +import com.codingapi.springboot.framework.dto.request.PageRequest; +import lombok.extern.slf4j.Slf4j; +import org.junit.jupiter.api.AfterEach; +import org.junit.jupiter.api.BeforeEach; +import org.junit.jupiter.api.Test; +import org.springframework.beans.factory.annotation.Autowired; +import org.springframework.boot.test.context.SpringBootTest; +import org.springframework.data.domain.Page; + +import java.util.List; + +import static org.junit.jupiter.api.Assertions.assertTrue; + +@Slf4j +@SpringBootTest +public class UserRepositoryTest { + + @Autowired + private DemoRepository demoRepository; + + @Autowired + private UserRepository userRepository; + + @Autowired + private ProfileRepository profileRepository; + + /** + * 测试数据与其他测试类共享同一个 H2 库（user→profile→demo 存在外键链）， + * 必须按外键顺序清理，且前后都要清理，避免测试类执行顺序不同导致 + * DemoRepositoryTest/JdbcQueryTest 的 deleteAll 触发外键约束冲突。 + */ + @BeforeEach + void cleanBefore() { + cleanAll(); + } + + @AfterEach + void cleanAfter() { + cleanAll(); + } + + private void cleanAll() { + userRepository.deleteAll(); + profileRepository.deleteAll(); + demoRepository.deleteAll(); + } + + + @Test + void test1() { + + Demo demo = new Demo(); + demo.setName("123"); + demoRepository.save(demo); + + + Profile profile = new Profile(); + profile.setDemo(demo); + profile.setName("123"); + profileRepository.save(profile); + + + User user = new User(); + user.setName("li"); + user.setProfile(profile); + userRepository.save(user); + + assertTrue(demo.getId()>0); + assertTrue(user.getId()>0); + + PageRequest request = new PageRequest(); + request.addFilter("profile.demo.id",1); + Page page = userRepository.pageRequest(request); + System.out.println(page.getContent()); + + } + + + @Test + void testMapQuery() { + + Demo demo = new Demo(); + demo.setName("123"); + demoRepository.save(demo); + + + Profile profile = new Profile(); + profile.setDemo(demo); + profile.setName("123"); + profileRepository.save(profile); + + + User user = new User(); + user.setName("li"); + user.setProfile(profile); + userRepository.save(user); + + assertTrue(demo.getId() > 0); + assertTrue(user.getId() > 0); + + PageRequest request = new PageRequest(); + request.addFilter("profile.demo.id", 1); + + String querySql = "from User u where u.profile.demo.id = ?1"; + String countSQL = "from User u where u.profile.demo.id = ?1"; + Page page = + userRepository.dynamicMapPageQuery( + QueryColumnsContext.build("u.id as iii","u.name"), + querySql, + countSQL, request, 1); + List queryMaps = page.getContent(); + System.out.println(queryMaps); + + List list = + userRepository.dynamicMapListQuery( + QueryColumnsContext.build("u.id as iii","u.name"), + querySql, + 1); + System.out.println(list); + + } + + + @Test + void test2() { + + Demo demo = new Demo(); + demo.setName("123"); + demoRepository.save(demo); + + + Profile profile = new Profile(); + profile.setDemo(demo); + profile.setName("123"); + profileRepository.save(profile); + + + User user = new User(); + user.setName("li"); + user.setProfile(profile); + userRepository.save(user); + + assertTrue(demo.getId()>0); + assertTrue(user.getId()>0); + + PageRequest request = new PageRequest(); + request.addFilter("name","li"); + Page page = userRepository.pageRequest(request); + System.out.println(page.getContent()); + + } + +} diff --git a/springboot-starter-data-fast/src/test/java/com/codingapi/springboot/fast/entity/Demo.java b/springboot-starter-data-fast/src/test/java/com/codingapi/springboot/fast/entity/Demo.java index 3e9e66d80..b0c922d72 100644 --- a/springboot-starter-data-fast/src/test/java/com/codingapi/springboot/fast/entity/Demo.java +++ b/springboot-starter-data-fast/src/test/java/com/codingapi/springboot/fast/entity/Demo.java @@ -2,12 +2,14 @@ import lombok.Getter; import lombok.Setter; +import lombok.ToString; -import jakarta.persistence.*; +import javax.persistence.*; @Setter @Getter @Entity +@ToString @Table(name = "t_demo") public class Demo { @Id @@ -15,4 +17,6 @@ public class Demo { private Integer id; private String name; + + private Integer sort; } diff --git a/springboot-starter-data-fast/src/test/java/com/codingapi/springboot/fast/entity/Menu.java b/springboot-starter-data-fast/src/test/java/com/codingapi/springboot/fast/entity/Menu.java new file mode 100644 index 000000000..efe7424cf --- /dev/null +++ b/springboot-starter-data-fast/src/test/java/com/codingapi/springboot/fast/entity/Menu.java @@ -0,0 +1,22 @@ +package com.codingapi.springboot.fast.entity; + +import javax.persistence.*; +import lombok.Getter; +import lombok.Setter; +import lombok.ToString; + +@Setter +@Getter +@Entity +@ToString +public class Menu { + + @Id + @GeneratedValue(strategy = GenerationType.IDENTITY) + private Integer id; + private String name; + + @ManyToOne + private Menu parent; + +} diff --git a/springboot-starter-data-fast/src/test/java/com/codingapi/springboot/fast/entity/Profile.java b/springboot-starter-data-fast/src/test/java/com/codingapi/springboot/fast/entity/Profile.java new file mode 100644 index 000000000..3ef6bb4af --- /dev/null +++ b/springboot-starter-data-fast/src/test/java/com/codingapi/springboot/fast/entity/Profile.java @@ -0,0 +1,21 @@ +package com.codingapi.springboot.fast.entity; + +import lombok.Getter; +import lombok.Setter; + +import javax.persistence.*; + +@Entity +@Setter +@Getter +public class Profile { + + @Id + @GeneratedValue(strategy = GenerationType.IDENTITY) + private int id; + + private String name; + + @OneToOne + private Demo demo; +} diff --git a/springboot-starter-data-fast/src/test/java/com/codingapi/springboot/fast/entity/User.java b/springboot-starter-data-fast/src/test/java/com/codingapi/springboot/fast/entity/User.java new file mode 100644 index 000000000..ab0b8815f --- /dev/null +++ b/springboot-starter-data-fast/src/test/java/com/codingapi/springboot/fast/entity/User.java @@ -0,0 +1,22 @@ +package com.codingapi.springboot.fast.entity; + +import lombok.Getter; +import lombok.Setter; + +import javax.persistence.*; + +@Entity +@Setter +@Getter +@Table(name = "t_user") +public class User { + + @Id + @GeneratedValue(strategy = GenerationType.IDENTITY) + private Integer id; + + private String name; + + @OneToOne + private Profile profile; +} diff --git a/springboot-starter-data-fast/src/test/java/com/codingapi/springboot/fast/generator/DynamicTableGeneratorQueryTest.java b/springboot-starter-data-fast/src/test/java/com/codingapi/springboot/fast/generator/DynamicTableGeneratorQueryTest.java new file mode 100644 index 000000000..843f5b53c --- /dev/null +++ b/springboot-starter-data-fast/src/test/java/com/codingapi/springboot/fast/generator/DynamicTableGeneratorQueryTest.java @@ -0,0 +1,75 @@ +package com.codingapi.springboot.fast.generator; + +import com.codingapi.springboot.fast.jdbc.JdbcQuery; +import com.codingapi.springboot.fast.jdbc.JdbcQueryContext; +import com.codingapi.springboot.fast.jpa.JpaQuery; +import com.codingapi.springboot.fast.jpa.JpaQueryContext; +import com.codingapi.springboot.fast.metadata.TableEntityMetadata; +import javax.persistence.EntityManagerFactory; +import javax.persistence.GenerationType; +import org.hibernate.cfg.AvailableSettings; +import org.junit.jupiter.api.Test; +import org.springframework.beans.factory.annotation.Autowired; +import org.springframework.boot.test.context.SpringBootTest; +import org.springframework.core.env.Environment; +import org.springframework.jdbc.core.JdbcTemplate; + +import java.util.List; +import java.util.Map; + +import static org.junit.jupiter.api.Assertions.assertFalse; +import static org.junit.jupiter.api.Assertions.assertThrows; + +@SpringBootTest +public class DynamicTableGeneratorQueryTest { + + @Autowired + private EntityManagerFactory entityManagerFactory; + + @Autowired + private Environment environment; + + @Autowired + private JdbcTemplate jdbcTemplate; + + + @Test + void generateThenUpdateQuery() throws ClassNotFoundException { + String dialect = entityManagerFactory.getProperties().get(AvailableSettings.DIALECT).toString(); + String jdbcUrl = environment.getProperty("spring.datasource.url"); + String username = environment.getProperty("spring.datasource.username"); + String password = environment.getProperty("spring.datasource.password"); + + DynamicTableGenerator dynamicTableGenerator = new DynamicTableGenerator(Class.forName(dialect), jdbcUrl, username, password); + + TableEntityMetadata tableEntityMetadata = new TableEntityMetadata("com.codingapi.springboot.fast.entity.Test"); + tableEntityMetadata.setTable("test"); + tableEntityMetadata.addPrimaryKeyColumn(Long.class, "id", GenerationType.IDENTITY, "主键"); + tableEntityMetadata.addColumn(String.class, "name", "姓名"); + tableEntityMetadata.addColumn(String.class, "description", "描述",true); + + Class entityClass = tableEntityMetadata.buildClass(); + + dynamicTableGenerator.generateDropTableDDL(entityClass,true); + + // 创建表 + String sql = dynamicTableGenerator.generateMigratorTableDDL(entityClass, true); + System.out.println(sql); + + // 通过DynamicTableGenerator 动态创建的entity无法通过jpa的 EntityManager进行数据查询处理, 因为Entity不在JPA扫描支持的范围内。 + JpaQuery jpaQuery = JpaQueryContext.getInstance().getJpaQuery(); + assertThrows(Exception.class,()->{ + jpaQuery.listQuery(entityClass,"select t from com.codingapi.springboot.fast.entity.Test"); + }); + + // 插入数据 + jdbcTemplate.update("insert into test(name,description) values(?,?)", "小明","123"); + + // 查询数据 + JdbcQuery jdbcQuery = JdbcQueryContext.getInstance().getJdbcQuery(); + List> list = jdbcQuery.queryForMapList("select * from test"); + System.out.println(list); + assertFalse(list.isEmpty()); + + } +} \ No newline at end of file diff --git a/springboot-starter-data-fast/src/test/java/com/codingapi/springboot/fast/generator/DynamicTableGeneratorTest.java b/springboot-starter-data-fast/src/test/java/com/codingapi/springboot/fast/generator/DynamicTableGeneratorTest.java new file mode 100644 index 000000000..5a240b2da --- /dev/null +++ b/springboot-starter-data-fast/src/test/java/com/codingapi/springboot/fast/generator/DynamicTableGeneratorTest.java @@ -0,0 +1,62 @@ +package com.codingapi.springboot.fast.generator; + +import com.codingapi.springboot.fast.entity.Demo; +import com.codingapi.springboot.fast.metadata.TableEntityMetadata; +import javax.persistence.GenerationType; +import org.hibernate.dialect.H2Dialect; +import org.junit.jupiter.api.Test; + +import java.util.List; + +import static org.junit.jupiter.api.Assertions.assertNotNull; + +class DynamicTableGeneratorTest { + + @Test + void generateTableDDL() { + DynamicTableGenerator dynamicTableGenerator = new DynamicTableGenerator(H2Dialect.class,"jdbc:h2:file:./test.db"); + List exceptions = dynamicTableGenerator.validatorTable(Demo.class); + System.out.println(exceptions); + + String createDDL = dynamicTableGenerator.generateCreateTableDDL(Demo.class); + System.out.println("createDDL:\n" + createDDL); + assertNotNull(createDDL); + + String dropDDL = dynamicTableGenerator.generateDropTableDDL(Demo.class); + System.out.println("dropDDL:\n" + dropDDL); + assertNotNull(dropDDL); + + String migrateDDL = dynamicTableGenerator.generateMigratorTableDDL(Demo.class); + System.out.println("migrateDDL:\n" + migrateDDL); + assertNotNull(migrateDDL); + } + + @Test + void dynamicGenerateTableDDL() { + DynamicTableGenerator dynamicTableGenerator = new DynamicTableGenerator(H2Dialect.class,"jdbc:h2:file:./test.db"); + + TableEntityMetadata tableEntityMetadata = new TableEntityMetadata("com.codingapi.entity.Test"); + tableEntityMetadata.setTable("test"); + tableEntityMetadata.addPrimaryKeyColumn(Long.class,"id", GenerationType.IDENTITY,"主键"); + tableEntityMetadata.addColumn(String.class,"name","姓名"); + tableEntityMetadata.addColumn(String.class,"desc","描述",true); + + Class entityClass = tableEntityMetadata.buildClass(); + + List exceptions = dynamicTableGenerator.validatorTable(entityClass); + System.out.println(exceptions); + + String createDDL = dynamicTableGenerator.generateCreateTableDDL(entityClass); + System.out.println("createDDL:\n" + createDDL); + assertNotNull(createDDL); + + String dropDDL = dynamicTableGenerator.generateDropTableDDL(entityClass); + System.out.println("dropDDL:\n" + dropDDL); + assertNotNull(dropDDL); + + String migrateDDL = dynamicTableGenerator.generateMigratorTableDDL(entityClass); + System.out.println("migrateDDL:\n" + migrateDDL); + assertNotNull(migrateDDL); + + } +} \ No newline at end of file diff --git a/springboot-starter-data-fast/src/test/java/com/codingapi/springboot/fast/jdbc/JdbcQueryUnitTest.java b/springboot-starter-data-fast/src/test/java/com/codingapi/springboot/fast/jdbc/JdbcQueryUnitTest.java new file mode 100644 index 000000000..3a1f17845 --- /dev/null +++ b/springboot-starter-data-fast/src/test/java/com/codingapi/springboot/fast/jdbc/JdbcQueryUnitTest.java @@ -0,0 +1,241 @@ +package com.codingapi.springboot.fast.jdbc; + +import com.codingapi.springboot.fast.jpa.SQLBuilder; +import org.h2.jdbcx.JdbcDataSource; +import org.junit.jupiter.api.BeforeEach; +import org.junit.jupiter.api.Test; +import org.mockito.ArgumentMatchers; +import org.springframework.data.domain.Page; +import org.springframework.data.domain.PageImpl; +import org.springframework.data.domain.PageRequest; +import org.springframework.jdbc.core.BeanPropertyRowMapper; +import org.springframework.jdbc.core.JdbcTemplate; +import org.springframework.jdbc.core.RowMapper; + +import java.util.ArrayList; +import java.util.List; +import java.util.Map; + +import static org.junit.jupiter.api.Assertions.assertEquals; +import static org.junit.jupiter.api.Assertions.assertTrue; +import static org.mockito.ArgumentMatchers.any; +import static org.mockito.ArgumentMatchers.anyString; +import static org.mockito.ArgumentMatchers.eq; +import static org.mockito.Mockito.doReturn; +import static org.mockito.Mockito.mock; +import static org.mockito.Mockito.verify; + +/** + * JdbcQuery 单元测试：基于独立的 H2 内存库，不依赖 Spring 上下文， + * 与其他测试类的数据完全隔离。 + */ +class JdbcQueryUnitTest { + + /** + * 查询结果行映射 Bean（列 user_name 映射到 userName） + */ + public static class JqRow { + private Integer id; + private String userName; + private Integer sort; + + public Integer getId() { + return id; + } + + public void setId(Integer id) { + this.id = id; + } + + public String getUserName() { + return userName; + } + + public void setUserName(String userName) { + this.userName = userName; + } + + public Integer getSort() { + return sort; + } + + public void setSort(Integer sort) { + this.sort = sort; + } + } + + private JdbcTemplate jdbcTemplate; + private JdbcQuery jdbcQuery; + + @BeforeEach + void setUp() { + JdbcDataSource dataSource = new JdbcDataSource(); + dataSource.setURL("jdbc:h2:mem:jdbc_query_unit;DB_CLOSE_DELAY=-1"); + jdbcTemplate = new JdbcTemplate(dataSource); + jdbcTemplate.execute("drop table if exists jq_demo"); + jdbcTemplate.execute("create table jq_demo(id int primary key, user_name varchar(50), sort int)"); + jdbcTemplate.update("insert into jq_demo(id, user_name, sort) values (?, ?, ?)", 1, "alice", 10); + jdbcTemplate.update("insert into jq_demo(id, user_name, sort) values (?, ?, ?)", 2, "bob", 20); + jdbcQuery = new JdbcQuery(jdbcTemplate); + } + + /** + * Map 查询，验证下划线列名转驼峰 + */ + @Test + void queryForMapList() { + List> list = jdbcQuery.queryForMapList("select * from jq_demo order by id"); + assertEquals(2, list.size()); + assertEquals("alice", list.get(0).get("userName")); + assertEquals("bob", list.get(1).get("userName")); + assertTrue(list.get(0).containsKey("id")); + assertTrue(list.get(0).containsKey("sort")); + } + + @Test + void queryForMapListWithParams() { + List> list = jdbcQuery.queryForMapList( + "select * from jq_demo where sort > ?", 15); + assertEquals(1, list.size()); + assertEquals("bob", list.get(0).get("userName")); + } + + @Test + void queryForMapListWithBuilder() { + SQLBuilder builder = new SQLBuilder<>( + "select * from jq_demo where 1=1", "select count(1) from jq_demo where 1=1"); + builder.append("and id = ?", 1); + List> list = jdbcQuery.queryForMapList(builder); + assertEquals(1, list.size()); + assertEquals("alice", list.get(0).get("userName")); + } + + /** + * Bean 查询 + */ + @Test + void queryForList() { + List list = jdbcQuery.queryForList( + "select * from jq_demo where id = ?", JqRow.class, 2); + assertEquals(1, list.size()); + assertEquals("bob", list.get(0).getUserName()); + assertEquals(Integer.valueOf(20), list.get(0).getSort()); + } + + @Test + void queryForListWithBuilder() { + SQLBuilder builder = new SQLBuilder<>( + JqRow.class, "select * from jq_demo where 1=1", "select count(1) from jq_demo where 1=1"); + builder.append("and sort <= ?", 10); + List list = jdbcQuery.queryForList(builder); + assertEquals(1, list.size()); + assertEquals("alice", list.get(0).getUserName()); + } + + /** + * 分页查询（显式 count SQL） + */ + @Test + void queryForPageWithCountSql() { + Page page = jdbcQuery.queryForPage( + "select * from jq_demo where sort > ?", + "select count(1) from jq_demo where sort > ?", + JqRow.class, PageRequest.of(0, 10), 5); + assertEquals(2, page.getTotalElements()); + assertEquals(2, page.getContent().size()); + } + + @Test + void queryForPageWithBuilder() { + SQLBuilder builder = new SQLBuilder<>( + JqRow.class, "select * from jq_demo where 1=1", "select count(1) from jq_demo where 1=1"); + builder.append("and sort > ?", 15); + Page page = jdbcQuery.queryForPage(builder, PageRequest.of(0, 10)); + assertEquals(1, page.getTotalElements()); + assertEquals("bob", page.getContent().get(0).getUserName()); + } + + /** + * Map 分页查询（显式 count SQL） + */ + @Test + void queryForMapPageWithCountSql() { + Page> page = jdbcQuery.queryForMapPage( + "select * from jq_demo where sort > ?", + "select count(1) from jq_demo where sort > ?", + PageRequest.of(0, 10), 5); + assertEquals(2, page.getTotalElements()); + assertEquals(2, page.getContent().size()); + } + + @Test + void queryForMapPageWithBuilder() { + SQLBuilder builder = new SQLBuilder<>( + "select * from jq_demo where 1=1", "select count(1) from jq_demo where 1=1"); + builder.append("and id = ?", 2); + Page> page = jdbcQuery.queryForMapPage(builder, PageRequest.of(0, 10)); + assertEquals(1, page.getTotalElements()); + assertEquals("bob", page.getContent().get(0).get("userName")); + } + + /** + * count SQL 占位符数量少于查询参数时，内部 arraycopy 截断参数 + */ + @Test + void queryForMapPageTruncatesParamsForCountSql() { + Page> page = jdbcQuery.queryForMapPage( + "select * from jq_demo where sort > ?", + "select count(1) from jq_demo", + PageRequest.of(0, 10), 5); + assertEquals(2, page.getTotalElements()); + assertEquals(2, page.getContent().size()); + } + + /** + * 自动拼接 count SQL 的两个方法：countSql = "SELECT COUNT(1) " + sql， + * 要求 sql 以 from 开头。原生 SQL 无法同时满足两种形态， + * 因此用 mock 的 JdbcTemplate 验证其 count SQL 拼装与调用逻辑。 + */ + @Test + void queryForPageAutoCountSql() { + JqRow row = new JqRow(); + row.setId(1); + row.setUserName("alice"); + List rows = new ArrayList<>(); + rows.add(row); + // 空参数数组的 varargs 调用无法被 Mockito 桩匹配, 改用 default answer 直接返回数据 + JdbcTemplate mockTemplate = mock(JdbcTemplate.class, invocation -> { + String methodName = invocation.getMethod().getName(); + if ("query".equals(methodName)) { + return rows; + } + if ("queryForObject".equals(methodName)) { + return 1L; + } + return null; + }); + + JdbcQuery query = new JdbcQuery(mockTemplate); + Page page = query.queryForPage("from jq_demo", JqRow.class, PageRequest.of(0, 10)); + + assertEquals(1, page.getTotalElements()); + assertEquals(1, page.getContent().size()); + verify(mockTemplate).queryForObject(eq("SELECT COUNT(1) from jq_demo"), eq(Long.class)); + } + + @Test + void queryForMapPageAutoCountSql() { + JdbcTemplate mockTemplate = mock(JdbcTemplate.class); + List> rows = new ArrayList<>(); + doReturn(rows).when(mockTemplate).query(anyString(), any(RowMapper.class), (Object[]) any()); + // 自动 count SQL 无占位符, countQuery 以空参数数组调用; 不带 varargs 参数的桩恰好匹配零长 varargs 调用 + doReturn(0L).when(mockTemplate).queryForObject(anyString(), eq(Long.class)); + + JdbcQuery query = new JdbcQuery(mockTemplate); + Page> page = query.queryForMapPage("from jq_demo", PageRequest.of(0, 10)); + + assertEquals(0, page.getTotalElements()); + assertTrue(page.getContent().isEmpty()); + verify(mockTemplate).queryForObject(eq("SELECT COUNT(1) from jq_demo"), eq(Long.class)); + } +} diff --git a/springboot-starter-data-fast/src/test/java/com/codingapi/springboot/fast/jpa/SQLBuilderTest.java b/springboot-starter-data-fast/src/test/java/com/codingapi/springboot/fast/jpa/SQLBuilderTest.java new file mode 100644 index 000000000..316c6eeb9 --- /dev/null +++ b/springboot-starter-data-fast/src/test/java/com/codingapi/springboot/fast/jpa/SQLBuilderTest.java @@ -0,0 +1,88 @@ +package com.codingapi.springboot.fast.jpa; + +import org.junit.jupiter.api.Test; + +import static org.junit.jupiter.api.Assertions.assertArrayEquals; +import static org.junit.jupiter.api.Assertions.assertEquals; +import static org.junit.jupiter.api.Assertions.assertNull; + +/** + * SQLBuilder 单元测试（覆盖全部构造器与追加方法） + */ +class SQLBuilderTest { + + @Test + void constructorWithSqlOnly() { + SQLBuilder builder = new SQLBuilder<>("select * from t_demo where 1=1"); + assertEquals("select * from t_demo where 1=1", builder.getSQL()); + assertEquals("select count(1) from select * from t_demo where 1=1", builder.getCountSQL()); + assertEquals(1, builder.getIndex()); + assertNull(builder.getClazz()); + assertEquals(0, builder.getParams().length); + } + + @Test + void constructorWithSqlAndCountSql() { + SQLBuilder builder = new SQLBuilder<>("select * from t_demo", "select count(1) from t_demo"); + assertEquals("select * from t_demo", builder.getSQL()); + assertEquals("select count(1) from t_demo", builder.getCountSQL()); + } + + @Test + void constructorWithClassAndSql() { + SQLBuilder builder = new SQLBuilder<>(String.class, "select name from t_demo"); + assertEquals(String.class, builder.getClazz()); + assertEquals("select name from t_demo", builder.getSQL()); + assertEquals("select count(1) from select name from t_demo", builder.getCountSQL()); + } + + @Test + void constructorWithClassSqlAndCountSql() { + SQLBuilder builder = new SQLBuilder<>(String.class, "select name from t_demo", "select count(1) from t_demo"); + assertEquals(String.class, builder.getClazz()); + assertEquals("select name from t_demo", builder.getSQL()); + assertEquals("select count(1) from t_demo", builder.getCountSQL()); + } + + /** + * append 非空值时拼接带序号的占位符，null 值时忽略 + */ + @Test + void append() { + SQLBuilder builder = new SQLBuilder<>("select * from t_demo where 1=1", "select count(1) from t_demo where 1=1"); + builder.append("and name = ?", "tom"); + assertEquals("select * from t_demo where 1=1 and name = ?1 ", builder.getSQL()); + assertEquals("select count(1) from t_demo where 1=1 and name = ?1 ", builder.getCountSQL()); + assertEquals(2, builder.getIndex()); + assertArrayEquals(new Object[]{"tom"}, builder.getParams()); + + // null 值不追加 + builder.append("and id = ?", null); + assertEquals("select * from t_demo where 1=1 and name = ?1 ", builder.getSQL()); + assertEquals(2, builder.getIndex()); + assertEquals(1, builder.getParams().length); + + builder.append("and sort > ?", 10); + assertEquals("select * from t_demo where 1=1 and name = ?1 and sort > ?2 ", builder.getSQL()); + assertEquals(3, builder.getIndex()); + assertArrayEquals(new Object[]{"tom", 10}, builder.getParams()); + } + + @Test + void addParam() { + SQLBuilder builder = new SQLBuilder<>("select * from t_demo"); + builder.addParam("a"); + assertEquals(2, builder.getIndex()); + builder.addParam("b", 9); + assertEquals(9, builder.getIndex()); + assertArrayEquals(new Object[]{"a", "b"}, builder.getParams()); + } + + @Test + void appendSql() { + SQLBuilder builder = new SQLBuilder<>("select * from t_demo", "select count(1) from t_demo"); + builder.appendSql("order by id desc"); + assertEquals("select * from t_demo order by id desc ", builder.getSQL()); + assertEquals("select count(1) from t_demo order by id desc ", builder.getCountSQL()); + } +} diff --git a/springboot-starter-data-fast/src/test/java/com/codingapi/springboot/fast/jpa/map/MapViewResultTest.java b/springboot-starter-data-fast/src/test/java/com/codingapi/springboot/fast/jpa/map/MapViewResultTest.java new file mode 100644 index 000000000..d553b7f62 --- /dev/null +++ b/springboot-starter-data-fast/src/test/java/com/codingapi/springboot/fast/jpa/map/MapViewResultTest.java @@ -0,0 +1,111 @@ +package com.codingapi.springboot.fast.jpa.map; + +import org.junit.jupiter.api.Test; + +import java.lang.reflect.Constructor; +import java.util.Arrays; + +import static org.junit.jupiter.api.Assertions.assertEquals; +import static org.junit.jupiter.api.Assertions.assertNull; + +/** + * MapViewResult 拥有 253 个构造器重载（1~253 个值参数）， + * 通过反射逐个 arity 调用，确保每个构造器与 build 逻辑都被覆盖。 + * + * 注意：build(key, values) 按 QueryColumns 的列数量遍历取值， + * 因此每个 arity 需要注册一个列数量与之匹配的 QueryColumns。 + */ +class MapViewResultTest { + + private static final int MAX_ARITY = 253; + + private String[] buildColumns(int count) { + String[] columns = new String[count]; + for (int i = 0; i < count; i++) { + columns[i] = "c" + i; + } + return columns; + } + + private Object[] buildValues(int count) { + Object[] values = new Object[count]; + for (int i = 0; i < count; i++) { + values[i] = "v" + i; + } + return values; + } + + /** + * 参数化遍历全部 253 个构造器重载 + */ + @Test + void allConstructorOverloads() throws Exception { + for (int arity = 1; arity <= MAX_ARITY; arity++) { + QueryColumns queryColumns = QueryColumnsContext.build(buildColumns(arity)); + String key = queryColumns.getKey(); + try { + Class[] parameterTypes = new Class[arity + 1]; + parameterTypes[0] = String.class; + Arrays.fill(parameterTypes, 1, arity + 1, Object.class); + Constructor constructor = MapViewResult.class.getConstructor(parameterTypes); + + Object[] args = new Object[arity + 1]; + args[0] = key; + Object[] values = buildValues(arity); + System.arraycopy(values, 0, args, 1, arity); + + MapViewResult result = constructor.newInstance(args); + + assertEquals(arity, result.size(), "arity=" + arity); + assertEquals("v0", result.get("c0"), "arity=" + arity); + assertEquals("v" + (arity - 1), result.get("c" + (arity - 1)), "arity=" + arity); + assertNull(result.get("not-exist"), "arity=" + arity); + } finally { + QueryColumnsContext.getInstance().clearCache(key); + } + } + } + + /** + * 直接调用部分常用构造器，验证列名映射与值顺序 + */ + @Test + void directConstructors() { + QueryColumns two = QueryColumnsContext.build("u.id as iii", "u.name"); + MapViewResult result2 = new MapViewResult(two.getKey(), 1, "tom"); + assertEquals(2, result2.size()); + assertEquals(1, result2.get("iii")); + assertEquals("tom", result2.get("name")); + QueryColumnsContext.getInstance().clearCache(two.getKey()); + + QueryColumns three = QueryColumnsContext.build("a", "b", "c"); + MapViewResult result3 = new MapViewResult(three.getKey(), 1, 2L, 3.5); + assertEquals(3, result3.size()); + assertEquals(1, result3.get("a")); + assertEquals(2L, result3.get("b")); + assertEquals(3.5, result3.get("c")); + QueryColumnsContext.getInstance().clearCache(three.getKey()); + + QueryColumns five = QueryColumnsContext.build("a", "b", "c", "d", "e"); + MapViewResult result5 = new MapViewResult(five.getKey(), "1", "2", "3", "4", "5"); + assertEquals(5, result5.size()); + assertEquals("5", result5.get("e")); + QueryColumnsContext.getInstance().clearCache(five.getKey()); + } + + /** + * MapViewResult 本身是一个 Map，验证 Map 的基础行为 + */ + @Test + void mapBehavior() { + QueryColumns columns = QueryColumnsContext.build("name", "age"); + MapViewResult result = new MapViewResult(columns.getKey(), "tom", 18); + assertEquals(true, result.containsKey("name")); + assertEquals(true, result.containsValue(18)); + result.put("extra", "value"); + assertEquals(3, result.size()); + result.remove("extra"); + assertEquals(2, result.size()); + QueryColumnsContext.getInstance().clearCache(columns.getKey()); + } +} diff --git a/springboot-starter-data-fast/src/test/java/com/codingapi/springboot/fast/jpa/map/QueryColumnsTest.java b/springboot-starter-data-fast/src/test/java/com/codingapi/springboot/fast/jpa/map/QueryColumnsTest.java new file mode 100644 index 000000000..09aedae2d --- /dev/null +++ b/springboot-starter-data-fast/src/test/java/com/codingapi/springboot/fast/jpa/map/QueryColumnsTest.java @@ -0,0 +1,92 @@ +package com.codingapi.springboot.fast.jpa.map; + +import org.junit.jupiter.api.Test; + +import java.util.Arrays; +import java.util.List; + +import static org.junit.jupiter.api.Assertions.assertEquals; +import static org.junit.jupiter.api.Assertions.assertNotNull; +import static org.junit.jupiter.api.Assertions.assertNull; +import static org.junit.jupiter.api.Assertions.assertSame; + +/** + * QueryColumns / QueryColumnsContext 单元测试 + */ +class QueryColumnsTest { + + /** + * 列别名解析：覆盖 小写as、大写AS、表前缀(.)、普通列 四种分支 + */ + @Test + void getColumnAlias() { + QueryColumns columns = QueryColumnsContext.build( + "u.id as iii", + "u.name AS userName", + "t_demo.sort", + "plain_column", + " spaced " + ); + List aliases = columns.getColumnAlias(); + assertEquals(Arrays.asList("iii", "userName", "sort", "plain_column", "spaced"), aliases); + QueryColumnsContext.getInstance().clearCache(columns.getKey()); + } + + /** + * 多个 as/AS 时取最后一段 + */ + @Test + void getColumnAliasWithMultipleAs() { + QueryColumns columns = QueryColumnsContext.build("concat(a,b) as x as y"); + List aliases = columns.getColumnAlias(); + assertEquals(1, aliases.size()); + assertEquals("y", aliases.get(0)); + QueryColumnsContext.getInstance().clearCache(columns.getKey()); + } + + @Test + void getColumnSql() { + QueryColumns columns = QueryColumnsContext.build("u.id as iii", "u.name"); + assertEquals("u.id as iii,u.name", columns.getColumnSql()); + assertEquals(2, columns.getColumns().size()); + QueryColumnsContext.getInstance().clearCache(columns.getKey()); + } + + /** + * addColumn 支持链式调用 + */ + @Test + void addColumnChaining() { + QueryColumns columns = new QueryColumns(); + assertNotNull(columns.getKey()); + assertEquals(8, columns.getKey().length()); + QueryColumns same = columns.addColumn("a").addColumn("b"); + assertSame(columns, same); + assertEquals("a,b", columns.getColumnSql()); + } + + /** + * context 注册、查询与清理 + */ + @Test + void contextBuildAndClear() { + QueryColumns columns = QueryColumnsContext.build("id"); + String key = columns.getKey(); + assertSame(columns, QueryColumnsContext.getInstance().getQueryColumns(key)); + QueryColumnsContext.getInstance().clearCache(key); + assertNull(QueryColumnsContext.getInstance().getQueryColumns(key)); + } + + /** + * 每次 build 生成的 key 不同，互不影响 + */ + @Test + void contextKeysAreIndependent() { + QueryColumns c1 = QueryColumnsContext.build("a"); + QueryColumns c2 = QueryColumnsContext.build("b"); + assertNotNull(QueryColumnsContext.getInstance().getQueryColumns(c1.getKey())); + assertNotNull(QueryColumnsContext.getInstance().getQueryColumns(c2.getKey())); + QueryColumnsContext.getInstance().clearCache(c1.getKey()); + QueryColumnsContext.getInstance().clearCache(c2.getKey()); + } +} diff --git a/springboot-starter-data-fast/src/test/java/com/codingapi/springboot/fast/jpa/repository/DynamicSQLBuilderTest.java b/springboot-starter-data-fast/src/test/java/com/codingapi/springboot/fast/jpa/repository/DynamicSQLBuilderTest.java new file mode 100644 index 000000000..2718580ff --- /dev/null +++ b/springboot-starter-data-fast/src/test/java/com/codingapi/springboot/fast/jpa/repository/DynamicSQLBuilderTest.java @@ -0,0 +1,210 @@ +package com.codingapi.springboot.fast.jpa.repository; + +import com.codingapi.springboot.fast.entity.Demo; +import com.codingapi.springboot.framework.dto.request.Filter; +import com.codingapi.springboot.framework.dto.request.PageRequest; +import com.codingapi.springboot.framework.dto.request.Relation; +import org.junit.jupiter.api.Test; +import org.springframework.data.domain.Sort; + +import java.util.Arrays; +import java.util.Collections; + +import static org.junit.jupiter.api.Assertions.assertArrayEquals; +import static org.junit.jupiter.api.Assertions.assertEquals; + +/** + * DynamicSQLBuilder 单元测试：覆盖全部过滤关系、or/and 嵌套与排序拼装。 + * （DynamicSQLBuilder 为包级私有，测试类置于同一包下） + */ +class DynamicSQLBuilderTest { + + @Test + void emptyRequest() { + PageRequest request = new PageRequest(); + DynamicSQLBuilder builder = new DynamicSQLBuilder(request, Demo.class); + assertEquals("FROM Demo WHERE ", builder.getHQL()); + assertEquals("SELECT COUNT(1) FROM Demo WHERE ", builder.getCountHQL()); + assertEquals(0, builder.getParams().length); + } + + @Test + void equalFilter() { + PageRequest request = new PageRequest(); + request.addFilter("name", "tom"); + DynamicSQLBuilder builder = new DynamicSQLBuilder(request, Demo.class); + assertEquals("FROM Demo WHERE name = ?1", builder.getHQL()); + assertEquals("SELECT COUNT(1) FROM Demo WHERE name = ?1", builder.getCountHQL()); + assertArrayEquals(new Object[]{"tom"}, builder.getParams()); + } + + @Test + void nullFilters() { + PageRequest request = new PageRequest(); + request.addFilter("name", Relation.IS_NULL); + DynamicSQLBuilder builder = new DynamicSQLBuilder(request, Demo.class); + assertEquals("FROM Demo WHERE name IS NULL ", builder.getHQL()); + assertEquals(0, builder.getParams().length); + } + + @Test + void notNullFilter() { + PageRequest request = new PageRequest(); + request.addFilter("name", Relation.IS_NOT_NULL); + DynamicSQLBuilder builder = new DynamicSQLBuilder(request, Demo.class); + assertEquals("FROM Demo WHERE name IS NOT NULL ", builder.getHQL()); + assertEquals(0, builder.getParams().length); + } + + @Test + void notEqualFilter() { + PageRequest request = new PageRequest(); + request.addFilter("name", Relation.NOT_EQUAL, "tom"); + DynamicSQLBuilder builder = new DynamicSQLBuilder(request, Demo.class); + assertEquals("FROM Demo WHERE name != ?1", builder.getHQL()); + assertArrayEquals(new Object[]{"tom"}, builder.getParams()); + } + + @Test + void likeFilters() { + PageRequest request = new PageRequest(); + request.addFilter("name", Relation.LIKE, "to"); + DynamicSQLBuilder builder = new DynamicSQLBuilder(request, Demo.class); + assertEquals("FROM Demo WHERE name LIKE ?1", builder.getHQL()); + assertArrayEquals(new Object[]{"%to%"}, builder.getParams()); + + PageRequest left = new PageRequest(); + left.addFilter("name", Relation.LEFT_LIKE, "to"); + DynamicSQLBuilder leftBuilder = new DynamicSQLBuilder(left, Demo.class); + assertEquals("FROM Demo WHERE name LIKE ?1", leftBuilder.getHQL()); + assertArrayEquals(new Object[]{"%to"}, leftBuilder.getParams()); + + PageRequest right = new PageRequest(); + right.addFilter("name", Relation.RIGHT_LIKE, "to"); + DynamicSQLBuilder rightBuilder = new DynamicSQLBuilder(right, Demo.class); + assertEquals("FROM Demo WHERE name LIKE ?1", rightBuilder.getHQL()); + assertArrayEquals(new Object[]{"to%"}, rightBuilder.getParams()); + } + + @Test + void inAndNotInFilters() { + PageRequest request = new PageRequest(); + request.addFilter("id", Relation.IN, 1, 2, 3); + DynamicSQLBuilder builder = new DynamicSQLBuilder(request, Demo.class); + assertEquals("FROM Demo WHERE id IN (?1)", builder.getHQL()); + assertEquals(1, builder.getParams().length); + assertEquals(Arrays.asList(1, 2, 3), builder.getParams()[0]); + + PageRequest notIn = new PageRequest(); + notIn.addFilter("id", Relation.NOT_IN, 4); + DynamicSQLBuilder notInBuilder = new DynamicSQLBuilder(notIn, Demo.class); + assertEquals("FROM Demo WHERE id NOT IN (?1)", notInBuilder.getHQL()); + assertEquals(Collections.singletonList(4), notInBuilder.getParams()[0]); + } + + @Test + void compareFilters() { + PageRequest request = new PageRequest(); + request.addFilter("sort", Relation.GREATER_THAN, 1); + assertEquals("FROM Demo WHERE sort > ?1", new DynamicSQLBuilder(request, Demo.class).getHQL()); + + PageRequest lt = new PageRequest(); + lt.addFilter("sort", Relation.LESS_THAN, 2); + assertEquals("FROM Demo WHERE sort < ?1", new DynamicSQLBuilder(lt, Demo.class).getHQL()); + + PageRequest gte = new PageRequest(); + gte.addFilter("sort", Relation.GREATER_THAN_EQUAL, 3); + assertEquals("FROM Demo WHERE sort >= ?1", new DynamicSQLBuilder(gte, Demo.class).getHQL()); + + PageRequest lte = new PageRequest(); + lte.addFilter("sort", Relation.LESS_THAN_EQUAL, 4); + assertEquals("FROM Demo WHERE sort <= ?1", new DynamicSQLBuilder(lte, Demo.class).getHQL()); + } + + /** + * BETWEEN 使用两个占位符，且后续参数序号连续 + */ + @Test + void betweenFilterWithFollowingFilter() { + PageRequest request = new PageRequest(); + request.addFilter("sort", Relation.BETWEEN, 1, 10); + request.addFilter("name", "tom"); + DynamicSQLBuilder builder = new DynamicSQLBuilder(request, Demo.class); + assertEquals("FROM Demo WHERE sort BETWEEN ?1 AND ?2 AND name = ?3", builder.getHQL()); + assertArrayEquals(new Object[]{1, 10, "tom"}, builder.getParams()); + } + + /** + * or 过滤组装 + */ + @Test + void orFilters() { + PageRequest request = new PageRequest(); + request.orFilters(Filter.as("name", "a"), Filter.as("name", "b")); + DynamicSQLBuilder builder = new DynamicSQLBuilder(request, Demo.class); + assertEquals("FROM Demo WHERE ( name = ?1 OR name = ?2 )", builder.getHQL()); + assertArrayEquals(new Object[]{"a", "b"}, builder.getParams()); + } + + /** + * and 过滤组装 + */ + @Test + void andFilters() { + PageRequest request = new PageRequest(); + request.andFilter(Filter.as("name", "a"), Filter.as("sort", Relation.GREATER_THAN, 1)); + DynamicSQLBuilder builder = new DynamicSQLBuilder(request, Demo.class); + assertEquals("FROM Demo WHERE ( name = ?1 AND sort > ?2 )", builder.getHQL()); + assertArrayEquals(new Object[]{"a", 1}, builder.getParams()); + } + + /** + * or 嵌套 and 的递归组装 + */ + @Test + void nestedOrAndFilters() { + PageRequest request = new PageRequest(); + request.orFilters(Filter.and(Filter.as("name", "a"), Filter.as("name", "b")), Filter.as("name", "c")); + DynamicSQLBuilder builder = new DynamicSQLBuilder(request, Demo.class); + assertEquals("FROM Demo WHERE ( ( name = ?1 AND name = ?2 ) OR name = ?3 )", builder.getHQL()); + assertArrayEquals(new Object[]{"a", "b", "c"}, builder.getParams()); + } + + /** + * 空的 or/and 过滤组不产生任何 SQL + */ + @Test + void emptyOrAndFilters() { + PageRequest request = new PageRequest(); + request.orFilters(); + request.andFilter(); + DynamicSQLBuilder builder = new DynamicSQLBuilder(request, Demo.class); + assertEquals("FROM Demo WHERE ", builder.getHQL()); + assertEquals(0, builder.getParams().length); + } + + /** + * 多字段排序拼装（通过构造器传入多字段 Sort） + */ + @Test + void sortBuild() { + Sort sort = Sort.by("id").descending().and(Sort.by("name").ascending()); + PageRequest request = new PageRequest(0, 10, sort); + request.addFilter("name", "tom"); + DynamicSQLBuilder builder = new DynamicSQLBuilder(request, Demo.class); + assertEquals("FROM Demo WHERE name = ?1 ORDER BY id DESC,name ASC", builder.getHQL()); + // count HQL 不包含排序 + assertEquals("SELECT COUNT(1) FROM Demo WHERE name = ?1", builder.getCountHQL()); + } + + /** + * 仅排序无过滤 + */ + @Test + void sortOnly() { + PageRequest request = new PageRequest(); + request.addSort(Sort.by("id").ascending()); + DynamicSQLBuilder builder = new DynamicSQLBuilder(request, Demo.class); + assertEquals("FROM Demo WHERE ORDER BY id ASC", builder.getHQL()); + } +} diff --git a/springboot-starter-data-fast/src/test/java/com/codingapi/springboot/fast/jpa/repository/ExampleBuilderTest.java b/springboot-starter-data-fast/src/test/java/com/codingapi/springboot/fast/jpa/repository/ExampleBuilderTest.java new file mode 100644 index 000000000..1255a026e --- /dev/null +++ b/springboot-starter-data-fast/src/test/java/com/codingapi/springboot/fast/jpa/repository/ExampleBuilderTest.java @@ -0,0 +1,96 @@ +package com.codingapi.springboot.fast.jpa.repository; + +import com.codingapi.springboot.fast.entity.Demo; +import com.codingapi.springboot.framework.dto.request.PageRequest; +import com.codingapi.springboot.framework.dto.request.Relation; +import org.junit.jupiter.api.Test; +import org.springframework.data.domain.Example; + +import static org.junit.jupiter.api.Assertions.assertEquals; +import static org.junit.jupiter.api.Assertions.assertNotNull; +import static org.junit.jupiter.api.Assertions.assertNull; +import static org.junit.jupiter.api.Assertions.assertThrows; + +/** + * ExampleBuilder 单元测试（包级私有类，测试置于同一包下） + */ +class ExampleBuilderTest { + + /** + * 无过滤条件时返回 null + */ + @Test + void noFilterReturnsNull() { + PageRequest request = new PageRequest(); + ExampleBuilder builder = new ExampleBuilder(request, Demo.class); + assertNull(builder.getExample()); + } + + /** + * 过滤条件命中实体属性时构建 Example， + * 同时覆盖字符串值向 Integer 类型属性的转换分支 + */ + @Test + void buildExampleWithFilters() { + PageRequest request = new PageRequest(); + request.addFilter("name", "tom"); + request.addFilter("sort", "18"); + ExampleBuilder builder = new ExampleBuilder(request, Demo.class); + Example example = builder.getExample(); + assertNotNull(example); + Demo probe = example.getProbe(); + assertEquals("tom", probe.getName()); + assertEquals(Integer.valueOf(18), probe.getSort()); + } + + /** + * 过滤条件未命中任何属性时，Example 的 probe 为空白对象 + */ + @Test + void filterNotMatchAnyProperty() { + PageRequest request = new PageRequest(); + request.addFilter("notExistField", "value"); + ExampleBuilder builder = new ExampleBuilder(request, Demo.class); + Example example = builder.getExample(); + assertNotNull(example); + assertNull(example.getProbe().getName()); + } + + /** + * 命中只读属性（如 class）时写入失败被内部吞掉，不影响整体构建 + */ + @Test + void readOnlyPropertyFailureIsIgnored() { + PageRequest request = new PageRequest(); + request.addFilter("class", "ignored"); + request.addFilter("name", "tom"); + ExampleBuilder builder = new ExampleBuilder(request, Demo.class); + Example example = builder.getExample(); + assertNotNull(example); + assertEquals("tom", example.getProbe().getName()); + } + + /** + * 实体类无默认构造器时抛出 RuntimeException + */ + @Test + void entityWithoutDefaultConstructor() { + PageRequest request = new PageRequest(); + request.addFilter("value", "1"); + ExampleBuilder builder = new ExampleBuilder(request, Integer.class); + assertThrows(RuntimeException.class, builder::getExample); + } + + /** + * 非 EQUAL 关系同样参与 Example 组装（仅取值填充 probe） + */ + @Test + void relationFilterAlsoFillsProbe() { + PageRequest request = new PageRequest(); + request.addFilter("name", Relation.LIKE, "to"); + ExampleBuilder builder = new ExampleBuilder(request, Demo.class); + Example example = builder.getExample(); + assertNotNull(example); + assertEquals("to", example.getProbe().getName()); + } +} diff --git a/springboot-starter-data-fast/src/test/java/com/codingapi/springboot/fast/query/FastDemoQuery.java b/springboot-starter-data-fast/src/test/java/com/codingapi/springboot/fast/query/FastDemoQuery.java deleted file mode 100644 index 50dd5939f..000000000 --- a/springboot-starter-data-fast/src/test/java/com/codingapi/springboot/fast/query/FastDemoQuery.java +++ /dev/null @@ -1,23 +0,0 @@ -package com.codingapi.springboot.fast.query; - -import com.codingapi.springboot.fast.annotation.FastController; -import com.codingapi.springboot.fast.annotation.FastMapping; -import com.codingapi.springboot.fast.entity.Demo; -import com.codingapi.springboot.framework.dto.request.PageRequest; -import com.codingapi.springboot.framework.dto.response.MultiResponse; -import com.codingapi.springboot.framework.dto.response.SingleResponse; -import org.springframework.web.bind.annotation.RequestParam; - -@FastController -public interface FastDemoQuery { - - @FastMapping(value = "select d from Demo d", mapping = "/demo/findAll") - MultiResponse findAll(); - - @FastMapping(value = "select d from Demo d where d.id = ?1", mapping = "/demo/getById") - SingleResponse getById(@RequestParam("id") int id); - - @FastMapping(value = "select d from Demo d", countQuery = "select count(d) from Demo d", mapping = "/demo/findPage") - MultiResponse findPage(PageRequest pageRequest); - -} diff --git a/springboot-starter-data-fast/src/test/java/com/codingapi/springboot/fast/repository/DemoRepository.java b/springboot-starter-data-fast/src/test/java/com/codingapi/springboot/fast/repository/DemoRepository.java index 43b362806..30a688b19 100644 --- a/springboot-starter-data-fast/src/test/java/com/codingapi/springboot/fast/repository/DemoRepository.java +++ b/springboot-starter-data-fast/src/test/java/com/codingapi/springboot/fast/repository/DemoRepository.java @@ -1,8 +1,8 @@ package com.codingapi.springboot.fast.repository; import com.codingapi.springboot.fast.entity.Demo; -import com.codingapi.springboot.fast.query.FastRepository; +import com.codingapi.springboot.fast.jpa.repository.FastRepository; -public interface DemoRepository extends FastRepository { +public interface DemoRepository extends FastRepository { } diff --git a/springboot-starter-data-fast/src/test/java/com/codingapi/springboot/fast/repository/MenuRepository.java b/springboot-starter-data-fast/src/test/java/com/codingapi/springboot/fast/repository/MenuRepository.java new file mode 100644 index 000000000..ed271005a --- /dev/null +++ b/springboot-starter-data-fast/src/test/java/com/codingapi/springboot/fast/repository/MenuRepository.java @@ -0,0 +1,9 @@ +package com.codingapi.springboot.fast.repository; + +import com.codingapi.springboot.fast.entity.Menu; +import com.codingapi.springboot.fast.jpa.repository.FastRepository; + +public interface MenuRepository extends FastRepository { + + +} diff --git a/springboot-starter-data-fast/src/test/java/com/codingapi/springboot/fast/repository/ProfileRepository.java b/springboot-starter-data-fast/src/test/java/com/codingapi/springboot/fast/repository/ProfileRepository.java new file mode 100644 index 000000000..51a377e82 --- /dev/null +++ b/springboot-starter-data-fast/src/test/java/com/codingapi/springboot/fast/repository/ProfileRepository.java @@ -0,0 +1,9 @@ +package com.codingapi.springboot.fast.repository; + +import com.codingapi.springboot.fast.entity.Profile; +import com.codingapi.springboot.fast.jpa.repository.FastRepository; + +public interface ProfileRepository extends FastRepository { + + +} diff --git a/springboot-starter-data-fast/src/test/java/com/codingapi/springboot/fast/repository/UserRepository.java b/springboot-starter-data-fast/src/test/java/com/codingapi/springboot/fast/repository/UserRepository.java new file mode 100644 index 000000000..e92382b0b --- /dev/null +++ b/springboot-starter-data-fast/src/test/java/com/codingapi/springboot/fast/repository/UserRepository.java @@ -0,0 +1,9 @@ +package com.codingapi.springboot.fast.repository; + +import com.codingapi.springboot.fast.entity.User; +import com.codingapi.springboot.fast.jpa.repository.FastRepository; + +public interface UserRepository extends FastRepository { + + +} diff --git a/springboot-starter-data-fast/src/test/java/com/codingapi/springboot/fast/script/ScriptRuntimeTest.java b/springboot-starter-data-fast/src/test/java/com/codingapi/springboot/fast/script/ScriptRuntimeTest.java new file mode 100644 index 000000000..4f5892b34 --- /dev/null +++ b/springboot-starter-data-fast/src/test/java/com/codingapi/springboot/fast/script/ScriptRuntimeTest.java @@ -0,0 +1,16 @@ +package com.codingapi.springboot.fast.script; + +import org.junit.jupiter.api.Test; +import org.springframework.boot.test.context.SpringBootTest; + +import static org.junit.jupiter.api.Assertions.assertEquals; + +@SpringBootTest +class ScriptRuntimeTest { + + @Test + void running() { + Object res = ScriptRuntime.getInstance().running("return 1"); + assertEquals(1, res); + } +} \ No newline at end of file diff --git a/springboot-starter-data-fast/src/test/resources/application.properties b/springboot-starter-data-fast/src/test/resources/application.properties index c3ec648b6..559cfc80c 100644 --- a/springboot-starter-data-fast/src/test/resources/application.properties +++ b/springboot-starter-data-fast/src/test/resources/application.properties @@ -1,5 +1,6 @@ server.port=8088 spring.datasource.driver-class-name=org.h2.Driver spring.datasource.url=jdbc:h2:file:./test.db +spring.jpa.database-platform=org.hibernate.dialect.H2Dialect spring.jpa.hibernate.ddl-auto=create-drop spring.jpa.show-sql=true \ No newline at end of file diff --git a/springboot-starter-id-generator/pom.xml b/springboot-starter-id-generator/pom.xml deleted file mode 100644 index c4adbf859..000000000 --- a/springboot-starter-id-generator/pom.xml +++ /dev/null @@ -1,37 +0,0 @@ - - - - springboot-parent - com.codingapi.springboot - 2.1.11 - - 4.0.0 - - springboot-starter-id-generator - - - 17 - - - - - - org.xerial - sqlite-jdbc - - - - commons-dbutils - commons-dbutils - - - - org.springframework - spring-jdbc - - - - - \ No newline at end of file diff --git a/springboot-starter-id-generator/src/main/java/com/codingapi/springboot/generator/AutoConfiguration.java b/springboot-starter-id-generator/src/main/java/com/codingapi/springboot/generator/AutoConfiguration.java deleted file mode 100644 index e9a8b3946..000000000 --- a/springboot-starter-id-generator/src/main/java/com/codingapi/springboot/generator/AutoConfiguration.java +++ /dev/null @@ -1,27 +0,0 @@ -package com.codingapi.springboot.generator; - -import com.codingapi.springboot.generator.dao.IdKeyDao; -import com.codingapi.springboot.generator.properties.GeneratorJdbcProperties; -import org.springframework.boot.autoconfigure.condition.ConditionalOnMissingBean; -import org.springframework.boot.context.properties.ConfigurationProperties; -import org.springframework.context.annotation.Bean; -import org.springframework.context.annotation.Configuration; - -@Configuration -public class AutoConfiguration { - - @Bean - @ConfigurationProperties(prefix = "codingapi.id.jdbc.generator") - public GeneratorJdbcProperties generatorJdbcProperties() { - return new GeneratorJdbcProperties(); - } - - @Bean(initMethod = "init") - @ConditionalOnMissingBean - public IdKeyDao idKeyDao(GeneratorJdbcProperties generatorJdbcProperties) { - IdKeyDao keyDao = new IdKeyDao(generatorJdbcProperties.openDataSource()); - IdGeneratorContext.getInstance().init(keyDao); - return keyDao; - } - -} diff --git a/springboot-starter-id-generator/src/main/java/com/codingapi/springboot/generator/IdGenerate.java b/springboot-starter-id-generator/src/main/java/com/codingapi/springboot/generator/IdGenerate.java deleted file mode 100644 index 972459a8e..000000000 --- a/springboot-starter-id-generator/src/main/java/com/codingapi/springboot/generator/IdGenerate.java +++ /dev/null @@ -1,17 +0,0 @@ -package com.codingapi.springboot.generator; - -public interface IdGenerate { - - default long generateLongId() { - return IdGeneratorContext.getInstance().generateId(getClass()); - } - - default int generateIntId() { - return (int) IdGeneratorContext.getInstance().generateId(getClass()); - } - - default String generateStringId() { - return String.valueOf(IdGeneratorContext.getInstance().generateId(getClass())); - } - -} diff --git a/springboot-starter-id-generator/src/main/java/com/codingapi/springboot/generator/IdGeneratorContext.java b/springboot-starter-id-generator/src/main/java/com/codingapi/springboot/generator/IdGeneratorContext.java deleted file mode 100644 index c405ef305..000000000 --- a/springboot-starter-id-generator/src/main/java/com/codingapi/springboot/generator/IdGeneratorContext.java +++ /dev/null @@ -1,33 +0,0 @@ -package com.codingapi.springboot.generator; - -import com.codingapi.springboot.generator.dao.IdKeyDao; -import com.codingapi.springboot.generator.service.IdGenerateService; - -public class IdGeneratorContext { - - private static IdGeneratorContext instance; - private IdGenerateService idGenerateService; - - private IdGeneratorContext() { - } - - public static IdGeneratorContext getInstance() { - if (instance == null) { - synchronized (IdGeneratorContext.class) { - if (instance == null) { - instance = new IdGeneratorContext(); - } - } - } - return instance; - } - - long generateId(Class clazz) { - return idGenerateService.generateId(clazz); - } - - void init(IdKeyDao idKeyDao) { - idGenerateService = new IdGenerateService(idKeyDao); - } - -} diff --git a/springboot-starter-id-generator/src/main/java/com/codingapi/springboot/generator/dao/DbHelper.java b/springboot-starter-id-generator/src/main/java/com/codingapi/springboot/generator/dao/DbHelper.java deleted file mode 100644 index 92b8191a1..000000000 --- a/springboot-starter-id-generator/src/main/java/com/codingapi/springboot/generator/dao/DbHelper.java +++ /dev/null @@ -1,76 +0,0 @@ -package com.codingapi.springboot.generator.dao; - -import org.apache.commons.dbutils.QueryRunner; - -import javax.sql.DataSource; -import java.sql.Connection; -import java.sql.SQLException; - -public class DbHelper { - - private final DataSource dataSource; - private final QueryRunner queryRunner; - - - public DbHelper(DataSource dataSource) { - this.dataSource = dataSource; - this.queryRunner = new QueryRunner(); - } - - public void execute(IExecute execute) throws SQLException { - Connection connection = dataSource.getConnection(); - execute.execute(connection, queryRunner); - connection.close(); - } - - public T updateAndQuery(IUpdateAndQuery execute) throws SQLException { - Connection connection = dataSource.getConnection(); - connection.setAutoCommit(false); - T res = execute.updateAndQuery(connection, queryRunner); - connection.commit(); - connection.close(); - return res; - } - - public int update(IUpdate execute) throws SQLException { - Connection connection = dataSource.getConnection(); - connection.setAutoCommit(false); - int res = execute.update(connection, queryRunner); - connection.commit(); - connection.close(); - return res; - } - - public T query(IQuery execute) throws SQLException { - Connection connection = dataSource.getConnection(); - T res = execute.query(connection, queryRunner); - connection.close(); - return res; - } - - - interface IExecute { - default void execute(Connection connection, QueryRunner queryRunner) throws SQLException { - } - } - - - interface IUpdateAndQuery { - default T updateAndQuery(Connection connection, QueryRunner queryRunner) throws SQLException { - return null; - } - } - - interface IUpdate { - default int update(Connection connection, QueryRunner queryRunner) throws SQLException { - return 0; - } - } - - interface IQuery { - default T query(Connection connection, QueryRunner queryRunner) throws SQLException { - return null; - } - } - -} diff --git a/springboot-starter-id-generator/src/main/java/com/codingapi/springboot/generator/dao/IdKeyDao.java b/springboot-starter-id-generator/src/main/java/com/codingapi/springboot/generator/dao/IdKeyDao.java deleted file mode 100644 index 59332bc00..000000000 --- a/springboot-starter-id-generator/src/main/java/com/codingapi/springboot/generator/dao/IdKeyDao.java +++ /dev/null @@ -1,94 +0,0 @@ -package com.codingapi.springboot.generator.dao; - -import com.codingapi.springboot.generator.domain.IdKey; -import lombok.SneakyThrows; -import org.apache.commons.dbutils.QueryRunner; -import org.apache.commons.dbutils.ResultSetHandler; - -import javax.sql.DataSource; -import java.sql.Connection; -import java.sql.SQLException; -import java.util.ArrayList; -import java.util.List; - -public class IdKeyDao { - - private final DbHelper> dbHelper; - - private final ResultSetHandler> handler; - - public IdKeyDao(DataSource dataSource) { - this.dbHelper = new DbHelper<>(dataSource); - this.handler = rs -> { - List list = new ArrayList<>(); - while (rs.next()) { - IdKey generator = new IdKey(); - generator.setKey(rs.getString("TAG")); - generator.setId(rs.getInt("ID")); - generator.setUpdateTime(rs.getLong("UPDATE_TIME")); - list.add(generator); - } - return list; - }; - } - - @SneakyThrows - public void save(IdKey generator) { - dbHelper.update(new DbHelper.IUpdate() { - @Override - public int update(Connection connection, QueryRunner queryRunner) throws SQLException { - List list = queryRunner.query(connection, "SELECT * FROM ID_GENERATOR WHERE TAG = ?", handler, generator.getKey()); - if (list != null && list.size() > 0) { - return 0; - } - - String sql = "INSERT INTO ID_GENERATOR (ID, UPDATE_TIME, TAG) VALUES (?, ?, ?)"; - return queryRunner.update(connection, sql, generator.getId(), generator.getUpdateTime(), generator.getKey()); - } - }); - } - - - @SneakyThrows - public IdKey getByKey(String key) { - return dbHelper.query(new DbHelper.IQuery>() { - @Override - public List query(Connection connection, QueryRunner queryRunner) throws SQLException { - return queryRunner.query(connection, "SELECT * FROM ID_GENERATOR WHERE TAG = ?", handler, key); - } - }).stream().findFirst().orElse(null); - } - - - @SneakyThrows - public IdKey updateMaxId(IdKey generator) { - return dbHelper.updateAndQuery(new DbHelper.IUpdateAndQuery<>() { - @Override - public List updateAndQuery(Connection connection, QueryRunner queryRunner) throws SQLException { - queryRunner.update(connection, "UPDATE ID_GENERATOR SET ID = ID + 1 WHERE TAG = ?", generator.getKey()); - return queryRunner.query(connection, "SELECT * FROM ID_GENERATOR WHERE TAG = ?", handler, generator.getKey()); - } - }).stream().findFirst().orElse(null); - } - - - @SneakyThrows - public List findAll() throws SQLException { - return dbHelper.query(new DbHelper.IQuery<>() { - @Override - public List query(Connection connection, QueryRunner queryRunner) throws SQLException { - return queryRunner.query(connection, "SELECT * FROM ID_GENERATOR", handler); - } - }); - } - - private void init() throws SQLException { - dbHelper.execute(new DbHelper.IExecute() { - @Override - public void execute(Connection connection, QueryRunner queryRunner) throws SQLException { - String sql = "CREATE TABLE IF NOT EXISTS ID_GENERATOR (TAG TEXT NOT NULL, ID INTEGER NOT NULL, UPDATE_TIME INTEGER NOT NULL, PRIMARY KEY (TAG))"; - queryRunner.update(connection, sql); - } - }); - } -} diff --git a/springboot-starter-id-generator/src/main/java/com/codingapi/springboot/generator/domain/IdKey.java b/springboot-starter-id-generator/src/main/java/com/codingapi/springboot/generator/domain/IdKey.java deleted file mode 100644 index 0363383e3..000000000 --- a/springboot-starter-id-generator/src/main/java/com/codingapi/springboot/generator/domain/IdKey.java +++ /dev/null @@ -1,33 +0,0 @@ -package com.codingapi.springboot.generator.domain; - -import lombok.Getter; -import lombok.NoArgsConstructor; -import lombok.Setter; - -@Setter -@Getter -@NoArgsConstructor -public class IdKey { - - private String key; - private long id; - private long updateTime; - - public IdKey(String key, long id) { - this.key = key; - this.id = id; - this.updateTime = System.currentTimeMillis(); - } - - public IdKey(String key) { - this.key = key; - this.id = 1; - this.updateTime = System.currentTimeMillis(); - } - - public IdKey(String key, long id, long updateTime) { - this.key = key; - this.id = id; - this.updateTime = updateTime; - } -} diff --git a/springboot-starter-id-generator/src/main/java/com/codingapi/springboot/generator/properties/GeneratorJdbcProperties.java b/springboot-starter-id-generator/src/main/java/com/codingapi/springboot/generator/properties/GeneratorJdbcProperties.java deleted file mode 100644 index 6d89224a0..000000000 --- a/springboot-starter-id-generator/src/main/java/com/codingapi/springboot/generator/properties/GeneratorJdbcProperties.java +++ /dev/null @@ -1,29 +0,0 @@ -package com.codingapi.springboot.generator.properties; - -import lombok.Getter; -import lombok.Setter; -import org.springframework.jdbc.datasource.DriverManagerDataSource; - -import javax.sql.DataSource; - -@Setter -@Getter -public class GeneratorJdbcProperties { - - private String jdbcUrl = "jdbc:sqlite:db.db"; - - private String jdbcDriver = "org.sqlite.JDBC"; - - private String jdbcUsername = "sa"; - - private String jdbcPassword = "sa"; - - public DataSource openDataSource() { - final DriverManagerDataSource dataSource = new DriverManagerDataSource(); - dataSource.setDriverClassName(jdbcDriver); - dataSource.setUrl(jdbcUrl); - dataSource.setUsername(jdbcUsername); - dataSource.setPassword(jdbcPassword); - return dataSource; - } -} diff --git a/springboot-starter-id-generator/src/main/java/com/codingapi/springboot/generator/service/IdGenerateService.java b/springboot-starter-id-generator/src/main/java/com/codingapi/springboot/generator/service/IdGenerateService.java deleted file mode 100644 index 9d7dc478f..000000000 --- a/springboot-starter-id-generator/src/main/java/com/codingapi/springboot/generator/service/IdGenerateService.java +++ /dev/null @@ -1,24 +0,0 @@ -package com.codingapi.springboot.generator.service; - -import com.codingapi.springboot.generator.dao.IdKeyDao; -import com.codingapi.springboot.generator.domain.IdKey; - -public class IdGenerateService { - - private final IdKeyDao keyDao; - - public IdGenerateService(IdKeyDao keyDao) { - this.keyDao = keyDao; - } - - public synchronized long generateId(Class clazz) { - IdKey idKey = keyDao.getByKey(clazz.getName()); - if (idKey == null) { - idKey = new IdKey(clazz.getName()); - keyDao.save(idKey); - } else { - keyDao.updateMaxId(idKey); - } - return idKey.getId(); - } -} diff --git a/springboot-starter-id-generator/src/main/resources/META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports b/springboot-starter-id-generator/src/main/resources/META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports deleted file mode 100644 index c1aa4e079..000000000 --- a/springboot-starter-id-generator/src/main/resources/META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports +++ /dev/null @@ -1 +0,0 @@ -com.codingapi.springboot.generator.AutoConfiguration \ No newline at end of file diff --git a/springboot-starter-id-generator/src/test/java/com/codingapi/springboot/generator/IdGenerateServiceTest.java b/springboot-starter-id-generator/src/test/java/com/codingapi/springboot/generator/IdGenerateServiceTest.java deleted file mode 100644 index a2176a7c7..000000000 --- a/springboot-starter-id-generator/src/test/java/com/codingapi/springboot/generator/IdGenerateServiceTest.java +++ /dev/null @@ -1,21 +0,0 @@ -package com.codingapi.springboot.generator; - -import lombok.extern.slf4j.Slf4j; -import org.junit.jupiter.api.Test; -import org.springframework.boot.test.context.SpringBootTest; - -import static org.junit.jupiter.api.Assertions.assertTrue; - -@Slf4j -@SpringBootTest -class IdGenerateServiceTest { - - @Test - void generateId() { - for (int i = 0; i < 1000; i++) { - long id = IdGeneratorContext.getInstance().generateId(IdGenerateServiceTest.class); - log.info("id=>{}", id); - assertTrue(id > 0, "id generator error."); - } - } -} \ No newline at end of file diff --git a/springboot-starter-id-generator/src/test/resources/application.properties b/springboot-starter-id-generator/src/test/resources/application.properties deleted file mode 100644 index 8a3b6d8a7..000000000 --- a/springboot-starter-id-generator/src/test/resources/application.properties +++ /dev/null @@ -1 +0,0 @@ -codingapi.id.generator.jdbc-url=jdbc:h2:file:./test.db \ No newline at end of file diff --git a/springboot-starter-script/pom.xml b/springboot-starter-script/pom.xml new file mode 100644 index 000000000..767012b1a --- /dev/null +++ b/springboot-starter-script/pom.xml @@ -0,0 +1,62 @@ + + + 4.0.0 + + com.codingapi.springboot + springboot-parent + ${revision} + + + springboot-starter-script + springboot-starter-script project for Spring Boot + springboot-starter-script + + + 8 + + + + + + com.codingapi.springboot + springboot-starter + + + + org.springframework.boot + spring-boot-starter-web + + + + org.apache.groovy + groovy + + + + org.apache.groovy + groovy-json + + + + org.apache.groovy + groovy-xml + + + + + org.springframework.boot + spring-boot-starter-data-jpa + test + + + + com.h2database + h2 + test + + + + + \ No newline at end of file diff --git a/springboot-starter-script/src/main/java/com/codingapi/springboot/script/AutoConfiguration.java b/springboot-starter-script/src/main/java/com/codingapi/springboot/script/AutoConfiguration.java new file mode 100644 index 000000000..3b29d0bd2 --- /dev/null +++ b/springboot-starter-script/src/main/java/com/codingapi/springboot/script/AutoConfiguration.java @@ -0,0 +1,28 @@ +package com.codingapi.springboot.script; + +import com.codingapi.springboot.script.properties.GroovyScriptProperties; +import com.codingapi.springboot.script.properties.PropertiesContext; +import com.codingapi.springboot.script.runner.GroovyScriptEngineRunner; +import org.springframework.boot.context.properties.ConfigurationProperties; +import org.springframework.context.annotation.Bean; +import org.springframework.context.annotation.ComponentScan; +import org.springframework.context.annotation.Configuration; + +@Configuration +@ComponentScan(basePackages = "com.codingapi.springboot.script") +public class AutoConfiguration { + + @Bean + public GroovyScriptEngineRunner tempClearRunner() { + return new GroovyScriptEngineRunner(); + } + + @Bean + @ConfigurationProperties(prefix = "codingapi.script") + public GroovyScriptProperties groovyScriptProperties(){ + GroovyScriptProperties properties = new GroovyScriptProperties(); + PropertiesContext.getInstance().setProperties(properties); + return properties; + } + +} diff --git a/springboot-starter-script/src/main/java/com/codingapi/springboot/script/GroovyScript.java b/springboot-starter-script/src/main/java/com/codingapi/springboot/script/GroovyScript.java new file mode 100644 index 000000000..5aa19e971 --- /dev/null +++ b/springboot-starter-script/src/main/java/com/codingapi/springboot/script/GroovyScript.java @@ -0,0 +1,318 @@ +package com.codingapi.springboot.script; + +import com.codingapi.springboot.script.temp.TempGroovyScriptContext; +import com.codingapi.springboot.script.meta.GroovyMetadata; +import com.codingapi.springboot.script.repository.GroovyScriptRepositoryContext; +import com.codingapi.springboot.script.scanner.GroovyMetadataScannerUtils; +import lombok.AllArgsConstructor; +import lombok.Getter; +import lombok.Setter; + +import java.util.Map; + +/** + * 脚本对象 + */ +@Getter +@Setter +@AllArgsConstructor +public class GroovyScript { + + /** + * 脚本唯一编码 + */ + private final String key; + /** + * 脚本内容 + */ + private String script; + /** + * 脚本描述信息 + */ + private String description; + /** + * 脚本函数名称 + */ + private String method; + /** + * 返回数据类型 + */ + private Class returnType; + /** + * 绑定数据类型 + */ + private Map> binds; + /** + * 请求参数对象 + */ + private Map> requests; + + /** + * 一级类型 + */ + private String typeOne; + + /** + * 二级类型 + */ + private String typeTwo; + + /** + * 标记参数 + */ + private String tag; + + /** + * 备注信息 + */ + private String remark; + + /** + * 创建时间 + */ + private long createTime; + + /** + * 更新时间 + */ + private long updateTime; + + + public GroovyScript(String key) { + this.key = key; + this.createTime = System.currentTimeMillis(); + } + + public static Builder builder(String key) { + return new Builder(key); + } + + public static class Builder { + private final GroovyScript script; + + public Builder(String key) { + this.script = new GroovyScript(key); + } + + public Builder script(String script) { + this.script.script = script; + return this; + } + + public Builder description(String description) { + this.script.description = description; + return this; + } + + public Builder tag(String tag) { + this.script.tag = tag; + return this; + } + + public Builder method(String method) { + this.script.method = method; + return this; + } + + public Builder typeOne(String typeOne) { + this.script.typeOne = typeOne; + return this; + } + + public Builder typeTwo(String typeTwo) { + this.script.typeTwo = typeTwo; + return this; + } + + public Builder remark(String remark) { + this.script.remark = remark; + return this; + } + + public Builder returnType(Class returnType) { + this.script.returnType = returnType; + return this; + } + + public Builder binds(Map> binds) { + this.script.binds = binds; + return this; + } + + public Builder requests(Map> requests) { + this.script.requests = requests; + return this; + } + + public GroovyScript build() { + return this.script; + } + + } + + /** + * 临时存储 + * 数据将会定时清理 + */ + public void temp() { + TempGroovyScriptContext.getInstance().save(this); + } + + + /** + * 保存对象 + */ + public void save() { + this.updateTime = System.currentTimeMillis(); + GroovyScriptRepositoryContext.getInstance().save(this); + // 清理临时数据 + TempGroovyScriptContext.getInstance().remove(this.getKey()); + } + + /** + * 删除对象 + */ + public void remove() { + GroovyScriptRepositoryContext.getInstance().delete(this.getKey()); + // 清理临时数据 + TempGroovyScriptContext.getInstance().remove(this.getKey()); + } + + /** + * 复制对象 + * + * @param key 新的key + * @return 脚本对象 + */ + public GroovyScript copy(String key) { + return new GroovyScript(key, script, description, method, returnType, binds, requests, typeOne, typeTwo, tag, remark, createTime, updateTime); + } + + + /** + * 编译脚本 并缓存 + * + * @param cache 是否缓存 + */ + public void compile(boolean cache) { + GroovyScriptRuntimeContext.getInstance().compile(this.script, cache); + } + + /** + * 编译脚本 非缓存 + */ + public void compile() { + GroovyScriptRuntimeContext.getInstance().compile(this.script); + } + + /** + * 转化为直接运行时对象 + * + * @param binds 绑定对象 + * @return 运行时对象 + */ + public T run(TransactionMode transactionMode, Map binds) { + return (T) GroovyScriptRuntimeContext.getInstance().run(this.script, returnType, transactionMode, binds); + } + + /** + * 转化为直接运行时对象 + * + * @param binds 绑定对象 + * @return 运行时对象 + */ + public T run(Map binds) { + return this.run(TransactionMode.DEFAULT, binds); + } + + /** + * 转化为直接运行时对象 + * + * @return 运行时对象 + */ + public T run(TransactionMode transactionMode) { + return this.run(transactionMode, null); + } + + /** + * 转化为直接运行时对象 + * + * @return 运行时对象 + */ + public T run() { + return this.run(TransactionMode.DEFAULT, null); + } + + /** + * 转化为函数运行时对象 + * + * @param transactionMode 事务模式 + * @param binds 绑定对象 + * @param requests 运行参数 + * @return 运行时对象 + */ + public T invoke(TransactionMode transactionMode, Map binds, Object... requests) { + return (T) GroovyScriptRuntimeContext.getInstance().invoke(this.method, this.script, this.returnType, transactionMode, binds, requests); + } + + + /** + * 转化为函数运行时对象 + * + * @param binds 绑定对象 + * @param requests 运行参数 + * @return 运行时对象 + */ + public T invoke(Map binds, Object... requests) { + return this.invoke(TransactionMode.DEFAULT, binds, requests); + } + + + /** + * 转化为函数运行时对象 + * + * @param requests 运行参数 + * @return 运行时对象 + */ + public T invoke(TransactionMode transactionMode, Object... requests) { + return this.invoke(transactionMode, null, requests); + } + + /** + * 转化为函数运行时对象 + * + * @param requests 运行参数 + * @return 运行时对象 + */ + public T invoke(Object... requests) { + return this.invoke(TransactionMode.DEFAULT, null, requests); + } + + /** + * 转化为函数运行时对象 + * + * @return 运行时对象 + */ + public T invoke() { + return this.invoke(TransactionMode.DEFAULT, null, null); + } + + /** + * 转化为函数运行时对象 + * + * @return 运行时对象 + */ + public T invoke(TransactionMode transactionMode) { + return this.invoke(transactionMode, null, null); + } + + + /** + * 构建脚本元数据信息 + */ + public GroovyMetadata toMetadata() { + return GroovyMetadataScannerUtils.scanner(this); + } + + +} diff --git a/springboot-starter-script/src/main/java/com/codingapi/springboot/script/GroovyScriptRuntime.java b/springboot-starter-script/src/main/java/com/codingapi/springboot/script/GroovyScriptRuntime.java new file mode 100644 index 000000000..6508f07c2 --- /dev/null +++ b/springboot-starter-script/src/main/java/com/codingapi/springboot/script/GroovyScriptRuntime.java @@ -0,0 +1,224 @@ +package com.codingapi.springboot.script; + +import com.codingapi.springboot.framework.crypto.SHA256; +import com.codingapi.springboot.framework.transaction.TransactionManagerContext; +import groovy.lang.GroovyClassLoader; +import groovy.lang.GroovyShell; +import groovy.lang.Script; +import lombok.Getter; + +import java.util.LinkedHashMap; +import java.util.Map; + +/** + * groovy script 执行上下文对象 + */ +public class GroovyScriptRuntime { + + private final GroovyShell shell; + + private final Map cache; + + @Getter + private final int maxCacheSize; + + + public GroovyScriptRuntime(int maxCacheSize) { + this.maxCacheSize = maxCacheSize; + GroovyClassLoader groovyClassLoader = new GroovyClassLoader(getClass().getClassLoader()); + this.shell = new GroovyShell(groovyClassLoader); + this.cache = new LinkedHashMap(16, 0.75F, true) { + @Override + protected boolean removeEldestEntry(Map.Entry eldest) { + return size() > maxCacheSize; + } + }; + } + + /** + * 清空缓存对象 + */ + public void clearCache() { + this.cache.clear(); + } + + /** + * 缓存大小 + */ + public int cacheSize() { + return this.cache.size(); + } + + + /** + * 编译脚本 + * + * @param script 脚本内容 + * @param cache 是否缓存 + */ + public void compile(String script, boolean cache) { + if (cache) { + String key = SHA256.sha256(script); + Script runtime = this.cache.get(key); + if (runtime == null) { + runtime = this.shell.parse(script); + this.cache.put(key, runtime); + } + } else { + this.shell.parse(script); + } + } + + + /** + * 编译脚本，非缓存模式 + * + * @param script 脚本内容 + */ + public void compile(String script) { + this.compile(script, false); + } + + /** + * 执行函数脚本 + * + * @param method 函数名称 + * @param script 脚本内容 + * @param returnType 返回类型 + * @param binds 绑定数据对象 + * @param args 函数参数 + * @return 返回数据 + */ + public T invoke(String method, + String script, + Class returnType, + Map binds, + Object... args) { + return this.invoke(method, script, returnType, TransactionMode.DEFAULT, binds, args); + } + + /** + * 执行函数脚本 + * + * @param method 函数名称 + * @param script 脚本内容 + * @param returnType 返回类型 + * @param args 函数参数 + * @return 返回数据 + */ + public T invoke(String method, + String script, + Class returnType, + Object... args) { + return this.invoke(method, script, returnType, TransactionMode.DEFAULT, null, args); + } + + /** + * 执行函数脚本 + * + * @param method 函数名称 + * @param script 脚本内容 + * @param returnType 返回类型 + * @param transactionMode 事务模式 + * @param binds 绑定数据对象 + * @param args 函数参数 + * @return 返回数据 + */ + public T invoke(String method, + String script, + Class returnType, + TransactionMode transactionMode, + Map binds, + Object... args) { + String key = SHA256.sha256(script); + Script runtime = this.cache.get(key); + if (runtime == null) { + runtime = this.shell.parse(script); + this.cache.put(key, runtime); + } + + + if (binds != null && !binds.isEmpty()) { + for (String bindKey : binds.keySet()) { + runtime.setProperty(bindKey, binds.get(bindKey)); + } + } + + // 事务制只读模式 + if (transactionMode == TransactionMode.READONLY) { + Script finalRuntime = runtime; + return TransactionManagerContext.getInstance().readOnly(() -> { + return (T) finalRuntime.invokeMethod(method, args); + }); + } + + // 事务制提交模式 + if (transactionMode == TransactionMode.COMMIT) { + Script finalRuntime = runtime; + return TransactionManagerContext.getInstance().commit(() -> { + return (T) finalRuntime.invokeMethod(method, args); + }); + } + + // 默认处理模式 + return (T) runtime.invokeMethod(method, args); + } + + /** + * 执行脚本 + * + * @param script 脚本 + * @param returnType 返回数据类型 + * @param binds 绑定对象 + * @return 返回数据 + */ + public T run(String script, Class returnType, Map binds) { + return this.run(script, returnType, TransactionMode.DEFAULT, binds); + } + + /** + * 执行脚本 + * + * @param script 脚本 + * @param returnType 返回数据类型 + * @param transactionMode 事务模式 + * @param binds 绑定对象 + * @return 返回数据 + */ + public T run(String script, Class returnType, TransactionMode transactionMode, Map binds) { + String key = SHA256.sha256(script); + Script runtime = this.cache.get(key); + if (runtime == null) { + runtime = this.shell.parse(script); + this.cache.put(key, runtime); + } + + if (binds != null && !binds.isEmpty()) { + for (String bindKey : binds.keySet()) { + runtime.setProperty(bindKey, binds.get(bindKey)); + } + } + + + // 事务制只读模式 + if (transactionMode == TransactionMode.READONLY) { + Script finalRuntime = runtime; + return TransactionManagerContext.getInstance().readOnly(() -> { + return (T) finalRuntime.run(); + }); + } + + // 事务制提交模式 + if (transactionMode == TransactionMode.COMMIT) { + Script finalRuntime = runtime; + return TransactionManagerContext.getInstance().commit(() -> { + return (T) finalRuntime.run(); + }); + } + + // 默认处理模式 + return (T) runtime.run(); + } + + +} diff --git a/springboot-starter-script/src/main/java/com/codingapi/springboot/script/GroovyScriptRuntimeContext.java b/springboot-starter-script/src/main/java/com/codingapi/springboot/script/GroovyScriptRuntimeContext.java new file mode 100644 index 000000000..0319b74c8 --- /dev/null +++ b/springboot-starter-script/src/main/java/com/codingapi/springboot/script/GroovyScriptRuntimeContext.java @@ -0,0 +1,49 @@ +package com.codingapi.springboot.script; + +import com.codingapi.springboot.script.properties.PropertiesContext; +import lombok.Getter; + +import java.util.Map; + +public class GroovyScriptRuntimeContext { + + @Getter + private final static GroovyScriptRuntimeContext instance = new GroovyScriptRuntimeContext(); + + private final GroovyScriptRuntime scriptRuntime; + + private GroovyScriptRuntimeContext() { + int maxCacheSize = PropertiesContext.getInstance().getShellMaxCacheSize(); + System.out.println("GroovyScriptRuntimeContext max cache size:" + maxCacheSize); + this.scriptRuntime = new GroovyScriptRuntime(maxCacheSize); + } + + public int getMaxCacheSize() { + return scriptRuntime.getMaxCacheSize(); + } + + public void clearCache() { + scriptRuntime.clearCache(); + } + + public int cacheSize() { + return scriptRuntime.cacheSize(); + } + + public void compile(String script, boolean cache) { + scriptRuntime.compile(script, cache); + } + + public void compile(String script) { + scriptRuntime.compile(script); + } + + public T invoke(String method, String script, Class returnType, TransactionMode transactionMode, Map binds, Object... requests) { + return scriptRuntime.invoke(method, script, returnType, transactionMode, binds, requests); + } + + + public T run(String script, Class returnType, TransactionMode transactionMode, Map binds) { + return scriptRuntime.run(script, returnType, transactionMode, binds); + } +} diff --git a/springboot-starter-script/src/main/java/com/codingapi/springboot/script/TransactionMode.java b/springboot-starter-script/src/main/java/com/codingapi/springboot/script/TransactionMode.java new file mode 100644 index 000000000..b3664bfe2 --- /dev/null +++ b/springboot-starter-script/src/main/java/com/codingapi/springboot/script/TransactionMode.java @@ -0,0 +1,10 @@ +package com.codingapi.springboot.script; + +public enum TransactionMode { + // 默认不处理 + DEFAULT, + // 事务提交模式 + COMMIT, + // 事务只读模式 + READONLY +} diff --git a/springboot-starter-script/src/main/java/com/codingapi/springboot/script/annotation/GroovyScript.java b/springboot-starter-script/src/main/java/com/codingapi/springboot/script/annotation/GroovyScript.java new file mode 100644 index 000000000..ba18c5327 --- /dev/null +++ b/springboot-starter-script/src/main/java/com/codingapi/springboot/script/annotation/GroovyScript.java @@ -0,0 +1,13 @@ +package com.codingapi.springboot.script.annotation; + +import java.lang.annotation.*; + +/** + * 脚本字段,用于获取对象下的脚本key数据 + */ +@Target({ElementType.FIELD}) +@Retention(RetentionPolicy.RUNTIME) +@Documented +public @interface GroovyScript { + +} diff --git a/springboot-starter-script/src/main/java/com/codingapi/springboot/script/annotation/ScriptField.java b/springboot-starter-script/src/main/java/com/codingapi/springboot/script/annotation/ScriptField.java new file mode 100644 index 000000000..f9396ca5d --- /dev/null +++ b/springboot-starter-script/src/main/java/com/codingapi/springboot/script/annotation/ScriptField.java @@ -0,0 +1,23 @@ +package com.codingapi.springboot.script.annotation; + +import java.lang.annotation.*; + +/** + * 脚本字段 + */ +@Target({ElementType.METHOD, ElementType.FIELD}) +@Retention(RetentionPolicy.RUNTIME) +@Documented +public @interface ScriptField { + + /** + * 名称 + */ + String name() default ""; + + /** + * 描述 + */ + String description() default ""; + +} diff --git a/springboot-starter-script/src/main/java/com/codingapi/springboot/script/annotation/ScriptFunction.java b/springboot-starter-script/src/main/java/com/codingapi/springboot/script/annotation/ScriptFunction.java new file mode 100644 index 000000000..6a2b65b20 --- /dev/null +++ b/springboot-starter-script/src/main/java/com/codingapi/springboot/script/annotation/ScriptFunction.java @@ -0,0 +1,23 @@ +package com.codingapi.springboot.script.annotation; + +import java.lang.annotation.*; + +/** + * 脚本函数 + */ +@Target({ElementType.METHOD}) +@Retention(RetentionPolicy.RUNTIME) +@Documented +public @interface ScriptFunction { + + /** + * 名称 + */ + String name(); + + /** + * 描述 + */ + String description() default ""; + +} diff --git a/springboot-starter-script/src/main/java/com/codingapi/springboot/script/annotation/ScriptParameter.java b/springboot-starter-script/src/main/java/com/codingapi/springboot/script/annotation/ScriptParameter.java new file mode 100644 index 000000000..9dd47360c --- /dev/null +++ b/springboot-starter-script/src/main/java/com/codingapi/springboot/script/annotation/ScriptParameter.java @@ -0,0 +1,23 @@ +package com.codingapi.springboot.script.annotation; + +import java.lang.annotation.*; + +/** + * 脚本函数参数 + */ +@Target({ElementType.PARAMETER}) +@Retention(RetentionPolicy.RUNTIME) +@Documented +public @interface ScriptParameter { + + /** + * 名称 + */ + String name() default ""; + + /** + * 描述 + */ + String description() default ""; + +} diff --git a/springboot-starter-script/src/main/java/com/codingapi/springboot/script/annotation/ScriptType.java b/springboot-starter-script/src/main/java/com/codingapi/springboot/script/annotation/ScriptType.java new file mode 100644 index 000000000..5dcb9b403 --- /dev/null +++ b/springboot-starter-script/src/main/java/com/codingapi/springboot/script/annotation/ScriptType.java @@ -0,0 +1,18 @@ +package com.codingapi.springboot.script.annotation; + +import java.lang.annotation.*; + +/** + * 脚本对象类型 + */ +@Target({ElementType.TYPE}) +@Retention(RetentionPolicy.RUNTIME) +@Documented +public @interface ScriptType { + + /** + * 描述 + */ + String description() default ""; + +} diff --git a/springboot-starter-script/src/main/java/com/codingapi/springboot/script/cache/GroovyScriptCacheContext.java b/springboot-starter-script/src/main/java/com/codingapi/springboot/script/cache/GroovyScriptCacheContext.java new file mode 100644 index 000000000..3a700e0ec --- /dev/null +++ b/springboot-starter-script/src/main/java/com/codingapi/springboot/script/cache/GroovyScriptCacheContext.java @@ -0,0 +1,169 @@ +package com.codingapi.springboot.script.cache; + +import com.codingapi.springboot.script.GroovyScript; +import com.codingapi.springboot.script.meta.GroovyMetadata; +import com.codingapi.springboot.script.repository.GroovyScriptRepositoryContext; +import com.codingapi.springboot.script.temp.TempGroovyScriptContext; +import lombok.Getter; + +import java.util.ArrayList; +import java.util.LinkedHashMap; +import java.util.List; +import java.util.Map; + +/** + * 脚本数据缓存上下文管理对象 + */ +public class GroovyScriptCacheContext { + + @Getter + private final static GroovyScriptCacheContext instance = new GroovyScriptCacheContext(); + + private final Map cache; + + private final static int MAX_CACHE_SIZE = 10 * 1024; + + private GroovyScriptCacheContext() { + this.cache = new LinkedHashMap(16, 0.75f, true) { + @Override + protected boolean removeEldestEntry(Map.Entry eldest) { + return size() > MAX_CACHE_SIZE; + } + }; + } + + /** + * 更新脚本缓存 + * + * @param script 脚本对象 + */ + public void save(GroovyScript script) { + if (script != null) { + this.cache.put(script.getKey(), script); + } + } + + + /** + * 保存缓存数据 + * + * @param script 脚本对象 + */ + public void cache(GroovyScript script) { + if (script != null) { + this.cache.put(script.getKey(), script); + } + } + + + /** + * 删除脚本 + * + * @param key 脚本key + */ + public void remove(String key) { + GroovyScript groovyScript = this.getGroovyScript(key); + if (groovyScript != null) { + this.cache.remove(key); + } + } + + /** + * 获取脚本keys + */ + public List keys() { + return new ArrayList<>(this.cache.keySet()); + } + + /** + * 脚本总数量 + * + * @return 总数量 + */ + public int count() { + return this.cache.size(); + } + + /** + * 获取脚本对象 + * + * @param key 脚本key + * @return 脚本对象 + */ + public GroovyScript getGroovyScript(String key) { + GroovyScript groovyScript = this.cache.get(key); + if (groovyScript == null) { + // 临时的数据不存到cache对象下 + groovyScript = TempGroovyScriptContext.getInstance().getGroovyScript(key); + if (groovyScript == null) { + groovyScript = GroovyScriptRepositoryContext.getInstance().get(key); + if (groovyScript != null) { + this.cache.put(key, groovyScript); + } + } + } + return groovyScript; + } + + /** + * 获取脚本元数据信息 + * + * @param key 脚本keu + * @return 元数据信息 + */ + public GroovyMetadata getGroovyMetadata(String key) { + GroovyScript script = this.getGroovyScript(key); + if (script != null) { + return script.toMetadata(); + } + return null; + } + + /** + * 获取脚本内容 + * + * @param key 脚本key + * @return 脚本数据 + */ + public String getScript(String key) { + GroovyScript script = this.getGroovyScript(key); + if (script != null) { + return script.getScript(); + } + return ""; + } + + /** + * 批量加载脚本 + * + * @param scriptList 脚本数据 + */ + public void setBatchCache(List scriptList) { + if (scriptList != null) { + for (GroovyScript script : scriptList) { + if (script != null) { + this.cache.put(script.getKey(), script); + } + } + } + } + + /** + * 编译脚本 + * + * @param cache 是否缓存 + */ + public void compileAll(boolean cache) { + for (GroovyScript script : this.cache.values()) { + script.compile(cache); + } + } + + + /** + * 清空脚本数据 + */ + public void clear() { + this.cache.clear(); + } +} diff --git a/springboot-starter-script/src/main/java/com/codingapi/springboot/script/controller/GroovyScriptController.java b/springboot-starter-script/src/main/java/com/codingapi/springboot/script/controller/GroovyScriptController.java new file mode 100644 index 000000000..e9f6dc6a7 --- /dev/null +++ b/springboot-starter-script/src/main/java/com/codingapi/springboot/script/controller/GroovyScriptController.java @@ -0,0 +1,73 @@ +package com.codingapi.springboot.script.controller; + + +import com.codingapi.springboot.framework.dto.response.Response; +import com.codingapi.springboot.framework.dto.response.SingleResponse; +import com.codingapi.springboot.framework.exception.LocaleMessageException; +import com.codingapi.springboot.script.GroovyScript; +import com.codingapi.springboot.script.GroovyScriptRuntimeContext; +import com.codingapi.springboot.script.cache.GroovyScriptCacheContext; +import com.codingapi.springboot.script.temp.TempGroovyScriptContext; +import com.codingapi.springboot.script.meta.GroovyMetadata; +import com.codingapi.springboot.script.pojo.ScriptCompileRequest; +import com.codingapi.springboot.script.pojo.ScriptSaveRequest; +import org.springframework.web.bind.annotation.*; + +@RestController +@RequestMapping("/api/groovy-script") +public class GroovyScriptController { + + @PostMapping("/compile") + public Response compile(@RequestBody ScriptCompileRequest request) { + try { + GroovyScriptRuntimeContext.getInstance().compile(request.getScript(), request.isCache()); + return Response.buildSuccess(); + } catch (Exception exception) { + throw new LocaleMessageException("script.compile.error", "脚本编译异常:" + exception.getMessage()); + } + } + + @GetMapping("/getScript") + public SingleResponse getScript(@RequestParam(name = "key") String key) { + GroovyScript groovyScript = GroovyScriptCacheContext.getInstance().getGroovyScript(key); + if (groovyScript != null) { + return SingleResponse.of(groovyScript.getScript()); + } + throw new LocaleMessageException("script.null", "脚本对象不存在"); + } + + @GetMapping("/getMetadata") + public SingleResponse getMetadata(@RequestParam(name = "key") String key) { + GroovyScript groovyScript = GroovyScriptCacheContext.getInstance().getGroovyScript(key); + if (groovyScript != null) { + return SingleResponse.of(groovyScript.toMetadata()); + } + throw new LocaleMessageException("script.null", "脚本对象不存在"); + } + + + @PostMapping("/save") + public Response save(@RequestBody ScriptSaveRequest request) { + try { + GroovyScript groovyScript = TempGroovyScriptContext.getInstance().getGroovyScript(request.getKey()); + if (groovyScript != null) { + groovyScript.setScript(request.getScript()); + groovyScript.compile(true); + groovyScript.temp(); + return Response.buildSuccess(); + } else { + groovyScript = GroovyScriptCacheContext.getInstance().getGroovyScript(request.getKey()); + if (groovyScript != null) { + groovyScript.setScript(request.getScript()); + groovyScript.compile(true); + groovyScript.save(); + return Response.buildSuccess(); + } + } + throw new LocaleMessageException("script.null", "脚本对象不存在"); + } catch (Exception exception) { + throw new LocaleMessageException("script.compile.error", "脚本编译异常:" + exception.getMessage()); + } + } + +} diff --git a/springboot-starter-script/src/main/java/com/codingapi/springboot/script/meta/GroovyField.java b/springboot-starter-script/src/main/java/com/codingapi/springboot/script/meta/GroovyField.java new file mode 100644 index 000000000..fe5cb2ae1 --- /dev/null +++ b/springboot-starter-script/src/main/java/com/codingapi/springboot/script/meta/GroovyField.java @@ -0,0 +1,30 @@ +package com.codingapi.springboot.script.meta; + +import lombok.Getter; +import lombok.Setter; + +/** + * 脚本对象类型 + */ +@Getter +@Setter +public class GroovyField { + + /** + * 访问名称 + */ + private String name; + + /** + * 描述信息 + */ + private String description; + + /** + * 数据类型 + */ + private String dataType; + + + +} diff --git a/springboot-starter-script/src/main/java/com/codingapi/springboot/script/meta/GroovyFunction.java b/springboot-starter-script/src/main/java/com/codingapi/springboot/script/meta/GroovyFunction.java new file mode 100644 index 000000000..4fbf02068 --- /dev/null +++ b/springboot-starter-script/src/main/java/com/codingapi/springboot/script/meta/GroovyFunction.java @@ -0,0 +1,43 @@ +package com.codingapi.springboot.script.meta; + +import lombok.Getter; +import lombok.Setter; + +import java.util.ArrayList; +import java.util.List; + +/** + * 脚本函数对象 + */ +@Getter +public class GroovyFunction { + + /** + * 对象访问名称 + */ + @Setter + private String name; + /** + * 对象描述信息 + */ + @Setter + private String description; + /** + * 返回类型 + */ + @Setter + private String returnType; + /** + * 参数类型 + */ + private final List parameters; + + public GroovyFunction() { + this.parameters = new ArrayList<>(); + } + + public void addParameter(GroovyField parameter) { + this.parameters.add(parameter); + } + +} diff --git a/springboot-starter-script/src/main/java/com/codingapi/springboot/script/meta/GroovyMetadata.java b/springboot-starter-script/src/main/java/com/codingapi/springboot/script/meta/GroovyMetadata.java new file mode 100644 index 000000000..2f73ecf32 --- /dev/null +++ b/springboot-starter-script/src/main/java/com/codingapi/springboot/script/meta/GroovyMetadata.java @@ -0,0 +1,110 @@ +package com.codingapi.springboot.script.meta; + +import com.codingapi.springboot.script.GroovyScript; +import com.codingapi.springboot.script.strategy.ScriptTypeMappingContext; +import lombok.Getter; + +import java.util.ArrayList; +import java.util.HashMap; +import java.util.List; +import java.util.Map; + + +/** + * 脚本对象元数据结构 + */ +@Getter +public class GroovyMetadata { + + /** + * 请求参数 + */ + private final List requests; + + /** + * 绑定参数 + */ + private final List binds; + + /** + * 程序主函数名称 + */ + private final String mainMethod; + + /** + * 返回类型 + */ + private final String returnType; + + /** + * 字段类型 + */ + private final Map types; + + /** + * 脚本说明 + */ + private final String description; + + + public GroovyMetadata(GroovyScript groovyScript) { + this.types = new HashMap<>(); + this.requests = new ArrayList<>(); + this.binds = new ArrayList<>(); + this.description = groovyScript.getDescription(); + this.mainMethod = groovyScript.getMethod(); + this.returnType = ScriptTypeMappingContext.getInstance().mapping(groovyScript.getReturnType()).getSimpleName(); + } + + + public GroovyMetadata(String mainMethod,String returnType, String description) { + this.returnType = returnType; + this.description = description; + this.mainMethod = mainMethod; + this.types = new HashMap<>(); + this.requests = new ArrayList<>(); + this.binds = new ArrayList<>(); + } + + + /** + * 增加请求参数数据对象 + * + * @param request 请求参数 + */ + public void addRequest(GroovyField request) { + this.requests.add(request); + } + + /** + * 更新流程类型数据 + * + * @param dataType 数据类型 + * @param groovyType 脚本类型 + */ + public void put(String dataType, GroovyType groovyType) { + this.types.put(dataType, groovyType); + } + + + /** + * 获取流程类型数据 + * + * @param dataType 数据类型 + * @return 脚本类型 + */ + public GroovyType getType(String dataType) { + return this.types.get(dataType); + } + + + /** + * 增加绑定数据对象 + * + * @param bind 绑定数据 + */ + public void addBind(GroovyField bind) { + this.binds.add(bind); + } + +} diff --git a/springboot-starter-script/src/main/java/com/codingapi/springboot/script/meta/GroovyType.java b/springboot-starter-script/src/main/java/com/codingapi/springboot/script/meta/GroovyType.java new file mode 100644 index 000000000..61980e3f2 --- /dev/null +++ b/springboot-starter-script/src/main/java/com/codingapi/springboot/script/meta/GroovyType.java @@ -0,0 +1,55 @@ +package com.codingapi.springboot.script.meta; + +import lombok.Getter; +import lombok.Setter; + +import java.util.ArrayList; +import java.util.List; + +/** + * 脚本对象类型 + */ +@Getter +public class GroovyType { + + /** + * 对象描述 + */ + @Setter + private String description; + + /** + * 数据类型 + */ + @Setter + private String dataType; + + /** + * 属性列表 + */ + private final List fields; + + /** + * 函数列表 + */ + private final List functions; + + public GroovyType() { + this.fields = new ArrayList<>(); + this.functions = new ArrayList<>(); + } + + public boolean isEmpty() { + return this.fields.isEmpty() && this.functions.isEmpty(); + } + + public void addFunction(GroovyFunction function) { + this.functions.add(function); + } + + + public void addField(GroovyField field) { + this.fields.add(field); + } + +} diff --git a/springboot-starter-script/src/main/java/com/codingapi/springboot/script/pojo/ScriptCompileRequest.java b/springboot-starter-script/src/main/java/com/codingapi/springboot/script/pojo/ScriptCompileRequest.java new file mode 100644 index 000000000..5b815cc8f --- /dev/null +++ b/springboot-starter-script/src/main/java/com/codingapi/springboot/script/pojo/ScriptCompileRequest.java @@ -0,0 +1,10 @@ +package com.codingapi.springboot.script.pojo; + +import lombok.Data; + +@Data +public class ScriptCompileRequest { + + private boolean cache; + private String script; +} diff --git a/springboot-starter-script/src/main/java/com/codingapi/springboot/script/pojo/ScriptSaveRequest.java b/springboot-starter-script/src/main/java/com/codingapi/springboot/script/pojo/ScriptSaveRequest.java new file mode 100644 index 000000000..d10373592 --- /dev/null +++ b/springboot-starter-script/src/main/java/com/codingapi/springboot/script/pojo/ScriptSaveRequest.java @@ -0,0 +1,10 @@ +package com.codingapi.springboot.script.pojo; + +import lombok.Data; + +@Data +public class ScriptSaveRequest { + + private String key; + private String script; +} diff --git a/springboot-starter-script/src/main/java/com/codingapi/springboot/script/properties/GroovyScriptProperties.java b/springboot-starter-script/src/main/java/com/codingapi/springboot/script/properties/GroovyScriptProperties.java new file mode 100644 index 000000000..aae1fe661 --- /dev/null +++ b/springboot-starter-script/src/main/java/com/codingapi/springboot/script/properties/GroovyScriptProperties.java @@ -0,0 +1,20 @@ +package com.codingapi.springboot.script.properties; + +import lombok.Getter; +import lombok.Setter; + +@Setter +@Getter +public class GroovyScriptProperties { + + /** + * 临时脚本到期时间，默认15分钟 + */ + private long tempValidTime = 1000 * 60 * 15; + + /** + * 脚本执行对象最大缓存大小 + */ + private int shellMaxCacheSize = 10 * 1024; + +} diff --git a/springboot-starter-script/src/main/java/com/codingapi/springboot/script/properties/PropertiesContext.java b/springboot-starter-script/src/main/java/com/codingapi/springboot/script/properties/PropertiesContext.java new file mode 100644 index 000000000..5a85ccc8c --- /dev/null +++ b/springboot-starter-script/src/main/java/com/codingapi/springboot/script/properties/PropertiesContext.java @@ -0,0 +1,28 @@ +package com.codingapi.springboot.script.properties; + +import lombok.Getter; +import lombok.Setter; + +/** + * 参数上下文对象 + */ +public class PropertiesContext { + + @Getter + private final static PropertiesContext instance = new PropertiesContext(); + + @Setter + private GroovyScriptProperties properties; + + private PropertiesContext() { + properties = new GroovyScriptProperties(); + } + + public long getTempValidTime() { + return properties.getTempValidTime(); + } + + public int getShellMaxCacheSize() { + return properties.getShellMaxCacheSize(); + } +} diff --git a/springboot-starter-script/src/main/java/com/codingapi/springboot/script/repository/GroovyScriptRepository.java b/springboot-starter-script/src/main/java/com/codingapi/springboot/script/repository/GroovyScriptRepository.java new file mode 100644 index 000000000..04324eb91 --- /dev/null +++ b/springboot-starter-script/src/main/java/com/codingapi/springboot/script/repository/GroovyScriptRepository.java @@ -0,0 +1,28 @@ +package com.codingapi.springboot.script.repository; + +import com.codingapi.springboot.script.GroovyScript; + +/** + * GroovyScript 仓储对象 + */ +public interface GroovyScriptRepository { + + /** + * 保存脚本 + * @param groovyScript 脚本对象 + */ + void save(GroovyScript groovyScript); + + /** + * 删除脚本 + * @param key 脚本key + */ + void delete(String key); + + + /** + * 获取脚本 + * @param key 脚本key + */ + GroovyScript get(String key); +} diff --git a/springboot-starter-script/src/main/java/com/codingapi/springboot/script/repository/GroovyScriptRepositoryContext.java b/springboot-starter-script/src/main/java/com/codingapi/springboot/script/repository/GroovyScriptRepositoryContext.java new file mode 100644 index 000000000..8a2e8fe46 --- /dev/null +++ b/springboot-starter-script/src/main/java/com/codingapi/springboot/script/repository/GroovyScriptRepositoryContext.java @@ -0,0 +1,35 @@ +package com.codingapi.springboot.script.repository; + +import com.codingapi.springboot.script.GroovyScript; +import com.codingapi.springboot.script.repository.impl.DefaultGroovyScriptRepository; +import lombok.Getter; +import lombok.Setter; + +/** + * GroovyScriptRepository 上下文对象 + */ +public class GroovyScriptRepositoryContext { + + @Getter + private final static GroovyScriptRepositoryContext instance = new GroovyScriptRepositoryContext(); + + private GroovyScriptRepositoryContext() { + this.groovyScriptRepository = new DefaultGroovyScriptRepository(); + } + + @Setter + private GroovyScriptRepository groovyScriptRepository; + + public void save(GroovyScript groovyScript) { + this.groovyScriptRepository.save(groovyScript); + } + + + public void delete(String key) { + this.groovyScriptRepository.delete(key); + } + + public GroovyScript get(String key) { + return this.groovyScriptRepository.get(key); + } +} diff --git a/springboot-starter-script/src/main/java/com/codingapi/springboot/script/repository/TempGroovyScriptRepository.java b/springboot-starter-script/src/main/java/com/codingapi/springboot/script/repository/TempGroovyScriptRepository.java new file mode 100644 index 000000000..c3152696f --- /dev/null +++ b/springboot-starter-script/src/main/java/com/codingapi/springboot/script/repository/TempGroovyScriptRepository.java @@ -0,0 +1,34 @@ +package com.codingapi.springboot.script.repository; + +import com.codingapi.springboot.script.temp.TempGroovyScript; +import org.springframework.data.domain.Page; +import org.springframework.data.domain.PageRequest; + +/** + * 临时脚本仓库对象 + */ +public interface TempGroovyScriptRepository { + + /** + * 保存数据 + */ + void save(TempGroovyScript tempGroovyScript); + + /** + * 删除数据 + */ + void delete(String key); + + /** + * 获取临时脚本 + * @param key 脚本key + */ + TempGroovyScript get(String key); + + /** + * 查询数据 + * @param request 分页条件 + */ + Page find(PageRequest request); + +} diff --git a/springboot-starter-script/src/main/java/com/codingapi/springboot/script/repository/TempGroovyScriptRepositoryContext.java b/springboot-starter-script/src/main/java/com/codingapi/springboot/script/repository/TempGroovyScriptRepositoryContext.java new file mode 100644 index 000000000..0bcb88732 --- /dev/null +++ b/springboot-starter-script/src/main/java/com/codingapi/springboot/script/repository/TempGroovyScriptRepositoryContext.java @@ -0,0 +1,39 @@ +package com.codingapi.springboot.script.repository; + +import com.codingapi.springboot.script.repository.impl.DefaultTempGroovyScriptRepository; +import com.codingapi.springboot.script.temp.TempGroovyScript; +import lombok.Getter; +import lombok.Setter; +import org.springframework.data.domain.Page; +import org.springframework.data.domain.PageRequest; + +public class TempGroovyScriptRepositoryContext { + + @Getter + private final static TempGroovyScriptRepositoryContext instance = new TempGroovyScriptRepositoryContext(); + + private TempGroovyScriptRepositoryContext(){ + this.tempGroovyScriptRepository = new DefaultTempGroovyScriptRepository(); + } + + @Setter + private TempGroovyScriptRepository tempGroovyScriptRepository; + + public void save(TempGroovyScript tempGroovyScript) { + tempGroovyScriptRepository.save(tempGroovyScript); + } + + public void delete(String key) { + tempGroovyScriptRepository.delete(key); + } + + public TempGroovyScript get(String key) { + return tempGroovyScriptRepository.get(key); + } + + public Page find(PageRequest request) { + return tempGroovyScriptRepository.find(request); + } + + +} diff --git a/springboot-starter-script/src/main/java/com/codingapi/springboot/script/repository/impl/DefaultGroovyScriptRepository.java b/springboot-starter-script/src/main/java/com/codingapi/springboot/script/repository/impl/DefaultGroovyScriptRepository.java new file mode 100644 index 000000000..402bc498a --- /dev/null +++ b/springboot-starter-script/src/main/java/com/codingapi/springboot/script/repository/impl/DefaultGroovyScriptRepository.java @@ -0,0 +1,31 @@ +package com.codingapi.springboot.script.repository.impl; + +import com.codingapi.springboot.script.GroovyScript; +import com.codingapi.springboot.script.repository.GroovyScriptRepository; + +import java.util.HashMap; +import java.util.Map; + +public class DefaultGroovyScriptRepository implements GroovyScriptRepository { + + private final Map data; + + public DefaultGroovyScriptRepository() { + this.data = new HashMap<>(); + } + + @Override + public void save(GroovyScript groovyScript) { + this.data.put(groovyScript.getKey(), groovyScript); + } + + @Override + public void delete(String key) { + this.data.remove(key); + } + + @Override + public GroovyScript get(String key) { + return this.data.get(key); + } +} diff --git a/springboot-starter-script/src/main/java/com/codingapi/springboot/script/repository/impl/DefaultTempGroovyScriptRepository.java b/springboot-starter-script/src/main/java/com/codingapi/springboot/script/repository/impl/DefaultTempGroovyScriptRepository.java new file mode 100644 index 000000000..a043b320d --- /dev/null +++ b/springboot-starter-script/src/main/java/com/codingapi/springboot/script/repository/impl/DefaultTempGroovyScriptRepository.java @@ -0,0 +1,58 @@ +package com.codingapi.springboot.script.repository.impl; + +import com.codingapi.springboot.script.repository.TempGroovyScriptRepository; +import com.codingapi.springboot.script.temp.TempGroovyScript; +import org.springframework.data.domain.Page; +import org.springframework.data.domain.PageImpl; +import org.springframework.data.domain.PageRequest; + +import java.util.*; +import java.util.stream.Collectors; + +public class DefaultTempGroovyScriptRepository implements TempGroovyScriptRepository { + + private final Map data; + + public DefaultTempGroovyScriptRepository() { + this.data = new HashMap<>(); + } + + @Override + public void save(TempGroovyScript tempGroovyScript) { + data.put(tempGroovyScript.getKey(), tempGroovyScript); + } + + + @Override + public void delete(String key) { + this.data.remove(key); + } + + @Override + public TempGroovyScript get(String key) { + return data.get(key); + } + + @Override + public Page find(PageRequest request) { + int form = request.getPageNumber() * request.getPageSize(); + int to = (request.getPageNumber() + 1) * request.getPageSize(); + + List list = this.data.values() + .stream() + .sorted(Comparator.comparing(TempGroovyScript::getClearTime)) + .collect(Collectors.toList()); + + List data; + if (form > list.size()) { + data = new ArrayList<>(); + } else { + if (list.size() > to) { + data = list.subList(form, to); + } else { + data = list.subList(form, list.size()); + } + } + return new PageImpl<>(data, request, this.data.size()); + } +} diff --git a/springboot-starter-script/src/main/java/com/codingapi/springboot/script/runner/GroovyScriptEngineRunner.java b/springboot-starter-script/src/main/java/com/codingapi/springboot/script/runner/GroovyScriptEngineRunner.java new file mode 100644 index 000000000..b7284e61c --- /dev/null +++ b/springboot-starter-script/src/main/java/com/codingapi/springboot/script/runner/GroovyScriptEngineRunner.java @@ -0,0 +1,44 @@ +package com.codingapi.springboot.script.runner; + +import com.codingapi.springboot.framework.dto.request.PageRequest; +import com.codingapi.springboot.script.temp.TempGroovyScriptContext; +import com.codingapi.springboot.script.repository.TempGroovyScriptRepositoryContext; +import com.codingapi.springboot.script.temp.TempGroovyScript; +import lombok.extern.slf4j.Slf4j; +import org.springframework.beans.factory.DisposableBean; +import org.springframework.beans.factory.InitializingBean; +import org.springframework.data.domain.Page; + +import java.util.List; + +@Slf4j +public class GroovyScriptEngineRunner implements InitializingBean, DisposableBean { + + + @Override + public void afterPropertiesSet() throws Exception { + log.info("load temp groovy script data to cache ..."); + PageRequest request = PageRequest.of(0, 100); + Page page = TempGroovyScriptRepositoryContext.getInstance().find(request); + while (page.hasNext()) { + TempGroovyScriptContext.getInstance().loadAll(page.getContent()); + request = PageRequest.of(request.getCurrent() + 1, 100); + page = TempGroovyScriptRepositoryContext.getInstance().find(request); + } + log.info("load temp groovy script data to cache success."); + } + + @Override + public void destroy() throws Exception { + log.info("save temp groovy script data to disk ..."); + + List tempGroovyScriptList = TempGroovyScriptContext.getInstance().findAll(); + if(!tempGroovyScriptList.isEmpty()){ + for (TempGroovyScript groovyScript:tempGroovyScriptList){ + TempGroovyScriptRepositoryContext.getInstance().save(groovyScript); + } + } + + log.info("save temp groovy script data to disk success."); + } +} diff --git a/springboot-starter-script/src/main/java/com/codingapi/springboot/script/scanner/GroovyMetadataScannerUtils.java b/springboot-starter-script/src/main/java/com/codingapi/springboot/script/scanner/GroovyMetadataScannerUtils.java new file mode 100644 index 000000000..f1466c55b --- /dev/null +++ b/springboot-starter-script/src/main/java/com/codingapi/springboot/script/scanner/GroovyMetadataScannerUtils.java @@ -0,0 +1,320 @@ +package com.codingapi.springboot.script.scanner; + +import com.codingapi.springboot.framework.reflect.ObjectAnnotationFieldUtils; +import com.codingapi.springboot.script.GroovyScript; +import com.codingapi.springboot.script.annotation.ScriptField; +import com.codingapi.springboot.script.annotation.ScriptFunction; +import com.codingapi.springboot.script.annotation.ScriptParameter; +import com.codingapi.springboot.script.annotation.ScriptType; +import com.codingapi.springboot.script.strategy.ScriptTypeMappingContext; +import com.codingapi.springboot.script.meta.GroovyField; +import com.codingapi.springboot.script.meta.GroovyFunction; +import com.codingapi.springboot.script.meta.GroovyMetadata; +import com.codingapi.springboot.script.meta.GroovyType; +import com.codingapi.springboot.script.strategy.GroovyMetadataGenerateStrategyContext; +import com.codingapi.springboot.script.strategy.GroovyTypeFixStrategyContext; +import lombok.Getter; +import org.springframework.util.ClassUtils; +import org.springframework.util.ReflectionUtils; +import org.springframework.util.StringUtils; + +import java.lang.reflect.Parameter; +import java.util.ArrayList; +import java.util.List; +import java.util.Map; + +/** + * 脚本元数据对象扫描工具 + */ +public class GroovyMetadataScannerUtils { + + public static GroovyMetadata scanner(GroovyScript groovyScript) { + // 手动构建的元数据则，直接返回 + GroovyMetadata metadata = GroovyMetadataGenerateStrategyContext.getInstance().generate(groovyScript); + if (metadata != null) { + return metadata; + } + // 扫描元数据信息 + GroovyMetadataHolder groovyMetadataHolder = new GroovyMetadataHolder(groovyScript); + groovyMetadataHolder.scanner(); + return groovyMetadataHolder.getMetadata(); + } + + + /** + * 脚本元数据持有者 + */ + private static class GroovyMetadataHolder { + + @Getter + private final GroovyMetadata metadata; + private final GroovyScript groovyScript; + + private final List> scannerHistoryList; + + public GroovyMetadataHolder(GroovyScript groovyScript) { + this.metadata = new GroovyMetadata(groovyScript); + this.groovyScript = groovyScript; + this.scannerHistoryList = new ArrayList<>(); + } + + /** + * 添加扫描历史记录 + * + * @param target 扫描对象 + */ + public void addHistory(Class target) { + this.scannerHistoryList.add(target); + } + + /** + * 是否在历史扫描对象 + * + * @param target 扫描对象 + */ + public boolean hasHistory(Class target) { + return this.scannerHistoryList.contains(target); + } + + + /** + * 扫描请求对象的数据类型 + */ + private void scannerRequestTypes() { + Map> requests = groovyScript.getRequests(); + if (requests != null && !requests.isEmpty()) { + for (Class objClass : requests.values()) { + GroovyTypeScanner scanner = new GroovyTypeScanner(objClass, this); + scanner.scanner(); + } + } + } + + /** + * 扫描绑定对象的数据类型 + */ + private void scannerBindTypes() { + Map> binds = groovyScript.getBinds(); + if (binds != null && !binds.isEmpty()) { + for (Class objClass : binds.values()) { + GroovyTypeScanner scanner = new GroovyTypeScanner(objClass, this); + scanner.scanner(); + } + } + } + + /** + * 扫描返回数据对象数据类型 + */ + private void scannerReturnType() { + Class returnTypeClass = this.groovyScript.getReturnType(); + if (returnTypeClass != null) { + GroovyTypeScanner scanner = new GroovyTypeScanner(returnTypeClass, this); + scanner.scanner(); + } + } + + + /** + * 扫描对象 + */ + public void scanner() { + this.scannerRequestTypes(); + this.scannerBindTypes(); + this.scannerReturnType(); + + this.loadRequestFields(); + this.loadBindFields(); + } + + /** + * 加载请求参数字段信息 + */ + private void loadRequestFields() { + Map> requests = groovyScript.getRequests(); + if (requests != null && !requests.isEmpty()) { + for (String key : requests.keySet()) { + Class objClass = this.getTargetClass(requests.get(key)); + String dataType = objClass.getSimpleName(); + GroovyField groovyField = new GroovyField(); + groovyField.setDataType(dataType); + groovyField.setName(key); + GroovyType groovyType = this.metadata.getType(dataType); + if (groovyType != null) { + groovyField.setDescription(groovyType.getDescription()); + } + this.metadata.addRequest(groovyField); + } + } + } + + /** + * 添加数据类型 + */ + public void addType(GroovyType groovyType) { + this.metadata.put(groovyType.getDataType(), groovyType); + } + + + /** + * 加载绑定对象的参数信息 + */ + private void loadBindFields() { + Map> binds = groovyScript.getBinds(); + if (binds != null && !binds.isEmpty()) { + for (String key : binds.keySet()) { + Class objClass = this.getTargetClass(binds.get(key)); + GroovyField groovyField = new GroovyField(); + String dataType = objClass.getSimpleName(); + groovyField.setDataType(dataType); + groovyField.setName(key); + GroovyType groovyType = this.metadata.getType(dataType); + if (groovyType != null) { + groovyField.setDescription(groovyType.getDescription()); + } + this.metadata.addBind(groovyField); + } + } + } + + /** + * 获取实际的类型对象 + * + * @param type 类型 + * @return 实际类型 + */ + public Class getTargetClass(Class type) { + return ScriptTypeMappingContext.getInstance().mapping(type); + } + + + } + + /** + * 脚本扫描对象 + */ + private static class GroovyTypeScanner { + + private final Class clazz; + private final GroovyType object; + private final GroovyMetadataHolder holder; + + public GroovyTypeScanner(Class clazz, GroovyMetadataHolder holder) { + this.clazz = holder.getTargetClass(clazz); + this.object = new GroovyType(); + this.holder = holder; + } + + + /** + * 加载字段信息 + */ + private void loadFields() { + ReflectionUtils.doWithFields(this.clazz, field -> { + ScriptField scriptField = field.getAnnotation(ScriptField.class); + if (scriptField != null) { + Class clazz = this.holder.getTargetClass(field.getType()); + + GroovyTypeScanner scanner = new GroovyTypeScanner(clazz, this.holder); + scanner.scanner(); + + GroovyField groovyField = new GroovyField(); + groovyField.setDataType(clazz.getSimpleName()); + groovyField.setName(field.getName()); + + if (StringUtils.hasText(scriptField.name())) { + groovyField.setName(scriptField.name()); + } + if (StringUtils.hasText(scriptField.description())) { + groovyField.setDescription(scriptField.description()); + } + this.object.addField(groovyField); + } + }); + } + + /** + * 加载函数信息 + */ + private void loadMethods() { + ReflectionUtils.doWithMethods(this.clazz, method -> { + ScriptFunction scriptFunction = method.getAnnotation(ScriptFunction.class); + if (scriptFunction != null) { + GroovyFunction groovyFunction = new GroovyFunction(); + groovyFunction.setName(method.getName()); + + if (StringUtils.hasText(scriptFunction.name())) { + groovyFunction.setName(scriptFunction.name()); + } + + if (StringUtils.hasText(scriptFunction.description())) { + groovyFunction.setDescription(scriptFunction.description()); + } + + Parameter[] methodParameters = method.getParameters(); + for (Parameter methodParameter : methodParameters) { + Class parameterClass = this.holder.getTargetClass(methodParameter.getType()); + + GroovyTypeScanner scanner = new GroovyTypeScanner(parameterClass, this.holder); + scanner.scanner(); + + GroovyField groovyParameter = new GroovyField(); + groovyParameter.setDataType(parameterClass.getSimpleName()); + groovyParameter.setName(methodParameter.getName()); + + ScriptParameter scriptParameter = methodParameter.getAnnotation(ScriptParameter.class); + if (scriptParameter != null) { + if (StringUtils.hasText(scriptParameter.name())) { + groovyParameter.setName(scriptParameter.name()); + } + if (StringUtils.hasText(scriptParameter.description())) { + groovyParameter.setDescription(scriptParameter.description()); + } + } + + groovyFunction.addParameter(groovyParameter); + } + + Class returnType = this.holder.getTargetClass(method.getReturnType()); + GroovyTypeScanner scanner = new GroovyTypeScanner(returnType, this.holder); + scanner.scanner(); + groovyFunction.setReturnType(returnType.getSimpleName()); + + this.object.addFunction(groovyFunction); + } + }); + } + + + /** + * 扫描类对象 + */ + public void scanner() { + this.object.setDataType(this.clazz.getSimpleName()); + ScriptType scriptType = this.clazz.getAnnotation(ScriptType.class); + if (scriptType != null) { + this.object.setDescription(scriptType.description()); + } + + // 简单数据类型不处理 + if (ObjectAnnotationFieldUtils.isSimpleType(this.clazz)) { + return; + } + + if (holder.hasHistory(this.clazz)) { + return; + } + this.holder.addHistory(this.clazz); + this.loadFields(); + this.loadMethods(); + + // 调整元数据 + GroovyTypeFixStrategyContext.getInstance().fix(this.holder.groovyScript, this.clazz, this.object); + + // 添加数据类型 + this.holder.addType(this.object); + } + + } + +} diff --git a/springboot-starter-script/src/main/java/com/codingapi/springboot/script/scanner/GroovyScriptAnnotationScannerUtils.java b/springboot-starter-script/src/main/java/com/codingapi/springboot/script/scanner/GroovyScriptAnnotationScannerUtils.java new file mode 100644 index 000000000..98d716239 --- /dev/null +++ b/springboot-starter-script/src/main/java/com/codingapi/springboot/script/scanner/GroovyScriptAnnotationScannerUtils.java @@ -0,0 +1,15 @@ +package com.codingapi.springboot.script.scanner; + +import com.codingapi.springboot.framework.reflect.ObjectAnnotationFieldUtils; +import com.codingapi.springboot.script.annotation.GroovyScript; + +/** + * {@link GroovyScript} 注解扫描工具类型 + */ +public class GroovyScriptAnnotationScannerUtils { + + public static GroovyScriptFieldResult findGroovyScriptFields(Object target) { + return new GroovyScriptFieldResult(ObjectAnnotationFieldUtils.findFieldAnnotationValue(target, GroovyScript.class, String.class)); + } + +} diff --git a/springboot-starter-script/src/main/java/com/codingapi/springboot/script/scanner/GroovyScriptFieldResult.java b/springboot-starter-script/src/main/java/com/codingapi/springboot/script/scanner/GroovyScriptFieldResult.java new file mode 100644 index 000000000..e2de3fad7 --- /dev/null +++ b/springboot-starter-script/src/main/java/com/codingapi/springboot/script/scanner/GroovyScriptFieldResult.java @@ -0,0 +1,21 @@ +package com.codingapi.springboot.script.scanner; + +import com.codingapi.springboot.framework.reflect.pojo.AnnotationTargetFieldResult; +import lombok.AllArgsConstructor; + +import java.util.List; + +@AllArgsConstructor +public class GroovyScriptFieldResult { + + private final AnnotationTargetFieldResult result; + + public List getKeys(){ + return result.getValues(); + } + + public void update(AnnotationTargetFieldResult.Generate generateKey){ + result.update(generateKey); + } + +} diff --git a/springboot-starter-script/src/main/java/com/codingapi/springboot/script/strategy/GroovyMetadataGenerateStrategy.java b/springboot-starter-script/src/main/java/com/codingapi/springboot/script/strategy/GroovyMetadataGenerateStrategy.java new file mode 100644 index 000000000..cbeb95615 --- /dev/null +++ b/springboot-starter-script/src/main/java/com/codingapi/springboot/script/strategy/GroovyMetadataGenerateStrategy.java @@ -0,0 +1,14 @@ +package com.codingapi.springboot.script.strategy; + +import com.codingapi.springboot.script.GroovyScript; +import com.codingapi.springboot.script.meta.GroovyMetadata; + +/** + * 脚本元数据构建策略 + */ +public interface GroovyMetadataGenerateStrategy { + + boolean support(GroovyScript script); + + GroovyMetadata generate(GroovyScript script); +} diff --git a/springboot-starter-script/src/main/java/com/codingapi/springboot/script/strategy/GroovyMetadataGenerateStrategyContext.java b/springboot-starter-script/src/main/java/com/codingapi/springboot/script/strategy/GroovyMetadataGenerateStrategyContext.java new file mode 100644 index 000000000..84372d6f2 --- /dev/null +++ b/springboot-starter-script/src/main/java/com/codingapi/springboot/script/strategy/GroovyMetadataGenerateStrategyContext.java @@ -0,0 +1,45 @@ +package com.codingapi.springboot.script.strategy; + +import com.codingapi.springboot.script.GroovyScript; +import com.codingapi.springboot.script.meta.GroovyMetadata; +import lombok.Getter; + +import java.util.ArrayList; +import java.util.List; + +/** + * 脚本元数据构建策略上下文 + */ +public class GroovyMetadataGenerateStrategyContext { + + @Getter + private final static GroovyMetadataGenerateStrategyContext instance = new GroovyMetadataGenerateStrategyContext(); + + private final List strategies; + + private GroovyMetadataGenerateStrategyContext() { + this.strategies = new ArrayList<>(); + } + + public void addGenerateStrategy(GroovyMetadataGenerateStrategy strategy) { + this.strategies.add(strategy); + } + + + /** + * 清空策略 + */ + public void clear(){ + this.strategies.clear(); + } + + public GroovyMetadata generate(GroovyScript groovyScript) { + for (GroovyMetadataGenerateStrategy strategy : this.strategies) { + if (strategy.support(groovyScript)) { + return strategy.generate(groovyScript); + } + } + return null; + } + +} diff --git a/springboot-starter-script/src/main/java/com/codingapi/springboot/script/strategy/GroovyTypeFixStrategy.java b/springboot-starter-script/src/main/java/com/codingapi/springboot/script/strategy/GroovyTypeFixStrategy.java new file mode 100644 index 000000000..75b7958c2 --- /dev/null +++ b/springboot-starter-script/src/main/java/com/codingapi/springboot/script/strategy/GroovyTypeFixStrategy.java @@ -0,0 +1,21 @@ +package com.codingapi.springboot.script.strategy; + +import com.codingapi.springboot.script.GroovyScript; +import com.codingapi.springboot.script.meta.GroovyType; + +/** + * 脚本元数据调整策略 + */ +public interface GroovyTypeFixStrategy { + + boolean support(Class clazz); + + /** + * 调整元数据结构 + * + * @param groovyScript 脚本对象 + * @param groovyType 类型元数据结构（扫描后） + */ + void fix(GroovyScript groovyScript, GroovyType groovyType); + +} diff --git a/springboot-starter-script/src/main/java/com/codingapi/springboot/script/strategy/GroovyTypeFixStrategyContext.java b/springboot-starter-script/src/main/java/com/codingapi/springboot/script/strategy/GroovyTypeFixStrategyContext.java new file mode 100644 index 000000000..e8ed6a8ef --- /dev/null +++ b/springboot-starter-script/src/main/java/com/codingapi/springboot/script/strategy/GroovyTypeFixStrategyContext.java @@ -0,0 +1,40 @@ +package com.codingapi.springboot.script.strategy; + +import com.codingapi.springboot.script.GroovyScript; +import com.codingapi.springboot.script.meta.GroovyType; +import lombok.Getter; + +import java.util.ArrayList; +import java.util.List; + +public class GroovyTypeFixStrategyContext { + + private final List strategies; + + @Getter + private final static GroovyTypeFixStrategyContext instance = new GroovyTypeFixStrategyContext(); + + private GroovyTypeFixStrategyContext() { + this.strategies = new ArrayList<>(); + } + + public void addFixStrategy(GroovyTypeFixStrategy gateway) { + this.strategies.add(gateway); + } + + /** + * 清空策略 + */ + public void clear(){ + this.strategies.clear(); + } + + public void fix(GroovyScript groovyScript, Class clazz, GroovyType groovyType) { + for (GroovyTypeFixStrategy strategy : strategies) { + if (strategy.support(clazz)) { + strategy.fix(groovyScript, groovyType); + } + } + } + +} diff --git a/springboot-starter-script/src/main/java/com/codingapi/springboot/script/strategy/ScriptTypeMapping.java b/springboot-starter-script/src/main/java/com/codingapi/springboot/script/strategy/ScriptTypeMapping.java new file mode 100644 index 000000000..cd240516e --- /dev/null +++ b/springboot-starter-script/src/main/java/com/codingapi/springboot/script/strategy/ScriptTypeMapping.java @@ -0,0 +1,22 @@ +package com.codingapi.springboot.script.strategy; + +/** + * 脚本类型关系映射 + */ +public interface ScriptTypeMapping { + + /** + * 是否匹配 + * @param target 类型 + */ + boolean support(Class target); + + + /** + * 转化后的类型 + * @param target 类型 + * @return 目标类型 + */ + Class mapping(Class target); + +} diff --git a/springboot-starter-script/src/main/java/com/codingapi/springboot/script/strategy/ScriptTypeMappingContext.java b/springboot-starter-script/src/main/java/com/codingapi/springboot/script/strategy/ScriptTypeMappingContext.java new file mode 100644 index 000000000..c9e30e338 --- /dev/null +++ b/springboot-starter-script/src/main/java/com/codingapi/springboot/script/strategy/ScriptTypeMappingContext.java @@ -0,0 +1,54 @@ +package com.codingapi.springboot.script.strategy; + +import lombok.Getter; + +import java.util.ArrayList; +import java.util.List; + +/** + * 脚本类型映射上下文对象 + */ +public class ScriptTypeMappingContext { + + @Getter + private final static ScriptTypeMappingContext instance = new ScriptTypeMappingContext(); + + private final List mappings; + + private ScriptTypeMappingContext() { + this.mappings = new ArrayList<>(); + } + + /** + * 添加类型映射 + * @param mapping 映射对象 + */ + public void addMapping(ScriptTypeMapping mapping){ + this.mappings.add(mapping); + } + + + /** + * 清空策略 + */ + public void clear(){ + this.mappings.clear(); + } + + + /** + * 映射 + * @param target 类对象 + * @return 目标类对象 + */ + public Class mapping(Class target) { + for (ScriptTypeMapping mapping : this.mappings) { + if (mapping.support(target)) { + return mapping.mapping(target); + } + } + return target; + } + + +} diff --git a/springboot-starter-script/src/main/java/com/codingapi/springboot/script/temp/TempGroovyScript.java b/springboot-starter-script/src/main/java/com/codingapi/springboot/script/temp/TempGroovyScript.java new file mode 100644 index 000000000..e2353998b --- /dev/null +++ b/springboot-starter-script/src/main/java/com/codingapi/springboot/script/temp/TempGroovyScript.java @@ -0,0 +1,30 @@ +package com.codingapi.springboot.script.temp; + +import com.codingapi.springboot.script.GroovyScript; +import lombok.Getter; + +/** + * 临时脚本对象 + * 数据将会自动清理 + */ +@Getter +public class TempGroovyScript { + + private final GroovyScript groovyScript; + private final long clearTime; + + public TempGroovyScript(GroovyScript groovyScript, long clearTime) { + this.groovyScript = groovyScript; + this.clearTime = clearTime; + } + + public String getKey() { + return this.groovyScript.getKey(); + } + + + public boolean isExpired(){ + return System.currentTimeMillis() - this.clearTime >= 0; + } + +} diff --git a/springboot-starter-script/src/main/java/com/codingapi/springboot/script/temp/TempGroovyScriptContext.java b/springboot-starter-script/src/main/java/com/codingapi/springboot/script/temp/TempGroovyScriptContext.java new file mode 100644 index 000000000..4b3c447a6 --- /dev/null +++ b/springboot-starter-script/src/main/java/com/codingapi/springboot/script/temp/TempGroovyScriptContext.java @@ -0,0 +1,190 @@ +package com.codingapi.springboot.script.temp; + +import com.codingapi.springboot.script.GroovyScript; +import com.codingapi.springboot.script.properties.PropertiesContext; +import com.codingapi.springboot.script.repository.TempGroovyScriptRepositoryContext; +import lombok.Getter; + +import java.util.List; +import java.util.Map; +import java.util.concurrent.ConcurrentHashMap; +import java.util.concurrent.Executors; +import java.util.concurrent.ScheduledExecutorService; +import java.util.concurrent.ScheduledFuture; +import java.util.concurrent.TimeUnit; +import java.util.stream.Collectors; + +/** + * 临时脚本数据上下文管理对象 + */ +public class TempGroovyScriptContext { + + @Getter + private final static TempGroovyScriptContext instance = new TempGroovyScriptContext(); + + /** + * 共享的清理调度线程（daemon） + * 所有临时脚本共用一个调度线程，避免每个脚本创建原生线程导致线程泄漏 + */ + private final static ScheduledExecutorService SCHEDULER = Executors.newSingleThreadScheduledExecutor(r -> { + Thread thread = new Thread(r, "temp-groovy-script-clear"); + thread.setDaemon(true); + return thread; + }); + + private final Map cache; + + private TempGroovyScriptContext() { + this.cache = new ConcurrentHashMap<>(); + } + + private static class ClearJob { + + @Getter + private final TempGroovyScript tempGroovyScript; + + private final ScheduledFuture future; + + public ClearJob(TempGroovyScript groovyScript) { + this.tempGroovyScript = groovyScript; + // clearTime 为绝对到期时间戳，需换算为相对延迟 + long delay = groovyScript.getClearTime() - System.currentTimeMillis(); + this.future = SCHEDULER.schedule(this::expire, delay, TimeUnit.MILLISECONDS); + } + + public GroovyScript getGroovyScript() { + return this.tempGroovyScript.getGroovyScript(); + } + + public String getKey() { + return tempGroovyScript.getKey(); + } + + /** + * 到期清理 + * 仅当缓存中仍是当前任务时才删除，避免过期任务误删已被刷新的脚本 + */ + private void expire() { + TempGroovyScriptContext.getInstance().removeIfCurrent(getKey(), this); + } + + /** + * 取消定时清理任务 + */ + private void cancel() { + this.future.cancel(false); + } + } + + /** + * 更新脚本缓存 + * + * @param script 脚本对象 + */ + public void save(GroovyScript script) { + if (script != null) { + long tempValidTime = PropertiesContext.getInstance().getTempValidTime(); + this.put(script.getKey(), new ClearJob(new TempGroovyScript(script, tempValidTime + System.currentTimeMillis()))); + } + } + + /** + * 写入缓存，覆盖时取消旧任务的定时清理 + */ + private void put(String key, ClearJob job) { + ClearJob previous = this.cache.put(key, job); + if (previous != null) { + previous.cancel(); + } + } + + /** + * 加载到临时缓存 + */ + public void loadAll(List groovyScripts) { + if (groovyScripts != null) { + for (TempGroovyScript groovyScript : groovyScripts) { + if (groovyScript.isExpired()) { + this.remove(groovyScript.getKey()); + } else { + this.put(groovyScript.getKey(), new ClearJob(groovyScript)); + } + } + } + } + + /** + * 获取当前缓存的数据 + */ + public List findAll() { + return this.cache.values().stream().map(ClearJob::getTempGroovyScript).collect(Collectors.toList()); + } + + + /** + * 删除脚本 + * + * @param key 脚本key + */ + public void remove(String key) { + ClearJob job = this.cache.remove(key); + if (job != null) { + job.cancel(); + } + TempGroovyScriptRepositoryContext.getInstance().delete(key); + } + + /** + * 仅当缓存中的任务仍为当前任务时删除，防止过期任务误删已被刷新的脚本。 + * 使用 ConcurrentHashMap.remove(key, value) 原子判断 + 删除，避免 check-then-act 竞态 + */ + private void removeIfCurrent(String key, ClearJob job) { + if (this.cache.remove(key, job)) { + job.cancel(); + TempGroovyScriptRepositoryContext.getInstance().delete(key); + } + } + + /** + * 脚本总数量 + * + * @return 总数量 + */ + public int count() { + return this.cache.size(); + } + + /** + * 获取脚本对象 + * + * @param key 脚本key + * @return 脚本对象 + */ + public GroovyScript getGroovyScript(String key) { + ClearJob job = this.cache.get(key); + if (job == null) { + TempGroovyScript groovyScript = TempGroovyScriptRepositoryContext.getInstance().get(key); + if (groovyScript != null) { + if (groovyScript.isExpired()) { + this.remove(key); + return null; + } + this.put(key, new ClearJob(groovyScript)); + return groovyScript.getGroovyScript(); + } + return null; + } + return job.getGroovyScript(); + } + + + /** + * 清空脚本数据 + */ + public void clear() { + for (ClearJob job : this.cache.values()) { + job.cancel(); + } + this.cache.clear(); + } +} \ No newline at end of file diff --git a/springboot-starter-id-generator/src/main/resources/META-INF/spring.factories b/springboot-starter-script/src/main/resources/META-INF/spring.factories similarity index 55% rename from springboot-starter-id-generator/src/main/resources/META-INF/spring.factories rename to springboot-starter-script/src/main/resources/META-INF/spring.factories index f30445ef6..2dcc1048d 100644 --- a/springboot-starter-id-generator/src/main/resources/META-INF/spring.factories +++ b/springboot-starter-script/src/main/resources/META-INF/spring.factories @@ -1,2 +1,2 @@ org.springframework.boot.autoconfigure.EnableAutoConfiguration=\ -com.codingapi.springboot.generator.AutoConfiguration \ No newline at end of file +com.codingapi.springboot.script.AutoConfiguration diff --git a/springboot-starter-script/src/main/resources/META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports b/springboot-starter-script/src/main/resources/META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports new file mode 100644 index 000000000..d19a6f5ff --- /dev/null +++ b/springboot-starter-script/src/main/resources/META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports @@ -0,0 +1 @@ +com.codingapi.springboot.script.AutoConfiguration diff --git a/springboot-starter-script/src/test/java/com/codingapi/springboot/script/GroovyScriptRuntimeContextCoverageTest.java b/springboot-starter-script/src/test/java/com/codingapi/springboot/script/GroovyScriptRuntimeContextCoverageTest.java new file mode 100644 index 000000000..e123abe54 --- /dev/null +++ b/springboot-starter-script/src/test/java/com/codingapi/springboot/script/GroovyScriptRuntimeContextCoverageTest.java @@ -0,0 +1,70 @@ +package com.codingapi.springboot.script; + +import org.junit.jupiter.api.AfterEach; +import org.junit.jupiter.api.Test; + +import java.util.HashMap; +import java.util.Map; + +import static org.junit.jupiter.api.Assertions.assertEquals; +import static org.junit.jupiter.api.Assertions.assertSame; +import static org.junit.jupiter.api.Assertions.assertTrue; + +/** + * GroovyScriptRuntimeContext 单元测试 + * 覆盖单例上下文对 GroovyScriptRuntime 的委托方法 + */ +class GroovyScriptRuntimeContextCoverageTest { + + @AfterEach + void tearDown() { + GroovyScriptRuntimeContext.getInstance().clearCache(); + } + + @Test + void instanceShouldBeSingletonWithDefaultConfig() { + GroovyScriptRuntimeContext context = GroovyScriptRuntimeContext.getInstance(); + assertSame(context, GroovyScriptRuntimeContext.getInstance()); + // 默认配置 shellMaxCacheSize = 10 * 1024 + assertTrue(context.getMaxCacheSize() > 0); + assertEquals(GroovyScriptRuntimeContext.getInstance().getMaxCacheSize(), context.getMaxCacheSize()); + } + + @Test + void compileWithAndWithoutCache() { + GroovyScriptRuntimeContext context = GroovyScriptRuntimeContext.getInstance(); + + context.compile("return 1;"); + assertEquals(0, context.cacheSize()); + + context.compile("return 2;", true); + assertEquals(1, context.cacheSize()); + + context.clearCache(); + assertEquals(0, context.cacheSize()); + } + + @Test + void runShouldDelegateToRuntime() { + GroovyScriptRuntimeContext context = GroovyScriptRuntimeContext.getInstance(); + + Integer result = context.run("return 7;", Integer.class, TransactionMode.DEFAULT, null); + assertEquals(7, result); + + Map binds = new HashMap<>(); + binds.put("$x", 1); + Integer bound = context.run("return $x + 1;", Integer.class, TransactionMode.DEFAULT, binds); + assertEquals(2, bound); + } + + @Test + void invokeShouldDelegateToRuntime() { + GroovyScriptRuntimeContext context = GroovyScriptRuntimeContext.getInstance(); + + String script = "def run(request){\n" + + " return request;\n" + + "}\n"; + Integer result = context.invoke("run", script, Integer.class, TransactionMode.DEFAULT, null, 100); + assertEquals(100, result); + } +} diff --git a/springboot-starter-script/src/test/java/com/codingapi/springboot/script/GroovyScriptRuntimeContextTest.java b/springboot-starter-script/src/test/java/com/codingapi/springboot/script/GroovyScriptRuntimeContextTest.java new file mode 100644 index 000000000..96a681f6e --- /dev/null +++ b/springboot-starter-script/src/test/java/com/codingapi/springboot/script/GroovyScriptRuntimeContextTest.java @@ -0,0 +1,123 @@ +package com.codingapi.springboot.script; + +import com.alibaba.fastjson.JSON; +import com.codingapi.springboot.script.meta.GroovyMetadata; +import com.codingapi.springboot.script.request.MyScriptRequest; +import com.codingapi.springboot.script.strategy.GroovyMetadataGenerateStrategyContext; +import com.codingapi.springboot.script.strategy.GroovyTypeFixStrategyContext; +import com.codingapi.springboot.script.strategy.ScriptTypeMappingContext; +import org.apache.groovy.util.Maps; +import org.junit.jupiter.api.BeforeEach; +import org.junit.jupiter.api.Test; + +import static org.junit.jupiter.api.Assertions.assertEquals; + +class GroovyScriptRuntimeContextTest { + + + @BeforeEach + void beforeRun(){ + GroovyMetadataGenerateStrategyContext.getInstance().clear(); + GroovyTypeFixStrategyContext.getInstance().clear(); + ScriptTypeMappingContext.getInstance().clear(); + } + + @Test + void voidInvoke() { + + String script = "def run(request){ println(request)}"; + + GroovyScript groovyScript = + GroovyScript.builder("voidInvoke") + .script(script) + .method("run") + .returnType(Void.class) + .requests(Maps.of("request", Integer.class)) + .build(); + + long t1 = System.currentTimeMillis(); + groovyScript.invoke(Maps.of("request", 100)); + long t2 = System.currentTimeMillis(); + System.out.println("groovy time:" + (t2 - t1)); + + } + + + @Test + void metaTest() { + + String script = "def run(request){ return request.count;}"; + + GroovyScript groovyScript = + GroovyScript.builder("metaTest") + .script(script) + .description("这是一个run函数，返回的格式为int类型。") + .method("run") + .tag("123") + .returnType(Integer.class) + .requests(Maps.of("request", MyScriptRequest.class)) + .build(); + + GroovyMetadata metadata = groovyScript.toMetadata(); + System.out.println(JSON.toJSONString(metadata)); + assertEquals(1, metadata.getRequests().size()); + + MyScriptRequest request = new MyScriptRequest(100); + long t1 = System.currentTimeMillis(); + int result = groovyScript.invoke(request); + long t2 = System.currentTimeMillis(); + System.out.println("groovy time:" + (t2 - t1)); + assertEquals(100, result); + } + + @Test + void run() { + + String script = " return $request; "; + + GroovyScript groovyScript = + GroovyScript.builder("run") + .script(script) + .returnType(Integer.class) + .binds(Maps.of("$request", Integer.class)) + .build(); + + long t1 = System.currentTimeMillis(); + int result = groovyScript.run(Maps.of("$request", 100)); + long t2 = System.currentTimeMillis(); + System.out.println("groovy time:" + (t2 - t1)); + + assertEquals(100, result); + } + + @Test + void invoke() { + String script = "def run(request){ return request;}"; + GroovyScript groovyScript = + GroovyScript.builder("invoke") + .method("run") + .script(script) + .returnType(Integer.class) + .binds(Maps.of("request", Integer.class)) + .build(); + + long t1 = System.currentTimeMillis(); + int result = groovyScript.invoke(100); + long t2 = System.currentTimeMillis(); + System.out.println("groovy time:" + (t2 - t1)); + + assertEquals(100, result); + } + + @Test + void batchInvoke() { + int count = 100; + invoke(); + long t1 = System.currentTimeMillis(); + for (int i = 0; i < count; i++) { + invoke(); + } + long t2 = System.currentTimeMillis(); + System.out.println("total time:" + (t2 - t1)); + } +} \ No newline at end of file diff --git a/springboot-starter-script/src/test/java/com/codingapi/springboot/script/GroovyScriptRuntimeUnitTest.java b/springboot-starter-script/src/test/java/com/codingapi/springboot/script/GroovyScriptRuntimeUnitTest.java new file mode 100644 index 000000000..7e047aa1d --- /dev/null +++ b/springboot-starter-script/src/test/java/com/codingapi/springboot/script/GroovyScriptRuntimeUnitTest.java @@ -0,0 +1,208 @@ +package com.codingapi.springboot.script; + +import com.codingapi.springboot.framework.transaction.TransactionManagerContext; +import org.junit.jupiter.api.AfterEach; +import org.junit.jupiter.api.BeforeEach; +import org.junit.jupiter.api.Test; +import org.mockito.Mockito; +import org.springframework.transaction.PlatformTransactionManager; +import org.springframework.transaction.TransactionDefinition; +import org.springframework.transaction.TransactionStatus; + +import java.util.HashMap; +import java.util.Map; + +import static org.junit.jupiter.api.Assertions.assertEquals; +import static org.junit.jupiter.api.Assertions.assertNull; +import static org.mockito.ArgumentMatchers.any; + +/** + * GroovyScriptRuntime 单元测试 + * 覆盖编译缓存、LRU 淘汰、invoke/run 各重载以及事务模式分支 + */ +class GroovyScriptRuntimeUnitTest { + + private GroovyScriptRuntime runtime; + + private PlatformTransactionManager originalTransactionManager; + + @BeforeEach + void setUp() { + runtime = new GroovyScriptRuntime(10); + originalTransactionManager = TransactionManagerContext.getInstance().getPlatformTransactionManager(); + } + + @AfterEach + void tearDown() { + // 恢复事务管理器，避免影响其他测试 + TransactionManagerContext.getInstance().setPlatformTransactionManager(originalTransactionManager); + } + + private PlatformTransactionManager mockTransactionManager() { + PlatformTransactionManager txManager = Mockito.mock(PlatformTransactionManager.class); + TransactionStatus status = Mockito.mock(TransactionStatus.class); + Mockito.when(txManager.getTransaction(any(TransactionDefinition.class))).thenReturn(status); + TransactionManagerContext.getInstance().setPlatformTransactionManager(txManager); + return txManager; + } + + @Test + void maxCacheSizeShouldBeConstructorValue() { + assertEquals(10, runtime.getMaxCacheSize()); + } + + @Test + void compileWithoutCacheShouldNotStoreEntry() { + runtime.compile("return 1;", false); + runtime.compile("return 1;"); + assertEquals(0, runtime.cacheSize()); + } + + @Test + void compileWithCacheShouldReuseCompiledEntry() { + runtime.compile("return 1;", true); + assertEquals(1, runtime.cacheSize()); + // 相同脚本再次编译命中缓存，数量不变 + runtime.compile("return 1;", true); + assertEquals(1, runtime.cacheSize()); + // 不同脚本新增缓存 + runtime.compile("return 2;", true); + assertEquals(2, runtime.cacheSize()); + } + + @Test + void cacheShouldEvictEldestWhenOverMaxSize() { + GroovyScriptRuntime smallRuntime = new GroovyScriptRuntime(2); + smallRuntime.run("return 1;", Integer.class, TransactionMode.DEFAULT, null); + smallRuntime.run("return 2;", Integer.class, TransactionMode.DEFAULT, null); + smallRuntime.run("return 3;", Integer.class, TransactionMode.DEFAULT, null); + assertEquals(2, smallRuntime.cacheSize()); + } + + @Test + void clearCacheShouldRemoveAllCompiledScripts() { + runtime.compile("return 1;", true); + runtime.compile("return 2;", true); + assertEquals(2, runtime.cacheSize()); + + runtime.clearCache(); + assertEquals(0, runtime.cacheSize()); + } + + @Test + void invokeMethodWithArguments() { + String script = "def run(request){\n" + + " return request;\n" + + "}\n"; + Integer result = runtime.invoke("run", script, Integer.class, 100); + assertEquals(100, result); + } + + @Test + void invokeMethodWithBindsOverload() { + String script = "def run(request){\n" + + " return request + $base;\n" + + "}\n"; + Map binds = new HashMap<>(); + binds.put("$base", 100); + Integer result = runtime.invoke("run", script, Integer.class, binds, 23); + assertEquals(123, result); + } + + @Test + void invokeMethodWithDefaultTransactionModeAndBinds() { + // 脚本体本身即 run() 方法，不能再定义无参 run()（重复签名） + String script = "return $name;\n"; + Map binds = new HashMap<>(); + binds.put("$name", "hello"); + String result = runtime.invoke("run", script, String.class, TransactionMode.DEFAULT, binds); + assertEquals("hello", result); + } + + @Test + void invokeReadonlyShouldUseTransactionAndRollback() { + PlatformTransactionManager txManager = mockTransactionManager(); + String script = "def run(request){\n" + + " return request;\n" + + "}\n"; + + Integer result = runtime.invoke("run", script, Integer.class, TransactionMode.READONLY, null, 5); + assertEquals(5, result); + Mockito.verify(txManager).getTransaction(any(TransactionDefinition.class)); + // 只读模式执行完成后以回滚结束 + Mockito.verify(txManager).rollback(any(TransactionStatus.class)); + Mockito.verify(txManager, Mockito.never()).commit(any(TransactionStatus.class)); + } + + @Test + void invokeCommitShouldUseTransactionAndCommit() { + PlatformTransactionManager txManager = mockTransactionManager(); + String script = "def run(request){\n" + + " return request * 2;\n" + + "}\n"; + + Integer result = runtime.invoke("run", script, Integer.class, TransactionMode.COMMIT, null, 4); + assertEquals(8, result); + Mockito.verify(txManager).commit(any(TransactionStatus.class)); + Mockito.verify(txManager, Mockito.never()).rollback(any(TransactionStatus.class)); + } + + @Test + void runScriptWithBinds() { + String script = "return $x + 1;"; + Map binds = new HashMap<>(); + binds.put("$x", 41); + Integer result = runtime.run(script, Integer.class, binds); + assertEquals(42, result); + } + + @Test + void runScriptWithoutBindsReturnsNullSafely() { + String script = "return 7;"; + Integer result = runtime.run(script, Integer.class, TransactionMode.DEFAULT, null); + assertEquals(7, result); + // binds 为空 Map 同样安全 + Integer result2 = runtime.run(script, Integer.class, TransactionMode.DEFAULT, new HashMap<>()); + assertEquals(7, result2); + } + + @Test + void runReadonlyShouldUseTransactionAndRollback() { + PlatformTransactionManager txManager = mockTransactionManager(); + + Integer result = runtime.run("return 9;", Integer.class, TransactionMode.READONLY, null); + assertEquals(9, result); + Mockito.verify(txManager).rollback(any(TransactionStatus.class)); + Mockito.verify(txManager, Mockito.never()).commit(any(TransactionStatus.class)); + } + + @Test + void runCommitShouldUseTransactionAndCommit() { + PlatformTransactionManager txManager = mockTransactionManager(); + + Integer result = runtime.run("return 9;", Integer.class, TransactionMode.COMMIT, null); + assertEquals(9, result); + Mockito.verify(txManager).commit(any(TransactionStatus.class)); + Mockito.verify(txManager, Mockito.never()).rollback(any(TransactionStatus.class)); + } + + @Test + void runShouldReuseCachedScriptInstance() { + String script = "return 3;"; + Integer first = runtime.run(script, Integer.class, TransactionMode.DEFAULT, null); + assertEquals(3, first); + assertEquals(1, runtime.cacheSize()); + + Integer second = runtime.run(script, Integer.class, TransactionMode.DEFAULT, null); + assertEquals(3, second); + assertEquals(1, runtime.cacheSize()); + } + + @Test + void invokeResultCanBeNull() { + // 脚本体本身即 run() 方法，不能再定义无参 run()（重复签名） + String script = "return null;\n"; + Object result = runtime.invoke("run", script, Object.class); + assertNull(result); + } +} diff --git a/springboot-starter-script/src/test/java/com/codingapi/springboot/script/GroovyScriptTest.java b/springboot-starter-script/src/test/java/com/codingapi/springboot/script/GroovyScriptTest.java new file mode 100644 index 000000000..63bbb90f9 --- /dev/null +++ b/springboot-starter-script/src/test/java/com/codingapi/springboot/script/GroovyScriptTest.java @@ -0,0 +1,215 @@ +package com.codingapi.springboot.script; + +import com.codingapi.springboot.script.meta.GroovyMetadata; +import com.codingapi.springboot.script.repository.GroovyScriptRepositoryContext; +import com.codingapi.springboot.script.temp.TempGroovyScriptContext; +import org.junit.jupiter.api.AfterEach; +import org.junit.jupiter.api.BeforeEach; +import org.junit.jupiter.api.Test; + +import java.util.HashMap; +import java.util.Map; + +import static org.junit.jupiter.api.Assertions.assertEquals; +import static org.junit.jupiter.api.Assertions.assertNotNull; +import static org.junit.jupiter.api.Assertions.assertNull; +import static org.junit.jupiter.api.Assertions.assertSame; +import static org.junit.jupiter.api.Assertions.assertTrue; + +/** + * GroovyScript 单元测试 + * 覆盖 Builder 全字段、copy、temp/save/remove 生命周期以及 run/invoke 各重载 + */ +class GroovyScriptTest { + + @BeforeEach + void setUp() { + TempGroovyScriptContext.getInstance().clear(); + } + + @AfterEach + void tearDown() { + TempGroovyScriptContext.getInstance().clear(); + GroovyScriptRepositoryContext.getInstance().delete("lifecycle-key"); + } + + @Test + void builderShouldSetAllFields() { + Map> binds = new HashMap<>(); + binds.put("$x", Integer.class); + Map> requests = new HashMap<>(); + requests.put("request", String.class); + + long before = System.currentTimeMillis(); + GroovyScript script = GroovyScript.builder("builder-key") + .script("return 1;") + .description("desc") + .method("run") + .returnType(Integer.class) + .binds(binds) + .requests(requests) + .typeOne("one") + .typeTwo("two") + .tag("tag") + .remark("remark") + .build(); + + assertEquals("builder-key", script.getKey()); + assertEquals("return 1;", script.getScript()); + assertEquals("desc", script.getDescription()); + assertEquals("run", script.getMethod()); + assertEquals(Integer.class, script.getReturnType()); + assertSame(binds, script.getBinds()); + assertSame(requests, script.getRequests()); + assertEquals("one", script.getTypeOne()); + assertEquals("two", script.getTypeTwo()); + assertEquals("tag", script.getTag()); + assertEquals("remark", script.getRemark()); + assertTrue(script.getCreateTime() >= before); + assertEquals(0, script.getUpdateTime()); + } + + @Test + void singleArgConstructorShouldOnlySetKeyAndCreateTime() { + GroovyScript script = new GroovyScript("ctor-key"); + assertEquals("ctor-key", script.getKey()); + assertTrue(script.getCreateTime() > 0); + assertNull(script.getScript()); + } + + @Test + void copyShouldKeepAllFieldsWithNewKey() { + Map> binds = new HashMap<>(); + binds.put("$x", Integer.class); + + GroovyScript origin = GroovyScript.builder("origin-key") + .script("return 1;") + .description("desc") + .method("run") + .returnType(Integer.class) + .binds(binds) + .typeOne("one") + .typeTwo("two") + .tag("tag") + .remark("remark") + .build(); + origin.setUpdateTime(123L); + + GroovyScript copy = origin.copy("copy-key"); + + assertEquals("copy-key", copy.getKey()); + assertEquals(origin.getScript(), copy.getScript()); + assertEquals(origin.getDescription(), copy.getDescription()); + assertEquals(origin.getMethod(), copy.getMethod()); + assertEquals(origin.getReturnType(), copy.getReturnType()); + assertSame(origin.getBinds(), copy.getBinds()); + assertEquals(origin.getTypeOne(), copy.getTypeOne()); + assertEquals(origin.getTypeTwo(), copy.getTypeTwo()); + assertEquals(origin.getTag(), copy.getTag()); + assertEquals(origin.getRemark(), copy.getRemark()); + assertEquals(origin.getCreateTime(), copy.getCreateTime()); + assertEquals(origin.getUpdateTime(), copy.getUpdateTime()); + } + + @Test + void tempSaveRemoveLifecycle() { + GroovyScript script = GroovyScript.builder("lifecycle-key") + .script("return 1;") + .build(); + + // 临时存储 + script.temp(); + assertNotNull(TempGroovyScriptContext.getInstance().getGroovyScript("lifecycle-key")); + + // 保存后进入仓储，临时数据被清理 + script.save(); + assertTrue(script.getUpdateTime() > 0); + assertSame(script, GroovyScriptRepositoryContext.getInstance().get("lifecycle-key")); + assertNull(TempGroovyScriptContext.getInstance().getGroovyScript("lifecycle-key")); + + // 删除后仓储与临时均无数据 + script.remove(); + assertNull(GroovyScriptRepositoryContext.getInstance().get("lifecycle-key")); + assertNull(TempGroovyScriptContext.getInstance().getGroovyScript("lifecycle-key")); + } + + @Test + void runOverloads() { + GroovyScript plain = GroovyScript.builder("run-key") + .script("return 7;") + .returnType(Integer.class) + .build(); + + assertEquals(Integer.valueOf(7), plain.run()); + assertEquals(Integer.valueOf(7), plain.run(TransactionMode.DEFAULT)); + + GroovyScript bound = GroovyScript.builder("run-bind-key") + .script("return $x + 1;") + .returnType(Integer.class) + .build(); + Map binds = new HashMap<>(); + binds.put("$x", 41); + assertEquals(Integer.valueOf(42), bound.run(binds)); + assertEquals(Integer.valueOf(42), bound.run(TransactionMode.DEFAULT, binds)); + } + + @Test + void invokeOverloads() { + String script = "def run(request){\n" + + " return request + offset;\n" + + "}\n"; + GroovyScript groovyScript = GroovyScript.builder("invoke-key") + .script(script) + .method("run") + .returnType(Integer.class) + .build(); + + // invoke(requests...) + Map binds = new HashMap<>(); + binds.put("offset", 0); + assertEquals(Integer.valueOf(10), groovyScript.invoke(binds, 10)); + // invoke(transactionMode, requests...) + assertEquals(Integer.valueOf(11), groovyScript.invoke(TransactionMode.DEFAULT, binds, 11)); + // invoke(transactionMode, binds, requests...) + assertEquals(Integer.valueOf(12), + groovyScript.invoke(TransactionMode.DEFAULT, binds, 12)); + + // 无参数函数：脚本体本身即 run() 方法，不能再定义无参 run()（重复签名） + String noArgScript = "return 99;\n"; + GroovyScript noArg = GroovyScript.builder("invoke-noarg-key") + .script(noArgScript) + .method("run") + .returnType(Integer.class) + .build(); + assertEquals(Integer.valueOf(99), noArg.invoke()); + assertEquals(Integer.valueOf(99), noArg.invoke(TransactionMode.DEFAULT)); + } + + @Test + void compileShouldDelegateToRuntimeContext() { + GroovyScript script = GroovyScript.builder("compile-key") + .script("return 5;") + .build(); + + script.compile(); + script.compile(true); + assertTrue(GroovyScriptRuntimeContext.getInstance().cacheSize() >= 1); + GroovyScriptRuntimeContext.getInstance().clearCache(); + } + + @Test + void toMetadataShouldReturnScannedMetadata() { + GroovyScript script = GroovyScript.builder("meta-key") + .script("return 1;") + .description("desc") + .method("run") + .returnType(Integer.class) + .build(); + + GroovyMetadata metadata = script.toMetadata(); + assertNotNull(metadata); + assertEquals("run", metadata.getMainMethod()); + assertEquals("Integer", metadata.getReturnType()); + assertEquals("desc", metadata.getDescription()); + } +} diff --git a/springboot-starter-script/src/test/java/com/codingapi/springboot/script/GroovyStrategyTest.java b/springboot-starter-script/src/test/java/com/codingapi/springboot/script/GroovyStrategyTest.java new file mode 100644 index 000000000..8965d75b6 --- /dev/null +++ b/springboot-starter-script/src/test/java/com/codingapi/springboot/script/GroovyStrategyTest.java @@ -0,0 +1,134 @@ +package com.codingapi.springboot.script; + +import com.alibaba.fastjson.JSON; +import com.codingapi.springboot.script.meta.GroovyFunction; +import com.codingapi.springboot.script.meta.GroovyMetadata; +import com.codingapi.springboot.script.meta.GroovyType; +import com.codingapi.springboot.script.request.MyScriptRequest; +import com.codingapi.springboot.script.strategy.*; +import org.apache.groovy.util.Maps; +import org.junit.jupiter.api.AfterEach; +import org.junit.jupiter.api.BeforeEach; +import org.junit.jupiter.api.Test; + +import static org.junit.jupiter.api.Assertions.assertEquals; + +public class GroovyStrategyTest { + + + @BeforeEach + void beforeRun(){ + GroovyMetadataGenerateStrategyContext.getInstance().clear(); + GroovyTypeFixStrategyContext.getInstance().clear(); + ScriptTypeMappingContext.getInstance().clear(); + } + + @AfterEach + void afterRun(){ + // 避免自定义策略泄漏到其他测试类（跨类共享单例上下文） + GroovyMetadataGenerateStrategyContext.getInstance().clear(); + GroovyTypeFixStrategyContext.getInstance().clear(); + ScriptTypeMappingContext.getInstance().clear(); + } + + @Test + void test1(){ + String script = "def run(request){return request.count;}"; + + ScriptTypeMappingContext.getInstance().addMapping(new ScriptTypeMapping() { + @Override + public boolean support(Class target) { + return Integer.class.equals(target); + } + + @Override + public Class mapping(Class target) { + return int.class; + } + }); + + + GroovyTypeFixStrategyContext.getInstance().addFixStrategy(new GroovyTypeFixStrategy() { + @Override + public boolean support(Class clazz) { + return MyScriptRequest.class.equals(clazz); + } + + @Override + public void fix(GroovyScript groovyScript, GroovyType groovyType) { + GroovyFunction groovyFunction = new GroovyFunction(); + groovyFunction.setReturnType("int"); + groovyFunction.setName("hi"); + groovyFunction.setDescription("测试"); + groovyType.addFunction(groovyFunction); + } + }); + + + GroovyScript groovyScript = + GroovyScript.builder("metaTest") + .script(script) + .description("这是一个run函数，返回的格式为int类型。") + .method("run") + .tag("123") + .returnType(Integer.class) + .requests(Maps.of("request", MyScriptRequest.class)) + .build(); + + GroovyMetadata metadata = groovyScript.toMetadata(); + System.out.println(JSON.toJSONString(metadata)); + assertEquals(1, metadata.getRequests().size()); + assertEquals("int",metadata.getReturnType()); + assertEquals(3,metadata.getType("MyScriptRequest").getFunctions().size()); + + MyScriptRequest request = new MyScriptRequest(100); + long t1 = System.currentTimeMillis(); + int result = groovyScript.invoke(request); + long t2 = System.currentTimeMillis(); + System.out.println("groovy time:" + (t2 - t1)); + assertEquals(100, result); + } + + + + @Test + void test2(){ + String script = "def run(request){return request.count;}"; + + GroovyMetadataGenerateStrategyContext.getInstance().addGenerateStrategy(new GroovyMetadataGenerateStrategy() { + @Override + public boolean support(GroovyScript script) { + return true; + } + + @Override + public GroovyMetadata generate(GroovyScript script) { + return new GroovyMetadata("hello","int","hello"); + } + }); + + + GroovyScript groovyScript = + GroovyScript.builder("metaTest") + .script(script) + .description("这是一个run函数，返回的格式为int类型。") + .method("run") + .tag("123") + .returnType(Integer.class) + .requests(Maps.of("request", MyScriptRequest.class)) + .build(); + + GroovyMetadata metadata = groovyScript.toMetadata(); + System.out.println(JSON.toJSONString(metadata)); + assertEquals("int",metadata.getReturnType()); + assertEquals("hello",metadata.getDescription()); + assertEquals("hello",metadata.getMainMethod()); + + MyScriptRequest request = new MyScriptRequest(100); + long t1 = System.currentTimeMillis(); + int result = groovyScript.invoke(request); + long t2 = System.currentTimeMillis(); + System.out.println("groovy time:" + (t2 - t1)); + assertEquals(100, result); + } +} diff --git a/springboot-starter-id-generator/src/test/java/com/codingapi/springboot/generator/IdGeneratorApplication.java b/springboot-starter-script/src/test/java/com/codingapi/springboot/script/TestApplication.java similarity index 57% rename from springboot-starter-id-generator/src/test/java/com/codingapi/springboot/generator/IdGeneratorApplication.java rename to springboot-starter-script/src/test/java/com/codingapi/springboot/script/TestApplication.java index d79796153..99600f422 100644 --- a/springboot-starter-id-generator/src/test/java/com/codingapi/springboot/generator/IdGeneratorApplication.java +++ b/springboot-starter-script/src/test/java/com/codingapi/springboot/script/TestApplication.java @@ -1,12 +1,13 @@ -package com.codingapi.springboot.generator; +package com.codingapi.springboot.script; + import org.springframework.boot.SpringApplication; import org.springframework.boot.autoconfigure.SpringBootApplication; @SpringBootApplication -public class IdGeneratorApplication { +public class TestApplication { public static void main(String[] args) { - SpringApplication.run(IdGeneratorApplication.class, args); + SpringApplication.run(TestApplication.class,args); } } diff --git a/springboot-starter-script/src/test/java/com/codingapi/springboot/script/TransactionGroovyScriptRuntimeContextTest.java b/springboot-starter-script/src/test/java/com/codingapi/springboot/script/TransactionGroovyScriptRuntimeContextTest.java new file mode 100644 index 000000000..bdf134012 --- /dev/null +++ b/springboot-starter-script/src/test/java/com/codingapi/springboot/script/TransactionGroovyScriptRuntimeContextTest.java @@ -0,0 +1,98 @@ +package com.codingapi.springboot.script; + +import com.codingapi.springboot.script.entity.MyTest; +import com.codingapi.springboot.script.repository.MyTestRepository; +import com.codingapi.springboot.script.request.MyScriptRequest; +import com.codingapi.springboot.script.strategy.GroovyMetadataGenerateStrategyContext; +import com.codingapi.springboot.script.strategy.GroovyTypeFixStrategyContext; +import com.codingapi.springboot.script.strategy.ScriptTypeMappingContext; +import org.apache.groovy.util.Maps; +import org.junit.jupiter.api.BeforeEach; +import org.junit.jupiter.api.Test; +import org.springframework.beans.factory.annotation.Autowired; +import org.springframework.boot.test.context.SpringBootTest; +import org.springframework.transaction.annotation.Transactional; + +import java.util.List; + +import static org.junit.jupiter.api.Assertions.assertFalse; +import static org.junit.jupiter.api.Assertions.assertTrue; + +@SpringBootTest +@Transactional +class TransactionGroovyScriptRuntimeContextTest { + + @Autowired + private MyTestRepository myTestRepository; + + @BeforeEach + void beforeRun(){ + GroovyMetadataGenerateStrategyContext.getInstance().clear(); + GroovyTypeFixStrategyContext.getInstance().clear(); + ScriptTypeMappingContext.getInstance().clear(); + } + + @Test + void transactionCommitRun() { + + String script = " def run(request){ request.addData($repository); println(request.count); } "; + + MyScriptRequest request = new MyScriptRequest(100); + + myTestRepository.deleteAll(); + List list = myTestRepository.findAll(); + assertTrue(list.isEmpty()); + + GroovyScript groovyScript = + GroovyScript.builder("transactionCommitRun") + .script(script) + .method("run") + .returnType(Void.class) + .binds(Maps.of("$repository", myTestRepository.getClass())) + .requests(Maps.of("request", request.getClass())) + .build(); + + long t1 = System.currentTimeMillis(); + groovyScript.invoke(TransactionMode.COMMIT, Maps.of("$repository", myTestRepository), request); + long t2 = System.currentTimeMillis(); + System.out.println("groovy time:" + (t2 - t1)); + + list = myTestRepository.findAll(); + assertFalse(list.isEmpty()); + + } + + @Test + void transactionOnlyReadRun() { + + String script = " def run(request){ request.addData($repository); println(request.count); } "; + + MyScriptRequest request = new MyScriptRequest(100); + + + myTestRepository.deleteAll(); + List list = myTestRepository.findAll(); + assertTrue(list.isEmpty()); + + GroovyScript groovyScript = + GroovyScript.builder("transactionOnlyReadRun") + .script(script) + .method("run") + .returnType(Void.class) + .binds(Maps.of("$repository", myTestRepository.getClass())) + .requests(Maps.of("request", request.getClass())) + .build(); + + + long t1 = System.currentTimeMillis(); + groovyScript.invoke(TransactionMode.READONLY, Maps.of("$repository", myTestRepository), request); + long t2 = System.currentTimeMillis(); + System.out.println("groovy time:" + (t2 - t1)); + + list = myTestRepository.findAll(); + System.out.println(list.size()); + assertTrue(list.isEmpty()); + + } + +} \ No newline at end of file diff --git a/springboot-starter-script/src/test/java/com/codingapi/springboot/script/cache/GroovyScriptCacheContextTest.java b/springboot-starter-script/src/test/java/com/codingapi/springboot/script/cache/GroovyScriptCacheContextTest.java new file mode 100644 index 000000000..14abcb67c --- /dev/null +++ b/springboot-starter-script/src/test/java/com/codingapi/springboot/script/cache/GroovyScriptCacheContextTest.java @@ -0,0 +1,184 @@ +package com.codingapi.springboot.script.cache; + +import com.codingapi.springboot.script.GroovyScript; +import com.codingapi.springboot.script.meta.GroovyMetadata; +import com.codingapi.springboot.script.repository.GroovyScriptRepositoryContext; +import com.codingapi.springboot.script.temp.TempGroovyScriptContext; +import org.junit.jupiter.api.AfterEach; +import org.junit.jupiter.api.BeforeEach; +import org.junit.jupiter.api.Test; + +import java.util.ArrayList; +import java.util.List; + +import static org.junit.jupiter.api.Assertions.assertEquals; +import static org.junit.jupiter.api.Assertions.assertNotNull; +import static org.junit.jupiter.api.Assertions.assertNull; +import static org.junit.jupiter.api.Assertions.assertSame; +import static org.junit.jupiter.api.Assertions.assertTrue; + +/** + * GroovyScriptCacheContext 单元测试 + * 覆盖 LRU 缓存的存取、回源（临时缓存/仓储）、批量加载、编译与淘汰逻辑 + */ +class GroovyScriptCacheContextTest { + + private final GroovyScriptCacheContext context = GroovyScriptCacheContext.getInstance(); + + private GroovyScript script(String key) { + return GroovyScript.builder(key) + .script("return 1;") + .description("desc-" + key) + .method("run") + .returnType(Integer.class) + .build(); + } + + @BeforeEach + void setUp() { + context.clear(); + TempGroovyScriptContext.getInstance().clear(); + } + + @AfterEach + void tearDown() { + context.clear(); + TempGroovyScriptContext.getInstance().clear(); + // 清理回源测试写入仓储的数据 + GroovyScriptRepositoryContext.getInstance().delete("cache-repo-key"); + GroovyScriptRepositoryContext.getInstance().delete("cache-save-key"); + } + + @Test + void saveAndCacheShouldPutScriptIntoCache() { + GroovyScript s1 = script("cache-key-1"); + GroovyScript s2 = script("cache-key-2"); + + context.save(s1); + context.cache(s2); + // null 入参直接忽略 + context.save(null); + context.cache(null); + + assertEquals(2, context.count()); + List keys = context.keys(); + assertEquals(2, keys.size()); + assertTrue(keys.contains("cache-key-1")); + assertTrue(keys.contains("cache-key-2")); + assertSame(s1, context.getGroovyScript("cache-key-1")); + } + + @Test + void removeShouldDeleteExistingKeyAndIgnoreMissingKey() { + context.save(script("cache-remove-key")); + assertEquals(1, context.count()); + + context.remove("cache-remove-key"); + assertEquals(0, context.count()); + + // 删除不存在的key不抛异常 + context.remove("cache-remove-key-missing"); + assertEquals(0, context.count()); + } + + @Test + void getGroovyScriptShouldFallbackToTempContextWithoutCaching() { + GroovyScript tempScript = script("cache-temp-key"); + TempGroovyScriptContext.getInstance().save(tempScript); + + GroovyScript result = context.getGroovyScript("cache-temp-key"); + assertSame(tempScript, result); + // 临时数据不回写到缓存 + assertEquals(0, context.count()); + } + + @Test + void getGroovyScriptShouldFallbackToRepositoryAndCacheResult() { + GroovyScript repoScript = script("cache-repo-key"); + GroovyScriptRepositoryContext.getInstance().save(repoScript); + + GroovyScript result = context.getGroovyScript("cache-repo-key"); + assertSame(repoScript, result); + // 仓储数据会回写到缓存 + assertEquals(1, context.count()); + + // 再次获取直接命中缓存 + assertSame(repoScript, context.getGroovyScript("cache-repo-key")); + } + + @Test + void getGroovyScriptShouldReturnNullWhenMissingEverywhere() { + assertNull(context.getGroovyScript("cache-no-such-key")); + } + + @Test + void getGroovyMetadataShouldReturnMetadataOrNull() { + context.save(script("cache-meta-key")); + GroovyMetadata metadata = context.getGroovyMetadata("cache-meta-key"); + assertNotNull(metadata); + assertEquals("run", metadata.getMainMethod()); + assertEquals("Integer", metadata.getReturnType()); + + assertNull(context.getGroovyMetadata("cache-no-such-key")); + } + + @Test + void getScriptShouldReturnContentOrEmptyString() { + context.save(script("cache-script-key")); + assertEquals("return 1;", context.getScript("cache-script-key")); + assertEquals("", context.getScript("cache-no-such-key")); + } + + @Test + void setBatchCacheShouldIgnoreNullListAndNullElements() { + context.setBatchCache(null); + assertEquals(0, context.count()); + + List list = new ArrayList<>(); + list.add(script("cache-batch-1")); + list.add(null); + list.add(script("cache-batch-2")); + context.setBatchCache(list); + + assertEquals(2, context.count()); + assertNotNull(context.getGroovyScript("cache-batch-1")); + assertNotNull(context.getGroovyScript("cache-batch-2")); + } + + @Test + void compileAllShouldCompileEveryCachedScript() { + context.save(script("cache-compile-1")); + context.save(script("cache-compile-2")); + + // 非缓存模式编译全部脚本 + context.compileAll(false); + assertEquals(2, context.count()); + } + + @Test + void lruCacheShouldEvictEldestEntryWhenOverMaxSize() { + // MAX_CACHE_SIZE = 10 * 1024，写入超出一条即触发 LRU 淘汰 + int total = 10 * 1024 + 1; + for (int i = 0; i < total; i++) { + context.save(GroovyScript.builder("cache-lru-" + i).script("return 1;").build()); + } + + assertEquals(10 * 1024, context.count()); + // 最早写入的被淘汰（缓存/临时/仓储均无，返回 null） + assertNull(context.getGroovyScript("cache-lru-0")); + // 其后写入的仍然存在 + assertNotNull(context.getGroovyScript("cache-lru-1")); + assertEquals(10 * 1024, context.count()); + } + + @Test + void clearShouldRemoveAllEntries() { + context.save(script("cache-clear-1")); + context.save(script("cache-clear-2")); + assertEquals(2, context.count()); + + context.clear(); + assertEquals(0, context.count()); + assertTrue(context.keys().isEmpty()); + } +} diff --git a/springboot-starter-script/src/test/java/com/codingapi/springboot/script/controller/GroovyScriptControllerTest.java b/springboot-starter-script/src/test/java/com/codingapi/springboot/script/controller/GroovyScriptControllerTest.java new file mode 100644 index 000000000..85d9677bf --- /dev/null +++ b/springboot-starter-script/src/test/java/com/codingapi/springboot/script/controller/GroovyScriptControllerTest.java @@ -0,0 +1,184 @@ +package com.codingapi.springboot.script.controller; + +import com.codingapi.springboot.framework.dto.response.Response; +import com.codingapi.springboot.framework.dto.response.SingleResponse; +import com.codingapi.springboot.framework.exception.LocaleMessageException; +import com.codingapi.springboot.script.GroovyScript; +import com.codingapi.springboot.script.GroovyScriptRuntimeContext; +import com.codingapi.springboot.script.cache.GroovyScriptCacheContext; +import com.codingapi.springboot.script.meta.GroovyMetadata; +import com.codingapi.springboot.script.pojo.ScriptCompileRequest; +import com.codingapi.springboot.script.pojo.ScriptSaveRequest; +import com.codingapi.springboot.script.repository.GroovyScriptRepositoryContext; +import com.codingapi.springboot.script.temp.TempGroovyScriptContext; +import org.junit.jupiter.api.AfterEach; +import org.junit.jupiter.api.BeforeEach; +import org.junit.jupiter.api.Test; + +import static org.junit.jupiter.api.Assertions.assertEquals; +import static org.junit.jupiter.api.Assertions.assertNotNull; +import static org.junit.jupiter.api.Assertions.assertThrows; +import static org.junit.jupiter.api.Assertions.assertTrue; + +/** + * GroovyScriptController 单元测试 + * 直接调用 Controller 方法，覆盖编译/查询/保存 REST 接口逻辑 + */ +class GroovyScriptControllerTest { + + private final GroovyScriptController controller = new GroovyScriptController(); + + private GroovyScript script(String key, String content) { + return GroovyScript.builder(key) + .script(content) + .description("desc-" + key) + .method("run") + .returnType(Integer.class) + .build(); + } + + @BeforeEach + void setUp() { + GroovyScriptCacheContext.getInstance().clear(); + TempGroovyScriptContext.getInstance().clear(); + GroovyScriptRuntimeContext.getInstance().clearCache(); + // 防御其他测试类泄漏的全局元数据策略 + com.codingapi.springboot.script.strategy.GroovyMetadataGenerateStrategyContext.getInstance().clear(); + } + + @AfterEach + void tearDown() { + GroovyScriptCacheContext.getInstance().clear(); + TempGroovyScriptContext.getInstance().clear(); + GroovyScriptRuntimeContext.getInstance().clearCache(); + GroovyScriptRepositoryContext.getInstance().delete("ctrl-save-key"); + GroovyScriptRepositoryContext.getInstance().delete("ctrl-repo-save-key"); + } + + @Test + void compileSuccessWithoutCache() { + ScriptCompileRequest request = new ScriptCompileRequest(); + request.setScript("return 1;"); + request.setCache(false); + + Response response = controller.compile(request); + assertTrue(response.isSuccess()); + } + + @Test + void compileSuccessWithCache() { + ScriptCompileRequest request = new ScriptCompileRequest(); + request.setScript("return 2;"); + request.setCache(true); + + Response response = controller.compile(request); + assertTrue(response.isSuccess()); + assertEquals(1, GroovyScriptRuntimeContext.getInstance().cacheSize()); + } + + @Test + void compileFailureShouldThrowCompileErrorException() { + ScriptCompileRequest request = new ScriptCompileRequest(); + request.setScript("def {{{"); + request.setCache(false); + + LocaleMessageException exception = + assertThrows(LocaleMessageException.class, () -> controller.compile(request)); + assertEquals("script.compile.error", exception.getErrCode()); + assertTrue(exception.getErrMessage().contains("脚本编译异常")); + } + + @Test + void getScriptShouldReturnContentWhenScriptExists() { + GroovyScriptCacheContext.getInstance().save(script("ctrl-get-key", "return 3;")); + + SingleResponse response = controller.getScript("ctrl-get-key"); + assertTrue(response.isSuccess()); + assertEquals("return 3;", response.getData()); + } + + @Test + void getScriptShouldThrowWhenScriptMissing() { + LocaleMessageException exception = + assertThrows(LocaleMessageException.class, () -> controller.getScript("ctrl-no-such-key")); + assertEquals("script.null", exception.getErrCode()); + } + + @Test + void getMetadataShouldReturnMetadataWhenScriptExists() { + GroovyScriptCacheContext.getInstance().save(script("ctrl-meta-key", "return 4;")); + + SingleResponse response = controller.getMetadata("ctrl-meta-key"); + assertTrue(response.isSuccess()); + assertNotNull(response.getData()); + assertEquals("run", response.getData().getMainMethod()); + assertEquals("Integer", response.getData().getReturnType()); + } + + @Test + void getMetadataShouldThrowWhenScriptMissing() { + LocaleMessageException exception = + assertThrows(LocaleMessageException.class, () -> controller.getMetadata("ctrl-no-such-key")); + assertEquals("script.null", exception.getErrCode()); + } + + @Test + void saveShouldUpdateTempScript() { + GroovyScript tempScript = script("ctrl-save-key", "return 1;"); + tempScript.temp(); + + ScriptSaveRequest request = new ScriptSaveRequest(); + request.setKey("ctrl-save-key"); + request.setScript("return 10;"); + + Response response = controller.save(request); + assertTrue(response.isSuccess()); + assertEquals("return 10;", + TempGroovyScriptContext.getInstance().getGroovyScript("ctrl-save-key").getScript()); + } + + @Test + void saveShouldUpdatePersistentScriptWhenNotInTemp() { + // 仅存在于仓储中的脚本（经由缓存上下文回源获取） + GroovyScriptRepositoryContext.getInstance().save(script("ctrl-repo-save-key", "return 1;")); + + ScriptSaveRequest request = new ScriptSaveRequest(); + request.setKey("ctrl-repo-save-key"); + request.setScript("return 20;"); + + Response response = controller.save(request); + assertTrue(response.isSuccess()); + + GroovyScript saved = GroovyScriptRepositoryContext.getInstance().get("ctrl-repo-save-key"); + assertNotNull(saved); + assertEquals("return 20;", saved.getScript()); + assertTrue(saved.getUpdateTime() > 0); + } + + @Test + void saveShouldThrowWhenScriptMissing() { + ScriptSaveRequest request = new ScriptSaveRequest(); + request.setKey("ctrl-no-such-key"); + request.setScript("return 30;"); + + // 注意：源码中 script.null 异常被外层 catch 捕获后重新包装为 script.compile.error + LocaleMessageException exception = + assertThrows(LocaleMessageException.class, () -> controller.save(request)); + assertEquals("script.compile.error", exception.getErrCode()); + assertTrue(exception.getErrMessage().contains("脚本对象不存在")); + } + + @Test + void saveShouldThrowCompileErrorWhenNewScriptInvalid() { + GroovyScript tempScript = script("ctrl-save-key", "return 1;"); + tempScript.temp(); + + ScriptSaveRequest request = new ScriptSaveRequest(); + request.setKey("ctrl-save-key"); + request.setScript("def {{{"); + + LocaleMessageException exception = + assertThrows(LocaleMessageException.class, () -> controller.save(request)); + assertEquals("script.compile.error", exception.getErrCode()); + } +} diff --git a/springboot-starter-script/src/test/java/com/codingapi/springboot/script/entity/MyTest.java b/springboot-starter-script/src/test/java/com/codingapi/springboot/script/entity/MyTest.java new file mode 100644 index 000000000..417c0d17e --- /dev/null +++ b/springboot-starter-script/src/test/java/com/codingapi/springboot/script/entity/MyTest.java @@ -0,0 +1,23 @@ +package com.codingapi.springboot.script.entity; + +import com.codingapi.springboot.script.annotation.ScriptField; +import com.codingapi.springboot.script.annotation.ScriptType; +import javax.persistence.Entity; +import javax.persistence.GeneratedValue; +import javax.persistence.GenerationType; +import javax.persistence.Id; +import lombok.Data; + +@Data +@Entity +@ScriptType(description = "test") +public class MyTest { + + @Id + @GeneratedValue(strategy = GenerationType.IDENTITY) + @ScriptField(name = "id", description = "id") + private Long id; + + @ScriptField(name = "name", description = "name") + private String name; +} diff --git a/springboot-starter-script/src/test/java/com/codingapi/springboot/script/repository/GroovyScriptRepositoryContextTest.java b/springboot-starter-script/src/test/java/com/codingapi/springboot/script/repository/GroovyScriptRepositoryContextTest.java new file mode 100644 index 000000000..304c83163 --- /dev/null +++ b/springboot-starter-script/src/test/java/com/codingapi/springboot/script/repository/GroovyScriptRepositoryContextTest.java @@ -0,0 +1,70 @@ +package com.codingapi.springboot.script.repository; + +import com.codingapi.springboot.script.GroovyScript; +import com.codingapi.springboot.script.repository.impl.DefaultGroovyScriptRepository; +import org.junit.jupiter.api.AfterEach; +import org.junit.jupiter.api.Test; +import org.mockito.Mockito; + +import static org.junit.jupiter.api.Assertions.assertNotNull; +import static org.junit.jupiter.api.Assertions.assertNull; +import static org.junit.jupiter.api.Assertions.assertSame; +import static org.mockito.Mockito.verify; + +/** + * GroovyScriptRepositoryContext 与 DefaultGroovyScriptRepository 单元测试 + */ +class GroovyScriptRepositoryContextTest { + + private final GroovyScriptRepositoryContext context = GroovyScriptRepositoryContext.getInstance(); + + @AfterEach + void tearDown() { + // 恢复默认仓储实现，避免 mock 泄漏到其他测试 + context.setGroovyScriptRepository(new DefaultGroovyScriptRepository()); + } + + private GroovyScript script(String key) { + return GroovyScript.builder(key).script("return 1;").build(); + } + + @Test + void defaultRepositoryShouldSupportSaveGetDelete() { + context.save(script("repo-key-1")); + + GroovyScript result = context.get("repo-key-1"); + assertNotNull(result); + assertSame("repo-key-1", result.getKey()); + + context.delete("repo-key-1"); + assertNull(context.get("repo-key-1")); + // 删除不存在的key不抛异常 + context.delete("repo-key-missing"); + } + + @Test + void instanceShouldBeSingletonWithDefaultRepository() { + assertSame(context, GroovyScriptRepositoryContext.getInstance()); + // 默认仓储可用：保存后可读取 + context.save(script("repo-default-key")); + assertNotNull(context.get("repo-default-key")); + context.delete("repo-default-key"); + } + + @Test + void contextShouldDelegateToCustomRepository() { + GroovyScriptRepository mockRepository = Mockito.mock(GroovyScriptRepository.class); + GroovyScript groovyScript = script("repo-mock-key"); + Mockito.when(mockRepository.get("repo-mock-key")).thenReturn(groovyScript); + + context.setGroovyScriptRepository(mockRepository); + + context.save(groovyScript); + assertSame(groovyScript, context.get("repo-mock-key")); + context.delete("repo-mock-key"); + + verify(mockRepository).save(groovyScript); + verify(mockRepository).get("repo-mock-key"); + verify(mockRepository).delete("repo-mock-key"); + } +} diff --git a/springboot-starter-script/src/test/java/com/codingapi/springboot/script/repository/MyTestRepository.java b/springboot-starter-script/src/test/java/com/codingapi/springboot/script/repository/MyTestRepository.java new file mode 100644 index 000000000..642ca4cc7 --- /dev/null +++ b/springboot-starter-script/src/test/java/com/codingapi/springboot/script/repository/MyTestRepository.java @@ -0,0 +1,10 @@ +package com.codingapi.springboot.script.repository; + +import com.codingapi.springboot.script.entity.MyTest; +import org.springframework.data.jpa.repository.JpaRepository; +import org.springframework.stereotype.Repository; + +@Repository +public interface MyTestRepository extends JpaRepository { + +} diff --git a/springboot-starter-script/src/test/java/com/codingapi/springboot/script/repository/TempGroovyScriptRepositoryContextTest.java b/springboot-starter-script/src/test/java/com/codingapi/springboot/script/repository/TempGroovyScriptRepositoryContextTest.java new file mode 100644 index 000000000..becee0430 --- /dev/null +++ b/springboot-starter-script/src/test/java/com/codingapi/springboot/script/repository/TempGroovyScriptRepositoryContextTest.java @@ -0,0 +1,106 @@ +package com.codingapi.springboot.script.repository; + +import com.codingapi.springboot.script.GroovyScript; +import com.codingapi.springboot.script.repository.impl.DefaultTempGroovyScriptRepository; +import com.codingapi.springboot.script.temp.TempGroovyScript; +import org.junit.jupiter.api.AfterEach; +import org.junit.jupiter.api.Test; +import org.mockito.Mockito; +import org.springframework.data.domain.Page; +import org.springframework.data.domain.PageRequest; + +import java.util.List; + +import static org.junit.jupiter.api.Assertions.assertEquals; +import static org.junit.jupiter.api.Assertions.assertNotNull; +import static org.junit.jupiter.api.Assertions.assertNull; +import static org.junit.jupiter.api.Assertions.assertSame; +import static org.junit.jupiter.api.Assertions.assertTrue; +import static org.mockito.Mockito.verify; + +/** + * TempGroovyScriptRepositoryContext 与 DefaultTempGroovyScriptRepository 单元测试 + * 覆盖分页查询的三个分支（整页/尾页/越界）以及上下文委托 + */ +class TempGroovyScriptRepositoryContextTest { + + private final TempGroovyScriptRepositoryContext context = TempGroovyScriptRepositoryContext.getInstance(); + + @AfterEach + void tearDown() { + for (int i = 0; i < 5; i++) { + context.delete("temp-page-" + i); + } + context.delete("temp-single"); + context.delete("temp-mock-key"); + // 恢复默认仓储实现，避免 mock 泄漏到其他测试 + context.setTempGroovyScriptRepository(new DefaultTempGroovyScriptRepository()); + } + + private TempGroovyScript tempScript(String key, long clearTime) { + return new TempGroovyScript(GroovyScript.builder(key).script("return 1;").build(), clearTime); + } + + @Test + void defaultRepositoryShouldSupportSaveGetDelete() { + TempGroovyScript tempGroovyScript = tempScript("temp-single", System.currentTimeMillis() + 60000); + + context.save(tempGroovyScript); + assertSame(tempGroovyScript, context.get("temp-single")); + + context.delete("temp-single"); + assertNull(context.get("temp-single")); + // 删除不存在的key不抛异常 + context.delete("temp-single-missing"); + } + + @Test + void findShouldReturnSortedPages() { + long now = System.currentTimeMillis(); + // clearTime 乱序写入，查询应按 clearTime 升序返回 + context.save(tempScript("temp-page-0", now + 5000)); + context.save(tempScript("temp-page-1", now + 4000)); + context.save(tempScript("temp-page-2", now + 3000)); + context.save(tempScript("temp-page-3", now + 2000)); + context.save(tempScript("temp-page-4", now + 1000)); + + // 第一页：满页（size > to 分支） + Page firstPage = context.find(PageRequest.of(0, 2)); + assertEquals(5, firstPage.getTotalElements()); + assertTrue(firstPage.hasNext()); + List firstContent = firstPage.getContent(); + assertEquals(2, firstContent.size()); + assertEquals("temp-page-4", firstContent.get(0).getKey()); + assertEquals("temp-page-3", firstContent.get(1).getKey()); + + // 尾页：不足一页（subList(form, list.size()) 分支） + Page lastPage = context.find(PageRequest.of(2, 2)); + assertEquals(1, lastPage.getContent().size()); + assertEquals("temp-page-0", lastPage.getContent().get(0).getKey()); + + // 越界页：空数据（form > list.size() 分支） + Page beyondPage = context.find(PageRequest.of(5, 2)); + assertTrue(beyondPage.getContent().isEmpty()); + } + + @Test + void contextShouldDelegateToCustomRepository() { + TempGroovyScriptRepository mockRepository = Mockito.mock(TempGroovyScriptRepository.class); + TempGroovyScript tempGroovyScript = tempScript("temp-mock-key", System.currentTimeMillis() + 60000); + Mockito.when(mockRepository.get("temp-mock-key")).thenReturn(tempGroovyScript); + + context.setTempGroovyScriptRepository(mockRepository); + + context.save(tempGroovyScript); + assertSame(tempGroovyScript, context.get("temp-mock-key")); + context.delete("temp-mock-key"); + PageRequest pageRequest = PageRequest.of(0, 10); + context.find(pageRequest); + + verify(mockRepository).save(tempGroovyScript); + verify(mockRepository).get("temp-mock-key"); + verify(mockRepository).delete("temp-mock-key"); + verify(mockRepository).find(pageRequest); + assertNotNull(context); + } +} diff --git a/springboot-starter-script/src/test/java/com/codingapi/springboot/script/request/BaseRequest.java b/springboot-starter-script/src/test/java/com/codingapi/springboot/script/request/BaseRequest.java new file mode 100644 index 000000000..66a168f93 --- /dev/null +++ b/springboot-starter-script/src/test/java/com/codingapi/springboot/script/request/BaseRequest.java @@ -0,0 +1,14 @@ +package com.codingapi.springboot.script.request; + +import com.codingapi.springboot.script.annotation.ScriptFunction; + +public class BaseRequest { + + @ScriptFunction( + name = "hello", + description = "测试" + ) + public void hello() { + System.out.println("hello"); + } +} diff --git a/springboot-starter-script/src/test/java/com/codingapi/springboot/script/request/MyScriptRequest.java b/springboot-starter-script/src/test/java/com/codingapi/springboot/script/request/MyScriptRequest.java new file mode 100644 index 000000000..40cb2099d --- /dev/null +++ b/springboot-starter-script/src/test/java/com/codingapi/springboot/script/request/MyScriptRequest.java @@ -0,0 +1,45 @@ +package com.codingapi.springboot.script.request; + +import com.codingapi.springboot.script.annotation.ScriptParameter; +import com.codingapi.springboot.script.entity.MyTest; +import com.codingapi.springboot.script.repository.MyTestRepository; +import com.codingapi.springboot.script.annotation.ScriptField; +import com.codingapi.springboot.script.annotation.ScriptFunction; +import lombok.AllArgsConstructor; +import lombok.Getter; + +@Getter +@AllArgsConstructor +public class MyScriptRequest extends BaseRequest { + + @ScriptField(name = "count", description = "总数量") + private final int count; + + @ScriptField(name = "test", description = "test") + private MyTest test; + + + @ScriptField(name = "request",description = "request") + private MyScriptRequest request; + + + @ScriptFunction( + name = "isSupport", + description = "是否匹配" + ) + public boolean isSupport(@ScriptParameter(description = "总数") int count) { + return this.count == count; + } + + public MyScriptRequest(int count) { + this.count = count; + } + + + public void addData(MyTestRepository testRepository) { + MyTest myTest = new MyTest(); + myTest.setName("test"); + testRepository.save(myTest); + } + +} diff --git a/springboot-starter-script/src/test/java/com/codingapi/springboot/script/request/Node.java b/springboot-starter-script/src/test/java/com/codingapi/springboot/script/request/Node.java new file mode 100644 index 000000000..812a405e8 --- /dev/null +++ b/springboot-starter-script/src/test/java/com/codingapi/springboot/script/request/Node.java @@ -0,0 +1,13 @@ +package com.codingapi.springboot.script.request; + +import com.codingapi.springboot.script.annotation.GroovyScript; +import lombok.Data; + +@Data +public class Node { + + private String id; + + @GroovyScript + private String script; +} diff --git a/springboot-starter-script/src/test/java/com/codingapi/springboot/script/request/Workflow.java b/springboot-starter-script/src/test/java/com/codingapi/springboot/script/request/Workflow.java new file mode 100644 index 000000000..72e0e997e --- /dev/null +++ b/springboot-starter-script/src/test/java/com/codingapi/springboot/script/request/Workflow.java @@ -0,0 +1,26 @@ +package com.codingapi.springboot.script.request; + +import lombok.Data; +import lombok.Getter; +import lombok.Setter; + +import java.util.ArrayList; +import java.util.List; + +@Data +public class Workflow { + + private String name; + private Node node; + private List nodes; + private Workflow target; + + public void addNode(Node node) { + this.node = node; + if (this.nodes == null) { + this.nodes = new ArrayList<>(); + } + this.nodes.add(node); + this.target = this; + } +} diff --git a/springboot-starter-script/src/test/java/com/codingapi/springboot/script/request/WorkflowTest.java b/springboot-starter-script/src/test/java/com/codingapi/springboot/script/request/WorkflowTest.java new file mode 100644 index 000000000..004bc5b4b --- /dev/null +++ b/springboot-starter-script/src/test/java/com/codingapi/springboot/script/request/WorkflowTest.java @@ -0,0 +1,40 @@ +package com.codingapi.springboot.script.request; + +import com.codingapi.springboot.script.scanner.GroovyScriptAnnotationScannerUtils; +import com.codingapi.springboot.script.scanner.GroovyScriptFieldResult; +import org.junit.jupiter.api.Test; + +import java.util.List; + +import static org.junit.jupiter.api.Assertions.assertEquals; + +class WorkflowTest { + + + @Test + void test() { + + Workflow workflow = new Workflow(); + workflow.setName("测试"); + Node node = new Node(); + node.setId("1"); + node.setScript("K123123"); + workflow.addNode(node); + + List keys = GroovyScriptAnnotationScannerUtils.findGroovyScriptFields(workflow).getKeys(); + assertEquals(1, keys.size()); + assertEquals("K123123", keys.get(0)); + + GroovyScriptFieldResult result = GroovyScriptAnnotationScannerUtils.findGroovyScriptFields(workflow); + + result.update((value)->{ + return "K123456"; + }); + + keys = GroovyScriptAnnotationScannerUtils.findGroovyScriptFields(workflow).getKeys(); + assertEquals(1, keys.size()); + assertEquals("K123456", keys.get(0)); + + } + +} \ No newline at end of file diff --git a/springboot-starter-script/src/test/java/com/codingapi/springboot/script/runner/GroovyScriptEngineRunnerTest.java b/springboot-starter-script/src/test/java/com/codingapi/springboot/script/runner/GroovyScriptEngineRunnerTest.java new file mode 100644 index 000000000..fc77eacd1 --- /dev/null +++ b/springboot-starter-script/src/test/java/com/codingapi/springboot/script/runner/GroovyScriptEngineRunnerTest.java @@ -0,0 +1,82 @@ +package com.codingapi.springboot.script.runner; + +import com.codingapi.springboot.script.GroovyScript; +import com.codingapi.springboot.script.repository.TempGroovyScriptRepositoryContext; +import com.codingapi.springboot.script.temp.TempGroovyScript; +import com.codingapi.springboot.script.temp.TempGroovyScriptContext; +import org.junit.jupiter.api.AfterEach; +import org.junit.jupiter.api.BeforeEach; +import org.junit.jupiter.api.Test; + +import static org.junit.jupiter.api.Assertions.assertEquals; +import static org.junit.jupiter.api.Assertions.assertNotNull; +import static org.junit.jupiter.api.Assertions.assertNull; + +/** + * GroovyScriptEngineRunner 单元测试 + * 覆盖启动时从仓储分页加载临时脚本、销毁时持久化临时脚本 + */ +class GroovyScriptEngineRunnerTest { + + private final GroovyScriptEngineRunner runner = new GroovyScriptEngineRunner(); + + private GroovyScript script(String key) { + return GroovyScript.builder(key).script("return 1;").build(); + } + + @BeforeEach + void setUp() { + TempGroovyScriptContext.getInstance().clear(); + } + + @AfterEach + void tearDown() { + TempGroovyScriptContext.getInstance().clear(); + for (int i = 0; i < 150; i++) { + TempGroovyScriptRepositoryContext.getInstance().delete("runner-key-" + i); + } + TempGroovyScriptRepositoryContext.getInstance().delete("destroy-key-1"); + TempGroovyScriptRepositoryContext.getInstance().delete("destroy-key-2"); + } + + @Test + void afterPropertiesSetShouldLoadTempScriptsFromRepository() throws Exception { + // 写入 150 条数据（超过单页 100 条，触发分页加载逻辑） + // clearTime 递增，保证按 clearTime 排序后 runner-key-0 必然在首页 + long clearTime = System.currentTimeMillis() + 60000; + for (int i = 0; i < 150; i++) { + TempGroovyScriptRepositoryContext.getInstance() + .save(new TempGroovyScript(script("runner-key-" + i), clearTime + i)); + } + + runner.afterPropertiesSet(); + + // 注意：源码仅在 page.hasNext() 时加载当前页，最后一页（50 条）不会加载， + // 疑似 bug（详见测试报告），此处按实际行为断言 + assertEquals(100, TempGroovyScriptContext.getInstance().count()); + assertNotNull(TempGroovyScriptContext.getInstance().getGroovyScript("runner-key-0")); + } + + @Test + void afterPropertiesSetWithEmptyRepositoryShouldLoadNothing() throws Exception { + runner.afterPropertiesSet(); + assertEquals(0, TempGroovyScriptContext.getInstance().count()); + } + + @Test + void destroyShouldSaveTempScriptsToRepository() throws Exception { + TempGroovyScriptContext.getInstance().save(script("destroy-key-1")); + TempGroovyScriptContext.getInstance().save(script("destroy-key-2")); + + runner.destroy(); + + assertNotNull(TempGroovyScriptRepositoryContext.getInstance().get("destroy-key-1")); + assertNotNull(TempGroovyScriptRepositoryContext.getInstance().get("destroy-key-2")); + } + + @Test + void destroyWithoutTempScriptsShouldDoNothing() throws Exception { + runner.destroy(); + assertNull(TempGroovyScriptRepositoryContext.getInstance().get("destroy-key-1")); + } +} diff --git a/springboot-starter-script/src/test/java/com/codingapi/springboot/script/scanner/DemoScriptRequest.java b/springboot-starter-script/src/test/java/com/codingapi/springboot/script/scanner/DemoScriptRequest.java new file mode 100644 index 000000000..191e8ae5a --- /dev/null +++ b/springboot-starter-script/src/test/java/com/codingapi/springboot/script/scanner/DemoScriptRequest.java @@ -0,0 +1,38 @@ +package com.codingapi.springboot.script.scanner; + +import com.codingapi.springboot.script.annotation.ScriptField; +import com.codingapi.springboot.script.annotation.ScriptFunction; +import com.codingapi.springboot.script.annotation.ScriptParameter; +import com.codingapi.springboot.script.annotation.ScriptType; + +/** + * 元数据扫描测试 fixture + * 覆盖 @ScriptType / @ScriptField / @ScriptFunction / @ScriptParameter 的各注解分支 + */ +@ScriptType(description = "demo request type") +public class DemoScriptRequest { + + /** + * 无 name/description 覆盖的字段 + */ + @ScriptField + private String plain; + + /** + * 有 name/description 覆盖的字段 + */ + @ScriptField(name = "age", description = "age description") + private int age; + + @ScriptFunction(name = "calc", description = "calc description") + public int calc(@ScriptParameter(name = "num", description = "num description") int num) { + return num; + } + + /** + * 无 description 的函数 + */ + @ScriptFunction(name = "noDesc") + public void noDesc() { + } +} diff --git a/springboot-starter-script/src/test/java/com/codingapi/springboot/script/scanner/GroovyMetadataScannerTest.java b/springboot-starter-script/src/test/java/com/codingapi/springboot/script/scanner/GroovyMetadataScannerTest.java new file mode 100644 index 000000000..c437c36eb --- /dev/null +++ b/springboot-starter-script/src/test/java/com/codingapi/springboot/script/scanner/GroovyMetadataScannerTest.java @@ -0,0 +1,218 @@ +package com.codingapi.springboot.script.scanner; + +import com.codingapi.springboot.script.GroovyScript; +import com.codingapi.springboot.script.meta.GroovyField; +import com.codingapi.springboot.script.meta.GroovyFunction; +import com.codingapi.springboot.script.meta.GroovyMetadata; +import com.codingapi.springboot.script.meta.GroovyType; +import com.codingapi.springboot.script.strategy.GroovyMetadataGenerateStrategy; +import com.codingapi.springboot.script.strategy.GroovyMetadataGenerateStrategyContext; +import com.codingapi.springboot.script.strategy.GroovyTypeFixStrategy; +import com.codingapi.springboot.script.strategy.GroovyTypeFixStrategyContext; +import com.codingapi.springboot.script.strategy.ScriptTypeMapping; +import com.codingapi.springboot.script.strategy.ScriptTypeMappingContext; +import org.junit.jupiter.api.AfterEach; +import org.junit.jupiter.api.BeforeEach; +import org.junit.jupiter.api.Test; + +import java.util.HashMap; +import java.util.Map; + +import static org.junit.jupiter.api.Assertions.assertEquals; +import static org.junit.jupiter.api.Assertions.assertNotNull; +import static org.junit.jupiter.api.Assertions.assertNull; +import static org.junit.jupiter.api.Assertions.assertThrows; +import static org.junit.jupiter.api.Assertions.assertTrue; + +/** + * GroovyMetadataScannerUtils 补充测试 + * 覆盖注解扫描各分支、简单类型处理、策略不匹配回退等场景 + */ +class GroovyMetadataScannerTest { + + @BeforeEach + void setUp() { + GroovyMetadataGenerateStrategyContext.getInstance().clear(); + GroovyTypeFixStrategyContext.getInstance().clear(); + ScriptTypeMappingContext.getInstance().clear(); + } + + @AfterEach + void tearDown() { + GroovyMetadataGenerateStrategyContext.getInstance().clear(); + GroovyTypeFixStrategyContext.getInstance().clear(); + ScriptTypeMappingContext.getInstance().clear(); + } + + private GroovyField fieldByName(java.util.List fields, String name) { + for (GroovyField field : fields) { + if (name.equals(field.getName())) { + return field; + } + } + return null; + } + + private GroovyFunction functionByName(GroovyType type, String name) { + for (GroovyFunction function : type.getFunctions()) { + if (name.equals(function.getName())) { + return function; + } + } + return null; + } + + @Test + void scannerShouldResolveAnnotationsOfComplexRequestType() { + Map> requests = new HashMap<>(); + requests.put("demo", DemoScriptRequest.class); + // 简单类型：不会注册为 GroovyType，字段描述为空 + requests.put("num", Integer.class); + Map> binds = new HashMap<>(); + binds.put("flag", Boolean.class); + + GroovyScript groovyScript = GroovyScript.builder("scanner-key") + .script("return 1;") + .description("scanner desc") + .method("run") + .returnType(String.class) + .requests(requests) + .binds(binds) + .build(); + + GroovyMetadata metadata = groovyScript.toMetadata(); + + assertEquals("run", metadata.getMainMethod()); + assertEquals("scanner desc", metadata.getDescription()); + assertEquals("String", metadata.getReturnType()); + + // 请求参数 + assertEquals(2, metadata.getRequests().size()); + GroovyField demoField = fieldByName(metadata.getRequests(), "demo"); + assertNotNull(demoField); + assertEquals("DemoScriptRequest", demoField.getDataType()); + // 类型已注册，描述取自 @ScriptType + assertEquals("demo request type", demoField.getDescription()); + GroovyField numField = fieldByName(metadata.getRequests(), "num"); + assertNotNull(numField); + assertEquals("Integer", numField.getDataType()); + // 简单类型未注册，描述为空 + assertNull(numField.getDescription()); + + // 绑定参数 + assertEquals(1, metadata.getBinds().size()); + GroovyField flagField = fieldByName(metadata.getBinds(), "flag"); + assertNotNull(flagField); + assertEquals("Boolean", flagField.getDataType()); + + // 复合类型元数据 + GroovyType demoType = metadata.getType("DemoScriptRequest"); + assertNotNull(demoType); + assertEquals("demo request type", demoType.getDescription()); + + // 字段：无覆盖的 plain 保留字段名，age 使用注解 name + assertEquals(2, demoType.getFields().size()); + GroovyField plain = fieldByName(demoType.getFields(), "plain"); + assertNotNull(plain); + assertEquals("String", plain.getDataType()); + assertNull(plain.getDescription()); + GroovyField age = fieldByName(demoType.getFields(), "age"); + assertNotNull(age); + assertEquals("int", age.getDataType()); + assertEquals("age description", age.getDescription()); + + // 函数：calc 带描述与参数覆盖，noDesc 仅有名称 + assertEquals(2, demoType.getFunctions().size()); + GroovyFunction calc = functionByName(demoType, "calc"); + assertNotNull(calc); + assertEquals("calc description", calc.getDescription()); + assertEquals("int", calc.getReturnType()); + assertEquals(1, calc.getParameters().size()); + assertEquals("num", calc.getParameters().get(0).getName()); + assertEquals("num description", calc.getParameters().get(0).getDescription()); + GroovyFunction noDesc = functionByName(demoType, "noDesc"); + assertNotNull(noDesc); + assertNull(noDesc.getDescription()); + assertEquals("void", noDesc.getReturnType()); + assertTrue(noDesc.getParameters().isEmpty()); + } + + @Test + void scannerShouldHandleScriptWithoutRequestBindAndReturnScanGracefully() { + // GroovyMetadata 构造器对 null returnType 未做防护，toMetadata 抛 NPE， + // 疑似 bug：GroovyMetadataHolder.scannerReturnType 有 null 判断但永远无法到达 + GroovyScript groovyScript = GroovyScript.builder("scanner-null-return") + .script("return 1;") + .build(); + assertThrows(NullPointerException.class, groovyScript::toMetadata); + } + + @Test + void scannerShouldFallbackWhenGenerateStrategyNotSupported() { + GroovyMetadataGenerateStrategyContext.getInstance().addGenerateStrategy(new GroovyMetadataGenerateStrategy() { + @Override + public boolean support(GroovyScript script) { + return false; + } + + @Override + public GroovyMetadata generate(GroovyScript script) { + return new GroovyMetadata("never", "never", "never"); + } + }); + + GroovyScript groovyScript = GroovyScript.builder("scanner-fallback") + .script("return 1;") + .method("run") + .returnType(Integer.class) + .build(); + + GroovyMetadata metadata = groovyScript.toMetadata(); + // 策略不匹配时走扫描逻辑 + assertEquals("run", metadata.getMainMethod()); + assertEquals("Integer", metadata.getReturnType()); + } + + @Test + void scannerShouldIgnoreNotSupportedFixStrategyAndMapping() { + GroovyTypeFixStrategyContext.getInstance().addFixStrategy(new GroovyTypeFixStrategy() { + @Override + public boolean support(Class clazz) { + return false; + } + + @Override + public void fix(GroovyScript groovyScript, GroovyType groovyType) { + groovyType.setDescription("should not happen"); + } + }); + ScriptTypeMappingContext.getInstance().addMapping(new ScriptTypeMapping() { + @Override + public boolean support(Class target) { + return false; + } + + @Override + public Class mapping(Class target) { + return Object.class; + } + }); + + Map> requests = new HashMap<>(); + requests.put("demo", DemoScriptRequest.class); + + GroovyScript groovyScript = GroovyScript.builder("scanner-ignore-strategy") + .script("return 1;") + .method("run") + .returnType(Integer.class) + .requests(requests) + .build(); + + GroovyMetadata metadata = groovyScript.toMetadata(); + GroovyType demoType = metadata.getType("DemoScriptRequest"); + assertNotNull(demoType); + // fix 策略未匹配，描述保持 @ScriptType 的值 + assertEquals("demo request type", demoType.getDescription()); + assertEquals("Integer", metadata.getReturnType()); + } +} diff --git a/springboot-starter-script/src/test/java/com/codingapi/springboot/script/temp/TempGroovyScriptContextLoadTest.java b/springboot-starter-script/src/test/java/com/codingapi/springboot/script/temp/TempGroovyScriptContextLoadTest.java new file mode 100644 index 000000000..4feec04bb --- /dev/null +++ b/springboot-starter-script/src/test/java/com/codingapi/springboot/script/temp/TempGroovyScriptContextLoadTest.java @@ -0,0 +1,126 @@ +package com.codingapi.springboot.script.temp; + +import com.codingapi.springboot.script.GroovyScript; +import com.codingapi.springboot.script.repository.TempGroovyScriptRepositoryContext; +import org.junit.jupiter.api.AfterEach; +import org.junit.jupiter.api.BeforeEach; +import org.junit.jupiter.api.Test; + +import java.util.ArrayList; +import java.util.List; + +import static org.junit.jupiter.api.Assertions.assertEquals; +import static org.junit.jupiter.api.Assertions.assertNotNull; +import static org.junit.jupiter.api.Assertions.assertNull; +import static org.junit.jupiter.api.Assertions.assertSame; + +/** + * TempGroovyScriptContext 补充测试 + * 覆盖 getGroovyScript 回源仓储、loadAll 批量加载、findAll 查询 + */ +class TempGroovyScriptContextLoadTest { + + private final TempGroovyScriptContext context = TempGroovyScriptContext.getInstance(); + + private GroovyScript script(String key) { + return GroovyScript.builder(key).script("return 1;").build(); + } + + @BeforeEach + void setUp() { + context.clear(); + } + + @AfterEach + void tearDown() { + context.clear(); + // 清理直接写入仓储的数据 + TempGroovyScriptRepositoryContext.getInstance().delete("temp-repo-valid"); + TempGroovyScriptRepositoryContext.getInstance().delete("temp-repo-expired"); + TempGroovyScriptRepositoryContext.getInstance().delete("temp-load-expired"); + } + + @Test + void getGroovyScriptShouldReturnNullWhenAbsent() { + assertNull(context.getGroovyScript("temp-no-such-key")); + } + + @Test + void getGroovyScriptShouldReturnSavedScript() { + GroovyScript groovyScript = script("temp-get-key"); + context.save(groovyScript); + + assertSame(groovyScript, context.getGroovyScript("temp-get-key")); + assertEquals(1, context.count()); + } + + @Test + void getGroovyScriptShouldReloadValidScriptFromRepository() { + TempGroovyScript repositoryScript = + new TempGroovyScript(script("temp-repo-valid"), System.currentTimeMillis() + 60000); + TempGroovyScriptRepositoryContext.getInstance().save(repositoryScript); + + GroovyScript result = context.getGroovyScript("temp-repo-valid"); + assertNotNull(result); + assertEquals("temp-repo-valid", result.getKey()); + // 重新加载后进入内存缓存 + assertEquals(1, context.count()); + } + + @Test + void getGroovyScriptShouldRemoveExpiredScriptFromRepository() { + TempGroovyScript expiredScript = + new TempGroovyScript(script("temp-repo-expired"), System.currentTimeMillis() - 1); + TempGroovyScriptRepositoryContext.getInstance().save(expiredScript); + + assertNull(context.getGroovyScript("temp-repo-expired")); + assertEquals(0, context.count()); + // 过期数据同时从仓储清理 + assertNull(TempGroovyScriptRepositoryContext.getInstance().get("temp-repo-expired")); + } + + @Test + void loadAllShouldSkipExpiredAndKeepValidScripts() { + // 预写一条过期数据到仓储，loadAll 时应被删除 + TempGroovyScript expiredInRepo = + new TempGroovyScript(script("temp-load-expired"), System.currentTimeMillis() - 1); + TempGroovyScriptRepositoryContext.getInstance().save(expiredInRepo); + + List list = new ArrayList<>(); + list.add(new TempGroovyScript(script("temp-load-1"), System.currentTimeMillis() + 60000)); + list.add(new TempGroovyScript(script("temp-load-2"), System.currentTimeMillis() + 60000)); + list.add(new TempGroovyScript(script("temp-load-expired"), System.currentTimeMillis() - 1)); + + context.loadAll(list); + + assertEquals(2, context.count()); + assertNotNull(context.getGroovyScript("temp-load-1")); + assertNotNull(context.getGroovyScript("temp-load-2")); + assertNull(TempGroovyScriptRepositoryContext.getInstance().get("temp-load-expired")); + } + + @Test + void loadAllWithNullListShouldDoNothing() { + context.loadAll(null); + assertEquals(0, context.count()); + } + + @Test + void findAllShouldReturnCurrentTempScripts() { + context.save(script("temp-find-1")); + context.save(script("temp-find-2")); + + List all = context.findAll(); + assertEquals(2, all.size()); + } + + @Test + void overwriteSameKeyShouldKeepSingleEntry() { + context.save(script("temp-overwrite")); + context.save(script("temp-overwrite")); + assertEquals(1, context.count()); + + context.remove("temp-overwrite"); + assertEquals(0, context.count()); + } +} diff --git a/springboot-starter-script/src/test/java/com/codingapi/springboot/script/temp/TempGroovyScriptContextTest.java b/springboot-starter-script/src/test/java/com/codingapi/springboot/script/temp/TempGroovyScriptContextTest.java new file mode 100644 index 000000000..d7fbd7c92 --- /dev/null +++ b/springboot-starter-script/src/test/java/com/codingapi/springboot/script/temp/TempGroovyScriptContextTest.java @@ -0,0 +1,84 @@ +package com.codingapi.springboot.script.temp; + +import com.codingapi.springboot.script.GroovyScript; +import com.codingapi.springboot.script.properties.GroovyScriptProperties; +import com.codingapi.springboot.script.properties.PropertiesContext; +import org.junit.jupiter.api.AfterEach; +import org.junit.jupiter.api.BeforeEach; +import org.junit.jupiter.api.Test; + +import static org.junit.jupiter.api.Assertions.assertEquals; + +/** + * 回归测试：临时脚本不得为每个脚本创建原生线程（OOM 根因）， + * 且脚本到期后应被自动清理。 + */ +class TempGroovyScriptContextTest { + + private TempGroovyScriptContext context; + + @BeforeEach + void setUp() { + context = TempGroovyScriptContext.getInstance(); + // 清理上一用例残留的定时任务 + context.clear(); + // 预热共享调度线程，避免首个任务创建线程影响基线统计 + context.save(script("__warmup__")); + context.remove("__warmup__"); + } + + @AfterEach + void tearDown() { + // 清理定时任务并恢复默认配置，避免泄漏到同 JVM 的其他测试 + context.clear(); + PropertiesContext.getInstance().setProperties(new GroovyScriptProperties()); + } + + private GroovyScript script(String key) { + return GroovyScript.builder(key).script("return 1;").build(); + } + + @Test + void saveManyScriptsShouldNotCreateThreads() { + int threadsBefore = Thread.getAllStackTraces().size(); + + for (int i = 0; i < 200; i++) { + context.save(script("key-" + i)); + } + + assertEquals(200, context.count()); + assertEquals(threadsBefore, Thread.getAllStackTraces().size(), + "注册 200 个临时脚本不应创建任何新线程"); + } + + @Test + void overwriteRemoveClearShouldNotCreateThreads() { + int threadsBefore = Thread.getAllStackTraces().size(); + + for (int i = 0; i < 100; i++) { + context.save(script("key-" + i)); + context.save(script("key-" + i)); // 覆盖刷新 + } + for (int i = 0; i < 100; i++) { + context.remove("key-" + i); + } + context.clear(); + + assertEquals(0, context.count()); + assertEquals(threadsBefore, Thread.getAllStackTraces().size(), + "覆盖/删除/清空不应创建新线程"); + } + + @Test + void expiredScriptShouldBeRemovedAutomatically() throws InterruptedException { + GroovyScriptProperties properties = new GroovyScriptProperties(); + properties.setTempValidTime(300); + PropertiesContext.getInstance().setProperties(properties); + + context.save(script("expire-key")); + assertEquals(1, context.count()); + + Thread.sleep(1500); + assertEquals(0, context.count(), "脚本到期后应被自动清理"); + } +} \ No newline at end of file diff --git a/springboot-starter-script/src/test/resources/application.properties b/springboot-starter-script/src/test/resources/application.properties new file mode 100644 index 000000000..967207fad --- /dev/null +++ b/springboot-starter-script/src/test/resources/application.properties @@ -0,0 +1,7 @@ +spring.datasource.driver-class-name=org.h2.Driver +spring.datasource.url=jdbc:h2:file:./test.db +spring.jpa.database-platform=org.hibernate.dialect.H2Dialect +spring.jpa.hibernate.ddl-auto=create-drop +spring.jpa.show-sql=true + +codingapi.framework.event.transaction.enable=true \ No newline at end of file diff --git a/springboot-starter-security-jwt/src/main/java/com/codingapi/springboot/security/filter/SecurityLoginHandler.java b/springboot-starter-security-jwt/src/main/java/com/codingapi/springboot/security/filter/SecurityLoginHandler.java deleted file mode 100644 index 5ad141150..000000000 --- a/springboot-starter-security-jwt/src/main/java/com/codingapi/springboot/security/filter/SecurityLoginHandler.java +++ /dev/null @@ -1,11 +0,0 @@ -package com.codingapi.springboot.security.filter; - -import com.codingapi.springboot.security.dto.request.LoginRequest; - -import jakarta.servlet.http.HttpServletRequest; -import jakarta.servlet.http.HttpServletResponse; - -public interface SecurityLoginHandler { - - void preHandle(HttpServletRequest request, HttpServletResponse response, LoginRequest handler) throws Exception; -} diff --git a/springboot-starter-security-jwt/src/main/resources/META-INF/spring.factories b/springboot-starter-security-jwt/src/main/resources/META-INF/spring.factories deleted file mode 100644 index b7882c59a..000000000 --- a/springboot-starter-security-jwt/src/main/resources/META-INF/spring.factories +++ /dev/null @@ -1,4 +0,0 @@ -org.springframework.boot.autoconfigure.EnableAutoConfiguration=\ -com.codingapi.springboot.security.configurer.WebSecurityConfigurer,\ -com.codingapi.springboot.security.crypto.MyCryptoConfiguration,\ -com.codingapi.springboot.security.AutoConfiguration \ No newline at end of file diff --git a/springboot-starter-security-jwt/src/main/resources/META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports b/springboot-starter-security-jwt/src/main/resources/META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports deleted file mode 100644 index 69b9af0dd..000000000 --- a/springboot-starter-security-jwt/src/main/resources/META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports +++ /dev/null @@ -1,3 +0,0 @@ -com.codingapi.springboot.security.configurer.WebSecurityConfigurer -com.codingapi.springboot.security.crypto.MyCryptoConfiguration -com.codingapi.springboot.security.AutoConfiguration \ No newline at end of file diff --git a/springboot-starter-security-jwt/pom.xml b/springboot-starter-security/pom.xml similarity index 71% rename from springboot-starter-security-jwt/pom.xml rename to springboot-starter-security/pom.xml index 6369c4864..b01858598 100644 --- a/springboot-starter-security-jwt/pom.xml +++ b/springboot-starter-security/pom.xml @@ -4,18 +4,18 @@ xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd"> 4.0.0 - springboot-parent com.codingapi.springboot - 2.1.11 + springboot-parent + ${revision} - springboot-starter-security-jwt + springboot-starter-security - springboot-starter-security-jwt - springboot-starter-security-jwt project for Spring Boot + springboot-starter-security + springboot-starter-security project for Spring Boot - 17 + 8 @@ -30,19 +30,28 @@ spring-boot-starter-web + + org.springframework.boot + spring-boot-starter-data-redis + provided + + io.jsonwebtoken jjwt-api + provided io.jsonwebtoken jjwt-impl + provided io.jsonwebtoken jjwt-jackson + provided diff --git a/springboot-starter-security-jwt/src/main/java/com/codingapi/springboot/security/AutoConfiguration.java b/springboot-starter-security/src/main/java/com/codingapi/springboot/security/AutoConfiguration.java similarity index 63% rename from springboot-starter-security-jwt/src/main/java/com/codingapi/springboot/security/AutoConfiguration.java rename to springboot-starter-security/src/main/java/com/codingapi/springboot/security/AutoConfiguration.java index ba56c691c..b8b21a764 100644 --- a/springboot-starter-security-jwt/src/main/java/com/codingapi/springboot/security/AutoConfiguration.java +++ b/springboot-starter-security/src/main/java/com/codingapi/springboot/security/AutoConfiguration.java @@ -2,9 +2,14 @@ import com.codingapi.springboot.security.configurer.HttpSecurityConfigurer; import com.codingapi.springboot.security.controller.VersionController; +import com.codingapi.springboot.security.customer.DefaultHttpSecurityCustomer; +import com.codingapi.springboot.security.customer.HttpSecurityCustomer; +import com.codingapi.springboot.security.dto.request.LoginRequest; +import com.codingapi.springboot.security.dto.response.LoginResponse; import com.codingapi.springboot.security.filter.*; -import com.codingapi.springboot.security.jwt.Jwt; -import com.codingapi.springboot.security.properties.SecurityJwtProperties; +import com.codingapi.springboot.security.gateway.Token; +import com.codingapi.springboot.security.gateway.TokenGateway; +import com.codingapi.springboot.security.properties.CodingApiSecurityProperties; import org.springframework.boot.autoconfigure.condition.ConditionalOnMissingBean; import org.springframework.boot.context.properties.ConfigurationProperties; import org.springframework.context.annotation.Bean; @@ -24,6 +29,9 @@ import org.springframework.web.servlet.config.annotation.CorsRegistry; import org.springframework.web.servlet.config.annotation.WebMvcConfigurer; +import javax.servlet.http.HttpServletRequest; +import javax.servlet.http.HttpServletResponse; + @Configuration @EnableWebSecurity public class AutoConfiguration { @@ -53,28 +61,53 @@ public PasswordEncoder passwordEncoder() { return PasswordEncoderFactories.createDelegatingPasswordEncoder(); } + @Bean + @ConditionalOnMissingBean + public AuthenticationTokenFilter authenticationTokenFilter() { + return (request, response) -> { + + }; + } @Bean @ConditionalOnMissingBean - public SecurityLoginHandler securityLoginHandler(){ - return (request, response, handler) -> { + public HttpSecurityCustomer httpSecurityCustomer(CodingApiSecurityProperties properties){ + return new DefaultHttpSecurityCustomer(properties); + } + + @Bean + @ConditionalOnMissingBean + public SecurityLoginHandler securityLoginHandler() { + return new SecurityLoginHandler() { + @Override + public void preHandle(HttpServletRequest request, HttpServletResponse response, LoginRequest handler) throws Exception { + + } + + @Override + public LoginResponse postHandle(HttpServletRequest request, HttpServletResponse response, LoginRequest loginRequest,UserDetails userDetails, Token token) { + LoginResponse loginResponse = new LoginResponse(); + loginResponse.setUsername(token.getUsername()); + loginResponse.setToken(token.getToken()); + loginResponse.setAuthorities(token.getAuthorities()); + return loginResponse; + } }; } @Bean @ConditionalOnMissingBean - public SecurityFilterChain filterChain(HttpSecurity security, Jwt jwt,SecurityLoginHandler loginHandler, - SecurityJwtProperties properties) throws Exception { - //disable basic auth - security.httpBasic().disable(); - - //before add addCorsMappings to enable cors. - security.cors(); - if(properties.isDisableCsrf() ){ - security.csrf().disable(); - } - security.apply(new HttpSecurityConfigurer(jwt,loginHandler,properties)); + public SecurityFilterChain filterChain(HttpSecurity security, + HttpSecurityCustomer httpSecurityCustomer, + TokenGateway tokenGateway, + SecurityLoginHandler loginHandler, + CodingApiSecurityProperties properties, + AuthenticationTokenFilter authenticationTokenFilter) throws Exception { + + httpSecurityCustomer.customize(security); + + security.apply(new HttpSecurityConfigurer(tokenGateway, loginHandler, properties, authenticationTokenFilter)); security .exceptionHandling() .authenticationEntryPoint(new MyUnAuthenticationEntryPoint()) @@ -82,8 +115,8 @@ public SecurityFilterChain filterChain(HttpSecurity security, Jwt jwt,SecurityLo .and() .authorizeHttpRequests( registry -> { - registry.requestMatchers(properties.getIgnoreUrls()).permitAll() - .requestMatchers(properties.getAuthenticatedUrls()).authenticated() + registry.antMatchers(properties.getIgnoreUrls()).permitAll() + .antMatchers(properties.getAuthenticatedUrls()).authenticated() .anyRequest().permitAll(); } ) @@ -113,19 +146,13 @@ public AuthenticationProvider authenticationProvider(UserDetailsService userDeta } - @Bean - @ConditionalOnMissingBean - public Jwt jwt(SecurityJwtProperties properties) { - return new Jwt(properties.getJwtSecretKey(), properties.getJwtTime(), properties.getJwtRestTime()); - } - @Bean - public WebMvcConfigurer corsConfigurer(SecurityJwtProperties securityJwtProperties) { + public WebMvcConfigurer corsConfigurer(CodingApiSecurityProperties securityProperties) { return new WebMvcConfigurer() { @Override public void addCorsMappings(CorsRegistry registry) { - if(securityJwtProperties.isDisableCors()) { + if (securityProperties.isDisableCors()) { registry.addMapping("/**") .allowedHeaders("*") .allowedMethods("*") @@ -142,14 +169,14 @@ public void addCorsMappings(CorsRegistry registry) { @Bean @ConfigurationProperties(prefix = "codingapi.security") - public SecurityJwtProperties securityJwtProperties() { - return new SecurityJwtProperties(); + public CodingApiSecurityProperties codingApiSecurityProperties() { + return new CodingApiSecurityProperties(); } @Bean @ConditionalOnMissingBean - public VersionController versionController(Environment environment){ + public VersionController versionController(Environment environment) { return new VersionController(environment); } diff --git a/springboot-starter-security-jwt/src/main/java/com/codingapi/springboot/security/configurer/HttpSecurityConfigurer.java b/springboot-starter-security/src/main/java/com/codingapi/springboot/security/configurer/HttpSecurityConfigurer.java similarity index 63% rename from springboot-starter-security-jwt/src/main/java/com/codingapi/springboot/security/configurer/HttpSecurityConfigurer.java rename to springboot-starter-security/src/main/java/com/codingapi/springboot/security/configurer/HttpSecurityConfigurer.java index d46a3a0b0..e6258f1cc 100644 --- a/springboot-starter-security-jwt/src/main/java/com/codingapi/springboot/security/configurer/HttpSecurityConfigurer.java +++ b/springboot-starter-security/src/main/java/com/codingapi/springboot/security/configurer/HttpSecurityConfigurer.java @@ -1,10 +1,11 @@ package com.codingapi.springboot.security.configurer; +import com.codingapi.springboot.security.filter.AuthenticationTokenFilter; import com.codingapi.springboot.security.filter.MyAuthenticationFilter; import com.codingapi.springboot.security.filter.MyLoginFilter; import com.codingapi.springboot.security.filter.SecurityLoginHandler; -import com.codingapi.springboot.security.jwt.Jwt; -import com.codingapi.springboot.security.properties.SecurityJwtProperties; +import com.codingapi.springboot.security.gateway.TokenGateway; +import com.codingapi.springboot.security.properties.CodingApiSecurityProperties; import lombok.AllArgsConstructor; import org.springframework.security.authentication.AuthenticationManager; import org.springframework.security.config.annotation.web.builders.HttpSecurity; @@ -13,15 +14,16 @@ @AllArgsConstructor public class HttpSecurityConfigurer extends AbstractHttpConfigurer { - private final Jwt jwt; + private final TokenGateway tokenGateway; private final SecurityLoginHandler securityLoginHandler; - private final SecurityJwtProperties securityJwtProperties; + private final CodingApiSecurityProperties securityProperties; + private final AuthenticationTokenFilter authenticationTokenFilter; @Override public void configure(HttpSecurity security) throws Exception { AuthenticationManager manager = security.getSharedObject(AuthenticationManager.class); - security.addFilter(new MyLoginFilter(manager, jwt,securityLoginHandler, securityJwtProperties)); - security.addFilter(new MyAuthenticationFilter(manager,securityJwtProperties,jwt)); + security.addFilter(new MyLoginFilter(manager, tokenGateway,securityLoginHandler, securityProperties)); + security.addFilter(new MyAuthenticationFilter(manager,securityProperties,tokenGateway,authenticationTokenFilter)); } } diff --git a/springboot-starter-security-jwt/src/main/java/com/codingapi/springboot/security/configurer/WebSecurityConfigurer.java b/springboot-starter-security/src/main/java/com/codingapi/springboot/security/configurer/WebSecurityConfigurer.java similarity index 71% rename from springboot-starter-security-jwt/src/main/java/com/codingapi/springboot/security/configurer/WebSecurityConfigurer.java rename to springboot-starter-security/src/main/java/com/codingapi/springboot/security/configurer/WebSecurityConfigurer.java index 7e5f3e750..06d84d7cc 100644 --- a/springboot-starter-security-jwt/src/main/java/com/codingapi/springboot/security/configurer/WebSecurityConfigurer.java +++ b/springboot-starter-security/src/main/java/com/codingapi/springboot/security/configurer/WebSecurityConfigurer.java @@ -1,6 +1,6 @@ package com.codingapi.springboot.security.configurer; -import com.codingapi.springboot.security.properties.SecurityJwtProperties; +import com.codingapi.springboot.security.properties.CodingApiSecurityProperties; import lombok.AllArgsConstructor; import org.springframework.context.annotation.Configuration; import org.springframework.security.config.annotation.web.builders.WebSecurity; @@ -10,12 +10,12 @@ @AllArgsConstructor public class WebSecurityConfigurer implements WebSecurityCustomizer { - private final SecurityJwtProperties securityJwtProperties; + private final CodingApiSecurityProperties securityProperties; @Override public void customize(WebSecurity web) { //ignoring security filters request url - web.ignoring().requestMatchers(securityJwtProperties.getIgnoreUrls()); + web.ignoring().antMatchers(securityProperties.getIgnoreUrls()); } } diff --git a/springboot-starter-security-jwt/src/main/java/com/codingapi/springboot/security/controller/VersionController.java b/springboot-starter-security/src/main/java/com/codingapi/springboot/security/controller/VersionController.java similarity index 71% rename from springboot-starter-security-jwt/src/main/java/com/codingapi/springboot/security/controller/VersionController.java rename to springboot-starter-security/src/main/java/com/codingapi/springboot/security/controller/VersionController.java index 7d2385a8d..03e8445d2 100644 --- a/springboot-starter-security-jwt/src/main/java/com/codingapi/springboot/security/controller/VersionController.java +++ b/springboot-starter-security/src/main/java/com/codingapi/springboot/security/controller/VersionController.java @@ -1,5 +1,6 @@ package com.codingapi.springboot.security.controller; +import com.codingapi.springboot.framework.dto.response.SingleResponse; import lombok.AllArgsConstructor; import org.springframework.core.env.Environment; import org.springframework.web.bind.annotation.GetMapping; @@ -14,7 +15,7 @@ public class VersionController { private final Environment env; @GetMapping("/version") - public String version(){ - return env.getProperty("application.version","-"); + public SingleResponse version() { + return SingleResponse.of(env.getProperty("application.version", "-")); } } diff --git a/springboot-starter-security-jwt/src/main/java/com/codingapi/springboot/security/crypto/MyAES.java b/springboot-starter-security/src/main/java/com/codingapi/springboot/security/crypto/AESTools.java similarity index 84% rename from springboot-starter-security-jwt/src/main/java/com/codingapi/springboot/security/crypto/MyAES.java rename to springboot-starter-security/src/main/java/com/codingapi/springboot/security/crypto/AESTools.java index b3536ca80..efe4a7a8d 100644 --- a/springboot-starter-security-jwt/src/main/java/com/codingapi/springboot/security/crypto/MyAES.java +++ b/springboot-starter-security/src/main/java/com/codingapi/springboot/security/crypto/AESTools.java @@ -6,20 +6,20 @@ import java.nio.charset.StandardCharsets; import java.util.Base64; -public class MyAES { +public class AESTools { - private final static MyAES instance = new MyAES(); + private final static AESTools instance = new AESTools(); private AES aes; - private MyAES() { + private AESTools() { } void init(AES aes) { this.aes = aes; } - public static MyAES getInstance() { + public static AESTools getInstance() { return instance; } diff --git a/springboot-starter-security-jwt/src/main/java/com/codingapi/springboot/security/crypto/MyCryptoConfiguration.java b/springboot-starter-security/src/main/java/com/codingapi/springboot/security/crypto/SecurityCryptoConfiguration.java similarity index 69% rename from springboot-starter-security-jwt/src/main/java/com/codingapi/springboot/security/crypto/MyCryptoConfiguration.java rename to springboot-starter-security/src/main/java/com/codingapi/springboot/security/crypto/SecurityCryptoConfiguration.java index 0d4b2bd4a..6820dc5ce 100644 --- a/springboot-starter-security-jwt/src/main/java/com/codingapi/springboot/security/crypto/MyCryptoConfiguration.java +++ b/springboot-starter-security/src/main/java/com/codingapi/springboot/security/crypto/SecurityCryptoConfiguration.java @@ -1,7 +1,7 @@ package com.codingapi.springboot.security.crypto; import com.codingapi.springboot.framework.crypto.AES; -import com.codingapi.springboot.security.properties.SecurityJwtProperties; +import com.codingapi.springboot.security.properties.CodingApiSecurityProperties; import org.springframework.boot.autoconfigure.condition.ConditionalOnMissingBean; import org.springframework.context.annotation.Bean; import org.springframework.context.annotation.Configuration; @@ -9,15 +9,14 @@ import java.util.Base64; @Configuration -public class MyCryptoConfiguration { +public class SecurityCryptoConfiguration { @Bean @ConditionalOnMissingBean - public AES aes(SecurityJwtProperties properties) throws Exception { + public AES aes(CodingApiSecurityProperties properties) throws Exception { AES aes = new AES(Base64.getDecoder().decode(properties.getAseKey().getBytes()), Base64.getDecoder().decode(properties.getAseIv())); - MyAES.getInstance().init(aes); + AESTools.getInstance().init(aes); return aes; } - } diff --git a/springboot-starter-security/src/main/java/com/codingapi/springboot/security/customer/DefaultHttpSecurityCustomer.java b/springboot-starter-security/src/main/java/com/codingapi/springboot/security/customer/DefaultHttpSecurityCustomer.java new file mode 100644 index 000000000..02733c6fe --- /dev/null +++ b/springboot-starter-security/src/main/java/com/codingapi/springboot/security/customer/DefaultHttpSecurityCustomer.java @@ -0,0 +1,50 @@ +package com.codingapi.springboot.security.customer; + +import com.codingapi.springboot.security.properties.CodingApiSecurityProperties; +import lombok.AllArgsConstructor; +import org.springframework.security.config.Customizer; +import org.springframework.security.config.annotation.web.builders.HttpSecurity; +import org.springframework.security.config.annotation.web.configurers.AbstractHttpConfigurer; +import org.springframework.security.config.annotation.web.configurers.HeadersConfigurer; + +@AllArgsConstructor +public class DefaultHttpSecurityCustomer implements HttpSecurityCustomer { + + private final CodingApiSecurityProperties properties; + + @Override + public void customize(HttpSecurity security) throws Exception { + //disable basic auth + if (properties.isDisableBasicAuth()) { + security.httpBasic(AbstractHttpConfigurer::disable); + } + + //disable frame options + if (properties.isDisableFrameOptions()) { + security.headers(new Customizer>() { + @Override + public void customize(HeadersConfigurer httpSecurityHeadersConfigurer) { + httpSecurityHeadersConfigurer.frameOptions(new Customizer.FrameOptionsConfig>() { + @Override + public void customize(HeadersConfigurer.FrameOptionsConfig frameOptionsConfig) { + frameOptionsConfig.disable(); + } + }); + } + }); + } + + //before add addCorsMappings to enable cors. + security.cors(httpSecurityCorsConfigurer -> { + if (properties.isDisableCors()) { + httpSecurityCorsConfigurer.disable(); + } + }); + + security.csrf(httpSecurityCsrfConfigurer -> { + if (properties.isDisableCsrf()) { + httpSecurityCsrfConfigurer.disable(); + } + }); + } +} diff --git a/springboot-starter-security/src/main/java/com/codingapi/springboot/security/customer/HttpSecurityCustomer.java b/springboot-starter-security/src/main/java/com/codingapi/springboot/security/customer/HttpSecurityCustomer.java new file mode 100644 index 000000000..ddc35dd69 --- /dev/null +++ b/springboot-starter-security/src/main/java/com/codingapi/springboot/security/customer/HttpSecurityCustomer.java @@ -0,0 +1,9 @@ +package com.codingapi.springboot.security.customer; + +import org.springframework.security.config.annotation.web.builders.HttpSecurity; + +public interface HttpSecurityCustomer { + + void customize(HttpSecurity security) throws Exception; + +} diff --git a/springboot-starter-security-jwt/src/main/java/com/codingapi/springboot/security/dto/request/LoginRequest.java b/springboot-starter-security/src/main/java/com/codingapi/springboot/security/dto/request/LoginRequest.java similarity index 100% rename from springboot-starter-security-jwt/src/main/java/com/codingapi/springboot/security/dto/request/LoginRequest.java rename to springboot-starter-security/src/main/java/com/codingapi/springboot/security/dto/request/LoginRequest.java diff --git a/springboot-starter-security-jwt/src/main/java/com/codingapi/springboot/security/dto/request/LoginRequestContext.java b/springboot-starter-security/src/main/java/com/codingapi/springboot/security/dto/request/LoginRequestContext.java similarity index 100% rename from springboot-starter-security-jwt/src/main/java/com/codingapi/springboot/security/dto/request/LoginRequestContext.java rename to springboot-starter-security/src/main/java/com/codingapi/springboot/security/dto/request/LoginRequestContext.java diff --git a/springboot-starter-security-jwt/src/main/java/com/codingapi/springboot/security/dto/response/LoginResponse.java b/springboot-starter-security/src/main/java/com/codingapi/springboot/security/dto/response/LoginResponse.java similarity index 91% rename from springboot-starter-security-jwt/src/main/java/com/codingapi/springboot/security/dto/response/LoginResponse.java rename to springboot-starter-security/src/main/java/com/codingapi/springboot/security/dto/response/LoginResponse.java index cdfc3a3f0..d717d36e0 100644 --- a/springboot-starter-security-jwt/src/main/java/com/codingapi/springboot/security/dto/response/LoginResponse.java +++ b/springboot-starter-security/src/main/java/com/codingapi/springboot/security/dto/response/LoginResponse.java @@ -12,5 +12,6 @@ public class LoginResponse { private String username; private String token; private List authorities; + private Object data; } diff --git a/springboot-starter-security-jwt/src/main/java/com/codingapi/springboot/security/exception/TokenExpiredException.java b/springboot-starter-security/src/main/java/com/codingapi/springboot/security/exception/TokenExpiredException.java similarity index 100% rename from springboot-starter-security-jwt/src/main/java/com/codingapi/springboot/security/exception/TokenExpiredException.java rename to springboot-starter-security/src/main/java/com/codingapi/springboot/security/exception/TokenExpiredException.java diff --git a/springboot-starter-security/src/main/java/com/codingapi/springboot/security/filter/AuthenticationTokenFilter.java b/springboot-starter-security/src/main/java/com/codingapi/springboot/security/filter/AuthenticationTokenFilter.java new file mode 100644 index 000000000..020ea6640 --- /dev/null +++ b/springboot-starter-security/src/main/java/com/codingapi/springboot/security/filter/AuthenticationTokenFilter.java @@ -0,0 +1,13 @@ +package com.codingapi.springboot.security.filter; + +import javax.servlet.ServletException; +import javax.servlet.http.HttpServletRequest; +import javax.servlet.http.HttpServletResponse; +import java.io.IOException; + +public interface AuthenticationTokenFilter { + + + void doFilter(HttpServletRequest request, HttpServletResponse response)throws IOException, ServletException; + +} diff --git a/springboot-starter-security-jwt/src/main/java/com/codingapi/springboot/security/filter/MyAccessDeniedHandler.java b/springboot-starter-security/src/main/java/com/codingapi/springboot/security/filter/MyAccessDeniedHandler.java similarity index 74% rename from springboot-starter-security-jwt/src/main/java/com/codingapi/springboot/security/filter/MyAccessDeniedHandler.java rename to springboot-starter-security/src/main/java/com/codingapi/springboot/security/filter/MyAccessDeniedHandler.java index 191d1dfc0..beb79203a 100644 --- a/springboot-starter-security-jwt/src/main/java/com/codingapi/springboot/security/filter/MyAccessDeniedHandler.java +++ b/springboot-starter-security/src/main/java/com/codingapi/springboot/security/filter/MyAccessDeniedHandler.java @@ -7,9 +7,9 @@ import org.springframework.security.access.AccessDeniedException; import org.springframework.security.web.access.AccessDeniedHandler; -import jakarta.servlet.ServletException; -import jakarta.servlet.http.HttpServletRequest; -import jakarta.servlet.http.HttpServletResponse; +import javax.servlet.ServletException; +import javax.servlet.http.HttpServletRequest; +import javax.servlet.http.HttpServletResponse; import java.io.IOException; import java.nio.charset.StandardCharsets; @@ -20,6 +20,10 @@ public class MyAccessDeniedHandler implements AccessDeniedHandler { public void handle(HttpServletRequest request, HttpServletResponse response, AccessDeniedException accessDeniedException) throws IOException, ServletException { log.debug("access denied"); String content = JSONObject.toJSONString(Response.buildFailure("not.access", "please check user authentication.")); + // 设置响应的 Content-Type 为 JSON，并指定字符编码为 UTF-8 + response.setContentType("application/json;charset=UTF-8"); + response.setCharacterEncoding("UTF-8"); + IOUtils.write(content, response.getOutputStream(), StandardCharsets.UTF_8); } } diff --git a/springboot-starter-security-jwt/src/main/java/com/codingapi/springboot/security/filter/MyAuthenticationFilter.java b/springboot-starter-security/src/main/java/com/codingapi/springboot/security/filter/MyAuthenticationFilter.java similarity index 50% rename from springboot-starter-security-jwt/src/main/java/com/codingapi/springboot/security/filter/MyAuthenticationFilter.java rename to springboot-starter-security/src/main/java/com/codingapi/springboot/security/filter/MyAuthenticationFilter.java index 095629192..7ff815c7a 100644 --- a/springboot-starter-security-jwt/src/main/java/com/codingapi/springboot/security/filter/MyAuthenticationFilter.java +++ b/springboot-starter-security/src/main/java/com/codingapi/springboot/security/filter/MyAuthenticationFilter.java @@ -3,13 +3,9 @@ import com.alibaba.fastjson.JSONObject; import com.codingapi.springboot.framework.dto.response.Response; import com.codingapi.springboot.security.exception.TokenExpiredException; -import com.codingapi.springboot.security.jwt.Jwt; -import com.codingapi.springboot.security.jwt.Token; -import com.codingapi.springboot.security.properties.SecurityJwtProperties; -import jakarta.servlet.FilterChain; -import jakarta.servlet.ServletException; -import jakarta.servlet.http.HttpServletRequest; -import jakarta.servlet.http.HttpServletResponse; +import com.codingapi.springboot.security.gateway.Token; +import com.codingapi.springboot.security.gateway.TokenGateway; +import com.codingapi.springboot.security.properties.CodingApiSecurityProperties; import lombok.extern.slf4j.Slf4j; import org.apache.commons.io.IOUtils; import org.springframework.security.authentication.AuthenticationManager; @@ -17,8 +13,11 @@ import org.springframework.security.web.authentication.www.BasicAuthenticationFilter; import org.springframework.util.AntPathMatcher; import org.springframework.util.StringUtils; -import org.springframework.web.filter.OncePerRequestFilter; +import javax.servlet.FilterChain; +import javax.servlet.ServletException; +import javax.servlet.http.HttpServletRequest; +import javax.servlet.http.HttpServletResponse; import java.io.IOException; import java.nio.charset.StandardCharsets; @@ -27,22 +26,24 @@ public class MyAuthenticationFilter extends BasicAuthenticationFilter { private final static String TOKEN_KEY = "Authorization"; - private final Jwt jwt; + private final TokenGateway tokenGateway; - private final SecurityJwtProperties securityJwtProperties; + private final CodingApiSecurityProperties securityProperties; + private final AuthenticationTokenFilter authenticationTokenFilter; private final AntPathMatcher antPathMatcher = new AntPathMatcher(); - public MyAuthenticationFilter(AuthenticationManager manager, SecurityJwtProperties securityJwtProperties, Jwt jwt) { + public MyAuthenticationFilter(AuthenticationManager manager, CodingApiSecurityProperties securityProperties, TokenGateway tokenGateway,AuthenticationTokenFilter authenticationTokenFilter) { super(manager); - this.jwt = jwt; - this.securityJwtProperties = securityJwtProperties; + this.tokenGateway = tokenGateway; + this.securityProperties = securityProperties; + this.authenticationTokenFilter = authenticationTokenFilter; } @Override protected void doFilterInternal(HttpServletRequest request, HttpServletResponse response, FilterChain chain) throws IOException, ServletException { log.debug("token authentication ~"); - for (String antUrl : securityJwtProperties.getAuthenticatedUrls()) { + for (String antUrl : securityProperties.getAuthenticatedUrls()) { if(antPathMatcher.match(antUrl,request.getRequestURI())) { String sign = request.getHeader(TOKEN_KEY); @@ -51,20 +52,31 @@ protected void doFilterInternal(HttpServletRequest request, HttpServletResponse return; } - Token token = jwt.parser(sign); - if (token.canRestToken()) { - Token newSign = jwt.create(token.getUsername(), token.decodeIv(), token.getAuthorities(), token.getExtra()); - log.info("reset token "); - response.setHeader(TOKEN_KEY, newSign.getToken()); - } + Token token = null; try { - token.verify(); - } catch (TokenExpiredException e) { + token = tokenGateway.parser(sign); + if (token == null) { + writeResponse(response, Response.buildFailure("token.expire", "token expire.")); + return; + } + if (token.canRestToken()) { + Token newSign = tokenGateway.create(token.getUsername(), token.decodeIv(), token.getAuthorities(), token.getExtra()); + log.info("reset token "); + response.setHeader(TOKEN_KEY, newSign.getToken()); + } + try { + token.verify(); + } catch (TokenExpiredException e) { + writeResponse(response, Response.buildFailure("token.expire", "token expire.")); + return; + } + } catch (Exception e) { writeResponse(response, Response.buildFailure("token.expire", "token expire.")); return; } SecurityContextHolder.getContext().setAuthentication(token.getAuthenticationToken()); + authenticationTokenFilter.doFilter(request, response); } } chain.doFilter(request, response); @@ -73,6 +85,10 @@ protected void doFilterInternal(HttpServletRequest request, HttpServletResponse private void writeResponse(HttpServletResponse servletResponse, Response returnResponse) throws IOException { String content = JSONObject.toJSONString(returnResponse); + // 设置响应的 Content-Type 为 JSON，并指定字符编码为 UTF-8 + servletResponse.setContentType("application/json;charset=UTF-8"); + servletResponse.setCharacterEncoding("UTF-8"); + IOUtils.write(content, servletResponse.getOutputStream(), StandardCharsets.UTF_8); } diff --git a/springboot-starter-security-jwt/src/main/java/com/codingapi/springboot/security/filter/MyLoginFilter.java b/springboot-starter-security/src/main/java/com/codingapi/springboot/security/filter/MyLoginFilter.java similarity index 71% rename from springboot-starter-security-jwt/src/main/java/com/codingapi/springboot/security/filter/MyLoginFilter.java rename to springboot-starter-security/src/main/java/com/codingapi/springboot/security/filter/MyLoginFilter.java index f472ed99d..c0ecc62b7 100644 --- a/springboot-starter-security-jwt/src/main/java/com/codingapi/springboot/security/filter/MyLoginFilter.java +++ b/springboot-starter-security/src/main/java/com/codingapi/springboot/security/filter/MyLoginFilter.java @@ -6,10 +6,10 @@ import com.codingapi.springboot.security.dto.request.LoginRequest; import com.codingapi.springboot.security.dto.request.LoginRequestContext; import com.codingapi.springboot.security.dto.response.LoginResponse; -import com.codingapi.springboot.security.jwt.Jwt; -import com.codingapi.springboot.security.jwt.Token; -import com.codingapi.springboot.security.jwt.TokenContext; -import com.codingapi.springboot.security.properties.SecurityJwtProperties; +import com.codingapi.springboot.security.gateway.Token; +import com.codingapi.springboot.security.gateway.TokenContext; +import com.codingapi.springboot.security.gateway.TokenGateway; +import com.codingapi.springboot.security.properties.CodingApiSecurityProperties; import lombok.extern.slf4j.Slf4j; import org.apache.commons.io.IOUtils; import org.springframework.security.authentication.AuthenticationManager; @@ -18,14 +18,14 @@ import org.springframework.security.core.Authentication; import org.springframework.security.core.AuthenticationException; import org.springframework.security.core.GrantedAuthority; -import org.springframework.security.core.userdetails.User; +import org.springframework.security.core.userdetails.UserDetails; import org.springframework.security.web.authentication.UsernamePasswordAuthenticationFilter; import org.springframework.security.web.util.matcher.AntPathRequestMatcher; -import jakarta.servlet.FilterChain; -import jakarta.servlet.ServletException; -import jakarta.servlet.http.HttpServletRequest; -import jakarta.servlet.http.HttpServletResponse; +import javax.servlet.FilterChain; +import javax.servlet.ServletException; +import javax.servlet.http.HttpServletRequest; +import javax.servlet.http.HttpServletResponse; import java.io.IOException; import java.nio.charset.StandardCharsets; import java.util.stream.Collectors; @@ -33,15 +33,15 @@ @Slf4j public class MyLoginFilter extends UsernamePasswordAuthenticationFilter { - private final Jwt jwt; + private final TokenGateway tokenGateway; private final SecurityLoginHandler loginHandler; - public MyLoginFilter(AuthenticationManager authenticationManager, Jwt jwt, SecurityLoginHandler loginHandler, SecurityJwtProperties securityJwtProperties) { + public MyLoginFilter(AuthenticationManager authenticationManager, TokenGateway tokenGateway, SecurityLoginHandler loginHandler, CodingApiSecurityProperties securityProperties) { super(authenticationManager); - this.jwt = jwt; + this.tokenGateway = tokenGateway; this.loginHandler = loginHandler; - this.setRequiresAuthenticationRequestMatcher(new AntPathRequestMatcher(securityJwtProperties.getLoginProcessingUrl(), "POST")); + this.setRequiresAuthenticationRequestMatcher(new AntPathRequestMatcher(securityProperties.getLoginProcessingUrl(), "POST")); } @Override @@ -58,7 +58,7 @@ public Authentication attemptAuthentication(HttpServletRequest request, HttpServ throw new AuthenticationServiceException("request stream read was null."); } try { - loginHandler.preHandle(request,response,login); + loginHandler.preHandle(request, response, login); } catch (Exception e) { throw new AuthenticationServiceException(e.getLocalizedMessage()); } @@ -69,19 +69,21 @@ public Authentication attemptAuthentication(HttpServletRequest request, HttpServ @Override protected void successfulAuthentication(HttpServletRequest request, HttpServletResponse response, FilterChain chain, Authentication authResult) throws IOException, ServletException { log.debug("login success authentication ~"); - User user = (User) authResult.getPrincipal(); + UserDetails user = (UserDetails) authResult.getPrincipal(); LoginRequest loginRequest = LoginRequestContext.getInstance().get(); - Token token = jwt.create(user.getUsername(), loginRequest.getPassword(), + Token token = tokenGateway.create(user.getUsername(), loginRequest.getPassword(), user.getAuthorities().stream().map(GrantedAuthority::getAuthority).collect(Collectors.toList()), TokenContext.getExtra()); - LoginResponse login = new LoginResponse(); - login.setUsername(user.getUsername()); - login.setToken(token.getToken()); - login.setAuthorities(token.getAuthorities()); + LoginResponse loginResponse = loginHandler.postHandle(request, response, loginRequest, user, token); + + String content = JSONObject.toJSONString(SingleResponse.of(loginResponse)); + + // 设置响应的 Content-Type 为 JSON，并指定字符编码为 UTF-8 + response.setContentType("application/json;charset=UTF-8"); + response.setCharacterEncoding("UTF-8"); - String content = JSONObject.toJSONString(SingleResponse.of(login)); IOUtils.write(content, response.getOutputStream(), StandardCharsets.UTF_8); LoginRequestContext.getInstance().clean(); @@ -92,7 +94,13 @@ protected void successfulAuthentication(HttpServletRequest request, HttpServletR protected void unsuccessfulAuthentication(HttpServletRequest request, HttpServletResponse response, AuthenticationException failed) throws IOException, ServletException { log.debug("login fail authentication ~"); String content = JSONObject.toJSONString(Response.buildFailure("login.error", failed.getMessage())); + + // 设置响应的 Content-Type 为 JSON，并指定字符编码为 UTF-8 + response.setContentType("application/json;charset=UTF-8"); + response.setCharacterEncoding("UTF-8"); + IOUtils.write(content, response.getOutputStream(), StandardCharsets.UTF_8); + LoginRequestContext.getInstance().clean(); } } diff --git a/springboot-starter-security-jwt/src/main/java/com/codingapi/springboot/security/filter/MyLogoutHandler.java b/springboot-starter-security/src/main/java/com/codingapi/springboot/security/filter/MyLogoutHandler.java similarity index 82% rename from springboot-starter-security-jwt/src/main/java/com/codingapi/springboot/security/filter/MyLogoutHandler.java rename to springboot-starter-security/src/main/java/com/codingapi/springboot/security/filter/MyLogoutHandler.java index a27c9d76f..b2cbe8d2d 100644 --- a/springboot-starter-security-jwt/src/main/java/com/codingapi/springboot/security/filter/MyLogoutHandler.java +++ b/springboot-starter-security/src/main/java/com/codingapi/springboot/security/filter/MyLogoutHandler.java @@ -4,8 +4,9 @@ import org.springframework.security.core.Authentication; import org.springframework.security.web.authentication.logout.LogoutHandler; -import jakarta.servlet.http.HttpServletRequest; -import jakarta.servlet.http.HttpServletResponse; +import javax.servlet.http.HttpServletRequest; +import javax.servlet.http.HttpServletResponse; + @Slf4j public class MyLogoutHandler implements LogoutHandler { diff --git a/springboot-starter-security-jwt/src/main/java/com/codingapi/springboot/security/filter/MyLogoutSuccessHandler.java b/springboot-starter-security/src/main/java/com/codingapi/springboot/security/filter/MyLogoutSuccessHandler.java similarity index 73% rename from springboot-starter-security-jwt/src/main/java/com/codingapi/springboot/security/filter/MyLogoutSuccessHandler.java rename to springboot-starter-security/src/main/java/com/codingapi/springboot/security/filter/MyLogoutSuccessHandler.java index 16a86c683..5b6520a63 100644 --- a/springboot-starter-security-jwt/src/main/java/com/codingapi/springboot/security/filter/MyLogoutSuccessHandler.java +++ b/springboot-starter-security/src/main/java/com/codingapi/springboot/security/filter/MyLogoutSuccessHandler.java @@ -7,9 +7,9 @@ import org.springframework.security.core.Authentication; import org.springframework.security.web.authentication.logout.LogoutSuccessHandler; -import jakarta.servlet.ServletException; -import jakarta.servlet.http.HttpServletRequest; -import jakarta.servlet.http.HttpServletResponse; +import javax.servlet.ServletException; +import javax.servlet.http.HttpServletRequest; +import javax.servlet.http.HttpServletResponse; import java.io.IOException; import java.nio.charset.StandardCharsets; @@ -20,6 +20,10 @@ public class MyLogoutSuccessHandler implements LogoutSuccessHandler { public void onLogoutSuccess(HttpServletRequest request, HttpServletResponse response, Authentication authentication) throws IOException, ServletException { log.debug("logout success ~"); String content = JSONObject.toJSONString(Response.buildSuccess()); + // 设置响应的 Content-Type 为 JSON，并指定字符编码为 UTF-8 + response.setContentType("application/json;charset=UTF-8"); + response.setCharacterEncoding("UTF-8"); + IOUtils.write(content, response.getOutputStream(), StandardCharsets.UTF_8); } } diff --git a/springboot-starter-security-jwt/src/main/java/com/codingapi/springboot/security/filter/MyUnAuthenticationEntryPoint.java b/springboot-starter-security/src/main/java/com/codingapi/springboot/security/filter/MyUnAuthenticationEntryPoint.java similarity index 73% rename from springboot-starter-security-jwt/src/main/java/com/codingapi/springboot/security/filter/MyUnAuthenticationEntryPoint.java rename to springboot-starter-security/src/main/java/com/codingapi/springboot/security/filter/MyUnAuthenticationEntryPoint.java index ecc91b959..885b6241f 100644 --- a/springboot-starter-security-jwt/src/main/java/com/codingapi/springboot/security/filter/MyUnAuthenticationEntryPoint.java +++ b/springboot-starter-security/src/main/java/com/codingapi/springboot/security/filter/MyUnAuthenticationEntryPoint.java @@ -7,9 +7,10 @@ import org.springframework.security.core.AuthenticationException; import org.springframework.security.web.AuthenticationEntryPoint; -import jakarta.servlet.ServletException; -import jakarta.servlet.http.HttpServletRequest; -import jakarta.servlet.http.HttpServletResponse; + +import javax.servlet.ServletException; +import javax.servlet.http.HttpServletRequest; +import javax.servlet.http.HttpServletResponse; import java.io.IOException; import java.nio.charset.StandardCharsets; @@ -20,6 +21,10 @@ public class MyUnAuthenticationEntryPoint implements AuthenticationEntryPoint { public void commence(HttpServletRequest request, HttpServletResponse response, AuthenticationException authException) throws IOException, ServletException { log.debug("no authentication ~"); String content = JSONObject.toJSONString(Response.buildFailure("not.login", "please to login.")); + // 设置响应的 Content-Type 为 JSON，并指定字符编码为 UTF-8 + response.setContentType("application/json;charset=UTF-8"); + response.setCharacterEncoding("UTF-8"); + IOUtils.write(content, response.getOutputStream(), StandardCharsets.UTF_8); } } diff --git a/springboot-starter-security/src/main/java/com/codingapi/springboot/security/filter/SecurityLoginHandler.java b/springboot-starter-security/src/main/java/com/codingapi/springboot/security/filter/SecurityLoginHandler.java new file mode 100644 index 000000000..db7bc6870 --- /dev/null +++ b/springboot-starter-security/src/main/java/com/codingapi/springboot/security/filter/SecurityLoginHandler.java @@ -0,0 +1,17 @@ +package com.codingapi.springboot.security.filter; + +import com.codingapi.springboot.security.dto.request.LoginRequest; +import com.codingapi.springboot.security.dto.response.LoginResponse; +import com.codingapi.springboot.security.gateway.Token; +import org.springframework.security.core.userdetails.UserDetails; + +import javax.servlet.http.HttpServletRequest; +import javax.servlet.http.HttpServletResponse; + + +public interface SecurityLoginHandler { + + void preHandle(HttpServletRequest request, HttpServletResponse response, LoginRequest loginRequest) throws Exception; + + LoginResponse postHandle(HttpServletRequest request, HttpServletResponse response, LoginRequest loginRequest, UserDetails userDetails, Token token); +} diff --git a/springboot-starter-security-jwt/src/main/java/com/codingapi/springboot/security/jwt/Token.java b/springboot-starter-security/src/main/java/com/codingapi/springboot/security/gateway/Token.java similarity index 91% rename from springboot-starter-security-jwt/src/main/java/com/codingapi/springboot/security/jwt/Token.java rename to springboot-starter-security/src/main/java/com/codingapi/springboot/security/gateway/Token.java index a3fd6345a..9579a9b35 100644 --- a/springboot-starter-security-jwt/src/main/java/com/codingapi/springboot/security/jwt/Token.java +++ b/springboot-starter-security/src/main/java/com/codingapi/springboot/security/gateway/Token.java @@ -1,8 +1,8 @@ -package com.codingapi.springboot.security.jwt; +package com.codingapi.springboot.security.gateway; import com.alibaba.fastjson.JSONObject; import com.codingapi.springboot.framework.serializable.JsonSerializable; -import com.codingapi.springboot.security.crypto.MyAES; +import com.codingapi.springboot.security.crypto.AESTools; import com.codingapi.springboot.security.exception.TokenExpiredException; import lombok.Getter; import lombok.NoArgsConstructor; @@ -34,7 +34,7 @@ public Token(String username, String iv,String extra, List authorities, this.username = username; this.extra = extra; if(iv!=null) { - this.iv = MyAES.getInstance().encode(iv); + this.iv = AESTools.getInstance().encode(iv); } this.authorities = authorities; this.expireTime = System.currentTimeMillis() + expireValue; @@ -56,7 +56,7 @@ public String decodeIv(){ if(iv==null){ return null; } - return MyAES.getInstance().decode(iv); + return AESTools.getInstance().decode(iv); } diff --git a/springboot-starter-security-jwt/src/main/java/com/codingapi/springboot/security/jwt/TokenContext.java b/springboot-starter-security/src/main/java/com/codingapi/springboot/security/gateway/TokenContext.java similarity index 91% rename from springboot-starter-security-jwt/src/main/java/com/codingapi/springboot/security/jwt/TokenContext.java rename to springboot-starter-security/src/main/java/com/codingapi/springboot/security/gateway/TokenContext.java index 99b37a7cc..e3ecaa8f5 100644 --- a/springboot-starter-security-jwt/src/main/java/com/codingapi/springboot/security/jwt/TokenContext.java +++ b/springboot-starter-security/src/main/java/com/codingapi/springboot/security/gateway/TokenContext.java @@ -1,4 +1,4 @@ -package com.codingapi.springboot.security.jwt; +package com.codingapi.springboot.security.gateway; import org.springframework.security.core.context.SecurityContextHolder; diff --git a/springboot-starter-security/src/main/java/com/codingapi/springboot/security/gateway/TokenGateway.java b/springboot-starter-security/src/main/java/com/codingapi/springboot/security/gateway/TokenGateway.java new file mode 100644 index 000000000..b339079d6 --- /dev/null +++ b/springboot-starter-security/src/main/java/com/codingapi/springboot/security/gateway/TokenGateway.java @@ -0,0 +1,23 @@ +package com.codingapi.springboot.security.gateway; + +import java.util.List; + +public interface TokenGateway { + + Token create(String username, String iv, List authorities, String extra); + + default Token create(String username, String iv, List authorities) { + return create(username, iv, authorities, null); + } + + default Token create(String username, List authorities) { + return create(username, null, authorities, null); + } + + default Token create(String username, List authorities, String extra) { + return create(username, null, authorities, extra); + } + + Token parser(String sign); + +} diff --git a/springboot-starter-security/src/main/java/com/codingapi/springboot/security/jwt/JWTSecurityConfiguration.java b/springboot-starter-security/src/main/java/com/codingapi/springboot/security/jwt/JWTSecurityConfiguration.java new file mode 100644 index 000000000..54df5b3ca --- /dev/null +++ b/springboot-starter-security/src/main/java/com/codingapi/springboot/security/jwt/JWTSecurityConfiguration.java @@ -0,0 +1,35 @@ +package com.codingapi.springboot.security.jwt; + +import com.codingapi.springboot.security.gateway.TokenGateway; +import org.springframework.boot.autoconfigure.condition.ConditionalOnMissingBean; +import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty; +import org.springframework.boot.context.properties.ConfigurationProperties; +import org.springframework.context.annotation.Bean; +import org.springframework.context.annotation.Configuration; + +@Configuration +@ConditionalOnProperty(prefix = "codingapi.security.jwt", name = "enable", havingValue = "true") +public class JWTSecurityConfiguration { + + + @Bean + @ConfigurationProperties(prefix = "codingapi.security.jwt") + public SecurityJWTProperties securityJWTProperties() { + return new SecurityJWTProperties(); + } + + + @Bean + @ConditionalOnMissingBean + public JwtTokenGateway jwtTokenGateway(SecurityJWTProperties properties) { + return new JwtTokenGateway(properties); + } + + + @Bean + @ConditionalOnMissingBean + public TokenGateway jwtTokenGatewayImpl(JwtTokenGateway jwtTokenGateway) { + return new JWTTokenGatewayImpl(jwtTokenGateway); + } + +} diff --git a/springboot-starter-security/src/main/java/com/codingapi/springboot/security/jwt/JWTTokenGatewayImpl.java b/springboot-starter-security/src/main/java/com/codingapi/springboot/security/jwt/JWTTokenGatewayImpl.java new file mode 100644 index 000000000..4a890ab7e --- /dev/null +++ b/springboot-starter-security/src/main/java/com/codingapi/springboot/security/jwt/JWTTokenGatewayImpl.java @@ -0,0 +1,25 @@ +package com.codingapi.springboot.security.jwt; + +import com.codingapi.springboot.security.gateway.Token; +import com.codingapi.springboot.security.gateway.TokenGateway; + +import java.util.List; + +public class JWTTokenGatewayImpl implements TokenGateway { + + private final JwtTokenGateway jwtTokenGateway; + + public JWTTokenGatewayImpl(JwtTokenGateway jwtTokenGateway) { + this.jwtTokenGateway = jwtTokenGateway; + } + + @Override + public Token create(String username, String password, List authorities, String extra) { + return jwtTokenGateway.create(username, password, authorities, extra); + } + + @Override + public Token parser(String sign) { + return jwtTokenGateway.parser(sign); + } +} diff --git a/springboot-starter-security-jwt/src/main/java/com/codingapi/springboot/security/jwt/Jwt.java b/springboot-starter-security/src/main/java/com/codingapi/springboot/security/jwt/JwtTokenGateway.java similarity index 64% rename from springboot-starter-security-jwt/src/main/java/com/codingapi/springboot/security/jwt/Jwt.java rename to springboot-starter-security/src/main/java/com/codingapi/springboot/security/jwt/JwtTokenGateway.java index c1b7a2b83..57dab4853 100644 --- a/springboot-starter-security-jwt/src/main/java/com/codingapi/springboot/security/jwt/Jwt.java +++ b/springboot-starter-security/src/main/java/com/codingapi/springboot/security/jwt/JwtTokenGateway.java @@ -2,28 +2,29 @@ import com.alibaba.fastjson.JSONObject; import com.codingapi.springboot.framework.exception.LocaleMessageException; +import com.codingapi.springboot.security.gateway.Token; import io.jsonwebtoken.Claims; import io.jsonwebtoken.Jws; import io.jsonwebtoken.Jwts; import io.jsonwebtoken.security.Keys; +import javax.crypto.SecretKey; import java.nio.charset.StandardCharsets; -import java.security.Key; import java.util.List; -public class Jwt { +public class JwtTokenGateway { - private final Key key; - private final int jwtTime; - private final int jwtRestTime; + private final SecretKey key; + private final int validTime; + private final int restTime; - public Jwt(String secretKey, int jwtTime, int jwtRestTime) { - this.key = Keys.hmacShaKeyFor(secretKey.getBytes(StandardCharsets.UTF_8)); - this.jwtTime = jwtTime; - this.jwtRestTime = jwtRestTime; + public JwtTokenGateway(SecurityJWTProperties properties) { + this.key = Keys.hmacShaKeyFor(properties.getSecretKey().getBytes(StandardCharsets.UTF_8)); + this.validTime = properties.getValidTime(); + this.restTime = properties.getRestTime(); } - public Token create(String username, List authorities,String extra){ + public Token create(String username, List authorities, String extra){ return create(username, null,authorities, extra); } @@ -36,17 +37,17 @@ public Token create(String username, String iv, List authorities){ } public Token create(String username, String iv,List authorities,String extra){ - Token token = new Token(username, iv,extra, authorities, jwtTime, jwtRestTime); - String jwt = Jwts.builder().setSubject(token.toJson()).signWith(key).compact(); + Token token = new Token(username, iv,extra, authorities, validTime, restTime); + String jwt = Jwts.builder().subject(token.toJson()).signWith(key).compact(); token.setToken(jwt); return token; } public Token parser(String sign) { try { - Jws jws = Jwts.parserBuilder().setSigningKey(key).build().parseClaimsJws(sign); + Jws jws = Jwts.parser().verifyWith(key).build().parseSignedClaims(sign); if (jws != null) { - String subject = jws.getBody().getSubject(); + String subject = jws.getPayload().getSubject(); return JSONObject.parseObject(subject, Token.class); } throw new LocaleMessageException("token.error", "token失效,请重新登录."); diff --git a/springboot-starter-security/src/main/java/com/codingapi/springboot/security/jwt/SecurityJWTProperties.java b/springboot-starter-security/src/main/java/com/codingapi/springboot/security/jwt/SecurityJWTProperties.java new file mode 100644 index 000000000..d4ca0537f --- /dev/null +++ b/springboot-starter-security/src/main/java/com/codingapi/springboot/security/jwt/SecurityJWTProperties.java @@ -0,0 +1,35 @@ +package com.codingapi.springboot.security.jwt; + +import lombok.Getter; +import lombok.Setter; + +@Setter +@Getter +public class SecurityJWTProperties { + + + /** + * 是否启用JWT + */ + private boolean enable = true; + + /** + * JWT密钥 + * 需大于32位的字符串 + */ + private String secretKey = "codingapi.security.jwt.secretkey"; + + + /** + * JWT 有效时间(毫秒) + * 15分钟有效期 1000*60*15=900000 + */ + private int validTime = 900000; + + /** + * JWT 更换令牌时间(毫秒) + * 10分钟后更换令牌 1000*60*10=600000 + */ + private int restTime = 600000; + +} diff --git a/springboot-starter-security-jwt/src/main/java/com/codingapi/springboot/security/properties/SecurityJwtProperties.java b/springboot-starter-security/src/main/java/com/codingapi/springboot/security/properties/CodingApiSecurityProperties.java similarity index 72% rename from springboot-starter-security-jwt/src/main/java/com/codingapi/springboot/security/properties/SecurityJwtProperties.java rename to springboot-starter-security/src/main/java/com/codingapi/springboot/security/properties/CodingApiSecurityProperties.java index 5c296e806..0db1dad03 100644 --- a/springboot-starter-security-jwt/src/main/java/com/codingapi/springboot/security/properties/SecurityJwtProperties.java +++ b/springboot-starter-security/src/main/java/com/codingapi/springboot/security/properties/CodingApiSecurityProperties.java @@ -5,58 +5,48 @@ @Setter @Getter -public class SecurityJwtProperties { +public class CodingApiSecurityProperties { /** - * JWT密钥 - * 需大于32位的字符串 + * 权限拦截URL */ - private String jwtSecretKey = "codingapi.security.jwt.secretkey"; - + private String authenticatedUrls = "/api/**"; - /** - * aes key - */ - private String aseKey = "QUNEWCQlXiYqJCNYQ1phc0FDRFgkJV4mKiQjWENaYXM="; /** - * aes iv + * 登录接口地址 */ - private String aseIv = "QUNYRkdIQEVEUyNYQ1phcw=="; - + private String loginProcessingUrl = "/user/login"; /** - * JWT 有效时间(毫秒) - * 15分钟有效期 1000*60*15=900000 + * 退出登录接口地址 */ - private int jwtTime = 900000; + private String logoutUrl = "/user/logout"; /** - * JWT 更换令牌时间(毫秒) - * 10分钟后更换令牌 1000*60*10=600000 + * 放开接口地址 */ - private int jwtRestTime = 600000; + private String ignoreUrls = "/open/**"; /** - * 权限拦截URL + * aes key */ - private String authenticatedUrls = "/api/**"; - + private String aseKey = "QUNEWCQlXiYqJCNYQ1phc0FDRFgkJV4mKiQjWENaYXM="; /** - * 登录接口地址 + * aes iv */ - private String loginProcessingUrl = "/user/login"; + private String aseIv = "QUNYRkdIQEVEUyNYQ1phcw=="; /** - * 退出登录接口地址 + * 禁用Basic Auth */ - private String logoutUrl = "/user/logout"; + private boolean disableBasicAuth = true; /** - * 放开接口地址 + * 禁用FrameOptions */ - private String ignoreUrls = "/open/**"; + private boolean disableFrameOptions = true; /** * 启用禁用CSRF diff --git a/springboot-starter-security/src/main/java/com/codingapi/springboot/security/redis/RedisSecurityConfiguration.java b/springboot-starter-security/src/main/java/com/codingapi/springboot/security/redis/RedisSecurityConfiguration.java new file mode 100644 index 000000000..c4bf141b2 --- /dev/null +++ b/springboot-starter-security/src/main/java/com/codingapi/springboot/security/redis/RedisSecurityConfiguration.java @@ -0,0 +1,35 @@ +package com.codingapi.springboot.security.redis; + +import com.codingapi.springboot.security.gateway.TokenGateway; +import org.springframework.boot.autoconfigure.condition.ConditionalOnMissingBean; +import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty; +import org.springframework.boot.context.properties.ConfigurationProperties; +import org.springframework.context.annotation.Bean; +import org.springframework.context.annotation.Configuration; +import org.springframework.data.redis.core.RedisTemplate; + +@Configuration +@ConditionalOnProperty(prefix = "codingapi.security.redis", name = "enable", havingValue = "true") +public class RedisSecurityConfiguration { + + + @Bean + @ConfigurationProperties(prefix = "codingapi.security.redis") + public SecurityRedisProperties securityRedisProperties() { + return new SecurityRedisProperties(); + } + + + @Bean + @ConditionalOnMissingBean + public RedisTokenGateway redisTokenGateway(RedisTemplate redisTemplate, SecurityRedisProperties properties) { + return new RedisTokenGateway(redisTemplate, properties); + } + + @Bean + @ConditionalOnMissingBean + public TokenGateway redisTokenGatewayImpl(RedisTokenGateway redisTokenGateway) { + return new RedisTokenGatewayImpl(redisTokenGateway); + } + +} diff --git a/springboot-starter-security/src/main/java/com/codingapi/springboot/security/redis/RedisTokenGateway.java b/springboot-starter-security/src/main/java/com/codingapi/springboot/security/redis/RedisTokenGateway.java new file mode 100644 index 000000000..d3db8c5da --- /dev/null +++ b/springboot-starter-security/src/main/java/com/codingapi/springboot/security/redis/RedisTokenGateway.java @@ -0,0 +1,122 @@ +package com.codingapi.springboot.security.redis; + +import com.alibaba.fastjson2.JSONObject; +import com.codingapi.springboot.framework.crypto.AESUtils; +import com.codingapi.springboot.security.gateway.Token; +import lombok.SneakyThrows; +import org.springframework.data.redis.core.RedisTemplate; + +import java.util.ArrayList; +import java.util.List; +import java.util.Set; +import java.util.UUID; +import java.util.concurrent.TimeUnit; +import java.util.function.Predicate; + +public class RedisTokenGateway { + + private final RedisTemplate redisTemplate; + private final int validTime; + private final int restTime; + + public RedisTokenGateway(RedisTemplate redisTemplate, SecurityRedisProperties properties) { + this.redisTemplate = redisTemplate; + this.validTime = properties.getValidTime(); + this.restTime = properties.getRestTime(); + } + + public Token create(String username, String iv, List authorities, String extra) { + Token token = new Token(username, iv, extra, authorities, validTime, restTime); + String usernameEncode = this.encodeUsername(username); + String key = String.format("%s:%s", usernameEncode, UUID.randomUUID().toString().replaceAll("-", "")); + token.setToken(key); + redisTemplate.opsForValue().set(key, token.toJson(), validTime, TimeUnit.MILLISECONDS); + return token; + } + + /** + * 根据token获取用户信息 + * + * @param token token + * @return 用户信息 + */ + public Token getToken(String token) { + String json = redisTemplate.opsForValue().get(token); + if (json == null) { + return null; + } + return JSONObject.parseObject(json, Token.class); + } + + /** + * 删除token + * + * @param token token + */ + public void removeToken(String token) { + redisTemplate.delete(token); + } + + /** + * 重置token + * + * @param token token + */ + public void resetToken(Token token) { + redisTemplate.opsForValue().set(token.getToken(), token.toJson(), validTime, TimeUnit.MILLISECONDS); + } + + /** + * 删除用户 + * + * @param username 用户名 + */ + public void removeUsername(String username) { + String usernameEncode = this.encodeUsername(username); + Set keys = redisTemplate.keys(usernameEncode + ":*"); + if (!keys.isEmpty()) { + redisTemplate.delete(keys); + } + } + + + @SneakyThrows + private String encodeUsername(String username){ + return AESUtils.getInstance().encode(username); + } + + + /** + * 获取用户的所有token + * + * @param username 用户名 + * @return token列表 + */ + public List getTokensByUsername(String username) { + String usernameEncode = this.encodeUsername(username); + Set keys = redisTemplate.keys(usernameEncode + ":*"); + return new ArrayList<>(keys); + } + + + /** + * 自定义删除用户 + * + * @param username 用户名 + * @param predicate 条件 + */ + public void removeUsername(String username, Predicate predicate) { + String usernameEncode = this.encodeUsername(username); + Set keys = redisTemplate.keys(usernameEncode + ":*"); + if (!keys.isEmpty()) { + for (String key : keys) { + Token token = getToken(key); + if (token != null && predicate.test(token)) { + redisTemplate.delete(key); + } + } + } + } + + +} diff --git a/springboot-starter-security/src/main/java/com/codingapi/springboot/security/redis/RedisTokenGatewayImpl.java b/springboot-starter-security/src/main/java/com/codingapi/springboot/security/redis/RedisTokenGatewayImpl.java new file mode 100644 index 000000000..8973f26df --- /dev/null +++ b/springboot-starter-security/src/main/java/com/codingapi/springboot/security/redis/RedisTokenGatewayImpl.java @@ -0,0 +1,26 @@ +package com.codingapi.springboot.security.redis; + +import com.codingapi.springboot.security.gateway.Token; +import com.codingapi.springboot.security.gateway.TokenGateway; + +import java.util.List; + +public class RedisTokenGatewayImpl implements TokenGateway { + + private final RedisTokenGateway redisTokenGateway; + + public RedisTokenGatewayImpl(RedisTokenGateway redisTokenGateway) { + this.redisTokenGateway = redisTokenGateway; + } + + @Override + public Token create(String username, String iv, List authorities, String extra) { + return redisTokenGateway.create(username, iv, authorities, extra); + } + + @Override + public Token parser(String sign) { + return redisTokenGateway.getToken(sign); + } + +} diff --git a/springboot-starter-security/src/main/java/com/codingapi/springboot/security/redis/SecurityRedisProperties.java b/springboot-starter-security/src/main/java/com/codingapi/springboot/security/redis/SecurityRedisProperties.java new file mode 100644 index 000000000..14eae9ac0 --- /dev/null +++ b/springboot-starter-security/src/main/java/com/codingapi/springboot/security/redis/SecurityRedisProperties.java @@ -0,0 +1,27 @@ +package com.codingapi.springboot.security.redis; + +import lombok.Getter; +import lombok.Setter; + +@Setter +@Getter +public class SecurityRedisProperties { + + + /** + * 是否启用redis + */ + private boolean enable = true; + + /** + * 15分钟有效期 1000*60*15=900000 + */ + private int validTime = 900000; + + /** + * 10分钟后更换令牌 1000*60*10=600000 + */ + private int restTime = 600000; + + +} diff --git a/springboot-starter-security/src/main/resources/META-INF/spring.factories b/springboot-starter-security/src/main/resources/META-INF/spring.factories new file mode 100644 index 000000000..6fbb976a1 --- /dev/null +++ b/springboot-starter-security/src/main/resources/META-INF/spring.factories @@ -0,0 +1,6 @@ +org.springframework.boot.autoconfigure.EnableAutoConfiguration=\ +com.codingapi.springboot.security.configurer.WebSecurityConfigurer,\ +com.codingapi.springboot.security.crypto.SecurityCryptoConfiguration,\ +com.codingapi.springboot.security.jwt.JWTSecurityConfiguration,\ +com.codingapi.springboot.security.redis.RedisSecurityConfiguration,\ +com.codingapi.springboot.security.AutoConfiguration \ No newline at end of file diff --git a/springboot-starter-security/src/main/resources/META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports b/springboot-starter-security/src/main/resources/META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports new file mode 100644 index 000000000..59324754c --- /dev/null +++ b/springboot-starter-security/src/main/resources/META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports @@ -0,0 +1,5 @@ +com.codingapi.springboot.security.configurer.WebSecurityConfigurer +com.codingapi.springboot.security.crypto.SecurityCryptoConfiguration +com.codingapi.springboot.security.jwt.JWTSecurityConfiguration +com.codingapi.springboot.security.redis.RedisSecurityConfiguration +com.codingapi.springboot.security.AutoConfiguration \ No newline at end of file diff --git a/springboot-starter-security-jwt/src/test/java/com/codingapi/springboot/security/SecurityJwtApplication.java b/springboot-starter-security/src/test/java/com/codingapi/springboot/security/SecurityJwtApplication.java similarity index 100% rename from springboot-starter-security-jwt/src/test/java/com/codingapi/springboot/security/SecurityJwtApplication.java rename to springboot-starter-security/src/test/java/com/codingapi/springboot/security/SecurityJwtApplication.java diff --git a/springboot-starter-security-jwt/src/test/java/com/codingapi/springboot/security/SecurityJwtApplicationTest.java b/springboot-starter-security/src/test/java/com/codingapi/springboot/security/SecurityJwtApplicationTest.java similarity index 92% rename from springboot-starter-security-jwt/src/test/java/com/codingapi/springboot/security/SecurityJwtApplicationTest.java rename to springboot-starter-security/src/test/java/com/codingapi/springboot/security/SecurityJwtApplicationTest.java index 3872eadc6..cd78167b2 100644 --- a/springboot-starter-security-jwt/src/test/java/com/codingapi/springboot/security/SecurityJwtApplicationTest.java +++ b/springboot-starter-security/src/test/java/com/codingapi/springboot/security/SecurityJwtApplicationTest.java @@ -7,14 +7,14 @@ import org.springframework.boot.test.autoconfigure.web.servlet.AutoConfigureMockMvc; import org.springframework.boot.test.context.SpringBootTest; import org.springframework.http.MediaType; +import org.springframework.security.crypto.password.PasswordEncoder; import org.springframework.test.web.servlet.MockMvc; import org.springframework.test.web.servlet.MvcResult; import org.springframework.util.StringUtils; import java.nio.charset.StandardCharsets; -import static org.junit.jupiter.api.Assertions.assertEquals; -import static org.junit.jupiter.api.Assertions.assertTrue; +import static org.junit.jupiter.api.Assertions.*; import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.get; import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.post; import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.status; @@ -27,6 +27,20 @@ public class SecurityJwtApplicationTest { @Autowired private MockMvc mockMvc; + + @Autowired + private PasswordEncoder passwordEncoder; + + + @Test + void encode(){ + String pwd1 = passwordEncoder.encode("123456"); + String pwd2 = passwordEncoder.encode("123456"); + System.out.println(pwd1); + System.out.println(pwd2); + assertNotEquals(pwd1,pwd2); + } + @Test void login() throws Exception { JSONObject json = new JSONObject(); @@ -37,6 +51,7 @@ void login() throws Exception { .contentType(MediaType.APPLICATION_JSON)).andExpect(status().isOk()); } + @Test void loginError() throws Exception { JSONObject json = new JSONObject(); diff --git a/springboot-starter-security/src/test/java/com/codingapi/springboot/security/configurer/WebSecurityConfigurerTest.java b/springboot-starter-security/src/test/java/com/codingapi/springboot/security/configurer/WebSecurityConfigurerTest.java new file mode 100644 index 000000000..6d48d7992 --- /dev/null +++ b/springboot-starter-security/src/test/java/com/codingapi/springboot/security/configurer/WebSecurityConfigurerTest.java @@ -0,0 +1,29 @@ +package com.codingapi.springboot.security.configurer; + +import com.codingapi.springboot.security.properties.CodingApiSecurityProperties; +import org.junit.jupiter.api.Test; +import org.mockito.Mockito; +import org.springframework.security.config.annotation.web.builders.WebSecurity; + +import static org.mockito.Mockito.verify; + +/** + * WebSecurityConfigurer 单元测试 + *

+ * 通过 mock WebSecurity 验证 ignoreUrls 被注册到 ignoring 列表。 + */ +class WebSecurityConfigurerTest { + + @Test + void customizeRegistersIgnoreUrls() { + CodingApiSecurityProperties properties = new CodingApiSecurityProperties(); + properties.setIgnoreUrls("/open/**,/public/**"); + WebSecurityConfigurer configurer = new WebSecurityConfigurer(properties); + + WebSecurity webSecurity = Mockito.mock(WebSecurity.class, Mockito.RETURNS_DEEP_STUBS); + configurer.customize(webSecurity); + + verify(webSecurity.ignoring()).antMatchers("/open/**", "/public/**"); + } + +} diff --git a/springboot-starter-security-jwt/src/test/java/com/codingapi/springboot/security/controller/DemoController.java b/springboot-starter-security/src/test/java/com/codingapi/springboot/security/controller/DemoController.java similarity index 100% rename from springboot-starter-security-jwt/src/test/java/com/codingapi/springboot/security/controller/DemoController.java rename to springboot-starter-security/src/test/java/com/codingapi/springboot/security/controller/DemoController.java diff --git a/springboot-starter-security/src/test/java/com/codingapi/springboot/security/crypto/AESToolsTest.java b/springboot-starter-security/src/test/java/com/codingapi/springboot/security/crypto/AESToolsTest.java new file mode 100644 index 000000000..89622feae --- /dev/null +++ b/springboot-starter-security/src/test/java/com/codingapi/springboot/security/crypto/AESToolsTest.java @@ -0,0 +1,70 @@ +package com.codingapi.springboot.security.crypto; + +import com.codingapi.springboot.framework.crypto.AES; +import com.codingapi.springboot.framework.crypto.AESUtils; +import com.codingapi.springboot.security.properties.CodingApiSecurityProperties; +import org.junit.jupiter.api.BeforeEach; +import org.junit.jupiter.api.Test; + +import java.nio.charset.StandardCharsets; +import java.util.Base64; + +import static org.junit.jupiter.api.Assertions.assertArrayEquals; +import static org.junit.jupiter.api.Assertions.assertEquals; +import static org.junit.jupiter.api.Assertions.assertNotEquals; +import static org.junit.jupiter.api.Assertions.assertNotNull; +import static org.junit.jupiter.api.Assertions.assertSame; + +/** + * AESTools 单元测试 + *

+ * 覆盖字符串与字节数组的加解密往返逻辑。 + * 测试类与 AESTools 同包，可调用包级私有的 init 方法。 + */ +class AESToolsTest { + + @BeforeEach + void setUp() throws Exception { + AES aes = new AES(Base64.getDecoder().decode(AESUtils.key), Base64.getDecoder().decode(AESUtils.iv)); + AESTools.getInstance().init(aes); + } + + @Test + void getInstanceReturnsSingleton() { + assertSame(AESTools.getInstance(), AESTools.getInstance()); + } + + @Test + void encodeAndDecodeStringRoundTrip() { + String input = "hello-世界-123456"; + + String encoded = AESTools.getInstance().encode(input); + assertNotNull(encoded); + assertNotEquals(input, encoded); + + String decoded = AESTools.getInstance().decode(encoded); + assertEquals(input, decoded); + } + + @Test + void encodeAndDecodeBytesRoundTrip() { + byte[] input = "byte-array-input-字节".getBytes(StandardCharsets.UTF_8); + + byte[] encoded = AESTools.getInstance().encode(input); + assertNotNull(encoded); + + byte[] decoded = AESTools.getInstance().decode(encoded); + assertArrayEquals(input, decoded); + } + + @Test + void securityCryptoConfigurationInitializesTools() throws Exception { + AES aes = new SecurityCryptoConfiguration().aes(new CodingApiSecurityProperties()); + assertNotNull(aes); + + // 配置类初始化后 AESTools 可正常完成加解密往返 + String encoded = AESTools.getInstance().encode("config-init"); + assertEquals("config-init", AESTools.getInstance().decode(encoded)); + } + +} diff --git a/springboot-starter-security/src/test/java/com/codingapi/springboot/security/customer/DefaultHttpSecurityCustomerTest.java b/springboot-starter-security/src/test/java/com/codingapi/springboot/security/customer/DefaultHttpSecurityCustomerTest.java new file mode 100644 index 000000000..0b130f8be --- /dev/null +++ b/springboot-starter-security/src/test/java/com/codingapi/springboot/security/customer/DefaultHttpSecurityCustomerTest.java @@ -0,0 +1,115 @@ +package com.codingapi.springboot.security.customer; + +import com.codingapi.springboot.security.properties.CodingApiSecurityProperties; +import org.junit.jupiter.api.Test; +import org.mockito.ArgumentCaptor; +import org.mockito.Mockito; +import org.springframework.security.config.Customizer; +import org.springframework.security.config.annotation.web.builders.HttpSecurity; +import org.springframework.security.config.annotation.web.configurers.CorsConfigurer; +import org.springframework.security.config.annotation.web.configurers.CsrfConfigurer; +import org.springframework.security.config.annotation.web.configurers.HeadersConfigurer; + +import static org.mockito.ArgumentMatchers.any; +import static org.mockito.Mockito.mock; +import static org.mockito.Mockito.never; +import static org.mockito.Mockito.verify; + +/** + * DefaultHttpSecurityCustomer 单元测试 + *

+ * 通过 mock HttpSecurity 覆盖 customize 中各开关的 true/false 分支， + * 并手动触发 cors/csrf/headers 的 Customizer lambda 以覆盖其内部分支。 + */ +class DefaultHttpSecurityCustomerTest { + + @Test + void customizeWithAllDisableFlagsTrue() throws Exception { + HttpSecurity security = mock(HttpSecurity.class, Mockito.RETURNS_DEEP_STUBS); + CodingApiSecurityProperties properties = new CodingApiSecurityProperties(); + + new DefaultHttpSecurityCustomer(properties).customize(security); + + verify(security).httpBasic(any()); + verify(security).headers(any()); + verify(security).cors(any()); + verify(security).csrf(any()); + } + + @Test + void customizeWithBasicAuthAndFrameOptionsEnabled() throws Exception { + HttpSecurity security = mock(HttpSecurity.class, Mockito.RETURNS_DEEP_STUBS); + CodingApiSecurityProperties properties = new CodingApiSecurityProperties(); + properties.setDisableBasicAuth(false); + properties.setDisableFrameOptions(false); + + new DefaultHttpSecurityCustomer(properties).customize(security); + + verify(security, never()).httpBasic(any()); + verify(security, never()).headers(any()); + // cors/csrf 的 Customizer 始终会被调用，内部再根据开关决定是否 disable + verify(security).cors(any()); + verify(security).csrf(any()); + } + + @SuppressWarnings({"unchecked", "rawtypes"}) + @Test + void corsAndCsrfCustomizerDisableWhenFlagsTrue() throws Exception { + HttpSecurity security = mock(HttpSecurity.class, Mockito.RETURNS_DEEP_STUBS); + CodingApiSecurityProperties properties = new CodingApiSecurityProperties(); + new DefaultHttpSecurityCustomer(properties).customize(security); + + ArgumentCaptor corsCaptor = ArgumentCaptor.forClass(Customizer.class); + verify(security).cors(corsCaptor.capture()); + CorsConfigurer corsConfigurer = mock(CorsConfigurer.class); + corsCaptor.getValue().customize(corsConfigurer); + verify(corsConfigurer).disable(); + + ArgumentCaptor csrfCaptor = ArgumentCaptor.forClass(Customizer.class); + verify(security).csrf(csrfCaptor.capture()); + CsrfConfigurer csrfConfigurer = mock(CsrfConfigurer.class); + csrfCaptor.getValue().customize(csrfConfigurer); + verify(csrfConfigurer).disable(); + } + + @SuppressWarnings({"unchecked", "rawtypes"}) + @Test + void corsAndCsrfCustomizerKeepEnabledWhenFlagsFalse() throws Exception { + HttpSecurity security = mock(HttpSecurity.class, Mockito.RETURNS_DEEP_STUBS); + CodingApiSecurityProperties properties = new CodingApiSecurityProperties(); + properties.setDisableCors(false); + properties.setDisableCsrf(false); + new DefaultHttpSecurityCustomer(properties).customize(security); + + ArgumentCaptor corsCaptor = ArgumentCaptor.forClass(Customizer.class); + verify(security).cors(corsCaptor.capture()); + CorsConfigurer corsConfigurer = mock(CorsConfigurer.class); + corsCaptor.getValue().customize(corsConfigurer); + verify(corsConfigurer, never()).disable(); + + ArgumentCaptor csrfCaptor = ArgumentCaptor.forClass(Customizer.class); + verify(security).csrf(csrfCaptor.capture()); + CsrfConfigurer csrfConfigurer = mock(CsrfConfigurer.class); + csrfCaptor.getValue().customize(csrfConfigurer); + verify(csrfConfigurer, never()).disable(); + } + + @SuppressWarnings({"unchecked", "rawtypes"}) + @Test + void headersCustomizerDisablesFrameOptions() throws Exception { + HttpSecurity security = mock(HttpSecurity.class, Mockito.RETURNS_DEEP_STUBS); + new DefaultHttpSecurityCustomer(new CodingApiSecurityProperties()).customize(security); + + ArgumentCaptor headersCaptor = ArgumentCaptor.forClass(Customizer.class); + verify(security).headers(headersCaptor.capture()); + HeadersConfigurer headersConfigurer = mock(HeadersConfigurer.class); + headersCaptor.getValue().customize(headersConfigurer); + + ArgumentCaptor frameOptionsCaptor = ArgumentCaptor.forClass(Customizer.class); + verify(headersConfigurer).frameOptions(frameOptionsCaptor.capture()); + HeadersConfigurer.FrameOptionsConfig frameOptionsConfig = mock(HeadersConfigurer.FrameOptionsConfig.class); + frameOptionsCaptor.getValue().customize(frameOptionsConfig); + verify(frameOptionsConfig).disable(); + } + +} diff --git a/springboot-starter-security/src/test/java/com/codingapi/springboot/security/dto/request/LoginRequestContextTest.java b/springboot-starter-security/src/test/java/com/codingapi/springboot/security/dto/request/LoginRequestContextTest.java new file mode 100644 index 000000000..eaf352f85 --- /dev/null +++ b/springboot-starter-security/src/test/java/com/codingapi/springboot/security/dto/request/LoginRequestContextTest.java @@ -0,0 +1,39 @@ +package com.codingapi.springboot.security.dto.request; + +import org.junit.jupiter.api.AfterEach; +import org.junit.jupiter.api.Test; + +import static org.junit.jupiter.api.Assertions.assertNull; +import static org.junit.jupiter.api.Assertions.assertSame; + +/** + * LoginRequestContext 单元测试 + *

+ * 覆盖单例获取与 ThreadLocal 的 set/get/clean 行为。 + */ +class LoginRequestContextTest { + + @AfterEach + void tearDown() { + LoginRequestContext.getInstance().clean(); + } + + @Test + void getInstanceReturnsSingleton() { + assertSame(LoginRequestContext.getInstance(), LoginRequestContext.getInstance()); + } + + @Test + void setGetAndClean() { + LoginRequestContext context = LoginRequestContext.getInstance(); + LoginRequest request = new LoginRequest(); + request.put("username", "admin"); + + context.set(request); + assertSame(request, context.get()); + + context.clean(); + assertNull(context.get()); + } + +} diff --git a/springboot-starter-security/src/test/java/com/codingapi/springboot/security/dto/request/LoginRequestTest.java b/springboot-starter-security/src/test/java/com/codingapi/springboot/security/dto/request/LoginRequestTest.java new file mode 100644 index 000000000..d7cb735d3 --- /dev/null +++ b/springboot-starter-security/src/test/java/com/codingapi/springboot/security/dto/request/LoginRequestTest.java @@ -0,0 +1,58 @@ +package com.codingapi.springboot.security.dto.request; + +import org.junit.jupiter.api.Test; + +import static org.junit.jupiter.api.Assertions.assertEquals; +import static org.junit.jupiter.api.Assertions.assertFalse; +import static org.junit.jupiter.api.Assertions.assertNull; +import static org.junit.jupiter.api.Assertions.assertTrue; + +/** + * LoginRequest 单元测试 + *

+ * 覆盖 isEmpty 校验、字符串取值以及 getBoolean 的默认值回退逻辑。 + */ +class LoginRequestTest { + + @Test + void isEmptyChecksUsernameAndPassword() { + LoginRequest request = new LoginRequest(); + assertTrue(request.isEmpty()); + + request.put("username", "admin"); + assertTrue(request.isEmpty()); + + request.put("password", "123456"); + assertFalse(request.isEmpty()); + assertEquals("admin", request.getUsername()); + assertEquals("123456", request.getPassword()); + assertEquals("admin", request.getString("username")); + assertNull(request.getString("missing")); + } + + @Test + void getBooleanReturnsValueWhenPresent() { + LoginRequest request = new LoginRequest(); + request.put("remember", Boolean.TRUE); + + assertTrue(request.getBoolean("remember", false)); + } + + @Test + void getBooleanReturnsDefaultWhenTypeMismatch() { + LoginRequest request = new LoginRequest(); + request.put("text", "not-a-boolean"); + + assertFalse(request.getBoolean("text", false)); + assertTrue(request.getBoolean("text", true)); + } + + @Test + void getBooleanReturnsDefaultWhenKeyMissing() { + LoginRequest request = new LoginRequest(); + + assertTrue(request.getBoolean("missing", true)); + assertFalse(request.getBoolean("missing", false)); + } + +} diff --git a/springboot-starter-security/src/test/java/com/codingapi/springboot/security/filter/MyAccessDeniedHandlerTest.java b/springboot-starter-security/src/test/java/com/codingapi/springboot/security/filter/MyAccessDeniedHandlerTest.java new file mode 100644 index 000000000..6925dd1ce --- /dev/null +++ b/springboot-starter-security/src/test/java/com/codingapi/springboot/security/filter/MyAccessDeniedHandlerTest.java @@ -0,0 +1,37 @@ +package com.codingapi.springboot.security.filter; + +import com.alibaba.fastjson.JSONObject; +import org.junit.jupiter.api.Test; +import org.springframework.mock.web.MockHttpServletRequest; +import org.springframework.mock.web.MockHttpServletResponse; +import org.springframework.security.access.AccessDeniedException; + +import java.nio.charset.StandardCharsets; + +import static org.junit.jupiter.api.Assertions.assertEquals; +import static org.junit.jupiter.api.Assertions.assertFalse; + +/** + * MyAccessDeniedHandler 单元测试 + *

+ * 直接调用 handle 方法，验证 403 场景下写出的 JSON 响应内容。 + */ +class MyAccessDeniedHandlerTest { + + @Test + void handleWritesAccessDeniedJsonResponse() throws Exception { + MockHttpServletRequest request = new MockHttpServletRequest(); + MockHttpServletResponse response = new MockHttpServletResponse(); + + new MyAccessDeniedHandler().handle(request, response, new AccessDeniedException("denied")); + + assertEquals("application/json;charset=UTF-8", response.getContentType()); + assertEquals("UTF-8", response.getCharacterEncoding()); + + JSONObject json = JSONObject.parseObject(response.getContentAsString(StandardCharsets.UTF_8)); + assertEquals("not.access", json.getString("errCode")); + assertEquals("please check user authentication.", json.getString("errMessage")); + assertFalse(json.getBooleanValue("success")); + } + +} diff --git a/springboot-starter-security/src/test/java/com/codingapi/springboot/security/filter/MyAuthenticationFilterTest.java b/springboot-starter-security/src/test/java/com/codingapi/springboot/security/filter/MyAuthenticationFilterTest.java new file mode 100644 index 000000000..77b7c0eac --- /dev/null +++ b/springboot-starter-security/src/test/java/com/codingapi/springboot/security/filter/MyAuthenticationFilterTest.java @@ -0,0 +1,177 @@ +package com.codingapi.springboot.security.filter; + +import com.alibaba.fastjson.JSONObject; +import com.codingapi.springboot.security.gateway.Token; +import com.codingapi.springboot.security.gateway.TokenGateway; +import com.codingapi.springboot.security.properties.CodingApiSecurityProperties; +import javax.servlet.FilterChain; +import org.junit.jupiter.api.AfterEach; +import org.junit.jupiter.api.BeforeEach; +import org.junit.jupiter.api.Test; +import org.springframework.mock.web.MockHttpServletRequest; +import org.springframework.mock.web.MockHttpServletResponse; +import org.springframework.security.authentication.AuthenticationManager; +import org.springframework.security.core.Authentication; +import org.springframework.security.core.context.SecurityContextHolder; + +import java.nio.charset.StandardCharsets; +import java.util.Collections; +import java.util.List; + +import static org.junit.jupiter.api.Assertions.assertEquals; +import static org.junit.jupiter.api.Assertions.assertNotNull; +import static org.junit.jupiter.api.Assertions.assertSame; +import static org.mockito.ArgumentMatchers.any; +import static org.mockito.ArgumentMatchers.anyString; +import static org.mockito.ArgumentMatchers.eq; +import static org.mockito.ArgumentMatchers.isNull; +import static org.mockito.Mockito.mock; +import static org.mockito.Mockito.never; +import static org.mockito.Mockito.verify; +import static org.mockito.Mockito.when; + +/** + * MyAuthenticationFilter 单元测试 + *

+ * 通过 mock TokenGateway 覆盖 doFilterInternal 的各分支： + * 缺少 token、token 解析为 null、解析异常、正常通过、token 重置、过期 token 等。 + */ +class MyAuthenticationFilterTest { + + private TokenGateway tokenGateway; + private AuthenticationTokenFilter authenticationTokenFilter; + private MyAuthenticationFilter filter; + + @BeforeEach + void setUp() { + tokenGateway = mock(TokenGateway.class); + authenticationTokenFilter = mock(AuthenticationTokenFilter.class); + filter = new MyAuthenticationFilter(mock(AuthenticationManager.class), + new CodingApiSecurityProperties(), tokenGateway, authenticationTokenFilter); + SecurityContextHolder.clearContext(); + } + + @AfterEach + void tearDown() { + SecurityContextHolder.clearContext(); + } + + private JSONObject bodyJson(MockHttpServletResponse response) throws Exception { + return JSONObject.parseObject(response.getContentAsString(StandardCharsets.UTF_8)); + } + + @Test + void missingAuthorizationHeaderWritesTokenError() throws Exception { + MockHttpServletRequest request = new MockHttpServletRequest("GET", "/api/hello"); + MockHttpServletResponse response = new MockHttpServletResponse(); + FilterChain chain = mock(FilterChain.class); + + filter.doFilterInternal(request, response, chain); + + assertEquals("token.error", bodyJson(response).getString("errCode")); + verify(chain, never()).doFilter(any(), any()); + } + + @Test + void parserReturnsNullWritesTokenExpire() throws Exception { + MockHttpServletRequest request = new MockHttpServletRequest("GET", "/api/hello"); + request.addHeader("Authorization", "token-value"); + MockHttpServletResponse response = new MockHttpServletResponse(); + FilterChain chain = mock(FilterChain.class); + when(tokenGateway.parser("token-value")).thenReturn(null); + + filter.doFilterInternal(request, response, chain); + + assertEquals("token.expire", bodyJson(response).getString("errCode")); + verify(chain, never()).doFilter(any(), any()); + } + + @Test + void parserThrowsExceptionWritesTokenExpire() throws Exception { + MockHttpServletRequest request = new MockHttpServletRequest("GET", "/api/hello"); + request.addHeader("Authorization", "bad-token"); + MockHttpServletResponse response = new MockHttpServletResponse(); + FilterChain chain = mock(FilterChain.class); + when(tokenGateway.parser("bad-token")).thenThrow(new RuntimeException("parser fail")); + + filter.doFilterInternal(request, response, chain); + + assertEquals("token.expire", bodyJson(response).getString("errCode")); + verify(chain, never()).doFilter(any(), any()); + } + + @Test + void expiredTokenWritesTokenExpire() throws Exception { + List authorities = Collections.singletonList("ADMIN"); + Token token = new Token("admin", null, null, authorities, -1000, -1000); + token.setToken("expired-token"); + + MockHttpServletRequest request = new MockHttpServletRequest("GET", "/api/hello"); + request.addHeader("Authorization", "expired-token"); + MockHttpServletResponse response = new MockHttpServletResponse(); + FilterChain chain = mock(FilterChain.class); + when(tokenGateway.parser("expired-token")).thenReturn(token); + + filter.doFilterInternal(request, response, chain); + + assertEquals("token.expire", bodyJson(response).getString("errCode")); + verify(chain, never()).doFilter(any(), any()); + } + + @Test + void validTokenSetsSecurityContextAndContinuesChain() throws Exception { + List authorities = Collections.singletonList("ADMIN"); + Token token = new Token("admin", null, "{\"channel\":\"pc\"}", authorities, 900000, 600000); + token.setToken("token-value"); + + MockHttpServletRequest request = new MockHttpServletRequest("GET", "/api/hello"); + request.addHeader("Authorization", "token-value"); + MockHttpServletResponse response = new MockHttpServletResponse(); + FilterChain chain = mock(FilterChain.class); + when(tokenGateway.parser("token-value")).thenReturn(token); + + filter.doFilterInternal(request, response, chain); + + verify(chain).doFilter(request, response); + verify(authenticationTokenFilter).doFilter(request, response); + Authentication authentication = SecurityContextHolder.getContext().getAuthentication(); + assertNotNull(authentication); + assertSame(token, authentication.getPrincipal()); + assertEquals(1, authentication.getAuthorities().size()); + } + + @Test + void restableTokenTriggersResetAndSetsResponseHeader() throws Exception { + List authorities = Collections.singletonList("ADMIN"); + // remindTime 已过期而 token 未过期 -> canRestToken() 返回 true + Token token = new Token("admin", null, null, authorities, 900000, -1000); + token.setToken("old-token"); + Token newToken = new Token("admin", null, null, authorities, 900000, 600000); + newToken.setToken("new-token"); + + MockHttpServletRequest request = new MockHttpServletRequest("GET", "/api/hello"); + request.addHeader("Authorization", "old-token"); + MockHttpServletResponse response = new MockHttpServletResponse(); + FilterChain chain = mock(FilterChain.class); + when(tokenGateway.parser("old-token")).thenReturn(token); + when(tokenGateway.create(eq("admin"), isNull(), eq(authorities), isNull())).thenReturn(newToken); + + filter.doFilterInternal(request, response, chain); + + assertEquals("new-token", response.getHeader("Authorization")); + verify(chain).doFilter(request, response); + } + + @Test + void notMatchedUrlSkipsTokenCheck() throws Exception { + MockHttpServletRequest request = new MockHttpServletRequest("GET", "/open/hello"); + MockHttpServletResponse response = new MockHttpServletResponse(); + FilterChain chain = mock(FilterChain.class); + + filter.doFilterInternal(request, response, chain); + + verify(chain).doFilter(request, response); + verify(tokenGateway, never()).parser(anyString()); + } + +} diff --git a/springboot-starter-security/src/test/java/com/codingapi/springboot/security/filter/MyLoginFilterTest.java b/springboot-starter-security/src/test/java/com/codingapi/springboot/security/filter/MyLoginFilterTest.java new file mode 100644 index 000000000..9e03eb0dd --- /dev/null +++ b/springboot-starter-security/src/test/java/com/codingapi/springboot/security/filter/MyLoginFilterTest.java @@ -0,0 +1,121 @@ +package com.codingapi.springboot.security.filter; + +import com.codingapi.springboot.security.dto.request.LoginRequest; +import com.codingapi.springboot.security.dto.request.LoginRequestContext; +import com.codingapi.springboot.security.gateway.TokenGateway; +import com.codingapi.springboot.security.properties.CodingApiSecurityProperties; +import javax.servlet.http.HttpServletRequest; +import org.junit.jupiter.api.AfterEach; +import org.junit.jupiter.api.BeforeEach; +import org.junit.jupiter.api.Test; +import org.mockito.ArgumentCaptor; +import org.springframework.mock.web.MockHttpServletRequest; +import org.springframework.mock.web.MockHttpServletResponse; +import org.springframework.security.authentication.AuthenticationManager; +import org.springframework.security.authentication.AuthenticationServiceException; +import org.springframework.security.authentication.UsernamePasswordAuthenticationToken; +import org.springframework.security.core.Authentication; + +import java.io.IOException; +import java.nio.charset.StandardCharsets; + +import static org.junit.jupiter.api.Assertions.assertEquals; +import static org.junit.jupiter.api.Assertions.assertNotNull; +import static org.junit.jupiter.api.Assertions.assertSame; +import static org.junit.jupiter.api.Assertions.assertThrows; +import static org.mockito.ArgumentMatchers.any; +import static org.mockito.Mockito.doThrow; +import static org.mockito.Mockito.mock; +import static org.mockito.Mockito.verify; +import static org.mockito.Mockito.when; + +/** + * MyLoginFilter 单元测试 + *

+ * 覆盖 attemptAuthentication 的各异常分支（空请求体、空登录参数、 + * 流读取失败、preHandle 异常）以及正常认证路径。 + */ +class MyLoginFilterTest { + + private AuthenticationManager authenticationManager; + private SecurityLoginHandler loginHandler; + private MyLoginFilter filter; + + @BeforeEach + void setUp() { + authenticationManager = mock(AuthenticationManager.class); + TokenGateway tokenGateway = mock(TokenGateway.class); + loginHandler = mock(SecurityLoginHandler.class); + filter = new MyLoginFilter(authenticationManager, tokenGateway, loginHandler, + new CodingApiSecurityProperties()); + } + + @AfterEach + void tearDown() { + LoginRequestContext.getInstance().clean(); + } + + private MockHttpServletRequest jsonRequest(String body) { + MockHttpServletRequest request = new MockHttpServletRequest("POST", "/user/login"); + request.setContent(body.getBytes(StandardCharsets.UTF_8)); + return request; + } + + @Test + void attemptAuthenticationWithNullBodyThrowsServiceException() { + MockHttpServletResponse response = new MockHttpServletResponse(); + + assertThrows(AuthenticationServiceException.class, + () -> filter.attemptAuthentication(jsonRequest("null"), response)); + } + + @Test + void attemptAuthenticationWithEmptyLoginRequestThrowsServiceException() { + MockHttpServletResponse response = new MockHttpServletResponse(); + + assertThrows(AuthenticationServiceException.class, + () -> filter.attemptAuthentication(jsonRequest("{}"), response)); + } + + @Test + void attemptAuthenticationWhenStreamReadFailsThrowsServiceException() throws Exception { + HttpServletRequest request = mock(HttpServletRequest.class); + when(request.getInputStream()).thenThrow(new IOException("stream read fail")); + + assertThrows(AuthenticationServiceException.class, + () -> filter.attemptAuthentication(request, new MockHttpServletResponse())); + } + + @Test + void attemptAuthenticationWhenPreHandleFailsThrowsServiceException() throws Exception { + doThrow(new IllegalStateException("pre handle fail")) + .when(loginHandler).preHandle(any(), any(), any(LoginRequest.class)); + String body = "{\"username\":\"admin\",\"password\":\"123456\"}"; + + assertThrows(AuthenticationServiceException.class, + () -> filter.attemptAuthentication(jsonRequest(body), new MockHttpServletResponse())); + } + + @Test + void attemptAuthenticationSuccessDelegatesToAuthenticationManager() { + Authentication authentication = mock(Authentication.class); + when(authenticationManager.authenticate(any(Authentication.class))).thenReturn(authentication); + String body = "{\"username\":\"admin\",\"password\":\"123456\"}"; + + Authentication result = filter.attemptAuthentication(jsonRequest(body), new MockHttpServletResponse()); + + assertSame(authentication, result); + + ArgumentCaptor captor = + ArgumentCaptor.forClass(UsernamePasswordAuthenticationToken.class); + verify(authenticationManager).authenticate(captor.capture()); + assertEquals("admin", captor.getValue().getName()); + assertEquals("123456", captor.getValue().getCredentials()); + + // 登录请求被放入线程上下文 + LoginRequest context = LoginRequestContext.getInstance().get(); + assertNotNull(context); + assertEquals("admin", context.getUsername()); + } + +} diff --git a/springboot-starter-security/src/test/java/com/codingapi/springboot/security/filter/MyLogoutHandlerTest.java b/springboot-starter-security/src/test/java/com/codingapi/springboot/security/filter/MyLogoutHandlerTest.java new file mode 100644 index 000000000..c48f9f9aa --- /dev/null +++ b/springboot-starter-security/src/test/java/com/codingapi/springboot/security/filter/MyLogoutHandlerTest.java @@ -0,0 +1,22 @@ +package com.codingapi.springboot.security.filter; + +import org.junit.jupiter.api.Test; +import org.springframework.mock.web.MockHttpServletRequest; +import org.springframework.mock.web.MockHttpServletResponse; + +import static org.junit.jupiter.api.Assertions.assertDoesNotThrow; + +/** + * MyLogoutHandler 单元测试 + *

+ * logout 为空实现，仅验证调用不抛异常。 + */ +class MyLogoutHandlerTest { + + @Test + void logoutDoesNotThrow() { + assertDoesNotThrow(() -> new MyLogoutHandler() + .logout(new MockHttpServletRequest(), new MockHttpServletResponse(), null)); + } + +} diff --git a/springboot-starter-security/src/test/java/com/codingapi/springboot/security/filter/MyLogoutSuccessHandlerTest.java b/springboot-starter-security/src/test/java/com/codingapi/springboot/security/filter/MyLogoutSuccessHandlerTest.java new file mode 100644 index 000000000..2583f5816 --- /dev/null +++ b/springboot-starter-security/src/test/java/com/codingapi/springboot/security/filter/MyLogoutSuccessHandlerTest.java @@ -0,0 +1,34 @@ +package com.codingapi.springboot.security.filter; + +import com.alibaba.fastjson.JSONObject; +import org.junit.jupiter.api.Test; +import org.springframework.mock.web.MockHttpServletRequest; +import org.springframework.mock.web.MockHttpServletResponse; + +import java.nio.charset.StandardCharsets; + +import static org.junit.jupiter.api.Assertions.assertEquals; +import static org.junit.jupiter.api.Assertions.assertTrue; + +/** + * MyLogoutSuccessHandler 单元测试 + *

+ * 直接调用 onLogoutSuccess 方法，验证退出成功后写出的 JSON 响应内容。 + */ +class MyLogoutSuccessHandlerTest { + + @Test + void onLogoutSuccessWritesSuccessJsonResponse() throws Exception { + MockHttpServletRequest request = new MockHttpServletRequest(); + MockHttpServletResponse response = new MockHttpServletResponse(); + + new MyLogoutSuccessHandler().onLogoutSuccess(request, response, null); + + assertEquals("application/json;charset=UTF-8", response.getContentType()); + assertEquals("UTF-8", response.getCharacterEncoding()); + + JSONObject json = JSONObject.parseObject(response.getContentAsString(StandardCharsets.UTF_8)); + assertTrue(json.getBooleanValue("success")); + } + +} diff --git a/springboot-starter-security/src/test/java/com/codingapi/springboot/security/filter/MyUnAuthenticationEntryPointTest.java b/springboot-starter-security/src/test/java/com/codingapi/springboot/security/filter/MyUnAuthenticationEntryPointTest.java new file mode 100644 index 000000000..92ded9fdf --- /dev/null +++ b/springboot-starter-security/src/test/java/com/codingapi/springboot/security/filter/MyUnAuthenticationEntryPointTest.java @@ -0,0 +1,48 @@ +package com.codingapi.springboot.security.filter; + +import com.alibaba.fastjson.JSONObject; +import org.junit.jupiter.api.Test; +import org.springframework.mock.web.MockHttpServletRequest; +import org.springframework.mock.web.MockHttpServletResponse; + +import java.nio.charset.StandardCharsets; + +import static org.junit.jupiter.api.Assertions.assertEquals; +import static org.junit.jupiter.api.Assertions.assertFalse; + +/** + * MyUnAuthenticationEntryPoint 单元测试 + *

+ * 直接调用 commence 方法，验证 401 场景下写出的 JSON 响应内容。 + */ +class MyUnAuthenticationEntryPointTest { + + @Test + void commenceWritesNotLoginJsonResponse() throws Exception { + MockHttpServletRequest request = new MockHttpServletRequest(); + MockHttpServletResponse response = new MockHttpServletResponse(); + + new MyUnAuthenticationEntryPoint().commence(request, response, + new InsufficientAuthenticationExceptionForTest("not authenticated")); + + assertEquals("application/json;charset=UTF-8", response.getContentType()); + assertEquals("UTF-8", response.getCharacterEncoding()); + + JSONObject json = JSONObject.parseObject(response.getContentAsString(StandardCharsets.UTF_8)); + assertEquals("not.login", json.getString("errCode")); + assertEquals("please to login.", json.getString("errMessage")); + assertFalse(json.getBooleanValue("success")); + } + + /** + * 简单的 AuthenticationException 实现，用于触发 commence 逻辑 + */ + private static class InsufficientAuthenticationExceptionForTest + extends org.springframework.security.core.AuthenticationException { + + InsufficientAuthenticationExceptionForTest(String msg) { + super(msg); + } + } + +} diff --git a/springboot-starter-security/src/test/java/com/codingapi/springboot/security/gateway/TokenContextTest.java b/springboot-starter-security/src/test/java/com/codingapi/springboot/security/gateway/TokenContextTest.java new file mode 100644 index 000000000..c5b74110c --- /dev/null +++ b/springboot-starter-security/src/test/java/com/codingapi/springboot/security/gateway/TokenContextTest.java @@ -0,0 +1,45 @@ +package com.codingapi.springboot.security.gateway; + +import org.junit.jupiter.api.AfterEach; +import org.junit.jupiter.api.Test; +import org.springframework.security.authentication.UsernamePasswordAuthenticationToken; +import org.springframework.security.core.context.SecurityContextHolder; + +import java.util.Collections; + +import static org.junit.jupiter.api.Assertions.assertEquals; +import static org.junit.jupiter.api.Assertions.assertNull; +import static org.junit.jupiter.api.Assertions.assertSame; + +/** + * TokenContext 单元测试 + *

+ * 覆盖 ThreadLocal extra 的读写以及从 SecurityContext 中获取当前 Token。 + */ +class TokenContextTest { + + @AfterEach + void tearDown() { + SecurityContextHolder.clearContext(); + } + + @Test + void pushExtraAndGetExtra() { + TokenContext.pushExtra("extra-value"); + assertEquals("extra-value", TokenContext.getExtra()); + + TokenContext.pushExtra(null); + assertNull(TokenContext.getExtra()); + } + + @Test + void currentReturnsTokenFromSecurityContext() { + Token token = new Token("admin", null, null, Collections.singletonList("ADMIN"), 900000, 600000); + UsernamePasswordAuthenticationToken authentication = + new UsernamePasswordAuthenticationToken(token, null, Collections.emptyList()); + SecurityContextHolder.getContext().setAuthentication(authentication); + + assertSame(token, TokenContext.current()); + } + +} diff --git a/springboot-starter-security/src/test/java/com/codingapi/springboot/security/gateway/TokenUnitTest.java b/springboot-starter-security/src/test/java/com/codingapi/springboot/security/gateway/TokenUnitTest.java new file mode 100644 index 000000000..b509da058 --- /dev/null +++ b/springboot-starter-security/src/test/java/com/codingapi/springboot/security/gateway/TokenUnitTest.java @@ -0,0 +1,118 @@ +package com.codingapi.springboot.security.gateway; + +import com.codingapi.springboot.security.crypto.SecurityCryptoConfiguration; +import com.codingapi.springboot.security.exception.TokenExpiredException; +import com.codingapi.springboot.security.properties.CodingApiSecurityProperties; +import org.junit.jupiter.api.AfterEach; +import org.junit.jupiter.api.BeforeAll; +import org.junit.jupiter.api.Test; +import org.springframework.security.authentication.UsernamePasswordAuthenticationToken; +import org.springframework.security.core.context.SecurityContextHolder; + +import java.util.Arrays; +import java.util.Collections; +import java.util.List; +import java.util.Map; + +import static org.junit.jupiter.api.Assertions.assertEquals; +import static org.junit.jupiter.api.Assertions.assertFalse; +import static org.junit.jupiter.api.Assertions.assertNull; +import static org.junit.jupiter.api.Assertions.assertSame; +import static org.junit.jupiter.api.Assertions.assertThrows; +import static org.junit.jupiter.api.Assertions.assertTrue; + +/** + * Token 单元测试 + *

+ * 覆盖构造、iv 加解密往返、过期校验、重置判断、extra 解析、 + * 认证凭据转换等逻辑。 + */ +class TokenUnitTest { + + @BeforeAll + static void initCrypto() throws Exception { + // Token 构造时会通过 AESTools 加密 iv，单元测试环境需要先完成初始化 + new SecurityCryptoConfiguration().aes(new CodingApiSecurityProperties()); + } + + @AfterEach + void tearDown() { + SecurityContextHolder.clearContext(); + } + + @Test + void constructorWithIvEncryptsAndDecodeRoundTrip() { + List authorities = Arrays.asList("ADMIN", "USER"); + Token token = new Token("admin", "123456", "{\"name\":\"test\"}", authorities, 900000, 600000); + + assertEquals("admin", token.getUsername()); + assertEquals("123456", token.decodeIv()); + assertEquals(authorities, token.getAuthorities()); + assertFalse(token.isExpire()); + assertEquals("test", token.parseExtra(Map.class).get("name")); + } + + @Test + void nullIvAndNullExtraReturnNull() { + Token token = new Token("admin", null, null, Collections.singletonList("ADMIN"), 900000, 600000); + + assertNull(token.decodeIv()); + assertNull(token.parseExtra(Map.class)); + } + + @Test + void expiredTokenVerifyThrowsException() { + Token expired = new Token("admin", null, null, Collections.singletonList("ADMIN"), -1000, -1000); + + assertTrue(expired.isExpire()); + assertFalse(expired.canRestToken()); + TokenExpiredException exception = assertThrows(TokenExpiredException.class, expired::verify); + assertEquals("token expired.", exception.getMessage()); + } + + @Test + void validTokenVerifyPassesAndCannotRest() throws TokenExpiredException { + Token token = new Token("admin", null, null, Collections.singletonList("ADMIN"), 900000, 600000); + + token.verify(); + assertFalse(token.canRestToken()); + } + + @Test + void restableTokenWhenRemindTimeReached() { + Token token = new Token("admin", null, null, Collections.singletonList("ADMIN"), 900000, -1000); + + assertFalse(token.isExpire()); + assertTrue(token.canRestToken()); + } + + @Test + void getAuthenticationTokenBuildsAuthoritiesAndPushesExtra() { + Token token = new Token("admin", "iv-value", "{\"channel\":\"pc\"}", + Arrays.asList("ADMIN", "USER"), 900000, 600000); + + UsernamePasswordAuthenticationToken authentication = token.getAuthenticationToken(); + + assertSame(token, authentication.getPrincipal()); + assertEquals(2, authentication.getAuthorities().size()); + assertEquals("{\"channel\":\"pc\"}", TokenContext.getExtra()); + } + + @Test + void defaultConstructorAndSetters() { + Token token = new Token(); + token.setUsername("user"); + token.setToken("token-value"); + token.setExtra("{}"); + token.setAuthorities(Collections.singletonList("USER")); + token.setExpireTime(System.currentTimeMillis() + 900000); + token.setRemindTime(System.currentTimeMillis() + 600000); + + assertEquals("user", token.getUsername()); + assertEquals("token-value", token.getToken()); + assertEquals("{}", token.getExtra()); + assertFalse(token.isExpire()); + assertFalse(token.canRestToken()); + } + +} diff --git a/springboot-starter-security/src/test/java/com/codingapi/springboot/security/jwt/JWTSecurityConfigurationTest.java b/springboot-starter-security/src/test/java/com/codingapi/springboot/security/jwt/JWTSecurityConfigurationTest.java new file mode 100644 index 000000000..4aee284a5 --- /dev/null +++ b/springboot-starter-security/src/test/java/com/codingapi/springboot/security/jwt/JWTSecurityConfigurationTest.java @@ -0,0 +1,32 @@ +package com.codingapi.springboot.security.jwt; + +import com.codingapi.springboot.security.gateway.TokenGateway; +import org.junit.jupiter.api.Test; + +import static org.junit.jupiter.api.Assertions.assertNotNull; +import static org.junit.jupiter.api.Assertions.assertTrue; + +/** + * JWTSecurityConfiguration 单元测试 + *

+ * 直接调用配置类的 Bean 工厂方法，验证各 Bean 的创建逻辑。 + */ +class JWTSecurityConfigurationTest { + + @Test + void beanFactoryMethodsCreateExpectedBeans() { + JWTSecurityConfiguration configuration = new JWTSecurityConfiguration(); + + SecurityJWTProperties properties = configuration.securityJWTProperties(); + assertNotNull(properties); + assertTrue(properties.isEnable()); + + JwtTokenGateway jwtTokenGateway = configuration.jwtTokenGateway(properties); + assertNotNull(jwtTokenGateway); + + TokenGateway tokenGateway = configuration.jwtTokenGatewayImpl(jwtTokenGateway); + assertNotNull(tokenGateway); + assertTrue(tokenGateway instanceof JWTTokenGatewayImpl); + } + +} diff --git a/springboot-starter-security/src/test/java/com/codingapi/springboot/security/jwt/JwtTokenGatewayTest.java b/springboot-starter-security/src/test/java/com/codingapi/springboot/security/jwt/JwtTokenGatewayTest.java new file mode 100644 index 000000000..69e14955e --- /dev/null +++ b/springboot-starter-security/src/test/java/com/codingapi/springboot/security/jwt/JwtTokenGatewayTest.java @@ -0,0 +1,105 @@ +package com.codingapi.springboot.security.jwt; + +import com.codingapi.springboot.framework.exception.LocaleMessageException; +import com.codingapi.springboot.security.crypto.SecurityCryptoConfiguration; +import com.codingapi.springboot.security.exception.TokenExpiredException; +import com.codingapi.springboot.security.gateway.Token; +import com.codingapi.springboot.security.properties.CodingApiSecurityProperties; +import org.junit.jupiter.api.BeforeAll; +import org.junit.jupiter.api.BeforeEach; +import org.junit.jupiter.api.Test; + +import java.util.Arrays; +import java.util.Collections; +import java.util.List; + +import static org.junit.jupiter.api.Assertions.assertEquals; +import static org.junit.jupiter.api.Assertions.assertNotNull; +import static org.junit.jupiter.api.Assertions.assertThrows; + +/** + * JwtTokenGateway 单元测试 + *

+ * 覆盖各 create 重载与 JWT 签发/解析的往返逻辑，以及非法 token 的异常分支。 + */ +class JwtTokenGatewayTest { + + private JwtTokenGateway gateway; + + @BeforeAll + static void initCrypto() throws Exception { + // Token 构造时会通过 AESTools 加密 iv，单元测试环境需要先完成初始化 + new SecurityCryptoConfiguration().aes(new CodingApiSecurityProperties()); + } + + @BeforeEach + void setUp() { + gateway = new JwtTokenGateway(new SecurityJWTProperties()); + } + + @Test + void createWithAllParamsAndParserRoundTrip() throws TokenExpiredException { + List authorities = Arrays.asList("ADMIN", "USER"); + TestVO extra = new TestVO("test-name"); + + Token token = gateway.create("admin", "123456", authorities, extra.toJson()); + assertNotNull(token.getToken()); + token.verify(); + + Token parsed = gateway.parser(token.getToken()); + assertEquals("admin", parsed.getUsername()); + assertEquals("123456", parsed.decodeIv()); + assertEquals(authorities, parsed.getAuthorities()); + assertEquals("test-name", parsed.parseExtra(TestVO.class).getName()); + } + + @Test + void createOverloadWithAuthoritiesOnly() { + List authorities = Collections.singletonList("ADMIN"); + + Token token = gateway.create("admin", authorities); + + Token parsed = gateway.parser(token.getToken()); + assertEquals("admin", parsed.getUsername()); + assertEquals(authorities, parsed.getAuthorities()); + } + + @Test + void createOverloadWithAuthoritiesAndExtra() { + List authorities = Collections.singletonList("ADMIN"); + TestVO extra = new TestVO("extra-name"); + + Token token = gateway.create("admin", authorities, extra.toJson()); + + Token parsed = gateway.parser(token.getToken()); + assertEquals("admin", parsed.getUsername()); + assertEquals("extra-name", parsed.parseExtra(TestVO.class).getName()); + } + + @Test + void createOverloadWithIvAndAuthorities() { + List authorities = Collections.singletonList("ADMIN"); + + Token token = gateway.create("admin", "123456", authorities); + + Token parsed = gateway.parser(token.getToken()); + assertEquals("admin", parsed.getUsername()); + assertEquals("123456", parsed.decodeIv()); + } + + @Test + void parserWithInvalidTokenThrowsLocaleMessageException() { + assertThrows(LocaleMessageException.class, () -> gateway.parser("invalid.jwt.token")); + } + + @Test + void parserWithTokenSignedByOtherKeyThrowsException() { + SecurityJWTProperties otherProperties = new SecurityJWTProperties(); + otherProperties.setSecretKey("another-secret-key-must-longer-than-32-chars"); + JwtTokenGateway otherGateway = new JwtTokenGateway(otherProperties); + Token token = otherGateway.create("admin", Collections.singletonList("ADMIN")); + + assertThrows(LocaleMessageException.class, () -> gateway.parser(token.getToken())); + } + +} diff --git a/springboot-starter-security/src/test/java/com/codingapi/springboot/security/jwt/SecurityJWTPropertiesTest.java b/springboot-starter-security/src/test/java/com/codingapi/springboot/security/jwt/SecurityJWTPropertiesTest.java new file mode 100644 index 000000000..1ce6b6b76 --- /dev/null +++ b/springboot-starter-security/src/test/java/com/codingapi/springboot/security/jwt/SecurityJWTPropertiesTest.java @@ -0,0 +1,40 @@ +package com.codingapi.springboot.security.jwt; + +import org.junit.jupiter.api.Test; + +import static org.junit.jupiter.api.Assertions.assertEquals; +import static org.junit.jupiter.api.Assertions.assertFalse; +import static org.junit.jupiter.api.Assertions.assertTrue; + +/** + * SecurityJWTProperties 单元测试 + *

+ * 校验默认值与 setter/getter 行为。 + */ +class SecurityJWTPropertiesTest { + + @Test + void defaultValues() { + SecurityJWTProperties properties = new SecurityJWTProperties(); + + assertTrue(properties.isEnable()); + assertEquals("codingapi.security.jwt.secretkey", properties.getSecretKey()); + assertEquals(900000, properties.getValidTime()); + assertEquals(600000, properties.getRestTime()); + } + + @Test + void settersAndGetters() { + SecurityJWTProperties properties = new SecurityJWTProperties(); + properties.setEnable(false); + properties.setSecretKey("changed-secret-key"); + properties.setValidTime(1000); + properties.setRestTime(500); + + assertFalse(properties.isEnable()); + assertEquals("changed-secret-key", properties.getSecretKey()); + assertEquals(1000, properties.getValidTime()); + assertEquals(500, properties.getRestTime()); + } + +} diff --git a/springboot-starter-security-jwt/src/test/java/com/codingapi/springboot/security/jwt/TestVO.java b/springboot-starter-security/src/test/java/com/codingapi/springboot/security/jwt/TestVO.java similarity index 100% rename from springboot-starter-security-jwt/src/test/java/com/codingapi/springboot/security/jwt/TestVO.java rename to springboot-starter-security/src/test/java/com/codingapi/springboot/security/jwt/TestVO.java diff --git a/springboot-starter-security-jwt/src/test/java/com/codingapi/springboot/security/jwt/TokenTest.java b/springboot-starter-security/src/test/java/com/codingapi/springboot/security/jwt/TokenTest.java similarity index 73% rename from springboot-starter-security-jwt/src/test/java/com/codingapi/springboot/security/jwt/TokenTest.java rename to springboot-starter-security/src/test/java/com/codingapi/springboot/security/jwt/TokenTest.java index 3010f7fb4..b56116741 100644 --- a/springboot-starter-security-jwt/src/test/java/com/codingapi/springboot/security/jwt/TokenTest.java +++ b/springboot-starter-security/src/test/java/com/codingapi/springboot/security/jwt/TokenTest.java @@ -1,6 +1,8 @@ package com.codingapi.springboot.security.jwt; import com.codingapi.springboot.security.exception.TokenExpiredException; +import com.codingapi.springboot.security.gateway.Token; +import com.codingapi.springboot.security.gateway.TokenGateway; import org.junit.jupiter.api.Test; import org.springframework.beans.factory.annotation.Autowired; import org.springframework.boot.test.context.SpringBootTest; @@ -14,7 +16,7 @@ class TokenTest { @Autowired - private Jwt jwt; + private TokenGateway tokenGateway; @Test void verify1() throws TokenExpiredException { @@ -22,10 +24,10 @@ void verify1() throws TokenExpiredException { String iv = "123456"; List authorities = Collections.singletonList("ADMIN"); - Token token =jwt.create(username,iv,authorities); + Token token =tokenGateway.create(username,iv,authorities); token.verify(); - Token data = jwt.parser(token.getToken()); + Token data = tokenGateway.parser(token.getToken()); assertEquals(data.decodeIv(),iv); assertEquals(data.getAuthorities(),authorities); } @@ -35,10 +37,10 @@ void verify2() throws TokenExpiredException { String username = "admin"; List authorities = Collections.singletonList("ADMIN"); - Token token =jwt.create(username,authorities); + Token token =tokenGateway.create(username,authorities); token.verify(); - Token data = jwt.parser(token.getToken()); + Token data = tokenGateway.parser(token.getToken()); assertEquals(data.getUsername(),username); assertEquals(data.getAuthorities(),authorities); } @@ -52,10 +54,10 @@ void verify3() throws TokenExpiredException { String extra = testVO.toJson(); List authorities = Collections.singletonList("ADMIN"); - Token token =jwt.create(username,authorities,extra); + Token token =tokenGateway.create(username,authorities,extra); token.verify(); - Token data = jwt.parser(token.getToken()); + Token data = tokenGateway.parser(token.getToken()); assertEquals(data.parseExtra(TestVO.class).getName(), testVO.getName()); assertEquals(data.getAuthorities(),authorities); } diff --git a/springboot-starter-security/src/test/java/com/codingapi/springboot/security/redis/RedisSecurityConfigurationTest.java b/springboot-starter-security/src/test/java/com/codingapi/springboot/security/redis/RedisSecurityConfigurationTest.java new file mode 100644 index 000000000..059d5e5d4 --- /dev/null +++ b/springboot-starter-security/src/test/java/com/codingapi/springboot/security/redis/RedisSecurityConfigurationTest.java @@ -0,0 +1,37 @@ +package com.codingapi.springboot.security.redis; + +import com.codingapi.springboot.security.gateway.TokenGateway; +import org.junit.jupiter.api.Test; +import org.springframework.data.redis.core.RedisTemplate; + +import static org.junit.jupiter.api.Assertions.assertNotNull; +import static org.junit.jupiter.api.Assertions.assertTrue; +import static org.mockito.Mockito.mock; + +/** + * RedisSecurityConfiguration 单元测试 + *

+ * 直接调用配置类的 Bean 工厂方法（RedisTemplate 使用 mock）， + * 验证各 Bean 的创建逻辑。 + */ +class RedisSecurityConfigurationTest { + + @SuppressWarnings("unchecked") + @Test + void beanFactoryMethodsCreateExpectedBeans() { + RedisSecurityConfiguration configuration = new RedisSecurityConfiguration(); + + SecurityRedisProperties properties = configuration.securityRedisProperties(); + assertNotNull(properties); + assertTrue(properties.isEnable()); + + RedisTemplate redisTemplate = mock(RedisTemplate.class); + RedisTokenGateway redisTokenGateway = configuration.redisTokenGateway(redisTemplate, properties); + assertNotNull(redisTokenGateway); + + TokenGateway tokenGateway = configuration.redisTokenGatewayImpl(redisTokenGateway); + assertNotNull(tokenGateway); + assertTrue(tokenGateway instanceof RedisTokenGatewayImpl); + } + +} diff --git a/springboot-starter-security/src/test/java/com/codingapi/springboot/security/redis/RedisTokenGatewayImplTest.java b/springboot-starter-security/src/test/java/com/codingapi/springboot/security/redis/RedisTokenGatewayImplTest.java new file mode 100644 index 000000000..c9593f78b --- /dev/null +++ b/springboot-starter-security/src/test/java/com/codingapi/springboot/security/redis/RedisTokenGatewayImplTest.java @@ -0,0 +1,67 @@ +package com.codingapi.springboot.security.redis; + +import com.codingapi.springboot.security.gateway.Token; +import com.codingapi.springboot.security.gateway.TokenGateway; +import org.junit.jupiter.api.BeforeEach; +import org.junit.jupiter.api.Test; + +import java.util.Collections; +import java.util.List; + +import static org.junit.jupiter.api.Assertions.assertSame; +import static org.junit.jupiter.api.Assertions.assertTrue; +import static org.mockito.Mockito.mock; +import static org.mockito.Mockito.when; + +/** + * RedisTokenGatewayImpl 单元测试 + *

+ * 验证其对 RedisTokenGateway 的委托行为以及 TokenGateway 默认方法。 + */ +class RedisTokenGatewayImplTest { + + private RedisTokenGateway redisTokenGateway; + private RedisTokenGatewayImpl gatewayImpl; + + @BeforeEach + void setUp() { + redisTokenGateway = mock(RedisTokenGateway.class); + gatewayImpl = new RedisTokenGatewayImpl(redisTokenGateway); + } + + @Test + void createDelegatesToRedisTokenGateway() { + List authorities = Collections.singletonList("ADMIN"); + Token expected = new Token("admin", null, null, authorities, 900000, 600000); + when(redisTokenGateway.create("admin", "123456", authorities, "extra")).thenReturn(expected); + + Token token = gatewayImpl.create("admin", "123456", authorities, "extra"); + + assertSame(expected, token); + } + + @Test + void parserDelegatesToGetToken() { + List authorities = Collections.singletonList("ADMIN"); + Token expected = new Token("admin", null, null, authorities, 900000, 600000); + when(redisTokenGateway.getToken("token-sign")).thenReturn(expected); + + Token token = gatewayImpl.parser("token-sign"); + + assertSame(expected, token); + } + + @Test + void tokenGatewayDefaultMethodsDelegateToFullCreate() { + List authorities = Collections.singletonList("ADMIN"); + Token expected = new Token("user", null, null, authorities, 900000, 600000); + when(redisTokenGateway.create("user", null, authorities, null)).thenReturn(expected); + + TokenGateway gateway = gatewayImpl; + assertSame(expected, gateway.create("user", authorities)); + assertSame(expected, gateway.create("user", authorities, null)); + assertSame(expected, gateway.create("user", null, authorities)); + assertTrue(gateway instanceof RedisTokenGatewayImpl); + } + +} diff --git a/springboot-starter-security/src/test/java/com/codingapi/springboot/security/redis/RedisTokenGatewayTest.java b/springboot-starter-security/src/test/java/com/codingapi/springboot/security/redis/RedisTokenGatewayTest.java new file mode 100644 index 000000000..025a0e027 --- /dev/null +++ b/springboot-starter-security/src/test/java/com/codingapi/springboot/security/redis/RedisTokenGatewayTest.java @@ -0,0 +1,200 @@ +package com.codingapi.springboot.security.redis; + +import com.codingapi.springboot.framework.crypto.AESUtils; +import com.codingapi.springboot.security.crypto.SecurityCryptoConfiguration; +import com.codingapi.springboot.security.gateway.Token; +import com.codingapi.springboot.security.properties.CodingApiSecurityProperties; +import org.junit.jupiter.api.BeforeAll; +import org.junit.jupiter.api.BeforeEach; +import org.junit.jupiter.api.Test; +import org.mockito.ArgumentCaptor; +import org.springframework.data.redis.core.RedisTemplate; +import org.springframework.data.redis.core.ValueOperations; + +import java.util.Arrays; +import java.util.Collections; +import java.util.HashSet; +import java.util.List; +import java.util.Set; +import java.util.concurrent.TimeUnit; +import java.util.function.Predicate; + +import static org.junit.jupiter.api.Assertions.assertEquals; +import static org.junit.jupiter.api.Assertions.assertNotNull; +import static org.junit.jupiter.api.Assertions.assertNull; +import static org.junit.jupiter.api.Assertions.assertTrue; +import static org.mockito.ArgumentMatchers.anyCollection; +import static org.mockito.ArgumentMatchers.anyString; +import static org.mockito.ArgumentMatchers.eq; +import static org.mockito.Mockito.mock; +import static org.mockito.Mockito.never; +import static org.mockito.Mockito.verify; +import static org.mockito.Mockito.when; + +/** + * RedisTokenGateway 单元测试 + *

+ * 通过 mock RedisTemplate/ValueOperations 验证 token 的创建、解析、删除、 + * 重置以及按用户名清理等逻辑，不依赖真实 Redis 连接。 + */ +class RedisTokenGatewayTest { + + private RedisTemplate redisTemplate; + private ValueOperations valueOperations; + private SecurityRedisProperties properties; + private RedisTokenGateway gateway; + + @BeforeAll + static void initCrypto() throws Exception { + // Token 构造时会通过 AESTools 加密 iv，单元测试环境需要先完成初始化 + new SecurityCryptoConfiguration().aes(new CodingApiSecurityProperties()); + } + + @SuppressWarnings("unchecked") + @BeforeEach + void setUp() { + redisTemplate = mock(RedisTemplate.class); + valueOperations = mock(ValueOperations.class); + when(redisTemplate.opsForValue()).thenReturn(valueOperations); + properties = new SecurityRedisProperties(); + gateway = new RedisTokenGateway(redisTemplate, properties); + } + + @Test + void createTokenStoresJsonWithValidTime() throws Exception { + List authorities = Arrays.asList("ADMIN", "USER"); + + Token token = gateway.create("admin", "123456", authorities, "{\"name\":\"test\"}"); + + assertNotNull(token.getToken()); + assertEquals("admin", token.getUsername()); + assertEquals("123456", token.decodeIv()); + assertEquals(authorities, token.getAuthorities()); + // key 由 AES 加密后的用户名 + ":" + 随机 UUID 组成 + String encodedUsername = AESUtils.getInstance().encode("admin"); + assertTrue(token.getToken().startsWith(encodedUsername + ":")); + + verify(valueOperations).set(eq(token.getToken()), eq(token.toJson()), + eq((long) properties.getValidTime()), eq(TimeUnit.MILLISECONDS)); + } + + @Test + void getTokenWhenPresent() { + Token source = new Token("admin", null, null, Collections.singletonList("ADMIN"), 900000, 600000); + source.setToken("token-key"); + when(valueOperations.get("token-key")).thenReturn(source.toJson()); + + Token token = gateway.getToken("token-key"); + + assertNotNull(token); + assertEquals("admin", token.getUsername()); + assertEquals(source.getAuthorities(), token.getAuthorities()); + assertEquals(source.getExpireTime(), token.getExpireTime()); + } + + @Test + void getTokenWhenAbsentReturnsNull() { + when(valueOperations.get("no-such-key")).thenReturn(null); + + assertNull(gateway.getToken("no-such-key")); + } + + @Test + void removeTokenDeletesKey() { + gateway.removeToken("token-key"); + + verify(redisTemplate).delete("token-key"); + } + + @Test + void resetTokenWritesAgainWithValidTime() { + Token token = new Token("admin", null, null, Collections.singletonList("ADMIN"), 900000, 600000); + token.setToken("token-key"); + + gateway.resetToken(token); + + verify(valueOperations).set(eq("token-key"), eq(token.toJson()), + eq((long) properties.getValidTime()), eq(TimeUnit.MILLISECONDS)); + } + + @Test + void removeUsernameDeletesMatchedKeys() { + Set keys = new HashSet(Arrays.asList("key-1", "key-2")); + when(redisTemplate.keys(anyString())).thenReturn(keys); + + gateway.removeUsername("admin"); + + ArgumentCaptor patternCaptor = ArgumentCaptor.forClass(String.class); + verify(redisTemplate).keys(patternCaptor.capture()); + assertTrue(patternCaptor.getValue().endsWith(":*")); + verify(redisTemplate).delete(keys); + } + + @Test + void removeUsernameSkipsDeleteWhenNoKeys() { + when(redisTemplate.keys(anyString())).thenReturn(Collections.emptySet()); + + gateway.removeUsername("admin"); + + verify(redisTemplate, never()).delete(anyCollection()); + } + + @Test + void getTokensByUsernameReturnsAllKeys() { + Set keys = new HashSet(Arrays.asList("key-1", "key-2")); + when(redisTemplate.keys(anyString())).thenReturn(keys); + + List tokens = gateway.getTokensByUsername("admin"); + + assertEquals(2, tokens.size()); + assertTrue(tokens.containsAll(keys)); + } + + @Test + void removeUsernameWithPredicateDeletesMatchedToken() { + String key = "key-1"; + when(redisTemplate.keys(anyString())).thenReturn(new HashSet(Collections.singletonList(key))); + Token token = new Token("admin", null, null, Collections.singletonList("ADMIN"), 900000, 600000); + when(valueOperations.get(key)).thenReturn(token.toJson()); + + Predicate predicate = t -> "admin".equals(t.getUsername()); + gateway.removeUsername("admin", predicate); + + verify(redisTemplate).delete(key); + } + + @Test + void removeUsernameWithPredicateKeepsNotMatchedToken() { + String key = "key-1"; + when(redisTemplate.keys(anyString())).thenReturn(new HashSet(Collections.singletonList(key))); + Token token = new Token("admin", null, null, Collections.singletonList("ADMIN"), 900000, 600000); + when(valueOperations.get(key)).thenReturn(token.toJson()); + + Predicate predicate = t -> "other".equals(t.getUsername()); + gateway.removeUsername("admin", predicate); + + verify(redisTemplate, never()).delete(anyString()); + } + + @Test + void removeUsernameWithPredicateSkipsMissingToken() { + String key = "key-1"; + when(redisTemplate.keys(anyString())).thenReturn(new HashSet(Collections.singletonList(key))); + when(valueOperations.get(key)).thenReturn(null); + + gateway.removeUsername("admin", t -> true); + + verify(redisTemplate, never()).delete(anyString()); + } + + @Test + void removeUsernameWithPredicateSkipsWhenNoKeys() { + when(redisTemplate.keys(anyString())).thenReturn(Collections.emptySet()); + + gateway.removeUsername("admin", t -> true); + + verify(redisTemplate, never()).delete(anyString()); + verify(valueOperations, never()).get(anyString()); + } + +} diff --git a/springboot-starter-security/src/test/java/com/codingapi/springboot/security/redis/SecurityRedisPropertiesTest.java b/springboot-starter-security/src/test/java/com/codingapi/springboot/security/redis/SecurityRedisPropertiesTest.java new file mode 100644 index 000000000..38438f62a --- /dev/null +++ b/springboot-starter-security/src/test/java/com/codingapi/springboot/security/redis/SecurityRedisPropertiesTest.java @@ -0,0 +1,37 @@ +package com.codingapi.springboot.security.redis; + +import org.junit.jupiter.api.Test; + +import static org.junit.jupiter.api.Assertions.assertEquals; +import static org.junit.jupiter.api.Assertions.assertFalse; +import static org.junit.jupiter.api.Assertions.assertTrue; + +/** + * SecurityRedisProperties 单元测试 + *

+ * 校验默认值与 setter/getter 行为。 + */ +class SecurityRedisPropertiesTest { + + @Test + void defaultValues() { + SecurityRedisProperties properties = new SecurityRedisProperties(); + + assertTrue(properties.isEnable()); + assertEquals(900000, properties.getValidTime()); + assertEquals(600000, properties.getRestTime()); + } + + @Test + void settersAndGetters() { + SecurityRedisProperties properties = new SecurityRedisProperties(); + properties.setEnable(false); + properties.setValidTime(1000); + properties.setRestTime(500); + + assertFalse(properties.isEnable()); + assertEquals(1000, properties.getValidTime()); + assertEquals(500, properties.getRestTime()); + } + +} diff --git a/springboot-starter-security-jwt/src/test/resources/application.properties b/springboot-starter-security/src/test/resources/application.properties similarity index 77% rename from springboot-starter-security-jwt/src/test/resources/application.properties rename to springboot-starter-security/src/test/resources/application.properties index 3848c3551..d228eabb0 100644 --- a/springboot-starter-security-jwt/src/test/resources/application.properties +++ b/springboot-starter-security/src/test/resources/application.properties @@ -1,14 +1,16 @@ server.port=8088 -codingapi.security.jwt-time=10000 -codingapi.security.jwt-rest-time=5000 +codingapi.security.jwt.valid-time=10000 +codingapi.security.jwt.rest-time=5000 + +codingapi.security.jwt.enable=true # JWT密钥 需大于32位的字符串 -codingapi.security.jwt-secret=codingapi.security.jwt.secretkey +codingapi.security.jwt.secret-key=codingapi.security.jwt.secretkey # JWT AES密钥 codingapi.security.ase-key=QUNEWCQlXiYqJCNYQ1phc0FDRFgkJV4mKiQjWENaYXM= # JWT AES IV -codingapi.security.aes-iv=QUNYRkdIQEVEUyNYQ1phcw== +codingapi.security.ase-iv=QUNYRkdIQEVEUyNYQ1phcw== # JWT 有效时间(毫秒) 15分钟有效期 1000*60*15=900000 #codingapi.security.jwt-time=900000 diff --git a/springboot-starter-security/src/test/resources/mockito-extensions/org.mockito.plugins.MockMaker b/springboot-starter-security/src/test/resources/mockito-extensions/org.mockito.plugins.MockMaker new file mode 100644 index 000000000..1f0955d45 --- /dev/null +++ b/springboot-starter-security/src/test/resources/mockito-extensions/org.mockito.plugins.MockMaker @@ -0,0 +1 @@ +mock-maker-inline diff --git a/springboot-starter/pom.xml b/springboot-starter/pom.xml index 307092424..00a0dc32d 100644 --- a/springboot-starter/pom.xml +++ b/springboot-starter/pom.xml @@ -5,14 +5,14 @@ com.codingapi.springboot springboot-parent - 2.1.11 + ${revision} springboot-starter springboot-starter springboot-starter project for Spring Boot - 17 + 8 @@ -21,6 +21,16 @@ spring-data-commons + + jakarta.persistence + jakarta.persistence-api + + + + com.fasterxml.jackson.core + jackson-databind + + org.springframework spring-tx @@ -38,7 +48,7 @@ org.bouncycastle - bcprov-jdk15on + bcprov-jdk18on @@ -47,8 +57,8 @@ - org.apache.httpcomponents.client5 - httpclient5 + org.apache.httpcomponents + httpclient @@ -87,6 +97,21 @@ test + + org.apache.groovy + groovy + + + + org.apache.groovy + groovy-json + + + + org.apache.groovy + groovy-xml + + diff --git a/springboot-starter/src/main/java/com/codingapi/springboot/framework/AutoConfiguration.java b/springboot-starter/src/main/java/com/codingapi/springboot/framework/AutoConfiguration.java index 2cfc0ae1d..194c779d9 100644 --- a/springboot-starter/src/main/java/com/codingapi/springboot/framework/AutoConfiguration.java +++ b/springboot-starter/src/main/java/com/codingapi/springboot/framework/AutoConfiguration.java @@ -1,8 +1,32 @@ package com.codingapi.springboot.framework; +import com.codingapi.springboot.framework.properties.FrameworkProperties; +import com.codingapi.springboot.framework.properties.PropertiesContext; +import com.codingapi.springboot.framework.utils.VersionUtils; +import org.springframework.beans.factory.InitializingBean; +import org.springframework.boot.context.properties.ConfigurationProperties; +import org.springframework.context.annotation.Bean; import org.springframework.context.annotation.Configuration; @Configuration -public class AutoConfiguration { +public class AutoConfiguration implements InitializingBean { + @Override + public void afterPropertiesSet() throws Exception { + String version = VersionUtils.getDriverVersion(); + this.printBanner(version); + } + + @Bean + @ConfigurationProperties(prefix = "codingapi.framework") + public FrameworkProperties frameworkProperties() { + FrameworkProperties properties = new FrameworkProperties(); + PropertiesContext.getInstance().setProperties(properties); + return properties; + } + public void printBanner(String version) { + System.out.println("------------------------------------------------------"); + System.out.println("\t\tCodingApi SpringBoot-Starter " + version); + System.out.println("------------------------------------------------------"); + } } diff --git a/springboot-starter/src/main/java/com/codingapi/springboot/framework/annotation/ColumnType.java b/springboot-starter/src/main/java/com/codingapi/springboot/framework/annotation/ColumnType.java new file mode 100644 index 000000000..40bb84f17 --- /dev/null +++ b/springboot-starter/src/main/java/com/codingapi/springboot/framework/annotation/ColumnType.java @@ -0,0 +1,52 @@ +package com.codingapi.springboot.framework.annotation; + +/** + * 数据库字段类型 + */ +public enum ColumnType { + + /** + * 整数 + */ + Number, + + /** + * 浮点数 + */ + Float, + + /** + * 字符串 + */ + String, + + /** + * 日期 + */ + Date, + + /** + * 文件 + */ + File, + + /** + * 布尔 + */ + Boolean, + + /** + * 字节 + */ + Bytes, + + /** + * JSON + */ + JSON, + + /** + * 任意 + */ + Any +} diff --git a/springboot-starter/src/main/java/com/codingapi/springboot/framework/annotation/MetaColumn.java b/springboot-starter/src/main/java/com/codingapi/springboot/framework/annotation/MetaColumn.java new file mode 100644 index 000000000..289a1d04e --- /dev/null +++ b/springboot-starter/src/main/java/com/codingapi/springboot/framework/annotation/MetaColumn.java @@ -0,0 +1,43 @@ +package com.codingapi.springboot.framework.annotation; + +import java.lang.annotation.*; + +/** + * 查询字段 + */ +@Target({ElementType.FIELD}) +@Retention(RetentionPolicy.RUNTIME) +@Documented +public @interface MetaColumn { + + /** + * 字段说明 + */ + String desc(); + + /** + * 字段名称 + */ + String name(); + + /** + * 是否主键 + */ + boolean primaryKey() default false; + + /** + * 字段类型 + */ + ColumnType type() default ColumnType.String; + + /** + * 格式化 + */ + String format() default ""; + + /** + * 依赖表 + */ + MetaRelation dependent() default @MetaRelation(tableName = "", columnName = ""); + +} diff --git a/springboot-starter/src/main/java/com/codingapi/springboot/framework/annotation/MetaRelation.java b/springboot-starter/src/main/java/com/codingapi/springboot/framework/annotation/MetaRelation.java new file mode 100644 index 000000000..2ee407108 --- /dev/null +++ b/springboot-starter/src/main/java/com/codingapi/springboot/framework/annotation/MetaRelation.java @@ -0,0 +1,20 @@ +package com.codingapi.springboot.framework.annotation; + +import java.lang.annotation.Documented; +import java.lang.annotation.Retention; +import java.lang.annotation.RetentionPolicy; + +@Retention(RetentionPolicy.RUNTIME) +@Documented +public @interface MetaRelation { + + /** + * 表名称 + */ + String tableName(); + + /** + * 字段名称 + */ + String columnName(); +} diff --git a/springboot-starter/src/main/java/com/codingapi/springboot/framework/annotation/MetaTable.java b/springboot-starter/src/main/java/com/codingapi/springboot/framework/annotation/MetaTable.java new file mode 100644 index 000000000..6075b1eb0 --- /dev/null +++ b/springboot-starter/src/main/java/com/codingapi/springboot/framework/annotation/MetaTable.java @@ -0,0 +1,23 @@ +package com.codingapi.springboot.framework.annotation; + +import java.lang.annotation.*; + +/** + * 查询表 + */ +@Target({ElementType.TYPE}) +@Retention(RetentionPolicy.RUNTIME) +@Documented +public @interface MetaTable { + + /** + * 表说明 + */ + String desc(); + + /** + * 表名称 + */ + String name(); + +} diff --git a/springboot-starter/src/main/java/com/codingapi/springboot/framework/crypto/SHA256.java b/springboot-starter/src/main/java/com/codingapi/springboot/framework/crypto/SHA256.java new file mode 100644 index 000000000..fd7c8ae47 --- /dev/null +++ b/springboot-starter/src/main/java/com/codingapi/springboot/framework/crypto/SHA256.java @@ -0,0 +1,23 @@ +package com.codingapi.springboot.framework.crypto; + +import lombok.extern.slf4j.Slf4j; +import org.bouncycastle.util.encoders.Hex; + +import java.nio.charset.StandardCharsets; +import java.security.MessageDigest; +import java.security.NoSuchAlgorithmException; + +@Slf4j +public class SHA256 { + + public static String sha256(String data) { + try { + byte[] digest = MessageDigest.getInstance("SHA-256") + .digest(data.getBytes(StandardCharsets.UTF_8)); + return Hex.toHexString(digest); + } catch (NoSuchAlgorithmException exception) { + log.error("sha256 error:", exception); + return data; + } + } +} diff --git a/springboot-starter/src/main/java/com/codingapi/springboot/framework/domain/ISort.java b/springboot-starter/src/main/java/com/codingapi/springboot/framework/domain/ISort.java new file mode 100644 index 000000000..f9efc10af --- /dev/null +++ b/springboot-starter/src/main/java/com/codingapi/springboot/framework/domain/ISort.java @@ -0,0 +1,8 @@ +package com.codingapi.springboot.framework.domain; + +public interface ISort { + + void setSort(Integer sort); + + Integer getSort(); +} diff --git a/springboot-starter/src/main/java/com/codingapi/springboot/framework/dto/offset/ICurrentOffset.java b/springboot-starter/src/main/java/com/codingapi/springboot/framework/dto/offset/ICurrentOffset.java new file mode 100644 index 000000000..206354da6 --- /dev/null +++ b/springboot-starter/src/main/java/com/codingapi/springboot/framework/dto/offset/ICurrentOffset.java @@ -0,0 +1,7 @@ +package com.codingapi.springboot.framework.dto.offset; + +public interface ICurrentOffset { + + void setCurrent(int current); + +} diff --git a/springboot-starter/src/main/java/com/codingapi/springboot/framework/dto/offset/ICurrentPageOffset.java b/springboot-starter/src/main/java/com/codingapi/springboot/framework/dto/offset/ICurrentPageOffset.java new file mode 100644 index 000000000..cd79e40b8 --- /dev/null +++ b/springboot-starter/src/main/java/com/codingapi/springboot/framework/dto/offset/ICurrentPageOffset.java @@ -0,0 +1,6 @@ +package com.codingapi.springboot.framework.dto.offset; + +public interface ICurrentPageOffset { + + int getCurrentPage(ICurrentOffset target, int current); +} diff --git a/springboot-starter/src/main/java/com/codingapi/springboot/framework/dto/offset/context/CurrentPageOffsetContext.java b/springboot-starter/src/main/java/com/codingapi/springboot/framework/dto/offset/context/CurrentPageOffsetContext.java new file mode 100644 index 000000000..392d8af41 --- /dev/null +++ b/springboot-starter/src/main/java/com/codingapi/springboot/framework/dto/offset/context/CurrentPageOffsetContext.java @@ -0,0 +1,31 @@ +package com.codingapi.springboot.framework.dto.offset.context; + +import com.codingapi.springboot.framework.dto.offset.ICurrentOffset; +import com.codingapi.springboot.framework.dto.offset.ICurrentPageOffset; +import com.codingapi.springboot.framework.dto.request.PageRequest; +import lombok.Getter; +import lombok.Setter; + +public class CurrentPageOffsetContext implements ICurrentPageOffset { + + @Getter + private static final CurrentPageOffsetContext instance = new CurrentPageOffsetContext(); + + private CurrentPageOffsetContext(){} + + @Setter + private ICurrentPageOffset currentPageOffset = new ICurrentPageOffset(){ + @Override + public int getCurrentPage(ICurrentOffset target, int current) { + if(target instanceof PageRequest){ + return current; + } + return current - 1; + } + }; + + public int getCurrentPage(ICurrentOffset target,int current) { + return currentPageOffset.getCurrentPage(target,current); + } + +} diff --git a/springboot-starter/src/main/java/com/codingapi/springboot/framework/dto/request/Filter.java b/springboot-starter/src/main/java/com/codingapi/springboot/framework/dto/request/Filter.java new file mode 100644 index 000000000..c7223a900 --- /dev/null +++ b/springboot-starter/src/main/java/com/codingapi/springboot/framework/dto/request/Filter.java @@ -0,0 +1,132 @@ +package com.codingapi.springboot.framework.dto.request; + +import lombok.Getter; +import lombok.Setter; + +@Setter +@Getter +public class Filter { + + public static final String FILTER_OR_KEY = "FILTER_OR_KEY"; + public static final String FILTER_AND_KEY = "FILTER_AND_KEY"; + + private String key; + private Object[] value; + private Relation relation; + + public Filter(String key, Relation relation, Object... value) { + this.key = key; + this.value = value; + this.relation = relation; + } + + public Filter(String key, Object... value) { + this(key, Relation.EQUAL, value); + } + + public Filter(String key, Filter... value) { + this(key, null, value); + } + + public static Filter as(String key, Relation relation, Object... value) { + return new Filter(key, relation, value); + } + + public static Filter as(String key, Object... value) { + return new Filter(key, value); + } + + public static Filter and(Filter... value) { + return new Filter(FILTER_AND_KEY, value); + } + + public static Filter or(Filter... value) { + return new Filter(FILTER_OR_KEY, value); + } + + public boolean isEqual() { + return relation == Relation.EQUAL; + } + + public boolean isNull() { + return relation == Relation.IS_NULL; + } + + public boolean isNotNull() { + return relation == Relation.IS_NOT_NULL; + } + + public boolean isNotIn() { + return relation == Relation.NOT_IN; + } + + public boolean isNotEqual() { + return relation == Relation.NOT_EQUAL; + } + + public boolean isLike() { + return relation == Relation.LIKE; + } + + + public boolean isLeftLike() { + return relation == Relation.LEFT_LIKE; + } + + public boolean isRightLike() { + return relation == Relation.RIGHT_LIKE; + } + + + public boolean isBetween() { + return relation == Relation.BETWEEN; + } + + public boolean isIn() { + return relation == Relation.IN; + } + + public boolean isOrFilters() { + return FILTER_OR_KEY.equals(key); + } + + public boolean isAndFilters() { + return FILTER_AND_KEY.equals(key); + } + + public boolean isGreaterThan() { + return relation == Relation.GREATER_THAN; + } + + public boolean isLessThan() { + return relation == Relation.LESS_THAN; + } + + public boolean isGreaterThanEqual() { + return relation == Relation.GREATER_THAN_EQUAL; + } + + public boolean isLessThanEqual() { + return relation == Relation.LESS_THAN_EQUAL; + } + + public Object getFilterValue(Class clazz) { + Object val = value[0]; + if (val instanceof String) { + if (clazz == Integer.class) { + return Integer.parseInt((String) val); + } + if (clazz == Long.class) { + return Long.parseLong((String) val); + } + if (clazz == Double.class) { + return Double.parseDouble((String) val); + } + if (clazz == Float.class) { + return Float.parseFloat((String) val); + } + } + return value[0]; + } + +} diff --git a/springboot-starter/src/main/java/com/codingapi/springboot/framework/dto/request/IdRequest.java b/springboot-starter/src/main/java/com/codingapi/springboot/framework/dto/request/IdRequest.java new file mode 100644 index 000000000..b325423e6 --- /dev/null +++ b/springboot-starter/src/main/java/com/codingapi/springboot/framework/dto/request/IdRequest.java @@ -0,0 +1,33 @@ +package com.codingapi.springboot.framework.dto.request; + +import lombok.Getter; +import lombok.Setter; + +@Setter +@Getter +public class IdRequest { + + private String id; + + public String getStringId(){ + return id; + } + + public int getIntId(){ + return Integer.parseInt(id); + } + + public Long getLongId(){ + return Long.parseLong(id); + } + + public float getFloatId(){ + return Float.parseFloat(id); + } + + public double getDoubleId(){ + return Double.parseDouble(id); + } + + +} diff --git a/springboot-starter/src/main/java/com/codingapi/springboot/framework/dto/request/PageRequest.java b/springboot-starter/src/main/java/com/codingapi/springboot/framework/dto/request/PageRequest.java index b7af6da8d..7320a994f 100644 --- a/springboot-starter/src/main/java/com/codingapi/springboot/framework/dto/request/PageRequest.java +++ b/springboot-starter/src/main/java/com/codingapi/springboot/framework/dto/request/PageRequest.java @@ -1,136 +1,69 @@ package com.codingapi.springboot.framework.dto.request; -import jakarta.servlet.http.HttpServletRequest; +import com.codingapi.springboot.framework.dto.offset.context.CurrentPageOffsetContext; +import com.codingapi.springboot.framework.dto.offset.ICurrentOffset; import lombok.Getter; -import org.springframework.beans.BeanUtils; -import org.springframework.data.domain.Example; -import org.springframework.data.domain.Pageable; +import lombok.Setter; import org.springframework.data.domain.Sort; -import org.springframework.util.StringUtils; -import org.springframework.web.context.request.RequestContextHolder; -import org.springframework.web.context.request.ServletRequestAttributes; -import java.beans.PropertyDescriptor; -import java.util.Enumeration; -import java.util.HashMap; -import java.util.Map; -import java.util.Optional; - -public class PageRequest extends org.springframework.data.domain.PageRequest { +public class PageRequest extends org.springframework.data.domain.PageRequest implements ICurrentOffset { @Getter private int current; + + @Setter private int pageSize; - private final Map filters = new HashMap<>(); + @Getter + private Sort sort; @Getter - private HttpServletRequest servletRequest; + private final RequestFilter requestFilter = new RequestFilter(); - private org.springframework.data.domain.PageRequest pageRequest; public PageRequest(int current, int pageSize, Sort sort) { - super(current > 0 ? current-- : 0, pageSize, sort); + super(current, pageSize, sort); this.current = current; this.pageSize = pageSize; - this.pageRequest = PageRequest.of(current, pageSize, sort); - - try { - ServletRequestAttributes attributes = (ServletRequestAttributes) RequestContextHolder.currentRequestAttributes(); - this.servletRequest = attributes.getRequest(); - this.syncParameter(); - } catch (Exception e) { - } + this.sort = sort; } - private void syncParameter() { - Enumeration enumeration = servletRequest.getParameterNames(); - while (enumeration.hasMoreElements()) { - String key = enumeration.nextElement(); - String value = servletRequest.getParameter(key); - if (StringUtils.hasText(value)) { - this.filters.put(key, value); - } - } - } - public PageRequest() { this(0, 20, Sort.unsorted()); } public void setCurrent(int current) { - this.current = current > 0 ? current - 1 : 0; - } - - public String getParameter(String key) { - return servletRequest.getParameter(key); - } - - public String getParameter(String key, String defaultValue) { - String result = servletRequest.getParameter(key); - return result == null ? defaultValue : result; - } - - public int getIntParameter(String key) { - return Integer.parseInt(servletRequest.getParameter(key)); - } - - public int getIntParameter(String key, int defaultValue) { - String result = servletRequest.getParameter(key); - return result == null ? defaultValue : Integer.parseInt(result); - } - - public Map getFilters() { - return filters; + this.current = CurrentPageOffsetContext.getInstance().getCurrentPage(this,current); } public String getStringFilter(String key) { - return (String) filters.get(key); + return requestFilter.getStringFilter(key); } + public String getStringFilter(String key, String defaultValue) { - String result = (String) filters.get(key); - return result == null ? defaultValue : result; + return requestFilter.getStringFilter(key, defaultValue); } public int getIntFilter(String key) { - return Integer.parseInt((String) filters.get(key)); - } - - public int getIntFilter(String key, int defaultValue) { - String result = (String) filters.get(key); - return result == null ? defaultValue : Integer.parseInt(result); + return requestFilter.getIntFilter(key); } - @Override - public int getPageSize() { - return pageSize; - } - - public void setPageSize(int pageSize) { - this.pageSize = pageSize; + public int getIntFilter(String key, int defaultValue) { + return requestFilter.getIntFilter(key, defaultValue); } - @Override - public Sort getSort() { - return pageRequest.getSort(); - } - @Override - public org.springframework.data.domain.PageRequest next() { - return new PageRequest(current + 1, getPageSize(), getSort()); + public boolean hasFilter() { + return requestFilter.hasFilter(); } - @Override - public org.springframework.data.domain.PageRequest previous() { - return current == 0 ? this : new PageRequest(current - 1, getPageSize(), getSort()); - } @Override - public org.springframework.data.domain.PageRequest first() { - return new PageRequest(0, getPageSize(), getSort()); + public int getPageSize() { + return pageSize; } @Override @@ -148,72 +81,44 @@ public boolean hasPrevious() { return current > 0; } - @Override - public Pageable previousOrFirst() { - return pageRequest.previousOrFirst(); - } - - @Override - public boolean isPaged() { - return pageRequest.isPaged(); + public void addSort(Sort sort) { + Sort nowSort = this.sort; + if (nowSort == Sort.unsorted()) { + this.sort = sort; + } else { + this.sort.and(sort); + } } - @Override - public boolean isUnpaged() { - return pageRequest.isUnpaged(); + public void removeFilter(String key) { + requestFilter.removeFilter(key); } - @Override - public Sort getSortOr(Sort sort) { - return pageRequest.getSortOr(sort); + public PageRequest addFilter(String key, Relation relation, Object... value) { + requestFilter.addFilter(key, relation, value); + return this; } - @Override - public Optional toOptional() { - return pageRequest.toOptional(); + public PageRequest addFilter(String key, Object... value) { + requestFilter.addFilter(key, value); + return this; } - public void addSort(Sort sort) { - Sort nowSort = pageRequest.getSort(); - if (nowSort == Sort.unsorted()) { - this.pageRequest = new PageRequest(getCurrent(), getPageSize(), sort); - } else { - pageRequest.getSort().and(sort); - } + public PageRequest andFilter(Filter... filters) { + requestFilter.andFilters(filters); + return this; } - public PageRequest addFilter(String key, Object value) { - this.filters.put(key, value); + public PageRequest orFilters(Filter... filters) { + requestFilter.orFilters(filters); return this; } - public boolean hasFilter() { - return !this.filters.isEmpty(); + public static PageRequest of(int page, int size) { + return new PageRequest(page, size, Sort.unsorted()); } - public Example getExample(Class clazz) { - if (!hasFilter()) { - return null; - } - Object entity = null; - try { - entity = clazz.getDeclaredConstructor().newInstance(); - } catch (Exception e) { - throw new RuntimeException(e); - } - PropertyDescriptor[] descriptors = BeanUtils.getPropertyDescriptors(clazz); - for (PropertyDescriptor descriptor : descriptors) { - String name = descriptor.getName(); - Object value = filters.get(name); - if (value != null) { - try { - descriptor.getWriteMethod().invoke(entity, value); - } catch (Exception e) { - } - } - } - return (Example) Example.of(entity); - + public static PageRequest of(int page, int size, Sort sort) { + return new PageRequest(page, size, sort); } } - diff --git a/springboot-starter/src/main/java/com/codingapi/springboot/framework/dto/request/Relation.java b/springboot-starter/src/main/java/com/codingapi/springboot/framework/dto/request/Relation.java new file mode 100644 index 000000000..3fd9fce5a --- /dev/null +++ b/springboot-starter/src/main/java/com/codingapi/springboot/framework/dto/request/Relation.java @@ -0,0 +1,19 @@ +package com.codingapi.springboot.framework.dto.request; + +public enum Relation { + + NOT_EQUAL, + EQUAL, + LIKE, + LEFT_LIKE, + RIGHT_LIKE, + BETWEEN, + IN, + NOT_IN, + IS_NULL, + IS_NOT_NULL, + GREATER_THAN, + LESS_THAN, + GREATER_THAN_EQUAL, + LESS_THAN_EQUAL, +} diff --git a/springboot-starter/src/main/java/com/codingapi/springboot/framework/dto/request/RequestFilter.java b/springboot-starter/src/main/java/com/codingapi/springboot/framework/dto/request/RequestFilter.java new file mode 100644 index 000000000..6e6a8d601 --- /dev/null +++ b/springboot-starter/src/main/java/com/codingapi/springboot/framework/dto/request/RequestFilter.java @@ -0,0 +1,112 @@ +package com.codingapi.springboot.framework.dto.request; + +import org.springframework.util.StringUtils; + +import java.util.ArrayList; +import java.util.HashMap; +import java.util.List; +import java.util.Map; + +public class RequestFilter { + + private final Map filterMap = new HashMap<>(); + private final List filterList = new ArrayList<>(); + + public RequestFilter addFilter(String key, Relation relation, Object... value) { + this.pushFilter(new Filter(key, relation, value)); + return this; + } + + public RequestFilter addFilter(String key, Object... value) { + this.pushFilter(new Filter(key, value)); + return this; + } + + public RequestFilter andFilters(Filter... value) { + this.pushFilter(new Filter(Filter.FILTER_AND_KEY, value)); + return this; + } + + public RequestFilter orFilters(Filter... value) { + this.pushFilter(new Filter(Filter.FILTER_OR_KEY, value)); + return this; + } + + public List getFilters() { + return filterList; + } + + public void pushFilter(Filter filter) { + filterList.removeIf(item -> item.getKey().equals(filter.getKey())); + filterList.add(filter); + filterMap.put(filter.getKey(), filter); + } + + + public String getStringFilter(String key) { + Filter filter = filterMap.get(key); + if (filter != null) { + return (String) filter.getValue()[0]; + } + return null; + } + + public String getStringFilter(String key, String defaultValue) { + String value = getStringFilter(key); + if (!StringUtils.hasText(value)) { + return defaultValue; + } + return value; + } + + public int getIntFilter(String key) { + Filter filter = filterMap.get(key); + if (filter != null) { + String value = (String) filter.getValue()[0]; + if (StringUtils.hasText(value)) { + return Integer.parseInt(value); + } + return 0; + } + return 0; + } + + public int getIntFilter(String key, int defaultValue) { + int value = getIntFilter(key); + if (value == 0) { + return defaultValue; + } + return value; + } + + + public boolean hasFilter() { + return !this.filterMap.isEmpty(); + } + + /** + * 判断所有过滤条件是否均为简单等值匹配（无 OR/AND 组合、无 LIKE/范围/IN 等复杂条件）， + * 用于决定走 Example 查询还是 HQL 动态查询 + */ + public boolean isAllEqualFilter() { + if (filterList.isEmpty()) { + return false; + } + for (Filter filter : filterList) { + if (!filter.isEqual()) { + return false; + } + } + return true; + } + + + public Filter getFilter(String name) { + return this.filterMap.get(name); + } + + public void removeFilter(String key) { + this.filterMap.remove(key); + this.filterList.removeIf(item -> item.getKey().equals(key)); + } +} diff --git a/springboot-starter/src/main/java/com/codingapi/springboot/framework/dto/request/SearchRequest.java b/springboot-starter/src/main/java/com/codingapi/springboot/framework/dto/request/SearchRequest.java new file mode 100644 index 000000000..2a56cce69 --- /dev/null +++ b/springboot-starter/src/main/java/com/codingapi/springboot/framework/dto/request/SearchRequest.java @@ -0,0 +1,275 @@ +package com.codingapi.springboot.framework.dto.request; + +import com.alibaba.fastjson.JSON; +import com.alibaba.fastjson.JSONArray; +import com.alibaba.fastjson.JSONObject; +import com.codingapi.springboot.framework.dto.offset.context.CurrentPageOffsetContext; +import com.codingapi.springboot.framework.dto.offset.ICurrentOffset; +import lombok.Getter; +import lombok.Setter; +import org.springframework.data.domain.Sort; +import org.springframework.util.StringUtils; +import org.springframework.web.context.request.RequestContextHolder; +import org.springframework.web.context.request.ServletRequestAttributes; + +import javax.servlet.http.HttpServletRequest; +import java.lang.reflect.Field; +import java.util.ArrayList; +import java.util.Base64; +import java.util.Enumeration; +import java.util.List; +import java.util.stream.Collectors; + +/** + * HttpServletRequest 请求参数解析成 PageRequest对象 + */ +public class SearchRequest implements ICurrentOffset { + + @Getter + private int current; + @Getter + private int pageSize; + + private final HttpServletRequest request; + + private final List removeKeys = new ArrayList<>(); + + private final PageRequest pageRequest; + + public SearchRequest() { + ServletRequestAttributes attributes = (ServletRequestAttributes) RequestContextHolder.currentRequestAttributes(); + this.request = attributes.getRequest(); + this.pageRequest = new PageRequest(); + } + + public void setCurrent(int current) { + this.current = CurrentPageOffsetContext.getInstance().getCurrentPage(this,current); + this.removeKeys.add("current"); + } + + public void setPageSize(int pageSize) { + this.pageSize = pageSize; + this.removeKeys.add("pageSize"); + } + + public void addSort(Sort sort) { + pageRequest.addSort(sort); + } + + public void removeFilter(String key) { + pageRequest.removeFilter(key); + this.removeKeys.add(key); + } + + public String getParameter(String key) { + return request.getParameter(key); + } + + public String[] getParameterValues(String key) { + return request.getParameterValues(key); + } + + + public List getParameterNames() { + Enumeration enumeration = request.getParameterNames(); + List list = new ArrayList<>(); + while (enumeration.hasMoreElements()) { + list.add(enumeration.nextElement()); + } + return list; + } + + public PageRequest addFilter(String key, Relation relation, Object... value) { + return pageRequest.addFilter(key, relation, value); + } + + public PageRequest addFilter(String key, Object... value) { + return pageRequest.addFilter(key, value); + } + + public PageRequest andFilter(Filter... filters) { + return pageRequest.andFilter(filters); + } + + public PageRequest orFilters(Filter... filters) { + return pageRequest.orFilters(filters); + } + + + /** + * Base64 解码，非法的 Base64 输入返回 null（由调用方按未消费参数处理），避免抛出 IllegalArgumentException + */ + private String decode(String value) { + try { + return new String(Base64.getDecoder().decode(value)); + } catch (IllegalArgumentException e) { + return null; + } + } + + + static class ClassContent { + + private final Class clazz; + private final PageRequest pageRequest; + + public ClassContent(Class clazz, PageRequest pageRequest) { + this.clazz = clazz; + this.pageRequest = pageRequest; + } + + public void addFilter(String key, Relation relation, String value) { + Class keyClass = getKeyType(key); + Object v = parseObject(value, keyClass); + pageRequest.addFilter(key, relation, v); + } + + public void addFilter(String key, String value) { + Class keyClass = getKeyType(key); + Object v = parseObject(value, keyClass); + pageRequest.addFilter(key, Relation.EQUAL, v); + } + + private Object parseObject(String value, Class keyClass) { + if (value.getClass().equals(keyClass)) { + return value; + } + return JSON.parseObject(value, keyClass); + } + + public void addFilter(String key, List value) { + Class keyClass = getKeyType(key); + pageRequest.addFilter(key, Relation.IN, value.stream() + .map(v -> parseObject(v, keyClass)) + .toArray() + ); + } + + + + private Class getKeyType(String key) { + String[] keys = key.split("\\."); + Class keyClass = clazz; + + for (String k : keys) { + keyClass = findFieldInHierarchy(keyClass, k); + + if (keyClass == null) { + throw new IllegalArgumentException("Field " + k + " not found in class hierarchy."); + } + } + return keyClass; + } + + private Class findFieldInHierarchy(Class clazz, String fieldName) { + Class currentClass = clazz; + + while (currentClass != null) { + Field[] fields = currentClass.getDeclaredFields(); + for (Field field : fields) { + if (field.getName().equals(fieldName)) { + return field.getType(); + } + } + currentClass = currentClass.getSuperclass(); // 向上查找父类 + } + return null; + } + + } + + @Setter + @Getter + static class ParamOperation { + private String key; + private String type; + + public Relation getOperation() { + return Relation.valueOf(type); + } + } + + private List loadParamOperations() { + String params = request.getParameter("params"); + if (StringUtils.hasLength(params)) { + params = decode(params); + if (params != null && JSON.isValid(params)) { + removeKeys.add("params"); + return JSON.parseArray(params, ParamOperation.class); + } + } + return null; + } + + public PageRequest toPageRequest(Class clazz) { + pageRequest.setCurrent(current); + pageRequest.setPageSize(pageSize); + + ClassContent content = new ClassContent(clazz, pageRequest); + + List loadParams = loadParamOperations(); + + String sort = request.getParameter("sort"); + if (StringUtils.hasLength(sort)) { + sort = decode(sort); + if (sort != null && JSON.isValid(sort)) { + removeKeys.add("sort"); + JSONObject jsonObject = JSON.parseObject(sort); + for (String key : jsonObject.keySet()) { + String value = jsonObject.getString(key); + if ("ascend".equals(value)) { + pageRequest.addSort(Sort.by(key).ascending()); + } else { + pageRequest.addSort(Sort.by(key).descending()); + } + } + } + } + + + String filter = request.getParameter("filter"); + if (StringUtils.hasLength(filter)) { + filter = decode(filter); + if (filter != null && JSON.isValid(filter)) { + removeKeys.add("filter"); + JSONObject jsonObject = JSON.parseObject(filter); + if(jsonObject!=null) { + for (String key : jsonObject.keySet()) { + JSONArray value = jsonObject.getJSONArray(key); + if (value != null && !value.isEmpty()) { + List values = value.stream().map(Object::toString).collect(Collectors.toList()); + content.addFilter(key, values); + } + } + } + } + } + + Enumeration enumeration = request.getParameterNames(); + + while (enumeration.hasMoreElements()){ + String key = enumeration.nextElement(); + if (!removeKeys.contains(key)) { + String value = request.getParameter(key); + if (StringUtils.hasLength(value)) { + if (loadParams != null) { + ParamOperation operation = loadParams.stream() + .filter(paramOperation -> paramOperation.getKey().equals(key)) + .findFirst() + .orElse(null); + if (operation != null) { + content.addFilter(key, operation.getOperation(), value); + } else { + content.addFilter(key, value); + } + } else { + content.addFilter(key, value); + } + } + } + } + return pageRequest; + } + + +} diff --git a/springboot-starter/src/main/java/com/codingapi/springboot/framework/dto/request/SortRequest.java b/springboot-starter/src/main/java/com/codingapi/springboot/framework/dto/request/SortRequest.java new file mode 100644 index 000000000..25d5a9b99 --- /dev/null +++ b/springboot-starter/src/main/java/com/codingapi/springboot/framework/dto/request/SortRequest.java @@ -0,0 +1,14 @@ +package com.codingapi.springboot.framework.dto.request; + +import lombok.Getter; +import lombok.Setter; + +import java.util.List; + +@Setter +@Getter +public class SortRequest { + + private List ids; + +} diff --git a/springboot-starter/src/main/java/com/codingapi/springboot/framework/em/IEnum.java b/springboot-starter/src/main/java/com/codingapi/springboot/framework/em/IEnum.java new file mode 100644 index 000000000..d24151b15 --- /dev/null +++ b/springboot-starter/src/main/java/com/codingapi/springboot/framework/em/IEnum.java @@ -0,0 +1,6 @@ +package com.codingapi.springboot.framework.em; + +public interface IEnum { + + int getCode(); +} diff --git a/springboot-starter/src/main/java/com/codingapi/springboot/framework/event/ApplicationHandlerUtils.java b/springboot-starter/src/main/java/com/codingapi/springboot/framework/event/ApplicationHandlerUtils.java new file mode 100644 index 000000000..61c7a932f --- /dev/null +++ b/springboot-starter/src/main/java/com/codingapi/springboot/framework/event/ApplicationHandlerUtils.java @@ -0,0 +1,96 @@ +package com.codingapi.springboot.framework.event; + +import com.codingapi.springboot.framework.exception.EventException; +import com.codingapi.springboot.framework.exception.EventLoopException; +import org.springframework.core.ResolvableType; + +import java.util.ArrayList; +import java.util.Comparator; +import java.util.List; +import java.util.stream.Collectors; + +class ApplicationHandlerUtils implements IHandler { + + private static ApplicationHandlerUtils instance; + private final List> handlers; + + + private ApplicationHandlerUtils() { + this.handlers = new ArrayList<>(); + } + + public static ApplicationHandlerUtils getInstance() { + if (instance == null) { + synchronized (ApplicationHandlerUtils.class) { + if (instance == null) { + instance = new ApplicationHandlerUtils(); + } + } + } + return instance; + } + + public void addHandlers(List handlers) { + if (handlers != null) { + handlers.forEach(this::addHandler); + } + } + + + public void addHandler(IHandler handler) { + if (handler != null) { + handlers.add(handler); + } + } + + /** + * 获取订阅的事件类型 + */ + private Class getHandlerEventClass(IHandler handler) { + ResolvableType resolvableType = ResolvableType.forClass(handler.getClass()).as(IHandler.class); + return resolvableType.getGeneric(0).resolve(); + } + + + @Override + public void handler(IEvent event) { + Class eventClass = event.getClass(); + + List> matchHandlers = handlers + .stream() + .filter(handler -> { + Class targetClass = getHandlerEventClass(handler); + return targetClass.isAssignableFrom(eventClass); + }) + .sorted(Comparator.comparingInt(IHandler::order)) + .collect(Collectors.toList()); + + if (matchHandlers.isEmpty()) { + return; + } + + List errorStack = new ArrayList<>(); + boolean hasThrowException = false; + for (IHandler handler : matchHandlers) { + try { + handler.handler(event); + } catch (Exception e) { + if (e instanceof EventLoopException) { + throw e; + } + try { + handler.error(e); + errorStack.add(e); + } catch (Exception err) { + hasThrowException = true; + errorStack.add(err); + } + } + } + if (hasThrowException) { + throw new EventException(errorStack); + } + } + + +} diff --git a/springboot-starter/src/main/java/com/codingapi/springboot/framework/event/DomainEvent.java b/springboot-starter/src/main/java/com/codingapi/springboot/framework/event/DomainEvent.java index 1f478ac14..a03d694e2 100644 --- a/springboot-starter/src/main/java/com/codingapi/springboot/framework/event/DomainEvent.java +++ b/springboot-starter/src/main/java/com/codingapi/springboot/framework/event/DomainEvent.java @@ -18,10 +18,14 @@ public class DomainEvent extends ApplicationEvent { @Getter private final boolean sync; - public DomainEvent(Object source, boolean sync) { + @Getter + private final String traceId; + + + public DomainEvent(Object source, boolean sync, String traceId) { super(source); this.event = (IEvent) source; this.sync = sync; + this.traceId = traceId; } - } diff --git a/springboot-starter/src/main/java/com/codingapi/springboot/framework/event/DomainEventContext.java b/springboot-starter/src/main/java/com/codingapi/springboot/framework/event/DomainEventContext.java index f7bcd7c21..7d10e38c3 100644 --- a/springboot-starter/src/main/java/com/codingapi/springboot/framework/event/DomainEventContext.java +++ b/springboot-starter/src/main/java/com/codingapi/springboot/framework/event/DomainEventContext.java @@ -23,9 +23,15 @@ public static DomainEventContext getInstance() { return instance; } - private void push(IEvent event, boolean sync) { + private void push(IEvent event, boolean sync,boolean hasLoopEvent) { if (context != null) { - context.publishEvent(new DomainEvent(event, sync)); + String traceId = EventTraceContext.getInstance().getOrCreateTrace(); + if(hasLoopEvent){ + EventTraceContext.getInstance().clearTrace(); + traceId = EventTraceContext.getInstance().getOrCreateTrace(); + } + EventTraceContext.getInstance().addEvent(traceId,event); + context.publishEvent(new DomainEvent(event, sync,traceId)); } } @@ -34,13 +40,13 @@ private void push(IEvent event, boolean sync) { * @see EventPusher * 默认 同步事件 */ - public void push(IEvent event) { + public void push(IEvent event,boolean hasLoopEvent) { if (event instanceof IAsyncEvent) { - this.push(event, false); + this.push(event, false,hasLoopEvent); } else if (event instanceof ISyncEvent) { - this.push(event, true); + this.push(event, true,hasLoopEvent); } else { - this.push(event, true); + this.push(event, true,hasLoopEvent); } } diff --git a/springboot-starter/src/main/java/com/codingapi/springboot/framework/event/EventPusher.java b/springboot-starter/src/main/java/com/codingapi/springboot/framework/event/EventPusher.java index ee90ddd8e..333569eaf 100644 --- a/springboot-starter/src/main/java/com/codingapi/springboot/framework/event/EventPusher.java +++ b/springboot-starter/src/main/java/com/codingapi/springboot/framework/event/EventPusher.java @@ -5,7 +5,23 @@ */ public class EventPusher { + /** + * 推送事件 + * 默认将自动检测事件是否有循环事件，当出现循环事件时，系统将会抛出循环调用异常。 + * @param event 事件 + */ public static void push(IEvent event) { - DomainEventContext.getInstance().push(event); + push(event, false); + } + + /** + * 推送事件 + * 默认将自动检测事件是否有循环事件，当出现循环事件时，系统将会抛出循环调用异常。 + * 设置hasLoopEvent为true，将不会检测循环事件。 + * @param event 事件 + * @param hasLoopEvent 是否有循环事件 + */ + public static void push(IEvent event, boolean hasLoopEvent) { + DomainEventContext.getInstance().push(event, hasLoopEvent); } } diff --git a/springboot-starter/src/main/java/com/codingapi/springboot/framework/event/EventStackContext.java b/springboot-starter/src/main/java/com/codingapi/springboot/framework/event/EventStackContext.java new file mode 100644 index 000000000..bcc014070 --- /dev/null +++ b/springboot-starter/src/main/java/com/codingapi/springboot/framework/event/EventStackContext.java @@ -0,0 +1,80 @@ +package com.codingapi.springboot.framework.event; + +import lombok.Getter; + +import java.util.ArrayList; +import java.util.HashMap; +import java.util.List; +import java.util.Map; + +/** + * 事件栈上下文 + */ +public class EventStackContext { + + private final Map>> eventClassStack = new HashMap<>(); + private final Map> eventStack = new HashMap<>(); + + @Getter + private final static EventStackContext instance = new EventStackContext(); + + private EventStackContext() { + + } + + private void addEventClass(String traceId, IEvent event) { + List> events = eventClassStack.get(traceId); + if (events == null) { + events = new ArrayList<>(); + } + events.add(event.getClass()); + eventClassStack.put(traceId, events); + } + + private void addEventStack(String traceId, IEvent event) { + List events = eventStack.get(traceId); + if (events == null) { + events = new ArrayList<>(); + } + events.add(event); + eventStack.put(traceId, events); + } + + + void addEvent(String traceId, IEvent event) { + addEventClass(traceId, event); + addEventStack(traceId, event); + } + + boolean checkEventLoop(String traceId, IEvent event) { + List> events = eventClassStack.get(traceId); + if (events != null) { + return events.contains(event.getClass()); + } + return false; + } + + public List getEvents(String eventKey) { + if(eventKey!=null) { + String traceId = eventKey.split("#")[0]; + return eventStack.get(traceId); + } + return null; + } + + public List> getEventClasses(String eventKey) { + if(eventKey!=null) { + String traceId = eventKey.split("#")[0]; + return eventClassStack.get(traceId); + } + return null; + } + + + void remove(String traceId) { + eventStack.remove(traceId); + eventClassStack.remove(traceId); + } + + +} diff --git a/springboot-starter/src/main/java/com/codingapi/springboot/framework/event/EventTraceContext.java b/springboot-starter/src/main/java/com/codingapi/springboot/framework/event/EventTraceContext.java new file mode 100644 index 000000000..6088234ce --- /dev/null +++ b/springboot-starter/src/main/java/com/codingapi/springboot/framework/event/EventTraceContext.java @@ -0,0 +1,107 @@ +package com.codingapi.springboot.framework.event; + +import com.codingapi.springboot.framework.exception.EventLoopException; +import com.codingapi.springboot.framework.utils.RandomGenerator; +import lombok.Getter; + +import java.util.*; + +/** + * 事件跟踪上下文 + */ +public class EventTraceContext { + + @Getter + private final static EventTraceContext instance = new EventTraceContext(); + + // trace key + private final Set traceKeys = new HashSet<>(); + + // thread local + private final ThreadLocal threadLocal = new ThreadLocal<>(); + + // event listenerKey state + private final Map eventKeyState = new HashMap<>(); + + + private EventTraceContext() { + } + + String getOrCreateTrace() { + String eventKey = threadLocal.get(); + if (eventKey != null) { + return eventKey.split("#")[0]; + } + String traceId = UUID.randomUUID().toString().replaceAll("-", ""); + traceKeys.add(traceId); + return traceId; + } + + /** + * get event key + * traceId = eventKey.split("#")[0] + */ + public String getEventKey() { + return threadLocal.get(); + } + + /** + * create event key + * @param traceId traceId + */ + void createEventKey(String traceId) { + String eventKey = traceId + "#" + RandomGenerator.randomString(8); + eventKeyState.put(eventKey, false); + threadLocal.set(eventKey); + } + + /** + * check event state + */ + void checkEventState() { + String eventKey = threadLocal.get(); + if (eventKey != null) { + Boolean state = eventKeyState.get(eventKey); + if (state!=null && !state) { + // event execute finish + String traceId = eventKey.split("#")[0]; + traceKeys.remove(traceId); + EventStackContext.getInstance().remove(traceId); + } + eventKeyState.remove(eventKey); + } + threadLocal.remove(); + } + + /** + * add event + * @param traceId traceId + * @param event event + */ + void addEvent(String traceId, IEvent event) { + boolean hasEventLoop = EventStackContext.getInstance().checkEventLoop(traceId, event); + if (hasEventLoop) { + List> stack = EventStackContext.getInstance().getEventClasses(traceId); + traceKeys.remove(traceId); + EventStackContext.getInstance().remove(traceId); + eventKeyState.remove(traceId); + threadLocal.remove(); + throw new EventLoopException(stack, event); + } + EventStackContext.getInstance().addEvent(traceId, event); + } + + /** + * clear trace + */ + public void clearTrace() { + String eventKey = threadLocal.get(); + if (eventKey != null) { + String traceId = eventKey.split("#")[0]; + traceKeys.remove(traceId); + EventStackContext.getInstance().remove(traceId); + eventKeyState.remove(eventKey); + threadLocal.remove(); + } + } +} diff --git a/springboot-starter/src/main/java/com/codingapi/springboot/framework/handler/Handler.java b/springboot-starter/src/main/java/com/codingapi/springboot/framework/event/Handler.java similarity index 76% rename from springboot-starter/src/main/java/com/codingapi/springboot/framework/handler/Handler.java rename to springboot-starter/src/main/java/com/codingapi/springboot/framework/event/Handler.java index d4321a032..6dda24a06 100644 --- a/springboot-starter/src/main/java/com/codingapi/springboot/framework/handler/Handler.java +++ b/springboot-starter/src/main/java/com/codingapi/springboot/framework/event/Handler.java @@ -1,4 +1,4 @@ -package com.codingapi.springboot.framework.handler; +package com.codingapi.springboot.framework.event; import java.lang.annotation.*; diff --git a/springboot-starter/src/main/java/com/codingapi/springboot/framework/handler/HandlerBeanDefinitionRegistrar.java b/springboot-starter/src/main/java/com/codingapi/springboot/framework/event/HandlerBeanDefinitionRegistrar.java similarity index 96% rename from springboot-starter/src/main/java/com/codingapi/springboot/framework/handler/HandlerBeanDefinitionRegistrar.java rename to springboot-starter/src/main/java/com/codingapi/springboot/framework/event/HandlerBeanDefinitionRegistrar.java index 3f1a76b3c..de878c8b3 100644 --- a/springboot-starter/src/main/java/com/codingapi/springboot/framework/handler/HandlerBeanDefinitionRegistrar.java +++ b/springboot-starter/src/main/java/com/codingapi/springboot/framework/event/HandlerBeanDefinitionRegistrar.java @@ -1,4 +1,4 @@ -package com.codingapi.springboot.framework.handler; +package com.codingapi.springboot.framework.event; import com.codingapi.springboot.framework.registrar.RegisterBeanScanner; import lombok.SneakyThrows; diff --git a/springboot-starter/src/main/java/com/codingapi/springboot/framework/event/IEvent.java b/springboot-starter/src/main/java/com/codingapi/springboot/framework/event/IEvent.java index ca03ea126..4cc123884 100644 --- a/springboot-starter/src/main/java/com/codingapi/springboot/framework/event/IEvent.java +++ b/springboot-starter/src/main/java/com/codingapi/springboot/framework/event/IEvent.java @@ -1,6 +1,8 @@ package com.codingapi.springboot.framework.event; +import java.io.Serializable; + /** * 默认同步事件 *

@@ -8,7 +10,6 @@ * 事件本身不应该同步主业务的事务，即事件对于主业务来说，可成功可失败，成功与失败都不应该强关联主体业务。 * 若需要让主体业务与分支做事务同步的时候，那不应该采用事件机制，而应该直接采用调用的方式实现业务绑定。 */ -public interface IEvent { - +public interface IEvent extends Serializable { } diff --git a/springboot-starter/src/main/java/com/codingapi/springboot/framework/handler/IHandler.java b/springboot-starter/src/main/java/com/codingapi/springboot/framework/event/IHandler.java similarity index 51% rename from springboot-starter/src/main/java/com/codingapi/springboot/framework/handler/IHandler.java rename to springboot-starter/src/main/java/com/codingapi/springboot/framework/event/IHandler.java index 45db5dd7d..46248d8cb 100644 --- a/springboot-starter/src/main/java/com/codingapi/springboot/framework/handler/IHandler.java +++ b/springboot-starter/src/main/java/com/codingapi/springboot/framework/event/IHandler.java @@ -1,6 +1,4 @@ -package com.codingapi.springboot.framework.handler; - -import com.codingapi.springboot.framework.event.IEvent; +package com.codingapi.springboot.framework.event; /** * handler 订阅 @@ -9,6 +7,14 @@ */ public interface IHandler { + /** + * 事件订阅排序 + * 在同样的事件中，可以通过order来控制订阅的顺序 + */ + default int order() { + return 0; + } + /** * 订阅触发 * @@ -18,12 +24,15 @@ public interface IHandler { /** * 异常回掉,在多订阅的情况下,为了实现订阅的独立性,将异常的处理放在回掉函数中。 + * 当异常抛出以后，会阻止后续的事件执行 * * @param exception 异常信息 */ - default void error(Exception exception) { + default void error(Exception exception) throws Exception { + throw exception; } - ; + + } diff --git a/springboot-starter/src/main/java/com/codingapi/springboot/framework/event/SpringDefaultEventHandler.java b/springboot-starter/src/main/java/com/codingapi/springboot/framework/event/SpringDefaultEventHandler.java new file mode 100644 index 000000000..6ef79e82c --- /dev/null +++ b/springboot-starter/src/main/java/com/codingapi/springboot/framework/event/SpringDefaultEventHandler.java @@ -0,0 +1,54 @@ +package com.codingapi.springboot.framework.event; + +import com.codingapi.springboot.framework.properties.PropertiesContext; +import lombok.extern.slf4j.Slf4j; +import org.springframework.beans.factory.InitializingBean; +import org.springframework.context.event.EventListener; + +import java.util.List; +import java.util.concurrent.ExecutorService; +import java.util.concurrent.Executors; + +/** + * handler订阅的Spring触发器,在异步的情况下可配置多线程。 + */ +@Slf4j +public class SpringDefaultEventHandler extends SpringEventHandler implements InitializingBean { + + private ExecutorService executorService; + + public SpringDefaultEventHandler(List handlers) { + ApplicationHandlerUtils.getInstance().addHandlers(handlers); + log.info("SpringDefaultEventHandler Success Initial."); + } + + + @Override + public void afterPropertiesSet() throws Exception { + executorService = Executors.newFixedThreadPool(PropertiesContext.getInstance().getHandlerThreadPoolSize()); + } + + @EventListener + public synchronized void dispatch(DomainEvent domainEvent) { + String traceId = domainEvent.getTraceId(); + + if (domainEvent.isSync()) { + try { + EventTraceContext.getInstance().createEventKey(traceId); + ApplicationHandlerUtils.getInstance().handler(domainEvent.getEvent()); + } finally { + EventTraceContext.getInstance().checkEventState(); + } + } else { + executorService.execute(() -> { + try { + EventTraceContext.getInstance().createEventKey(traceId); + ApplicationHandlerUtils.getInstance().handler(domainEvent.getEvent()); + } finally { + EventTraceContext.getInstance().checkEventState(); + } + }); + } + } + +} diff --git a/springboot-starter/src/main/java/com/codingapi/springboot/framework/event/SpringEventHandler.java b/springboot-starter/src/main/java/com/codingapi/springboot/framework/event/SpringEventHandler.java new file mode 100644 index 000000000..a2db53b30 --- /dev/null +++ b/springboot-starter/src/main/java/com/codingapi/springboot/framework/event/SpringEventHandler.java @@ -0,0 +1,4 @@ +package com.codingapi.springboot.framework.event; + +public abstract class SpringEventHandler { +} diff --git a/springboot-starter/src/main/java/com/codingapi/springboot/framework/event/SpringHandlerConfiguration.java b/springboot-starter/src/main/java/com/codingapi/springboot/framework/event/SpringHandlerConfiguration.java new file mode 100644 index 000000000..2900e8955 --- /dev/null +++ b/springboot-starter/src/main/java/com/codingapi/springboot/framework/event/SpringHandlerConfiguration.java @@ -0,0 +1,28 @@ +package com.codingapi.springboot.framework.event; + +import org.springframework.beans.factory.annotation.Autowired; +import org.springframework.boot.autoconfigure.condition.ConditionalOnMissingBean; +import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty; +import org.springframework.context.annotation.Bean; +import org.springframework.context.annotation.Configuration; + +import java.util.List; + +@Configuration +public class SpringHandlerConfiguration { + + @Bean + @ConditionalOnProperty(value = "codingapi.framework.event.transaction.enable",havingValue = "true") + public SpringEventHandler springTransactionEventHandler(@Autowired(required = false) List handlers) { + return new SpringTransactionEventHandler(handlers); + } + + @Bean + @ConditionalOnMissingBean + public SpringEventHandler springDefaultEventHandler(@Autowired(required = false) List handlers) { + return new SpringDefaultEventHandler(handlers); + } + + + +} diff --git a/springboot-starter/src/main/java/com/codingapi/springboot/framework/event/SpringTransactionEventHandler.java b/springboot-starter/src/main/java/com/codingapi/springboot/framework/event/SpringTransactionEventHandler.java new file mode 100644 index 000000000..d92999c99 --- /dev/null +++ b/springboot-starter/src/main/java/com/codingapi/springboot/framework/event/SpringTransactionEventHandler.java @@ -0,0 +1,57 @@ +package com.codingapi.springboot.framework.event; + +import com.codingapi.springboot.framework.properties.PropertiesContext; +import lombok.extern.slf4j.Slf4j; +import org.springframework.beans.factory.InitializingBean; +import org.springframework.transaction.event.TransactionPhase; +import org.springframework.transaction.event.TransactionalEventListener; + +import java.util.List; +import java.util.concurrent.ExecutorService; +import java.util.concurrent.Executors; + +/** + * handler订阅的Spring触发器,在异步的情况下可配置多线程。 + */ +@Slf4j +public class SpringTransactionEventHandler extends SpringEventHandler implements InitializingBean { + + /** + * 异步多线程的KEY + */ + private ExecutorService executorService; + + public SpringTransactionEventHandler(List handlers) { + ApplicationHandlerUtils.getInstance().addHandlers(handlers); + log.info("SpringTransactionEventHandler Success Initial."); + } + + @Override + public void afterPropertiesSet() throws Exception { + executorService = Executors.newFixedThreadPool(PropertiesContext.getInstance().getHandlerThreadPoolSize()); + } + + @TransactionalEventListener(phase = TransactionPhase.AFTER_COMMIT, fallbackExecution = true) + public synchronized void dispatch(DomainEvent domainEvent) { + String traceId = domainEvent.getTraceId(); + + if (domainEvent.isSync()) { + try { + EventTraceContext.getInstance().createEventKey(traceId); + ApplicationHandlerUtils.getInstance().handler(domainEvent.getEvent()); + } finally { + EventTraceContext.getInstance().checkEventState(); + } + } else { + executorService.execute(() -> { + try { + EventTraceContext.getInstance().createEventKey(traceId); + ApplicationHandlerUtils.getInstance().handler(domainEvent.getEvent()); + } finally { + EventTraceContext.getInstance().checkEventState(); + } + }); + } + } + +} diff --git a/springboot-starter/src/main/java/com/codingapi/springboot/framework/exception/EventException.java b/springboot-starter/src/main/java/com/codingapi/springboot/framework/exception/EventException.java new file mode 100644 index 000000000..dec330869 --- /dev/null +++ b/springboot-starter/src/main/java/com/codingapi/springboot/framework/exception/EventException.java @@ -0,0 +1,37 @@ +package com.codingapi.springboot.framework.exception; + +import lombok.Getter; + +import java.util.List; + +@Getter +public class EventException extends RuntimeException { + + private final List error; + + public EventException(List error) { + super(EventException.convert(error)); + this.error = error; + for (Exception e : error) { + this.addSuppressed(e); + } + } + + private static String convert(List errors){ + if (errors == null || errors.isEmpty()) { + return "No errors."; + } + StringBuilder message = new StringBuilder(); + message.append("Has ").append(errors.size()).append(" Errors:\n"); + int index = 1; + for (Exception exception : errors) { + message.append(index++) + .append(". ") + .append(exception.getClass().getSimpleName()) + .append(": ") + .append(exception.getMessage()) + .append("\n"); + } + return message.toString(); + } +} diff --git a/springboot-starter/src/main/java/com/codingapi/springboot/framework/exception/EventLoopException.java b/springboot-starter/src/main/java/com/codingapi/springboot/framework/exception/EventLoopException.java new file mode 100644 index 000000000..cb17f0467 --- /dev/null +++ b/springboot-starter/src/main/java/com/codingapi/springboot/framework/exception/EventLoopException.java @@ -0,0 +1,17 @@ +package com.codingapi.springboot.framework.exception; + +import com.codingapi.springboot.framework.event.IEvent; +import lombok.Getter; + +import java.util.List; + +@Getter +public class EventLoopException extends RuntimeException { + + private final List> stack; + + public EventLoopException(List> stack, IEvent event) { + super("event loop error current event class:" + event.getClass() + ", history event stack:" + stack); + this.stack = stack; + } +} diff --git a/springboot-starter/src/main/java/com/codingapi/springboot/framework/exception/LocaleMessageException.java b/springboot-starter/src/main/java/com/codingapi/springboot/framework/exception/LocaleMessageException.java index 44e2c08ac..18e482ff1 100644 --- a/springboot-starter/src/main/java/com/codingapi/springboot/framework/exception/LocaleMessageException.java +++ b/springboot-starter/src/main/java/com/codingapi/springboot/framework/exception/LocaleMessageException.java @@ -17,22 +17,48 @@ public LocaleMessageException(String errCode, String errMessage, Throwable cause this.errMessage = errMessage; } - public LocaleMessageException(String errCode, Throwable cause) { + public LocaleMessageException(String errCode,Throwable cause) { super(MessageContext.getInstance().getErrorMsg(errCode), cause); this.errCode = errCode; this.errMessage = getMessage(); } + + public LocaleMessageException(String errCode,Object[] args, Throwable cause) { + super(MessageContext.getInstance().getErrorMsg(errCode,args), cause); + this.errCode = errCode; + this.errMessage = getMessage(); + } + public LocaleMessageException(String errCode, String errMessage) { super(errMessage); this.errCode = errCode; this.errMessage = errMessage; } + public LocaleMessageException(String errCode,Object[] args) { + super(MessageContext.getInstance().getErrorMsg(errCode,args)); + this.errCode = errCode; + this.errMessage = getMessage(); + } + public LocaleMessageException(String errCode) { super(MessageContext.getInstance().getErrorMsg(errCode)); this.errCode = errCode; this.errMessage = getMessage(); } + + /** + * 占位符异常，在message.properties中配置错误信息,占位符参数从0开始实例如下 + * error3= 错误 3 {0} {1} + * @param errCode 错误码 + * @param args 占位符参数 + * @return 异常 + */ + public static LocaleMessageException of(String errCode, Object ...args) { + return new LocaleMessageException(errCode, args); + } + + } diff --git a/springboot-starter/src/main/java/com/codingapi/springboot/framework/exception/MessageContext.java b/springboot-starter/src/main/java/com/codingapi/springboot/framework/exception/MessageContext.java index e2c43d4e3..792356b7d 100644 --- a/springboot-starter/src/main/java/com/codingapi/springboot/framework/exception/MessageContext.java +++ b/springboot-starter/src/main/java/com/codingapi/springboot/framework/exception/MessageContext.java @@ -27,4 +27,8 @@ public String getErrorMsg(String errCode) { return localeMessage.getMessage(errCode); } + public String getErrorMsg(String errCode,Object[] args) { + return localeMessage.getMessage(errCode,args); + } + } diff --git a/springboot-starter/src/main/java/com/codingapi/springboot/framework/handler/ApplicationHandlerUtils.java b/springboot-starter/src/main/java/com/codingapi/springboot/framework/handler/ApplicationHandlerUtils.java deleted file mode 100644 index 7817ae560..000000000 --- a/springboot-starter/src/main/java/com/codingapi/springboot/framework/handler/ApplicationHandlerUtils.java +++ /dev/null @@ -1,85 +0,0 @@ -package com.codingapi.springboot.framework.handler; - -import com.codingapi.springboot.framework.event.IEvent; -import lombok.extern.slf4j.Slf4j; - -import java.lang.reflect.ParameterizedType; -import java.lang.reflect.Type; -import java.util.ArrayList; -import java.util.List; - -@Slf4j -class ApplicationHandlerUtils implements IHandler { - - private static ApplicationHandlerUtils instance; - private List> handlers; - - - private ApplicationHandlerUtils() { - this.handlers = new ArrayList<>(); - } - - public static ApplicationHandlerUtils getInstance() { - if (instance == null) { - synchronized (ApplicationHandlerUtils.class) { - if (instance == null) { - instance = new ApplicationHandlerUtils(); - } - } - } - return instance; - } - - public void addHandlers(List handlers) { - if (handlers != null) { - handlers.forEach(this::addHandler); - } - } - - - public void addHandler(IHandler handler) { - if (handler != null) { - handlers.add(handler); - } - } - - - @Override - public void handler(IEvent event) { - for (IHandler handler : handlers) { - String targetClassName = null; - try { - Class eventClass = event.getClass(); - Class targetClass = getHandlerEventClass(handler); - if (eventClass.equals(targetClass)) { - targetClassName = targetClass.getName(); - handler.handler(event); - } - } catch (Exception e) { - //IPersistenceEvent 抛出异常 - if ("com.codingapi.springboot.framework.persistence.PersistenceEvent".equals(targetClassName)) { - throw e; - } - log.warn("handler exception", e); - handler.error(e); - - } - } - } - - private Class getHandlerEventClass(IHandler handler) { - Type[] types = handler.getClass().getGenericInterfaces(); - for (Type type : types) { - if (type instanceof ParameterizedType) { - ParameterizedType parameterizedType = (ParameterizedType) type; - Type[] actualTypeArguments = parameterizedType.getActualTypeArguments(); - if (actualTypeArguments != null) { - return (Class) actualTypeArguments[0]; - } - } - } - return null; - } - - -} diff --git a/springboot-starter/src/main/java/com/codingapi/springboot/framework/handler/SpringEventHandler.java b/springboot-starter/src/main/java/com/codingapi/springboot/framework/handler/SpringEventHandler.java deleted file mode 100644 index 9796511b7..000000000 --- a/springboot-starter/src/main/java/com/codingapi/springboot/framework/handler/SpringEventHandler.java +++ /dev/null @@ -1,40 +0,0 @@ -package com.codingapi.springboot.framework.handler; - -import com.codingapi.springboot.framework.event.DomainEvent; -import lombok.extern.slf4j.Slf4j; -import org.springframework.context.ApplicationListener; - -import java.util.List; -import java.util.concurrent.ExecutorService; -import java.util.concurrent.Executors; - -/** - * handler订阅的Spring触发器,在异步的情况下可配置多线程。 - */ -@Slf4j -public class SpringEventHandler implements ApplicationListener { - - /** - * 异步多线程的KEY - * 可通过 System.setProperty(THREAD_KEY,"20") 调整线程数 - */ - public final static String THREAD_KEY = "Handler.ThreadPools"; - - private final ExecutorService executorService = Executors.newFixedThreadPool(Integer.parseInt(System.getProperty(THREAD_KEY, "10"))); - - public SpringEventHandler(List handlers) { - ApplicationHandlerUtils.getInstance().addHandlers(handlers); - } - - @Override - public void onApplicationEvent(DomainEvent domainEvent) { - if (domainEvent.isSync()) { - ApplicationHandlerUtils.getInstance().handler(domainEvent.getEvent()); - } else { - executorService.execute(() -> { - ApplicationHandlerUtils.getInstance().handler(domainEvent.getEvent()); - }); - } - } - -} diff --git a/springboot-starter/src/main/java/com/codingapi/springboot/framework/handler/SpringHandlerConfiguration.java b/springboot-starter/src/main/java/com/codingapi/springboot/framework/handler/SpringHandlerConfiguration.java deleted file mode 100644 index 0f5c989c1..000000000 --- a/springboot-starter/src/main/java/com/codingapi/springboot/framework/handler/SpringHandlerConfiguration.java +++ /dev/null @@ -1,17 +0,0 @@ -package com.codingapi.springboot.framework.handler; - -import org.springframework.beans.factory.annotation.Autowired; -import org.springframework.context.annotation.Bean; -import org.springframework.context.annotation.Configuration; - -import java.util.List; - -@Configuration -public class SpringHandlerConfiguration { - - @Bean - public SpringEventHandler springEventHandler(@Autowired(required = false) List handlers) { - return new SpringEventHandler(handlers); - } - -} diff --git a/springboot-starter/src/main/java/com/codingapi/springboot/framework/properties/FrameworkProperties.java b/springboot-starter/src/main/java/com/codingapi/springboot/framework/properties/FrameworkProperties.java new file mode 100644 index 000000000..6bd1f036e --- /dev/null +++ b/springboot-starter/src/main/java/com/codingapi/springboot/framework/properties/FrameworkProperties.java @@ -0,0 +1,16 @@ +package com.codingapi.springboot.framework.properties; + +import lombok.Getter; +import lombok.Setter; + +@Setter +@Getter +public class FrameworkProperties { + + /** + * 事件异步线程数量，默认20 + */ + private int handlerThreadPoolSize = 20; + + +} diff --git a/springboot-starter/src/main/java/com/codingapi/springboot/framework/properties/PropertiesContext.java b/springboot-starter/src/main/java/com/codingapi/springboot/framework/properties/PropertiesContext.java new file mode 100644 index 000000000..efb6bd43a --- /dev/null +++ b/springboot-starter/src/main/java/com/codingapi/springboot/framework/properties/PropertiesContext.java @@ -0,0 +1,22 @@ +package com.codingapi.springboot.framework.properties; + +import lombok.Getter; +import lombok.Setter; + +public class PropertiesContext { + + @Getter + private final static PropertiesContext instance = new PropertiesContext(); + + private PropertiesContext(){ + + } + + @Setter + private FrameworkProperties properties; + + public int getHandlerThreadPoolSize() { + return properties.getHandlerThreadPoolSize(); + } + +} diff --git a/springboot-starter/src/main/java/com/codingapi/springboot/framework/reflect/ObjectAnnotationFieldUtils.java b/springboot-starter/src/main/java/com/codingapi/springboot/framework/reflect/ObjectAnnotationFieldUtils.java new file mode 100644 index 000000000..dae3dbcf4 --- /dev/null +++ b/springboot-starter/src/main/java/com/codingapi/springboot/framework/reflect/ObjectAnnotationFieldUtils.java @@ -0,0 +1,196 @@ +package com.codingapi.springboot.framework.reflect; + +import com.codingapi.springboot.framework.reflect.pojo.AnnotationTargetField; +import com.codingapi.springboot.framework.reflect.pojo.AnnotationTargetFieldResult; +import lombok.Getter; +import org.springframework.util.ClassUtils; +import org.springframework.util.ReflectionUtils; + +import java.lang.annotation.Annotation; +import java.lang.reflect.Field; +import java.util.*; + +/** + * 对象注解字段反射工具类 + */ +public class ObjectAnnotationFieldUtils { + + /** + * 查找对象的注解的字段 (仅支持简单数据类型的扫描) + * + * @param target 目标对象 + * @param annotationClass 注解类型 + * @param fieldType 字段类型 + * @param 字段类型 + * @return 注解目标字段对象集合 + */ + public static AnnotationTargetFieldResult findFieldAnnotationValue(Object target, Class annotationClass, Class fieldType) { + AnnotationTargetFieldHolder annotationTargetFieldHolder = new AnnotationTargetFieldHolder<>(target, annotationClass); + annotationTargetFieldHolder.scanner(); + return new AnnotationTargetFieldResult<>(annotationTargetFieldHolder.getResult()); + } + + + /** + * 是否简单数据结构 + * @param fieldType 字段类型 + */ + public static boolean isSimpleType(Class fieldType) { + return fieldType.isPrimitive() + || ClassUtils.isPrimitiveOrWrapper(fieldType) + || fieldType == String.class + || fieldType.isEnum() + || Number.class.isAssignableFrom(fieldType) + || CharSequence.class.isAssignableFrom(fieldType); + } + + /** + * 注解目标字段持有对象 + * @param 字段类型 + */ + private static class AnnotationTargetFieldHolder { + /** + * 扫描对象 + */ + private final Object source; + + /** + * 注解类型 + */ + @Getter + private final Class annotationClass; + + /** + * 已扫描的对象记录 + */ + private final List scannerHistoryList; + + /** + * 扫描结果数据 + */ + @Getter + private final List> result; + + public AnnotationTargetFieldHolder(Object source, Class annotationClass) { + this.source = source; + this.scannerHistoryList = new ArrayList<>(); + this.result = new ArrayList<>(); + this.annotationClass = annotationClass; + } + + /** + * 添加匹配字段 + * @param field 字段 + * @param target 字段绑定对象 + * @param value 字段值 + */ + public void addFiled(Field field, Object target, T value) { + this.result.add(new AnnotationTargetField<>(field, target, value)); + } + + /** + * 扫描对象 + */ + public void scanner() { + ObjectAnnotationScanner scanner = new ObjectAnnotationScanner<>(source, this); + scanner.scanner(); + } + + /** + * 是否已经扫描 + * @param target 对象 + */ + public boolean hasHistory(Object target) { + return this.scannerHistoryList.contains(target); + } + + /** + * 添加到扫描记录 + * @param target 对象 + */ + public void addHistory(Object target) { + this.scannerHistoryList.add(target); + } + } + + /** + * 对象注解扫描器 + * @param 字段类型 + */ + private static class ObjectAnnotationScanner { + /** + * 扫描对象 + */ + private final Object target; + + /** + * 扫描对象类型 + */ + private final Class targetClass; + + /** + * 注解目标字段持有对象 + */ + private final AnnotationTargetFieldHolder valueHolder; + + + public ObjectAnnotationScanner(Object target, AnnotationTargetFieldHolder valueHolder) { + this.target = target; + this.valueHolder = valueHolder; + this.targetClass = target.getClass(); + } + + /** + * 扫描对象 + */ + public void scanner() { + if(ObjectAnnotationFieldUtils.isSimpleType(this.targetClass)) { + return; + } + if (this.target instanceof Collection) { + for (Object item : (Collection) this.target) { + ObjectAnnotationScanner scanner = new ObjectAnnotationScanner<>(item, this.valueHolder); + scanner.scanner(); + } + } else if (this.target instanceof Map) { + for (Object item : ((Map) this.target).values()) { + ObjectAnnotationScanner groovyScriptParser = new ObjectAnnotationScanner<>(item, this.valueHolder); + groovyScriptParser.scanner(); + } + } else if (this.target instanceof Set) { + for (Object item : ((Set) this.target)) { + ObjectAnnotationScanner groovyScriptParser = new ObjectAnnotationScanner<>(item, this.valueHolder); + groovyScriptParser.scanner(); + } + } else { + this.scannerFields(); + } + } + + /** + * 扫描字段 + */ + private void scannerFields() { + if (this.valueHolder.hasHistory(this.target)) { + return; + } + this.valueHolder.addHistory(this.target); + ReflectionUtils.doWithFields(targetClass, field -> { + field.setAccessible(true); + Object value = ReflectionUtils.getField(field, target); + Class fieldTypeClass = field.getType(); + if (value != null) { + if (ObjectAnnotationFieldUtils.isSimpleType(fieldTypeClass)) { + Annotation annotation = field.getAnnotation(this.valueHolder.getAnnotationClass()); + if (annotation != null) { + this.valueHolder.addFiled(field, target, (T) value); + } + } else { + ObjectAnnotationScanner scanner = new ObjectAnnotationScanner<>(value, this.valueHolder); + scanner.scanner(); + } + } + }); + } + } +} diff --git a/springboot-starter/src/main/java/com/codingapi/springboot/framework/reflect/pojo/AnnotationTargetField.java b/springboot-starter/src/main/java/com/codingapi/springboot/framework/reflect/pojo/AnnotationTargetField.java new file mode 100644 index 000000000..f5d0c7e4f --- /dev/null +++ b/springboot-starter/src/main/java/com/codingapi/springboot/framework/reflect/pojo/AnnotationTargetField.java @@ -0,0 +1,41 @@ +package com.codingapi.springboot.framework.reflect.pojo; + +import lombok.AllArgsConstructor; +import lombok.Getter; +import org.springframework.util.ReflectionUtils; + +import java.lang.reflect.Field; + +/** + * 字段目标注解 + * + * @param 目标字段值类型 + */ +@Getter +@AllArgsConstructor +public class AnnotationTargetField { + + /** + * 字段对象 + */ + private final Field field; + /** + * 绑定对象 + */ + private final Object target; + /** + * 字段值对象 + */ + private final T value; + + + /** + * 更新字段值 + * @param value 新值 + */ + public void update(T value) { + this.field.setAccessible(true); + ReflectionUtils.setField(this.field, target, value); + } + +} diff --git a/springboot-starter/src/main/java/com/codingapi/springboot/framework/reflect/pojo/AnnotationTargetFieldResult.java b/springboot-starter/src/main/java/com/codingapi/springboot/framework/reflect/pojo/AnnotationTargetFieldResult.java new file mode 100644 index 000000000..69360c027 --- /dev/null +++ b/springboot-starter/src/main/java/com/codingapi/springboot/framework/reflect/pojo/AnnotationTargetFieldResult.java @@ -0,0 +1,40 @@ +package com.codingapi.springboot.framework.reflect.pojo; + +import lombok.AllArgsConstructor; + +import java.util.List; +import java.util.function.Consumer; +import java.util.stream.Collectors; + +/** + * 注解目标字段对象集合 + * + * @param 注解字段类型 + */ +@AllArgsConstructor +public class AnnotationTargetFieldResult { + + private final List> fields; + + public List getValues() { + return fields.stream().map(AnnotationTargetField::getValue).distinct().collect(Collectors.toList()); + } + + public void fetch(Consumer> consumer) { + this.fields.forEach(consumer); + } + + public void update(Generate generateValue) { + this.fields.forEach(tAnnotationTargetField -> { + tAnnotationTargetField.update(generateValue.generate(tAnnotationTargetField.getValue())); + }); + } + + + public interface Generate{ + + T generate(T value); + + } + +} diff --git a/springboot-starter/src/main/java/com/codingapi/springboot/framework/rest/HttpClient.java b/springboot-starter/src/main/java/com/codingapi/springboot/framework/rest/HttpClient.java index 4484b0321..b91377b2b 100644 --- a/springboot-starter/src/main/java/com/codingapi/springboot/framework/rest/HttpClient.java +++ b/springboot-starter/src/main/java/com/codingapi/springboot/framework/rest/HttpClient.java @@ -31,7 +31,7 @@ public String post(String url, HttpHeaders headers, JSON jsonObject) { return httpRequest.getPostRequest(url, headers, jsonObject).execute(); } - public String post(String url, HttpHeaders headers, MultiValueMap formData) { + public String post(String url, HttpHeaders headers, MultiValueMap formData) { return httpRequest.getPostRequest(url, headers, formData).execute(); } diff --git a/springboot-starter/src/main/java/com/codingapi/springboot/framework/rest/HttpRequest.java b/springboot-starter/src/main/java/com/codingapi/springboot/framework/rest/HttpRequest.java index f9ea8a71c..025571dce 100644 --- a/springboot-starter/src/main/java/com/codingapi/springboot/framework/rest/HttpRequest.java +++ b/springboot-starter/src/main/java/com/codingapi/springboot/framework/rest/HttpRequest.java @@ -129,8 +129,8 @@ public Request getPostRequest(String url, HttpHeaders headers, JSON jsonObject) }; } - public Request getPostRequest(String url, HttpHeaders headers, MultiValueMap formData) { - HttpEntity> httpEntity = new HttpEntity<>(formData, headers); + public Request getPostRequest(String url, HttpHeaders headers, MultiValueMap formData) { + HttpEntity> httpEntity = new HttpEntity<>(formData, headers); String requestUrl = requestHandler.handler(this,url ,HttpMethod.POST,headers,httpEntity); return () -> { ResponseEntity httpResponse = restTemplate.exchange(requestUrl, HttpMethod.POST, httpEntity, String.class); diff --git a/springboot-starter/src/main/java/com/codingapi/springboot/framework/rest/RestClient.java b/springboot-starter/src/main/java/com/codingapi/springboot/framework/rest/RestClient.java index 7aa14d62c..61621744c 100644 --- a/springboot-starter/src/main/java/com/codingapi/springboot/framework/rest/RestClient.java +++ b/springboot-starter/src/main/java/com/codingapi/springboot/framework/rest/RestClient.java @@ -62,7 +62,7 @@ public String get(String api, HttpHeaders headers, MultiValueMap } public String get(String api, HttpHeaders headers, RestParam paramBuilder) { - return get(api, headers,paramBuilder!=null?paramBuilder.toFormRequest():null); + return get(api, headers,paramBuilder!=null?paramBuilder.toGetRequest():null); } public String get(String api, RestParam paramBuilder) { diff --git a/springboot-starter/src/main/java/com/codingapi/springboot/framework/rest/SessionClient.java b/springboot-starter/src/main/java/com/codingapi/springboot/framework/rest/SessionClient.java index ac4dc72a0..24eab5f7c 100644 --- a/springboot-starter/src/main/java/com/codingapi/springboot/framework/rest/SessionClient.java +++ b/springboot-starter/src/main/java/com/codingapi/springboot/framework/rest/SessionClient.java @@ -92,11 +92,11 @@ public String getHtml(String url){ public String getHtml(String url, RestParam restParam){ httpHeaders.setContentType(MediaType.APPLICATION_FORM_URLENCODED); - return httpClient.get(url,httpHeaders,restParam!=null?restParam.toFormRequest():null); + return httpClient.get(url,httpHeaders,restParam!=null?restParam.toGetRequest():null); } public String getJson(String url, RestParam restParam){ httpHeaders.setContentType(MediaType.APPLICATION_JSON); - return httpClient.get(url,httpHeaders,restParam!=null?restParam.toFormRequest():null); + return httpClient.get(url,httpHeaders,restParam!=null?restParam.toGetRequest():null); } } diff --git a/springboot-starter/src/main/java/com/codingapi/springboot/framework/rest/param/RestParam.java b/springboot-starter/src/main/java/com/codingapi/springboot/framework/rest/param/RestParam.java index 51c08a8b1..5cd08ce95 100644 --- a/springboot-starter/src/main/java/com/codingapi/springboot/framework/rest/param/RestParam.java +++ b/springboot-starter/src/main/java/com/codingapi/springboot/framework/rest/param/RestParam.java @@ -1,17 +1,18 @@ package com.codingapi.springboot.framework.rest.param; -import com.alibaba.fastjson.JSONArray; import com.alibaba.fastjson.JSONObject; +import lombok.SneakyThrows; import org.springframework.util.LinkedMultiValueMap; import org.springframework.util.MultiValueMap; import java.net.URLEncoder; -import java.nio.charset.StandardCharsets; +import java.util.ArrayList; +import java.util.List; public class RestParam { private final JSONObject jsonBody; - private final MultiValueMap mapBody; + private final MultiValueMap mapBody; private RestParam() { this.jsonBody = new JSONObject(); @@ -35,19 +36,6 @@ private static void fetch(JSONObject object, RestParam builder) { Object value = object.getObject(key, Object.class); if (value != null) { builder.add(key, value); - - if (value instanceof JSONObject) { - JSONObject jsonObject = (JSONObject) value; - fetch(jsonObject, builder); - } - - if (value instanceof JSONArray jsonArray) { - for (Object o : jsonArray) { - if (o instanceof JSONObject jsonObject) { - fetch(jsonObject, builder); - } - } - } } } } @@ -56,17 +44,31 @@ public JSONObject toJsonRequest() { return jsonBody; } - public MultiValueMap toFormRequest() { + public MultiValueMap toFormRequest() { return mapBody; } + public MultiValueMap toGetRequest(){ + MultiValueMap request = new LinkedMultiValueMap<>(); + for(String key: mapBody.keySet()){ + List objectList = mapBody.get(key); + List stringList = new ArrayList<>(); + for (Object object:objectList){ + stringList.add(object.toString()); + } + request.put(key,stringList); + } + return request; + } + public RestParam add(String key, Object value) { return add(key, value, true); } + @SneakyThrows public RestParam add(String key, Object value, boolean encode) { String stringValue = value.toString(); - String encodeValue = encode ? URLEncoder.encode(stringValue, StandardCharsets.UTF_8) : value.toString(); + String encodeValue = encode ? URLEncoder.encode(stringValue, "UTF-8") : value.toString(); jsonBody.put(key, value); mapBody.add(key, encodeValue); return this; diff --git a/springboot-starter/src/main/java/com/codingapi/springboot/framework/serializable/EnumSerializer.java b/springboot-starter/src/main/java/com/codingapi/springboot/framework/serializable/EnumSerializer.java new file mode 100644 index 000000000..338dcf20a --- /dev/null +++ b/springboot-starter/src/main/java/com/codingapi/springboot/framework/serializable/EnumSerializer.java @@ -0,0 +1,16 @@ +package com.codingapi.springboot.framework.serializable; + +import com.codingapi.springboot.framework.em.IEnum; +import com.fasterxml.jackson.core.JsonGenerator; +import com.fasterxml.jackson.databind.JsonSerializer; +import com.fasterxml.jackson.databind.SerializerProvider; + +import java.io.IOException; + +public class EnumSerializer extends JsonSerializer { + + @Override + public void serialize(IEnum iEnum, JsonGenerator jsonGenerator, SerializerProvider serializerProvider) throws IOException { + jsonGenerator.writeNumber(iEnum.getCode()); + } +} diff --git a/springboot-starter/src/main/java/com/codingapi/springboot/framework/serializable/MapSerializable.java b/springboot-starter/src/main/java/com/codingapi/springboot/framework/serializable/MapSerializable.java index e7f967430..2b40aae73 100644 --- a/springboot-starter/src/main/java/com/codingapi/springboot/framework/serializable/MapSerializable.java +++ b/springboot-starter/src/main/java/com/codingapi/springboot/framework/serializable/MapSerializable.java @@ -1,6 +1,7 @@ package com.codingapi.springboot.framework.serializable; import com.alibaba.fastjson.JSONObject; +import com.alibaba.fastjson2.JSON; import java.util.Map; @@ -11,6 +12,6 @@ public interface MapSerializable { default Map toMap() { - return (Map) JSONObject.toJSON(this); + return JSON.parseObject(JSONObject.toJSONString(this)); } } diff --git a/springboot-starter/src/main/java/com/codingapi/springboot/framework/servlet/BasicHandlerExceptionResolverConfiguration.java b/springboot-starter/src/main/java/com/codingapi/springboot/framework/servlet/BasicHandlerExceptionResolverConfiguration.java index 573de914f..8cf34dc32 100644 --- a/springboot-starter/src/main/java/com/codingapi/springboot/framework/servlet/BasicHandlerExceptionResolverConfiguration.java +++ b/springboot-starter/src/main/java/com/codingapi/springboot/framework/servlet/BasicHandlerExceptionResolverConfiguration.java @@ -2,8 +2,6 @@ import com.codingapi.springboot.framework.exception.LocaleMessageException; -import jakarta.servlet.http.HttpServletRequest; -import jakarta.servlet.http.HttpServletResponse; import lombok.extern.slf4j.Slf4j; import org.springframework.boot.autoconfigure.condition.ConditionalOnClass; import org.springframework.context.annotation.Bean; @@ -12,6 +10,9 @@ import org.springframework.web.servlet.ModelAndView; import org.springframework.web.servlet.view.json.MappingJackson2JsonView; +import javax.servlet.http.HttpServletRequest; +import javax.servlet.http.HttpServletResponse; + @Configuration @ConditionalOnClass(name = "org.springframework.web.servlet.HandlerExceptionResolver") public class BasicHandlerExceptionResolverConfiguration { diff --git a/springboot-starter/src/main/java/com/codingapi/springboot/framework/transaction/TransactionManagerContext.java b/springboot-starter/src/main/java/com/codingapi/springboot/framework/transaction/TransactionManagerContext.java new file mode 100644 index 000000000..7cdd18268 --- /dev/null +++ b/springboot-starter/src/main/java/com/codingapi/springboot/framework/transaction/TransactionManagerContext.java @@ -0,0 +1,66 @@ +package com.codingapi.springboot.framework.transaction; + +import lombok.Getter; +import lombok.extern.slf4j.Slf4j; +import org.springframework.transaction.PlatformTransactionManager; +import org.springframework.transaction.TransactionDefinition; +import org.springframework.transaction.TransactionStatus; +import org.springframework.transaction.support.DefaultTransactionDefinition; + +import java.util.function.Supplier; + +@Slf4j +public class TransactionManagerContext { + + @Getter + private PlatformTransactionManager platformTransactionManager; + + @Getter + private final static TransactionManagerContext instance = new TransactionManagerContext(); + + private TransactionManagerContext() { + } + + public void setPlatformTransactionManager(PlatformTransactionManager platformTransactionManager) { + this.platformTransactionManager = platformTransactionManager; + if (platformTransactionManager != null) { + log.info("platformTransactionManager:{} load success", platformTransactionManager); + } + } + + + public T commit(Supplier supplier) { + if (platformTransactionManager != null) { + DefaultTransactionDefinition def = new DefaultTransactionDefinition(); + def.setPropagationBehavior(TransactionDefinition.PROPAGATION_REQUIRES_NEW); + TransactionStatus transactionStatus = platformTransactionManager.getTransaction(def); + try { + T result = supplier.get(); + platformTransactionManager.commit(transactionStatus); + return result; + } catch (Exception e) { + platformTransactionManager.rollback(transactionStatus); + throw e; + } + } + return supplier.get(); + } + + public T readOnly(Supplier supplier) { + if (platformTransactionManager != null) { + DefaultTransactionDefinition def = new DefaultTransactionDefinition(); + def.setPropagationBehavior(TransactionDefinition.PROPAGATION_REQUIRES_NEW); + def.setReadOnly(true); + TransactionStatus transactionStatus = platformTransactionManager.getTransaction(def); + try { + T result = supplier.get(); + platformTransactionManager.rollback(transactionStatus); + return result; + } catch (Exception e) { + platformTransactionManager.rollback(transactionStatus); + throw e; + } + } + return supplier.get(); + } +} diff --git a/springboot-starter/src/main/java/com/codingapi/springboot/framework/transaction/TransactionManagerContextConfiguration.java b/springboot-starter/src/main/java/com/codingapi/springboot/framework/transaction/TransactionManagerContextConfiguration.java new file mode 100644 index 000000000..4e0199449 --- /dev/null +++ b/springboot-starter/src/main/java/com/codingapi/springboot/framework/transaction/TransactionManagerContextConfiguration.java @@ -0,0 +1,16 @@ +package com.codingapi.springboot.framework.transaction; + +import org.springframework.beans.factory.annotation.Autowired; +import org.springframework.context.annotation.Bean; +import org.springframework.context.annotation.Configuration; +import org.springframework.transaction.PlatformTransactionManager; + +@Configuration +public class TransactionManagerContextConfiguration { + + @Bean + public TransactionManagerContextRegister transactionManagerContextRegister(@Autowired(required = false) PlatformTransactionManager platformTransactionManager){ + return new TransactionManagerContextRegister(platformTransactionManager); + } + +} diff --git a/springboot-starter/src/main/java/com/codingapi/springboot/framework/transaction/TransactionManagerContextRegister.java b/springboot-starter/src/main/java/com/codingapi/springboot/framework/transaction/TransactionManagerContextRegister.java new file mode 100644 index 000000000..5c53e9ebc --- /dev/null +++ b/springboot-starter/src/main/java/com/codingapi/springboot/framework/transaction/TransactionManagerContextRegister.java @@ -0,0 +1,20 @@ +package com.codingapi.springboot.framework.transaction; + +import org.springframework.beans.factory.InitializingBean; +import org.springframework.transaction.PlatformTransactionManager; + +public class TransactionManagerContextRegister implements InitializingBean { + + private final PlatformTransactionManager transactionManager; + + public TransactionManagerContextRegister(PlatformTransactionManager transactionManager) { + this.transactionManager = transactionManager; + } + + @Override + public void afterPropertiesSet() throws Exception { + TransactionManagerContext.getInstance().setPlatformTransactionManager(transactionManager); + } + + +} diff --git a/springboot-starter/src/main/java/com/codingapi/springboot/framework/user/IUser.java b/springboot-starter/src/main/java/com/codingapi/springboot/framework/user/IUser.java new file mode 100644 index 000000000..ad3a4e7a3 --- /dev/null +++ b/springboot-starter/src/main/java/com/codingapi/springboot/framework/user/IUser.java @@ -0,0 +1,4 @@ +package com.codingapi.springboot.framework.user; + +public interface IUser { +} diff --git a/springboot-starter/src/main/java/com/codingapi/springboot/framework/user/UserContext.java b/springboot-starter/src/main/java/com/codingapi/springboot/framework/user/UserContext.java new file mode 100644 index 000000000..6c65d3522 --- /dev/null +++ b/springboot-starter/src/main/java/com/codingapi/springboot/framework/user/UserContext.java @@ -0,0 +1,22 @@ +package com.codingapi.springboot.framework.user; + +import lombok.Getter; + +public class UserContext { + + private final ThreadLocal threadLocal = new ThreadLocal<>(); + + @Getter + private final static UserContext instance = new UserContext(); + + private UserContext() { + } + + public void setCurrent(IUser user) { + threadLocal.set(user); + } + + public IUser current() { + return threadLocal.get(); + } +} \ No newline at end of file diff --git a/springboot-starter/src/main/java/com/codingapi/springboot/framework/utils/ClassLoaderUtils.java b/springboot-starter/src/main/java/com/codingapi/springboot/framework/utils/ClassLoaderUtils.java new file mode 100644 index 000000000..df9cd18bb --- /dev/null +++ b/springboot-starter/src/main/java/com/codingapi/springboot/framework/utils/ClassLoaderUtils.java @@ -0,0 +1,99 @@ +package com.codingapi.springboot.framework.utils; + +import java.io.File; +import java.io.IOException; +import java.net.MalformedURLException; +import java.net.URISyntaxException; +import java.net.URL; +import java.net.URLClassLoader; +import java.util.ArrayList; +import java.util.Enumeration; +import java.util.List; +import java.util.jar.JarEntry; +import java.util.jar.JarFile; + +public class ClassLoaderUtils { + + public static URLClassLoader createClassLoader(String jarPath) throws MalformedURLException { + File file = new File(jarPath); + if(!file.exists()){ + throw new RuntimeException("jar file not found:"+jarPath); + } + URL[] urls = new URL[]{file.toURI().toURL()}; + return new URLClassLoader(urls, ClassLoader.getSystemClassLoader()); + } + + public static List findAllClasses(URLClassLoader classLoader) throws URISyntaxException, IOException { + List classNames = new ArrayList<>(); + URL[] urls = classLoader.getURLs(); + for (URL url : urls) { + if (url.getProtocol().equals("file")) { + File file = new File(url.toURI()); + if (file.isDirectory()) { + classNames.addAll(findClassesInDirectory(file, "")); + } else if (file.getName().endsWith(".jar")) { + classNames.addAll(findClassesInJar(new JarFile(file))); + } + } + } + return classNames; + } + + public static List> findJarClasses(String jarPath) throws IOException, URISyntaxException { + URLClassLoader classLoader = createClassLoader(jarPath); + List classList = ClassLoaderUtils.findAllClasses(classLoader); + List> classes = new ArrayList<>(); + for(String className:classList){ + try { + Class driverClass = classLoader.loadClass(className); + classes.add(driverClass); + }catch (NoClassDefFoundError | ClassNotFoundException ignored){} + } + return classes; + } + + public static List> findJarClass(String jarPath,Class clazz) throws IOException, URISyntaxException { + URLClassLoader classLoader = createClassLoader(jarPath); + List classList = ClassLoaderUtils.findAllClasses(classLoader); + List> classes = new ArrayList<>(); + for(String className:classList){ + try { + Class driverClass = classLoader.loadClass(className); + if(clazz.isAssignableFrom(driverClass)){ + classes.add(driverClass); + } + }catch (NoClassDefFoundError | ClassNotFoundException ignored){} + } + return classes; + } + + private static List findClassesInDirectory(File directory, String packageName) { + List classNames = new ArrayList<>(); + File[] files = directory.listFiles(); + if (files != null) { + for (File file : files) { + if (file.isDirectory()) { + classNames.addAll(findClassesInDirectory(file, packageName + file.getName() + ".")); + } else if (file.getName().endsWith(".class")) { + String className = packageName + file.getName().replace(".class", ""); + classNames.add(className); + } + } + } + return classNames; + } + + private static List findClassesInJar(JarFile jarFile) { + List classNames = new ArrayList<>(); + Enumeration entries = jarFile.entries(); + while (entries.hasMoreElements()) { + JarEntry entry = entries.nextElement(); + String name = entry.getName(); + if (name.endsWith(".class")) { + String className = name.replace('/', '.').replace(".class", ""); + classNames.add(className); + } + } + return classNames; + } +} diff --git a/springboot-starter/src/main/java/com/codingapi/springboot/framework/utils/RandomGenerator.java b/springboot-starter/src/main/java/com/codingapi/springboot/framework/utils/RandomGenerator.java new file mode 100644 index 000000000..d81723c6a --- /dev/null +++ b/springboot-starter/src/main/java/com/codingapi/springboot/framework/utils/RandomGenerator.java @@ -0,0 +1,22 @@ +package com.codingapi.springboot.framework.utils; + +import java.util.UUID; + +public class RandomGenerator { + + public static String generateUUID() { + return UUID.randomUUID().toString(); + } + + + public static String randomString(int length) { + String str = "abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789"; + StringBuilder sb = new StringBuilder(); + for (int i = 0; i < length; i++) { + int number = (int) (Math.random() * str.length()); + sb.append(str.charAt(number)); + } + return sb.toString(); + } + +} diff --git a/springboot-starter/src/main/java/com/codingapi/springboot/framework/utils/TrustAnyHttpClientFactory.java b/springboot-starter/src/main/java/com/codingapi/springboot/framework/utils/TrustAnyHttpClientFactory.java index 258108851..2bc34c3df 100644 --- a/springboot-starter/src/main/java/com/codingapi/springboot/framework/utils/TrustAnyHttpClientFactory.java +++ b/springboot-starter/src/main/java/com/codingapi/springboot/framework/utils/TrustAnyHttpClientFactory.java @@ -2,16 +2,17 @@ import lombok.SneakyThrows; -import org.apache.hc.client5.http.classic.HttpClient; -import org.apache.hc.client5.http.config.RequestConfig; -import org.apache.hc.client5.http.impl.classic.HttpClients; -import org.apache.hc.client5.http.impl.io.BasicHttpClientConnectionManager; -import org.apache.hc.client5.http.socket.ConnectionSocketFactory; -import org.apache.hc.client5.http.socket.PlainConnectionSocketFactory; -import org.apache.hc.client5.http.ssl.NoopHostnameVerifier; -import org.apache.hc.client5.http.ssl.SSLConnectionSocketFactory; -import org.apache.hc.core5.http.config.Registry; -import org.apache.hc.core5.http.config.RegistryBuilder; +import org.apache.http.client.HttpClient; +import org.apache.http.client.config.RequestConfig; +import org.apache.http.config.Registry; +import org.apache.http.config.RegistryBuilder; +import org.apache.http.conn.socket.ConnectionSocketFactory; +import org.apache.http.conn.socket.PlainConnectionSocketFactory; +import org.apache.http.conn.ssl.NoopHostnameVerifier; +import org.apache.http.conn.ssl.SSLConnectionSocketFactory; +import org.apache.http.impl.client.HttpClients; +import org.apache.http.impl.conn.BasicHttpClientConnectionManager; + import javax.net.ssl.SSLContext; import javax.net.ssl.TrustManager; diff --git a/springboot-starter/src/main/java/com/codingapi/springboot/framework/utils/VersionUtils.java b/springboot-starter/src/main/java/com/codingapi/springboot/framework/utils/VersionUtils.java new file mode 100644 index 000000000..4c1cedb71 --- /dev/null +++ b/springboot-starter/src/main/java/com/codingapi/springboot/framework/utils/VersionUtils.java @@ -0,0 +1,34 @@ +package com.codingapi.springboot.framework.utils; + +import java.io.InputStream; +import java.util.jar.Attributes; +import java.util.jar.Manifest; + +public class VersionUtils { + + public static String getJarVersion(Class clazz) { + try { + String classPath = clazz.getResource(clazz.getSimpleName() + ".class").toString(); + if (!classPath.startsWith("jar")) { + // 不是从 jar 启动的 + return "DEV"; + } + + String manifestPath = classPath.substring(0, classPath.lastIndexOf("!") + 1) + "/META-INF/MANIFEST.MF"; + try (InputStream inputStream = new java.net.URL(manifestPath).openStream()) { + Manifest manifest = new Manifest(inputStream); + Attributes attributes = manifest.getMainAttributes(); + return attributes.getValue("Implementation-Version"); + } + } catch (Exception e) { + return "UNKNOWN"; + } + } + + + public static String getDriverVersion(){ + return VersionUtils.getJarVersion(VersionUtils.class); + } + + +} diff --git a/springboot-starter/src/main/resources/META-INF/spring.factories b/springboot-starter/src/main/resources/META-INF/spring.factories index 5765e1026..046b912ba 100644 --- a/springboot-starter/src/main/resources/META-INF/spring.factories +++ b/springboot-starter/src/main/resources/META-INF/spring.factories @@ -2,6 +2,7 @@ org.springframework.boot.autoconfigure.EnableAutoConfiguration=\ com.codingapi.springboot.framework.AutoConfiguration,\ com.codingapi.springboot.framework.event.SpringEventConfiguration,\ com.codingapi.springboot.framework.exception.ExceptionConfiguration,\ -com.codingapi.springboot.framework.handler.HandlerBeanDefinitionRegistrar,\ -com.codingapi.springboot.framework.handler.SpringHandlerConfiguration,\ -com.codingapi.springboot.framework.servlet.BasicHandlerExceptionResolverConfiguration \ No newline at end of file +com.codingapi.springboot.framework.transaction.TransactionManagerContextConfiguration,\ +com.codingapi.springboot.framework.event.HandlerBeanDefinitionRegistrar,\ +com.codingapi.springboot.framework.event.SpringHandlerConfiguration,\ +com.codingapi.springboot.framework.servlet.BasicHandlerExceptionResolverConfiguration diff --git a/springboot-starter/src/main/resources/META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports b/springboot-starter/src/main/resources/META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports index 39319e717..0d489bbc3 100644 --- a/springboot-starter/src/main/resources/META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports +++ b/springboot-starter/src/main/resources/META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports @@ -1,6 +1,7 @@ com.codingapi.springboot.framework.AutoConfiguration com.codingapi.springboot.framework.event.SpringEventConfiguration com.codingapi.springboot.framework.exception.ExceptionConfiguration -com.codingapi.springboot.framework.handler.HandlerBeanDefinitionRegistrar -com.codingapi.springboot.framework.handler.SpringHandlerConfiguration -com.codingapi.springboot.framework.servlet.BasicHandlerExceptionResolverConfiguration \ No newline at end of file +com.codingapi.springboot.framework.transaction.TransactionManagerContextConfiguration +com.codingapi.springboot.framework.event.HandlerBeanDefinitionRegistrar +com.codingapi.springboot.framework.event.SpringHandlerConfiguration +com.codingapi.springboot.framework.servlet.BasicHandlerExceptionResolverConfiguration diff --git a/springboot-starter/src/test/java/com/codingapi/springboot/framework/FrameworkApplicationEventTests.java b/springboot-starter/src/test/java/com/codingapi/springboot/framework/FrameworkApplicationEventTests.java new file mode 100644 index 000000000..25c976af5 --- /dev/null +++ b/springboot-starter/src/test/java/com/codingapi/springboot/framework/FrameworkApplicationEventTests.java @@ -0,0 +1,34 @@ +package com.codingapi.springboot.framework; + +import com.codingapi.springboot.framework.repository.MyTestRepository; +import com.codingapi.springboot.framework.service.MyTestService; +import org.junit.jupiter.api.Test; +import org.springframework.beans.factory.annotation.Autowired; +import org.springframework.boot.test.context.SpringBootTest; +import static org.junit.jupiter.api.Assertions.*; + +@SpringBootTest +class FrameworkApplicationEventTests { + + @Autowired + private MyTestService myTestService; + @Autowired + private MyTestRepository repository; + + @Test + void transactionTest1() { + repository.deleteAll(); + assertThrows(ArithmeticException.class,()->{ + myTestService.save1(); + }); + assertEquals(0, repository.findAll().size()); + } + + @Test + void transactionTest2() { + repository.deleteAll(); + myTestService.save2(); + assertEquals(1, repository.findAll().size()); + } + +} diff --git a/springboot-starter/src/test/java/com/codingapi/springboot/framework/dto/request/FilterTest.java b/springboot-starter/src/test/java/com/codingapi/springboot/framework/dto/request/FilterTest.java new file mode 100644 index 000000000..2aaabce58 --- /dev/null +++ b/springboot-starter/src/test/java/com/codingapi/springboot/framework/dto/request/FilterTest.java @@ -0,0 +1,110 @@ +package com.codingapi.springboot.framework.dto.request; + +import org.junit.jupiter.api.Test; + +import static org.junit.jupiter.api.Assertions.*; + +/** + * Filter 单元测试 + */ +class FilterTest { + + @Test + void constructors() { + Filter equalFilter = new Filter("name", "zhang"); + assertEquals("name", equalFilter.getKey()); + assertEquals(Relation.EQUAL, equalFilter.getRelation()); + assertEquals(1, equalFilter.getValue().length); + assertEquals("zhang", equalFilter.getValue()[0]); + + Filter relationFilter = new Filter("age", Relation.GREATER_THAN, 18); + assertEquals(Relation.GREATER_THAN, relationFilter.getRelation()); + + Filter groupFilter = new Filter(Filter.FILTER_AND_KEY, + new Filter("a", "1"), new Filter("b", "2")); + assertNull(groupFilter.getRelation()); + assertEquals(2, groupFilter.getValue().length); + assertTrue(groupFilter.isAndFilters()); + assertFalse(groupFilter.isOrFilters()); + } + + @Test + void staticFactories() { + Filter as1 = Filter.as("name", "zhang"); + assertTrue(as1.isEqual()); + + Filter as2 = Filter.as("age", Relation.LESS_THAN, 30); + assertTrue(as2.isLessThan()); + + Filter and = Filter.and(Filter.as("a", "1"), Filter.as("b", "2")); + assertEquals(Filter.FILTER_AND_KEY, and.getKey()); + assertTrue(and.isAndFilters()); + + Filter or = Filter.or(Filter.as("c", "3"), Filter.as("d", "4")); + assertEquals(Filter.FILTER_OR_KEY, or.getKey()); + assertTrue(or.isOrFilters()); + assertFalse(or.isAndFilters()); + } + + @Test + void settersAndGetters() { + Filter filter = new Filter("name", "zhang"); + filter.setKey("newName"); + filter.setRelation(Relation.NOT_EQUAL); + filter.setValue(new Object[]{"li"}); + assertEquals("newName", filter.getKey()); + assertEquals(Relation.NOT_EQUAL, filter.getRelation()); + assertEquals("li", filter.getValue()[0]); + } + + @Test + void relationChecks() { + assertTrue(new Filter("k", Relation.EQUAL, "v").isEqual()); + assertTrue(new Filter("k", Relation.NOT_EQUAL, "v").isNotEqual()); + assertTrue(new Filter("k", Relation.LIKE, "v").isLike()); + assertTrue(new Filter("k", Relation.LEFT_LIKE, "v").isLeftLike()); + assertTrue(new Filter("k", Relation.RIGHT_LIKE, "v").isRightLike()); + assertTrue(new Filter("k", Relation.BETWEEN, 1, 2).isBetween()); + assertTrue(new Filter("k", Relation.IN, 1, 2).isIn()); + assertTrue(new Filter("k", Relation.NOT_IN, 1, 2).isNotIn()); + assertTrue(new Filter("k", Relation.IS_NULL).isNull()); + assertTrue(new Filter("k", Relation.IS_NOT_NULL).isNotNull()); + assertTrue(new Filter("k", Relation.GREATER_THAN, 1).isGreaterThan()); + assertTrue(new Filter("k", Relation.LESS_THAN, 1).isLessThan()); + assertTrue(new Filter("k", Relation.GREATER_THAN_EQUAL, 1).isGreaterThanEqual()); + assertTrue(new Filter("k", Relation.LESS_THAN_EQUAL, 1).isLessThanEqual()); + + Filter filter = new Filter("k", Relation.EQUAL, "v"); + assertFalse(filter.isNull()); + assertFalse(filter.isNotNull()); + assertFalse(filter.isIn()); + assertFalse(filter.isNotIn()); + assertFalse(filter.isLike()); + assertFalse(filter.isLeftLike()); + assertFalse(filter.isRightLike()); + assertFalse(filter.isBetween()); + assertFalse(filter.isGreaterThan()); + assertFalse(filter.isLessThan()); + assertFalse(filter.isGreaterThanEqual()); + assertFalse(filter.isLessThanEqual()); + assertFalse(filter.isNotEqual()); + } + + @Test + void getFilterValueWithStringConversion() { + assertEquals(1, new Filter("k", "1").getFilterValue(Integer.class)); + assertEquals(2L, new Filter("k", "2").getFilterValue(Long.class)); + assertEquals(3.5d, new Filter("k", "3.5").getFilterValue(Double.class)); + assertEquals(4.5f, new Filter("k", "4.5").getFilterValue(Float.class)); + assertEquals("text", new Filter("k", "text").getFilterValue(String.class)); + // 非字符串值原样返回 + assertEquals(9, new Filter("k", 9).getFilterValue(Integer.class)); + } + + @Test + void relationEnum() { + assertEquals(14, Relation.values().length); + assertEquals(Relation.EQUAL, Relation.valueOf("EQUAL")); + assertEquals(Relation.LESS_THAN_EQUAL, Relation.valueOf("LESS_THAN_EQUAL")); + } +} diff --git a/springboot-starter/src/test/java/com/codingapi/springboot/framework/dto/request/PageRequestFullTest.java b/springboot-starter/src/test/java/com/codingapi/springboot/framework/dto/request/PageRequestFullTest.java new file mode 100644 index 000000000..0bbba267f --- /dev/null +++ b/springboot-starter/src/test/java/com/codingapi/springboot/framework/dto/request/PageRequestFullTest.java @@ -0,0 +1,94 @@ +package com.codingapi.springboot.framework.dto.request; + +import org.junit.jupiter.api.Test; +import org.springframework.data.domain.Sort; + +import static org.junit.jupiter.api.Assertions.*; + +/** + * PageRequest 单元测试(补充现有 PageRequestTest) + */ +class PageRequestFullTest { + + @Test + void staticFactories() { + PageRequest pageRequest = PageRequest.of(2, 10); + assertEquals(2, pageRequest.getCurrent()); + assertEquals(2, pageRequest.getPageNumber()); + assertEquals(10, pageRequest.getPageSize()); + assertEquals(20L, pageRequest.getOffset()); + assertTrue(pageRequest.hasPrevious()); + assertEquals(Sort.unsorted(), pageRequest.getSort()); + + PageRequest firstPage = PageRequest.of(0, 10); + assertFalse(firstPage.hasPrevious()); + assertEquals(0L, firstPage.getOffset()); + + Sort sort = Sort.by("id").descending(); + PageRequest sorted = PageRequest.of(1, 10, sort); + assertNotNull(sorted.getSort().getOrderFor("id")); + } + + @Test + void addSort() { + PageRequest pageRequest = new PageRequest(); + assertEquals(Sort.unsorted(), pageRequest.getSort()); + + pageRequest.addSort(Sort.by("name").ascending()); + assertNotNull(pageRequest.getSort().getOrderFor("name")); + + // 已有排序时再次添加 + pageRequest.addSort(Sort.by("id").descending()); + assertNotNull(pageRequest.getSort()); + } + + @Test + void filterDelegation() { + PageRequest pageRequest = PageRequest.of(0, 20); + assertFalse(pageRequest.hasFilter()); + + pageRequest.addFilter("name", "zhang"); + pageRequest.addFilter("age", Relation.GREATER_THAN, 18); + pageRequest.andFilter(Filter.as("a", "1")); + pageRequest.orFilters(Filter.as("b", "2")); + + assertTrue(pageRequest.hasFilter()); + assertEquals("zhang", pageRequest.getStringFilter("name")); + assertEquals("default", pageRequest.getStringFilter("missing", "default")); + assertEquals(0, pageRequest.getIntFilter("missing")); + assertEquals(3, pageRequest.getIntFilter("missing", 3)); + assertNotNull(pageRequest.getRequestFilter().getFilter(Filter.FILTER_AND_KEY)); + assertNotNull(pageRequest.getRequestFilter().getFilter(Filter.FILTER_OR_KEY)); + + pageRequest.removeFilter("name"); + assertNull(pageRequest.getStringFilter("name")); + } + + @Test + void setPageSizeAndCurrent() { + PageRequest pageRequest = new PageRequest(); + pageRequest.setPageSize(50); + pageRequest.setCurrent(3); + assertEquals(50, pageRequest.getPageSize()); + assertEquals(3, pageRequest.getCurrent()); + assertEquals(150L, pageRequest.getOffset()); + } + + @Test + void idRequest() { + IdRequest idRequest = new IdRequest(); + idRequest.setId("12"); + assertEquals("12", idRequest.getStringId()); + assertEquals(12, idRequest.getIntId()); + assertEquals(Long.valueOf(12L), idRequest.getLongId()); + assertEquals(12f, idRequest.getFloatId()); + assertEquals(12d, idRequest.getDoubleId()); + } + + @Test + void sortRequest() { + SortRequest sortRequest = new SortRequest(); + sortRequest.setIds(java.util.Arrays.asList("1", "2")); + assertEquals(2, sortRequest.getIds().size()); + } +} diff --git a/springboot-starter/src/test/java/com/codingapi/springboot/framework/dto/request/PageRequestTest.java b/springboot-starter/src/test/java/com/codingapi/springboot/framework/dto/request/PageRequestTest.java index e3584bfa5..93028dd81 100644 --- a/springboot-starter/src/test/java/com/codingapi/springboot/framework/dto/request/PageRequestTest.java +++ b/springboot-starter/src/test/java/com/codingapi/springboot/framework/dto/request/PageRequestTest.java @@ -9,7 +9,7 @@ class PageRequestTest { @Test void test(){ PageRequest pageRequest = new PageRequest(); - pageRequest.setCurrent(2); + pageRequest.setCurrent(1); pageRequest.setPageSize(10); assertEquals(pageRequest.getCurrent(),1); diff --git a/springboot-starter/src/test/java/com/codingapi/springboot/framework/dto/request/RequestFilterTest.java b/springboot-starter/src/test/java/com/codingapi/springboot/framework/dto/request/RequestFilterTest.java new file mode 100644 index 000000000..124264413 --- /dev/null +++ b/springboot-starter/src/test/java/com/codingapi/springboot/framework/dto/request/RequestFilterTest.java @@ -0,0 +1,125 @@ +package com.codingapi.springboot.framework.dto.request; + +import org.junit.jupiter.api.Test; + +import static org.junit.jupiter.api.Assertions.*; + +/** + * RequestFilter 单元测试 + */ +class RequestFilterTest { + + @Test + void addFilters() { + RequestFilter requestFilter = new RequestFilter(); + assertFalse(requestFilter.hasFilter()); + + requestFilter.addFilter("name", "zhang"); + requestFilter.addFilter("age", Relation.GREATER_THAN, "18"); + + assertTrue(requestFilter.hasFilter()); + assertEquals(2, requestFilter.getFilters().size()); + assertEquals("zhang", requestFilter.getStringFilter("name")); + assertTrue(requestFilter.getFilter("age").isGreaterThan()); + } + + @Test + void groupFilters() { + RequestFilter requestFilter = new RequestFilter(); + requestFilter.andFilters(Filter.as("a", "1"), Filter.as("b", "2")); + requestFilter.orFilters(Filter.as("c", "3")); + + Filter andFilter = requestFilter.getFilter(Filter.FILTER_AND_KEY); + assertNotNull(andFilter); + assertTrue(andFilter.isAndFilters()); + assertEquals(2, andFilter.getValue().length); + + Filter orFilter = requestFilter.getFilter(Filter.FILTER_OR_KEY); + assertNotNull(orFilter); + assertTrue(orFilter.isOrFilters()); + } + + @Test + void pushFilterReplacesSameKey() { + RequestFilter requestFilter = new RequestFilter(); + requestFilter.addFilter("name", "zhang"); + requestFilter.addFilter("name", Relation.LIKE, "li"); + + assertEquals(1, requestFilter.getFilters().size()); + assertTrue(requestFilter.getFilter("name").isLike()); + assertEquals("li", requestFilter.getFilter("name").getValue()[0]); + } + + @Test + void removeFilter() { + RequestFilter requestFilter = new RequestFilter(); + requestFilter.addFilter("name", "zhang"); + requestFilter.removeFilter("name"); + + assertFalse(requestFilter.hasFilter()); + assertNull(requestFilter.getFilter("name")); + assertTrue(requestFilter.getFilters().isEmpty()); + } + + @Test + void stringFilterWithDefault() { + RequestFilter requestFilter = new RequestFilter(); + assertNull(requestFilter.getStringFilter("missing")); + assertEquals("default", requestFilter.getStringFilter("missing", "default")); + + requestFilter.addFilter("blank", ""); + assertEquals("default", requestFilter.getStringFilter("blank", "default")); + + requestFilter.addFilter("name", "zhang"); + assertEquals("zhang", requestFilter.getStringFilter("name", "default")); + } + + @Test + void intFilter() { + RequestFilter requestFilter = new RequestFilter(); + assertEquals(0, requestFilter.getIntFilter("missing")); + assertEquals(5, requestFilter.getIntFilter("missing", 5)); + + requestFilter.addFilter("age", "18"); + assertEquals(18, requestFilter.getIntFilter("age")); + assertEquals(18, requestFilter.getIntFilter("age", 5)); + + requestFilter.addFilter("zero", ""); + assertEquals(0, requestFilter.getIntFilter("zero")); + assertEquals(5, requestFilter.getIntFilter("zero", 5)); + } + + @Test + void isAllEqualFilter() { + RequestFilter requestFilter = new RequestFilter(); + // 无条件时返回 false + assertFalse(requestFilter.isAllEqualFilter()); + + // 全部为等值条件 + requestFilter.addFilter("name", "zhang"); + requestFilter.addFilter("age", Relation.EQUAL, 18); + assertTrue(requestFilter.isAllEqualFilter()); + + // 包含 LIKE 条件 + requestFilter.addFilter("title", Relation.LIKE, "%a%"); + assertFalse(requestFilter.isAllEqualFilter()); + requestFilter.removeFilter("title"); + assertTrue(requestFilter.isAllEqualFilter()); + + // 包含范围条件 + requestFilter.addFilter("age", Relation.GREATER_THAN, 20); + assertFalse(requestFilter.isAllEqualFilter()); + requestFilter.removeFilter("age"); + assertTrue(requestFilter.isAllEqualFilter()); + + // 包含 OR 组合条件 + requestFilter.orFilters(Filter.as("name", "a"), Filter.as("name", "b")); + assertFalse(requestFilter.isAllEqualFilter()); + requestFilter.removeFilter(Filter.FILTER_OR_KEY); + assertTrue(requestFilter.isAllEqualFilter()); + + // 包含 AND 组合条件 + requestFilter.andFilters(Filter.as("name", "a"), Filter.as("age", 1)); + assertFalse(requestFilter.isAllEqualFilter()); + } +} diff --git a/springboot-starter/src/test/java/com/codingapi/springboot/framework/dto/request/SearchRequestParseTest.java b/springboot-starter/src/test/java/com/codingapi/springboot/framework/dto/request/SearchRequestParseTest.java new file mode 100644 index 000000000..f6cd1a9bc --- /dev/null +++ b/springboot-starter/src/test/java/com/codingapi/springboot/framework/dto/request/SearchRequestParseTest.java @@ -0,0 +1,297 @@ +package com.codingapi.springboot.framework.dto.request; + +import lombok.Getter; +import lombok.Setter; +import org.junit.jupiter.api.AfterEach; +import org.junit.jupiter.api.BeforeEach; +import org.junit.jupiter.api.Test; +import org.springframework.data.domain.Sort; +import org.springframework.mock.web.MockHttpServletRequest; +import org.springframework.web.context.request.RequestContextHolder; +import org.springframework.web.context.request.ServletRequestAttributes; + +import java.nio.charset.StandardCharsets; +import java.util.Arrays; +import java.util.Base64; +import java.util.List; + +import static org.junit.jupiter.api.Assertions.*; + +/** + * SearchRequest 及其内部类 ClassContent、ParamOperation 的单元测试 + */ +class SearchRequestParseTest { + + private MockHttpServletRequest httpRequest; + + @BeforeEach + void setUp() { + httpRequest = new MockHttpServletRequest(); + RequestContextHolder.setRequestAttributes(new ServletRequestAttributes(httpRequest)); + } + + @AfterEach + void tearDown() { + RequestContextHolder.resetRequestAttributes(); + } + + private static String encode(String json) { + return Base64.getEncoder().encodeToString(json.getBytes(StandardCharsets.UTF_8)); + } + + @Setter + @Getter + static class Address { + private String city; + } + + @Setter + @Getter + static class BaseQuery { + private int state; + } + + @Setter + @Getter + static class UserQuery extends BaseQuery { + private long id; + private String name; + private int age; + private boolean deleted; + private Address address; + } + + @Setter + @Getter + static class RawQuery { + private String params; + private String sort; + private String filter; + } + + @Test + void toPageRequestWithSortFilterAndParams() { + httpRequest.setParameter("current", "2"); + httpRequest.setParameter("pageSize", "15"); + httpRequest.setParameter("name", "zhang"); + httpRequest.setParameter("age", "18"); + httpRequest.setParameter("empty", ""); + httpRequest.setParameter("sort", encode("{\"name\":\"ascend\"}")); + httpRequest.setParameter("filter", encode("{\"id\":[\"1\",\"2\"]}")); + httpRequest.setParameter("params", encode("[{\"key\":\"age\",\"type\":\"GREATER_THAN\"}]")); + + SearchRequest searchRequest = new SearchRequest(); + searchRequest.setCurrent(2); + searchRequest.setPageSize(15); + + assertEquals("zhang", searchRequest.getParameter("name")); + assertArrayEquals(new String[]{"zhang"}, searchRequest.getParameterValues("name")); + List parameterNames = searchRequest.getParameterNames(); + assertTrue(parameterNames.contains("name")); + assertTrue(parameterNames.contains("age")); + + PageRequest pageRequest = searchRequest.toPageRequest(UserQuery.class); + + // SearchRequest 不是 PageRequest, 默认分页偏移规则会减一 + assertEquals(1, searchRequest.getCurrent()); + assertEquals(1, pageRequest.getCurrent()); + assertEquals(15, pageRequest.getPageSize()); + + Filter nameFilter = pageRequest.getRequestFilter().getFilter("name"); + assertNotNull(nameFilter); + assertTrue(nameFilter.isEqual()); + assertEquals("zhang", nameFilter.getValue()[0]); + + Filter ageFilter = pageRequest.getRequestFilter().getFilter("age"); + assertNotNull(ageFilter); + assertTrue(ageFilter.isGreaterThan()); + assertEquals(18, ageFilter.getValue()[0]); + + Filter idFilter = pageRequest.getRequestFilter().getFilter("id"); + assertNotNull(idFilter); + assertTrue(idFilter.isIn()); + assertEquals(2, idFilter.getValue().length); + assertEquals(1L, idFilter.getValue()[0]); + assertEquals(2L, idFilter.getValue()[1]); + + Sort sort = pageRequest.getSort(); + assertNotNull(sort.getOrderFor("name")); + assertTrue(sort.getOrderFor("name").isAscending()); + + // filter/sort/params 已从查询参数中移除, 不会再作为过滤条件 + assertNull(pageRequest.getRequestFilter().getFilter("sort")); + assertNull(pageRequest.getRequestFilter().getFilter("filter")); + assertNull(pageRequest.getRequestFilter().getFilter("params")); + } + + @Test + void toPageRequestWithDescendSort() { + httpRequest.setParameter("sort", encode("{\"id\":\"descend\"}")); + + SearchRequest searchRequest = new SearchRequest(); + searchRequest.setCurrent(1); + searchRequest.setPageSize(10); + + PageRequest pageRequest = searchRequest.toPageRequest(UserQuery.class); + assertNotNull(pageRequest.getSort().getOrderFor("id")); + assertTrue(pageRequest.getSort().getOrderFor("id").isDescending()); + } + + @Test + void toPageRequestWithEmptyFilterArrayAndBooleanField() { + httpRequest.setParameter("filter", encode("{\"name\":[],\"deleted\":[\"true\"]}")); + + SearchRequest searchRequest = new SearchRequest(); + searchRequest.setCurrent(1); + searchRequest.setPageSize(10); + + PageRequest pageRequest = searchRequest.toPageRequest(UserQuery.class); + // 空数组的 filter 被忽略 + assertNull(pageRequest.getRequestFilter().getFilter("name")); + Filter deletedFilter = pageRequest.getRequestFilter().getFilter("deleted"); + assertNotNull(deletedFilter); + assertTrue(deletedFilter.isIn()); + assertEquals(true, deletedFilter.getValue()[0]); + } + + @Test + void toPageRequestWithoutOperations() { + httpRequest.setParameter("name", "li"); + httpRequest.setParameter("state", "1"); + httpRequest.setParameter("address.city", "hangzhou"); + + SearchRequest searchRequest = new SearchRequest(); + searchRequest.setCurrent(1); + searchRequest.setPageSize(10); + + PageRequest pageRequest = searchRequest.toPageRequest(UserQuery.class); + + assertTrue(pageRequest.getRequestFilter().getFilter("name").isEqual()); + assertEquals("li", pageRequest.getRequestFilter().getFilter("name").getValue()[0]); + // state 字段定义在父类 BaseQuery 中 + assertEquals(1, pageRequest.getRequestFilter().getFilter("state").getValue()[0]); + // 嵌套对象字段 + assertEquals("hangzhou", pageRequest.getRequestFilter().getFilter("address.city").getValue()[0]); + } + + @Test + void toPageRequestWithInvalidJsonParams() { + // 合法 Base64 但非法 JSON 时不会加入 removeKeys, 原始(未解码)值将作为普通过滤条件处理 + String raw = encode("not-a-json"); + httpRequest.setParameter("params", raw); + httpRequest.setParameter("sort", raw); + httpRequest.setParameter("filter", raw); + + SearchRequest searchRequest = new SearchRequest(); + searchRequest.setCurrent(1); + searchRequest.setPageSize(10); + + PageRequest pageRequest = searchRequest.toPageRequest(RawQuery.class); + assertEquals(raw, pageRequest.getRequestFilter().getFilter("params").getValue()[0]); + assertEquals(raw, pageRequest.getRequestFilter().getFilter("sort").getValue()[0]); + assertEquals(raw, pageRequest.getRequestFilter().getFilter("filter").getValue()[0]); + } + + @Test + void toPageRequestWithInvalidBase64Params() { + // 非法 Base64 不应抛出 IllegalArgumentException, 参数按原始值作为普通过滤条件处理 + httpRequest.setParameter("params", "%%%not-base64%%%"); + httpRequest.setParameter("sort", "%%%not-base64%%%"); + httpRequest.setParameter("filter", "%%%not-base64%%%"); + + SearchRequest searchRequest = new SearchRequest(); + searchRequest.setCurrent(1); + searchRequest.setPageSize(10); + + PageRequest pageRequest = assertDoesNotThrow(() -> searchRequest.toPageRequest(RawQuery.class)); + assertEquals("%%%not-base64%%%", pageRequest.getRequestFilter().getFilter("params").getValue()[0]); + assertEquals("%%%not-base64%%%", pageRequest.getRequestFilter().getFilter("sort").getValue()[0]); + assertEquals("%%%not-base64%%%", pageRequest.getRequestFilter().getFilter("filter").getValue()[0]); + } + + @Test + void toPageRequestWithUnknownFieldThrowsException() { + httpRequest.setParameter("unknownField", "value"); + + SearchRequest searchRequest = new SearchRequest(); + searchRequest.setCurrent(1); + searchRequest.setPageSize(10); + + assertThrows(IllegalArgumentException.class, () -> searchRequest.toPageRequest(UserQuery.class)); + } + + @Test + void removeFilterAddsRemoveKey() { + httpRequest.setParameter("name", "wang"); + + SearchRequest searchRequest = new SearchRequest(); + searchRequest.setCurrent(1); + searchRequest.setPageSize(10); + searchRequest.removeFilter("name"); + + PageRequest pageRequest = searchRequest.toPageRequest(UserQuery.class); + assertNull(pageRequest.getRequestFilter().getFilter("name")); + } + + @Test + void delegateMethods() { + SearchRequest searchRequest = new SearchRequest(); + searchRequest.addSort(Sort.by("id").descending()); + searchRequest.addFilter("name", "zhang"); + searchRequest.addFilter("age", Relation.GREATER_THAN, 18); + searchRequest.andFilter(Filter.as("a", "1"), Filter.as("b", "2")); + searchRequest.orFilters(Filter.as("c", "3"), Filter.as("d", "4")); + + PageRequest pageRequest = searchRequest.toPageRequest(UserQuery.class); + assertNotNull(pageRequest.getSort().getOrderFor("id")); + assertEquals("zhang", pageRequest.getStringFilter("name")); + assertTrue(pageRequest.getRequestFilter().getFilter("age").isGreaterThan()); + assertNotNull(pageRequest.getRequestFilter().getFilter(Filter.FILTER_AND_KEY)); + assertNotNull(pageRequest.getRequestFilter().getFilter(Filter.FILTER_OR_KEY)); + } + + @Test + void classContentDirectly() { + PageRequest pageRequest = new PageRequest(); + SearchRequest.ClassContent content = new SearchRequest.ClassContent(UserQuery.class, pageRequest); + + content.addFilter("name", "zhang"); + content.addFilter("age", Relation.LESS_THAN, "30"); + content.addFilter("id", Arrays.asList("1", "2")); + content.addFilter("address.city", Relation.LIKE, "hz"); + + RequestFilter requestFilter = pageRequest.getRequestFilter(); + assertTrue(requestFilter.getFilter("name").isEqual()); + assertTrue(requestFilter.getFilter("age").isLessThan()); + assertEquals(30, requestFilter.getFilter("age").getValue()[0]); + assertTrue(requestFilter.getFilter("id").isIn()); + assertTrue(requestFilter.getFilter("address.city").isLike()); + } + + @Test + void classContentWithSameTypeValue() { + PageRequest pageRequest = new PageRequest(); + SearchRequest.ClassContent content = new SearchRequest.ClassContent(UserQuery.class, pageRequest); + // String 类型字段直接返回原始值, 不需要 JSON 转换 + content.addFilter("name", Relation.EQUAL, "direct"); + assertEquals("direct", pageRequest.getRequestFilter().getFilter("name").getValue()[0]); + } + + @Test + void classContentUnknownField() { + PageRequest pageRequest = new PageRequest(); + SearchRequest.ClassContent content = new SearchRequest.ClassContent(UserQuery.class, pageRequest); + assertThrows(IllegalArgumentException.class, () -> content.addFilter("notExist", "value")); + assertThrows(IllegalArgumentException.class, () -> content.addFilter("address.notExist", "value")); + } + + @Test + void paramOperation() { + SearchRequest.ParamOperation operation = new SearchRequest.ParamOperation(); + operation.setKey("age"); + operation.setType("GREATER_THAN"); + assertEquals("age", operation.getKey()); + assertEquals("GREATER_THAN", operation.getType()); + assertEquals(Relation.GREATER_THAN, operation.getOperation()); + } +} diff --git a/springboot-starter/src/test/java/com/codingapi/springboot/framework/entity/MyTest.java b/springboot-starter/src/test/java/com/codingapi/springboot/framework/entity/MyTest.java new file mode 100644 index 000000000..a337cebbe --- /dev/null +++ b/springboot-starter/src/test/java/com/codingapi/springboot/framework/entity/MyTest.java @@ -0,0 +1,19 @@ +package com.codingapi.springboot.framework.entity; + +import javax.persistence.Entity; +import javax.persistence.GeneratedValue; +import javax.persistence.GenerationType; +import javax.persistence.Id; + +import lombok.Data; + +@Data +@Entity +public class MyTest { + + @Id + @GeneratedValue(strategy = GenerationType.IDENTITY) + private Long id; + + private String name; +} diff --git a/springboot-starter/src/test/java/com/codingapi/springboot/framework/event/EventPusherTest.java b/springboot-starter/src/test/java/com/codingapi/springboot/framework/event/EventPusherTest.java new file mode 100644 index 000000000..b77a0d36d --- /dev/null +++ b/springboot-starter/src/test/java/com/codingapi/springboot/framework/event/EventPusherTest.java @@ -0,0 +1,32 @@ +package com.codingapi.springboot.framework.event; + +import org.junit.jupiter.api.Test; +import org.springframework.boot.test.context.SpringBootTest; + +import java.util.concurrent.ExecutorService; +import java.util.concurrent.Executors; + +@SpringBootTest +public class EventPusherTest { + + private final ExecutorService executorService = Executors.newFixedThreadPool(100); + + @Test + void test() { + for (int i = 0; i < 100_0000; i++) { + executorService.execute(() -> { + try { + EventPusher.push(new DemoChangeEvent("before", "current"), true); + } catch (Exception e) { + e.printStackTrace(); + } + }); + } + + try { + Thread.sleep(10000); // 等待所有任务完成 + } catch (InterruptedException e) { + Thread.currentThread().interrupt(); + } + } +} diff --git a/springboot-starter/src/test/java/com/codingapi/springboot/framework/event/MyTestAsyncEvent.java b/springboot-starter/src/test/java/com/codingapi/springboot/framework/event/MyTestAsyncEvent.java new file mode 100644 index 000000000..1d2fe477f --- /dev/null +++ b/springboot-starter/src/test/java/com/codingapi/springboot/framework/event/MyTestAsyncEvent.java @@ -0,0 +1,12 @@ +package com.codingapi.springboot.framework.event; + +import com.codingapi.springboot.framework.entity.MyTest; +import lombok.AllArgsConstructor; +import lombok.Getter; + +@Getter +@AllArgsConstructor +public class MyTestAsyncEvent implements IAsyncEvent{ + + private final MyTest myTest; +} diff --git a/springboot-starter/src/test/java/com/codingapi/springboot/framework/event/MyTestSyncEvent.java b/springboot-starter/src/test/java/com/codingapi/springboot/framework/event/MyTestSyncEvent.java new file mode 100644 index 000000000..869b75852 --- /dev/null +++ b/springboot-starter/src/test/java/com/codingapi/springboot/framework/event/MyTestSyncEvent.java @@ -0,0 +1,12 @@ +package com.codingapi.springboot.framework.event; + +import com.codingapi.springboot.framework.entity.MyTest; +import lombok.AllArgsConstructor; +import lombok.Getter; + +@Getter +@AllArgsConstructor +public class MyTestSyncEvent implements ISyncEvent{ + + private final MyTest myTest; +} diff --git a/springboot-starter/src/test/java/com/codingapi/springboot/framework/handler/DemoChangeLogHandler.java b/springboot-starter/src/test/java/com/codingapi/springboot/framework/handler/DemoChangeLogHandler.java index 0f2d3bb1e..f1efb83b2 100644 --- a/springboot-starter/src/test/java/com/codingapi/springboot/framework/handler/DemoChangeLogHandler.java +++ b/springboot-starter/src/test/java/com/codingapi/springboot/framework/handler/DemoChangeLogHandler.java @@ -1,6 +1,8 @@ package com.codingapi.springboot.framework.handler; import com.codingapi.springboot.framework.event.DemoChangeEvent; +import com.codingapi.springboot.framework.event.Handler; +import com.codingapi.springboot.framework.event.IHandler; import lombok.extern.slf4j.Slf4j; @Slf4j diff --git a/springboot-starter/src/test/java/com/codingapi/springboot/framework/handler/DemoCreateHandler.java b/springboot-starter/src/test/java/com/codingapi/springboot/framework/handler/DemoCreateHandler.java index f48c9fcca..01ab9aa59 100644 --- a/springboot-starter/src/test/java/com/codingapi/springboot/framework/handler/DemoCreateHandler.java +++ b/springboot-starter/src/test/java/com/codingapi/springboot/framework/handler/DemoCreateHandler.java @@ -1,6 +1,8 @@ package com.codingapi.springboot.framework.handler; import com.codingapi.springboot.framework.domain.event.DomainCreateEvent; +import com.codingapi.springboot.framework.event.Handler; +import com.codingapi.springboot.framework.event.IHandler; import lombok.extern.slf4j.Slf4j; @Slf4j diff --git a/springboot-starter/src/test/java/com/codingapi/springboot/framework/handler/DemoDeleteHandler.java b/springboot-starter/src/test/java/com/codingapi/springboot/framework/handler/DemoDeleteHandler.java index 89885b160..6f02be803 100644 --- a/springboot-starter/src/test/java/com/codingapi/springboot/framework/handler/DemoDeleteHandler.java +++ b/springboot-starter/src/test/java/com/codingapi/springboot/framework/handler/DemoDeleteHandler.java @@ -1,6 +1,8 @@ package com.codingapi.springboot.framework.handler; import com.codingapi.springboot.framework.domain.event.DomainDeleteEvent; +import com.codingapi.springboot.framework.event.Handler; +import com.codingapi.springboot.framework.event.IHandler; import lombok.extern.slf4j.Slf4j; @Slf4j diff --git a/springboot-starter/src/test/java/com/codingapi/springboot/framework/handler/DemoPersistEventHandler.java b/springboot-starter/src/test/java/com/codingapi/springboot/framework/handler/DemoPersistEventHandler.java index cb3dae62b..2d18934f5 100644 --- a/springboot-starter/src/test/java/com/codingapi/springboot/framework/handler/DemoPersistEventHandler.java +++ b/springboot-starter/src/test/java/com/codingapi/springboot/framework/handler/DemoPersistEventHandler.java @@ -1,11 +1,13 @@ package com.codingapi.springboot.framework.handler; import com.codingapi.springboot.framework.domain.event.DomainPersistEvent; +import com.codingapi.springboot.framework.event.Handler; +import com.codingapi.springboot.framework.event.IHandler; import lombok.extern.slf4j.Slf4j; @Slf4j @Handler -public class DemoPersistEventHandler implements IHandler{ +public class DemoPersistEventHandler implements IHandler { @Override public void handler(DomainPersistEvent event) { diff --git a/springboot-starter/src/test/java/com/codingapi/springboot/framework/handler/EntityFiledChangeHandler.java b/springboot-starter/src/test/java/com/codingapi/springboot/framework/handler/EntityFiledChangeHandler.java index b6bf661f9..d4fb12b04 100644 --- a/springboot-starter/src/test/java/com/codingapi/springboot/framework/handler/EntityFiledChangeHandler.java +++ b/springboot-starter/src/test/java/com/codingapi/springboot/framework/handler/EntityFiledChangeHandler.java @@ -1,11 +1,13 @@ package com.codingapi.springboot.framework.handler; import com.codingapi.springboot.framework.domain.event.DomainChangeEvent; +import com.codingapi.springboot.framework.event.Handler; +import com.codingapi.springboot.framework.event.IHandler; import lombok.extern.slf4j.Slf4j; @Slf4j @Handler -public class EntityFiledChangeHandler implements IHandler{ +public class EntityFiledChangeHandler implements IHandler { @Override public void handler(DomainChangeEvent event) { diff --git a/springboot-starter/src/test/java/com/codingapi/springboot/framework/handler/MyTestAsyncHandler.java b/springboot-starter/src/test/java/com/codingapi/springboot/framework/handler/MyTestAsyncHandler.java new file mode 100644 index 000000000..4ed2b689a --- /dev/null +++ b/springboot-starter/src/test/java/com/codingapi/springboot/framework/handler/MyTestAsyncHandler.java @@ -0,0 +1,16 @@ +package com.codingapi.springboot.framework.handler; + +import com.codingapi.springboot.framework.event.IHandler; +import com.codingapi.springboot.framework.event.MyTestAsyncEvent; +import lombok.extern.slf4j.Slf4j; +import org.springframework.stereotype.Component; + +@Slf4j +@Component +public class MyTestAsyncHandler implements IHandler { + + @Override + public void handler(MyTestAsyncEvent event) { + log.info("event:{}",event.getMyTest()); + } +} diff --git a/springboot-starter/src/test/java/com/codingapi/springboot/framework/handler/MyTestSyncHandler.java b/springboot-starter/src/test/java/com/codingapi/springboot/framework/handler/MyTestSyncHandler.java new file mode 100644 index 000000000..4a9042c13 --- /dev/null +++ b/springboot-starter/src/test/java/com/codingapi/springboot/framework/handler/MyTestSyncHandler.java @@ -0,0 +1,16 @@ +package com.codingapi.springboot.framework.handler; + +import com.codingapi.springboot.framework.event.IHandler; +import com.codingapi.springboot.framework.event.MyTestSyncEvent; +import lombok.extern.slf4j.Slf4j; +import org.springframework.stereotype.Component; + +@Slf4j +@Component +public class MyTestSyncHandler implements IHandler { + + @Override + public void handler(MyTestSyncEvent event) { + log.info("event:{}",event.getMyTest()); + } +} diff --git a/springboot-starter/src/test/java/com/codingapi/springboot/framework/math/ArithmeticFullTest.java b/springboot-starter/src/test/java/com/codingapi/springboot/framework/math/ArithmeticFullTest.java new file mode 100644 index 000000000..2077a39f0 --- /dev/null +++ b/springboot-starter/src/test/java/com/codingapi/springboot/framework/math/ArithmeticFullTest.java @@ -0,0 +1,99 @@ +package com.codingapi.springboot.framework.math; + +import org.junit.jupiter.api.Test; + +import java.math.BigDecimal; + +import static org.junit.jupiter.api.Assertions.assertEquals; + +/** + * Arithmetic 全量重载方法单元测试 + */ +class ArithmeticFullTest { + + @Test + void factoriesAndConstructors() { + assertEquals(0, Arithmetic.zero().getIntValue()); + assertEquals(1, Arithmetic.one().getIntValue()); + + assertEquals(5, Arithmetic.parse(5).getIntValue()); + assertEquals(5, Arithmetic.parse(5L).getIntValue()); + assertEquals(1.5, Arithmetic.parse(1.5d).getDoubleValue(), 0.0001); + assertEquals(1.5, Arithmetic.parse(1.5f).getDoubleValue(), 0.0001); + assertEquals(2.5, Arithmetic.parse("2.5").getDoubleValue(), 0.0001); + + assertEquals(3, new Arithmetic(3).getIntValue()); + assertEquals(3, new Arithmetic(3L).getIntValue()); + assertEquals(0.5, new Arithmetic(0.5d).getDoubleValue(), 0.0001); + assertEquals(0.5, new Arithmetic(0.5f).getDoubleValue(), 0.0001); + assertEquals(4.5, new Arithmetic("4.5").getDoubleValue(), 0.0001); + } + + @Test + void addOverloads() { + assertEquals(3, Arithmetic.one().add(Arithmetic.parse(2)).getIntValue()); + assertEquals(3, Arithmetic.one().add("2").getIntValue()); + assertEquals(3, Arithmetic.one().add(2).getIntValue()); + assertEquals(3, Arithmetic.one().add(2.0d).getIntValue()); + assertEquals(3, Arithmetic.one().add(2.0f).getIntValue()); + assertEquals(3, Arithmetic.one().add(2L).getIntValue()); + } + + @Test + void subOverloads() { + assertEquals(1, Arithmetic.parse(3).sub(Arithmetic.parse(2)).getIntValue()); + assertEquals(1, Arithmetic.parse(3).sub("2").getIntValue()); + assertEquals(1, Arithmetic.parse(3).sub(2).getIntValue()); + assertEquals(1, Arithmetic.parse(3).sub(2.0d).getIntValue()); + assertEquals(1, Arithmetic.parse(3).sub(2.0f).getIntValue()); + assertEquals(1, Arithmetic.parse(3).sub(2L).getIntValue()); + } + + @Test + void mulOverloads() { + assertEquals(6, Arithmetic.parse(3).mul(Arithmetic.parse(2)).getIntValue()); + assertEquals(6, Arithmetic.parse(3).mul("2").getIntValue()); + assertEquals(6, Arithmetic.parse(3).mul(2).getIntValue()); + assertEquals(6, Arithmetic.parse(3).mul(2.0d).getIntValue()); + assertEquals(6, Arithmetic.parse(3).mul(2.0f).getIntValue()); + assertEquals(6, Arithmetic.parse(3).mul(2L).getIntValue()); + } + + @Test + void divOverloads() { + assertEquals(3, Arithmetic.parse(6).div(Arithmetic.parse(2)).getIntValue()); + assertEquals(3, Arithmetic.parse(6).div("2").getIntValue()); + assertEquals(3, Arithmetic.parse(6).div(2).getIntValue()); + assertEquals(3, Arithmetic.parse(6).div(2.0d).getIntValue()); + assertEquals(3, Arithmetic.parse(6).div(2.0f).getIntValue()); + assertEquals(3, Arithmetic.parse(6).div(2L).getIntValue()); + } + + @Test + void valueGetters() { + Arithmetic value = Arithmetic.parse("12.34"); + assertEquals(new BigDecimal("12.34"), value.getValue()); + assertEquals("12.34", value.getStringValue()); + assertEquals(12, value.getIntValue()); + assertEquals(12L, value.getLongValue()); + assertEquals(12.34, value.getDoubleValue(), 0.0001); + assertEquals(12.34f, value.getFloatValue(), 0.0001); + assertEquals(12, value.getBigIntegerValue().intValue()); + } + + @Test + void halfUpScale() { + // 1.005 保留两位四舍五入 -> 1.01(half up) + assertEquals("1.01", Arithmetic.parse("1.005").halfUpScale2().getStringValue()); + assertEquals("1.005", Arithmetic.parse("1.0051").halfUpScale(3).getStringValue()); + assertEquals("3.14", Arithmetic.parse("3.14159").halfUpScale2().getStringValue()); + } + + @Test + void chainedCalculation() { + // ((10 - 2) x 3) / 4 = 6 + assertEquals(6, Arithmetic.parse(10).sub(2).mul(3).div(4).getIntValue()); + // 0.1 + 0.2 精确等于 0.3 + assertEquals("0.3", Arithmetic.parse("0.1").add("0.2").getStringValue()); + } +} diff --git a/springboot-starter/src/test/java/com/codingapi/springboot/framework/query/entity/Demo.java b/springboot-starter/src/test/java/com/codingapi/springboot/framework/query/entity/Demo.java index 664f815a8..148a34aec 100644 --- a/springboot-starter/src/test/java/com/codingapi/springboot/framework/query/entity/Demo.java +++ b/springboot-starter/src/test/java/com/codingapi/springboot/framework/query/entity/Demo.java @@ -1,9 +1,10 @@ package com.codingapi.springboot.framework.query.entity; -import jakarta.persistence.*; import lombok.Getter; import lombok.Setter; +import javax.persistence.*; + @Setter @Getter @Table(name = "t_demo") diff --git a/springboot-starter/src/test/java/com/codingapi/springboot/framework/query/test/DemoRepositoryTest.java b/springboot-starter/src/test/java/com/codingapi/springboot/framework/query/test/DemoRepositoryTest.java index 3ae7c3e20..2b787c96a 100644 --- a/springboot-starter/src/test/java/com/codingapi/springboot/framework/query/test/DemoRepositoryTest.java +++ b/springboot-starter/src/test/java/com/codingapi/springboot/framework/query/test/DemoRepositoryTest.java @@ -46,9 +46,9 @@ void query(){ request.setCurrent(1); request.setPageSize(10); - request.addFilter("name","123"); - - Example demo = request.getExample(Demo.class); + Demo search = new Demo(); + search.setName("123"); + Example demo = Example.of(search); System.out.println(demo); Page page = demoRepository.findAll(demo,request); assertEquals(1, page.getTotalElements()); @@ -67,7 +67,7 @@ void sort(){ demoRepository.save(demo2); PageRequest request = new PageRequest(); - request.setCurrent(1); + request.setCurrent(0); request.setPageSize(10); request.addSort(Sort.by("id").descending()); diff --git a/springboot-starter/src/test/java/com/codingapi/springboot/framework/reflect/FieldAttribute.java b/springboot-starter/src/test/java/com/codingapi/springboot/framework/reflect/FieldAttribute.java new file mode 100644 index 000000000..d8ac2d020 --- /dev/null +++ b/springboot-starter/src/test/java/com/codingapi/springboot/framework/reflect/FieldAttribute.java @@ -0,0 +1,17 @@ +package com.codingapi.springboot.framework.reflect; + +import lombok.Data; + +/** + * 附加属性 + */ +@Data +public class FieldAttribute { + // 属性key + @MyScript + private String key; + // 属性名称 + private String label; + // 属性值 + private Object value; +} diff --git a/springboot-starter/src/test/java/com/codingapi/springboot/framework/reflect/MyScript.java b/springboot-starter/src/test/java/com/codingapi/springboot/framework/reflect/MyScript.java new file mode 100644 index 000000000..0506e2800 --- /dev/null +++ b/springboot-starter/src/test/java/com/codingapi/springboot/framework/reflect/MyScript.java @@ -0,0 +1,9 @@ +package com.codingapi.springboot.framework.reflect; + +import java.lang.annotation.*; + +@Target({ElementType.FIELD}) +@Retention(RetentionPolicy.RUNTIME) +@Documented +public @interface MyScript { +} diff --git a/springboot-starter/src/test/java/com/codingapi/springboot/framework/reflect/ObjectAnnotationFieldUtilsTest.java b/springboot-starter/src/test/java/com/codingapi/springboot/framework/reflect/ObjectAnnotationFieldUtilsTest.java new file mode 100644 index 000000000..c40e2b812 --- /dev/null +++ b/springboot-starter/src/test/java/com/codingapi/springboot/framework/reflect/ObjectAnnotationFieldUtilsTest.java @@ -0,0 +1,27 @@ +package com.codingapi.springboot.framework.reflect; + +import com.alibaba.fastjson.JSONObject; +import org.junit.jupiter.api.Test; + +import java.util.List; + +import static org.junit.jupiter.api.Assertions.assertEquals; + +class ObjectAnnotationFieldUtilsTest { + + @Test + void findFieldAnnotationValue() { + String attribute2 = " {\"key\":\"123\",\"label\":\"123\",\"value\":[ {\"data\":\"123\"}, {\"data\":\"123\"}]} "; + + + FieldAttribute attributeObj1 = new FieldAttribute(); + FieldAttribute attributeObj2 = JSONObject.parseObject(attribute2,FieldAttribute.class); + + + List keys1 = ObjectAnnotationFieldUtils.findFieldAnnotationValue(attributeObj1,MyScript.class, String.class).getValues(); + assertEquals(0,keys1.size()); + + List keys2 = ObjectAnnotationFieldUtils.findFieldAnnotationValue(attributeObj2,MyScript.class, String.class).getValues(); + assertEquals(1,keys2.size()); + } +} \ No newline at end of file diff --git a/springboot-starter/src/test/java/com/codingapi/springboot/framework/repository/MyTestRepository.java b/springboot-starter/src/test/java/com/codingapi/springboot/framework/repository/MyTestRepository.java new file mode 100644 index 000000000..1a6831889 --- /dev/null +++ b/springboot-starter/src/test/java/com/codingapi/springboot/framework/repository/MyTestRepository.java @@ -0,0 +1,10 @@ +package com.codingapi.springboot.framework.repository; + +import com.codingapi.springboot.framework.entity.MyTest; +import org.springframework.data.jpa.repository.JpaRepository; +import org.springframework.stereotype.Repository; + +@Repository +public interface MyTestRepository extends JpaRepository { + +} diff --git a/springboot-starter/src/test/java/com/codingapi/springboot/framework/rest/LocalHttpServerRestTest.java b/springboot-starter/src/test/java/com/codingapi/springboot/framework/rest/LocalHttpServerRestTest.java new file mode 100644 index 000000000..68573ec0b --- /dev/null +++ b/springboot-starter/src/test/java/com/codingapi/springboot/framework/rest/LocalHttpServerRestTest.java @@ -0,0 +1,218 @@ +package com.codingapi.springboot.framework.rest; + +import com.alibaba.fastjson.JSONObject; +import com.codingapi.springboot.framework.rest.param.RestParam; +import com.sun.net.httpserver.HttpExchange; +import com.sun.net.httpserver.HttpServer; +import org.junit.jupiter.api.AfterAll; +import org.junit.jupiter.api.BeforeAll; +import org.junit.jupiter.api.Test; +import org.springframework.http.HttpHeaders; +import org.springframework.util.LinkedMultiValueMap; +import org.springframework.util.MultiValueMap; + +import java.io.ByteArrayOutputStream; +import java.io.IOException; +import java.io.InputStream; +import java.io.OutputStream; +import java.net.InetSocketAddress; +import java.nio.charset.StandardCharsets; + +import static org.junit.jupiter.api.Assertions.assertEquals; +import static org.junit.jupiter.api.Assertions.assertNotNull; +import static org.junit.jupiter.api.Assertions.assertTrue; + +/** + * 基于 JDK 内置 HttpServer 的本地回环 HTTP 测试, 无外部网络依赖, + * 覆盖 HttpRequest / RestClient / SessionClient 的 GET/POST 主要路径 + */ +class LocalHttpServerRestTest { + + private static HttpServer server; + private static String baseUrl; + + @BeforeAll + static void startServer() throws IOException { + server = HttpServer.create(new InetSocketAddress("127.0.0.1", 0), 0); + // 固定 JSON 响应 + server.createContext("/json", exchange -> + respond(exchange, "{\"name\":\"codingapi\"}")); + // 回显请求体 + server.createContext("/echo", exchange -> + respond(exchange, new String(readBody(exchange.getRequestBody()), StandardCharsets.UTF_8))); + // 回显查询字符串 + server.createContext("/query", exchange -> { + String query = exchange.getRequestURI().getRawQuery(); + respond(exchange, query == null ? "" : query); + }); + server.start(); + baseUrl = "http://127.0.0.1:" + server.getAddress().getPort(); + } + + @AfterAll + static void stopServer() { + if (server != null) { + server.stop(0); + } + } + + private static byte[] readBody(InputStream in) throws IOException { + ByteArrayOutputStream buffer = new ByteArrayOutputStream(); + byte[] chunk = new byte[2048]; + int len; + while ((len = in.read(chunk)) != -1) { + buffer.write(chunk, 0, len); + } + return buffer.toByteArray(); + } + + private static void respond(HttpExchange exchange, String body) throws IOException { + byte[] bytes = body.getBytes(StandardCharsets.UTF_8); + exchange.getResponseHeaders().set("Content-Type", "application/json;charset=UTF-8"); + exchange.sendResponseHeaders(200, bytes.length); + try (OutputStream out = exchange.getResponseBody()) { + out.write(bytes); + } + exchange.close(); + } + + @Test + void restClientGetJson() { + RestClient restClient = new RestClient(baseUrl); + String response = restClient.get("/json"); + JSONObject json = JSONObject.parseObject(response); + assertNotNull(json); + assertEquals("codingapi", json.getString("name")); + } + + @Test + void restClientGetWithQueryParams() { + RestClient restClient = new RestClient(baseUrl); + String response = restClient.get("/query", RestParam.create() + .add("name", "zhang") + .add("age", "18")); + assertTrue(response.contains("name=zhang")); + assertTrue(response.contains("age=18")); + } + + @Test + void restClientGetWithHeaders() { + RestClient restClient = new RestClient(baseUrl); + HttpHeaders headers = new HttpHeaders(); + String response = restClient.get("/json", headers); + assertNotNull(response); + } + + @Test + void restClientPostJson() { + RestClient restClient = new RestClient(baseUrl); + JSONObject body = new JSONObject(); + body.put("username", "admin"); + String response = restClient.post("/echo", body); + JSONObject echo = JSONObject.parseObject(response); + assertNotNull(echo); + assertEquals("admin", echo.getString("username")); + } + + @Test + void restClientPostWithRestParam() { + RestClient restClient = new RestClient(baseUrl); + String response = restClient.post("/echo", RestParam.create().add("k", "v")); + JSONObject echo = JSONObject.parseObject(response); + assertNotNull(echo); + assertEquals("v", echo.getString("k")); + } + + @Test + void sessionClientGetJson() { + SessionClient sessionClient = new SessionClient(); + String response = sessionClient.getJson(baseUrl + "/json"); + JSONObject json = JSONObject.parseObject(response); + assertNotNull(json); + assertEquals("codingapi", json.getString("name")); + } + + @Test + void sessionClientGetJsonWithParams() { + SessionClient sessionClient = new SessionClient(); + String response = sessionClient.getJson(baseUrl + "/query", RestParam.create().add("q", "1")); + assertTrue(response.contains("q=1")); + } + + @Test + void sessionClientPostJson() { + SessionClient sessionClient = new SessionClient(); + String response = sessionClient.postJson(baseUrl + "/echo", RestParam.create().add("action", "login")); + JSONObject echo = JSONObject.parseObject(response); + assertNotNull(echo); + assertEquals("login", echo.getString("action")); + } + + @Test + void sessionClientPostJsonBody() { + SessionClient sessionClient = new SessionClient(); + JSONObject body = new JSONObject(); + body.put("from", "body"); + String response = sessionClient.postJson(baseUrl + "/echo", body); + JSONObject echo = JSONObject.parseObject(response); + assertNotNull(echo); + assertEquals("body", echo.getString("from")); + } + + @Test + void sessionClientPostForm() { + SessionClient sessionClient = new SessionClient(); + String response = sessionClient.postForm(baseUrl + "/echo", RestParam.create().add("f", "1")); + assertTrue(response.contains("f=1")); + } + + @Test + void sessionClientGetHtml() { + SessionClient sessionClient = new SessionClient(); + String response = sessionClient.getHtml(baseUrl + "/json"); + assertNotNull(response); + } + + @Test + void sessionClientAddHeader() { + SessionClient sessionClient = new SessionClient(); + sessionClient.addHeader("X-Test", "1"); + assertEquals("1", sessionClient.getHttpHeaders().getFirst("X-Test")); + } + + @Test + void httpRequestGetRequestExecute() { + HttpRequest httpRequest = new HttpRequest(); + MultiValueMap variables = new LinkedMultiValueMap<>(); + variables.add("a", "1"); + String response = httpRequest.getGetRequest(baseUrl + "/query", new HttpHeaders(), variables).execute(); + assertTrue(response.contains("a=1")); + } + + @Test + void httpRequestGetWithoutVariables() { + HttpRequest httpRequest = new HttpRequest(); + String response = httpRequest.getGetRequest(baseUrl + "/json", new HttpHeaders(), null).execute(); + assertNotNull(response); + } + + @Test + void httpRequestPostJsonRequest() { + HttpRequest httpRequest = new HttpRequest(); + JSONObject body = new JSONObject(); + body.put("via", "request"); + String response = httpRequest.getPostRequest(baseUrl + "/echo", new HttpHeaders(), (com.alibaba.fastjson.JSON) body).execute(); + JSONObject echo = JSONObject.parseObject(response); + assertNotNull(echo); + assertEquals("request", echo.getString("via")); + } + + @Test + void httpRequestPostFormRequest() { + HttpRequest httpRequest = new HttpRequest(); + MultiValueMap form = new LinkedMultiValueMap<>(); + form.add("field", "x"); + String response = httpRequest.getPostRequest(baseUrl + "/echo", new HttpHeaders(), form).execute(); + assertTrue(response.contains("field=x")); + } +} diff --git a/springboot-starter/src/test/java/com/codingapi/springboot/framework/rest/RestClientTest.java b/springboot-starter/src/test/java/com/codingapi/springboot/framework/rest/RestClientTest.java index c6a48d792..b4266c2f2 100644 --- a/springboot-starter/src/test/java/com/codingapi/springboot/framework/rest/RestClientTest.java +++ b/springboot-starter/src/test/java/com/codingapi/springboot/framework/rest/RestClientTest.java @@ -1,10 +1,13 @@ package com.codingapi.springboot.framework.rest; +import com.alibaba.fastjson.JSONArray; import com.alibaba.fastjson.JSONObject; import com.codingapi.springboot.framework.rest.param.RestParam; import com.codingapi.springboot.framework.rest.properties.HttpProxyProperties; import lombok.extern.slf4j.Slf4j; +import org.junit.jupiter.api.Assumptions; import org.junit.jupiter.api.Test; +import org.springframework.http.HttpHeaders; import java.net.Proxy; @@ -13,6 +16,10 @@ @Slf4j class RestClientTest { + /** + * 依赖外部网络与本地代理（127.0.0.1:7890）的集成用例： + * 代理缺失、网络受限或外部接口限流时跳过，不作为 CI 强制断言。 + */ @Test void okxTest() { String baseUrl = "https://www.okx.com/"; @@ -21,14 +28,32 @@ void okxTest() { proxyProperties.setProxyType(Proxy.Type.HTTP); proxyProperties.setProxyHost("127.0.0.1"); proxyProperties.setProxyPort(7890); + + HttpHeaders headers = new HttpHeaders(); + headers.set("x-simulated-trading","1"); + headers.set("User-Agent", "Application"); RestClient restClient = new RestClient(proxyProperties,baseUrl,5,"{}",null,null); - String response = restClient.get("api/v5/market/candles", RestParam.create() - .add("instId","BTC-USDT") - .add("bar","1m") - .add("limit","300") - ); + String response; + try { + response = restClient.get( + "api/v5/market/candles", + headers, + RestParam.create() + .add("instId","BTC-USDT") + .add("bar","1m") + .add("limit","300") + ); + } catch (Exception e) { + Assumptions.assumeTrue(false, "OKX 外部接口不可用（本地代理 127.0.0.1:7890 缺失或网络受限），跳过用例: " + e.getMessage()); + return; + } log.info("response:{}",response); JSONObject jsonObject = JSONObject.parseObject(response); - assertEquals(jsonObject.getJSONArray("data").size(),300); + JSONArray data = jsonObject == null ? null : jsonObject.getJSONArray("data"); + if (data == null) { + Assumptions.assumeTrue(false, "OKX 外部接口响应无 data 数据（网络受限或限流），跳过用例"); + return; + } + assertEquals(300, data.size()); } -} \ No newline at end of file +} diff --git a/springboot-starter/src/test/java/com/codingapi/springboot/framework/service/MyTestService.java b/springboot-starter/src/test/java/com/codingapi/springboot/framework/service/MyTestService.java new file mode 100644 index 000000000..ede591505 --- /dev/null +++ b/springboot-starter/src/test/java/com/codingapi/springboot/framework/service/MyTestService.java @@ -0,0 +1,37 @@ +package com.codingapi.springboot.framework.service; + +import com.codingapi.springboot.framework.entity.MyTest; +import com.codingapi.springboot.framework.event.EventPusher; +import com.codingapi.springboot.framework.event.MyTestAsyncEvent; +import com.codingapi.springboot.framework.event.MyTestSyncEvent; +import com.codingapi.springboot.framework.repository.MyTestRepository; +import javax.transaction.Transactional; +import lombok.AllArgsConstructor; +import org.springframework.stereotype.Service; + +@Service +@AllArgsConstructor +public class MyTestService { + + private final MyTestRepository testRepository; + + @Transactional + public void save1(){ + MyTest myTest = new MyTest(); + myTest.setName("test"); + testRepository.save(myTest); + EventPusher.push(new MyTestSyncEvent(myTest)); + EventPusher.push(new MyTestAsyncEvent(myTest)); + int value = 100 / 0; + System.out.println(value); + } + + @Transactional + public void save2(){ + MyTest myTest = new MyTest(); + myTest.setName("test"); + testRepository.save(myTest); + EventPusher.push(new MyTestSyncEvent(myTest)); + EventPusher.push(new MyTestAsyncEvent(myTest)); + } +} diff --git a/springboot-starter/src/test/java/com/codingapi/springboot/framework/transaction/TransactionManagerContextTest.java b/springboot-starter/src/test/java/com/codingapi/springboot/framework/transaction/TransactionManagerContextTest.java new file mode 100644 index 000000000..c0344b96a --- /dev/null +++ b/springboot-starter/src/test/java/com/codingapi/springboot/framework/transaction/TransactionManagerContextTest.java @@ -0,0 +1,114 @@ +package com.codingapi.springboot.framework.transaction; + +import org.junit.jupiter.api.AfterEach; +import org.junit.jupiter.api.BeforeEach; +import org.junit.jupiter.api.Test; +import org.mockito.ArgumentCaptor; +import org.springframework.transaction.PlatformTransactionManager; +import org.springframework.transaction.TransactionDefinition; +import org.springframework.transaction.TransactionStatus; +import org.springframework.transaction.support.DefaultTransactionDefinition; + +import static org.junit.jupiter.api.Assertions.assertEquals; +import static org.junit.jupiter.api.Assertions.assertThrows; +import static org.mockito.ArgumentMatchers.any; +import static org.mockito.Mockito.mock; +import static org.mockito.Mockito.never; +import static org.mockito.Mockito.verify; +import static org.mockito.Mockito.when; + +/** + * TransactionManagerContext 单元测试 + */ +class TransactionManagerContextTest { + + private PlatformTransactionManager transactionManager; + private TransactionStatus transactionStatus; + + @BeforeEach + void setUp() { + transactionManager = mock(PlatformTransactionManager.class); + transactionStatus = mock(TransactionStatus.class); + when(transactionManager.getTransaction(any(TransactionDefinition.class))).thenReturn(transactionStatus); + } + + @AfterEach + void tearDown() { + // 恢复为空, 避免影响其他测试 + TransactionManagerContext.getInstance().setPlatformTransactionManager(null); + } + + @Test + void commitWithTransactionManager() { + TransactionManagerContext.getInstance().setPlatformTransactionManager(transactionManager); + + String result = TransactionManagerContext.getInstance().commit(() -> "ok"); + + assertEquals("ok", result); + ArgumentCaptor captor = ArgumentCaptor.forClass(TransactionDefinition.class); + verify(transactionManager).getTransaction(captor.capture()); + assertEquals(TransactionDefinition.PROPAGATION_REQUIRES_NEW, captor.getValue().getPropagationBehavior()); + verify(transactionManager).commit(transactionStatus); + verify(transactionManager, never()).rollback(transactionStatus); + } + + @Test + void commitRollsBackOnException() { + TransactionManagerContext.getInstance().setPlatformTransactionManager(transactionManager); + + assertThrows(IllegalStateException.class, + () -> TransactionManagerContext.getInstance().commit(() -> { + throw new IllegalStateException("boom"); + })); + + verify(transactionManager).rollback(transactionStatus); + verify(transactionManager, never()).commit(transactionStatus); + } + + @Test + void commitWithoutTransactionManager() { + TransactionManagerContext.getInstance().setPlatformTransactionManager(null); + + String result = TransactionManagerContext.getInstance().commit(() -> "direct"); + + assertEquals("direct", result); + } + + @Test + void readOnlyEndsWithRollback() { + TransactionManagerContext.getInstance().setPlatformTransactionManager(transactionManager); + + String result = TransactionManagerContext.getInstance().readOnly(() -> "read"); + + assertEquals("read", result); + ArgumentCaptor captor = ArgumentCaptor.forClass(TransactionDefinition.class); + verify(transactionManager).getTransaction(captor.capture()); + DefaultTransactionDefinition definition = (DefaultTransactionDefinition) captor.getValue(); + assertEquals(TransactionDefinition.PROPAGATION_REQUIRES_NEW, definition.getPropagationBehavior()); + assertEquals(true, definition.isReadOnly()); + // 只读模式以回滚结束 + verify(transactionManager).rollback(transactionStatus); + verify(transactionManager, never()).commit(transactionStatus); + } + + @Test + void readOnlyRollsBackOnException() { + TransactionManagerContext.getInstance().setPlatformTransactionManager(transactionManager); + + assertThrows(IllegalStateException.class, + () -> TransactionManagerContext.getInstance().readOnly(() -> { + throw new IllegalStateException("boom"); + })); + + verify(transactionManager).rollback(transactionStatus); + } + + @Test + void readOnlyWithoutTransactionManager() { + TransactionManagerContext.getInstance().setPlatformTransactionManager(null); + + String result = TransactionManagerContext.getInstance().readOnly(() -> "direct"); + + assertEquals("direct", result); + } +} diff --git a/springboot-starter/src/test/java/com/codingapi/springboot/framework/utils/ClassLoaderUtilsTest.java b/springboot-starter/src/test/java/com/codingapi/springboot/framework/utils/ClassLoaderUtilsTest.java new file mode 100644 index 000000000..0171e8627 --- /dev/null +++ b/springboot-starter/src/test/java/com/codingapi/springboot/framework/utils/ClassLoaderUtilsTest.java @@ -0,0 +1,103 @@ +package com.codingapi.springboot.framework.utils; + +import org.junit.jupiter.api.Test; +import org.junit.jupiter.api.io.TempDir; + +import java.io.File; +import java.io.FileOutputStream; +import java.net.URLClassLoader; +import java.nio.file.Path; +import java.util.List; +import java.util.jar.JarEntry; +import java.util.jar.JarOutputStream; + +import static org.junit.jupiter.api.Assertions.assertEquals; +import static org.junit.jupiter.api.Assertions.assertFalse; +import static org.junit.jupiter.api.Assertions.assertThrows; +import static org.junit.jupiter.api.Assertions.assertTrue; + +/** + * ClassLoaderUtils 单元测试 + */ +class ClassLoaderUtilsTest { + + @TempDir + Path tempDir; + + @Test + void createClassLoaderThrowsWhenJarNotFound() { + assertThrows(RuntimeException.class, () -> ClassLoaderUtils.createClassLoader("/no/such/file.jar")); + } + + @Test + void findAllClassesInDirectory() throws Exception { + // 构造目录结构: root/com/demo/A.class, root/com/demo/sub/B.class + File root = tempDir.toFile(); + File pkg = new File(root, "com/demo/sub"); + assertTrue(pkg.mkdirs()); + assertTrue(new File(pkg.getParentFile(), "A.class").createNewFile()); + assertTrue(new File(pkg, "B.class").createNewFile()); + // 非 class 文件应被忽略 + assertTrue(new File(pkg, "readme.txt").createNewFile()); + + URLClassLoader classLoader = new URLClassLoader(new java.net.URL[]{root.toURI().toURL()}); + List classes = ClassLoaderUtils.findAllClasses(classLoader); + + assertTrue(classes.contains("com.demo.A")); + assertTrue(classes.contains("com.demo.sub.B")); + assertEquals(2, classes.size()); + classLoader.close(); + } + + @Test + void findAllClassesInJar() throws Exception { + File jarFile = tempDir.resolve("demo.jar").toFile(); + try (JarOutputStream jar = new JarOutputStream(new FileOutputStream(jarFile))) { + jar.putNextEntry(new JarEntry("com/demo/Inner.class")); + jar.write(new byte[]{(byte) 0xCA, (byte) 0xFE, (byte) 0xBA, (byte) 0xBE}); + jar.closeEntry(); + // 非 class 条目应被忽略 + jar.putNextEntry(new JarEntry("META-INF/MANIFEST.MF")); + jar.write("Manifest-Version: 1.0".getBytes()); + jar.closeEntry(); + } + + URLClassLoader classLoader = ClassLoaderUtils.createClassLoader(jarFile.getAbsolutePath()); + List classes = ClassLoaderUtils.findAllClasses(classLoader); + + assertEquals(1, classes.size()); + assertEquals("com.demo.Inner", classes.get(0)); + classLoader.close(); + } + + @Test + void findJarClassesLoadsRealClasses() throws Exception { + // 将当前测试类所在的 classes 目录打包成 jar, 验证类可被真实加载 + String classFilePath = ClassLoaderUtilsTest.class.getName().replace('.', '/') + ".class"; + java.net.URL classUrl = ClassLoaderUtilsTest.class.getClassLoader().getResource(classFilePath); + assertFalse(classUrl == null); + + File jarFile = tempDir.resolve("real.jar").toFile(); + try (JarOutputStream jar = new JarOutputStream(new FileOutputStream(jarFile))) { + jar.putNextEntry(new JarEntry(classFilePath)); + try (java.io.InputStream in = classUrl.openStream()) { + byte[] buffer = new byte[4096]; + int len; + while ((len = in.read(buffer)) != -1) { + jar.write(buffer, 0, len); + } + } + jar.closeEntry(); + } + + List> classes = ClassLoaderUtils.findJarClasses(jarFile.getAbsolutePath()); + assertFalse(classes.isEmpty()); + + List> filtered = ClassLoaderUtils.findJarClass(jarFile.getAbsolutePath(), Object.class); + assertFalse(filtered.isEmpty()); + + // 指定不可能匹配的接口类型时返回空 + List> none = ClassLoaderUtils.findJarClass(jarFile.getAbsolutePath(), Runnable.class); + assertTrue(none.isEmpty() || none.stream().allMatch(Runnable.class::isAssignableFrom)); + } +} diff --git a/springboot-starter/src/test/resources/application.properties b/springboot-starter/src/test/resources/application.properties index c3ec648b6..68dd11835 100644 --- a/springboot-starter/src/test/resources/application.properties +++ b/springboot-starter/src/test/resources/application.properties @@ -1,5 +1,8 @@ server.port=8088 spring.datasource.driver-class-name=org.h2.Driver spring.datasource.url=jdbc:h2:file:./test.db +spring.jpa.database-platform=org.hibernate.dialect.H2Dialect spring.jpa.hibernate.ddl-auto=create-drop -spring.jpa.show-sql=true \ No newline at end of file +spring.jpa.show-sql=true + +codingapi.framework.event.transaction.enable=true \ No newline at end of file