# dldsj_backend

**Repository Path**: topic4/dldsj_backend

## Basic Information

- **Project Name**: dldsj_backend
- **Description**: 地理大数据时空解析原型系统后台
- **Primary Language**: Java
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2018-11-20
- **Last Updated**: 2020-12-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# dldsj

[TOC]

## 角色

URL | FUNCTION | METHOD | PARAM | RESULT | REMARK
---|---|---|---|---|---
/dldsj/role/add | 角色注册 | POST | name,description,isAdministrator,functionId(逗号分隔),modelId(逗号分隔) | {code,body,message}|
/dldsj/role/update/{roleId}|更改角色设置|POST|name,description,isAdministrator,functionId,modelId|{code,body,message}|
/dldsj/role/delete/{roleId}|删除角色|DELETE|option(getUsers-拉取用户列表/deleteRoleOnly-仅删除角色及其与模型、功能的关联/deleteOnCascade-删除角色、模型关联、功能关联、用户)|{code,body,message}|功能待讨论



## 用户（包含我的数据）

URL | FUNCTION | METHOD | PARAM | RESULT | REMARK
---|---|---|---|---|---
/dldsj/user/register|用户注册|POST|roleId,name,fullName,password,psd_prompt,sex,description,phone,email,organization,department,modelId(用逗号隔开的多个modelId)|{code,body,message}
/dldsj/user/login| 用户登录 | POST | name,pass | {code,body,message}
/dldsj/user/logout|用户退出|GET| |未定（看前端需求）
/dldsj/user/data|获取我的数据（按访问次数降序）|GET|offset,size|{code,body(`List<UserDataWithVisit>`),message}
/dldsj/data/field/{dataId}|获取字段信息|GET| |{code,body(`List<DataField>`),message}
/dldsj/data/preview/{dataId}|预览我的数据|GET|offset,size|{code,body(`JSONArray`),message}|未完成
/dldsj/user/favorite/add/{dataId}|添加收藏|POST|dataType(公共数据 - meta_storage，我的数据 - sys_user_data)|{code,body,message}
/dldsj/user/favorite/delete/{dataId}|删除收藏|DELETE|dataType(公共数据 - meta_storage，我的数据 - sys_user_data)|{code,body,message}

## 模型

URL | FUNCTION | METHOD | PARAM | RESULT | REMARK
---|---|---|---|---|---
/dldsj/parallel/register | 模型注册 | POST | 两个name属性为file的multipart表单(或三个，包含图片) | {code,body,message}
/dldsj/parallel/unregister/{artifactId}| 注销模型 | DELETE | |{code,body,message}
/dldsj/parallel/get|获取权限允许的所有模型|GET| |{code,body(`List<ParallelModel>`),message}
/dldsj/parallel/get/{artifactId}|获取指定ID的模型的详细描述|GET| |{code,body(`ParallelModel`),message}
/dldsj/parallel/use/{artifactId}|提交模型任务|POST|customname,params(`Array`)|{code,body(jobName),message}
/dldsj/parallel/kill/{jobName}|终止模型任务|POST| |{code,body,message}
/dldsj/parallel/jobs/user|读取用户的任务列表|GET|onlyFinished(true/false)|{code,body(`List<TaskWithMonitor>`),message}
/dldsj/parallel/jobs/running|读取用户正在运行的任务|GET| |{code,body(`List<TaskRecord>`),message}
/dldsj/parallel/jobs/{jobName}|读取指定ID的任务详情|GET| |{code,body(`TaskRecord`),message}
/dldsj/parallel/jobs/{jobName}/delete|任务完成的情况下，删除任务记录|DELETE| |{code,body,message}
/dldsj/parallel/monitor/{jobName}|读取指定jobName的任务的运行情况|GET| |{code,body(`Monitor`),message}
/dldsj/parallel/result/download/{jobName}|下载指定jobName的任务的结果|GET| | |结果文件夹不存在或为空时，下载得到一个文件夹，包含一个名为`空文件夹`的空文件
/dldsj/parallel/result/preview/{jobName}|预览指定jobName的任务的结果|GET|size|{code,body(`JSONArray`),message}
/dldsj/parallel/result/preview/{jobName}/geojson|以GeoJSON的格式返回指定jobName的任务结果|GET|size|{code,body(`GeoJSON`),message}


## 数据

URL | FUNCTION | METHOD | PARAM | RESULT|REMARK
---|---|---|---|---|---
/dldsj/data/list | 获取公共数据列表 | GET | offset,size | {code,body(`List<StorageWithVisit>`),message}|body.data.geomFields为以逗号分隔的空间属性字段名，如：lon,lat；为空字符串时表示该数据不可上图预览
/dldsj/data/field/{dataId}|获取字段信息|GET| |{code,body(`List<DataField>`),message}
/dldsj/data/preview/{dataId}|预览公共数据|GET|offset,size|{code,body(`JSONArray`),message}
/dldsj/data/preview/{dataId}/geojson|以geojson的格式预览公共数据|GET|offset,size|{code,body(`GeoJSON`),message}|当数据不支持预览时，返回body为null