マイクロサービスプロジェクト: Shang Rongbao (17) (バックエンド構築: データディクショナリ)

空想を捨て、現実を認識し、戦う準備をする

 必要

1.データ辞書とは

データ ディクショナリとは データ ディクショナリは、システムで一般的に使用される機密データまたは固定データの管理を担当します。たとえば、地方および都市の 3 レベル リンケージ データ、民族データ、産業データ、教育データなどです。データ ディクショナリは、これらの一般的なデータを取得して適用します。

第二に、データディクショナリの設計

  • たとえば、すべての業界データを取得したい場合は、parent_id=20000 のデータを照会するだけで済みます。
  • 名前: 名前、例: ユーザー情報を入力します。ラベルを選択して国籍を選択する必要があります。「漢民族」はデータ ディクショナリの名前です。
  • 値: 値、例: ユーザー情報を入力します。ラベルを選択して国籍を選択します。「1」(漢民族の識別) はデータ ディクショナリの値です。
  • dict_code: エンコーディング。エンコーディングはカスタマイズされており、グローバルに一意です。たとえば、業界データを取得したい場合、parent_id を介して取得できますが、parent_id は不明であるため、コードに従って業界データを取得できます。

この設定により、複数のテーブルの長さの超過が回避されます

 Excelデータ一括インポート

1.依存関係を追加する

次の依存関係をコアに追加します

<dependency>
    <groupId>com.alibaba</groupId>
    <artifactId>easyexcel</artifactId>
</dependency>

<dependency>
    <groupId>org.apache.xmlbeans</groupId>
    <artifactId>xmlbeans</artifactId>
</dependency>

2.Excel エンティティ クラスを作成する 

@Data
public class ExcelDictDTO {

    @ExcelProperty("id")
    private Long id;

    @ExcelProperty("上级id")
    private Long parentId;

    @ExcelProperty("名称")
    private String name;

    @ExcelProperty("值")
    private Integer value;

    @ExcelProperty("编码")
    private String dictCode;
}

3.リスナーを作成する 

@Slf4j
//@AllArgsConstructor //全参
@NoArgsConstructor //无参
public class ExcelDictDTOListener extends AnalysisEventListener<ExcelDictDTO> {

    /**
     * 每隔5条存储数据库,实际使用中可以3000条,然后清理list ,方便内存回收
     */
    private static final int BATCH_COUNT = 5;
    List<ExcelDictDTO> list = new ArrayList();

    private DictMapper dictMapper;

	//传入mapper对象
    public ExcelDictDTOListener(DictMapper dictMapper) {
        this.dictMapper = dictMapper;
    }

    /**
     *遍历每一行的记录
     * @param data
     * @param context
     */
    @Override
    public void invoke(ExcelDictDTO data, AnalysisContext context) {
        log.info("解析到一条记录: {}", data);
        list.add(data);
        // 达到BATCH_COUNT了,需要去存储一次数据库,防止数据几万条数据在内存,容易OOM
        if (list.size() >= BATCH_COUNT) {
            saveData();
            // 存储完成清理 list
            list.clear();
        }
    }

    /**
     * 所有数据解析完成了 都会来调用
     */
    @Override
    public void doAfterAllAnalysed(AnalysisContext context) {
        // 这里也要保存数据,确保最后遗留的数据也存储到数据库
        saveData();
        log.info("所有数据解析完成!");
    }

    /**
     * 加上存储数据库
     */
    private void saveData() {
        log.info("{}条数据,开始存储数据库!", list.size());
        dictMapper.insertBatch(list);  //批量插入
        log.info("存储数据库成功!");
    }
}

4.Mapperレイヤーの一括挿入

インターフェース: DictMapper

void importData(InputStream inputStream);

実装: DictServiceImpl 

