public:it:thingsboard

这是本文档旧的修订版！

Thingsboard

V3.2 代码解析

架构

目录结构

  • 顶层目录
    .
├── LICENSE
├── README.md
├── license-header-template.txt
├── pom.xml
├── img                   --仅一张readme的logo图片
├── application           --主程序，JAVA, Spring, Spring Boot
├── common                --通用的JAVA代码, 包括数据信息结构，消息队列处理等等
├── dao                   --JAVA 数据库操作相关
├── docker                --docker 脚本
├── k8s                   --Kubernetes 配置脚本相关
├── msa                   --微服务相关，整合启动各种服务
├── netty-mqtt            --JAVA mqtt 实现
├── packaging             --打deb包相关
├── rest-client           --使用rest api 的JAVA客户端，供JAVA开发使用
├── rule-engine           --规则引擎, JAVA
├── tools
├── transport             
└── ui-ngx                --web前端代码, angular架构

登录与认证过程

  • ui-ngx前端页面加载后，angular初始化时，ui-ngx\src\app\app.component.ts, 查看setupAuth代码
  • 页面登录逻辑代码：ui-ngx\src\app\modules\login\pages\login\login.component.ts
    • 由 angular DI 注入 authService， 路径ui-ngx\src\app\core\auth\auth.service.ts
    • AuthService 调用 /api/auth/login 接口
    • 如果登录成功，是以 jwt 方式存储认证信息。依赖库：@auth0/angular-jwt
    • 如果密码过期，转url login/resetExpiredPassword
  • 后端接口/api/auth/login实现：
    • Spring Boot, application\src\main\java\org\thingsboard\server\config\ThingsboardSecurityConfiguration.java
    • org.springframework.security.web.authentication
  • 前端从 jwt 带的 userId 来获取用户信息 userService(位于ui-ngx\src\app\core\http\user.service.ts)
    • 调用 rest 接口 /api/user/{userId}
  • 由用户信息的字段 authority 来决定用户类型
    • 前端定义在ui-ngx\src\app\shared\models\authority.enum.ts;
    • 后端定义在common\data\src\main\java\org\thingsboard\server\common\data\security\Authority.java

路由

  • 刚加载时，路由走向是在 AuthService.defaultUrl里处理决定
    • 调用顺序 AppComponent.setupAuth → AuthService.gotoDefaultPlace → AuthService.defaultUrl

REST API

Tips

  • 站点初始化：参考 DefaultSystemDataLoaderService.loadDemoData 来进行站点初始化
  • java 怎么进行前后端分离与打包？
    • spring-boot-starter-web 包含 spring-boot-starter-tomcat, tomcat 是个web代理服务
    • spring-boot-starter-tomcat 默认映射的静态资源目录为 /static, /public, /resources, /META-INF/resources
    • ui-ngx 工程生成目录为 ui-ngx/target/generated-resources/public, 然后打包成 jar 包, 用 jar xvf ui-ngx-3.2.0.jar 可以看到 jar 包里为 public 目录资源。
    • 主工程 jar 包依赖 ui-ngx-3.2.0.jar, 运行时首页返回的便是ui-ngx生成的 public/index.html。
  • gateway 网关类型设备直接推送子设备数据时，可直接按名自动创建子设备，如果子设备被删除，需要网关断开链接再重连(session 重置）才能重新自动创建子设备

改造

  • 前端呈现 区域-楼宇-房间-设备点位-设备；
    • 设备点位与设备是不一样的，设备点位可增加删除但不可更改，数据历史是一直连续的，而点位所关联的设备可被更换。
    • 为了防止混淆，设备点位重名为房间点位应该更合适？ 暂不改。
    • 概念上，设备最好和具体的物理设备绑定，如果物理设备损坏更换，那么应创建新的设备，然后把该设备连接到点位上。
  • 增加手机短信消息机制；
  • public/it/thingsboard.1611307921.txt.gz
  • 最后更改: 2021/01/22 17:32
  • 由 oakfire