Skip to content

Commit a890621

Browse files
TommyLemonTommyLemon
committedFeb 2, 2025
新增 javax 来兼容 JDK 1.8~16 及 SpringBoot 1.4~2.7 等
·
7.1.77.1.5
1 parent 432f162 commit a890621

17 files changed

+2797
-9
lines changed
 

‎.gitignore

+2
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,8 @@
11
HELP.md
22
.gradle
33
build/
4+
target/
5+
46
!gradle/wrapper/gradle-wrapper.jar
57
!**/src/main/**/build/
68
!**/src/test/**/build/

‎pom.xml

+9-1
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@
55

66
<groupId>apijson.framework</groupId>
77
<artifactId>apijson-framework</artifactId>
8-
<version>7.1.0</version>
8+
<version>7.1.5</version>
99
<packaging>jar</packaging>
1010

1111
<name>APIJSONFramework</name>
@@ -21,13 +21,21 @@
2121
</properties>
2222

2323
<dependencies>
24+
<!-- JDK 17+, SpringBoot 3.0+ -->
2425
<dependency>
2526
<groupId>jakarta.servlet</groupId>
2627
<artifactId>jakarta.servlet-api</artifactId>
2728
<version>6.0.0</version>
2829
<scope>provided</scope>
2930
</dependency>
3031

32+
<!-- JDK 1.8~16, SpringBoot 1.4~2.7 -->
33+
<dependency>
34+
<groupId>javax.servlet</groupId>
35+
<artifactId>javax.servlet-api</artifactId>
36+
<version>4.0.1</version>
37+
</dependency>
38+
3139
<dependency>
3240
<groupId>com.alibaba</groupId>
3341
<artifactId>fastjson</artifactId>

‎src/main/java/apijson/framework/APIJSONCreator.java

+6-6
Original file line numberDiff line numberDiff line change
@@ -35,8 +35,8 @@ public Parser<T> createParser() {
3535
}
3636

