前几天,有几位朋友私信我,叫我写一个使用SpringCloudAlibaba搭建项目。
今天,我给安排上,使用SpringCloudAlibaba搭建一个用户中心。
下面,我就来给大家说一下,我饿还是如何搭建的,具体步骤如下:
使用IDEA创建项目结构
添加maven相关依赖
安装Nacos
业务代码
创建项目结构我们先来创建父项目user-center,打开IDEA,进入File菜单。
然后,选择next
如果你的ArtifactId太长了,其中很多单词使用-分割,那在这里最好把你的复制一遍,后面有用。
选择好自己的maven和本地仓库配置文件。
下面我们来创建modules
和前面一样
这里我们需要填写自己的module名称,比如:user-web或者user-service或者user-api
然后就是next、next、最后就是finish(注意项目名称使用-的情况,和尚庙创建父项目一样)。
注意:我们的父项目user-center不做任何业务相关,所以,我们需要把父项目user-center中的src目录给删除。
然后,整个项目就变成了:
添加maven依赖我们使用父项目进行版本管理,即user-center中的内容如下:
?xmlversion="1.0"encoding="UTF-8"?projectxmlns=""xmlns:xsi=""xsi:schemaLocation=""/modelVersionpackagingpom/packagingmodulesmoduleuser-web/modulemoduleuser-service/modulemoduleuser-api/module//groupIdartifactIdspring-boot-starter-parent//version//groupIdartifactIduser-center//versionnameuser-center////////groupIdartifactIdspring-cloud-alibaba-depencies/artifactIdversion${}/versiontypepom/typescopeimport/scope//groupIdartifactIdspring-boot-depencies/artifactIdversion${}/versiontypepom/typescopeimport/scope/depency/depencies/depencyManagement/projectuser-api主要给服务消费者和服务提供者共同使用那部分代码,也就是提供给外部的api和相关共用代码。
user-api中内容:
?xmlversion="1.0"encoding="UTF-8"?projectxmlns=""xmlns:xsi=""xsi:schemaLocation=""//groupIdartifactIduser-center//version/parentartifactIduser-api//versionnameuser-api/////properties/project
user-service是业务具体实现
user-service中内容:
?xmlversion="1.0"encoding="UTF-8"?projectxmlns=""xmlns:xsi=""xsi:schemaLocation=""//groupIdartifactIduser-center//version/parentartifactIduser-service//versionnameuser-service//////groupIdartifactIdspring-boot-starter/artifactId//groupIdartifactIdspring-cloud-starter-alibaba-nacos-discovery/artifactId//groupIdartifactIdspring-cloud-starter-dubbo/artifactId//groupIdartifactIdmybatis-spring-boot-starter//version/depencydepencygroupIdmysql/groupIdartifactIdmysql-connector-java/artifactId//groupIdartifactIdfastjson//version/depency!--把user-api引进来--/groupIdartifactIduser-api//version/depencydepencygroupIdcommons-beanutils/groupIdartifactIdcommons-beanutils//version/depency/depencies/project
user-web是用户管理的页面系统
user-web中的内容:
?xmlversion="1.0"encoding="UTF-8"?projectxmlns=""xmlns:xsi=""xsi:schemaLocation=""//groupIdartifactIduser-center//version/parentartifactIduser-web//versionnameuser-web//groupIdartifactIdspring-boot-starter/artifactId//groupIdartifactIdspring-cloud-starter-alibaba-nacos-discovery/artifactId//groupIdartifactIdspring-cloud-starter-alibaba-nacos-config/artifactId//groupIdartifactIdspring-cloud-starter-dubbo/artifactId/depency!--/groupIdartifactIdspring-boot-starter-web/artifactId/depency!--/groupIdartifactIdspring-boot-starter-thymeleaf/artifactId//groupIdartifactIdfastjson//version//groupIdartifactIduser-api//version/depency/depencies/project
以上就是整个项目的整体结构。
user-center|--user-api|--user-service|--user-web
项目整体结构以及搭建完成,我们现在把Nacosserver端给搞定。
Nacos安装Nacos官网地址:
Nacos源码地址:
进入
直接选择对应下载包接口:
下载下来,然后解压,建议配置成咱们自己的数据库,比如MySQL数据库。在\conf目录下
在配置文件中。
另外,一定要记得,创建数据库,在此数据库下执行脚本:
最后数据库中的表,有如下:
在Linux/Unix/Mac操作系统中使用下面命令启动Nacos(单机模式),找到Nacos的bin目录下:
在Windows操作系统中,打开CMD,来到Nacos的bin目录下:
快速开始,请参官方文档,中文版请求地址:
项目启动后,我们直接访问:
如果需要输入用户名和密码,则世界输入nacos/nacos
这里的配置管理表示nacos作为配置中心的相关管理。服务管理便是我们的服务注册信息管理,其他这里不做讨论。
本文中,nacos所处位置:
业务代码本文的重点在于构建项目基础架构,所以,本文中不会展示过多的业务代码。
user-api这个module主要是服务提供者和服务消费者共同使用的代码,通常包括:service接口、数据传输对象DTO、一些工具类。
我们定义一类service接口类:
publicinterfaceUserService{UserInfoDTOfindUserInfoById(Longid);UserInfoDTOfindUserInfo(StringuserName,Stringpassword);}一个数据传输对象(注意需要实现Serializable用作序列化):
publicclassUserInfoDTOimplementsSerializable{privateLongid;privateStringuserName;privateIntegerage;privateIntegerger;privateStringphone;//省略getset}user-service也叫user-provider,就这个意思,懂了就行,另外,在项目开发中,遵循项目开发命名规范来就行。这个module里才是我们真正的业务处理,还有就是数据库操作也基本上在这里面。
下面我把代码都贴一遍。
配置文件:
=9002=user-serviceDubbo服务暴露的协议配置,其中子属性name为协议名称,port为协议端口(-1表示自增端口,从20880开始)==28801=localhost:8848==jdbc:mysql://localhost:3306/user-center?useUnicode=truecharacterEncoding=utf8autoReconnect=trueuseSSL=falseserverTimezone===123456=classpath:mapper/**/*.==
UserServiceApplication项目启动类:
@SpringBootApplication@MapperScan("")publicclassUserServiceApplication{publicstaticvoidmain(String[]args){(,args);}}数据库表对应的实体类:
publicclassUser{privateLongid;privateStringuserName;privateStringpassword;privateIntegerage;privateIntegerger;privateStringphone;//省略setget}?xmlversion="1.0"encoding="UTF-8"?!DOCTYPEmapperPUBLIC"-//////EN"""mappernamespace=""resultMapid="BaseResultMap"type=""idcolumn="id"property="id"jdbcType="BIGINT"/resultcolumn="user_name"property="userName"jdbcType="VARCHAR"/resultcolumn="password"property="password"jdbcType="VARCHAR"/resultcolumn="age"property="age"jdbcType="INTEGER"/resultcolumn="ger"property="ger"jdbcType="INTEGER"/resultcolumn="phone"property="phone"jdbcType="VARCHAR"//resultMapsqlid="BaseSQL"id,user_name,age,ger,phone/sqlselectid="selectByPrimaryKey"resultMap="BaseResultMap"parameterType="long"selectincluderefid="BaseSQL"/fromt_userwhereid={userName}andpassword=#{password}/select/mapperpublicinterfaceUserMapper{UserselectByPrimaryKey(LonguId);UserfindUserInfo(@Param("userName")StringuserName,@Param("password")Stringpassword);}业务具体实现类(注意:这里的Service注解是dubbo中,不是spring中的):
@Service(protocol="dubbo")publicclassUserServiceImplimplementsUserService{privateLoggerlogger=(());@ResourceprivateUserMapperuserMapper;@OverridepublicUserInfoDTOfindUserInfoById(Longid){("通过id查询用户信息,id={}",id);Useruser=(id);if(user==null){("用户信息不存在,id={}",id);returnnull;}UserInfoDTOuserInfoDTO=newUserInfoDTO();try{(userInfoDTO,user);}catch(Exceptionex){("bean转换失败",ex);}returnuserInfoDTO;}@OverridepublicUserInfoDTOfindUserInfo(StringuserName,Stringpassword){Useruser=(userName,password);if(user==null){returnnull;}UserInfoDTOuserInfoDTO=newUserInfoDTO();try{(userInfoDTO,user);}catch(Exceptionex){("bean转换失败",ex);}returnuserInfoDTO;}}user-web为了演示nacos作为分布式配置,所以,这个项目中的配置文件有所不同。
配置文件:
==localhost:8848=properties
UserController类:
@RestController@RequestMapping("/user")@RefreshScope//只需要在需要动态读取配置的类上添加此注解就可以使用@Value注解获取配置项publicclassUserController{@ResourceprivateIUserInfoServiceuserInfoService;/***nacos作为配置中心验证*/@Value("${}")privateStringconfigName;@GetMapping("/info/{id}")publicResultDatafindUserInfoById(@PathVariable("id")Longid){//输出我们在nacos配置中心配置的内容(configName);(id);}@PostMapping(value="/login")publicResultDatalogin(@RequestParam("userName")StringuserName,@RequestParam("password")Stringpassword){if((userName)||(password)){(_(),_());}(userName,password);}}在user-web中,我们通常也会定义一个service目录,可以做一些数据包装转换之类的。
publicinterfaceIUserInfoService{/***查询用户信息*/ResultDatafindUserInfoById(Longid);/***用户登录*/ResultDatalogin(StringuserName,Stringpassword);}实现类(注意:@Reference这个注解是Dubbo中的,protocol指定协议):
@ServicepublicclassUserInfoServiceImplimplementsIUserInfoService{@Reference(protocol="dubbo")privateUserServiceuserService;@OverridepublicResultDatafindUserInfoById(Longid){UserInfoDTOuserInfoDTO=(id);if(userInfoDTO==null){(_(),_());}(userInfoDTO);}@OverridepublicResultDatalogin(StringuserName,Stringpassword){UserInfoDTOuserInfoDTO=(userName,password);if(userInfoDTO==null){(_(),_());}(userInfoDTO);}}项目启动类:
@SpringBootApplicationpublicclassWebApplication{publicstaticvoidmain(String[]args){(,args);}}ResultData返回数据类:
publicclassResultDataT{privateTdata;privateintcode;privateStringmsg;publicstaticTResultDataTsuccess(Tdata){returnnewResultData(data,_(),_());}publicstaticTResultDataTfail(intcode,StringerrorMsg){returnnewResultData(null,code,errorMsg);}}ResultCodeEnum返回码类:
publicenumResultCodeEnum{SUCCESS(200,"操作成功"),SYSTEM_ERROR(500,"系统错误"),PARAM_EMPTY(400,"参数为空"),LOGIN_SUCCESS(200,"登录成功"),LOGIN_FAILD(500,"登录失败");privateintcode;privateStringmsg;//省略相关非核心代码}好了,以上就是构建一个用户中心的主要代码,大家也可以在此基础之上,进行添加一些功能。同时还可以添加请求和相应参数的打印,也可以做一个统一异常处理。
咱们下期见!答案获取方式:已赞已评已关~