fix: 修正 Flexmodel 目录名称及更新 README 文档

- 将 isFlexModelPath 方法重命名为 isFlexmodelPath，确保一致性
- 更新 README.md，增加 Java SDK 特性描述和使用示例
- 修改 variables.json 中的描述字段，简化为 "Java SDK"
- 在 RecordsApi.java 中新增 listRecordsAsList 方法，支持直接返回实体列表

Author: cjbi

src/main/java/tech/wetech/flexmodel/codegen/CodeGenerationService.java

@@ -189,7 +189,7 @@ private void outputFiles(GroovyClassLoader classLoader, GenerationContext contex
 
   private void outFile(GroovyClassLoader classLoader, GenerationContext context, String sourceDirectory, String targetDirectory, List<File> outputFiles, Path path) throws Exception {
     // Skip .flexmodel directory and its contents
-    if (isFlexModelPath(path)) {
+    if (isFlexmodelPath(path)) {
       return;
     }
 
@@ -253,7 +253,7 @@ private String resolveTargetPath(String sourcePath, GenerationContext context, S
   /**
    * Check if the path is within .flexmodel directory
    */
-  private boolean isFlexModelPath(Path path) {
+  private boolean isFlexmodelPath(Path path) {
     String pathString = path.toString().replace("\\", "/");
     return pathString.contains("/.flexmodel/") || pathString.endsWith("/.flexmodel");
   }

src/main/templates/java_sdk/.flexmodel/variables.json

@@ -2,7 +2,7 @@
   "packageName": "com.example",
   "path": "com/example",
   "projectName": "java-sdk",
-  "description": "Java SDK Sample",
+  "description": "Java SDK",
   "version": "1.0.0",
   "groupId": "com.example",
   "artifactId": "java-sdk-sample"

src/main/templates/java_sdk/README.md

@@ -1,9 +1,150 @@
-Flexmodel Java SDK 模板
+# Flexmodel Java SDK 模板
 
-该模板提供访问 Flexmodel 后端的简易 Java SDK，覆盖模型数据记录 CRUD 接口。
+该模板提供访问 Flexmodel 后端的简易 Java SDK，支持直接访问实体类型，无需通用封装。
 
-快速开始：
-- 设置占位变量 groupId、artifactId、version。
-- 使用 ApiClient 与 RecordsApi 调用接口。
+## 特性
+
+- **直接实体访问**：`List<User> listUsers()` 而不是 `ApiResponse<PageResult<Map<String, Object>>>`
+- **类型安全**：强类型实体类，编译时类型检查
+- **便捷API**：为每个实体生成专门的API类
+- **灵活查询**：支持分页、过滤、排序等查询参数
+- **简单易用**：工厂模式创建客户端，一行代码开始使用
+
+## 快速开始
+
+### 1. 创建客户端
+
+```java
+// 使用工厂方法创建客户端
+FlexmodelClient client = FlexmodelClientFactory.createClient(
+    "http://localhost:8080", 
+    "myDatasource"
+);
+
+// 或者手动创建
+ApiClient apiClient = new ApiClient("http://localhost:8080");
+FlexmodelClient client = new FlexmodelClient(apiClient, "myDatasource");
+```
+
+### 2. 直接访问实体
+
+```java
+// 获取用户API（示例）
+UserApi userApi = client.users();
+
+// 获取所有用户 - 直接返回List<User>
+List<User> users = userApi.listUsers();
+
+// 带条件查询
+List<User> activeUsers = userApi.listUsers("status='active'", null, "name asc");
+
+// 分页查询
+PageResult<User> userPage = userApi.listUsers(1, 10, null, null, null);
+
+// 获取单个用户
+User user = userApi.getUser("123");
+
+// 创建用户
+User newUser = new User();
+newUser.setName("张三");
+newUser.setEmail("[email protected]");
+User createdUser = userApi.createUser(newUser);
+
+// 更新用户
+user.setAge(26);
+User updatedUser = userApi.updateUser(user.getId(), user);
+
+// 删除用户
+userApi.deleteUser(user.getId());
+```
+
+### 3. 访问多个实体
+
+```java
+// 用户相关操作（示例）
+UserApi userApi = client.users();
+List<User> users = userApi.listUsers();
+
+// 产品相关操作（示例）
+ProductApi productApi = client.products();
+List<Product> products = productApi.listProducts();
+
+// 订单相关操作（示例）
+OrderApi orderApi = client.orders();
+List<Order> orders = orderApi.listOrders();
+```
+
+## API 方法说明
+
+每个实体API都提供以下方法：
+
+- `list{Entity}s()` - 获取所有记录（直接返回列表）
+- `list{Entity}s(filter, nestedQuery, sort)` - 带条件查询
+- `list{Entity}s(current, pageSize, filter, nestedQuery, sort)` - 分页查询
+- `get{Entity}(id)` - 根据ID获取记录
+- `create{Entity}(entity)` - 创建记录
+- `update{Entity}(id, entity)` - 更新记录
+- `patch{Entity}(id, entity)` - 部分更新记录
+- `delete{Entity}(id)` - 删除记录
+
+## 通用API
+
+如果需要使用通用API（返回Map类型），可以使用：
+
+```java
+RecordsApi recordsApi = client.getRecordsApi();
+PageResult<Map<String, Object>> records = recordsApi.listRecords(
+    "datasource", "model", 1, 10, null, null, null
+);
+```
+
+## 配置
+
+### 认证
+
+```java
+// API Key认证
+FlexmodelClient client = FlexmodelClientFactory.createClient(
+    "http://localhost:8080", 
+    "myDatasource", 
+    "your-api-key"
+);
+
+// 用户名密码认证
+FlexmodelClient client = FlexmodelClientFactory.createClient(
+    "http://localhost:8080", 
+    "myDatasource", 
+    "username", 
+    "password"
+);
+```
+
+### 开发环境
+
+```java
+// 使用默认配置（localhost:8080）
+FlexmodelClient client = FlexmodelClientFactory.createDefaultClient("myDatasource");
+```
+
+## 实体生成
+
+模板包含实体生成器，会根据模型定义自动生成：
+- 实体类（如User.java）
+- API类（如UserApi.java）
+
+## 示例代码
+
+所有示例代码都位于 `example` 包中：
+- `example.User.java` - 用户实体示例
+- `example.Product.java` - 产品实体示例  
+- `example.Order.java` - 订单实体示例
+- `example.UserApi.java` - 用户API示例
+- `example.ProductApi.java` - 产品API示例
+- `example.OrderApi.java` - 订单API示例
+- `example.FlexmodelExample.java` - 完整使用示例
+
+## 依赖
+
+确保在pom.xml中设置正确的groupId、artifactId和version占位变量。
 
 

src/main/templates/java_sdk/TEMPLATE_USAGE.md

@@ -0,0 +1,123 @@
+# Java SDK 模板使用说明
+
+## 模板结构
+
+```
+src/main/templates/java_sdk/
+├── src/main/java/${path}/
+│   ├── api/
+│   │   ├── RecordsApi.java              # 通用API（已修改为直接返回数据）
+│   │   └── EntityApiGenerator.groovy    # 实体API生成器
+│   ├── client/
+│   │   ├── ApiClient.java               # 基础API客户端
+│   │   ├── ApiResponse.java             # API响应包装类
+│   │   ├── FlexmodelClient.java         # 主客户端类
+│   │   └── FlexmodelClientFactory.java  # 客户端工厂
+│   ├── entity/
+│   │   └── JavaSdkEntityGenerator.groovy # 实体生成器
+│   └── example/                         # 示例代码包
+│       ├── User.java                    # 用户实体示例
+│       ├── Product.java                 # 产品实体示例
+│       ├── Order.java                   # 订单实体示例
+│       ├── UserApi.java                 # 用户API示例
+│       ├── ProductApi.java              # 产品API示例
+│       ├── OrderApi.java                # 订单API示例
+│       └── FlexmodelExample.java        # 完整使用示例
+├── pom.xml                              # Maven配置
+├── README.md                            # 使用文档
+└── TEMPLATE_USAGE.md                    # 模板使用说明
+```
+
+## 主要改进
+
+### 1. 直接实体访问
+**之前**：
+```java
+ApiResponse<PageResult<Map<String, Object>>> response = recordsApi.listRecords(...);
+List<Map<String, Object>> records = response.getData().getList();
+```
+
+**现在**：
+```java
+List<User> users = userApi.listUsers();
+```
+
+### 2. 类型安全
+- 强类型实体类，编译时类型检查
+- 自动补全和重构支持
+- 减少运行时错误
+
+### 3. 便捷API
+- 每个实体都有专门的API类
+- 统一的方法命名规范
+- 支持多种查询方式
+
+## 生成器使用
+
+### 实体生成器 (JavaSdkEntityGenerator.groovy)
+自动生成实体类，包含：
+- 私有字段
+- Getter/Setter方法
+- 标准JavaBean结构
+
+### API生成器 (EntityApiGenerator.groovy)
+自动生成API类，包含：
+- CRUD操作方法
+- 分页查询支持
+- 条件查询支持
+- 直接返回实体类型
+
+## 使用流程
+
+1. **配置模板变量**：
+   - `${packageName}` - 包名
+   - `${path}` - 路径结构
+
+2. **生成实体类**：
+   - 使用 `JavaSdkEntityGenerator` 为每个模型生成实体类
+
+3. **生成API类**：
+   - 使用 `EntityApiGenerator` 为每个实体生成API类
+
+4. **使用客户端**：
+   ```java
+   FlexmodelClient client = FlexmodelClientFactory.createClient(baseUrl, datasource);
+   // 注意：以下示例方法需要根据实际生成的实体类型进行调整
+   UserApi userApi = client.users();
+   List<User> users = userApi.listUsers();
+   ```
+
+## 扩展指南
+
+### 添加新的实体类型
+1. 创建实体类（或使用生成器）
+2. 创建对应的API类（或使用生成器）
+3. 在 `FlexmodelClient` 中添加便捷方法（参考example包中的示例）
+
+### 自定义API方法
+在生成的API类中添加业务特定的方法：
+```java
+public List<User> findActiveUsers() {
+    return listUsers("status='active'", null, "name asc");
+}
+```
+
+### 添加认证支持
+在 `ApiClient` 中添加认证逻辑，或在 `FlexmodelClientFactory` 中配置认证参数。
+
+## 最佳实践
+
+1. **使用工厂方法**：优先使用 `FlexmodelClientFactory` 创建客户端
+2. **类型安全**：尽量使用强类型API而不是通用API
+3. **错误处理**：适当处理API调用异常
+4. **资源管理**：合理管理客户端生命周期
+5. **缓存策略**：考虑对频繁访问的数据进行缓存
+
+## 注意事项
+
+- 确保所有实体类都有无参构造函数
+- API类需要与实体类在同一个包中
+- 生成器需要正确的模型定义才能工作
+- 客户端工厂方法提供了多种认证方式
+- 示例代码位于 `example` 包中，实际使用时需要根据您的实体类型进行调整
+- `FlexmodelClient` 中的便捷方法（如 `users()`, `products()` 等）是示例方法，需要根据实际生成的实体类型进行修改