3737
@Override
38-
public FunctionParser createFunctionParser() {
39-
return new APIJSONFunctionParser();
38+
public FunctionParser<T> createFunctionParser() {
39+
return new APIJSONFunctionParser<>();
4040
}
4141

4242
@Override
@@ -45,13 +45,13 @@ public Verifier<T> createVerifier() {
4545
}
4646

4747
@Override
48-
public SQLConfig createSQLConfig() {
49-
return new APIJSONSQLConfig();
48+
public SQLConfig<T> createSQLConfig() {
49+
return new APIJSONSQLConfig<>();
5050
}
5151

5252
@Override
53-
public SQLExecutor createSQLExecutor() {
54-
return new APIJSONSQLExecutor();
53+
public SQLExecutor<T> createSQLExecutor() {
54+
return new APIJSONSQLExecutor<>();
5555
}
5656

5757
}

‎src/main/java/apijson/framework/APIJSONSQLConfig.java

+2-2
Original file line numberDiff line numberDiff line change
@@ -56,11 +56,11 @@ public class APIJSONSQLConfig<T extends Object> extends AbstractSQLConfig<T> {
5656

5757
APIJSON_CREATOR = new APIJSONCreator<>();
5858

59-
SIMPLE_CALLBACK = new SimpleCallback<Object>() {
59+
SIMPLE_CALLBACK = new SimpleCallback<>() {
6060

6161
@Override
6262
public SQLConfig<Object> getSQLConfig(RequestMethod method, String database, String schema,String datasource, String table) {
63-
SQLConfig<Object> config = APIJSON_CREATOR.createSQLConfig();
63+
SQLConfig<Object> config = (SQLConfig<Object>) APIJSON_CREATOR.createSQLConfig();
6464
config.setMethod(method);
6565
config.setDatabase(database);
6666
config.setDatasource(datasource);

‎src/main/java/apijson/framework/javax/APIJSONApplication.java

+163
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,163 @@
1+
/*Copyright ©2016 TommyLemon(https://github.com/TommyLemon/APIJSON)
2+
3+
Licensed under the Apache License, Version 2.0 (the "License");
4+
you may not use this file except in compliance with the License.
5+
You may obtain a copy of the License at
6+
7+
http://www.apache.org/licenses/LICENSE-2.0
8+
9+
Unless required by applicable law or agreed to in writing, software
10+
distributed under the License is distributed on an "AS IS" BASIS,
11+
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12+
See the License for the specific language governing permissions and
13+
limitations under the License.*/
14+
15+
package apijson.framework.javax;
16+
17+
import apijson.Log;
18+
import apijson.NotNull;
19+
import apijson.orm.AbstractFunctionParser;
20+
import apijson.orm.script.ScriptExecutor;
21+
22+
import java.rmi.ServerException;
23+
24+
25+
/**启动入口 Application
26+
* 右键这个类 > Run As > Java Application
27+
* @author Lemon
28+
*/
29+
public class APIJSONApplication {
30+
public static final String TAG = "APIJSONApplication";
31+
32+
@NotNull
33+
public static APIJSONCreator<? extends Object> DEFAULT_APIJSON_CREATOR;
34+
static {
35+
DEFAULT_APIJSON_CREATOR = new APIJSONCreator<>();
36+
}
37+
38+
39+
/**初始化，加载所有配置并校验
40+
* @return
41+
* @throws Exception
42+
*/
43+
public static void init() throws Exception {
44+
init(true, DEFAULT_APIJSON_CREATOR);
45+
}
46+
/**初始化，加载所有配置并校验
47+
* @param shutdownWhenServerError
48+
* @return
49+
* @throws Exception
50+
*/
51+
public static void init(boolean shutdownWhenServerError) throws Exception {
52+
init(shutdownWhenServerError, DEFAULT_APIJSON_CREATOR);
53+
}
54+
/**初始化，加载所有配置并校验
55+
* @param creator
56+
* @return
57+
* @throws Exception
58+
*/
59+
public static <T extends Object> void init(@NotNull APIJSONCreator<T> creator) throws Exception {
60+
init(true, creator);
61+
}
62+
/**初始化，加载所有配置并校验
63+
* @param shutdownWhenServerError
64+
* @param creator
65+
* @return
66+
* @throws Exception
67+
*/
68+
public static <T extends Object> void init(boolean shutdownWhenServerError, @NotNull APIJSONCreator<T> creator) throws Exception {
69+
System.out.println("\n\n\n\n\n<<<<<<<<<<<<<<<<<<<<<<<<< APIJSON 开始启动 >>>>>>>>>>>>>>>>>>>>>>>>\n");
70+
DEFAULT_APIJSON_CREATOR = creator;
71+
72+
// 统一用同一个 creator
73+
APIJSONSQLConfig.APIJSON_CREATOR = creator;
74+
APIJSONParser.APIJSON_CREATOR = creator;
75+
APIJSONController.APIJSON_CREATOR = creator;
76+
77+
78+
if (APIJSONVerifier.ENABLE_VERIFY_ROLE) {
79+
System.out.println("\n\n\n开始初始化: Access 权限校验配置 <<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<\n");
80+
try {
81+
APIJSONVerifier.initAccess(shutdownWhenServerError, creator);
82+
} catch (Throwable e) {
83+
e.printStackTrace();
84+
if (shutdownWhenServerError) {
85+
onServerError("Access 权限校验配置 初始化失败！", shutdownWhenServerError);
86+
}
87+
}
88+
System.out.println("\n完成初始化: Access 权限校验配置 >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>");
89+
}
90+
91+
92+
if (APIJSONFunctionParser.ENABLE_REMOTE_FUNCTION) {
93+
System.out.println("\n\n\n开始初始化: Function 远程函数配置 <<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<\n");
94+
try {
95+
APIJSONFunctionParser.init(shutdownWhenServerError, creator);
96+
} catch (Throwable e) {
97+
e.printStackTrace();
98+
if (shutdownWhenServerError) {
99+
onServerError("Function 远程函数配置 初始化失败！", shutdownWhenServerError);
100+
}
101+
}
102+
System.out.println("\n完成初始化: Function 远程函数配置 >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>");
103+
104+
System.out.println("开始测试: Function 远程函数 <<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<\n");
105+
try {
106+
APIJSONFunctionParser.test();
107+
} catch (Throwable e) {
108+
e.printStackTrace();
109+
if (shutdownWhenServerError) {
110+
onServerError("Function 远程函数配置 测试失败！", shutdownWhenServerError);
111+
}
112+
}
113+
System.out.println("\n完成测试: Function 远程函数 >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>");
114+
}
115+
116+
117+
if (APIJSONVerifier.ENABLE_VERIFY_CONTENT) {
118+
System.out.println("\n\n\n开始初始化: Request 请求参数校验配置 <<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<\n");
119+
try {
120+
APIJSONVerifier.initRequest(shutdownWhenServerError, creator);
121+
} catch (Throwable e) {
122+
e.printStackTrace();
123+
if (shutdownWhenServerError) {
124+
onServerError("Request 请求参数校验配置 初始化失败！", shutdownWhenServerError);
125+
}
126+
}
127+
System.out.println("\n完成初始化: Request 请求参数校验校验配置 >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>");
128+
129+
System.out.println("\n\n\n开始测试: Request 请求参数校验 <<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<\n");
130+
try {
131+
APIJSONVerifier.testStructure();
132+
} catch (Throwable e) {
133+
e.printStackTrace();
134+
if (shutdownWhenServerError) {
135+
onServerError("Request 请求参数校验 测试失败！", shutdownWhenServerError);
136+
}
137+
}
138+
System.out.println("\n完成测试: Request 请求参数校验 >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>");
139+
}
140+
141+
142+
143+
System.out.println("官方网站： http://apijson.cn");
144+
System.out.println("设计规范： https://github.com/Tencent/APIJSON/blob/master/Document.md#3");
145+
System.out.println("测试链接： http://apijson.cn/api?type=JSON&url=http://localhost:8080/get");
146+
System.out.println("\n\n<<<<<<<<<<<<<<<<<<<<<<<<< APIJSON 启动完成，试试调用零代码万能通用 API 吧 ^_^ >>>>>>>>>>>>>>>>>>>>>>>>\n");
147+
}
148+
149+
protected static void onServerError(String msg, boolean shutdown) throws ServerException {
150+
Log.e(TAG, "\n启动时自检测试未通过！原因：\n" + msg);
151+
152+
if (shutdown) {
153+
System.exit(1);
154+
} else {
155+
throw new ServerException(msg);
156+
}
157+
}
158+
159+
public static void addScriptExecutor(String language, ScriptExecutor scriptExecutor) {
160+
scriptExecutor.init();
161+
AbstractFunctionParser.SCRIPT_EXECUTOR_MAP.put(language, scriptExecutor);
162+
}
163+
}

‎src/main/java/apijson/framework/javax/APIJSONConstant.java

+20
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,20 @@
1+
/*Copyright ©2016 TommyLemon(https://github.com/TommyLemon/APIJSON)
2+
3+
Licensed under the Apache License, Version 2.0 (the "License");
4+
you may not use this file except in compliance with the License.
5+
You may obtain a copy of the License at
6+
7+
http://www.apache.org/licenses/LICENSE-2.0
8+
9+
Unless required by applicable law or agreed to in writing, software
10+
distributed under the License is distributed on an "AS IS" BASIS,
11+
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12+
See the License for the specific language governing permissions and
13+
limitations under the License.*/
14+
15+
package apijson.framework.javax;
16+
17+
/**APIJSON 常量类
18+
* @author Lemon
19+
*/
20+
public class APIJSONConstant extends apijson.framework.APIJSONConstant {}

‎src/main/java/apijson/framework/javax/APIJSONController.java

+452
Large diffs are not rendered by default.

‎src/main/java/apijson/framework/javax/APIJSONCreator.java

+50
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,50 @@
1+
/*Copyright ©2016 TommyLemon(https://github.com/TommyLemon/APIJSON)
2+
3+
Licensed under the Apache License, Version 2.0 (the "License");
4+
you may not use this file except in compliance with the License.
5+
You may obtain a copy of the License at
6+
7+
http://www.apache.org/licenses/LICENSE-2.0
8+
9+
Unless required by applicable law or agreed to in writing, software
10+
distributed under the License is distributed on an "AS IS" BASIS,
11+
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12+
See the License for the specific language governing permissions and
13+
limitations under the License.*/
14+
15+
package apijson.framework.javax;
16+
17+
import apijson.orm.*;
18+
19+
20+
/**APIJSON相关创建器
21+
* @author Lemon
22+
*/
23+
public class APIJSONCreator<T> implements ParserCreator<T>, VerifierCreator<T>, SQLCreator {
24+
25+
@Override
26+
public Parser<T> createParser() {
27+
return new APIJSONParser<>();
28+
}
29+
30+
@Override
31+
public FunctionParser<T> createFunctionParser() {
32+
return new APIJSONFunctionParser<>();
33+
}
34+
35+
@Override
36+
public Verifier<T> createVerifier() {
37+
return new APIJSONVerifier<>();
38+
}
39+
40+
@Override
41+
public SQLConfig<T> createSQLConfig() {
42+
return new APIJSONSQLConfig<>();
43+
}
44+
45+
@Override
46+
public SQLExecutor<T> createSQLExecutor() {
47+
return new APIJSONSQLExecutor<>();
48+
}
49+
50+
}

‎src/main/java/apijson/framework/javax/APIJSONFunctionParser.java

+790
Large diffs are not rendered by default.

‎src/main/java/apijson/framework/javax/APIJSONObjectParser.java

+69
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,69 @@
1+
/*Copyright ©2016 TommyLemon(https://github.com/TommyLemon/APIJSON)
2+
3+
Licensed under the Apache License, Version 2.0 (the "License");
4+
you may not use this file except in compliance with the License.
5+
You may obtain a copy of the License at
6+
7+
http://www.apache.org/licenses/LICENSE-2.0
8+
9+
Unless required by applicable law or agreed to in writing, software
10+
distributed under the License is distributed on an "AS IS" BASIS,
11+
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12+
See the License for the specific language governing permissions and
13+
limitations under the License.*/
14+
15+
package apijson.framework.javax;
16+
17+
import apijson.NotNull;
18+
import apijson.RequestMethod;
19+
import apijson.orm.AbstractObjectParser;
20+
import apijson.orm.Join;
21+
import apijson.orm.Parser;
22+
import apijson.orm.SQLConfig;
23+
import com.alibaba.fastjson.JSONObject;
24+
import javax.servlet.http.HttpSession;
25+
26+
import java.util.List;
27+
28+
29+
/**简化Parser，getObject和getArray(getArrayConfig)都能用
30+
* @author Lemon
31+
*/
32+
public class APIJSONObjectParser<T extends Object> extends AbstractObjectParser<T> {
33+
public static final String TAG = "APIJSONObjectParser";
34+
35+
/**for single object
36+
* @param session
37+
* @param request
38+
* @param parentPath
39+
* @param arrayConfig
40+
* @param isSubquery
41+
* @param isTable
42+
* @param isArrayMainTable
43+
* @throws Exception
44+
*/
45+
public APIJSONObjectParser(HttpSession session, @NotNull JSONObject request, String parentPath, SQLConfig<T> arrayConfig
46+
, boolean isSubquery, boolean isTable, boolean isArrayMainTable) throws Exception {
47+
super(request, parentPath, arrayConfig, isSubquery, isTable, isArrayMainTable);
48+
}
49+
50+
@Override
51+
public APIJSONObjectParser<T> setMethod(RequestMethod method) {
52+
super.setMethod(method);
53+
return this;
54+
}
55+
56+
@Override
57+
public APIJSONObjectParser<T> setParser(Parser<T> parser) {
58+
super.setParser(parser);
59+
return this;
60+
}
61+
62+
63+
@Override
64+
public SQLConfig<T> newSQLConfig(RequestMethod method, String table, String alias, JSONObject request, List<Join> joinList, boolean isProcedure) throws Exception {
65+
return APIJSONSQLConfig.newSQLConfig(method, table, alias, request, joinList, isProcedure);
66+
}
67+
68+
69+
}

‎src/main/java/apijson/framework/javax/APIJSONParser.java

+176
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,176 @@
1+
/*Copyright ©2016 TommyLemon(https://github.com/TommyLemon/APIJSON)
2+
3+
Licensed under the Apache License, Version 2.0 (the "License");
4+
you may not use this file except in compliance with the License.
5+
You may obtain a copy of the License at
6+
7+
http://www.apache.org/licenses/LICENSE-2.0
8+
9+
Unless required by applicable law or agreed to in writing, software
10+
distributed under the License is distributed on an "AS IS" BASIS,
11+
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12+
See the License for the specific language governing permissions and
13+
limitations under the License.*/
14+
15+
package apijson.framework.javax;
16+
17+
import apijson.NotNull;
18+
import apijson.RequestMethod;
19+
import apijson.orm.*;
20+
import com.alibaba.fastjson.JSONObject;
21+
import javax.servlet.http.HttpSession;
22+
23+
import java.util.Map;
24+
import java.util.Set;
25+
26+
import static apijson.framework.javax.APIJSONConstant.*;
27+
28+
29+
/**请求解析器
30+
* @author Lemon
31+
*/
32+
public class APIJSONParser<T extends Object> extends AbstractParser<T> {
33+
public static final String TAG = "APIJSONParser";
34+
35+
@NotNull
36+
public static APIJSONCreator<? extends Object> APIJSON_CREATOR;
37+
static {
38+
APIJSON_CREATOR = new APIJSONCreator<>();
39+
}
40+
41+
42+
public APIJSONParser() {
43+
super();
44+
}
45+
public APIJSONParser(RequestMethod method) {
46+
super(method);
47+
}
48+
public APIJSONParser(RequestMethod method, boolean needVerify) {
49+
super(method, needVerify);
50+
}
51+
52+
private HttpSession session;
53+
public HttpSession getSession() {
54+
return session;
55+
}
56+
public APIJSONParser<T> setSession(HttpSession session) {
57+
this.session = session;
58+
setVisitor(APIJSONVerifier.getVisitor(session));
59+
return this;
60+
}
61+
62+
@SuppressWarnings("unchecked")
63+
@Override
64+
public Parser<T> createParser() {
65+
return (Parser<T>) APIJSON_CREATOR.createParser();
66+
}
67+
@Override
68+
public FunctionParser createFunctionParser() {
69+
return APIJSON_CREATOR.createFunctionParser();
70+
}
71+
72+
@SuppressWarnings("unchecked")
73+
@Override
74+
public Verifier<T> createVerifier() {
75+
return (Verifier<T>) APIJSON_CREATOR.createVerifier();
76+
}
77+
78+
@Override
79+
public SQLConfig createSQLConfig() {
80+
return APIJSON_CREATOR.createSQLConfig();
81+
}
82+
@Override
83+
public SQLExecutor createSQLExecutor() {
84+
return APIJSON_CREATOR.createSQLExecutor();
85+
}
86+
87+
88+
@Override
89+
public JSONObject parseResponse(JSONObject request) {
90+
//补充format
91+
if (session != null && request != null) {
92+
if (request.get(FORMAT) == null) {
93+
request.put(FORMAT, session.getAttribute(FORMAT));
94+
}
95+
if (request.get(DEFAULTS) == null) {
96+
JSONObject defaults = (JSONObject) session.getAttribute(DEFAULTS);
97+
Set<Map.Entry<String, Object>> set = defaults == null ? null : defaults.entrySet();
98+
99+
if (set != null) {
100+
for (Map.Entry<String, Object> e : set) {
101+
if (e != null && request.get(e.getKey()) == null) {
102+
request.put(e.getKey(), e.getValue());
103+
}
104+
}
105+
}
106+
}
107+
}
108+
return super.parseResponse(request);
109+
}
110+
111+
private FunctionParser functionParser;
112+
public FunctionParser getFunctionParser() {
113+
return functionParser;
114+
}
115+
@Override
116+
public Object onFunctionParse(String key, String function, String parentPath, String currentName, JSONObject currentObject, boolean containRaw) throws Exception {
117+
if (functionParser == null) {
118+
functionParser = createFunctionParser();
119+
functionParser.setParser(this);
120+
functionParser.setMethod(getMethod());
121+
functionParser.setTag(getTag());
122+
functionParser.setVersion(getVersion());
123+
functionParser.setRequest(requestObject);
124+
125+
if (functionParser instanceof APIJSONFunctionParser) {
126+
((APIJSONFunctionParser) functionParser).setSession(getSession());
127+
}
128+
}
129+
functionParser.setKey(key);
130+
functionParser.setParentPath(parentPath);
131+
functionParser.setCurrentName(currentName);
132+
functionParser.setCurrentObject(currentObject);
133+
134+
return functionParser.invoke(function, currentObject, containRaw);
135+
}
136+
137+
138+
@Override
139+
public APIJSONObjectParser<T> createObjectParser(JSONObject request, String parentPath, SQLConfig<T> arrayConfig
140+
, boolean isSubquery, boolean isTable, boolean isArrayMainTable) throws Exception {
141+
142+
return new APIJSONObjectParser<T>(getSession(), request, parentPath, arrayConfig, isSubquery, isTable, isArrayMainTable) {
143+
144+
// @Override
145+
// protected APIJSONSQLConfig newQueryConfig() {
146+
// if (itemConfig != null) {
147+
// return itemConfig;
148+
// }
149+
// return super.newQueryConfig();
150+
// }
151+
152+
// 导致最多评论的(Strong 30个)的那个动态详情界面Android(82001)无姓名和头像，即User=null
153+
// @Override
154+
// protected void onComplete() {
155+
// if (response != null) {
156+
// putQueryResult(path, response); // 解决获取关联数据时requestObject里不存在需要的关联数据
157+
// }
158+
// }
159+
160+
}.setMethod(getMethod()).setParser(this);
161+
}
162+
163+
164+
165+
@Override
166+
public void onVerifyContent() throws Exception {
167+
//补充全局缺省版本号 //可能在默认为1的前提下这个请求version就需要为0 requestObject.getIntValue(VERSION) <= 0) {
168+
HttpSession session = getSession();
169+
if (session != null && requestObject.get(VERSION) == null) {
170+
requestObject.put(VERSION, session.getAttribute(VERSION));
171+
}
172+
super.onVerifyContent();
173+
}
174+
175+
176+
}

‎src/main/java/apijson/framework/javax/APIJSONSQLConfig.java

+248
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,248 @@
1+
/*Copyright ©2016 TommyLemon(https://github.com/TommyLemon/APIJSON)
2+
3+
Licensed under the Apache License, Version 2.0 (the "License");
4+
you may not use this file except in compliance with the License.
5+
You may obtain a copy of the License at
6+
7+
http://www.apache.org/licenses/LICENSE-2.0
8+
9+
Unless required by applicable law or agreed to in writing, software
10+
distributed under the License is distributed on an "AS IS" BASIS,
11+
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12+
See the License for the specific language governing permissions and
13+
limitations under the License.*/
14+
15+
package apijson.framework.javax;
16+
17+
import apijson.RequestMethod;
18+
import apijson.column.ColumnUtil;
19+
import apijson.orm.AbstractSQLConfig;
20+
import apijson.orm.Join;
21+
import apijson.orm.SQLConfig;
22+
import com.alibaba.fastjson.JSONObject;
23+
import com.alibaba.fastjson.annotation.JSONField;
24+
25+
import java.util.List;
26+
27+
import static apijson.framework.javax.APIJSONConstant.*;
28+
29+
30+
/**SQL配置
31+
* TiDB 用法和 MySQL 一致
32+
* @author Lemon
33+
*/
34+
public class APIJSONSQLConfig<T extends Object> extends AbstractSQLConfig<T> {
35+
public static final String TAG = "APIJSONSQLConfig";
36+
37+
public static boolean ENABLE_COLUMN_CONFIG = false;
38+
39+
public static Callback<? extends Object> SIMPLE_CALLBACK;
40+
public static APIJSONCreator<? extends Object> APIJSON_CREATOR;
41+
42+
static {
43+
DEFAULT_DATABASE = DATABASE_MYSQL; //TODO 默认数据库类型，改成你自己的
44+
DEFAULT_SCHEMA = "sys"; //TODO 默认模式名，改成你自己的，默认情况是 MySQL: sys, PostgreSQL: public, SQL Server: dbo, Oracle:
45+
// TABLE_KEY_MAP.put(Access.class.getSimpleName(), "apijson_access");
46+
47+
// 由 APIJSONVerifier.init 方法读取数据库 Access 表来替代手动输入配置
48+
// //表名映射，隐藏真实表名，对安全要求很高的表可以这么做
49+
// TABLE_KEY_MAP.put(User.class.getSimpleName(), "apijson_user");
50+
// TABLE_KEY_MAP.put(Privacy.class.getSimpleName(), "apijson_privacy");
51+
52+
APIJSON_CREATOR = new APIJSONCreator<>();
53+
54+
SIMPLE_CALLBACK = new SimpleCallback<>() {
55+
56+
@Override
57+
public SQLConfig<Object> getSQLConfig(RequestMethod method, String database, String schema,String datasource, String table) {
58+
SQLConfig<Object> config = (SQLConfig<Object>) APIJSON_CREATOR.createSQLConfig();
59+
config.setMethod(method);
60+
config.setDatabase(database);
61+
config.setDatasource(datasource);
62+
config.setSchema(schema);
63+
config.setTable(table);
64+
return config;
65+
}
66+
67+
//取消注释来实现自定义各个表的主键名
68+
// @Override
69+
// public String getIdKey(String database, String schema, String datasource, String table) {
70+
// return StringUtil.firstCase(table + "Id"); // userId, comemntId ...
71+
// // return StringUtil.toLowerCase(t) + "_id"; // user_id, comemnt_id ...
72+
// // return StringUtil.toUpperCase(t) + "_ID"; // USER_ID, COMMENT_ID ...
73+
// }
74+
75+
@Override
76+
public String getUserIdKey(String database, String schema, String datasource, String table) {
77+
return USER_.equals(table) || PRIVACY_.equals(table) ? ID : USER_ID; // id / userId
78+
}
79+
80+
//取消注释来实现数据库自增 id
81+
// @Override
82+
// public Object newId(RequestMethod method, String database, String schema, String datasource, String table) {
83+
// return null; // return null 则不生成 id，一般用于数据库自增 id
84+
// }
85+
};
86+
87+
}
88+
89+
90+
91+
@Override
92+
public String getDBVersion() {
93+
if (isMySQL()) {
94+
return "5.7.22"; //"8.0.11"; //TODO 改成你自己的 MySQL 或 PostgreSQL 数据库版本号 //MYSQL 8 和 7 使用的 JDBC 配置不一样
95+
}
96+
if (isPostgreSQL()) {
97+
return "9.6.15"; //TODO 改成你自己的
98+
}
99+
if (isSQLServer()) {
100+
return "2016"; //TODO 改成你自己的
101+
}
102+
if (isOracle()) {
103+
return "18c"; //TODO 改成你自己的
104+
}
105+
return null;
106+
}
107+
108+
@JSONField(serialize = false) // 不在日志打印 账号/密码 等敏感信息，用了 UnitAuto 则一定要加
109+
@Override
110+
public String getDBUri() {
111+
if (isMySQL()) {
112+
return "jdbc:mysql://localhost:3306"; //TODO 改成你自己的，TiDB 可以当成 MySQL 使用，默认端口为 4000
113+
}
114+
if (isPostgreSQL()) {
115+
return "jdbc:postgresql://localhost:5432/postgres"; //TODO 改成你自己的
116+
}
117+
if (isSQLServer()) {
118+
return "jdbc:jtds:sqlserver://localhost:1433/pubs;instance=SQLEXPRESS"; //TODO 改成你自己的
119+
}
120+
if (isOracle()) {
121+
return "jdbc:oracle:thin:@localhost:1521:orcl"; //TODO 改成你自己的
122+
}
123+
return null;
124+
}
125+
126+
@JSONField(serialize = false) // 不在日志打印 账号/密码 等敏感信息，用了 UnitAuto 则一定要加
127+
@Override
128+
public String getDBAccount() {
129+
if (isMySQL()) {
130+
return "root"; //TODO 改成你自己的
131+
}
132+
if (isPostgreSQL()) {
133+
return "postgres"; //TODO 改成你自己的
134+
}
135+
if (isSQLServer()) {
136+
return "sa"; //TODO 改成你自己的
137+
}
138+
if (isOracle()) {
139+
return "scott"; //TODO 改成你自己的
140+
}
141+
return null;
142+
}
143+
144+
@JSONField(serialize = false) // 不在日志打印 账号/密码 等敏感信息，用了 UnitAuto 则一定要加
145+
@Override
146+
public String getDBPassword() {
147+
if (isMySQL()) {
148+
return "apijson"; //TODO 改成你自己的，TiDB 可以当成 MySQL 使用， 默认密码为空字符串 ""
149+
}
150+
if (isPostgreSQL()) {
151+
return null; //TODO 改成你自己的
152+
}
153+
if (isSQLServer()) {
154+
return "apijson@123"; //TODO 改成你自己的
155+
}
156+
if (isOracle()) {
157+
return "tiger"; //TODO 改成你自己的
158+
}
159+
return null;
160+
}
161+
162+
/**获取 APIJSON 配置表所在数据库模式 database，默认与业务表一块
163+
* @return
164+
*/
165+
public String getConfigDatabase() {
166+
return getDatabase();
167+
}
168+
/**获取 APIJSON 配置表所在数据库模式 schema，默认与业务表一块
169+
* @return
170+
*/
171+
public String getConfigSchema() {
172+
return getSchema();
173+
}
174+
/**是否为 APIJSON 配置表，如果和业务表一块，可以重写这个方法，固定 return false 来提高性能
175+
* @return
176+
*/
177+
public boolean isConfigTable() {
178+
return CONFIG_TABLE_LIST.contains(getTable());
179+
}
180+
@Override
181+
public String getSQLDatabase() {
182+
String db = isConfigTable() ? getConfigDatabase() : super.getSQLDatabase();
183+
return db == null ? DEFAULT_DATABASE : db;
184+
}
185+
@Override
186+
public String getSQLSchema() {
187+
String sch = isConfigTable() ? getConfigSchema() : super.getSQLSchema();
188+
return sch == null ? DEFAULT_SCHEMA : sch;
189+
}
190+
191+
192+
@Override
193+
public String getIdKey() {
194+
return SIMPLE_CALLBACK.getIdKey(getDatabase(), getSchema(), getDatasource(), getTable());
195+
}
196+
197+
@Override
198+
public String getUserIdKey() {
199+
return SIMPLE_CALLBACK.getUserIdKey(getDatabase(), getSchema(), getDatasource(), getTable());
200+
}
201+
202+
203+
public APIJSONSQLConfig() {
204+
this(RequestMethod.GET);
205+
}
206+
public APIJSONSQLConfig(RequestMethod method) {
207+
super(method);
208+
}
209+
public APIJSONSQLConfig(RequestMethod method, String table) {
210+
super(method, table);
211+
}
212+
public APIJSONSQLConfig(RequestMethod method, int count, int page) {
213+
super(method, count, page);
214+
}
215+
216+
217+
218+
/**获取SQL配置
219+
* @param table
220+
* @param alias
221+
* @param request
222+
* @param isProcedure
223+
* @return
224+
* @throws Exception
225+
*/
226+
public static <T extends Object> SQLConfig<T> newSQLConfig(RequestMethod method, String table, String alias, JSONObject request, List<Join> joinList, boolean isProcedure) throws Exception {
227+
return (SQLConfig<T>) newSQLConfig(method, table, alias, request, joinList, isProcedure, SIMPLE_CALLBACK);
228+
}
229+
230+
231+
// 支持 !key 反选字段 和 字段名映射，依赖插件 https://github.com/APIJSON/apijson-column
232+
@Override
233+
public AbstractSQLConfig<T> setColumn(List<String> column) {
234+
if (ENABLE_COLUMN_CONFIG) {
235+
column = ColumnUtil.compatInputColumn(column, getTable(), getMethod(), getVersion(), ! isConfigTable());
236+
}
237+
return super.setColumn(column);
238+
}
239+
240+
@Override
241+
public String getKey(String key) {
242+
if (ENABLE_COLUMN_CONFIG) {
243+
key = ColumnUtil.compatInputKey(key, getTable(), getMethod(), getVersion(), ! isConfigTable());
244+
}
245+
return super.getKey(key);
246+
}
247+
248+
}

‎src/main/java/apijson/framework/javax/APIJSONSQLExecutor.java

+109
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,109 @@
1+
/*Copyright ©2016 TommyLemon(https://github.com/TommyLemon/APIJSON)
2+
3+
Licensed under the Apache License, Version 2.0 (the "License");
4+
you may not use this file except in compliance with the License.
5+
You may obtain a copy of the License at
6+
7+
http://www.apache.org/licenses/LICENSE-2.0
8+
9+
Unless required by applicable law or agreed to in writing, software
10+
distributed under the License is distributed on an "AS IS" BASIS,
11+
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12+
See the License for the specific language governing permissions and
13+
limitations under the License.*/
14+
15+
package apijson.framework.javax;
16+
17+
import apijson.JSON;
18+
import apijson.Log;
19+
import apijson.NotNull;
20+
import apijson.column.ColumnUtil;
21+
import apijson.orm.AbstractSQLExecutor;
22+
import apijson.orm.SQLConfig;
23+
import com.alibaba.fastjson.JSONObject;
24+
import org.postgresql.util.PGobject;
25+
26+
import java.sql.PreparedStatement;
27+
import java.sql.ResultSet;
28+
import java.sql.ResultSetMetaData;
29+
import java.sql.SQLException;
30+
import java.util.Map;
31+
32+
33+
/**executor for query(read) or update(write) MySQL database
34+
* @author Lemon
35+
*/
36+
public class APIJSONSQLExecutor<T extends Object> extends AbstractSQLExecutor<T> {
37+
public static final String TAG = "APIJSONSQLExecutor";
38+
39+
static {
40+
try { //加载驱动程序
41+
Log.d(TAG, "尝试加载 MySQL 8 驱动 <<<<<<<<<<<<<<<<<<<<< ");
42+
Class.forName("com.mysql.cj.jdbc.Driver");
43+
Log.d(TAG, "成功加载 MySQL 8 驱动！>>>>>>>>>>>>>>>>>>>>>");
44+
}
45+
catch (ClassNotFoundException e) {
46+
Log.e(TAG, "加载 MySQL 8 驱动失败，请检查 pom.xml 中 mysql-connector-java 版本是否存在以及可用 ！！！");
47+
e.printStackTrace();
48+
49+
try { //加载驱动程序
50+
Log.d(TAG, "尝试加载 MySQL 7 及以下版本的 驱动 <<<<<<<<<<<<<<<<<<<<< ");
51+
Class.forName("com.mysql.jdbc.Driver");
52+
Log.d(TAG, "成功加载 MySQL 7 及以下版本的 驱动！>>>>>>>>>>>>>>>>>>>>> ");
53+
}
54+
catch (ClassNotFoundException e2) {
55+
Log.e(TAG, "加载 MySQL 7 及以下版本的 驱动失败，请检查 pom.xml 中 mysql-connector-java 版本是否存在以及可用 ！！！");
56+
e2.printStackTrace();
57+
}
58+
}
59+
60+
try { //加载驱动程序
61+
Log.d(TAG, "尝试加载 PostgresSQL 驱动 <<<<<<<<<<<<<<<<<<<<< ");
62+
Class.forName("org.postgresql.Driver");
63+
Log.d(TAG, "成功加载 PostgresSQL 驱动！>>>>>>>>>>>>>>>>>>>>> ");
64+
}
65+
catch (ClassNotFoundException e) {
66+
e.printStackTrace();
67+
Log.e(TAG, "加载 PostgresSQL 驱动失败，请检查 libs 目录中 postgresql.jar 版本是否存在以及可用 ！！！");
68+
}
69+
70+
}
71+
72+
73+
@Override
74+
public PreparedStatement setArgument(@NotNull SQLConfig<T> config, @NotNull PreparedStatement statement, int index, Object value) throws SQLException {
75+
if (config.isPostgreSQL() && JSON.isBooleanOrNumberOrString(value) == false) {
76+
PGobject o = new PGobject();
77+
o.setType("jsonb");
78+
o.setValue(value == null ? null : value.toString());
79+
statement.setObject(index + 1, o); //PostgreSQL 除了基本类型，其它的必须通过 PGobject 设置进去，否则 jsonb = varchar 等报错
80+
return statement;
81+
}
82+
83+
return super.setArgument(config, statement, index, value);
84+
}
85+
86+
87+
@Override
88+
protected Object getValue(SQLConfig<T> config, ResultSet rs, ResultSetMetaData rsmd, int tablePosition,
89+
JSONObject table, int columnIndex, String lable, Map<String, JSONObject> childMap) throws Exception {
90+
91+
Object value = super.getValue(config, rs, rsmd, tablePosition, table, columnIndex, lable, childMap);
92+
93+
return value instanceof PGobject ? JSON.parse(((PGobject) value).getValue()) : value;
94+
}
95+
96+
// 支持 !key 反选字段 和 字段名映射，依赖插件 https://github.com/APIJSON/apijson-column
97+
@Override
98+
protected String getKey(SQLConfig<T> config, ResultSet rs, ResultSetMetaData rsmd, int tablePosition, JSONObject table,
99+
int columnIndex, Map<String, JSONObject> childMap) throws Exception {
100+
101+
String key = super.getKey(config, rs, rsmd, tablePosition, table, columnIndex, childMap);
102+
if (APIJSONSQLConfig.ENABLE_COLUMN_CONFIG) {
103+
return ColumnUtil.compatOutputKey(key, config.getTable(), config.getMethod());
104+
}
105+
106+
return key;
107+
}
108+
109+
}

‎src/main/java/apijson/framework/javax/APIJSONVerifier.java

+651
Large diffs are not rendered by default.

‎src/main/java/apijson/framework/javax/AssertUtil.java

+21
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,21 @@
1+
/*Copyright ©2016 TommyLemon(https://github.com/TommyLemon/APIJSON)
2+
3+
Licensed under the Apache License, Version 2.0 (the "License");
4+
you may not use this file except in compliance with the License.
5+
You may obtain a copy of the License at
6+
7+
http://www.apache.org/licenses/LICENSE-2.0
8+
9+
Unless required by applicable law or agreed to in writing, software
10+
distributed under the License is distributed on an "AS IS" BASIS,
11+
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12+
See the License for the specific language governing permissions and
13+
limitations under the License.*/
14+
15+
package apijson.framework.javax;
16+
17+
18+
/**简单断言工具类，不用额外引入 JUnit 等库
19+
* @author Lemon
20+
*/
21+
public class AssertUtil extends apijson.framework.AssertUtil {}

‎src/main/java/apijson/framework/javax/BaseModel.java

+21
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,21 @@
1+
/*Copyright ©2016 TommyLemon(https://github.com/TommyLemon/APIJSON)
2+
3+
Licensed under the Apache License, Version 2.0 (the "License");
4+
you may not use this file except in compliance with the License.
5+
You may obtain a copy of the License at
6+
7+
http://www.apache.org/licenses/LICENSE-2.0
8+
9+
Unless required by applicable law or agreed to in writing, software
10+
distributed under the License is distributed on an "AS IS" BASIS,
11+
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12+
See the License for the specific language governing permissions and
13+
limitations under the License.*/
14+
15+
package apijson.framework.javax;
16+
17+
/**base model for reduce model codes
18+
* @author Lemon
19+
* @use extends BaseModel
20+
*/
21+
public abstract class BaseModel extends apijson.framework.BaseModel {}

‎src/main/java/apijson/framework/javax/package-info.java

+8
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,8 @@
1+
/**
2+
* 服务端框架，兼容 JDK 1.8~16，使用 javax.servlet
3+
*/
4+
/**
5+
* @author Lemon
6+
*
7+
*/
8+
package apijson.framework.javax;

0 commit comments

Comments
 (0)
Please sign in to comment.