@Transactional(rollbackFor = {Exception.class})
@Override
public void importData(InputStream inputStream) {
    // 这里 需要指定读用哪个class去读,然后读取第一个sheet 文件流会自动关闭
    EasyExcel.read(inputStream, ExcelDictDTO.class, new ExcelDictDTOListener(baseMapper)).sheet().doRead();
    log.info("importData finished");
}

注: トランザクション処理がここに追加されます。デフォルトでは、rollbackFor = RuntimeException.class です。エラーまたは異常な状況が発生した後、時間内にロールバックできることを保証できます。誤ったデータを避ける

6. コントローラー層はクライアントのアップロードを受け取ります

AdminDictController

@Api(tags = "数据字典管理")
@RestController
@RequestMapping("/admin/core/dict")
@Slf4j
@CrossOrigin
public class AdminDictController {

    @Resource
    private DictService dictService;

    @ApiOperation("Excel批量导入数据字典")
    @PostMapping("/import")
    public R batchImport(
            @ApiParam(value = "Excel文件", required = true)
            @RequestParam("file") MultipartFile file) {

        try {
            InputStream inputStream = file.getInputStream();
            dictService.importData(inputStream);
            return R.ok().message("批量导入成功");
        } catch (Exception e) {
            //UPLOAD_ERROR(-103, "文件上传错误"),
            throw new BusinessException(ResponseEnum.UPLOAD_ERROR, e);
        }
    }
}

7. マッパーのリリース構成を追加する

注: Maven プロジェクトの src/main/java ディレクトリにあるすべてのリソース ファイルは、デフォルトではターゲット ディレクトリに公開されないため、xml 構成ファイルのリリース構成を pom.xml に追加する必要があります。

