net.sohelp.boot.dev.web.system.i18n

类 LanguageController

java.lang.Object

net.sohelp.boot.admin.core.base.BaseController

net.sohelp.boot.dev.web.system.i18n.LanguageController

@RestController(value="dev-system-lang")
 @RequestMapping(value="/dev/system/lang")
public class LanguageController
extends BaseController

语言管理控制器，提供语言相关的增删改查及配置功能。

从以下版本开始:

2022/8/29

作者:

AaronFung

字段概要

从类继承的字段 net.sohelp.boot.admin.core.base.BaseController

request, response

构造器概要

构造器

构造器和说明
LanguageController()

方法概要

限定符和类型	方法和说明
ApiResult<String>	delete(Map<String,Object> paramMap) 根据ID删除指定语言项。
ApiResult<List<Map<String,Object>>>	getEnabledLanguage() 获取系统中已启用的语言列表。
ApiResult<Map<String,Object>>	getLangConfig() 获取语言相关个性化配置信息。
ApiResult<List<Map<String,Object>>>	list(Map<String,Object> paramMap) 获取所有语言信息列表，并按排序字段升序排列。
ApiResult<Pager<Map<String,Object>>>	page(Map<String,Object> paramMap) 分页查询语言信息列表。
ApiResult<String>	save(Map<String,Object> paramMap) 新增或修改语言信息。
ApiResult<String>	setLangConfig(Map<String,Object> paramMap) 保存语言相关的个性化配置信息。
ApiResult<Map<String,Object>>	setLanguage(Map<String,Object> paramMap) 设置某个语言的启用状态。

从类继承的方法 net.sohelp.boot.admin.core.base.BaseController

error, error, fail, fail, fail, getLoginID, getLoginName, getLoginOrgID, getLoginOrgName, getLoginUser, getNickname, getTenantId, getUserName, getUserNo, i18n, i18n, isAdministrator, isDeveloper, limit, offset, ok, ok, response, success, success, success, success, validateToken

从类继承的方法 java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

构造器详细资料

LanguageController

public LanguageController()

方法详细资料

page

@Permission(value="ADMIN")
 @GetMapping(value="/page")
public ApiResult<Pager<Map<String,Object>>> page(@RequestParam
                                                                                                          Map<String,Object> paramMap)
                                                                                                   throws Exception

分页查询语言信息列表。

参数:

paramMap - 请求参数映射表（当前未使用）

返回:

包含分页数据的语言信息结果对象

抛出:

Exception - 查询过程中可能抛出的异常

list

@GetMapping(value="/list")
 @Permission(value="ADMIN")
public ApiResult<List<Map<String,Object>>> list(@RequestParam
                                                                                                         Map<String,Object> paramMap)
                                                                                                  throws Exception

获取所有语言信息列表，并按排序字段升序排列。

参数:

paramMap - 请求参数映射表（当前未使用）

返回:

包含全部语言信息的结果对象

抛出:

Exception - 查询过程中可能抛出的异常

delete

@PostMapping(value="/delete")
 @Transactional(rollbackFor=java.lang.Exception.class)
 @Permission(value="DEVELOPER")
 @OperationLog(value="\u5220\u9664\u8bed\u8a00")
public ApiResult<String> delete(@RequestBody
                                                                                                                                                                                                          Map<String,Object> paramMap)
                                                                                                                                                                                                   throws Exception

根据ID删除指定语言项。

参数:

paramMap - 请求体中包含要删除语言的ID

返回:

删除操作结果提示信息

抛出:

Exception - 操作过程中的潜在异常

getEnabledLanguage

@GetMapping(value="/getEnabledLangs")
public ApiResult<List<Map<String,Object>>> getEnabledLanguage()
                                                                                              throws Exception

获取系统中已启用的语言列表。

返回:

已启用语言的信息集合

抛出:

Exception - 查询或处理过程中的异常

setLanguage

@RequestMapping(value="/setLang",
                method={GET,POST})
 @Transactional(rollbackFor=java.lang.Exception.class)
 @Permission(value="ADMIN")
public ApiResult<Map<String,Object>> setLanguage(@RequestBody
                                                                                                                                                                                                             Map<String,Object> paramMap)
                                                                                                                                                                                                      throws Exception

设置某个语言的启用状态。

参数:

paramMap - 请求体中包含语言ID和是否启用的状态

返回:

设置操作结果信息

抛出:

Exception - 更新资源文件时可能出现的异常

save

@PostMapping(value="/save")
 @Transactional(rollbackFor=java.lang.Exception.class)
 @Permission(value="DEVELOPER")
 @OperationLog(value="\u4fdd\u5b58\u8bed\u8a00")
public ApiResult<String> save(@RequestBody
                                                                                                                                                                                                      Map<String,Object> paramMap)
                                                                                                                                                                                               throws Exception

新增或修改语言信息。

参数:

paramMap - 请求体中包含语言相关信息（如编号、名称等）

返回:

添加或修改操作的成功提示

抛出:

Exception - 数据存储或转换过程中的异常

getLangConfig

@GetMapping(value="/getLangConfig")
 @Transactional(rollbackFor=java.lang.Exception.class)
public ApiResult<Map<String,Object>> getLangConfig()

获取语言相关个性化配置信息。

返回:

当前系统的语言配置参数

setLangConfig

@PostMapping(value="/setLangConfig")
 @Transactional(rollbackFor=java.lang.Exception.class)
 @Permission(value="DEVELOPER")
 @OperationLog(value="\u4fdd\u5b58\u8bed\u8a00\u4e2a\u6027\u5316\u914d\u7f6e")
public ApiResult<String> setLangConfig(@RequestBody
                                                                                                                                                                                                                                                      Map<String,Object> paramMap)
                                                                                                                                                                                                                                               throws SQLException,
                                                                                                                                                                                                                                                      EntityException,
                                                                                                                                                                                                                                                      EntityValidateException,
                                                                                                                                                                                                                                                      EntityFormulaException,
                                                                                                                                                                                                                                                      EntityEventException,
                                                                                                                                                                                                                                                      DuplicateKeyException

保存语言相关的个性化配置信息。

参数:

paramMap - 请求体中包含需要保存的语言配置键值对

返回:

保存操作结果提示

抛出:

SQLException - SQL执行错误

EntityException - 实体操作异常

EntityValidateException - 实体验证失败

EntityFormulaException - 公式计算异常

EntityEventException - 事件触发异常

DuplicateKeyException - 主键冲突异常