增加代码模板

Author: HGthecode

src/Controller.php

@@ -4,6 +4,7 @@
 namespace hg\apidoc;
 
 use hg\apidoc\parses\ParseApiDetail;
+use hg\apidoc\parses\ParseCodeTemplate;
 use hg\apidoc\parses\ParseApiMenus;
 use hg\apidoc\parses\ParseMarkdown;
 use hg\apidoc\utils\Cache;
@@ -255,4 +256,18 @@ public function createAllCache(){
         return Helper::showJson(0,"",true);
     }
 
+    public function renderCodeTemplate(){
+        $this->init(true);
+        $config = $this->config;
+        $params = $this->requestParams;
+
+        $code = (new ParseCodeTemplate($config))->renderCode($params);
+
+        return Helper::showJson(0,"",[
+            'code'=>$code
+        ]);
+
+    }
+
+
 }

src/parses/ParseApiDetail.php

@@ -689,7 +689,7 @@ protected function handleParamAndReturned($params,$annotation,$type="param",$ena
                 $param['children'][] = [
                     'children' => $children['params'],
                     'name'   => !empty($annotation->childrenField)?$annotation->childrenField:"children",
-                    'type'   => 'array',
+                    'type'   => 'array<object>',
                     'desc'   => Lang::getLang($annotation->childrenDesc),
                 ];
             }

src/parses/ParseApiMenus.php

@@ -177,7 +177,7 @@ protected function scanDir($dir) {
         return $list;
     }
 
-    protected function parseController($class)
+    public function parseController($class)
     {
 
         $data                 = [];
@@ -194,6 +194,7 @@ protected function parseController($class)
         $controllersNameArr = explode("\\", $class);
         $controllersName    = $controllersNameArr[count($controllersNameArr) - 1];
         $data['controller'] = $controllersName;
+        $data['path'] = $class;
         $data['group']      = !empty($group->value) ? $group->value : null;
         $data['sort']      = !empty($sort->value) ? $sort->value : null;
         if (!empty($data['group']) && !in_array($data['group'], $this->groups)) {

src/parses/ParseCodeTemplate.php

@@ -0,0 +1,104 @@
+<?php
+declare(strict_types = 1);
+
+namespace hg\apidoc\parses;
+
+use Doctrine\Common\Annotations\AnnotationReader;
+use hg\apidoc\exception\ErrorException;
+use hg\apidoc\generator\ParseTemplate;
+use hg\apidoc\utils\DirAndFile;
+use hg\apidoc\utils\Helper;
+use hg\apidoc\utils\Lang;
+
+class ParseCodeTemplate
+{
+
+    protected $config = [];
+
+    protected $currentApp = [];
+
+
+    public function __construct($config)
+    {
+
+        $this->config = $config;
+    }
+
+    public function renderCode($params)
+    {
+        $appKey = $params['appKey'];
+        $currentAppConfig = Helper::getCurrentAppConfig($appKey);
+        $currentApp = $currentAppConfig['appConfig'];
+        $this->currentApp  = $currentApp;
+
+        $codeTemplate = $params['template'];
+
+        //验证参数
+
+        //验证模板文件是否存在
+
+        //解析接口数据
+        $tplData = [];
+        if ($codeTemplate['select_mode'] == 'controller'){
+            $parseApiMenusService = new ParseApiMenus($this->config);
+            $controllers = $params['selected'];
+            if (!empty($controllers) && count($controllers) > 0) {
+                $controllerList = [];
+                foreach ($controllers as $class) {
+                    $classData = $parseApiMenusService->parseController($class);
+                    if ($classData !== false) {
+                        $controllerList[] = $classData;
+                    }
+                }
+                if (empty($codeTemplate['multiple'])){
+                    $tplData = $controllerList[0];
+                }else{
+                    $tplData = $controllerList;
+                }
+            }
+        }else{
+            // api
+            $apis = $params['selected'];
+            if (!empty($apis) && count($apis) > 0) {
+                $parseApiDetailService = new ParseApiDetail($this->config);
+                $apiList = [];
+                foreach ($apis as $key) {
+                    $apiKey = urldecode($key);
+                    $pathArr   = explode("@", $apiKey);
+                    $classPath = $pathArr[0];
+                    $method = $pathArr[1];
+
+                    $apiDetail = $parseApiDetailService->renderApiDetail($appKey,$classPath,$method);
+                    if ($apiDetail !== false) {
+                        $apiList[] = $apiDetail;
+                    }
+                }
+                if (empty($codeTemplate['multiple'])){
+                    $tplData = $apiList[0];
+                }else{
+                    $tplData = $apiList;
+                }
+            }
+        }
+
+
+        // 读取模板
+        $templatePath =DirAndFile::formatPath( APIDOC_ROOT_PATH . $codeTemplate['template'],"/");
+        if (is_readable($templatePath) == false) {
+            throw new ErrorException("template not found",  [
+                'template' => $template
+            ]);
+        }
+        $tplParams = [
+            'form'=>  $params['form'],
+            'data'=>$tplData
+        ];
+        $html = (new ParseTemplate())->compile($templatePath,$tplParams);
+
+
+
+        return $html;
+    }
+
+
+}

src/providers/CommonService.php

@@ -18,6 +18,7 @@ trait CommonService
         ['rule'=>'generator','route'=>'createGenerator','method'=>'POST'],
         ['rule'=>'cancelAllCache','route'=>'cancelAllCache','method'=>'POST'],
         ['rule'=>'createAllCache','route'=>'createAllCache','method'=>'POST'],
+        ['rule'=>'renderCodeTemplate','route'=>'renderCodeTemplate','method'=>'POST'],
     ];
 
 

src/utils/ConfigProvider.php

@@ -49,6 +49,7 @@ public static function getFeConfig(){
             'params'=>!empty($config['params'])?$config['params']:[],
             'responses'=>!empty($config['responses'])?$config['responses']:[],
             'generator'=>!empty($config['generator'])?$config['generator']:[],
+            'code_template'=>!empty($config['code_template'])?$config['code_template']:[],
         ];
         if (!empty($feConfig['apps']) && count($feConfig['apps'])){
             // 清除apps配置中的password