# group_12

**Repository Path**: lei-jinqi/group_12

## Basic Information

- **Project Name**: group_12
- **Description**: group12（12组）
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2023-07-04
- **Last Updated**: 2026-01-21

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# group_12

#### 项目结构


- java
    - com.group12
        - config
        - controller
        - mapper
        - pojo
        - service
        - Group12Application.java
- resources
    - mapper
    - static
        - css
        - img
        - js
        - auth
            - css
            - img
            - js
            - user.html
        - index.html
    - templates
    - application.properties

注：无需登录权限的前端页面（及js、css、img等）直接放置于static目录下，需要登录权限的页面放置于static/auth目录下

#### 命名规范

|  类型  |      命名方式       |         举例          |
| :----: | :-----------------: | :-------------------: |
|  类名  |    大驼峰命名法     |    UserController     |
| 变量名 |    小驼峰命名法     |    computedValues     |
| 常量名 | 全大写，"_"分隔单词 |  CHACHE_EXPIRED_TIME  |
| 方法名 |    小驼峰命名法     | selectByIdAndUsername |

#### 注意事项

1. 由于项目后期需部署至服务器，故所有网址均需写为相对路径形式。原项目版本在本地的根路径为localhost:8080/，而部署至服务器则为localhost:8080/group12/，故现项目版本通过修改配置文件将本地与远程改为一致，为localhost:8080/group12/。以下举几个修改后网址需更改的例子（均为用于前后端数据交换的（虚构）网址）：
    - 在user.html原来的js代码中table.render({...,url:'/user/insert', ...})的实际访问网址为：localhost:8080/user/insert；现在需修改为table.render({...,url:'./user/insert', ...})，实际访问网址为：localhost:8080/group12/auth/user/insert
        - 注：在老师编写的代码中，有部分user的接口网址直接写为了table.render({...,url:'/selectById', ...})，此类接口无法看出属于哪张表（user），命名空间会与其他表重合，因此后续需要废弃或修改，后续新增的网址也应在前加上表名，如：./user/selectById。此外考虑到用户的输入体验，网址应全部使用小写字母，单词分隔符可使用"-"
    - 与上条对应，在UserController.java文件中，原代码：@RequestMapping("/user/insert")需修改为@RequestMapping("/auth/user/insert")，完整网址即为：localhost:8080/group12/auth/user/insert
    - 资源链接默认指向当前文件夹，书写习惯与原项目相同因而几乎无需修改，如"img/mm.png"

2. 为避免xss攻击，所有由用户输入，并且能在前端显示的数据（如用户名），均需转义后再传给前端进行渲染，因此对此类数据需在xxxService.java文件中进行转义，以下为user的例子

    ``` java
    List<User> userList = userMapper.selectByPage(index, limit, username, age);
    //新增下面的代码将username字段转义
    for (User user:userList){
        user.setUsername(ESAPI.encoder().encodeForHTML(user.getUsername()));
    }
    ```