RequestHandler.java 15 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406
  1. package org.ssssssss.magicapi.config;
  2. import com.fasterxml.jackson.databind.ObjectMapper;
  3. import org.apache.commons.io.IOUtils;
  4. import org.apache.commons.lang3.StringUtils;
  5. import org.slf4j.Logger;
  6. import org.slf4j.LoggerFactory;
  7. import org.springframework.core.io.InputStreamSource;
  8. import org.springframework.http.MediaType;
  9. import org.springframework.http.ResponseEntity;
  10. import org.springframework.http.converter.HttpMessageConverter;
  11. import org.springframework.http.server.ServletServerHttpRequest;
  12. import org.springframework.web.bind.annotation.PathVariable;
  13. import org.springframework.web.bind.annotation.RequestParam;
  14. import org.springframework.web.bind.annotation.ResponseBody;
  15. import org.springframework.web.context.request.RequestContextHolder;
  16. import org.ssssssss.magicapi.context.CookieContext;
  17. import org.ssssssss.magicapi.context.HeaderContext;
  18. import org.ssssssss.magicapi.context.RequestContext;
  19. import org.ssssssss.magicapi.context.SessionContext;
  20. import org.ssssssss.magicapi.functions.ResponseFunctions;
  21. import org.ssssssss.magicapi.logging.MagicLoggerContext;
  22. import org.ssssssss.magicapi.model.JsonBean;
  23. import org.ssssssss.magicapi.model.JsonBodyBean;
  24. import org.ssssssss.magicapi.provider.ResultProvider;
  25. import org.ssssssss.magicapi.script.ScriptManager;
  26. import org.ssssssss.script.MagicScript;
  27. import org.ssssssss.script.MagicScriptContext;
  28. import org.ssssssss.script.MagicScriptDebugContext;
  29. import org.ssssssss.script.exception.MagicScriptAssertException;
  30. import org.ssssssss.script.exception.MagicScriptException;
  31. import org.ssssssss.script.functions.ObjectConvertExtension;
  32. import org.ssssssss.script.parsing.Span;
  33. import javax.script.ScriptContext;
  34. import javax.script.SimpleScriptContext;
  35. import javax.servlet.http.HttpServletRequest;
  36. import javax.servlet.http.HttpServletResponse;
  37. import java.io.IOException;
  38. import java.io.InputStream;
  39. import java.util.*;
  40. import java.util.stream.Collectors;
  41. public class RequestHandler {
  42. private static Logger logger = LoggerFactory.getLogger(RequestHandler.class);
  43. /**
  44. * 请求拦截器
  45. */
  46. private List<RequestInterceptor> requestInterceptors = new ArrayList<>();
  47. /**
  48. * 请求出错时,是否抛出异常
  49. */
  50. private boolean throwException = false;
  51. /**
  52. * 结果处理器
  53. */
  54. private ResultProvider resultProvider;
  55. private WebUIController webUIController;
  56. private final String HEADER_REQUEST_SESSION = "Magic-Request-Session";
  57. private final String HEADER_REQUEST_BREAKPOINTS = "Magic-Request-Breakpoints";
  58. private final String HEADER_REQUEST_CONTINUE = "Magic-Request-Continue";
  59. private final String HEADER_REQUEST_STEP_INTO = "Magic-Request-Step-Into";
  60. private final String HEADER_RESPONSE_WITH_MAGIC_API = "Response-With-Magic-API";
  61. /**
  62. * debug 超时时间
  63. */
  64. private int debugTimeout;
  65. public void setDebugTimeout(int debugTimeout) {
  66. this.debugTimeout = debugTimeout;
  67. }
  68. public void setWebUIController(WebUIController webUIController) {
  69. this.webUIController = webUIController;
  70. }
  71. public void setResultProvider(ResultProvider resultProvider) {
  72. this.resultProvider = resultProvider;
  73. }
  74. public void addRequestInterceptor(RequestInterceptor requestInterceptor) {
  75. requestInterceptors.add(requestInterceptor);
  76. }
  77. public void setThrowException(boolean throwException) {
  78. this.throwException = throwException;
  79. }
  80. private List<HttpMessageConverter<?>> httpMessageConverters;
  81. public void setHttpMessageConverters(List<HttpMessageConverter<?>> httpMessageConverters) {
  82. this.httpMessageConverters = httpMessageConverters;
  83. }
  84. /**
  85. * 打印banner
  86. */
  87. public void printBanner() {
  88. System.out.println(" __ __ _ _ ____ ___ ");
  89. System.out.println(" | \\/ | __ _ __ _ (_) ___ / \\ | _ \\|_ _|");
  90. System.out.println(" | |\\/| | / _` | / _` || | / __| / _ \\ | |_) || | ");
  91. System.out.println(" | | | || (_| || (_| || || (__ / ___ \\ | __/ | | ");
  92. System.out.println(" |_| |_| \\__,_| \\__, ||_| \\___|/_/ \\_\\|_| |___|");
  93. System.out.println(" |___/ " + RequestHandler.class.getPackage().getImplementationVersion());
  94. }
  95. @ResponseBody
  96. public Object invoke(HttpServletRequest request, HttpServletResponse response,
  97. @PathVariable(required = false) Map<String, Object> pathVariables,
  98. @RequestParam(required = false) Map<String, Object> parameters) throws Throwable {
  99. boolean requestedFromTest = isRequestedFromTest(request);
  100. ApiInfo info = MappingHandlerMapping.getMappingApiInfo(request);
  101. if (requestedFromTest) {
  102. if (!webUIController.allowVisit(request, RequestInterceptor.Authorization.RUN)) {
  103. return new JsonBean<>(-10, "无权限执行测试方法");
  104. }
  105. }
  106. if (info == null) {
  107. logger.error("接口不存在");
  108. return resultProvider.buildResult(1001, "fail", "接口不存在");
  109. }
  110. MagicScriptContext context = createMagicScriptContext(info, request, pathVariables, parameters);
  111. Object value;
  112. // 执行前置拦截器
  113. if ((value = doPreHandle(info, context)) != null) {
  114. return value;
  115. }
  116. if (requestedFromTest) {
  117. if (isRequestedFromContinue(request)) {
  118. return invokeContinueRequest(request, response);
  119. }
  120. return invokeTestRequest(info, (MagicScriptDebugContext) context, request, response);
  121. }
  122. return invokeRequest(info, context, request, response);
  123. }
  124. private Object invokeContinueRequest(HttpServletRequest request, HttpServletResponse response) throws IOException {
  125. String sessionId = getRequestedSessionId(request);
  126. MagicScriptDebugContext context = MagicScriptDebugContext.getDebugContext(sessionId);
  127. response.addHeader(HEADER_RESPONSE_WITH_MAGIC_API, "true");
  128. if (context == null) {
  129. return new JsonBean<>(0, "debug session not found!", resultProvider.buildResult(0, "debug session not found!"));
  130. }
  131. // 重置断点
  132. context.setBreakpoints(getRequestedBreakpoints(request));
  133. // 步进
  134. context.setStepInto("1".equalsIgnoreCase(request.getHeader(HEADER_REQUEST_STEP_INTO)));
  135. try {
  136. context.singal(); //等待语句执行到断点或执行完毕
  137. } catch (InterruptedException e) {
  138. e.printStackTrace();
  139. }
  140. if (context.isRunning()) { //判断是否执行完毕
  141. return new JsonBodyBean<>(1000, context.getId(), resultProvider.buildResult(1000, context.getId()), context.getDebugInfo());
  142. } else if (context.isException()) {
  143. return resolveThrowable((Throwable) context.getReturnValue(), response);
  144. }
  145. return convertResult(context.getReturnValue(), response);
  146. }
  147. private Object invokeTestRequest(ApiInfo info, MagicScriptDebugContext context, HttpServletRequest request, HttpServletResponse response) {
  148. try {
  149. // 初始化debug操作
  150. initializeDebug(context, request, response);
  151. Object result = executeScript(info.getScript(), context);
  152. response.addHeader(HEADER_RESPONSE_WITH_MAGIC_API, "true");
  153. if (context.isRunning()) {
  154. return new JsonBodyBean<>(1000, context.getId(), resultProvider.buildResult(1000, context.getId(), result), result);
  155. } else if (context.isException()) { //判断是否出现异常
  156. return resolveThrowable((Throwable) context.getReturnValue(), response);
  157. }
  158. Object value = result;
  159. // 执行后置拦截器
  160. if ((value = doPostHandle(info, context, value)) != null) {
  161. return convertResult(value, response);
  162. }
  163. return convertResult(result, response);
  164. } catch (Exception e) {
  165. return resolveThrowable(e, response);
  166. }
  167. }
  168. private Object invokeRequest(ApiInfo info, MagicScriptContext context, HttpServletRequest request, HttpServletResponse response) throws Throwable {
  169. try {
  170. RequestContext.setRequestAttribute(request, response);
  171. Object result = executeScript(info.getScript(), context);
  172. Object value = result;
  173. // 执行后置拦截器
  174. if ((value = doPostHandle(info, context, value)) != null) {
  175. return value;
  176. }
  177. // 对返回结果包装处理
  178. return response(result);
  179. } catch (Throwable root) {
  180. if (throwException) {
  181. throw root;
  182. }
  183. logger.error("接口请求出错", root);
  184. return response(root);
  185. } finally {
  186. RequestContext.remove();
  187. }
  188. }
  189. /**
  190. * 执行脚本
  191. */
  192. private Object executeScript(String script, MagicScriptContext context) {
  193. SimpleScriptContext simpleScriptContext = new SimpleScriptContext();
  194. simpleScriptContext.setAttribute(MagicScript.CONTEXT_ROOT, context, ScriptContext.ENGINE_SCOPE);
  195. // 执行脚本
  196. return ScriptManager.compile("MagicScript", script).eval(simpleScriptContext);
  197. }
  198. /**
  199. * 转换请求结果
  200. */
  201. private Object convertResult(Object result, HttpServletResponse response) throws IOException {
  202. if (result instanceof ResponseEntity) {
  203. ResponseEntity entity = (ResponseEntity) result;
  204. for (Map.Entry<String, List<String>> entry : entity.getHeaders().entrySet()) {
  205. String key = entry.getKey();
  206. for (String value : entry.getValue()) {
  207. response.addHeader("MA-" + key, value);
  208. }
  209. }
  210. if (entity.getHeaders().isEmpty()) {
  211. return ResponseEntity.ok(new JsonBean<>(entity.getBody()));
  212. }
  213. return ResponseEntity.ok(new JsonBean<>(convertToBase64(entity.getBody())));
  214. } else if (result instanceof ResponseFunctions.NullValue) {
  215. return new JsonBean<>(1, "empty.");
  216. }
  217. return new JsonBean<>(resultProvider.buildResult(result));
  218. }
  219. /**
  220. * 将结果转为base64
  221. */
  222. private String convertToBase64(Object value) throws IOException {
  223. if (value instanceof String || value instanceof Number) {
  224. return convertToBase64(value.toString().getBytes());
  225. } else if (value instanceof byte[]) {
  226. return Base64.getEncoder().encodeToString((byte[]) value);
  227. } else if (value instanceof InputStream) {
  228. return convertToBase64(IOUtils.toByteArray((InputStream) value));
  229. } else if (value instanceof InputStreamSource) {
  230. InputStreamSource iss = (InputStreamSource) value;
  231. return convertToBase64(iss.getInputStream());
  232. } else {
  233. return convertToBase64(new ObjectMapper().writeValueAsString(value));
  234. }
  235. }
  236. /**
  237. * 解决异常
  238. */
  239. private JsonBean<Object> resolveThrowable(Throwable root, HttpServletResponse response) {
  240. MagicScriptException se = null;
  241. Throwable parent = root;
  242. do {
  243. if (parent instanceof MagicScriptAssertException) {
  244. MagicScriptAssertException sae = (MagicScriptAssertException) parent;
  245. return new JsonBean<>(resultProvider.buildResult(sae.getCode(), sae.getMessage()));
  246. }
  247. if (parent instanceof MagicScriptException) {
  248. se = (MagicScriptException) parent;
  249. }
  250. } while ((parent = parent.getCause()) != null);
  251. logger.error("测试脚本出错", root);
  252. if (se != null) {
  253. Span.Line line = se.getLine();
  254. return new JsonBodyBean<>(-1000, se.getSimpleMessage(), resultProvider.buildResult(-1000, se.getSimpleMessage()), line == null ? null : Arrays.asList(line.getLineNumber(), line.getEndLineNumber(), line.getStartCol(), line.getEndCol()));
  255. }
  256. return new JsonBean<>(-1, root.getMessage(), resultProvider.buildResult(-1, root.getMessage()));
  257. }
  258. private void initializeDebug(MagicScriptDebugContext context, HttpServletRequest request, HttpServletResponse response) {
  259. RequestContextHolder.setRequestAttributes(RequestContextHolder.getRequestAttributes(), true);
  260. String sessionId = getRequestedSessionId(request);
  261. // 设置断点
  262. context.setBreakpoints(getRequestedBreakpoints(request));
  263. context.setTimeout(this.debugTimeout);
  264. context.setId(sessionId);
  265. context.onComplete(() -> {
  266. logger.info("Close Console Session : {}", sessionId);
  267. RequestContext.remove();
  268. MagicLoggerContext.remove(sessionId);
  269. });
  270. context.onStart(() -> {
  271. RequestContext.setRequestAttribute(request, response);
  272. MagicLoggerContext.SESSION.set(sessionId);
  273. logger.info("Create Console Session : {}", sessionId);
  274. });
  275. }
  276. private boolean isRequestedFromTest(HttpServletRequest request) {
  277. return webUIController != null && request.getHeader(HEADER_REQUEST_SESSION) != null;
  278. }
  279. private boolean isRequestedFromContinue(HttpServletRequest request) {
  280. return request.getHeader(HEADER_REQUEST_CONTINUE) != null;
  281. }
  282. private String getRequestedSessionId(HttpServletRequest request) {
  283. return request.getHeader(HEADER_REQUEST_SESSION);
  284. }
  285. private List<Integer> getRequestedBreakpoints(HttpServletRequest request) {
  286. String breakpoints = request.getHeader(HEADER_REQUEST_BREAKPOINTS);
  287. if (breakpoints != null) {
  288. return Arrays.stream(breakpoints.split(","))
  289. .map(val -> ObjectConvertExtension.asInt(val, -1))
  290. .collect(Collectors.toList());
  291. }
  292. return null;
  293. }
  294. private Object readRequestBody(HttpServletRequest request) throws IOException {
  295. if (httpMessageConverters != null && request.getContentType() != null) {
  296. MediaType mediaType = MediaType.valueOf(request.getContentType());
  297. Class clazz = Map.class;
  298. for (HttpMessageConverter<?> converter : httpMessageConverters) {
  299. if (converter.canRead(clazz, mediaType)) {
  300. return converter.read(clazz, new ServletServerHttpRequest(request));
  301. }
  302. }
  303. }
  304. return null;
  305. }
  306. /**
  307. * 构建 MagicScriptContext
  308. */
  309. private MagicScriptContext createMagicScriptContext(ApiInfo info, HttpServletRequest request, Map<String, Object> pathVariables, Map<String, Object> parameters) throws IOException {
  310. // 构建脚本上下文
  311. MagicScriptContext context = isRequestedFromTest(request) ? new MagicScriptDebugContext() : new MagicScriptContext();
  312. Object wrap = info.getOptionValue(ApiInfo.WRAP_REQUEST_PARAMETER);
  313. if (wrap != null && StringUtils.isNotBlank(wrap.toString())) {
  314. context.set(wrap.toString(), parameters);
  315. }
  316. context.putMapIntoContext(parameters);
  317. context.putMapIntoContext(pathVariables);
  318. context.set("cookie", new CookieContext(request));
  319. context.set("header", new HeaderContext(request));
  320. context.set("session", new SessionContext(request.getSession()));
  321. context.set("path", pathVariables);
  322. Object requestBody = readRequestBody(request);
  323. if (requestBody != null) {
  324. context.set("body", requestBody);
  325. }
  326. return context;
  327. }
  328. /**
  329. * 包装返回结果
  330. */
  331. private Object response(Object value) {
  332. if (value instanceof ResponseEntity) {
  333. return value;
  334. } else if (value instanceof ResponseFunctions.NullValue) {
  335. return null;
  336. }
  337. return resultProvider.buildResult(value);
  338. }
  339. /**
  340. * 执行后置拦截器
  341. */
  342. private Object doPostHandle(ApiInfo info, MagicScriptContext context, Object value) throws Exception {
  343. for (RequestInterceptor requestInterceptor : requestInterceptors) {
  344. Object target = requestInterceptor.postHandle(info, context, value);
  345. if (target != null) {
  346. return target;
  347. }
  348. }
  349. return null;
  350. }
  351. /**
  352. * 执行前置拦截器
  353. */
  354. private Object doPreHandle(ApiInfo info, MagicScriptContext context) throws Exception {
  355. for (RequestInterceptor requestInterceptor : requestInterceptors) {
  356. Object value = requestInterceptor.preHandle(info, context);
  357. if (value != null) {
  358. return value;
  359. }
  360. }
  361. return null;
  362. }
  363. }