<build>
    <!-- 项目打包时会将java目录中的*.xml文件也进行打包 -->
    <resources>
        <resource>
            <directory>src/main/java</directory>
            <includes>
                <include>**/*.xml</include>
            </includes>
            <filtering>false</filtering>
        </resource>
    </resources>
</build>

第二に、フロントエンドコール

1. ページ コンポーネントを作成する

src/views/core/dict/list.vue を作成します

<template>
  <div class="app-container">
    
  </div>
</template>

<script>
export default {
  
}
</script>

2.ルーティングを構成する 

{
    path: '/core',
    component: Layout,
    redirect: '/core/dict/list',
    name: 'coreDict',
    meta: { title: '系统设置', icon: 'el-icon-setting' },
    alwaysShow: true,
    children: [
      {
        path: 'dict/list',
        name: '数据字典',
        component: () => import('@/views/core/dict/list'),
        meta: { title: '数据字典' }
      }
    ]
},

3.データインポートを実装する 

<template>
  <div class="app-container">
    <div style="margin-bottom: 10px;">
      <el-button
        @click="dialogVisible = true"
        type="primary"
        size="mini"
        icon="el-icon-download"
      >
        导入Excel
      </el-button>

      <el-button
    @click="exportData"
    type="primary"
    size="mini"
    icon="el-icon-upload2" >导出Excel</el-button>
    </div>

    <el-dialog title="数据字典导入" :visible.sync="dialogVisible" width="30%">
      <el-form>
        <el-form-item label="请选择Excel文件">
          <el-upload
            :auto-upload="true"
            :multiple="false"
            :limit="1"
            :on-exceed="fileUploadExceed"
            :on-success="fileUploadSuccess"
            :on-error="fileUploadError"
            :action="BASE_API + '/admin/core/dict/import'"
            name="file"
            accept="application/vnd.ms-excel,application/vnd.openxmlformats-officedocument.spreadsheetml.sheet"
          >
        
            <el-button size="small" type="primary">点击上传</el-button>
          </el-upload>
        </el-form-item>
      </el-form>                                                                                                                                                                                           
      <div slot="footer" class="dialog-footer">
        <el-button @click="dialogVisible = false">
          取消
        </el-button>
      </div>
    </el-dialog>
    <el-table :data="list" border row-key="id" lazy :load="load">
    <el-table-column label="名称" align="left" prop="name" />
    <el-table-column label="编码" prop="dictCode" />
    <el-table-column label="值" align="left" prop="value" />
</el-table>
  </div>
  
</template>

<script>
import dictApi from '@/api/core/dict'
export default {



  created() {
    console.log("123231231")
    this.fetchData()
},


  // 定义数据
  data() {
    
    return {
     
      dialogVisible: false, //文件上传对话框是否显示
      BASE_API: process.env.VUE_APP_BASE_API ,//获取后端接口地址
      list: [],//数据字典列表
    }
  },
  

  methods: {
    // 调用api层获取数据库中的数据
fetchData() {
  dictApi.listByParentId(1).then(response => {
     console.log("8888888888")
    this.list = response.data.list
  })
},
//延迟加载子节点
getChildren(row, treeNode, resolve) {
  dictApi.listByParentId(row.id).then(response => {
    //负责将子节点数据展示在展开的列表中  
    resolve(response.data.list)
  })
},
    // 上传多于一个文件时
    fileUploadExceed() {
      this.$message.warning('只能选取一个文件')
    },

//上传成功回调
fileUploadSuccess(response) {
    if (response.code === 0) {
        this.$message.success('数据导入成功')
        this.dialogVisible = false
        this.fetchData()
    } else {
        this.$message.error(response.message)
    }
},

    //上传失败回调
    fileUploadError(error) {
      this.$message.error('数据导入失败')
    },
    //Excel数据导出
exportData() {
    window.location.href = this.BASE_API + '/admin/core/dict/export'
},
//加载节点
load(tree,treeNode,resolve){
    //获取数据
    dictApi.listByParentId(tree.id).then(response => {
    resolve(response.data.list)
  })
  }
  }

}

</script>

Excelデータ一括エクスポート 

1. サービス レイヤーが Excel データを解析する

インターフェース: DictService

List<ExcelDictDTO> listDictData();

実装: DictServiceImpl 

@Override
public List<ExcelDictDTO> listDictData() {

    List<Dict> dictList = baseMapper.selectList(null);
    //创建ExcelDictDTO列表,将Dict列表转换成ExcelDictDTO列表
    ArrayList<ExcelDictDTO> excelDictDTOList = new ArrayList<>(dictList.size());
    dictList.forEach(dict -> {

        ExcelDictDTO excelDictDTO = new ExcelDictDTO();
        BeanUtils.copyProperties(dict, excelDictDTO);
        excelDictDTOList.add(excelDictDTO);
    });
    return excelDictDTOList;
}

 2. コントローラー層がクライアント要求を受け取る

@ApiOperation("Excel数据的导出")
@GetMapping("/export")
public void export(HttpServletResponse response){
    
    try {
        // 这里注意 有同学反应使用swagger 会导致各种问题,请直接用浏览器或者用postman
        response.setContentType("application/vnd.ms-excel");
        response.setCharacterEncoding("utf-8");
        // 这里URLEncoder.encode可以防止中文乱码 当然和easyexcel没有关系
        String fileName = URLEncoder.encode("mydict", "UTF-8").replaceAll("\\+", "%20");
        response.setHeader("Content-disposition", "attachment;filename*=utf-8''" + fileName + ".xlsx");
        EasyExcel.write(response.getOutputStream(), ExcelDictDTO.class).sheet("数据字典").doWrite(dictService.listDictData());

    } catch (IOException e) {
        //EXPORT_DATA_ERROR(104, "数据导出失败"),
        throw  new BusinessException(ResponseEnum.EXPORT_DATA_ERROR, e);
    }    
}

第二に、フロントエンドコール

1. ページにエクスポート ボタンを追加する

<el-button
    @click="exportData"
    type="primary"
    size="mini"
    icon="el-icon-upload2" >导出Excel</el-button>

2.エクスポート方法を追加 

//Excel数据导出
exportData() {
    window.location.href = this.BASE_API + '/admin/core/dict/export'
}

データ辞書一覧表示 

1. バックエンド インターフェイス

1. エンティティ クラスに属性を追加する

プロパティを Dict に追加する

@ApiModelProperty(value = "是否包含子节点")
@TableField(exist = false)//在数据库表中忽略此列
private boolean hasChildren;

2. サービス層はデータクエリを実装します

インターフェース: DictService

List<Dict> listByParentId(Long parentId);

実装: DictServiceImpl 

@Override
public List<Dict> listByParentId(Long parentId) {
    List<Dict> dictList = baseMapper.selectList(new QueryWrapper<Dict>().eq("parent_id", parentId));
    dictList.forEach(dict -> {
        //如果有子节点,则是非叶子节点
        boolean hasChildren = this.hasChildren(dict.getId());
        dict.setHasChildren(hasChildren);
    });
    return dictList;
}

/**
     * 判断该节点是否有子节点
     */
