产品特性

YiAIR-86-印刷-2.png

  • 无线远传：NB-IoT全网通
  • 干电池供电：2节AA电池（5号）
  • 静态功耗：< 20uA，可用1年*
  • 温/湿度精度：±0.2℃/±3%
  • 私有化 IoT 平台：多租户管理
  • 尺寸：86 x 86 x 30mm

适用范围

  • 供暖、冷链、厂房、仓库
  • 办公室、会议室、学校、幼儿园
  • 酒店、医院、商场、咖啡厅
  • 酒吧、餐馆、地铁、地下室

多租户

多租户.png

仪表板

dashboard.png

  • 编辑 docker-compose.yml
version: "3.7"
services:
  db:
    image: postgres:11.6
    restart: always
    environment:
      POSTGRES_DB: postgres
      POSTGRES_USER: postgres
      POSTGRES_PASSWORD: postgres
      PGDATA: /var/lib/postgresql/data
    volumes:
      - db-data:/var/lib/postgresql/data
    ports:
      - "5432:5432"
 
  pgadmin:
    image: dpage/pgadmin4
    restart: always
    environment:
      PGADMIN_DEFAULT_EMAIL: admin@yiqisoft.cn
      PGADMIN_DEFAULT_PASSWORD: talent
      PGADMIN_LISTEN_PORT: 80
    ports:
      - "8088:80"
    volumes:
      - pgadmin-data:/var/lib/pgadmin
    links:
      - "db:pgsql-server"
volumes:
  db-data:
  pgadmin-data:

注意：文件保存在本地 volumes 中，如果需要再次使用，请保存！

  • 启动
docker-compose up -d
  • 登录 pgAdmin 4

打开本地浏览器 http://localhost:8080 ， 使用用户名 admin@yiqisoft.cn 和密码 talent 登录

假设 ThingsBoard 以 docker 方式运行，需要通过反向映射来提供服务，为了加强安全性，用 https 和 wss，但是，wss 映射需要注意最后几行配置。

<VirtualHost *>
    DocumentRoot /var/www/iot
    ServerName iot.domain
    RewriteEngine on
    RewriteCond %{SERVER_PORT} !^443$
    RewriteRule ^(.*)$ https://%{SERVER_NAME}$1 [L,R]

    <Directory /var/www/iot>
        allow from all
        Options None
        Require all granted
    </Directory>
</VirtualHost>
<VirtualHost *:443>
    DocumentRoot "/var/www/iot"
    ServerName iot.doamin
    <Directory "/var/www/iot">
    allow from all
    Options FollowSymLinks
    Require all granted
    AllowOverride All 
    </Directory>
    SSLEngine on
    SSLCertificateFile /etc/httpd/conf.d/server.crt
    SSLCertificateKeyFile /etc/httpd/conf.d/server.key
    SSLCertificateChainFile /etc/httpd/conf.d/ca.crt

    ProxyPreserveHost On
    ProxyPass / http://127.0.0.1:8088/
    ProxyPassReverse / http://127.0.0.1:8088/
    ProxyPass /api/ws ws://127.0.0.1:8088/
    ProxyPassReverse /api/ws ws://127.0.0.1:8088/

    RewriteEngine on
    RewriteCond %{HTTP:Upgrade} =websocket [NC]
    RewriteRule /(.*) ws://127.0.0.1:8088/$1 [P,L]
</VirtualHost>

上篇文章介绍了如何对 ThingsBoard 进行无缝二次开发，在进一步集成 Spring Data Jpa 时，导致依赖注入问题，经过几十个小时的不懈努力，终于得到解决。参考了官方代码，只需要简单一个 Config 配置文件即可解决。

问题

  • 不多说，看图，你估计会遇到
    error.png

必要条件

正常开发模式

  • Controller
  • Entity，Pojo，Domain
  • Dao，Repository
  • Service
  • AutoConfig

解决方案

  • 官方参考
    tb.png
@Configuration
@EnableAutoConfiguration
@ComponentScan("org.thingsboard.server.dao.sql")
@EnableJpaRepositories("org.thingsboard.server.dao.sql")
@EntityScan("org.thingsboard.server.dao.model.sql")
@EnableTransactionManagement
public class JpaDaoConfig {

}
  • 依葫芦画瓢
    eco.png
