1 В избранное 0 Ответвления 0

OSCHINA-MIRROR/redkale-redkale

Присоединиться к Gitlife
Откройте для себя и примите участие в публичных проектах с открытым исходным кодом с участием более 10 миллионов разработчиков. Приватные репозитории также полностью бесплатны :)
Присоединиться бесплатно
Клонировать/Скачать
service.md 3.6 КБ
Копировать Редактировать Web IDE Исходные данные Просмотреть построчно История
redkale Отправлено 29.12.2023 18:19 fe6a5dd

Service组件

  Service是Redkale最核心的组件,主要处理业务逻辑和操作数据层。Service实例分两种模式: 本地模式远程模式。其模式由conf/application.xml文件来配置。开发人员在调用过程中通常不需要区分Service实例是哪种模式。
  并不是Sevice都能进行本地和远程模式切换, 以下情况的Service不能转成远程模式:
     1、类被修饰为final
     2、类被标记@Local
     3、类被标记@Component

  Redkale进程启动时扫描可加载的Service实现类,根据配置文件配置的模式采用ASM技术动态生成相应的Service临时类进行实例化,并注册到ResourceFactory同其他Service、Servlet依赖注入。

Service使用类型

类型 使用注解 场景说明
默认加载 @AutoLoad或无注解 默认的Service会自动加载并初始化,且会自动生成对应协议层Servlet
依赖加载 @AutoLoad(false) 此类Service只有被其他服务依赖或者显式的配置时才会被初始化,
主要用于工具类功能服务,
比如DataSourceCacheSource
本地模式 @Local 此类Service无论配不配成远程模式,都不会转成远程模式,
主要用于功能依赖本地环境或者参数无法序列化的服务
组件模式 @Component 此类Service不会被动态生成协议层Servlet,
主要用于无需提供对进程外提供接口的服务,
比如DataSourceCacheSource的实现

用法

@RestService(comment = "用户服务模块")
public class UserService implements Service {
    
    @Resource(name = "platf")
    private DataSource source;

    //请求url:  /user/updatePwd?bean={}
    @RestMapping(auth = true, methods = "POST", comment = "更改密码(只能POST请求)")
    public RetResult<String> updatePwd(@RestUserid long userid, UserPwdBean bean) {
        //逻辑处理
        return RetResult.success();
    }

    //请求url:  /user/updateIntro?intro=xxx
    @RestMapping(auth = true, comment = "更新用户介绍")
    public RetResult<String> updateIntro(@RestUserid long userid, String intro) {
        intro = Utility.orElse(intro, "");  //为null则用""
        //更新数据库
        source.updateColumn(UserDetail.class, userid, UserDetail::getIntro, intro); 
        return RetResult.success();
    }

    //请求url:  /user/updateGender?gender=1
    @RestMapping(auth = true, comment = "修改用户性别(异步方法)")
    public CompletableFuture<RetResult<String>> updateGender(@RestUserid long userid, short gender) {
        if (gender != GENDER_MALE && gender != GENDER_FEMALE) {
            return RetCodes.retResultFuture(RET_USER_GENDER_ILLEGAL);
        }        
        //更新数据库
        return source.updateColumnAsync(UserDetail.class, userid, UserDetail::getGender, gender)
                     .thenApply(v -> RetResult.success());
    }
}

  @RestUserid int userid为当前用户Id, 值是在BaseServlet里进行设置,userid可以是String、long、int类型。

远程模式Service

  远程Servie其实是提供RPC接口,需要配置文件中显式配置才可使用远程模式。

    <group name="remote-A" nodes="192.168.10.11:6060,192.168.10.22:7070"/>

    <server protocol="HTTP" host="0.0.0.0" port="8080">  
        <services autoload="true" group="remote-A"/>  
        <service name="" value="org.redkale.demo.user.UserService" group="remote-A"/>
    </server>

Опубликовать ( 0 )

Вы можете оставить комментарий после Вход в систему

1
https://api.gitlife.ru/oschina-mirror/redkale-redkale.git
git@api.gitlife.ru:oschina-mirror/redkale-redkale.git
oschina-mirror
redkale-redkale
redkale-redkale
main