private boolean hasChildren(Long id) {
    QueryWrapper<Dict> queryWrapper = new QueryWrapper<Dict>().eq("parent_id", id);
    Integer count = baseMapper.selectCount(queryWrapper);
    if(count.intValue() > 0) {
        return true;
    }
    return false;
}

3. コントローラ層はフロン​​トエンド リクエストを受け取ります 

@ApiOperation("根据上级id获取子节点数据列表")
@GetMapping("/listByParentId/{parentId}")
public R listByParentId(
    @ApiParam(value = "上级节点id", required = true)
    @PathVariable Long parentId) {
    List<Dict> dictList = dictService.listByParentId(parentId);
    return R.ok().data("list", dictList);
}

第二に、フロントエンドコール

1、アピ

src/api/core/dict.js を作成

import request from '@/utils/request'
export default {
  listByParentId(parentId) {
    return request({
      url: `/admin/core/dict/listByParentId/${parentId}`,
      method: 'get'
    })
  }
}

2. コンポーネントスクリプト

データを定義する

list: [], //数据字典列表

ライフサイクル機能 

created() {
    this.fetchData()
},

データを取得する方法 

import dictApi from '@/api/core/dict'
// 调用api层获取数据库中的数据
fetchData() {
  dictApi.listByParentId(1).then(response => {
    this.list = response.data.list
  })
},

//延迟加载子节点
getChildren(row, treeNode, resolve) {
  dictApi.listByParentId(row.id).then(response => {
    //负责将子节点数据展示在展开的列表中  
    resolve(response.data.list)
  })
},

3. コンポーネント テンプレート 

<el-table :data="list" border row-key="id" lazy :load="load">
    <el-table-column label="名称" align="left" prop="name" />
    <el-table-column label="编码" prop="dictCode" />
    <el-table-column label="值" align="left" prop="value" />
</el-table>

4. プロセスの最適化

データのインポート後にページのデータ リストを更新する

//上传成功回调
fileUploadSuccess(response) {
    if (response.code === 0) {
        this.$message.success('数据导入成功')
        this.dialogVisible = false
        this.fetchData()
    } else {
        this.$message.error(response.message)
    }
},

今日は珍しい 

 java.lang.IllegalStateException: @SpringBootConfiguration が見つかりません。使用する必要があります

2 つの問題が考えられます:
1. スタートアップ クラスが記述されていない:
2. スタートアップ クラスが記述されているが、スタートアップ クラスが配置されているパッケージが単体テスト パッケージと同じルート ディレクトリにない。
例: 1 つは cn.xxxx.cmcc にあり、もう 1 つは cn.xxxxx にあります。それらは同じディレクトリにないため、スタートアップ クラスが見つからないことが報告されています。
これを解決するには、同じパッケージ ディレクトリに配置します。問題。

概要: 単体テストのテスト クラスは、スタートアップ クラスと同じルート ディレクトリにある必要があります。
 

おすすめ

転載: blog.csdn.net/m0_62436868/article/details/126697488