@Configuration
@ComponentScan({ "cn.yiqisoft.ecolabanalysis.controller", "cn.yiqisoft.ecolabanalysis.services" })
@EnableJpaRepositories("cn.yiqisoft.ecolabanalysis.dao")
@EntityScan("cn.yiqisoft.ecolabanalysis.domain")
public class ReportAutoConfiguration {
}

  • ThingsboardServerApplication 扫描自己的 namespace

    @ComponentScan({"org.thingsboard.server","cn.yiqisoft.ecolabanalysis"})
  • 验证结果
    result.jpeg

**

至此，完全独立扩展 ThingsBoard！

**

众所周知，ThingsBoard 核心采用 Spring Boot 开发，当然，很多人已经在 Spring Boot 之上平步青云，那如何无缝扩展 ThingsBoard 功能，而不改变原有代码结构，且将来无缝升级？

创建自定义 Spring Boot Starter，实现功能模块

新建 Spring Boot Starter 项目

  • 名称定义为了方便识别： xxx-xxx-spring-boot-starter
    project.png
  • 增加依赖，看需求，自己的项目需要，spring-boot-autoconfigure，必不可少！
    depends.png

  • 完整pom.xml，自己细品

    <?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">

    <modelVersion>4.0.0</modelVersion>
    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>2.3.4.RELEASE</version>
        <relativePath /> <!-- lookup parent from repository -->
    </parent>
    <groupId>cn.yiqisoft</groupId>
    <artifactId>report-spring-boot-starter</artifactId>
    <version>0.0.1</version>
    <name>EcolabReport</name>
    <description>Ecolab Report</description>

    <properties>
        <java.version>1.8</java.version>
    </properties>

    <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web-services</artifactId>
        </dependency>

        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-devtools</artifactId>
            <scope>runtime</scope>
            <optional>true</optional>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-configuration-processor</artifactId>
            <optional>true</optional>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-autoconfigure</artifactId>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-test</artifactId>
            <scope>test</scope>
            <exclusions>
                <exclusion>
                    <groupId>org.junit.vintage</groupId>
                    <artifactId>junit-vintage-engine</artifactId>
                </exclusion>
            </exclusions>
        </dependency>
        
        
    </dependencies>

    <build>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
            </plugin>
        </plugins>
    </build>

</project>

新建controller，为了方便测试，简单即可

  • 新建 controller 文件

    package cn.yiqisoft.ecolabanalysis.controller;
    import org.springframework.web.bind.annotation.RequestMapping;
    import org.springframework.web.bind.annotation.RequestMethod;
    import org.springframework.web.bind.annotation.RestController;
    @RestController
    public class ReportController {

    @RequestMapping(value = "/api/report", method = RequestMethod.GET)
public String reportList() {
    return "Report List";
}

    }

自动装载工程

  • 新建 src/main/resources/META-INF/spring.factories 文件

    org.springframework.boot.autoconfigure.EnableAutoConfiguration=\
cn.yiqisoft.ecolabanalysis.controller.ReportController
  • 通知 Spring Boot 启动时自动装载我们的 Controller

打包，jar 包输出

命令行编译，并安装到本地 maven 库

mvn clean install

生成 ～/.m2/repository/cn/yiqisoft/report-spring-boot-starter/0.0.1/ecolab-report-spring-boot-starter-0.0.1.jar，这样本地其他项目依赖此 jar 包即可。

【可选】本地运行项目，独立测试都没问题

命令行启动项目

mvn spring-boot:run

效果

jiekechoo@jiekechoo ~ % curl http://localhost:8080/api/report
Report List
jiekechoo@jiekechoo ~ %

融入 ThingsBoard ，实现无缝二次开发

自定义 starter 分析

  • 我们的 maven 库

    <groupId>cn.yiqisoft</groupId>
<artifactId>report-spring-boot-starter</artifactId>
<version>0.0.1</version>
  • 加入 ThingsBoard application 工程依赖，在 application/pom.xml 加入我们的 maven 库即可
    pom.png

运行 ThingsBoard application 工程

  • 打开 swagger ，我们二次开发的模块已经被成功载入
    swagger.png

扩展

  • 即使 ThingsBoard 升级，我们单独 jar 包也相应升级即可；
  • 独立使用自己的二次开发数据库表，不影响 TB 本身；
  • 如果有能力，将自定义 jar 做成动态加载，实现更高级别。
  1. 1
  2. 2
  3. 3
  4. 4
  5. 5
  6. 6
  7. ...
  8. 8