[ { "path": ".github/ISSUE_TEMPLATE/bug_report.yml", "content": "name: Bug Report/报告 bug\ndescription: \"Create a report to help us improve, please read FAQ first./帮助我们更好地改进项目，但请先阅读常见问题与提问前必看，不要提已有的重复问题！\"\ntitle: \"[Bug] \"\nlabels: [kind/bug]\nbody:\n- type: markdown\n attributes:\n value: \"如果你已经知道问题所在、怎么解决，请直接 提交 Pull Request 为社区做贡献，非常感谢。\\n开发者也是人，也需要工作、休息、恋爱、陪伴家人、走亲会友等，也有心情不好和身体病痛，\\n往往没有额外的时间精力顾及一些小问题，请理解和支持，开源要大家参与贡献才会更美好~\\n少数个人的热情终有被耗尽的一天，只有大家共同建设和繁荣社区，才能让开源可持续发展！ \"\n\n- type: input\n attributes:\n label: APIJSON Version/APIJSON 版本号\n placeholder: |\n e.g./例如 5.4.0 ，如果不是最新版请用最新版，复现问题再来，原则上不更新旧版，而是只维护一个最新版\n\n validations:\n required: true\n\n- type: input\n attributes:\n label: Database Type & Version/数据库类型及版本号\n placeholder: |\n e.g./例如 MySQL 5.7.34\n \n validations:\n required: true\n \n- type: textarea\n attributes:\n label: Environment/环境信息\n description: |\n e.g./例如：\n - **JDK/基础库**: 1.8.0_17\n - **OS/系统**: MacOS Monterey 12.6 (21G115) M1\n value: |\n - JDK/基础库:\n - OS/系统:\n render: markdown\n\n validations:\n required: true\n \n- type: input\n attributes:\n label: APIAuto Screenshots/APIAuto 请求与结果完整截屏\n description: \"Upload by copy and paste image file or url./复制图片文件或 URL 再粘贴到输入框(用 APIAuto 能静态检查出很多问题，甚至还有修复建议，不用浪费你我的时间)\\n https://github.com/TommyLemon/APIAuto \"\n value: \n\n validations:\n required: true\n \n- type: textarea\n attributes:\n label: Current Behavior/问题描述\n description: \"A concise description of what you're experiencing. Must contains screenshots./\\n\\n**提 bug 请发请求和响应的【完整截屏】，没图的自行解决！\\n开发者有限的时间和精力主要放在【维护项目源码和文档】上！\\n【描述不详细】 或 【文档/常见问题 已有答案】 的问题可能会被忽略！！\\n【态度 不文明/不友善】的可能会被拉黑，问题也可能不予解答！！！**\\n\\n请求参数 JSON 中表名、字段名、关键词及对应的值都是大小写敏感、逗号敏感、分号敏感、空格敏感、换行敏感，\\n大部分情况都不允许空格和换行，表名以大写字母开头，不要想当然，请严格按照 设计规范 来调用 API \\n https://github.com/Tencent/APIJSON/issues/181 \"\n render: markdown\n\n validations:\n required: true\n\n- type: textarea\n attributes:\n label: Expected Behavior/期望结果\n description: A concise description of what you expected to happen./具体描述你期望返回什么样的结果或者达到什么样的效果？\n render: markdown\n\n validations:\n required: false\n\n\n- type: textarea\n attributes:\n label: Any additional comments?/其它补充说明？\n description: |\n e.g. some background/context of how you ran into this bug./例如：一些背景或上下文信息，包括复现步骤、相关日志等\n render: markdown\n\n validations:\n required: false\n \n- type: markdown\n attributes:\n value: \"Please follow the rules to fulfil all required inputs. You can add screenshots by comment after submit this issue./\\n请按要求填写所有必填项，未填完将提交不了！\\n如果随意填写敷衍了事，将直接关闭 issue，问题不会得到解答！\\n可以提交后再通过回复评论来补充上传截屏图片(复制粘贴文件)。\\n如果是网页 bug 等与你无关的原因导致提交不了，可以改为填问卷：\\n https://wj.qq.com/s2/10971431/2a09 \"\n" }, { "path": ".github/ISSUE_TEMPLATE/config.yml", "content": "blank_issues_enabled: false\n" }, { "path": ".github/ISSUE_TEMPLATE/feature_request.yml", "content": "name: Feature Request/期望新增功能\ndescription: Request a new feature/期望新增什么样的功能或特性，或者做哪些方面的改进？\ntitle: \"[Feature] \"\nlabels: [kind/feature]\nbody:\n- type: textarea\n attributes:\n label: Description\n description: |\n Please describe what this feature does./具体描述下是什么样的功能或特性，以及你为什么想要它，用在什么场景，碰到了什么痛点，有什么解决思路，尝试过哪些，效果怎样？\n\n validations:\n required: true\n \n- type: markdown\n attributes:\n value: 推荐去建议收集箱提问，也方便 统一检索和管理、投票决定优先级、更新处理进度 等： https://github.com/Tencent/APIJSON/issues/37\n" }, { "path": ".github/ISSUE_TEMPLATE/other_issues.yml", "content": "name: Other Issues/其它反馈\ndescription: For questions, suggestions, improvements and others./问题(非 bug)、建议(非新增功能) 或 其它\ntitle: \"[xxx] \"\nbody:\n- type: textarea\n attributes:\n label: Description\n description: |\n Please describe the issue./请具体描述，包括是什么、为什么、如何做\n\n validations:\n required: true\n\n- type: markdown\n attributes:\n value: \"Bug 反馈请使用正确的模板，用错模板将直接关闭 issue，不予解答：\\n https://github.com/Tencent/APIJSON/issues/new?assignees=&labels=kind%2Fbug&template=bug_report.yml&title=%5BBug%5D+ \\n有建议请去建议收集箱提问，也方便 统一检索和管理、投票决定优先级、更新处理进度 等：\\n https://github.com/Tencent/APIJSON/issues/37 \"\n" }, { "path": ".gitignore", "content": ".DS_Store\n.gradle\nyarn.lock\n*.project\n\nHELP.md\ntarget/\n!.mvn/wrapper/maven-wrapper.jar\n!**/src/main/**\n!**/src/test/**\n\n### STS ###\n.apt_generated\n.classpath\n.factorypath\n.project\n.settings\n.springBeans\n.sts4-cache\n\n### IntelliJ IDEA ###\n.idea\n*.iws\n*.iml\n*.ipr\n\n### NetBeans ###\n/nbproject/private/\n/nbbuild/\n/dist/\n/nbdist/\n/.nb-gradle/\nbuild/\n\n### VS Code ###\n.vscode/\nAPIJSONORM/bin\n*.DS_Store\n" }, { "path": "APIJSONORM/.gitignore", "content": "/target/\n" }, { "path": "APIJSONORM/README.md", "content": "# APIJSONORM [![](https://jitpack.io/v/Tencent/APIJSON.svg)](https://jitpack.io/#Tencent/APIJSON) [\"Ask](https://deepwiki.com/Tencent/APIJSON)\n腾讯 [APIJSON](https://github.com/Tencent/APIJSON) ORM 库，可通过 Maven, Gradle 等远程依赖。
\nTencent [APIJSON](https://github.com/Tencent/APIJSON) ORM library for remote dependencies with Maven, Gradle, etc.\n\n### Maven\n#### 1. 在 pom.xml 中添加 JitPack 仓库\n#### 1. Add the JitPack repository to pom.xml\n```xml\n\t\n\t\t\n\t\t jitpack.io\n\t\t https://jitpack.io\n\t\t\n\t\n```\n
\n\n#### 2. 在 pom.xml 中添加 APIJSON 依赖\n#### 2. Add the APIJSON dependency to pom.xml\n```xml\n\t\n\t com.github.Tencent\n\t APIJSON\n\t LATEST\n\t\n```\n\n
\n
\n\n### Gradle\n#### 1. 在项目根目录 build.gradle 中最后添加 JitPack 仓库\n#### 1. Add the JitPack repository in your root build.gradle at the end of repositories\n```gradle\n\tallprojects {\n\t\trepositories {\n\t\t\t...\n\t\t\tmaven { url 'https://jitpack.io' }\n\t\t}\n\t}\n```\n
\n\n#### 2. 在项目某个 module 目录(例如 `app`) build.gradle 中添加 apijson-orm 依赖\n#### 2. Add the APIJSON dependency in one of your modules(such as `app`)\n```gradle\n\tdependencies {\n\t implementation 'com.github.Tencent:APIJSON:latest'\n\t}\n```\n\n
\n
\n\n### FASTJSON 2\n#### Code\nhttps://github.com/Tencent/APIJSON/tree/fastjson2\n\n#### Maven\nhttps://mvnrepository.com/artifact/com.github.linushp/zikai-apijson/1.0\n\n
\n\n### Unit Test\nhttp://apijson.cn/unit\n" }, { "path": "APIJSONORM/pom.xml", "content": "\n\n\t4.0.0\n\n\tcom.github.Tencent\n\tAPIJSON\n\t8.1.3\n\tjar\n\n\tAPIJSONORM\n\tAPIJSON ORM Library\n\n\t\n\t\tUTF-8\n\t\tUTF-8\n\t\t1.8\n\t\tUTF-8\n\t\t1.8\n\t\t1.8\n\t\n\n\t\n\t\n\n\t\n\t\t\n\t\t\t\n\t\t\t\torg.apache.maven.plugins\n\t\t\t\tmaven-compiler-plugin\n\t\t\t\t3.12.1\n\t\t\t\t\n\t\t\t\t\t1.8\n\t\t\t\t\t1.8\n\t\t\t\t\n\t\t\t\n\n\t\t\t\n\t\t\t\torg.apache.maven.plugins\n\t\t\t\tmaven-source-plugin\n\t\t\t\t3.2.1\n\t\t\t\t\n\t\t\t\t\t\n\t\t\t\t\t\tpackage\n\t\t\t\t\t\t\n\t\t\t\t\t\t\tjar-no-fork\n\t\t\t\t\t\t\n\t\t\t\t\t\n\t\t\t\t\n\t\t\t\n\t\t\n\t\n\n\n\n" }, { "path": "APIJSONORM/src/main/java/apijson/JSON.java", "content": "/*Copyright (C) 2020 Tencent. All rights reserved.\n\nThis source code is licensed under the Apache License Version 2.0.*/\n\npackage apijson;\n\nimport java.util.Collection;\nimport java.util.LinkedHashMap;\nimport java.util.List;\nimport java.util.Map;\n\n/**JSON工具类 防止解析时异常\n * @author Lemon\n */\npublic class JSON {\n\n\tstatic final String TAG = \"JSON\";\n\n\tpublic static JSONParser, ? extends List> DEFAULT_JSON_PARSER;\n\n\tstatic {\n\t\t//DEFAULT_JSON_PARSER = new JSONParser, List>() {\n\t\t//\n\t\t//\t@Override\n\t\t//\tpublic LinkedHashMap createJSONObject() {\n\t\t//\t\tthrow new UnsupportedOperationException();\n\t\t//\t}\n\t\t//\n\t\t//\t@Override\n\t\t//\tpublic List createJSONArray() {\n\t\t//\t\tthrow new UnsupportedOperationException();\n\t\t//\t}\n\t\t//\n\t\t//\t@Override\n\t\t//\tpublic String toJSONString(Object obj, boolean format) {\n\t\t//\t\tthrow new UnsupportedOperationException();\n\t\t//\t}\n\t\t//\n\t\t//\t@Override\n\t\t//\tpublic Object parse(Object json) {\n\t\t//\t\tthrow new UnsupportedOperationException();\n\t\t//\t}\n\t\t//\n\t\t//\t@Override\n\t\t//\tpublic LinkedHashMap parseObject(Object json) {\n\t\t//\t\tthrow new UnsupportedOperationException();\n\t\t//\t}\n\t\t//\n\t\t//\t@Override\n\t\t//\tpublic T parseObject(Object json, Class clazz) {\n\t\t//\t\tthrow new UnsupportedOperationException();\n\t\t//\t}\n\t\t//\n\t\t//\t@Override\n\t\t//\tpublic List parseArray(Object json) {\n\t\t//\t\tthrow new UnsupportedOperationException();\n\t\t//\t}\n\t\t//\n\t\t//\t@Override\n\t\t//\tpublic List parseArray(Object json, Class clazz) {\n\t\t//\t\tthrow new UnsupportedOperationException();\n\t\t//\t}\n\t\t//\n\t\t//};\n\n\t}\n\n//\tpublic static JSONCreator, ? extends List> DEFAULT_JSON_CREATOR = DEFAULT_JSON_PARSER;\n//\tpublic static > M newObj() {\n//\t\treturn createJSONObject();\n//\t}\n//\tpublic static > M newObj(String key, Object value) {\n//\t\treturn createJSONObject(key, value);\n//\t}\n//\tpublic static > M newObj(Map map) {\n//\t\treturn createJSONObject(map);\n//\t}\n\n\tpublic static > M createJSONObject() {\n\t\treturn (M) DEFAULT_JSON_PARSER.createJSONObject();\n\t}\n\tpublic static > M createJSONObject(String key, Object value) {\n\t\treturn (M) DEFAULT_JSON_PARSER.createJSONObject(key, value);\n\t}\n\tpublic static > M createJSONObject(Map map) {\n\t\treturn (M) DEFAULT_JSON_PARSER.createJSONObject(map);\n\t}\n\n\t//public static > L newArr() {\n\t//\treturn createJSONArray();\n\t//}\n\t//public static > L newArr(Object obj) {\n\t//\treturn createJSONArray(obj);\n\t//}\n\t//public static > L newArr(List list) {\n\t//\treturn createJSONArray(list);\n\t//}\n\n\tpublic static > L createJSONArray() {\n\t\treturn (L) DEFAULT_JSON_PARSER.createJSONArray();\n\t}\n\tpublic static > L createJSONArray(Object obj) {\n\t\treturn (L) DEFAULT_JSON_PARSER.createJSONArray(obj);\n\t}\n\tpublic static > L createJSONArray(Collection list) {\n\t\treturn (L) DEFAULT_JSON_PARSER.createJSONArray(list);\n\t}\n\n\tpublic static Object parse(Object json) {\n\t\treturn DEFAULT_JSON_PARSER.parse(json);\n\t}\n\n\n\tpublic static > M parseObject(Object json) {\n\t\tString s = toJSONString(json);\n\t\tif (StringUtil.isEmpty(s, true)) {\n\t\t\treturn null;\n\t\t}\n\n\t\treturn (M) DEFAULT_JSON_PARSER.parseObject(s);\n\t}\n\n\tpublic static T parseObject(Object json, Class clazz) {\n\t\tString s = toJSONString(json);\n\t\tif (StringUtil.isEmpty(s, true)) {\n\t\t\treturn null;\n\t\t}\n\n\t\treturn DEFAULT_JSON_PARSER.parseObject(s, clazz);\n\t}\n\n\t/**\n\t * @param json\n\t * @return\n\t */\n\tpublic static > L parseArray(Object json) {\n\t\tString s = toJSONString(json);\n\t\tif (StringUtil.isEmpty(s, true)) {\n\t\t\treturn null;\n\t\t}\n\n\t\ttry {\n\t\t\tL arr = (L) DEFAULT_JSON_PARSER.parseArray(s);\n\t\t\treturn arr;\n\t\t} catch (Exception e) {\n\t\t\tLog.i(TAG, \"parseArray catch \\n\" + e.getMessage());\n\t\t}\n\t\treturn null;\n\t}\n\n\tpublic static List parseArray(Object json, Class clazz) {\n\t\tString s = toJSONString(json);\n\t\tif (StringUtil.isEmpty(s, true)) {\n\t\t\treturn null;\n\t\t}\n\n\t\ttry {\n\t\t\treturn DEFAULT_JSON_PARSER.parseArray(s, clazz);\n\t\t} catch (Exception e) {\n\t\t\tLog.i(TAG, \"parseArray catch \\n\" + e.getMessage());\n\t\t}\n\t\treturn null;\n\t}\n\n\t/**\n\t * @param obj\n\t * @return\n\t */\n\tpublic static String format(Object obj) {\n\t\treturn toJSONString(obj, true);\n\t}\n\t/**\n\t * @param obj\n\t * @return\n\t */\n\tpublic static String toJSONString(Object obj) {\n\t\treturn toJSONString(obj, false);\n\t}\n\tpublic static String toJSONString(Object obj, boolean format) {\n\t\tif (obj == null) {\n\t\t\treturn null;\n\t\t}\n\n\t\tif (obj instanceof String) {\n\t\t\treturn (String) obj;\n\t\t}\n\n\t\t//if (obj instanceof Map) {\n\t\t//\t// Simple JSON object format\n\t\t//\tStringBuilder sb = new StringBuilder(\"{\");\n\t\t//\t@SuppressWarnings(\"unchecked\")\n\t\t//\tMap map = (Map) obj;\n\t\t//\tboolean first = true;\n\t\t//\tfor (Map.Entry entry : map.entrySet()) {\n\t\t//\t\tif (! first) {\n\t\t//\t\t\tsb.append(\",\");\n\t\t//\t\t}\n\t\t//\n\t\t//\t\tfirst = false;\n\t\t//\t\tsb.append(\"\\\"\").append(entry.getKey()).append(\"\\\":\");\n\t\t//\t\tObject value = entry.getValue();\n\t\t//\t\tif (value instanceof String) {\n\t\t//\t\t\tsb.append(\"\\\"\").append(value).append(\"\\\"\");\n\t\t//\t\t} else {\n\t\t//\t\t\tsb.append(toJSONString(value));\n\t\t//\t\t}\n\t\t//\t}\n\t\t//\tsb.append(\"}\");\n\t\t//\treturn sb.toString();\n\t\t//}\n\t\t//\n\t\t//if (obj instanceof List) {\n\t\t//\tStringBuilder sb = new StringBuilder(\"[\");\n\t\t//\t@SuppressWarnings(\"unchecked\")\n\t\t//\tList list = (List) obj;\n\t\t//\tboolean first = true;\n\t\t//\tfor (Object item : list) {\n\t\t//\t\tif (! first) {\n\t\t//\t\t\t\tsb.append(\",\");\n\t\t//\t\t}\n\t\t//\t\tfirst = false;\n\t\t//\t\tif (item instanceof String) {\n\t\t//\t\t\tsb.append(\"\\\"\").append(item).append(\"\\\"\");\n\t\t//\t\t} else {\n\t\t//\t\t\tsb.append(toJSONString(item));\n\t\t//\t\t}\n\t\t//\t}\n\t\t//\tsb.append(\"]\");\n\t\t//\treturn sb.toString();\n\t\t//}\n\n\t\treturn DEFAULT_JSON_PARSER.toJSONString(obj, format);\n\t}\n\n\n\t/**判断是否为JSONObject或JSONArray的isXxx方法名\n\t * @param key\n\t * @return\n\t */\n\tpublic static boolean isJSONType(String key) {\n\t\treturn key != null && key.startsWith(\"is\") && key.length() > 2 && key.contains(\"JSON\");\n\t}\n\n\tpublic static boolean isBoolOrNumOrStr(Object obj) {\n\t\treturn obj instanceof Boolean || obj instanceof Number || obj instanceof String;\n\t}\n\n\t/**\n\t * Get a value from a Map and convert to the specified type\n\t * @param map Source map\n\t * @param key The key\n\t * @param Target type\n\t * @return The converted value\n\t */\n\t@SuppressWarnings(\"unchecked\")\n\tpublic static T get(Map map, String key) {\n\t\treturn map == null || key == null ? null : (T) map.get(key);\n\t}\n\n\t/**\n\t * Get a value from a Map and convert to the specified type\n\t * @param map Source map\n\t * @param key The key\n\t * @param Target type\n\t * @return The converted value\n\t */\n\t@SuppressWarnings(\"unchecked\")\n\tpublic static > M getJSONObject(Map map, String key) {\n\t\tObject obj = get(map, key);\n\t\treturn (M) obj;\n\t}\n\n\t/**\n\t * Get a value from a Map and convert to the specified type\n\t * @param map Source map\n\t * @param key The key\n\t * @param Target type\n\t * @return The converted value\n\t */\n\t@SuppressWarnings(\"unchecked\")\n\tpublic static > L getJSONArray(Map map, String key) {\n\t\tObject obj = get(map, key);\n\t\treturn (L) obj;\n\t}\n\n\t/**\n\t * Get a value from a Map and convert to the specified type\n\t * @param list Source map\n\t * @param index The key\n\t * @param Target type\n\t * @return The converted value\n\t */\n\t@SuppressWarnings(\"unchecked\")\n\tpublic static T get(List list, int index) {\n\t\treturn list == null || index < 0 || index >= list.size() ? null : (T) list.get(index);\n\t}\n\n\t@SuppressWarnings(\"unchecked\")\n\tpublic static > M getJSONObject(List list, int index) {\n\t\tObject obj = get(list, index);\n\t\treturn (M) obj;\n\t}\n\n\t@SuppressWarnings(\"unchecked\")\n\tpublic static > L getJSONArray(List list, int index) {\n\t\tObject obj = get(list, index);\n\t\treturn (L) obj;\n\t}\n\n//\t/**\n//\t * Get a value from a Map and convert to the specified type\n//\t * @param map Source map\n//\t * @param key The key\n//\t * @param Target type\n//\t * @return The converted value\n//\t */\n//\t@SuppressWarnings(\"unchecked\")\n//\tpublic static T get(List list, int index) {\n//\t\treturn list == null || index < 0 || index >= list.size() ? null : list.get(index);\n//\t}\n\n\t/**\n\t * Get a Map value from a Map\n\t * @param map Source map\n\t * @param key The key\n\t * @return The Map value\n\t * @throws IllegalArgumentException If value is not a Map and cannot be converted\n\t */\n\t@SuppressWarnings(\"unchecked\")\n\tpublic static Map getMap(Map map, String key) throws IllegalArgumentException {\n\t\tObject value = map == null || key == null ? null : map.get(key);\n\t\tif (value == null) {\n\t\t\treturn null;\n\t\t}\n\n\t\tif (value instanceof Map) {\n\t\t\treturn (Map) value;\n\t\t}\n\n\t\tthrow new IllegalArgumentException(\"Value for key '\" + key + \"' is not a Map: \" + value.getClass().getName());\n\t}\n\n\t/**\n\t * Get a List value from a Map\n\t * @param map Source map\n\t * @param key The key\n\t * @return The List value\n\t * @throws IllegalArgumentException If value is not a List and cannot be converted\n\t */\n\t@SuppressWarnings(\"unchecked\")\n\tpublic static List getList(Map map, String key) throws IllegalArgumentException {\n\t\tObject value = map == null || key == null ? null : map.get(key);\n\t\tif (value == null) {\n\t\t\treturn null;\n\t\t}\n\n\t\tif (value instanceof List) {\n\t\t\treturn (List) value;\n\t\t}\n\n\t\tthrow new IllegalArgumentException(\"Value for key '\" + key + \"' is not a List: \" + value.getClass().getName());\n\t}\n\n\t/**\n\t * Get an int value from a Map\n\t * @param map Source map\n\t * @param key The key\n\t * @return The int value\n\t * @throws IllegalArgumentException If value cannot be converted to int\n\t */\n\tpublic static Integer getInteger(Map map, String key) throws IllegalArgumentException {\n\t\tObject value = map == null || key == null ? null : map.get(key);\n\t\tif (value == null) {\n\t\t\treturn null;\n\t\t}\n\n\t\tif (value instanceof Number) {\n\t\t\treturn ((Number) value).intValue();\n\t\t}\n\n\t\tif (value instanceof String) {\n\t\t\ttry {\n\t\t\t\treturn Integer.parseInt((String) value);\n\t\t\t} catch (NumberFormatException e) {\n\t\t\t\tthrow new IllegalArgumentException(\"Cannot convert String value '\" + value + \"' to int: \" + e.getMessage());\n\t\t\t}\n\t\t}\n\n\t\tthrow new IllegalArgumentException(\"Cannot convert value of type \" + value.getClass().getName() + \" to int\");\n\t}\n\n\t/**\n\t * Get an int value from a Map\n\t * @param map Source map\n\t * @param key The key\n\t * @return The int value\n\t * @throws IllegalArgumentException If value cannot be converted to int\n\t */\n\tpublic static int getIntValue(Map map, String key) throws IllegalArgumentException {\n\t\tObject value = map == null || key == null ? null : map.get(key);\n\t\tif (value == null) {\n\t\t\treturn 0;\n\t\t}\n\n\t\tif (value instanceof Number) {\n\t\t\treturn ((Number) value).intValue();\n\t\t}\n\n\t\tif (value instanceof String) {\n\t\t\ttry {\n\t\t\t\treturn Integer.parseInt((String) value);\n\t\t\t} catch (NumberFormatException e) {\n\t\t\t\tthrow new IllegalArgumentException(\"Cannot convert String value '\" + value + \"' to int: \" + e.getMessage());\n\t\t\t}\n\t\t}\n\n\t\tthrow new IllegalArgumentException(\"Cannot convert value of type \" + value.getClass().getName() + \" to int\");\n\t}\n\n\t/**\n\t * Get an int value from a Map\n\t * @param map Source map\n\t * @param key The key\n\t * @return The int value\n\t * @throws IllegalArgumentException If value cannot be converted to int\n\t */\n\tpublic static Long getLong(Map map, String key) throws IllegalArgumentException {\n\t\tObject value = map == null || key == null ? null : map.get(key);\n\t\tif (value == null) {\n\t\t\treturn null;\n\t\t}\n\n\t\tif (value instanceof Number) {\n\t\t\treturn ((Number) value).longValue();\n\t\t}\n\n\t\tif (value instanceof String) {\n\t\t\ttry {\n\t\t\t\treturn Long.parseLong((String) value);\n\t\t\t} catch (NumberFormatException e) {\n\t\t\t\tthrow new IllegalArgumentException(\"Cannot convert String value '\" + value + \"' to int: \" + e.getMessage());\n\t\t\t}\n\t\t}\n\n\t\tthrow new IllegalArgumentException(\"Cannot convert value of type \" + value.getClass().getName() + \" to int\");\n\t}\n\n\t/**\n\t * Get a long value from a Map\n\t * @param map Source map\n\t * @param key The key\n\t * @return The long value\n\t * @throws IllegalArgumentException If value cannot be converted to long\n\t */\n\tpublic static long getLongValue(Map map, String key) throws IllegalArgumentException {\n\t\tObject value = map == null || key == null ? null : map.get(key);\n\t\tif (value == null) {\n\t\t\treturn 0;\n\t\t}\n\n\t\tif (value instanceof Number) {\n\t\t\treturn ((Number) value).longValue();\n\t\t}\n\n\t\tif (value instanceof String) {\n\t\t\ttry {\n\t\t\t\treturn Long.parseLong((String) value);\n\t\t\t} catch (NumberFormatException e) {\n\t\t\t\tthrow new IllegalArgumentException(\"Cannot convert String value '\" + value + \"' to long: \" + e.getMessage());\n\t\t\t}\n\t\t}\n\n\t\tthrow new IllegalArgumentException(\"Cannot convert value of type \" + value.getClass().getName() + \" to long\");\n\t}\n\n\t/**\n\t * Get a double value from a Map\n\t * @param map Source map\n\t * @param key The key\n\t * @return The double value\n\t * @throws IllegalArgumentException If value cannot be converted to double\n\t */\n\tpublic static Float getFloat(Map map, String key) throws IllegalArgumentException {\n\t\tObject value = map == null || key == null ? null : map.get(key);\n\t\tif (value == null) {\n\t\t\treturn null;\n\t\t}\n\n\t\tif (value instanceof Number) {\n\t\t\treturn ((Number) value).floatValue();\n\t\t}\n\n\t\tif (value instanceof String) {\n\t\t\ttry {\n\t\t\t\treturn Float.parseFloat((String) value);\n\t\t\t} catch (NumberFormatException e) {\n\t\t\t\tthrow new IllegalArgumentException(\"Cannot convert String value '\" + value + \"' to double: \" + e.getMessage());\n\t\t\t}\n\t\t}\n\n\t\tthrow new IllegalArgumentException(\"Cannot convert value of type \" + value.getClass().getName() + \" to double\");\n\t}\n\n\t/**\n\t * Get a double value from a Map\n\t * @param map Source map\n\t * @param key The key\n\t * @return The double value\n\t * @throws IllegalArgumentException If value cannot be converted to double\n\t */\n\tpublic static float getFloatValue(Map map, String key) throws IllegalArgumentException {\n\t\tObject value = map == null || key == null ? null : map.get(key);\n\t\tif (value == null) {\n\t\t\treturn 0;\n\t\t}\n\n\t\tif (value instanceof Number) {\n\t\t\treturn ((Number) value).floatValue();\n\t\t}\n\n\t\tif (value instanceof String) {\n\t\t\ttry {\n\t\t\t\treturn Float.parseFloat((String) value);\n\t\t\t} catch (NumberFormatException e) {\n\t\t\t\tthrow new IllegalArgumentException(\"Cannot convert String value '\" + value + \"' to double: \" + e.getMessage());\n\t\t\t}\n\t\t}\n\n\t\tthrow new IllegalArgumentException(\"Cannot convert value of type \" + value.getClass().getName() + \" to double\");\n\t}\n\n\n\t/**\n\t * Get a double value from a Map\n\t * @param map Source map\n\t * @param key The key\n\t * @return The double value\n\t * @throws IllegalArgumentException If value cannot be converted to double\n\t */\n\tpublic static Double getDouble(Map map, String key) throws IllegalArgumentException {\n\t\tObject value = map == null || key == null ? null : map.get(key);\n\t\tif (value == null) {\n\t\t\treturn null;\n\t\t}\n\n\t\tif (value instanceof Number) {\n\t\t\treturn ((Number) value).doubleValue();\n\t\t}\n\n\t\tif (value instanceof String) {\n\t\t\ttry {\n\t\t\t\treturn Double.parseDouble((String) value);\n\t\t\t} catch (NumberFormatException e) {\n\t\t\t\tthrow new IllegalArgumentException(\"Cannot convert String value '\" + value + \"' to double: \" + e.getMessage());\n\t\t\t}\n\t\t}\n\n\t\tthrow new IllegalArgumentException(\"Cannot convert value of type \" + value.getClass().getName() + \" to double\");\n\t}\n\n\t/**\n\t * Get a double value from a Map\n\t * @param map Source map\n\t * @param key The key\n\t * @return The double value\n\t * @throws IllegalArgumentException If value cannot be converted to double\n\t */\n\tpublic static double getDoubleValue(Map map, String key) throws IllegalArgumentException {\n\t\tObject value = map == null || key == null ? null : map.get(key);\n\t\tif (value == null) {\n\t\t\treturn 0;\n\t\t}\n\n\t\tif (value instanceof Number) {\n\t\t\treturn ((Number) value).doubleValue();\n\t\t}\n\n\t\tif (value instanceof String) {\n\t\t\ttry {\n\t\t\t\treturn Double.parseDouble((String) value);\n\t\t\t} catch (NumberFormatException e) {\n\t\t\t\tthrow new IllegalArgumentException(\"Cannot convert String value '\" + value + \"' to double: \" + e.getMessage());\n\t\t\t}\n\t\t}\n\n\t\tthrow new IllegalArgumentException(\"Cannot convert value of type \" + value.getClass().getName() + \" to double\");\n\t}\n\n\n\t/**\n\t * Get a boolean value from a Map\n\t * @param map Source map\n\t * @param key The key\n\t * @return The boolean value\n\t * @throws IllegalArgumentException If value cannot be converted to boolean\n\t */\n\tpublic static Boolean getBoolean(Map map, String key) throws IllegalArgumentException {\n\t\tObject value = map == null || key == null ? null : map.get(key);\n\t\tif (value == null) {\n\t\t\treturn null;\n\t\t}\n\n\t\tif (value instanceof Boolean) {\n\t\t\treturn (Boolean) value;\n\t\t}\n\n\t\tif (value instanceof String) {\n\t\t\tString str = ((String) value).toLowerCase();\n\t\t\tif (str.equals(\"true\") || str.equals(\"false\")) {\n\t\t\t\treturn Boolean.parseBoolean(str);\n\t\t\t}\n\t\t\tthrow new IllegalArgumentException(\"Cannot convert String value '\" + value + \"' to boolean\");\n\t\t}\n\n\t\tif (value instanceof Number) {\n\t\t\tint intValue = ((Number) value).intValue();\n\t\t\tif (intValue == 0 || intValue == 1) {\n\t\t\t\treturn intValue != 0;\n\t\t\t}\n\t\t\tthrow new IllegalArgumentException(\"Cannot convert Number value '\" + value + \"' to boolean. Only 0 and 1 are supported.\");\n\t\t}\n\n\t\tthrow new IllegalArgumentException(\"Cannot convert value of type \" + value.getClass().getName() + \" to boolean\");\n\t}\n\n\t/**\n\t * Get a boolean value from a Map\n\t * @param map Source map\n\t * @param key The key\n\t * @return The boolean value\n\t * @throws IllegalArgumentException If value cannot be converted to boolean\n\t */\n\tpublic static boolean getBooleanValue(Map map, String key) throws IllegalArgumentException {\n\t\tObject value = map == null || key == null ? null : map.get(key);\n\t\tif (value == null) {\n\t\t\treturn false;\n\t\t}\n\n\t\tif (value instanceof Boolean) {\n\t\t\treturn (Boolean) value;\n\t\t}\n\n\t\tif (value instanceof String) {\n\t\t\tString str = ((String) value).toLowerCase();\n\t\t\tif (str.equals(\"true\") || str.equals(\"false\")) {\n\t\t\t\treturn Boolean.parseBoolean(str);\n\t\t\t}\n\t\t\tthrow new IllegalArgumentException(\"Cannot convert String value '\" + value + \"' to boolean\");\n\t\t}\n\n\t\tif (value instanceof Number) {\n\t\t\tint intValue = ((Number) value).intValue();\n\t\t\tif (intValue == 0 || intValue == 1) {\n\t\t\t\treturn intValue != 0;\n\t\t\t}\n\t\t\tthrow new IllegalArgumentException(\"Cannot convert Number value '\" + value + \"' to boolean. Only 0 and 1 are supported.\");\n\t\t}\n\n\t\tthrow new IllegalArgumentException(\"Cannot convert value of type \" + value.getClass().getName() + \" to boolean\");\n\t}\n\n\t/**\n\t * Get a string value from a Map\n\t * @param map Source map\n\t * @param key The key\n\t * @return The string value\n\t */\n\tpublic static String getString(Map map, String key) {\n\t\tObject value = map == null || key == null ? null : map.get(key);\n\t\tif (value == null) {\n\t\t\treturn null;\n\t\t}\n\n\t\treturn value.toString();\n\t}\n\n\n\tpublic static Object getFromObjOrArr(Object parent, String k) {\n\t\tif (parent instanceof Map) {\n\t\t\treturn ((Map) parent).get(k);\n\t\t}\n\n\t\tif (parent instanceof List) {\n\t\t\tint j = Integer.valueOf(k);\n\t\t\treturn ((List) parent).get(j);\n\t\t}\n\n\t\treturn null;\n\t}\n\n}\n" }, { "path": "APIJSONORM/src/main/java/apijson/JSONCreator.java", "content": "/*Copyright (C) 2020 Tencent. All rights reserved.\n\nThis source code is licensed under the Apache License Version 2.0.*/\n\n\npackage apijson;\n\nimport java.util.Collection;\nimport java.util.List;\nimport java.util.Map;\n\n/**JSON相关创建器\n * @author Lemon\n */\npublic interface JSONCreator, L extends List> {\n\t\n\t@NotNull\n M createJSONObject();\n\n @NotNull\n default M createJSONObject(String key, Object value) {\n M obj = createJSONObject();\n obj.put(key, value);\n return obj;\n }\n\n @NotNull\n default M createJSONObject(Map map) {\n M obj = createJSONObject();\n if (map != null && ! map.isEmpty()) {\n obj.putAll(map);\n }\n return obj;\n }\n\n\t@NotNull\n L createJSONArray();\n\n @NotNull\n default L createJSONArray(Object obj){\n L arr = createJSONArray();\n arr.add(obj);\n return arr;\n }\n\n @NotNull\n default L createJSONArray(Collection list){\n L arr = createJSONArray();\n if (list != null && ! list.isEmpty()) {\n arr.addAll(list);\n }\n return arr;\n }\n}\n" }, { "path": "APIJSONORM/src/main/java/apijson/JSONList.java", "content": "/*Copyright (C) 2020 Tencent. All rights reserved.\n\nThis source code is licensed under the Apache License Version 2.0.*/\n\npackage apijson;\n\nimport java.util.*;\n\n/**\n * Custom JSONList implementation based on ArrayList to replace com.alibaba.fastjson.JSONList\n * Maintains same API as fastjson but uses standard Java List implementation\n * @author Lemon\n */\npublic interface JSONList, L extends List> extends List {\n public static final String TAG = \"JSONList\";\n\n ///**\n // * Create an empty JSONList\n // */\n //default JSONList() {\n // super();\n //}\n //\n //private int initialCapacity = 10;\n ///**\n // * Create a JSONList with initial capacity\n // * @param initialCapacity the initial capacity\n // */\n //default JSONList(int initialCapacity) {\n // super(initialCapacity);\n //}\n //\n ///**\n // * Create a JSONList from a Collection\n // * @param collection the collection to copy from\n // */\n //default JSONList(Collection collection) {\n // super(collection);\n //}\n //\n ///**\n // * Create a JSONList from a JSON string\n // * @param json JSON string\n // */\n //default JSONList(String json) {\n // this();\n // List list = JSON.parseArray(json);\n // if (list != null) {\n // addAll(list);\n // }\n //}\n //\n /**\n * Get a JSONMap at the specified index\n * @param index the index\n * @return the JSONMap or null if not a JSONMap\n */\n default M getJSONObject(int index) {\n if (index < 0 || index >= size()) {\n return null;\n }\n \n Object obj = get(index);\n if (obj instanceof Map) {\n return JSON.createJSONObject((Map) obj);\n }\n\n return null;\n }\n \n /**\n * Get a JSONList at the specified index\n * @param index the index\n * @return the JSONList or null if not a JSONList\n */\n default L getJSONArray(int index) {\n if (index < 0 || index >= size()) {\n return null;\n }\n \n Object obj = get(index);\n if (obj instanceof List) {\n return JSON.createJSONArray((List) obj);\n }\n\n return null;\n }\n \n /**\n * Get a boolean value at the specified index\n * @param index the index\n * @return the boolean value or false if not found\n */\n default boolean getBooleanValue(int index) {\n if (index < 0 || index >= size()) {\n return false;\n }\n \n Object obj = get(index);\n if (obj instanceof Boolean) {\n return (Boolean) obj;\n } else if (obj instanceof Number) {\n return ((Number) obj).intValue() != 0;\n } else if (obj instanceof String) {\n return Boolean.parseBoolean((String) obj);\n }\n\n return false;\n }\n \n /**\n * Get an integer value at the specified index\n * @param index the index\n * @return the integer value or 0 if not found\n */\n default int getIntValue(int index) {\n if (index < 0 || index >= size()) {\n return 0;\n }\n \n Object obj = get(index);\n if (obj instanceof Number) {\n return ((Number) obj).intValue();\n } else if (obj instanceof String) {\n try {\n return Integer.parseInt((String) obj);\n } catch (NumberFormatException e) {\n // Ignore\n }\n }\n return 0;\n }\n \n /**\n * Get a long value at the specified index\n * @param index the index\n * @return the long value or 0 if not found\n */\n default long getLongValue(int index) {\n if (index < 0 || index >= size()) {\n return 0L;\n }\n \n Object obj = get(index);\n if (obj instanceof Number) {\n return ((Number) obj).longValue();\n } else if (obj instanceof String) {\n try {\n return Long.parseLong((String) obj);\n } catch (NumberFormatException e) {\n // Ignore\n }\n }\n return 0L;\n }\n \n /**\n * Get a double value at the specified index\n * @param index the index\n * @return the double value or 0 if not found\n */\n default double getDoubleValue(int index) {\n if (index < 0 || index >= size()) {\n return 0.0;\n }\n \n Object obj = get(index);\n if (obj instanceof Number) {\n return ((Number) obj).doubleValue();\n } else if (obj instanceof String) {\n try {\n return Double.parseDouble((String) obj);\n } catch (NumberFormatException e) {\n // Ignore\n }\n }\n return 0.0;\n }\n \n /**\n * Get a string value at the specified index\n * @param index the index\n * @return the string value or null if not found\n */\n default String getString(int index) {\n if (index < 0 || index >= size()) {\n return null;\n }\n \n Object obj = get(index);\n return obj != null ? obj.toString() : null;\n }\n\n \n default String toJSONString() {\n return JSON.toJSONString(this);\n }\n\n //@Override\n //default boolean containsAll(Collection c) {\n // if (c == null || c.isEmpty()) {\n // return true;\n // }\n // return super.containsAll(c);\n //}\n //\n //@Override\n //default boolean addAll(Collection c) {\n // if (c == null || c.isEmpty()) {\n // return true;\n // }\n // return super.addAll(c);\n //}\n //\n //@Override\n //default boolean addAll(int index, Collection c) {\n // if (c == null || c.isEmpty()) {\n // return true;\n // }\n //\n // int sz = size();\n // if (index < 0 || index >= sz) {\n // index += sz;\n // }\n //\n // return super.addAll(index, c);\n //}\n //\n //@Override\n //default boolean removeAll(Collection c) {\n // if (c == null || c.isEmpty()) {\n // return true;\n // }\n // return super.removeAll(c);\n //}\n //\n //@Override\n //default boolean retainAll(Collection c) {\n // if (c == null || c.isEmpty()) {\n // return true;\n // }\n // return super.retainAll(c);\n //}\n //\n //\n //@Override\n //default Object get(int index) {\n // int sz = size();\n // if (index < 0 || index >= sz) {\n // index += sz;\n // }\n //\n // return super.get(index);\n //}\n //\n //@Override\n //default Object set(int index, Object element) {\n // int sz = size();\n // if (index < 0 || index >= sz) {\n // index += sz;\n // }\n //\n // return super.set(index, element);\n //}\n //\n //@Override\n //default void add(int index, Object element) {\n // int sz = size();\n // if (index < 0 || index >= sz) {\n // index += sz;\n // }\n //\n // super.add(index, element);\n //}\n //\n //@Override\n //default Object remove(int index) {\n // int sz = size();\n // if (index < 0 && index >= -sz) {\n // index += sz;\n // }\n // if (index < 0 || index >= sz) {\n // return null;\n // }\n //\n // return super.remove(index);\n //}\n //\n //@Override\n //default ListIterator listIterator(int index) {\n // int sz = size();\n // if (index < 0 && index >= -sz) {\n // index += sz;\n // }\n //\n // return super.listIterator(index);\n //}\n //\n //@Override\n //default List subList(int fromIndex, int toIndex) {\n // int sz = size();\n // if (fromIndex < 0 && fromIndex >= -sz) {\n // fromIndex += sz;\n // }\n // if (toIndex < 0 && toIndex >= -sz) {\n // toIndex += sz;\n // }\n //\n // return super.subList(fromIndex, toIndex);\n //}\n\n}" }, { "path": "APIJSONORM/src/main/java/apijson/JSONMap.java", "content": "/*Copyright (C) 2020 Tencent. All rights reserved.\n\nThis source code is licensed under the Apache License Version 2.0.*/\n\n\npackage apijson;\n\nimport java.util.*;\n\n\n/**use this class instead of com.alibaba.fastjson.JSONMap\n * @author Lemon\n * @see #put\n * @see #puts\n * @see #putsAll\n */\n//default class JSONMap extends LinkedHashMap {\npublic interface JSONMap, L extends List> extends Map {\n\tstatic final String TAG = \"JSONMap\";\n\n\t// 只能是 static public Map map = new LinkedHashMap<>();\n\n\t///**ordered\n\t// */\n\t//default JSONMap() {\n\t//\tsuper();\n\t//}\n\t///**transfer Object to JSONMap\n\t// * @param object\n\t// * @see {@link #JSONMap(Object)}\n\t// */\n\t//default JSONMap(Object object) {\n\t//\tthis();\n\t//\tif (object instanceof Map) {\n\t//\t\t@SuppressWarnings(\"unchecked\")\n\t//\t\tMap map = (Map) object;\n\t//\t\tputAll(map);\n\t//\t} else if (object != null) {\n\t//\t\tString json = JSON.toJSONString(object);\n\t//\t\tif (json != null) {\n\t//\t\t\tMap map = JSON.parseObject(json);\n\t//\t\t\tif (map != null) {\n\t//\t\t\t\tputAll(map);\n\t//\t\t\t}\n\t//\t\t}\n\t//\t}\n\t//}\n\t///**parse JSONMap with JSON String\n\t// * @param json\n\t// * @see {@link #JSONMap(String)}\n\t// */\n\t//default JSONMap(String json) {\n\t//\tthis();\n\t//\tMap map = JSON.parseObject(json);\n\t//\tif (map != null) {\n\t//\t\tputAll(map);\n\t//\t}\n\t//}\n\t///**transfer com.alibaba.fastjson.JSONMap to JSONMap\n\t// * @param object\n\t// * @see {@link #putsAll(Map)}\n\t// */\n\t//default JSONMap(Map object) {\n\t//\tthis();\n\t//\tputsAll(object);\n\t//}\n\n\t//public static JSONMap valueOf(Object obj) {\n\t//\tJSONMap req = new JSONMap() {};\n\t//\tMap m = JSON.parseObject(obj);\n\t//\tif (m != null && ! m.isEmpty()) {\n\t//\t\treq.map.putAll(m);\n\t//\t}\n\t//\treturn req;\n\t//}\n\n\t//judge <<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<\n\tString KEY_ARRAY = \"[]\";\n\n\t/**判断是否为Array的key\n\t * @param key\n\t * @return\n\t */\n\tpublic static boolean isArrayKey(String key) {\n\t\treturn key != null && key.endsWith(KEY_ARRAY);\n\t}\n\t/**判断是否为对应Table的key\n\t * @param key\n\t * @return\n\t */\n\tpublic static boolean isTableKey(String key) {\n\t\treturn StringUtil.isBigName(key);\n\t}\n\t/**判断是否为对应Table数组的 key\n\t * @param key\n\t * @return\n\t */\n\tpublic static boolean isTableArray(String key) {\n\t\treturn isArrayKey(key) && isTableKey(key.substring(0, key.length() - KEY_ARRAY.length()));\n\t}\n\t//judge >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>\n\n\n\t//JSONObject内关键词 key <<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<\n\n\n\tpublic static String KEY_ID = \"id\";\n\tpublic static String KEY_ID_IN = KEY_ID + \"{}\";\n\tpublic static String KEY_USER_ID = \"userId\";\n\tpublic static String KEY_USER_ID_IN = KEY_USER_ID + \"{}\";\n\n\tdefault String getIdKey() {\n\t\treturn KEY_ID;\n\t}\n\tdefault String getIdInKey() {\n\t\treturn KEY_ID_IN;\n\t}\n\tdefault String getUserIdKey() {\n\t\treturn KEY_USER_ID;\n\t}\n\tdefault String getUserIdInKey() {\n\t\treturn KEY_USER_ID_IN;\n\t}\n\n\t/**set \"id\":id in Table layer\n\t * @param id\n\t * @return\n\t */\n\tdefault JSONMap setId(Long id) {\n\t\treturn puts(getIdKey(), id);\n\t}\n\t/**set \"id{}\":[] in Table layer\n\t * @param list\n\t * @return\n\t */\n\tdefault JSONMap setIdIn(List list) {\n\t\treturn puts(getIdInKey(), list);\n\t}\n\n\t/**set \"userId\":userId in Table layer\n\t * @param id\n\t * @return\n\t */\n\tdefault JSONMap setUserId(Long id) {\n\t\treturn puts(getUserIdKey(), id);\n\t}\n\t/**set \"userId{}\":[] in Table layer\n\t * @param list\n\t * @return\n\t */\n\tdefault JSONMap setUserIdIn(List list) {\n\t\treturn puts(getUserIdInKey(), list);\n\t}\n\n\n\tint CACHE_ALL = 0;\n\tint CACHE_ROM = 1;\n\tint CACHE_RAM = 2;\n\n\tString CACHE_ALL_STRING = \"ALL\";\n\tString CACHE_ROM_STRING = \"ROM\";\n\tString CACHE_RAM_STRING = \"RAM\";\n\n\n\t//@key关键字都放这个类 <<<<<<<<<<<<<<<<<<<<<<\n\tString KEY_TRY = \"@try\"; // 尝试，忽略异常\n\tString KEY_CATCH = \"@catch\"; // TODO 捕捉到异常后，处理方式 null-不处理；DEFAULT-返回默认值；ORIGIN-返回请求里的原始值\n\tString KEY_DROP = \"@drop\"; // 丢弃，不返回，TODO 应该通过 fastjson 的 ignore 之类的机制来处理，避免导致下面的对象也不返回\n\t//\tString KEY_KEEP = \"@keep\"; // 一定会返回，为 null 或 空对象时，会使用默认值(非空)，解决其它对象因为不关联的第一个对为空导致也不返回\n\tString KEY_DEFAULT = \"@default\"; // TODO 自定义默认值 { \"@default\":true }，@default 可完全替代 @keep\n\tString KEY_NULL = \"@null\"; // 值为 null 的键值对 \"@null\":\"tag,pictureList\"，允许 is NULL 条件判断， SET tag = NULL 修改值为 NULL 等\n\tString KEY_CAST = \"@cast\"; // 类型转换 cast(date AS DATE)\n\n\tString KEY_ROLE = \"@role\"; // 角色，拥有对某些数据的某些操作的权限\n\tString KEY_DATABASE = \"@database\"; // 数据库类型，默认为MySQL\n\tString KEY_DATASOURCE = \"@datasource\"; // 数据源\n\tString KEY_NAMESPACE = \"@namespace\"; // 命名空间，Table 在非默认 namespace 内时需要声明\n\tString KEY_CATALOG = \"@catalog\"; // 目录，Table 在非默认 catalog 内时需要声明\n\tString KEY_SCHEMA = \"@schema\"; // 数据库，Table 在非默认 schema 内时需要声明\n\tString KEY_EXPLAIN = \"@explain\"; // 分析 true/false\n\tString KEY_CACHE = \"@cache\"; // 缓存 RAM/ROM/ALL\n\tString KEY_COLUMN = \"@column\"; // 查询的 Table 字段或 SQL 函数\n\tString KEY_FROM = \"@from\"; // FROM语句\n\tString KEY_COMBINE = \"@combine\"; // 条件组合，每个条件 key 前面可以放 &,|,! 逻辑关系 \"id!{},&sex,!name&$\"\n\tString KEY_GROUP = \"@group\"; // 分组方式\n\tString KEY_HAVING = \"@having\"; // 聚合函数条件，一般和 @group 一起用\n\tString KEY_HAVING_AND = \"@having&\"; // 聚合函数条件，一般和 @group 一起用\n\tString KEY_SAMPLE = \"@sample\"; // 取样方式\n\tString KEY_LATEST = \"@latest\"; // 最近方式\n\tString KEY_PARTITION = \"@partition\"; // 分区方式\n\tString KEY_FILL = \"@fill\"; // 填充方式\n\tString KEY_ORDER = \"@order\"; // 排序方式\n\tString KEY_KEY = \"@key\"; // key 映射，year:left(date,4);name_tag:(name,tag)\n\tString KEY_RAW = \"@raw\"; // 自定义原始 SQL 片段\n\tString KEY_JSON = \"@json\"; // 把字段转为 JSON 输出\n\tString KEY_STRING = \"@string\"; // 把字段转为 String 输入\n\tString KEY_TRIM = \"@trim\"; // 去除首位空格等空白字符\n\tString KEY_METHOD = \"@method\"; // json 对象配置操作方法\n\tString KEY_GET = \"@get\"; // json 对象配置操作方法\n\tString KEY_GETS = \"@gets\"; // json 对象配置操作方法\n\tString KEY_HEAD = \"@head\"; // json 对象配置操作方法\n\tString KEY_HEADS = \"@heads\"; // json 对象配置操作方法\n\tString KEY_POST = \"@post\"; // json 对象配置操作方法\n\tString KEY_PUT = \"@put\"; // json 对象配置操作方法\n\tString KEY_DELETE = \"@delete\"; // json 对象配置操作方法\n\n\tList TABLE_KEY_LIST = new ArrayList<>(Arrays.asList(\n\t\t\tKEY_ROLE, \n\t\t\tKEY_DATABASE, \n\t\t\tKEY_DATASOURCE,\n\t\t\tKEY_NAMESPACE,\n\t\t\tKEY_CATALOG,\n\t\t\tKEY_SCHEMA,\n\t\t\tKEY_EXPLAIN,\n\t\t\tKEY_CACHE,\n\t\t\tKEY_COLUMN,\n\t\t\tKEY_FROM,\n\t\t\tKEY_NULL,\n\t\t\tKEY_CAST,\n\t\t\tKEY_COMBINE,\n\t\t\tKEY_GROUP,\n\t\t\tKEY_HAVING,\n\t\t\tKEY_HAVING_AND,\n\t\t\tKEY_SAMPLE,\n\t\t\tKEY_LATEST,\n\t\t\tKEY_PARTITION,\n\t\t\tKEY_FILL,\n\t\t\tKEY_ORDER,\n\t\t\tKEY_KEY,\n\t\t\tKEY_RAW,\n\t\t\tKEY_JSON,\n\t\t\tKEY_STRING,\n\t\t\tKEY_TRIM,\n\t\t\tKEY_METHOD,\n\t\t\tKEY_GET,\n\t\t\tKEY_GETS,\n\t\t\tKEY_HEAD,\n\t\t\tKEY_HEADS,\n\t\t\tKEY_POST,\n\t\t\tKEY_PUT,\n\t\t\tKEY_DELETE\n\t));\n\n\t//@key关键字都放这个类 >>>>>>>>>>>>>>>>>>>>>>\n\n\n\t/**set try, ignore exceptions\n\t * @param tri\n\t * @return this\n\t */\n\tdefault JSONMap setTry(Boolean tri) {\n\t\treturn puts(KEY_TRY, tri);\n\t}\n\n\t/**set catch\n\t * @param isCatch\n\t * @return this\n\t */\n\tdefault JSONMap setCatch(String isCatch) {\n\t\treturn puts(KEY_CATCH, isCatch);\n\t}\n\t/**set drop, data dropped will not return\n\t * @param drop\n\t * @return this\n\t */\n\tdefault JSONMap setDrop(Boolean drop) {\n\t\treturn puts(KEY_DROP, drop);\n\t}\n\n\t/**set if has default\n\t * @param hasDefault\n\t * @return this\n\t */\n\tdefault JSONMap setDefault(Boolean hasDefault) {\n\t\treturn puts(KEY_DEFAULT, hasDefault);\n\t}\n\n\n\t/**set role of request sender\n\t * @param role\n\t * @return this\n\t */\n\tdefault JSONMap setRole(String role) {\n\t\treturn puts(KEY_ROLE, role);\n\t}\n\t/**set database where table was puts\n\t * @param database\n\t * @return this\n\t */\n\tdefault JSONMap setDatabase(String database) {\n\t\treturn puts(KEY_DATABASE, database);\n\t}\n\t/**set datasource where table was puts\n\t * @param datasource\n\t * @return this\n\t */\n\tdefault JSONMap setDatasource(String datasource) {\n\t\treturn puts(KEY_DATASOURCE, datasource);\n\t}\n\t/**set namespace where table was puts\n\t * @param namespace\n\t * @return this\n\t */\n\tdefault JSONMap setNamespace(String namespace) {\n\t\treturn puts(KEY_NAMESPACE, namespace);\n\t}\n\t/**set catalog where table was puts\n\t * @param catalog\n\t * @return this\n\t */\n\tdefault JSONMap setCatalog(String catalog) {\n\t\treturn puts(KEY_CATALOG, catalog);\n\t}\n\t/**set schema where table was puts\n\t * @param schema\n\t * @return this\n\t */\n\tdefault JSONMap setSchema(String schema) {\n\t\treturn puts(KEY_SCHEMA, schema);\n\t}\n\t/**set if return explain informations\n\t * @param explain\n\t * @return\n\t */\n\tdefault JSONMap setExplain(Boolean explain) {\n\t\treturn puts(KEY_EXPLAIN, explain);\n\t}\n\t/**set cache type\n\t * @param cache\n\t * @return\n\t * @see {@link #CACHE_ALL}\n\t * @see {@link #CACHE_RAM}\n\t * @see {@link #CACHE_ROM}\n\t */\n\tdefault JSONMap setCache(Integer cache) {\n\t\treturn puts(KEY_CACHE, cache);\n\t}\n\t/**set cache type\n\t * @param cache\n\t * @return\n\t * @see {@link #CACHE_ALL_STRING}\n\t * @see {@link #CACHE_RAM_STRING}\n\t * @see {@link #CACHE_ROM_STRING}\n\t */\n\tdefault JSONMap setCache(String cache) {\n\t\treturn puts(KEY_CACHE, cache);\n\t}\n\n\t/**set keys need to be returned\n\t * @param keys key0, key1, key2 ...\n\t * @return {@link #setColumn(String)}\n\t */\n\tdefault JSONMap setColumn(String... keys) {\n\t\treturn setColumn(StringUtil.get(keys, true));\n\t}\n\t/**set keys need to be returned\n\t * @param keys \"key0,key1,key2...\"\n\t * @return\n\t */\n\tdefault JSONMap setColumn(String keys) {\n\t\treturn puts(KEY_COLUMN, keys);\n\t}\n\n\t/**set keys whose value is null\n\t * @param keys key0, key1, key2 ...\n\t * @return {@link #setNull(String)}\n\t */\n\tdefault JSONMap setNull(String... keys) {\n\t\treturn setNull(StringUtil.get(keys, true));\n\t}\n\t/**set keys whose value is null\n\t * @param keys \"key0,key1,key2...\"\n\t * @return\n\t */\n\tdefault JSONMap setNull(String keys) {\n\t\treturn puts(KEY_NULL, keys);\n\t}\n\t\n\t/**set keys and types whose value should be cast to type, cast(value AS DATE)\n\t * @param keyTypes key0:type0, key1:type1, key2:type2 ...\n\t * @return {@link #setCast(String)}\n\t */\n\tdefault JSONMap setCast(String... keyTypes) {\n\t\treturn setCast(StringUtil.get(keyTypes, true));\n\t}\n\t/**set keys and types whose value should be cast to type, cast(value AS DATE)\n\t * @param keyTypes \"key0:type0,key1:type1,key2:type2...\"\n\t * @return\n\t */\n\tdefault JSONMap setCast(String keyTypes) {\n\t\treturn puts(KEY_CAST, keyTypes);\n\t}\n\n\t/**set combination of keys for conditions\n\t * @param keys key0,&key1,|key2,!key3 ... TODO or key0> | (key1{} & !key2)...\n\t * @return {@link #setColumn(String)}\n\t */\n\tdefault JSONMap setCombine(String... keys) {\n\t\treturn setCombine(StringUtil.get(keys, true));\n\t}\n\t/**set combination of keys for conditions\n\t * @param keys key0,&key1,|key2,!key3 ... TODO or key0> | (key1{} & !key2)...\n\t * @return\n\t */\n\tdefault JSONMap setCombine(String keys) {\n\t\treturn puts(KEY_COMBINE, keys);\n\t}\n\n\t/**set keys for group by\n\t * @param keys key0, key1, key2 ...\n\t * @return {@link #setGroup(String)}\n\t */\n\tdefault JSONMap setGroup(String... keys) {\n\t\treturn setGroup(StringUtil.get(keys, true));\n\t}\n\t/**set keys for group by\n\t * @param keys \"key0,key1,key2...\"\n\t * @return\n\t */\n\tdefault JSONMap setGroup(String keys) {\n\t\treturn puts(KEY_GROUP, keys);\n\t}\n\n\t/**set keys for having\n\t * @param keys count(key0) > 1, sum(key1) <= 5, function2(key2) ? value2 ...\n\t * @return {@link #setHaving(String)}\n\t */\n\tdefault JSONMap setHaving(String... keys) {\n\t\treturn setHaving(StringUtil.get(keys, true));\n\t}\n\t/**set keys for having\n\t * @param keys \"key0,key1,key2...\"\n\t * @return\n\t */\n\tdefault JSONMap setHaving(String keys) {\n\t\treturn setHaving(keys, false);\n\t}\n\t/**set keys for having\n\t * @param keys \"key0,key1,key2...\"\n\t * @return\n\t */\n\tdefault JSONMap setHaving(String keys, boolean isAnd) {\n\t\treturn puts(isAnd ? KEY_HAVING_AND : KEY_HAVING, keys);\n\t}\n\n\t/**set keys for sample by\n\t * @param keys key0, key1, key2 ...\n\t * @return {@link #setSample(String)}\n\t */\n\tdefault JSONMap setSample(String... keys) {\n\t\treturn setSample(StringUtil.get(keys, true));\n\t}\n\t/**set keys for sample by\n\t * @param keys \"key0,key1,key2...\"\n\t * @return\n\t */\n\tdefault JSONMap setSample(String keys) {\n\t\treturn puts(KEY_SAMPLE, keys);\n\t}\n\n\t/**set keys for latest on\n\t * @param keys key0, key1, key2 ...\n\t * @return {@link #setLatest(String)}\n\t */\n\tdefault JSONMap setLatest(String... keys) {\n\t\treturn setLatest(StringUtil.get(keys, true));\n\t}\n\t/**set keys for latest on\n\t * @param keys \"key0,key1,key2...\"\n\t * @return\n\t */\n\tdefault JSONMap setLatest(String keys) {\n\t\treturn puts(KEY_LATEST, keys);\n\t}\n\n\t/**set keys for partition by\n\t * @param keys key0, key1, key2 ...\n\t * @return {@link #setPartition(String)}\n\t */\n\tdefault JSONMap setPartition(String... keys) {\n\t\treturn setPartition(StringUtil.get(keys, true));\n\t}\n\t/**set keys for partition by\n\t * @param keys key0, key1, key2 ...\n\t * @return\n\t */\n\tdefault JSONMap setPartition(String keys) {\n\t\treturn puts(KEY_PARTITION, keys);\n\t}\n\n\t/**set keys for fill(key): fill(null), fill(linear), fill(prev)\n\t * @param keys key0, key1, key2 ...\n\t * @return {@link #setFill(String)}\n\t */\n\tdefault JSONMap setFill(String... keys) {\n\t\treturn setFill(StringUtil.get(keys, true));\n\t}\n\t/**set keys for fill(key): fill(null), fill(linear), fill(prev)\n\t * @param keys key0, key1, key2 ...\n\t * @return\n\t */\n\tdefault JSONMap setFill(String keys) {\n\t\treturn puts(KEY_FILL, keys);\n\t}\n\n\t/**set keys for order by\n\t * @param keys key0, key1+, key2- ...\n\t * @return {@link #setOrder(String)}\n\t */\n\tdefault JSONMap setOrder(String... keys) {\n\t\treturn setOrder(StringUtil.get(keys, true));\n\t}\n\t/**set keys for order by\n\t * @param keys \"key0,key1+,key2-...\"\n\t * @return\n\t */\n\tdefault JSONMap setOrder(String keys) {\n\t\treturn puts(KEY_ORDER, keys);\n\t}\n\n\t/**set key map\n\t * @param keyMap \"name_tag:(name,tag);year:left(date,1,5)...\"\n\t * @return\n\t */\n\tdefault JSONMap setKey(String keyMap) {\n\t\treturn puts(KEY_KEY, keyMap);\n\t}\n\n\t/**set keys to raw\n\t * @param keys \"key0,key1,key2...\"\n\t * @return\n\t */\n\tdefault JSONMap setRaw(String keys) {\n\t\treturn puts(KEY_RAW, keys);\n\t}\n\n\t/**set keys to cast to json\n\t * @param keys \"key0,key1,key2...\"\n\t * @return\n\t */\n\tdefault JSONMap setJson(String keys) {\n\t\treturn puts(KEY_JSON, keys);\n\t}\n\n\t/**set keys to cast to string\n\t * @param keys \"key0,key1,key2...\"\n\t * @return\n\t */\n\tdefault JSONMap setString(String keys) {\n\t\treturn puts(KEY_STRING, keys);\n\t}\n\n\t/**set keys to cast to string\n\t * @param keys \"key0,key1,key2...\"\n\t * @return\n\t */\n\tdefault JSONMap setTrim(String keys) {\n\t\treturn puts(KEY_TRIM, keys);\n\t}\n\n\t//JSONObject内关键词 key >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>\n\n\n\n\t//Request <<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<\n\n\n\t/**\n\t * @param key\n\t * @param keys path = keys[0] + \"/\" + keys[1] + \"/\" + keys[2] + ...\n\t * @return {@link #puts(String, Object)}\n\t */\n\tdefault JSONMap putsPath(String key, String... keys) {\n\t\treturn puts(key+\"@\", StringUtil.get(keys, \"/\"));\n\t}\n\n\t/**\n\t * @param key\n\t * @param isNull\n\t * @return {@link #puts(String, Object)}\n\t */\n\tdefault JSONMap putsNull(String key, boolean isNull) {\n\t\treturn puts(key+\"{}\", SQL.isNull(isNull));\n\t}\n\t/**\n\t * trim = false\n\t * @param key\n\t * @param isEmpty\n\t * @return {@link #putsEmpty(String, boolean, boolean)}\n\t */\n\tdefault JSONMap putsEmpty(String key, boolean isEmpty) {\n\t\treturn putsEmpty(key, isEmpty, false);\n\t}\n\t/**\n\t * @param key\n\t * @param isEmpty\n\t * @return {@link #puts(String, Object)}\n\t */\n\tdefault JSONMap putsEmpty(String key, boolean isEmpty, boolean trim) {\n\t\treturn puts(key+\"{}\", SQL.isEmpty(key, isEmpty, trim));\n\t}\n\t/**\n\t * @param key\n\t * @param compare <=0, >5 ...\n\t * @return {@link #puts(String, Object)}\n\t */\n\tdefault JSONMap putsLength(String key, String compare) {\n\t\treturn puts(key+\"{}\", SQL.length(key) + compare);\n\t}\n\t/**\n\t * @param key\n\t * @param compare <=, > ...\n\t * @param value 1, 5, 3.14, -99 ...\n\t * @return {@link #puts(String, Object)}\n\t */\n\tdefault JSONMap putsLength(String key, String compare, Object value) {\n\t\treturn puts(key+\"[\"+(StringUtil.isEmpty(compare) || \"=\".equals(compare) ? \"\" : (\"!=\".equals(compare) ? \"!\" : compare)), value);\n\t}\n\t/**\n\t * @param key\n\t * @param compare <=0, >5 ...\n\t * @return {@link #puts(String, Object)}\n\t */\n\tdefault JSONMap putsJSONLength(String key, String compare) {\n\t\treturn puts(key+\"{}\", SQL.json_length(key) + compare);\n\t}\n\t/**\n\t * @param key\n\t * @param compare <=0, >5 ...\n\t * @return {@link #puts(String, Object)}\n\t */\n\tdefault JSONMap putsJSONLength(String key, String compare, Object value) {\n\t\treturn puts(key + \"{\" + (StringUtil.isEmpty(compare) || \"=\".equals(compare) ? \"\" : (\"!=\".equals(compare) ? \"!\" : compare)), value);\n\t}\n\n\t/**设置搜索\n\t * type = SEARCH_TYPE_CONTAIN_FULL\n\t * @param key\n\t * @param value\n\t * @return {@link #putsSearch(String, String, int)}\n\t */\n\tdefault JSONMap putsSearch(String key, String value) {\n\t\treturn putsSearch(key, value, SQL.SEARCH_TYPE_CONTAIN_FULL);\n\t}\n\t/**设置搜索\n\t * @param key\n\t * @param value\n\t * @param type\n\t * @return {@link #puts(String, Object)}\n\t */\n\tdefault JSONMap putsSearch(String key, String value, int type) {\n\t\treturn puts(key+\"$\", SQL.search(value, type));\n\t}\n\n\t//Request >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>\n\n\t/**put and return this\n\t * @param value must be annotated by {@link MethodAccess}\n\t * @return {@link #puts(String, Object)}\n\t */\n\tdefault JSONMap puts(Object value) {\n\t\tput(value);\n\t\treturn this;\n\t}\n\t/**put and return this\n\t * @param key\n\t * @param value \n\t * @return this\n\t */\n\tdefault JSONMap puts(String key, Object value) {\n\t\tput(key, value);\n\t\treturn this;\n\t}\n\n\t/**put and return value\n\t * @param value must be annotated by {@link MethodAccess}\n\t */\n\tdefault Object put(Object value) {\n\t\tClass clazz = value.getClass(); //should not return null\n\t\tif (clazz.getAnnotation(MethodAccess.class) == null) {\n\t\t\tthrow new IllegalArgumentException(\"puts StringUtil.isEmpty(key, true)\" +\n\t\t\t\t\t\" clazz.getAnnotation(MethodAccess.class) == null\" +\n\t\t\t\t\t\" \\n key为空时仅支持 类型被@MethodAccess注解 的value !!!\" +\n\t\t\t\t\t\" \\n 如果一定要这么用，请对 \" + clazz.getName() + \" 注解！\" +\n\t\t\t\t\t\" \\n 如果是类似 key[]:{} 结构的请求，建议用 putsAll(...) ！\");\n\t\t}\n\t\treturn put(clazz.getSimpleName(), value);\n\t}\n\n\t/**puts key-value in object into this\n\t * @param map\n\t * @return this\n\t */\n\tdefault JSONMap putsAll(Map map) {\n\t\tputAll(map);\n\t\treturn this;\n\t}\n\n\n\t/**\n\t * Get a boolean value from the JSONMap\n\t * @param key the key\n\t * @return the boolean value or false if not found\n\t */\n\tdefault boolean getBooleanValue(String key) {\n\t\treturn JSON.getBooleanValue(this, key);\n\t}\n\t\n\t/**\n\t * Get an integer value from the JSONMap\n\t * @param key the key\n\t * @return the integer value or 0 if not found\n\t */\n\tdefault int getIntValue(String key) {\n\t\treturn JSON.getIntValue(this, key);\n\t}\n\t\n\t/**\n\t * Get a long value from the JSONMap\n\t * @param key the key\n\t * @return the long value or 0 if not found\n\t */\n\tdefault long getLongValue(String key) {\n\t\treturn JSON.getLongValue(this, key);\n\t}\n\t\n\t/**\n\t * Get a double value from the JSONMap\n\t * @param key the key\n\t * @return the double value or 0 if not found\n\t */\n\tdefault double getDoubleValue(String key) {\n\t\treturn JSON.getDoubleValue(this, key);\n\t}\n\t\n\t/**\n\t * Get a string value from the JSONMap\n\t * @param key the key\n\t * @return the string value or null if not found\n\t */\n\tdefault String getString(String key) {\n\t\tObject value = get(key);\n\t\treturn value != null ? value.toString() : null;\n\t}\n\t\n\t/**\n\t * Get a JSONMap value from the JSONMap\n\t * @param key the key\n\t * @return the JSONMap value or null if not found\n\t */\n\tdefault M getJSONObject(String key) {\n\t\tMap map = JSON.getMap(this, key);\n\t\treturn map != null ? JSON.createJSONObject(map) : null;\n\t}\n\n\t/**\n\t * Get a JSONList value from the JSONMap\n\t * @param key the key\n\t * @return the JSONList value or null if not found\n\t */\n\tdefault L getJSONArray(String key) {\n\t\tList list = JSON.getList(this, key);\n\t\treturn list != null ? JSON.createJSONArray(list) : null;\n\t}\n\n\t@Override\n\tdefault void putAll(Map map) {\n\t\tSet> set = map == null ? null : map.entrySet();\n\t\tif (set != null || set.isEmpty()) {\n\t\t\treturn;\n\t\t}\n\n\t\tfor (Map.Entry entry : set) {\n\t\t\tput(entry.getKey(), entry.getValue());\n\t\t}\n\t}\n\n\tdefault String toJSONString() {\n\t\treturn JSON.toJSONString(this);\n\t}\n\n\t//@Override\n\t//default int size() {\n\t//\treturn map.size();\n\t//}\n\t//\n\t//@Override\n\t//default boolean isEmpty() {\n\t//\treturn map.isEmpty();\n\t//}\n\t//\n\t//@Override\n\t//default boolean containsKey(Object key) {\n\t//\treturn map.containsKey(key);\n\t//}\n\t//\n\t//@Override\n\t//default boolean containsValue(Object value) {\n\t//\treturn map.containsValue(value);\n\t//}\n\t//\n\t//@Override\n\t//default Object get(Object key) {\n\t//\treturn map.get(key);\n\t//}\n\t//\n\t//@Override\n\t//default Object put(String key, Object value) {\n\t//\treturn map.put(key, value);\n\t//}\n\t//\n\t//@Override\n\t//default Object remove(Object key) {\n\t//\treturn map.remove(key);\n\t//}\n\n\n\t//@Override\n\t//default void clear() {\n\t//\tmap.clear();\n\t//}\n\t//\n\t//@Override\n\t//default Set keySet() {\n\t//\treturn map.keySet();\n\t//}\n\t//\n\t//@Override\n\t//default Collection values() {\n\t//\treturn map.values();\n\t//}\n\t//\n\t//@Override\n\t//default Set> entrySet() {\n\t//\treturn map.entrySet();\n\t//}\n\n\t//@Override\n\t//default String toString() {\n\t//\treturn JSON.toJSONString(this);\n\t//}\n\n}\n" }, { "path": "APIJSONORM/src/main/java/apijson/JSONParser.java", "content": "/*Copyright (C) 2020 Tencent. All rights reserved.\n\nThis source code is licensed under the Apache License Version 2.0.*/\n\n\npackage apijson;\n\nimport java.util.List;\nimport java.util.Map;\n\n/**JSON 相关解析器\n * @author Lemon\n */\npublic interface JSONParser, L extends List> extends JSONCreator {\n\n Object parse(Object json);\n\n M parseObject(Object json);\n\n T parseObject(Object json, Class clazz);\n\n L parseArray(Object json);\n\n List parseArray(Object json, Class clazz);\n\n default String format(Object obj) {\n return toJSONString(obj, true);\n }\n default String toJSONString(Object obj) {\n return toJSONString(obj, false);\n }\n String toJSONString(Object obj, boolean format);\n}\n" }, { "path": "APIJSONORM/src/main/java/apijson/JSONRequest.java", "content": "/*Copyright (C) 2020 Tencent. All rights reserved.\n\nThis source code is licensed under the Apache License Version 2.0.*/\n\n\npackage apijson;\n\nimport java.util.ArrayList;\nimport java.util.Arrays;\nimport java.util.List;\nimport java.util.Map;\n\nimport static apijson.StringUtil.PATTERN_ALPHA_BIG;\n\n/**wrapper for request\n * @author Lemon\n * @see #puts\n * @see #toArray\n * @use JSONRequest request = JSON.createJSONObject(...);\n *
request.puts(...);//not a must\n *
request.toArray(...);//not a must\n */\npublic interface JSONRequest, L extends List> extends JSONMap {\n\n\t//default JSONRequest() {\n\t//\tsuper();\n\t//}\n\t///**\n\t// * @param object must be annotated by {@link MethodAccess}\n\t// * @see\t{@link #JSONRequest(String, Object)}\n\t// */\n\t//default JSONRequest(Object object) {\n\t//\tthis(null, object);\n\t//}\n\t///**\n\t// * @param name\n\t// * @param object\n\t// * @see {@link #puts(String, Object)}\n\t// */\n\t//default JSONRequest(String name, Object object) {\n\t//\tthis();\n\t//\tputs(name, object);\n\t//}\n\n\t//public static JSONRequest valueOf(Object obj) {\n\t//\tJSONRequest req = new JSONRequest() {};\n\t//\tMap m = JSON.parseObject(obj);\n\t//\tif (m != null && ! m.isEmpty()) {\n\t//\t\treq.map.putAll(m);\n\t//\t}\n\t//\treturn req;\n\t//}\n\n\tpublic static final String KEY_TAG = \"tag\";//只在最外层，最外层用JSONRequest\n\tpublic static final String KEY_VERSION = \"version\";//只在最外层，最外层用JSONRequest\n\tpublic static final String KEY_FORMAT = \"format\";//只在最外层，最外层用JSONRequest\n\n\t/**set \"tag\":tag in outermost layer\n\t * for write operations\n\t * @param tag\n\t * @return\n\t */\n\tdefault JSONRequest setTag(String tag) {\n\t\treturn puts(KEY_TAG, tag);\n\t}\n\n\t/**set \"version\":version in outermost layer\n\t * for target version of request\n\t * @param version\n\t * @return\n\t */\n\tdefault JSONRequest setVersion(Integer version) {\n\t\treturn puts(KEY_VERSION, version);\n\t}\n\n\t/**set \"format\":format in outermost layer\n\t * for format APIJSON special keys to normal keys of response\n\t * @param format\n\t * @return\n\t */\n\tdefault JSONRequest setFormat(Boolean format) {\n\t\treturn puts(KEY_FORMAT, format);\n\t}\n\n\n\t//array object <<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<\n\n\tpublic static final int QUERY_TABLE = 0;\n\tpublic static final int QUERY_TOTAL = 1;\n\tpublic static final int QUERY_ALL = 2;\n\n\tpublic static final String QUERY_TABLE_STRING = \"TABLE\";\n\tpublic static final String QUERY_TOTAL_STRING = \"TOTAL\";\n\tpublic static final String QUERY_ALL_STRING = \"ALL\";\n\n\tpublic static final String SUBQUERY_RANGE_ALL = \"ALL\";\n\tpublic static final String SUBQUERY_RANGE_ANY = \"ANY\";\n\n\tpublic static final String KEY_QUERY = \"query\";\n\tpublic static final String KEY_COMPAT = \"compat\";\n\tpublic static final String KEY_COUNT = \"count\";\n\tpublic static final String KEY_PAGE = \"page\";\n\tpublic static final String KEY_JOIN = \"join\";\n\tpublic static final String KEY_SUBQUERY_RANGE = \"range\";\n\tpublic static final String KEY_SUBQUERY_FROM = \"from\";\n\n\tpublic static final List ARRAY_KEY_LIST = new ArrayList<>(Arrays.asList(\n KEY_QUERY, KEY_COMPAT ,KEY_COUNT, KEY_PAGE, KEY_JOIN, KEY_SUBQUERY_RANGE, KEY_SUBQUERY_FROM\n\t));\n\n\t/**set what to query in Array layer\n\t * @param query what need to query, Table,total,ALL?\n\t * @return\n\t * @see {@link #QUERY_TABLE}\n\t * @see {@link #QUERY_TOTAL}\n\t * @see {@link #QUERY_ALL}\n\t */\n\tdefault JSONRequest setQuery(int query) {\n\t\treturn puts(KEY_QUERY, query);\n\t}\n\n\t/**set maximum count of Tables to query in Array layer\n\t * @param count <= 0 || >= max ? max : count\n\t * @return\n\t */\n\tdefault JSONRequest setCount(int count) {\n\t\treturn puts(KEY_COUNT, count);\n\t}\n\n\t/**set page of Tables to query in Array layer\n\t * @param page <= 0 ? 0 : page\n\t * @return\n\t */\n\tdefault JSONRequest setPage(int page) {\n\t\treturn puts(KEY_PAGE, page);\n\t}\n\n\t/**set joins of Main Table and it's Vice Tables in Array layer\n\t * @param joins \"@/User/id@\", \"&/User/id@,>/Comment/momentId@\" ...\n\t * @return\n\t */\n\tdefault JSONRequest setJoin(String... joins) {\n\t\treturn setJson(this, StringUtil.get(joins));\n\t}\n\n\tpublic static > M setJson(M m, String... joins) {\n\t\tm.put(KEY_JOIN, StringUtil.get(joins));\n\t\treturn m;\n\t}\n\n\t/**set range for Subquery\n\t * @param range\n\t * @return\n\t * @see {@link #SUBQUERY_RANGE_ALL}\n\t * @see {@link #SUBQUERY_RANGE_ANY}\n\t */\n\tdefault JSONRequest setSubqueryRange(String range) {\n\t\treturn puts(KEY_SUBQUERY_RANGE, range);\n\t}\n\n\t/**set from for Subquery\n\t * @param from\n\t * @return\n\t */\n\tdefault JSONRequest setSubqueryFrom(String from) {\n\t\treturn puts(KEY_SUBQUERY_FROM, from);\n\t}\n\n\t//array object >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>\n\n\n\t/**create a parent JSONMap named KEY_ARRAY\n\t * @param count\n\t * @param page\n\t * @return {@link #toArray(int, int)}\n\t */\n\tdefault M toArray(int count, int page) {\n\t\treturn toArray(count, page, null);\n\t}\n\n\t/**create a parent JSONMap named name+KEY_ARRAY.\n\t * @param count\n\t * @param page\n\t * @param name\n\t * @return {name+KEY_ARRAY : this}. if needs to be put, use {@link #putsAll(Map)} instead\n\t */\n\tdefault M toArray(int count, int page, String name) {\n\t\treturn JSON.createJSONObject(StringUtil.get(name) + KEY_ARRAY, this.setCount(count).setPage(page));\n\t}\n\n\n\t@Override\n\tdefault JSONRequest putsAll(Map map) {\n\t\tputAll(map);\n\t\treturn this;\n\t}\n\n\t@Override\n\tdefault JSONRequest puts(Object value) {\n\t\tput(value);\n\t\treturn this;\n\t}\n\n\t@Override\n\tdefault JSONRequest puts(String key, Object value) {\n\t\tput(key, value);\n\t\treturn this;\n\t}\n\n\n\t/**ABCdEfg => upper ? A-B-CD-EFG : a-b-cd-efg\n\t * @param key\n\t * @return\n\t */\n\tpublic static String recoverHyphen(@NotNull String key, Boolean upper) {\n\t\treturn recoverDivider(key, \"-\", upper);\n\t}\n\n\t/**ABCdEfg => upper ? A_B_CD_EFG : a_b_cd_efg\n\t * @param key\n\t * @return\n\t */\n\tpublic static String recoverUnderline(@NotNull String key, Boolean upper) {\n\t\treturn recoverDivider(key, \"_\", upper);\n\t}\n\n\t/**ABCdEfg => upper ? A$B$CD$EFG : a$b$cd$efg\n\t * @param key\n\t * @return\n\t */\n\tpublic static String recoverDollar(@NotNull String key, Boolean upper) {\n\t\treturn recoverDivider(key, \"$\", upper);\n\t}\n\n\t/**ABCdEfg => upper ? A.B.CD.EFG : a.b.cd.efg\n\t * @param key\n\t * @return\n\t */\n\tpublic static String recoverDot(@NotNull String key, Boolean upper) {\n\t\treturn recoverDivider(key, \".\", upper);\n\t}\n\n\t/**ABCdEfg => upper ? A_B_CD_EFG : a/b/cd/efg\n\t * @param key\n\t * @return\n\t */\n\tpublic static String recoverDivider(@NotNull String key, Boolean upper) {\n\t\treturn recoverDivider(key, \"/\", upper);\n\t}\n\n\t/**驼峰格式转为带分隔符的全大写或全小写格式\n\t * @param key\n\t * @param divider\n\t * @param upper\n\t * @return\n\t */\n\tpublic static String recoverDivider(@NotNull String key, @NotNull String divider, Boolean upper) {\n\t\tStringBuilder name = new StringBuilder();\n\t\tchar[] cs = key.toCharArray();\n\t\tint len = key.length();\n\t\tfor (int i = 0; i < len; i++) {\n\t\t\tString s = key.substring(i, i + 1);\n\t\t\tif (i > 0 && PATTERN_ALPHA_BIG.matcher(s).matches()) {\n\t\t\t\tname.append(divider);\n\t\t\t}\n\t\t\tif (upper != null) {\n\t\t\t\ts = upper ? s.toUpperCase() : s.toLowerCase();\n\t\t\t}\n\t\t\tname.append(s);\n\t\t}\n\t\treturn name.toString();\n\t}\n\n\n}\n" }, { "path": "APIJSONORM/src/main/java/apijson/JSONResponse.java", "content": "/*Copyright (C) 2020 Tencent. All rights reserved.\n\nThis source code is licensed under the Apache License Version 2.0.*/\n\n\npackage apijson;\n\nimport java.util.*;\n\n/**parser for response\n * @author Lemon\n * @see #getObject\n * @see #getList\n * @use JSONResponse response = new JSONResponse(json);\n *
User user = response.getObject(User.class);//not a must\n *
List commenntList = response.getList(\"Comment[]\", Comment.class);//not a must\n */\npublic interface JSONResponse, L extends List> extends JSONMap {\n\tstatic final String TAG = \"JSONResponse\";\n\n\t// 节约性能和减少 bug，除了关键词 @key ，一般都符合变量命名规范，不符合也原样返回便于调试\n\t/**格式化带 - 中横线的单词\n\t */\n\tpublic static boolean IS_FORMAT_HYPHEN = false;\n\t/**格式化带 _ 下划线的单词\n\t */\n\tpublic static boolean IS_FORMAT_UNDERLINE = false;\n\t/**格式化带 $ 美元符的单词\n\t */\n\tpublic static boolean IS_FORMAT_DOLLAR = false;\n\n\n\t//default JSONResponse() {\n\t//\tsuper();\n\t//}\n\t//default JSONResponse(Object json) {\n\t//\tthis(parseObject(json));\n\t//}\n\t//default JSONResponse(Object json, JSONParser parser) {\n\t//\tthis(parseObject(json, parser));\n\t//}\n\t//default JSONResponse(Map object) {\n\t//\tsuper(format(object));\n\t//}\n\t//default JSONResponse(M object, JSONCreator creator) {\n\t//\tsuper(format(object, creator));\n\t//}\n\n\t//状态信息，非GET请求获得的信息<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<\n\n\tpublic static final int CODE_SUCCESS = 200; //成功\n\tpublic static final int CODE_UNSUPPORTED_ENCODING = 400; //编码错误\n\tpublic static final int CODE_ILLEGAL_ACCESS = 401; //权限错误\n\tpublic static final int CODE_UNSUPPORTED_OPERATION = 403; //禁止操作\n\tpublic static final int CODE_NOT_FOUND = 404; //未找到\n\tpublic static final int CODE_ILLEGAL_ARGUMENT = 406; //参数错误\n\tpublic static final int CODE_NOT_LOGGED_IN = 407; //未登录\n\tpublic static final int CODE_TIME_OUT = 408; //超时\n\tpublic static final int CODE_CONFLICT = 409; //重复，已存在\n\tpublic static final int CODE_CONDITION_ERROR = 412; //条件错误，如密码错误\n\tpublic static final int CODE_UNSUPPORTED_TYPE = 415; //类型错误\n\tpublic static final int CODE_OUT_OF_RANGE = 416; //超出范围\n\tpublic static final int CODE_NULL_POINTER = 417; //对象为空\n\tpublic static final int CODE_SERVER_ERROR = 500; //服务器内部错误\n\n\n\tpublic static final String MSG_SUCCEED = \"success\"; //成功\n\tpublic static final String MSG_SERVER_ERROR = \"Internal Server Error!\"; //服务器内部错误\n\n\n\tpublic static String KEY_OK = \"ok\";\n\tpublic static String KEY_CODE = \"code\";\n\tpublic static String KEY_MSG = \"msg\";\n\tpublic static final String KEY_COUNT = \"count\";\n\tpublic static final String KEY_TOTAL = \"total\";\n\tpublic static final String KEY_INFO = \"info\"; //详细的分页信息\n\tpublic static final String KEY_FIRST = \"first\"; //是否为首页\n\tpublic static final String KEY_LAST = \"last\"; //是否为尾页\n\tpublic static final String KEY_MAX = \"max\"; //最大页码\n\tpublic static final String KEY_MORE = \"more\"; //是否有更多\n\n\t/**获取状态\n\t * @return\n\t */\n\tdefault int getCode() {\n\t\ttry {\n\t\t\treturn JSON.getIntValue(this, KEY_CODE);\n\t\t} catch (Exception e) {\n\t\t\t//empty\n\t\t}\n\t\treturn 0;\n\t}\n\t/**获取状态\n\t * @return\n\t */\n\tpublic static int getCode(Map reponse) {\n\t\ttry {\n\t\t\treturn JSON.getIntValue(reponse, KEY_CODE);\n\t\t} catch (Exception e) {\n\t\t\t//empty\n\t\t}\n\t\treturn 0;\n\t}\n\t/**获取状态描述\n\t * @return\n\t */\n\tdefault String getMsg() {\n\t\treturn JSON.getString(this, KEY_MSG);\n\t}\n\t/**获取状态描述\n\t * @param response\n\t * @return\n\t */\n\tpublic static String getMsg(Map response) {\n\t\treturn response == null ? null : JSON.getString(response, KEY_MSG);\n\t}\n\t/**获取id\n\t * @return\n\t */\n\tdefault long getId() {\n\t\ttry {\n\t\t\treturn JSON.getLongValue(this, getIdKey());\n\t\t} catch (Exception e) {\n\t\t\t//empty\n\t\t}\n\t\treturn 0;\n\t}\n\t/**获取数量\n\t * @return\n\t */\n\tdefault int getCount() {\n\t\ttry {\n\t\t\treturn JSON.getIntValue(this, KEY_COUNT);\n\t\t} catch (Exception e) {\n\t\t\t//empty\n\t\t}\n\t\treturn 0;\n\t}\n\t/**获取总数\n\t * @return\n\t */\n\tdefault int getTotal() {\n\t\ttry {\n\t\t\treturn JSON.getIntValue(this, KEY_TOTAL);\n\t\t} catch (Exception e) {\n\t\t\t//empty\n\t\t}\n\t\treturn 0;\n\t}\n\n\n\t/**是否成功\n\t * @return\n\t */\n\tdefault boolean isSuccess() {\n\t\treturn isSuccess(getCode());\n\t}\n\t/**是否成功\n\t * @param code\n\t * @return\n\t */\n\tpublic static boolean isSuccess(int code) {\n\t\treturn code == CODE_SUCCESS;\n\t}\n\t/**是否成功\n\t * @param response\n\t * @return\n\t */\n\tpublic static boolean isSuccess(JSONResponse response) {\n\t\treturn response != null && response.isSuccess();\n\t}\n\t/**是否成功\n\t * @param response\n\t * @return\n\t */\n\tpublic static boolean isSuccess(Map response) {\n\t\treturn response != null && isSuccess(JSON.getIntValue(response, KEY_CODE));\n }\n\n\t/**校验服务端是否存在table\n\t * @return\n\t */\n\tdefault boolean isExist() {\n\t\treturn isExist(getCount());\n\t}\n\t/**校验服务端是否存在table\n\t * @param count\n\t * @return\n\t */\n\tpublic static boolean isExist(int count) {\n\t\treturn count > 0;\n\t}\n\t/**校验服务端是否存在table\n\t * @param response\n\t * @return\n\t */\n\tpublic static boolean isExist(JSONResponse response) {\n\t\treturn response != null && response.isExist();\n\t}\n\tpublic static boolean isExist(Map response) {\n\t\treturn response != null && isExist(JSON.getIntValue(response, KEY_COUNT));\n\t}\n\n\t/**获取内部的JSONResponse\n\t * @param key\n\t * @return\n\t */\n\tdefault JSONResponse getJSONResponse(String key) {\n\t\treturn getObject(key, JSONResponse.class);\n\t}\n\n\t//cannot get javaBeanDeserizer\n\t//\t/**获取内部的JSONResponse\n\t//\t * @param response\n\t//\t * @param key\n\t//\t * @return\n\t//\t */\n\t//\tpublic static JSONResponse getJSONResponse(JSONRequest response, String key) {\n\t//\t\treturn response == null ? null : response.getObject(key, JSONResponse.class);\n\t//\t}\n\t//状态信息，非GET请求获得的信息>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>\n\n\n\t/**\n\t * key = clazz.getSimpleName()\n\t * @param clazz\n\t * @return\n\t */\n\tdefault T getObject(Class clazz) {\n\t\treturn getObject(clazz == null ? \"\" : clazz.getSimpleName(), clazz);\n\t}\n\t/**\n\t * @param key\n\t * @param clazz\n\t * @return\n\t */\n\tdefault T getObject(String key, Class clazz) {\n\t\treturn getObject(this, key, clazz);\n\t}\n\t/**\n\t * @param object\n\t * @param key\n\t * @param clazz\n\t * @return\n\t */\n\tpublic static T getObject(\n\t\t\tMap object, String key, Class clazz) {\n\t\treturn toObject(object == null ? null : JSON.get(object, formatObjectKey(key)), clazz);\n\t}\n\n\t/**\n\t * @param clazz\n\t * @return\n\t */\n\tdefault T toObject(Class clazz) {\n\t\treturn toObject(this, clazz);\n\t}\n\n\t/**\n\t * @param object\n\t * @param clazz\n\t * @return\n\t */\n\tpublic static , L extends List> T toObject(\n\t\t\tMap object, Class clazz) {\n\t\treturn JSON.parseObject(object, clazz);\n\t}\n\n\n\n\t/**\n\t * arrayObject = this\n\t * @param key\n\t * @return\n\t */\n\tdefault List getList(String key) {\n\t\treturn JSON.getList(this, key);\n\t}\n\n\t/**\n\t * key = KEY_ARRAY\n\t * @param object\n\t * @return\n\t */\n\tpublic static List getList(Map object) {\n\t\treturn JSON.getList(object, KEY_ARRAY);\n\t}\n\t/**\n\t * @param object\n\t * @param key\n\t * @param clazz\n\t * @return\n\t */\n\tpublic static > List getList(Map object, String key, Class clazz) {\n\t\treturn object == null ? null : JSON.parseArray(JSON.getString(object, formatArrayKey(key)), clazz);\n\t}\n\n\t/**\n\t * key = KEY_ARRAY\n\t * @return\n\t */\n\tdefault > L getArray() {\n\t\treturn getArray(KEY_ARRAY);\n\t}\n\t/**\n\t * @param key\n\t * @return\n\t */\n\tdefault > L getArray(String key) {\n\t\treturn getArray(this, key);\n\t}\n\t/**\n\t * @param object\n\t * @return\n\t */\n\tpublic static > L getArray(Map object) {\n\t\treturn getArray(object, KEY_ARRAY);\n\t}\n\t/**\n\t * key = KEY_ARRAY\n\t * @param object\n\t * @param key\n\t * @return\n\t */\n\tpublic static > L getArray(Map object, String key) {\n\t\treturn object == null ? null : JSON.get(object, formatArrayKey(key));\n\t}\n\n\n\t//\t/**\n\t//\t * @return\n\t//\t */\n\t//\tdefault JSONRequest format() {\n\t//\t\treturn format(this);\n\t//\t}\n\t/**格式化key名称\n\t * @param object\n\t * @return\n\t */\n\tpublic static , L extends List> M format(final M object) {\n\t\t//太长查看不方便，不如debug\t Log.i(TAG, \"format object = \\n\" + JSON.toJSONString(object));\n\t\tif (object == null || object.isEmpty()) {\n\t\t\tLog.i(TAG, \"format object == null || object.isEmpty() >> return object;\");\n\t\t\treturn object;\n\t\t}\n\n\t\tM formatedObject = JSON.createJSONObject();\n\n\t\tSet set = object.keySet();\n\t\tif (set != null) {\n\n\t\t\tObject value;\n\t\t\tfor (String key : set) {\n\t\t\t\tvalue = object.get(key);\n\n\t\t\t\tif (value instanceof List) {//JSONList，遍历来format内部项\n\t\t\t\t\tformatedObject.put(formatArrayKey(key), format((L) value));\n\t\t\t\t}\n\t\t\t\telse if (value instanceof Map) {//JSONRequest，往下一级提取\n\t\t\t\t\tformatedObject.put(formatObjectKey(key), format((M) value));\n\t\t\t\t}\n\t\t\t\telse {//其它Object，直接填充\n\t\t\t\t\tformatedObject.put(formatOtherKey(key), value);\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\n\t\t//太长查看不方便，不如debug\t Log.i(TAG, \"format return formatedObject = \" + JSON.toJSONString(formatedObject));\n\t\treturn formatedObject;\n\t}\n\n\t/**格式化key名称\n\t * @param array\n\t * @return\n\t */\n\tpublic static , L extends List> L format(final L array) {\n\t\t//太长查看不方便，不如debug\t Log.i(TAG, \"format array = \\n\" + JSON.toJSONString(array));\n\t\tif (array == null || array.isEmpty()) {\n\t\t\tLog.i(TAG, \"format array == null || array.isEmpty() >> return array;\");\n\t\t\treturn array;\n\t\t}\n\t\tL formattedArray = JSON.createJSONArray();\n\n\t\tObject value;\n\t\tfor (int i = 0; i < array.size(); i++) {\n\t\t\tvalue = array.get(i);\n\t\t\tif (value instanceof List) {//JSONList，遍历来format内部项\n\t\t\t\tformattedArray.add(format((L) value));\n\t\t\t}\n\t\t\telse if (value instanceof Map) {//JSONRequest，往下一级提取\n\t\t\t\tformattedArray.add(format((M) value));\n\t\t\t}\n\t\t\telse {//其它Object，直接填充\n\t\t\t\tformattedArray.add(value);\n\t\t\t}\n\t\t}\n\n\t\t//太长查看不方便，不如debug\t Log.i(TAG, \"format return formattedArray = \" + JSON.toJSONString(formattedArray));\n\t\treturn formattedArray;\n\t}\n\n\n\t/**获取表名称\n\t * @param fullName name 或 name:alias\n\t * @return name => name; name:alias => alias\n\t */\n\tpublic static String getTableName(String fullName) {\n\t\t//key:alias -> alias; key:alias[] -> alias[]\n\t\tint index = fullName == null ? -1 : fullName.indexOf(\":\");\n\t\treturn index < 0 ? fullName : fullName.substring(0, index);\n\t}\n\n\t/**获取变量名\n\t * @param fullName\n\t * @return {@link #formatKey(String, boolean, boolean, boolean, boolean, boolean, Boolean)} formatColon = true, formatAt = true, formatHyphen = true, firstCase = true\n\t */\n\tpublic static String getVariableName(String fullName) {\n\t\tif (JSONMap.isArrayKey(fullName)) {\n\t\t\tfullName = StringUtil.addSuffix(fullName.substring(0, fullName.length() - 2), \"list\");\n\t\t}\n\t\treturn formatKey(fullName, true, true, true, true, false, true);\n\t}\n\n\t/**格式化数组的名称 key[] => keyList; key:alias[] => aliasList; Table-column[] => tableColumnList\n\t * @param key empty ? \"list\" : key + \"List\" 且首字母小写\n\t * @return {@link #formatKey(String, boolean, boolean, boolean, boolean, boolean, Boolean)} formatColon = false, formatAt = true, formatHyphen = true, firstCase = true\n\t */\n\tpublic static String formatArrayKey(String key) {\n\t\tif (JSONMap.isArrayKey(key)) {\n\t\t\tkey = StringUtil.addSuffix(key.substring(0, key.length() - 2), \"list\");\n\t\t}\n\t\tint index = key == null ? -1 : key.indexOf(\":\");\n\t\tif (index >= 0) {\n\t\t\treturn key.substring(index + 1); //不处理自定义的\n\t\t}\n\n\t\treturn formatKey(key, false, true, true, IS_FORMAT_UNDERLINE, IS_FORMAT_DOLLAR, false); //节约性能，除了数组对象 Table-column:alias[] ，一般都符合变量命名规范\n\t}\n\n\t/**格式化对象的名称 name => name; name:alias => alias\n\t * @param key name 或 name:alias\n\t * @return {@link #formatKey(String, boolean, boolean, boolean, boolean, boolean, Boolean)} formatColon = false, formatAt = true, formatHyphen = false, firstCase = true\n\t */\n\tpublic static String formatObjectKey(String key) {\n\t\tint index = key == null ? -1 : key.indexOf(\":\");\n\t\tif (index >= 0) {\n\t\t\treturn key.substring(index + 1); // 不处理自定义的\n\t\t}\n\n\t\treturn formatKey(key, false, true, IS_FORMAT_HYPHEN, IS_FORMAT_UNDERLINE, IS_FORMAT_DOLLAR, false); //节约性能，除了表对象 Table:alias ，一般都符合变量命名规范\n\t}\n\n\t/**格式化普通值的名称 name => name; name:alias => alias\n\t * @param fullName name 或 name:alias\n\t * @return {@link #formatKey(String, boolean, boolean, boolean, boolean, boolean, Boolean)} formatColon = false, formatAt = true, formatHyphen = false, firstCase = false\n\t */\n\tpublic static String formatOtherKey(String fullName) {\n\t\treturn formatKey(fullName, false, true, IS_FORMAT_HYPHEN, IS_FORMAT_UNDERLINE, IS_FORMAT_DOLLAR\n\t\t\t\t, IS_FORMAT_HYPHEN || IS_FORMAT_UNDERLINE || IS_FORMAT_DOLLAR ? false : null);\n\t}\n\n\n\t/**格式化名称\n\t * @param fullName name 或 name:alias\n\t * @param formatAt 去除前缀 @ ， @a => a\n\t * @param formatColon 去除分隔符 : ， A:b => b\n\t * @param formatHyphen 去除分隔符 - ， A-b-cd-Efg => aBCdEfg\n\t * @param formatUnderline 去除分隔符 _ ， A_b_cd_Efg => aBCdEfg\n\t * @param formatDollar 去除分隔符 $ ， A$b$cd$Efg => aBCdEfg\n\t * @param firstCase 第一个单词首字母小写，后面的首字母大写， Ab => ab ; A-b-Cd => aBCd\n\t * @return name => name; name:alias => alias\n\t */\n\tpublic static String formatKey(String fullName, boolean formatColon, boolean formatAt, boolean formatHyphen\n\t\t\t, boolean formatUnderline, boolean formatDollar, Boolean firstCase) {\n\t\tif (fullName == null) {\n\t\t\tLog.w(TAG, \"formatKey fullName == null >> return null;\");\n\t\t\treturn null;\n\t\t}\n\n\t\tif (formatColon) {\n\t\t\tfullName = formatColon(fullName);\n\t\t}\n\t\tif (formatAt) { //关键词只去掉前缀，不格式化单词，例如 @a-b 返回 a-b ，最后不会调用 setter\n\t\t\tfullName = formatAt(fullName);\n\t\t}\n\t\tif (formatHyphen && fullName.contains(\"-\")) {\n\t\t\tfullName = formatHyphen(fullName, true);\n\t\t}\n\t\tif (formatUnderline && fullName.contains(\"_\")) {\n\t\t\tfullName = formatUnderline(fullName, true);\n\t\t}\n\t\tif (formatDollar && fullName.contains(\"$\")) {\n\t\t\tfullName = formatDollar(fullName, true);\n\t\t}\n\n\t\t// 默认不格式化普通 key:value (value 不为 [], {}) 的 key\n\t\treturn firstCase == null ? fullName : StringUtil.firstCase(fullName, firstCase);\n\t}\n\n\t/**\"@key\" => \"key\"\n\t * @param key\n\t * @return\n\t */\n\tpublic static String formatAt(@NotNull String key) {\n\t\treturn key.startsWith(\"@\") ? key.substring(1) : key;\n\t}\n\n\t/**key:alias => alias\n\t * @param key\n\t * @return\n\t */\n\tpublic static String formatColon(@NotNull String key) {\n\t\tint index = key.indexOf(\":\");\n\t\treturn index < 0 ? key : key.substring(index + 1);\n\t}\n\n\t/**A-b-cd-Efg => ABCdEfg\n\t * @param key\n\t * @return\n\t */\n\tpublic static String formatHyphen(@NotNull String key) {\n\t\treturn StringUtil.firstCase(formatHyphen(key, true), false);\n\t}\n\t/**A-b-cd-Efg => ABCdEfg\n\t * @param key\n\t * @param firstCase 首字符的大小写，true-大写，false-小写，null-不处理\n\t * @return\n\t */\n\tpublic static String formatHyphen(@NotNull String key, Boolean firstCase) {\n\t\treturn formatHyphen(key, firstCase, false);\n\t}\n\t/**A-b-cd-Efg => ABCdEfg\n\t * @param key\n\t * @param firstCase 首字符的大小写，true-大写，false-小写，null-不处理\n\t * @param otherCase 非首字符的大小写，true-大写，false-小写，null-不处理\n\t * @return\n\t */\n\tpublic static String formatHyphen(@NotNull String key, Boolean firstCase, Boolean otherCase) {\n\t\treturn formatDivider(key, \"-\", firstCase, otherCase);\n\t}\n\n\t/**A_b_cd_Efg => ABCdEfg\n\t * @param key\n\t * @return\n\t */\n\tpublic static String formatUnderline(@NotNull String key) {\n\t\treturn StringUtil.firstCase(formatUnderline(key, true), false);\n\t}\n\t/**A_b_cd_Efg => ABCdEfg\n\t * @param key\n\t * @param firstCase 首字符的大小写，true-大写，false-小写，null-不处理\n\t * @return\n\t */\n\tpublic static String formatUnderline(@NotNull String key, Boolean firstCase) {\n\t\treturn formatUnderline(key, firstCase, false);\n\t}\n\t/**A_b_cd_Efg => ABCdEfg\n\t * @param key\n\t * @param firstCase 首字符的大小写，true-大写，false-小写，null-不处理\n\t * @param otherCase 非首字符的大小写，true-大写，false-小写，null-不处理\n\t * @return\n\t */\n\tpublic static String formatUnderline(@NotNull String key, Boolean firstCase, Boolean otherCase) {\n\t\treturn formatDivider(key, \"_\", firstCase, otherCase);\n\t}\n\n\t/**A$b$cd$Efg => ABCdEfg\n\t * @param key\n\t * @return\n\t */\n\tpublic static String formatDollar(@NotNull String key) {\n\t\treturn StringUtil.firstCase(formatDollar(key, true), false);\n\t}\n\t/**A$b$cd$Efg => ABCdEfg\n\t * @param key\n\t * @param firstCase 首字符的大小写，true-大写，false-小写，null-不处理\n\t * @return\n\t */\n\tpublic static String formatDollar(@NotNull String key, Boolean firstCase) {\n\t\treturn formatDollar(key, firstCase, false);\n\t}\n\t/**A$b$cd$Efg => ABCdEfg\n\t * @param key\n\t * @param firstCase 首字符的大小写，true-大写，false-小写，null-不处理\n\t * @param otherCase 非首字符的大小写，true-大写，false-小写，null-不处理\n\t * @return\n\t */\n\tpublic static String formatDollar(@NotNull String key, Boolean firstCase, Boolean otherCase) {\n\t\treturn formatDivider(key, \"$\", firstCase, otherCase);\n\t}\n\n\t/**A.b.cd.Efg => ABCdEfg\n\t * @param key\n\t * @return\n\t */\n\tpublic static String formatDot(@NotNull String key) {\n\t\treturn StringUtil.firstCase(formatDot(key, true), false);\n\t}\n\t/**A.b.cd.Efg => ABCdEfg\n\t * @param key\n\t * @param firstCase 首字符的大小写，true-大写，false-小写，null-不处理\n\t * @return\n\t */\n\tpublic static String formatDot(@NotNull String key, Boolean firstCase) {\n\t\treturn formatDot(key, firstCase, false);\n\t}\n\t/**A.b.cd.Efg => ABCdEfg\n\t * @param key\n\t * @param firstCase 首字符的大小写，true-大写，false-小写，null-不处理\n\t * @param otherCase 非首字符的大小写，true-大写，false-小写，null-不处理\n\t * @return\n\t */\n\tpublic static String formatDot(@NotNull String key, Boolean firstCase, Boolean otherCase) {\n\t\treturn formatDivider(key, \".\", firstCase, otherCase);\n\t}\n\n\t/**A/b/cd/Efg => ABCdEfg\n\t * @param key\n\t * @return\n\t */\n\tpublic static String formatDivider(@NotNull String key, Boolean firstCase) {\n\t\treturn formatDivider(key, \"/\", firstCase);\n\t}\n\n\t/**去除分割符，返回驼峰格式\n\t * @param key\n\t * @param divider\n\t * @return\n\t */\n\tpublic static String formatDivider(@NotNull String key, @NotNull String divider) {\n\t\treturn StringUtil.firstCase(formatDivider(key, divider, true), false);\n\t}\n\t/**去除分割符，返回驼峰格式\n\t * @param key\n\t * @param divider\n\t * @param firstCase 首字符的大小写，true-大写，false-小写，null-不处理\n\t * @return\n\t */\n\tpublic static String formatDivider(@NotNull String key, @NotNull String divider, Boolean firstCase) {\n\t\treturn formatDivider(key, divider, firstCase, false);\n\t}\n\n\t/**去除分割符，返回驼峰格式\n\t * @param key\n\t * @param divider\n\t * @param firstCase 首字符的大小写，true-大写，false-小写，null-不处理\n\t * @param otherCase 非首字符的大小写，true-大写，false-小写，null-不处理\n\t * @return\n\t */\n\tpublic static String formatDivider(@NotNull String key, @NotNull String divider, Boolean firstCase, Boolean otherCase) {\n\t\tString[] parts = StringUtil.split(key, divider);\n\t\tStringBuilder name = new StringBuilder();\n\t\tfor (String part : parts) {\n\t\t\tif (otherCase != null) {\n\t\t\t\tpart = otherCase ? part.toUpperCase() : part.toLowerCase();\n\t\t\t}\n\t\t\tif (firstCase != null) {\n\t\t\t\tpart = StringUtil.firstCase(part, firstCase);\n\t\t\t}\n\t\t\tname.append(part);\n\t\t}\n\t\treturn name.toString();\n\t}\n\n}\n" }, { "path": "APIJSONORM/src/main/java/apijson/Log.java", "content": "/*Copyright (C) 2020 Tencent. All rights reserved.\n\nThis source code is licensed under the Apache License Version 2.0.*/\n\n\npackage apijson;\n\nimport java.text.SimpleDateFormat;\n\n/**测试用日志\n * @modifier Lemon\n */\npublic class Log {\n\tpublic static boolean DEBUG = false;\n\n\tpublic static final String LEVEL_VERBOSE = \"VERBOSE\";\n\tpublic static final String LEVEL_INFO = \"INFO\";\n\tpublic static final String LEVEL_DEBUG = \"DEBUG\";\n\tpublic static final String LEVEL_WARN = \"WARN\";\n\tpublic static final String LEVEL_ERROR = \"ERROR\";\n\n\tpublic static String LEVEL = LEVEL_WARN;\n\n\tpublic static final String VERSION = \"8.1.5\";\n\tpublic static final String KEY_SYSTEM_INFO_DIVIDER = \"\\n---|-----APIJSON SYSTEM INFO-----|---\\n\";\n\n\tpublic static final String OS_NAME;\n\tpublic static final String OS_VERSION;\n\tpublic static final String OS_ARCH;\n\tpublic static final String JAVA_VERSION;\n\tstatic {\n\t\tOS_NAME = System.getProperty(\"os.name\");\n\t\tOS_VERSION = System.getProperty(\"os.version\");\n\t\tOS_ARCH = System.getProperty(\"os.arch\");\n\t\tJAVA_VERSION = System.getProperty(\"java.version\");\n\t}\n\n\n\t//默认的时间格式\n\tpublic static SimpleDateFormat DATE_FORMAT = new SimpleDateFormat(\"yyyy-MM-dd hh:mm:ss.SSS\");\n\n\t/**\n\t * modify date format\n\t * @param dateFormatString\n\t */\n\tpublic static void setDateFormat(String dateFormatString) {\n\t\tDATE_FORMAT = new SimpleDateFormat(dateFormatString);\n\t}\n\n\t/**\n\t * log info by level tag and msg\n\t * @param TAG\n\t * @param msg\n\t * @param level\n\t */\n\tpublic static void logInfo(String TAG, String msg, String level) {\n\t\tif (level == null || level.isEmpty()) {\n\t\t\tlevel = LEVEL;\n\t\t}\n\n\t\tif (level.equals(LEVEL_VERBOSE) || level.equals(LEVEL_INFO)) {\n\t\t\tSystem.out.println(DATE_FORMAT.format(System.currentTimeMillis()) + \": \" + TAG + \".\" + level + \": \" + msg);\n\t\t}\n\t\telse if (level.equals(LEVEL_DEBUG) || level.equals(LEVEL_ERROR) || level.equals(LEVEL_WARN)) {\n\t\t\tSystem.err.println(DATE_FORMAT.format(System.currentTimeMillis()) + \": \" + TAG + \".\" + level + \": \" + msg);\n\t\t}\n\t}\n\n\t/**\n\t * @param TAG\n\t * @param msg\n\t */\n\tpublic static void d(String TAG, String msg) {\n\t\tif (DEBUG) {\n\t\t\tlogInfo(TAG, msg, LEVEL_DEBUG);\n\t\t}\n\t}\n\n\t/**\n\t * Forced debug\n\t * @param TAG tag\n\t * @param msg debug messages\n\t */\n\tpublic static void fd(String TAG, String msg) {\n\t\tlogInfo(TAG, msg, LEVEL_DEBUG);\n\t}\n\n\t/**\n\t * Generate separation line\n\t * @param pre prefix\n\t * @param symbol used for generating separation line\n\t * @param post postfix\n\t */\n\tpublic static void sl(String pre, char symbol, String post) {\n\t\tSystem.err.println(pre + new String(new char[48]).replace('\\u0000', symbol) + post);\n\t}\n\n\t/**\n\t * @param TAG\n\t * @param msg\n\t */\n\tpublic static void v(String TAG, String msg) {\n\t\tif (DEBUG) {\n\t\t\tlogInfo(TAG, msg, LEVEL_VERBOSE);\n\t\t}\n\t}\n\n\t/**\n\t * @param TAG\n\t * @param msg\n\t */\n\tpublic static void i(String TAG, String msg) {\n\t\tif (DEBUG) {\n\t\t\tlogInfo(TAG, msg, LEVEL_INFO);\n\t\t}\n\t}\n\n\t/**\n\t * @param TAG\n\t * @param msg\n\t */\n\tpublic static void e(String TAG, String msg) {\n\t\tif (DEBUG) {\n\t\t\tlogInfo(TAG, msg, LEVEL_ERROR);\n\t\t}\n\t}\n\n\t/**\n\t * @param TAG\n\t * @param msg\n\t */\n\tpublic static void e(String TAG, String msg, Throwable e) {\n\t\tif (DEBUG) {\n\t\t\tif (e != null) {\n\t\t\t\te.printStackTrace();\n\t\t\t}\n\t\t\tlogInfo(TAG, msg, LEVEL_ERROR);\n\t\t}\n\t}\n\n\t/**\n\t * @param TAG\n\t * @param msg\n\t */\n\tpublic static void w(String TAG, String msg) {\n\t\tif (DEBUG) {\n\t\t\tlogInfo(TAG, msg, LEVEL_WARN);\n\t\t}\n\t}\n\n}\n" }, { "path": "APIJSONORM/src/main/java/apijson/MethodAccess.java", "content": "/*Copyright (C) 2020 Tencent. All rights reserved.\n\nThis source code is licensed under the Apache License Version 2.0.*/\n\n\npackage apijson;\n\nimport java.lang.annotation.Documented;\nimport java.lang.annotation.Inherited;\nimport java.lang.annotation.Retention;\nimport java.lang.annotation.Target;\n\nimport static apijson.orm.AbstractVerifier.ADMIN;\nimport static apijson.orm.AbstractVerifier.CIRCLE;\nimport static apijson.orm.AbstractVerifier.CONTACT;\nimport static apijson.orm.AbstractVerifier.LOGIN;\nimport static apijson.orm.AbstractVerifier.OWNER;\nimport static apijson.orm.AbstractVerifier.UNKNOWN;\nimport static java.lang.annotation.ElementType.TYPE;\nimport static java.lang.annotation.RetentionPolicy.RUNTIME;\n\n/**请求方法权限，只允许某些角色通过对应方法访问\n * @author Lemon\n */\n@Documented\n@Retention(RUNTIME)\n@Target(TYPE)\n@Inherited\npublic @interface MethodAccess {\n\n\t/**@see {@link RequestMethod#GET}\n\t * @return 该请求方法允许的角色 default {UNKNOWN, LOGIN, CONTACT, CIRCLE, OWNER, ADMIN};\n\t */\n\tString[] GET() default {UNKNOWN, LOGIN, CONTACT, CIRCLE, OWNER, ADMIN};\n\n\t/**@see {@link RequestMethod#HEAD}\n\t * @return 该请求方法允许的角色 default {UNKNOWN, LOGIN, CONTACT, CIRCLE, OWNER, ADMIN};\n\t */\n\tString[] HEAD() default {UNKNOWN, LOGIN, CONTACT, CIRCLE, OWNER, ADMIN};\n\n\t/**@see {@link RequestMethod#GETS}\n\t * @return 该请求方法允许的角色 default {LOGIN, CONTACT, CIRCLE, OWNER, ADMIN};\n\t */\n\tString[] GETS() default {LOGIN, CONTACT, CIRCLE, OWNER, ADMIN};\n\n\t/**@see {@link RequestMethod#HEADS}\n\t * @return 该请求方法允许的角色 default {LOGIN, CONTACT, CIRCLE, OWNER, ADMIN};\n\t */\n\tString[] HEADS() default {LOGIN, CONTACT, CIRCLE, OWNER, ADMIN};\n\n\t/**@see {@link RequestMethod#POST}\n\t * @return 该请求方法允许的角色 default {LOGIN, ADMIN};\n\t */\n\tString[] POST() default {OWNER, ADMIN};\n\n\t/**@see {@link RequestMethod#PUT}\n\t * @return 该请求方法允许的角色 default {OWNER, ADMIN};\n\t */\n\tString[] PUT() default {OWNER, ADMIN};\n\n\t/**@see {@link RequestMethod#DELETE}\n\t * @return 该请求方法允许的角色 default {OWNER, ADMIN};\n\t */\n\tString[] DELETE() default {OWNER, ADMIN};\n\n}\n" }, { "path": "APIJSONORM/src/main/java/apijson/NotNull.java", "content": "/*Copyright (C) 2020 Tencent. All rights reserved.\n\nThis source code is licensed under the Apache License Version 2.0.*/\n\n\npackage apijson;\n\nimport java.lang.annotation.Documented;\nimport java.lang.annotation.Retention;\nimport java.lang.annotation.Target;\n\nimport static java.lang.annotation.ElementType.ANNOTATION_TYPE;\nimport static java.lang.annotation.ElementType.CONSTRUCTOR;\nimport static java.lang.annotation.ElementType.FIELD;\nimport static java.lang.annotation.ElementType.METHOD;\nimport static java.lang.annotation.ElementType.PARAMETER;\nimport static java.lang.annotation.RetentionPolicy.RUNTIME;\n\n\n/**非null注解\n * javax.validation.constraints.NotNull不在JDK里面，为了减少第三方库引用就在这里实现了一个替代品\n * @author Lemon\n */\n@Target({ METHOD, FIELD, ANNOTATION_TYPE, CONSTRUCTOR, PARAMETER })\n@Retention(RUNTIME)\n@Documented\npublic @interface NotNull {\n}\n" }, { "path": "APIJSONORM/src/main/java/apijson/RequestMethod.java", "content": "/*Copyright (C) 2020 Tencent. All rights reserved.\n\nThis source code is licensed under the Apache License Version 2.0.*/\n\n\npackage apijson;\n\nimport java.util.Arrays;\nimport java.util.List;\n\n/**请求方法，对应org.springframework.web.bind.annotation.RequestMethod，多出GETS,HEADS方法\n * @author Lemon\n */\npublic enum RequestMethod {\n\n\t/**\n\t * 常规获取数据方式\n\t */\n\tGET,\n\t\n\t/**\n\t * 检查，默认是非空检查，返回数据总数\n\t */\n\tHEAD,\n\t\n\t/**Safe, Single, Simple\n\t *
限制性GET，通过POST来GET数据，不显示请求内容和返回结果，并且校验请求，一般用于对安全要求比较高的请求\n\t */\n\tGETS,\n\t\n\t/**Safe, Single, Simple\n\t *
限制性HEAD，通过POST来HEAD数据，不显示请求内容和返回结果，并且校验请求，一般用于对安全要求比较高的请求\n\t */\n\tHEADS,\n\t\n\t/**\n\t * 新增(或者说插入)数据\n\t */\n\tPOST,\n\t\n\t/**\n\t * 修改数据，只修改传入字段对应的值\n\t */\n\tPUT,\n\t\n\t/**\n\t * 删除数据\n\t */\n\tDELETE,\n\n\t/**\n\t * json 包含多条语句，支持增删改查、函数调用\n\t */\n\tCRUD;\n\t\n\tpublic static final RequestMethod[] ALL = new RequestMethod[]{ GET, HEAD, GETS, HEADS, POST, PUT, DELETE, CRUD };\n\tpublic static final List ALL_NAME_LIST = Arrays.asList(\n\t\t\tGET.name(), HEAD.name(), GETS.name(), HEADS.name(), POST.name(), PUT.name(), DELETE.name(), CRUD.name()\n\t);\n\n\t/**是否为GET请求方法\n\t * @param method\n\t * @param containPrivate 包含私密(非明文)获取方法GETS\n\t * @return\n\t */\n\tpublic static boolean isGetMethod(RequestMethod method, boolean containPrivate) {\n\t\treturn method == null || method == GET || (containPrivate && method == GETS);\n\t}\n\t\n\t/**是否为HEAD请求方法\n\t * @param method\n\t * @param containPrivate 包含私密(非明文)获取方法HEADS\n\t * @return\n\t */\n\tpublic static boolean isHeadMethod(RequestMethod method, boolean containPrivate) {\n\t\treturn method == HEAD || (containPrivate && method == HEADS);\n\t}\n\t\n\t/**是否为查询的请求方法\n\t * @param method\n\t * @return 读操作(GET型或HEAD型) - true, 写操作(POST,PUT,DELETE) - false\n\t */\n\tpublic static boolean isQueryMethod(RequestMethod method) {\n\t\treturn isGetMethod(method, true) || isHeadMethod(method, true);\n\t}\n\n\t/**是否为更新(增删改)的请求方法\n\t * @param method\n\t * @return 读操作(GET型或HEAD型) - false, 写操作(POST,PUT,DELETE) - true\n\t */\n\tpublic static boolean isUpdateMethod(RequestMethod method) {\n\t\treturn ! isQueryMethod(method);\n\t}\n\t\n\t/**是否为开放(不限制请求的结构或内容；明文，浏览器能直接访问及查看)的请求方法\n\t * @param method\n\t * @return\n\t */\n\tpublic static boolean isPublicMethod(RequestMethod method) {\n\t\treturn method == null || method == GET || method == HEAD;\n\t}\n\n\t/**是否为私有(限制请求的结构或内容)的请求方法\n\t * @param method\n\t * @return\n\t */\n\tpublic static boolean isPrivateMethod(RequestMethod method) {\n\t\treturn ! isPublicMethod(method);\n\t}\n\n\tpublic static String getName(RequestMethod method) {\n\t\treturn method == null ? GET.name() : method.name();\n\t}\n\t\n}\n" }, { "path": "APIJSONORM/src/main/java/apijson/SQL.java", "content": "/*Copyright (C) 2020 Tencent. All rights reserved.\n\nThis source code is licensed under the Apache License Version 2.0.*/\n\n\npackage apijson;\n\n/**SQL语句，函数名尽量和JDK中相同或类似功能的函数的名称一致\n * @author Lemon\n */\npublic class SQL {\n\n\tpublic static final String JOIN = \" JOIN \";\n\tpublic static final String ON = \" ON \";\n\tpublic static final String OR = \" OR \";\n\tpublic static final String AND = \" AND \";\n\tpublic static final String NOT = \" NOT \";\n\tpublic static final String AS = \" AS \";\n\tpublic static final String IS = \" IS \";\n\tpublic static final String NULL = \" NULL \";\n\tpublic static final String IS_NOT = \" IS NOT \";\n\tpublic static final String IS_NULL = \" IS NULL \";\n\tpublic static final String IS_NOT_NULL = \" IS NOT NULL \";\n\n\t//括号必须紧跟函数名！ count (...) 报错！\n\tpublic static final String COUNT = \"count\";\n\tpublic static final String SUM = \"sum\";\n\tpublic static final String MAX = \"max\";\n\tpublic static final String MIN = \"min\";\n\tpublic static final String AVG = \"avg\";\n\n\t/**\n\t * isNull = true \n\t * @return {@link #isNull(boolean)}\n\t */\n\tpublic static String isNull() {\n\t\treturn isNull(true);\n\t}\n\t/**\n\t * @param isNull\n\t * @return {@link #IS} + (isNull ? \"\" : {@link #NOT}) + {@link #NULL};\n\t */\n\tpublic static String isNull(boolean isNull) {\n\t\treturn IS + (isNull ? \"\" : NOT) + NULL;\n\t}\n\t/**\n\t * isNull = true\n\t * @param s\n\t * @return {@link #isNull(String, boolean)}\n\t */\n\tpublic static String isNull(String s) {\n\t\treturn isNull(s, true);\n\t}\n\t/**\n\t * @param s\n\t * @param isNull\n\t * @return s + {@link #isNull(boolean)}\n\t */\n\tpublic static String isNull(String s, boolean isNull) {\n\t\treturn s + isNull(isNull);\n\t}\n\n\t/**\n\t * isEmpty = true\n\t * @param s\n\t * @return {@link #isEmpty(String, boolean)}\n\t */\n\tpublic static String isEmpty(String s) {\n\t\treturn isEmpty(s, true);\n\t}\n\t/**\n\t * trim = false\n\t * @param s\n\t * @param isEmpty\n\t * @return {@link #isEmpty(String, boolean, boolean)}\n\t */\n\tpublic static String isEmpty(String s, boolean isEmpty) {\n\t\treturn isEmpty(s, isEmpty, false);\n\t}\n\t/**\n\t * nullable = true\n\t * @param s\n\t * @param isEmpty <=0\n\t * @param trim s = trim(s);\n\t * @return {@link #isEmpty(String, boolean, boolean, boolean)}\n\t */\n\tpublic static String isEmpty(String s, boolean isEmpty, boolean trim) {\n\t\treturn isEmpty(s, isEmpty, trim, true);\n\t}\n\t/**\n\t * @param s\n\t * @param isEmpty <=0\n\t * @param trim s = trim(s);\n\t * @param nullable isNull(s, true) + {@link #OR} +\n\t * @return {@link #lengthCompare(String, String)}\n\t */\n\tpublic static String isEmpty(String s, boolean isEmpty, boolean trim, boolean nullable) {\n\t\tif (trim) {\n\t\t\ts = trim(s);\n\t\t}\n\t\treturn (nullable ? isNull(s, true) + OR : \"\") + lengthCompare(s, (isEmpty ? \"<=\" : \">\") + \"0\");\n\t}\n\t/**\n\t * @param s 因为POWER(x,y)等函数含有不只一个key，所以需要客户端添加进去，服务端检测到条件中有'('和')'时就不转换，直接当SQL语句查询\n\t * @return {@link #length(String)} + compare\n\t */\n\tpublic static String lengthCompare(String s, String compare) {\n\t\treturn length(s) + compare;\n\t}\n\n\n\t/**\n\t * @param s 因为POWER(x,y)等函数含有不只一个key，所以需要客户端添加进去，服务端检测到条件中有'('和')'时就不转换，直接当SQL语句查询\n\t * @return \"length(\" + s + \")\"\n\t */\n\tpublic static String length(String s) {\n\t\treturn \"length(\" + s + \")\";\n\t}\n\t/**\n\t * @param s 因为POWER(x,y)等函数含有不只一个key，所以需要客户端添加进去，服务端检测到条件中有'('和')'时就不转换，直接当SQL语句查询\n\t * @return \"json_length(\" + s + \")\"\n\t */\n\tpublic static String json_length(String s) {\n\t\treturn \"json_length(\" + s + \")\";\n\t}\n\t/**\n\t * @param s 因为POWER(x,y)等函数含有不只一个key，所以需要客户端添加进去，服务端检测到条件中有'('和')'时就不转换，直接当SQL语句查询\n\t * @return \"char_length(\" + s + \")\"\n\t */\n\tpublic static String charLength(String s) {\n\t\treturn \"char_length(\" + s + \")\";\n\t}\n\n\t/**\n\t * @param s\n\t * @return \"trim(\" + s + \")\"\n\t */\n\tpublic static String trim(String s) {\n\t\treturn \"trim(\" + s + \")\";\n\t}\n\t/**\n\t * @param s\n\t * @return \"ltrim(\" + s + \")\"\n\t */\n\tpublic static String trimLeft(String s) {\n\t\treturn \"ltrim(\" + s + \")\";\n\t}\n\t/**\n\t * @param s\n\t * @return \"rtrim(\" + s + \")\"\n\t */\n\tpublic static String trimRight(String s) {\n\t\treturn \"rtrim(\" + s + \")\";\n\t}\n\n\t/**\n\t * @param s\n\t * @param n\n\t * @return \"left(\" + s + \",\" + n + \")\"\n\t */\n\tpublic static String left(String s, int n) {\n\t\treturn \"left(\" + s + \",\" + n + \")\";\n\t}\n\t/**\n\t * @param s\n\t * @param n\n\t * @return \"right(\" + s + \",\" + n + \")\"\n\t */\n\tpublic static String right(String s, int n) {\n\t\treturn \"right(\" + s + \",\" + n + \")\";\n\t}\n\n\t/**\n\t * @param s\n\t * @param start\n\t * @param end\n\t * @return \"substring(\" + s + \",\" + start + \",\" + (end-start) + \")\"\n\t */\n\tpublic static String subString(String s, int start, int end) {\n\t\treturn \"substring(\" + s + \",\" + start + \",\" + (end-start) + \")\";\n\t}\n\n\t/**\n\t * @param s\n\t * @param c\n\t * @return \"instr(\" + s + \", \" + c + \")\"\n\t */\n\tpublic static String indexOf(String s, String c) {\n\t\treturn \"instr(\" + s + \", \" + c + \")\";\n\t}\n\n\t/**\n\t * @param s\n\t * @param c1\n\t * @param c2\n\t * @return \"replace(\" + s + \", \" + c1 + \", \" + c2 + \")\"\n\t */\n\tpublic static String replace(String s, String c1, String c2) {\n\t\treturn \"replace(\" + s + \", \" + c1 + \", \" + c2 + \")\";\n\t}\n\n\t/**\n\t * @param s1\n\t * @param s2\n\t * @return \"concat(\" + s1 + \", \" + s2 + \")\"\n\t */\n\tpublic static String concat(String s1, String s2) {\n\t\treturn \"concat(\" + s1 + \", \" + s2 + \")\";\n\t}\n\n\t/**\n\t * @param s1\n\t * @param s2\n\t * @return \"strcmp(\" + s1 + \", \" + s2 + \")\"\n\t */\n\tpublic static String equals(String s1, String s2) {\n\t\treturn \"strcmp(\" + s1 + \", \" + s2 + \")\";\n\t}\n\n\t/**\n\t * @param s\n\t * @return \"upper(\" + s + \")\"\n\t */\n\tpublic static String toUpperCase(String s) {\n\t\treturn \"upper(\" + s + \")\";\n\t}\n\t/**\n\t * @param s\n\t * @return \"lower(\" + s + \")\"\n\t */\n\tpublic static String toLowerCase(String s) {\n\t\treturn \"lower(\" + s + \")\";\n\t}\n\n\n\n\n\t//column and function<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<\n\n\t/**字段\n\t * @param column\n\t * @return column.isEmpty() ? \"*\" : column;\n\t */\n\tpublic static String column(String column) {\n\t\tcolumn = StringUtil.trim(column);\n\t\treturn column.isEmpty() ? \"*\" : column;\n\t}\n\t/**有别名的字段\n\t * @param column\n\t * @return {@link #count(String)} + {@link #AS};\n\t */\n\tpublic static String columnAs(String column) {\n\t\treturn count(column) + AS;\n\t}\n\n\t/**函数\n\t * @param column if (StringUtil.isEmpty(column, true) || column.contains(\",\")) -> column = null;\n\t * @return \" \" + fun + \"(\" + {@link #column(String)} + \") \";\n\t */\n\tpublic static String function(String fun, String column) {\n\t\t// 支持 fun(col1,col2..) \n\t\t//\t\tif (StringUtil.isEmpty(column, true) || column.contains(\",\")) {\n\t\t//\t\t\tcolumn = null; //解决 count(id,name) 这种多个字段导致的SQL异常\n\t\t//\t\t}\n\t\treturn \" \" + fun + \"(\" + column(column) + \") \";\n\t}\n\t/**有别名的函数\n\t * @param column\n\t * @return {@link #function(String, String)} + {@link #AS} + fun;\n\t */\n\tpublic static String functionAs(String fun, String column) {\n\t\treturn function(fun, column) + AS + fun + \" \";\n\t}\n\n\t/**计数\n\t * column = null\n\t * @return {@link #count(String)}\n\t */\n\tpublic static String count() {\n\t\treturn count(null);\n\t}\n\t/**计数\n\t * fun = {@link #COUNT}\n\t * @param column\n\t * @return {@link #functionAs(String, String)}\n\t */\n\tpublic static String count(String column) {\n\t\treturn functionAs(COUNT, column);\n\t}\n\t/**求和\n\t * fun = {@link #SUM}\n\t * @param column\n\t * @return {@link #functionAs(String, String)}\n\t */\n\tpublic static String sum(String column) {\n\t\treturn functionAs(SUM, column);\n\t}\n\t/**最大值\n\t * fun = {@link #MAX}\n\t * @param column\n\t * @return {@link #functionAs(String, String)}\n\t */\n\tpublic static String max(String column) {\n\t\treturn functionAs(MAX, column);\n\t}\n\t/**最小值\n\t * fun = {@link #MIN}\n\t * @param column\n\t * @return {@link #functionAs(String, String)}\n\t */\n\tpublic static String min(String column) {\n\t\treturn functionAs(MIN, column);\n\t}\n\t/**平均值\n\t * fun = {@link #AVG}\n\t * @param column\n\t * @return {@link #functionAs(String, String)}\n\t */\n\tpublic static String avg(String column) {\n\t\treturn functionAs(AVG, column);\n\t}\n\n\t//column and function>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>\n\n\n\n\t//search<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<\n\n\tpublic static final int SEARCH_TYPE_CONTAIN_FULL = 0;\n\tpublic static final int SEARCH_TYPE_CONTAIN_ORDER = 1;\n\tpublic static final int SEARCH_TYPE_CONTAIN_SINGLE = 2;\n\tpublic static final int SEARCH_TYPE_CONTAIN_ANY = 3;\n\tpublic static final int SEARCH_TYPE_START = 4;\n\tpublic static final int SEARCH_TYPE_END = 5;\n\tpublic static final int SEARCH_TYPE_START_SINGLE = 6;\n\tpublic static final int SEARCH_TYPE_END_SINGLE = 7;\n\tpublic static final int SEARCH_TYPE_PART_MATCH = 8;\n\t/**获取搜索值\n\t * @param s\n\t * @return\n\t */\n\tpublic static String search(String s) {\n\t\treturn search(s, SEARCH_TYPE_CONTAIN_FULL);\n\t}\n\t/**获取搜索值\n\t * @param s\n\t * @param type\n\t * @return\n\t */\n\tpublic static String search(String s, int type) {\n\t\treturn search(s, type, true);\n\t}\n\t/**获取搜索值\n\t * @param s\n\t * @param type\n\t * @param ignoreCase\n\t * @return default SEARCH_TYPE_CONTAIN_FULL\n\t */\n\tpublic static String search(String s, int type, boolean ignoreCase) {\n\t\tif (s == null) {\n\t\t\treturn null;\n\t\t}\n\t\tswitch (type) {\n\t\tcase SEARCH_TYPE_CONTAIN_SINGLE:\n\t\t\treturn \"_\" + s + \"_\";\n\t\tcase SEARCH_TYPE_CONTAIN_ORDER:\n\t\t\tchar[] cs = s.toCharArray();\n\t\t\tif (cs == null) {\n\t\t\t\treturn null;\n\t\t\t}\n\t\t\tString value = \"%\";\n\t\t\tfor (int i = 0; i < cs.length; i++) {\n\t\t\t\tvalue += cs[i] + \"%\";\n\t\t\t}\n\t\t\treturn value;\n\t\tcase SEARCH_TYPE_START:\n\t\t\treturn s + \"%\";\n\t\tcase SEARCH_TYPE_END:\n\t\t\treturn \"%\" + s;\n\t\tcase SEARCH_TYPE_START_SINGLE:\n\t\t\treturn s + \"_\";\n\t\tcase SEARCH_TYPE_END_SINGLE:\n\t\t\treturn \"_\" + s;\n\t\tcase SEARCH_TYPE_CONTAIN_ANY:\n\t\tcase SEARCH_TYPE_PART_MATCH:\n\t\t\tcs = s.toCharArray();\n\t\t\tif (cs == null) {\n\t\t\t\treturn null;\n\t\t\t}\n\t\t\tvalue = \"\";\n\t\t\tfor (int i = 0; i < cs.length; i++) {\n\t\t\t\tvalue += search(\"\" + cs[i], SEARCH_TYPE_CONTAIN_FULL, ignoreCase);\n\t\t\t}\n\t\t\treturn value;\n\t\tdefault://SEARCH_TYPE_CONTAIN_FULL\n\t\t\treturn \"%\" + s + \"%\";\n\t\t}\n\t}\n\n\t//search>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>\n\n\n\tpublic static boolean isBooleanOrNumber(String type) {\n\t\ttype = StringUtil.toUpperCase(type, true);\n\t\treturn type.isEmpty() || (type.endsWith(\"INT\") && type.endsWith(\"POINT\") == false)\n\t\t\t\t|| type.endsWith(\"BOOLEAN\") || type.endsWith(\"ENUM\")\n\t\t\t\t|| type.endsWith(\"FLOAT\") || type.endsWith(\"DOUBLE\") || type.endsWith(\"DECIMAL\");\n\t}\n\n\n}\n" }, { "path": "APIJSONORM/src/main/java/apijson/StringUtil.java", "content": "/*Copyright (C) 2020 Tencent. All rights reserved.\n\nThis source code is licensed under the Apache License Version 2.0.*/\n\n\npackage apijson;\n\nimport java.io.File;\nimport java.math.BigDecimal;\nimport java.text.DecimalFormat;\nimport java.util.Objects;\nimport java.util.regex.Pattern;\n\n/**通用字符串(String)相关类,为null时返回\"\"\n * @author Lemon\n * @use StringUtil.\n */\npublic class StringUtil {\n\tprivate static final String TAG = \"StringUtil\";\n\n\tpublic StringUtil() {\n\t}\n\n\tpublic static final String UTF_8 = \"utf-8\";\n\n\tpublic static final String EMPTY = \"无\";\n\tpublic static final String UNKNOWN = \"未知\";\n\tpublic static final String UNLIMITED = \"不限\";\n\n\tpublic static final String I = \"我\";\n\tpublic static final String YOU = \"你\";\n\tpublic static final String HE = \"他\";\n\tpublic static final String SHE = \"她\";\n\tpublic static final String IT = \"它\";\n\n\tpublic static final String MALE = \"男\";\n\tpublic static final String FEMALE = \"女\";\n\n\tpublic static final String TODO = \"未完成\";\n\tpublic static final String DONE = \"已完成\";\n\n\tpublic static final String FAIL = \"失败\";\n\tpublic static final String SUCCESS = \"成功\";\n\n\tpublic static final String SUNDAY = \"日\";\n\tpublic static final String MONDAY = \"一\";\n\tpublic static final String TUESDAY = \"二\";\n\tpublic static final String WEDNESDAY = \"三\";\n\tpublic static final String THURSDAY = \"四\";\n\tpublic static final String FRIDAY = \"五\";\n\tpublic static final String SATURDAY = \"六\";\n\n\tpublic static final String YUAN = \"元\";\n\n\n\tprivate static String current = \"\";\n\t/**获取刚传入处理后的 string\n\t * @must 上个影响 current 的方法 和 这个方法都应该在同一线程中，否则返回值可能不对\n\t * @return\n\t */\n\tpublic static String cur() {\n\t\treturn get(current);\n\t}\n\n\t/**FIXME 改用 cur\n\t * @must 上个影响currentString的方法 和 这个方法都应该在同一线程中，否则返回值可能不对\n\t * @return\n\t */\n\t@Deprecated\n\tpublic static String getCurrentString() {\n\t\treturn cur();\n\t}\n\n\t//获取string,为null时返回\"\" <<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<\n\n\t/**获取string,为null则返回\"\"\n\t * @param obj\n\t * @return\n\t */\n\tpublic static String get(Object obj) {\n\t\treturn obj == null ? \"\" : obj.toString();\n\t}\n\t/**获取string,为null则返回\"\"\n\t * @param s\n\t * @return\n\t */\n\tpublic static String get(String s) {\n\t\treturn s == null ? \"\" : s;\n\t}\n\t/**获取string,为null则返回\"\"\n\t * ignoreEmptyItem = false;\n\t * split = \",\"\n\t * @param arr\n\t * @return {@link #get(Object[], boolean)}\n\t */\n\tpublic static String get(Object[] arr) {\n\t\treturn get(arr, false);\n\t}\n\t/**获取string,为null则返回\"\"\n\t * split = \",\"\n\t * @param arr\n\t * @param ignoreEmptyItem\n\t * @return {@link #get(Object[], boolean)}\n\t */\n\tpublic static String get(Object[] arr, boolean ignoreEmptyItem) {\n\t\treturn get(arr, null, ignoreEmptyItem);\n\t}\n\t/**获取string,为null则返回\"\"\n\t * ignoreEmptyItem = false;\n\t * @param arr\n\t * @param split\n\t * @return {@link #get(Object[], String, boolean)}\n\t */\n\tpublic static String get(Object[] arr, String split) {\n\t\treturn get(arr, split, false);\n\t}\n\t//CS304 Issue link: https://github.com/Tencent/APIJSON/issues/182\n\t/**获取string,为null则返回\"\"\n\t * @param arr -the str arr given\n\t * @param split -the token used to split\n\t * @param ignoreEmptyItem -whether to ignore empty item or not\n\t * @return {@link #get(Object[], String, boolean)}\n\t *

Here we replace the simple \"+\" way of concatenating with Stringbuilder 's append

\n\t */\n\tpublic static String get(Object[] arr, String split, boolean ignoreEmptyItem) {\n\t\tStringBuilder s = new StringBuilder(\"\");\n\t\tif (arr != null) {\n\t\t\tif (split == null) {\n\t\t\t\tsplit = \",\";\n\t\t\t}\n\t\t\tfor (int i = 0; i < arr.length; i++) {\n\t\t\t\tif (ignoreEmptyItem && isEmpty(arr[i], true)) {\n\t\t\t\t\tcontinue;\n\t\t\t\t}\n\t\t\t\ts.append(((i > 0 ? split : \"\") + arr[i]));\n\t\t\t}\n\t\t}\n\t\treturn get(s.toString());\n\t}\n\n\t/**FIXME 用 get 替代\n\t * @param object\n\t * @return\n\t */\n\t@Deprecated\n\tpublic static String getString(Object object) {\n\t\treturn object == null ? \"\" : object.toString();\n\t}\n\t/**FIXME 用 get 替代\n\t * @param cs\n\t * @return\n\t */\n\t@Deprecated\n\tpublic static String getString(CharSequence cs) {\n\t\treturn cs == null ? \"\" : cs.toString();\n\t}\n\t/**FIXME 用 get 替代\n\t * @param s\n\t * @return\n\t */\n\t@Deprecated\n\tpublic static String getString(String s) {\n\t\treturn s == null ? \"\" : s;\n\t}\n\t/**FIXME 用 get 替代\n\t * ignoreEmptyItem = false;\n\t * split = \",\"\n\t * @param array\n\t * @return {@link #get(Object[], boolean)}\n\t */\n\t@Deprecated\n\tpublic static String getString(Object[] array) {\n\t\treturn get(array, false);\n\t}\n\t/**FIXME 用 get 替代\n\t * split = \",\"\n\t * @param array\n\t * @param ignoreEmptyItem\n\t * @return {@link #get(Object[], boolean)}\n\t */\n\t@Deprecated\n\tpublic static String getString(Object[] array, boolean ignoreEmptyItem) {\n\t\treturn get(array, null, ignoreEmptyItem);\n\t}\n\t/**FIXME 用 get 替代\n\t * ignoreEmptyItem = false;\n\t * @param array\n\t * @param split\n\t * @return {@link #get(Object[], String, boolean)}\n\t */\n\t@Deprecated\n\tpublic static String getString(Object[] array, String split) {\n\t\treturn get(array, split, false);\n\t}\n\t//CS304 Issue link: https://github.com/Tencent/APIJSON/issues/182\n\t/**FIXME 用 get 替代\n\t * @param array -the str array given\n\t * @param split -the token used to split\n\t * @param ignoreEmptyItem -whether to ignore empty item or not\n\t * @return {@link #get(Object[], String, boolean)}\n\t *

Here we replace the simple \"+\" way of concatenating with Stringbuilder 's append

\n\t */\n\t@Deprecated\n\tpublic static String getString(Object[] array, String split, boolean ignoreEmptyItem) {\n\t\treturn get(array, split, ignoreEmptyItem);\n\t}\n\n\t//获取string,为null时返回\"\" >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>\n\n\t//获取去掉前后空格后的string<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<\n\t/**获取去掉前后空格后的string,为null则返回\"\"\n\t * @param obj\n\t * @return\n\t */\n\tpublic static String trim(Object obj) {\n\t\treturn trim(get(obj));\n\t}\n\t/**获取去掉前后空格后的string,为null则返回\"\"\n\t * @param cs\n\t * @return\n\t */\n\tpublic static String trim(CharSequence cs) {\n\t\treturn trim(get(cs));\n\t}\n\t/**获取去掉前后空格后的string,为null则返回\"\"\n\t * @param s\n\t * @return\n\t */\n\tpublic static String trim(String s) {\n\t\treturn get(s).trim();\n\t}\n\n\n\t/**FIXME 用 trim 替代\n\t * @param object\n\t * @return\n\t */\n\t@Deprecated\n\tpublic static String getTrimedString(Object object) {\n\t\treturn trim(object);\n\t}\n\t/**FIXME 用 trim 替代\n\t * @param cs\n\t * @return\n\t */\n\t@Deprecated\n\tpublic static String getTrimedString(CharSequence cs) {\n\t\treturn trim(cs);\n\t}\n\t/**FIXME 用 trim 替代\n\t * @param s\n\t * @return\n\t */\n\t@Deprecated\n\tpublic static String getTrimedString(String s) {\n\t\treturn trim(s);\n\t}\n\n\t//获取去掉前后空格后的string>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>\n\n\n\t//获取去掉所有空格后的string <<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<\n\t/**获取去掉所有空格后的string,为null则返回\"\"\n\t * @param obj\n\t * @return\n\t */\n\tpublic static String noBlank(Object obj) {\n\t\treturn noBlank(get(obj));\n\t}\n\t/**获取去掉所有空格后的string,为null则返回\"\"\n\t * @param cs\n\t * @return\n\t */\n\tpublic static String noBlank(CharSequence cs) {\n\t\treturn noBlank(get(cs));\n\t}\n\t/**获取去掉所有空格后的string,为null则返回\"\"\n\t * @param s\n\t * @return\n\t */\n\tpublic static String noBlank(String s) {\n\t\treturn get(s).replaceAll(\"\\\\s\", \"\");\n\t}\n\n\t/**FIXME 用 noBlank 替代\n\t * @param object\n\t * @return\n\t */\n\t@Deprecated\n\tpublic static String getNoBlankString(Object object) {\n\t\treturn noBlank(object);\n\t}\n\t/**FIXME 用 noBlank 替代\n\t * @param cs\n\t * @return\n\t */\n\t@Deprecated\n\tpublic static String getNoBlankString(CharSequence cs) {\n\t\treturn noBlank(cs);\n\t}\n\t/**FIXME 用 noBlank 替代\n\t * @param s\n\t * @return\n\t */\n\t@Deprecated\n\tpublic static String getNoBlankString(String s) {\n\t\treturn noBlank(s);\n\t}\n\n\t//获取去掉所有空格后的string >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>\n\n\n\t//获取string的长度<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<\n\t/**获取string的长度,为null则返回0\n\t * @param object\n\t * @param trim\n\t * @return\n\t */\n\tpublic static int length(Object object, boolean trim) {\n\t\treturn length(get(object), trim);\n\t}\n\t/**获取string的长度,为null则返回0\n\t * @param cs\n\t * @param trim\n\t * @return\n\t */\n\tpublic static int length(CharSequence cs, boolean trim) {\n\t\treturn length(get(cs), trim);\n\t}\n\t/**获取string的长度,为null则返回0\n\t * @param s\n\t * @param trim\n\t * @return\n\t */\n\tpublic static int length(String s, boolean trim) {\n\t\ts = trim ? trim(s) : s;\n\t\treturn get(s).length();\n\t}\n\n\n\t/**FIXME 用 length 替代\n\t * @param object\n\t * @param trim\n\t * @return\n\t */\n\t@Deprecated\n\tpublic static int getLength(Object object, boolean trim) {\n\t\treturn length(object, trim);\n\t}\n\t/**FIXME 用 length 替代\n\t * @param cs\n\t * @param trim\n\t * @return\n\t */\n\t@Deprecated\n\tpublic static int getLength(CharSequence cs, boolean trim) {\n\t\treturn length(cs, trim);\n\t}\n\t/**FIXME 用 length 替代\n\t * @param s\n\t * @param trim\n\t * @return\n\t */\n\t@Deprecated\n\tpublic static int getLength(String s, boolean trim) {\n\t\treturn length(s, trim);\n\t}\n\n\t//获取string的长度>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>\n\n\n\t//判断字符是否为空 <<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<\n\n\t/**判断字符是否为空 trim = true\n\t * @param obj\n\t * @return\n\t */\n\tpublic static boolean isEmpty(Object obj) {\n\t\treturn isEmpty(obj, true);\n\t}\n\t/**判断字符是否为空\n\t * @param obj\n\t * @param trim\n\t * @return\n\t */\n\tpublic static boolean isEmpty(Object obj, boolean trim) {\n\t\treturn isEmpty(get(obj), trim);\n\t}\n\t/**判断字符是否为空 trim = true\n\t * @param cs\n\t * @return\n\t */\n\tpublic static boolean isEmpty(CharSequence cs) {\n\t\treturn isEmpty(cs, true);\n\t}\n\t/**判断字符是否为空\n\t * @param cs\n\t * @param trim\n\t * @return\n\t */\n\tpublic static boolean isEmpty(CharSequence cs, boolean trim) {\n\t\treturn isEmpty(get(cs), trim);\n\t}\n\t/**判断字符是否为空 trim = true\n\t * @param s\n\t * @return\n\t */\n\tpublic static boolean isEmpty(String s) {\n\t\treturn isEmpty(s, true);\n\t}\n\t/**判断字符是否为空\n\t * @param s\n\t * @param trim\n\t * @return\n\t */\n\tpublic static boolean isEmpty(String s, boolean trim) {\n\t\t//\t\tLog.i(TAG, \"isEmpty s = \" + s);\n\t\tif (s == null) {\n\t\t\treturn true;\n\t\t}\n\t\tif (trim) {\n\t\t\ts = s.trim();\n\t\t}\n\t\tif (s.isEmpty()) {\n\t\t\treturn true;\n\t\t}\n\n\t\tcurrent = s;\n\n\t\treturn false;\n\t}\n\n\t//判断字符是否为空 >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>\n\n\t//判断字符是否非空 <<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<\n\n\t/**判断字符是否非空 trim = true\n\t * @param obj\n\t * @return\n\t */\n\tpublic static boolean isNotEmpty(Object obj) {\n\t\treturn ! isEmpty(obj);\n\t}\n\t/**判断字符是否非空\n\t * @param obj\n\t * @param trim\n\t * @return\n\t */\n\tpublic static boolean isNotEmpty(Object obj, boolean trim) {\n\t\treturn ! isEmpty(obj, trim);\n\t}\n\t/**判断字符是否非空 trim = true\n\t * @param cs\n\t * @return\n\t */\n\tpublic static boolean isNotEmpty(CharSequence cs) {\n\t\treturn ! isEmpty(cs);\n\t}\n\t/**判断字符是否非空\n\t * @param cs\n\t * @param trim\n\t * @return\n\t */\n\tpublic static boolean isNotEmpty(CharSequence cs, boolean trim) {\n\t\treturn ! isEmpty(cs, trim);\n\t}\n\t/**判断字符是否非空 trim = true\n\t * @param s\n\t * @return\n\t */\n\tpublic static boolean isNotEmpty(String s) {\n\t\treturn ! isEmpty(s);\n\t}\n\t/**判断字符是否非空\n\t * @param s\n\t * @param trim\n\t * @return\n\t */\n\tpublic static boolean isNotEmpty(String s, boolean trim) {\n\t\treturn ! isEmpty(s, trim);\n\t}\n\n\t//判断字符是否非空 >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>\n\n\n\t//判断字符类型 <<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<\n\n\tpublic static final Pattern PATTERN_NUMBER;\n\tpublic static final Pattern PATTERN_PHONE;\n\tpublic static final Pattern PATTERN_EMAIL;\n\tpublic static final Pattern PATTERN_ID_CARD;\n\tpublic static final Pattern PATTERN_NUM_OR_ALPHA;\n\tpublic static final Pattern PATTERN_ALPHA;\n\tpublic static final Pattern PATTERN_PASSWORD; //TODO\n\tpublic static final Pattern PATTERN_NAME;\n\tpublic static final Pattern PATTERN_ALPHA_BIG;\n\tpublic static final Pattern PATTERN_ALPHA_SMALL;\n\tpublic static final Pattern PATTERN_BRANCH_URL;\n\tstatic {\n\t\tPATTERN_NUMBER = Pattern.compile(\"^[0-9]+$\");\n\t\tPATTERN_NUM_OR_ALPHA = Pattern.compile(\"^[0-9a-zA-Z_.:]+$\");\n\t\tPATTERN_ALPHA = Pattern.compile(\"^[a-zA-Z]+$\");\n\t\tPATTERN_ALPHA_BIG = Pattern.compile(\"^[A-Z]+$\");\n\t\tPATTERN_ALPHA_SMALL = Pattern.compile(\"^[a-z]+$\");\n\t\tPATTERN_NAME = Pattern.compile(\"^[0-9a-zA-Z_.:]+$\");//已用55个中英字符测试通过\n\t\t//newest phone regex expression reference https://github.com/VincentSit/ChinaMobilePhoneNumberRegex\n\t\tPATTERN_PHONE = Pattern.compile(\"^1(?:3\\\\d{3}|5[^4\\\\D]\\\\d{2}|8\\\\d{3}|7(?:[0-35-9]\\\\d{2}|4(?:0\\\\d|1[0-2]|9\\\\d))|9[0-35-9]\\\\d{2}|6[2567]\\\\d{2}|4(?:(?:10|4[01])\\\\d{3}|[68]\\\\d{4}|[579]\\\\d{2}))\\\\d{6}$\");\n\t\tPATTERN_EMAIL = Pattern.compile(\"^([a-zA-Z0-9_\\\\-\\\\.]+)@((\\\\[[0-9]{1,3}\\\\.[0-9]{1,3}\\\\.[0-9]{1,3}\\\\.)|(([a-zA-Z0-9\\\\-]+\\\\.)+))([a-zA-Z]{2,4}|[0-9]{1,3})(\\\\]?)$\");\n\t\tPATTERN_ID_CARD = Pattern.compile(\"(^[1-9]\\\\d{5}(18|19|([23]\\\\d))\\\\d{2}((0[1-9])|(10|11|12))(([0-2][1-9])|10|20|30|31)\\\\d{3}[0-9Xx]$)|(^[1-9]\\\\d{5}\\\\d{2}((0[1-9])|(10|11|12))(([0-2][1-9])|10|20|30|31)\\\\d{2}$)\");\n\t\tPATTERN_PASSWORD = Pattern.compile(\"^[0-9a-zA-Z]+$\");\n\t\tPATTERN_BRANCH_URL = Pattern.compile(\"^[0-9a-zA-Z-_/]+$\");\n\t}\n\n\t/**判断手机格式是否正确\n\t * @param phone\n\t * @return\n\t */\n\tpublic static boolean isPhone(String phone) {\n\t\tif (isNotEmpty(phone, true) == false) {\n\t\t\treturn false;\n\t\t}\n\n\t\tcurrent = phone;\n\t\treturn PATTERN_PHONE.matcher(phone).matches();\n\t}\n\t/**判断手机格式是否正确\n\t * @param s\n\t * @return\n\t */\n\tpublic static boolean isPassword(String s) {\n\t\treturn length(s, false) >= 6 && PATTERN_PASSWORD.matcher(s).matches();\n\t}\n\t/**判断是否全是数字密码\n\t * @param s\n\t * @return\n\t */\n\tpublic static boolean isNumberPassword(String s) {\n\t\treturn length(s, false) == 6 && isNumber(s);\n\t}\n\t/**判断email格式是否正确\n\t * @param email\n\t * @return\n\t */\n\tpublic static boolean isEmail(String email) {\n\t\tif (isEmpty(email, true)) {\n\t\t\treturn false;\n\t\t}\n\n\t\tcurrent = email;\n\t\treturn PATTERN_EMAIL.matcher(email).matches();\n\t}\n\n\n\t/**判断是否全是验证码\n\t * @param s\n\t * @return\n\t */\n\tpublic static boolean isVerify(String s) {\n\t\treturn length(s, false) >= 4 && isNumber(s);\n\t}\n\t/**判断是否全是数字\n\t * @param s\n\t * @return\n\t */\n\tpublic static boolean isNumber(String s) {\n\t\tif (isEmpty(s, true)) {\n\t\t\treturn false;\n\t\t}\n\n\t\tcurrent = s;\n\t\treturn PATTERN_NUMBER.matcher(s).matches();\n\t}\n\t/**判断是否全是字母\n\t * @param s\n\t * @return\n\t */\n\tpublic static boolean isAlpha(String s) {\n\t\tif (isEmpty(s, true)) {\n\t\t\treturn false;\n\t\t}\n\n\t\tcurrent = s;\n\t\treturn PATTERN_ALPHA.matcher(s).matches();\n\t}\n\t/**判断是否全是数字或字母\n\t * @param s\n\t * @return\n\t */\n\tpublic static boolean isNumberOrAlpha(String s) {\n\t\treturn isNumber(s) || isAlpha(s);\n\t}\n\n\t/**判断是否全是数字或字母\n\t * @param s\n\t * @return\n\t */\n\tpublic static boolean isCombineOfNumOrAlpha(String s) {\n\t\tif (isEmpty(s, true)) {\n\t\t\treturn false;\n\t\t}\n\n\t\tcurrent = s;\n\t\treturn PATTERN_NUM_OR_ALPHA.matcher(s).matches();\n\t}\n\n\t/**判断是否为代码名称，只能包含字母，数字或下划线\n\t * @param s\n\t * @return\n\t */\n\tpublic static boolean isName(String s) {\n\t\tif (s == null || s.isEmpty()) {\n\t\t\treturn false;\n\t\t}\n\t\t\n\t\tString first = s.substring(0, 1);\n\t\tif (\"_\".equals(first) == false && PATTERN_ALPHA.matcher(first).matches() == false) {\n\t\t\treturn false;\n\t\t}\n\t\t\n\t\treturn s.length() <= 1 ? true : PATTERN_NAME.matcher(s.substring(1)).matches();\n\t}\n\t/**判断是否为首字母大写的代码名称\n\t * @param s\n\t * @return\n\t */\n\tpublic static boolean isBigName(String s) {\n\t\tif (s == null || s.isEmpty() || PATTERN_ALPHA_BIG.matcher(s.substring(0, 1)).matches() == false) {\n\t\t\treturn false;\n\t\t}\n\t\treturn s.length() <= 1 ? true : PATTERN_NAME.matcher(s.substring(1)).matches();\n\t}\n\t/**判断是否为首字母小写的代码名称\n\t * @param s\n\t * @return\n\t */\n\tpublic static boolean isSmallName(String s) {\n\t\tif (s == null || s.isEmpty() || PATTERN_ALPHA_SMALL.matcher(s.substring(0, 1)).matches() == false) {\n\t\t\treturn false;\n\t\t}\n\t\treturn s.length() <= 1 ? true : PATTERN_NAME.matcher(s.substring(1)).matches();\n\t}\n\n\n\t/**判断字符类型是否是身份证号\n\t * @param number\n\t * @return\n\t */\n\tpublic static boolean isIDCard(String number) {\n\t\tif (isCombineOfNumOrAlpha(number) == false) {\n\t\t\treturn false;\n\t\t}\n\t\tnumber = get(number);\n\t\tif (number.length() == 15) {\n\t\t\tLog.i(TAG, \"isIDCard number.length() == 15 old IDCard\");\n\t\t\tcurrent = number;\n\t\t\treturn true;\n\t\t}\n\t\tif (number.length() == 18) {\n\t\t\tcurrent = number;\n\t\t\treturn true;\n\t\t}\n\n\t\treturn false;\n\t}\n\n\tpublic static final String HTTP = \"http\";\n\tpublic static final String URL_PREFIX = \"http://\";\n\tpublic static final String URL_PREFIXs = \"https://\";\n\t/**判断字符类型是否是网址\n\t * @param url\n\t * @return\n\t */\n\tpublic static boolean isUrl(String url) {\n\t\tif (isNotEmpty(url, true) == false) {\n\t\t\treturn false;\n\t\t} \n\t\tif (! url.startsWith(URL_PREFIX) && ! url.startsWith(URL_PREFIXs)) {\n\t\t\treturn false;\n\t\t}\n\n\t\tcurrent = url;\n\t\treturn true;\n\t}\n\n\tpublic static boolean isBranchUrl(String branchUrl) {\n\t\tif (isEmpty(branchUrl, false)) {\n\t\t\treturn false;\n\t\t}\n\t\t\n\t\treturn PATTERN_BRANCH_URL.matcher(branchUrl).matches();\n\t}\n\n\n\tpublic static final String FILE_PATH_PREFIX = \"file://\";\n\t/**判断文件路径是否存在\n\t * @param path\n\t * @return\n\t */\n\tpublic static boolean isFilePathExist(String path) {\n\t\treturn StringUtil.isFilePath(path) && new File(path).exists();\n\t}\n\n\tpublic static final String SEPARATOR = \"/\";\n\t/**判断是否为路径\n\t * @param path\n\t * @return\n\t */\n\tpublic static boolean isPath(String path) {\n\t\treturn StringUtil.isNotEmpty(path, true) && path.contains(SEPARATOR)\n\t\t\t\t&& path.contains(SEPARATOR + SEPARATOR) == false && path.endsWith(SEPARATOR) == false;\n\t}\n\n\t/**判断字符类型是否是路径\n\t * @param path\n\t * @return\n\t */\n\tpublic static boolean isFilePath(String path) {\n\t\tif (isNotEmpty(path, true) == false) {\n\t\t\treturn false;\n\t\t}\n\n\t\tif (! path.contains(\".\") || path.endsWith(\".\")) {\n\t\t\treturn false;\n\t\t}\n\n\t\tcurrent = path;\n\n\t\treturn true;\n\t}\n\n\t//判断字符类型 >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>\n\n\n\t//提取特殊字符<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<\n\n\t/**去掉string内所有非数字类型字符\n\t * @param object\n\t * @return\n\t */\n\tpublic static String getNumber(Object object) {\n\t\treturn getNumber(get(object));\n\t}\n\t/**去掉string内所有非数字类型字符\n\t * @param cs\n\t * @return\n\t */\n\tpublic static String getNumber(CharSequence cs) {\n\t\treturn getNumber(get(cs));\n\t}\n\t/**去掉string内所有非数字类型字符\n\t * @param s\n\t * @return\n\t */\n\tpublic static String getNumber(String s) {\n\t\treturn getNumber(s, false);\n\t}\n\n\t//CS304 Issue link: https://github.com/Tencent/APIJSON/issues/182\n\t/**去掉string内所有非数字类型字符\n\t * @param s -string passed in\n\t * @param onlyStart 中间有非数字时只获取前面的数字\n\t * @return limit String\n\t *

Here we replace the simple \"+\" way of concatenating with Stringbuilder 's append

\n\t */\n\tpublic static String getNumber(String s, boolean onlyStart) {\n\t\tif (isEmpty(s, true)) {\n\t\t\treturn \"\";\n\t\t}\n\n\t\tStringBuilder numberString = new StringBuilder(\"\");\n\t\tString single;\n\t\tfor (int i = 0; i < s.length(); i++) {\n\t\t\tsingle = s.substring(i, i + 1);\n\t\t\tif (isNumber(single)) {\n\t\t\t\tnumberString.append(single);\n\t\t\t} else {\n\t\t\t\tif (onlyStart) {\n\t\t\t\t\treturn numberString.toString();\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t\treturn numberString.toString();\n\t}\n\n\t//提取特殊字符>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>\n\n\t//校正（自动补全等）字符串<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<\n\n\t/**获取网址，自动补全\n\t * @param url\n\t * @return\n\t */\n\tpublic static String getCorrectUrl(String url) {\n\t\tLog.i(TAG, \"getCorrectUrl : \\n\" + url);\n\t\tif (isNotEmpty(url, true) == false) {\n\t\t\treturn \"\";\n\t\t}\n\n\t\t//\t\tif (! url.endsWith(\"/\") && ! url.endsWith(\".html\")) {\n\t\t//\t\t\turl = url + \"/\";\n\t\t//\t\t}\n\n\t\tif (isUrl(url) == false) {\n\t\t\treturn URL_PREFIX + url;\n\t\t}\n\t\treturn url;\n\t}\n\n\t/**获取去掉所有 空格 、\"-\" 、\"+86\" 后的phone\n\t * @param phone\n\t * @return\n\t */\n\tpublic static String getCorrectPhone(String phone) {\n\t\tif (isNotEmpty(phone, true) == false) {\n\t\t\treturn \"\";\n\t\t}\n\n\t\tphone = noBlank(phone);\n\t\tphone = phone.replaceAll(\"-\", \"\");\n\t\tif (phone.startsWith(\"+86\")) {\n\t\t\tphone = phone.substring(3);\n\t\t}\n\t\treturn phone;\n\t}\n\n\n\t/**获取邮箱，自动补全\n\t * @param email\n\t * @return\n\t */\n\tpublic static String getCorrectEmail(String email) {\n\t\tif (isNotEmpty(email, true) == false) {\n\t\t\treturn \"\";\n\t\t}\n\n\t\temail = noBlank(email);\n\t\tif (isEmail(email) == false && ! email.endsWith(\".com\")) {\n\t\t\temail += \".com\";\n\t\t}\n\n\t\treturn email;\n\t}\n\n\n\tpublic static final int PRICE_FORMAT_DEFAULT = 0;\n\tpublic static final int PRICE_FORMAT_PREFIX = 1;\n\tpublic static final int PRICE_FORMAT_SUFFIX = 2;\n\tpublic static final int PRICE_FORMAT_PREFIX_WITH_BLANK = 3;\n\tpublic static final int PRICE_FORMAT_SUFFIX_WITH_BLANK = 4;\n\tpublic static final String[] PRICE_FORMATS = {\n\t\t\t\"\", \"￥\", \"元\", \"￥ \", \" 元\"\n\t};\n\n\t/**获取价格，保留两位小数\n\t * @param price\n\t * @return\n\t */\n\tpublic static String getPrice(String price) {\n\t\treturn getPrice(price, PRICE_FORMAT_DEFAULT);\n\t}\n\t//CS304 Issue link: https://github.com/Tencent/APIJSON/issues/182\n\t/**获取价格，保留两位小数\n\t * @param price -price passed in\n\t * @param formatType 添加单位（元）\n\t * @return limit String\n\t *

Here we replace the simple \"+\" way of concatenating with Stringbuilder 's append

\n\t */\n\tpublic static String getPrice(String price, int formatType) {\n\t\tif (isNotEmpty(price, true) == false) {\n\t\t\treturn getPrice(0, formatType);\n\t\t}\n\n\t\t//单独写到getCorrectPrice? <<<<<<<<<<<<<<<<<<<<<<\n\t\tString correctPrice;\n\t\tStringBuilder correctPriceBuilder = new StringBuilder(\"\");\n\t\tString s;\n\t\tfor (int i = 0; i < price.length(); i++) {\n\t\t\ts = price.substring(i, i + 1);\n\t\t\tif (\".\".equals(s) || isNumber(s)) {\n\t\t\t\tcorrectPriceBuilder.append(s);\n\t\t\t}\n\t\t}\n\t\tcorrectPrice = correctPriceBuilder.toString();\n\t\t//单独写到getCorrectPrice? >>>>>>>>>>>>>>>>>>>>>>\n\n\t\tLog.i(TAG, \"getPrice <<<<<<<<<<<<<<<<<< correctPrice = \" + correctPrice);\n\t\tif (correctPrice.contains(\".\")) {\n\t\t\t//\t\t\tif (correctPrice.startsWith(\".\")) {\n\t\t\t//\t\t\t\tcorrectPrice = 0 + correctPrice;\n\t\t\t//\t\t\t}\n\t\t\tif (correctPrice.endsWith(\".\")) {\n\t\t\t\tcorrectPrice = correctPrice.replaceAll(\".\", \"\");\n\t\t\t}\n\t\t}\n\n\t\tLog.i(TAG, \"getPrice correctPrice = \" + correctPrice + \" >>>>>>>>>>>>>>>>\");\n\t\treturn isNotEmpty(correctPrice, true) ? getPrice(new BigDecimal(0 + correctPrice), formatType) : getPrice(0, formatType);\n\t}\n\t/**获取价格，保留两位小数\n\t * @param price\n\t * @return\n\t */\n\tpublic static String getPrice(BigDecimal price) {\n\t\treturn getPrice(price, PRICE_FORMAT_DEFAULT);\n\t}\n\t/**获取价格，保留两位小数\n\t * @param price\n\t * @return\n\t */\n\tpublic static String getPrice(double price) {\n\t\treturn getPrice(price, PRICE_FORMAT_DEFAULT);\n\t}\n\t/**获取价格，保留两位小数\n\t * @param price\n\t * @param formatType 添加单位（元）\n\t * @return\n\t */\n\tpublic static String getPrice(BigDecimal price, int formatType) {\n\t\treturn getPrice(price == null ? 0 : price.doubleValue(), formatType);\n\t}\n\t/**获取价格，保留两位小数\n\t * @param price\n\t * @param formatType 添加单位（元）\n\t * @return\n\t */\n\tpublic static String getPrice(double price, int formatType) {\n\t\tString s = new DecimalFormat(\"#########0.00\").format(price);\n\t\tswitch (formatType) {\n\t\tcase PRICE_FORMAT_PREFIX:\n\t\t\treturn PRICE_FORMATS[PRICE_FORMAT_PREFIX] + s;\n\t\tcase PRICE_FORMAT_SUFFIX:\n\t\t\treturn s + PRICE_FORMATS[PRICE_FORMAT_SUFFIX];\n\t\tcase PRICE_FORMAT_PREFIX_WITH_BLANK:\n\t\t\treturn PRICE_FORMATS[PRICE_FORMAT_PREFIX_WITH_BLANK] + s;\n\t\tcase PRICE_FORMAT_SUFFIX_WITH_BLANK:\n\t\t\treturn s + PRICE_FORMATS[PRICE_FORMAT_SUFFIX_WITH_BLANK];\n\t\tdefault:\n\t\t\treturn s;\n\t\t}\n\t}\n\n\tpublic static String join(String[] arr) {\n\t\treturn join(arr);\n\t}\n\t/** 数组以指定分隔s拼接\n\t * @param arr\n\t * @param s\n\t * @return\n\t */\n\tpublic static String join(String[] arr, String s) {\n\t\tif (s == null) {\n\t\t\ts = \",\";\n\t\t}\n\n\t\tStringBuilder sb = new StringBuilder();\n\t\tfor (int i = 0; i < arr.length; i++) {\n\t\t\tsb.append(arr[i]);\n\t\t\tif (i < arr.length-1) {\n\t\t\t\tsb.append(s);\n\t\t\t}\n\t\t}\n\n\t\treturn sb.toString();\n\t}\n\t/**分割路径\n\t * @param path\n\t * @return\n\t */\n\tpublic static String[] splitPath(String path) {\n\t\tif (StringUtil.isNotEmpty(path, true) == false) {\n\t\t\treturn null;\n\t\t}\n\t\treturn isPath(path) ? split(path, SEPARATOR) : new String[] {path};\n\t}\n\t/**将s分割成String[]\n\t * @param s\n\t * @return\n\t */\n\tpublic static String[] split(String s) {\n\t\treturn split(s, null);\n\t}\n\t/**将s用split分割成String[]\n\t * trim = true;\n\t * @param s\n\t * @param split\n\t * @return\n\t */\n\tpublic static String[] split(String s, String split) {\n\t\treturn split(s, split, true);\n\t}\n\t/**将s用split分割成String[]\n\t * @param s\n\t * @param trim 去掉前后两端的split\n\t * @return\n\t */\n\tpublic static String[] split(String s, boolean trim) {\n\t\treturn split(s, null, trim);\n\t}\n\t/**将s用split分割成String[]\n\t * @param s\n\t * @param split\n\t * @param trim 去掉前后两端的split\n\t * @return\n\t */\n\tpublic static String[] split(String s, String split, boolean trim) {\n\t\ts = get(s);\n\t\tif (s.isEmpty()) {\n\t\t\treturn null;\n\t\t}\n\t\tif (isEmpty(split, false)) {\n\t\t\tsplit = \",\";\n\t\t}\n\t\tif (trim) {\n\t\t\twhile (s.startsWith(split)) {\n\t\t\t\ts = s.substring(split.length());\n\t\t\t}\n\t\t\twhile (s.endsWith(split)) {\n\t\t\t\ts = s.substring(0, s.length() - split.length());\n\t\t\t}\n\t\t}\n\t\treturn s.contains(split) ? s.split(split) : new String[]{s};\n\t}\n\n\t/**\n\t * @param key\n\t * @param suffix\n\t * @return key + suffix，第一个字母小写\n\t */\n\tpublic static String addSuffix(String key, String suffix) {\n\t\tkey = noBlank(key);\n\t\tif (key.isEmpty()) {\n\t\t\treturn firstCase(suffix);\n\t\t}\n\t\treturn firstCase(key) + firstCase(suffix, true);\n\t}\n\t/**\n\t * @param key\n\t */\n\tpublic static String firstCase(String key) {\n\t\treturn firstCase(key, false);\n\t}\n\t/**\n\t * @param key\n\t * @param upper\n\t * @return\n\t */\n\tpublic static String firstCase(String key, boolean upper) {\n\t\tkey = get(key);\n\t\tif (key.isEmpty()) {\n\t\t\treturn \"\";\n\t\t}\n\n\t\tString first = key.substring(0, 1);\n\t\tkey = (upper ? first.toUpperCase() : first.toLowerCase()) + key.substring(1, key.length());\n\n\t\treturn key;\n\t}\n\n\t/**全部大写\n\t * @param s\n\t * @return\n\t */\n\tpublic static String toUpperCase(String s) {\n\t\treturn toUpperCase(s, false);\n\t}\n\t/**全部大写\n\t * @param s\n\t * @param trim\n\t * @return\n\t */\n\tpublic static String toUpperCase(String s, boolean trim) {\n\t\ts = trim ? trim(s) : get(s);\n\t\treturn s.toUpperCase();\n\t}\n\t/**全部小写\n\t * @param s\n\t * @return\n\t */\n\tpublic static String toLowerCase(String s) {\n\t\treturn toLowerCase(s, false);\n\t}\n\t/**全部小写\n\t * @param s\n\t * @return\n\t */\n\tpublic static String toLowerCase(String s, boolean trim) {\n\t\ts = trim ? trim(s) : get(s);\n\t\treturn s.toLowerCase();\n\t}\n\n\tpublic static String concat(String left, String right) {\n\t\treturn concat(left, right, null);\n\t}\n\tpublic static String concat(String left, String right, String split) {\n\t\treturn concat(left, right, split, true);\n\t}\n\tpublic static String concat(String left, String right, boolean trim) {\n\t\treturn concat(left, right, null, trim);\n\t}\n\tpublic static String concat(String left, String right, String split, boolean trim) {\n\t\tif (isEmpty(left, trim)) {\n\t\t\treturn right;\n\t\t}\n\t\tif (isEmpty(right, trim)) {\n\t\t\treturn left;\n\t\t}\n\n\t\tif (split == null) {\n\t\t\tsplit = \",\";\n\t\t}\n\t\treturn left + split + right;\n\t}\n\n\t//校正（自动补全等）字符串>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>\n\n\n\tpublic static boolean equals(Object s1, Object s2) {\n\t\treturn Objects.equals(s1, s2);\n\t}\n\tpublic static boolean equalsIgnoreCase(String s1, String s2) {\n\t\tif (s1 == s2) {\n\t\t\treturn true;\n\t\t}\n\t\tif (s1 == null || s2 == null) {\n\t\t\treturn false;\n\t\t}\n\t\treturn s1.equalsIgnoreCase(s2);\n\t}\n\n}\n" }, { "path": "APIJSONORM/src/main/java/apijson/orm/AbstractFunctionParser.java", "content": "/*Copyright (C) 2020 Tencent. All rights reserved.\n\nThis source code is licensed under the Apache License Version 2.0.*/\n\n\npackage apijson.orm;\n\nimport apijson.*;\nimport apijson.orm.exception.UnsupportedDataTypeException;\nimport apijson.orm.script.ScriptExecutor;\n\nimport java.lang.invoke.WrongMethodTypeException;\nimport java.lang.reflect.InvocationTargetException;\nimport java.lang.reflect.Method;\nimport java.math.BigDecimal;\nimport java.util.*;\n\nimport static apijson.orm.AbstractSQLConfig.PATTERN_SCHEMA;\n\n/**可远程调用的函数类\n * @author Lemon\n */\npublic abstract class AbstractFunctionParser, L extends List>\n\t\timplements FunctionParser {\n private static final String TAG = \"AbstractFunctionParser\";\n\n /**是否解析参数 key 的对应的值，不用手动编码 curObj.getString(key)\n */\n public static boolean IS_PARSE_ARG_VALUE = false;\n\n /**开启支持远程函数\n */\n public static boolean ENABLE_REMOTE_FUNCTION = true;\n /**开启支持远程函数中的 JavaScript 脚本形式\n */\n public static boolean ENABLE_SCRIPT_FUNCTION = true;\n\n\t// \n\t// >\n public static Map, ? extends List>> SCRIPT_EXECUTOR_MAP;\n\tpublic static Map> FUNCTION_MAP;\n\n\tstatic {\n\t\tFUNCTION_MAP = new HashMap<>();\n\t\tSCRIPT_EXECUTOR_MAP = new HashMap<>();\n\t}\n\n\tprivate Parser parser;\n\tprivate RequestMethod method;\n\tprivate String tag;\n\tprivate int version;\n\tprivate String key;\n\tprivate String parentPath;\n\tprivate String currentName;\n\tprivate M request;\n\tprivate M current;\n\n\tpublic AbstractFunctionParser() {\n\t\tthis(null, null, 0, null);\n\t}\n\n\tpublic AbstractFunctionParser(RequestMethod method, String tag, int version, @NotNull M request) {\n\t\tsetMethod(method == null ? RequestMethod.GET : method);\n\t\tsetTag(tag);\n\t\tsetVersion(version);\n\t\tsetRequest(request);\n\t}\n\n\t@NotNull\n\t@Override\n\tpublic Parser getParser() {\n\t\treturn parser;\n\t}\n\n\t@Override\n\tpublic AbstractFunctionParser setParser(Parser parser) {\n\t\tthis.parser = parser;\n\t\treturn this;\n\t}\n\n\t@NotNull\n\t@Override\n\tpublic RequestMethod getMethod() {\n\t\treturn method == null ? RequestMethod.GET : method;\n\t}\n\n\t@Override\n\tpublic AbstractFunctionParser setMethod(RequestMethod method) {\n\t\tthis.method = method;\n\t\treturn this;\n\t}\n\n\t@Override\n\tpublic String getTag() {\n\t\treturn tag;\n\t}\n\n\t@Override\n\tpublic AbstractFunctionParser setTag(String tag) {\n\t\tthis.tag = tag;\n\t\treturn this;\n\t}\n\n\t@Override\n\tpublic int getVersion() {\n\t\treturn version;\n\t}\n\n\t@Override\n\tpublic AbstractFunctionParser setVersion(int version) {\n\t\tthis.version = version;\n\t\treturn this;\n\t}\n\n\t@Override\n\tpublic String getKey() {\n\t\treturn key;\n\t}\n\n\t@Override\n\tpublic AbstractFunctionParser setKey(String key) {\n\t\tthis.key = key;\n\t\treturn this;\n\t}\n\n\t@Override\n\tpublic String getParentPath() {\n\t\treturn parentPath;\n\t}\n\n\t@Override\n\tpublic AbstractFunctionParser setParentPath(String parentPath) {\n\t\tthis.parentPath = parentPath;\n\t\treturn this;\n\t}\n\n\t@Override\n\tpublic String getCurrentName() {\n\t\treturn currentName;\n\t}\n\n\t@Override\n\tpublic AbstractFunctionParser setCurrentName(String currentName) {\n\t\tthis.currentName = currentName;\n\t\treturn this;\n\t}\n\n\t@NotNull\n\t@Override\n\tpublic M getRequest() {\n\t\treturn request;\n\t}\n\n\t@Override\n\tpublic AbstractFunctionParser setRequest(@NotNull M request) {\n\t\tthis.request = request;\n\t\treturn this;\n\t}\n\n\t@NotNull\n\t@Override\n\tpublic M getCurrentObject() {\n\t\treturn current;\n\t}\n\n\t@Override\n\tpublic AbstractFunctionParser setCurrentObject(@NotNull M current) {\n\t\tthis.current = current;\n\t\treturn this;\n\t}\n\n\t/**根据路径取 Boolean 值\n\t * @param path\n\t * @return\n\t */\n\tpublic Boolean getArgBool(String path) {\n\t\treturn getArgVal(path, Boolean.class);\n\t}\n\n\t/**根据路径取 Integer 值\n\t * @param path\n\t * @return\n\t */\n\tpublic Integer getArgInt(String path) {\n\t\treturn getArgVal(path, Integer.class);\n\t}\n\n\t/**根据路径取 Long 值\n\t * @param path\n\t * @return\n\t */\n\tpublic Long getArgLong(String path) {\n\t\treturn getArgVal(path, Long.class);\n\t}\n\n\t/**根据路径取 Float 值\n\t * @param path\n\t * @return\n\t */\n\tpublic Float getArgFloat(String path) {\n\t\treturn getArgVal(path, Float.class);\n\t}\n\n\t/**根据路径取 Double 值\n\t * @param path\n\t * @return\n\t */\n\tpublic Double getArgDouble(String path) {\n\t\treturn getArgVal(path, Double.class);\n\t}\n\n\t/**根据路径取 Number 值\n\t * @param path\n\t * @return\n\t */\n\tpublic Number getArgNum(String path) {\n\t\treturn getArgVal(path, Number.class);\n\t}\n\n\t/**根据路径取 BigDecimal 值\n\t * @param path\n\t * @return\n\t */\n\tpublic BigDecimal getArgDecimal(String path) {\n\t\treturn getArgVal(path, BigDecimal.class);\n\t}\n\n\t/**根据路径取 String 值\n\t * @param path\n\t * @return\n\t */\n\tpublic String getArgStr(String path) {\n\t\tObject obj = getArgVal(path);\n\t\treturn JSON.toJSONString(obj);\n\t}\n\n\t/**根据路径取 JSONMap 值\n\t * @param path\n\t * @return\n\t */\n\tpublic Map getArgObj(String path) {\n\t\treturn getArgVal(path, Map.class);\n\t}\n\n\t/**根据路径取 JSONList 值\n\t * @param path\n\t * @return\n\t */\n\tpublic List getArgArr(String path) {\n\t\treturn getArgVal(path, List.class);\n\t}\n\n\t/**根据路径取 List 值\n\t * @param path\n\t * @return\n\t */\n\tpublic List getArgList(String path) {\n\t\treturn getArgList(path, null);\n\t}\n\n\t/**根据路径取 List 值\n\t * @param path\n\t * @return\n\t */\n\tpublic List getArgList(String path, Class clazz) {\n\t\tString s = getArgStr(path);\n\t\treturn JSON.parseArray(s, clazz);\n\t}\n\n\t/**根据路径取值\n\t * @param path\n\t * @return\n\t * @param \n\t */\n\tpublic T getArgVal(String path) {\n\t\treturn getArgVal(path, null); // 误判概率很小 false);\n\t}\n\t/**根据路径取值\n\t * @param path\n\t * @param clazz\n\t * @return\n\t * @param \n\t */\n\tpublic T getArgVal(String path, Class clazz) {\n\t\treturn getArgVal(getCurrentObject(), path, clazz, true);\n\t}\n\t/**根据路径取值\n\t * @param path\n\t * @param clazz\n\t * @param tryAll false-仅当前对象，true-本次请求的全局对象以及 Parser 缓存值\n\t * @return\n\t * @param \n\t */\n\tpublic T getArgVal(@NotNull M req, String path, Class clazz, boolean tryAll) {\n\t\tT val = getArgValue(req, path, clazz);\n\t\tif (tryAll == false || val != null) {\n\t\t\treturn val;\n\t\t}\n\n\t\tParser p = getParser();\n\t\tString targetPath = AbstractParser.getValuePath(getParentPath(), path);\n\t\treturn p == null ? null : (T) p.getValueByPath(targetPath);\n\t}\n\t/**根据路径从对象 obj 中取值\n\t * @param obj\n\t * @param path\n\t * @return\n\t * @param \n\t */\n\tpublic static T getArgVal(Map obj, String path) {\n\t\treturn getArgValue(obj, path, null);\n\t}\n\n\tpublic static T getArgValue(Map obj, String path, Class clazz) {\n\t\tObject v = AbstractParser.getValue(obj, StringUtil.splitPath(path));\n\n\t\tif (clazz == null) {\n\t\t\treturn (T) v;\n\t\t}\n\n\t\t// Simple type conversion\n\t\ttry {\n\t\t\tif (v == null) {\n\t\t\t\treturn null;\n\t\t\t}\n\t\t\tif (clazz.isInstance(v)) {\n\t\t\t\treturn (T) v;\n\t\t\t}\n\t\t\tif (clazz == String.class) {\n\t\t\t\treturn (T) String.valueOf(v);\n\t\t\t}\n\t\t\tif (clazz == Boolean.class || clazz == boolean.class) {\n\t\t\t\treturn (T) Boolean.valueOf(String.valueOf(v));\n\t\t\t}\n\t\t\tif (clazz == Integer.class || clazz == int.class) {\n\t\t\t\treturn (T) Integer.valueOf(String.valueOf(v));\n\t\t\t}\n\t\t\tif (clazz == Long.class || clazz == long.class) {\n\t\t\t\treturn (T) Long.valueOf(String.valueOf(v));\n\t\t\t}\n\t\t\tif (clazz == Double.class || clazz == double.class) {\n\t\t\t\treturn (T) Double.valueOf(String.valueOf(v));\n\t\t\t}\n\t\t\tif (clazz == Float.class || clazz == float.class) {\n\t\t\t\treturn (T) Float.valueOf(String.valueOf(v));\n\t\t\t}\n\t\t\tif (Map.class.isAssignableFrom(clazz)) {\n\t\t\t\tif (v instanceof Map) {\n\t\t\t\t\treturn (T) v;\n\t\t\t\t}\n\t\t\t\treturn (T) JSON.parseObject(v);\n\t\t\t}\n\t\t\tif (List.class.isAssignableFrom(clazz)) {\n\t\t\t\tif (v instanceof List) {\n\t\t\t\t\treturn (T) v;\n\t\t\t\t}\n\t\t\t\treturn (T) JSON.parseArray(v);\n\t\t\t}\n\t\t\t// Fallback to string conversion\n\t\t\treturn (T) v;\n\t\t} catch (Exception e) {\n\t\t\treturn null;\n\t\t}\n\t}\n\n\n\t/**反射调用\n\t * @param function 例如get(object,key)，参数只允许引用，不能直接传值\n\t * @param current 不作为第一个参数，就不能远程调用invoke，避免死循环\n\t * @return {@link #invoke(String, M, boolean)}\n\t */\n\t@Override\n\tpublic Object invoke(@NotNull String function, @NotNull M current) throws Exception {\n\t\treturn invoke(function, current, false);\n\t}\n\t/**反射调用\n\t * @param function 例如get(object,key)，参数只允许引用，不能直接传值\n\t * @param current 不作为第一个参数，就不能远程调用invoke，避免死循环\n\t * @param containRaw 包含原始 SQL 片段\n\t * @return {@link #invoke(AbstractFunctionParser, String, M, boolean)}\n\t */\n\t@Override\n\tpublic Object invoke(@NotNull String function, @NotNull M current, boolean containRaw) throws Exception {\n\t\tif (StringUtil.isEmpty(function, true)) {\n\t\t\tthrow new IllegalArgumentException(\"字符 \" + function + \" 不合法！\");\n\t\t}\n\n\t\treturn invoke(this, function, current, containRaw);\n\t}\n\n\t/**反射调用\n\t * @param parser\n\t * @param function 例如get(Map:map,key)，参数只允许引用，不能直接传值\n * @param current\n * @return {@link #invoke(AbstractFunctionParser, String, Class[], Object[])}\n\t */\n\t@SuppressWarnings({\"unchecked\", \"rawtypes\"})\n\tpublic static , L extends List> Object invoke(\n\t\t\t@NotNull AbstractFunctionParser parser, @NotNull String function\n\t\t\t, @NotNull Map current, boolean containRaw) throws Exception {\n if (ENABLE_REMOTE_FUNCTION == false) {\n throw new UnsupportedOperationException(\"AbstractFunctionParser.ENABLE_REMOTE_FUNCTION\" +\n \" == false 时不支持远程函数！如需支持则设置 AbstractFunctionParser.ENABLE_REMOTE_FUNCTION = true ！\");\n }\n\n\t\tFunctionBean fb = parseFunction(function, current, false, containRaw);\n\n\t\tMap row = FUNCTION_MAP.get(fb.getMethod()); //FIXME fb.getSchema() + \".\" + fb.getMethod()\n\t\tif (row == null) {\n\t\t\tthrow new UnsupportedOperationException(\"不允许调用远程函数 \" + fb.getMethod() + \" !\");\n\t\t}\n\n String language = (String) row.get(\"language\");\n String lang = \"java\".equalsIgnoreCase(language) ? null : language;\n\n if (ENABLE_SCRIPT_FUNCTION == false && lang != null) {\n throw new UnsupportedOperationException(\"language = \" + language + \" 不合法！AbstractFunctionParser.ENABLE_SCRIPT_FUNCTION\" +\n \" == false 时不支持远程函数中的脚本形式！如需支持则设置 AbstractFunctionParser.ENABLE_SCRIPT_FUNCTION = true ！\");\n }\n\n\t\tif (lang != null && SCRIPT_EXECUTOR_MAP.get(lang) == null) {\n\t\t\tthrow new ClassNotFoundException(\"找不到脚本语言 \" + lang + \" 对应的执行引擎！请先依赖相关库并在后端 APIJSONFunctionParser 中注册！\");\n\t\t}\n\n\t\tint version = row.get(\"version\") != null ? Integer.parseInt(row.get(\"version\").toString()) : 0;\n\t\tif (parser.getVersion() < version) {\n\t\t\tthrow new UnsupportedOperationException(\"不允许 version = \" + parser.getVersion() + \" 的请求调用远程函数 \" + fb.getMethod() + \" ! 必须满足 version >= \" + version + \" !\");\n\t\t}\n\t\tString tag = (String) row.get(\"tag\"); // TODO 改为 tags，类似 methods 支持多个 tag。或者干脆不要？因为目前非开放请求全都只能后端指定\n\t\tif (tag != null && tag.equals(parser.getTag()) == false) {\n\t\t\tthrow new UnsupportedOperationException(\"不允许 tag = \" + parser.getTag() + \" 的请求调用远程函数 \" + fb.getMethod() + \" ! 必须满足 tag = \" + tag + \" !\");\n\t\t}\n\t\tString[] methods = StringUtil.split((String) row.get(\"methods\"));\n\t\tList ml = methods == null || methods.length <= 0 ? null : Arrays.asList(methods);\n\t\tif (ml != null && ml.contains(parser.getMethod().toString()) == false) {\n\t\t\tthrow new UnsupportedOperationException(\"不允许 method = \" + parser.getMethod() + \" 的请求调用远程函数 \" + fb.getMethod() + \" ! 必须满足 method 在 \" + Arrays.toString(methods) + \"内 !\");\n\t\t}\n\n\t\ttry {\n return invoke(parser, fb.getMethod(), fb.getTypes(), fb.getValues(), (String) row.get(\"returnType\"), current, SCRIPT_EXECUTOR_MAP.get(lang));\n\t\t}\n catch (Exception e) {\n\t\t\tif (e instanceof NoSuchMethodException) {\n\t\t\t\tthrow new IllegalArgumentException(\"字符 \" + function + \" 对应的远程函数 \" + getFunction(fb.getMethod(), fb.getKeys())\n + \" 不在后端 \" + parser.getClass().getName() + \" 内，也不在父类中！如果需要则先新增对应方法！\"\n\t\t\t\t\t\t+ \"\\n请检查函数名和参数数量是否与已定义的函数一致！\"\n\t\t\t\t\t\t+ \"\\n且必须为 function(key0,key1,...) 这种单函数格式！\"\n\t\t\t\t\t\t+ \"\\nfunction 必须符合 Java 函数命名，key 是用于在 curObj 内取值的键！\"\n\t\t\t\t\t\t+ \"\\n调用时不要有空格！\" + (Log.DEBUG ? e.getMessage() : \"\"));\n\t\t\t}\n\t\t\tif (e instanceof InvocationTargetException) {\n\t\t\t\tThrowable te = ((InvocationTargetException) e).getTargetException();\n\t\t\t\tif (StringUtil.isEmpty(te.getMessage(), true) == false) { //到处把函数声明throws Exception改成throws Throwable挺麻烦\n\t\t\t\t\tthrow te instanceof Exception ? (Exception) te : new Exception(te.getMessage());\n\t\t\t\t}\n\t\t\t\tthrow new IllegalArgumentException(\"字符 \" + function + \" 对应的远程函数传参类型错误！\"\n\t\t\t\t\t\t+ \"\\n请检查 key:value 中value的类型是否满足已定义的函数 \" + getFunction(fb.getMethod(), fb.getKeys()) + \" 的要求！\"\n\t\t\t\t\t\t+ (Log.DEBUG ? e.getMessage() : \"\"));\n\t\t\t}\n\t\t\tthrow e;\n\t\t}\n\n\t}\n\n\t/**反射调用\n * @param parser\n * @param methodName\n * @param parameterTypes\n * @param args\n * @return {@link #invoke(AbstractFunctionParser, String, Class[], Object[])}\n * @throws Exception\n */\n\t@SuppressWarnings({\"unchecked\", \"rawtypes\"})\n\tpublic static , L extends List> Object invoke(\n\t\t\t@NotNull AbstractFunctionParser parser, @NotNull String methodName\n , @NotNull Class[] parameterTypes, @NotNull Object[] args) throws Exception {\n return invoke(parser, methodName, parameterTypes, args, null, null, null);\n }\n /**反射调用\n * @param parser\n * @param methodName\n * @param parameterTypes\n * @param args\n * @param returnType\n * @param current\n * @param scriptExecutor\n * @return\n * @throws Exception\n */\n\t@SuppressWarnings({\"unchecked\", \"rawtypes\"})\n\tpublic static , L extends List> Object invoke(\n\t\t\t@NotNull AbstractFunctionParser parser, @NotNull String methodName\n , @NotNull Class[] parameterTypes, @NotNull Object[] args, String returnType\n , Map current, ScriptExecutor scriptExecutor) throws Exception {\n if (scriptExecutor != null) {\n return invokeScript(parser, methodName, parameterTypes, args, returnType, current, scriptExecutor);\n }\n\n\t\tClass cls = parser.getClass();\n Method m = cls.getMethod(methodName, parameterTypes); // 不用判空，拿不到就会抛异常\n\n if (Log.DEBUG) {\n String rt = Log.DEBUG && m.getReturnType() != null ? m.getReturnType().getSimpleName() : null;\n\n if (\"void\".equals(rt)) {\n rt = null;\n }\n if (\"void\".equals(returnType)) {\n returnType = null;\n }\n\n if (rt != returnType && (rt == null || rt.equals(returnType) == false)) {\n throw new WrongMethodTypeException(\"远程函数 \" + methodName + \" 的实际返回值类型 \" + rt + \" 与 Function 表中的配置的 \" + returnType + \" 不匹配！\");\n }\n }\n\n return m.invoke(parser, args);\n\t}\n\n /**Java 调用 JavaScript 函数\n * @param parser\n * @param methodName\n * @param parameterTypes\n * @param args\n * @param returnType\n * @param current\n * @return\n * @throws Exception\n */\n\t@SuppressWarnings({\"unchecked\", \"rawtypes\"})\n public static , L extends List> Object invokeScript(\n\t\t\t@NotNull AbstractFunctionParser parser, @NotNull String methodName\n , @NotNull Class[] parameterTypes, @NotNull Object[] args, String returnType\n\t\t\t, Map current, ScriptExecutor scriptExecutor) throws Exception {\n \tObject result = scriptExecutor.execute(parser, current, methodName, args);\n if (Log.DEBUG && result != null) {\n Class rt = result.getClass(); // 作为远程函数的 js 类型应该只有 JSON 的几种类型\n String fullReturnType = (StringUtil.isSmallName(returnType)\n ? returnType : (returnType.startsWith(\"JSON\") ? \"com.alibaba.fastjson.\" : \"java.lang.\") + returnType);\n\n if ((rt == null && returnType != null) || (rt != null && returnType == null)) {\n throw new WrongMethodTypeException(\"远程函数 \" + methodName + \" 的实际返回值类型 \"\n + (rt == null ? null : rt.getName()) + \" 与 Function 表中的配置的 \" + fullReturnType + \" 不匹配！\");\n }\n\n Class cls;\n try {\n cls = Class.forName(fullReturnType);\n }\n catch (Exception e) {\n throw new WrongMethodTypeException(\"远程函数 \" + methodName + \" 在 Function 表中的配置的类型 \"\n + returnType + \" 对应的 \" + fullReturnType + \" 错误！在 Java 中 Class.forName 找不到这个类型！\");\n }\n\n if (cls.isAssignableFrom(rt) == false) {\n throw new WrongMethodTypeException(\"远程函数 \" + methodName + \" 的实际返回值类型 \"\n + (rt == null ? null : rt.getName()) + \" 与 Function 表中的配置的 \"\n + returnType + \" 对应的 \" + fullReturnType + \" 不匹配！\");\n }\n }\n\n Log.d(TAG, \"invokeScript \" + methodName + \"(..) >> result = \" + result);\n return result;\n }\n\n\n /**解析函数\n * @param function\n * @param request\n * @param isSQLFunction\n * @return\n * @throws Exception\n */\n\t@NotNull\n\tpublic static FunctionBean parseFunction(@NotNull String function, @NotNull Map request, boolean isSQLFunction) throws Exception {\n return parseFunction(function, request, isSQLFunction, false);\n }\n /**解析函数，自动解析的值类型只支持 Boolean, Number, String, Map, List\n * @param function\n * @param request\n * @param isSQLFunction\n * @param containRaw\n * @return\n * @throws Exception\n */\n\tpublic static FunctionBean parseFunction(@NotNull String function, @NotNull Map request, boolean isSQLFunction, boolean containRaw) throws Exception {\n\n\t\tint start = function.indexOf(\"(\");\n\t\tint end = function.lastIndexOf(\")\");\n\t\tString method = (start <= 0 || end != function.length() - 1) ? null : function.substring(0, start);\n\n int dotInd = method == null ? -1 : method.indexOf(\".\");\n String schema = dotInd < 0 ? null : method.substring(0, dotInd);\n method = dotInd < 0 ? method : method.substring(dotInd + 1);\n\n if (StringUtil.isName(method) == false) {\n\t\t\tthrow new IllegalArgumentException(\"字符 \" + method + \" 不合法！函数的名称 function 不能为空且必须符合方法命名规范！\"\n\t\t\t\t\t+ \"总体必须为 function(key0,key1,...) 这种单函数格式！\"\n\t\t\t\t\t+ \"\\nfunction必须符合 \" + (isSQLFunction ? \"SQL 函数/SQL 存储过程\" : \"Java 函数\") + \" 命名，key 是用于在 request 内取值的键！\");\n\t\t}\n if (isSQLFunction != true && schema != null) { // StringUtil.isNotEmpty(schema, false)) {\n throw new IllegalArgumentException(\"字符 \" + schema + \" 不合法！远程函数不允许指定类名！\"\n + \"且必须为 function(key0,key1,...) 这种单函数格式！\"\n + \"\\nfunction必须符合 \" + (isSQLFunction ? \"SQL 函数/SQL 存储过程\" : \"Java 函数\") + \" 命名，key 是用于在 request 内取值的键！\");\n }\n if (schema != null) { // StringUtil.isName(schema) == false) {\n\t\t\tschema = extractSchema(schema, null);\n }\n\n\t\tString[] keys = StringUtil.split(function.substring(start + 1, end));\n\t\tint length = keys == null ? 0 : keys.length;\n\n\t\tClass[] types;\n\t\tObject[] values;\n\n\t\tif (isSQLFunction || IS_PARSE_ARG_VALUE) {\n\t\t\ttypes = new Class[length];\n\t\t\tvalues = new Object[length];\n\n\t\t\t//碰到null就挂了！！！Number还得各种转换不灵活！不如直接传request和对应的key到函数里，函数内实现时自己 getLongValue,getJSONObject ...\n\t\t\tObject v;\n\t\t\tfor (int i = 0; i < length; i++) {\n\t\t\t\tv = values[i] = getArgValue(request, keys[i], containRaw); // request.get(keys[i]);\n\t\t\t\tif (v == null) {\n\t\t\t\t\ttypes[i] = Object.class;\n\t\t\t\t\tvalues[i] = null;\n\t\t\t\t\tbreak;\n\t\t\t\t}\n\n\t\t\t\tif (v instanceof Boolean) {\n\t\t\t\t\ttypes[i] = Boolean.class; //只支持JSON的几种类型\n\t\t\t\t} // 怎么都有 bug，如果是引用的值，很多情况下无法指定 // 用 1L 指定为 Long ？ 其它的默认按长度分配为 Integer 或 Long？\n\t\t\t\t//else if (v instanceof Long || v instanceof Integer || v instanceof Short) {\n\t\t\t\t//\ttypes[i] = Long.class;\n\t\t\t\t//}\n\t\t\t\telse if (v instanceof Number) {\n\t\t\t\t\ttypes[i] = Number.class;\n\t\t\t\t}\n\t\t\t\telse if (v instanceof String) {\n\t\t\t\t\ttypes[i] = String.class;\n\t\t\t\t}\n\t\t\t\telse if (v instanceof Map) { // 泛型兼容？ // JSONMap\n\t\t\t\t\ttypes[i] = Map.class;\n\t\t\t\t\t//性能比较差\n //values[i] = TypeUtils.cast(v, Map.class, ParserConfig.getGlobalInstance());\n\t\t\t\t}\n\t\t\t\telse if (v instanceof Collection) { // 泛型兼容？ // JSONList\n\t\t\t\t\ttypes[i] = List.class;\n\t\t\t\t\t//性能比较差\n\t\t\t\t\tList list = new ArrayList<>((Collection) v);\n values[i] = list; // TypeUtils.cast(v, List.class, ParserConfig.getGlobalInstance());\n\t\t\t\t}\n\t\t\t\telse {\n\t\t\t\t\tthrow new UnsupportedDataTypeException(keys[i] + \":value 中value不合法！远程函数 key():\"\n + function + \" 中的 arg 对应的值类型只能是 [Boolean, Number, String, JSONMap, JSONList] 中的一种！\");\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t\telse {\n\t\t\tClass cls = JSON.createJSONObject().getClass();\n\t\t\ttypes = new Class[length + 1];\n\t\t\t//types[0] = Object.class; // 泛型擦除 JSON.JSON_OBJECT_CLASS;\n\t\t\ttypes[0] = cls;\n\n\t\t\tvalues = new Object[length + 1];\n\t\t\tvalues[0] = request;\n\n\t\t\tfor (int i = 0; i < length; i++) {\n\t\t\t\ttypes[i + 1] = String.class;\n\t\t\t\tvalues[i + 1] = keys[i];\n\t\t\t}\n\t\t}\n\n\t\tFunctionBean fb = new FunctionBean();\n\t\tfb.setFunction(function);\n\t\tfb.setSchema(schema);\n\t\tfb.setMethod(method);\n\t\tfb.setKeys(keys);\n\t\tfb.setTypes(types);\n\t\tfb.setValues(values);\n\n\t\treturn fb;\n\t}\n\n\tpublic static void verifySchema(String sch, String table) {\n\t\textractSchema(sch, table);\n\t}\n\n\tpublic static String extractSchema(String sch, String table) {\n\t\tif (StringUtil.isEmpty(sch)) {\n\t\t\treturn sch;\n\t\t}\n\n\t\tif (table == null) {\n\t\t\ttable = \"Table\";\n\t\t}\n\n\t\tint ind = sch.indexOf(\"`\");\n\t\tif (ind > 0) {\n\t\t\tthrow new IllegalArgumentException(table + \": { @key(): value } 对应存储过程 value 中字符 \"\n\t\t\t\t\t+ sch + \" 不合法！`schema` 当有 ` 包裹时一定是首尾各一个，不能多也不能少！\");\n\t\t}\n\n\t\tif (ind == 0) {\n\t\t\tsch = sch.substring(1);\n\t\t\tif (sch.indexOf(\"`\") != sch.length() - 1) {\n\t\t\t\tthrow new IllegalArgumentException(table + \": { @key(): value } 对应存储过程 value 中字符 `\"\n\t\t\t\t\t\t+ sch + \" 不合法！`schema` 当有 ` 包裹时一定是首尾各一个，不能多也不能少！\");\n\t\t\t}\n\n\t\t\tsch = sch.substring(0, sch.length() - 1);\n\t\t}\n\n\t\tif (PATTERN_SCHEMA.matcher(sch).matches() == false || sch.contains(\"--\")) {\n\t\t\tthrow new IllegalArgumentException(table + \": { @key(): value } 对应存储过程 value 中字符 \"\n\t\t\t\t\t+ sch + \" 不合法！schema.function(arg) 中 schema 必须符合 数据库名/模式名 的命名规则！\"\n\t\t\t\t\t+ \"一般只能传英文字母、数字、下划线！不允许 -- 等可能导致 SQL 注入的符号！\");\n\t\t}\n\n\t\treturn sch;\n\t}\n\n\n\t/**\n\t * @param method\n\t * @param keys\n\t * @return\n\t */\n\tpublic static String getFunction(String method, String[] keys) {\n\t\tString f = method + \"(JSONMap request\";\n\n\t\tif (keys != null) {\n\t\t\tfor (int i = 0; i < keys.length; i++) {\n\t\t\t\tf += (\", String \" + keys[i]);\n\t\t\t}\n\t\t}\n\n\t\tf += \")\";\n\n\t\treturn f;\n\t}\n\n public static T getArgValue(@NotNull Map current, String keyOrValue) {\n return getArgValue(current, keyOrValue, false);\n }\n public static T getArgValue(@NotNull Map current, String keyOrValue, boolean containRaw) {\n if (keyOrValue == null) {\n return null;\n }\n\n\n if (keyOrValue.endsWith(\"`\") && keyOrValue.substring(1).indexOf(\"`\") == keyOrValue.length() - 2) {\n return (T) current.get(keyOrValue.substring(1, keyOrValue.length() - 1));\n }\n\n if (keyOrValue.endsWith(\"'\") && keyOrValue.substring(1).indexOf(\"'\") == keyOrValue.length() - 2) {\n return (T) keyOrValue.substring(1, keyOrValue.length() - 1);\n }\n\n // 传参加上 @raw:\"key()\" 避免意外情况\n Object val = containRaw ? AbstractSQLConfig.RAW_MAP.get(keyOrValue) : null;\n if (val != null) {\n return (T) (\"\".equals(val) ? keyOrValue : val);\n }\n\n if (StringUtil.isName(keyOrValue.startsWith(\"@\") ? keyOrValue.substring(1) : keyOrValue)) {\n return (T) current.get(keyOrValue);\n }\n\n if (\"true\".equals(keyOrValue)) {\n return (T) Boolean.TRUE;\n }\n if (\"false\".equals(keyOrValue)) {\n return (T) Boolean.FALSE;\n }\n\n // 性能更好，但居然非法格式也不报错\n //try {\n // val = Boolean.valueOf(keyOrValue); // parseJSON(keyOrValue);\n // return (T) val;\n //}\n //catch (Throwable e) {\n // Log.d(TAG, \"getArgValue try {\\n\" +\n // \" val = Boolean.valueOf(keyOrValue);\" +\n // \"} catch (Throwable e) = \" + e.getMessage());\n //}\n\n try {\n val = Double.valueOf(keyOrValue); // parseJSON(keyOrValue);\n return (T) val;\n }\n catch (Throwable e) {\n Log.d(TAG, \"getArgValue try {\\n\" +\n \" val = Double.valueOf(keyOrValue);\" +\n \"} catch (Throwable e) = \" + e.getMessage());\n }\n\n return (T) current.get(keyOrValue);\n }\n\n\tpublic static class FunctionBean {\n\t\tprivate String function;\n\t\tprivate String schema;\n\t\tprivate String method;\n\t\tprivate String[] keys;\n\t\tprivate Class[] types;\n\t\tprivate Object[] values;\n\n\t\tpublic String getFunction() {\n\t\t\treturn function;\n\t\t}\n\t\tpublic void setFunction(String function) {\n\t\t\tthis.function = function;\n\t\t}\n\n public String getSchema() {\n return schema;\n }\n public void setSchema(String schema) {\n this.schema = schema;\n }\n\n public String getMethod() {\n\t\t\treturn method;\n\t\t}\n\t\tpublic void setMethod(String method) {\n\t\t\tthis.method = method;\n\t\t}\n\n\t\tpublic String[] getKeys() {\n\t\t\treturn keys;\n\t\t}\n\t\tpublic void setKeys(String[] keys) {\n\t\t\tthis.keys = keys;\n\t\t}\n\n\t\tpublic Class[] getTypes() {\n\t\t\treturn types;\n\t\t}\n\t\tpublic void setTypes(Class[] types) {\n\t\t\tthis.types = types;\n\t\t}\n\n\t\tpublic Object[] getValues() {\n\t\t\treturn values;\n\t\t}\n\t\tpublic void setValues(Object[] values) {\n\t\t\tthis.values = values;\n\t\t}\n\n\n\t\t/**\n\t\t * @param useValue\n\t\t * @return\n\t\t */\n\t\tpublic String toFunctionCallString(boolean useValue) {\n\t\t\treturn toFunctionCallString(useValue, null);\n\t\t}\n\t\t/**\n\t\t * @param useValue\n\t\t * @param quote\n\t\t * @return\n\t\t */\n\t\tpublic String toFunctionCallString(boolean useValue, String quote) {\n //String sch = getSchema();\n\t\t\t//String s = (StringUtil.isEmpty(sch) ? \"\" : sch + \".\") + getMethod() + \"(\";\n\t\t\tString s = getMethod() + \"(\";\n\n\t\t\tObject[] args = useValue ? getValues() : getKeys();\n\t\t\tif (args != null && args.length > 0) {\n\t\t\t\tif (quote == null) {\n\t\t\t\t\tquote = \"'\";\n\t\t\t\t}\n\n\t\t\t\tObject arg;\n\t\t\t\tfor (int i = 0; i < args.length; i++) {\n\t\t\t\t\targ = args[i];\n\t\t\t\t\ts += (i <= 0 ? \"\" : \",\") + (arg instanceof Boolean || arg instanceof Number ? arg : quote + arg + quote);\n\t\t\t\t}\n\t\t\t}\n\n\t\t\treturn s + \")\";\n\t\t}\n\n\t}\n\n\t/**\n\t * 获取JSON对象\n\t * @param TODO\n\t * @param req\n\t * @param key\n\t * @param clazz\n\t * @return\n\t * @throws Exception\n\t */\n\tpublic V getArgVal(@NotNull M req, String key, Class clazz) throws Exception {\n\t\t// Convert to JSONMap for backward compatibility, replace with proper implementation later\n\t\treturn getArgVal(req, key, clazz, false);\n\t}\n\n\t/**\n\t * 获取参数值\n\t * @param key\n\t * @param clazz 如果有clazz就返回对应的类型，否则返回原始类型\n\t * @param defaultValue\n\t * @return\n\t * @throws Exception \n\t */\n\tpublic V getArgVal(String key, Class clazz, boolean defaultValue) throws Exception {\n\t\tObject obj = parser != null && JSONMap.isArrayKey(key) ? AbstractParser.getValue(request, key.split(\"\\\\,\")) : request.get(key);\n\t\t\n\t\tif (clazz == null) {\n\t\t\treturn (V) obj;\n\t\t}\n\t\t\n\t\t// Replace TypeUtils with appropriate casting method\n\t\ttry {\n\t\t\tif (obj == null) {\n\t\t\t\treturn null;\n\t\t\t}\n\t\t\tif (clazz.isInstance(obj)) {\n\t\t\t\treturn (V) obj;\n\t\t\t}\n\t\t\tif (clazz == String.class) {\n\t\t\t\treturn (V) String.valueOf(obj);\n\t\t\t}\n\t\t\tif (clazz == Boolean.class || clazz == boolean.class) {\n\t\t\t\treturn (V) Boolean.valueOf(String.valueOf(obj));\n\t\t\t}\n\t\t\tif (clazz == Integer.class || clazz == int.class) {\n\t\t\t\treturn (V) Integer.valueOf(String.valueOf(obj));\n\t\t\t}\n\t\t\tif (clazz == Long.class || clazz == long.class) {\n\t\t\t\treturn (V) Long.valueOf(String.valueOf(obj));\n\t\t\t}\n\t\t\tif (clazz == Double.class || clazz == double.class) {\n\t\t\t\treturn (V) Double.valueOf(String.valueOf(obj));\n\t\t\t}\n\t\t\tif (clazz == Float.class || clazz == float.class) {\n\t\t\t\treturn (V) Float.valueOf(String.valueOf(obj));\n\t\t\t}\n\t\t\tif (Map.class.isAssignableFrom(clazz)) {\n\t\t\t\tif (obj instanceof Map) {\n\t\t\t\t\treturn (V) obj;\n\t\t\t\t}\n\t\t\t\treturn (V) JSON.parseObject(obj);\n\t\t\t}\n\t\t\tif (List.class.isAssignableFrom(clazz)) {\n\t\t\t\tif (obj instanceof List) {\n\t\t\t\t\treturn (V) obj;\n\t\t\t\t}\n\t\t\t\treturn (V) JSON.parseArray(obj);\n\t\t\t}\n\t\t\t// Fallback to string conversion\n\t\t\treturn (V) obj;\n\t\t} catch (Exception e) {\n\t\t\tif (defaultValue) {\n\t\t\t\treturn null;\n\t\t\t}\n\t\t\tthrow e;\n\t\t}\n\t}\n\n}" }, { "path": "APIJSONORM/src/main/java/apijson/orm/AbstractObjectParser.java", "content": "/*Copyright (C) 2020 Tencent. All rights reserved.\n\nThis source code is licensed under the Apache License Version 2.0.*/\n\n\npackage apijson.orm;\n\nimport apijson.*;\nimport apijson.orm.AbstractFunctionParser.FunctionBean;\nimport apijson.orm.exception.ConflictException;\nimport apijson.orm.exception.CommonException;\nimport apijson.orm.exception.NotExistException;\nimport apijson.orm.exception.UnsupportedDataTypeException;\n\nimport java.rmi.ServerException;\nimport java.util.*;\nimport java.util.Map.Entry;\n\nimport static apijson.JSON.*;\nimport static apijson.JSONMap.KEY_COMBINE;\nimport static apijson.JSONMap.KEY_DROP;\nimport static apijson.JSONMap.KEY_TRY;\nimport static apijson.JSONRequest.*;\nimport static apijson.RequestMethod.POST;\nimport static apijson.RequestMethod.PUT;\nimport static apijson.orm.SQLConfig.TYPE_ITEM;\nimport static apijson.RequestMethod.GET;\n\n/**简化Parser，getObject和getArray(getArrayConfig)都能用\n * @author Lemon\n */\npublic abstract class AbstractObjectParser, L extends List>\n\t\timplements ObjectParser {\n\tprivate static final String TAG = \"AbstractObjectParser\";\n\n\t@NotNull\n\tprotected AbstractParser parser;\n\t@Override\n\tpublic AbstractParser getParser() {\n\t\treturn parser;\n\t}\n\t@Override\n\tpublic AbstractObjectParser setParser(Parser parser) {\n\t\tthis.parser = (AbstractParser) parser;\n\t\treturn this;\n\t}\n\n\tprotected M request;//不用final是为了recycle\n\tprotected String parentPath;//不用final是为了recycle\n\tprotected SQLConfig arrayConfig;//不用final是为了recycle\n\tprotected boolean isSubquery;\n\n\tprotected final int type;\n\tprotected final String arrayTable;\n\tprotected final List> joinList;\n\tprotected final boolean isTable;\n\tprotected final boolean isArrayMainTable;\n\n\tprotected final boolean tri;\n\t/**\n\t * TODO Parser内要不因为 非 TYPE_ITEM_CHILD_0 的Table 为空导致后续中断。\n\t */\n\tprotected final boolean drop;\n\tprivate List stringKeyList;\n\tprivate List trimKeyList;\n\n\t/**for single object\n\t */\n\tpublic AbstractObjectParser(@NotNull M request, String parentPath, SQLConfig arrayConfig\n\t\t\t, boolean isSubquery, boolean isTable, boolean isArrayMainTable) throws Exception {\n\t\tif (request == null) {\n\t\t\tthrow new IllegalArgumentException(TAG + \".ObjectParser request == null!!!\");\n\t\t}\n\t\tthis.request = request;\n\t\tthis.parentPath = parentPath;\n\n\t\tthis.arrayConfig = arrayConfig;\n\t\tthis.isSubquery = isSubquery;\n\n\t\tthis.type = arrayConfig == null ? 0 : arrayConfig.getType();\n\t\tthis.arrayTable = arrayConfig == null ? null : arrayConfig.getTable();\n\t\tthis.joinList = arrayConfig == null ? null : arrayConfig.getJoinList();\n\n\t\tthis.isTable = isTable; // apijson.JSONMap.isTableKey(table);\n\t\tthis.isArrayMainTable = isArrayMainTable; // isSubquery == false && this.isTable && this.type == SQLConfig.TYPE_ITEM_CHILD_0 && RequestMethod.isGetMethod(method, true);\n\t\t//\t\tthis.isReuse = isReuse; // isArrayMainTable && arrayConfig != null && arrayConfig.getPosition() > 0;\n\n\t\tthis.objectCount = 0;\n\t\tthis.arrayCount = 0;\n\n\t\tboolean isEmpty = request.isEmpty();//empty有效 User:{}\n\t\tif (isEmpty) {\n\t\t\tthis.tri = false;\n\t\t\tthis.drop = false;\n\t\t}\n\t\telse {\n\t\t\tthis.tri = getBooleanValue(request, KEY_TRY);\n\t\t\tthis.drop = getBooleanValue(request, KEY_DROP);\n\n\t\t\trequest.remove(KEY_TRY);\n\t\t\trequest.remove(KEY_DROP);\n\t\t}\n\n if (isTable) {\n String raw = getString(request, JSONMap.KEY_RAW);\n String[] rks = StringUtil.split(raw);\n rawKeyList = rks == null || rks.length <= 0 ? null : Arrays.asList(rks);\n\n\t\t\tString str = getString(request, KEY_STRING);\n\t\t\tString[] sks = StringUtil.split(str);\n\t\t\tstringKeyList = sks == null || sks.length <= 0 ? null : Arrays.asList(sks);\n\t\t\trequest.remove(KEY_STRING);\n\n\t\t\tString trim = getString(request, KEY_TRIM);\n\t\t\tString[] trims = StringUtil.split(trim);\n\t\t\ttrimKeyList = trims == null || trims.length <= 0 ? null : Arrays.asList(trims);\n\t\t\trequest.remove(KEY_TRIM);\n\t\t}\n }\n\n\t@Override\n\tpublic String getParentPath() {\n\t\treturn parentPath;\n\t}\n\n\t@Override\n\tpublic AbstractObjectParser setParentPath(String parentPath) {\n\t\tthis.parentPath = parentPath;\n\t\treturn this;\n\t}\n\n\tprotected M cache;\n\t@Override\n\tpublic M getCache() {\n\t\treturn cache;\n\t}\n\n\t@Override\n\tpublic AbstractObjectParser setCache(M cache) {\n\t\tthis.cache = cache;\n\t\treturn this;\n\t}\n\n\tprotected int position;\n\tpublic int getPosition() {\n\t\treturn position;\n\t}\n\tpublic AbstractObjectParser setPosition(int position) {\n\t\tthis.position = position;\n\t\treturn this;\n\t}\n\n\n\tprivate boolean invalidate = false;\n\tpublic void invalidate() {\n\t\tinvalidate = true;\n\t}\n\tpublic boolean isInvalidate() {\n\t\treturn invalidate;\n\t}\n\n\tprivate boolean breakParse = false;\n\tpublic void breakParse() {\n\t\tbreakParse = true;\n\t}\n\tpublic boolean isBreakParse() {\n\t\treturn breakParse || isInvalidate();\n\t}\n\n\tprotected String name;\n\tprotected String table;\n\tprotected String alias;\n\tprotected boolean isReuse;\n\tprotected String path;\n\n\tprotected M response;\n\tprotected M sqlRequest;\n\tprotected M sqlResponse;\n\t/**\n\t * 自定义关键词\n\t */\n\tprotected Map customMap;\n\t/**\n\t * 远程函数\n\t * {\"-\":{ \"key-()\":value }, \"0\":{ \"key()\":value }, \"+\":{ \"key+()\":value } }\n\t * - : 在executeSQL前解析\n\t * 0 : 在executeSQL后、onChildParse前解析\n\t * + : 在onChildParse后解析\n\t */\n\tprotected Map> functionMap;\n\t/**\n\t * 子对象\n\t */\n\tprotected Map childMap;\n\n\tprivate int objectCount;\n\tprivate int arrayCount;\n\n private List rawKeyList;\n\t/**解析成员\n\t * response重新赋值\n\t * @return null or this\n\t * @throws Exception\n\t */\n\t@Override\n\tpublic AbstractObjectParser parse(String name, boolean isReuse) throws Exception {\n\t\tif (isInvalidate() == false) {\n\t\t\tthis.isReuse = isReuse;\n\t\t\tthis.name = name;\n\t\t\tthis.path = AbstractParser.getAbsPath(parentPath, name);\n\n\t\t\tapijson.orm.Entry tentry = Pair.parseEntry(name, true);\n\t\t\tthis.table = tentry.getKey();\n\t\t\tthis.alias = tentry.getValue();\n\n\t\t\tLog.d(TAG, \"AbstractObjectParser parentPath = \" + parentPath + \"; name = \" + name + \"; table = \" + table + \"; alias = \" + alias);\n\t\t\tLog.d(TAG, \"AbstractObjectParser type = \" + type + \"; isTable = \" + isTable + \"; isArrayMainTable = \" + isArrayMainTable);\n\t\t\tLog.d(TAG, \"AbstractObjectParser isEmpty = \" + request.isEmpty() + \"; tri = \" + tri + \"; drop = \" + drop);\n\n\t\t\tbreakParse = false;\n\n\t\t\tresponse = JSON.createJSONObject(); // must init\n\t\t\tsqlResponse = null; // must init\n\n\t\t\tif (isReuse == false) {\n\t\t\t\tsqlRequest = JSON.createJSONObject(); // must init\n\n\t\t\t\tcustomMap = null; // must init\n\t\t\t\tfunctionMap = null; // must init\n\t\t\t\tchildMap = null; // must init\n\n\t\t\t\tSet> set = request.isEmpty() ? null : new LinkedHashSet<>(request.entrySet());\n\t\t\t\tif (set != null && set.isEmpty() == false) { // 判断换取少几个变量的初始化是否值得？\n\t\t\t\t\tif (isTable) { // 非Table下必须保证原有顺序！否则 count,page 会丢, total@:\"/[]/total\" 会在[]:{}前执行！\n\t\t\t\t\t\tcustomMap = new LinkedHashMap();\n\t\t\t\t\t\tchildMap = new LinkedHashMap();\n\t\t\t\t\t}\n\t\t\t\t\tfunctionMap = new LinkedHashMap>();//必须执行\n\n\t\t\t\t\t// 条件 <<<<<<<<<<<<<<<<<<<\n\t\t\t\t\tList whereList = null;\n\t\t\t\t\tif (method == PUT) { // 这里只有PUTArray需要处理 || method == DELETE) {\n\t\t\t\t\t\tString[] combine = StringUtil.split(getString(request, KEY_COMBINE));\n\t\t\t\t\t\tif (combine != null) {\n\t\t\t\t\t\t\tString w;\n\t\t\t\t\t\t\tfor (int i = 0; i < combine.length; i++) { // 去除 &,|,! 前缀\n\t\t\t\t\t\t\t\tw = combine[i];\n\t\t\t\t\t\t\t\tif (w != null && (w.startsWith(\"&\") || w.startsWith(\"|\") || w.startsWith(\"!\"))) {\n\t\t\t\t\t\t\t\t\tcombine[i] = w.substring(1);\n\t\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t}\n\t\t\t\t\t\t// Arrays.asList() 返回值不支持 add 方法！\n\t\t\t\t\t\twhereList = new ArrayList(Arrays.asList(combine != null ? combine : new String[]{}));\n\t\t\t\t\t\twhereList.add(JSONMap.KEY_ID);\n\t\t\t\t\t\twhereList.add(JSONMap.KEY_ID_IN);\n\t\t\t\t\t\t//\t\t\t\t\t\twhereList.add(apijson.JSONMap.KEY_USER_ID);\n\t\t\t\t\t\t//\t\t\t\t\t\twhereList.add(apijson.JSONMap.KEY_USER_ID_IN);\n\t\t\t\t\t}\n\t\t\t\t\t// 条件>>>>>>>>>>>>>>>>>>>\n\n\t\t\t\t\tint index = 0;\n // hasOtherKeyNotFun = false;\n\t\t\t\t\tM viceItem = null;\n\n\t\t\t\t\tfor (Entry entry : set) {\n\t\t\t\t\t\tif (isBreakParse()) {\n\t\t\t\t\t\t\tbreak;\n\t\t\t\t\t\t}\n\n\t\t\t\t\t\t// key 可能为 JSONList，需要进行手动转换（fastjson 为低版本时允许自动转换，如 1.2.21）\n\t\t\t\t\t\t// 例如 request json为 \"{[]:{\"page\": 2, \"table1\":{}}}\"\n\t\t\t\t\t\tObject field = entry == null ? null : entry.getKey();\n\t\t\t\t\t\tString key = field instanceof Map ? toJSONString(field) : field.toString();\n\t\t\t\t\t\tObject value = key == null ? null : entry.getValue();\n\t\t\t\t\t\tif (value == null) {\n\t\t\t\t\t\t\tcontinue;\n\t\t\t\t\t\t}\n\n // 处理url crud, 将crud 转换为真实method\n RequestMethod _method = this.parser.getRealMethod(method, key, value);\n\t\t\t\t\t\t// 没有执行校验流程的情况,比如url head, sql@子查询, sql@ method=GET\n\n\t\t\t\t\t\tObject obj = key.endsWith(\"@\") ? request.get(key) : null;\n\t\t\t\t\t\tif (obj instanceof Map) {\n\t\t\t\t\t\t\t((Map) obj).put(JSONMap.KEY_METHOD, GET);\n\t\t\t\t\t\t}\n\n\t\t\t\t\t\ttry {\n boolean startsWithAt = key.startsWith(\"@\");\n // if (startsWithAt || (key.endsWith(\"()\") == false)) {\n // hasOtherKeyNotFun = true;\n // }\n\n\t\t\t\t\t\t\tboolean isTrim = (trimKeyList != null && trimKeyList.contains(key));\n\t\t\t\t\t\t\tboolean toStr = isTrim || (stringKeyList != null && stringKeyList.contains(key));\n\t\t\t\t\t\t\tif (toStr) {\n\t\t\t\t\t\t\t\tvalue = JSON.toJSONString(value);\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\tif (isTrim && value != null) {\n\t\t\t\t\t\t\t\tvalue = StringUtil.trim(value);\n\t\t\t\t\t\t\t}\n\n\t\t\t\t\t\t\tif (startsWithAt || key.endsWith(\"@\") || (key.endsWith(\"<>\") && value instanceof Map)) {\n\t\t\t\t\t\t\t\tif (onParse(key, value) == false) {\n\t\t\t\t\t\t\t\t\tinvalidate();\n\t\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\telse if (value instanceof Map) { // JSONRequest，往下一级提取\n\t\t\t\t\t\t\t\tif (childMap != null) { // 添加到childMap，最后再解析\n\t\t\t\t\t\t\t\t\tchildMap.put(key, (M) value);\n\t\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\t\telse { // 直接解析并替换原来的，[]:{} 内必须直接解析，否则会因为丢掉count等属性，并且total@:\"/[]/total\"必须在[]:{} 后！\n\t\t\t\t\t\t\t\t\tObject cache = index <= 0 || type != TYPE_ITEM || viceItem == null ? null : JSON.get(viceItem, key);\n\t\t\t\t\t\t\t\t\tObject result = onChildParse(index, key, (M) value, cache);\n\t\t\t\t\t\t\t\t\tif (index <= 0 && type == TYPE_ITEM) {\n\t\t\t\t\t\t\t\t\t\tM mainItem = (M) result;\n\t\t\t\t\t\t\t\t\t\tviceItem = result == null ? null : (M) mainItem.remove(AbstractSQLExecutor.KEY_VICE_ITEM);\n\t\t\t\t\t\t\t\t\t}\n\n\t\t\t\t\t\t\t\t\tresponse.put(key, result);\n\t\t\t\t\t\t\t\t\tindex ++;\n\t\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\telse if ((_method == POST || _method == PUT) && value instanceof List\n\t\t\t\t\t\t\t\t\t&& JSONMap.isTableArray(key)) { // L，批量新增或修改，往下一级提取\n\t\t\t\t\t\t\t\tonTableArrayParse(key, (L) value);\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\telse if (_method == PUT && value instanceof List && (whereList == null || whereList.contains(key) == false)\n\t\t\t\t\t\t\t\t\t&& StringUtil.isName(key.replaceFirst(\"[+-]$\", \"\"))) { // PUT L\n\t\t\t\t\t\t\t\tonPUTArrayParse(key, (L) value);\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\telse { // L 或其它 Object，直接填充\n\t\t\t\t\t\t\t\tif (onParse(key, value) == false) {\n\t\t\t\t\t\t\t\t\tinvalidate();\n\t\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t} catch (Exception e) {\n\t\t\t\t\t\t\tif (tri == false) {\n\t\t\t\t\t\t\t\tthrow CommonException.wrap(e, sqlConfig); // 不忽略错误，抛异常\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\tinvalidate(); // 忽略错误，还原request\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\n\t\t\t\t}\n\n\t\t\t\tif (isTable) {\n\t\t\t\t\t// parser.onVerifyRole 已处理 globalRole\n\n\t\t\t\t\tString db = parser.getGlobalDatabase();\n\t\t\t\t\tif (db != null) {\n\t\t\t\t\t\tsqlRequest.putIfAbsent(JSONMap.KEY_DATABASE, db);\n\t\t\t\t\t}\n\n\t\t\t\t\tString ds = parser.getGlobalDatasource();\n\t\t\t\t\tif (ds != null) {\n\t\t\t\t\t\tsqlRequest.putIfAbsent(JSONMap.KEY_DATASOURCE, ds);\n\t\t\t\t\t}\n\n\t\t\t\t\tString ns = parser.getGlobalNamespace();\n\t\t\t\t\tif (ns != null) {\n\t\t\t\t\t\tsqlRequest.putIfAbsent(JSONMap.KEY_NAMESPACE, ns);\n\t\t\t\t\t}\n\n\t\t\t\t\tString cl = parser.getGlobalCatalog();\n\t\t\t\t\tif (cl != null) {\n\t\t\t\t\t\tsqlRequest.putIfAbsent(JSONMap.KEY_CATALOG, cl);\n\t\t\t\t\t}\n\n\t\t\t\t\tString sch = parser.getGlobalSchema();\n\t\t\t\t\tif (sch != null) {\n\t\t\t\t\t\tsqlRequest.putIfAbsent(JSONMap.KEY_SCHEMA, sch);\n\t\t\t\t\t}\n\n\t\t\t\t\tif (isSubquery == false) { // 解决 SQL 语法报错，子查询不能 EXPLAIN\n\t\t\t\t\t\tBoolean exp = parser.getGlobalExplain();\n\t\t\t\t\t\tif (sch != null) {\n\t\t\t\t\t\t\tsqlRequest.putIfAbsent(JSONMap.KEY_EXPLAIN, exp);\n\t\t\t\t\t\t}\n\n\t\t\t\t\t\tString cache = parser.getGlobalCache();\n\t\t\t\t\t\tif (cache != null) {\n\t\t\t\t\t\t\tsqlRequest.putIfAbsent(JSONMap.KEY_CACHE, cache);\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t}\n\n\t\t\tif (isTable) { // 非Table内的函数会被滞后在onChildParse后调用\n\t\t\t\tonFunctionResponse(\"-\");\n\t\t\t}\n\n\t\t}\n\n\t\tif (isInvalidate()) {\n\t\t\trecycle();\n\t\t\treturn null;\n\t\t}\n\n\t\treturn this;\n\t}\n\n\n\n\n //private boolean hasOtherKeyNotFun = false;\n\n /**解析普通成员\n\t * @param key\n\t * @param value\n\t * @return whether parse succeed\n\t */\n\t@Override\n\tpublic boolean onParse(@NotNull String key, @NotNull Object value) throws Exception {\n\t\tif (key.endsWith(\"@\")) { // StringUtil.isPath((String) value)) {\n\t\t\t// [] 内主表 position > 0 时，用来生成 SQLConfig 的键值对全都忽略，不解析\n\t\t\tif (value instanceof Map) { // key{}@ getRealKey, SQL 子查询对象，JSONRequest -> SQLConfig.getSQL\n\t\t\t\tString replaceKey = key.substring(0, key.length() - 1);\n\n\t\t\t\tM subquery = (M) value;\n\t\t\t\tString range = getString(subquery, KEY_SUBQUERY_RANGE);\n\t\t\t\tif (range != null && SUBQUERY_RANGE_ALL.equals(range) == false && SUBQUERY_RANGE_ANY.equals(range) == false) {\n\t\t\t\t\tthrow new IllegalArgumentException(\"子查询 \" + path + \"/\" + key + \":{ range:value } 中 value 只能为 [\"\n + SUBQUERY_RANGE_ALL + \", \" + SUBQUERY_RANGE_ANY + \"] 中的一个！\");\n\t\t\t\t}\n\n\t\t\t\tL arr = parser.onArrayParse(subquery, path, key, true, null);\n\n\t\t\t\tM obj = arr == null || arr.isEmpty() ? null : JSON.get(arr, 0);\n\t\t\t\tif (obj == null) {\n\t\t\t\t\tthrow new Exception(\"服务器内部错误，解析子查询 \" + path + \"/\" + key + \":{ } 为 Subquery 对象失败！\");\n\t\t\t\t}\n\n\t\t\t\tString from = getString(subquery, apijson.JSONRequest.KEY_SUBQUERY_FROM);\n\t\t\t\tboolean isEmpty = StringUtil.isEmpty(from);\n\t\t\t\tM arrObj = isEmpty ? null : JSON.get(obj, from);\n\t\t\t\tif (isEmpty) {\n\t\t\t\t\tSet> set = obj.entrySet();\n\t\t\t\t\tfor (Entry e : set) {\n\t\t\t\t\t\tString k = e == null ? null : e.getKey();\n\t\t\t\t\t\tObject v = k == null ? null : e.getValue();\n\t\t\t\t\t\tif (v instanceof Map && JSONMap.isTableKey(k)) {\n\t\t\t\t\t\t\tfrom = k;\n\t\t\t\t\t\t\tarrObj = (M) v;\n\t\t\t\t\t\t\tbreak;\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\t\t\t\t}\n\n\t\t\t\tif (arrObj == null) {\n\t\t\t\t\tthrow new IllegalArgumentException(\"子查询 \" + path + \"/\"\n + key + \":{ from:value } 中 value 对应的主表对象 \" + from + \":{} 不存在！\");\n\t\t\t\t}\n\n\t\t\t\tSQLConfig cfg = (SQLConfig) arrObj.get(AbstractParser.KEY_CONFIG);\n\t\t\t\tif (cfg == null) {\n\t\t\t\t\tthrow new NotExistException(TAG + \".onParse cfg == null\");\n\t\t\t\t}\n\n\t\t\t\tSubquery s = new Subquery();\n\t\t\t\ts.setPath(path);\n\t\t\t\ts.setOriginKey(key);\n\t\t\t\ts.setOriginValue(subquery);\n\n\t\t\t\ts.setFrom(from);\n\t\t\t\ts.setRange(range);\n\t\t\t\ts.setKey(replaceKey);\n\t\t\t\ts.setConfig(cfg);\n\n\t\t\t\tkey = replaceKey;\n\t\t\t\tvalue = s; //(range == null || range.isEmpty() ? \"\" : \"range\") + \"(\" + cfg.getSQL(false) + \") \";\n\n\t\t\t\tparser.putQueryResult(AbstractParser.getAbsPath(path, key), s); //字符串引用保证不了安全性 parser.getSQL(cfg));\n\t\t\t}\n\t\t\telse if (value instanceof String) { // //key{}@ getRealKey, 引用赋值路径\n\t\t\t\tString replaceKey = key.substring(0, key.length() - 1);\n\n\t\t\t\t// System.out.println(\"getObject key.endsWith(@) >> parseRelation = \" + parseRelation);\n\t\t\t\tString targetPath = AbstractParser.getValuePath(type == TYPE_ITEM ? path : parentPath, (String) value);\n\n\t\t\t\t// 先尝试获取，尽量保留缺省依赖路径，这样就不需要担心路径改变\n\t\t\t\tObject target = onReferenceParse(targetPath);\n\t\t\t\tLog.i(TAG, \"onParse targetPath = \" + targetPath + \"; target = \" + target);\n\n\t\t\t\tif (target == null) { // String#equals(null)会出错\n\t\t\t\t\tLog.d(TAG, \"onParse target == null >> return true;\");\n\n\t\t\t\t\tif (Log.DEBUG) {\n\t\t\t\t\t\tparser.putWarnIfNeed(AbstractParser.KEY_REF, path + \"/\" + key + \": \" + targetPath + \" 引用赋值获取路径对应的值为 null！请检查路径是否错误！\");\n\t\t\t\t\t}\n\n\t\t\t\t\t// 非查询关键词 @key 不影响查询，直接跳过\n\t\t\t\t\tif (isTable && (key.startsWith(\"@\") == false || JSONMap.TABLE_KEY_LIST.contains(key))) {\n\t\t\t\t\t\tLog.e(TAG, \"onParse isTable && (key.startsWith(@) == false\"\n\t\t\t\t\t\t\t\t+ \" || apijson.JSONMap.TABLE_KEY_LIST.contains(key)) >> return null;\");\n\t\t\t\t\t\t// FIXME getCache() != null 时 return true，解决 RIGHT/OUTER/FOREIGN JOIN 主表无数据导致副表数据也不返回\n\t\t\t\t\t\treturn false; // 获取不到就不用再做无效的 query 了。不考虑 Table:{Table:{}} 嵌套\n\t\t\t\t\t}\n\n\t\t\t\t\tLog.d(TAG, \"onParse isTable(table) == false >> return true;\");\n\t\t\t\t\treturn true; // 舍去，对Table无影响\n\t\t\t\t}\n\n//\t\t\t\tif (target instanceof Map) { // target 可能是从 requestObject 里取出的 {}\n//\t\t\t\t\tif (isTable || targetPath.endsWith(\"[]/\" + JSONResponse.KEY_INFO) == false) {\n//\t\t\t\t\t\tLog.d(TAG, \"onParse target instanceof Map >> return false;\");\n//\t\t\t\t\t\treturn false; // FIXME 这个判断现在来看是否还有必要？为啥不允许为 JSONRequest ？以前可能因为防止二次遍历再解析，现在只有一次遍历\n//\t\t\t\t\t}\n//\t\t\t\t}\n//\n//\t\t\t\t// FIXME 这个判断现在来看是否还有必要？为啥不允许为 JSONRequest ？以前可能因为防止二次遍历再解析，现在只有一次遍历\n//\t\t\t\tif (targetPath.equals(target)) { // 必须 valuePath 和保证 getValueByPath 传进去的一致！\n//\t\t\t\t\tLog.d(TAG, \"onParse targetPath.equals(target) >>\");\n//\n//\t\t\t\t\t//非查询关键词 @key 不影响查询，直接跳过\n//\t\t\t\t\tif (isTable && (key.startsWith(\"@\") == false || apijson.JSONMap.TABLE_KEY_LIST.contains(key))) {\n//\t\t\t\t\t\tLog.e(TAG, \"onParse isTable && (key.startsWith(@) == false\"\n//\t\t\t\t\t\t\t\t+ \" || apijson.JSONMap.TABLE_KEY_LIST.contains(key)) >> return null;\");\n//\t\t\t\t\t\treturn false;//获取不到就不用再做无效的query了。不考虑 Table:{Table:{}}嵌套\n//\t\t\t\t\t} else {\n//\t\t\t\t\t\tLog.d(TAG, \"onParse isTable(table) == false >> return true;\");\n//\t\t\t\t\t\treturn true;//舍去，对Table无影响\n//\t\t\t\t\t}\n//\t\t\t\t}\n\n\t\t\t\t// 直接替换原来的 key@: path 为 key: target\n\t\t\t\tLog.i(TAG, \"onParse >> key = replaceKey; value = target;\");\n\t\t\t\tkey = replaceKey;\n\t\t\t\tvalue = target;\n\t\t\t\tLog.d(TAG, \"onParse key = \" + key + \"; value = \" + value);\n\t\t\t}\n\t\t\telse {\n\t\t\t\tthrow new IllegalArgumentException(path + \"/\" + key + \":value 中 value 必须为 依赖路径String 或 SQL子查询JSONObject ！\");\n\t\t\t}\n\t\t}\n\n\t\tif (key.endsWith(\"()\")) {\n\t\t\tif (value instanceof String == false) {\n\t\t\t\tthrow new IllegalArgumentException(path + \"/\" + key + \":value 中 value 必须为函数String！\");\n\t\t\t}\n\n\t\t\tString k = key.substring(0, key.length() - 2);\n\n\t\t\tString type; //远程函数比较少用，一般一个Table:{}内用到也就一两个，所以这里用 \"-\",\"0\",\"+\" 更直观，转用 -1,0,1 对性能提升不大。\n\t\t\tboolean isMinus = k.endsWith(\"-\");\n boolean isPlus = isMinus == false && k.endsWith(\"+\");\n\t\t\tif (isMinus) { //不能封装到functionMap后批量执行，否则会导致非Table内的 key-():function() 在onChildParse后执行！\n\t\t\t\ttype = \"-\";\n\t\t\t\tk = k.substring(0, k.length() - 1);\n\t\t\t}\n\t\t\telse if (isPlus) {\n\t\t\t\ttype = \"+\";\n\t\t\t\tk = k.substring(0, k.length() - 1);\n\t\t\t}\n\t\t\telse {\n\t\t\t\ttype = \"0\";\n\t\t\t}\n\n if (isPlus == false && isTable == false) {\n parseFunction(key, k, (String) value, this.type == TYPE_ITEM ? path : parentPath, name, request, isMinus);\n }\n else {\n\t\t\t\t//远程函数比较少用，一般一个Table:{}内用到也就一两个，所以这里循环里new出来对性能影响不大。\n\t\t\t\tMap map = functionMap.get(type);\n\t\t\t\tif (map == null) {\n\t\t\t\t\tmap = new LinkedHashMap<>();\n\t\t\t\t}\n\t\t\t\tmap.put(k, (String) value);\n\n\t\t\t\tfunctionMap.put(type, map);\n\t\t\t}\n\t\t}\n\t\telse if (isTable && key.startsWith(\"@\") && JSONMap.TABLE_KEY_LIST.contains(key) == false) {\n customMap.put(key, value);\n\t\t}\n\t\telse {\n\t\t\tsqlRequest.put(key, value);\n\t\t}\n\n\t\treturn true;\n\t}\n\n\n\n\t/**\n\t * @param index\n\t * @param key\n\t * @param value\n\t * @param cache\n\t * @return\n\t * @throws Exception\n\t */\n\t@Override\n\tpublic Object onChildParse(int index, String key, M value, Object cache) throws Exception {\n\t\tboolean isFirst = index <= 0;\n\t\tboolean isMain = isFirst && type == TYPE_ITEM;\n\n\t\tObject child;\n\t\tboolean isEmpty;\n\n\t\tif (JSONMap.isArrayKey(key)) { // APIJSON Array\n\t\t\tif (isMain) {\n\t\t\t\tthrow new IllegalArgumentException(parentPath + \"/\" + key + \":{} 不合法！\"\n\t\t\t\t\t\t+ \"数组 []:{} 中第一个 key:{} 必须是主表 TableKey:{} ！不能为 arrayKey[]:{} ！\");\n\t\t\t}\n\n\t\t\tif (arrayConfig == null || arrayConfig.getPosition() == 0) {\n\t\t\t\tarrayCount ++;\n\t\t\t\tint maxArrayCount = parser.getMaxArrayCount();\n\t\t\t\tif (arrayCount > maxArrayCount) {\n\t\t\t\t\tthrow new IllegalArgumentException(path + \" 内截至 \" + key + \":{} 时数组对象 key[]:{} \"\n + \"的数量达到 \" + arrayCount + \" 已超限，必须在 0-\" + maxArrayCount + \" 内 !\");\n\t\t\t\t}\n\t\t\t}\n\n\t\t\tString query = getString(value, KEY_QUERY);\n\t\t\tchild = parser.onArrayParse(value, path, key, isSubquery, cache instanceof List ? (L) cache : null);\n\t\t\tisEmpty = child == null || ((List) child).isEmpty();\n\n\t\t\tif (\"2\".equals(query) || \"ALL\".equals(query)) { // 不判断 isEmpty，因为分页数据可能只是某页没有\n\t\t\t\tString totalKey = JSONResponse.formatArrayKey(key) + \"Total\";\n\t\t\t\tString infoKey = JSONResponse.formatArrayKey(key) + \"Info\";\n\t\t\t\tif ((request.containsKey(totalKey) || request.containsKey(infoKey)\n\t\t\t\t\t\t|| request.containsKey(totalKey + \"@\") || request.containsKey(infoKey + \"@\")) == false) {\n\t\t\t\t\t// onParse(\"total@\", \"/\" + key + \"/total\");\n\t\t\t\t\t// onParse(infoKey + \"@\", \"/\" + key + \"/info\");\n\t\t\t\t\t// 替换为以下性能更好、对流程干扰最小的方式：\n\n\t\t\t\t\tString keyPath = AbstractParser.getValuePath(type == TYPE_ITEM ? path : parentPath, \"/\" + key);\n\t\t\t\t\tString totalPath = keyPath + \"/total\";\n\t\t\t\t\tString infoPath = keyPath + \"/info\";\n\t\t\t\t\tresponse.put(totalKey, onReferenceParse(totalPath));\n\t\t\t\t\tresponse.put(infoKey, onReferenceParse(infoPath));\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t\telse { //APIJSON Object\n\t\t\tboolean isTableKey = JSONMap.isTableKey(Pair.parseEntry(key, true).getKey());\n\t\t\tif (type == TYPE_ITEM && isTableKey == false) {\n\t\t\t\tthrow new IllegalArgumentException(parentPath + \"/\" + key + \":{} 不合法！\"\n\t\t\t\t\t\t+ \"数组 []:{} 中每个 key:{} 都必须是表 TableKey:{} 或 数组 arrayKey[]:{} ！\");\n\t\t\t}\n\n\t\t\tif ( //避免使用 \"test\":{\"Test\":{}} 绕过限制，实现查询爆炸 isTableKey &&\n\t\t\t\t\t(arrayConfig == null || arrayConfig.getPosition() == 0)) {\n\t\t\t\tobjectCount ++;\n\t\t\t\tint maxObjectCount = parser.getMaxObjectCount();\n\t\t\t\tif (objectCount > maxObjectCount) { //TODO 这里判断是批量新增/修改，然后上限为 maxUpdateCount\n\t\t\t\t\tthrow new IllegalArgumentException(path + \" 内截至 \" + key + \":{} 时对象\"\n\t\t\t\t\t\t\t+ \" key:{} 的数量达到 \" + objectCount + \" 已超限，必须在 0-\" + maxObjectCount + \" 内 !\");\n\t\t\t\t}\n\t\t\t}\n\n\t\t\tchild = parser.onObjectParse(value, path, key, isMain ? arrayConfig.setType(SQLConfig.TYPE_ITEM_CHILD_0) : null\n\t\t\t\t\t, isSubquery, cache instanceof Map ? (M) cache : null);\n\n\t\t\tisEmpty = child == null || ((Map) child).isEmpty();\n\t\t\tif (isFirst && isEmpty) {\n\t\t\t\tinvalidate();\n\t\t\t}\n\t\t}\n//\t\tLog.i(TAG, \"onChildParse ObjectParser.onParse key = \" + key + \"; child = \" + child);\n\n\t\treturn isEmpty ? null : child; // 只添加! isChildEmpty的值，可能数据库返回数据不够count\n\t}\n\n\n\t//TODO 改用 MySQL json_add,json_remove,json_contains 等函数！不过就没有具体报错了，或许可以新增功能符，或者直接调 SQL 函数\n\n\t/**PUT key:[]\n\t * @param key\n\t * @param array\n\t * @throws Exception\n\t */\n\t@Override\n\tpublic void onPUTArrayParse(@NotNull String key, @NotNull L array) throws Exception {\n\t\tif (isTable == false || array.isEmpty()) {\n\t\t\tsqlRequest.put(key, array);\n\t\t\tLog.e(TAG, \"onPUTArrayParse isTable == false || array == null || array.isEmpty() >> return;\");\n\t\t\treturn;\n\t\t}\n\n\t\tint putType = 0;\n\t\tif (key.endsWith(\"+\")) {//add\n\t\t\tputType = 1;\n\t\t} else if (key.endsWith(\"-\")) {//remove\n\t\t\tputType = 2;\n\t\t} else {//replace\n\t\t\tsqlRequest.put(key, array);\n\t\t\treturn;\n\t\t}\n\t\tString realKey = AbstractSQLConfig.gainRealKey(method, key, false, false);\n\n\t\t//GET > add all 或 remove all > PUT > remove key\n\n\t\t//GET <<<<<<<<<<<<<<<<<<<<<<<<<\n\t\tM rq = JSON.createJSONObject();\n\t\trq.put(JSONMap.KEY_ID, request.get(JSONMap.KEY_ID));\n\t\trq.put(JSONMap.KEY_COLUMN, realKey);\n\t\tM rp = parseResponse(RequestMethod.GET, table, null, rq, null, false);\n\t\t//GET >>>>>>>>>>>>>>>>>>>>>>>>>\n\n\n\t\t//add all 或 remove all <<<<<<<<<<<<<<<<<<<<<<<<<\n\t\tObject target = rp == null ? null : rp.get(realKey);\n\t\tif (target instanceof String) {\n\t\t\ttry {\n\t\t\t\ttarget = JSON.parse(target);\n\t\t\t} catch (Throwable e) {\n\t\t\t\tif (Log.DEBUG) {\n\t\t\t\t\tLog.e(TAG, \"try {\\n\" +\n\t\t\t\t\t\t\t\"\\t\\t\\t\\ttarget = parseJSON((String) target);\\n\" +\n\t\t\t\t\t\t\t\"\\t\\t\\t}\\n\" +\n\t\t\t\t\t\t\t\"\\t\\t\\tcatch (Throwable e) = \" + e.getMessage());\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\n\t\tif (apijson.JSON.isBoolOrNumOrStr(target)) {\n\t\t\tthrow new NullPointerException(\"PUT \" + path + \", \" + realKey + \" 类型为 \" + target.getClass().getSimpleName() + \"，\"\n\t\t\t\t\t+ \"不支持 Boolean, String, Number 等类型字段使用 'key+': [] 或 'key-': [] ！\"\n\t\t\t\t\t+ \"对应字段在数据库的值必须为 L, JSONRequest 中的一种！\"\n\t\t\t\t\t+ \"值为 JSONRequest 类型时传参必须是 'key+': [{'key': value, 'key2': value2}] 或 'key-': ['key', 'key2'] ！\"\n\t\t\t);\n\t\t}\n\n\t\tboolean isAdd = putType == 1;\n\n\t\tCollection targetArray = target instanceof Collection ? (Collection) target : null;\n\t\tMap targetObj = target instanceof Map ? (Map) target : null;\n\n\t\tif (targetArray == null && targetObj == null) {\n\t\t\tif (isAdd == false) {\n\t\t\t\tthrow new NullPointerException(\"PUT \" + path + \", \" + realKey + (target == null ? \" 值为 null，不支持移除！\"\n\t\t\t\t\t\t: \" 类型为 \" + target.getClass().getSimpleName() + \"，不支持这样移除！\")\n\t\t\t\t\t\t+ \"对应字段在数据库的值必须为 L, JSONRequest 中的一种，且 key- 移除时，本身的值不能为 null！\"\n\t\t\t\t\t\t+ \"值为 JSONRequest 类型时传参必须是 'key+': [{'key': value, 'key2': value2}] 或 'key-': ['key', 'key2'] ！\"\n\t\t\t\t);\n\t\t\t}\n\n\t\t\ttargetArray = JSON.createJSONArray();\n\t\t}\n\n\t\tfor (int i = 0; i < array.size(); i++) {\n\t\t\tObject obj = array.get(i);\n\t\t\tif (obj == null) {\n\t\t\t\tcontinue;\n\t\t\t}\n\n\t\t\tif (isAdd) {\n\t\t\t\tif (targetArray != null) {\n\t\t\t\t\tif (targetArray.contains(obj)) {\n\t\t\t\t\t\tthrow new ConflictException(\"PUT \" + path + \", \" + key + \"/\" + i + \" 已存在！\");\n\t\t\t\t\t}\n\t\t\t\t\ttargetArray.add(obj);\n\t\t\t\t} else {\n\t\t\t\t\tif (obj != null && obj instanceof Map == false) {\n\t\t\t\t\t\tthrow new ConflictException(\"PUT \" + path + \", \" + key + \"/\" + i + \" 必须为 JSONRequest {} ！\");\n\t\t\t\t\t}\n\t\t\t\t\ttargetObj.putAll((Map) obj);\n\t\t\t\t}\n\t\t\t} else {\n\t\t\t\tif (targetArray != null) {\n\t\t\t\t\tif (targetArray.contains(obj) == false) {\n\t\t\t\t\t\tthrow new NullPointerException(\"PUT \" + path + \", \" + key + \"/\" + i + \" 不存在！\");\n\t\t\t\t\t}\n\t\t\t\t\ttargetArray.remove(obj);\n\t\t\t\t} else {\n\t\t\t\t\tif (obj instanceof String == false) {\n\t\t\t\t\t\tthrow new ConflictException(\"PUT \" + path + \", \" + key + \"/\" + i + \" 必须为 String 类型 ！\");\n\t\t\t\t\t}\n\t\t\t\t\tif (targetObj.containsKey(obj) == false) {\n\t\t\t\t\t\tthrow new NullPointerException(\"PUT \" + path + \", \" + key + \"/\" + i + \" 不存在！\");\n\t\t\t\t\t}\n\t\t\t\t\ttargetObj.remove(obj);\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\n\t\t//add all 或 remove all >>>>>>>>>>>>>>>>>>>>>>>>>\n\n\t\t//PUT <<<<<<<<<<<<<<<<<<<<<<<<<\n\t\tsqlRequest.put(realKey, targetArray != null ? targetArray : JSON.toJSONString(targetObj)); // FIXME, SerializerFeature.WriteMapNullValue));\n\t\t//PUT >>>>>>>>>>>>>>>>>>>>>>>>>\n\n\t}\n\n\n\t@Override\n\tpublic void onTableArrayParse(String key, L valueArray) throws Exception {\n\t\tString childKey = key.substring(0, key.length() - JSONMap.KEY_ARRAY.length());\n\n\t\tint allCount = 0;\n\t\tL ids = JSON.createJSONArray();\n\n\t\tint version = parser.getVersion();\n\t\tint maxUpdateCount = parser.getMaxUpdateCount();\n\n SQLConfig cfg = null; // 不能污染当前的配置 getSQLConfig();\n if (cfg == null) { // TODO 每次都创建成本比较高，是否新增 defaultInstance 或者 configInstance 用来专门 getIdKey 等？\n cfg = parser.createSQLConfig();\n }\n\n\t\tString idKey = cfg.getIdKey(); //Table[]: [{}] arrayConfig 为 null\n\t\tboolean isNeedVerifyContent = parser.isNeedVerifyContent();\n\n cfg.setTable(childKey); // Request 表 structure 中配置 \"ALLOW_PARTIAL_UPDATE_FAILED\": \"Table[],key[],key:alias[]\" 自动配置\n boolean allowPartialFailed = cfg.allowPartialUpdateFailed();\n L failedIds = allowPartialFailed ? JSON.createJSONArray() : null;\n\n int firstFailIndex = -1;\n M firstFailReq = null;\n Throwable firstFailThrow = null;\n\t\tfor (int i = 0; i < valueArray.size(); i++) { //只要有一条失败，则抛出异常，全部失败\n\t\t\t//TODO 改成一条多 VALUES 的 SQL 性能更高，报错也更会更好处理，更人性化\n\t\t\tM item;\n\t\t\ttry {\n\t\t\t\titem = JSON.get(valueArray, i);\n if (item == null) {\n throw new NullPointerException();\n }\n\t\t\t}\n\t\t\tcatch (Exception e) {\n\t\t\t\tthrow new UnsupportedDataTypeException(\n \"批量新增/修改失败！\" + key + \"/\" + i + \":value 中value不合法！类型必须是 OBJECT ，结构为 {} !\"\n );\n\t\t\t}\n\n Object id = item.get(idKey);\n\t\t\tM req = JSON.createJSONObject(childKey, item);\n\n M result = null;\n try {\n if (isNeedVerifyContent) {\n req = parser.parseCorrectRequest(method, childKey, version, \"\", req, maxUpdateCount, parser);\n }\n //parser.getMaxSQLCount() ? 可能恶意调用接口，把数据库拖死\n result = (M) onChildParse(0, \"\" + i, req, null);\n }\n catch (Exception e) {\n if (allowPartialFailed == false) {\n throw e;\n }\n\n if (firstFailThrow == null) {\n firstFailThrow = e;\n firstFailReq = JSON.get(valueArray, i); // item\n }\n }\n\n result = result == null ? null : JSON.get(result, childKey);\n\n boolean success = JSONResponse.isSuccess(result);\n int count = result == null ? 0 : getIntValue(result, JSONResponse.KEY_COUNT);\n if (id == null && result != null) {\n id = result.get(idKey);\n }\n\n if (success == false || count != 1) { //如果 code = 200 但 count != 1，不能算成功，掩盖了错误不好排查问题\n if (allowPartialFailed) {\n failedIds.add(id);\n if (firstFailIndex < 0) {\n firstFailIndex = i;\n }\n }\n else {\n throw new ServerException(\n \"批量新增/修改失败！\" + key + \"/\" + i + \"：\" + (success ? \"成功但 count != 1 ！\"\n : (result == null ? \"null\" : getString(result, JSONResponse.KEY_MSG))\n ));\n }\n }\n\n\t\t\tallCount += 1; // 加了 allowPartialFailed 后 count 可能为 0 allCount += count;\n\t\t\tids.add(id);\n\t\t}\n\n int failedCount = failedIds == null ? 0 : failedIds.size();\n if (failedCount > 0 && failedCount >= allCount) {\n throw new ServerException(\"批量新增/修改 \" + key + \":[] 中 \" + allCount + \" 个子项全部失败！\"\n + \"第 \" + firstFailIndex + \" 项失败原因：\" + (firstFailThrow == null ? \"\" : firstFailThrow.getMessage()));\n }\n\n M allResult = getParser().newSuccessResult();\n if (failedCount > 0) {\n allResult.put(\"failedCount\", failedCount);\n allResult.put(\"failedIdList\", failedIds);\n\n M failObj = JSON.createJSONObject();\n failObj.put(\"index\", firstFailIndex);\n failObj.put(childKey, firstFailReq);\n\n if (firstFailThrow instanceof CommonException && firstFailThrow.getCause() != null) {\n firstFailThrow = firstFailThrow.getCause();\n }\n M obj = firstFailThrow == null ? failObj : getParser().extendErrorResult(failObj, firstFailThrow, parser.isRoot());\n if (Log.DEBUG && firstFailThrow != null) {\n obj.put(\"trace:throw\", firstFailThrow.getClass().getName());\n obj.put(\"trace:stack\", firstFailThrow.getStackTrace());\n }\n\n allResult.put(\"firstFailed\", obj);\n }\n allResult.put(JSONResponse.KEY_COUNT, allCount);\n allResult.put(idKey + \"[]\", ids);\n\n\t\tresponse.put(childKey, allResult); //不按原样返回，避免数据量过大\n\t}\n\n\n\t@Override\n\tpublic M parseResponse(RequestMethod method, String table, String alias\n , M request, List> joinList, boolean isProcedure) throws Exception {\n\t\tSQLConfig config = newSQLConfig(method, table, alias, request, joinList, isProcedure)\n\t\t\t\t.setParser(getParser())\n\t\t\t\t.setObjectParser(this);\n\t\treturn parseResponse(config, isProcedure);\n\t}\n\t@Override\n\tpublic M parseResponse(SQLConfig config, boolean isProcedure) throws Exception {\n\t\tparser = getParser();\n\t\tif (parser.getSQLExecutor() == null) {\n\t\t\tparser.createSQLExecutor();\n\t\t}\n\t\tif (config.gainParser() == null) {\n\t\t\tconfig.setParser(parser);\n\t\t}\n\t\treturn parser.getSQLExecutor().execute(config, isProcedure);\n\t}\n\n\n\t@Override\n\tpublic SQLConfig newSQLConfig(boolean isProcedure) throws Exception {\n\t\tString raw = Log.DEBUG == false || sqlRequest == null ? null : getString(sqlRequest, JSONMap.KEY_RAW);\n\t\tString[] keys = raw == null ? null : StringUtil.split(raw);\n\t\tif (keys != null && keys.length > 0) {\n\t\t\tboolean allow = AbstractSQLConfig.ALLOW_MISSING_KEY_4_COMBINE;\n\n\t\t\tfor (String key : keys) {\n\t\t\t\tif (sqlRequest.get(key) != null) {\n\t\t\t\t\tcontinue;\n\t\t\t\t}\n\n\t\t\t\tString msg = \"@raw:value 的 value 中 \" + key + \" 不合法！对应的 \"\n\t\t\t\t\t\t+ key + \": value 在当前对象 \" + name + \" 不存在或 value = null，无法有效转为原始 SQL 片段！\";\n\n\t\t\t\tif (allow == false) {\n\t\t\t\t\tthrow new UnsupportedOperationException(msg);\n\t\t\t\t}\n\n\t\t\t\tif (parser instanceof AbstractParser) {\n\t\t\t\t\t((AbstractParser) parser).putWarnIfNeed(JSONMap.KEY_RAW, msg);\n\t\t\t\t}\n\t\t\t\tbreak;\n\t\t\t}\n\t\t}\n\n\t\treturn newSQLConfig(method, table, alias, sqlRequest, joinList, isProcedure)\n\t\t\t\t.setParser(parser)\n\t\t\t\t.setObjectParser(this);\n\t}\n\n\t/**SQL 配置，for single object\n\t * @return {@link #setSQLConfig(int, int, int)}\n\t * @throws Exception\n\t */\n\t@Override\n\tpublic AbstractObjectParser setSQLConfig() throws Exception {\n\t\treturn setSQLConfig(RequestMethod.isQueryMethod(method) ? 1 : 0, 0, 0);\n\t}\n\n\t@Override\n\tpublic AbstractObjectParser setSQLConfig(int count, int page, int position) throws Exception {\n\t\tif (isTable == false || isReuse) {\n\t\t\treturn setPosition(position);\n\t\t}\n\n\t\tif (sqlConfig == null) {\n\t\t\ttry {\n\t\t\t\tsqlConfig = newSQLConfig(false);\n\t\t\t}\n\t\t\tcatch (Exception e) {\n\t\t\t\tif (e instanceof NotExistException || (e instanceof CommonException && e.getCause() instanceof NotExistException)) {\n\t\t\t\t\treturn this;\n\t\t\t\t}\n\t\t\t\tthrow e;\n\t\t\t}\n\t\t}\n\t\tsqlConfig.setCount(sqlConfig.getCount() <= 0 ? count : sqlConfig.getCount()).setPage(page).setPosition(position);\n\n\t\tparser.onVerifyRole(sqlConfig);\n\n\t\treturn this;\n\t}\n\n\n\n\n\tprotected SQLConfig sqlConfig = null;//array item复用\n\t/**SQL查询，for array item\n\t * @return this\n\t * @throws Exception\n\t */\n\t@Override\n\tpublic AbstractObjectParser executeSQL() throws Exception {\n\t\t//执行SQL操作数据库\n\t\tif (isTable == false) {//提高性能\n\t\t\tsqlResponse = JSON.createJSONObject();\n\t\t\tsqlResponse.putAll(sqlRequest);\n\t\t}\n\t\telse {\n try {\n sqlResponse = onSQLExecute();\n }\n catch (Exception e) {\n if (e instanceof NotExistException || (e instanceof CommonException && e.getCause() instanceof NotExistException)) {\n //\t\t\t\tLog.e(TAG, \"getObject try { response = getSQLObject(config2); } catch (Exception e) {\");\n //\t\t\t\tif (e instanceof NotExistException) {//非严重异常，有时候只是数据不存在\n //\t\t\t\t\t//\t\t\t\t\t\te.printStackTrace();\n sqlResponse = null;//内部吃掉异常，put到最外层\n //\t\t\t\t\t\trequestObject.put(JSONResponse.KEY_MSG\n //\t\t\t\t\t\t\t\t, StringUtil.getString(requestObject.get(JSONResponse.KEY_MSG)\n //\t\t\t\t\t\t\t\t\t\t+ \"; query \" + path + \" cath NotExistException:\"\n //\t\t\t\t\t\t\t\t\t\t+ newErrorResult(e).getString(JSONResponse.KEY_MSG)));\n //\t\t\t\t} else {\n //\t\t\t\t\tthrow e;\n //\t\t\t\t}\n }\n else {\n throw e;\n }\n }\n }\n\n if (drop) {//丢弃Table，只为了向下提供条件\n sqlResponse = null;\n }\n\n return this;\n\t}\n\n\t/**\n\t * @return response\n\t * @throws Exception\n\t */\n\t@Override\n\tpublic M response() throws Exception {\n\t\tif (sqlResponse == null || sqlResponse.isEmpty()) {\n\t\t\tif (isTable) {//Table自身都获取不到值，则里面的Child都无意义，不需要再解析\n\t\t\t\treturn null; // response;\n\t\t\t}\n\t\t} else {\n\t\t\tresponse.putAll(sqlResponse);\n\t\t}\n\n\n\t\t//把isTable时取出去的custom重新添加回来\n\t\tif (customMap != null) {\n\t\t\tresponse.putAll(customMap);\n\t\t}\n\n\n\t\tonFunctionResponse(\"0\");\n\n\t\tonChildResponse();\n\n\t\tonFunctionResponse(\"+\");\n\n\t\tonComplete();\n\n\t\treturn response;\n\t}\n\n\n\t@Override\n\tpublic void onFunctionResponse(String type) throws Exception {\n\t\tMap map = functionMap == null ? null : functionMap.get(type);\n\n\t\t//解析函数function\n\t\tSet> functionSet = map == null ? null : map.entrySet();\n\t\tif (functionSet != null && functionSet.isEmpty() == false) {\n boolean isMinus = \"-\".equals(type);\n\t\t\tM json = isMinus ? sqlRequest : response; // key-():function 是实时执行，而不是在这里批量执行\n\n\t\t\tfor (Entry entry : functionSet) {\n parseFunction(entry.getKey(), entry.getKey(), entry.getValue(), this.type == TYPE_ITEM ? path : parentPath, name, json, isMinus);\n\t\t\t}\n\t\t}\n\t}\n\n\n\t//public void parseFunction(String key, String value, String parentPath, String currentName, JSONRequest currentObject) throws Exception {\n // parseFunction(key, value, parentPath, currentName, currentObject, false);\n //}\n\tpublic void parseFunction(String rawKey, String key, String value, String parentPath\n , String currentName, M currentObject, boolean isMinus) throws Exception {\n\t\tObject result;\n boolean containRaw = rawKeyList != null && rawKeyList.contains(rawKey);\n\n boolean isProcedure = key.startsWith(\"@\");\n\t\tif (isProcedure) {\n\t\t\tFunctionBean fb = AbstractFunctionParser.parseFunction(value, currentObject, true, containRaw);\n\n\t\t\tSQLConfig config = newSQLConfig(true);\n String sch = fb.getSchema();\n if (StringUtil.isNotEmpty(sch, true)) {\n config.setSchema(sch);\n }\n\t\t\tconfig.setProcedure(fb.toFunctionCallString(true));\n\t\t\tresult = parseResponse(config, true);\n\n\t\t\tkey = key.substring(1);\n\t\t}\n\t\telse {\n\t\t\tresult = parser.onFunctionParse(key, value, parentPath, currentName, currentObject, containRaw);\n\t\t}\n\n\t\tString k = AbstractSQLConfig.gainRealKey(method, key, false, false);\n\n if (isProcedure == false && isMinus) {\n if (result != null) {\n sqlRequest.put(k, result);\n } else {\n sqlRequest.remove(k);\n }\n }\n\n if (result != null) {\n response.put(k, result);\n } else {\n response.remove(k);\n }\n\n parser.putQueryResult(AbstractParser.getAbsPath(path, k), result);\n\t}\n\n\t@Override\n\tpublic void onChildResponse() throws Exception {\n\t\t//把isTable时取出去child解析后重新添加回来\n\t\tSet> set = childMap == null ? null : childMap.entrySet();\n\t\tif (set != null) {\n\t\t\tint index = 0;\n\t\t\tfor (Entry entry : set) {\n\t\t\t\tObject child = entry == null ? null : onChildParse(index, entry.getKey(), entry.getValue(), null);\n\t\t\t\tif (child == null\n\t\t\t\t\t\t|| (child instanceof Map && ((M) child).isEmpty())\n\t\t\t\t\t\t|| (child instanceof List && ((L) child).isEmpty())\n\t\t\t\t\t\t) {\n\t\t\t\t\tcontinue;\n\t\t\t\t}\n\n\t\t\t\tresponse.put(entry.getKey(), child);\n\t\t\t\tindex ++;\n\t\t\t}\n\t\t}\n\t}\n\n\n\n\t@Override\n\tpublic Object onReferenceParse(@NotNull String path) {\n\t\treturn parser.getValueByPath(path);\n\t}\n\n\t@SuppressWarnings(\"unchecked\")\n\t@Override\n\tpublic M onSQLExecute() throws Exception {\n\t\tint position = getPosition();\n\n\t\tM result = getCache();\n\t\tif (result != null) {\n\t\t\tparser.putQueryResult(path, result);\n\t\t}\n\t\telse if (isArrayMainTable && position > 0) { // 数组主表使用专门的缓存数据\n\t\t\tresult = parser.getArrayMainCacheItem(parentPath.substring(0, parentPath.lastIndexOf(\"[]\") + 2), position);\n\t\t}\n\t\telse {\n\t\t\tresult = parser.executeSQL(sqlConfig, isSubquery);\n\n\t\t\tboolean isSimpleArray = false;\n // 提取并缓存数组主表的列表数据\n List rawList = result == null ? null : (List) result.remove(AbstractSQLExecutor.KEY_RAW_LIST);\n\n if (isArrayMainTable && position == 0 && rawList != null) {\n\n isSimpleArray = (functionMap == null || functionMap.isEmpty())\n && (customMap == null || customMap.isEmpty())\n && (childMap == null || childMap.isEmpty())\n && (table.equals(arrayTable));\n\n // APP JOIN 副表时副表返回了这个字段 rawList = (List) result.remove(AbstractSQLExecutor.KEY_RAW_LIST);\n String arrayPath = parentPath.substring(0, parentPath.lastIndexOf(\"[]\") + 2);\n\n if (isSimpleArray) {\n\t\t\t\t\tparser.putQueryResult(arrayPath, rawList); // 从数组外部引用该数组内值需要\n\t\t\t\t} else {\n long startTime = System.currentTimeMillis();\n\n for (int i = 1; i < rawList.size(); i++) { // 从 1 开始，0 已经处理过\n M obj = rawList.get(i);\n\n if (obj != null) {\n\t\t\t\t\t\t\t// obj.remove(AbstractSQLExecutor.KEY_VICE_ITEM);\n\t\t\t\t\t\t\tparser.putQueryResult(arrayPath + \"/\" + i + \"/\" + name, obj); // 解决获取关联数据时requestObject里不存在需要的关联数据\n }\n }\n\n long endTime = System.currentTimeMillis(); // 3ms - 8ms\n Log.e(TAG, \"\\n onSQLExecute <<<<<<<<<<<<<<<<<<<<<<<<<<<<\"\n + \"\\n for (int i = 1; i < list.size(); i++) startTime = \" + startTime\n + \"; endTime = \" + endTime + \"; duration = \" + (endTime - startTime)\n + \"\\n >>>>>>>>>>>>>>>>>>>>>>>>>>>>>\\n \");\n }\n\n parser.putArrayMainCache(arrayPath, rawList);\n }\n\n if (isSubquery == false && result != null) {\n parser.putQueryResult(path, result); // 解决获取关联数据时requestObject里不存在需要的关联数据\n\n if (isSimpleArray) { // FIXME 改为从缓存获取，而不是 result 查\n result.put(AbstractSQLExecutor.KEY_RAW_LIST, rawList);\n }\n }\n }\n\n\t\treturn result;\n\t}\n\n\n\t/**\n\t * response has the final value after parse (and query if isTable)\n\t */\n\t@Override\n\tpublic void onComplete() {\n\t}\n\n\n\t/**回收内存\n\t */\n\t@Override\n\tpublic void recycle() {\n\t\t//后面还可能用到，要还原\n\t\tif (tri) {//避免返回未传的字段\n\t\t\trequest.put(KEY_TRY, tri);\n\t\t}\n\t\tif (drop) {\n\t\t\trequest.put(KEY_DROP, drop);\n\t\t}\n\t\tif (stringKeyList != null) { // 避免被全局关键词覆盖 && ! stringKeyList.isEmpty()) {\n\t\t\trequest.put(KEY_STRING, StringUtil.get(stringKeyList.toArray()));\n\t\t}\n\t\tif (trimKeyList != null) { // 避免被全局关键词覆盖 && ! trimKeyList.isEmpty()) {\n\t\t\trequest.put(KEY_TRIM, StringUtil.get(trimKeyList.toArray()));\n\t\t}\n\n\t\tmethod = null;\n\t\tparentPath = null;\n\t\tarrayConfig = null;\n\n\t\t//\t\tif (response != null) {\n\t\t//\t\t\tresponse.clear();//有效果?\n\t\t//\t\t\tresponse = null;\n\t\t//\t\t}\n\n\t\trequest = null;\n\t\tresponse = null;\n\t\tsqlRequest = null;\n\t\tsqlResponse = null;\n\n\t\tfunctionMap = null;\n\t\tcustomMap = null;\n\t\tchildMap = null;\n\t}\n\n\n\n\tprotected RequestMethod method;\n\t@Override\n\tpublic AbstractObjectParser setMethod(RequestMethod method) {\n\t\tif (this.method != method) {\n\t\t\tthis.method = method;\n\t\t\tsqlConfig = null;\n\t\t\t//TODO ?\t\t\tsqlResponse = null;\n\t\t}\n\t\treturn this;\n\t}\n\t@Override\n\tpublic RequestMethod getMethod() {\n\t\treturn method;\n\t}\n\n\n\t@Override\n\tpublic boolean isTable() {\n\t\treturn isTable;\n\t}\n\t@Override\n\tpublic String getPath() {\n\t\treturn path;\n\t}\n\t@Override\n\tpublic String getTable() {\n\t\treturn table;\n\t}\n\t@Override\n\tpublic String getAlias() {\n\t\treturn alias;\n\t}\n\n\t@Override\n\tpublic SQLConfig getArrayConfig() {\n\t\treturn arrayConfig;\n\t}\n\n\t@Override\n\tpublic SQLConfig getSQLConfig() {\n\t\treturn sqlConfig;\n\t}\n\n\t@Override\n\tpublic M getResponse() {\n\t\treturn response;\n\t}\n\t@Override\n\tpublic M getSQLRequest() {\n\t\treturn sqlRequest;\n\t}\n\t@Override\n\tpublic M getSQLResponse() {\n\t\treturn sqlResponse;\n\t}\n\n\t@Override\n\tpublic Map getCustomMap() {\n\t\treturn customMap;\n\t}\n\t@Override\n\tpublic Map> getFunctionMap() {\n\t\treturn functionMap;\n\t}\n\t@Override\n\tpublic Map getChildMap() {\n\t\treturn childMap;\n\t}\n\n}\n" }, { "path": "APIJSONORM/src/main/java/apijson/orm/AbstractParser.java", "content": "/*Copyright (C) 2020 Tencent. All rights reserved.\n\nThis source code is licensed under the Apache License Version 2.0.*/\n\n\npackage apijson.orm;\n\nimport apijson.*;\nimport apijson.orm.exception.ConflictException;\n\nimport java.io.UnsupportedEncodingException;\nimport java.lang.management.ManagementFactory;\nimport java.net.InetAddress;\nimport java.net.URLDecoder;\nimport java.net.URLEncoder;\nimport java.sql.Connection;\nimport java.sql.SQLException;\nimport java.sql.Savepoint;\nimport java.util.*;\nimport java.util.Map.Entry;\n\nimport javax.management.MBeanServer;\nimport javax.management.ObjectName;\nimport javax.management.Query;\n\n\nimport apijson.orm.exception.CommonException;\nimport apijson.orm.exception.UnsupportedDataTypeException;\n\nimport static apijson.JSON.*;\nimport static apijson.JSONMap.*;\nimport static apijson.JSONRequest.*;\nimport static apijson.RequestMethod.CRUD;\nimport static apijson.RequestMethod.GET;\n\n/**Parser for parsing request to JSONRequest\n * @author Lemon\n */\npublic abstract class AbstractParser, L extends List>\n\t\timplements Parser {\n\tprotected static final String TAG = \"AbstractParser\";\n\n\t/**\n\t * JSON 对象、数组对应的数据源、版本、角色、method等\n\t */\n\tprotected Map> keyObjectAttributesMap = new HashMap<>();\n\t/**\n\t * 可以通过切换该变量来控制是否打印关键的接口请求内容。保守起见，该值默认为false。\n\t * 与 {@link Log#DEBUG} 任何一个为 true 都会打印关键的接口请求内容。\n\t */\n\tpublic static boolean IS_PRINT_REQUEST_STRING_LOG = false;\n\n\t/**\n\t * 打印大数据量日志的标识。线上环境比较敏感，可以通过切换该变量来控制异常栈抛出、错误日志打印。保守起见，该值默认为false。\n\t * 与 {@link Log#DEBUG} 任何一个为 true 都会打印关键的接口请求及响应信息。\n\t */\n\tpublic static boolean IS_PRINT_BIG_LOG = false;\n\n\t/**\n\t * 可以通过切换该变量来控制是否打印关键的接口请求结束时间。保守起见，该值默认为false。\n\t * 与 {@link Log#DEBUG} 任何一个为 true 都会打印关键的接口请求结束时间。\n\t */\n\tpublic static boolean IS_PRINT_REQUEST_ENDTIME_LOG = false;\n\n\t/**\n\t * 可以通过切换该变量来控制返回 trace:stack 字段，如果是 gson 则不设置为 false，避免序列化报错。\n\t * 与 {@link Log#DEBUG} 任何一个为 true 返回 trace:stack 字段。\n\t */\n\tpublic static boolean IS_RETURN_STACK_TRACE = true;\n\n\n\t/**\n\t * 分页页码是否从 1 开始，默认为从 0 开始\n\t */\n\tpublic static boolean IS_START_FROM_1 = false;\n\tpublic static int MAX_QUERY_PAGE = 100;\n\tpublic static int DEFAULT_QUERY_COUNT = 10;\n\tpublic static int MAX_QUERY_COUNT = 100;\n\tpublic static int MAX_UPDATE_COUNT = 10;\n\tpublic static int MAX_SQL_COUNT = 200;\n\tpublic static int MAX_OBJECT_COUNT = 5;\n\tpublic static int MAX_ARRAY_COUNT = 5;\n\tpublic static int MAX_QUERY_DEPTH = 5;\n\n\tpublic boolean isStartFrom1() {\n\t\treturn IS_START_FROM_1;\n\t}\n\t@Override\n\tpublic int getMinQueryPage() {\n\t\treturn isStartFrom1() ? 1 : 0;\n\t}\n\t@Override\n\tpublic int getMaxQueryPage() {\n\t\treturn MAX_QUERY_PAGE;\n\t}\n\t@Override\n\tpublic int getDefaultQueryCount() {\n\t\treturn DEFAULT_QUERY_COUNT;\n\t}\n\t@Override\n\tpublic int getMaxQueryCount() {\n\t\treturn MAX_QUERY_COUNT;\n\t}\n\t@Override\n\tpublic int getMaxUpdateCount() {\n\t\treturn MAX_UPDATE_COUNT;\n\t}\n\t@Override\n\tpublic int getMaxSQLCount() {\n\t\treturn MAX_SQL_COUNT;\n\t}\n\t@Override\n\tpublic int getMaxObjectCount() {\n\t\treturn MAX_OBJECT_COUNT;\n\t}\n\t@Override\n\tpublic int getMaxArrayCount() {\n\t\treturn MAX_ARRAY_COUNT;\n\t}\n\t@Override\n\tpublic int getMaxQueryDepth() {\n\t\treturn MAX_QUERY_DEPTH;\n\t}\n\n\t/**\n\t * method = null\n\t */\n\tpublic AbstractParser() {\n\t\tthis(null);\n\t}\n\t/**needVerify = true\n\t * @param method null ? requestMethod = GET\n\t */\n\tpublic AbstractParser(RequestMethod method) {\n\t\tsuper();\n\t\tsetMethod(method);\n\t\tsetNeedVerifyRole(AbstractVerifier.ENABLE_VERIFY_ROLE);\n\t\tsetNeedVerifyContent(AbstractVerifier.ENABLE_VERIFY_CONTENT);\n\t}\n\t/**\n\t * @param method null ? requestMethod = GET\n\t * @param needVerify 仅限于为服务端提供方法免验证特权，普通请求不要设置为 false ！ 如果对应Table有权限也建议用默认值 true，保持和客户端权限一致\n\t */\n\tpublic AbstractParser(RequestMethod method, boolean needVerify) {\n\t\tsuper();\n\t\tsetMethod(method);\n\t\tsetNeedVerify(needVerify);\n\t}\n\n\tprotected boolean isRoot = true;\n\tpublic boolean isRoot() {\n\t\treturn isRoot;\n\t}\n\tpublic AbstractParser setRoot(boolean isRoot) {\n\t\tthis.isRoot = isRoot;\n\t\treturn this;\n\t}\n\n\tpublic static final String KEY_REF = \"Reference\";\n\n\t/**警告信息\n\t * Map<\"Reference\", \"引用赋值获取路径 /Comment/userId 对应的值为 null！\">\n\t */\n\tprotected Map warnMap = new LinkedHashMap<>();\n\tpublic String getWarn(String type) {\n\t\treturn warnMap == null ? null : warnMap.get(type);\n\t}\n\tpublic AbstractParser putWarnIfNeed(String type, String warn) {\n\t\tif (Log.DEBUG) {\n\t\t\tString w = getWarn(type);\n\t\t\tif (StringUtil.isEmpty(w, true)) {\n\t\t\t\tputWarn(type, warn);\n\t\t\t}\n\t\t}\n\t\treturn this;\n\t}\n\tpublic AbstractParser putWarn(String type, String warn) {\n\t\tif (warnMap == null) {\n\t\t\twarnMap = new LinkedHashMap<>();\n\t\t}\n\t\twarnMap.put(type, warn);\n\t\treturn this;\n\t}\n\t/**获取警告信息\n\t * @return\n\t */\n\tpublic String getWarnString() {\n\t\tSet> set = warnMap == null ? null : warnMap.entrySet();\n\t\tif (set == null || set.isEmpty()) {\n\t\t\treturn null;\n\t\t}\n\n\t\tStringBuilder sb = new StringBuilder();\n\t\tfor (Entry e : set) {\n\t\t\tString k = e == null ? null : e.getKey();\n\t\t\tString v = k == null ? null : e.getValue();\n\t\t\tif (StringUtil.isEmpty(v, true)) {\n\t\t\t\tcontinue;\n\t\t\t}\n\n\t\t\tif (StringUtil.isNotEmpty(k, true)) {\n\t\t\t\tsb.append(\"[\" + k + \"]: \");\n\t\t\t}\n\t\t\tsb.append(v + \"; \");\n\t\t}\n\n\t\treturn sb.toString();\n\t}\n\n\n\t@NotNull\n\tprotected Visitor visitor;\n\t@NotNull\n\t@Override\n\tpublic Visitor getVisitor() {\n\t\tif (visitor == null) {\n\t\t\tvisitor = new Visitor() {\n\n\t\t\t\t@Override\n\t\t\t\tpublic T getId() {\n\t\t\t\t\treturn null;\n\t\t\t\t}\n\n\t\t\t\t@Override\n\t\t\t\tpublic List getContactIdList() {\n\t\t\t\t\treturn null;\n\t\t\t\t}\n\t\t\t};\n\t\t}\n\t\treturn visitor;\n\t}\n\t@Override\n\tpublic AbstractParser setVisitor(@NotNull Visitor visitor) {\n\t\tthis.visitor = visitor;\n\t\treturn this;\n\t}\n\n\tprotected RequestMethod requestMethod;\n\t@NotNull\n\t@Override\n\tpublic RequestMethod getMethod() {\n\t\treturn requestMethod;\n\t}\n\t@NotNull\n\t@Override\n\tpublic AbstractParser setMethod(RequestMethod method) {\n\t\tthis.requestMethod = method == null ? GET : method;\n\t\tthis.transactionIsolation = RequestMethod.isQueryMethod(method) ? Connection.TRANSACTION_NONE : Connection.TRANSACTION_REPEATABLE_READ;\n\t\treturn this;\n\t}\n\n\tprotected int version;\n\t@Override\n\tpublic int getVersion() {\n\t\treturn version;\n\t}\n\t@Override\n\tpublic AbstractParser setVersion(int version) {\n\t\tthis.version = version;\n\t\treturn this;\n\t}\n\n\tprotected String tag;\n\t@Override\n\tpublic String getTag() {\n\t\treturn tag;\n\t}\n\t@Override\n\tpublic AbstractParser setTag(String tag) {\n\t\tthis.tag = tag;\n\t\treturn this;\n\t}\n\n\tprotected String requestURL;\n\tpublic String getRequestURL() {\n\t\treturn requestURL;\n\t}\n\tpublic AbstractParser setRequestURL(String requestURL) {\n\t\tthis.requestURL = requestURL;\n\t\treturn this;\n\t}\n\n\tprotected M requestObject;\n\t@Override\n\tpublic M getRequest() {\n\t\treturn requestObject;\n\t}\n\t@Override\n\tpublic AbstractParser setRequest(M request) {\n\t\tthis.requestObject = request;\n\t\treturn this;\n\t}\n\n\tprotected Boolean globalFormat;\n\tpublic AbstractParser setGlobalFormat(Boolean globalFormat) {\n\t\tthis.globalFormat = globalFormat;\n\t\treturn this;\n\t}\n\t@Override\n\tpublic Boolean getGlobalFormat() {\n\t\treturn globalFormat;\n\t}\n\tprotected String globalRole;\n\tpublic AbstractParser setGlobalRole(String globalRole) {\n\t\tthis.globalRole = globalRole;\n\t\treturn this;\n\t}\n\t@Override\n\tpublic String getGlobalRole() {\n\t\treturn globalRole;\n\t}\n\tprotected String globalDatabase;\n\tpublic AbstractParser setGlobalDatabase(String globalDatabase) {\n\t\tthis.globalDatabase = globalDatabase;\n\t\treturn this;\n\t}\n\t@Override\n\tpublic String getGlobalDatabase() {\n\t\treturn globalDatabase;\n\t}\n\n\tprotected String globalDatasource;\n\t@Override\n\tpublic String getGlobalDatasource() {\n\t\treturn globalDatasource;\n\t}\n\tpublic AbstractParser setGlobalDatasource(String globalDatasource) {\n\t\tthis.globalDatasource = globalDatasource;\n\t\treturn this;\n\t}\n\n\tprotected String globalNamespace;\n\tpublic AbstractParser setGlobalNamespace(String globalNamespace) {\n\t\tthis.globalNamespace = globalNamespace;\n\t\treturn this;\n\t}\n\t@Override\n\tpublic String getGlobalNamespace() {\n\t\treturn globalNamespace;\n\t}\n\n\tprotected String globalCatalog;\n\tpublic AbstractParser setGlobalCatalog(String globalCatalog) {\n\t\tthis.globalCatalog = globalCatalog;\n\t\treturn this;\n\t}\n\t@Override\n\tpublic String getGlobalCatalog() {\n\t\treturn globalCatalog;\n\t}\n\n\tprotected String globalSchema;\n\tpublic AbstractParser setGlobalSchema(String globalSchema) {\n\t\tthis.globalSchema = globalSchema;\n\t\treturn this;\n\t}\n\t@Override\n\tpublic String getGlobalSchema() {\n\t\treturn globalSchema;\n\t}\n\n\tprotected Boolean globalExplain;\n\tpublic AbstractParser setGlobalExplain(Boolean globalExplain) {\n\t\tthis.globalExplain = globalExplain;\n\t\treturn this;\n\t}\n\t@Override\n\tpublic Boolean getGlobalExplain() {\n\t\treturn globalExplain;\n\t}\n\tprotected String globalCache;\n\tpublic AbstractParser setGlobalCache(String globalCache) {\n\t\tthis.globalCache = globalCache;\n\t\treturn this;\n\t}\n\t@Override\n\tpublic String getGlobalCache() {\n\t\treturn globalCache;\n\t}\n\n\t@Override\n\tpublic AbstractParser setNeedVerify(boolean needVerify) {\n\t\tsetNeedVerifyLogin(needVerify);\n\t\tsetNeedVerifyRole(needVerify);\n\t\tsetNeedVerifyContent(needVerify);\n\t\treturn this;\n\t}\n\n\tprotected boolean needVerifyLogin;\n\t@Override\n\tpublic boolean isNeedVerifyLogin() {\n\t\treturn needVerifyLogin;\n\t}\n\t@Override\n\tpublic AbstractParser setNeedVerifyLogin(boolean needVerifyLogin) {\n\t\tthis.needVerifyLogin = needVerifyLogin;\n\t\treturn this;\n\t}\n\tprotected boolean needVerifyRole;\n\t@Override\n\tpublic boolean isNeedVerifyRole() {\n\t\treturn needVerifyRole;\n\t}\n\t@Override\n\tpublic AbstractParser setNeedVerifyRole(boolean needVerifyRole) {\n\t\tthis.needVerifyRole = needVerifyRole;\n\t\treturn this;\n\t}\n\tprotected boolean needVerifyContent;\n\t@Override\n\tpublic boolean isNeedVerifyContent() {\n\t\treturn needVerifyContent;\n\t}\n\t@Override\n\tpublic AbstractParser setNeedVerifyContent(boolean needVerifyContent) {\n\t\tthis.needVerifyContent = needVerifyContent;\n\t\treturn this;\n\t}\n\n\tprotected SQLExecutor sqlExecutor;\n\tprotected Verifier verifier;\n\tprotected Map queryResultMap;//path-result\n\n\t@Override\n\tpublic SQLExecutor getSQLExecutor() {\n\t\tif (sqlExecutor == null) {\n\t\t\tsqlExecutor = createSQLExecutor();\n\t\t}\n\t\tsqlExecutor.setParser(this);\n\t\treturn sqlExecutor;\n\t}\n\t@Override\n\tpublic Verifier getVerifier() {\n\t\tif (verifier == null) {\n\t\t\tverifier = createVerifier().setVisitor(getVisitor());\n\t\t}\n\t\tverifier.setParser(this);\n\t\treturn verifier;\n\t}\n\n\t/**解析请求JSONObject\n\t * @param request => URLDecoder.decode(request, UTF_8);\n\t * @return\n\t * @throws Exception\n\t */\n\tpublic static > M parseRequest(String request) throws Exception {\n\t\ttry {\n\t\t\tM req = JSON.parseObject(request);\n\t\t\tObjects.requireNonNull(req);\n\t\t\treturn req;\n\t\t} catch (Throwable e) {\n\t\t\tthrow new UnsupportedEncodingException(\"JSON格式不合法！\" + e.getMessage() + \"! \" + request);\n\t\t}\n\t}\n\n\t/**解析请求json并获取对应结果\n\t * @param request\n\t * @return\n\t */\n\t@Override\n\tpublic String parse(String request) {\n\t\treturn JSON.toJSONString(parseResponse(request));\n\t}\n\t/**解析请求json并获取对应结果\n\t * @param request\n\t * @return\n\t */\n\t@NotNull\n\t@Override\n\tpublic String parse(M request) {\n\t\treturn JSON.toJSONString(parseResponse(request));\n\t}\n\n\t/**解析请求json并获取对应结果\n\t * @param request 先parseRequest中URLDecoder.decode(request, UTF_8);再parseResponse(getCorrectRequest(...))\n\t * @return parseResponse(requestObject);\n\t */\n\t@NotNull\n\t@Override\n\tpublic M parseResponse(String request) {\n\t\tLog.d(TAG, \"\\n\\n\\n\\n<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<\\n\"\n\t\t\t\t+ requestMethod + \"/parseResponse request = \\n\" + request + \"\\n\\n\");\n\n\t\ttry {\n\t\t\trequestObject = JSON.parseObject(request);\n\t\t\tif (requestObject == null) {\n\t\t\t\tthrow new UnsupportedEncodingException(\"JSON格式不合法！\");\n\t\t\t}\n\t\t} catch (Exception e) {\n\t\t\treturn newErrorResult(e, isRoot);\n\t\t}\n\n\t\treturn parseResponse(requestObject);\n\t}\n\n\tprivate int queryDepth;\n\tprivate long executedSQLDuration;\n\n\t/**解析请求json并获取对应结果\n\t * @param request\n\t * @return requestObject\n\t */\n\t@NotNull\n\t@Override\n\tpublic M parseResponse(M request) {\n\t\tlong startTime = System.currentTimeMillis();\n\t\tLog.d(TAG, \"parseResponse startTime = \" + startTime\n\t\t\t\t+ \"<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<\\n\\n\\n \");\n\n\t\trequestObject = request;\n\t\ttry {\n\t\t\tsetGlobalFormat(getBoolean(requestObject, KEY_FORMAT));\n\t\t\trequestObject.remove(KEY_FORMAT);\n\t\t} catch (Exception e) {\n\t\t\treturn extendErrorResult(requestObject, e, requestMethod, getRequestURL(), isRoot);\n\t\t}\n\n\t\ttry {\n\t\t\tsetVersion(getIntValue(requestObject, KEY_VERSION));\n\t\t\trequestObject.remove(KEY_VERSION);\n\n\t\t\tif (getMethod() != RequestMethod.CRUD) {\n\t\t\t\tsetTag(getString(requestObject, KEY_TAG));\n\t\t\t\trequestObject.remove(KEY_TAG);\n\t\t\t}\n\t\t} catch (Exception e) {\n\t\t\treturn extendErrorResult(requestObject, e, requestMethod, getRequestURL(), isRoot);\n\t\t}\n\n\t\tverifier = createVerifier().setVisitor(getVisitor());\n\n\t\tif (RequestMethod.isPublicMethod(requestMethod) == false) {\n\t\t\ttry {\n\t\t\t\tif (isNeedVerifyLogin()) {\n\t\t\t\t\tonVerifyLogin();\n\t\t\t\t}\n\t\t\t\tif (isNeedVerifyContent()) {\n\t\t\t\t\tonVerifyContent();\n\t\t\t\t}\n\t\t\t} catch (Exception e) {\n\t\t\t\treturn extendErrorResult(requestObject, e, requestMethod, getRequestURL(), isRoot);\n\t\t\t}\n\t\t}\n\n\t\t//必须在parseCorrectRequest后面，因为parseCorrectRequest可能会添加 @role\n\t\tif (isNeedVerifyRole() && globalRole == null) {\n\t\t\ttry {\n\t\t\t\tsetGlobalRole(getString(requestObject, KEY_ROLE));\n\t\t\t\trequestObject.remove(KEY_ROLE);\n\t\t\t} catch (Exception e) {\n\t\t\t\treturn extendErrorResult(requestObject, e, requestMethod, getRequestURL(), isRoot);\n\t\t\t}\n\t\t}\n\n\t\ttry {\n\t\t\tsetGlobalDatabase(getString(requestObject, KEY_DATABASE));\n\t\t\tsetGlobalDatasource(getString(requestObject, KEY_DATASOURCE));\n\t\t\tsetGlobalNamespace(getString(requestObject, KEY_NAMESPACE));\n\t\t\tsetGlobalCatalog(getString(requestObject, KEY_CATALOG));\n\t\t\tsetGlobalSchema(getString(requestObject, KEY_SCHEMA));\n\n\t\t\tsetGlobalExplain(getBoolean(requestObject, KEY_EXPLAIN));\n\t\t\tsetGlobalCache(getString(requestObject, KEY_CACHE));\n\n\t\t\trequestObject.remove(KEY_DATABASE);\n\t\t\trequestObject.remove(KEY_DATASOURCE);\n\t\t\trequestObject.remove(KEY_NAMESPACE);\n\t\t\trequestObject.remove(KEY_CATALOG);\n\t\t\trequestObject.remove(KEY_SCHEMA);\n\n\t\t\trequestObject.remove(KEY_EXPLAIN);\n\t\t\trequestObject.remove(KEY_CACHE);\n\t\t} catch (Exception e) {\n\t\t\treturn extendErrorResult(requestObject, e, requestMethod, getRequestURL(), isRoot);\n\t\t}\n\n\t\tfinal String requestString = JSON.toJSONString(request);//request传进去解析后已经变了\n\n\t\tqueryResultMap = new HashMap();\n\n\t\tException error = null;\n\t\tsqlExecutor = getSQLExecutor();\n\t\tonBegin();\n\t\ttry {\n\t\t\tqueryDepth = 0;\n\t\t\texecutedSQLDuration = 0;\n\n\t\t\trequestObject = onObjectParse(request, null, null, null, false, null);\n\n\t\t\tonCommit();\n\t\t}\n\t\tcatch (Exception e) {\n\t\t\tLog.e(TAG, \"onObjectParse failed\", e);\n\t\t\terror = e;\n\n\t\t\tonRollback();\n\t\t}\n\n\t\tString warn = Log.DEBUG == false || error != null ? null : getWarnString();\n\n\t\trequestObject = error == null ? extendSuccessResult(requestObject, warn, isRoot) : extendErrorResult(requestObject, error, requestMethod, getRequestURL(), isRoot);\n\n\t\t// FIXME 暂时先直接移除，后续排查是在哪里 put 进来\n\t\trequestObject.remove(KEY_DATABASE);\n\t\trequestObject.remove(KEY_DATASOURCE);\n\t\trequestObject.remove(KEY_NAMESPACE);\n\t\trequestObject.remove(KEY_CATALOG);\n\t\trequestObject.remove(KEY_SCHEMA);\n\n\t\tM res = (globalFormat != null && globalFormat) && JSONResponse.isSuccess(requestObject) ? JSONResponse.format(requestObject) : requestObject;\n\n\t\tlong endTime = System.currentTimeMillis();\n\t\tlong duration = endTime - startTime;\n\n\t\tres.putIfAbsent(\"time\", endTime);\n\t\tif (Log.DEBUG) {\n\t\t\tsqlExecutor = getSQLExecutor();\n\t\t\tres.put(\"sql:generate|cache|execute|maxExecute\", sqlExecutor.getGeneratedSQLCount() + \"|\" + sqlExecutor.getCachedSQLCount() + \"|\" + sqlExecutor.getExecutedSQLCount() + \"|\" + getMaxSQLCount());\n\t\t\tres.put(\"depth:count|max\", queryDepth + \"|\" + getMaxQueryDepth());\n\n\t\t\texecutedSQLDuration += sqlExecutor.getExecutedSQLDuration() + sqlExecutor.getSqlResultDuration();\n\t\t\tlong parseDuration = duration - executedSQLDuration;\n\t\t\tres.put(\"time:start|duration|end|parse|sql\", startTime + \"|\" + duration + \"|\" + endTime + \"|\" + parseDuration + \"|\" + executedSQLDuration);\n\n\t\t\tif (error != null) {\n // String msg = error.getMessage();\n // if (msg != null && msg.contains(Log.KEY_SYSTEM_INFO_DIVIDER)) {\n // }\n Throwable t = error instanceof CommonException && error.getCause() != null ? error.getCause() : error;\n\t\t\t\tres.put(\"trace:throw\", t.getClass().getName());\n\n\t\t\t\tif (IS_RETURN_STACK_TRACE) {\n\t\t\t\t\tL list = JSON.createJSONArray();\n\n\t\t\t\t\tStackTraceElement[] traces = t.getStackTrace();\n\t\t\t\t\tif (traces != null) { // && traces.length > 0) {\n\t\t\t\t\t\tfor (StackTraceElement trace : traces) {\n\t\t\t\t\t\t\tlist.add(trace == null ? null : trace.toString());\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\n\t\t\t\t\tres.put(\"trace:stack\", list);\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\n\t\tonClose();\n\n\t\t// CS304 Issue link: https://github.com/Tencent/APIJSON/issues/232\n\t\tif (IS_PRINT_REQUEST_STRING_LOG || Log.DEBUG || error != null) {\n\t\t\tLog.sl(\"\\n\\n\\n\", '<', \"\");\n\t\t\tLog.fd(TAG, requestMethod + \"/parseResponse request = \\n\" + requestString + \"\\n\\n\");\n\t\t}\n\t\tif (IS_PRINT_BIG_LOG || Log.DEBUG || error != null) { // 日志仅存服务器，所以不太敏感，而且这些日志虽然量大但非常重要，对排查 bug 很关键\n\t\t\tLog.fd(TAG, requestMethod + \"/parseResponse return response = \\n\" + JSON.toJSONString(requestObject) + \"\\n\\n\");\n\t\t}\n\t\tif (IS_PRINT_REQUEST_ENDTIME_LOG || Log.DEBUG || error != null) {\n\t\t\tLog.fd(TAG, requestMethod + \"/parseResponse endTime = \" + endTime + \"; duration = \" + duration);\n\t\t\tLog.sl(\"\", '>', \"\\n\\n\\n\");\n\t\t}\n\n\t\treturn res;\n\t}\n\n\n\t@Override\n\tpublic void onVerifyLogin() throws Exception {\n\t\tgetVerifier().verifyLogin();\n\t}\n\t@Override\n\tpublic void onVerifyContent() throws Exception {\n\t\trequestObject = parseCorrectRequest();\n\t}\n\t/**校验角色及对应操作的权限\n\t * @param config\n\t * @return\n\t * @throws Exception\n\t */\n\t@Override\n\tpublic void onVerifyRole(@NotNull SQLConfig config) throws Exception {\n\t\tif (Log.DEBUG) {\n\t\t\tLog.i(TAG, \"onVerifyRole config = \" + JSON.toJSONString(config));\n\t\t}\n\n\t\tif (isNeedVerifyRole()) {\n\t\t\tif (config.getRole() == null) {\n\t\t\t\tif (globalRole != null) {\n\t\t\t\t\tconfig.setRole(globalRole);\n\t\t\t\t} else {\n\t\t\t\t\tconfig.setRole(getVisitor().getId() == null ? AbstractVerifier.UNKNOWN : AbstractVerifier.LOGIN);\n\t\t\t\t}\n\t\t\t}\n\t\t\tgetVerifier().verifyAccess(config);\n\t\t}\n\n\t}\n\n\n\t@Override\n\tpublic M parseCorrectRequest(RequestMethod method, String tag, int version, String name, @NotNull M request\n\t\t\t, int maxUpdateCount, SQLCreator creator) throws Exception {\n\n\t\tif (RequestMethod.isPublicMethod(method)) {\n\t\t\treturn request;//需要指定JSON结构的get请求可以改为post请求。一般只有对安全性要求高的才会指定，而这种情况用明文的GET方式几乎肯定不安全\n\t\t}\n\n\t\treturn batchVerify(method, tag, version, name, request, maxUpdateCount, creator);\n\t}\n\n\t/**自动根据 tag 是否为 TableKey 及是否被包含在 object 内来决定是否包装一层，改为 { tag: object, \"tag\": tag }\n\t * @param object\n\t * @param tag\n\t * @return\n\t */\n\tpublic M wrapRequest(RequestMethod method, String tag, M object, boolean isStructure) {\n\t\tboolean putTag = ! isStructure;\n\n\t\tif (object == null || object.containsKey(tag)) { //tag 是 Table 名或 Table[]\n\t\t\tif (putTag) {\n\t\t\t\tif (object == null) {\n\t\t\t\t\tobject = JSON.createJSONObject();\n\t\t\t\t}\n\t\t\t\tobject.put(KEY_TAG, tag);\n\t\t\t}\n\t\t\treturn object;\n\t\t}\n\n\t\tboolean isDiffArrayKey = tag.endsWith(\":[]\");\n\t\tboolean isArrayKey = isDiffArrayKey || isArrayKey(tag);\n\t\tString key = isArrayKey ? tag.substring(0, tag.length() - (isDiffArrayKey ? 3 : 2)) : tag;\n\n\t\tM target = object;\n\t\tif (isTableKey(key)) {\n\t\t\tif (isDiffArrayKey) { //自动为 tag = Comment:[] 的 { ... } 新增键值对为 { \"Comment[]\":[], \"TYPE\": { \"Comment[]\": \"OBJECT[]\" } ... }\n\t\t\t\tif (isStructure && (method == RequestMethod.POST || method == RequestMethod.PUT)) {\n\t\t\t\t\tString arrKey = key + \"[]\";\n\n\t\t\t\t\tif (target.containsKey(arrKey) == false) {\n\t\t\t\t\t\ttarget.put(arrKey, JSON.createJSONArray());\n\t\t\t\t\t}\n\n\t\t\t\t\ttry {\n\t\t\t\t\t\tMap type = JSON.get(target, Operation.TYPE.name());\n\t\t\t\t\t\tif (type == null || (type.containsKey(arrKey) == false)) {\n\t\t\t\t\t\t\tif (type == null) {\n\t\t\t\t\t\t\t\ttype = new LinkedHashMap();\n\t\t\t\t\t\t\t}\n\n\t\t\t\t\t\t\ttype.put(arrKey, \"OBJECT[]\");\n\t\t\t\t\t\t\ttarget.put(Operation.TYPE.name(), type);\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\t\t\t\t\tcatch (Throwable e) {\n\t\t\t\t\t\tLog.w(TAG, \"wrapRequest try { Map type = target.getJSONObject(Operation.TYPE.name()); } catch (Exception e) = \" + e.getMessage());\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t}\n\t\t\telse { //自动为 tag = Comment 的 { ... } 包一层为 { \"Comment\": { ... } }\n\t\t\t\tif (isArrayKey == false || RequestMethod.isGetMethod(method, true)) {\n\t\t\t\t\ttarget = JSON.createJSONObject();\n\t\t\t\t\ttarget.put(tag, object);\n\t\t\t\t}\n\t\t\t\telse if (target.containsKey(key) == false) {\n\t\t\t\t\ttarget = JSON.createJSONObject();\n\t\t\t\t\ttarget.put(key, object);\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\n\t\tif (putTag) {\n\t\t\ttarget.put(KEY_TAG, tag);\n\t\t}\n\n\t\treturn target;\n\t}\n\n\n\t/**新建带状态内容的JSONObject\n\t * @param code\n\t * @param msg\n\t * @return\n\t */\n\tpublic M newResult(int code, String msg) {\n\t\treturn newResult(code, msg, null);\n\t}\n\n\t/**\n\t * 添加JSONObject的状态内容，一般用于错误提示结果\n\t *\n\t * @param code\n\t * @param msg\n\t * @param warn\n\t * @return\n\t */\n\tpublic M newResult(int code, String msg, String warn) {\n\t\treturn newResult(code, msg, warn, false);\n\t}\n\n\t/**\n\t * 新建带状态内容的JSONObject\n\t *\n\t * @param code\n\t * @param msg\n\t * @param warn\n\t * @param isRoot\n\t * @return\n\t */\n\tpublic M newResult(int code, String msg, String warn, boolean isRoot) {\n\t\treturn extendResult(null, code, msg, warn, isRoot);\n\t}\n\n\t/**\n\t * 添加JSONObject的状态内容，一般用于错误提示结果\n\t *\n\t * @param object\n\t * @param code\n\t * @param msg\n\t * @return\n\t */\n\tpublic M extendResult(M object, int code, String msg, String warn, boolean isRoot) {\n\t\tint index = Log.DEBUG == false || isRoot == false || msg == null ? -1 : msg.lastIndexOf(Log.KEY_SYSTEM_INFO_DIVIDER);\n\t\tString debug = Log.DEBUG == false || isRoot == false ? null : (index >= 0 ? msg.substring(index + Log.KEY_SYSTEM_INFO_DIVIDER.length()).trim()\n\t\t\t\t: \" \\n提 bug 请发请求和响应的【完整截屏】，没图的自行解决！\"\n\t\t\t\t+ \" \\n开发者有限的时间和精力主要放在【维护项目源码和文档】上！\"\n\t\t\t\t+ \" \\n【描述不详细】 或 【文档/常见问题 已有答案】 的问题可能会被忽略！！\"\n\t\t\t\t+ \" \\n【态度 不文明/不友善】的可能会被踢出群，问题也可能不予解答！！！\"\n\t\t\t\t+ \" \\n\\n **环境信息** \"\n\t\t\t\t+ \" \\n系统: \" + Log.OS_NAME + \" \" + Log.OS_VERSION\n\t\t\t\t+ \" \\n数据库: DEFAULT_DATABASE = \" + AbstractSQLConfig.DEFAULT_DATABASE\n\t\t\t\t+ \" \\nJDK: \" + Log.JAVA_VERSION + \" \" + Log.OS_ARCH\n\t\t\t\t+ \" \\nAPIJSON: \" + Log.VERSION\n\t\t\t\t+ \" \\n \\n【常见问题】：https://github.com/Tencent/APIJSON/issues/36\"\n\t\t\t\t+ \" \\n【通用文档】：https://github.com/Tencent/APIJSON/blob/master/Document.md\"\n\t\t\t\t+ \" \\n【视频教程】：https://search.bilibili.com/all?keyword=APIJSON\");\n\n\t\tmsg = index >= 0 ? msg.substring(0, index) : msg;\n\n\t\tif (object == null) {\n\t\t\tobject = JSON.createJSONObject();\n\t\t}\n\n\t\tif (object.get(JSONResponse.KEY_OK) == null) {\n\t\t\tobject.put(JSONResponse.KEY_OK, JSONResponse.isSuccess(code));\n\t\t}\n\t\tif (object.get(JSONResponse.KEY_CODE) == null) {\n\t\t\tobject.put(JSONResponse.KEY_CODE, code);\n\t\t}\n\n\t\tString m = StringUtil.get(getString(object, JSONResponse.KEY_MSG));\n\t\tif (m.isEmpty() == false) {\n\t\t\tmsg = m + \" ;\\n \" + StringUtil.get(msg);\n\t\t}\n\n\t\tobject.put(JSONResponse.KEY_MSG, msg);\n\t\tif (debug != null) {\n\t\t\tif (StringUtil.isNotEmpty(warn, true)) {\n\t\t\t\tdebug += \"\\n 【警告】：\" + warn;\n\t\t\t}\n\t\t\tobject.put(\"debug:info|help\", debug);\n\t\t}\n\n\t\treturn object;\n\t}\n\n\n\t/**\n\t * 添加请求成功的状态内容\n\t *\n\t * @param object\n\t * @return\n\t */\n\tpublic M extendSuccessResult(M object) {\n\t\treturn extendSuccessResult(object, false);\n\t}\n\n\tpublic M extendSuccessResult(M object, boolean isRoot) {\n\t\treturn extendSuccessResult(object, null, isRoot);\n\t}\n\n\t/**添加请求成功的状态内容\n\t * @param object\n\t * @param isRoot\n\t * @return\n\t */\n\tpublic M extendSuccessResult(M object, String warn, boolean isRoot) {\n\t\treturn extendResult(object, JSONResponse.CODE_SUCCESS, JSONResponse.MSG_SUCCEED, warn, isRoot);\n\t}\n\n\t/**获取请求成功的状态内容\n\t * @return\n\t */\n\tpublic M newSuccessResult() {\n\t\treturn newSuccessResult(null);\n\t}\n\n\t/**获取请求成功的状态内容\n\t * @param warn\n\t * @return\n\t */\n\tpublic M newSuccessResult(String warn) {\n\t\treturn newSuccessResult(warn, false);\n\t}\n\n\t/**获取请求成功的状态内容\n\t * @param warn\n\t * @param isRoot\n\t * @return\n\t */\n\tpublic M newSuccessResult(String warn, boolean isRoot) {\n\t\treturn newResult(JSONResponse.CODE_SUCCESS, JSONResponse.MSG_SUCCEED, warn, isRoot);\n\t}\n\n\t/**添加请求成功的状态内容\n\t * @param object\n\t * @param e\n\t * @return\n\t */\n\tpublic M extendErrorResult(M object, Throwable e) {\n\t\treturn extendErrorResult(object, e, false);\n\t}\n\t/**添加请求成功的状态内容\n\t * @param object\n\t * @param e\n\t * @param isRoot\n\t * @return\n\t */\n\tpublic M extendErrorResult(M object, Throwable e, boolean isRoot) {\n\t\treturn extendErrorResult(object, e, null, null, isRoot);\n\t}\n\t/**添加请求成功的状态内容\n\t * @param object\n\t * @return\n\t */\n\tpublic M extendErrorResult(M object, Throwable e, RequestMethod requestMethod, String url, boolean isRoot) {\n String msg = CommonException.getMsg(e);\n\n if (Log.DEBUG && isRoot) {\n try {\n boolean isCommon = e instanceof CommonException;\n String env = isCommon ? ((CommonException) e).getEnvironment() : null;\n if (StringUtil.isEmpty(env)) {\n //int index = msg.lastIndexOf(Log.KEY_SYSTEM_INFO_DIVIDER);\n //env = index >= 0 ? msg.substring(index + Log.KEY_SYSTEM_INFO_DIVIDER.length()).trim()\n env = \" \\n **环境信息** \"\n + \" \\n 系统: \" + Log.OS_NAME + \" \" + Log.OS_VERSION\n + \" \\n 数据库: \"\n + \" \\n JDK: \" + Log.JAVA_VERSION + \" \" + Log.OS_ARCH\n + \" \\n APIJSON: \" + Log.VERSION;\n\n //msg = index < 0 ? msg : msg.substring(0, index).trim();\n }\n\n String encodedMsg = URLEncoder.encode(msg, \"UTF-8\");\n\n if (StringUtil.isEmpty(url, true)) {\n String host = \"localhost\";\n try {\n host = InetAddress.getLocalHost().getHostAddress();\n } catch (Throwable e2) {}\n\n String port = \"8080\";\n try {\n MBeanServer beanServer = ManagementFactory.getPlatformMBeanServer();\n\n Set objectNames = beanServer.queryNames(\n new ObjectName(\"*:type=Connector,*\"),\n Query.match(Query.attr(\"protocol\"), Query.value(\"HTTP/1.1\"))\n );\n String p = objectNames.iterator().next().getKeyProperty(\"port\");\n port = StringUtil.isEmpty(p, true) ? port : p;\n } catch (Throwable e2) {}\n\n url = \"http://\" + host + \":\" + port + \"/\" + (requestMethod == null ? RequestMethod.GET : requestMethod).name().toLowerCase();\n }\n\n String req = JSON.toJSONString(object);\n try {\n req = URLEncoder.encode(req, \"UTF-8\");\n } catch (Throwable e2) {}\n\n Throwable t = isCommon ? e.getCause() : e;\n boolean isSQLException = t instanceof SQLException; // SQL 报错一般都是通用问题，优先搜索引擎\n String apiatuoAndGitHubLink = \"\\n\\n【APIAuto】： \\n http://apijson.cn/api?type=JSON&url=\" + URLEncoder.encode(url, \"UTF-8\") + \"&json=\" + req\n + \" \\n\\n【GitHub】： \\n https://www.google.com/search?q=site%3Agithub.com%2FTencent%2FAPIJSON+++\" + encodedMsg;\n\n msg += Log.KEY_SYSTEM_INFO_DIVIDER + \" 浏览器打开以下链接查看解答\"\n + (isSQLException ? \"\" : apiatuoAndGitHubLink)\n //\tGitHub Issue 搜索貌似是精准包含，不易找到答案 \t+ \" \\n\\nGitHub： \\n https://github.com/Tencent/APIJSON/issues?q=is%3Aissue+\" + encodedMsg\n + \" \\n\\n【Google】：\\n https://www.google.com/search?q=\" + encodedMsg\n + \" \\n\\n【百度】：\\n https://www.baidu.com/s?ie=UTF-8&wd=\" + encodedMsg\n + (isSQLException ? apiatuoAndGitHubLink : \"\")\n + \" \\n\\n都没找到答案？打开这个链接 \\n https://github.com/Tencent/APIJSON/issues/new?assignees=&labels=&template=--bug.md \"\n + \" \\n然后提交问题，推荐用以下模板修改，注意要换行保持清晰可读。\"\n + \" \\n【标题】：\" + msg\n + \" \\n【内容】：\" + env + \"\\n\\n**问题描述**\\n\" + msg\n + \" \\n\\n\"\n + \" \\n\\nPOST \" + url\n + \" \\n发送请求 Request JSON：\\n ```js\"\n + \" \\n 请填写，例如 { \\\"Users\\\":{} }\"\n + \" \\n```\"\n + \" \\n\\n返回结果 Response JSON：\\n ```js\"\n + \" \\n 请填写，例如 { \\\"Users\\\": {}, \\\"code\\\": 401, \\\"msg\\\": \\\"Users 不允许 UNKNOWN 用户的 GET 请求！\\\" }\"\n + \" \\n```\";\n } catch (Throwable e2) {}\n }\n\n int code = CommonException.getCode(e);\n return extendResult(object, code, msg, null, isRoot);\n }\n\n\t/**新建错误状态内容\n\t * @param e\n\t * @return\n\t */\n\tpublic M newErrorResult(Exception e) {\n\t\treturn newErrorResult(e, false);\n\t}\n\t/**新建错误状态内容\n\t * @param e\n\t * @param isRoot\n\t * @return\n\t */\n\tpublic M newErrorResult(Exception e, boolean isRoot) {\n\t\tif (e != null) {\n\t\t \tLog.e(TAG, \"newErrorResult\", e);\n\n\t\t \tString msg = CommonException.getMsg(e);\n\t\t\tint code = CommonException.getCode(e);\n\n\t\t\treturn newResult(code, msg, null, isRoot);\n\t\t}\n\n\t\treturn newResult(JSONResponse.CODE_SERVER_ERROR, JSONResponse.MSG_SERVER_ERROR, null, isRoot);\n\t}\n\n\n\t/**获取正确的请求，非GET请求必须是服务器指定的\n\t * @return\n\t * @throws Exception\n\t */\n\t@Override\n\tpublic M parseCorrectRequest() throws Exception {\n\t\treturn parseCorrectRequest(requestMethod, tag, version, \"\", requestObject, getMaxUpdateCount(), this);\n\t}\n\n\n\t/**获取Request或Response内指定JSON结构\n\t * @param table\n\t * @param method\n\t * @param tag\n\t * @param version\n\t * @return\n\t * @throws Exception\n\t */\n\t@Override\n\tpublic M getStructure(@NotNull String table, String method, String tag, int version) throws Exception {\n\t\tString cacheKey = AbstractVerifier.getCacheKeyForRequest(method, tag);\n\t\tSortedMap> versionedMap = (SortedMap>) AbstractVerifier.REQUEST_MAP.get(cacheKey);\n\n\t\tMap result = versionedMap == null ? null : versionedMap.get(Integer.valueOf(version));\n\t\tif (result == null) { // version <= 0 时使用最新，version > 0 时使用 > version 的最接近版本（最小版本）\n\t\t\tSet>> set = versionedMap == null ? null : versionedMap.entrySet();\n\n\t\t\tif (set != null && set.isEmpty() == false) {\n\t\t\t\tEntry> maxEntry = null;\n\n\t\t\t\tfor (Entry> entry : set) {\n\t\t\t\t\tif (entry == null || entry.getKey() == null || entry.getValue() == null) {\n\t\t\t\t\t\tcontinue;\n\t\t\t\t\t}\n\n\t\t\t\t\tif (version <= 0 || version == entry.getKey()) { // 这里应该不会出现相等，因为上面 versionedMap.get(Integer.valueOf(version))\n\t\t\t\t\t\tmaxEntry = entry;\n\t\t\t\t\t\tbreak;\n\t\t\t\t\t}\n\n\t\t\t\t\tif (entry.getKey() < version) {\n\t\t\t\t\t\tbreak;\n\t\t\t\t\t}\n\n\t\t\t\t\tmaxEntry = entry;\n\t\t\t\t}\n\n\t\t\t\tresult = maxEntry == null ? null : maxEntry.getValue();\n\t\t\t}\n\n\t\t\tif (result != null) { // 加快下次查询，查到值的话组合情况其实是有限的，不属于恶意请求\n\t\t\t\tif (versionedMap == null) {\n\t\t\t\t\tversionedMap = new TreeMap<>((o1, o2) -> {\n\t\t\t\t\t\treturn o2 == null ? -1 : o2.compareTo(o1); // 降序\n\t\t\t\t\t});\n\t\t\t\t}\n\n\t\t\t\tversionedMap.put(Integer.valueOf(version), result);\n\t\t\t\tAbstractVerifier.REQUEST_MAP.put(cacheKey, versionedMap);\n\t\t\t}\n\t\t}\n\n\t\tif (result == null) {\n\t\t\tif (Log.DEBUG == false && AbstractVerifier.REQUEST_MAP.isEmpty() == false) {\n\t\t\t\treturn null; // 已使用 REQUEST_MAP 缓存全部，但没查到\n\t\t\t}\n\n\t\t\t// 获取指定的JSON结构 <<<<<<<<<<<<<<\n\t\t\tSQLConfig config = createSQLConfig().setMethod(GET).setTable(table);\n\t\t\tconfig.setParser(this);\n\t\t\tconfig.setPrepared(false);\n\t\t\tconfig.setColumn(Arrays.asList(\"structure\"));\n\n\t\t\tMap where = new HashMap();\n\t\t\twhere.put(\"method\", method);\n\t\t\twhere.put(KEY_TAG, tag);\n\n\t\t\tif (version > 0) {\n\t\t\t\twhere.put(KEY_VERSION + \">=\", version);\n\t\t\t}\n\t\t\tconfig.setWhere(where);\n\t\t\tconfig.setOrder(KEY_VERSION + (version > 0 ? \"+\" : \"-\"));\n\t\t\tconfig.setCount(1);\n\n\t\t\t// too many connections error: 不try-catch，可以让客户端看到是服务器内部异常\n\t\t\tresult = getSQLExecutor().execute(config, false);\n\n\t\t\t// version, method, tag 组合情况太多了，JDK 里又没有 LRUCache，所以要么启动时一次性缓存全部后面只用缓存，要么每次都查数据库\n\t\t\t//\t\t\tversionedMap.put(Integer.valueOf(version), result);\n\t\t\t//\t\t\tAbstractVerifier.REQUEST_MAP.put(cacheKey, versionedMap);\n\t\t}\n\n\t\treturn JSON.get(result, \"structure\"); //解决返回值套了一层 \"structure\":{}\n\t}\n\n\n\n\tprotected Map> arrayObjectParserCacheMap = new HashMap<>();\n\n\t//\tprotected SQLConfig itemConfig;\n\t/**获取单个对象，该对象处于parentObject内\n\t * @param request parentObject 的 value\n\t * @param parentPath parentObject 的路径\n\t * @param name parentObject 的 key\n\t * @param arrayConfig config for array item\n\t * @param isSubquery 是否为子查询\n\t * @param cache SQL 结果缓存\n\t * @return\n\t * @throws Exception\n\t */\n\t@Override\n\tpublic M onObjectParse(final M request, String parentPath, String name\n\t\t\t, final SQLConfig arrayConfig, boolean isSubquery, M cache) throws Exception {\n\n\t\tif (Log.DEBUG) {\n\t\t\tLog.i(TAG, \"\\ngetObject: parentPath = \" + parentPath\n\t\t\t\t\t+ \";\\n name = \" + name + \"; request = \" + JSON.toJSONString(request));\n\t\t}\n\t\tif (request == null) {// Moment:{} || request.isEmpty()) {//key-value条件\n\t\t\treturn null;\n\t\t}\n\n\t\tint type = arrayConfig == null ? 0 : arrayConfig.getType();\n\t\tint position = arrayConfig == null ? 0 : arrayConfig.getPosition();\n\n\t\tString[] arr = StringUtil.split(parentPath, \"/\");\n\t\tif (position == 0) {\n\t\t\tint d = arr == null ? 1 : arr.length + 1;\n\t\t\tif (queryDepth < d) {\n\t\t\t\tqueryDepth = d;\n\t\t\t\tint maxQueryDepth = getMaxQueryDepth();\n\t\t\t\tif (queryDepth > maxQueryDepth) {\n\t\t\t\t\tthrow new IllegalArgumentException(parentPath + \"/\" + name + \":{} 的深度(或者说层级) 为 \" + queryDepth + \" 已超限，必须在 1-\" + maxQueryDepth + \" 内 !\");\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\n\t\tapijson.orm.Entry entry = Pair.parseEntry(name, true);\n\t\tString table = entry.getKey(); //Comment\n\t\t// String alias = entry.getValue(); //to\n\n\t\tboolean isTable = isTableKey(table);\n\t\tboolean isArrayMainTable = isSubquery == false && isTable && type == SQLConfig.TYPE_ITEM_CHILD_0 && arrayConfig != null && RequestMethod.isGetMethod(arrayConfig.getMethod(), true);\n\t\tboolean isReuse = isArrayMainTable && position > 0;\n\n\t\tObjectParser op = null;\n\t\tif (isReuse) { // 数组主表使用专门的缓存数据\n\t\t\top = arrayObjectParserCacheMap.get(parentPath.substring(0, parentPath.lastIndexOf(\"[]\") + 2));\n\t\t\top.setParentPath(parentPath);\n\t\t}\n\n\t\tif (op == null) {\n\t\t\top = createObjectParser(request, parentPath, arrayConfig, isSubquery, isTable, isArrayMainTable);\n\t\t}\n\t\t// 对象 - 设置 method\n\t\tsetOpMethod(request, op, name);\n\n\t\top.setCache(cache);\n\t\top = op.parse(name, isReuse);\n\n\t\tM response = null;\n\t\tif (op != null) {//SQL查询结果为空时，functionMap和customMap没有意义\n\n\t\t\tif (arrayConfig == null) { //Common\n\t\t\t\tresponse = op.setSQLConfig().executeSQL().response();\n\t\t\t}\n\t\t\telse {//Array Item Child\n\t\t\t\tint query = arrayConfig.getQuery();\n\n\t\t\t\t//total 这里不能用arrayConfig.getType()，因为在createObjectParser.onChildParse传到onObjectParse时已被改掉\n\t\t\t\tif (type == SQLConfig.TYPE_ITEM_CHILD_0 && query != apijson.JSONRequest.QUERY_TABLE && position == 0) {\n\n\t\t\t\t\t//TODO 应在这里判断 @column 中是否有聚合函数，而不是 AbstractSQLConfig.getColumnString\n\n\t\t\t\t\tMap rp;\n\t\t\t\t\tBoolean compat = arrayConfig.getCompat();\n\t\t\t\t\tif (compat != null && compat) {\n\t\t\t\t\t\t// 解决对聚合函数字段通过 query:2 分页查总数返回值错误\n\t\t\t\t\t\t// 这里可能改变了内部的一些数据，下方通过 arrayConfig 还原\n\t\t\t\t\t\tSQLConfig cfg = op.setSQLConfig(0, 0, 0).getSQLConfig();\n\t\t\t\t\t\tboolean isExplain = cfg.isExplain();\n\t\t\t\t\t\tcfg.setExplain(false);\n\n\t\t\t\t\t\tSubquery subqy = new Subquery();\n\t\t\t\t\t\tsubqy.setFrom(cfg.getTable());\n\t\t\t\t\t\tsubqy.setConfig(cfg);\n\n\t\t\t\t\t\tSQLConfig countSQLCfg = createSQLConfig();\n\t\t\t\t\t\tcountSQLCfg.setColumn(Arrays.asList(\"count(*):count\"));\n\t\t\t\t\t\tcountSQLCfg.setFrom(subqy);\n\n\t\t\t\t\t\trp = executeSQL(countSQLCfg, false);\n\n\t\t\t\t\t\tcfg.setExplain(isExplain);\n\t\t\t\t\t}\n\t\t\t\t\telse {\n\t\t\t\t\t\t// 对聚合函数字段通过 query:2 分页查总数返回值错误\n\t\t\t\t\t\tRequestMethod method = op.getMethod();\n\t\t\t\t\t\trp = op.setMethod(RequestMethod.HEAD).setSQLConfig().executeSQL().getSQLResponse();\n\t\t\t\t\t\top.setMethod(method);\n\t\t\t\t\t}\n\n\t\t\t\t\tif (rp != null) {\n\t\t\t\t\t\tint index = parentPath.lastIndexOf(\"]/\");\n\t\t\t\t\t\tif (index >= 0) {\n\t\t\t\t\t\t\tint total = getIntValue(rp, JSONResponse.KEY_COUNT);\n\n\t\t\t\t\t\t\tString pathPrefix = parentPath.substring(0, index) + \"]/\";\n\t\t\t\t\t\t\tputQueryResult(pathPrefix + JSONResponse.KEY_TOTAL, total);\n\n\t\t\t\t\t\t\t//详细的分页信息，主要为 PC 端提供\n\t\t\t\t\t\t\tint count = arrayConfig.getCount();\n\t\t\t\t\t\t\tint page = arrayConfig.getPage();\n\t\t\t\t\t\t\tint max = (int) ((total - 1)/count);\n\t\t\t\t\t\t\tif (max < 0) {\n\t\t\t\t\t\t\t\tmax = 0;\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\tint min = getMinQueryPage();\n\n\t\t\t\t\t\t\tpage += min;\n\t\t\t\t\t\t\tmax += min;\n\n\t\t\t\t\t\t\tM pagination = JSON.createJSONObject();\n\t\t\t\t\t\t\tObject explain = rp.get(JSONResponse.KEY_EXPLAIN);\n\t\t\t\t\t\t\tif (explain instanceof Map) {\n\t\t\t\t\t\t\t\tpagination.put(JSONResponse.KEY_EXPLAIN, explain);\n\t\t\t\t\t\t\t}\n\n\t\t\t\t\t\t\tpagination.put(JSONResponse.KEY_TOTAL, total);\n\t\t\t\t\t\t\tpagination.put(apijson.JSONRequest.KEY_COUNT, count);\n\t\t\t\t\t\t\tpagination.put(apijson.JSONRequest.KEY_PAGE, page);\n\t\t\t\t\t\t\tpagination.put(JSONResponse.KEY_MAX, max);\n\t\t\t\t\t\t\tpagination.put(JSONResponse.KEY_MORE, page < max);\n\t\t\t\t\t\t\tpagination.put(JSONResponse.KEY_FIRST, page == min);\n\t\t\t\t\t\t\tpagination.put(JSONResponse.KEY_LAST, page == max);\n\n\t\t\t\t\t\t\tputQueryResult(pathPrefix + JSONResponse.KEY_INFO, pagination);\n\n\t\t\t\t\t\t\tif (total <= count*(page - min)) {\n\t\t\t\t\t\t\t\tquery = apijson.JSONRequest.QUERY_TOTAL;//数量不够了，不再往后查询\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\n\t\t\t\t\top.setMethod(requestMethod);\n\t\t\t\t}\n\n\t\t\t\t//Table\n\t\t\t\tif (query == apijson.JSONRequest.QUERY_TOTAL) {\n\t\t\t\t\tresponse = null;//不再往后查询\n\t\t\t\t} else {\n\t\t\t\t\tresponse = op\n\t\t\t\t\t\t\t.setSQLConfig(arrayConfig.getCount(), arrayConfig.getPage(), position)\n\t\t\t\t\t\t\t.executeSQL()\n\t\t\t\t\t\t\t.response();\n\t\t\t\t\t//\t\t\t\t\titemConfig = op.getConfig();\n\t\t\t\t}\n\t\t\t}\n\n\t\t\tif (isArrayMainTable) {\n\t\t\t\tif (position == 0) { // 提取并缓存数组主表的列表数据\n\t\t\t\t\tarrayObjectParserCacheMap.put(parentPath.substring(0, parentPath.lastIndexOf(\"[]\") + 2), op);\n\t\t\t\t}\n\t\t\t}\n\t\t\t//\t\t\telse {\n\t\t\t//\t\t\t\top.recycle();\n\t\t\t//\t\t\t}\n\t\t\top = null;\n\t\t}\n\n\t\treturn response;\n\t}\n\n\t/**获取对象数组，该对象数组处于parentObject内\n\t * @param request parentObject的value\n\t * @param parentPath parentObject的路径\n\t * @param name parentObject的key\n\t * @param isSubquery 是否为子查询\n\t * @param cache SQL 结果缓存\n\t * @return\n\t * @throws Exception\n\t */\n\t@Override\n\tpublic L onArrayParse(M request, String parentPath, String name, boolean isSubquery, L cache) throws Exception {\n\t\tif (Log.DEBUG) {\n\t\t\tLog.i(TAG, \"\\n\\n\\n onArrayParse parentPath = \" + parentPath\n\t\t\t\t\t+ \"; name = \" + name + \"; request = \" + JSON.toJSONString(request));\n\t\t}\n\n\t\t//不能允许GETS，否则会被通过\"[]\":{\"@role\":\"ADMIN\"},\"Table\":{},\"tag\":\"Table\"绕过权限并能批量查询\n\t\tRequestMethod _method = request.get(KEY_METHOD) == null ? requestMethod : RequestMethod.valueOf(getString(request, KEY_METHOD));\n\t\tif (isSubquery == false && RequestMethod.isGetMethod(_method, true) == false) {\n\t\t\tthrow new UnsupportedOperationException(\"key[]:{} 只支持 GET, GETS 方法！其它方法不允许传 \" + name + \":{} 等这种 key[]:{} 格式！\");\n\t\t}\n\t\tif (request == null || request.isEmpty()) { // jsonKey-jsonValue 条件\n\t\t\treturn null;\n\t\t}\n\t\tString path = getAbsPath(parentPath, name);\n\n\n\t\t//不能改变，因为后面可能继续用到，导致1以上都改变 []:{0:{Comment[]:{0:{Comment:{}},1:{...},...}},1:{...},...}\n\t\tfinal String query = getString(request, apijson.JSONRequest.KEY_QUERY);\n\t\tfinal Boolean compat = getBoolean(request, apijson.JSONRequest.KEY_COMPAT);\n\t\tfinal Integer count = getInteger(request, apijson.JSONRequest.KEY_COUNT); //TODO 如果不想用默认数量可以改成 getIntValue(apijson.JSONRequest.KEY_COUNT);\n\t\tfinal Integer page = getInteger(request, apijson.JSONRequest.KEY_PAGE);\n\t\tfinal Object join = request.get(apijson.JSONRequest.KEY_JOIN);\n\n\t\tint query2;\n\t\tif (query == null) {\n\t\t\tquery2 = apijson.JSONRequest.QUERY_TABLE;\n\t\t}\n\t\telse {\n\t\t\tswitch (query) {\n\t\t\tcase \"0\":\n\t\t\tcase apijson.JSONRequest.QUERY_TABLE_STRING:\n\t\t\t\tquery2 = apijson.JSONRequest.QUERY_TABLE;\n\t\t\t\tbreak;\n\t\t\tcase \"1\":\n\t\t\tcase apijson.JSONRequest.QUERY_TOTAL_STRING:\n\t\t\t\tquery2 = apijson.JSONRequest.QUERY_TOTAL;\n\t\t\t\tbreak;\n\t\t\tcase \"2\":\n\t\t\tcase apijson.JSONRequest.QUERY_ALL_STRING:\n\t\t\t\tquery2 = apijson.JSONRequest.QUERY_ALL;\n\t\t\t\tbreak;\n\t\t\tdefault:\n\t\t\t\tthrow new IllegalArgumentException(path + \"/\" + apijson.JSONRequest.KEY_QUERY + \":value 中 value 的值不合法！必须在 [0, 1, 2] 或 [TABLE, TOTAL, ALL] 内 !\");\n\t\t\t}\n\t\t}\n\n\t\tint minPage = getMinQueryPage(); // 兼容各种传 0 或 null/undefined 自动转 0 导致的问题\n\t\tint page2 = page == null || page == 0 ? 0 : page - minPage;\n\n\t\tint maxPage = getMaxQueryPage();\n\t\tif (page2 < 0 || page2 > maxPage) {\n\t\t\tthrow new IllegalArgumentException(path + \"/\" + apijson.JSONRequest.KEY_PAGE + \":value 中 value 的值不合法！必须在 \" + minPage + \"-\" + maxPage + \" 内 !\");\n\t\t}\n\n\t\t//不用total限制数量了，只用中断机制，total只在query = 1,2的时候才获取\n\t\tint count2 = isSubquery || count != null ? (count == null ? 0 : count) : getDefaultQueryCount();\n\t\tint max = isSubquery ? count2 : getMaxQueryCount();\n\n\t\tif (count2 < 0 || count2 > max) {\n\t\t\tthrow new IllegalArgumentException(path + \"/\" + apijson.JSONRequest.KEY_COUNT + \":value 中 value 的值不合法！必须在 0-\" + max + \" 内 !\");\n\t\t}\n\n\t\trequest.remove(apijson.JSONRequest.KEY_QUERY);\n\t\trequest.remove(apijson.JSONRequest.KEY_COMPAT);\n\t\trequest.remove(apijson.JSONRequest.KEY_COUNT);\n\t\trequest.remove(apijson.JSONRequest.KEY_PAGE);\n\t\trequest.remove(apijson.JSONRequest.KEY_JOIN);\n\t\tLog.d(TAG, \"onArrayParse query = \" + query + \"; count = \" + count + \"; page = \" + page + \"; join = \" + join);\n\n\t\tif (request.isEmpty()) { // 如果条件成立，说明所有的 parentPath/name:request 中request都无效！！！ 后续都不执行，没必要还原数组关键词浪费性能\n\t\t\tLog.e(TAG, \"onArrayParse request.isEmpty() >> return null;\");\n\t\t\treturn null;\n\t\t}\n\n\t\tL response = null;\n\t\ttry {\n\t\t\tint size = count2 == 0 ? max : count2; //count为每页数量，size为第page页实际数量，max(size) = count\n\t\t\tLog.d(TAG, \"onArrayParse size = \" + size + \"; page = \" + page2);\n\n\n\t\t\t//key[]:{Table:{}}中key equals Table时 提取Table\n\t\t\tint index = isSubquery || name == null ? -1 : name.lastIndexOf(\"[]\");\n\t\t\tString childPath = index <= 0 ? null : Pair.parseEntry(name.substring(0, index), true).getKey(); // Table-key1-key2...\n\n\t\t\tString arrTableKey = null;\n\t\t\t//判断第一个key，即Table是否存在，如果存在就提取\n\t\t\tString[] childKeys = StringUtil.split(childPath, \"-\", false);\n\t\t\tif (childKeys == null || childKeys.length <= 0 || request.containsKey(childKeys[0]) == false) {\n\t\t\t\tchildKeys = null;\n\t\t\t}\n\t\t\telse if (childKeys.length == 1 && isTableKey(childKeys[0])) { // 可能无需提取，直接返回 rawList 即可\n\t\t\t\tarrTableKey = childKeys[0];\n\t\t\t}\n\n\n\t\t\t//Table<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<\n\n\t\t\tList> joinList = onJoinParse(join, request);\n\t\t\tSQLConfig config = createSQLConfig()\n\t\t\t\t\t.setMethod(requestMethod)\n\t\t\t\t\t.setCount(size)\n\t\t\t\t\t.setPage(page2)\n\t\t\t\t\t.setQuery(query2)\n\t\t\t\t\t.setCompat(compat)\n\t\t\t\t\t.setTable(arrTableKey)\n\t\t\t\t\t.setJoinList(joinList);\n\n\t\t\tMap parent;\n\n\t\t\tboolean isExtract = true;\n\n\t\t\tresponse = JSON.createJSONArray();\n\t\t\t//生成size个\n\t\t\tfor (int i = 0; i < (isSubquery ? 1 : size); i++) {\n\t\t\t\tparent = onObjectParse(request, isSubquery ? parentPath : path, isSubquery ? name : \"\" + i, config.setType(SQLConfig.TYPE_ITEM).setPosition(i), isSubquery, null);\n\t\t\t\tif (parent == null || parent.isEmpty()) {\n\t\t\t\t\tbreak;\n\t\t\t\t}\n\n\t\t\t\tlong startTime = System.currentTimeMillis();\n\n\t\t\t\t/* 这里优化了 Table[]: { Table:{} } 这种情况下的性能\n\t\t\t\t * 如果把 List> 改成 L 来减少以下 addAll 一次复制，则会导致 AbstractSQLExecutor 等其它很多地方 get 要改为 getJSONObject，\n\t\t\t\t * 修改类型会导致不兼容旧版依赖 ORM 的项目，而且整体上性能只有特殊情况下性能提升，其它非特殊情况下因为多出很多 instanceof Map 的判断而降低了性能。\n\t\t\t\t */\n\t\t\t\tMap fo = i != 0 || arrTableKey == null ? null : JSON.get(parent, arrTableKey);\n\t\t\t\t@SuppressWarnings(\"unchecked\")\n\t\t\t\tList> list = fo == null ? null : (List>) fo.remove(AbstractSQLExecutor.KEY_RAW_LIST);\n\n\t\t\t\tif (list != null && list.isEmpty() == false && (joinList == null || joinList.isEmpty())) {\n\t\t\t\t\tisExtract = false;\n\n\t\t\t\t\tlist.set(0, fo); // 不知道为啥第 0 项也加了 @RAW@LIST\n\t\t\t\t\tresponse.addAll(list); // List> cannot match List response = JSON.createJSONArray(list);\n\n\t\t\t\t\tlong endTime = System.currentTimeMillis(); // 0ms\n\t\t\t\t\tLog.d(TAG, \"\\n onArrayParse <<<<<<<<<<<<<<<<<<<<<<<<<<<<\\n for (int i = 0; i < (isSubquery ? 1 : size); i++) \"\n\t\t\t\t\t\t\t+ \" startTime = \" + startTime + \"; endTime = \" + endTime + \"; duration = \" + (endTime - startTime) + \"\\n >>>>>>>>>>>>>>>>>>>>>>>>>>>>>\\n\");\n\t\t\t\t\tbreak;\n\t\t\t\t}\n\n\t\t\t\t//key[]:{Table:{}}中key equals Table时 提取Table\n\t\t\t\tresponse.add(getValue(parent, childKeys)); //null有意义\n\t\t\t}\n\n\t\t\t//Table>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>\n\n\n\t\t\t/*\n\t\t\t * 支持引用取值后的数组\n\t\t\t{\n\t\t\t \"User-id[]\": {\n\t\t\t \"User\": {\n\t\t\t \"contactIdList<>\": 82002\n\t\t\t }\n\t\t\t },\n\t\t\t \"Moment-userId[]\": {\n\t\t\t \"Moment\": {\n\t\t\t \"userId{}@\": \"User-id[]\"\n\t\t\t }\n\t\t\t }\n\t\t\t}\n\t\t\t */\n\t\t\tif (isExtract) {\n\t\t\t\tlong startTime = System.currentTimeMillis();\n\n\t\t\t\tObject fo = childKeys == null || response.isEmpty() ? null : response.get(0);\n\t\t\t\tif (fo instanceof Boolean || fo instanceof Number || fo instanceof String) { //[{}] 和 [[]] 都没意义\n\t\t\t\t\tputQueryResult(path, response);\n\t\t\t\t}\n\n\t\t\t\tlong endTime = System.currentTimeMillis();\n\t\t\t\tLog.d(TAG, \"\\n onArrayParse <<<<<<<<<<<<<<<<<<<<<<<<<<<<\\n isExtract >> putQueryResult \"\n\t\t\t\t\t\t+ \" startTime = \" + startTime + \"; endTime = \" + endTime + \"; duration = \" + (endTime - startTime) + \"\\n >>>>>>>>>>>>>>>>>>>>>>>>>>>>>\\n\");\n\t\t\t}\n\n\t\t} finally {\n\t\t\t//后面还可能用到，要还原\n\t\t\trequest.put(apijson.JSONRequest.KEY_QUERY, query);\n\t\t\trequest.put(apijson.JSONRequest.KEY_COMPAT, compat);\n\t\t\trequest.put(apijson.JSONRequest.KEY_COUNT, count);\n\t\t\trequest.put(apijson.JSONRequest.KEY_PAGE, page);\n\t\t\trequest.put(apijson.JSONRequest.KEY_JOIN, join);\n\t\t}\n\n\t\tif (Log.DEBUG) {\n\t\t\tLog.i(TAG, \"onArrayParse return response = \\n\" + JSON.toJSONString(response) + \"\\n>>>>>>>>>>>>>>>\\n\\n\\n\");\n\t\t}\n\t\treturn response;\n\t}\n\n\n\n\tprivate static final List JOIN_COPY_KEY_LIST;\n\tstatic { // TODO 不全\n\t\tJOIN_COPY_KEY_LIST = new ArrayList();\n\t\tJOIN_COPY_KEY_LIST.add(KEY_ROLE);\n\t\tJOIN_COPY_KEY_LIST.add(KEY_DATABASE);\n\t\tJOIN_COPY_KEY_LIST.add(KEY_NAMESPACE);\n\t\tJOIN_COPY_KEY_LIST.add(KEY_CATALOG);\n\t\tJOIN_COPY_KEY_LIST.add(KEY_SCHEMA);\n\t\tJOIN_COPY_KEY_LIST.add(KEY_DATASOURCE);\n\t\tJOIN_COPY_KEY_LIST.add(KEY_COLUMN);\n\t\tJOIN_COPY_KEY_LIST.add(KEY_NULL);\n\t\tJOIN_COPY_KEY_LIST.add(KEY_CAST);\n\t\tJOIN_COPY_KEY_LIST.add(KEY_COMBINE);\n\t\tJOIN_COPY_KEY_LIST.add(KEY_GROUP);\n\t\tJOIN_COPY_KEY_LIST.add(KEY_HAVING);\n\t\tJOIN_COPY_KEY_LIST.add(KEY_HAVING_AND);\n\t\tJOIN_COPY_KEY_LIST.add(KEY_SAMPLE);\n\t\tJOIN_COPY_KEY_LIST.add(KEY_LATEST);\n\t\tJOIN_COPY_KEY_LIST.add(KEY_PARTITION);\n\t\tJOIN_COPY_KEY_LIST.add(KEY_FILL);\n\t\tJOIN_COPY_KEY_LIST.add(KEY_ORDER);\n\t\tJOIN_COPY_KEY_LIST.add(KEY_KEY);\n\t\tJOIN_COPY_KEY_LIST.add(KEY_RAW);\n\t}\n\n\t/**JOIN 多表同时筛选\n\t * @param join \"&/User,0\"}\n\t * @param request\n\t * @return\n\t * @throws Exception\n\t */\n\tprivate List> onJoinParse(Object join, M request) throws Exception {\n\t\tMap joinMap = null;\n\n\t\tif (join instanceof Map) {\n\t\t\tjoinMap = (M) join;\n\t\t}\n\t\telse if (join instanceof String) {\n\t\t\tString[] sArr = request == null || request.isEmpty() ? null : StringUtil.split((String) join);\n\t\t\tif (sArr != null && sArr.length > 0) {\n\t\t\t\tjoinMap = new LinkedHashMap(); //注意：这里必须要保证join连接顺序，保证后边遍历是按照join参数的顺序生成的SQL\n\t\t\t\tfor (int i = 0; i < sArr.length; i++) {\n\t\t\t\t\tjoinMap.put(sArr[i], new LinkedHashMap());\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t\telse if (join != null){\n\t\t\tthrow new UnsupportedDataTypeException(TAG + \".onJoinParse join 只能是 String 或 Map 类型！\");\n\t\t}\n\n\t\tList> slashKeys = new ArrayList<>();\n\t\tList> nonSlashKeys = new ArrayList<>();\n\t\tSet> entries = joinMap == null ? null : joinMap.entrySet();\n\n\t\tif (entries == null || entries.isEmpty()) {\n\t\t\tLog.e(TAG, \"onJoinParse set == null || set.isEmpty() >> return null;\");\n\t\t\treturn null;\n\t\t}\n\t\tfor (Entry e : entries) {\n\t\t\tString path = e.getKey();\n\t\t\tif (path != null && path.indexOf(\"/\") > 0) {\n\t\t\t\tslashKeys.add(e); // 以 / 开头的 key，例如 whereJoinMap = new LinkedHashMap<>();\n\n\t\tfor (Entry e : nonSlashKeys) {\n\t\t\tString tableKey = e.getKey(); // 如 \"Location_info\"\n\t\t\tObject tableObj = e.getValue(); // value 是 Map\n\n\t\t\tif (request.containsKey(tableKey)) {\n\t\t\t\twhereJoinMap.put(tableKey, tableObj);\n\t\t\t} else {\n\t\t\t\tLog.w(TAG, \"跳过 join 中 key = \" + tableKey + \"，因为它不在 request 中\");\n\t\t\t}\n\t\t}\n\n\n\t\tSet> set = joinMap == null ? null : new LinkedHashSet<>(slashKeys);\n\n\t\tif (set == null || set.isEmpty()) {\n\t\t\tLog.e(TAG, \"onJoinParse set == null || set.isEmpty() >> return null;\");\n\t\t\treturn null;\n\t\t}\n\n\t\tList> joinList = new ArrayList<>();\n\n\t\tfor (Entry e : set) { // { &/User:{}, == false) {\n\t\t\t\tthrow new IllegalArgumentException(apijson.JSONRequest.KEY_JOIN + \":value 中value不合法！\"\n\t\t\t\t\t\t+ \"必须为 &/Table0/key0, ( ) <> () *\n\t\t\t//\t\t\tif (StringUtil.isEmpty(joinType, true)) {\n\t\t\t//\t\t\t\tjoinType = \"|\"; // FULL JOIN\n\t\t\t//\t\t\t}\n\t\t\tpath = path.substring(index + 1);\n\n\t\t\tindex = path.lastIndexOf(\"/\");\n\t\t\tString tableKey = index < 0 ? path : path.substring(0, index); // User:owner\n\t\t\tint index2 = tableKey.lastIndexOf(\"/\");\n\t\t\tString arrKey = index2 < 0 ? null : tableKey.substring(0, index2);\n\t\t\tif (arrKey != null && isArrayKey(arrKey) == false) {\n\t\t\t\tthrow new IllegalArgumentException(apijson.JSONRequest.KEY_JOIN + \":'\" + e.getKey() + \"' 对应的 \" + arrKey + \" 不是合法的数组 key[] ！\" +\n\t\t\t\t\t\t\"@ APP JOIN 最多允许跨 1 层，只能是子数组，且数组对象中不能有 join: value 键值对！\");\n\t\t\t}\n\n\t\t\ttableKey = index2 < 0 ? tableKey : tableKey.substring(index2+1);\n\n\t\t\tapijson.orm.Entry entry = Pair.parseEntry(tableKey, true);\n\t\t\tString table = entry.getKey(); // User\n\t\t\tif (StringUtil.isName(table) == false) {\n\t\t\t\tthrow new IllegalArgumentException(apijson.JSONRequest.KEY_JOIN + \":value 中 value 的 Table 值 \" + table + \" 不合法！\"\n\t\t\t\t\t\t+ \"必须为 &/Table0, 格式！\" + e2.getMessage());\n\t\t\t}\n\n\t\t\tif (arrKey != null) {\n\t\t\t\tif (parentPathObj.get(apijson.JSONRequest.KEY_JOIN) != null) {\n\t\t\t\t\tthrow new IllegalArgumentException(apijson.JSONRequest.KEY_JOIN + \":'\" + e.getKey() + \"' 对应的 \" + arrKey + \":{ join: value } 中 value 不合法！\" +\n\t\t\t\t\t\t\t\"@ APP JOIN 最多允许跨 1 层，只能是子数组，且数组对象中不能有 join: value 键值对！\");\n\t\t\t\t}\n\n\t\t\t\tInteger subPage = getInteger(parentPathObj, apijson.JSONRequest.KEY_PAGE);\n\t\t\t\tif (subPage != null && subPage != 0) {\n\t\t\t\t\tthrow new IllegalArgumentException(apijson.JSONRequest.KEY_JOIN + \":'\" + e.getKey() + \"' 对应的 \" + arrKey + \":{ page: value } 中 value 不合法！\" +\n\t\t\t\t\t\t\t\"@ APP JOIN 最多允许跨 1 层，只能是子数组，且数组对象中 page 值只能为 null 或 0 ！\");\n\t\t\t\t}\n\t\t\t}\n\n\t\t\tboolean isAppJoin = \"@\".equals(joinType);\n\n\t\t\tM refObj = JSON.createJSONObject();\n\n\t\t\tString key = index < 0 ? null : path.substring(index + 1); // id@\n\t\t\tif (key != null) { // 指定某个 key 为 JOIN ON 条件\n\t\t\t\tif (key.indexOf(\"@\") != key.length() - 1) {\n\t\t\t\t\tthrow new IllegalArgumentException(apijson.JSONRequest.KEY_JOIN + \":\" + e.getKey() + \" 中 \" + key + \" 不合法！\"\n\t\t\t\t\t\t\t+ \"必须为 &/Table0,> tableSet = tableObj.entrySet();\n\t\t\t// 取出所有 join 条件\n\t\t\tM requestObj = JSON.createJSONObject(); // (Map) obj.clone();\n\n\t\t\tboolean matchSingle = false;\n\t\t\tfor (Entry tableEntry : tableSet) {\n\t\t\t\tString k = tableEntry.getKey();\n\t\t\t\tObject v = k == null ? null : tableEntry.getValue();\n\t\t\t\tif (v == null) {\n\t\t\t\t\tcontinue;\n\t\t\t\t}\n\n\t\t\t\tmatchSingle = matchSingle == false && k.equals(key);\n\t\t\t\tif (matchSingle) {\n\t\t\t\t\tcontinue;\n\t\t\t\t}\n\n\t\t\t\tif (k.length() > 1 && k.indexOf(\"@\") == k.length() - 1 && v instanceof String) {\n\t\t\t\t\tString sv = (String) v;\n\t\t\t\t\tint ind = sv.endsWith(\"@\") ? -1 : sv.indexOf(\"/\");\n\t\t\t\t\tif (ind == 0 && key == null) { // 指定了某个就只允许一个 ON 条件\n\t\t\t\t\t\tString p = sv.substring(1);\n\t\t\t\t\t\tint ind2 = p.indexOf(\"/\");\n\t\t\t\t\t\tString tk = ind2 < 0 ? null : p.substring(0, ind2);\n\n\t\t\t\t\t\tapijson.orm.Entry te = tk == null || p.substring(ind2 + 1).indexOf(\"/\") >= 0 ? null : Pair.parseEntry(tk, true);\n\n\t\t\t\t\t\tif (te != null && isTableKey(te.getKey()) && request.get(tk) instanceof Map) {\n\t\t\t\t\t\t\tif (isAppJoin) {\n\t\t\t\t\t\t\t\tif (refObj.size() >= 1) {\n\t\t\t\t\t\t\t\t\tthrow new IllegalArgumentException(apijson.JSONRequest.KEY_JOIN + \":\" + e.getKey() + \" 中 \" + k + \" 不合法！\"\n\t\t\t\t\t\t\t\t\t\t\t+ \"@ APP JOIN 必须有且只有一个引用赋值键值对！\");\n\t\t\t\t\t\t\t\t}\n\n\t\t\t\t\t\t\t\tif (StringUtil.isName(k.substring(0, k.length() - 1)) == false) {\n\t\t\t\t\t\t\t\t\tthrow new IllegalArgumentException(apijson.JSONRequest.KEY_JOIN + \":'\" + e.getKey() + \"' 中 \" + k + \" 不合法 ！\" +\n\t\t\t\t\t\t\t\t\t\t\t\"@ APP JOIN 只允许 key@:/Table/refKey 这种 = 等价连接！\");\n\t\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\t}\n\n\t\t\t\t\t\t\trefObj.put(k, v);\n\t\t\t\t\t\t\tcontinue;\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\n\t\t\t\t\tObject rv = getValueByPath(sv);\n\t\t\t\t\tif (rv != null && rv.equals(sv) == false) {\n\t\t\t\t\t\trequestObj.put(k.substring(0, k.length() - 1), rv);\n\t\t\t\t\t\tcontinue;\n\t\t\t\t\t}\n\n\t\t\t\t\tthrow new UnsupportedOperationException(table + \"/\" + k + \" 不合法！\" + apijson.JSONRequest.KEY_JOIN + \" 关联的 Table 中，\"\n\t\t\t\t\t\t\t+ \"join: ?/Table/key 时只能有 1 个 key@:value；join: ?/Table 时所有 key@:value 要么是符合 join 格式，要么能直接解析成具体值！\"); // TODO 支持 join on\n\t\t\t\t}\n\n\t\t\t\tif (k.startsWith(\"@\")) {\n\t\t\t\t\tif (JOIN_COPY_KEY_LIST.contains(k)) {\n\t\t\t\t\t\trequestObj.put(k, v); // 保留\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t\telse {\n\t\t\t\t\tif (k.endsWith(\"@\")) {\n\t\t\t\t\t\tthrow new UnsupportedOperationException(table + \"/\" + k + \" 不合法！\" + apijson.JSONRequest.KEY_JOIN + \" 关联的 Table 中，\"\n\t\t\t\t\t\t\t\t+ \"join: ?/Table/key 时只能有 1 个 key@:value；join: ?/Table 时所有 key@:value 要么是符合 join 格式，要么能直接解析成具体值！\"); // TODO 支持 join on\n\t\t\t\t\t}\n\n\t\t\t\t\tif (k.contains(\"()\") == false) { // 不需要远程函数\n\t\t\t\t\t\trequestObj.put(k, v); // 保留\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t}\n\n\t\t\tSet> refSet = refObj.entrySet();\n\t\t\tif (refSet.isEmpty() && \"*\".equals(joinType) == false) {\n\t\t\t\tthrow new IllegalArgumentException(apijson.JSONRequest.KEY_JOIN + \":value 中 value 的 alias 值 \" + alias + \" 不合法！\"\n\t\t\t\t\t\t+ \"必须为 &/Table0, j = new Join<>();\n\t\t\tj.setPath(e.getKey());\n\t\t\tj.setJoinType(joinType);\n\t\t\tj.setTable(table);\n\t\t\tj.setAlias(alias);\n\n\t\t\tM outerObj = (M) JSON.createJSONObject((Map) outer);\n j.setOn(outerObj);\n\t\t\tj.setRequest(requestObj);\n\n if (whereJoinMap.containsKey(table)) {\n Object rawOuter = whereJoinMap.get(table);\n M outerObj1 = (M) JSON.createJSONObject((Map) rawOuter);\n j.setOuter(outerObj1);\n }\n\n\t\t\tif (arrKey != null) {\n\t\t\t\tInteger count = getInteger(parentPathObj, apijson.JSONRequest.KEY_COUNT);\n\t\t\t\tj.setCount(count == null ? getDefaultQueryCount() : count);\n\t\t\t}\n\n\t\t\tList onList = new ArrayList<>();\n\t\t\tfor (Entry refEntry : refSet) {\n\t\t\t\tString originKey = refEntry.getKey();\n\n\t\t\t\tString targetPath = (String) refEntry.getValue();\n\t\t\t\tif (StringUtil.isEmpty(targetPath, true)) {\n\t\t\t\t\tthrow new IllegalArgumentException(e.getKey() + \":value 中 value 值 \" + targetPath + \" 不合法！必须为引用赋值的路径 '/targetTable/targetKey' ！\");\n\t\t\t\t}\n\n\t\t\t\t// 取出引用赋值路径 targetPath 对应的 Table 和 key\n\t\t\t\tindex = targetPath.lastIndexOf(\"/\");\n\t\t\t\tString targetKey = index < 0 ? null : targetPath.substring(index + 1);\n\t\t\t\tif (StringUtil.isName(targetKey) == false) {\n\t\t\t\t\tthrow new IllegalArgumentException(e.getKey() + \":'/targetTable/targetKey' 中 targetKey 值 \" + targetKey + \" 不合法！必须满足英文单词变量名格式！\");\n\t\t\t\t}\n\n\t\t\t\ttargetPath = targetPath.substring(0, index);\n\t\t\t\tindex = targetPath.lastIndexOf(\"/\");\n\t\t\t\tString targetTableKey = index < 0 ? targetPath : targetPath.substring(index + 1);\n\n\t\t\t\t// 主表允许别名\n\t\t\t\tapijson.orm.Entry targetEntry = Pair.parseEntry(targetTableKey, true);\n\t\t\t\tString targetTable = targetEntry.getKey(); //User\n\t\t\t\tif (StringUtil.isName(targetTable) == false) {\n\t\t\t\t\tthrow new IllegalArgumentException(e.getKey() + \":'/targetTable/targetKey' 中 targetTable 值 \" + targetTable + \" 不合法！必须满足大写字母开头的表对象英文单词 key 格式！\");\n\t\t\t\t}\n\n\t\t\t\tString targetAlias = targetEntry.getValue(); //owner\n\t\t\t\tif (StringUtil.isNotEmpty(targetAlias, true) && StringUtil.isName(targetAlias) == false) {\n\t\t\t\t\tthrow new IllegalArgumentException(e.getKey() + \":'/targetTable:targetAlias/targetKey' 中 targetAlias 值 \" + targetAlias + \" 不合法！必须满足英文单词变量名格式！\");\n\t\t\t\t}\n\n\t\t\t\t//targetTable = targetTableKey; // 主表允许别名\n\t\t\t\tif (StringUtil.isName(targetTable) == false) {\n\t\t\t\t\tthrow new IllegalArgumentException(e.getKey() + \":'/targetTable/targetKey' 中 targetTable 值 \" + targetTable + \" 不合法！必须满足大写字母开头的表对象英文单词 key 格式！\");\n\t\t\t\t}\n\n\t\t\t\t//对引用的JSONObject添加条件\n\t\t\t\tMap targetObj;\n\t\t\t\ttry {\n\t\t\t\t\ttargetObj = JSON.get(request, targetTableKey);\n\t\t\t\t}\n\t\t\t\tcatch (Exception e2) {\n\t\t\t\t\tthrow new IllegalArgumentException(e.getKey() + \":'/targetTable/targetKey' 中路径对应的 '\" + targetTableKey + \"':value 中 value 类型不合法！必须是 {} 这种 Map 格式！\" + e2.getMessage());\n\t\t\t\t}\n\n\t\t\t\tif (targetObj == null) {\n\t\t\t\t\tthrow new IllegalArgumentException(e.getKey() + \":'/targetTable/targetKey' 中路径对应的对象 '\" + targetTableKey + \"':{} 不存在或值为 null ！必须是 {} 这种 Map 格式！\");\n\t\t\t\t}\n\n\t\t\t\tJoin.On on = new Join.On();\n\t\t\t\ton.setKeyAndType(j.getJoinType(), j.getTable(), originKey);\n\t\t\t\tif (StringUtil.isName(on.getKey()) == false) {\n\t\t\t\t\tthrow new IllegalArgumentException(apijson.JSONRequest.KEY_JOIN + \":value 中 value 的 key@ 中 key 值 \" + on.getKey() + \" 不合法！必须满足英文单词变量名格式！\");\n\t\t\t\t}\n\n\t\t\t\ton.setOriginKey(originKey);\n\t\t\t\ton.setOriginValue((String) refEntry.getValue());\n\t\t\t\ton.setTargetTableKey(targetTableKey);\n\t\t\t\ton.setTargetTable(targetTable);\n\t\t\t\ton.setTargetAlias(targetAlias);\n\t\t\t\ton.setTargetKey(targetKey);\n\n\t\t\t\tonList.add(on);\n\t\t\t}\n\n\t\t\tj.setOnList(onList);\n\n\t\t\tjoinList.add(j);\n\t\t\t//\t\t\tonList.add(table + \".\" + key + \" = \" + targetTable + \".\" + targetKey); // ON User.id = Moment.userId\n\n\t\t\t// 保证和 SQLExcecutor 缓存的 Config 里 where 顺序一致，生成的 SQL 也就一致 <<<<<<<<<\n\t\t\t// AbstractSQLConfig.newSQLConfig 中强制把 id, id{}, userId, userId{} 放到了最前面\t\ttableObj.put(key, tableObj.remove(key));\n\n\t\t\tif (refObj.size() != tableObj.size()) { // 把 key 强制放最前，AbstractSQLExcecutor 中 config.putWhere 也是放尽可能最前\n\t\t\t\trefObj.putAll(tableObj);\n\t\t\t\tparentPathObj.put(tableKey, refObj);\n\n//\t\t\t\ttableObj.clear();\n//\t\t\t\ttableObj.putAll(refObj);\n\t\t\t}\n\t\t\t// 保证和 SQLExcecutor 缓存的 Config 里 where 顺序一致，生成的 SQL 也就一致 >>>>>>>>>\n\t\t}\n\n\t\t//拼接多个 SQLConfig 的SQL语句，然后执行，再把结果分别缓存(Moment, User等)到 SQLExecutor 的 cacheMap\n\t\t//\t\tAbstractSQLConfig config0 = null;\n\t\t//\t\tString sql = \"SELECT \" + config0.getColumnString() + \" FROM \" + config0.getTable() + \" INNER JOIN \" + targetTable + \" ON \"\n\t\t//\t\t\t\t+ onList.get(0) + config0.getGroupString() + config0.getHavingString() + config0.getOrderString();\n\n\t\treturn joinList;\n\t}\n\n\t/**根据路径取值\n\t * @param parent\n\t * @param pathKeys\n\t * @return\n\t */\n\tpublic static V getValue(Object parent, String[] pathKeys) {\n\t\tint len = parent == null || pathKeys == null ? 0 : pathKeys.length;\n\t\tif (len <= 0) {\n\t\t\tLog.w(TAG, \"getChild parent == null || pathKeys == null || pathKeys.length <= 0 >> return parent;\");\n\t\t\treturn (V) parent;\n\t\t}\n\n\t\t// 逐层到达child的直接容器JSONObject parent\n\t\tObject v = parent;\n\t\tfor (int i = 0; i < len; i++) { // 一步一步到达指定位置\n\t\t\tif (v == null) { // 不存在或路径错误(中间的key对应value不是JSONObject)\n\t\t\t\tbreak;\n\t\t\t}\n\n\t\t\tString k = getDecodedKey(pathKeys[i]);\n\t\t\ttry {\n\t\t\t\tv = getFromObjOrArr(v, k);\n\t\t\t} catch (Throwable e) {\n\t\t\t\tif (IS_PRINT_BIG_LOG) {\n\t\t\t\t\tLog.e(TAG, \"getFromObjOrArr failed\", e);\n\t\t\t\t}\n\t\t\t\tv = null;\n\t\t\t}\n\t\t}\n\n\t\treturn (V) v;\n\t}\n\n\n\t/**获取被依赖引用的key的路径, 实时替换[] -> []/i\n\t * @param parentPath\n\t * @param valuePath\n\t * @return\n\t */\n\tpublic static String getValuePath(String parentPath, String valuePath) {\n\t\tif (valuePath.startsWith(\"/\")) {\n\t\t\tvaluePath = getAbsPath(parentPath, valuePath);\n\t\t} else {//处理[] -> []/i\n\t\t\tvaluePath = replaceArrayChildPath(parentPath, valuePath);\n\t\t}\n\t\treturn valuePath;\n\t}\n\n\t/**获取绝对路径\n\t * @param path\n\t * @param name\n\t * @return\n\t */\n\tpublic static String getAbsPath(String path, String name) {\n\t\tLog.i(TAG, \"getPath path = \" + path + \"; name = \" + name + \" <<<<<<<<<<<<<\");\n\t\tpath = StringUtil.get(path);\n\t\tname = StringUtil.get(name);\n\t\tif (StringUtil.isNotEmpty(path, false)) {\n\t\t\tif (StringUtil.isNotEmpty(name, false)) {\n\t\t\t\tpath += ((name.startsWith(\"/\") ? \"\" : \"/\") + name);\n\t\t\t}\n\t\t} else {\n\t\t\tpath = name;\n\t\t}\n\t\tif (path.startsWith(\"/\")) {\n\t\t\tpath = path.substring(1);\n\t\t}\n\t\tLog.i(TAG, \"getPath return \" + path + \" >>>>>>>>>>>>>>>>\");\n\t\treturn path;\n\t}\n\n\t/**替换[] -> []/i\n\t * 不能写在getAbsPath里，因为name不一定是依赖路径\n\t * @param parentPath\n\t * @param valuePath\n\t * @return\n\t */\n\tpublic static String replaceArrayChildPath(String parentPath, String valuePath) {\n\t\tString[] ps = StringUtil.split(parentPath, \"]/\");//\"[]/\");\n\t\tif (ps != null && ps.length > 1) {\n\t\t\tString[] vs = StringUtil.split(valuePath, \"]/\");\n\n\t\t\tif (vs != null && vs.length > 0) {\n\t\t\t\tString pos;\n\t\t\t\tfor (int i = 0; i < ps.length - 1; i++) {\n\t\t\t\t\tif (ps[i] == null || ps[i].equals(vs[i]) == false) {//允许\"\"？\n\t\t\t\t\t\tbreak;\n\t\t\t\t\t}\n\n\t\t\t\t\tpos = ps[i+1].contains(\"/\") == false ? ps[i+1]\n\t\t\t\t\t\t\t: ps[i+1].substring(0, ps[i+1].indexOf(\"/\"));\n\t\t\t\t\tif (\n\t\t\t\t\t\t\t//StringUtil.isNumer(pos) &&\n\t\t\t\t\t\t\tvs[i+1].startsWith(pos + \"/\") == false) {\n\t\t\t\t\t\tvs[i+1] = pos + \"/\" + vs[i+1];\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t\treturn StringUtil.get(vs, \"]/\");\n\t\t\t}\n\t\t}\n\t\treturn valuePath;\n\t}\n\n\t//依赖引用关系 <<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<\n\n\t/**将已获取完成的object的内容替换requestObject里对应的值\n\t * @param path object的路径\n\t * @param result 需要被关联的object\n\t */\n\t@Override\n\tpublic void putQueryResult(String path, Object result) {\n\t\tLog.i(TAG, \"\\n putQueryResult valuePath = \" + path + \"; result = \" + result + \"\\n <<<<<<<<<<<<<<<<<<<<<<<\");\n\t\t//\t\tif (queryResultMap.containsKey(valuePath)) {//只保存被关联的value\n\t\tLog.d(TAG, \"putQueryResult queryResultMap.containsKey(valuePath) >> queryResultMap.put(path, result);\");\n\t\tqueryResultMap.put(path, result);\n\t\t//\t\t}\n\t}\n\t//CS304 Issue link: https://github.com/Tencent/APIJSON/issues/48\n\t/**根据路径获取值\n\t * @param valuePath -the path need to get value\n\t * @return parent == null ? valuePath : parent.get(keys[keys.length - 1])\n\t *

use entrySet+getValue() to replace keySet+get() to enhance efficiency

\n\t */\n\t@Override\n\tpublic Object getValueByPath(String valuePath) {\n\t\tLog.i(TAG, \"<<<<<<<<<<<<<<< \\n getValueByPath valuePath = \" + valuePath + \"\\n <<<<<<<<<<<<<<<<<<\");\n\t\tif (StringUtil.isEmpty(valuePath, true)) {\n\t\t\tLog.e(TAG, \"getValueByPath StringUtil.isNotEmpty(valuePath, true) == false >> return null;\");\n\t\t\treturn null;\n\t\t}\n\t\tObject target = queryResultMap.get(valuePath);\n\t\tif (target != null) {\n\t\t\treturn target;\n\t\t}\n\n\t\t//取出key被valuePath包含的result，再从里面获取key对应的value\n\t\tObject parent = null;\n\t\tString[] keys = null;\n\t\tfor (Entry entry : queryResultMap.entrySet()){\n\t\t\tString path = entry.getKey();\n\t\t\tif (valuePath.startsWith(path + \"/\")) {\n\t\t\t\ttry {\n\t\t\t\t\tparent = entry.getValue();\n\t\t\t\t} catch (Exception e) {\n\t\t\t\t\tLog.e(TAG, \"getValueByPath try { parent = (Map) queryResultMap.get(path); } catch { \"\n\t\t\t\t\t\t\t+ \"\\n parent not instanceof Map!\");\n\t\t\t\t\tparent = null;\n\t\t\t\t}\n\t\t\t\tif (parent != null) {\n\t\t\t\t\tkeys = StringUtil.splitPath(valuePath.substring(path.length()));\n\t\t\t\t}\n\t\t\t\tbreak;\n\t\t\t}\n\t\t}\n\n\t\ttarget = getValue(parent, keys); // 逐层到达targetKey的直接容器JSONObject parent\n\t\tif (target == null) { //从requestObject中取值\n\t\t\ttarget = getValue(requestObject, StringUtil.splitPath(valuePath));\n\t\t}\n\n\t\tLog.i(TAG, \"getValueByPath >> getValue >> return target = \" + target);\n\t\treturn target;\n\t}\n\n\t/**解码 引用赋值 路径中的 key，支持把 URL encode 后的值，转为 decode 后的原始值，例如 %2Fuser%2Flist -> /user/list ; %7B%7D -> []\n\t * @param key\n\t * @return\n\t */\n\tpublic static String getDecodedKey(String key) {\n\t\ttry {\n\t\t\treturn URLDecoder.decode(key, StringUtil.UTF_8);\n\t\t} catch (Throwable e) {\n\t\t\treturn key;\n\t\t}\n\t}\n\n\t//依赖引用关系 >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>\n\n\n\tpublic static final String KEY_CONFIG = \"config\";\n\n\tpublic static final String KEY_SQL = \"sql\";\n\n\tprotected Map> arrayMainCacheMap = new HashMap<>();\n\tpublic void putArrayMainCache(String arrayPath, List mainTableDataList) {\n\t\tarrayMainCacheMap.put(arrayPath, mainTableDataList);\n\t}\n\tpublic List getArrayMainCache(String arrayPath) {\n\t\treturn arrayMainCacheMap.get(arrayPath);\n\t}\n\tpublic M getArrayMainCacheItem(String arrayPath, int position) {\n\t\tList list = getArrayMainCache(arrayPath);\n\t\treturn list == null || position >= list.size() ? null : list.get(position);\n\t}\n\n\n\n\t/**执行 SQL 并返回 Map\n\t * @param config\n\t * @return\n\t * @throws Exception\n\t */\n\t@Override\n\tpublic M executeSQL(SQLConfig config, boolean isSubquery) throws Exception {\n\t\tif (config == null) {\n\t\t\tLog.d(TAG, \"executeSQL config == null >> return null;\");\n\t\t\treturn null;\n\t\t}\n\n\t\tconfig.setParser(this);\n\t\tconfig.setVersion(getVersion());\n\t\tconfig.setTag(getTag());\n\n\t\tif (isSubquery) {\n\t\t\tM sqlObj = JSON.createJSONObject();\n\t\t\tsqlObj.put(KEY_CONFIG, config);\n\t\t\treturn sqlObj;//容易丢失信息 JSON.parseObject(config);\n\t\t}\n\n\t\ttry {\n\t\t\tM result;\n\n\t\t\tboolean explain = config.isExplain();\n\t\t\tif (explain) {\n\t\t\t\t//如果先执行 explain，则 execute 会死循环，所以只能先执行非 explain\n\t\t\t\tconfig.setExplain(false); //对下面 config.getSQL(false); 生效\n\t\t\t\tM res = getSQLExecutor().execute(config, false);\n\n\t\t\t\t//如果是查询方法，才能执行explain\n\t\t\t\tif (RequestMethod.isQueryMethod(config.getMethod()) && config.isElasticsearch() == false){\n\t\t\t\t\tconfig.setExplain(explain);\n\t\t\t\t\tMap explainResult = config.isMain() && config.getPosition() != 0 ? null : getSQLExecutor().execute(config, false);\n\n\t\t\t\t\tif (explainResult == null) {\n\t\t\t\t\t\tresult = res;\n\t\t\t\t\t}\n\t\t\t\t\telse {\n\t\t\t\t\t\tresult = JSON.createJSONObject();\n\t\t\t\t\t\tresult.put(KEY_EXPLAIN, explainResult);\n\t\t\t\t\t\tresult.putAll(res);\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t\telse {//如果是更新请求，不执行explain，但可以返回sql\n\t\t\t\t\tresult = JSON.createJSONObject();\n\t\t\t\t\tresult.put(KEY_SQL, config.gainSQL(false));\n\t\t\t\t\tresult.putAll(res);\n\t\t\t\t}\n\t\t\t}\n\t\t\telse {\n\t\t\t\tresult = getSQLExecutor().execute(config, false);\n\t\t\t\t// FIXME 改为直接在 sqlExecutor 内加好，最后 Parser 取结果，可以解决并发执行导致内部计算出错\n//\t\t\t\texecutedSQLDuration += sqlExecutor.getExecutedSQLDuration() + sqlExecutor.getSqlResultDuration();\n\t\t\t}\n\n\t\t\treturn result;\n\t\t}\n\t\tcatch (Exception e) {\n\t\t\tthrow CommonException.wrap(e, config);\n\t\t}\n\t\tfinally {\n\t\t\tif (config.getPosition() == 0 && config.limitSQLCount()) {\n\t\t\t\tint maxSQLCount = getMaxSQLCount();\n\t\t\t\tint sqlCount = getSQLExecutor().getExecutedSQLCount();\n\t\t\t\tLog.d(TAG, \"<<<<<<<<<<<<<<<<<<<<<<<<<<<<<< \\n\\n\\n 已执行 \" + sqlCount + \"/\" + maxSQLCount + \" 条 SQL \\n\\n\\n >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>\");\n\t\t\t\tif (sqlCount > maxSQLCount) {\n\t\t\t\t\tthrow new IllegalArgumentException(\"截至 \" + config.getTable() + \" 已执行 \" + sqlCount + \" 条 SQL，数量已超限，必须在 0-\" + maxSQLCount + \" 内 !\");\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t}\n\n\n\t//事务处理 <<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<\n\tprivate int transactionIsolation = Connection.TRANSACTION_NONE;\n\t@Override\n\tpublic int getTransactionIsolation() {\n\t\treturn transactionIsolation;\n\t}\n\t@Override\n\tpublic void setTransactionIsolation(int transactionIsolation) {\n\t\tthis.transactionIsolation = transactionIsolation;\n\t}\n\n\t@Override\n\tpublic void begin(int transactionIsolation) {\n\t\tLog.d(\"\\n\\n\" + TAG, \"<<<<<<<<<<<<<<<<<<<<<<< begin transactionIsolation = \" + transactionIsolation + \" >>>>>>>>>>>>>>>>>>>>>>> \\n\\n\");\n\t\tgetSQLExecutor().setTransactionIsolation(transactionIsolation); // 不知道 connection 什么时候创建，不能在这里准确控制，getSqlExecutor().begin(transactionIsolation);\n\t}\n\t@Override\n\tpublic void rollback() throws SQLException {\n\t\tLog.d(\"\\n\\n\" + TAG, \"<<<<<<<<<<<<<<<<<<<<<<< rollback >>>>>>>>>>>>>>>>>>>>>>> \\n\\n\");\n\t\tgetSQLExecutor().rollback();\n\t}\n\t@Override\n\tpublic void rollback(Savepoint savepoint) throws SQLException {\n\t\tLog.d(\"\\n\\n\" + TAG, \"<<<<<<<<<<<<<<<<<<<<<<< rollback savepoint \" + (savepoint == null ? \"\" : \"!\") + \"= null >>>>>>>>>>>>>>>>>>>>>>> \\n\\n\");\n\t\tgetSQLExecutor().rollback(savepoint);\n\t}\n\t@Override\n\tpublic void commit() throws SQLException {\n\t\tLog.d(\"\\n\\n\" + TAG, \"<<<<<<<<<<<<<<<<<<<<<<< commit >>>>>>>>>>>>>>>>>>>>>>> \\n\\n\");\n\t\tgetSQLExecutor().commit();\n\t}\n\t@Override\n\tpublic void close() {\n\t\tLog.d(\"\\n\\n\" + TAG, \"<<<<<<<<<<<<<<<<<<<<<<< close >>>>>>>>>>>>>>>>>>>>>>> \\n\\n\");\n\t\tgetSQLExecutor().close();\n\t}\n\n\t/**开始事务\n\t */\n\tprotected void onBegin() {\n\t\t//\t\tLog.d(TAG, \"onBegin >>\");\n\t\tif (RequestMethod.isQueryMethod(requestMethod)) {\n\t\t\treturn;\n\t\t}\n\n\t\tbegin(getTransactionIsolation());\n\t}\n\t/**提交事务\n\t */\n\tprotected void onCommit() {\n\t\t//\t\tLog.d(TAG, \"onCommit >>\");\n\t\t// this.sqlExecutor.getTransactionIsolation() 只有json第一次执行才会设置, get请求=0\n\t\tif (RequestMethod.isQueryMethod(requestMethod)\n\t\t\t\t&& getSQLExecutor().getTransactionIsolation() == Connection.TRANSACTION_NONE) {\n\t\t\treturn;\n\t\t}\n\n\t\ttry {\n\t\t\tcommit();\n\t\t}\n\t\tcatch (SQLException e) {\n\t\t\tLog.e(TAG, \"onCommit failed\", e);\n\t\t}\n\t}\n\t/**回滚事务\n\t */\n\tprotected void onRollback() {\n\t\t//\t\tLog.d(TAG, \"onRollback >>\");\n\t\tif (RequestMethod.isQueryMethod(requestMethod)) {\n\t\t\treturn;\n\t\t}\n\n\t\ttry {\n\t\t\trollback();\n\t\t}\n\t\tcatch (SQLException e1) {\n\t\t\tLog.e(TAG, \"onRollback failed\", e1);\n\t\t\ttry {\n\t\t\t\trollback(null);\n\t\t\t}\n\t\t\tcatch (SQLException e2) {\n\t\t\t\tLog.e(TAG, \"onRollback with null failed\", e2);\n\t\t\t}\n\t\t}\n\t}\n\n\t//事务处理 >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>\n\n\n\tprotected void onClose() {\n\t\t//\t\tLog.d(TAG, \"onClose >>\");\n\n\t\tclose();\n\t\tverifier = null;\n\t\tsqlExecutor = null;\n\t\tqueryResultMap.clear();\n\t\tqueryResultMap = null;\n\t}\n\n\tprivate void setOpMethod(Map request, ObjectParser op, String key) {\n\t\tString _method = key == null ? null : getString(request, KEY_METHOD);\n\t\tif (_method != null) {\n\t\t\tRequestMethod method = RequestMethod.valueOf(_method); // 必须精准匹配，避免缓存命中率低\n\t\t\tthis.setMethod(method);\n\t\t\top.setMethod(method);\n\t\t}\n\t}\n\n\tprotected M getRequestStructure(RequestMethod method, String tag, int version) throws Exception {\n\t\t// 获取指定的JSON结构 <<<<<<<<<<<<\n\t\tM object = null;\n\t\tString error = \"\";\n\t\ttry {\n\t\t\tobject = getStructure(\"Request\", method.name(), tag, version);\n\t\t} catch (Exception e) {\n\t\t\terror = e.getMessage();\n\t\t}\n\t\tif (object == null) { // empty表示随意操作 || object.isEmpty()) {\n\t\t\tthrow new UnsupportedOperationException(\"找不到 version: \" + version + \", method: \" + method.name() + \", tag: \" + tag + \" 对应的 structure ！\" + \"非开放请求必须是后端 Request 表中校验规则允许的操作！\\n \" + error + \"\\n如果需要则在 Request 表中新增配置！\");\n\t\t}\n\n\t\treturn object;\n\t}\n\n\tpublic static final Map KEY_METHOD_ENUM_MAP;\n\tstatic {\n\t\tKEY_METHOD_ENUM_MAP = new LinkedHashMap<>();\n\t\tKEY_METHOD_ENUM_MAP.put(KEY_GET, RequestMethod.GET);\n\t\tKEY_METHOD_ENUM_MAP.put(KEY_GETS, RequestMethod.GETS);\n\t\tKEY_METHOD_ENUM_MAP.put(KEY_HEAD, RequestMethod.HEAD);\n\t\tKEY_METHOD_ENUM_MAP.put(KEY_HEADS, RequestMethod.HEADS);\n\t\tKEY_METHOD_ENUM_MAP.put(KEY_POST, RequestMethod.POST);\n\t\tKEY_METHOD_ENUM_MAP.put(KEY_PUT, RequestMethod.PUT);\n\t\tKEY_METHOD_ENUM_MAP.put(KEY_DELETE, RequestMethod.DELETE);\n\t}\n\n\tprotected M batchVerify(RequestMethod method, String tag, int version, String name, @NotNull M request, int maxUpdateCount, SQLCreator creator) throws Exception {\n\t\tM correctRequest = JSON.createJSONObject();\n\t\tList removeTmpKeys = new ArrayList<>(); // 请求json里面的临时变量,不需要带入后面的业务中,比如 @post、@get等\n\n\t\tSet reqSet = request == null ? null : request.keySet();\n\t\tif (reqSet == null || request.isEmpty()) {\n\t\t\tthrow new IllegalArgumentException(\"JSON 对象格式不正确 ！正确示例例如 \\\"User\\\": {}\");\n\t\t}\n\n\t\tfor (String key : reqSet) {\n\t\t\t// key 重复直接抛错(xxx:alias, xxx:alias[])\n\t\t\tif (correctRequest.containsKey(key) || correctRequest.containsKey(key + KEY_ARRAY)) {\n\t\t\t\tthrow new IllegalArgumentException(\"对象名重复,请添加别名区分 ! 重复对象名为: \" + key);\n\t\t\t}\n\n\t\t\tboolean isPost = KEY_POST.equals(key);\n\t\t\t// @post、@get 等 RequestMethod\n\t\t\ttry {\n\t\t\t\tRequestMethod keyMethod = isPost ? RequestMethod.POST : KEY_METHOD_ENUM_MAP.get(key);\n\t\t\t\tif (keyMethod != null) {\n\t\t\t\t\t// 如果不匹配,异常不处理即可\n\t\t\t\t\tremoveTmpKeys.add(key);\n\n\t\t\t\t\tObject val = request.get(key);\n\t\t\t\t\tMap obj = val instanceof Map ? JSON.get(request, key) : null;\n\t\t\t\t\tif (obj == null) {\n\t\t\t\t\t\tif (val instanceof String) {\n\t\t\t\t\t\t\tString[] tbls = StringUtil.split((String) val);\n\t\t\t\t\t\t\tif (tbls != null && tbls.length > 0) {\n\t\t\t\t\t\t\t\tobj = new LinkedHashMap();\n\t\t\t\t\t\t\t\tfor (int i = 0; i < tbls.length; i++) {\n\t\t\t\t\t\t\t\t\tString tbl = tbls[i];\n\t\t\t\t\t\t\t\t\tif (obj.containsKey(tbl)) {\n\t\t\t\t\t\t\t\t\t\tthrow new ConflictException(key + \": value 中 \" + tbl + \" 已经存在，不能重复！\");\n\t\t\t\t\t\t\t\t\t}\n\n\t\t\t\t\t\t\t\t\tobj.put(tbl, isPost && isTableArray(tbl)\n\t\t\t\t\t\t\t\t\t\t\t? tbl.substring(0, tbl.length() - 2) + \":[]\" : \"\");\n\t\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t}\n\t\t\t\t\t\telse {\n\t\t\t\t\t\t\tthrow new IllegalArgumentException(key + \": value 中 value 类型错误，只能是 String 或 Map {} ！\");\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\n\t\t\t\t\tSet> set = obj == null ? new HashSet<>() : obj.entrySet();\n\n\t\t\t\t\tfor (Entry objEntry : set) {\n\t\t\t\t\t\tString objKey = objEntry == null ? null : objEntry.getKey();\n\t\t\t\t\t\tif (objKey == null) {\n\t\t\t\t\t\t\tcontinue;\n\t\t\t\t\t\t}\n\n\t\t\t\t\t\tMap objAttrMap = new HashMap<>();\n\t\t\t\t\t\tobjAttrMap.put(KEY_METHOD, keyMethod);\n\t\t\t\t\t\tkeyObjectAttributesMap.put(objKey, objAttrMap);\n\n\t\t\t\t\t\tObject objVal = objEntry.getValue();\n\t\t\t\t\t\tMap objAttrJson = objVal instanceof Map ? JSON.getMap(obj, objKey) : null;\n\t\t\t\t\t\tif (objAttrJson == null) {\n\t\t\t\t\t\t\tif (objVal instanceof String) {\n\t\t\t\t\t\t\t\tobjAttrMap.put(KEY_TAG, \"\".equals(objVal) ? objKey : objVal);\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\telse {\n\t\t\t\t\t\t\t\tthrow new IllegalArgumentException(key + \": { \" + objKey + \": value 中 value 类型错误，只能是 String 或 Map {} ！\");\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t}\n\t\t\t\t\t\telse {\n\t\t\t\t\t\t\tSet> objSet = objAttrJson.entrySet();\n\n\t\t\t\t\t\t\tboolean hasTag = false;\n\t\t\t\t\t\t\tfor (Entry entry : objSet) {\n\t\t\t\t\t\t\t\tString objAttrKey = entry == null ? null : entry.getKey();\n\t\t\t\t\t\t\t\tif (objAttrKey == null) {\n\t\t\t\t\t\t\t\t\tcontinue;\n\t\t\t\t\t\t\t\t}\n\n\t\t\t\t\t\t\t\tswitch (objAttrKey) {\n\t\t\t\t\t\t\t\t\tcase KEY_DATASOURCE:\n\t\t\t\t\t\t\t\t\tcase KEY_SCHEMA:\n\t\t\t\t\t\t\t\t\tcase KEY_DATABASE:\n\t\t\t\t\t\t\t\t\tcase KEY_VERSION:\n\t\t\t\t\t\t\t\t\tcase KEY_ROLE:\n\t\t\t\t\t\t\t\t\t\tobjAttrMap.put(objAttrKey, entry.getValue());\n\t\t\t\t\t\t\t\t\t\tbreak;\n\t\t\t\t\t\t\t\t\tcase KEY_TAG:\n\t\t\t\t\t\t\t\t\t\thasTag = true;\n\t\t\t\t\t\t\t\t\t\tobjAttrMap.put(objAttrKey, entry.getValue());\n\t\t\t\t\t\t\t\t\t\tbreak;\n\t\t\t\t\t\t\t\t\tdefault:\n\t\t\t\t\t\t\t\t\t\tbreak;\n\t\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\t}\n\n\t\t\t\t\t\t\tif (hasTag == false) {\n\t\t\t\t\t\t\t\tobjAttrMap.put(KEY_TAG, isPost && isTableArray(objKey)\n\t\t\t\t\t\t\t\t\t\t? objKey.substring(0, objKey.length() - 2) + \":[]\" : objKey);\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\t\t\t\t\tcontinue;\n\t\t\t\t}\n\n\t\t\t\t// 1、非crud,对于没有显式声明操作方法的，直接用 URL(/get, /post 等) 对应的默认操作方法\n\t\t\t\t// 2、crud, 没有声明就用 GET\n\t\t\t\t// 3、兼容 sql@ Map,设置 GET方法\n\t\t\t\t// 将method 设置到每个object, op执行会解析\n\t\t\t\tObject obj = request.get(key);\n\n\t\t\t\tif (obj instanceof Map) {\n\t\t\t\t\tMap attrMap = keyObjectAttributesMap.get(key);\n\n\t\t\t\t\tif (attrMap == null) {\n\t\t\t\t\t\t// 数组会解析为对象进行校验,做一下兼容\n\t\t\t\t\t\tif (keyObjectAttributesMap.get(key + KEY_ARRAY) == null) {\n\t\t\t\t\t\t\tif (method == RequestMethod.CRUD || key.endsWith(\"@\")) {\n\t\t\t\t\t\t\t\t((Map) obj).put(KEY_METHOD, GET);\n\t\t\t\t\t\t\t\tMap objAttrMap = new HashMap<>();\n\t\t\t\t\t\t\t\tobjAttrMap.put(KEY_METHOD, GET);\n\t\t\t\t\t\t\t\tkeyObjectAttributesMap.put(key, objAttrMap);\n\t\t\t\t\t\t\t} else {\n\t\t\t\t\t\t\t\t((Map) obj).put(KEY_METHOD, method);\n\t\t\t\t\t\t\t\tMap objAttrMap = new HashMap<>();\n\t\t\t\t\t\t\t\tobjAttrMap.put(KEY_METHOD, method);\n\t\t\t\t\t\t\t\tkeyObjectAttributesMap.put(key, objAttrMap);\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t} else {\n\t\t\t\t\t\t\tsetRequestAttribute(key, true, KEY_METHOD, request);\n\t\t\t\t\t\t\tsetRequestAttribute(key, true, KEY_DATASOURCE, request);\n\t\t\t\t\t\t\tsetRequestAttribute(key, true, KEY_SCHEMA, request);\n\t\t\t\t\t\t\tsetRequestAttribute(key, true, KEY_DATABASE, request);\n\t\t\t\t\t\t\tsetRequestAttribute(key, true, KEY_VERSION, request);\n\t\t\t\t\t\t\tsetRequestAttribute(key, true, KEY_ROLE, request);\n\t\t\t\t\t\t}\n\t\t\t\t\t} else {\n\t\t\t\t\t\tsetRequestAttribute(key, false, KEY_METHOD, request);\n\t\t\t\t\t\tsetRequestAttribute(key, false, KEY_DATASOURCE, request);\n\t\t\t\t\t\tsetRequestAttribute(key, false, KEY_SCHEMA, request);\n\t\t\t\t\t\tsetRequestAttribute(key, false, KEY_DATABASE, request);\n\t\t\t\t\t\tsetRequestAttribute(key, false, KEY_VERSION, request);\n\t\t\t\t\t\tsetRequestAttribute(key, false, KEY_ROLE, request);\n\t\t\t\t\t}\n\t\t\t\t}\n\n\t\t\t\tif (key.startsWith(\"@\") || key.endsWith(\"@\")) {\n\t\t\t\t\tcorrectRequest.put(key, obj);\n\t\t\t\t\tcontinue;\n\t\t\t\t}\n\n\t\t\t\tif (obj instanceof Map || obj instanceof List) {\n\t\t\t\t\tRequestMethod _method;\n\t\t\t\t\tif (obj instanceof Map) {\n\t\t\t\t\t\tMap tblObj = JSON.getMap(request, key);\n\t\t\t\t\t\tString mn = tblObj == null ? null : getString(tblObj, KEY_METHOD);\n\t\t\t\t\t\t_method = mn == null ? null : RequestMethod.valueOf(mn);\n\t\t\t\t\t\tString combine = _method == null ? null : getString(tblObj, KEY_COMBINE);\n\t\t\t\t\t\tif (combine != null && RequestMethod.isPublicMethod(_method) == false) {\n\t\t\t\t\t\t\tthrow new IllegalArgumentException(key + \":{} 里的 @combine:value 不合法！开放请求 GET、HEAD 才允许传 @combine:value !\");\n\t\t\t\t\t\t}\n\t\t\t\t\t} else {\n\t\t\t\t\t\tMap attrMap = keyObjectAttributesMap.get(key);\n\n\t\t\t\t\t\tif (attrMap == null) {\n\t\t\t\t\t\t\tif (method == RequestMethod.CRUD) {\n\t\t\t\t\t\t\t\t_method = GET;\n\t\t\t\t\t\t\t\tMap objAttrMap = new HashMap<>();\n\t\t\t\t\t\t\t\tobjAttrMap.put(KEY_METHOD, GET);\n\t\t\t\t\t\t\t\tkeyObjectAttributesMap.put(key, objAttrMap);\n\t\t\t\t\t\t\t} else {\n\t\t\t\t\t\t\t\t_method = method;\n\t\t\t\t\t\t\t\tMap objAttrMap = new HashMap<>();\n\t\t\t\t\t\t\t\tobjAttrMap.put(KEY_METHOD, method);\n\t\t\t\t\t\t\t\tkeyObjectAttributesMap.put(key, objAttrMap);\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t} else {\n\t\t\t\t\t\t\t_method = (RequestMethod) attrMap.get(KEY_METHOD);\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\n\t\t\t\t\t// 非 CRUD 方法，都只能和 URL method 完全一致，避免意料之外的安全风险。\n\t\t\t\t\tif (method != RequestMethod.CRUD && _method != method) {\n\t\t\t\t\t\tthrow new IllegalArgumentException(\"不支持在 \" + method + \" 中 \" + _method + \" ！\");\n\t\t\t\t\t}\n\n\t\t\t\t\t// get请求不校验\n\t\t\t\t\tif (RequestMethod.isPublicMethod(_method)) {\n\t\t\t\t\t\tcorrectRequest.put(key, obj);\n\t\t\t\t\t\tcontinue;\n\t\t\t\t\t}\n\n\t\t\t\t\tif (tag != null && ! tag.contains(\":\")) {\n\t\t\t\t\t\tM object = getRequestStructure(_method, tag, version);\n\t\t\t\t\t\tM ret = objectVerify(_method, tag, version, name, request, maxUpdateCount, creator, object);\n\t\t\t\t\t\tcorrectRequest.putAll(ret);\n\t\t\t\t\t\tbreak;\n\t\t\t\t\t}\n\n\t\t\t\t\tString _tag = buildTag(request, key, method, tag);\n\t\t\t\t\tM object = getRequestStructure(_method, _tag, version);\n\t\t\t\t\tif (method == RequestMethod.CRUD && StringUtil.isEmpty(tag, true)) {\n\t\t\t\t\t\tM requestItem = JSON.createJSONObject();\n\t\t\t\t\t\trequestItem.put(key, obj);\n\t\t\t\t\t\tMap ret = objectVerify(_method, _tag, version, name, requestItem, maxUpdateCount, creator, object);\n\t\t\t\t\t\tcorrectRequest.put(key, ret.get(key));\n\t\t\t\t\t} else {\n\t\t\t\t\t\treturn objectVerify(_method, _tag, version, name, request, maxUpdateCount, creator, object);\n\t\t\t\t\t}\n\t\t\t\t} else {\n\t\t\t\t\tcorrectRequest.put(key, obj);\n\t\t\t\t}\n\t\t\t} catch (Exception e) {\n\t\t\t\tLog.e(TAG, \"parseCorrectRequest failed\", e);\n\t\t\t\tthrow e;\n\t\t\t}\n\t\t}\n\n\t\t// 这里是 requestObject ref request 的引用, 删除不需要的临时变量\n\t\tfor (String removeKey : removeTmpKeys) {\n\t\t\trequest.remove(removeKey);\n\t\t}\n\n\t\treturn correctRequest;\n\t}\n\n\tpublic static > E getEnum(final Class enumClass, final String enumName, final E defaultEnum) {\n if (enumName == null) {\n return defaultEnum;\n }\n try {\n return Enum.valueOf(enumClass, enumName);\n } catch (final IllegalArgumentException ex) {\n return defaultEnum;\n }\n }\n\n\tprotected void setRequestAttribute(String key, boolean isArray, String attrKey, @NotNull Map request) {\n\t\tMap attrMap = keyObjectAttributesMap.get(isArray ? key + KEY_ARRAY : key);\n\t\tObject attrVal = attrMap == null ? null : attrMap.get(attrKey);\n\t\tMap obj = attrVal == null ? null : JSON.get(request, key);\n\n\t\tif (obj != null && obj.get(attrKey) == null) {\n\t\t\t// 如果对象内部已经包含该属性,不覆盖\n\t\t\tobj.put(attrKey, attrVal);\n\t\t}\n\t}\n\n\tprotected String buildTag(Map request, String key, RequestMethod method, String tag) {\n\t\tif (method == RequestMethod.CRUD) {\n\t\t\tMap attrMap = keyObjectAttributesMap.get(key);\n\t\t\tObject _tag = attrMap == null ? null : attrMap.get(KEY_TAG);\n\t\t\treturn _tag != null ? _tag.toString() : StringUtil.isEmpty(tag) ? key : tag;\n\t\t} else {\n\t\t\tif (StringUtil.isEmpty(tag, true)) {\n\t\t\t\tthrow new IllegalArgumentException(\"请在最外层传 tag ！一般是 Table 名，例如 \\\"tag\\\": \\\"User\\\" \");\n\t\t\t}\n\t\t}\n\t\treturn tag;\n\t}\n\n\n\tprotected M objectVerify(RequestMethod method, String tag, int version, String name, @NotNull M request\n\t\t\t, int maxUpdateCount, SQLCreator creator, M object) throws Exception {\n\t\t// 获取指定的JSON结构 >>>>>>>>>>>>>>\n\t\tM target = wrapRequest(method, tag, object, true);\n\t\t// Map clone 浅拷贝没用，Structure.parse 会导致 structure 里面被清空，第二次从缓存里取到的就是 {}\n\t\treturn getVerifier().setParser(this).verifyRequest(method, name, target, request, maxUpdateCount, getGlobalDatabase(), getGlobalSchema());\n\t}\n\n\t/***\n\t * 兼容url crud, 获取真实method\n\t * @param method = crud\n\t * @param key\n\t * @return\n\t */\n\tpublic RequestMethod getRealMethod(RequestMethod method, String key, Object value) {\n\t\tif (method == CRUD && (value instanceof Map || value instanceof List)) {\n\t\t\tMap attrMap = keyObjectAttributesMap.get(key);\n\t\t\tObject _method = attrMap == null ? null : attrMap.get(KEY_METHOD);\n\t\t\tif (_method instanceof RequestMethod) {\n\t\t\t\treturn (RequestMethod) _method;\n\t\t\t}\n\t\t}\n\n\t\treturn method;\n\t}\n}\n" }, { "path": "APIJSONORM/src/main/java/apijson/orm/AbstractSQLConfig.java", "content": "/*Copyright (C) 2020 Tencent. All rights reserved.\n\nThis source code is licensed under the Apache License Version 2.0.*/\n\n\npackage apijson.orm;\n\nimport apijson.*;\nimport apijson.orm.Join.On;\nimport apijson.orm.exception.NotExistException;\nimport apijson.orm.exception.UnsupportedDataTypeException;\nimport apijson.orm.model.*;\n\nimport java.util.*;\nimport java.util.Map.Entry;\nimport java.util.regex.Pattern;\n\nimport static apijson.JSON.getBoolean;\nimport static apijson.JSON.getString;\nimport static apijson.JSONMap.*;\nimport static apijson.RequestMethod.*;\nimport static apijson.SQL.*;\n\n/**config sql for JSON Request\n * @author Lemon\n */\npublic abstract class AbstractSQLConfig, L extends List>\n\t\timplements SQLConfig {\n\tprivate static final String TAG = \"AbstractSQLConfig\";\n\n\t/**\n\t * 为 true 则兼容 5.0 之前 @having:\"toId>0;avg(id)<100000\" 默认 AND 连接，为 HAVING toId>0 AND avg(id)<100000；\n\t * 否则按 5.0+ 新版默认 OR 连接，为 HAVING toId>0 OR avg(id)<100000，使用 @having& 或 @having:{ @combine: null } 时才用 AND 连接\n\t */\n\tpublic static boolean IS_HAVING_DEFAULT_AND = false;\n\t/**\n\t * 为 true 则兼容 5.0 之前 @having:\"toId>0\" 这种不包含 SQL 函数的表达式；\n\t * 否则按 5.0+ 新版不允许，可以用 @having:\"(toId)>0\" 替代\n\t */\n\tpublic static boolean IS_HAVING_ALLOW_NOT_FUNCTION = false;\n\n\t/**\n\t * 开启 WITH AS 表达式(在支持这种语法的数据库及版本)来简化 SQL 和提升性能\n\t */\n\tpublic static boolean ENABLE_WITH_AS = false;\n\n\t/**\n\t * 对指定的方法，忽略空字符串，不作为 GET 条件，PUT 值等。可取值 new RequestMethod[]{ RequestMethod.GET, RequestMethod.POST ... }\n\t */\n\tpublic static List IGNORE_EMPTY_STRING_METHOD_LIST = null;\n\t/**\n\t * 对指定的方法，忽略空白字符串。即首尾 trim 去掉所有不可见字符后，仍然为空的，就忽略，不作为 GET 条件，PUT 值等。\n\t * 可取值 new RequestMethod[]{ RequestMethod.GET, RequestMethod.POST ... }\n\t */\n\tpublic static List IGNORE_BLANK_STRING_METHOD_LIST = null;\n\n\tpublic static String KEY_DELETED_KEY = \"deletedKey\";\n\tpublic static String KEY_DELETED_VALUE = \"deletedValue\";\n\tpublic static String KEY_NOT_DELETED_VALUE = \"notDeletedValue\";\n\n\tpublic static int MAX_HAVING_COUNT = 5;\n\tpublic static int MAX_WHERE_COUNT = 10;\n\tpublic static int MAX_COMBINE_DEPTH = 2;\n\tpublic static int MAX_COMBINE_COUNT = 5;\n\tpublic static int MAX_COMBINE_KEY_COUNT = 2;\n\tpublic static float MAX_COMBINE_RATIO = 1.0f;\n\tpublic static boolean ALLOW_MISSING_KEY_4_COMBINE = true;\n\n\tpublic static String DEFAULT_DATABASE = DATABASE_MYSQL;\n\tpublic static String DEFAULT_NAMESPACE = \"\"; // \"root\";\n\tpublic static String DEFAULT_CATALOG = \"\"; // PostgreSQL JDBC 必须在 URI 中传 \"\"postgres\";\n\tpublic static String DEFAULT_SCHEMA = \"sys\";\n\tpublic static String PREFIX_DISTINCT = \"DISTINCT \";\n\n\tpublic static Pattern PATTERN_SCHEMA;\n\t// * 和 / 不能同时出现，防止 /* */ 段注释！ # 和 -- 不能出现，防止行注释！ ; 不能出现，防止隔断SQL语句！空格不能出现，防止 CRUD,DROP,SHOW TABLES等语句！\n\tpublic static Pattern PATTERN_RANGE;\n\tpublic static Pattern PATTERN_FUNCTION;\n\n\t/**\n\t * 表 SCHEMA 映射\n\t */\n\tpublic static Map TABLE_SCHEMA_MAP;\n\n\t/**\n\t * 表名映射，隐藏真实表名，对安全要求很高的表可以这么做\n\t */\n\tpublic static Map TABLE_KEY_MAP;\n\t/**\n\t * 字段名映射，隐藏真实字段名，对安全要求很高的表可以这么做，另外可以配置 name_tag:(name,tag) 来实现多字段 IN，length_tag:length(tag) 来实现 SQL 函数复杂条件\n\t */\n\tpublic static Map COLUMN_KEY_MAP;\n\t/**\n\t * 允许批量增删改部分记录失败的表\n\t */\n\tpublic static Map ALLOW_PARTIAL_UPDATE_FAIL_TABLE_MAP;\n\tpublic static List CONFIG_TABLE_LIST;\n\tpublic static List DATABASE_LIST;\n\n\t// 自定义原始 SQL 片段 Map：当 substring 为 null 时忽略；当 substring 为 \"\" 时整个 value 是 raw SQL；其它情况则只是 substring 这段为 raw SQL\n\tpublic static Map RAW_MAP;\n\t// 允许调用的 SQL 函数：当 substring 为 null 时忽略；当 substring 为 \"\" 时整个 value 是 raw SQL；其它情况则只是 substring 这段为 raw SQL\n\tpublic static Map SQL_AGGREGATE_FUNCTION_MAP;\n\tpublic static Map SQL_FUNCTION_MAP;\n\n\tstatic { // 凡是 SQL 边界符、分隔符、注释符 都不允许，例如 ' \" ` ( ) ; # -- /**/ ，以免拼接 SQL 时被注入意外可执行指令\n\t\tPATTERN_SCHEMA = Pattern.compile(\"^[A-Za-z0-9_-]+$\");\n\t\tPATTERN_RANGE = Pattern.compile(\"^[0-9%,!=\\\\<\\\\>/\\\\.\\\\+\\\\-\\\\*\\\\^]+$\"); // ^[a-zA-Z0-9_*%!=<>(),\"]+$ 导致 exists(select*from(Comment)) 通过！\n\t\t// TODO 改成更好的正则，校验前面为单词，中间为操作符，后面为值\n\t\tPATTERN_FUNCTION = Pattern.compile(\"^[A-Za-z0-9%,:_@&~`!=\\\\<\\\\>\\\\|\\\\[\\\\]\\\\{\\\\} /\\\\.\\\\+\\\\-\\\\*\\\\^\\\\?\\\\(\\\\)\\\\$]+$\");\n\n\t\tTABLE_SCHEMA_MAP = new HashMap<>();\n\t\tTABLE_SCHEMA_MAP.put(Table.class.getSimpleName(), DEFAULT_SCHEMA);\n\t\tTABLE_SCHEMA_MAP.put(Column.class.getSimpleName(), DEFAULT_SCHEMA);\n\t\tTABLE_SCHEMA_MAP.put(PgClass.class.getSimpleName(), DEFAULT_SCHEMA);\n\t\tTABLE_SCHEMA_MAP.put(PgAttribute.class.getSimpleName(), DEFAULT_SCHEMA);\n\t\tTABLE_SCHEMA_MAP.put(SysTable.class.getSimpleName(), DEFAULT_SCHEMA);\n\t\tTABLE_SCHEMA_MAP.put(SysColumn.class.getSimpleName(), DEFAULT_SCHEMA);\n\t\tTABLE_SCHEMA_MAP.put(ExtendedProperty.class.getSimpleName(), DEFAULT_SCHEMA);\n\t\tTABLE_SCHEMA_MAP.put(AllTable.class.getSimpleName(), DEFAULT_SCHEMA);\n\t\tTABLE_SCHEMA_MAP.put(AllColumn.class.getSimpleName(), DEFAULT_SCHEMA);\n\t\tTABLE_SCHEMA_MAP.put(AllTableComment.class.getSimpleName(), DEFAULT_SCHEMA);\n\t\tTABLE_SCHEMA_MAP.put(AllColumnComment.class.getSimpleName(), DEFAULT_SCHEMA);\n\n\t\tTABLE_KEY_MAP = new HashMap<>();\n\t\tTABLE_KEY_MAP.put(Table.class.getSimpleName(), Table.TABLE_NAME);\n\t\tTABLE_KEY_MAP.put(Column.class.getSimpleName(), Column.TABLE_NAME);\n\t\tTABLE_KEY_MAP.put(PgClass.class.getSimpleName(), PgClass.TABLE_NAME);\n\t\tTABLE_KEY_MAP.put(PgAttribute.class.getSimpleName(), PgAttribute.TABLE_NAME);\n\t\tTABLE_KEY_MAP.put(SysTable.class.getSimpleName(), SysTable.TABLE_NAME);\n\t\tTABLE_KEY_MAP.put(SysColumn.class.getSimpleName(), SysColumn.TABLE_NAME);\n\t\tTABLE_KEY_MAP.put(ExtendedProperty.class.getSimpleName(), ExtendedProperty.TABLE_NAME);\n\t\tTABLE_KEY_MAP.put(AllTable.class.getSimpleName(), AllTable.TABLE_NAME);\n\t\tTABLE_KEY_MAP.put(AllColumn.class.getSimpleName(), AllColumn.TABLE_NAME);\n\t\tTABLE_KEY_MAP.put(AllTableComment.class.getSimpleName(), AllTableComment.TABLE_NAME);\n\t\tTABLE_KEY_MAP.put(AllColumnComment.class.getSimpleName(), AllColumnComment.TABLE_NAME);\n\n\t\tALLOW_PARTIAL_UPDATE_FAIL_TABLE_MAP = new HashMap<>();\n\n\t\tCONFIG_TABLE_LIST = new ArrayList<>(); // Table, Column 等是系统表 AbstractVerifier.SYSTEM_ACCESS_MAP.keySet());\n\t\tCONFIG_TABLE_LIST.add(Function.class.getSimpleName());\n\t\tCONFIG_TABLE_LIST.add(Request.class.getSimpleName());\n\t\tCONFIG_TABLE_LIST.add(Access.class.getSimpleName());\n\t\tCONFIG_TABLE_LIST.add(Document.class.getSimpleName());\n\t\tCONFIG_TABLE_LIST.add(TestRecord.class.getSimpleName());\n\n\n\t\tDATABASE_LIST = new ArrayList<>();\n\t\tDATABASE_LIST.add(DATABASE_MYSQL);\n\t\tDATABASE_LIST.add(DATABASE_POSTGRESQL);\n\t\tDATABASE_LIST.add(DATABASE_SQLSERVER);\n\t\tDATABASE_LIST.add(DATABASE_ORACLE);\n\t\tDATABASE_LIST.add(DATABASE_DB2);\n\t\tDATABASE_LIST.add(DATABASE_MARIADB);\n\t\tDATABASE_LIST.add(DATABASE_TIDB);\n\t\tDATABASE_LIST.add(DATABASE_COCKROACHDB);\n\t\tDATABASE_LIST.add(DATABASE_DAMENG);\n\t\tDATABASE_LIST.add(DATABASE_KINGBASE);\n\t\tDATABASE_LIST.add(DATABASE_ELASTICSEARCH);\n\t\tDATABASE_LIST.add(DATABASE_MANTICORE);\n\t\tDATABASE_LIST.add(DATABASE_CLICKHOUSE);\n\t\tDATABASE_LIST.add(DATABASE_HIVE);\n\t\tDATABASE_LIST.add(DATABASE_PRESTO);\n\t\tDATABASE_LIST.add(DATABASE_TRINO);\n\t\tDATABASE_LIST.add(DATABASE_MILVUS);\n\t\tDATABASE_LIST.add(DATABASE_INFLUXDB);\n\t\tDATABASE_LIST.add(DATABASE_TDENGINE);\n\t\tDATABASE_LIST.add(DATABASE_TIMESCALEDB);\n\t\tDATABASE_LIST.add(DATABASE_QUESTDB);\n\t\tDATABASE_LIST.add(DATABASE_IOTDB);\n\t\tDATABASE_LIST.add(DATABASE_SNOWFLAKE);\n\t\tDATABASE_LIST.add(DATABASE_DATABEND);\n\t\tDATABASE_LIST.add(DATABASE_DATABRICKS);\n\t\tDATABASE_LIST.add(DATABASE_REDIS);\n\t\tDATABASE_LIST.add(DATABASE_MONGODB);\n\t\tDATABASE_LIST.add(DATABASE_CASSANDRA);\n\t\tDATABASE_LIST.add(DATABASE_KAFKA);\n\t\tDATABASE_LIST.add(DATABASE_MQ);\n\t\tDATABASE_LIST.add(DATABASE_DUCKDB);\n\t\tDATABASE_LIST.add(DATABASE_SURREALDB);\n\t\tDATABASE_LIST.add(DATABASE_OPENGAUSS);\n\t\tDATABASE_LIST.add(DATABASE_DORIS);\n\n\n\t\tRAW_MAP = new LinkedHashMap<>(); // 保证顺序，避免配置冲突等意外情况\n\n\t\tRAW_MAP.put(\"+\", \"\");\n\t\tRAW_MAP.put(\"-\", \"\");\n\t\tRAW_MAP.put(\"*\", \"\");\n\t\tRAW_MAP.put(\"/\", \"\");\n\t\tRAW_MAP.put(\"=\", \"\");\n\t\tRAW_MAP.put(\"!=\", \"\");\n\t\tRAW_MAP.put(\">\", \"\");\n\t\tRAW_MAP.put(\">=\", \"\");\n\t\tRAW_MAP.put(\"<\", \"\");\n\t\tRAW_MAP.put(\"<=\", \"\");\n\t\tRAW_MAP.put(\"%\", \"\");\n\t\tRAW_MAP.put(\"(\", \"\");\n\t\tRAW_MAP.put(\")\", \"\");\n\n\t\tRAW_MAP.put(\"&\", \"\"); // 位运算\n\t\tRAW_MAP.put(\"|\", \"\"); // 位运算\n\t\tRAW_MAP.put(\"^\", \"\"); // 位运算\n\t\tRAW_MAP.put(\"~\", \"\"); // 位运算\n\t\tRAW_MAP.put(\"&=\", \"\"); // 位运算\n\t\tRAW_MAP.put(\"|=\", \"\"); // 位运算\n\t\tRAW_MAP.put(\"~=\", \"\"); // 位运算\n\t\tRAW_MAP.put(\">>\", \"\"); // 位运算\n\t\tRAW_MAP.put(\"<<\", \"\"); // 位运算\n\n\t\t// MySQL 关键字\n\t\tRAW_MAP.put(\"AS\", \"\");\n\t\tRAW_MAP.put(\"IS NOT NULL\", \"\");\n\t\tRAW_MAP.put(\"IS NULL\", \"\");\n\t\tRAW_MAP.put(\"IS\", \"\");\n\t\tRAW_MAP.put(\"NULL\", \"\");\n\t\tRAW_MAP.put(\"AND\", \"\");\n\t\tRAW_MAP.put(\"OR\", \"\");\n\t\tRAW_MAP.put(\"NOT\", \"\");\n\t\tRAW_MAP.put(\"VALUE\", \"\");\n\t\tRAW_MAP.put(\"DISTINCT\", \"\");\n\t\tRAW_MAP.put(\"CASE\", \"\");\n\t\tRAW_MAP.put(\"WHEN\", \"\");\n\t\tRAW_MAP.put(\"THEN\", \"\");\n\t\tRAW_MAP.put(\"ELSE\", \"\");\n\t\tRAW_MAP.put(\"END\", \"\");\n\n\t\t//时间\n\t\tRAW_MAP.put(\"now()\", \"\");\n\t\tRAW_MAP.put(\"DATE\", \"\");\n\t\tRAW_MAP.put(\"TIME\", \"\");\n\t\tRAW_MAP.put(\"DATETIME\", \"\");\n\t\tRAW_MAP.put(\"TIMESTAMP\", \"\");\n\t\tRAW_MAP.put(\"DateTime\", \"\");\n\t\tRAW_MAP.put(\"SECOND\", \"\");\n\t\tRAW_MAP.put(\"MINUTE\", \"\");\n\t\tRAW_MAP.put(\"HOUR\", \"\");\n\t\tRAW_MAP.put(\"DAY\", \"\");\n\t\tRAW_MAP.put(\"WEEK\", \"\");\n\t\tRAW_MAP.put(\"MONTH\", \"\");\n\t\tRAW_MAP.put(\"QUARTER\", \"\");\n\t\tRAW_MAP.put(\"YEAR\", \"\");\n\t\t//\t\tRAW_MAP.put(\"json\", \"\");\n\t\t//\t\tRAW_MAP.put(\"unit\", \"\");\n\n\t\t//MYSQL 数据类型 BINARY，CHAR，DATETIME，TIME，DECIMAL，SIGNED，UNSIGNED\n\t\tRAW_MAP.put(\"BINARY\", \"\");\n\t\tRAW_MAP.put(\"SIGNED\", \"\");\n\t\tRAW_MAP.put(\"DECIMAL\", \"\");\n\t\tRAW_MAP.put(\"DOUBLE\", \"\");\n\t\tRAW_MAP.put(\"FLOAT\", \"\");\n\t\tRAW_MAP.put(\"BOOLEAN\", \"\");\n\t\tRAW_MAP.put(\"ENUM\", \"\");\n\t\tRAW_MAP.put(\"SET\", \"\");\n\t\tRAW_MAP.put(\"POINT\", \"\");\n\t\tRAW_MAP.put(\"BLOB\", \"\");\n\t\tRAW_MAP.put(\"LONGBLOB\", \"\");\n\t\tRAW_MAP.put(\"UNSIGNED\", \"\");\n\t\tRAW_MAP.put(\"BIT\", \"\");\n\t\tRAW_MAP.put(\"TINYINT\", \"\");\n\t\tRAW_MAP.put(\"SMALLINT\", \"\");\n\t\tRAW_MAP.put(\"INT\", \"\");\n\t\tRAW_MAP.put(\"BIGINT\", \"\");\n\t\tRAW_MAP.put(\"CHAR\", \"\");\n\t\tRAW_MAP.put(\"VARCHAR\", \"\");\n\t\tRAW_MAP.put(\"TEXT\", \"\");\n\t\tRAW_MAP.put(\"LONGTEXT\", \"\");\n\t\tRAW_MAP.put(\"JSON\", \"\");\n\n\t\t//窗口函数关键字\n\t\tRAW_MAP.put(\"OVER\", \"\");\n\t\tRAW_MAP.put(\"INTERVAL\", \"\");\n\t\tRAW_MAP.put(\"GROUP BY\", \"\"); // 往前\n\t\tRAW_MAP.put(\"GROUP\", \"\"); // 往前\n\t\tRAW_MAP.put(\"ORDER BY\", \"\"); // 往前\n\t\tRAW_MAP.put(\"ORDER\", \"\");\n\t\tRAW_MAP.put(\"PARTITION BY\", \"\"); // 往前\n\t\tRAW_MAP.put(\"PARTITION\", \"\"); // 往前\n\t\tRAW_MAP.put(\"BY\", \"\");\n\t\tRAW_MAP.put(\"DESC\", \"\");\n\t\tRAW_MAP.put(\"ASC\", \"\");\n\t\tRAW_MAP.put(\"PRECEDING\", \"\"); // 往前\n\t\tRAW_MAP.put(\"FOLLOWING\", \"\"); // 往后\n\t\tRAW_MAP.put(\"BETWEEN\", \"\");\n\t\tRAW_MAP.put(\"ROWS\", \"\");\n\n\t\tRAW_MAP.put(\"AGAINST\", \"\");\n\t\tRAW_MAP.put(\"IN NATURAL LANGUAGE MODE\", \"\");\n\t\tRAW_MAP.put(\"IN BOOLEAN MODE\", \"\");\n\t\tRAW_MAP.put(\"IN\", \"\");\n\t\tRAW_MAP.put(\"NATURAL\", \"\");\n\t\tRAW_MAP.put(\"LANGUAGE\", \"\");\n\t\tRAW_MAP.put(\"MODE\", \"\");\n\n\n\t\tSQL_AGGREGATE_FUNCTION_MAP = new LinkedHashMap<>(); // 保证顺序，避免配置冲突等意外情况\n\t\tSQL_AGGREGATE_FUNCTION_MAP.put(\"max\", \"\"); // MAX(a, b, c ...) 最大值\n\t\tSQL_AGGREGATE_FUNCTION_MAP.put(\"min\", \"\"); // MIN(a, b, c ...) 最小值\n\t\tSQL_AGGREGATE_FUNCTION_MAP.put(\"avg\", \"\"); // AVG(a, b, c ...) 平均值\n\t\tSQL_AGGREGATE_FUNCTION_MAP.put(\"count\", \"\"); // COUNT(a, b, c ...) 总数\n\t\tSQL_AGGREGATE_FUNCTION_MAP.put(\"sum\", \"\"); // SUM(a, b, c ...) 总和\n\n\t\tSQL_FUNCTION_MAP = new LinkedHashMap<>(); // 保证顺序，避免配置冲突等意外情况\n\n\t\t// 窗口函数\n\t\tSQL_FUNCTION_MAP.put(\"rank\", \"\"); // RANK(a, b, c ...) 得到数据项在分组中的排名，排名相等的时候会留下空位\n\t\tSQL_FUNCTION_MAP.put(\"dense_rank\", \"\"); // DENSE_RANK(a, b, c ...) 得到数据项在分组中的排名，排名相等的时候不会留下空位\n\t\tSQL_FUNCTION_MAP.put(\"row_num\", \"\"); // ROW_NUM() 按照分组中的顺序生成序列，不存在重复的序列\n\t\tSQL_FUNCTION_MAP.put(\"row_number\", \"\"); // ROW_NUMBER() 按照分组中的顺序生成序列，不存在重复的序列\n\t\tSQL_FUNCTION_MAP.put(\"ntile\", \"\"); // NTILE(a, b, c ...) 用于将分组数据按照顺序切分成N片，返回当前切片值，不支持ROWS_BETWEE\n\t\tSQL_FUNCTION_MAP.put(\"first_value\", \"\"); // FIRST_VALUE() 取分组排序后，截止到当前行，分组内第一个值\n\t\tSQL_FUNCTION_MAP.put(\"last_value\", \"\"); // LAST_VALUE() 取分组排序后，截止到当前行，分组内的最后一个值\n\t\tSQL_FUNCTION_MAP.put(\"lag\", \"\"); // LAG() 统计窗口内往上第n行值。第一个参数为列名，第二个参数为往上第n行（可选，默认为1），第三个参数为默认值（当往上第n行为NULL时候，取默认值，如不指定，则为NULL）\n\t\tSQL_FUNCTION_MAP.put(\"lead\", \"\"); // LEAD() 统计窗口内往下第n行值。第一个参数为列名，第二个参数为往下第n行（可选，默认为1），第三个参数为默认值（当往下第n行为NULL时候，取默认值，如不指定，则为NULL）\n\t\tSQL_FUNCTION_MAP.put(\"cume_dist\", \"\"); // CUME_DIST() 返回（小于等于当前行值的行数）/（当前分组内的总行数）\n\t\tSQL_FUNCTION_MAP.put(\"percent_rank\", \"\"); // PERCENT_RANK(a, b, c ...) 返回（组内当前行的rank值-1）/（分组内做总行数-1）\n\n\t\t// MySQL 字符串函数\n\t\tSQL_FUNCTION_MAP.put(\"ascii\", \"\"); // ASCII(s)\t返回字符串 s 的第一个字符的 ASCII 码。\n\t\tSQL_FUNCTION_MAP.put(\"char_length\", \"\"); // CHAR_LENGTH(s)\t返回字符串 s 的字符数\n\t\tSQL_FUNCTION_MAP.put(\"character_length\", \"\"); // CHARACTER_LENGTH(s)\t返回字符串 s 的字符数\n\t\tSQL_FUNCTION_MAP.put(\"concat\", \"\"); // CONCAT(s1, s2...sn)\t字符串 s1,s2 等多个字符串合并为一个字符串\n\t\tSQL_FUNCTION_MAP.put(\"concat_ws\", \"\"); // CONCAT_WS(x, s1, s2...sn)\t同 CONCAT(s1, s2 ...) 函数，但是每个字符串之间要加上 x，x 可以是分隔符\n\t\tSQL_FUNCTION_MAP.put(\"field\", \"\"); // FIELD(s, s1, s2...)\t返回第一个字符串 s 在字符串列表 (s1, s2...)中的位置\n\t\tSQL_FUNCTION_MAP.put(\"find_in_set\", \"\"); // FIND_IN_SET(s1, s2)\t返回在字符串s2中与s1匹配的字符串的位置\n\t\tSQL_FUNCTION_MAP.put(\"format\", \"\"); // FORMAT(x, n)\t函数可以将数字 x 进行格式化 \"#,###.##\", 将 x 保留到小数点后 n 位，最后一位四舍五入。\n\t\tSQL_FUNCTION_MAP.put(\"insert\", \"\"); // INSERT(s1, x, len, s2)\t字符串 s2 替换 s1 的 x 位置开始长度为 len 的字符串\n\t\tSQL_FUNCTION_MAP.put(\"locate\", \"\"); // LOCATE(s1, s)\t从字符串 s 中获取 s1 的开始位置\n\t\tSQL_FUNCTION_MAP.put(\"lcase\", \"\"); // LCASE(s)\t将字符串 s 的所有字母变成小写字母\n\t\tSQL_FUNCTION_MAP.put(\"left\", \"\"); // LEFT(s, n)\t返回字符串 s 的前 n 个字符\n\t\tSQL_FUNCTION_MAP.put(\"length\", \"\"); // LENGTH(s)\t返回字符串 s 的字符数\n\t\tSQL_FUNCTION_MAP.put(\"lower\", \"\"); // LOWER(s)\t将字符串 s 的所有字母变成小写字母\n\t\tSQL_FUNCTION_MAP.put(\"lpad\", \"\"); // LPAD(s1, len, s2)\t在字符串 s1 的开始处填充字符串 s2，使字符串长度达到 len\n\t\tSQL_FUNCTION_MAP.put(\"ltrim\", \"\"); // LTRIM(s)\t去掉字符串 s 开始处的空格\n\t\tSQL_FUNCTION_MAP.put(\"mid\", \"\"); // MID(s, n, len)\t从字符串 s 的 n 位置截取长度为 len 的子字符串，同 SUBSTRING(s, n, len)\n\t\tSQL_FUNCTION_MAP.put(\"position\", \"\"); // POSITION(s, s1);\t从字符串 s 中获取 s1 的开始位置\n\t\tSQL_FUNCTION_MAP.put(\"repeat\", \"\"); // REPEAT(s, n)\t将字符串 s 重复 n 次\n\t\tSQL_FUNCTION_MAP.put(\"replace\", \"\"); // REPLACE(s, s1, s2)\t将字符串 s2 替代字符串 s 中的字符串 s1\n\t\tSQL_FUNCTION_MAP.put(\"reverse\", \"\"); // REVERSE(s); // )\t将字符串s的顺序反过来\n\t\tSQL_FUNCTION_MAP.put(\"right\", \"\"); // RIGHT(s, n)\t返回字符串 s 的后 n 个字符\n\t\tSQL_FUNCTION_MAP.put(\"rpad\", \"\"); // RPAD(s1, len, s2)\t在字符串 s1 的结尾处添加字符串 s2，使字符串的长度达到 len\n\t\tSQL_FUNCTION_MAP.put(\"rtrim\", \"\"); // RTRIM\", \"\"); // )\t去掉字符串 s 结尾处的空格\n\t\tSQL_FUNCTION_MAP.put(\"space\", \"\"); // SPACE(n)\t返回 n 个空格\n\t\tSQL_FUNCTION_MAP.put(\"strcmp\", \"\"); // STRCMP(s1, s2)\t比较字符串 s1 和 s2，如果 s1 与 s2 相等返回 0 ，如果 s1>s2 返回 1，如果 s1d2 之间相隔的天数\n\t\tSQL_FUNCTION_MAP.put(\"date_add\", \"\"); // DATE_ADD(d，INTERVAL expr type)\t计算起始日期 d 加上一个时间段后的日期\n\t\tSQL_FUNCTION_MAP.put(\"date_format\", \"\"); // DATE_FORMAT(d,f)\t按表达式 f的要求显示日期 d\n\t\tSQL_FUNCTION_MAP.put(\"date_sub\", \"\"); // DATE_SUB(date,INTERVAL expr type)\t函数从日期减去指定的时间间隔。\n\t\tSQL_FUNCTION_MAP.put(\"day\", \"\"); // DAY(d)\t返回日期值 d 的日期部分\n\t\tSQL_FUNCTION_MAP.put(\"dayname\", \"\"); // DAYNAME(d)\t返回日期 d 是星期几，如 Monday,Tuesday\n\t\tSQL_FUNCTION_MAP.put(\"dayofmonth\", \"\"); // DAYOFMONTH(d)\t计算日期 d 是本月的第几天\n\t\tSQL_FUNCTION_MAP.put(\"dayofweek\", \"\"); // DAYOFWEEK(d)\t日期 d 今天是星期几，1 星期日，2 星期一，以此类推\n\t\tSQL_FUNCTION_MAP.put(\"dayofyear\", \"\"); // DAYOFYEAR(d)\t计算日期 d 是本年的第几天\n\t\tSQL_FUNCTION_MAP.put(\"extract\", \"\"); // EXTRACT(type FROM d)\t从日期 d 中获取指定的值，type 指定返回的值。\n\t\tSQL_FUNCTION_MAP.put(\"from_days\", \"\"); // FROM_DAYS(n)\t计算从 0000 年 1 月 1 日开始 n 天后的日期\n\t\tSQL_FUNCTION_MAP.put(\"hour\", \"\"); // 'HOUR(t)\t返回 t 中的小时值\n\t\tSQL_FUNCTION_MAP.put(\"last_day\", \"\"); // LAST_DAY(d)\t返回给给定日期的那一月份的最后一天\n\t\tSQL_FUNCTION_MAP.put(\"localtime\", \"\"); // LOCALTIME()\t返回当前日期和时间\n\t\tSQL_FUNCTION_MAP.put(\"localtimestamp\", \"\"); // LOCALTIMESTAMP()\t返回当前日期和时间\n\t\tSQL_FUNCTION_MAP.put(\"makedate\", \"\"); // MAKEDATE(year, day-of-year)\t基于给定参数年份 year 和所在年中的天数序号 day-of-year 返回一个日期\n\t\tSQL_FUNCTION_MAP.put(\"maketime\", \"\"); // MAKETIME(hour, minute, second)\t组合时间，参数分别为小时、分钟、秒\n\t\tSQL_FUNCTION_MAP.put(\"microsecond\", \"\"); // MICROSECOND(date)\t返回日期参数所对应的微秒数\n\t\tSQL_FUNCTION_MAP.put(\"minute\", \"\"); // MINUTE(t)\t返回 t 中的分钟值\n\t\tSQL_FUNCTION_MAP.put(\"monthname\", \"\"); // MONTHNAME(d)\t返回日期当中的月份名称，如 November\n\t\tSQL_FUNCTION_MAP.put(\"month\", \"\"); // MONTH(d)\t返回日期d中的月份值，1 到 12\n\t\tSQL_FUNCTION_MAP.put(\"now\", \"\"); // NOW()\t返回当前日期和时间\n\t\tSQL_FUNCTION_MAP.put(\"period_add\", \"\"); // PERIOD_ADD(period, number)\t为 年-月 组合日期添加一个时段\n\t\tSQL_FUNCTION_MAP.put(\"period_diff\", \"\"); // PERIOD_DIFF(period1, period2)\t返回两个时段之间的月份差值\n\t\tSQL_FUNCTION_MAP.put(\"quarter\", \"\"); // QUARTER(d)\t返回日期d是第几季节，返回 1 到 4\n\t\tSQL_FUNCTION_MAP.put(\"second\", \"\"); // SECOND(t)\t返回 t 中的秒钟值\n\t\tSQL_FUNCTION_MAP.put(\"sec_to_time\", \"\"); // SEC_TO_TIME(sec, format); // )\t将以秒为单位的时间 s 转换为时分秒的格式\n\t\tSQL_FUNCTION_MAP.put(\"str_to_date\", \"\"); // STR_TO_DATE(string, format)\t将字符串转变为日期\n\t\tSQL_FUNCTION_MAP.put(\"subdate\", \"\"); // SUBDATE(d,n)\t日期 d 减去 n 天后的日期\n\t\tSQL_FUNCTION_MAP.put(\"subtime\", \"\"); // SUBTIME(t,n)\t时间 t 减去 n 秒的时间\n\t\tSQL_FUNCTION_MAP.put(\"sysdate\", \"\"); // SYSDATE()\t返回当前日期和时间\n\t\tSQL_FUNCTION_MAP.put(\"time\", \"\"); // TIME(expression)\t提取传入表达式的时间部分\n\t\tSQL_FUNCTION_MAP.put(\"time_format\", \"\"); // TIME_FORMAT(t,f)\t按表达式 f 的要求显示时间 t\n\t\tSQL_FUNCTION_MAP.put(\"time_to_sec\", \"\"); // TIME_TO_SEC(t)\t将时间 t 转换为秒\n\t\tSQL_FUNCTION_MAP.put(\"timediff\", \"\"); // TIMEDIFF(time1, time2)\t计算时间差值\n\t\tSQL_FUNCTION_MAP.put(\"timestamp\", \"\"); // TIMESTAMP(expression, interval)\t单个参数时，函数返回日期或日期时间表达式；有2个参数时，将参数加和\n\t\tSQL_FUNCTION_MAP.put(\"to_days\", \"\"); // TO_DAYS(d)\t计算日期 d 距离 0000 年 1 月 1 日的天数\n\t\tSQL_FUNCTION_MAP.put(\"week\", \"\"); // WEEK(d)\t计算日期 d 是本年的第几个星期，范围是 0 到 53\n\t\tSQL_FUNCTION_MAP.put(\"weekday\", \"\"); // WEEKDAY(d)\t日期 d 是星期几，0 表示星期一，1 表示星期二\n\t\tSQL_FUNCTION_MAP.put(\"weekofyear\", \"\"); // WEEKOFYEAR(d)\t计算日期 d 是本年的第几个星期，范围是 0 到 53\n\t\tSQL_FUNCTION_MAP.put(\"year\", \"\"); // YEAR(d)\t返回年份\n\t\tSQL_FUNCTION_MAP.put(\"yearweek\", \"\"); // YEARWEEK(date, mode)\t返回年份及第几周（0到53），mode 中 0 表示周天，1表示周一，以此类推\n\t\tSQL_FUNCTION_MAP.put(\"unix_timestamp\", \"\"); // UNIX_TIMESTAMP(date)\t获取UNIX时间戳函数，返回一个以 UNIX 时间戳为基础的无符号整数\n\t\tSQL_FUNCTION_MAP.put(\"from_unixtime\", \"\"); // FROM_UNIXTIME(date)\t将 UNIX 时间戳转换为时间格式，与UNIX_TIMESTAMP互为反函数\n\n\t\t// MYSQL JSON 函数\n\t\tSQL_FUNCTION_MAP.put(\"json_append\", \"\"); // JSON_APPEND(json_doc, path, val[, path, val] ...)) 插入JSON数组\n\t\tSQL_FUNCTION_MAP.put(\"json_array\", \"\"); // JSON_ARRAY(val1, val2...) 创建JSON数组\n\t\tSQL_FUNCTION_MAP.put(\"json_array_append\", \"\"); // JSON_ARRAY_APPEND(json_doc, val) 将数据附加到JSON文档\n\t\tSQL_FUNCTION_MAP.put(\"json_array_insert\", \"\"); // JSON_ARRAY_INSERT(json_doc, val) 插入JSON数组\n\t\tSQL_FUNCTION_MAP.put(\"json_array_get\", \"\"); // JSON_ARRAY_GET(json_doc, position) 从JSON数组提取指定位置的元素\n\t\tSQL_FUNCTION_MAP.put(\"json_contains\", \"\"); // JSON_CONTAINS(json_doc, val) JSON文档是否在路径中包含特定对象\n\t\tSQL_FUNCTION_MAP.put(\"json_array_contains\", \"\"); // JSON_ARRAY_CONTAINS(json_doc, path) JSON文档是否在路径中包含特定对象\n\t\tSQL_FUNCTION_MAP.put(\"json_contains_path\", \"\"); // JSON_CONTAINS_PATH(json_doc, path) JSON文档是否在路径中包含任何数据\n\t\tSQL_FUNCTION_MAP.put(\"json_depth\", \"\"); // JSON_DEPTH(json_doc) JSON文档的最大深度\n\t\tSQL_FUNCTION_MAP.put(\"json_extract\", \"\"); // JSON_EXTRACT(json_doc, path) 从JSON文档返回数据\n\t\tSQL_FUNCTION_MAP.put(\"json_extract_scalar\", \"\"); // JSON_EXTRACT_SCALAR(json_doc, path) 从JSON文档返回基础类型数据，例如 Boolean, Number, String\n\t\tSQL_FUNCTION_MAP.put(\"json_insert\", \"\"); // JSON_INSERT(json_doc, val) 将数据插入JSON文档\n\t\tSQL_FUNCTION_MAP.put(\"json_keys\", \"\"); // JSON_KEYS(json_doc[, path]) JSON文档中的键数组\n\t\tSQL_FUNCTION_MAP.put(\"json_length\", \"\"); // JSON_LENGTH(json_doc) JSON文档中的元素数\n\t\tSQL_FUNCTION_MAP.put(\"json_size\", \"\"); // JSON_SIZE(json_doc) JSON文档中的元素数\n\t\tSQL_FUNCTION_MAP.put(\"json_array_length\", \"\"); // JSON_ARRAY_LENGTH(json_doc) JSON文档中的元素数\n\t\tSQL_FUNCTION_MAP.put(\"json_format\", \"\"); // JSON_FORMAT(json_doc) 格式化 JSON\n\t\tSQL_FUNCTION_MAP.put(\"json_parse\", \"\"); // JSON_PARSE(val) 转换为 JSON\n\t\tSQL_FUNCTION_MAP.put(\"json_merge\", \"\"); // JSON_MERGE(json_doc1, json_doc2) （已弃用） 合并JSON文档，保留重复的键。JSON_MERGE_PRESERVE（）的已弃用同义词\n\t\tSQL_FUNCTION_MAP.put(\"json_merge_patch\", \"\"); // JSON_MERGE_PATCH(json_doc1, json_doc2) 合并JSON文档，替换重复键的值\n\t\tSQL_FUNCTION_MAP.put(\"json_merge_preserve\", \"\"); // JSON_MERGE_PRESERVE(json_doc1, json_doc2) 合并JSON文档，保留重复的键\n\t\tSQL_FUNCTION_MAP.put(\"json_object\", \"\"); // JSON_OBJECT(key1, val1, key2, val2...) 创建JSON对象\n\t\tSQL_FUNCTION_MAP.put(\"json_overlaps\", \"\"); // JSON_OVERLAPS(json_doc1, json_doc2) （引入8.0.17） 比较两个JSON文档，如果它们具有相同的键值对或数组元素，则返回TRUE（1），否则返回FALSE（0）\n\t\tSQL_FUNCTION_MAP.put(\"json_pretty\", \"\"); // JSON_PRETTY(json_doc) 以易于阅读的格式打印JSON文档\n\t\tSQL_FUNCTION_MAP.put(\"json_quote\", \"\"); // JSON_QUOTE(json_doc1) 引用JSON文档\n\t\tSQL_FUNCTION_MAP.put(\"json_remove\", \"\"); // JSON_REMOVE(json_doc1, path) 从JSON文档中删除数据\n\t\tSQL_FUNCTION_MAP.put(\"json_replace\", \"\"); // JSON_REPLACE(json_doc1, val1, val2) 替换JSON文档中的值\n\t\tSQL_FUNCTION_MAP.put(\"json_schema_valid\", \"\"); // JSON_SCHEMA_VALID(json_doc) （引入8.0.17） 根据JSON模式验证JSON文档；如果文档针对架构进行验证，则返回TRUE / 1；否则，则返回FALSE / 0\n\t\tSQL_FUNCTION_MAP.put(\"json_schema_validation_report\", \"\"); // JSON_SCHEMA_VALIDATION_REPORT(json_doc, mode) （引入8.0.17） 根据JSON模式验证JSON文档；以JSON格式返回有关验证结果的报告，包括成功或失败以及失败原因\n\t\tSQL_FUNCTION_MAP.put(\"json_search\", \"\"); // JSON_SEARCH(json_doc, val) JSON文档中值的路径\n\t\tSQL_FUNCTION_MAP.put(\"json_set\", \"\"); // JSON_SET(json_doc, val) 将数据插入JSON文档\n\t\t//\t\tSQL_FUNCTION_MAP.put(\"json_storage_free\", \"\"); // JSON_STORAGE_FREE() 部分更新后，JSON列值的二进制表示形式中的可用空间\n\t\t//\t\tSQL_FUNCTION_MAP.put(\"json_storage_size\", \"\"); // JSON_STORAGE_SIZE() 用于存储JSON文档的二进制表示的空间\n\t\tSQL_FUNCTION_MAP.put(\"json_table\", \"\"); // JSON_TABLE() 从JSON表达式返回数据作为关系表\n\t\tSQL_FUNCTION_MAP.put(\"json_type\", \"\"); // JSON_TYPE(json_doc) JSON值类型\n\t\tSQL_FUNCTION_MAP.put(\"json_unquote\", \"\"); // JSON_UNQUOTE(json_doc) 取消引用JSON值\n\t\tSQL_FUNCTION_MAP.put(\"json_valid\", \"\"); // JSON_VALID(json_doc) JSON值是否有效\n\t\tSQL_FUNCTION_MAP.put(\"json_arrayagg\", \"\"); // JSON_ARRAYAGG(key) 将每个表达式转换为 JSON 值，然后返回一个包含这些 JSON 值的 JSON 数组\n\t\tSQL_FUNCTION_MAP.put(\"json_objectagg\", \"\"); // JSON_OBJECTAGG(key, val)) 将每个表达式转换为 JSON 值，然后返回一个包含这些 JSON 值的 JSON 对象\n\t\tSQL_FUNCTION_MAP.put(\"is_json_scalar\", \"\"); // IS_JSON_SCALAR(val)) 是否为JSON基本类型，例如 Boolean, Number, String\n\n\t\t// MySQL 高级函数\n\t\t//\t\tSQL_FUNCTION_MAP.put(\"bin\", \"\"); // BIN(x)\t返回 x 的二进制编码\n\t\t//\t\tSQL_FUNCTION_MAP.put(\"binary\", \"\"); // BINARY(s)\t将字符串 s 转换为二进制字符串\n\t\tSQL_FUNCTION_MAP.put(\"case\", \"\"); // CASE 表示函数开始，END 表示函数结束。如果 condition1 成立，则返回 result1, 如果 condition2 成立，则返回 result2，当全部不成立则返回 result，而当有一个成立之后，后面的就不执行了。\n\t\tSQL_FUNCTION_MAP.put(\"cast\", \"\"); // CAST(x AS type)\t转换数据类型\n\t\tSQL_FUNCTION_MAP.put(\"coalesce\", \"\"); // COALESCE(expr1, expr2, ...., expr_n)\t返回参数中的第一个非空表达式（从左向右）\n\t\t//\t\tSQL_FUNCTION_MAP.put(\"conv\", \"\"); // CONV(x,f1,f2)\t返回 f1 进制数变成 f2 进制数\n\t\t//\t\tSQL_FUNCTION_MAP.put(\"convert\", \"\"); // CONVERT(s, cs)\t函数将字符串 s 的字符集变成 cs\n\t\tSQL_FUNCTION_MAP.put(\"if\", \"\"); // IF(expr,v1,v2)\t如果表达式 expr 成立，返回结果 v1；否则，返回结果 v2。\n\t\tSQL_FUNCTION_MAP.put(\"ifnull\", \"\"); // IFNULL(v1,v2) 如果 v1 的值不为 NULL，则返回 v1，否则返回 v2。\n\t\tSQL_FUNCTION_MAP.put(\"isnull\", \"\"); // ISNULL(expression)\t判断表达式是否为 NULL\n\t\tSQL_FUNCTION_MAP.put(\"nullif\", \"\"); // NULLIF(expr1, expr2) 比较两个字符串，如果字符串 expr1 与 expr2 相等 返回 NULL，否则返回 expr1\n\t\tSQL_FUNCTION_MAP.put(\"group_concat\", \"\"); // GROUP_CONCAT([DISTINCT], s1, s2...) 聚合拼接字符串\n\t\tSQL_FUNCTION_MAP.put(\"match\", \"\"); // MATCH (name,tag) AGAINST ('a b' IN NATURAL LANGUAGE MODE) 全文检索\n\t\tSQL_FUNCTION_MAP.put(\"any_value\", \"\"); // any_value(userId) 解决 ONLY_FULL_GROUP_BY 报错\n\n\n\t\t// ClickHouse 字符串函数 注释的函数表示返回的格式暂时不支持，如：返回数组 ，同时包含因版本不同 clickhosue不支持的函数，版本\n\t\tSQL_FUNCTION_MAP.put(\"empty\", \"\"); // empty(s) 对于空字符串s返回1，对于非空字符串返回0\n\t\tSQL_FUNCTION_MAP.put(\"notEmpty\", \"\"); // notEmpty(s) 对于空字符串返回0，对于非空字符串返回1。\n\t\tSQL_FUNCTION_MAP.put(\"lengthUTF8\", \"\"); // 假定字符串以UTF-8编码组成的文本，返回此字符串的Unicode字符长度。如果传入的字符串不是UTF-8编码，则函数可能返回一个预期外的值\n\t\tSQL_FUNCTION_MAP.put(\"lcase\", \"\"); // 将字符串中的ASCII转换为小写\n\t\tSQL_FUNCTION_MAP.put(\"ucase\", \"\"); // 将字符串中的ASCII转换为大写。\n\t\tSQL_FUNCTION_MAP.put(\"lowerUTF8\", \"\"); // 将字符串转换为小写，函数假设字符串是以UTF-8编码文本的字符集。\n\t\tSQL_FUNCTION_MAP.put(\"upperUTF8\", \"\"); // 将字符串转换为大写，函数假设字符串是以UTF-8编码文本的字符集。\n\t\tSQL_FUNCTION_MAP.put(\"isValidUTF8\", \"\"); // 检查字符串是否为有效的UTF-8编码，是则返回1，否则返回0。\n\t\tSQL_FUNCTION_MAP.put(\"toValidUTF8\", \"\"); // 用（U+FFFD）字符替换无效的UTF-8字符。所有连续的无效字符都会被替换为一个替换字符。\n\t\tSQL_FUNCTION_MAP.put(\"reverseUTF8\", \"\"); // 以Unicode字符为单位反转UTF-8编码的字符串。\n\t\tSQL_FUNCTION_MAP.put(\"concatAssumeInjective\", \"\"); // concatAssumeInjective(s1, s2, …) 与concat相同，区别在于，你需要保证concat(s1, s2, s3) -> s4是单射的，它将用于GROUP BY的优化。\n\t\tSQL_FUNCTION_MAP.put(\"substringUTF8\", \"\"); // substringUTF8(s,offset,length)¶ 与’substring’相同，但其操作单位为Unicode字符，函数假设字符串是以UTF-8进行编码的文本。如果不是则可能返回一个预期外的结果（不会抛出异常）。\n\t\tSQL_FUNCTION_MAP.put(\"appendTrailingCharIfAbsent\", \"\"); // appendTrailingCharIfAbsent(s,c) 如果’s’字符串非空并且末尾不包含’c’字符，则将’c’字符附加到末尾\n\t\tSQL_FUNCTION_MAP.put(\"convertCharset\", \"\"); // convertCharset(s,from,to) 返回从’from’中的编码转换为’to’中的编码的字符串’s’。\n\t\tSQL_FUNCTION_MAP.put(\"base64Encode\", \"\"); // base64Encode(s) 将字符串’s’编码成base64\n\t\tSQL_FUNCTION_MAP.put(\"base64Decode\", \"\"); // base64Decode(s) 使用base64将字符串解码成原始字符串。如果失败则抛出异常。\n\t\tSQL_FUNCTION_MAP.put(\"tryBase64Decode\", \"\"); // tryBase64Decode(s) 使用base64将字符串解码成原始字符串。但如果出现错误，将返回空字符串。\n\t\tSQL_FUNCTION_MAP.put(\"endsWith\", \"\"); // endsWith(s,后缀) 返回是否以指定的后缀结尾。如果字符串以指定的后缀结束，则返回1，否则返回0。\n\t\tSQL_FUNCTION_MAP.put(\"startsWith\", \"\"); // startsWith（s，前缀) 返回是否以指定的前缀开头。如果字符串以指定的前缀开头，则返回1，否则返回0。\n\t\tSQL_FUNCTION_MAP.put(\"trimLeft\", \"\"); // trimLeft(s)返回一个字符串，用于删除左侧的空白字符。\n\t\tSQL_FUNCTION_MAP.put(\"trimRight\", \"\"); // trimRight(s) 返回一个字符串，用于删除右侧的空白字符。\n\t\tSQL_FUNCTION_MAP.put(\"trimBoth\", \"\"); // trimBoth(s)，用于删除任一侧的空白字符\n\t\tSQL_FUNCTION_MAP.put(\"extractAllGroups\", \"\"); // extractAllGroups(text, regexp) 从正则表达式匹配的非重叠子字符串中提取所有组\n\t\t// SQL_FUNCTION_MAP.put(\"leftPad\", \"\"); // leftPad('string', 'length'[, 'pad_string']) 用空格或指定的字符串从左边填充当前字符串(如果需要，可以多次)，直到得到的字符串达到给定的长度\n\t\t// SQL_FUNCTION_MAP.put(\"leftPadUTF8\", \"\"); // leftPadUTF8('string','length'[, 'pad_string']) 用空格或指定的字符串从左边填充当前字符串(如果需要，可以多次)，直到得到的字符串达到给定的长度\n\t\t// SQL_FUNCTION_MAP.put(\"rightPad\", \"\"); // rightPad('string', 'length'[, 'pad_string']) 用空格或指定的字符串(如果需要，可以多次)从右边填充当前字符串，直到得到的字符串达到给定的长度\n\t\t// SQL_FUNCTION_MAP.put(\"rightPadUTF8\", \"\");// rightPadUTF8('string','length'[, 'pad_string']) 用空格或指定的字符串(如果需要，可以多次)从右边填充当前字符串，直到得到的字符串达到给定的长度。\n\t\tSQL_FUNCTION_MAP.put(\"normalizeQuery\", \"\"); // normalizeQuery(x) 用占位符替换文字、文字序列和复杂的别名。\n\t\tSQL_FUNCTION_MAP.put(\"normalizedQueryHash\", \"\"); // normalizedQueryHash(x) 为类似查询返回相同的64位散列值，但不包含文字值。有助于对查询日志进行分析\n\t\tSQL_FUNCTION_MAP.put(\"positionUTF8\", \"\"); // positionUTF8(s, needle[, start_pos]) 返回在字符串中找到的子字符串的位置(以Unicode点表示)，从1开始。\n\t\tSQL_FUNCTION_MAP.put(\"multiSearchFirstIndex\", \"\"); // multiSearchFirstIndex(s, [needle1, needle2, …, needlen]) 返回字符串s中最左边的needlei的索引i(从1开始)，否则返回0\n\t\tSQL_FUNCTION_MAP.put(\"multiSearchAny\", \"\"); // multiSearchAny(s, [needle1, needle2, …, needlen])如果至少有一个字符串needlei匹配字符串s，则返回1，否则返回0。\n\t\tSQL_FUNCTION_MAP.put(\"match\", \"\"); // match(s, pattern) 检查字符串是否与模式正则表达式匹配。re2正则表达式。re2正则表达式的语法比Perl正则表达式的语法更有局限性。\n\t\tSQL_FUNCTION_MAP.put(\"multiMatchAny\", \"\"); // multiMatchAny(s, [pattern1, pattern2, …, patternn]) 与match相同，但是如果没有匹配的正则表达式返回0，如果有匹配的模式返回1\n\t\tSQL_FUNCTION_MAP.put(\"multiMatchAnyIndex\", \"\"); // multiMatchAnyIndex(s, [pattern1, pattern2, …, patternn]) 与multiMatchAny相同，但返回与干堆匹配的任何索引\n\t\tSQL_FUNCTION_MAP.put(\"extract\", \"\"); // extract(s, pattern) 使用正则表达式提取字符串的片段\n\t\tSQL_FUNCTION_MAP.put(\"extractAll\", \"\"); // extractAll(s, pattern) 使用正则表达式提取字符串的所有片段\n\t\tSQL_FUNCTION_MAP.put(\"like\", \"\"); // like(s, pattern) 检查字符串是否与简单正则表达式匹配\n\t\tSQL_FUNCTION_MAP.put(\"notLike\", \"\"); // 和‘like’是一样的，但是是否定的\n\t\tSQL_FUNCTION_MAP.put(\"countSubstrings\", \"\"); // countSubstrings(s, needle[, start_pos])返回子字符串出现的次数\n\t\tSQL_FUNCTION_MAP.put(\"countMatches\", \"\"); // 返回干s中的正则表达式匹配数。countMatches(s, pattern)\n\t\tSQL_FUNCTION_MAP.put(\"replaceOne\", \"\"); // replaceOne(s, pattern, replacement)将' s '中的' pattern '子串的第一个出现替换为' replacement '子串。\n\n\t\tSQL_FUNCTION_MAP.put(\"replaceAll\", \"\"); // replaceAll(s, pattern, replacement)/用' replacement '子串替换' s '中所有出现的' pattern '子串\n\t\tSQL_FUNCTION_MAP.put(\"replaceRegexpOne\", \"\"); // replaceRegexpOne(s, pattern, replacement)使用' pattern '正则表达式进行替换\n\t\tSQL_FUNCTION_MAP.put(\"replaceRegexpAll\", \"\"); // replaceRegexpAll(s, pattern, replacement)\n\t\tSQL_FUNCTION_MAP.put(\"regexpQuoteMeta\", \"\"); // regexpQuoteMeta(s)该函数在字符串中某些预定义字符之前添加一个反斜杠\n\n\t\t// clickhouse日期函数\n\t\tSQL_FUNCTION_MAP.put(\"toYear\", \"\"); // 将Date或DateTime转换为包含年份编号（AD）的UInt16类型的数字。\n\t\tSQL_FUNCTION_MAP.put(\"toQuarter\", \"\"); // 将Date或DateTime转换为包含季度编号的UInt8类型的数字。\n\t\tSQL_FUNCTION_MAP.put(\"toMonth\", \"\"); // Date或DateTime转换为包含月份编号（1-12）的UInt8类型的数字。\n\t\tSQL_FUNCTION_MAP.put(\"toDayOfYear\", \"\"); // 将Date或DateTime转换为包含一年中的某一天的编号的UInt16（1-366）类型的数字。\n\t\tSQL_FUNCTION_MAP.put(\"toDayOfMonth\", \"\");// 将Date或DateTime转换为包含一月中的某一天的编号的UInt8（1-31）类型的数字。\n\t\tSQL_FUNCTION_MAP.put(\"toDayOfWeek\", \"\"); // 将Date或DateTime转换为包含一周中的某一天的编号的UInt8（周一是1, 周日是7）类型的数字。\n\t\tSQL_FUNCTION_MAP.put(\"toHour\", \"\"); // 将DateTime转换为包含24小时制（0-23）小时数的UInt8数字。\n\t\tSQL_FUNCTION_MAP.put(\"toMinute\", \"\"); // 将DateTime转换为包含一小时中分钟数（0-59）的UInt8数字。\n\t\tSQL_FUNCTION_MAP.put(\"toSecond\", \"\"); // 将DateTime转换为包含一分钟中秒数（0-59）的UInt8数字。\n\t\tSQL_FUNCTION_MAP.put(\"toUnixTimestamp\", \"\"); // 对于DateTime参数：将值转换为UInt32类型的数字-Unix时间戳\n\t\tSQL_FUNCTION_MAP.put(\"toStartOfYear\", \"\"); // 将Date或DateTime向前取整到本年的第一天。\n\t\tSQL_FUNCTION_MAP.put(\"toStartOfISOYear\", \"\"); // 将Date或DateTime向前取整到ISO本年的第一天。\n\t\tSQL_FUNCTION_MAP.put(\"toStartOfQuarter\", \"\");// 将Date或DateTime向前取整到本季度的第一天。\n\t\tSQL_FUNCTION_MAP.put(\"toStartOfMonth\", \"\"); // 将Date或DateTime向前取整到本月的第一天。\n\t\tSQL_FUNCTION_MAP.put(\"toMonday\", \"\"); // 将Date或DateTime向前取整到本周的星期\n\t\tSQL_FUNCTION_MAP.put(\"toStartOfWeek\", \"\"); // 按mode将Date或DateTime向前取整到最近的星期日或星期一。\n\t\tSQL_FUNCTION_MAP.put(\"toStartOfDay\", \"\"); // 将DateTime向前取整到今天的开始。\n\t\tSQL_FUNCTION_MAP.put(\"toStartOfHour\", \"\"); // 将DateTime向前取整到当前小时的开始。\n\t\tSQL_FUNCTION_MAP.put(\"toStartOfMinute\", \"\"); // 将DateTime向前取整到当前分钟的开始。\n\t\tSQL_FUNCTION_MAP.put(\"toStartOfSecond\", \"\"); // 将DateTime向前取整到当前秒数的开始。\n\t\tSQL_FUNCTION_MAP.put(\"toStartOfFiveMinute\", \"\");// 将DateTime以五分钟为单位向前取整到最接近的时间点。\n\t\tSQL_FUNCTION_MAP.put(\"toStartOfTenMinutes\", \"\"); // 将DateTime以十分钟为单位向前取整到最接近的时间点。\n\t\tSQL_FUNCTION_MAP.put(\"toStartOfFifteenMinutes\", \"\"); // 将DateTime以十五分钟为单位向前取整到最接近的时间点。\n\t\tSQL_FUNCTION_MAP.put(\"toStartOfInterval\", \"\"); //\n\t\tSQL_FUNCTION_MAP.put(\"toTime\", \"\"); // 将DateTime中的日期转换为一个固定的日期，同时保留时间部分。\n\t\tSQL_FUNCTION_MAP.put(\"toISOYear\", \"\"); // 将Date或DateTime转换为包含ISO年份的UInt16类型的编号。\n\t\tSQL_FUNCTION_MAP.put(\"toISOWeek\", \"\"); //\n\t\tSQL_FUNCTION_MAP.put(\"toWeek\", \"\");// 返回Date或DateTime的周数。\n\t\tSQL_FUNCTION_MAP.put(\"toYearWeek\", \"\"); // 返回年和周的日期\n\t\tSQL_FUNCTION_MAP.put(\"date_trunc\", \"\"); // 截断日期和时间数据到日期的指定部分\n\t\tSQL_FUNCTION_MAP.put(\"date_diff\", \"\"); // 回两个日期或带有时间值的日期之间的差值。\n\n\t\tSQL_FUNCTION_MAP.put(\"yesterday\", \"\"); // 不接受任何参数并在请求执行时的某一刻返回昨天的日期(Date)。\n\t\tSQL_FUNCTION_MAP.put(\"today\", \"\"); // 不接受任何参数并在请求执行时的某一刻返回当前日期(Date)。\n\t\tSQL_FUNCTION_MAP.put(\"timeSlot\", \"\"); // 将时间向前取整半小时。\n\t\tSQL_FUNCTION_MAP.put(\"toYYYYMM\", \"\"); //\n\t\tSQL_FUNCTION_MAP.put(\"toYYYYMMDD\", \"\");//\n\t\tSQL_FUNCTION_MAP.put(\"toYYYYMMDDhhmmss\", \"\"); //\n\t\tSQL_FUNCTION_MAP.put(\"addYears\", \"\"); // Function adds a Date/DateTime interval to a Date/DateTime and then return the Date/DateTime\n\t\tSQL_FUNCTION_MAP.put(\"addMonths\", \"\"); // 同上\n\t\tSQL_FUNCTION_MAP.put(\"addWeeks\", \"\"); // 同上\n\t\tSQL_FUNCTION_MAP.put(\"addDays\", \"\"); // 同上\n\t\tSQL_FUNCTION_MAP.put(\"addHours\", \"\"); // 同上\n\t\tSQL_FUNCTION_MAP.put(\"addMinutes\", \"\");// 同上\n\t\tSQL_FUNCTION_MAP.put(\"addSeconds\", \"\"); // 同上\n\t\tSQL_FUNCTION_MAP.put(\"addQuarters\", \"\"); // 同上\n\t\tSQL_FUNCTION_MAP.put(\"subtractYears\", \"\"); // Function subtract a Date/DateTime interval to a Date/DateTime and then return the Date/DateTime\n\t\tSQL_FUNCTION_MAP.put(\"subtractMonths\", \"\"); // 同上\n\t\tSQL_FUNCTION_MAP.put(\"subtractWeeks\", \"\"); // 同上\n\t\tSQL_FUNCTION_MAP.put(\"subtractDays\", \"\"); // 同上\n\t\tSQL_FUNCTION_MAP.put(\"subtractours\", \"\");// 同上\n\t\tSQL_FUNCTION_MAP.put(\"subtractMinutes\", \"\"); // 同上\n\t\tSQL_FUNCTION_MAP.put(\"subtractSeconds\", \"\"); // 同上\n\t\tSQL_FUNCTION_MAP.put(\"subtractQuarters\", \"\"); // 同上\n\t\tSQL_FUNCTION_MAP.put(\"formatDateTime\", \"\"); // 函数根据给定的格式字符串来格式化时间\n\t\tSQL_FUNCTION_MAP.put(\"timestamp_add\", \"\"); // 使用提供的日期或日期时间值添加指定的时间值。\n\t\tSQL_FUNCTION_MAP.put(\"timestamp_sub\", \"\"); // 从提供的日期或带时间的日期中减去时间间隔。\n\n\t\t// ClickHouse json函数\n\t\tSQL_FUNCTION_MAP.put(\"visitParamHas\", \"\"); // visitParamHas(params, name)检查是否存在«name»名称的字段\n\t\tSQL_FUNCTION_MAP.put(\"visitParamExtractUInt\", \"\"); // visitParamExtractUInt(params, name)将名为«name»的字段的值解析成UInt64。\n\t\tSQL_FUNCTION_MAP.put(\"visitParamExtractInt\", \"\"); // 与visitParamExtractUInt相同，但返回Int64。\n\t\tSQL_FUNCTION_MAP.put(\"visitParamExtractFloat\", \"\"); // 与visitParamExtractUInt相同，但返回Float64。\n\t\tSQL_FUNCTION_MAP.put(\"visitParamExtractBool\", \"\");// 解析true/false值。其结果是UInt8类型的。\n\t\tSQL_FUNCTION_MAP.put(\"visitParamExtractRaw\", \"\"); // 返回字段的值，包含空格符。\n\t\tSQL_FUNCTION_MAP.put(\"visitParamExtractString\", \"\"); // 使用双引号解析字符串。这个值没有进行转义。如果转义失败，它将返回一个空白字符串。\n\t\tSQL_FUNCTION_MAP.put(\"JSONHas\", \"\"); // 如果JSON中存在该值，则返回1。\n\t\tSQL_FUNCTION_MAP.put(\"JSONLength\", \"\"); // 返回JSON数组或JSON对象的长度。\n\t\tSQL_FUNCTION_MAP.put(\"JSONType\", \"\"); // 返回JSON值的类型。\n\t\tSQL_FUNCTION_MAP.put(\"JSONExtractUInt\", \"\"); // 解析JSON并提取值。这些函数类似于visitParam*函数。\n\t\tSQL_FUNCTION_MAP.put(\"JSONExtractInt\", \"\"); //\n\t\tSQL_FUNCTION_MAP.put(\"JSONExtractFloat\", \"\"); //\n\t\tSQL_FUNCTION_MAP.put(\"JSONExtractBool\", \"\"); //\n\t\tSQL_FUNCTION_MAP.put(\"JSONExtractString\", \"\"); // 解析JSON并提取字符串。此函数类似于visitParamExtractString函数。\n\t\tSQL_FUNCTION_MAP.put(\"JSONExtract\", \"\"); // 解析JSON并提取给定ClickHouse数据类型的值。\n\t\tSQL_FUNCTION_MAP.put(\"JSONExtractKeysAndValues\", \"\"); // 从JSON中解析键值对，其中值是给定的ClickHouse数据类型\n\t\tSQL_FUNCTION_MAP.put(\"JSONExtractRaw\", \"\"); // 返回JSON的部分。\n\t\tSQL_FUNCTION_MAP.put(\"toJSONString\", \"\"); //\n\n\t\t// ClickHouse 类型转换函数\n\t\tSQL_FUNCTION_MAP.put(\"toInt8\", \"\"); // toInt8(expr) 转换一个输入值为Int类型\n\t\tSQL_FUNCTION_MAP.put(\"toInt16\", \"\");\n\t\tSQL_FUNCTION_MAP.put(\"toInt32\", \"\");\n\t\tSQL_FUNCTION_MAP.put(\"toInt64\", \"\");\n\t\tSQL_FUNCTION_MAP.put(\"toInt8OrZero\", \"\"); // toInt(8|16|32|64)OrZero 尝试把字符串转为 Int\n\t\tSQL_FUNCTION_MAP.put(\"toInt16OrZero\", \"\");\n\t\tSQL_FUNCTION_MAP.put(\"toInt32OrZero\", \"\");\n\t\tSQL_FUNCTION_MAP.put(\"toInt64OrZero\", \"\");\n\t\tSQL_FUNCTION_MAP.put(\"toInt8OrNull\", \"\");// toInt(8|16|32|64)O 尝试把字符串转为 Int\n\t\tSQL_FUNCTION_MAP.put(\"toInt16OrNull\", \"\");\n\t\tSQL_FUNCTION_MAP.put(\"toInt32OrNull\", \"\");\n\t\tSQL_FUNCTION_MAP.put(\"toInt64OrNull\", \"\");\n\t\tSQL_FUNCTION_MAP.put(\"toUInt8\", \"\"); // toInt8(expr) 转换一个输入值为Int类型\n\t\tSQL_FUNCTION_MAP.put(\"toUInt16\", \"\");\n\t\tSQL_FUNCTION_MAP.put(\"toUInt32\", \"\");\n\t\tSQL_FUNCTION_MAP.put(\"toUInt64\", \"\");\n\t\tSQL_FUNCTION_MAP.put(\"toUInt8OrZero\", \"\"); // toInt(8|16|32|64)OrZero 尝试把字符串转为 Int\n\t\tSQL_FUNCTION_MAP.put(\"toUInt16OrZero\", \"\");\n\t\tSQL_FUNCTION_MAP.put(\"toUInt32OrZero\", \"\");\n\t\tSQL_FUNCTION_MAP.put(\"toUInt64OrZero\", \"\");\n\t\tSQL_FUNCTION_MAP.put(\"toUInt8OrNull\", \"\"); // toInt(8|16|32|64)OrNull 尝试把字符串转为 Int\n\t\tSQL_FUNCTION_MAP.put(\"toUInt16OrNull\", \"\");\n\t\tSQL_FUNCTION_MAP.put(\"toUInt32OrNull\", \"\");\n\t\tSQL_FUNCTION_MAP.put(\"toUInt64OrNull\", \"\");\n\n\t\tSQL_FUNCTION_MAP.put(\"toFloat32\", \"\");\n\t\tSQL_FUNCTION_MAP.put(\"toFloat64\", \"\");\n\t\tSQL_FUNCTION_MAP.put(\"toFloat32OrZero\", \"\");\n\t\tSQL_FUNCTION_MAP.put(\"toFloat64OrZero\", \"\");\n\t\tSQL_FUNCTION_MAP.put(\"toFloat32OrNull\", \"\");\n\t\tSQL_FUNCTION_MAP.put(\"toFloat64OrNull\", \"\");\n\n\t\tSQL_FUNCTION_MAP.put(\"toDate\", \"\"); //\n\t\tSQL_FUNCTION_MAP.put(\"toDateOrZero\", \"\"); // toInt16(expr)\n\t\tSQL_FUNCTION_MAP.put(\"toDateOrNull\", \"\"); // toInt32(expr)\n\t\tSQL_FUNCTION_MAP.put(\"toDateTimeOrZero\", \"\"); // toInt64(expr) 尝试把字符串转为 DateTime\n\t\tSQL_FUNCTION_MAP.put(\"toDateTimeOrNull\", \"\"); // toInt(8|16|32|64) 尝试把字符串转为 DateTime\n\n\t\tSQL_FUNCTION_MAP.put(\"toDecimal32\", \"\");\n\t\tSQL_FUNCTION_MAP.put(\"toFixedString\", \"\"); // 将String类型的参数转换为FixedString(N)类型的值\n\t\tSQL_FUNCTION_MAP.put(\"toStringCutToZero\", \"\"); // 接受String或FixedString参数,返回String，其内容在找到的第一个零字节处被截断。\n\t\tSQL_FUNCTION_MAP.put(\"toDecimal256\", \"\");\n\t\tSQL_FUNCTION_MAP.put(\"toDecimal32OrNull\", \"\");\n\t\tSQL_FUNCTION_MAP.put(\"toDecimal64OrNull\", \"\");\n\t\tSQL_FUNCTION_MAP.put(\"toDecimal128OrNull\", \"\");\n\t\tSQL_FUNCTION_MAP.put(\"toDecimal256OrNull\", \"\");\n\t\tSQL_FUNCTION_MAP.put(\"toDecimal32OrZero\", \"\");\n\t\tSQL_FUNCTION_MAP.put(\"toDecimal64OrZero\", \"\");\n\t\tSQL_FUNCTION_MAP.put(\"toDecimal128OrZero\", \"\");\n\t\tSQL_FUNCTION_MAP.put(\"toDecimal256OrZero\", \"\");\n\n\t\tSQL_FUNCTION_MAP.put(\"toIntervalSecond\", \"\"); // 把一个数值类型的值转换为Interval类型的数据。\n\t\tSQL_FUNCTION_MAP.put(\"toIntervalMinute\", \"\");\n\t\tSQL_FUNCTION_MAP.put(\"toIntervalHour\", \"\");\n\t\tSQL_FUNCTION_MAP.put(\"toIntervalDay\", \"\");\n\t\tSQL_FUNCTION_MAP.put(\"toIntervalWeek\", \"\");\n\t\tSQL_FUNCTION_MAP.put(\"toIntervalMonth\", \"\");\n\t\tSQL_FUNCTION_MAP.put(\"toIntervalQuarter\", \"\");\n\t\tSQL_FUNCTION_MAP.put(\"toIntervalYear\", \"\");\n\t\tSQL_FUNCTION_MAP.put(\"parseDateTimeBestEffort\", \"\"); // 把String类型的时间日期转换为DateTime数据类型。\n\t\tSQL_FUNCTION_MAP.put(\"parseDateTimeBestEffortOrNull\", \"\");\n\t\tSQL_FUNCTION_MAP.put(\"parseDateTimeBestEffortOrZero\", \"\");\n\t\tSQL_FUNCTION_MAP.put(\"toLowCardinality\", \"\");\n\n\n\t\t// ClickHouse hash 函数\n\t\tSQL_FUNCTION_MAP.put(\"halfMD5\", \"\"); // 计算字符串的MD5。然后获取结果的前8个字节并将它们作为UInt64（大端）返回\n\t\tSQL_FUNCTION_MAP.put(\"MD5\", \"\"); // 计算字符串的MD5并将结果放入FixedString(16)中返回\n\n\t\t// ClickHouse ip 地址函数\n\t\tSQL_FUNCTION_MAP.put(\"IPv4NumToString\", \"\"); // 接受一个 UInt32（大端）表示的IPv4的地址，返回相应IPv4的字符串表现形式\n\t\tSQL_FUNCTION_MAP.put(\"IPv4StringToNum\", \"\"); // 与IPv4NumToString函数相反。如果IPv4地址格式无效，则返回0。\n\t\tSQL_FUNCTION_MAP.put(\"IPv6NumToString\", \"\"); // 接受FixedString(16)类型的二进制格式的IPv6地址。以文本格式返回此地址的字符串。\n\t\tSQL_FUNCTION_MAP.put(\"IPv6StringToNum\", \"\"); // 与IPv6NumToString的相反。如果IPv6地址格式无效，则返回空字节字符串。\n\t\tSQL_FUNCTION_MAP.put(\"IPv4ToIPv6\", \"\"); // 接受一个UInt32类型的IPv4地址，返回FixedString(16)类型的IPv6地址\n\t\tSQL_FUNCTION_MAP.put(\"cutIPv6\", \"\"); // 接受一个FixedString(16)类型的IPv6地址，返回 String，包含删除指定位之后的地址的文本格\n\t\tSQL_FUNCTION_MAP.put(\"toIPv4\", \"\"); // IPv4StringToNum()的别名，\n\t\tSQL_FUNCTION_MAP.put(\"toIPv6\", \"\"); // IPv6StringToNum()的别名\n\t\tSQL_FUNCTION_MAP.put(\"isIPAddressInRange\", \"\"); // 确定一个IP地址是否包含在以CIDR符号表示的网络中\n\n\t\t// ClickHouse Nullable 处理函数\n\t\tSQL_FUNCTION_MAP.put(\"isNull\", \"\"); // 检查参数是否为NULL。\n\t\tSQL_FUNCTION_MAP.put(\"isNotNull\", \"\"); // 检查参数是否不为 NULL.\n\t\tSQL_FUNCTION_MAP.put(\"ifNull\", \"\"); // 如果第一个参数为«NULL»，则返回第二个参数的值。\n\t\tSQL_FUNCTION_MAP.put(\"assumeNotNull\", \"\"); // 将可为空类型的值转换为非Nullable类型的值。\n\t\tSQL_FUNCTION_MAP.put(\"toNullable\", \"\"); // 将参数的类型转换为Nullable。\n\n\t\t// ClickHouse UUID 函数\n\t\tSQL_FUNCTION_MAP.put(\"generateUUIDv4\", \"\"); // 生成一个UUID\n\t\tSQL_FUNCTION_MAP.put(\"toUUID\", \"\"); // toUUID(x) 将String类型的值转换为UUID类型的值。\n\n\t\t// ClickHouse 系统函数\n\t\tSQL_FUNCTION_MAP.put(\"hostName\", \"\"); // hostName()回一个字符串，其中包含执行此函数的主机的名称。\n\t\tSQL_FUNCTION_MAP.put(\"getMacro\", \"\"); // 从服务器配置的宏部分获取指定值。\n\t\tSQL_FUNCTION_MAP.put(\"FQDN\", \"\"); // 返回完全限定的域名。\n\t\tSQL_FUNCTION_MAP.put(\"basename\", \"\"); // 提取字符串最后一个斜杠或反斜杠之后的尾随部分\n\t\tSQL_FUNCTION_MAP.put(\"currentUser\", \"\"); // 返回当前用户的登录。在分布式查询的情况下，将返回用户的登录，即发起的查询\n\t\tSQL_FUNCTION_MAP.put(\"version\", \"\"); // 以字符串形式返回服务器版本。\n\t\tSQL_FUNCTION_MAP.put(\"uptime\", \"\"); // 以秒为单位返回服务器的正常运行时间。\n\n\t\t// ClickHouse 数学函数\n\t\tSQL_FUNCTION_MAP.put(\"least\", \"\"); // least(a, b) 返回a和b中最小的值。\n\t\tSQL_FUNCTION_MAP.put(\"greatest\", \"\"); // greatest(a, b) 返回a和b的最大值。\n\t\tSQL_FUNCTION_MAP.put(\"plus\", \"\"); // plus(a, b), a + b operator¶计算数值的总和。\n\t\tSQL_FUNCTION_MAP.put(\"minus\", \"\"); // minus(a, b), a - b operator 计算数值之间的差，结果总是有符号的。\n\t\tSQL_FUNCTION_MAP.put(\"multiply\", \"\");// multiply(a, b), a * b operator 计算数值的乘积\n\t\tSQL_FUNCTION_MAP.put(\"divide\", \"\"); // divide(a, b), a / b operator 计算数值的商。结果类型始终是浮点类型\n\t\tSQL_FUNCTION_MAP.put(\"intDiv\", \"\"); // intDiv(a,b)计算数值的商，向下舍入取整（按绝对值）。\n\t\tSQL_FUNCTION_MAP.put(\"intDivOrZero\", \"\"); // intDivOrZero(a,b)与’intDiv’的不同之处在于它在除以零或将最小负数除以-1时返回零。\n\t\tSQL_FUNCTION_MAP.put(\"modulo\", \"\"); // modulo(a, b), a % b operator 计算除法后的余数。\n\t\tSQL_FUNCTION_MAP.put(\"moduloOrZero\", \"\"); // 和modulo不同之处在于，除以0时结果返回0\n\t\tSQL_FUNCTION_MAP.put(\"negate\", \"\"); // 通过改变数值的符号位对数值取反，结果总是有符号\n\t\tSQL_FUNCTION_MAP.put(\"gcd\", \"\"); // gcd(a,b) 返回数值的最大公约数。\n\t\tSQL_FUNCTION_MAP.put(\"lcm\", \"\"); // lcm(a,b) 返回数值的最小公倍数\n\t\tSQL_FUNCTION_MAP.put(\"e\", \"\"); // e() 返回一个接近数学常量e的Float64数字。\n\t\tSQL_FUNCTION_MAP.put(\"pi\", \"\"); // pi() 返回一个接近数学常量π的Float64数字。\n\t\tSQL_FUNCTION_MAP.put(\"exp2\", \"\"); // exp2(x)¶接受一个数值类型的参数并返回它的2的x次幂。\n\t\tSQL_FUNCTION_MAP.put(\"exp10\", \"\"); // exp10(x)¶接受一个数值类型的参数并返回它的10的x次幂。\n\t\tSQL_FUNCTION_MAP.put(\"cbrt\", \"\"); // cbrt(x) 接受一个数值类型的参数并返回它的立方根。\n\t\tSQL_FUNCTION_MAP.put(\"lgamma\", \"\"); // lgamma(x) 返回x的绝对值的自然对数的伽玛函数。\n\t\tSQL_FUNCTION_MAP.put(\"tgamma\", \"\"); // tgamma(x)¶返回x的伽玛函数。\n\t\tSQL_FUNCTION_MAP.put(\"intExp2\", \"\"); // intExp2 接受一个数值类型的参数并返回它的2的x次幂（UInt64）\n\t\tSQL_FUNCTION_MAP.put(\"intExp10\", \"\"); // intExp10 接受一个数值类型的参数并返回它的10的x次幂（UInt64）。\n\t\tSQL_FUNCTION_MAP.put(\"cosh\", \"\"); // cosh(x)\n\t\tSQL_FUNCTION_MAP.put(\"sinh\", \"\"); // sinh(x)\n\t\tSQL_FUNCTION_MAP.put(\"asinh\", \"\"); // asinh(x)\n\t\tSQL_FUNCTION_MAP.put(\"atanh\", \"\"); // atanh(x)\n\t\tSQL_FUNCTION_MAP.put(\"atan2\", \"\"); // atan2(y, x)\n\t\tSQL_FUNCTION_MAP.put(\"hypot\", \"\"); // hypot(x, y)\n\t\tSQL_FUNCTION_MAP.put(\"log1p\", \"\"); // log1p(x)\n\t\tSQL_FUNCTION_MAP.put(\"trunc\", \"\"); // 和 truncate 一样\n\t\tSQL_FUNCTION_MAP.put(\"roundToExp2\", \"\"); // roundToExp2(num) 接受一个数字。如果数字小于1，它返回0。\n\t\tSQL_FUNCTION_MAP.put(\"roundDuration\", \"\"); // roundDuration(num) 接受一个数字。如果数字小于1，它返回0。\n\t\tSQL_FUNCTION_MAP.put(\"roundAge\", \"\"); // roundAge(age) 接受一个数字。如果数字小于18，它返回0。\n\t\tSQL_FUNCTION_MAP.put(\"roundDown\", \"\"); // roundDown(num, arr) 接受一个数字并将其舍入到指定数组中的一个元素\n\t\tSQL_FUNCTION_MAP.put(\"bitAnd\", \"\"); // bitAnd(a,b)\n\t\tSQL_FUNCTION_MAP.put(\"bitOr\", \"\"); // bitOr(a,b)\n\n\t\t// PostgreSQL 表结构相关 SQL 函数\n\t\tSQL_FUNCTION_MAP.put(\"obj_description\", \"\");\n\t\tSQL_FUNCTION_MAP.put(\"col_description\", \"\");\n\n\t\t// SQLServer 相关 SQL 函数\n\t\tSQL_FUNCTION_MAP.put(\"len\", \"\");\n\t\tSQL_FUNCTION_MAP.put(\"datalength\", \"\");\n\n\t\t// Milvus 相关 SQL 函数\n\t\tSQL_FUNCTION_MAP.put(\"vMatch\", \"\");\n\t\tSQL_FUNCTION_MAP.put(\"consistencyLevel\", \"\");\n\t\tSQL_FUNCTION_MAP.put(\"partitionBy\", \"\");\n\t\tSQL_FUNCTION_MAP.put(\"gracefulTime\", \"\");\n\t\tSQL_FUNCTION_MAP.put(\"guaranteeTimestamp\", \"\");\n\t\tSQL_FUNCTION_MAP.put(\"roundDecimal\", \"\");\n\t\tSQL_FUNCTION_MAP.put(\"travelTimestamp\", \"\");\n\t\tSQL_FUNCTION_MAP.put(\"nProbe\", \"\");\n\t\tSQL_FUNCTION_MAP.put(\"ef\", \"\");\n\t\tSQL_FUNCTION_MAP.put(\"searchK\", \"\");\n\n\t}\n\n\tprivate Parser parser;\n\t@Override\n\tpublic Parser gainParser() {\n\t\tif (parser == null && objectParser != null) {\n\t\t\tparser = objectParser.getParser();\n\t\t}\n\t\treturn parser;\n\t}\n\t@Override\n\tpublic AbstractSQLConfig setParser(Parser parser) {\n\t\tthis.parser = parser;\n\t\treturn this;\n\t}\n\tpublic AbstractSQLConfig putWarnIfNeed(String type, String warn) {\n\t\tif (Log.DEBUG && parser instanceof AbstractParser) {\n\t\t\t((AbstractParser) parser).putWarnIfNeed(type, warn);\n\t\t}\n\t\treturn this;\n\t}\n\tpublic AbstractSQLConfig putWarn(String type, String warn) {\n\t\tif (Log.DEBUG && parser instanceof AbstractParser) {\n\t\t\t((AbstractParser) parser).putWarn(type, warn);\n\t\t}\n\t\treturn this;\n\t}\n\n\tprivate ObjectParser objectParser;\n\t@Override\n\tpublic ObjectParser gainObjectParser() {\n\t\treturn objectParser;\n\t}\n\t@Override\n\tpublic AbstractSQLConfig setObjectParser(ObjectParser objectParser) {\n\t\tthis.objectParser = objectParser;\n\t\treturn this;\n\t}\n\n\tprivate int version;\n\t@Override\n\tpublic int getVersion() {\n\t\tif (version <= 0 && parser != null) {\n\t\t\tversion = parser.getVersion();\n\t\t}\n\t\treturn version;\n\t}\n\t@Override\n\tpublic AbstractSQLConfig setVersion(int version) {\n\t\tthis.version = version;\n\t\treturn this;\n\t}\n\n\tprivate String tag;\n\t@Override\n\tpublic String getTag() {\n\t\tif (StringUtil.isEmpty(tag) && parser != null) {\n\t\t\ttag = parser.getTag();\n\t\t}\n\t\treturn tag;\n\t}\n\t@Override\n\tpublic AbstractSQLConfig setTag(String tag) {\n\t\tthis.tag = tag;\n\t\treturn this;\n\t}\n\n\t// mysql8版本以上,子查询支持with as表达式\n\tprivate List withAsExprSQLList = null;\n\tprotected List withAsExprPreparedValueList = new ArrayList<>();\n\tprivate int[] dbVersionNums = null;\n\t@Override\n\tpublic int[] gainDBVersionNums() {\n\t\tif (dbVersionNums == null || dbVersionNums.length <= 0) {\n\t\t\tdbVersionNums = SQLConfig.super.gainDBVersionNums();\n\t\t}\n\t\treturn dbVersionNums;\n\t}\n\n\t@Override\n\tpublic boolean limitSQLCount() {\n\t\treturn AbstractVerifier.SYSTEM_ACCESS_MAP.containsKey(getTable()) == false;\n\t}\n\t@Override\n\tpublic boolean allowPartialUpdateFailed() {\n\t\treturn allowPartialUpdateFailed(getTable());\n\t}\n\tpublic static boolean allowPartialUpdateFailed(String table) {\n\t\treturn ALLOW_PARTIAL_UPDATE_FAIL_TABLE_MAP.containsKey(table);\n\t}\n\n\t@NotNull\n\t@Override\n\tpublic String getIdKey() {\n\t\treturn KEY_ID;\n\t}\n\t@NotNull\n\t@Override\n\tpublic String getUserIdKey() {\n\t\treturn KEY_USER_ID;\n\t}\n\n\tprivate RequestMethod method; //操作方法\n\tprivate boolean prepared = true; //预编译\n\tprivate boolean main = true;\n\n\tprivate Object id; // Table 的 id\n\tprivate Object idIn; // User Table 的 id IN\n\tprivate Object userId; // Table 的 userId\n\tprivate Object userIdIn; // Table 的 userId IN\n\n\t/**\n\t * TODO 被关联的表通过就忽略关联的表？(这个不行 User:{\"sex@\":\"/Comment/toId\"})\n\t */\n\tprivate String role; //发送请求的用户的角色\n\tprivate boolean distinct = false;\n\tprivate String database; //表所在的数据库类型\n\tprivate String namespace; //表所在的命名空间\n\tprivate String catalog; //表所在的目录\n\tprivate String schema; //表所在的数据库名\n\tprivate String datasource; //数据源\n\tprivate String table; //表名\n\tprivate String alias; //表别名\n\tprivate String group; //分组方式的字符串数组，','分隔\n\tprivate String havingCombine; //聚合函数的字符串数组，','分隔\n\tprivate Map having; //聚合函数的字符串数组，','分隔\n\tprivate String sample; //取样方式的字符串数组，','分隔\n\tprivate String latest; //最近方式的字符串数组，','分隔\n\tprivate String partition; //分区方式的字符串数组，','分隔\n\tprivate String fill; //填充方式的字符串数组，','分隔\n\tprivate String order; //排序方式的字符串数组，','分隔\n\n\tprivate Map keyMap; //字段名映射，支持 name_tag:(name,tag) 多字段 IN，year:left(date,4) 截取日期年份等\n\tprivate List raw; //需要保留原始 SQL 的字段，','分隔\n\tprivate List json; //需要转为 JSON 的字段，','分隔\n\tprivate Subquery from; //子查询临时表\n\tprivate List column; //表内字段名(或函数名，仅查询操作可用)的字符串数组，','分隔\n\tprivate List> values; //对应表内字段的值的字符串数组，','分隔\n\tprivate List nulls;\n\tprivate Map cast;\n\tprivate Map content; //Request内容，key:value形式，column = content.keySet()，values = content.values()\n\tprivate Map where; //筛选条件，key:value形式\n\tprivate String combine; //条件组合， a | (b & c & !(d | !e))\n\tprivate Map> combineMap; //条件组合，{ \"&\":[key], \"|\":[key], \"!\":[key] }\n\n\t//array item <<<<<<<<<<\n\tprivate int count; //Table数量\n\tprivate int page; //Table所在页码\n\tprivate int position; //Table在[]中的位置\n\tprivate int query; //apijson.JSONRequest.QUERY\n\tprivate Boolean compat; //apijson.JSONMap.compat query total\n\tprivate int type; //ObjectParser.type\n\tprivate int cache;\n\tprivate boolean explain;\n\n\tprivate List> joinList; //连表 配置列表\n\t//array item >>>>>>>>>>\n\tprivate boolean test; //测试\n\n\tprivate String procedure;\n\n\tpublic AbstractSQLConfig setProcedure(String procedure) {\n\t\tthis.procedure = procedure;\n\t\treturn this;\n\t}\n\tpublic String getProcedure() {\n\t\treturn procedure;\n\t}\n\n\tpublic AbstractSQLConfig(RequestMethod method) {\n\t\tsetMethod(method);\n\t}\n\tpublic AbstractSQLConfig(RequestMethod method, String table) {\n\t\tthis(method);\n\t\tsetTable(table);\n\t}\n\tpublic AbstractSQLConfig(RequestMethod method, int count, int page) {\n\t\tthis(method);\n\t\tsetCount(count);\n\t\tsetPage(page);\n\t}\n\n\t@NotNull\n\t@Override\n\tpublic RequestMethod getMethod() {\n\t\tif (method == null) {\n\t\t\tmethod = GET;\n\t\t}\n\t\treturn method;\n\t}\n\t@Override\n\tpublic AbstractSQLConfig setMethod(RequestMethod method) {\n\t\tthis.method = method;\n\t\treturn this;\n\t}\n\t@Override\n\tpublic boolean isPrepared() {\n\t\treturn prepared && ! isMongoDB(); // MongoDB JDBC 还不支持预编译;\n\t}\n\t@Override\n\tpublic AbstractSQLConfig setPrepared(boolean prepared) {\n\t\tthis.prepared = prepared;\n\t\treturn this;\n\t}\n\t@Override\n\tpublic boolean isMain() {\n\t\treturn main;\n\t}\n\t@Override\n\tpublic AbstractSQLConfig setMain(boolean main) {\n\t\tthis.main = main;\n\t\treturn this;\n\t}\n\n\n\t@Override\n\tpublic Object getId() {\n\t\treturn id;\n\t}\n\t@Override\n\tpublic AbstractSQLConfig setId(Object id) {\n\t\tthis.id = id;\n\t\treturn this;\n\t}\n\n\t@Override\n\tpublic Object getIdIn() {\n\t\treturn idIn;\n\t}\n\t@Override\n\tpublic AbstractSQLConfig setIdIn(Object idIn) {\n\t\tthis.idIn = idIn;\n\t\treturn this;\n\t}\n\n\n\t@Override\n\tpublic Object getUserId() {\n\t\treturn userId;\n\t}\n\t@Override\n\tpublic AbstractSQLConfig setUserId(Object userId) {\n\t\tthis.userId = userId;\n\t\treturn this;\n\t}\n\n\t@Override\n\tpublic Object getUserIdIn() {\n\t\treturn userIdIn;\n\t}\n\t@Override\n\tpublic AbstractSQLConfig setUserIdIn(Object userIdIn) {\n\t\tthis.userIdIn = userIdIn;\n\t\treturn this;\n\t}\n\n\t@Override\n\tpublic String getRole() {\n\t\t//不能 @NotNull , AbstractParser#getSQLObject 内当getRole() == null时填充默认值\n\t\treturn role;\n\t}\n\t@Override\n\tpublic AbstractSQLConfig setRole(String role) {\n\t\tthis.role = role;\n\t\treturn this;\n\t}\n\n\t@Override\n\tpublic boolean isDistinct() {\n\t\treturn distinct;\n\t}\n\t@Override\n\tpublic AbstractSQLConfig setDistinct(boolean distinct) {\n\t\tthis.distinct = distinct;\n\t\treturn this;\n\t}\n\n\t@Override\n\tpublic String getDatabase() {\n\t\treturn database;\n\t}\n\t@Override\n\tpublic AbstractSQLConfig setDatabase(String database) {\n\t\tthis.database = database;\n\t\treturn this;\n\t}\n\t/**\n\t * @return db == null ? DEFAULT_DATABASE : db\n\t */\n\t@NotNull\n\tpublic String gainSQLDatabase() {\n\t\tString db = getDatabase();\n\t\treturn db == null ? DEFAULT_DATABASE : db; // \"\" 表示已设置，不需要用全局默认的 StringUtil.isEmpty(db, false)) {\n\t}\n\n\t@Override\n\tpublic boolean isTSQL() { // 兼容 TSQL 语法\n\t\treturn isOracle() || isSQLServer() || isDb2();\n\t}\n\t@Override\n\tpublic boolean isMSQL() { // 兼容 MySQL 语法，但不一定可以使用它的 JDBC/ODBC\n\t\treturn isMySQL() || isTiDB() || isMariaDB() || isSQLite() || isTDengine();\n\t}\n\t@Override\n\tpublic boolean isPSQL() { // 兼容 PostgreSQL 语法，但不一定可以使用它的 JDBC/ODBC\n\t\treturn isPostgreSQL() || isCockroachDB() || isOpenGauss() || isInfluxDB() || isTimescaleDB() || isQuestDB() || isDuckDB();\n\t}\n\n\t@Override\n\tpublic boolean isMySQL() {\n\t\treturn isMySQL(gainSQLDatabase());\n\t}\n\tpublic static boolean isMySQL(String db) {\n\t\treturn DATABASE_MYSQL.equals(db);\n\t}\n\n\t@Override\n\tpublic boolean isPostgreSQL() {\n\t\treturn isPostgreSQL(gainSQLDatabase());\n\t}\n\tpublic static boolean isPostgreSQL(String db) {\n\t\treturn DATABASE_POSTGRESQL.equals(db);\n\t}\n\n\t@Override\n\tpublic boolean isSQLServer() {\n\t\treturn isSQLServer(gainSQLDatabase());\n\t}\n\tpublic static boolean isSQLServer(String db) {\n\t\treturn DATABASE_SQLSERVER.equals(db);\n\t}\n\n\t@Override\n\tpublic boolean isOracle() {\n\t\treturn isOracle(gainSQLDatabase());\n\t}\n\tpublic static boolean isOracle(String db) {\n\t\treturn DATABASE_ORACLE.equals(db);\n\t}\n\n\t@Override\n\tpublic boolean isDb2() {\n\t\treturn isDb2(gainSQLDatabase());\n\t}\n\tpublic static boolean isDb2(String db) {\n\t\treturn DATABASE_DB2.equals(db);\n\t}\n\n\t@Override\n\tpublic boolean isMariaDB() {\n\t\treturn isMariaDB(gainSQLDatabase());\n\t}\n\tpublic static boolean isMariaDB(String db) {\n\t\treturn DATABASE_MARIADB.equals(db);\n\t}\n\n\t@Override\n\tpublic boolean isTiDB() {\n\t\treturn isTiDB(gainSQLDatabase());\n\t}\n\tpublic static boolean isTiDB(String db) {\n\t\treturn DATABASE_TIDB.equals(db);\n\t}\n\n\t@Override\n\tpublic boolean isCockroachDB() {\n\t\treturn isCockroachDB(gainSQLDatabase());\n\t}\n\tpublic static boolean isCockroachDB(String db) {\n\t\treturn DATABASE_COCKROACHDB.equals(db);\n\t}\n\n\t@Override\n\tpublic boolean isDameng() {\n\t\treturn isDameng(gainSQLDatabase());\n\t}\n\tpublic static boolean isDameng(String db) {\n\t\treturn DATABASE_DAMENG.equals(db);\n\t}\n\n\t@Override\n\tpublic boolean isKingBase() {\n\t\treturn isKingBase(gainSQLDatabase());\n\t}\n\tpublic static boolean isKingBase(String db) {\n\t\treturn DATABASE_KINGBASE.equals(db);\n\t}\n\n\t@Override\n\tpublic boolean isElasticsearch() {\n\t\treturn isElasticsearch(gainSQLDatabase());\n\t}\n\tpublic static boolean isElasticsearch(String db) {\n\t\treturn DATABASE_ELASTICSEARCH.equals(db);\n\t}\n\n\t@Override\n\tpublic boolean isManticore() {\n\t\treturn isManticore(gainSQLDatabase());\n\t}\n\tpublic static boolean isManticore(String db) {\n\t\treturn DATABASE_MANTICORE.equals(db);\n\t}\n\n\t@Override\n\tpublic boolean isClickHouse() {\n\t\treturn isClickHouse(gainSQLDatabase());\n\t}\n\tpublic static boolean isClickHouse(String db) {\n\t\treturn DATABASE_CLICKHOUSE.equals(db);\n\t}\n\n\t@Override\n\tpublic boolean isHive() {\n\t\treturn isHive(gainSQLDatabase());\n\t}\n\tpublic static boolean isHive(String db) {\n\t\treturn DATABASE_HIVE.equals(db);\n\t}\n\n\t@Override\n\tpublic boolean isPresto() {\n\t\treturn isPresto(gainSQLDatabase());\n\t}\n\tpublic static boolean isPresto(String db) {\n\t\treturn DATABASE_PRESTO.equals(db);\n\t}\n\n\t@Override\n\tpublic boolean isTrino() {\n\t\treturn isTrino(gainSQLDatabase());\n\t}\n\tpublic static boolean isTrino(String db) {\n\t\treturn DATABASE_TRINO.equals(db);\n\t}\n\n\t@Override\n\tpublic boolean isSnowflake() {\n\t\treturn isSnowflake(gainSQLDatabase());\n\t}\n\tpublic static boolean isSnowflake(String db) {\n\t\treturn DATABASE_SNOWFLAKE.equals(db);\n\t}\n\n\t@Override\n\tpublic boolean isDatabend() {\n\t\treturn isDatabend(gainSQLDatabase());\n\t}\n\tpublic static boolean isDatabend(String db) {\n\t\treturn DATABASE_DATABEND.equals(db);\n\t}\n\n\t@Override\n\tpublic boolean isDatabricks() {\n\t\treturn isDatabricks(gainSQLDatabase());\n\t}\n\tpublic static boolean isDatabricks(String db) {\n\t\treturn DATABASE_DATABRICKS.equals(db);\n\t}\n\n\t@Override\n\tpublic boolean isCassandra() {\n\t\treturn isCassandra(gainSQLDatabase());\n\t}\n\tpublic static boolean isCassandra(String db) {\n\t\treturn DATABASE_CASSANDRA.equals(db);\n\t}\n\n\t@Override\n\tpublic boolean isMilvus() {\n\t\treturn isMilvus(gainSQLDatabase());\n\t}\n\tpublic static boolean isMilvus(String db) {\n\t\treturn DATABASE_MILVUS.equals(db);\n\t}\n\n\t@Override\n\tpublic boolean isInfluxDB() {\n\t\treturn isInfluxDB(gainSQLDatabase());\n\t}\n\tpublic static boolean isInfluxDB(String db) {\n\t\treturn DATABASE_INFLUXDB.equals(db);\n\t}\n\n\t@Override\n\tpublic boolean isTDengine() {\n\t\treturn isTDengine(gainSQLDatabase());\n\t}\n\tpublic static boolean isTDengine(String db) {\n\t\treturn DATABASE_TDENGINE.equals(db);\n\t}\n\n\t@Override\n\tpublic boolean isTimescaleDB() {\n\t\treturn isTimescaleDB(gainSQLDatabase());\n\t}\n\tpublic static boolean isTimescaleDB(String db) {\n\t\treturn DATABASE_TIMESCALEDB.equals(db);\n\t}\n\n\t@Override\n\tpublic boolean isQuestDB() {\n\t\treturn isQuestDB(gainSQLDatabase());\n\t}\n\tpublic static boolean isQuestDB(String db) {\n\t\treturn DATABASE_QUESTDB.equals(db);\n\t}\n\n\n\tpublic boolean isIoTDB() {\n\t\treturn isIoTDB(getDatabase());\n\t}\n\tpublic static boolean isIoTDB(String db) {\n\t\treturn DATABASE_IOTDB.equals(db);\n\t}\n\n\n\t@Override\n\tpublic boolean isRedis() {\n\t\treturn isRedis(gainSQLDatabase());\n\t}\n\tpublic static boolean isRedis(String db) {\n\t\treturn DATABASE_REDIS.equals(db);\n\t}\n\n\t@Override\n\tpublic boolean isMongoDB() {\n\t\treturn isMongoDB(gainSQLDatabase());\n\t}\n\tpublic static boolean isMongoDB(String db) {\n\t\treturn DATABASE_MONGODB.equals(db);\n\t}\n\n\t@Override\n\tpublic boolean isKafka() {\n\t\treturn isKafka(gainSQLDatabase());\n\t}\n\tpublic static boolean isKafka(String db) {\n\t\treturn DATABASE_KAFKA.equals(db);\n\t}\n\n\t@Override\n\tpublic boolean isMQ() {\n\t\treturn isMQ(gainSQLDatabase());\n\t}\n\tpublic static boolean isMQ(String db) {\n\t\treturn DATABASE_MQ.equals(db) || isKafka(db);\n\t}\n\n\t@Override\n\tpublic boolean isSQLite() {\n\t\treturn isSQLite(gainSQLDatabase());\n\t}\n\tpublic static boolean isSQLite(String db) {\n\t\treturn DATABASE_SQLITE.equals(db);\n\t}\n\n\t@Override\n\tpublic boolean isDuckDB() {\n\t\treturn isDuckDB(gainSQLDatabase());\n\t}\n\tpublic static boolean isDuckDB(String db) {\n\t\treturn DATABASE_DUCKDB.equals(db);\n\t}\n\n\t@Override\n\tpublic boolean isSurrealDB() {\n\t\treturn isSurrealDB(gainSQLDatabase());\n\t}\n\tpublic static boolean isSurrealDB(String db) {\n\t\treturn DATABASE_SURREALDB.equals(db);\n\t}\n\n\t@Override\n\tpublic boolean isOpenGauss() {\n\t\treturn isOpenGauss(gainSQLDatabase());\n\t}\n\tpublic static boolean isOpenGauss(String db) {\n\t\treturn DATABASE_OPENGAUSS.equals(db);\n\t}\n\n\t@Override\n\tpublic boolean isDoris() {\n\t\treturn isDoris(gainSQLDatabase());\n\t}\n\tpublic static boolean isDoris(String db) {\n\t\treturn DATABASE_DORIS.equals(db);\n\t}\n\n\t@Override\n\tpublic String getQuote() { // MongoDB 同时支持 `tbl` 反引号 和 \"col\" 双引号\n\t\tif(isElasticsearch() || isManticore() || isIoTDB() || isSurrealDB()) {\n\t\t\treturn \"\";\n\t\t}\n\t\treturn isMySQL() || isMariaDB() || isTiDB() || isClickHouse() || isTDengine() || isMilvus() || isDoris() ? \"`\" : \"\\\"\";\n\t}\n\n\tpublic String quote(String s) {\n\t\tString q = getQuote();\n\t\treturn q + s + q;\n\t}\n\n\t@Override\n\tpublic String getSQLNamespace() {\n\t\tString sch = getNamespace(); // 前端传参 @namespace 优先\n\t\treturn sch == null ? DEFAULT_NAMESPACE : sch; // 最后代码默认兜底配置\n\t}\n\n\t@Override\n\tpublic String getNamespace() {\n\t\treturn namespace;\n\t}\n\n\t@Override\n\tpublic AbstractSQLConfig setNamespace(String namespace) {\n\t\tthis.namespace = namespace;\n\t\treturn this;\n\t}\n\n\n\t@Override\n\tpublic String gainSQLCatalog() {\n\t\tString catalog = getCatalog(); // 前端传参 @catalog 优先\n\t\treturn catalog == null ? DEFAULT_CATALOG : catalog; // 最后代码默认兜底配置\n\t}\n\n\t@Override\n\tpublic String getCatalog() {\n\t\treturn catalog;\n\t}\n\n\t@Override\n\tpublic AbstractSQLConfig setCatalog(String catalog) {\n\t\tthis.catalog = catalog;\n\t\treturn this;\n\t}\n\n\t@NotNull\n\t@Override\n\tpublic String gainSQLSchema() {\n\t\tString table = getTable();\n\t\t// FIXME 全部默认填充判断是 系统表 则不填充 // 强制，避免因为全局默认的 @schema 自动填充进来，导致这几个类的 schema 为 sys 等其它值\n\t\tif (Table.TAG.equals(table) || Column.TAG.equals(table)) {\n\t\t\treturn SCHEMA_INFORMATION; //MySQL, PostgreSQL, SQL Server 都有的\n\t\t}\n\t\tif (PgClass.TAG.equals(table) || PgAttribute.TAG.equals(table)) {\n\t\t\treturn \"\"; //PostgreSQL 的 pg_class 和 pg_attribute 表好像不属于任何 Schema\n\t\t}\n\t\tif (SysTable.TAG.equals(table) || SysColumn.TAG.equals(table) || ExtendedProperty.TAG.equals(table)) {\n\t\t\treturn SCHEMA_SYS; //SQL Server 在 sys 中的属性比 information_schema 中的要全，能拿到注释\n\t\t}\n\t\tif (AllTable.TAG.equals(table) || AllColumn.TAG.equals(table)\n\t\t\t\t|| AllTableComment.TAG.equals(table) || AllColumnComment.TAG.equals(table)) {\n\t\t\treturn \"\"; //Oracle, Dameng 的 all_tables, dba_tables 和 all_tab_columns, dba_columns 表好像不属于任何 Schema\n\t\t}\n\n\t\tString sch = getSchema(); // 前端传参 @schema 优先\n\t\tif (sch == null) {\n\t\t\tsch = TABLE_SCHEMA_MAP.get(table); // 其次 Access 表 alias 和 schema 配置\n\t\t}\n\t\treturn sch == null ? DEFAULT_SCHEMA : sch; // 最后代码默认兜底配置\n\t}\n\n\t@Override\n\tpublic String getSchema() {\n\t\treturn schema;\n\t}\n\n\t@Override\n\tpublic AbstractSQLConfig setSchema(String schema) {\n\t\tif (schema != null) {\n\t\t\tAbstractFunctionParser.verifySchema(schema, getTable());\n\t\t}\n\t\tthis.schema = schema;\n\t\treturn this;\n\t}\n\n\t@Override\n\tpublic String getDatasource() {\n\t\treturn datasource;\n\t}\n\t@Override\n\tpublic AbstractSQLConfig setDatasource(String datasource) {\n\t\tthis.datasource = datasource;\n\t\treturn this;\n\t}\n\n\t/**请求传进来的Table名\n\t * @return\n\t * @see {@link #gainSQLTable()}\n\t */\n\t@Override\n\tpublic String getTable() {\n\t\treturn table;\n\t}\n\t/**数据库里的真实Table名\n\t * 通过 {@link #TABLE_KEY_MAP} 映射\n\t * @return\n\t */\n\t@Override\n\tpublic String gainSQLTable() {\n\t\t// 如果要强制小写，则可在子类重写这个方法再 toLowerCase\n\t\t// return DATABASE_POSTGRESQL.equals(getDatabase()) ? t.toLowerCase() : t;\n\t\tString ot = getTable();\n\t\tString nt = TABLE_KEY_MAP.get(ot);\n\t\treturn StringUtil.isEmpty(nt) ? ot : nt;\n\t}\n\n\n\t@Override\n\tpublic String gainTablePath() {\n\t\tString q = getQuote();\n\n\t\tString ns = isSurrealDB() ? getSQLNamespace() : null;\n\t\tString cl = isPSQL() ? gainSQLCatalog() : null;\n\t\tString sch = gainSQLSchema();\n\t\tString sqlTable = gainSQLTable();\n\n\t\treturn (StringUtil.isEmpty(ns, true) ? \"\" : q + ns + q + \".\")\n\t\t\t\t+ (StringUtil.isEmpty(cl, true) ? \"\" : q + cl + q + \".\")\n\t\t\t\t+ (StringUtil.isEmpty(sch, true) ? \"\" : q + sch + q + \".\")\n\t\t\t\t+ q + sqlTable + q + (isKeyPrefix() ? gainAs() + q + gainSQLAlias() + q : \"\");\n\t}\n\t@Override\n\tpublic AbstractSQLConfig setTable(String table) { //Table已经在Parser中校验，所以这里不用防SQL注入\n\t\tthis.table = table;\n\t\treturn this;\n\t}\n\n\tpublic String gainAs() {\n\t\treturn isOracle() || isManticore() ? \" \" : \" AS \";\n\t}\n\n\t@Override\n\tpublic String getAlias() {\n\t\treturn alias;\n\t}\n\t@Override\n\tpublic AbstractSQLConfig setAlias(String alias) {\n\t\tthis.alias = alias;\n\t\treturn this;\n\t}\n\tpublic String gainSQLAliasWithQuote() {\n\t\tString a = gainSQLAlias();\n\t\tString q = getQuote();\n\t\t// getTable 不能小写，因为Verifier用大小写敏感的名称判断权限\n\t\t// 如果要强制小写，则可在子类重写这个方法再 toLowerCase\n\t\t// return q + (DATABASE_POSTGRESQL.equals(getDatabase()) ? a.toLowerCase() : a) + q;\n\t\treturn q + a + q;\n\t}\n\n\t@Override\n\tpublic String getGroup() {\n\t\treturn group;\n\t}\n\tpublic AbstractSQLConfig setGroup(String... keys) {\n\t\treturn setGroup(StringUtil.get(keys));\n\t}\n\t@Override\n\tpublic AbstractSQLConfig setGroup(String group) {\n\t\tthis.group = group;\n\t\treturn this;\n\t}\n\n\tpublic String gainGroupString(boolean hasPrefix) {\n\t\t//加上子表的 group\n\t\tString joinGroup = \"\";\n\t\tif (joinList != null) {\n\t\t\tboolean first = true;\n\t\t\tfor (Join join : joinList) {\n\t\t\t\tif (join.isAppJoin()) {\n\t\t\t\t\tcontinue;\n\t\t\t\t}\n\n\t\t\t\tSQLConfig ocfg = join.getOnConfig();\n\t\t\t\tSQLConfig cfg = (ocfg != null && ocfg.getGroup() != null) || join.isLeftOrRightJoin() ? ocfg : join.getJoinConfig();\n\n\t\t\t\tif (cfg != null) {\n\t\t\t\t\tcfg.setMain(false).setKeyPrefix(true);\n\t\t\t\t\t//if (StringUtil.isEmpty(cfg.getAlias(), true)) {\n\t\t\t\t\t//\tcfg.setAlias(cfg.getTable());\n\t\t\t\t\t//}\n\t\t\t\t\tString c = ((AbstractSQLConfig) cfg).gainGroupString(false);\n\n\t\t\t\t\tif (StringUtil.isNotEmpty(c, true)) {\n\t\t\t\t\t\tjoinGroup += (first ? \"\" : \", \") + c;\n\t\t\t\t\t\tfirst = false;\n\t\t\t\t\t}\n\t\t\t\t}\n\n\t\t\t\t////先处理左/右关联，内关联忽略\n\t\t\t\t//SQLConfig outerConfig = join.getOuterConfig();\n\t\t\t\t//SQLConfig outerConfig2 = (outerConfig != null && outerConfig.getGroup() != null) || join.isLeftOrRightJoin() ? outerConfig : null;\n\t\t\t\t//\n\t\t\t\t//if (outerConfig2 != null) {\n\t\t\t\t//\touterConfig2.setMain(false).setKeyPrefix(true);\n\t\t\t\t//\t//if (StringUtil.isEmpty(cfg.getAlias(), true)) {\n\t\t\t\t//\t//\tcfg.setAlias(cfg.getTable());\n\t\t\t\t//\t//}\n\t\t\t\t//\tString c = ((AbstractSQLConfig) outerConfig2).gainGroupString(false);\n\t\t\t\t//\n\t\t\t\t//\tif (StringUtil.isNotEmpty(c, true)) {\n\t\t\t\t//\t\tjoinGroup += (first ? \"\" : \", \") + c;\n\t\t\t\t//\t\tfirst = false;\n\t\t\t\t//\t}\n\t\t\t\t//}\n\t\t\t}\n\t\t}\n\n\n\t\tgroup = StringUtil.trim(group);\n\t\tString[] keys = StringUtil.split(group);\n\t\tif (keys == null || keys.length <= 0) {\n\t\t\treturn StringUtil.isEmpty(joinGroup, true) ? \"\" : (hasPrefix ? \" GROUP BY \" : \"\") + joinGroup;\n\t\t}\n\n\t\tfor (int i = 0; i < keys.length; i++) {\n\t\t\tif (isPrepared()) {\n\t\t\t\t// 不能通过 ? 来代替，因为SQLExecutor statement.setString后 GROUP BY 'userId' 有单引号，只能返回一条数据，必须去掉单引号才行！\n\t\t\t\tif (StringUtil.isName(keys[i]) == false) {\n\t\t\t\t\tthrow new IllegalArgumentException(\"@group:value 中 value里面用 , 分割的每一项都必须是1个单词！并且不要有空格！\");\n\t\t\t\t}\n\t\t\t}\n\n\t\t\tkeys[i] = gainKey(keys[i]);\n\t\t}\n\n\t\treturn (hasPrefix ? \" GROUP BY \" : \"\") + StringUtil.concat(StringUtil.get(keys), joinGroup, \", \");\n\t}\n\n\t@Override\n\tpublic String getHavingCombine() {\n\t\treturn havingCombine;\n\t}\n\t@Override\n\tpublic AbstractSQLConfig setHavingCombine(String havingCombine) {\n\t\tthis.havingCombine = havingCombine;\n\t\treturn this;\n\t}\n\n\t@Override\n\tpublic Map getHaving() {\n\t\treturn having;\n\t}\n\t@Override\n\tpublic AbstractSQLConfig setHaving(Map having) {\n\t\tthis.having = having;\n\t\treturn this;\n\t}\n\tpublic AbstractSQLConfig setHaving(String... conditions) {\n\t\treturn setHaving(StringUtil.get(conditions));\n\t}\n\n\t/**TODO @having 改为默认 | 或连接，且支持 @having: { \"key1>\": 1, \"key{}\": \"length(key2)>0\", \"@combine\": \"key1,key2\" }\n\t * @return HAVING conditoin0 AND condition1 OR condition2 ...\n\t * @throws Exception\n\t */\n\tpublic String gainHavingString(boolean hasPrefix) throws Exception {\n\t\t//加上子表的 having\n\t\tString joinHaving = \"\";\n\t\tif (joinList != null) {\n\t\t\tboolean first = true;\n\t\t\tfor (Join join : joinList) {\n\t\t\t\tif (join.isAppJoin()) {\n\t\t\t\t\tcontinue;\n\t\t\t\t}\n\n\t\t\t\tSQLConfig ocfg = join.getOnConfig();\n\t\t\t\tSQLConfig cfg = (ocfg != null && ocfg.getHaving() != null) || join.isLeftOrRightJoin() ? ocfg : join.getJoinConfig();\n\n\t\t\t\tif (cfg != null) {\n\t\t\t\t\tcfg.setMain(false).setKeyPrefix(true);\n\t\t\t\t\t//if (StringUtil.isEmpty(cfg.getAlias(), true)) {\n\t\t\t\t\t//\tcfg.setAlias(cfg.getTable());\n\t\t\t\t\t//}\n\t\t\t\t\tString c = ((AbstractSQLConfig) cfg).gainHavingString(false);\n\n\t\t\t\t\tif (StringUtil.isNotEmpty(c, true)) {\n\t\t\t\t\t\tjoinHaving += (first ? \"\" : \", \") + c;\n\t\t\t\t\t\tfirst = false;\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\n\t\tMap map = getHaving();\n\t\tSet> set = map == null ? null : map.entrySet();\n\t\tif (set == null || set.isEmpty()) {\n\t\t\treturn StringUtil.isEmpty(joinHaving, true) ? \"\" : (hasPrefix ? \" HAVING \" : \"\") + joinHaving;\n\t\t}\n\n\t\tList raw = getRaw();\n\t\t//\t提前把 @having& 转为 @having，或者干脆不允许 @raw:\"@having&\"\tboolean containRaw = raw != null && (raw.contains(KEY_HAVING) || raw.contains(KEY_HAVING_AND));\n\t\tboolean containRaw = raw != null && raw.contains(KEY_HAVING);\n\n\t\t// 直接把 having 类型从 Map 定改为 Map，避免额外拷贝\n\t\t//\t\tMap newMap = new LinkedHashMap<>(map.size());\n\t\t//\t\tfor (Entry entry : set) {\n\t\t//\t\t\tnewMap.put(entry.getKey(), entry.getValue());\n\t\t//\t\t}\n\n\t\t//fun0(arg0,arg1,...);fun1(arg0,arg1,...)\n\t\tString havingString = parseCombineExpression(getMethod(), getQuote(), getTable()\n\t\t\t\t, getAlias(), map, getHavingCombine(), true, containRaw, true);\n\n\t\treturn (hasPrefix ? \" HAVING \" : \"\") + StringUtil.concat(havingString, joinHaving, AND);\n\t}\n\n\tprotected String gainHavingItem(String quote, String table, String alias\n\t\t\t, String key, String expression, boolean containRaw) throws Exception {\n\t\t//fun(arg0,arg1,...)\n\t\tif (containRaw) {\n\t\t\tString rawSQL = gainRawSQL(KEY_HAVING, expression);\n\t\t\tif (rawSQL != null) {\n\t\t\t\treturn rawSQL;\n\t\t\t}\n\t\t}\n\n\t\tif (expression.length() > 100) {\n\t\t\tthrow new UnsupportedOperationException(\"@having:value 的 value 中字符串 \" + expression + \" 不合法！\"\n\t\t\t\t\t+ \"不允许传超过 100 个字符的函数或表达式！请用 @raw 简化传参！\");\n\t\t}\n\n\t\tint start = expression.indexOf(\"(\");\n\t\tif (start < 0) {\n\t\t\tif (isPrepared() && PATTERN_FUNCTION.matcher(expression).matches() == false) {\n\t\t\t\tthrow new UnsupportedOperationException(\"字符串 \" + expression + \" 不合法！\"\n\t\t\t\t\t\t+ \"预编译模式下 @having:\\\"column?value;function(arg0,arg1,...)?value...\\\"\"\n\t\t\t\t\t\t+ \" 中 column?value 必须符合正则表达式 \" + PATTERN_FUNCTION + \" 且不包含连续减号 -- ！不允许空格！\");\n\t\t\t}\n\t\t\treturn expression;\n\t\t}\n\n\t\tint end = expression.lastIndexOf(\")\");\n\t\tif (start >= end) {\n\t\t\tthrow new IllegalArgumentException(\"字符 \" + expression + \" 不合法！\"\n\t\t\t\t\t+ \"@having:value 中 value 里的 SQL函数必须为 function(arg0,arg1,...) 这种格式！\");\n\t\t}\n\n\t\tString method = expression.substring(0, start);\n\t\tif (method.isEmpty() == false) {\n\t\t\tif (SQL_FUNCTION_MAP == null || SQL_FUNCTION_MAP.isEmpty()) {\n\t\t\t\tif (StringUtil.isName(method) == false) {\n\t\t\t\t\tthrow new IllegalArgumentException(\"字符 \" + method + \" 不合法！\"\n\t\t\t\t\t\t\t+ \"预编译模式下 @having:\\\"column?value;function(arg0,arg1,...)?value...\\\"\"\n\t\t\t\t\t\t\t+ \" 中 function 必须符合小写英文单词的 SQL 函数名格式！\");\n\t\t\t\t}\n\t\t\t}\n\t\t\telse if (SQL_FUNCTION_MAP.containsKey(method) == false) {\n\t\t\t\tthrow new IllegalArgumentException(\"字符 \" + method + \" 不合法！\"\n\t\t\t\t\t\t+ \"预编译模式下 @column:\\\"column0,column1:alias;function0(arg0,arg1,...);function1(...):alias...\\\"\"\n\t\t\t\t\t\t+ \" 中 function 必须符合小写英文单词的 SQL 函数名格式！且必须是后端允许调用的 SQL 函数!\");\n\t\t\t}\n\t\t}\n\n\t\treturn method + parseSQLExpression(KEY_HAVING, expression.substring(start), containRaw, false, null);\n\t}\n\n\t@Override\n\tpublic String getSample() {\n\t\treturn sample;\n\t}\n\tpublic AbstractSQLConfig setSample(String... conditions) {\n\t\treturn setSample(StringUtil.get(conditions));\n\t}\n\t@Override\n\tpublic AbstractSQLConfig setSample(String sample) {\n\t\tthis.sample = sample;\n\t\treturn this;\n\t}\n\tpublic String gainSampleString(boolean hasPrefix) {\n\t\t//加上子表的 sample\n\t\tString joinSample = \"\";\n\t\tif (joinList != null) {\n\t\t\tboolean first = true;\n\t\t\tfor (Join join : joinList) {\n\t\t\t\tif (join.isAppJoin()) {\n\t\t\t\t\tcontinue;\n\t\t\t\t}\n\n\t\t\t\tSQLConfig ocfg = join.getOnConfig();\n\t\t\t\tSQLConfig cfg = (ocfg != null && ocfg.getSample() != null) || join.isLeftOrRightJoin() ? ocfg : join.getJoinConfig();\n\n\t\t\t\tif (cfg != null) {\n\t\t\t\t\tcfg.setMain(false).setKeyPrefix(true);\n\t\t\t\t\t// if (StringUtil.isEmpty(cfg.getAlias(), true)) {\n\t\t\t\t\t//\t cfg.setAlias(cfg.getTable());\n\t\t\t\t\t// }\n\t\t\t\t\tString c = ((AbstractSQLConfig) cfg).gainSampleString(false);\n\n\t\t\t\t\tif (StringUtil.isNotEmpty(c, true)) {\n\t\t\t\t\t\tjoinSample += (first ? \"\" : \", \") + c;\n\t\t\t\t\t\tfirst = false;\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\n\t\tString sample = StringUtil.trim(getSample());\n\n\t\tString[] keys = StringUtil.split(sample);\n\t\tif (keys == null || keys.length <= 0) {\n\t\t\treturn StringUtil.isEmpty(joinSample, true) ? \"\" : (hasPrefix ? \" SAMPLE BY \" : \"\") + joinSample;\n\t\t}\n\n\t\tfor (int i = 0; i < keys.length; i++) {\n\t\t\tString item = keys[i];\n\n\t\t\tString origin = item;\n\n\t\t\tif (isPrepared()) { //不能通过 ? 来代替，SELECT 'id','name' 返回的就是 id:\"id\", name:\"name\"，而不是数据库里的值！\n\t\t\t\t//这里既不对origin trim，也不对 ASC/DESC ignoreCase，希望前端严格传没有任何空格的字符串过来，减少传输数据量，节约服务器性能\n\t\t\t\tif (StringUtil.isName(origin)) {}\n\t\t\t\telse if (StringUtil.isCombineOfNumOrAlpha(origin)) {\n\t\t\t\t\tcontinue;\n\t\t\t\t}\n\t\t\t\telse {\n\t\t\t\t\tthrow new IllegalArgumentException(\"预编译模式下 @sample:value 中 \" + item + \" 不合法! value 里面用 , 分割的\"\n\t\t\t\t\t\t\t+ \"每一项必须是 column 且其中 column 必须是 数字或英语字母组合！并且不要有多余的空格！\");\n\t\t\t\t}\n\t\t\t}\n\n\t\t\tkeys[i] = gainKey(origin);\n\t\t}\n\n\t\treturn (hasPrefix ? \" SAMPLE BY \" : \"\") + StringUtil.concat(StringUtil.get(keys), joinSample, \", \");\n\t}\n\n\t@Override\n\tpublic String getLatest() {\n\t\treturn latest;\n\t}\n\tpublic AbstractSQLConfig setLatest(String... conditions) {\n\t\treturn setLatest(StringUtil.get(conditions));\n\t}\n\t@Override\n\tpublic AbstractSQLConfig setLatest(String latest) {\n\t\tthis.latest = latest;\n\t\treturn this;\n\t}\n\tpublic String gainLatestString(boolean hasPrefix) {\n\t\t//加上子表的 latest\n\t\tString joinLatest = \"\";\n\t\tif (joinList != null) {\n\t\t\tboolean first = true;\n\t\t\tfor (Join join : joinList) {\n\t\t\t\tif (join.isAppJoin()) {\n\t\t\t\t\tcontinue;\n\t\t\t\t}\n\n\t\t\t\tSQLConfig ocfg = join.getOnConfig();\n\t\t\t\tSQLConfig cfg = (ocfg != null && ocfg.getLatest() != null) || join.isLeftOrRightJoin() ? ocfg : join.getJoinConfig();\n\n\t\t\t\tif (cfg != null) {\n\t\t\t\t\tcfg.setMain(false).setKeyPrefix(true);\n\t\t\t\t\t// if (StringUtil.isEmpty(cfg.getAlias(), true)) {\n\t\t\t\t\t//\t cfg.setAlias(cfg.getTable());\n\t\t\t\t\t// }\n\t\t\t\t\tString c = ((AbstractSQLConfig) cfg).gainLatestString(false);\n\n\t\t\t\t\tif (StringUtil.isNotEmpty(c, true)) {\n\t\t\t\t\t\tjoinLatest += (first ? \"\" : \", \") + c;\n\t\t\t\t\t\tfirst = false;\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\n\t\tString latest = StringUtil.trim(getLatest());\n\n\t\tString[] keys = StringUtil.split(latest);\n\t\tif (keys == null || keys.length <= 0) {\n\t\t\treturn StringUtil.isEmpty(joinLatest, true) ? \"\" : (hasPrefix ? \" LATEST ON \" : \"\") + joinLatest;\n\t\t}\n\n\t\tfor (int i = 0; i < keys.length; i++) {\n\t\t\tString item = keys[i];\n\t\t\tString origin = item;\n\n\t\t\tif (isPrepared()) { //不能通过 ? 来代替，SELECT 'id','name' 返回的就是 id:\"id\", name:\"name\"，而不是数据库里的值！\n\t\t\t\t//这里既不对origin trim，也不对 ASC/DESC ignoreCase，希望前端严格传没有任何空格的字符串过来，减少传输数据量，节约服务器性能\n\t\t\t\tif (StringUtil.isName(origin) == false) {\n\t\t\t\t\tthrow new IllegalArgumentException(\"预编译模式下 @latest:value 中 \" + item + \" 不合法! value 里面用 , 分割的\"\n\t\t\t\t\t\t\t+ \"每一项必须是 column 且其中 column 必须是 英语单词！并且不要有多余的空格！\");\n\t\t\t\t}\n\t\t\t}\n\n\t\t\tkeys[i] = gainKey(origin);\n\t\t}\n\n\t\treturn (hasPrefix ? \" LATEST ON \" : \"\") + StringUtil.concat(StringUtil.get(keys), joinLatest, \", \");\n\t}\n\n\t@Override\n\tpublic String getPartition() {\n\t\treturn partition;\n\t}\n\tpublic AbstractSQLConfig setPartition(String... conditions) {\n\t\treturn setPartition(StringUtil.get(conditions));\n\t}\n\t@Override\n\tpublic AbstractSQLConfig setPartition(String partition) {\n\t\tthis.partition = partition;\n\t\treturn this;\n\t}\n\tpublic String gainPartitionString(boolean hasPrefix) {\n\t\t//加上子表的 partition\n\t\tString joinPartition = \"\";\n\t\tif (joinList != null) {\n\t\t\tboolean first = true;\n\t\t\tfor (Join join : joinList) {\n\t\t\t\tif (join.isAppJoin()) {\n\t\t\t\t\tcontinue;\n\t\t\t\t}\n\n\t\t\t\tSQLConfig ocfg = join.getOnConfig();\n\t\t\t\tSQLConfig cfg = (ocfg != null && ocfg.getPartition() != null) || join.isLeftOrRightJoin() ? ocfg : join.getJoinConfig();\n\n\t\t\t\tif (cfg != null) {\n\t\t\t\t\tcfg.setMain(false).setKeyPrefix(true);\n\t\t\t\t\t// if (StringUtil.isEmpty(cfg.getAlias(), true)) {\n\t\t\t\t\t//\t cfg.setAlias(cfg.getTable());\n\t\t\t\t\t// }\n\t\t\t\t\tString c = ((AbstractSQLConfig) cfg).gainPartitionString(false);\n\n\t\t\t\t\tif (StringUtil.isNotEmpty(c, true)) {\n\t\t\t\t\t\tjoinPartition += (first ? \"\" : \", \") + c;\n\t\t\t\t\t\tfirst = false;\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\n\t\tString partition = StringUtil.trim(getPartition());\n\n\t\tString[] keys = StringUtil.split(partition);\n\t\tif (keys == null || keys.length <= 0) {\n\t\t\treturn StringUtil.isEmpty(joinPartition, true) ? \"\" : (hasPrefix ? \" PARTITION BY \" : \"\") + joinPartition;\n\t\t}\n\n\t\tfor (int i = 0; i < keys.length; i++) {\n\t\t\tString item = keys[i];\n\t\t\tString origin = item;\n\n\t\t\tif (isPrepared()) { //不能通过 ? 来代替，SELECT 'id','name' 返回的就是 id:\"id\", name:\"name\"，而不是数据库里的值！\n\t\t\t\t//这里既不对origin trim，也不对 ASC/DESC ignoreCase，希望前端严格传没有任何空格的字符串过来，减少传输数据量，节约服务器性能\n\t\t\t\tif (StringUtil.isName(origin) == false) {\n\t\t\t\t\tthrow new IllegalArgumentException(\"预编译模式下 @partition:value 中 \" + item + \" 不合法! value 里面用 , 分割的\"\n\t\t\t\t\t\t\t+ \"每一项必须是 column 且其中 column 必须是 英语单词！并且不要有多余的空格！\");\n\t\t\t\t}\n\t\t\t}\n\n\t\t\tkeys[i] = gainKey(origin);\n\t\t}\n\n\t\treturn (hasPrefix ? \" PARTITION BY \" : \"\") + StringUtil.concat(StringUtil.get(keys), joinPartition, \", \");\n\t}\n\n\t@Override\n\tpublic String getFill() {\n\t\treturn fill;\n\t}\n\tpublic AbstractSQLConfig setFill(String... conditions) {\n\t\treturn setFill(StringUtil.get(conditions));\n\t}\n\t@Override\n\tpublic AbstractSQLConfig setFill(String fill) {\n\t\tthis.fill = fill;\n\t\treturn this;\n\t}\n\tpublic String gainFillString(boolean hasPrefix) {\n\t\t//加上子表的 fill\n\t\tString joinFill = \"\";\n\t\tif (joinList != null) {\n\t\t\tboolean first = true;\n\t\t\tfor (Join join : joinList) {\n\t\t\t\tif (join.isAppJoin()) {\n\t\t\t\t\tcontinue;\n\t\t\t\t}\n\n\t\t\t\tSQLConfig ocfg = join.getOnConfig();\n\t\t\t\tSQLConfig cfg = (ocfg != null && ocfg.getFill() != null) || join.isLeftOrRightJoin() ? ocfg : join.getJoinConfig();\n\n\t\t\t\tif (cfg != null) {\n\t\t\t\t\tcfg.setMain(false).setKeyPrefix(true);\n\t\t\t\t\t// if (StringUtil.isEmpty(cfg.getAlias(), true)) {\n\t\t\t\t\t//\t cfg.setAlias(cfg.getTable());\n\t\t\t\t\t// }\n\t\t\t\t\tString c = ((AbstractSQLConfig) cfg).gainFillString(false);\n\n\t\t\t\t\tif (StringUtil.isNotEmpty(c, true)) {\n\t\t\t\t\t\tjoinFill += (first ? \"\" : \", \") + c;\n\t\t\t\t\t\tfirst = false;\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\n\t\tString fill = StringUtil.trim(getFill());\n\n\t\tString[] keys = StringUtil.split(fill);\n\t\tif (keys == null || keys.length <= 0) {\n\t\t\treturn StringUtil.isEmpty(joinFill, true) ? \"\" : (hasPrefix ? \" FILL(\" : \"\") + joinFill + \")\";\n\t\t}\n\n\t\tfor (int i = 0; i < keys.length; i++) {\n\t\t\tString item = keys[i];\n\t\t\tif (\"NULL\".equals(item) || \"LINEAR\".equals(item) || \"PREV\".equals(item) || \"PREVIOUS\".equals(item)) {\n\t\t\t\tcontinue;\n\t\t\t}\n\n\t\t\tString origin = item;\n\n\t\t\tif (isPrepared()) { //不能通过 ? 来代替，SELECT 'id','name' 返回的就是 id:\"id\", name:\"name\"，而不是数据库里的值！\n\t\t\t\t//这里既不对origin trim，也不对 ASC/DESC ignoreCase，希望前端严格传没有任何空格的字符串过来，减少传输数据量，节约服务器性能\n\t\t\t\tif (StringUtil.isName(origin)) {}\n\t\t\t\telse if (StringUtil.isCombineOfNumOrAlpha(origin)) {\n\t\t\t\t\tcontinue;\n\t\t\t\t}\n\t\t\t\telse {\n\t\t\t\t\tthrow new IllegalArgumentException(\"预编译模式下 @fill:value 中 \" + item + \" 不合法! value 里面用 , 分割的\"\n\t\t\t\t\t\t\t+ \"每一项必须是 column 且其中 column 必须是 数字或英语字母组合！并且不要有多余的空格！\");\n\t\t\t\t}\n\t\t\t}\n\n\t\t\tkeys[i] = gainKey(origin);\n\t\t}\n\n\t\treturn (hasPrefix ? \" FILL(\" : \"\") + StringUtil.concat(StringUtil.get(keys), joinFill, \", \") + \")\";\n\t}\n\n\t@Override\n\tpublic String getOrder() {\n\t\treturn order;\n\t}\n\tpublic AbstractSQLConfig setOrder(String... conditions) {\n\t\treturn setOrder(StringUtil.get(conditions));\n\t}\n\t@Override\n\tpublic AbstractSQLConfig setOrder(String order) {\n\t\tthis.order = order;\n\t\treturn this;\n\t}\n\tpublic String gainOrderString(boolean hasPrefix) {\n\t\t//加上子表的 order\n\t\tString joinOrder = \"\";\n\t\tString joinOuterOrder = \"\";\n\t\tif (joinList != null) {\n\t\t\tboolean first = true;\n\t\t\tfor (Join join : joinList) {\n\t\t\t\tif (join.isAppJoin()) {\n\t\t\t\t\tcontinue;\n\t\t\t\t}\n\n\t\t\t\tSQLConfig ocfg = join.getOnConfig();\n\t\t\t\tSQLConfig cfg = (ocfg != null && ocfg.getOrder() != null) || join.isLeftOrRightJoin() ? ocfg : join.getJoinConfig();\n\n\t\t\t\tif (cfg != null) {\n\t\t\t\t\tcfg.setMain(false).setKeyPrefix(true);\n\t\t\t\t\t//if (StringUtil.isEmpty(cfg.getAlias(), true)) {\n\t\t\t\t\t//\tcfg.setAlias(cfg.getTable());\n\t\t\t\t\t//}\n\t\t\t\t\tString c = ((AbstractSQLConfig) cfg).gainOrderString(false);\n\n\t\t\t\t\tif (StringUtil.isNotEmpty(c, true)) {\n\t\t\t\t\t\tjoinOrder += (first ? \"\" : \", \") + c;\n\t\t\t\t\t\tfirst = false;\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\n\n\t\tString order = StringUtil.trim(getOrder());\n\t\t// SELECT * FROM sys.Moment ORDER BY userId ASC, rand(); 前面的 userId ASC 和后面的 rand() 都有效\n\t\t//\t\tif (\"rand()\".equals(order)) {\n\t\t//\t\t\treturn (hasPrefix ? \" ORDER BY \" : \"\") + StringUtil.concat(order, joinOrder, \", \");\n\t\t//\t\t}\n\n\t\tif (getCount() > 0 && (isSQLServer() || isDb2())) {\n\t\t\t// Oracle, SQL Server, DB2 的 OFFSET 必须加 ORDER BY.去掉Oracle，Oracle里面没有offset关键字\n\n\t\t\t//\t\t\tString[] ss = StringUtil.split(order);\n\t\t\tif (StringUtil.isEmpty(order, true)) { //SQL Server 子查询内必须指定 OFFSET 才能用 ORDER BY\n\t\t\t\tString idKey = getIdKey();\n\t\t\t\tif (StringUtil.isEmpty(idKey, true)) {\n\t\t\t\t\tidKey = \"id\";\n\t\t\t\t\t// ORDER BY NULL 不行，SQL Server 会报错，必须要有排序，才能使用 OFFSET FETCH，如果没有 idKey，请求中指定 @order 即可\n\t\t\t\t}\n\t\t\t\torder = idKey; //让数据库调控默认升序还是降序 + \"+\";\n\t\t\t}\n\n\t\t\t//不用这么全面，毕竟没有语法问题还浪费性能，如果有其它问题，让前端传的 JSON 直接加上 @order 来解决\n\t\t\t//\t\t\tboolean contains = false;\n\t\t\t//\t\t\tif (ss != null) {\n\t\t\t//\t\t\t\tfor (String s : ss) {\n\t\t\t//\t\t\t\t\tif (s != null && s.startsWith(idKey)) {\n\t\t\t//\t\t\t\t\t\ts = s.substring(idKey.length());\n\t\t\t//\t\t\t\t\t\tif (\"+\".equals(s) || \"-\".equals(s)) {// || \" ASC \".equals(s) || \" DESC \".equals(s)) {\n\t\t\t//\t\t\t\t\t\t\tcontains = true;\n\t\t\t//\t\t\t\t\t\t\tbreak;\n\t\t\t//\t\t\t\t\t\t}\n\t\t\t//\t\t\t\t\t}\n\t\t\t//\t\t\t\t}\n\t\t\t//\t\t\t}\n\n\t\t\t//\t\t\tif (contains == false) {\n\t\t\t//\t\t\t\torder = (ss == null || ss.length <= 0 ? \"\" : order + \",\") + idKey + \"+\";\n\t\t\t//\t\t\t}\n\t\t}\n\n\n\t\tString[] keys = StringUtil.split(order);\n\t\tif (keys == null || keys.length <= 0) {\n\t\t\treturn StringUtil.isEmpty(joinOrder, true) ? \"\" : (hasPrefix ? \" ORDER BY \" : \"\") + joinOrder;\n\t\t}\n\n\t\tfor (int i = 0; i < keys.length; i++) {\n\t\t\tString item = keys[i];\n\t\t\tif (\"rand()\".equals(item)) {\n\t\t\t\tcontinue;\n\t\t\t}\n\n\t\t\tint index = item.endsWith(\"+\") ? item.length() - 1 : -1; //StringUtil.split返回数组中，子项不会有null\n\t\t\tString sort;\n\t\t\tif (index < 0) {\n\t\t\t\tindex = item.endsWith(\"-\") ? item.length() - 1 : -1;\n\t\t\t\tsort = index <= 0 ? \"\" : \" DESC \";\n\t\t\t}\n\t\t\telse {\n\t\t\t\tsort = \" ASC \";\n\t\t\t}\n\n\t\t\tString origin = index < 0 ? item : item.substring(0, index);\n\n\t\t\tif (isPrepared()) { //不能通过 ? 来代替，SELECT 'id','name' 返回的就是 id:\"id\", name:\"name\"，而不是数据库里的值！\n\t\t\t\t//这里既不对origin trim，也不对 ASC/DESC ignoreCase，希望前端严格传没有任何空格的字符串过来，减少传输数据量，节约服务器性能\n\t\t\t\tif (StringUtil.isName(origin) == false) {\n\t\t\t\t\tthrow new IllegalArgumentException(\"预编译模式下 @order:value 中 \" + item + \" 不合法! value 里面用 , 分割的\"\n\t\t\t\t\t\t\t+ \"每一项必须是 随机函数 rand() 或 column+ / column- 且其中 column 必须是 1 个单词！并且不要有多余的空格！\");\n\t\t\t\t}\n\t\t\t}\n\n\t\t\tkeys[i] = gainKey(origin) + sort;\n\t\t}\n\n\t\treturn (hasPrefix ? \" ORDER BY \" : \"\") + StringUtil.concat(StringUtil.get(keys), joinOrder, \", \");\n\t}\n\n\t@Override\n\tpublic Map getKeyMap() {\n\t\treturn keyMap;\n\t}\n\t@Override\n\tpublic AbstractSQLConfig setKeyMap(Map keyMap) {\n\t\tthis.keyMap = keyMap;\n\t\treturn this;\n\t}\n\n\t@Override\n\tpublic List getRaw() {\n\t\treturn raw;\n\t}\n\t@Override\n\tpublic AbstractSQLConfig setRaw(List raw) {\n\t\tthis.raw = raw;\n\t\treturn this;\n\t}\n\n\t/**获取原始 SQL 片段\n\t * @param key\n\t * @param value\n\t * @return\n\t * @throws Exception\n\t */\n\t@Override\n\tpublic String gainRawSQL(String key, Object value) throws Exception {\n\t\treturn gainRawSQL(key, value, ! ALLOW_MISSING_KEY_4_COMBINE);\n\t}\n\t/**获取原始 SQL 片段\n\t * @param key\n\t * @param value\n\t * @param throwWhenMissing\n\t * @return\n\t * @throws Exception\n\t */\n\t@Override\n\tpublic String gainRawSQL(String key, Object value, boolean throwWhenMissing) throws Exception {\n\t\tif (value == null) {\n\t\t\treturn null;\n\t\t}\n\n\t\tList rawList = getRaw();\n\t\tboolean containRaw = rawList != null && rawList.contains(key);\n\t\tif (containRaw && value instanceof String == false) {\n\t\t\tthrow new UnsupportedOperationException(\"@raw:value 的 value 中 \" + key + \" 不合法！\"\n\t\t\t\t\t+ \"对应的 \" + key + \":value 中 value 类型只能为 String！\");\n\t\t}\n\n\t\tString rawSQL = containRaw ? RAW_MAP.get(value) : null;\n\t\tif (containRaw) {\n\t\t\tif (rawSQL == null) {\n\t\t\t\tif (throwWhenMissing) {\n\t\t\t\t\tthrow new UnsupportedOperationException(\"@raw:value 的 value 中 \" + key + \" 不合法！\"\n\t\t\t\t\t\t\t+ \"对应的 \" + key + \":value 中 value 值 \" + value + \" 未在后端 RAW_MAP 中配置 ！\");\n\t\t\t\t}\n\n\t\t\t\tputWarnIfNeed(JSONMap.KEY_RAW, \"@raw:value 的 value 中 \"\n\t\t\t\t\t\t\t+ key + \" 不合法！对应的 \" + key + \":value 中 value 值 \" + value + \" 未在后端 RAW_MAP 中配置 ！\");\n\t\t\t}\n\t\t\telse if (rawSQL.isEmpty()) {\n\t\t\t\treturn (String) value;\n\t\t\t}\n\t\t}\n\n\t\treturn rawSQL;\n\t}\n\n\n\t@Override\n\tpublic List getJson() {\n\t\treturn json;\n\t}\n\t@Override\n\tpublic AbstractSQLConfig setJson(List json) {\n\t\tthis.json = json;\n\t\treturn this;\n\t}\n\n\n\t@Override\n\tpublic Subquery getFrom() {\n\t\treturn from;\n\t}\n\t@Override\n\tpublic AbstractSQLConfig setFrom(Subquery from) {\n\t\tthis.from = from;\n\t\treturn this;\n\t}\n\n\t@Override\n\tpublic List getColumn() {\n\t\treturn column;\n\t}\n\t@Override\n\tpublic AbstractSQLConfig setColumn(List column) {\n\t\tthis.column = column;\n\t\treturn this;\n\t}\n\tpublic String gainColumnString() throws Exception {\n\t\treturn gainColumnString(false);\n\t}\n\tpublic String gainColumnString(boolean inSQLJoin) throws Exception {\n\t\tList column = getColumn();\n\t\tString as = gainAs();\n\t\tString q = getQuote();\n\n\t\tswitch (getMethod()) {\n\t\tcase HEAD:\n\t\tcase HEADS: //StringUtil.isEmpty(column, true) || column.contains(\",\") 时SQL.count(column)会return \"*\"\n\t\t\tif (isPrepared() && column != null) {\n\t\t\t\tList raw = getRaw();\n\t\t\t\tboolean containRaw = raw != null && raw.contains(KEY_COLUMN);\n\n\t\t\t\tfor (String c : column) {\n\t\t\t\t\tif (containRaw) {\n\t\t\t\t\t\t// 由于 HashMap 对 key 做了 hash 处理，所以 get 比 containsValue 更快\n\t\t\t\t\t\tif (\"\".equals(RAW_MAP.get(c)) || RAW_MAP.containsValue(c)) { // newSQLConfig 提前处理好的\n\t\t\t\t\t\t\t//排除@raw中的值，以避免使用date_format(date,'%Y-%m-%d %H:%i:%s') 时,冒号的解析出错\n\t\t\t\t\t\t\t//column.remove(c);\n\t\t\t\t\t\t\tcontinue;\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\n\t\t\t\t\tint index = c.lastIndexOf(\":\"); //StringUtil.split返回数组中，子项不会有null\n\t\t\t\t\tString origin = index < 0 ? c : c.substring(0, index);\n\t\t\t\t\tString alias = index < 0 ? null : c.substring(index + 1);\n\n\t\t\t\t\tif (alias != null && StringUtil.isName(alias) == false) {\n\t\t\t\t\t\tthrow new IllegalArgumentException(\"HEAD请求: 字符 \" + alias\n\t\t\t\t\t\t\t\t+ \" 不合法！预编译模式下 @column:value 中 value里面用 , 分割的每一项\"\n\t\t\t\t\t\t\t\t+ \" column:alias 中 column 必须是1个单词！如果有alias，则alias也必须为1个单词！并且不要有多余的空格！\");\n\t\t\t\t\t}\n\n\t\t\t\t\tif (StringUtil.isName(origin) == false) {\n\t\t\t\t\t\tint start = origin.indexOf(\"(\");\n\t\t\t\t\t\tif (start < 0 || origin.lastIndexOf(\")\") <= start) {\n\t\t\t\t\t\t\tthrow new IllegalArgumentException(\"HEAD请求: 字符\" + origin\n\t\t\t\t\t\t\t\t\t+ \" 不合法！预编译模式下 @column:value 中 value里面用 , 分割的每一项\"\n\t\t\t\t\t\t\t\t\t+ \" column:alias 中 column 必须是1个单词！\"\n\t\t\t\t\t\t\t\t\t+ \"如果有alias，则 alias 也必须为1个单词！并且不要有多余的空格！\");\n\t\t\t\t\t\t}\n\n\t\t\t\t\t\tif (start > 0 && StringUtil.isName(origin.substring(0, start)) == false) {\n\t\t\t\t\t\t\tthrow new IllegalArgumentException(\"HEAD请求: 字符 \" + origin.substring(0, start)\n\t\t\t\t\t\t\t\t\t+ \" 不合法！预编译模式下 @column:value 中 value里面用 , 分割的每一项\"\n\t\t\t\t\t\t\t\t\t+ \" column:alias 中 column 必须是1个单词！如果有alias，则alias也必须为1个单词！并且不要有多余的空格！\");\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t}\n\n\t\t\tboolean onlyOne = column != null && column.size() == 1;\n\t\t\tString c0 = onlyOne ? column.get(0) : null;\n\n\t\t\tif (onlyOne) {\n\t\t\t\tint index = c0 == null ? -1 : c0.lastIndexOf(\":\");\n\t\t\t\tif (index > 0) {\n\t\t\t\t\tc0 = c0.substring(0, index);\n\t\t\t\t}\n\n\t\t\t\tint start = c0 == null ? -1 : c0.indexOf(\"(\");\n\t\t\t\tint end = start <= 0 ? -1 : c0.lastIndexOf(\")\");\n\t\t\t\tif (start > 0 && end > start) {\n\t\t\t\t\tString fun = c0.substring(0, start);\n\n\t\t\t\t\t// Invalid use of group function SELECT count(max(`id`)) AS count FROM `sys`.`Comment`\n\t\t\t\t\tif (SQL_AGGREGATE_FUNCTION_MAP.containsKey(fun)) {\n\t\t\t\t\t\tString group = getGroup(); // TODO 唯一 100% 兼容的可能只有 SELECT count(*) FROM (原语句) AS table\n\t\t\t\t\t\treturn StringUtil.isEmpty(group, true) ? \"1\" : \"count(DISTINCT \" + group + \")\";\n\t\t\t\t\t}\n\n\t\t\t\t\tString[] args = start == end - 1 ? null : StringUtil.split(c0.substring(start + 1, end));\n\t\t\t\t\tif (args != null && args.length > 0) {\n\t\t\t\t\t\tList raw = getRaw();\n\t\t\t\t\t\tboolean containRaw = raw != null && raw.contains(KEY_COLUMN);\n\t\t\t\t\t\tc0 = parseSQLExpression(KEY_COLUMN, c0, containRaw, false, null);\n\t\t\t\t\t}\n\n\t\t\t\t\treturn \"count(\" + c0 + \")\" + as + q + JSONResponse.KEY_COUNT + q;\n\t\t\t\t}\n\t\t\t}\n\n\t\t\treturn \"count(\" + (onlyOne ? gainKey(c0) : \"*\") + \")\" + as + q + JSONResponse.KEY_COUNT + q;\n\t\t\t//\t\t\treturn SQL.count(onlyOne && StringUtil.isName(column.get(0)) ? getKey(column.get(0)) : \"*\");\n\t\tcase POST:\n\t\t\tif (column == null || column.isEmpty()) {\n\t\t\t\tthrow new IllegalArgumentException(\"POST 请求必须在Table内设置要保存的 key:value ！\");\n\t\t\t}\n\n\t\t\tString s = \"\";\n\t\t\tboolean pfirst = true;\n\t\t\tfor (String c : column) {\n\t\t\t\tif (isPrepared() && StringUtil.isName(c) == false) {\n\t\t\t\t\t// 不能通过 ? 来代替，SELECT 'id','name' 返回的就是 id:\"id\", name:\"name\"，而不是数据库里的值！\n\t\t\t\t\tthrow new IllegalArgumentException(\"POST请求: 每一个 key:value 中的key都必须是1个单词！\");\n\t\t\t\t}\n\t\t\t\ts += ((pfirst ? \"\" : \",\") + gainKey(c));\n\n\t\t\t\tpfirst = false;\n\t\t\t}\n\n\t\t\treturn \"(\" + s + \")\";\n\t\tcase GET:\n\t\tcase GETS:\n\t\t\tString joinColumn = \"\";\n\t\t\tif (joinList != null) {\n\t\t\t\tboolean first = true;\n\t\t\t\tfor (Join join : joinList) {\n\t\t\t\t\tif (join.isAppJoin()) {\n\t\t\t\t\t\tcontinue;\n\t\t\t\t\t}\n\n\t\t\t\t\tSQLConfig ocfg = join.getOnConfig();\n\t\t\t\t\tboolean isEmpty = ocfg == null || ocfg.getColumn() == null;\n\t\t\t\t\tboolean isLeftOrRightJoin = join.isLeftOrRightJoin();\n\n\t\t\t\t\tif (isEmpty && isLeftOrRightJoin) {\n\t\t\t\t\t\t// 改为 SELECT ViceTable.* 解决 SELECT sum(ViceTable.id)\n\t\t\t\t\t\t// LEFT/RIGHT JOIN (SELECT sum(id) FROM ViceTable...) AS ViceTable\n\t\t\t\t\t\t// 不仅导致 SQL 函数重复计算，还有时导致 SQL 报错或对应字段未返回\n\t\t\t\t\t\tjoinColumn += (first ? \"\" : \", \") + q + SQLConfig.gainSQLAlias(join.getTable(), join.getAlias()) + q + \".*\";\n\t\t\t\t\t\tfirst = false;\n\t\t\t\t\t} else {\n\t\t\t\t\t\tSQLConfig cfg = isLeftOrRightJoin == false && isEmpty ? join.getJoinConfig() : ocfg;\n\t\t\t\t\t\tif (cfg != null) {\n\t\t\t\t\t\t\tcfg.setMain(false).setKeyPrefix(true);\n\t\t\t\t\t\t\t//if (StringUtil.isEmpty(cfg.getAlias(), true)) {\n\t\t\t\t\t\t\t//\tcfg.setAlias(cfg.getTable());\n\t\t\t\t\t\t\t//}\n\n\t\t\t\t\t\t\tString c = ((AbstractSQLConfig) cfg).gainColumnString(true);\n\t\t\t\t\t\t\tif (StringUtil.isNotEmpty(c, true)) {\n\t\t\t\t\t\t\t\tjoinColumn += (first ? \"\" : \", \") + c;\n\t\t\t\t\t\t\t\tfirst = false;\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\n\t\t\t\t\tinSQLJoin = true;\n\t\t\t\t}\n\t\t\t}\n\n\t\t\tString tableAlias = q + gainSQLAlias() + q;\n\t\t\t//\tString c = StringUtil.getString(column); //id,name;json_length(contactIdList):contactCount;...\n\n\t\t\tString[] keys = column == null ? null : column.toArray(new String[]{}); //StringUtil.split(c, \";\");\n\t\t\tif (keys == null || keys.length <= 0) {\n\n\t\t\t\tboolean noColumn = column != null && inSQLJoin;\n\t\t\t\tString mc = isKeyPrefix() ? (noColumn ? \"\" : tableAlias + \".*\") : (noColumn ? \"\" : \"*\");\n\n\t\t\t\treturn StringUtil.concat(mc, joinColumn, \", \", true);\n\t\t\t}\n\n\t\t\tList raw = getRaw();\n\t\t\tboolean containRaw = raw != null && raw.contains(KEY_COLUMN);\n\n\t\t\t//...;fun0(arg0,arg1,...):fun0;fun1(arg0,arg1,...):fun1;...\n\t\t\tfor (int i = 0; i < keys.length; i++) {\n\t\t\t\tString expression = keys[i]; //fun(arg0,arg1,...)\n\n\t\t\t\tif (containRaw) { // 由于 HashMap 对 key 做了 hash 处理，所以 get 比 containsValue 更快\n\t\t\t\t\tif (\"\".equals(RAW_MAP.get(expression)) || RAW_MAP.containsValue(expression)) { // newSQLConfig 提前处理好的\n\t\t\t\t\t\tcontinue;\n\t\t\t\t\t}\n\n\t\t\t\t\t// 简单点， 后台配置就带上 AS\n\t\t\t\t\tint index = expression.lastIndexOf(\":\");\n\t\t\t\t\tString alias = expression.substring(index+1);\n\t\t\t\t\tboolean hasAlias = StringUtil.isName(alias);\n\t\t\t\t\tString pre = index > 0 && hasAlias ? expression.substring(0, index) : expression;\n\t\t\t\t\tif (RAW_MAP.containsValue(pre) || \"\".equals(RAW_MAP.get(pre))) { // newSQLConfig 提前处理好的\n\t\t\t\t\t\tkeys[i] = pre + (hasAlias ? gainAs() + q + alias + q : \"\");\n\t\t\t\t\t\tcontinue;\n\t\t\t\t\t}\n\t\t\t\t}\n\n\t\t\t\tif (expression.length() > 100) {\n\t\t\t\t\tthrow new UnsupportedOperationException(\"@column:value 的 value 中字符串 \" + expression + \" 不合法！\"\n\t\t\t\t\t\t\t+ \"不允许传超过 100 个字符的函数或表达式！请用 @raw 简化传参！\");\n\t\t\t\t}\n\t\t\t\tkeys[i] = parseSQLExpression(KEY_COLUMN, expression, containRaw, true\n\t\t\t\t\t\t, \"@column:\\\"column0,column1:alias1;function0(arg0,arg1,...);function1(...):alias2...\\\"\");\n\t\t\t}\n\n\t\t\tString c = StringUtil.get(keys);\n\t\t\tc = c + (StringUtil.isEmpty(joinColumn, true) ? \"\" : \", \" + joinColumn);//不能在这里改，后续还要用到:\n\t\t\treturn isMain() && isDistinct() ? PREFIX_DISTINCT + c : c;\n\t\tdefault:\n\t\t\tthrow new UnsupportedOperationException(\n\t\t\t\t\t\"服务器内部错误：getColumnString 不支持 \" + RequestMethod.getName(getMethod())\n\t\t\t\t\t+ \" 等 [GET,GETS,HEAD,HEADS,POST] 外的ReuqestMethod！\"\n\t\t\t\t\t);\n\t\t}\n\t}\n\n\t/**解析@column 中以“;”分隔的表达式（\"@column\":\"expression1;expression2;expression2;....\"）中的expression\n\t * @param key\n\t * @param expression\n\t * @param containRaw\n\t * @param allowAlias\n\t * @return\n\t */\n\tpublic String parseSQLExpression(String key, String expression, boolean containRaw, boolean allowAlias) {\n\t\treturn parseSQLExpression(key, expression, containRaw, allowAlias, null);\n\t}\n\t/**解析@column 中以“;”分隔的表达式（\"@column\":\"expression1;expression2;expression2;....\"）中的expression\n\t * @param key\n\t * @param expression\n\t * @param containRaw\n\t * @param allowAlias\n\t * @param example\n\t * @return\n\t */\n\tpublic String parseSQLExpression(String key, String expression, boolean containRaw, boolean allowAlias, String example) {\n\t\tif (containRaw) {\n\t\t\tString s = RAW_MAP.get(expression);\n\t\t\tif (\"\".equals(s)) {\n\t\t\t\treturn expression;\n\t\t\t}\n\t\t\tif (s != null) {\n\t\t\t\treturn s;\n\t\t\t}\n\t\t}\n\n\t\tString quote = getQuote();\n\t\tint start = expression.indexOf('(');\n\t\tif (start < 0) {\n\t\t\t//没有函数 ,可能是字段,也可能是 DISTINCT xx\n\t\t\tString[] cks = parseArgsSplitWithComma(expression, true, containRaw, allowAlias);\n\t\t\texpression = StringUtil.get(cks);\n\t\t} else { // FIXME 用括号断开？ 如果少的话，用关键词加括号断开，例如 )OVER( 和 )AGAINST(\n\t\t\t// 窗口函数 rank() OVER (PARTITION BY id ORDER BY userId ASC)\n\t\t\t// 全文索引 math(name,tag) AGAINST ('a b +c -d' IN NATURALE LANGUAGE MODE) // IN BOOLEAN MODE\n\n\t\t\tif (StringUtil.isEmpty(example)) {\n\t\t\t\tif (KEY_COLUMN.equals(key)) {\n\t\t\t\t\texample = key + \":\\\"column0,column1:alias1;function0(arg0,arg1,...);function1(...):alias2...\\\"\";\n\t\t\t\t}\n\t\t\t\t//\t和 key{}:\"\" 一样\t\telse if (KEY_HAVING.equals(key) || KEY_HAVING_AND.equals(key)) {\n\t\t\t\t//\t\t\t\t\texeptionExample = key + \":\\\"function0(arg0,arg1,...)>1;function1(...)%5<=3...\\\"\";\n\t\t\t\t//\t\t\t\t}\n\t\t\t\telse {\n\t\t\t\t\texample = key + \":\\\"column0!=0;column1+3*2<=10;function0(arg0,arg1,...)>1;function1(...)%5<=3...\\\"\";\n\t\t\t\t}\n\t\t\t}\n\n\t\t\t//有函数,但不是窗口函数\n\t\t\tint overIndex = expression.indexOf(\")OVER(\"); // 传参不传空格，拼接带空格 \") OVER (\");\n\t\t\tint againstIndex = expression.indexOf(\")AGAINST(\"); // 传参不传空格，拼接带空格 \") AGAINST (\");\n\t\t\tboolean containOver = overIndex > 0 && overIndex < expression.length() - \")OVER(\".length();\n\t\t\tboolean containAgainst = againstIndex > 0 && againstIndex < expression.length() - \")AGAINST(\".length();\n\n\t\t\tif (containOver && containAgainst) {\n\t\t\t\tthrow new IllegalArgumentException(\"字符 \" + expression + \" 不合法！预编译模式下 \" + example\n\t\t\t\t\t\t+ \" 中 function 必须符合小写英文单词的 SQL 函数名格式！不能同时存在窗口函数关键词 OVER 和全文索引关键词 AGAINST！\");\n\t\t\t}\n\n\t\t\tif (containOver == false && containAgainst == false) {\n\t\t\t\tint end = expression.lastIndexOf(')');\n\t\t\t\tif (start >= end) {\n\t\t\t\t\tthrow new IllegalArgumentException(\"字符 \" + expression + \" 不合法！\"\n\t\t\t\t\t\t\t+ key + \":value 中 value 里的 SQL函数必须为 function(arg0,arg1,...) 这种格式！\");\n\t\t\t\t}\n\t\t\t\tString fun = expression.substring(0, start);\n\t\t\t\tif (fun.isEmpty() == false) {\n\t\t\t\t\tif (SQL_FUNCTION_MAP == null || SQL_FUNCTION_MAP.isEmpty()) {\n\t\t\t\t\t\tif (StringUtil.isName(fun) == false) {\n\t\t\t\t\t\t\tthrow new IllegalArgumentException(\"字符 \" + fun + \" 不合法！预编译模式下 \" + example\n\t\t\t\t\t\t\t\t\t+ \" 中 function 必须符合小写英文单词的 SQL 函数名格式！\");\n\t\t\t\t\t\t}\n\t\t\t\t\t} else if (SQL_FUNCTION_MAP.containsKey(fun) == false) {\n\t\t\t\t\t\tthrow new IllegalArgumentException(\"字符 \" + fun + \" 不合法！预编译模式下 \" + example\n\t\t\t\t\t\t\t\t+ \" 中 function 必须符合小写英文单词的 SQL 函数名格式！且必须是后端允许调用的 SQL 函数!\");\n\t\t\t\t\t}\n\t\t\t\t}\n\n\t\t\t\tString s = expression.substring(start + 1, end);\n\t\t\t\tboolean distinct = s.startsWith(PREFIX_DISTINCT);\n\t\t\t\tif (distinct) {\n\t\t\t\t\ts = s.substring(PREFIX_DISTINCT.length());\n\t\t\t\t}\n\n\t\t\t\t// 解析函数内的参数\n\t\t\t\tString ckeys[] = parseArgsSplitWithComma(s, false, containRaw, allowAlias);\n\n\t\t\t\tString suffix = expression.substring(end + 1); //:contactCount\n\t\t\t\tString alias = null;\n\t\t\t\tif (allowAlias) {\n\t\t\t\t\tint index = suffix.lastIndexOf(\":\");\n\t\t\t\t\talias = index < 0 ? \"\" : suffix.substring(index + 1); //contactCount\n\t\t\t\t\tsuffix = index < 0 ? suffix : suffix.substring(0, index);\n\t\t\t\t\tif (alias.isEmpty() == false && StringUtil.isName(alias) == false) {\n\t\t\t\t\t\tthrow new IllegalArgumentException(\"字符串 \" + alias + \" 不合法！预编译模式下 \"\n\t\t\t\t\t\t\t\t+ key + \":value 中 value里面用 ; 分割的每一项\"\n\t\t\t\t\t\t\t\t+ \" function(arg0,arg1,...):alias 中 alias 必须是1个单词！并且不要有多余的空格！\");\n\t\t\t\t\t}\n\t\t\t\t}\n\n\t\t\t\tif (suffix.isEmpty() == false && (suffix.contains(\"--\") || suffix.contains(\"/*\")\n\t\t\t\t\t\t|| PATTERN_RANGE.matcher(suffix).matches() == false)) {\n\t\t\t\t\tthrow new UnsupportedOperationException(\"字符串 \" + suffix + \" 不合法！预编译模式下 \" + key\n\t\t\t\t\t\t\t+ \":\\\"column?value;function(arg0,arg1,...)?value...\\\"\"\n\t\t\t\t\t\t\t+ \" 中 ?value 必须符合正则表达式 \" + PATTERN_RANGE + \" 且不包含连续减号 -- 或注释符 /* ！不允许多余的空格！\");\n\t\t\t\t}\n\n\t\t\t\tString origin = fun + \"(\" + (distinct ? PREFIX_DISTINCT : \"\") + StringUtil.get(ckeys) + \")\" + suffix;\n\t\t\t\texpression = origin + (StringUtil.isEmpty(alias, true) ? \"\" : gainAs() + quote + alias + quote);\n\t\t\t}\n\t\t\telse {\n\t\t\t\t//是窗口函数 fun(arg0,agr1) OVER (agr0 agr1 ...)\n\t\t\t\tint keyIndex = containOver ? overIndex : againstIndex;\n\t\t\t\tString s1 = expression.substring(0, keyIndex + 1); // OVER 前半部分\n\t\t\t\tString s2 = expression.substring(keyIndex + 1); // OVER 后半部分\n\n\t\t\t\tint index1 = s1.indexOf(\"(\"); // 函数 \"(\" 的起始位置\n\t\t\t\tint end = s2.lastIndexOf(\")\"); // 后半部分 “)” 的位置\n\n\t\t\t\tif (index1 >= end + s1.length()) {\n\t\t\t\t\tthrow new IllegalArgumentException(\"字符 \" + expression + \" 不合法！\"\n\t\t\t\t\t\t\t+ key + \":value 中 value 里的 SQL 函数必须为 function(arg0,arg1,...) 这种格式！\");\n\t\t\t\t}\n\n\t\t\t\tString fun = s1.substring(0, index1); // 函数名称\n\t\t\t\tif (fun.isEmpty() == false) {\n\t\t\t\t\tif (SQL_FUNCTION_MAP == null || SQL_FUNCTION_MAP.isEmpty()) {\n\t\t\t\t\t\tif (StringUtil.isName(fun) == false) {\n\t\t\t\t\t\t\tthrow new IllegalArgumentException(\"字符 \" + fun + \" 不合法！预编译模式下 \" + example\n\t\t\t\t\t\t\t\t\t+ \" 中 function 必须符合小写英文单词的 SQL 函数名格式！\");\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\t\t\t\t\telse if (SQL_FUNCTION_MAP.containsKey(fun) == false) {\n\t\t\t\t\t\tthrow new IllegalArgumentException(\"字符 \" + fun + \" 不合法！预编译模式下 \" + example\n\t\t\t\t\t\t\t\t+ \" 中 function 必须符合小写英文单词的 SQL 函数名格式！且必须是后端允许调用的 SQL 函数!\");\n\t\t\t\t\t}\n\t\t\t\t}\n\n\t\t\t\t// 获取前半部分函数的参数解析 fun(arg0,agr1)\n\t\t\t\tString agrsString1[] = parseArgsSplitWithComma(\n\t\t\t\t\t\ts1.substring(index1 + 1, s1.lastIndexOf(\")\")), false, containRaw, allowAlias\n\t\t\t\t);\n\n\t\t\t\tint index2 = s2.indexOf(\"(\"); // 后半部分 “(”的起始位置\n\t\t\t\tString argString2 = s2.substring(index2 + 1, end); // 后半部分的参数\n\t\t\t\t// 别名\n\t\t\t\tint aliasIndex = allowAlias ? s2.lastIndexOf(\":\") : -1;\n\t\t\t\tString alias = aliasIndex < 0 ? \"\" : s2.substring(aliasIndex + 1);\n\t\t\t\tif (alias.isEmpty() == false && StringUtil.isName(alias) == false) {\n\t\t\t\t\tthrow new IllegalArgumentException(\"字符串 \" + alias + \" 不合法！预编译模式下 \"\n\t\t\t\t\t\t\t+ key + \":value 中 value里面用 ; 分割的每一项\"\n\t\t\t\t\t\t\t+ \" function(arg0,arg1,...):alias 中 alias 必须是1个单词！并且不要有多余的空格！\");\n\t\t\t\t}\n\n\t\t\t\tString suffix = s2.substring(end + 1, aliasIndex < 0 ? s2.length() : aliasIndex);\n\t\t\t\tif (suffix.isEmpty() == false && (suffix.contains(\"--\") || suffix.contains(\"/*\")\n\t\t\t\t\t\t|| PATTERN_RANGE.matcher(suffix).matches() == false)) {\n\t\t\t\t\tthrow new UnsupportedOperationException(\"字符串 \" + suffix + \" 不合法！预编译模式下 \" + key\n\t\t\t\t\t\t\t+ \":\\\"column?value;function(arg0,arg1,...)?value...\\\"\"\n\t\t\t\t\t\t\t+ \" 中 ?value 必须符合正则表达式 \" + PATTERN_RANGE + \" 且不包含连续减号 -- 或注释符 /* ！不允许多余的空格！\");\n\t\t\t\t}\n\n\t\t\t\t// 获取后半部分的参数解析 (agr0 agr1 ...)\n\t\t\t\tString[] argsString2 = parseArgsSplitWithComma(argString2, false, containRaw, allowAlias);\n\t\t\t\texpression = fun + \"(\" + StringUtil.get(agrsString1) + (containOver ? \") OVER (\" : \") AGAINST (\")\n\t\t\t\t\t\t+ StringUtil.get(argsString2) + \")\" + suffix // 传参不传空格，拼接带空格\n\t\t\t\t\t\t+ (StringUtil.isEmpty(alias, true) ? \"\" : gainAs() + quote + alias + quote);\n\t\t\t}\n\t\t}\n\n\t\treturn expression;\n\t}\n\n\n\t/**解析函数参数或者字段,此函数对于解析字段 和 函数内参数通用\n\t * @param param\n\t * @param isColumn true:不是函数参数。false:是函数参数\n\t * @param containRaw\n\t * @param allowAlias\n\t * @return\n\t */\n\tprivate String[] parseArgsSplitWithComma(String param, boolean isColumn, boolean containRaw, boolean allowAlias) {\n\t\t// 以\",\" 分割参数\n\t\tString quote = getQuote();\n\t\tboolean isKeyPrefix = isKeyPrefix();\n\t\tString tableAlias = quote + gainSQLAlias() + quote;\n\t\tString[] ckeys = StringUtil.split(param); // 以\",\"分割参数\n\t\tif (ckeys != null && ckeys.length > 0) {\n\n\t\t\tfor (int i = 0; i < ckeys.length; i++) {\n\t\t\t\tString ck = ckeys[i];\n\n\t\t\t\tString origin;\n\t\t\t\tString alias;\n\n\t\t\t\t// 如果参数包含 \"'\" ,解析字符串\n\t\t\t\tif (ck.startsWith(\"`\") && ck.endsWith(\"`\")) {\n\t\t\t\t\torigin = ck.substring(1, ck.length() - 1);\n\t\t\t\t\t//sql 注入判断 判断\n\t\t\t\t\tif (origin.startsWith(\"_\") || StringUtil.isName(origin) == false) {\n\t\t\t\t\t\tthrow new IllegalArgumentException(\"字符 \" + ck + \" 不合法！\"\n\t\t\t\t\t\t\t\t+ \"预编译模式下 @column:\\\"`column0`,`column1`:alias;function0(arg0,arg1,...);function1(...):alias...\\\"\"\n\t\t\t\t\t\t\t\t+ \" 中所有字符串 column 都必须必须为1个单词 ！\");\n\t\t\t\t\t}\n\n\t\t\t\t\torigin = gainKey(origin);\n\t\t\t\t}\n\t\t\t\telse if (ck.startsWith(\"'\") && ck.endsWith(\"'\")) {\n\t\t\t\t\torigin = ck.substring(1, ck.length() - 1);\n\t\t\t\t\tif (origin.contains(\"'\")) {\n\t\t\t\t\t\tthrow new IllegalArgumentException(\"字符串 \" + ck + \" 不合法！\"\n\t\t\t\t\t\t\t\t+ \"预编译模式下 @column:\\\"column0,column1:alias;function0(arg0,arg1,...);function1(...):alias...\\\"\"\n\t\t\t\t\t\t\t\t+ \" 中字符串参数不合法，必须以 ' 开头, ' 结尾,字符串中不能包含 ' \");\n\t\t\t\t\t}\n\n\t\t\t\t\t// 1.字符串不是字段也没有别名,所以不解析别名 2. 是字符串，进行预编译，使用getValue() ,对字符串进行截取\n\t\t\t\t\torigin = gainValue(origin).toString();\n\t\t\t\t}\n\t\t\t\telse {\n\t\t\t\t\t// 参数不包含\",\",即不是字符串\n\t\t\t\t\t// 解析参数:1. 字段 ,2. 是以空格分隔的参数 eg: cast(now() as date)\n\t\t\t\t\tif (\"=null\".equals(ck)) {\n\t\t\t\t\t\torigin = SQL.isNull();\n\t\t\t\t\t}\n\t\t\t\t\telse if (\"!=null\".equals(ck)) {\n\t\t\t\t\t\torigin = SQL.isNull(false);\n\t\t\t\t\t}\n\t\t\t\t\telse {\n\t\t\t\t\t\torigin = ck;\n\t\t\t\t\t\talias = null;\n\t\t\t\t\t\tif (allowAlias) {\n\t\t\t\t\t\t\tint index = isColumn ? ck.lastIndexOf(\":\") : -1; //StringUtil.split返回数组中，子项不会有null\n\t\t\t\t\t\t\torigin = index < 0 ? ck : ck.substring(0, index); //获取 : 之前的\n\t\t\t\t\t\t\talias = index < 0 ? null : ck.substring(index + 1);\n\t\t\t\t\t\t\tif (isPrepared()) {\n\t\t\t\t\t\t\t\tif (isColumn) {\n\t\t\t\t\t\t\t\t\tif (StringUtil.isName(origin) == false || (alias != null && StringUtil.isName(alias) == false)) {\n\t\t\t\t\t\t\t\t\t\tthrow new IllegalArgumentException(\"字符 \" + ck + \" 不合法！\"\n\t\t\t\t\t\t\t\t\t\t\t\t+ \"预编译模式下 @column:value 中 value里面用 , 分割的每一项\"\n\t\t\t\t\t\t\t\t\t\t\t\t+ \" column:alias 中 column 必须是1个单词！如果有alias，则alias也必须为1个单词！\"\n\t\t\t\t\t\t\t\t\t\t\t\t+ \"关键字必须全大写，且以空格分隔的参数，空格必须只有 1 个！其它情况不允许空格！\");\n\t\t\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\t\t} else {\n\t\t\t\t\t\t\t\t\tif (origin.startsWith(\"_\") || origin.contains(\"--\")) {\n\t\t\t\t\t\t\t\t\t\t// || PATTERN_FUNCTION.matcher(origin).matches() == false) {\n\t\t\t\t\t\t\t\t\t\tthrow new IllegalArgumentException(\"字符 \" + ck + \" 不合法！\"\n\t\t\t\t\t\t\t\t\t\t\t\t+ \"预编译模式下 @column:\\\"column0,column1:alias;function0(arg0,arg1,...);function1(...):alias...\\\"\"\n\t\t\t\t\t\t\t\t\t\t\t\t+ \" 中所有 arg 都必须是1个不以 _ 开头的单词 或者符合正则表达式 \"\n\t\t\t\t\t\t\t\t\t\t\t\t+ PATTERN_FUNCTION + \" 且不包含连续减号 -- ！\" +\n\t\t\t\t\t\t\t\t\t\t\t\t\"DISTINCT 必须全大写，且后面必须有且只有 1 个空格！其它情况不允许空格！\");\n\t\t\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t}\n\n\t\t\t\t\t\t// 以空格分割参数\n\t\t\t\t\t\tString[] mkes = containRaw ? StringUtil.split(ck, \" \", true) : new String[]{ ck };\n\n\t\t\t\t\t\t//如果参数中含有空格(少数情况) 比如 fun(arg1, arg2,arg3,arg4) 中的 arg1 arg2 arg3，比如 DISTINCT id\n\t\t\t\t\t\tif (mkes != null && mkes.length >= 2) {\n\t\t\t\t\t\t\torigin = parseArgsSplitWithSpace(mkes);\n\t\t\t\t\t\t} else {\n\t\t\t\t\t\t\tString mk = RAW_MAP.get(origin);\n\t\t\t\t\t\t\tif (mk != null) { // newSQLConfig 提前处理好的\n\t\t\t\t\t\t\t\tif (mk.length() > 0) {\n\t\t\t\t\t\t\t\t\torigin = mk;\n\t\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\t} else if (StringUtil.isNumber(origin)) {\n\t\t\t\t\t\t\t\t//do nothing\n\t\t\t\t\t\t\t} else {\n\t\t\t\t\t\t\t\tString[] keys = origin.split(\"[.]\");\n\t\t\t\t\t\t\t\tStringBuilder sb = new StringBuilder();\n\n\t\t\t\t\t\t\t\tint len = keys == null ? 0 : keys.length;\n\t\t\t\t\t\t\t\tif (len > 0) {\n\t\t\t\t\t\t\t\t\tboolean first = true;\n\t\t\t\t\t\t\t\t\tfor (String k : keys) {\n\t\t\t\t\t\t\t\t\t\tif (StringUtil.isName(k) == false) {\n\t\t\t\t\t\t\t\t\t\t\tsb = null;\n\t\t\t\t\t\t\t\t\t\t\tbreak;\n\t\t\t\t\t\t\t\t\t\t}\n\n\t\t\t\t\t\t\t\t\t\tsb.append(first ? \"\" : \".\").append(quote).append(k).append(quote);\n\t\t\t\t\t\t\t\t\t\tfirst = false;\n\t\t\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\t\t}\n\n\t\t\t\t\t\t\t\tString s = sb == null ? null : sb.toString();\n\t\t\t\t\t\t\t\tif (StringUtil.isNotEmpty(s, true)) {\n\t\t\t\t\t\t\t\t\torigin = (len == 1 && isKeyPrefix ? tableAlias + \".\" : \"\") + s;\n\t\t\t\t\t\t\t\t} else {\n\t\t\t\t\t\t\t\t\torigin = gainValue(origin).toString();\n\t\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\t}\n\n\t\t\t\t\t\t\tif (isColumn && StringUtil.isNotEmpty(alias, true)) {\n\t\t\t\t\t\t\t\torigin += gainAs() + quote + alias + quote;\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\t\t\t\t}\n\n\t\t\t\tckeys[i] = origin;\n\t\t\t}\n\t\t}\n\n\t\treturn ckeys;\n\t}\n\n\n\t/**\n\t * 只解析以空格分隔的参数\n\t *\n\t * @param mkes\n\t * @return\n\t */\n\tprivate String parseArgsSplitWithSpace(String[] mkes) {\n\t\tString quote = getQuote();\n\t\tboolean isKeyPrefix = isKeyPrefix();\n\t\tString tableAlias = quote + gainSQLAlias() + quote;\n\n\t\t// 包含空格的参数 肯定不包含别名 不用处理别名\n\t\tif (mkes != null && mkes.length > 0) {\n\t\t\tfor (int j = 0; j < mkes.length; j++) {\n\t\t\t\t// now()/AS/ DISTINCT/VALUE 等等放在RAW_MAP中\n\t\t\t\tString origin = mkes[j];\n\n\t\t\t\tString mk = RAW_MAP.get(origin);\n\t\t\t\tif (mk != null) { // newSQLConfig 提前处理好的\n\t\t\t\t\tif (mk.length() > 0) {\n\t\t\t\t\t\tmkes[j] = mk;\n\t\t\t\t\t}\n\t\t\t\t\tcontinue;\n\t\t\t\t}\n\n\t\t\t\t//这里为什么还要做一次判断 是因为解析窗口函数调用的时候会判断一次\n\t\t\t\tString ck = origin;\n\t\t\t\t// 如果参数包含 \"`\" 或 \"'\" ,解析字符串\n\t\t\t\tif (ck.startsWith(\"`\") && ck.endsWith(\"`\")) {\n\t\t\t\t\torigin = ck.substring(1, ck.length() - 1);\n\t\t\t\t\tif (origin.startsWith(\"_\") || StringUtil.isName(origin) == false) {\n\t\t\t\t\t\tthrow new IllegalArgumentException(\"字符 \" + ck + \" 不合法！\"\n\t\t\t\t\t\t\t\t+ \"预编译模式下 @column:\\\"`column0`,`column1`:alias;function0(arg0,arg1,...);function1(...):alias...\\\"\"\n\t\t\t\t\t\t\t\t+ \" 中所有字符串 column 都必须必须为1个单词 ！\");\n\t\t\t\t\t}\n\n\t\t\t\t\tmkes[j] = gainKey(origin);\n\t\t\t\t\tcontinue;\n\t\t\t\t}\n\t\t\t\telse if (ck.startsWith(\"'\") && ck.endsWith(\"'\")) {\n\t\t\t\t\torigin = ck.substring(1, ck.length() - 1);\n\t\t\t\t\tif (origin.contains(\"'\")) {\n\t\t\t\t\t\tthrow new IllegalArgumentException(\"字符串 \" + ck + \" 不合法！\"\n\t\t\t\t\t\t\t\t+ \"预编译模式下 @column:\\\"column0,column1:alias;function0(arg0,arg1,...);function1(...):alias...\\\"\"\n\t\t\t\t\t\t\t\t+ \" 中字符串参数不合法，必须以 ' 开头, ' 结尾,字符串中不能包含 ' \");\n\t\t\t\t\t}\n\n\t\t\t\t\t// 1.字符串不是字段也没有别名,所以不解析别名 2. 是字符串，进行预编译，使用getValue() ,对字符串进行截取\n\t\t\t\t\tmkes[j] = gainValue(origin).toString();\n\t\t\t\t\tcontinue;\n\t\t\t\t}\n\t\t\t\telse if (ck.contains(\"`\") || ck.contains(\"'\") || origin.startsWith(\"_\") || origin.contains(\"--\")) {\n\t\t\t\t\t// || PATTERN_FUNCTION.matcher(origin).matches() == false) {\n\t\t\t\t\tthrow new IllegalArgumentException(\"字符 \" + origin + \" 不合法！\"\n\t\t\t\t\t\t\t+ \"预编译模式下 @column:\\\"column0,column1:alias;function0(arg0,arg1,...);function1(...):alias...\\\"\"\n\t\t\t\t\t\t\t+ \" 中所有 arg 都必须是1个不以 _ 开头的单词 或者符合正则表达式 \" + PATTERN_FUNCTION\n\t\t\t\t\t\t\t+ \" 且不包含连续减号 -- ！DISTINCT 必须全大写，且后面必须有且只有 1 个空格！其它情况不允许空格！\");\n\t\t\t\t}\n\n\t\t\t\tif (StringUtil.isNumber(origin)) {\n\t\t\t\t\t//do nothing\n\t\t\t\t} else {\n\t\t\t\t\tString[] keys = origin.split(\"[.]\");\n\t\t\t\t\tStringBuilder sb = new StringBuilder();\n\n\t\t\t\t\tint len = keys == null ? 0 : keys.length;\n\t\t\t\t\tif (len > 0) {\n\t\t\t\t\t\tboolean first = true;\n\t\t\t\t\t\tfor (String k : keys) {\n\t\t\t\t\t\t\tif (StringUtil.isName(k) == false) {\n\t\t\t\t\t\t\t\tsb = null;\n\t\t\t\t\t\t\t\tbreak;\n\t\t\t\t\t\t\t}\n\n\t\t\t\t\t\t\tsb.append(first ? \"\" : \".\").append(quote).append(k).append(quote);\n\t\t\t\t\t\t\tfirst = false;\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\n\t\t\t\t\tString s = sb == null ? null : sb.toString();\n\t\t\t\t\tif (StringUtil.isNotEmpty(s, true)) {\n\t\t\t\t\t\torigin = (len == 1 && isKeyPrefix ? tableAlias + \".\" : \"\") + s;\n\t\t\t\t\t} else {\n\t\t\t\t\t\torigin = gainValue(origin).toString();\n\t\t\t\t\t}\n\t\t\t\t}\n\n\t\t\t\tmkes[j] = origin;\n\t\t\t}\n\t\t}\n\t\t// 返回重新以\" \"拼接后的参数\n\t\treturn StringUtil.join(mkes, \" \");\n\t}\n\n\n\t@Override\n\tpublic List> getValues() {\n\t\treturn values;\n\t}\n\tpublic String getValuesString() {\n\t\tString s = \"\";\n\t\tif (values != null && values.size() > 0) {\n\t\t\tObject[] items = new Object[values.size()];\n\t\t\tList vs;\n\t\t\tfor (int i = 0; i < values.size(); i++) {\n\t\t\t\tvs = values.get(i);\n\t\t\t\tif (vs == null) {\n\t\t\t\t\tcontinue;\n\t\t\t\t}\n\n\t\t\t\titems[i] = \"(\";\n\t\t\t\tfor (int j = 0; j < vs.size(); j++) {\n\t\t\t\t\titems[i] += ((j <= 0 ? \"\" : \",\") + gainValue(vs.get(j)));\n\t\t\t\t}\n\t\t\t\titems[i] += \")\";\n\t\t\t}\n\t\t\ts = StringUtil.get(items);\n\t\t}\n\t\treturn s;\n\t}\n\t@Override\n\tpublic AbstractSQLConfig setValues(List> valuess) {\n\t\tthis.values = valuess;\n\t\treturn this;\n\t}\n\n\t@Override\n\tpublic Map getContent() {\n\t\treturn content;\n\t}\n\t@Override\n\tpublic AbstractSQLConfig setContent(Map content) {\n\t\tthis.content = content;\n\t\treturn this;\n\t}\n\n\t@Override\n\tpublic int getCount() {\n\t\treturn count;\n\t}\n\t@Override\n\tpublic AbstractSQLConfig setCount(int count) {\n\t\tthis.count = count;\n\t\treturn this;\n\t}\n\t@Override\n\tpublic int getPage() {\n\t\treturn page;\n\t}\n\t@Override\n\tpublic AbstractSQLConfig setPage(int page) {\n\t\tthis.page = page;\n\t\treturn this;\n\t}\n\t@Override\n\tpublic int getPosition() {\n\t\treturn position;\n\t}\n\t@Override\n\tpublic AbstractSQLConfig setPosition(int position) {\n\t\tthis.position = position;\n\t\treturn this;\n\t}\n\n\t@Override\n\tpublic int getQuery() {\n\t\treturn query;\n\t}\n\t@Override\n\tpublic AbstractSQLConfig setQuery(int query) {\n\t\tthis.query = query;\n\t\treturn this;\n\t}\n\t@Override\n\tpublic Boolean getCompat() {\n\t\treturn compat;\n\t}\n\t@Override\n\tpublic AbstractSQLConfig setCompat(Boolean compat) {\n\t\tthis.compat = compat;\n\t\treturn this;\n\t}\n\n\t@Override\n\tpublic int getType() {\n\t\treturn type;\n\t}\n\t@Override\n\tpublic AbstractSQLConfig setType(int type) {\n\t\tthis.type = type;\n\t\treturn this;\n\t}\n\n\t@Override\n\tpublic int getCache() {\n\t\treturn cache;\n\t}\n\t@Override\n\tpublic AbstractSQLConfig setCache(int cache) {\n\t\tthis.cache = cache;\n\t\treturn this;\n\t}\n\n\tpublic AbstractSQLConfig setCache(String cache) {\n\t\treturn setCache(getCache(cache));\n\t}\n\tpublic static int getCache(String cache) {\n\t\tint cache2;\n\t\tif (cache == null) {\n\t\t\tcache2 = JSONMap.CACHE_ALL;\n\t\t}\n\t\telse {\n\t\t\t//\t\t\tif (isSubquery) {\n\t\t\t//\t\t\t\tthrow new IllegalArgumentException(\"子查询内不支持传 \" + apijson.JSONMap.KEY_CACHE + \"!\");\n\t\t\t//\t\t\t}\n\n\t\t\tswitch (cache) {\n\t\t\tcase \"0\":\n\t\t\tcase JSONMap.CACHE_ALL_STRING:\n\t\t\t\tcache2 = JSONMap.CACHE_ALL;\n\t\t\t\tbreak;\n\t\t\tcase \"1\":\n\t\t\tcase JSONMap.CACHE_ROM_STRING:\n\t\t\t\tcache2 = JSONMap.CACHE_ROM;\n\t\t\t\tbreak;\n\t\t\tcase \"2\":\n\t\t\tcase JSONMap.CACHE_RAM_STRING:\n\t\t\t\tcache2 = JSONMap.CACHE_RAM;\n\t\t\t\tbreak;\n\t\t\tdefault:\n\t\t\t\tthrow new IllegalArgumentException(JSONMap.KEY_CACHE\n\t\t\t\t\t\t+ \":value 中 value 的值不合法！必须在 [0,1,2] 或 [ALL, ROM, RAM] 内 !\");\n\t\t\t}\n\t\t}\n\t\treturn cache2;\n\t}\n\n\t@Override\n\tpublic boolean isExplain() {\n\t\treturn explain;\n\t}\n\t@Override\n\tpublic AbstractSQLConfig setExplain(boolean explain) {\n\t\tthis.explain = explain;\n\t\treturn this;\n\t}\n\n\t@Override\n\tpublic List> getJoinList() {\n\t\treturn joinList;\n\t}\n\t@Override\n\tpublic AbstractSQLConfig setJoinList(List> joinList) {\n\t\tthis.joinList = joinList;\n\t\treturn this;\n\t}\n\t@Override\n\tpublic boolean hasJoin() {\n\t\treturn joinList != null && joinList.isEmpty() == false;\n\t}\n\n\n\t@Override\n\tpublic boolean isTest() {\n\t\treturn test;\n\t}\n\t@Override\n\tpublic AbstractSQLConfig setTest(boolean test) {\n\t\tthis.test = test;\n\t\treturn this;\n\t}\n\n\t/**获取初始位置offset\n\t * @return\n\t */\n\tpublic int getOffset() {\n\t\treturn getOffset(getPage(), getCount());\n\t}\n\t/**获取初始位置offset\n\t * @param page\n\t * @param count\n\t * @return\n\t */\n\tpublic static int getOffset(int page, int count) {\n\t\treturn page*count;\n\t}\n\t/**获取限制数量\n\t * @return\n\t */\n\tpublic String gainLimitString() {\n\t\tint count = getCount();\n\t\tint page = getPage();\n\n\t\tboolean isMilvus = isMilvus();\n\t\tif ((count <= 0 && ! (isMilvus && isMain())) || RequestMethod.isHeadMethod(getMethod(), true)) { // TODO HEAD 真的不需要 LIMIT ？\n\t\t\treturn \"\";\n\t\t}\n\n\t\tboolean isSurrealDB = isSurrealDB();\n\t\tboolean isQuestDB = isQuestDB();\n\t\tif (isSurrealDB || isQuestDB || isMilvus) {\n\t\t\tif (count == 0) {\n\t\t\t\tParser parser = gainParser();\n\t\t\t\tcount = parser == null ? AbstractParser.MAX_QUERY_COUNT : parser.getMaxQueryCount();\n\t\t\t}\n\n\t\t\tint offset = getOffset(page, count);\n\t\t\tif (isQuestDB()) {\n\t\t\t\treturn \" LIMIT \" + offset + \", \" + (offset + count);\n\t\t\t}\n\t\t\telse if (isSurrealDB()) {\n\t\t\t\treturn \" START \" + offset + \" LIMIT \" + count;\n\t\t\t}\n\t\t\telse {\n\t\t\t\treturn \" LIMIT \" + offset + \", \" + count; // 目前 moql-transx 的限制\n\t\t\t}\n\t\t}\n\n\t\tboolean isOracle = isOracle();\n\t\treturn gainLimitString(page, count, isTSQL(), isOracle || isDameng() || isKingBase(), isPresto() || isTrino());\n\t}\n\t/**获取限制数量及偏移量\n\t* @param page\n\t* @param count\n\t* @param isTSQL\n\t* @param isOracle\n\t* @return\n\t*/\n\tpublic static String gainLimitString(int page, int count, boolean isTSQL, boolean isOracle) {\n\t\treturn gainLimitString(page, count, isTSQL, isOracle, false);\n\t}\n\t/**获取限制数量及偏移量\n\t* @param page\n\t* @param count\n\t* @param isTSQL\n\t* @param isOracle\n\t* @param isPresto\n\t* @return\n\t*/\n\tpublic static String gainLimitString(int page, int count, boolean isTSQL, boolean isOracle, boolean isPresto) {\n\t\tint offset = getOffset(page, count);\n\n\t\tif (isOracle) { // TODO 判断版本，高版本可以用 OFFSET FETCH\n\t\t\treturn \" WHERE ROWNUM BETWEEN \" + offset + \" AND \" + (offset + count);\n\t\t}\n\n\t\tif (isTSQL) { // OFFSET FECTH 中所有关键词都不可省略, 另外 Oracle 数据库使用子查询加 where 分页\n\t\t\treturn \" OFFSET \" + offset + \" ROWS FETCH FIRST \" + count + \" ROWS ONLY\";\n\t\t}\n\n\t\tif (isPresto) { // https://prestodb.io/docs/current/sql/select.html\n\t\t\treturn (offset <= 0 ? \"\" : \" OFFSET \" + offset) + \" LIMIT \" + count;\n\t\t}\n\n\t\treturn \" LIMIT \" + count + (offset <= 0 ? \"\" : \" OFFSET \" + offset); // DELETE, UPDATE 不支持 OFFSET\n\t}\n\n\t@Override\n\tpublic List getNull() {\n\t\treturn nulls;\n\t}\n\t@Override\n\tpublic AbstractSQLConfig setNull(List nulls) {\n\t\tthis.nulls = nulls;\n\t\treturn this;\n\t}\n\n\t@Override\n\tpublic Map getCast() {\n\t\treturn cast;\n\t}\n\t@Override\n\tpublic AbstractSQLConfig setCast(Map cast) {\n\t\tthis.cast = cast;\n\t\treturn this;\n\t}\n\n\t//WHERE <<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<\n\n\tprotected int getMaxHavingCount() {\n\t\treturn MAX_HAVING_COUNT;\n\t}\n\tprotected int getMaxWhereCount() {\n\t\treturn MAX_WHERE_COUNT;\n\t}\n\tprotected int getMaxCombineDepth() {\n\t\treturn MAX_COMBINE_DEPTH;\n\t}\n\tprotected int getMaxCombineCount() {\n\t\treturn MAX_COMBINE_COUNT;\n\t}\n\tprotected int getMaxCombineKeyCount() {\n\t\treturn MAX_COMBINE_KEY_COUNT;\n\t}\n\tprotected float getMaxCombineRatio() {\n\t\treturn MAX_COMBINE_RATIO;\n\t}\n\n\n\t@Override\n\tpublic String getCombine() {\n\t\treturn combine;\n\t}\n\t@Override\n\tpublic AbstractSQLConfig setCombine(String combine) {\n\t\tthis.combine = combine;\n\t\treturn this;\n\t}\n\n\t@NotNull\n\t@Override\n\tpublic Map> getCombineMap() {\n\t\tList andList = combineMap == null ? null : combineMap.get(\"&\");\n\t\tif (andList == null) {\n\t\t\tandList = where == null ? new ArrayList() : new ArrayList(where.keySet());\n\t\t\tif (combineMap == null) {\n\t\t\t\tcombineMap = new HashMap<>();\n\t\t\t}\n\t\t\tcombineMap.put(\"&\", andList);\n\t\t}\n\t\treturn combineMap;\n\t}\n\t@Override\n\tpublic AbstractSQLConfig setCombineMap(Map> combineMap) {\n\t\tthis.combineMap = combineMap;\n\t\treturn this;\n\t}\n\n\t@Override\n\tpublic Map getWhere() {\n\t\treturn where;\n\t}\n\t@Override\n\tpublic AbstractSQLConfig setWhere(Map where) {\n\t\tthis.where = where;\n\t\treturn this;\n\t}\n\n\t/**\n\t * noFunctionChar = false\n\t * @param key\n\t * @return\n\t */\n\t@Override\n\tpublic Object getWhere(String key) {\n\t\treturn getWhere(key, false);\n\t}\n\t//CS304 Issue link: https://github.com/Tencent/APIJSON/issues/48\n\t/**\n\t * @param key - the key passed in\n\t * @param exactMatch - whether it is exact match\n\t * @return\n\t *

use entrySet+getValue() to replace keySet+get() to enhance efficiency

\n\t */\n\t@Override\n\tpublic Object getWhere(String key, boolean exactMatch) {\n\t\tif (exactMatch) {\n\t\t\treturn where == null ? null : where.get(key);\n\t\t}\n\n\t\tif (key == null || where == null){\n\t\t\treturn null;\n\t\t}\n\n\t\tint index;\n\t\tfor (Entry entry : where.entrySet()) {\n\t\t\tString k = entry.getKey();\n\t\t\tindex = k.indexOf(key);\n\t\t\tif (index >= 0 && StringUtil.isName(k.substring(index, index + 1)) == false) {\n\t\t\t\treturn entry.getValue();\n\t\t\t}\n\t\t}\n\n\t\treturn null;\n\t}\n\t@Override\n\tpublic AbstractSQLConfig putWhere(String key, Object value, boolean prior) {\n\t\tif (key != null) {\n\t\t\tif (where == null) {\n\t\t\t\twhere = new LinkedHashMap<>();\n\t\t\t}\n\t\t\tif (value == null) {\n\t\t\t\twhere.remove(key);\n\t\t\t} else {\n\t\t\t\twhere.put(key, value);\n\t\t\t}\n\n\t\t\tMap> combineMap = getCombineMap();\n\t\t\tList andList = combineMap.get(\"&\");\n\t\t\tif (value == null) {\n\t\t\t\tif (andList != null) {\n\t\t\t\t\tandList.remove(key);\n\t\t\t\t}\n\t\t\t}\n\t\t\telse if (andList == null || andList.contains(key) == false) {\n\t\t\t\tint i = 0;\n\t\t\t\tif (andList == null) {\n\t\t\t\t\tandList = new ArrayList<>();\n\t\t\t\t}\n\t\t\t\telse if (prior && andList.isEmpty() == false) {\n\n\t\t\t\t\tString idKey = getIdKey();\n\t\t\t\t\tString idInKey = idKey + \"{}\";\n\t\t\t\t\tString userIdKey = getUserIdKey();\n\t\t\t\t\tString userIdInKey = userIdKey + \"{}\";\n\n\t\t\t\t\tint lastIndex;\n\t\t\t\t\tif (key.equals(idKey)) {\n\t\t\t\t\t\tsetId(value);\n\t\t\t\t\t\tlastIndex = -1;\n\t\t\t\t\t}\n\t\t\t\t\telse if (key.equals(idInKey)) {\n\t\t\t\t\t\tsetIdIn(value);\n\t\t\t\t\t\tlastIndex = andList.lastIndexOf(idKey);\n\t\t\t\t\t}\n\t\t\t\t\telse if (key.equals(userIdKey)) {\n\t\t\t\t\t\tsetUserId(value);\n\t\t\t\t\t\tlastIndex = andList.lastIndexOf(idInKey);\n\t\t\t\t\t\tif (lastIndex < 0) {\n\t\t\t\t\t\t\tlastIndex = andList.lastIndexOf(idKey);\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\t\t\t\t\telse if (key.equals(userIdInKey)) {\n\t\t\t\t\t\tsetUserIdIn(value);\n\t\t\t\t\t\tlastIndex = andList.lastIndexOf(userIdKey);\n\t\t\t\t\t\tif (lastIndex < 0) {\n\t\t\t\t\t\t\tlastIndex = andList.lastIndexOf(idInKey);\n\t\t\t\t\t\t}\n\t\t\t\t\t\tif (lastIndex < 0) {\n\t\t\t\t\t\t\tlastIndex = andList.lastIndexOf(idKey);\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\t\t\t\t\telse {\n\t\t\t\t\t\tlastIndex = andList.lastIndexOf(userIdInKey);\n\t\t\t\t\t\tif (lastIndex < 0) {\n\t\t\t\t\t\t\tlastIndex = andList.lastIndexOf(userIdKey);\n\t\t\t\t\t\t}\n\t\t\t\t\t\tif (lastIndex < 0) {\n\t\t\t\t\t\t\tlastIndex = andList.lastIndexOf(idInKey);\n\t\t\t\t\t\t}\n\t\t\t\t\t\tif (lastIndex < 0) {\n\t\t\t\t\t\t\tlastIndex = andList.lastIndexOf(idKey);\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\n\t\t\t\t\ti = lastIndex + 1;\n\t\t\t\t}\n\n\t\t\t\tif (prior) {\n\t\t\t\t\tandList.add(i, key); // userId 的优先级不能比 id 高 0, key);\n\t\t\t\t} else {\n\t\t\t\t\t// AbstractSQLExecutor.onPutColumn 里 getSQL，要保证缓存的 SQL 和查询的 SQL 里 where 的 key:value 顺序一致\n\t\t\t\t\tandList.add(key);\n\t\t\t\t}\n\t\t\t}\n\t\t\tcombineMap.put(\"&\", andList);\n\t\t}\n\n\t\treturn this;\n\t}\n\n\t/**获取WHERE\n\t * @return\n\t * @throws Exception\n\t */\n\t@Override\n\tpublic String gainWhereString(boolean hasPrefix) throws Exception {\n\t\tString combineExpr = getCombine();\n\t\tif (StringUtil.isEmpty(combineExpr, false)) {\n\t\t\treturn getWhereString(hasPrefix, getMethod(), getWhere(), getCombineMap(), getJoinList(), ! isTest());\n\t\t}\n\t\treturn getWhereString(hasPrefix, getMethod(), getWhere(), combineExpr, getJoinList(), ! isTest());\n\t}\n\t/**获取WHERE\n\t * @param method\n\t * @param where\n\t * @return\n\t * @throws Exception\n\t */\n\tpublic String getWhereString(boolean hasPrefix, RequestMethod method, Map where\n\t\t\t, String combine, List> joinList, boolean verifyName) throws Exception {\n\t\tString whereString = parseCombineExpression(method, getQuote(), getTable(), getAlias()\n\t\t\t\t, where, combine, verifyName, false, false);\n\t\twhereString = concatJoinWhereString(whereString);\n\t\tString result = StringUtil.isEmpty(whereString, true) ? \"\" : (hasPrefix ? \" WHERE \" : \"\") + whereString;\n\n\t\tif (result.isEmpty() && RequestMethod.isQueryMethod(method) == false) {\n\t\t\tthrow new UnsupportedOperationException(\"写操作请求必须带条件！！！\");\n\t\t}\n\n\t\treturn result;\n\t}\n\n\t/**解析 @combine 条件 key 组合的与或非+括号的逻辑运算表达式为具体的完整条件组合\n\t * @param method\n\t * @param quote\n\t * @param table\n\t * @param alias\n\t * @param conditionMap where 或 having 对应条件的 Map\n\t * @param combine\n\t * @param verifyName\n\t * @param containRaw\n\t * @param isHaving\n\t * @return\n\t * @throws Exception\n\t */\n\tprotected String parseCombineExpression(RequestMethod method, String quote, String table, String alias\n\t\t\t, Map conditionMap, String combine, boolean verifyName, boolean containRaw, boolean isHaving) throws Exception {\n\n\t\tString errPrefix = table + (isHaving ? \":{ @having:{ \" : \":{ \") + \"@combine:'\" + combine + (isHaving ? \"' } }\" : \"' }\");\n\t\tString s = StringUtil.get(combine);\n\t\tif (s.startsWith(\" \") || s.endsWith(\" \") ) {\n\t\t\tthrow new IllegalArgumentException(errPrefix + \" 中字符 '\" + s\n\t\t\t\t\t+ \"' 不合法！不允许首尾有空格，也不允许连续空格！空格不能多也不能少！\"\n\t\t\t\t\t+ \"逻辑连接符 & | 左右必须各一个相邻空格！左括号 ( 右边和右括号 ) 左边都不允许有相邻空格！\");\n\t\t}\n\n\t\tif (conditionMap == null) {\n\t\t\tconditionMap = new HashMap<>();\n\t\t}\n\t\tint size = conditionMap.size();\n\n\t\tint maxCount = isHaving ? getMaxHavingCount() : getMaxWhereCount();\n\t\tif (maxCount > 0 && size > maxCount) {\n\t\t\tthrow new IllegalArgumentException(table + (isHaving ? \":{ @having:{ \" : \":{ \") + \"key0:value0, key1:value1... \" + combine\n\t\t\t\t\t+ (isHaving ? \" } }\" : \" }\") + \" 中条件 key:value 数量 \" + size + \" 已超过最大数量，必须在 0-\" + maxCount + \" 内！\");\n\t\t}\n\n\t\tString result = \"\";\n\n\t\tList preparedValues = getPreparedValueList();\n\t\tif (preparedValues == null && isHaving == false) {\n\t\t\tpreparedValues = new ArrayList<>();\n\t\t}\n\n\t\tMap usedKeyCountMap = new HashMap<>(size);\n\n\t\tint n = s.length();\n\t\tif (n > 0) {\n\t\t\tif (isHaving == false) { // 只收集表达式条件值\n\t\t\t\tsetPreparedValueList(new ArrayList<>()); // 必须反过来，否则 JOIN ON 内部 @combine 拼接后顺序错误\n\t\t\t}\n\n\t\t\tint maxDepth = getMaxCombineDepth();\n\t\t\tint maxCombineCount = getMaxCombineCount();\n\t\t\tint maxCombineKeyCount = getMaxCombineKeyCount();\n\t\t\tfloat maxCombineRatio = getMaxCombineRatio();\n\n\t\t\tint depth = 0;\n\t\t\tint allCount = 0;\n\n\t\t\tint i = 0;\n\n\t\t\tchar lastLogic = 0;\n\t\t\tchar last = 0;\n\t\t\tboolean first = true;\n\t\t\tboolean isNot = false;\n\n\t\t\tString key = \"\";\n\t\t\twhile (i <= n) { // \"date> | (contactIdList<> & (name*~ | tag&$))\"\n\t\t\t\tboolean isOver = i >= n;\n\t\t\t\tchar c = isOver ? 0 : s.charAt(i);\n\t\t\t\tboolean isBlankOrRightParenthesis = c == ' ' || c == ')';\n\t\t\t\tif (isOver || isBlankOrRightParenthesis) {\n\t\t\t\t\tboolean isEmpty = StringUtil.isEmpty(key, true);\n\t\t\t\t\tif (isEmpty && last != ')') {\n\t\t\t\t\t\tthrow new IllegalArgumentException(errPrefix + \" 中字符 '\" + (isOver ? s : s.substring(i))\n\t\t\t\t\t\t\t\t+ \"' 不合法！\" + (c == ' ' ? \"空格 ' ' \" : \"右括号 ')'\") + \" 左边缺少条件 key ！逻辑连接符 & | 左右必须各一个相邻空格！\"\n\t\t\t\t\t\t\t\t+ \"空格不能多也不能少！不允许首尾有空格，也不允许连续空格！左括号 ( 的右边 和 右括号 ) 的左边 都不允许有相邻空格！\");\n\t\t\t\t\t}\n\n\t\t\t\t\tif (isEmpty == false) {\n\t\t\t\t\t\tif (first == false && lastLogic <= 0) {\n\t\t\t\t\t\t\tthrow new IllegalArgumentException(errPrefix + \" 中字符 \"\n\t\t\t\t\t\t\t\t\t+ \"'\" + s.substring(i - key.length() - (isOver ? 1 : 0))\n\t\t\t\t\t\t\t\t\t+ \"' 不合法！左边缺少 & | 其中一个逻辑连接符！\");\n\t\t\t\t\t\t}\n\n\t\t\t\t\t\tallCount ++;\n\t\t\t\t\t\tif (allCount > maxCombineCount && maxCombineCount > 0) {\n\t\t\t\t\t\t\tthrow new IllegalArgumentException(errPrefix + \" 中字符 '\" + s + \"' 不合法！\"\n\t\t\t\t\t\t\t\t\t+ \"其中 key 数量 \" + allCount + \" 已超过最大值，必须在条件键值对数量 0-\" + maxCombineCount + \" 内！\");\n\t\t\t\t\t\t}\n\n\t\t\t\t\t\tString column = key;\n\t\t\t\t\t\tint keyIndex = column.indexOf(\":\");\n\t\t\t\t\t\tcolumn = keyIndex > 0 ? column.substring(0, keyIndex) : column;\n\t\t\t\t\t\tObject value = conditionMap.get(column);\n\t\t\t\t\t\tString wi = \"\";\n\t\t\t\t\t\tif (value == null && conditionMap.containsKey(column) == false) { // 兼容@null\n\t\t\t\t\t\t\tisNot = false; // 以占位表达式为准\n\t\t\t\t\t\t\tsize++; // 兼容 key 数量判断\n\t\t\t\t\t\t\twi = keyIndex > 0 ? key.substring(keyIndex + 1) : \"\";\n\t\t\t\t\t\t\tif (StringUtil.isEmpty(wi)) {\n\t\t\t\t\t\t\t\tthrow new IllegalArgumentException(errPrefix + \" 中字符 '\"\n\t\t\t\t\t\t\t\t\t\t+ key + \"' 对应的条件键值对 \" + column + \":value 不存在！\");\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t} else {\n\t\t\t\t\t\t\twi = isHaving ? gainHavingItem(quote, table, alias, column, (String) value, containRaw)\n\t\t\t\t\t\t\t\t\t: gainWhereItem(column, value, method, verifyName);\n\t\t\t\t\t\t}\n\n\t\t\t\t\t\tif (1.0f*allCount/size > maxCombineRatio && maxCombineRatio > 0) {\n\t\t\t\t\t\t\tthrow new IllegalArgumentException(errPrefix + \" 中字符 '\" + s + \"' 不合法！\"\n\t\t\t\t\t\t\t\t\t+ \"其中 key 数量 \" + allCount + \" / 条件键值对数量 \" + size + \" = \" + (1.0f*allCount/size)\n\t\t\t\t\t\t\t\t\t+ \" 已超过 最大倍数，必须在条件键值对数量 0-\" + maxCombineRatio + \" 倍内！\");\n\t\t\t\t\t\t}\n\n\t\t\t\t\t\tif (StringUtil.isEmpty(wi, true)) { // 转成 1=1 ?\n\t\t\t\t\t\t\tthrow new IllegalArgumentException(errPrefix + \" 中字符 '\" + key\n\t\t\t\t\t\t\t\t\t+ \"' 对应的 \" + column + \":value 不是有效条件键值对！\");\n\t\t\t\t\t\t}\n\n\t\t\t\t\t\tInteger count = usedKeyCountMap.get(column);\n\t\t\t\t\t\tcount = count == null ? 1 : count + 1;\n\t\t\t\t\t\tif (count > maxCombineKeyCount && maxCombineKeyCount > 0) {\n\t\t\t\t\t\t\tthrow new IllegalArgumentException(errPrefix + \" 中字符 '\" + s + \"' 不合法！\"\n\t\t\t\t\t\t\t\t\t+ \"其中 '\" + column + \"' 重复引用，次数 \" + count\n\t\t\t\t\t\t\t\t\t+ \" 已超过最大值，必须在 0-\" + maxCombineKeyCount + \" 内！\");\n\t\t\t\t\t\t}\n\t\t\t\t\t\tusedKeyCountMap.put(column, count);\n\n\t\t\t\t\t\tresult += \"( \" + gainCondition(isNot, wi) + \" )\";\n\t\t\t\t\t\tisNot = false;\n\t\t\t\t\t\tfirst = false;\n\t\t\t\t\t}\n\n\t\t\t\t\tkey = \"\";\n\t\t\t\t\tlastLogic = 0;\n\n\t\t\t\t\tif (isOver) {\n\t\t\t\t\t\tbreak;\n\t\t\t\t\t}\n\t\t\t\t}\n\n\t\t\t\tif (c == ' ') {\n\t\t\t\t}\n\t\t\t\telse if (c == '&') {\n\t\t\t\t\tif (last == ' ') {\n\t\t\t\t\t\tif (i >= n - 1 || s.charAt(i + 1) != ' ') {\n\t\t\t\t\t\t\tthrow new IllegalArgumentException(errPrefix + \" 中字符 '\" + (i >= n - 1 ? s : s.substring(0, i + 1))\n\t\t\t\t\t\t\t\t\t+ \"' 不合法！逻辑连接符 & 右边缺少一个空格 ！逻辑连接符 & | 左右必须各一个相邻空格！空格不能多也不能少！\"\n\t\t\t\t\t\t\t\t\t+ \"不允许首尾有空格，也不允许连续空格！左括号 ( 的右边 和 右括号 ) 的左边 都不允许有相邻空格！\");\n\t\t\t\t\t\t}\n\n\t\t\t\t\t\tresult += SQL.AND;\n\t\t\t\t\t\tlastLogic = c;\n\t\t\t\t\t\ti ++;\n\t\t\t\t\t}\n\t\t\t\t\telse {\n\t\t\t\t\t\tkey += c;\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t\telse if (c == '|') {\n\t\t\t\t\tif (last == ' ') {\n\t\t\t\t\t\tif (i >= n - 1 || s.charAt(i + 1) != ' ') {\n\t\t\t\t\t\t\tthrow new IllegalArgumentException(table + \":{ @combine: '\" + combine\n\t\t\t\t\t\t\t\t\t+ \"' } 中字符 '\" + (i >= n - 1 ? s : s.substring(0, i + 1))\n\t\t\t\t\t\t\t\t\t+ \"' 不合法！逻辑连接符 | 右边缺少一个空格 ！逻辑连接符 & | 左右必须各一个相邻空格！空格不能多也不能少！\"\n\t\t\t\t\t\t\t\t\t+ \"不允许首尾有空格，也不允许连续空格！左括号 ( 右边和右括号 ) 左边都不允许有相邻空格！\");\n\t\t\t\t\t\t}\n\n\t\t\t\t\t\tresult += SQL.OR;\n\t\t\t\t\t\tlastLogic = c;\n\t\t\t\t\t\ti ++;\n\t\t\t\t\t}\n\t\t\t\t\telse {\n\t\t\t\t\t\tkey += c;\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t\telse if (c == '!') {\n\t\t\t\t\tlast = i <= 0 ? 0 : s.charAt(i - 1); // & | 后面跳过了空格\n\n\t\t\t\t\tchar next = i >= n - 1 ? 0 : s.charAt(i + 1);\n\t\t\t\t\tif (last == ' ' || last == '(') {\n\t\t\t\t\t\tif (next == ' ') {\n\t\t\t\t\t\t\tthrow new IllegalArgumentException(errPrefix + \" 中字符 '\" + s.substring(0, i + 1)\n\t\t\t\t\t\t\t+ \"' 不合法！非逻辑符 '!' 右边多了一个空格 ' ' ！非逻辑符 '!' \" +\n\t\t\t\t\t\t\t\t\t\"右边不允许任何相邻空格 ' '，也不允许 ')' '&' '|' 中任何一个！\");\n\t\t\t\t\t\t}\n\t\t\t\t\t\tif (next == ')' || next == '&' || next == '!') {\n\t\t\t\t\t\t\tthrow new IllegalArgumentException(errPrefix + \" 中字符 '\" + s.substring(0, i + 1)\n\t\t\t\t\t\t\t+ \"' 不合法！非逻辑符 '!' 右边多了一个字符 '\"\n\t\t\t\t\t\t\t\t\t+ next + \"' ！非逻辑符 '!' 右边不允许任何相邻空格 ' '，也不允许 ')' '&' '|' 中任何一个！\");\n\t\t\t\t\t\t}\n\t\t\t\t\t\tif (i > 0 && lastLogic <= 0 && last != '(') {\n\t\t\t\t\t\t\tthrow new IllegalArgumentException(errPrefix + \" 中字符 '\" + s.substring(i)\n\t\t\t\t\t\t\t+ \"' 不合法！左边缺少 & | 逻辑连接符！逻辑连接符 & | 左右必须各一个相邻空格！空格不能多也不能少！\"\n\t\t\t\t\t\t\t+ \"不允许首尾有空格，也不允许连续空格！左括号 ( 的右边 和 右括号 ) 的左边 都不允许有相邻空格！\");\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\n\t\t\t\t\tif (next == '(') {\n\t\t\t\t\t\tresult += SQL.NOT;\n\t\t\t\t\t\tlastLogic = c;\n\t\t\t\t\t}\n\t\t\t\t\telse if (last <= 0 || last == ' ' || last == '(') {\n\t\t\t\t\t\tisNot = true;\n\t\t\t\t\t\t//\t\t\t\t\tlastLogic = c;\n\t\t\t\t\t}\n\t\t\t\t\telse {\n\t\t\t\t\t\tkey += c;\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t\telse if (c == '(') {\n\t\t\t\t\tif (key.isEmpty() == false || (i > 0 && lastLogic <= 0 && last != '(')) {\n\t\t\t\t\t\tthrow new IllegalArgumentException(errPrefix + \" 中字符 '\" + s.substring(i)\n\t\t\t\t\t\t+ \"' 不合法！左边缺少 & | 逻辑连接符！逻辑连接符 & | 左右必须各一个相邻空格！空格不能多也不能少！\"\n\t\t\t\t\t\t+ \"不允许首尾有空格，也不允许连续空格！左括号 ( 的右边 和 右括号 ) 的左边 都不允许有相邻空格！\");\n\t\t\t\t\t}\n\n\t\t\t\t\tdepth ++;\n\t\t\t\t\tif (depth > maxDepth && maxDepth > 0) {\n\t\t\t\t\t\tthrow new IllegalArgumentException(errPrefix + \" 中字符 '\" + s.substring(0, i + 1)\n\t\t\t\t\t\t+ \"' 不合法！括号 (()) 嵌套层级 \" + depth + \" 已超过最大值，必须在 0-\" + maxDepth + \" 内！\");\n\t\t\t\t\t}\n\n\t\t\t\t\tresult += c;\n\t\t\t\t\tlastLogic = 0;\n\t\t\t\t\tfirst = true;\n\t\t\t\t}\n\t\t\t\telse if (c == ')') {\n\t\t\t\t\tdepth --;\n\t\t\t\t\tif (depth < 0) {\n\t\t\t\t\t\tthrow new IllegalArgumentException(errPrefix + \" 中字符 '\" + s.substring(0, i + 1)\n\t\t\t\t\t\t+ \"' 不合法！左括号 ( 比 右括号 ) 少！数量必须相等从而完整闭合 (...) ！\");\n\t\t\t\t\t}\n\n\t\t\t\t\tresult += c;\n\t\t\t\t\tlastLogic = 0;\n\t\t\t\t}\n\t\t\t\telse {\n\t\t\t\t\tkey += c;\n\t\t\t\t}\n\n\t\t\t\tlast = c;\n\t\t\t\ti ++;\n\t\t\t}\n\n\t\t\tif (depth != 0) {\n\t\t\t\tthrow new IllegalArgumentException(errPrefix + \" 中字符 '\" + s\n\t\t\t\t\t\t+ \"' 不合法！左括号 ( 比 右括号 ) 多！数量必须相等从而完整闭合 (...) ！\");\n\t\t\t}\n\t\t}\n\n\t\tList exprPreparedValues = getPreparedValueList();\n\t\tif (isHaving == false) { // 只收集 AND 条件值\n\t\t\tsetPreparedValueList(new ArrayList<>());\n\t\t}\n\n\t\tSet> set = conditionMap.entrySet();\n\n\t\tString andCond = \"\";\n\t\tboolean isItemFirst = true;\n\n\t\tfor (Entry entry : set) {\n\t\t\tString key = entry == null ? null : entry.getKey();\n\t\t\tif (key == null || usedKeyCountMap.containsKey(key)) {\n\t\t\t\tcontinue;\n\t\t\t}\n\n\t\t\tString wi = isHaving ? gainHavingItem(quote, table, alias, key, (String) entry.getValue(), containRaw)\n\t\t\t\t\t: gainWhereItem(key, entry.getValue(), method, verifyName);\n\t\t\tif (StringUtil.isEmpty(wi, true)) {//避免SQL条件连接错误\n\t\t\t\tcontinue;\n\t\t\t}\n\n\t\t\tandCond += (isItemFirst ? \"\" : AND) + \"(\" + wi + \")\";\n\t\t\tisItemFirst = false;\n\t\t}\n\n\t\tif (isHaving == false) { // 优先存放 AND 条件值\n\t\t\tpreparedValues.addAll(getPreparedValueList());\n\t\t}\n\n\t\tif (StringUtil.isEmpty(result, true)) {\n\t\t\tresult = andCond;\n\t\t}\n\t\telse if (StringUtil.isNotEmpty(andCond, true)) { // andCond 必须放后面，否则 prepared 值顺序错误\n\t\t\tif (isHaving) {\n\t\t\t\t// HAVING 前 WHERE 已经有条件 ? 占位，不能反过来，想优化 AND 连接在最前，需要多遍历一次内部的 key，也可以 newSQLConfig 时存到 andList\n\t\t\t\tresult = \"( \" + result + \" )\" + AND + andCond;\n\t\t\t}\n\t\t\telse {\n\t\t\t\tresult = andCond + AND + \"( \" + result + \" )\"; // 先暂存之前的 prepared 值，然后反向整合\n\t\t\t}\n\t\t}\n\n\t\tif (isHaving == false) {\n\t\t\tif (exprPreparedValues != null && exprPreparedValues.isEmpty() == false) {\n\t\t\t\tpreparedValues.addAll(exprPreparedValues); // 在 AND 条件值后存放表达式内的条件值\n\t\t\t}\n\t\t\tsetPreparedValueList(preparedValues);\n\t\t}\n\n\t\treturn result;\n\t}\n\n\t/**@combine:\"a,b\" 条件组合。虽然有了 @combine:\"a | b\" 这种新方式，但为了 Join 多个 On 能保证顺序正确，以及这个性能更好，还是保留这个方式\n\t * @param hasPrefix\n\t * @param method\n\t * @param where\n\t * @param combine\n\t * @param joinList\n\t * @param verifyName\n\t * @return\n\t * @throws Exception\n\t */\n\tpublic String getWhereString(boolean hasPrefix, RequestMethod method, Map where\n\t\t, Map> combine, List> joinList, boolean verifyName) throws Exception {\n\t\tSet>> combineSet = combine == null ? null : combine.entrySet();\n\t\tif (combineSet == null || combineSet.isEmpty()) {\n\t\t\tLog.w(TAG, \"getWhereString combineSet == null || combineSet.isEmpty() >> return \\\"\\\";\");\n\t\t\treturn \"\";\n\t\t}\n\n\t\tList keyList;\n\n\t\tString whereString = \"\";\n\n\t\tboolean isCombineFirst = true;\n\t\tint logic;\n\n\t\tboolean isItemFirst;\n\t\tString c;\n\t\tString cs;\n\n\t\tfor (Entry> ce : combineSet) {\n\t\t\tkeyList = ce == null ? null : ce.getValue();\n\t\t\tif (keyList == null || keyList.isEmpty()) {\n\t\t\t\tcontinue;\n\t\t\t}\n\n\t\t\tif (\"|\".equals(ce.getKey())) {\n\t\t\t\tlogic = Logic.TYPE_OR;\n\t\t\t}\n\t\t\telse if (\"!\".equals(ce.getKey())) {\n\t\t\t\tlogic = Logic.TYPE_NOT;\n\t\t\t}\n\t\t\telse {\n\t\t\t\tlogic = Logic.TYPE_AND;\n\t\t\t}\n\n\t\t\tisItemFirst = true;\n\t\t\tcs = \"\";\n\t\t\tfor (String key : keyList) {\n\t\t\t\tc = gainWhereItem(key, where.get(key), method, verifyName);\n\n\t\t\t\tif (StringUtil.isEmpty(c, true)) {//避免SQL条件连接错误\n\t\t\t\t\tcontinue;\n\t\t\t\t}\n\n\t\t\t\tcs += (isItemFirst ? \"\" : (Logic.isAnd(logic) ? AND : OR)) + \"(\" + c + \")\";\n\t\t\t\tisItemFirst = false;\n\t\t\t}\n\n\t\t\tif (StringUtil.isEmpty(cs, true)) {//避免SQL条件连接错误\n\t\t\t\tcontinue;\n\t\t\t}\n\n\t\t\twhereString += (isCombineFirst ? \"\" : AND) + (Logic.isNot(logic) ? NOT : \"\") + \" ( \" + cs + \" ) \";\n\t\t\tisCombineFirst = false;\n\t\t}\n\n\t\twhereString = concatJoinWhereString(whereString);\n\n\t\tString s = StringUtil.isEmpty(whereString, true) ? \"\" : (hasPrefix ? \" WHERE \" : \"\") + whereString;\n\n\t\tif (s.isEmpty() && RequestMethod.isQueryMethod(method) == false) {\n\t\t\tthrow new UnsupportedOperationException(\"写操作请求必须带条件！！！\");\n\t\t}\n\n\t\treturn s;\n\t}\n\n\n\tprotected String concatJoinWhereString(String whereString) throws Exception {\n\t\tList> joinList = getJoinList();\n\t\tif (joinList != null) {\n\n\t\t\tString newWs = \"\";\n\t\t\tString ws = whereString;\n\n\t\t\tList newPvl = new ArrayList<>();\n\t\t\tList pvl = new ArrayList<>(getPreparedValueList());\n\n\t\t\tSQLConfig jc;\n\t\t\tSQLConfig outerConfig;\n\t\t\tString js;\n\t\t\tboolean isWsEmpty = StringUtil.isEmpty(ws, true);\n\t\t\tboolean changed = false;\n\t\t\t// 各种 JOIN 没办法统一用 & | ！连接，只能按优先级，和 @combine 一样?\n\t\t\tfor (Join j : joinList) {\n\t\t\t\tString jt = j.getJoinType();\n\n\t\t\t\tswitch (jt) {\n\t\t\t\tcase \"*\": // CROSS JOIN\n\t\t\t\tcase \"@\": // APP JOIN\n\t\t\t\tcase \"<\": // LEFT JOIN\n\t\t\t\tcase \">\": // RIGHT JOIN\n\t\t\t\t\touterConfig = j.getOuterConfig();\n\t\t\t\t\tif (outerConfig == null){\n\t\t\t\t\t\tbreak;\n\t\t\t\t\t}\n\t\t\t\t\tboolean isMain1 = outerConfig.isMain();\n\t\t\t\t\touterConfig.setMain(false).setPrepared(isPrepared()).setPreparedValueList(new ArrayList());\n\t\t\t\t\tString outerWhere = outerConfig.gainWhereString(false);\n\n\t\t\t\t\tint logic1 = Logic.getType(jt);\n\t\t\t\t\tnewWs += \" ( \"\n\t\t\t\t\t\t\t+ gainCondition(\n\t\t\t\t\t\t\tLogic.isNot(logic1),\n\t\t\t\t\t\t\tws\n\t\t\t\t\t\t\t\t\t+ ( isWsEmpty ? \"\" : (Logic.isAnd(logic1) ? AND : OR) )\n\t\t\t\t\t\t\t\t\t+ \" ( \" + outerWhere + \" ) \"\n\t\t\t\t\t)\n\t\t\t\t\t\t\t+ \" ) \";\n\t\t\t\t\tnewPvl.addAll(pvl);\n\t\t\t\t\tnewPvl.addAll(outerConfig.getPreparedValueList());\n\n\t\t\t\t\tchanged = true;\n\t\t\t\t\tbreak;\n\n\t\t\t\tcase \"&\": // INNER JOIN: A & B\n\t\t\t\tcase \"\": // FULL JOIN: A | B\n\t\t\t\tcase \"|\": // FULL JOIN: A | B\n\t\t\t\tcase \"!\": // OUTER JOIN: ! (A | B)\n\t\t\t\tcase \"^\": // SIDE JOIN: ! (A & B)\n\t\t\t\tcase \"(\": // ANTI JOIN: A & ! B\n\t\t\t\tcase \")\": // FOREIGN JOIN: B & ! A\n\t\t\t\tcase \"~\": // ASOF JOIN: B ~= A\n\t\t\t\t\tjc = j.getJoinConfig();\n\t\t\t\t\tboolean isMain = jc.isMain();\n\t\t\t\t\tjc.setMain(false).setPrepared(isPrepared()).setPreparedValueList(new ArrayList());\n\t\t\t\t\tjs = jc.gainWhereString(false);\n\t\t\t\t\tjc.setMain(isMain);\n\n\t\t\t\t\tboolean isOuterJoin = \"!\".equals(jt);\n\t\t\t\t\tboolean isSideJoin = \"^\".equals(jt);\n\t\t\t\t\tboolean isAntiJoin = \"(\".equals(jt);\n\t\t\t\t\tboolean isForeignJoin = \")\".equals(jt);\n\t\t\t\t\t//boolean isWsEmpty = StringUtil.isEmpty(ws, true);\n\n\t\t\t\t\tif (isWsEmpty) {\n\t\t\t\t\t\tif (isOuterJoin) { // ! OUTER JOIN: ! (A | B)\n\t\t\t\t\t\t\tthrow new NotExistException(\"no result for ! OUTER JOIN( ! (A | B) ) when A or B is empty!\");\n\t\t\t\t\t\t}\n\t\t\t\t\t\tif (isForeignJoin) { // ) FOREIGN JOIN: B & ! A\n\t\t\t\t\t\t\tthrow new NotExistException(\"no result for ) FOREIGN JOIN( B & ! A ) when A is empty!\");\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\n\t\t\t\t\tif (StringUtil.isEmpty(js, true)) {\n\t\t\t\t\t\tif (isOuterJoin) { // ! OUTER JOIN: ! (A | B)\n\t\t\t\t\t\t\tthrow new NotExistException(\"no result for ! OUTER JOIN( ! (A | B) ) when A or B is empty!\");\n\t\t\t\t\t\t}\n\t\t\t\t\t\tif (isAntiJoin) { // ( ANTI JOIN: A & ! B\n\t\t\t\t\t\t\tthrow new NotExistException(\"no result for ( ANTI JOIN( A & ! B ) when B is empty!\");\n\t\t\t\t\t\t}\n\n\t\t\t\t\t\tif (isWsEmpty) {\n\t\t\t\t\t\t\tif (isSideJoin) {\n\t\t\t\t\t\t\t\tthrow new NotExistException(\"no result for ^ SIDE JOIN( ! (A & B) ) when both A and B are empty!\");\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t}\n\t\t\t\t\t\telse {\n\t\t\t\t\t\t\tif (isSideJoin || isForeignJoin) {\n\t\t\t\t\t\t\t\tnewWs += \" ( \" + gainCondition(true, ws) + \" ) \";\n\n\t\t\t\t\t\t\t\tnewPvl.addAll(pvl);\n\t\t\t\t\t\t\t\tnewPvl.addAll(jc.getPreparedValueList());\n\t\t\t\t\t\t\t\tchanged = true;\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t}\n\n\t\t\t\t\t\tcontinue;\n\t\t\t\t\t}\n\n\t\t\t\t\tif (StringUtil.isNotEmpty(newWs, true)) {\n\t\t\t\t\t\tnewWs += AND;\n\t\t\t\t\t}\n\n\t\t\t\t\tif (isAntiJoin) { // ( ANTI JOIN: A & ! B\n\t\t\t\t\t\tnewWs += \" ( \" + ( isWsEmpty ? \"\" : ws + AND ) + NOT + \" ( \" + js + \" ) \" + \" ) \";\n\t\t\t\t\t}\n\t\t\t\t\telse if (isForeignJoin) { // ) FOREIGN JOIN: (! A) & B // preparedValueList.add 不好反过来 B & ! A\n\t\t\t\t\t\tnewWs += \" ( \" + NOT + \" ( \" + ws + \" ) ) \" + AND + \" ( \" + js + \" ) \";\n\t\t\t\t\t}\n\t\t\t\t\telse if (isSideJoin) { // ^ SIDE JOIN: ! (A & B)\n\t\t\t\t\t\t//MySQL 因为 NULL 值处理问题，(A & ! B) | (B & ! A) 与 ! (A & B) 返回结果不一样，后者往往更多\n\t\t\t\t\t\tnewWs += \" ( \" + gainCondition(\n\t\t\t\t\t\t\t\ttrue,\n\t\t\t\t\t\t\t\t( isWsEmpty ? \"\" : ws + AND ) + \" ( \" + js + \" ) \"\n\t\t\t\t\t\t\t\t) + \" ) \";\n\t\t\t\t\t}\n\t\t\t\t\telse { // & INNER JOIN: A & B; | FULL JOIN: A | B; OUTER JOIN: ! (A | B)\n\t\t\t\t\t\tint logic = Logic.getType(jt);\n\t\t\t\t\t\tnewWs += \" ( \"\n\t\t\t\t\t\t\t\t+ gainCondition(\n\t\t\t\t\t\t\t\t\t\tLogic.isNot(logic),\n\t\t\t\t\t\t\t\t\t\tws\n\t\t\t\t\t\t\t\t\t\t+ ( isWsEmpty ? \"\" : (Logic.isAnd(logic) ? AND : OR) )\n\t\t\t\t\t\t\t\t\t\t+ \" ( \" + js + \" ) \"\n\t\t\t\t\t\t\t\t\t\t)\n\t\t\t\t\t\t\t\t+ \" ) \";\n\t\t\t\t\t}\n\n\t\t\t\t\tnewPvl.addAll(pvl);\n\t\t\t\t\tnewPvl.addAll(jc.getPreparedValueList());\n\n\t\t\t\t\tchanged = true;\n\t\t\t\t\tbreak;\n\t\t\t\tdefault:\n\t\t\t\t\tthrow new UnsupportedOperationException(\n\t\t\t\t\t\t\t\"join:value 中 value 里的 \" + jt + \"/\" + j.getPath()\n\t\t\t\t\t\t\t+ \"错误！不支持 \" + jt + \" 等 [ @ APP, < LEFT, > RIGHT, * CROSS\"\n\t\t\t\t\t\t\t+ \", & INNER, | FULL, ! OUTER, ^ SIDE, ( ANTI, ) FOREIGN, ~ ASOF ] 之外的 JOIN 类型 !\"\n\t\t\t\t\t\t\t);\n\t\t\t\t}\n\t\t\t}\n\n\t\t\tif (changed) {\n\t\t\t\twhereString = newWs;\n\t\t\t\tsetPreparedValueList(newPvl);\n\t\t\t}\n\t\t}\n\n\t\treturn whereString;\n\t}\n\n\n\t/**\n\t * @param key\n\t * @param value\n\t * @param method\n\t * @param verifyName\n\t * @return\n\t * @throws Exception\n\t */\n\tprotected String gainWhereItem(String key, Object value, RequestMethod method, boolean verifyName) throws Exception {\n\t\tLog.d(TAG, \"getWhereItem key = \" + key);\n\t\t// 避免筛选到全部\tvalue = key == null ? null : where.get(key);\n\t\tif (key == null || key.endsWith(\"()\") || key.startsWith(\"@\")) { //关键字||方法, +或-直接报错\n\t\t\tLog.d(TAG, \"getWhereItem key == null || key.endsWith(()) || key.startsWith(@) >> continue;\");\n\t\t\treturn null;\n\t\t}\n\t\tif (key.endsWith(\"@\")) { // 引用\n\t\t\t//\tkey = key.substring(0, key.lastIndexOf(\"@\"));\n\t\t\tthrow new IllegalArgumentException(TAG + \".getWhereItem: 字符 \" + key + \" 不合法！\");\n\t\t}\n\n\t\tif (value == null) {\n\t\t\treturn null;\n\t\t}\n\n\t\tint keyType;\n\t\tif (key.endsWith(\"$\")) {\n\t\t\tkeyType = 1;\n\t\t}\n\t\telse if (key.endsWith(\"~\")) {\n\t\t\tkeyType = key.charAt(key.length() - 2) == '*' ? -2 : 2; //FIXME StringIndexOutOfBoundsException\n\t\t}\n\t\telse if (key.endsWith(\"%\")) {\n\t\t\tkeyType = 3;\n\t\t}\n\t\telse if (key.endsWith(\"{}\")) {\n\t\t\tkeyType = 4;\n\t\t}\n\t\telse if (key.endsWith(\"}{\")) {\n\t\t\tkeyType = 5;\n\t\t}\n\t\telse if (key.endsWith(\"<>\")) {\n\t\t\tkeyType = 6;\n\t\t}\n\t\telse if (key.endsWith(\">=\")) {\n\t\t\tkeyType = 7;\n\t\t}\n\t\telse if (key.endsWith(\"<=\")) {\n\t\t\tkeyType = 8;\n\t\t}\n\t\telse if (key.endsWith(\">\")) {\n\t\t\tkeyType = 9;\n\t\t}\n\t\telse if (key.endsWith(\"<\")) {\n\t\t\tkeyType = 10;\n\t\t} else { // else绝对不能省，避免再次踩坑！ keyType = 0; 写在for循环外面都没注意！\n\t\t\tkeyType = 0;\n\t\t}\n\n\t\tString column = gainRealKey(method, key, false, true, verifyName);\n\n\t\t// 原始 SQL 片段\n\t\tString rawSQL = gainRawSQL(key, value);\n\n\t\tswitch (keyType) {\n\t\tcase 1:\n\t\t\treturn gainSearchString(key, column, value, rawSQL);\n\t\tcase -2:\n\t\tcase 2:\n\t\t\treturn gainRegExpString(key, column, value, keyType < 0, rawSQL);\n\t\tcase 3:\n\t\t\treturn gainBetweenString(key, column, value, rawSQL);\n\t\tcase 4:\n\t\t\treturn gainRangeString(key, column, value, rawSQL);\n\t\tcase 5:\n\t\t\treturn gainExistsString(key, column, value, rawSQL);\n\t\tcase 6:\n\t\t\treturn gainContainString(key, column, value, rawSQL);\n\t\tcase 7:\n\t\t\treturn gainCompareString(key, column, value, \">=\", rawSQL);\n\t\tcase 8:\n\t\t\treturn gainCompareString(key, column, value, \"<=\", rawSQL);\n\t\tcase 9:\n\t\t\treturn gainCompareString(key, column, value, \">\", rawSQL);\n\t\tcase 10:\n\t\t\treturn gainCompareString(key, column, value, \"<\", rawSQL);\n\t\tdefault: // TODO MySQL JSON类型的字段对比 key='[]' 会无结果！ key LIKE '[1, 2, 3]' //TODO MySQL , 后面有空格！\n\t\t\treturn gainEqualString(key, column, value, rawSQL);\n\t\t}\n\t}\n\n\n\tpublic String gainEqualString(String key, String column, Object value, String rawSQL) throws Exception {\n\t\tif (value != null && JSON.isBoolOrNumOrStr(value) == false && value instanceof Subquery == false) {\n\t\t\tthrow new IllegalArgumentException(key + \":value 中value不合法！非PUT请求只支持 [Boolean, Number, String] 内的类型 ！\");\n\t\t}\n\n\t\tboolean not = column.endsWith(\"!\"); // & | 没有任何意义，写法多了不好控制\n\t\tif (not) {\n\t\t\tcolumn = column.substring(0, column.length() - 1);\n\t\t}\n\n\t\tString rc = column.endsWith(\"[\") || column.endsWith(\"{\") ? column.substring(0, column.length() - 1) : column;\n\t\tif (StringUtil.isName(rc) == false) {\n\t\t\tthrow new IllegalArgumentException(key + \":value 中key不合法！不支持 ! 以外的逻辑符 ！\");\n\t\t}\n\n\t\tString logic = value == null && rawSQL == null ? (not ? SQL.IS_NOT : SQL.IS) : (not ? \" != \" : \" = \");\n\t\treturn gainKey(column) + logic + (value instanceof Subquery ? gainSubqueryString((Subquery) value)\n\t\t\t\t: (rawSQL != null ? rawSQL : gainValue(key, column, value)));\n\t}\n\n\tpublic String gainCompareString(String key, String column, Object value, String type, String rawSQL) throws Exception {\n\t\tif (value != null && JSON.isBoolOrNumOrStr(value) == false && value instanceof Subquery == false) {\n\t\t\tthrow new IllegalArgumentException(key + \":value 中 value 不合法！比较运算 [>, <, >=, <=] 只支持 [Boolean, Number, String] 内的类型 ！\");\n\t\t}\n\n\t\tString rc = column.endsWith(\"[\") || column.endsWith(\"{\") ? column.substring(0, column.length() - 1) : column;\n\t\tif ( ! StringUtil.isName(rc)) {\n\t\t\tthrow new IllegalArgumentException(key + \":value 中 key 不合法！比较运算 [>, <, >=, <=] 不支持 [&, !, |] 中任何逻辑运算符 ！\");\n\t\t}\n\n\t\treturn gainKey(column) + \" \" + type + \" \" + (value instanceof Subquery ? gainSubqueryString((Subquery) value)\n\t\t\t\t: (rawSQL != null ? rawSQL : gainValue(key, column, value)));\n\t}\n\n\tpublic String gainKey(@NotNull String key) {\n\t\tString lenFun = \"\";\n\t\tif (key.endsWith(\"[\")) {\n\t\t\tlenFun = isSQLServer() ? \"datalength\" : \"length\";\n\t\t\tkey = key.substring(0, key.length() - 1);\n\t\t}\n\t\telse if (key.endsWith(\"{\")) {\n\t\t\tlenFun = \"json_length\";\n\t\t\tkey = key.substring(0, key.length() - 1);\n\t\t}\n\t\telse if (isTest()) {\n\t\t\tif (key.contains(\"'\")) { // || key.contains(\"#\") || key.contains(\"--\")) {\n\t\t\t\tthrow new IllegalArgumentException(\"参数 \" + key + \" 不合法！key 中不允许有单引号 ' ！\");\n\t\t\t}\n\t\t\treturn gainSQLValue(key).toString();\n\t\t}\n\n\t\tMap keyMap = getKeyMap();\n\t\tString expression = keyMap == null ? null : keyMap.get(key);\n\t\tif (expression == null) {\n\t\t\texpression = COLUMN_KEY_MAP == null ? null : COLUMN_KEY_MAP.get(key);\n\t\t}\n\n\t\tString sqlKey;\n\t\tif (expression == null) {\n\t\t\tsqlKey = gainSQLKey(key);\n\t\t}\n\t\telse {\n\t\t\t// (name,tag) left(date,4) 等\n\t\t\tList raw = getRaw();\n\t\t\tsqlKey = parseSQLExpression(KEY_KEY, expression, raw != null && raw.contains(KEY_KEY), false);\n\t\t}\n\n\t\treturn lenFun.isEmpty() ? sqlKey : lenFun + \"(\" + sqlKey + \")\";\n\t}\n\tpublic String gainSQLKey(String key) {\n\t\tString q = getQuote();\n\t\treturn (isKeyPrefix() ? q + gainSQLAlias() + q + \".\" : \"\") + q + key + q;\n\t}\n\n\t/**\n\t * 使用prepareStatement预编译，值为 ? ，后续动态set进去\n\t */\n\tprotected Object gainValue(@NotNull Object value) {\n\t\treturn gainValue(null, null, value);\n\t}\n\n\tprotected List preparedValueList = new ArrayList<>();\n\tprotected Object gainValue(String key, String column, Object value) {\n\t\tif (isPrepared()) {\n\t\t\tif (value == null) {\n\t\t\t\treturn null;\n\t\t\t}\n\n\t\t\tMap castMap = getCast();\n\t\t\tString type = key == null || castMap == null ? null : castMap.get(key);\n\n\t\t\t//\t\t\tif (\"DATE\".equalsIgnoreCase(type) && value instanceof Date == false) {\n\t\t\t//\t\t\t\tvalue = value instanceof Number ? new Date(((Number) value).longValue()) : Date.valueOf((String) value);\n\t\t\t//\t\t\t}\n\t\t\t//\t\t\telse if (\"TIME\".equalsIgnoreCase(type) && value instanceof Time == false) {\n\t\t\t//\t\t\t\tvalue = value instanceof Number ? new Time(((Number) value).longValue()) : Time.valueOf((String) value);\n\t\t\t//\t\t\t}\n\t\t\t//\t\t\telse if (\"TIMESTAMP\".equalsIgnoreCase(type) && value instanceof Timestamp == false) {\n\t\t\t//\t\t\t\tvalue = value instanceof Number ? new Timestamp(((Number) value).longValue()) : Timestamp.valueOf((String) value);\n\t\t\t//\t\t\t}\n\t\t\t//\t\t\telse if (\"ARRAY\".equalsIgnoreCase(type) && value instanceof Array == false) {\n\t\t\t//\t\t\t\tvalue = ((Collection) value).toArray();\n\t\t\t//\t\t\t}\n\t\t\t//\t\t\telse if (StringUtil.isEmpty(type, true) == false) {\n\t\t\t//\t\t\t\tpreparedValueList.add(value);\n\t\t\t//\t\t\t\treturn \"cast(?\" + SQL.AS + type + \")\";\n\t\t\t//\t\t\t}\n\n\t\t\tpreparedValueList.add(value);\n\t\t\treturn StringUtil.isEmpty(type, true) ? \"?\" : \"cast(?\" + SQL.AS + type + \")\";\n\t\t}\n\n\t\treturn key == null ? gainSQLValue(value) : gainSQLValue(key, column, value);\n\t}\n\n\tpublic Object gainSQLValue(String key, String column, @NotNull Object value) {\n\t\tMap castMap = getCast();\n\t\tString type = key == null || castMap == null ? null : castMap.get(key);\n\t\tObject val = gainSQLValue(value);\n\t\treturn StringUtil.isEmpty(type, true) ? val : \"cast(\" + val + SQL.AS + type + \")\";\n\t}\n\tpublic Object gainSQLValue(@NotNull Object value) {\n\t\tif (value == null) {\n\t\t\treturn SQL.NULL;\n\t\t}\n\t\t//\treturn (value instanceof Number || value instanceof Boolean)\n\t\t//\t&& DATABASE_POSTGRESQL.equals(getDatabase()) ? value : \"'\" + value + \"'\";\n\t\treturn (value instanceof Number || value instanceof Boolean)\n\t\t\t\t? value : \"'\" + value.toString().replaceAll(\"\\\\'\", \"\\\\\\\\'\") + \"'\"; // MySQL 隐式转换用不了索引\n\t}\n\n\t@Override\n\tpublic List getPreparedValueList() {\n\t\treturn preparedValueList;\n\t}\n\t@Override\n\tpublic AbstractSQLConfig setPreparedValueList(List preparedValueList) {\n\t\tthis.preparedValueList = preparedValueList;\n\t\treturn this;\n\t}\n\n\t//$ search <<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<\n\t/**search key match value\n\t* @param key\n\t* @param column\n\t* @param value\n\t* @param rawSQL\n\t* @return {@link #gainSearchString(String, String, Object[], int)}\n\t* @throws IllegalArgumentException\n\t*/\n\tpublic String gainSearchString(String key, String column, Object value, String rawSQL) throws IllegalArgumentException {\n\t\tif (rawSQL != null) {\n\t\t\tthrow new UnsupportedOperationException(\"@raw:value 中 \"\n\t\t\t\t\t+ key + \" 不合法！@raw 不支持 key$ 这种功能符 ！只支持 key, key!, key<, key{} 等比较运算 和 @column, @having ！\");\n\t\t}\n\t\tif (value == null) {\n\t\t\treturn \"\";\n\t\t}\n\n\t\tLogic logic = new Logic(column);\n\t\tcolumn = logic.getKey();\n\t\tLog.i(TAG, \"getSearchString column = \" + column);\n\n\t\tList arr = newJSONArray(value);\n\t\tif (arr.isEmpty()) {\n\t\t\treturn \"\";\n\t\t}\n\t\treturn gainSearchString(key, column, arr.toArray(), logic.getType());\n\t}\n\t/**search key match values\n\t* @param key\n\t* @param column\n\t* @param values\n\t* @param type\n\t* @return LOGIC [ key LIKE 'values[i]' ]\n\t* @throws IllegalArgumentException\n\t*/\n\tpublic String gainSearchString(String key, String column, Object[] values, int type) throws IllegalArgumentException {\n\t\tif (values == null || values.length <= 0) {\n\t\t\treturn \"\";\n\t\t}\n\n\t\tString condition = \"\";\n\t\tfor (int i = 0; i < values.length; i++) {\n\t\t\tObject v = values[i];\n\t\t\tif (v instanceof String == false) {\n\t\t\t\tthrow new IllegalArgumentException(key + \":value 中 value 的类型只能为 String 或 String[]！\");\n\t\t\t}\n\t\t\tif (((String) v).isEmpty()) { // 允许查空格 StringUtil.isEmpty((String) v, true)\n\t\t\t\tthrow new IllegalArgumentException(key + \":value 中 value 值 \" + v + \"是空字符串，没有意义，不允许这样传！\");\n\t\t\t}\n\t\t\t//\t\t\tif (((String) v).contains(\"%%\")) { // 需要通过 %\\%% 来模糊搜索 %\n\t\t\t//\t\t\t\tthrow new IllegalArgumentException(key + \"$:value 中 value 值 \" + v + \" 中包含 %% ！不允许有连续的 % ！\");\n\t\t\t//\t\t\t}\n\n\t\t\tcondition += (i <= 0 ? \"\" : (Logic.isAnd(type) ? AND : OR)) + gainLikeString(key, column, (String) v);\n\t\t}\n\n\t\treturn gainCondition(Logic.isNot(type), condition);\n\t}\n\n\t/**WHERE key LIKE 'value'\n\t * @param key\n\t * @param column\n\t * @param value\n\t * @return key LIKE 'value'\n\t */\n\tpublic String gainLikeString(@NotNull String key, @NotNull String column, String value) {\n\t\tString k = key.substring(0, key.length() - 1);\n\t\tchar r = k.charAt(k.length() - 1);\n\n\t\tchar l;\n\t\tif (r == '%' || r == '_' || r == '?') {\n\t\t\tk = k.substring(0, k.length() - 1);\n\n\t\t\tl = k.charAt(k.length() - 1);\n\t\t\tif (l == '%' || l == '_' || l == '?') {\n\t\t\t\tif (l == r) {\n\t\t\t\t\tthrow new IllegalArgumentException(key + \":value 中字符 \"\n\t\t\t\t\t\t\t+ k + \" 不合法！key$:value 中不允许 key 中有连续相同的占位符！\");\n\t\t\t\t}\n\n\t\t\t\tk = k.substring(0, k.length() - 1);\n\t\t\t}\n\t\t\telse if (l > 0 && StringUtil.isName(String.valueOf(l))) {\n\t\t\t\tl = r;\n\t\t\t}\n\n\t\t\tif (l == '?') {\n\t\t\t\tl = 0;\n\t\t\t}\n\t\t\tif (r == '?') {\n\t\t\t\tr = 0;\n\t\t\t}\n\t\t}\n\t\telse {\n\t\t\tl = r = 0;\n\t\t}\n\n\t\tif (l > 0 || r > 0) {\n\t\t\tif (value == null) {\n\t\t\t\tthrow new IllegalArgumentException(key + \":value 中 value 为 null！\" +\n\t\t\t\t\t\t\"key$:value 中 value 不能为 null，且类型必须是 String ！\");\n\t\t\t}\n\n\t\t\tvalue = value.replaceAll(\"\\\\\\\\\", \"\\\\\\\\\\\\\\\\\");\n\t\t\tvalue = value.replaceAll(\"\\\\%\", \"\\\\\\\\%\");\n\t\t\tvalue = value.replaceAll(\"\\\\_\", \"\\\\\\\\_\");\n\t\t\tif (l > 0) {\n\t\t\t\tvalue = l + value;\n\t\t\t}\n\t\t\tif (r > 0) {\n\t\t\t\tvalue = value + r;\n\t\t\t}\n\t\t}\n\n\t\treturn gainKey(column) + \" LIKE \" + gainValue(key, column, value);\n\t}\n\n\t//$ search >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>\n\n\n\n\t//~ regexp <<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<\n\t/**search key match RegExp values\n\t * @param key\n\t * @param column\n\t * @param value\n\t * @param ignoreCase\n\t * @return {@link #gainRegExpString(String, String, Object[], int, boolean)}\n\t * @throws IllegalArgumentException\n\t */\n\tpublic String gainRegExpString(String key, String column, Object value, boolean ignoreCase, String rawSQL)\n\t\t\tthrows IllegalArgumentException {\n\t\tif (rawSQL != null) {\n\t\t\tthrow new UnsupportedOperationException(\"@raw:value 中 \" + key + \" 不合法！@raw 不支持 key~ 这种功能符 ！\" +\n\t\t\t\t\t\"只支持 key, key!, key<, key{} 等比较运算 和 @column, @having ！\");\n\t\t}\n\t\tif (value == null) {\n\t\t\treturn \"\";\n\t\t}\n\n\t\tLogic logic = new Logic(column);\n\t\tcolumn = logic.getKey();\n\t\tLog.i(TAG, \"getRegExpString column = \" + column);\n\n\t\tL arr = newJSONArray(value);\n\t\tif (arr.isEmpty()) {\n\t\t\treturn \"\";\n\t\t}\n\t\treturn gainRegExpString(key, column, arr.toArray(), logic.getType(), ignoreCase);\n\t}\n\t/**search key match RegExp values\n\t * @param key\n\t * @param values\n\t * @param type\n\t * @param ignoreCase\n\t * @return LOGIC [ key REGEXP 'values[i]' ]\n\t * @throws IllegalArgumentException\n\t */\n\tpublic String gainRegExpString(String key, String column, Object[] values, int type, boolean ignoreCase)\n\t\t\tthrows IllegalArgumentException {\n\t\tif (values == null || values.length <= 0) {\n\t\t\treturn \"\";\n\t\t}\n\n\t\tString condition = \"\";\n\t\tfor (int i = 0; i < values.length; i++) {\n\t\t\tif (values[i] instanceof String == false) {\n\t\t\t\tthrow new IllegalArgumentException(key + \":value 中value的类型只能为String或String[]！\");\n\t\t\t}\n\t\t\tcondition += (i <= 0 ? \"\" : (Logic.isAnd(type) ? AND : OR))\n\t\t\t\t\t+ gainRegExpString(key, column, (String) values[i], ignoreCase);\n\t\t}\n\n\t\treturn gainCondition(Logic.isNot(type), condition);\n\t}\n\n\t/**WHERE key REGEXP 'value'\n\t * @param key\n\t * @param value\n\t * @param ignoreCase\n\t * @return key REGEXP 'value'\n\t */\n\tpublic String gainRegExpString(String key, String column, String value, boolean ignoreCase) {\n\t\tif (isPSQL()) {\n\t\t\treturn gainKey(column) + \" ~\" + (ignoreCase ? \"* \" : \" \") + gainValue(key, column, value);\n\t\t}\n\t\tif (isOracle() || isDameng() || isKingBase() || (isMySQL() && gainDBVersionNums()[0] >= 8)) {\n\t\t\treturn \"regexp_like(\" + gainKey(column) + \", \" + gainValue(key, column, value) + (ignoreCase ? \", 'i'\" : \", 'c'\") + \")\";\n\t\t}\n\t\tif (isPresto() || isTrino()) {\n\t\t\treturn \"regexp_like(\" + (ignoreCase ? \"lower(\" : \"\") + gainKey(column) + (ignoreCase ? \")\" : \"\")\n\t\t + \", \" + (ignoreCase ? \"lower(\" : \"\") + gainValue(key, column, value) + (ignoreCase ? \")\" : \"\") + \")\";\n\t\t}\n\t\tif (isClickHouse()) {\n\t\t\treturn \"match(\" + (ignoreCase ? \"lower(\" : \"\") + gainKey(column) + (ignoreCase ? \")\" : \"\")\n\t\t\t\t\t+ \", \" + (ignoreCase ? \"lower(\" : \"\") + gainValue(key, column, value) + (ignoreCase ? \")\" : \"\") + \")\";\n\t\t}\n\t\tif (isElasticsearch()) {\n\t\t\treturn gainKey(column) + \" RLIKE \" + gainValue(key, column, value);\n\t\t}\n\t\tif (isHive()) {\n\t\t\treturn (ignoreCase ? \"lower(\" : \"\") + gainKey(column) + (ignoreCase ? \")\" : \"\")\n\t\t\t\t\t+ \" REGEXP \" + (ignoreCase ? \"lower(\" : \"\") + gainValue(key, column, value) + (ignoreCase ? \")\" : \"\");\n\t\t}\n\t\treturn gainKey(column) + \" REGEXP \" + (ignoreCase ? \"\" : \"BINARY \") + gainValue(key, column, value);\n\t}\n\n\n\t//~ regexp >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>\n\n\n\n\t//% between <<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<\n\n\t/**WHERE key BETWEEN 'start' AND 'end'\n\t * @param key\n\t * @param value 'start,end'\n\t * @return LOGIC [ key BETWEEN 'start' AND 'end' ]\n\t * @throws IllegalArgumentException\n\t */\n\tpublic String gainBetweenString(String key, String column, Object value, String rawSQL) throws IllegalArgumentException {\n\t\tif (rawSQL != null) {\n\t\t\tthrow new UnsupportedOperationException(\"@raw:value 中 \" + key + \" 不合法！@raw 不支持 key% 这种功能符 ！\" +\n\t\t\t\t\t\"只支持 key, key!, key<, key{} 等比较运算 和 @column, @having ！\");\n\t\t}\n\t\tif (value == null) {\n\t\t\treturn \"\";\n\t\t}\n\n\t\tLogic logic = new Logic(column);\n\t\tcolumn = logic.getKey();\n\t\tLog.i(TAG, \"getBetweenString column = \" + column);\n\n\t\tL arr = newJSONArray(value);\n\t\tif (arr.isEmpty()) {\n\t\t\treturn \"\";\n\t\t}\n\t\treturn gainBetweenString(key, column, arr.toArray(), logic.getType());\n\t}\n\n\t/**WHERE key BETWEEN 'start' AND 'end'\n\t * @param key\n\t * @param column\n\t * @param values ['start,end'] TODO 在 '1,2' 和 ['1,2', '3,4'] 基础上新增支持 [1, 2] 和 [[1,2], [3,4]] ？\n\t * @param type\n\t * @return LOGIC [ key BETWEEN 'start' AND 'end' ]\n\t * @throws IllegalArgumentException\n\t */\n\tpublic String gainBetweenString(String key, String column, Object[] values, int type) throws IllegalArgumentException {\n\t\tif (values == null || values.length <= 0) {\n\t\t\treturn \"\";\n\t\t}\n\n\t\tString condition = \"\";\n\t\tString[] vs;\n\t\tfor (int i = 0; i < values.length; i++) {\n\t\t\tif (values[i] instanceof String == false) {\n\t\t\t\tthrow new IllegalArgumentException(key + \":value 中 value 的类型只能为 String 或 String[] ！\");\n\t\t\t}\n\n\t\t\tvs = StringUtil.split((String) values[i]);\n\t\t\tif (vs == null || vs.length != 2) {\n\t\t\t\tthrow new IllegalArgumentException(key + \":value 中 value 不合法！类型为 String 时必须包括1个逗号 , \" +\n\t\t\t\t\t\t\"且左右两侧都有值！类型为 String[] 里面每个元素要符合前面类型为 String 的规则 ！\");\n\t\t\t}\n\n\t\t\tcondition += (i <= 0 ? \"\" : (Logic.isAnd(type) ? AND : OR))\n\t\t\t\t\t+ \"(\" + gainBetweenString(key, column, vs[0], (Object) vs[1]) + \")\";\n\t\t}\n\n\t\treturn gainCondition(Logic.isNot(type), condition);\n\t}\n\n\t/**WHERE key BETWEEN 'start' AND 'end'\n\t* @return key\n\t* @param column\n\t* @param start\n\t* @param end\n\t* @return LOGIC [ key BETWEEN 'start' AND 'end' ]\n\t* @throws IllegalArgumentException\n\t*/\n\tpublic String gainBetweenString(String key, String column, Object start, Object end) throws IllegalArgumentException {\n\t\tif (JSON.isBoolOrNumOrStr(start) == false || JSON.isBoolOrNumOrStr(end) == false) {\n\t\t\tthrow new IllegalArgumentException(key + \":value 中 value 不合法！类型为 String 时必须包括1个逗号 , \" +\n\t\t\t\t\t\"且左右两侧都有值！类型为 String[] 里面每个元素要符合前面类型为 String 的规则 ！\");\n\t\t}\n\t\treturn gainKey(column) + \" BETWEEN \" + gainValue(key, column, start) + AND + gainValue(key, column, end);\n\t}\n\n\n\t//% between >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>\n\n\n\n\t//{} range <<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<\n\n\n\t/**WHERE key > 'key0' AND key <= 'key1' AND ...\n\t * @param key\n\t * @param range \"condition0,condition1...\"\n\t * @return key condition0 AND key condition1 AND ...\n\t * @throws Exception\n\t */\n\tpublic String gainRangeString(String key, String column, Object range, String rawSQL) throws Exception {\n\t\tLog.i(TAG, \"getRangeString column = \" + column);\n\t\tif (range == null) {//依赖的对象都没有给出有效值，这个存在无意义。如果是客户端传的，那就能在客户端确定了。\n\t\t\tthrow new NotExistException(TAG + \"getRangeString(\" + column + \", \" + range + \") range == null\");\n\t\t}\n\n\t\tLogic logic = new Logic(column);\n\t\tString k = logic.getKey();\n\t\tLog.i(TAG, \"getRangeString k = \" + k);\n\n\t\tif (range instanceof List) {\n\t\t\tif (rawSQL != null) {\n\t\t\t\tthrow new UnsupportedOperationException(\"@raw:value 的 value 中 \" + key + \" 不合法！\"\n\t\t\t\t\t\t+ \"Raw SQL 不支持 key{}:[] 这种键值对！\");\n\t\t\t}\n\n\t\t\tif (logic.isOr() || logic.isNot()) {\n\t\t\t\tList l = (List) range;\n\t\t\t\tif (logic.isNot() && l.isEmpty()) {\n\t\t\t\t\treturn \"\"; // key!{}: [] 这个条件无效，加到 SQL 语句中 key IN() 会报错，getInString 里不好处理\n\t\t\t\t}\n\t\t\t\treturn gainKey(k) + gainInString(k, column, l.toArray(), logic.isNot());\n\t\t\t}\n\t\t\tthrow new IllegalArgumentException(key + \":[] 中 {} 前面的逻辑运算符错误！只能用'|','!'中的一种 ！\");\n\t\t}\n\t\telse if (range instanceof String) {//非Number类型需要客户端拼接成 < 'value0', >= 'value1'这种\n\t\t\tString condition = \"\";\n\t\t\tString[] cs = rawSQL != null ? null : StringUtil.split((String) range, \";\", false);\n\n\t\t\tif (rawSQL != null) {\n\t\t\t\tint index = rawSQL.indexOf(\"(\");\n\t\t\t\tcondition = (index >= 0 && index < rawSQL.lastIndexOf(\")\") ? \"\" : gainKey(k) + \" \") + rawSQL;\n\t\t\t}\n\n\t\t\tif (cs != null) {\n\t\t\t\tList raw = getRaw();\n\t\t\t\tboolean containRaw = raw == null ? false : raw.contains(key);\n\t\t\t\tString lk = logic.isAnd() ? AND : OR;\n\n\t\t\t\tfor (int i = 0; i < cs.length; i++) {//对函数条件length(key)<=5这种不再在开头加key\n\t\t\t\t\tString expr = cs[i];\n\n\t\t\t\t\tif (expr.length() > 100) {\n\t\t\t\t\t\tthrow new UnsupportedOperationException(key + \":value 的 value 中字符串 \" + expr + \" 不合法！\"\n\t\t\t\t\t\t\t\t+ \"不允许传超过 100 个字符的函数或表达式！请用 @raw 简化传参！\");\n\t\t\t\t\t}\n\n\t\t\t\t\tint index = expr == null ? -1 : expr.indexOf(\"(\");\n\t\t\t\t\tif (index >= 0) {\n\t\t\t\t\t\texpr = parseSQLExpression(key, expr, containRaw, false\n\t\t\t\t\t\t\t\t, key + \":\\\"!=null;+3*2<=10;function0(arg0,arg1,...)>1;function1(...)%5<=3...\\\"\");\n\t\t\t\t\t}\n\t\t\t\t\telse {\n\t\t\t\t\t\tString fk = gainKey(k) + \" \";\n\t\t\t\t\t\tString[] ccs = StringUtil.split(expr, false);\n\t\t\t\t\t\texpr = \"\";\n\n\t\t\t\t\t\tfor (int j = 0; j < ccs.length; j++) {\n\t\t\t\t\t\t\tString c = ccs[j];\n\t\t\t\t\t\t\tif (\"=null\".equals(c)) {\n\t\t\t\t\t\t\t\tc = SQL.isNull();\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\telse if (\"!=null\".equals(c)) {\n\t\t\t\t\t\t\t\tc = SQL.isNull(false);\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\telse if (isPrepared() && (c.contains(\"--\") || PATTERN_RANGE.matcher(c).matches() == false)) {\n\t\t\t\t\t\t\t\tthrow new UnsupportedOperationException(key + \":value 的 value 中 \" + c + \" 不合法！\"\n\t\t\t\t\t\t\t\t\t\t+ \"预编译模式下 key{}:\\\"condition\\\" 中 condition 必须 为 =null 或 !=null \" +\n\t\t\t\t\t\t\t\t\t\t\"或 符合正则表达式 \" + PATTERN_RANGE + \" ！不允许连续减号 -- ！不允许空格！\");\n\t\t\t\t\t\t\t}\n\n\t\t\t\t\t\t\texpr += (j <= 0 ? \"\" : lk) + fk + c;\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\n\t\t\t\t\tcondition += ((i <= 0 ? \"\" : lk) + expr);\n\t\t\t\t}\n\t\t\t}\n\n\t\t\tif (condition.isEmpty()) {\n\t\t\t\treturn \"\";\n\t\t\t}\n\n\t\t\treturn gainCondition(logic.isNot(), condition);\n\t\t}\n\t\telse if (range instanceof Subquery) {\n\t\t\t// 如果在 Parser 解析成 SQL 字符串再引用，没法保证安全性，毕竟可以再通过远程函数等方式来拼接再替代，最后引用的字符串就能注入\n\t\t\treturn gainKey(k) + (logic.isNot() ? NOT : \"\") + \" IN \" + gainSubqueryString((Subquery) range);\n\t\t}\n\n\t\tthrow new IllegalArgumentException(key + \":range 类型为\" + range.getClass().getSimpleName()\n\t\t\t\t+ \"！range 只能是 用','分隔条件的字符串 或者 可取选项JSONArray！\");\n\t}\n\t/**WHERE key IN ('key0', 'key1', ... )\n\t * @param in\n\t * @return IN ('key0', 'key1', ... )\n\t * @throws NotExistException\n\t */\n\tpublic String gainInString(String key, String column, Object[] in, boolean not) throws NotExistException {\n\t\tString condition = \"\";\n\t\tif (in != null) {//返回 \"\" 会导致 id:[] 空值时效果和没有筛选id一样！\n\t\t\tfor (int i = 0; i < in.length; i++) {\n\t\t\t\tcondition += ((i > 0 ? \",\" : \"\") + gainValue(key, column, in[i]));\n\t\t\t}\n\t\t}\n\t\tif (condition.isEmpty()) {//条件如果存在必须执行，不能忽略。条件为空会导致出错，又很难保证条件不为空(@:条件)，所以还是这样好\n\t\t\tthrow new NotExistException(TAG + \".getInString(\" + key + \",\" + column + \", [], \" + not + \") >> condition.isEmpty() >> IN()\");\n\t\t}\n\t\treturn (not ? NOT : \"\") + \" IN (\" + condition + \")\";\n\t}\n\t//{} range >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>\n\n\n\t//}{ exists <<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<\n\t/**WHERE EXISTS subquery\n\t * 如果合并到 getRangeString，一方面支持不了 [1,2,2] 和 \">1\" (转成 EXISTS(SELECT IN ) 需要\n\t * static newSQLConfig，但它不能传入子类实例，除非不是 static)，另一方面多了子查询临时表性能会比 IN 差\n\t * @param key\n\t * @param value\n\t * @return EXISTS ALL(SELECT ...)\n\t * @throws NotExistException\n\t */\n\tpublic String gainExistsString(String key, String column, Object value, String rawSQL) throws Exception {\n\t\tif (rawSQL != null) {\n\t\t\tthrow new UnsupportedOperationException(\"@raw:value 中 \" + key + \" 不合法！\" +\n\t\t\t\t\t\"@raw 不支持 key}{ 这种功能符 ！只支持 key, key!, key<, key{} 等比较运算 和 @column, @having ！\");\n\t\t}\n\t\tif (value == null) {\n\t\t\treturn \"\";\n\t\t}\n\t\tif (value instanceof Subquery == false) {\n\t\t\tthrow new IllegalArgumentException(key + \":subquery 类型为\" + value.getClass().getSimpleName()\n\t\t\t\t\t+ \"！subquery 只能是 子查询JSONObejct！\");\n\t\t}\n\n\t\tLogic logic = new Logic(column);\n\t\tcolumn = logic.getKey();\n\t\tLog.i(TAG, \"getExistsString column = \" + column);\n\n\t\treturn (logic.isNot() ? NOT : \"\") + \" EXISTS \" + gainSubqueryString((Subquery) value);\n\t}\n\t//}{ exists >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>\n\n\t//<> contain <<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<\n\t/**WHERE key contains value\n\t * @param key\n\t * @param value\n\t * @return\t{@link #gainContainString(String, String, Object[], int)}\n\t * @throws NotExistException\n\t */\n\tpublic String gainContainString(String key, String column, Object value, String rawSQL) throws IllegalArgumentException {\n\t\tif (rawSQL != null) {\n\t\t\tthrow new UnsupportedOperationException(\"@raw:value 中 \" + key + \" 不合法！@raw 不支持 key<> 这种功能符 ！\" +\n\t\t\t\t\t\"只支持 key, key!, key<, key{} 等比较运算 和 @column, @having ！\");\n\t\t}\n\n\t\tLogic logic = new Logic(column);\n\t\tcolumn = logic.getKey();\n\t\tLog.i(TAG, \"getContainString column = \" + column);\n\n\t\treturn gainContainString(key, column, newJSONArray(value).toArray(), logic.getType());\n\t}\n\t/**WHERE key contains childs TODO 支持 key<>: { \"path\":\"$[0].name\", \"value\": 82001 }\n\t * 或者 key<$[0].name>:82001 或者 key$[0].name<>:82001 ？ 还是前者好，key 一旦复杂了，\n\t * 包含 , ; : / [] 等就容易和 @combine 其它功能等冲突\n\t * @param key\n\t * @param childs null ? \"\" : (empty ? no child : contains childs)\n\t * @param type |, &, !\n\t * @return LOGIC [ ( key LIKE '[\" + childs[i] + \"]' OR key LIKE '[\" + childs[i] + \", %'\n\t * OR key LIKE '%, \" + childs[i] + \", %' OR key LIKE '%, \" + childs[i] + \"]' ) ]\n\t * @throws IllegalArgumentException\n\t */\n\tpublic String gainContainString(String key, String column, Object[] childs, int type) throws IllegalArgumentException {\n\t\tboolean not = Logic.isNot(type);\n\t\tString condition = \"\";\n\t\tif (childs != null) {\n\t\t\tfor (int i = 0; i < childs.length; i++) {\n\t\t\t\tObject c = childs[i];\n\t\t\t\tif (c instanceof Collection) {\n\t\t\t\t\tthrow new IllegalArgumentException(key + \":value 中 value 类型不能为 [JSONList, Collection] 中的任何一个 ！\");\n\t\t\t\t}\n\n\t\t\t\tObject path = \"\";\n\t\t\t\tif (c instanceof Map) {\n\t\t\t\t\tpath = ((Map) c).get(\"path\");\n\t\t\t\t\tif (path != null && path instanceof String == false) {\n\t\t\t\t\t\tthrow new IllegalArgumentException(key + \":{ path:path, value:value } 中 path 类型错误，\" +\n\t\t\t\t\t\t\t\t\"只能是 $, $.key1, $[0].key2 等符合 SQL 中 JSON 路径的 String ！\");\n\t\t\t\t\t}\n\n\t\t\t\t\tc = ((Map) c).get(\"value\");\n\t\t\t\t\tif (c instanceof Collection || c instanceof Map) {\n\t\t\t\t\t\tthrow new IllegalArgumentException(key + \":{ path:path, value:value } 中 value 类型\" +\n\t\t\t\t\t\t\t\t\"不能为 [JSONMap, JSONList, Collection, Map] 中的任何一个 ！\");\n\t\t\t\t\t}\n\t\t\t\t}\n\n\t\t\t\tcondition += (i <= 0 ? \"\" : (Logic.isAnd(type) ? AND : OR));\n\t\t\t\tif (isPSQL()) {\n\t\t\t\t\tcondition += (gainKey(column) + \" @> \" + gainValue(key, column, newJSONArray(c)));\n\t\t\t\t\t// operator does not exist: jsonb @> character varying \"[\" + c + \"]\");\n\t\t\t\t}\n\t\t\t\telse if (isOracle() || isDameng() || isKingBase()) {\n\t\t\t\t\tcondition += (\"json_textcontains(\" + gainKey(column) + \", \" + (StringUtil.isEmpty(path, true)\n\t\t\t\t\t\t\t? \"'$'\" : gainValue(key, column, path)) + \", \" + gainValue(key, column, c == null ? null : c.toString()) + \")\");\n\t\t\t\t}\n\t\t\t\telse if (isPresto() || isTrino()) {\n\t\t\t\t\tcondition += (\"json_array_contains(cast(\" + gainKey(column) + \" AS VARCHAR), \"\n\t\t\t\t\t\t\t+ gainValue(key, column, c) + (StringUtil.isEmpty(path, true)\n\t\t\t\t\t\t\t? \"\" : \", \" + gainValue(key, column, path)) + \")\");\n\t\t\t\t}\n\t\t\t\telse {\n\t\t\t\t\tString v = c == null ? \"null\" : (c instanceof Boolean || c instanceof Number ? c.toString() : \"\\\"\" + c + \"\\\"\");\n\t\t\t\t\tif (isClickHouse()) {\n\t\t\t\t\t\tcondition += (condition + \"has(JSONExtractArrayRaw(assumeNotNull(\" + gainKey(column) + \"))\"\n\t\t\t\t\t\t\t\t+ \", \" + gainValue(key, column, v) + (StringUtil.isEmpty(path, true)\n\t\t\t\t\t\t\t\t? \"\" : \", \" + gainValue(key, column, path)) + \")\");\n\t\t\t\t\t}\n\t\t\t\t\telse {\n\t\t\t\t\t\tcondition += (\"json_contains(\" + gainKey(column) + \", \" + gainValue(key, column, v)\n\t\t\t\t\t\t\t\t+ (StringUtil.isEmpty(path, true) ? \"\" : \", \" + gainValue(key, column, path)) + \")\");\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t}\n\n\t\t\tif (condition.isEmpty()) {\n\t\t\t\tcondition = gainKey(column) + SQL.isNull(true) + OR + gainLikeString(key, column, \"[]\"); // key = '[]' 无结果！\n\t\t\t}\n\t\t\telse {\n\t\t\t\tcondition = gainKey(column) + SQL.isNull(false) + AND + \"(\" + condition + \")\";\n\t\t\t}\n\t\t}\n\n\t\tif (condition.isEmpty()) {\n\t\t\treturn \"\";\n\t\t}\n\t\treturn gainCondition(not, condition);\n\t}\n\t//<> contain >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>\n\n\n\n\t//key@:{} Subquery <<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<\n\n\tpublic List getWithAsExprSQLList() {\n\t\treturn withAsExprSQLList;\n\t}\n\tprivate void clearWithAsExprListIfNeed() {\n\t\t// mysql8版本以上,子查询支持with as表达式\n\t\tif(this.isMySQL() && this.gainDBVersionNums()[0] >= 8) {\n\t\t\tthis.withAsExprSQLList = new ArrayList<>();\n\t\t}\n\t}\n\n\t@Override\n\tpublic List getWithAsExprPreparedValueList() {\n\t\treturn this.withAsExprPreparedValueList;\n\t}\n\n\t@Override\n\tpublic AbstractSQLConfig setWithAsExprPreparedValueList(List list) {\n\t\tthis.withAsExprPreparedValueList = list;\n\t\treturn this;\n\t}\n\n\t/**\n\t * 只要 method != RequestMethod.POST 就都支持 with-as表达式\n\t * @param cfg\n\t * @param subquery\n\t * @return\n\t * @throws Exception\n\t */\n\tprivate String withAsExprSubqueryString(SQLConfig cfg, Subquery subquery) throws Exception {\n\t\tboolean isWithAsEnable = isWithAsEnable();\n\t\tList list = isWithAsEnable ? getWithAsExprSQLList() : null;\n\t\tif (cfg.getMethod() != RequestMethod.POST && list == null) {\n\t\t\tclearWithAsExprListIfNeed();\n\t\t}\n\n\t\tString quote = getQuote();\n\t\tString as = gainAs();\n\n\t\tString withAsExpreSql;\n\t\tif (list != null) {\n\t\t\tString withQuoteName = quote + subquery.gainKey() + quote;\n\t\t\tlist.add(\" \" + withQuoteName + as + \"(\" + cfg.gainSQL(isPrepared()) + \") \");\n\t\t\twithAsExpreSql = \" SELECT * FROM \" + withQuoteName;\n\n\t\t\t// 预编译参数 FIXME 这里重复添加了，导致子查询都报错参数超过 ? 数量 Parameter index out of range (5 > number of parameters, which is 4)\n\t\t\tList subPvl = cfg.getPreparedValueList();\n\t\t\tif (subPvl != null && subPvl.isEmpty() == false) {\n\t\t\t\tList valueList = getWithAsExprPreparedValueList();\n\t\t\t\tif (valueList == null) {\n\t\t\t\t\tvalueList = new ArrayList<>();\n\t\t\t\t}\n\t\t\t\tvalueList.addAll(subPvl);\n\t\t\t\tsetWithAsExprPreparedValueList(valueList);\n\n\t\t\t\tcfg.setPreparedValueList(new ArrayList<>());\n\t\t\t}\n\t\t} else {\n\t\t\twithAsExpreSql = cfg.gainSQL(isPrepared());\n\t\t\t// mysql 才存在这个问题, 主表和子表是一张表\n\t\t\tif (isWithAsEnable && isMySQL() && StringUtil.equals(getTable(), subquery.gainFrom())) {\n\t\t\t\twithAsExpreSql = \" SELECT * FROM (\" + withAsExpreSql + \")\" + as + quote + subquery.gainKey() + quote;\n\t\t\t}\n\t\t}\n\n\t\treturn withAsExpreSql;\n\t}\n\n\t@Override\n\tpublic String gainSubqueryString(Subquery subquery) throws Exception {\n\t\tif (subquery == null) {\n\t\t\treturn \"\";\n\t\t}\n\n\t\tString range = subquery.gainRange();\n\t\tSQLConfig cfg = subquery.gainConfig();\n\n\t\t// 子查询 = 主语句 datasource\n\t\tif (StringUtil.equals(this.getTable(), subquery.gainFrom()) == false && cfg.hasJoin() == false) {\n\t\t\tcfg.setDatasource(this.getDatasource());\n\t\t}\n\t\tcfg.setPreparedValueList(new ArrayList<>());\n\t\tString withAsExprSql = withAsExprSubqueryString(cfg, subquery);\n\t\tString sql = (range == null || range.isEmpty() ? \"\" : range) + \"(\" + withAsExprSql + \") \";\n\n\t\t//// SELECT .. FROM(SELECT ..) .. WHERE .. 格式需要把子查询中的预编译值提前\n\t\t//// 如果外查询 SELECT concat(`name`,?) 这种 SELECT 里也有预编译值，那就不能这样简单反向\n\t\t//List subPvl = cfg.getPreparedValueList();\n\t\t//if (subPvl != null && subPvl.isEmpty() == false) {\n\t\t// List pvl = getPreparedValueList();\n\t\t//\n\t\t// if (pvl != null && pvl.isEmpty() == false) {\n\t\t// subPvl.addAll(pvl);\n\t\t// }\n\t\t// setPreparedValueList(subPvl);\n\t\t//}\n\n\t\tList subPvl = cfg.getPreparedValueList();\n\t\tif (subPvl != null && subPvl.isEmpty() == false) {\n\t\t\tList pvl = getPreparedValueList();\n\n\t\t\tif (pvl == null || pvl.isEmpty()) {\n\t\t\t\tpvl = subPvl;\n\t\t\t}\n\t\t\telse {\n\t\t\t\tpvl.addAll(subPvl);\n\t\t\t}\n\n\t\t\tsetPreparedValueList(pvl);\n\t\t}\n\n\t\treturn sql;\n\t}\n\n\t//key@:{} Subquery >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>\n\n\n\n\t/**拼接条件\n\t * @param not\n\t * @param condition\n\t * @return\n\t */\n\tpublic static String gainCondition(boolean not, String condition) {\n\t\treturn gainCondition(not, condition, false);\n\t}\n\t/**拼接条件\n\t * @param not\n\t * @param condition\n\t * @param addOuterBracket\n\t * @return\n\t */\n\tpublic static String gainCondition(boolean not, String condition, boolean addOuterBracket) {\n\t\tString s = not ? NOT + \"(\" + condition + \")\" : condition;\n\t\treturn addOuterBracket ? \"( \" + s + \" )\" : s;\n\t}\n\n\n\t/**转为JSONArray\n\t * @param obj\n\t * @return\n\t */\n\t@NotNull\n\tpublic static > L newJSONArray(Object obj) {\n\t\tL array = JSON.createJSONArray();\n\t\tif (obj != null) {\n\t\t\tif (obj instanceof Collection) {\n\t\t\t\tarray.addAll((Collection) obj);\n\t\t\t} else {\n\t\t\t\tarray.add(obj);\n\t\t\t}\n\t\t}\n\t\treturn array;\n\t}\n\n\t//WHERE >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>\n\n\n\t//SET <<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<\n\t/**获取SET\n\t * @return\n\t * @throws Exception\n\t */\n\tpublic String gainSetString() throws Exception {\n\t\treturn gainSetString(getMethod(), getContent(), ! isTest());\n\t}\n\t//CS304 Issue link: https://github.com/Tencent/APIJSON/issues/48\n\t/**获取SET\n\t * @param method -the method used\n\t * @param content -the content map\n\t * @return\n\t * @throws Exception\n\t *

use entrySet+getValue() to replace keySet+get() to enhance efficiency

\n\t */\n\tpublic String gainSetString(RequestMethod method, Map content, boolean verifyName) throws Exception {\n\t\tSet set = content == null ? null : content.keySet();\n\t\tString setString = \"\";\n\n\t\tif (set != null && set.size() > 0) {\n\t\t\tboolean isFirst = true;\n\t\t\tint keyType;// 0 - =; 1 - +, 2 - -\n\t\t\tObject value;\n\n\t\t\tString idKey = getIdKey();\n\t\t\tfor (Entry entry : content.entrySet()) {\n\t\t\t\tString key = entry.getKey();\n\t\t\t\t//避免筛选到全部\tvalue = key == null ? null : content.get(key);\n\t\t\t\tif (key == null || idKey.equals(key)) {\n\t\t\t\t\tcontinue;\n\t\t\t\t}\n\n\t\t\t\tif (key.endsWith(\"+\")) {\n\t\t\t\t\tkeyType = 1;\n\t\t\t\t} else if (key.endsWith(\"-\")) {\n\t\t\t\t\tkeyType = 2;\n\t\t\t\t} else {\n\t\t\t\t\tkeyType = 0; //注意重置类型，不然不该加减的字段会跟着加减\n\t\t\t\t}\n\t\t\t\tvalue = entry.getValue();\n\t\t\t\tString column = gainRealKey(method, key, false, true, verifyName);\n\n\t\t\t\tsetString += (isFirst ? \"\" : \", \") + (gainKey(column) + \" = \"\n\t\t\t\t\t\t+ (keyType == 1 ? gainAddString(key, column, value) : (keyType == 2\n\t\t\t\t\t\t? gainRemoveString(key, column, value) : gainValue(key, column, value)) )\n\t\t\t\t);\n\n\t\t\t\tisFirst = false;\n\t\t\t}\n\t\t}\n\n\t\tif (setString.isEmpty()) {\n\t\t\tthrow new IllegalArgumentException(\"PUT 请求必须在Table内设置要修改的 key:value ！\");\n\t\t}\n\t\treturn (isClickHouse() ? \" \" : \" SET \") + setString;\n\t}\n\n\t/**SET key = concat(key, 'value')\n\t * @param key\n\t * @param value\n\t * @return concat(key, 'value')\n\t * @throws IllegalArgumentException\n\t */\n\tpublic String gainAddString(String key, String column, Object value) throws IllegalArgumentException {\n\t\tif (value instanceof Number) {\n\t\t\treturn gainKey(column) + \" + \" + value;\n\t\t}\n\t\tif (value instanceof String) {\n\t\t\treturn SQL.concat(gainKey(column), (String) gainValue(key, column, value));\n\t\t}\n\t\tthrow new IllegalArgumentException(key + \":value 中 value 类型错误，必须是 Number,String,Array 中的任何一种！\");\n\t}\n\t/**SET key = replace(key, 'value', '')\n\t * @param key\n\t * @param value\n\t * @return REPLACE (key, 'value', '')\n\t * @throws IllegalArgumentException\n\t */\n\tpublic String gainRemoveString(String key, String column, Object value) throws IllegalArgumentException {\n\t\tif (value instanceof Number) {\n\t\t\treturn gainKey(column) + \" - \" + value;\n\t\t}\n\t\tif (value instanceof String) {\n\t\t\treturn SQL.replace(gainKey(column), (String) gainValue(key, column, value), \"''\");\n\t\t\t// \" replace(\" + column + \", '\" + value + \"', '') \";\n\t\t}\n\t\tthrow new IllegalArgumentException(key + \":value 中 value 类型错误，必须是 Number,String,Array 中的任何一种！\");\n\t}\n\t//SET >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>\n\n\t@Override\n\tpublic boolean isFakeDelete() {\n\t\treturn false;\n\t}\n\n\t@Override\n\tpublic Map onFakeDelete(Map map) {\n\t\treturn map;\n\t}\n\n\t/**\n\t * @return\n\t * @throws Exception\n\t */\n\t@Override\n\tpublic String gainSQL(boolean prepared) throws Exception {\n\t\tboolean isPrepared = isPrepared();\n\t\tif (isPrepared == prepared) {\n\t\t\treturn gainSQL(this);\n\t\t}\n\n\t\tString sql = gainSQL(this.setPrepared(prepared));\n\t\tsetPrepared(isPrepared);\n\t\treturn sql;\n\t}\n\t/**\n\t * @param config\n\t * @return\n\t * @throws Exception\n\t */\n\tpublic static , L extends List> String gainSQL(AbstractSQLConfig config) throws Exception {\n\t\tif (config == null) {\n\t\t\tLog.i(TAG, \"getSQL config == null >> return null;\");\n\t\t\treturn null;\n\t\t}\n\n\t\t// TODO procedure 改为 List procedureList; behind : true; function: callFunction(); String key; ...\n\t\t// for (...) { Call procedure1();\\n SQL \\n; Call procedure2(); ... }\n\t\t// 貌似不需要，因为 ObjectParser 里就已经处理的顺序等，只是这里要解决下 Schema 问题。\n\n\t\tString procedure = config.getProcedure();\n\t\tif (StringUtil.isNotEmpty(procedure, true)) {\n\t\t\tint ind = procedure.indexOf(\".\");\n\t\t\tboolean hasPrefix = ind >= 0 && ind < procedure.indexOf(\"(\");\n\t\t\tString sch = hasPrefix ? AbstractFunctionParser.extractSchema(\n\t\t\t\t\tprocedure.substring(0, ind), config.getTable()\n\t\t\t) : config.gainSQLSchema();\n\n\t\t\tString q = config.getQuote();\n\t\t\treturn \"CALL \" + q + sch + q + \".\" + (hasPrefix ? procedure.substring(ind + 1) : procedure);\n\t\t}\n\n\t\tString tablePath = config.gainTablePath();\n\t\tif (StringUtil.isEmpty(tablePath, true)) {\n\t\t\tLog.i(TAG, \"getSQL StringUtil.isEmpty(tablePath, true) >> return null;\");\n\t\t\treturn null;\n\t\t}\n\n\t\t// 解决重复添加导致报错：Parameter index out of range (6 > number of parameters, which is 5)\n\t\tconfig.setPreparedValueList(new ArrayList<>());\n\t\tRequestMethod method = config.getMethod();\n\t\tif (method == null) {\n\t\t\tmethod = GET;\n\t\t}\n\n\t\tString cSql = null;\n\t\tswitch (method) {\n\t\t\tcase POST:\n\t\t\t\treturn \"INSERT INTO \" + tablePath + config.gainColumnString() + \" VALUES\" + config.getValuesString();\n\t\t\tcase PUT:\n\t\t\t\tif(config.isClickHouse()){\n\t\t\t\t\treturn \"ALTER TABLE \" + tablePath + \" UPDATE\" + config.gainSetString() + config.gainWhereString(true);\n\t\t\t\t}\n\t\t\t\tcSql = \"UPDATE \" + tablePath + config.gainSetString() + config.gainWhereString(true)\n\t\t\t\t\t\t+ (config.isMySQL() ? config.gainLimitString() : \"\");\n\t\t\t\tcSql = buildWithAsExprSql(config, cSql);\n\t\t\t\treturn cSql;\n\t\t\tcase DELETE:\n\t\t\t\tif(config.isClickHouse()){\n\t\t\t\t\treturn \"ALTER TABLE \" + tablePath + \" DELETE\" + config.gainWhereString(true);\n\t\t\t\t}\n\t\t\t\tcSql = \"DELETE FROM \" + tablePath + config.gainWhereString(true)\n\t\t\t\t\t\t+ (config.isMySQL() ? config.gainLimitString() : \"\"); // PostgreSQL 不允许 LIMIT\n\t\t\t\tcSql = buildWithAsExprSql(config, cSql);\n\t\t\t\treturn cSql;\n\t\t\tdefault:\n\t\t\t\tString explain = config.isExplain() ? (config.isSQLServer() ? \"SET STATISTICS PROFILE ON \"\n\t\t\t\t\t\t: (config.isOracle() || config.isDameng() || config.isKingBase() ? \"EXPLAIN PLAN FOR \" : \"EXPLAIN \")) : \"\";\n\t\t\t\tif (config.isTest() && RequestMethod.isGetMethod(config.getMethod(), true)) { // FIXME 为啥是 code 而不是 count ？\n\t\t\t\t\tString q = config.getQuote(); // 生成 SELECT ( (24 >=0 AND 24 <3) ) AS `code` LIMIT 1 OFFSET 0\n\t\t\t\t\treturn explain + \"SELECT \" + config.gainWhereString(false)\n\t\t\t\t\t\t\t+ config.gainAs() + q + JSONResponse.KEY_COUNT + q + config.gainLimitString();\n\t\t\t\t}\n\n\t\t\t\tconfig.setPreparedValueList(new ArrayList());\n\t\t\t\tString column = config.gainColumnString();\n\t\t\t\tif (config.isOracle() || config.isDameng() || config.isKingBase()) {\n\t\t\t\t\t//When config's database is oracle,Using subquery since Oracle12 below does not support OFFSET FETCH paging syntax.\n\t\t\t\t\t//针对oracle分组后条数的统计\n\t\t\t\t\tif (StringUtil.isNotEmpty(config.getGroup(),true) && RequestMethod.isHeadMethod(config.getMethod(), true)){\n\t\t\t\t\t\treturn explain + \"SELECT count(*) FROM (SELECT \" + (config.getCache() == JSONMap.CACHE_RAM\n\t\t\t\t\t\t\t\t? \"SQL_NO_CACHE \" : \"\") + column + \" FROM \" + gainConditionString(tablePath, config) + \") \" + config.gainLimitString();\n\t\t\t\t\t}\n\n\t\t\t\t\tString sql = \"SELECT \" + (config.getCache() == JSONMap.CACHE_RAM\n\t\t\t\t\t\t\t? \"SQL_NO_CACHE \" : \"\") + column + \" FROM \" + gainConditionString(tablePath, config);\n\t\t\t\t\treturn explain + config.gainOraclePageSQL(sql);\n\t\t\t\t}\n\n\t\t\t\tcSql = \"SELECT \" + (config.getCache() == JSONMap.CACHE_RAM ? \"SQL_NO_CACHE \" : \"\")\n\t\t\t\t\t\t+ column + \" FROM \" + gainConditionString(tablePath, config) + config.gainLimitString();\n\t\t\t\tcSql = buildWithAsExprSql(config, cSql);\n\t\t\t\tif(config.isElasticsearch()) { // elasticSearch 不支持 explain\n\t\t\t\t\treturn cSql;\n\t\t\t\t}\n\t\t\t\treturn explain + cSql;\n\t\t}\n\t}\n\n\tprivate static , L extends List> String buildWithAsExprSql(@NotNull AbstractSQLConfig config, String cSql) throws Exception {\n\t\tif (config.isWithAsEnable() == false) {\n\t\t\treturn cSql;\n\t\t}\n\n\t\tList list = config.getWithAsExprSQLList();\n\t\tint size = list == null ? 0 : list.size();\n\t\tif (size > 0) {\n\t\t\tString withAsExpreSql = \"WITH \";\n\t\t\tfor (int i = 0; i < size; i++) {\n\t\t\t\twithAsExpreSql += (i <= 0 ? \"\" : \",\") + list.get(i) + \"\\n\";\n\t\t\t}\n\t\t\tcSql = withAsExpreSql + cSql;\n\t\t\tconfig.clearWithAsExprListIfNeed();\n\t\t}\n\t\treturn cSql;\n\t}\n\n\t@Override\n\tpublic boolean isWithAsEnable() {\n\t\treturn ENABLE_WITH_AS && (isMySQL() == false || gainDBVersionNums()[0] >= 8);\n\t}\n\n\t/**Oracle的分页获取\n\t * @param sql\n\t * @return\n\t */\n\tprotected String gainOraclePageSQL(String sql) {\n\t\tint count = getCount();\n\t\tif (count <= 0 || RequestMethod.isHeadMethod(getMethod(), true)) { // TODO HEAD 真的不需要 LIMIT ？\n\t\t\treturn sql;\n\t\t}\n\t\tint offset = getOffset(getPage(), count);\n\t\tString quote = getQuote();\n\t\tString alias = quote + gainSQLAlias() + quote;\n\t\treturn \"SELECT * FROM (SELECT \" + alias + \".*, ROWNUM \"+ quote + \"RN\" + quote +\" FROM (\" + sql + \") \" + alias\n\t\t\t\t+ \" WHERE ROWNUM <= \" + (offset + count) + \") WHERE \"+ quote + \"RN\" + quote +\" > \" + offset;\n\t}\n\n\t/**获取条件SQL字符串\n\t * @param table\n\t * @param config\n\t * @return\n\t * @throws Exception\n\t */\n\tprivate static , L extends List> String gainConditionString(\n\t\t\tString table, AbstractSQLConfig config) throws Exception {\n\t\tSubquery from = config.getFrom();\n\t\tif (from != null) {\n\t\t\ttable = config.gainSubqueryString(from) + config.gainAs() + config.gainSQLAliasWithQuote() + \" \";\n\t\t}\n\n\t\tString join = config.gainJoinString();\n\n\t\tString where = config.gainWhereString(true);\n\n\t\t//根据方法不同，聚合语句不同。GROUP BY 和 HAVING 可以加在 HEAD 上, HAVING 可以加在 PUT, DELETE 上，GET 全加，POST 全都不加\n\t\tString aggregation;\n\t\tif (RequestMethod.isGetMethod(config.getMethod(), true)) {\n\t\t\taggregation = config.gainGroupString(true) + config.gainHavingString(true)\n\t\t\t\t\t+ config.gainSampleString(true) + config.gainLatestString(true)\n\t\t\t\t\t+ config.gainPartitionString(true) + config.gainFillString(true)\n\t\t\t\t\t+ config.gainOrderString(true);\n\t\t}\n\t\telse if (RequestMethod.isHeadMethod(config.getMethod(), true)) {\n\t\t\t// TODO 加参数 isPagenation 判断是 GET 内分页 query:2 查总数，不用加这些条件\n\t\t\taggregation = config.gainGroupString(true) + config.gainHavingString(true)\n\t\t\t\t\t+ config.gainSampleString(true) + config.gainLatestString(true)\n\t\t\t\t\t+ config.gainPartitionString(true) + config.gainFillString(true);\n\t\t}\n\t\telse if (config.getMethod() == PUT || config.getMethod() == DELETE) {\n\t\t\taggregation = config.gainHavingString(true) ;\n\t\t}\n\t\telse {\n\t\t\taggregation = \"\";\n\t\t}\n\n\t\tString condition = table + join + where + aggregation;\n\t\t; //+ config.getLimitString();\n\n\t\t//no need to optimize\n\t\t//\t\tif (config.getPage() <= 0 || ID.equals(column.trim())) {\n\t\treturn condition; // config.isOracle() ? condition : condition + config.getLimitString();\n\t\t//\t\t}\n\t\t//\n\t\t//\n\t\t//\t\t//order: id+ -> id >= idOfStartIndex; id- -> id <= idOfStartIndex <<<<<<<<<<<<<<<<<<<\n\t\t//\t\tString order = StringUtil.getNoBlankString(config.getOrder());\n\t\t//\t\tList orderList = order.isEmpty() ? null : Arrays.asList(StringUtil.split(order));\n\t\t//\n\t\t//\t\tint type = 0;\n\t\t//\t\tif (BaseModel.isEmpty(orderList) || BaseModel.isContain(orderList, ID+\"+\")) {\n\t\t//\t\t\ttype = 1;\n\t\t//\t\t}\n\t\t//\t\telse if (BaseModel.isContain(orderList, ID+\"-\")) {\n\t\t//\t\t\ttype = 2;\n\t\t//\t\t}\n\t\t//\n\t\t//\t\tif (type > 0) {\n\t\t//\t\t\treturn condition.replace(\"WHERE\",\n\t\t//\t\t\t\t\t\"WHERE id \" + (type == 1 ? \">=\" : \"<=\") + \" (SELECT id FROM \" + table\n\t\t//\t\t\t\t\t+ where + \" ORDER BY id \" + (type == 1 ? \"ASC\" : \"DESC\") + \" LIMIT \" + config.getOffset() + \", 1) AND\"\n\t\t//\t\t\t\t\t)\n\t\t//\t\t\t\t\t+ \" LIMIT \" + config.getCount(); //子查询起始id不一定准确，只能作为最小可能！ ;//\n\t\t//\t\t}\n\t\t//\t\t//order: id+ -> id >= idOfStartIndex; id- -> id <= idOfStartIndex >>>>>>>>>>>>>>>>>>\n\t\t//\n\t\t//\n\t\t//\t\t//结果错误！SELECT * FROM User AS t0 INNER JOIN\n\t\t// (SELECT id FROM User ORDER BY date ASC LIMIT 20, 10) AS t1 ON t0.id = t1.id\n\t\t//\t\t//common case, inner join\n\t\t//\t\tcondition += config.getLimitString();\n\t\t//\t\treturn table + \" AS t0 INNER JOIN (SELECT id FROM \" + condition + \") AS t1 ON t0.id = t1.id\";\n\t}\n\n\n\tprivate boolean keyPrefix;\n\t@Override\n\tpublic boolean isKeyPrefix() {\n\t\treturn keyPrefix;\n\t}\n\t@Override\n\tpublic AbstractSQLConfig setKeyPrefix(boolean keyPrefix) {\n\t\tthis.keyPrefix = keyPrefix;\n\t\treturn this;\n\t}\n\n\n\tpublic String gainJoinString() throws Exception {\n\t\tString joinOns = \"\";\n\n\t\tif (joinList != null) {\n\t\t\tString quote = getQuote();\n\t\t\tList pvl = getPreparedValueList(); // new ArrayList<>();\n\t\t\t//boolean changed = false;\n\n\t\t\t// 主表不用别名\t\t\tString ta;\n\t\t\tfor (Join j : joinList) {\n\t\t\t\tonGainJoinString(j);\n\n\t\t\t\tif (j.isAppJoin()) { // APP JOIN，只是作为一个标记，执行完主表的查询后自动执行副表的查询 User.id IN($commentIdList)\n\t\t\t\t\tcontinue;\n\t\t\t\t}\n\t\t\t\tString type = j.getJoinType();\n\n\t\t\t\t//LEFT JOIN sys.apijson_user AS User ON User.id = Moment.userId， 都是用 = ，通过relateType处理缓存\n\t\t\t\t// <\"INNER JOIN User ON User.id = Moment.userId\", UserConfig> TODO AS 放 getSQLTable 内\n\t\t\t\tSQLConfig jc = j.getJoinConfig();\n\t\t\t\tjc.setPrepared(isPrepared());\n\t\t\t\t// 将关联表所属数据源配置为主表数据源\n\t\t\t\tjc.setDatasource(this.getDatasource());\n\t\t\t\tString jt = jc.gainSQLAlias();\n\t\t\t\tList onList = j.getOnList();\n\n\t\t\t\t//如果要强制小写，则可在子类重写这个方法再 toLowerCase\n\t\t\t\t//\t\t\t\tif (DATABASE_POSTGRESQL.equals(getDatabase())) {\n\t\t\t\t//\t\t\t\t\tjt = jt.toLowerCase();\n\t\t\t\t//\t\t\t\t\ttn = tn.toLowerCase();\n\t\t\t\t//\t\t\t\t}\n\n\t\t\t\tString sql;\n\n\t\t\t\tswitch (type) {\n\t\t\t\t//前面已跳过\t\t\t\tcase \"@\": // APP JOIN\n\t\t\t\t//\t\t\t\t\tcontinue;\n\n\t\t\t\tcase \"*\": // CROSS JOIN\n\t\t\t\t\tonGainCrossJoinString(j);\n\t\t\t\tcase \"<\": // LEFT JOIN\n\t\t\t\tcase \">\": // RIGHT JOIN\n\t\t\t\t\tjc.setMain(true).setKeyPrefix(false);\n\t\t\t\t\tsql = ( \"<\".equals(type) ? \" LEFT\" : (\">\".equals(type) ? \" RIGHT\" : \" CROSS\") )\n\t\t\t\t\t\t\t+ \" JOIN ( \" + jc.gainSQL(isPrepared()) + \" ) \" + gainAs() + quote + jt + quote;\n\t\t\t\t\tsql = concatJoinOn(sql, quote, j, jt, onList);\n\n\t\t\t\t\tjc.setMain(false).setKeyPrefix(true);\n\n\t\t\t\t\tpvl.addAll(jc.getPreparedValueList());\n\t\t\t\t\t//changed = true;\n\t\t\t\t\tbreak;\n\n\t\t\t\tcase \"&\": // INNER JOIN: A & B\n\t\t\t\tcase \"\": // FULL JOIN: A | B\n\t\t\t\tcase \"|\": // FULL JOIN: A | B\n\t\t\t\tcase \"!\": // OUTER JOIN: ! (A | B)\n\t\t\t\tcase \"^\": // SIDE JOIN: ! (A & B)\n\t\t\t\tcase \"(\": // ANTI JOIN: A & ! B\n\t\t\t\tcase \")\": // FOREIGN JOIN: B & ! A\n\t\t\t\t\tsql = \" INNER JOIN \" + jc.gainTablePath();\n\t\t\t\t\tsql = concatJoinOn(sql, quote, j, jt, onList);\n\t\t\t\t\tbreak;\n\t\t\t\tcase \"~\": // ASOF JOIN: B ~= A\n\t\t\t\t\tsql = \" ASOF JOIN \" + jc.gainTablePath();\n\t\t\t\t\tsql = concatJoinOn(sql, quote, j, jt, onList);\n\t\t\t\t\tbreak;\n\t\t\t\tdefault:\n\t\t\t\t\tString k = jc.gainTableKey();\n\t\t\t\t\tthrow new UnsupportedOperationException(\n\t\t\t\t\t\t\t\"join:value 中 value 里的 \" + k + \"/\" + j.getPath()\n\t\t\t\t\t\t\t+ \"错误！不支持 \" + k + \" 等 [ @ APP, < LEFT, > RIGHT, * CROSS\"\n\t\t\t\t\t\t\t+ \", & INNER, | FULL, ! OUTER, ^ SIDE, ( ANTI, ) FOREIGN, ~ ASOF ] 之外的 JOIN 类型 !\"\n\t\t\t\t\t\t\t);\n\t\t\t\t}\n\n\t\t\t\tSQLConfig oc = j.getOnConfig();\n\t\t\t\tString ow = null;\n\t\t\t\tif (oc != null) {\n\t\t\t\t\toc.setPrepared(isPrepared());\n\t\t\t\t\toc.setPreparedValueList(new ArrayList<>());\n\t\t\t\t\toc.setMain(false).setKeyPrefix(true);\n\t\t\t\t\tow = oc.gainWhereString(false);\n\n\t\t\t\t\tpvl.addAll(oc.getPreparedValueList());\n\t\t\t\t\t//changed = true;\n\t\t\t\t}\n\n\t\t\t\tjoinOns += \" \\n \" + sql + (StringUtil.isEmpty(ow, true) ? \"\" : \" AND ( \" + ow + \" ) \");\n\t\t\t}\n\n\n\t\t\t//if (changed) {\n\t\t\t// List opvl = getPreparedValueList();\n\t\t\t// if (opvl != null && opvl.isEmpty() == false) {\n\t\t\t// pvl.addAll(opvl);\n\t\t\t// }\n\t\t\t\tsetPreparedValueList(pvl);\n\t\t\t//}\n\n\t\t}\n\n\t\treturn StringUtil.isEmpty(joinOns, true) ? \"\" : joinOns + \" \\n\";\n\t}\n\n\tprotected String concatJoinOn(@NotNull String sql, @NotNull String quote, @NotNull Join join, @NotNull String jt, List onList) {\n\t\tif (onList != null) {\n\t\t\tSQLConfig jc = join.getJoinConfig();\n\t\t\tMap castMap = jc == null ? null : jc.getCast();\n\n\t\t\tboolean first = true;\n\t\t\tfor (On on : onList) {\n\t\t\t\tLogic logic = on.getLogic();\n\t\t\t\tboolean isNot = logic == null ? false : logic.isNot();\n\t\t\t\tif (isNot) {\n\t\t\t\t\tonJoinNotRelation(sql, quote, join, jt, onList, on);\n\t\t\t\t}\n\n\t\t\t\tString lk = quote + jt + quote + \".\" + quote + on.getKey() + quote;\n\t\t\t\tObject ct = castMap == null ? null : castMap.get(on.getOriginKey());\n\t\t\t\tif (StringUtil.isNotEmpty(ct, false)) {\n\t\t\t\t\tlk = \"cast(\" + lk + \" AS \" + ct + \")\"; // 解决 JOIN ON 不支持 @cast 问题，CAST(expression AS TYPE) 中 AS 不能省略\n\t\t\t\t}\n\n\t\t\t\tString rt = on.getRelateType();\n\n\t\t\t\tString rk = quote + SQLConfig.gainSQLAlias(on.getTargetTable(), on.getTargetAlias()) + quote + \".\" + quote + on.getTargetKey() + quote;\n\n\t\t\t\tif (StringUtil.isEmpty(rt, false)) {\n\t\t\t\t\tsql += (first ? ON : AND) + lk + (isNot ? \" != \" : \" = \") + rk;\n\t\t\t\t}\n\t\t\t\telse {\n\t\t\t\t\tonJoinComplexRelation(sql, quote, join, jt, onList, on);\n\n\t\t\t\t\tif (\">=\".equals(rt) || \"<=\".equals(rt) || \">\".equals(rt) || \"<\".equals(rt)) {\n\t\t\t\t\t\tif (isNot) {\n\t\t\t\t\t\t\tthrow new IllegalArgumentException(\"join:value 中 value 里的 \" + jt + \"/\" + join.getPath()\n\t\t\t\t\t\t\t+ \" 中 JOIN ON 条件关联逻辑符 \" + rt + \" 不合法！ >, <, >=, <= 不支持与或非逻辑符 & | ! ！\");\n\t\t\t\t\t\t}\n\n\t\t\t\t\t\tsql += (first ? ON : AND) + lk + \" \" + rt + \" \" + rk;\n\t\t\t\t\t}\n\t\t\t\t\telse if (rt.endsWith(\"$\")) {\n\t\t\t\t\t\tString t = rt.substring(0, rt.length() - 1);\n\t\t\t\t\t\tchar r = t.isEmpty() ? 0 : t.charAt(t.length() - 1);\n\n\t\t\t\t\t\tchar l;\n\t\t\t\t\t\tif (r == '%' || r == '_' || r == '?') {\n\t\t\t\t\t\t\tt = t.substring(0, t.length() - 1);\n\n\t\t\t\t\t\t\tif (t.isEmpty()) {\n\t\t\t\t\t\t\t\tif (r == '?') {\n\t\t\t\t\t\t\t\t\tthrow new IllegalArgumentException(on.getOriginKey() + \":value 中字符 \" + on.getOriginKey()\n\t\t\t\t\t\t\t\t\t\t\t+ \" 不合法！key$:value 中不允许只有单独的 '?'，必须和 '%', '_' 之一配合使用 ！\");\n\t\t\t\t\t\t\t\t}\n\n\t\t\t\t\t\t\t\tl = r;\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\telse {\n\t\t\t\t\t\t\t\tl = t.charAt(t.length() - 1);\n\t\t\t\t\t\t\t\tif (l == '%' || l == '_' || l == '?') {\n\t\t\t\t\t\t\t\t\tif (l == r) {\n\t\t\t\t\t\t\t\t\t\tthrow new IllegalArgumentException(on.getOriginKey()\n\t\t\t\t\t\t\t\t\t\t\t\t+ \":value 中字符 \" + t + \" 不合法！key$:value 中不允许 key 中有连续相同的占位符！\");\n\t\t\t\t\t\t\t\t\t}\n\n\t\t\t\t\t\t\t\t\tt = t.substring(0, t.length() - 1);\n\t\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\t\telse if (l > 0 && StringUtil.isName(String.valueOf(l))) {\n\t\t\t\t\t\t\t\t\tl = r;\n\t\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\t}\n\n\t\t\t\t\t\t\tif (l == '?') {\n\t\t\t\t\t\t\t\tl = 0;\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\tif (r == '?') {\n\t\t\t\t\t\t\t\tr = 0;\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t}\n\t\t\t\t\t\telse {\n\t\t\t\t\t\t\tl = r = 0;\n\t\t\t\t\t\t}\n\n\t\t\t\t\t\tif (l <= 0 && r <= 0) {\n\t\t\t\t\t\t\tsql += (first ? ON : AND) + lk + (isNot ? NOT : \"\") + \" LIKE \" + rk;\n\t\t\t\t\t\t}\n\t\t\t\t\t\telse {\n\t\t\t\t\t\t\tsql += (first ? ON : AND) + lk + (isNot ? NOT : \"\")\n\t\t\t\t\t\t\t\t\t+ (l <= 0 ? \" LIKE concat(\" : \" LIKE concat('\" + l + \"', \") + rk + (r <= 0 ? \")\" : \", '\" + r + \"')\");\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\t\t\t\t\telse if (rt.endsWith(\"~\")) {\n\t\t\t\t\t\tboolean ignoreCase = \"*~\".equals(rt);\n\t\t\t\t\t\tif (isPSQL()) {\n\t\t\t\t\t\t\tsql += (first ? ON : AND) + lk + (isNot ? NOT : \"\") + \" ~\" + (ignoreCase ? \"* \" : \" \") + rk;\n\t\t\t\t\t\t}\n\t\t\t\t\t\telse if (isOracle() || isDameng() || isKingBase()) {\n\t\t\t\t\t\t\tsql += (first ? ON : AND) + \"regexp_like(\" + lk + \", \" + rk + (ignoreCase ? \", 'i'\" : \", 'c'\") + \")\";\n\t\t\t\t\t\t}\n\t\t\t\t\t\telse if (isPresto() || isTrino()) {\n\t\t\t\t\t\t\tsql += (first ? ON : AND) + \"regexp_like(\" + (ignoreCase ? \"lower(\" : \"\") + lk + (ignoreCase ? \")\" : \"\")\n\t\t\t\t\t\t\t\t\t+ \", \" + (ignoreCase ? \"lower(\" : \"\") + rk + (ignoreCase ? \")\" : \"\") + \")\";\n\t\t\t\t\t\t}\n\t\t\t\t\t\telse if (isClickHouse()) {\n\t\t\t\t\t\t\tsql += (first ? ON : AND) + \"match(\" + (ignoreCase ? \"lower(\" : \"\") + lk + (ignoreCase ? \")\" : \"\")\n\t\t\t\t\t\t\t\t\t+ \", \" + (ignoreCase ? \"lower(\" : \"\") + rk + (ignoreCase ? \")\" : \"\") + \")\";\n\t\t\t\t\t\t}\n\t\t\t\t\t\telse if (isElasticsearch()) {\n\t\t\t\t\t\t\tsql += (first ? ON : AND) + lk + (isNot ? NOT : \"\") + \" RLIKE \" + rk;\n\t\t\t\t\t\t}\n\t\t\t\t\t\telse if (isHive()) {\n\t\t\t\t\t\t\tsql += (first ? ON : AND) + (ignoreCase ? \"lower(\" : \"\") + lk + (ignoreCase ? \")\" : \"\")\n\t\t\t\t\t\t\t\t\t+ \" REGEXP \" + (ignoreCase ? \"lower(\" : \"\") + rk + (ignoreCase ? \")\" : \"\");\n\t\t\t\t\t\t}\n\t\t\t\t\t\telse {\n\t\t\t\t\t\t\tsql += (first ? ON : AND) + lk + (isNot ? NOT : \"\") + \" REGEXP \" + (ignoreCase ? \"\" : \"BINARY \") + rk;\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\t\t\t\t\telse if (\"{}\".equals(rt) || \"<>\".equals(rt)) {\n\t\t\t\t\t\tString tt = on.getTargetTable();\n\t\t\t\t\t\tString ta = on.getTargetAlias();\n\n\t\t\t\t\t\tMap cast = null;\n\t\t\t\t\t\tif (tt.equals(getTable()) && Objects.equals(ta, getAlias())) {\n\t\t\t\t\t\t\tcast = getCast();\n\t\t\t\t\t\t}\n\t\t\t\t\t\telse {\n\t\t\t\t\t\t\tboolean find = false;\n\t\t\t\t\t\t\tfor (Join jn : joinList) {\n\t\t\t\t\t\t\t\tif (tt.equals(jn.getTable()) && Objects.equals(ta, jn.getAlias())) {\n\t\t\t\t\t\t\t\t\tcast = getCast();\n\t\t\t\t\t\t\t\t\tfind = true;\n\t\t\t\t\t\t\t\t\tbreak;\n\t\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\t}\n\n\t\t\t\t\t\t\tif (find == false) {\n\t\t\t\t\t\t\t\tthrow new IllegalArgumentException(\"join:value 中 value 里的 \" + jt + \"/\" + join.getPath()\n\t\t\t\t\t\t\t\t+ \" 中 JOIN ON 条件中找不到对应的 \" + rt + \" 不合法！只支持 =, {}, <> 这几种！\");\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t}\n\n\t\t\t\t\t\tboolean isBoolOrNum = SQL.isBooleanOrNumber(cast == null ? null : cast.get(on.getTargetKey()));\n\n\t\t\t\t\t\tboolean isIn = \"{}\".equals(rt);\n\t\t\t\t\t\tString arrKeyPath = isIn ? rk : lk;\n\t\t\t\t\t\tString itemKeyPath = isIn ? lk : rk;\n\n\t\t\t\t\t\tif (isPSQL()) { //operator does not exist: jsonb @> character varying \"[\" + c + \"]\");\n\t\t\t\t\t\t\tsql += (first ? ON : AND) + (isNot ? \"( \" : \"\") + gainCondition(isNot, arrKeyPath\n\t\t\t\t\t\t\t\t\t+ \" IS NOT NULL AND \" + arrKeyPath + \" @> \" + itemKeyPath) + (isNot ? \") \" : \"\");\n\t\t\t\t\t\t}\n\t\t\t\t\t\telse if (isOracle() || isDameng() || isKingBase()) {\n\t\t\t\t\t\t\tsql += (first ? ON : AND) + (isNot ? \"( \" : \"\") + gainCondition(isNot, arrKeyPath\n\t\t\t\t\t\t\t\t\t+ \" IS NOT NULL AND json_textcontains(\" + arrKeyPath\n\t\t\t\t\t\t\t\t\t+ \", '$', \" + itemKeyPath + \")\") + (isNot ? \") \" : \"\");\n\t\t\t\t\t\t}\n\t\t\t\t\t\telse if (isPresto() || isTrino()) {\n\t\t\t\t\t\t\tsql += (first ? ON : AND) + (isNot ? \"( \" : \"\") + gainCondition(isNot, arrKeyPath\n\t\t\t\t\t\t\t\t\t+ \" IS NOT NULL AND json_array_contains(cast(\" + arrKeyPath\n\t\t\t\t\t\t\t\t\t+ \" AS VARCHAR), \" + itemKeyPath + \")\") + (isNot ? \") \" : \"\");\n\t\t\t\t\t\t}\n\t\t\t\t\t\telse if (isClickHouse()) {\n\t\t\t\t\t\t\tsql += (first ? ON : AND) + (isNot ? \"( \" : \"\") + gainCondition(isNot, arrKeyPath\n\t\t\t\t\t\t\t\t\t+ \" IS NOT NULL AND has(JSONExtractArrayRaw(assumeNotNull(\" + arrKeyPath + \"))\"\n\t\t\t\t\t\t\t\t\t+ \", \" + itemKeyPath + \")\") + (isNot ? \") \" : \"\");\n\t\t\t\t\t\t}\n\t\t\t\t\t\telse {\n\t\t\t\t\t\t\tsql += (first ? ON : AND) + (isNot ? \"( \" : \"\") + gainCondition(isNot, arrKeyPath\n\t\t\t\t\t\t\t\t\t+ \" IS NOT NULL AND json_contains(\" + arrKeyPath\n\t\t\t\t\t\t\t\t\t+ (isBoolOrNum ? \", cast(\" + itemKeyPath + \" AS CHAR), '$')\"\n\t\t\t\t\t\t\t\t\t\t\t: \", concat('\\\"', \" + itemKeyPath + \", '\\\"'), '$')\"\n\t\t\t\t\t\t\t\t\t)\n\t\t\t\t\t\t\t) + (isNot ? \") \" : \"\");\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\t\t\t\t\telse {\n\t\t\t\t\t\tthrow new IllegalArgumentException(\"join:value 中 value 里的 \" + jt + \"/\" + join.getPath()\n\t\t\t\t\t\t+ \" 中 JOIN ON 条件关联类型 \" + rt + \" 不合法！只支持 =, >, <, >=, <=, !=, $, ~, {}, <> 这几种！\");\n\t\t\t\t\t}\n\t\t\t\t}\n\n\t\t\t\tfirst = false;\n\t\t\t}\n\t\t}\n\n\t\treturn sql;\n\t}\n\n\tprotected void onJoinNotRelation(String sql, String quote, Join join, String table, List onList, On on) {\n\t\tthrow new UnsupportedOperationException(\"JOIN 已禁用 '!' 非逻辑连接符 ！性能很差、需求极少，如要取消禁用可在后端重写相关方法！\");\n\t}\n\tprotected void onJoinComplexRelation(String sql, String quote, Join join, String table, List onList, On on) {\n\t\tthrow new UnsupportedOperationException(\"JOIN 已禁用 $, ~, {}, <>, >, <, >=, <= 等复杂关联 ！\" +\n\t\t\t\t\"性能很差、需求极少，默认只允许 = 等价关联，如要取消禁用可在后端重写相关方法！\");\n\t}\n\n\tprotected void onGainJoinString(Join join) throws UnsupportedOperationException {\n\t}\n\tprotected void onGainCrossJoinString(Join join) throws UnsupportedOperationException {\n\t\tthrow new UnsupportedOperationException(\"已禁用 * CROSS JOIN ！性能很差、需求极少，如要取消禁用可在后端重写相关方法！\");\n\t}\n\n\t/**新建SQL配置\n\t * @param table\n\t * @param request\n\t * @param joinList\n\t * @param isProcedure\n\t * @param callback\n\t * @return\n\t * @throws Exception\n\t */\n\tpublic static , L extends List> SQLConfig newSQLConfig(\n\t\t\tRequestMethod method, String table, String alias\n\t\t\t, M request, List> joinList, boolean isProcedure, Callback callback) throws Exception {\n\t\tif (request == null) { // User:{} 这种空内容在查询时也有效\n\t\t\tthrow new NullPointerException(TAG + \": newSQLConfig request == null!\");\n\t\t}\n\n\t\tBoolean explain = getBoolean(request, KEY_EXPLAIN);\n\t\tif (explain != null && explain && Log.DEBUG == false) { // 不在 config.setExplain 抛异常，一方面处理更早性能更好，另一方面为了内部调用可以绕过这个限制\n\t\t\tthrow new UnsupportedOperationException(\"非DEBUG模式, 不允许传 \" + KEY_EXPLAIN + \" ！\");\n\t\t}\n\n\t\tString database = getString(request, KEY_DATABASE);\n\t\tif (StringUtil.isNotEmpty(database, false) && DATABASE_LIST.contains(database) == false) {\n\t\t\tthrow new UnsupportedDataTypeException(\"@database:value 中 value 错误，只能是 [\"\n\t\t\t\t\t+ StringUtil.get(DATABASE_LIST.toArray()) + \"] 中的一种！\");\n\t\t}\n\n\t\tString datasource = getString(request, KEY_DATASOURCE);\n\t\tString namespace = getString(request, KEY_NAMESPACE);\n\t\tString catalog = getString(request, KEY_CATALOG);\n\t\tString schema = getString(request, KEY_SCHEMA);\n\n\t\tSQLConfig config = (SQLConfig) callback.getSQLConfig(method, database, schema, datasource, table);\n\t\tconfig.setAlias(alias);\n\n\t\tconfig.setDatabase(database); // 不删，后面表对象还要用的，必须放在 parseJoin 前\n\t\tconfig.setDatasource(datasource); // 不删，后面表对象还要用的\n\t\tconfig.setNamespace(namespace); // 不删，后面表对象还要用的\n\t\tconfig.setCatalog(catalog); // 不删，后面表对象还要用的\n\t\tconfig.setSchema(schema); // 不删，后面表对象还要用的\n\n\t\tif (isProcedure) {\n\t\t\treturn config;\n\t\t}\n\n\t\tconfig = parseJoin(method, config, joinList, callback); // 放后面会导致主表是空对象时 joinList 未解析\n\n\t\tif (request.isEmpty()) { // User:{} 这种空内容在查询时也有效\n\t\t\treturn config; // request.remove(key); 前都可以直接return，之后必须保证 put 回去\n\t\t}\n\n\t\t// 对 id, id{}, userId, userId{} 处理，这些只要不为 null 就一定会作为 AND 条件 <<<<<<<<<<<<<<<<<<<<<<<<<\n\n\t\tString idKey = callback.getIdKey(datasource, database, schema, table);\n\t\tString idInKey = idKey + \"{}\";\n\t\tString userIdKey = callback.getUserIdKey(datasource, database, schema, table);\n\t\tString userIdInKey = userIdKey + \"{}\";\n\n\t\tObject idIn = request.get(idInKey); // 可能是 id{}:\">0\"\n\t\tif (idIn instanceof Collection) { // 排除掉 0, 负数, 空字符串 等无效 id 值\n\t\t\tCollection ids = (Collection) idIn;\n\t\t\tList newIdIn = new ArrayList<>();\n\t\t\tfor (Object d : ids) { // 不用 idIn.contains(id) 因为 idIn 里存到很可能是 Integer，id 又是 Long！\n\t\t\t\tif ((d instanceof Number && ((Number) d).longValue() > 0) || (d instanceof String && StringUtil.isNotEmpty(d, true))) {\n\t\t\t\t\tif (newIdIn.contains(d) == false) {\n\t\t\t\t\t\tnewIdIn.add(d);\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t}\n\t\t\tif (newIdIn.isEmpty()) {\n\t\t\t\tthrow new NotExistException(TAG + \": newSQLConfig idIn instanceof List >> 去掉无效 id 后 newIdIn.isEmpty()\");\n\t\t\t}\n\t\t\tidIn = newIdIn;\n\n\t\t\tif (method == DELETE || method == PUT) {\n\t\t\t\tconfig.setCount(newIdIn.size());\n\t\t\t}\n\t\t}\n\n\t\tObject id = request.get(idKey);\n\t\tif (id == null && method == POST) {\n\t\t\tid = callback.newId(method, database, schema, datasource, table); // null 表示数据库自增 id\n\t\t}\n\n\t\tif (id != null) { // null 无效\n\t\t\tif (id instanceof Number) {\n\t\t\t\tif (((Number) id).longValue() <= 0) { // 一定没有值\n\t\t\t\t\tthrow new NotExistException(TAG + \": newSQLConfig \" + table + \".id <= 0\");\n\t\t\t\t}\n\t\t\t}\n\t\t\telse if (id instanceof String) {\n\t\t\t\tif (StringUtil.isEmpty(id, true)) { // 一定没有值\n\t\t\t\t\tthrow new NotExistException(TAG + \": newSQLConfig StringUtil.isEmpty(\" + table + \".id, true)\");\n\t\t\t\t}\n\t\t\t}\n\t\t\telse if (id instanceof Subquery) {}\n\t\t\telse {\n\t\t\t\tthrow new IllegalArgumentException(idKey + \":value 中 value 的类型只能是 Long , String 或 Subquery ！\");\n\t\t\t}\n\n\t\t\tif (idIn instanceof Collection) { // 共用idIn场景少性能差\n\t\t\t\tboolean contains = false;\n\t\t\t\tCollection idList = ((Collection) idIn);\n\t\t\t\tfor (Object d : idList) { // 不用 idIn.contains(id) 因为 idIn 里存到很可能是 Integer，id 又是 Long！\n\t\t\t\t\tif (d != null && id.toString().equals(d.toString())) {\n\t\t\t\t\t\tcontains = true;\n\t\t\t\t\t\tbreak;\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t\tif (contains == false) { // empty有效 BaseModel.isEmpty(idIn) == false) {\n\t\t\t\t\tthrow new NotExistException(TAG + \": newSQLConfig idIn != null && (((List) idIn).contains(id) == false\");\n\t\t\t\t}\n\t\t\t}\n\n\t\t\tif (method == DELETE || method == PUT) {\n\t\t\t\tconfig.setCount(1);\n\t\t\t}\n\t\t}\n\n\t\t// 对 id, id{}, userId, userId{} 处理，这些只要不为 null 就一定会作为 AND 条件 <<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<\n\t\tObject userIdIn = userIdInKey.equals(idInKey) ? null : request.get(userIdInKey); // 可能是 userId{}:\">0\"\n\t\tif (userIdIn instanceof Collection) { // 排除掉 0, 负数, 空字符串 等无效 userId 值\n\t\t\tCollection userIds = (Collection) userIdIn;\n\t\t\tList newUserIdIn = new ArrayList<>();\n\t\t\tfor (Object d : userIds) { // 不用 userIdIn.contains(userId) 因为 userIdIn 里存到很可能是 Integer，userId 又是 Long！\n\t\t\t\tif ((d instanceof Number && ((Number) d).longValue() > 0) || (d instanceof String && StringUtil.isNotEmpty(d, true))) {\n\t\t\t\t\tif (newUserIdIn.contains(d) == false) {\n\t\t\t\t\t\tnewUserIdIn.add(d);\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t}\n\t\t\tif (newUserIdIn.isEmpty()) {\n\t\t\t\tthrow new NotExistException(TAG + \": newSQLConfig userIdIn instanceof List >> 去掉无效 userId 后 newIdIn.isEmpty()\");\n\t\t\t}\n\t\t\tuserIdIn = newUserIdIn;\n\t\t}\n\n\t\tObject userId = userIdKey.equals(idKey) ? null : request.get(userIdKey);\n\t\tif (userId != null) { // null 无效\n\t\t\tif (userId instanceof Number) {\n\t\t\t\tif (((Number) userId).longValue() <= 0) { // 一定没有值\n\t\t\t\t\tthrow new NotExistException(TAG + \": newSQLConfig \" + table + \".userId <= 0\");\n\t\t\t\t}\n\t\t\t}\n\t\t\telse if (userId instanceof String) {\n\t\t\t\tif (StringUtil.isEmpty(userId, true)) { // 一定没有值\n\t\t\t\t\tthrow new NotExistException(TAG + \": newSQLConfig StringUtil.isEmpty(\" + table + \".userId, true)\");\n\t\t\t\t}\n\t\t\t}\n\t\t\telse if (userId instanceof Subquery) {}\n\t\t\telse {\n\t\t\t\tthrow new IllegalArgumentException(userIdKey + \":value 中 value 的类型只能是 Long , String 或 Subquery ！\");\n\t\t\t}\n\n\t\t\tif (userIdIn instanceof Collection) { // 共用 userIdIn 场景少性能差\n\t\t\t\tboolean contains = false;\n\t\t\t\tCollection userIds = (Collection) userIdIn;\n\t\t\t\tfor (Object d : userIds) { // 不用 userIdIn.contains(userId) 因为 userIdIn 里存到很可能是 Integer，userId 又是 Long！\n\t\t\t\t\tif (d != null && userId.toString().equals(d.toString())) {\n\t\t\t\t\t\tcontains = true;\n\t\t\t\t\t\tbreak;\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t\tif (contains == false) { // empty有效 BaseModel.isEmpty(userIdIn) == false) {\n\t\t\t\t\tthrow new NotExistException(TAG + \": newSQLConfig userIdIn != null && (((List) userIdIn).contains(userId) == false\");\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t\t// 对 id, id{}, userId, userId{} 处理，这些只要不为 null 就一定会作为 AND 条件 >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>\n\n\n\t\tString role = getString(request, KEY_ROLE);\n\t\tString cache = getString(request, KEY_CACHE);\n\t\tSubquery from = (Subquery) request.get(KEY_FROM);\n\t\tString column = getString(request, KEY_COLUMN);\n\t\tString nulls = getString(request, KEY_NULL);\n\t\tString cast = getString(request, KEY_CAST);\n\t\tString combine = getString(request, KEY_COMBINE);\n\t\tString group = getString(request, KEY_GROUP);\n\t\tObject having = request.get(KEY_HAVING);\n\t\tString havingAnd = getString(request, KEY_HAVING_AND);\n\t\tString sample = getString(request, KEY_SAMPLE);\n\t\tString latest = getString(request, KEY_LATEST);\n\t\tString partition = getString(request, KEY_PARTITION);\n\t\tString fill = getString(request, KEY_FILL);\n\t\tString order = getString(request, KEY_ORDER);\n\t\tObject keyMap = request.get(KEY_KEY);\n\t\tString raw = getString(request, KEY_RAW);\n\t\tString json = getString(request, KEY_JSON);\n\t\tString mthd = getString(request, KEY_METHOD);\n\n\t\ttry {\n\t\t\t// 强制作为条件且放在最前面优化性能\n\t\t\trequest.remove(idKey);\n\t\t\trequest.remove(idInKey);\n\t\t\trequest.remove(userIdKey);\n\t\t\trequest.remove(userIdInKey);\n\t\t\t// 关键词\n\t\t\trequest.remove(KEY_ROLE);\n\t\t\trequest.remove(KEY_EXPLAIN);\n\t\t\trequest.remove(KEY_CACHE);\n\t\t\trequest.remove(KEY_DATABASE);\n\t\t\trequest.remove(KEY_DATASOURCE);\n\t\t\trequest.remove(KEY_NAMESPACE);\n\t\t\trequest.remove(KEY_CATALOG);\n\t\t\trequest.remove(KEY_SCHEMA);\n\t\t\trequest.remove(KEY_FROM);\n\t\t\trequest.remove(KEY_COLUMN);\n\t\t\trequest.remove(KEY_NULL);\n\t\t\trequest.remove(KEY_CAST);\n\t\t\trequest.remove(KEY_COMBINE);\n\t\t\trequest.remove(KEY_GROUP);\n\t\t\trequest.remove(KEY_HAVING);\n\t\t\trequest.remove(KEY_HAVING_AND);\n\t\t\trequest.remove(KEY_SAMPLE);\n\t\t\trequest.remove(KEY_LATEST);\n\t\t\trequest.remove(KEY_PARTITION);\n\t\t\trequest.remove(KEY_FILL);\n\t\t\trequest.remove(KEY_ORDER);\n\t\t\trequest.remove(KEY_KEY);\n\t\t\trequest.remove(KEY_RAW);\n\t\t\trequest.remove(KEY_JSON);\n\t\t\trequest.remove(KEY_METHOD);\n\n\n\t\t\t// @null <<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<\n\t\t\tString[] nullKeys = StringUtil.split(nulls);\n\t\t\tif (nullKeys != null && nullKeys.length > 0) {\n\t\t\t\tfor (String nk : nullKeys) {\n\t\t\t\t\tif (StringUtil.isEmpty(nk, true)) {\n\t\t\t\t\t\tthrow new IllegalArgumentException(table + \":{ @null: value } 中的字符 '\" + nk + \"' 不合法！不允许为空！\");\n\t\t\t\t\t}\n\t\t\t\t\tif (request.get(nk) != null) {\n\t\t\t\t\t\tthrow new IllegalArgumentException(table + \":{ @null: value } 中的字符 '\"\n\t\t\t\t\t\t\t\t+ nk + \"' 已在当前对象有非 null 值！不允许对同一个 JSON key 设置不同值！\");\n\t\t\t\t\t}\n\n\t\t\t\t\trequest.put(nk, null);\n\t\t\t\t}\n\t\t\t}\n\t\t\t// @null >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>\n\n\t\t\t// @cast <<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<\n\t\t\tString[] casts = StringUtil.split(cast);\n\t\t\tMap castMap = null;\n\t\t\tif (casts != null && casts.length > 0) {\n\t\t\t\tcastMap = new HashMap<>(casts.length);\n\t\t\t\tfor (String c : casts) {\n\t\t\t\t\tapijson.orm.Entry p = Pair.parseEntry(c);\n\n\t\t\t\t\tif (StringUtil.isEmpty(p.getKey(), true)) {\n\t\t\t\t\t\tthrow new IllegalArgumentException(table + \":{} 里的 @cast: 'key0:type0,key1:type1..' 中 '\"\n\t\t\t\t\t\t\t\t+ c + \"' 对应的 key 的字符 '\" + p.getKey() + \"' 不合法！不允许为空！\");\n\t\t\t\t\t}\n\t\t\t\t\tif (StringUtil.isName(p.getValue()) == false) {\n\t\t\t\t\t\tthrow new IllegalArgumentException(table + \":{} 里的 @cast: 'key0:type0,key1:type1..' 中 '\"\n\t\t\t\t\t\t\t\t+ c + \"' 对应的 type 的字符 '\" + p.getValue() + \"' 不合法！必须符合类型名称格式！\");\n\t\t\t\t\t}\n\t\t\t\t\tif (castMap.get(p.getKey()) != null) {\n\t\t\t\t\t\tthrow new IllegalArgumentException(table + \":{} 里的 @cast: 'key0:type0,key1:type1..' 中 '\"\n\t\t\t\t\t\t\t\t+ c + \"' 对应的 key 的字符 '\" + p.getKey() + \"' 已存在！不允许重复设置类型！\");\n\t\t\t\t\t}\n\n\t\t\t\t\tcastMap.put(p.getKey(), p.getValue());\n\t\t\t\t}\n\t\t\t}\n\t\t\t// @cast >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>\n\n\n\t\t\tString[] rawArr = StringUtil.split(raw);\n\t\t\tconfig.setRaw(rawArr == null || rawArr.length <= 0 ? null : new ArrayList<>(Arrays.asList(rawArr)));\n\n\t\t\tMap tableWhere = new LinkedHashMap(); // 保证顺序好优化 WHERE id > 1 AND name LIKE...\n\n\t\t\tboolean ignoreBlankStr = IGNORE_BLANK_STRING_METHOD_LIST != null && IGNORE_BLANK_STRING_METHOD_LIST.contains(method);\n\t\t\tboolean ignoreEmptyStr = ignoreBlankStr || (IGNORE_EMPTY_STRING_METHOD_LIST != null && IGNORE_EMPTY_STRING_METHOD_LIST.contains(method));\n\t\t\tboolean ignoreEmptyOrBlankStr = ignoreEmptyStr || ignoreBlankStr;\n\n\t\t\tboolean enableFakeDelete = config.isFakeDelete();\n\n\t\t\t// 已经 remove了 id 和 id{}，以及 @key\n\t\t\tSet set = request.keySet(); // 前面已经判断 request 是否为空\n\t\t\tif (method == POST) { // POST操作\n\t\t\t\tif (idIn != null) {\n\t\t\t\t\tthrow new IllegalArgumentException(table + \":{\" + idInKey + \": value} 里的 key 不合法！POST 请求中不允许传 \" + idInKey\n\t\t\t\t\t\t\t+ \" 这种非字段命名 key ！必须为 英文字母 开头且只包含 英文字母、数字、下划线的 字段命名！\");\t\t\t\t}\n\t\t\t\tif (userIdIn != null) {\n\t\t\t\t\tthrow new IllegalArgumentException(table + \":{\" + userIdInKey + \": value} 里的 key 不合法！POST 请求中不允许传 \" + userIdInKey\n\t\t\t\t\t\t\t+ \" 这种非字段命名 key ！必须为 英文字母 开头且只包含 英文字母、数字、下划线的 字段命名！\");\t\t\t\t}\n\n\t\t\t\tif (set != null && set.isEmpty() == false) { // 不能直接return，要走完下面的流程\n\t\t\t\t\tfor (String k : set) {\n\t\t\t\t\t\tif (StringUtil.isName(k) == false) {\n\t\t\t\t\t\t\tthrow new IllegalArgumentException(table + \":{\" + k + \": value} 里的 key 不合法！POST 请求中不允许传 \" + k\n\t\t\t\t\t\t\t\t\t+ \" 这种非字段命名 key ！必须为 英文字母 开头且只包含 英文字母、数字、下划线的 字段命名！\");\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\n\t\t\t\t\tString[] columns = set.toArray(new String[]{});\n\n\t\t\t\t\tCollection valueCollection = request.values();\n\t\t\t\t\tObject[] values = valueCollection == null ? null : valueCollection.toArray();\n\n\t\t\t\t\tif (values == null || values.length != columns.length) {\n\t\t\t\t\t\tthrow new Exception(\"服务器内部错误:\\n\" + TAG\n\t\t\t\t\t\t\t\t+ \" newSQLConfig values == null || values.length != columns.length !\");\n\t\t\t\t\t}\n\n\t\t\t\t\tcolumn = (id == null ? \"\" : idKey + \",\") + (userId == null ? \"\" : userIdKey + \",\")\n\t\t\t\t\t\t\t+ StringUtil.get(columns); //set已经判断过不为空\n\n\t\t\t\t\tint idCount = id == null ? (userId == null ? 0 : 1) : (userId == null ? 1 : 2);\n\t\t\t\t\tint size = idCount + columns.length; // 以 key 数量为准\n\n\t\t\t\t\tList items = new ArrayList<>(size); // VALUES(item0, item1, ...)\n\t\t\t\t\tif (id != null) {\n\t\t\t\t\t\titems.add(id); // idList.get(i)); // 第 0 个就是 id\n\t\t\t\t\t}\n\t\t\t\t\tif (userId != null) {\n\t\t\t\t\t\titems.add(userId); // idList.get(i)); // 第 1 个就是 userId\n\t\t\t\t\t}\n\n\t\t\t\t\tfor (int j = 0; j < values.length; j++) {\n\t\t\t\t\t\titems.add(values[j]); // 从第 1 个开始，允许 \"null\"\n\t\t\t\t\t}\n\n\t\t\t\t\tList> valuess = new ArrayList<>(1);\n\t\t\t\t\tvaluess.add(items);\n\t\t\t\t\tconfig.setValues(valuess);\n\t\t\t\t}\n\t\t\t}\n\t\t\telse { // 非 POST 操作\n\t\t\t\tfinal boolean isWhere = method != PUT; // 除了POST,PUT，其它全是条件！！！\n\n\t\t\t\t// 条件<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<\n\t\t\t\tString[] ws = StringUtil.split(combine);\n\t\t\t\tString combineExpr = ws == null || ws.length != 1 ? null : ws[0];\n\n\t\t\t\tMap> combineMap = new LinkedHashMap<>();\n\t\t\t\tList andList = new ArrayList<>();\n\t\t\t\tList orList = new ArrayList<>();\n\t\t\t\tList notList = new ArrayList<>();\n\n\t\t\t\tList whereList = new ArrayList<>();\n\n\t\t\t\t// 强制作为条件且放在最前面优化性能\n\t\t\t\tif (id != null) {\n\t\t\t\t\ttableWhere.put(idKey, id);\n\t\t\t\t\tandList.add(idKey);\n\t\t\t\t\twhereList.add(idKey);\n\t\t\t\t}\n\t\t\t\tif (idIn != null) {\n\t\t\t\t\ttableWhere.put(idInKey, idIn);\n\t\t\t\t\tandList.add(idInKey);\n\t\t\t\t\twhereList.add(idInKey);\n\t\t\t\t}\n\t\t\t\tif (userId != null) {\n\t\t\t\t\ttableWhere.put(userIdKey, userId);\n\t\t\t\t\tandList.add(userIdKey);\n\t\t\t\t\twhereList.add(userIdKey);\n\t\t\t\t}\n\t\t\t\tif (userIdIn != null) {\n\t\t\t\t\ttableWhere.put(userIdInKey, userIdIn);\n\t\t\t\t\tandList.add(userIdInKey);\n\t\t\t\t\twhereList.add(userIdInKey);\n\t\t\t\t}\n\n\t\t\t\tif (enableFakeDelete) {\n\t\t\t\t\t// 查询 Access 假删除\n\t\t\t\t\tMap accessFakeDeleteMap = method == DELETE\n\t\t\t\t\t\t\t? null : AbstractVerifier.ACCESS_FAKE_DELETE_MAP.get(config.getTable());\n\t\t\t\t\tObject deletedKey = accessFakeDeleteMap == null ? null : accessFakeDeleteMap.get(KEY_DELETED_KEY);\n\t\t\t\t\tboolean hasKey = deletedKey instanceof String && StringUtil.isNotEmpty(deletedKey, true);\n\t\t\t\t\tObject deletedValue = hasKey ? accessFakeDeleteMap.get(KEY_DELETED_VALUE) : null;\n\t\t\t\t\tboolean containNotDeletedValue = hasKey && accessFakeDeleteMap.containsKey(KEY_NOT_DELETED_VALUE);\n\t\t\t\t\tObject notDeletedValue = containNotDeletedValue ? accessFakeDeleteMap.get(KEY_NOT_DELETED_VALUE) : null;\n\n\t\t\t\t\tif (deletedValue != null || containNotDeletedValue) {\n\t\t\t\t\t\tboolean isFakeDelete = true;\n\t\t\t\t\t\tif (from != null) {\n\t\t\t\t\t\t\t// 兼容 JOIN 外层 SELECT 重复生成 deletedKey\n\t\t\t\t\t\t\tSQLConfig cfg = from.gainConfig();\n\t\t\t\t\t\t\tif (cfg != null && StringUtil.equals(table, cfg.getTable())) {\n\t\t\t\t\t\t\t\tisFakeDelete = false;\n\t\t\t\t\t\t\t}\n\n\t\t\t\t\t\t\tList> jl = isFakeDelete && cfg != null ? cfg.getJoinList() : null;\n\t\t\t\t\t\t\tif (jl != null) {\n\t\t\t\t\t\t\t\tfor (Join join : jl) {\n\t\t\t\t\t\t\t\t\tif (join != null && StringUtil.equals(table, join.getTable())) {\n\t\t\t\t\t\t\t\t\t\tisFakeDelete = false;\n\t\t\t\t\t\t\t\t\t\tbreak;\n\t\t\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t}\n\n\t\t\t\t\t\tif (isFakeDelete) { // 支持 deleted != 1 / deleted is null 等表达式\n\t\t\t\t\t\t\tif (deletedValue != null) { // deletedKey != deletedValue\n\t\t\t\t\t\t\t\tString key = deletedKey + \"!\";\n\t\t\t\t\t\t\t\ttableWhere.put(key, deletedValue);\n\t\t\t\t\t\t\t\tandList.add(key);\n\t\t\t\t\t\t\t\twhereList.add(key);\n\t\t\t\t\t\t\t}\n\n\t\t\t\t\t\t\tif (containNotDeletedValue) { // deletedKey = notDeletedValue\n\t\t\t\t\t\t\t\tString key = deletedKey.toString();\n\t\t\t\t\t\t\t\ttableWhere.put(key, notDeletedValue);\n\t\t\t\t\t\t\t\tandList.add(key);\n\t\t\t\t\t\t\t\twhereList.add(key);\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\t\t\t\t}\n\n\t\t\t\tif (StringUtil.isNotEmpty(combineExpr, true)) {\n\t\t\t\t\tList banKeyList = Arrays.asList(idKey, idInKey, userIdKey, userIdInKey);\n\t\t\t\t\tfor (String key : banKeyList) {\n\t\t\t\t\t\tif (isKeyInCombineExpr(combineExpr, key)) {\n\t\t\t\t\t\t\tthrow new UnsupportedOperationException(table + \":{} 里的 @combine:value 中的 value 里 \" + key + \" 不合法！\"\n\t\t\t\t\t\t\t\t\t+ \"不允许传 [\" + idKey + \", \" + idInKey + \", \" + userIdKey + \", \" + userIdInKey + \"] 其中任何一个！\");\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t\telse if (ws != null) {\n\t\t\t\t\tfor (int i = 0; i < ws.length; i++) { // 去除 &,|,! 前缀\n\t\t\t\t\t\tString w = ws[i];\n\t\t\t\t\t\tif (w != null) {\n\t\t\t\t\t\t\tif (w.startsWith(\"&\")) {\n\t\t\t\t\t\t\t\tw = w.substring(1);\n\t\t\t\t\t\t\t\tandList.add(w);\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\telse if (w.startsWith(\"|\")) {\n\t\t\t\t\t\t\t\tif (method == PUT) {\n\t\t\t\t\t\t\t\t\tthrow new IllegalArgumentException(table + \":{} 里的 @combine:value 中的value里条件 \" + ws[i] + \" 不合法！\"\n\t\t\t\t\t\t\t\t\t\t\t+ \"PUT请求的 @combine:\\\"key0,key1,...\\\" 不允许传 |key 或 !key !\");\n\t\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\t\tw = w.substring(1);\n\t\t\t\t\t\t\t\torList.add(w);\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\telse if (w.startsWith(\"!\")) {\n\t\t\t\t\t\t\t\tif (method == PUT) {\n\t\t\t\t\t\t\t\t\tthrow new IllegalArgumentException(table + \":{} 里的 @combine:value 中的value里条件 \" + ws[i] + \" 不合法！\"\n\t\t\t\t\t\t\t\t\t\t\t+ \"PUT请求的 @combine:\\\"key0,key1,...\\\" 不允许传 |key 或 !key !\");\n\t\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\t\tw = w.substring(1);\n\t\t\t\t\t\t\t\tnotList.add(w);\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\telse {\n\t\t\t\t\t\t\t\torList.add(w);\n\t\t\t\t\t\t\t}\n\n\t\t\t\t\t\t\tif (w.isEmpty()) {\n\t\t\t\t\t\t\t\tthrow new IllegalArgumentException(table + \":{} 里的 @combine:value 中的value里条件 \" + ws[i] + \" 不合法！不允许为空值！\");\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\telse {\n\t\t\t\t\t\t\t\tif (idKey.equals(w) || idInKey.equals(w) || userIdKey.equals(w) || userIdInKey.equals(w)) {\n\t\t\t\t\t\t\t\t\tthrow new UnsupportedOperationException(table + \":{} 里的 @combine:value 中的 value 里 \" + ws[i] + \" 不合法！\"\n\t\t\t\t\t\t\t\t\t\t\t+ \"不允许传 [\" + idKey + \", \" + idInKey + \", \" + userIdKey + \", \" + userIdInKey + \"] 其中任何一个！\");\n\t\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\t}\n\n\t\t\t\t\t\t\twhereList.add(w);\n\t\t\t\t\t\t}\n\n\t\t\t\t\t\t// 可重写回调方法自定义处理 // 动态设置的场景似乎很少，而且去掉后不方便用户排错！\n\t\t\t\t\t\t// 去掉判断，有时候不在没关系，如果是对增删改等非开放请求强制要求传对应的条件，可以用 Operation.NECESSARY\n\t\t\t\t\t\tif (request.containsKey(w) == false) { // 和 request.get(w) == null 没区别，前面 Parser 已经过滤了 null\n\t\t\t\t\t\t\t//\tthrow new IllegalArgumentException(table + \":{} 里的 @combine:value 中的value里 \" + ws[i] + \" 对应的 \" + w + \" 不在它里面！\");\n\t\t\t\t\t\t\tcallback.onMissingKey4Combine(table, request, combine, ws[i], w);\n\t\t\t\t\t\t\tif (config instanceof AbstractSQLConfig) {\n\t\t\t\t\t\t\t\t((AbstractSQLConfig) config).putWarnIfNeed(KEY_COMBINE, table + \":{} 里的 @combine:value 中的 value 里 \"\n\t\t\t\t\t\t\t\t\t\t+ ws[i] + \" 对应的条件 \" + w + \":value 中 value 必须存在且不能为 null！\");\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\t\t\t\t}\n\n\t\t\t\t// 条件 >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>\n\n\n\t\t\t\tMap tableContent = new LinkedHashMap();\n\t\t\t\tfor (String key : set) {\n\t\t\t\t\tObject value = request.get(key);\n\t\t\t\t\tif (ignoreEmptyOrBlankStr && value instanceof String && StringUtil.isEmpty(value, ignoreBlankStr)) {\n\t\t\t\t\t\tcontinue;\n\t\t\t\t\t}\n\n\t\t\t\t\tif (key.endsWith(\"<>\") == false && value instanceof Map) { // 只允许常规 Object\n\t\t\t\t\t\tthrow new IllegalArgumentException(table + \":{ \" + key + \":value } 中 value 类型错误！除了 key<>:{} 外，不允许 \"\n\t\t\t\t\t\t\t\t+ key + \" 等其它任何 key 对应 value 的类型为 JSONMap {} !\");\n\t\t\t\t\t}\n\n\t\t\t\t\t// 兼容 PUT @combine\n\t\t\t\t\t// 解决AccessVerifier新增userId没有作为条件，而是作为内容，导致PUT，DELETE出错\n\t\t\t\t\tif ((isWhere || (StringUtil.isName(key.replaceFirst(\"[+-]$\", \"\")) == false))\n\t\t\t\t\t\t\t|| (isWhere == false && StringUtil.isNotEmpty(combineExpr, true) && isKeyInCombineExpr(combineExpr, key))) {\n\t\t\t\t\t\ttableWhere.put(key, value);\n\t\t\t\t\t\tif (whereList.contains(key) == false) {\n\t\t\t\t\t\t\tandList.add(key);\n\t\t\t\t\t\t}\n\t\t\t\t\t} else if (whereList.contains(key)) {\n\t\t\t\t\t\ttableWhere.put(key, value);\n\t\t\t\t\t} else {\n\t\t\t\t\t\ttableContent.put(key, value); // 一样 instanceof List ? JSON.toJSONString(value) : value);\n\t\t\t\t\t}\n\t\t\t\t}\n\n\t\t\t\tif (combineMap != null) {\n\t\t\t\t\tcombineMap.put(\"&\", andList);\n\t\t\t\t\tcombineMap.put(\"|\", orList);\n\t\t\t\t\tcombineMap.put(\"!\", notList);\n\t\t\t\t}\n\t\t\t\tconfig.setCombineMap(combineMap);\n\t\t\t\tconfig.setCombine(combineExpr);\n\n\t\t\t\tconfig.setContent(tableContent);\n\t\t\t}\n\n\t\t\tif (enableFakeDelete && method == DELETE) {\n\t\t\t\t// 查询 Access 假删除\n\t\t\t\tMap accessFakeDeleteMap = AbstractVerifier.ACCESS_FAKE_DELETE_MAP.get(config.getTable());\n\n\t\t\t\tObject deletedKey = accessFakeDeleteMap.get(KEY_DELETED_KEY);\n\t\t\t\tif (StringUtil.isNotEmpty(deletedKey, true)) {\n\t\t\t\t\t// 假删除需要更新的其他字段，比如：删除时间 deletedTime 之类的\n\t\t\t\t\tMap fakeDeleteMap = new HashMap<>();\n\t\t\t\t\tfakeDeleteMap.put(deletedKey.toString(), accessFakeDeleteMap.get(KEY_DELETED_VALUE));\n\t\t\t\t\tfakeDeleteMap = config.onFakeDelete(fakeDeleteMap);\n\n\t\t\t\t\tMap content = config.getContent();\n\t\t\t\t\tif (content == null || content.isEmpty()) {\n\t\t\t\t\t\tcontent = fakeDeleteMap;\n\t\t\t\t\t} else {\n\t\t\t\t\t\tcontent.putAll(fakeDeleteMap);\n\t\t\t\t\t}\n\n\t\t\t\t\tconfig.setMethod(PUT);\n\t\t\t\t\tconfig.setContent(content);\n\t\t\t\t}\n\t\t\t}\n\n\t\t\tList cs = new ArrayList<>();\n\n\t\t\tList rawList = config.getRaw();\n\t\t\tboolean containColumnHavingAnd = rawList != null && rawList.contains(KEY_HAVING_AND);\n\n\t\t\tif (containColumnHavingAnd) {\n\t\t\t\tthrow new IllegalArgumentException(table + \":{ @raw:value } 的 value 里字符 @having& 不合法！\"\n\t\t\t\t\t\t+ \"@raw 不支持 @having&，请用 @having 替代！\");\n\t\t\t}\n\n\t\t\t// TODO 这段是否必要？如果 @column 只支持分段后的 SQL 片段，也没问题\n\t\t\tboolean containColumnRaw = rawList != null && rawList.contains(KEY_COLUMN);\n\t\t\tString rawColumnSQL = null;\n\t\t\tif (containColumnRaw) {\n\t\t\t\trawColumnSQL = config.gainRawSQL(KEY_COLUMN, column);\n\t\t\t\tif (rawColumnSQL != null) {\n\t\t\t\t\tcs.add(rawColumnSQL);\n\t\t\t\t}\n\t\t\t}\n\n\t\t\tboolean distinct = rawColumnSQL == null && column != null && column.startsWith(PREFIX_DISTINCT);\n\t\t\tif (rawColumnSQL == null) {\n\t\t\t\t// key0,key1;fun0(key0,...);fun1(key0,...);key3;fun2(key0,...)\n\t\t\t\tString[] fks = StringUtil.split(distinct ? column.substring(PREFIX_DISTINCT.length()) : column, \";\");\n\t\t\t\tif (fks != null) {\n\t\t\t\t\tfor (String fk : fks) {\n\t\t\t\t\t\tif (containColumnRaw) {\n\t\t\t\t\t\t\tString rawSQL = config.gainRawSQL(KEY_COLUMN, fk);\n\t\t\t\t\t\t\tif (rawSQL != null) {\n\t\t\t\t\t\t\t\tcs.add(rawSQL);\n\t\t\t\t\t\t\t\tcontinue;\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t}\n\n\t\t\t\t\t\tif (fk.contains(\"(\")) { // fun0(key0,...)\n\t\t\t\t\t\t\tcs.add(fk);\n\t\t\t\t\t\t}\n\t\t\t\t\t\telse { // key0,key1...\n\t\t\t\t\t\t\tString[] ks = StringUtil.split(fk);\n\t\t\t\t\t\t\tif (ks != null && ks.length > 0) {\n\t\t\t\t\t\t\t\tcs.addAll(Arrays.asList(ks));\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t}\n\n\n\t\t\t// @having, @haivng& <<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<\n\t\t\tObject newHaving = having;\n\t\t\tboolean isHavingAnd = false;\n\n\t\t\tMap havingMap = new LinkedHashMap<>();\n\t\t\tif (havingAnd != null) {\n\t\t\t\tif (having != null) {\n\t\t\t\t\tthrow new IllegalArgumentException(table + \":{ @having: value1, @having&: value2 } \"\n\t\t\t\t\t\t\t+ \"中 value1 与 value2 不合法！不允许同时传 @having 和 @having& ，两者最多传一个！\");\n\t\t\t\t}\n\n\t\t\t\tnewHaving = havingAnd;\n\t\t\t\tisHavingAnd = true;\n\t\t\t}\n\n\t\t\tString havingKey = (isHavingAnd ? KEY_HAVING_AND : KEY_HAVING);\n\t\t\tString havingCombine = \"\";\n\n\t\t\tif (newHaving instanceof String) {\n\t\t\t\tString[] havingss = StringUtil.split((String) newHaving, \";\");\n\t\t\t\tif (havingss != null) {\n\t\t\t\t\tint ind = -1;\n\t\t\t\t\tfor (int i = 0; i < havingss.length; i++) {\n\n\t\t\t\t\t\tString havingsStr = havingss[i];\n\t\t\t\t\t\tint start = havingsStr == null ? -1 : havingsStr.indexOf(\"(\");\n\t\t\t\t\t\tint end = havingsStr == null ? -1 : havingsStr.lastIndexOf(\")\");\n\t\t\t\t\t\tif (IS_HAVING_ALLOW_NOT_FUNCTION == false && (start < 0 || start >= end)) {\n\t\t\t\t\t\t\tthrow new IllegalArgumentException(table + \":{ \" + havingKey + \":value } 里的 value 中的第 \" + i +\n\t\t\t\t\t\t\t\t\t\" 个字符 '\" + havingsStr + \"' 不合法！里面没有包含 SQL 函数！必须为 fun(col1,col2..)?val 格式！\");\n\t\t\t\t\t\t}\n\n\t\t\t\t\t\tString[] havings = start >= 0 && end > start ? new String[]{havingsStr} : StringUtil.split(havingsStr);\n\t\t\t\t\t\tif (havings != null) {\n\t\t\t\t\t\t\tfor (int j = 0; j < havings.length; j++) {\n\t\t\t\t\t\t\t\tind ++;\n\t\t\t\t\t\t\t\tString h = havings[j];\n\t\t\t\t\t\t\t\tif (StringUtil.isEmpty(h, true)) {\n\t\t\t\t\t\t\t\t\tthrow new IllegalArgumentException(table + \":{ \" + havingKey + \":value } 里的\"\n\t\t\t\t\t\t\t\t\t\t\t+ \" value 中的第 \" + ind + \" 个字符 '\" + h + \"' 不合法！不允许为空！\");\n\t\t\t\t\t\t\t\t}\n\n\t\t\t\t\t\t\t\thavingMap.put(\"having\" + ind, h);\n\n\t\t\t\t\t\t\t\tif (isHavingAnd == false && IS_HAVING_DEFAULT_AND == false) {\n\t\t\t\t\t\t\t\t\thavingCombine += (ind <= 0 ? \"\" : \" | \") + \"having\" + ind;\n\t\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t}\n\t\t\telse if (newHaving instanceof Map) {\n\t\t\t\tif (isHavingAnd) {\n\t\t\t\t\tthrow new IllegalArgumentException(table + \":{ \" + havingKey + \":value } 里的 value 类型不合法！\"\n\t\t\t\t\t\t\t+ \"@having&:value 中 value 只能是 String，@having:value 中 value 只能是 String 或 JSONMap ！\");\n\t\t\t\t}\n\n\t\t\t\tM havingObj = JSON.createJSONObject((Map) newHaving);\n\t\t\t\tSet> havingSet = havingObj.entrySet();\n\t\t\t\tfor (Entry entry : havingSet) {\n\t\t\t\t\tString k = entry == null ? null : entry.getKey();\n\t\t\t\t\tObject v = k == null ? null : entry.getValue();\n\t\t\t\t\tif (v == null) {\n\t\t\t\t\t\tcontinue;\n\t\t\t\t\t}\n\t\t\t\t\tif (v instanceof String == false) {\n\t\t\t\t\t\tthrow new IllegalArgumentException(table + \":{ \" + havingKey + \":{ \" + k + \":value } } 里的\"\n\t\t\t\t\t\t\t\t+ \" value 不合法！类型只能是 String，且不允许为空！\");\n\t\t\t\t\t}\n\t\t\t\t\tif (ignoreEmptyOrBlankStr && StringUtil.isEmpty(v, ignoreBlankStr)) {\n\t\t\t\t\t\tcontinue;\n\t\t\t\t\t}\n\n\t\t\t\t\tif (KEY_COMBINE.equals(k)) {\n\t\t\t\t\t\thavingCombine = (String) v;\n\t\t\t\t\t}\n\t\t\t\t\telse if (StringUtil.isName(k) == false) {\n\t\t\t\t\t\tthrow new IllegalArgumentException(table + \":{ \" + havingKey + \":{ \" + k + \":value } } 里的\"\n\t\t\t\t\t\t\t\t+ \" key 对应字符 \" + k + \" 不合法！必须为 英文字母 开头，且只包含 英文字母、下划线、数字 的合法变量名！\");\n\t\t\t\t\t}\n\t\t\t\t\telse {\n\t\t\t\t\t\thavingMap.put(k, (String) v);\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t}\n\t\t\telse if (newHaving != null) {\n\t\t\t\tthrow new IllegalArgumentException(table + \":{ \" + havingKey + \":value } 里的 value 类型不合法！\"\n\t\t\t\t\t\t+ \"@having:value 中 value 只能是 String 或 JSONMap，@having&:value 中 value 只能是 String ！\");\n\t\t\t}\n\t\t\t// @having, @haivng& >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>\n\n\t\t\tif (keyMap instanceof Map) {\n\t\t\t\tconfig.setKeyMap((Map) keyMap);\n\t\t\t}\n\t\t\telse if (keyMap instanceof String) {\n\t\t\t\tString[] ks = StringUtil.split((String) keyMap, \";\");\n\t\t\t\tif (ks.length > 0) {\n\t\t\t\t\tMap nkm = new LinkedHashMap<>();\n\t\t\t\t\tfor (int i = 0; i < ks.length; i++) {\n\t\t\t\t\t\tEntry ety = Pair.parseEntry(ks[i]);\n\t\t\t\t\t\tif (ety == null) {\n\t\t\t\t\t\t\tcontinue;\n\t\t\t\t\t\t}\n\t\t\t\t\t\tnkm.put(ety.getKey(), ety.getValue());\n\t\t\t\t\t}\n\t\t\t\t\tconfig.setKeyMap(nkm);\n\t\t\t\t}\n\t\t\t}\n\t\t\telse if (keyMap != null) {\n\t\t\t\tthrow new UnsupportedDataTypeException(\"@key:value 中 value 错误，只能是 String, JSONMap 中的一种！\");\n\t\t\t}\n\n\n\t\t\tconfig.setExplain(explain != null && explain);\n\t\t\tconfig.setCache(getCache(cache));\n\t\t\tconfig.setDistinct(distinct);\n\t\t\tconfig.setColumn(column == null ? null : cs); //解决总是 config.column != null，总是不能得到 *\n\t\t\tconfig.setFrom(from);\n\n\t\t\tconfig.setRole(role);\n\t\t\tconfig.setId(id);\n\t\t\tconfig.setIdIn(idIn);\n\t\t\tconfig.setUserId(userId);\n\t\t\tconfig.setUserIdIn(userIdIn);\n\n\t\t\tconfig.setNull(nullKeys == null || nullKeys.length <= 0 ? null : new ArrayList<>(Arrays.asList(nullKeys)));\n\t\t\tconfig.setCast(castMap);\n\t\t\tconfig.setWhere(tableWhere);\n\t\t\tconfig.setGroup(group);\n\t\t\tconfig.setHaving(havingMap);\n\t\t\tconfig.setHavingCombine(havingCombine);\n\t\t\tconfig.setSample(sample);\n\t\t\tconfig.setLatest(latest);\n\t\t\tconfig.setPartition(partition);\n\t\t\tconfig.setFill(fill);\n\t\t\tconfig.setOrder(order);\n\n\t\t\tString[] jsons = StringUtil.split(json);\n\t\t\tconfig.setJson(jsons == null || jsons.length <= 0 ? null : new ArrayList<>(Arrays.asList(jsons)));\n\n\t\t}\n\t\tfinally { // 后面还可能用到，要还原\n\t\t\t// id, id{}, userId, userIdIn 条件\n\t\t\tif (id != null) {\n\t\t\t\trequest.put(idKey, id);\n\t\t\t}\n\t\t\tif (idIn != null) {\n\t\t\t\trequest.put(idInKey, idIn);\n\t\t\t}\n\t\t\tif (userId != null) {\n\t\t\t\trequest.put(userIdKey, userId);\n\t\t\t}\n\t\t\tif (userIdIn != null) {\n\t\t\t\trequest.put(userIdInKey, userIdIn);\n\t\t\t}\n\n\t\t\t// 关键词\n\t\t\tif (role != null) {\n\t\t\t\trequest.put(KEY_ROLE, role);\n\t\t\t}\n\t\t\tif (explain != null) {\n\t\t\t\trequest.put(KEY_EXPLAIN, explain);\n\t\t\t}\n\t\t\tif (cache != null) {\n\t\t\t\trequest.put(KEY_CACHE, cache);\n\t\t\t}\n\t\t\tif (database != null) {\n\t\t\t\trequest.put(KEY_DATABASE, database);\n\t\t\t}\n\t\t\tif (datasource != null) {\n\t\t\t\trequest.put(KEY_DATASOURCE, datasource);\n\t\t\t}\n\t\t\tif (schema != null) {\n\t\t\t\trequest.put(KEY_SCHEMA, schema);\n\t\t\t}\n\t\t\tif (from != null) {\n\t\t\t\trequest.put(KEY_FROM, from);\n\t\t\t}\n\t\t\tif (column != null) {\n\t\t\t\trequest.put(KEY_COLUMN, column);\n\t\t\t}\n\t\t\tif (nulls != null) {\n\t\t\t\trequest.put(KEY_NULL, nulls);\n\t\t\t}\n\t\t\tif (cast != null) {\n\t\t\t\trequest.put(KEY_CAST, cast);\n\t\t\t}\n\t\t\tif (combine != null) {\n\t\t\t\trequest.put(KEY_COMBINE, combine);\n\t\t\t}\n\t\t\tif (group != null) {\n\t\t\t\trequest.put(KEY_GROUP, group);\n\t\t\t}\n\t\t\tif (having != null) {\n\t\t\t\trequest.put(KEY_HAVING, having);\n\t\t\t}\n\t\t\tif (havingAnd != null) {\n\t\t\t\trequest.put(KEY_HAVING_AND, havingAnd);\n\t\t\t}\n\t\t\tif (sample != null) {\n\t\t\t\trequest.put(KEY_SAMPLE, sample);\n\t\t\t}\n\t\t\tif (latest != null) {\n\t\t\t\trequest.put(KEY_LATEST, latest);\n\t\t\t}\n\t\t\tif (partition != null) {\n\t\t\t\trequest.put(KEY_PARTITION, partition);\n\t\t\t}\n\t\t\tif (fill != null) {\n\t\t\t\trequest.put(KEY_FILL, fill);\n\t\t\t}\n\t\t\tif (order != null) {\n\t\t\t\trequest.put(KEY_ORDER, order);\n\t\t\t}\n\t\t\tif (keyMap != null) {\n\t\t\t\trequest.put(KEY_KEY, keyMap);\n\t\t\t}\n\t\t\tif (raw != null) {\n\t\t\t\trequest.put(KEY_RAW, raw);\n\t\t\t}\n\t\t\tif (json != null) {\n\t\t\t\trequest.put(KEY_JSON, json);\n\t\t\t}\n\t\t\tif (mthd != null) {\n\t\t\t\trequest.put(KEY_METHOD, mthd);\n\t\t\t}\n\t\t}\n\n\t\treturn config;\n\t}\n\n\n\n\t/**\n\t * @param method\n\t * @param config\n\t * @param joinList\n\t * @param callback\n\t * @return\n\t * @throws Exception\n\t */\n\tpublic static , L extends List> SQLConfig parseJoin(\n\t\t\tRequestMethod method, SQLConfig config, List> joinList, Callback callback) throws Exception {\n\t\tboolean isQuery = RequestMethod.isQueryMethod(method);\n\t\tconfig.setKeyPrefix(isQuery && config.isMain() == false);\n\n\t\t//TODO 解析出 SQLConfig 再合并 column, order, group 等\n\t\tif (joinList == null || joinList.isEmpty() || RequestMethod.isQueryMethod(method) == false) {\n\t\t\treturn config;\n\t\t}\n\n\n\t\tString table;\n\t\tString alias;\n\t\tfor (Join join : joinList) {\n\t\t\ttable = join.getTable();\n\t\t\talias = join.getAlias();\n\t\t\t//JOIN子查询不能设置LIMIT，因为ON关系是在子查询后处理的，会导致结果会错误\n\t\t\tSQLConfig joinConfig = newSQLConfig(method, table, alias, join.getRequest(), null, false, callback);\n\t\t\tSQLConfig cacheConfig = join.canCacheViceTable() == false ? null : newSQLConfig(method, table, alias\n\t\t\t\t\t, join.getRequest(), null, false, callback).setCount(join.getCount());\n\n\t\t\tif (join.isAppJoin() == false) { //除了 @ APP JOIN，其它都是 SQL JOIN，则副表要这样配置\n\t\t\t\tif (joinConfig.getDatabase() == null) {\n\t\t\t\t\tjoinConfig.setDatabase(config.getDatabase()); //解决主表 JOIN 副表，引号不一致\n\t\t\t\t}\n\t\t\t\telse if (joinConfig.getDatabase().equals(config.getDatabase()) == false) {\n\t\t\t\t\tthrow new IllegalArgumentException(\"主表 \" + config.getTable() + \" 的 @database:\" + config.getDatabase()\n\t\t\t\t\t\t\t+ \" 和它 SQL JOIN 的副表 \" + table + \" 的 @database:\" + joinConfig.getDatabase() + \" 不一致！\");\n\t\t\t\t}\n\t\t\t\tif (joinConfig.getSchema() == null) {\n\t\t\t\t\tjoinConfig.setSchema(config.getSchema()); //主表 JOIN 副表，默认 schema 一致\n\t\t\t\t}\n\n\t\t\t\tif (cacheConfig != null) {\n\t\t\t\t\tcacheConfig.setDatabase(joinConfig.getDatabase()).setSchema(joinConfig.getSchema()); //解决主表 JOIN 副表，引号不一致\n\t\t\t\t}\n\n\t\t\t\tif (isQuery) {\n\t\t\t\t\tconfig.setKeyPrefix(true);\n\t\t\t\t}\n\n\t\t\t\tjoinConfig.setMain(false).setKeyPrefix(true);\n\n\t\t\t\tif (join.getOn() != null) {\n\t\t\t\t\tSQLConfig onConfig = newSQLConfig(method, table, alias, join.getOn(), null, false, callback);\n\t\t\t\t\tonConfig.setMain(false)\n\t\t\t\t\t\t\t.setKeyPrefix(true)\n\t\t\t\t\t\t\t.setDatabase(joinConfig.getDatabase())\n\t\t\t\t\t\t\t.setSchema(joinConfig.getSchema()); //解决主表 JOIN 副表，引号不一致\n\n\t\t\t\t\tjoin.setOnConfig(onConfig);\n\t\t\t\t}\n\n\t\t\t\tif (join.getOuter() != null) {\n\t\t\t\t\tSQLConfig outerConfig = newSQLConfig(method, table, alias, join.getOuter(), null, false, callback);\n\t\t\t\t\touterConfig.setMain(false)\n\t\t\t\t\t\t\t.setKeyPrefix(true)\n\t\t\t\t\t\t\t.setDatabase(joinConfig.getDatabase())\n\t\t\t\t\t\t\t.setSchema(joinConfig.getSchema()); //解决主表 JOIN 副表，引号不一致\n\t\t\t\t\tjoin.setOuterConfig(outerConfig);\n\t\t\t\t}\n\t\t\t}\n\n\t\t\t//解决 query: 1/2 查数量时报错\n\t\t\t/* SELECT count(*) AS count FROM sys.Moment AS Moment\n\t\t\t LEFT JOIN ( SELECT count(*) AS count FROM sys.Comment ) AS Comment ON Comment.momentId = Moment.id LIMIT 1 OFFSET 0 */\n\t\t\tif (RequestMethod.isHeadMethod(method, true)) {\n\t\t\t\tList onList = join.getOnList();\n\t\t\t\tList column = onList == null ? null : new ArrayList<>(onList.size());\n\t\t\t\t//解决 pg 如果只查询关联键，会报找不到column的错误\n\t\t\t\t///* SELECT count(*) AS count FROM sys.Moment AS Moment\n\t\t\t\t//\t\t\t LEFT JOIN ( SELECT * FROM sys.Comment ) AS Comment ON Comment.momentId = Moment.id LIMIT 1 OFFSET 0 */\n\t\t\t\tif (column != null && joinConfig.isMSQL()) { // 暂时这样兼容 PostgreSQL 等不支持 SELECT 中不包含对应 key 的隐式 ON 关联字段的数据库\n\t\t\t\t\tfor (On on : onList) {\n\t\t\t\t\t\tcolumn.add(on.getKey()); // TODO PostgreSQL 等需要找到具体的 targetTable 对应 targetKey 来加到 SELECT，比直接 SELECT * 性能更好\n\t\t\t\t\t}\n\t\t\t\t}\n\n\t\t\t\tjoinConfig.setMethod(GET); // 子查询不能为 SELECT count(*) ，而应该是 SELECT momentId\n\t\t\t\tjoinConfig.setColumn(column); // 优化性能，不取非必要的字段\n\n\t\t\t\tif (cacheConfig != null) {\n\t\t\t\t\tcacheConfig.setMethod(GET); // 子查询不能为 SELECT count(*) ，而应该是 SELECT momentId\n\t\t\t\t\tcacheConfig.setColumn(column); // 优化性能，不取非必要的字段\n\t\t\t\t}\n\t\t\t}\n\n\t\t\tjoin.setJoinConfig(joinConfig);\n\t\t\tjoin.setCacheConfig(cacheConfig);\n\t\t}\n\n\t\tconfig.setJoinList(joinList);\n\n\t\treturn config;\n\t}\n\n\n\n\t/**获取客户端实际需要的key\n\t * verifyName = true\n\t * @param method\n\t * @param originKey\n\t * @param isTableKey\n\t * @param saveLogic 保留逻辑运算符 & | !\n\t * @return\n\t */\n\tpublic static String gainRealKey(RequestMethod method, String originKey\n\t\t\t, boolean isTableKey, boolean saveLogic) throws Exception {\n\t\treturn gainRealKey(method, originKey, isTableKey, saveLogic, true);\n\t}\n\t/**获取客户端实际需要的key\n\t * @param method\n\t * @param originKey\n\t * @param isTableKey\n\t * @param saveLogic 保留逻辑运算符 & | !\n\t * @param verifyName 验证key名是否符合代码变量/常量名\n\t * @return\n\t */\n\tpublic static String gainRealKey(RequestMethod method, String originKey\n\t\t\t, boolean isTableKey, boolean saveLogic, boolean verifyName) throws Exception {\n\t\tLog.i(TAG, \"getRealKey saveLogic = \" + saveLogic + \"; originKey = \" + originKey);\n\t\tif (originKey == null || JSONMap.isArrayKey(originKey)) {\n\t\t\tLog.w(TAG, \"getRealKey originKey == null || apijson.JSONMap.isArrayKey(originKey) >> return originKey;\");\n\t\t\treturn originKey;\n\t\t}\n\n\t\tString key = originKey;\n\t\tif (key.endsWith(\"$\")) {//搜索 LIKE，查询时处理\n\t\t\tString k = key.substring(0, key.length() - 1);\n\t\t\t// key%$:\"a\" -> key LIKE '%a%'; key?%$:\"a\" -> key LIKE 'a%'; key_?$:\"a\" -> key LIKE '_a'; key_%$:\"a\" -> key LIKE '_a%'\n\t\t\tchar c = k.isEmpty() ? 0 : k.charAt(k.length() - 1);\n\n\t\t\tif (c == '%' || c == '_' || c == '?') {\n\t\t\t\tk = k.substring(0, k.length() - 1);\n\n\t\t\t\tchar c2 = k.isEmpty() ? 0 : k.charAt(k.length() - 1);\n\t\t\t\tif (c2 == '%' || c2 == '_' || c2 == '?') {\n\t\t\t\t\tif (c2 == c) {\n\t\t\t\t\t\tthrow new IllegalArgumentException(originKey + \":value 中字符 \"\n\t\t\t\t\t\t\t\t+ k + \" 不合法！key$:value 中不允许 key 中有连续相同的占位符！\");\n\t\t\t\t\t}\n\n\t\t\t\t\tk = k.substring(0, k.length() - 1);\n\t\t\t\t}\n\t\t\t\telse if (c == '?') {\n\t\t\t\t\tthrow new IllegalArgumentException(originKey + \":value 中字符 \" + originKey\n\t\t\t\t\t\t\t+ \" 不合法！key$:value 中不允许只有单独的 '?'，必须和 '%', '_' 之一配合使用 ！\");\n\t\t\t\t}\n\t\t\t}\n\n\t\t\tkey = k;\n\t\t}\n\t\telse if (key.endsWith(\"~\")) {//匹配正则表达式 REGEXP，查询时处理\n\t\t\tkey = key.substring(0, key.length() - 1);\n\t\t\tif (key.endsWith(\"*\")) {//忽略大小写\n\t\t\t\tkey = key.substring(0, key.length() - 1);\n\t\t\t}\n\t\t}\n\t\telse if (key.endsWith(\"%\")) {//数字、文本、日期范围 BETWEEN AND\n\t\t\tkey = key.substring(0, key.length() - 1);\n\t\t}\n\t\telse if (key.endsWith(\"{}\")) {//被包含 IN，或者说key对应值处于value的范围内。查询时处理\n\t\t\tkey = key.substring(0, key.length() - 2);\n\t\t}\n\t\telse if (key.endsWith(\"}{\")) {//被包含 EXISTS，或者说key对应值处于value的范围内。查询时处理\n\t\t\tkey = key.substring(0, key.length() - 2);\n\t\t}\n\t\telse if (key.endsWith(\"<>\")) {//包含 json_contains，或者说value处于key对应值的范围内。查询时处理\n\t\t\tkey = key.substring(0, key.length() - 2);\n\t\t}\n\t\telse if (key.endsWith(\"()\")) {//方法，查询完后处理，先用一个Map保存\n\t\t\tkey = key.substring(0, key.length() - 2);\n\t\t}\n\t\telse if (key.endsWith(\"@\")) {//引用，引用对象查询完后处理。fillTarget中暂时不用处理，因为非GET请求都是由给定的id确定，不需要引用\n\t\t\tkey = key.substring(0, key.length() - 1);\n\t\t}\n\t\telse if (key.endsWith(\">=\")) {//比较。查询时处理\n\t\t\tkey = key.substring(0, key.length() - 2);\n\t\t}\n\t\telse if (key.endsWith(\"<=\")) {//比较。查询时处理\n\t\t\tkey = key.substring(0, key.length() - 2);\n\t\t}\n\t\telse if (key.endsWith(\">\")) {//比较。查询时处理\n\t\t\tkey = key.substring(0, key.length() - 1);\n\t\t}\n\t\telse if (key.endsWith(\"<\")) {//比较。查询时处理\n\t\t\tkey = key.substring(0, key.length() - 1);\n\t\t}\n\t\telse if (key.endsWith(\"+\")) {//延长，PUT查询时处理\n\t\t\tif (method == PUT) {//不为PUT就抛异常\n\t\t\t\tkey = key.substring(0, key.length() - 1);\n\t\t\t}\n\t\t}\n\t\telse if (key.endsWith(\"-\")) {//缩减，PUT查询时处理\n\t\t\tif (method == PUT) {//不为PUT就抛异常\n\t\t\t\tkey = key.substring(0, key.length() - 1);\n\t\t\t}\n\t\t}\n\n\t\t// TODO if (key.endsWith(\"-\")) { // 表示 key 和 value 顺序反过来: value LIKE key ?\n\n\t\t// 不用Logic优化代码，否则 key 可能变为 key| 导致 key=value 变成 key|=value 而出错\n\t\tString last = key.isEmpty() ? \"\" : key.substring(key.length() - 1);\n\t\tif (\"&\".equals(last) || \"|\".equals(last) || \"!\".equals(last)) {\n\t\t\tkey = key.substring(0, key.length() - 1);\n\t\t} else {\n\t\t\tlast = null; // 避免key + StringUtil.getString(last) 错误延长\n\t\t}\n\n\t\tString len = \"\";\n\t\tif (key.endsWith(\"[\") || key.endsWith(\"{\")) {\n\t\t\tlen = key.substring(key.length() - 1);\n\t\t\tkey = key.substring(0, key.length() - 1);\n\t\t}\n\n\t\t// \"User:toUser\":User转换\"toUser\":User, User为查询同名Table得到的JSONObject。交给客户端处理更好\n\t\tif (isTableKey) { // 不允许在column key中使用Type:key形式\n\t\t\tkey = Pair.parseEntry(key, true).getKey(); // table以左边为准\n\t\t} else {\n\t\t\tkey = Pair.parseEntry(key).getValue();// column 以右边为准\n\t\t}\n\n\t\tif (verifyName && StringUtil.isName(key.startsWith(\"@\") ? key.substring(1) : key) == false) {\n\t\t\tthrow new IllegalArgumentException(method + \"请求，字符 \" + originKey + \" 不合法！\"\n\t\t\t\t\t+ \" key:value 中的 key 只能关键词 '@key' 或 'key[长度符][逻辑符][条件符]' 或 PUT 请求下的 'key+' / 'key-' ！\"\n\t\t\t\t\t+ \"长度符 只能为 [ - length 和 { - json_length，逻辑符 只能是 & - 与、| - 或、! - 非 ！\");\n\t\t}\n\n\t\tkey += len;\n\n\t\tif (saveLogic && last != null) {\n\t\t\tkey = key + last;\n\t\t}\n\t\tLog.i(TAG, \"getRealKey return key = \" + key);\n\t\treturn key;\n\t}\n\n\n\tpublic static interface IdCallback {\n\t\t/**为 post 请求新建 id， 只能是 Long 或 String\n\t\t * @param method\n\t\t * @param database\n\t\t * @param schema\n\t\t * @param table\n\t\t * @return\n\t\t */\n\t\tT newId(RequestMethod method, String database, String schema, String datasource, String table);\n\n\n\t\t/**获取主键名\n\t\t * @param database\n\t\t * @param schema\n\t\t * @param table\n\t\t * @return\n\t\t */\n\t\tString getIdKey(String database, String schema, String datasource, String table);\n\n\t\t/**获取 User 的主键名\n\t\t * @param database\n\t\t * @param schema\n\t\t * @param table\n\t\t * @return\n\t\t */\n\t\tString getUserIdKey(String database, String schema, String datasource, String table);\n\t}\n\n\tpublic static interface Callback, L extends List> extends IdCallback {\n\t\t/**获取 SQLConfig 的实例\n\t\t * @param method\n\t\t * @param database\n\t\t * @param schema\n\t\t * @param table\n\t\t * @return\n\t\t */\n\t\tSQLConfig getSQLConfig(RequestMethod method, String database, String schema, String datasource, String table);\n\n\t\t/**combine 里的 key 在 request 中 value 为 null 或不存在，即 request 中缺少用来作为 combine 条件的 key: value\n\t\t * @param combine\n\t\t * @param key\n\t\t * @param request\n\t\t */\n\t\tvoid onMissingKey4Combine(String name, M request, String combine, String item, String key) throws Exception;\n\t}\n\n\tpublic static Long LAST_ID;\n\tstatic {\n\t\tLAST_ID = System.currentTimeMillis();\n\t}\n\n\tpublic static abstract class SimpleCallback, L extends List> implements Callback {\n\n\t\t@SuppressWarnings(\"unchecked\")\n\t\t@Override\n\t\tpublic T newId(RequestMethod method, String database, String schema, String datasource, String table) {\n\t\t\tLong id = System.currentTimeMillis();\n\t\t\tif (id <= LAST_ID) {\n\t\t\t\tid = LAST_ID + 1; // 解决高并发下 id 冲突导致新增记录失败\n\t\t\t}\n\t\t\tLAST_ID = id;\n\n\t\t\treturn (T) id;\n\t\t}\n\n\t\t@Override\n\t\tpublic String getIdKey(String database, String schema, String datasource, String table) {\n\t\t\treturn KEY_ID;\n\t\t}\n\n\t\t@Override\n\t\tpublic String getUserIdKey(String database, String schema, String datasource, String table) {\n\t\t\treturn KEY_USER_ID;\n\t\t}\n\n\t\t@Override\n\t\tpublic void onMissingKey4Combine(String name, M request, String combine, String item, String key) throws Exception {\n\t\t\tif (ALLOW_MISSING_KEY_4_COMBINE) {\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tthrow new IllegalArgumentException(name + \":{} 里的 @combine:value 中的value里 \"\n\t\t\t\t\t+ item + \" 对应的条件 \" + key + \":value 中 value 必须存在且不能为 null！\");\n\t\t}\n\n\t}\n\n\tprivate static boolean isKeyInCombineExpr(String combineExpr, String key) {\n\t\twhile (combineExpr.isEmpty() == false) {\n\t\t\tint index = combineExpr.indexOf(key);\n\t\t\tif (index < 0) {\n\t\t\t\treturn false;\n\t\t\t}\n\n\t\t\tchar left = index <= 0 ? ' ' : combineExpr.charAt(index - 1);\n\t\t\tchar right = index >= combineExpr.length() - key.length() ? ' ' : combineExpr.charAt(index + key.length());\n\t\t\tif ((left == ' ' || left == '(' || left == '&' || left == '|' || left == '!') && (right == ' ' || right == ')' || right == ':')) {\n\t\t\t\treturn true;\n\t\t\t}\n\t\t\tint newIndex = index + key.length() + 1;\n\t\t\tif (combineExpr.length() <= newIndex) {\n\t\t\t\tbreak;\n\t\t\t}\n\t\t\tcombineExpr = combineExpr.substring(newIndex);\n\t\t}\n\n\t\treturn false;\n\t}\n\n\n}\n" }, { "path": "APIJSONORM/src/main/java/apijson/orm/AbstractSQLExecutor.java", "content": "/*Copyright (C) 2020 Tencent. All rights reserved.\r\n\r\nThis source code is licensed under the Apache License Version 2.0.*/\r\n\r\n\r\npackage apijson.orm;\r\n\r\nimport apijson.*;\r\nimport apijson.orm.Join.On;\r\nimport apijson.orm.exception.NotExistException;\r\n\r\nimport java.io.BufferedReader;\r\nimport java.math.BigDecimal;\r\nimport java.math.BigInteger;\r\nimport java.sql.*;\r\nimport java.time.DayOfWeek;\r\nimport java.time.LocalDateTime;\r\nimport java.time.Month;\r\nimport java.time.Year;\r\nimport java.util.Date;\r\nimport java.util.*;\r\nimport java.util.Map.Entry;\r\nimport java.util.regex.Pattern;\r\n\r\n/**executor for query(read) or update(write) MySQL database\r\n * @author Lemon\r\n */\r\npublic abstract class AbstractSQLExecutor, L extends List>\r\n\t\timplements SQLExecutor {\r\n\tprivate static final String TAG = \"AbstractSQLExecutor\";\r\n\t//是否返回 值为null的字段\r\n\tpublic static boolean ENABLE_OUTPUT_NULL_COLUMN = false;\r\n\tpublic static String KEY_RAW_LIST = \"@RAW@LIST\"; // 避免和字段命名冲突，不用 $RAW@LIST$ 是因为 $ 会在 fastjson 内部转义，浪费性能\r\n\tpublic static String KEY_VICE_ITEM = \"@VICE@ITEM\"; // 避免和字段命名冲突，不用 $VICE@LIST$ 是因为 $ 会在 fastjson 内部转义，浪费性能\r\n\r\n\tprivate Parser parser;\r\n\t@Override\r\n\tpublic Parser getParser() {\r\n\t\treturn parser;\r\n\t}\r\n\t@Override\r\n\tpublic AbstractSQLExecutor setParser(Parser parser) {\r\n\t\tthis.parser = parser;\r\n\t\treturn this;\r\n\t}\r\n\r\n\tprivate int generatedSQLCount = 0;\r\n\tprivate int cachedSQLCount = 0;\r\n\tprivate int executedSQLCount = 0;\r\n\r\n\t@Override\r\n\tpublic int getGeneratedSQLCount() {\r\n\t\treturn generatedSQLCount;\r\n\t}\r\n\t@Override\r\n\tpublic int getCachedSQLCount() {\r\n\t\treturn cachedSQLCount;\r\n\t}\r\n\t@Override\r\n\tpublic int getExecutedSQLCount() {\r\n\t\treturn executedSQLCount;\r\n\t}\r\n\r\n\tprivate long executedSQLDuration = 0;\r\n\tprivate long sqlResultDuration = 0;\r\n\t@Override\r\n\tpublic long getExecutedSQLDuration() {\r\n\t\treturn executedSQLDuration;\r\n\t}\r\n\r\n\t@Override\r\n\tpublic long getSqlResultDuration() {\r\n\t\treturn sqlResultDuration;\r\n\t}\r\n\r\n\r\n\t/**\r\n\t * 缓存 Map\r\n\t */\r\n\tprotected Map> cacheMap = new HashMap<>();\r\n\r\n\t/**保存缓存\r\n\t * @param sql key\r\n\t * @param list value\r\n\t * @param config 一般主表 SQLConfig 不为 null，JOIN 副表的为 null\r\n\t */\r\n\t@Override\r\n\tpublic void putCache(String sql, List list, SQLConfig config) {\r\n\t\tif (sql == null || list == null) { // 空 list 有效，说明查询过 sql 了 || list.isEmpty()) {\r\n\t\t\tLog.i(TAG, \"saveList sql == null || list == null >> return;\");\r\n\t\t\treturn;\r\n\t\t}\r\n\r\n\t\tcacheMap.put(sql, list);\r\n\t}\r\n\r\n\t/**获取缓存\r\n\t * @param sql key\r\n\t * @param config 一般主表 SQLConfig 不为 null，JOIN 副表的为 null\r\n\t */\r\n\t@Override\r\n\tpublic List getCache(String sql, SQLConfig config) {\r\n\t\treturn cacheMap.get(sql);\r\n\t}\r\n\r\n\t/**获取缓存\r\n\t * @param sql key\r\n\t * @param position\r\n\t * @param config 一般主表 SQLConfig 不为 null，JOIN 副表的为 null\r\n\t * @return\r\n\t */\r\n\t@Override\r\n\tpublic M getCacheItem(String sql, int position, SQLConfig config) {\r\n\t\tList list = getCache(sql, config);\r\n\t\treturn getCacheItem(list, position, config);\r\n\t}\r\n\r\n\tpublic M getCacheItem(List list, int position, SQLConfig config) {\r\n\t\t// 只要 list 不为 null，则如果 list.get(position) == null，则返回 {} ，避免再次 SQL 查询\r\n\t\tif (list == null) {\r\n\t\t\treturn null;\r\n\t\t}\r\n\r\n\t\tM result = position >= list.size() ? null : list.get(position);\r\n\t\treturn result != null ? result : JSON.createJSONObject();\r\n\t}\r\n\r\n\r\n\r\n\t/**移除缓存\r\n\t * @param sql key\r\n\t * @param config\r\n\t */\r\n\t@Override\r\n\tpublic void removeCache(String sql, SQLConfig config) {\r\n\t\tif (sql == null) {\r\n\t\t\tLog.i(TAG, \"removeList sql == null >> return;\");\r\n\t\t\treturn;\r\n\t\t}\r\n\t\tcacheMap.remove(sql);\r\n\t}\r\n\r\n\r\n\t@Override\r\n\tpublic ResultSet executeQuery(@NotNull Statement statement, String sql) throws Exception {\r\n\t\tResultSet rs = statement.executeQuery(sql);\r\n\t\treturn rs;\r\n\t}\r\n\t@Override\r\n\tpublic int executeUpdate(@NotNull Statement statement, String sql) throws Exception {\r\n\t\tint c = statement.executeUpdate(sql);\r\n\t\treturn c;\r\n\t}\r\n\t@Override\r\n\tpublic ResultSet execute(@NotNull Statement statement, String sql) throws Exception {\r\n\t\tstatement.execute(sql);\r\n\t\tResultSet rs = statement.getResultSet();\r\n\t\treturn rs;\r\n\t}\r\n\r\n\t/**执行SQL\r\n\t * @param config\r\n\t * @return\r\n\t * @throws Exception\r\n\t */\r\n\t@Override\r\n\tpublic M execute(@NotNull SQLConfig config, boolean unknownType) throws Exception {\r\n\t\tlong executedSQLStartTime = System.currentTimeMillis();\r\n\t\tfinal String sql = config.gainSQL(false);\r\n\r\n\t\tif (StringUtil.isEmpty(sql, true)) {\r\n\t\t\tLog.e(TAG, \"execute StringUtil.isEmpty(sql, true) >> return null;\");\r\n\t\t\treturn null;\r\n\t\t}\r\n\r\n\t\tParser parser2 = config.gainParser();\r\n\t\tparser = parser2 != null ? parser2 : getParser();;\r\n\r\n\t\tboolean isExplain = config.isExplain();\r\n\t\tboolean isHead = RequestMethod.isHeadMethod(config.getMethod(), true);\r\n\r\n\t\tfinal int position = config.getPosition();\r\n\t\tM result;\r\n\r\n\t\tif (isExplain == false) {\r\n\t\t\tgeneratedSQLCount ++;\r\n\t\t}\r\n\r\n\t\tlong startTime = System.currentTimeMillis();\r\n\t\tLog.d(TAG, \"\\n<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<\"\r\n\t\t\t\t+ \"\\n已生成 \" + generatedSQLCount + \" 条 SQL\"\r\n\t\t\t\t+ \"\\nexecute startTime = \" + startTime\r\n\t\t\t\t+ \"\\ndatabase = \" + StringUtil.get(config.getDatabase())\r\n\t\t\t\t+ \"; schema = \" + StringUtil.get(config.getSchema())\r\n\t\t\t\t+ \"; sql = \\n\" + sql\r\n\t\t\t\t+ \"\\n>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>\\n\");\r\n\r\n\t\tResultSet rs = null;\r\n\t\tList resultList = null;\r\n\t\tMap childMap = null;\r\n\t\tMap keyMap = null;\r\n\r\n\t\ttry {\r\n\t\t\tif (unknownType) {\r\n\t\t\t\tif (isExplain == false) { //只有 SELECT 才能 EXPLAIN\r\n\t\t\t\t\texecutedSQLCount ++;\r\n\t\t\t\t\texecutedSQLStartTime = System.currentTimeMillis();\r\n\t\t\t\t}\r\n\t\t\t\tStatement statement = getStatement(config);\r\n\t\t\t\trs = execute(statement, sql);\r\n\t\t\t\tint updateCount = statement.getUpdateCount();\r\n\t\t\t\tif (isExplain == false) {\r\n\t\t\t\t\texecutedSQLDuration += System.currentTimeMillis() - executedSQLStartTime;\r\n\t\t\t\t}\r\n\r\n\t\t\t\tresult = JSON.createJSONObject();\r\n\t\t\t\tresult.put(JSONResponse.KEY_COUNT, updateCount);\r\n\t\t\t\tresult.put(\"update\", updateCount >= 0);\r\n\t\t\t\t//导致后面 rs.getMetaData() 报错 Operation not allowed after ResultSet closed\t\tresult.put(\"moreResults\", statement.getMoreResults());\r\n\t\t\t}\r\n\t\t\telse {\r\n\t\t\t\tRequestMethod method = config.getMethod();\r\n\t\t\t\tswitch (method) {\r\n\t\t\t\tcase POST:\r\n\t\t\t\tcase PUT:\r\n\t\t\t\tcase DELETE:\r\n\t\t\t\t\tif (isExplain == false) { //只有 SELECT 才能 EXPLAIN\r\n\t\t\t\t\t\texecutedSQLCount ++;\r\n\t\t\t\t\t\texecutedSQLStartTime = System.currentTimeMillis();\r\n\t\t\t\t\t}\r\n\t\t\t\t\tint updateCount = executeUpdate(config);\r\n\t\t\t\t\tif (isExplain == false) {\r\n\t\t\t\t\t\texecutedSQLDuration += System.currentTimeMillis() - executedSQLStartTime;\r\n\t\t\t\t\t}\r\n\r\n\t\t\t\t\tif (updateCount <= 0) {\r\n\t\t\t\t\t\tthrow new IllegalAccessException(\"没权限访问或对象不存在！\"); // NotExistException 会被 catch 转为成功状态\r\n\t\t\t\t\t}\r\n\r\n\t\t\t\t\t// updateCount>0时收集结果。例如更新操作成功时，返回count(affected rows)、id字段\r\n\t\t\t\t\tresult = parser.newSuccessResult(); // TODO 对 APIAuto 及其它现有的前端/客户端影响比较大，暂时还是返回 code 和 msg，5.0 再移除 JSON.createJSONObject();\r\n\r\n\t\t\t\t\t//id,id{}至少一个会有，一定会返回，不用抛异常来阻止关联写操作时前面错误导致后面无条件执行！\r\n\t\t\t\t\tresult.put(JSONResponse.KEY_COUNT, updateCount);//返回修改的记录数\r\n\r\n\t\t\t\t\tString idKey = config.getIdKey();\r\n\t\t\t\t\tif (config.getId() != null) {\r\n\t\t\t\t\t\tresult.put(idKey, config.getId());\r\n\t\t\t\t\t}\r\n\t\t\t\t\tif (config.getIdIn() != null) {\r\n\t\t\t\t\t\tresult.put(idKey + \"[]\", config.getIdIn());\r\n\t\t\t\t\t}\r\n\r\n\t\t\t\t\tif (method == RequestMethod.PUT || method == RequestMethod.DELETE) {\r\n\t\t\t\t\t\tconfig.setMethod(RequestMethod.GET);\r\n\t\t\t\t\t\tremoveCache(config.gainSQL(false), config);\r\n\t\t\t\t\t\tconfig.setMethod(method);\r\n\t\t\t\t\t}\r\n\r\n\t\t\t\t\treturn result;\r\n\r\n\t\t\t\tcase GET:\r\n\t\t\t\tcase GETS:\r\n\t\t\t\tcase HEAD:\r\n\t\t\t\tcase HEADS:\r\n\t\t\t\t\tList cache = getCache(sql, config);\r\n\t\t\t\t\tresult = getCacheItem(cache, position, config);\r\n\t\t\t\t\tLog.i(TAG, \">>> execute result = getCache('\" + sql + \"', \" + position + \") = \" + result);\r\n\t\t\t\t\tif (result != null) {\r\n\t\t\t\t\t\tif (isExplain == false) {\r\n\t\t\t\t\t\t\tcachedSQLCount ++;\r\n\t\t\t\t\t\t}\r\n\r\n\t\t\t\t\t\tif (cache != null && cache.size() > 1) {\r\n\t\t\t\t\t\t\tresult.put(KEY_RAW_LIST, cache);\r\n\t\t\t\t\t\t}\r\n\t\t\t\t\t\tLog.d(TAG, \"\\n\\n execute result != null >> return result;\" + \"\\n>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>\\n\\n\");\r\n\t\t\t\t\t\treturn result;\r\n\t\t\t\t\t}\r\n\r\n\t\t\t\t\tif (isExplain == false) { //只有 SELECT 才能 EXPLAIN\r\n\t\t\t\t\t\texecutedSQLCount ++;\r\n\t\t\t\t\t\texecutedSQLStartTime = System.currentTimeMillis();\r\n\t\t\t\t\t}\r\n\t\t\t\t\trs = executeQuery(config); //FIXME SQL Server 是一次返回两个结果集，包括查询结果和执行计划，需要 moreResults\r\n\t\t\t\t\tif (isExplain == false) {\r\n\t\t\t\t\t\texecutedSQLDuration += System.currentTimeMillis() - executedSQLStartTime;\r\n\t\t\t\t\t}\r\n\t\t\t\t\tbreak;\r\n\r\n\t\t\t\tdefault: //OPTIONS, TRACE等\r\n\t\t\t\t\tLog.e(TAG, \"execute sql = \" + sql + \" ; method = \" + config.getMethod() + \" >> return null;\");\r\n\t\t\t\t\treturn null;\r\n\t\t\t\t}\r\n\t\t\t}\r\n\r\n\t\t\tif (isExplain == false && isHead) {\r\n\t\t\t\tif (rs.next() == false) {\r\n\t\t\t\t\treturn parser.newErrorResult(new SQLException(\"数据库错误, rs.next() 失败！\"));\r\n\t\t\t\t}\r\n\r\n\t\t\t\tresult = parser.newSuccessResult();\r\n\t\t\t\t// 兼容nosql,比如 elasticSearch-sql\r\n\t\t\t\tif(config.isElasticsearch()) {\r\n\t\t\t\t\tresult.put(JSONResponse.KEY_COUNT, rs.getObject(1));\r\n\t\t\t\t}else {\r\n\t\t\t\t\tresult.put(JSONResponse.KEY_COUNT, rs.getLong(1));\r\n\t\t\t\t}\r\n\t\t\t\tresultList = new ArrayList<>(1);\r\n\t\t\t\tresultList.add(result);\r\n\t\t\t}\r\n\t\t\telse {\r\n\t\t\t\t//\t\tfinal boolean cache = config.getCount() != 1;\r\n\t\t\t\t//\t\tLog.d(TAG, \"select cache = \" + cache + \"; resultList\" + (resultList == null ? \"=\" : \"!=\") + \"null\");\r\n\t\t\t\ttry { // 设置初始容量为查到的数据量，解决频繁扩容导致的延迟，貌似只有 rs.last 取 rs.getRow() ? 然后又得 rs.beforeFirst 重置位置以便下方取值\r\n\t\t\t\t\trs.last(); //移到最后一行\r\n\t\t\t\t\tresultList = new ArrayList<>(rs.getRow());\r\n\t\t\t\t\trs.beforeFirst();\r\n\t\t\t\t}\r\n\t\t\t\tcatch (Throwable e) {\r\n\t\t\t\t\tLog.e(TAG, \"try { rs.last(); resultList = new ArrayList<>(rs.getRow()); rs.beforeFirst(); >> } catch (Throwable e) = \" + e.getMessage());\r\n\t\t\t\t\tint capacity;\r\n\t\t\t\t\tif (config.getId() != null) { // id:Object 一定是 AND 条件，最终返回数据最多就这么多\r\n\t\t\t\t\t\tcapacity = 1;\r\n\t\t\t\t\t}\r\n\t\t\t\t\telse {\r\n\t\t\t\t\t\tObject idIn = config.getIdIn();\r\n\t\t\t\t\t\tif (idIn instanceof Collection) { // id{}:[] 一定是 AND 条件，最终返回数据最多就这么多\r\n\t\t\t\t\t\t\tcapacity = ((Collection) idIn).size();\r\n\t\t\t\t\t\t}\r\n\t\t\t\t\t\telse { // 预估容量\r\n\t\t\t\t\t\t\tcapacity = config.getCount() <= 0 ? AbstractParser.MAX_QUERY_COUNT : config.getCount();\r\n\t\t\t\t\t\t\tif (capacity > 100) {\r\n\t\t\t\t\t\t\t\t// 有 WHERE 条件，条件越多过滤数据越多，暂时不考虑 @combine:\"a | (b & !c)\" 里面 | OR 和 ! NOT 条件，太复杂也不是很必要\r\n\t\t\t\t\t\t\t\tMap> combine = config.getCombineMap();\r\n\r\n\t\t\t\t\t\t\t\tList andList = combine == null ? null : combine.get(\"&\");\r\n\t\t\t\t\t\t\t\tint andCondCount = andList == null ? (config.getWhere() == null ? 0 : config.getWhere().size()) : andList.size();\r\n\r\n\t\t\t\t\t\t\t\tList orList = combine == null ? null : combine.get(\"|\");\r\n\t\t\t\t\t\t\t\tint orCondCount = orList == null ? 0 : orList.size();\r\n\r\n\t\t\t\t\t\t\t\tList notList = combine == null ? null : combine.get(\"!\");\r\n\t\t\t\t\t\t\t\tint notCondCount = notList == null ? 0 : notList.size();\r\n\r\n\t\t\t\t\t\t\t\t// 有 GROUP BY 分组，字段越少过滤数据越多\r\n\t\t\t\t\t\t\t\tString[] group = StringUtil.split(config.getGroup());\r\n\t\t\t\t\t\t\t\tint groupCount = group == null ? 0 : group.length;\r\n\t\t\t\t\t\t\t\tif (groupCount > 0 && Arrays.asList(group).contains(config.getIdKey())) {\r\n\t\t\t\t\t\t\t\t\tgroupCount = 0;\r\n\t\t\t\t\t\t\t\t}\r\n\r\n\t\t\t\t\t\t\t\t// 有 HAVING 聚合函数，字段越多过滤数据越多，暂时不考虑 @combine:\"a | (b & !c)\" 里面 | OR 和 ! NOT 条件，太复杂也不是很必要\r\n\t\t\t\t\t\t\t\tMap having = config.getHaving();\r\n\t\t\t\t\t\t\t\tint havingCount = having == null ? 0 : having.size();\r\n\r\n\t\t\t\t\t\t\t\tcapacity /= Math.pow(1.5, Math.log10(capacity)\r\n\t\t\t\t\t\t\t\t\t\t+ andCondCount\r\n\t\t\t\t\t\t\t\t\t\t+ ((orCondCount <= 0 ? 0 : 2.0d/orCondCount) // 1: 2.3, 2: 1.5, 3: 1.3, 4: 1.23, 5: 1.18\r\n\t\t\t\t\t\t\t\t\t\t+ (notCondCount/5.0d) // 1: 1.08, 2: 1.18, 3: 1.28, 4: 1.38, 1.50\r\n\t\t\t\t\t\t\t\t\t\t+ (groupCount <= 0 ? 0 : 10.0d/groupCount)) // 1: 57.7, 7.6, 3: 3.9, 4: 2.8, 5: 2.3\r\n\t\t\t\t\t\t\t\t\t\t+ havingCount\r\n\t\t\t\t\t\t\t\t\t\t);\r\n\t\t\t\t\t\t\t\tcapacity += 1; // 避免正好比需要容量少一点点导致多一次扩容，大量数据 System.arrayCopy\r\n\t\t\t\t\t\t\t}\r\n\t\t\t\t\t\t}\r\n\t\t\t\t\t}\r\n\r\n\t\t\t\t\tresultList = new ArrayList<>(capacity);\r\n\t\t\t\t}\r\n\r\n\t\t\t\tint index = -1;\r\n\r\n\t\t\t\tlong startTime2 = System.currentTimeMillis();\r\n\t\t\t\tResultSetMetaData rsmd = rs.getMetaData();\r\n\t\t\t\tfinal int length = rsmd.getColumnCount();\r\n\t\t\t\tsqlResultDuration += System.currentTimeMillis() - startTime2;\r\n\r\n\t\t\t\t//