若依SpringCloud微服务集成东方通的消息队列TongLINK/Q

前言

        由于目前集成国产中间件网上的资料少之又少，所以过程中相当坎坷，不过好在还是弄成了。我是基于RuoYi-Cloud-Plus微服务来集成的，对于普通的springboot或springcloud服务都可以参照它来集成。

集成步骤

一、前期准备

东方通的TongLINK需要去官网申请试用，才可以得到相关的资料，在windows或linux上安装完TongLINK后，再安装一下管理控制台，如下界面：

二、文件准备

        我把消息队列封装成了一个模块并放到了ruoyi-common模块下

resource下的lib中的两个jar包是在安装完TongLINK后的安装目录中获取的，如图

之后将这两个jar包加载进模块中去，同时也添加jms、jakarta相关的依赖，都在下面的pom文件里

<?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 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <parent>
        <groupId>org.dromara</groupId>
        <artifactId>ruoyi-common</artifactId>
        <version>${revision}</version>
    </parent>
    <modelVersion>4.0.0</modelVersion>

    <artifactId>ruoyi-common-tlq</artifactId>

    <description>
        ruoyi-common-tlq tlq服务
    </description>

    <dependencies>
        <!-- RuoYi Common Core-->
        <dependency>
            <groupId>org.dromara</groupId>
            <artifactId>ruoyi-common-core</artifactId>
        </dependency>

        <!--redisson-->
        <dependency>
            <groupId>org.redisson</groupId>
            <artifactId>redisson-spring-boot-starter</artifactId>
        </dependency>

        <dependency>
            <groupId>com.baomidou</groupId>
            <artifactId>lock4j-redisson-spring-boot-starter</artifactId>
        </dependency>

        <dependency>
            <groupId>com.github.ben-manes.caffeine</groupId>
            <artifactId>caffeine</artifactId>
        </dependency>

        <dependency>
            <groupId>com.fasterxml.jackson.datatype</groupId>
            <artifactId>jackson-datatype-jsr310</artifactId>
        </dependency>

<!--        &lt;!&ndash; redis序列化替代方案 比json快无数的跨语言二进制序列化 &ndash;&gt;-->
<!--        <dependency>-->
<!--            <groupId>org.apache.fury</groupId>-->
<!--            <artifactId>fury-core</artifactId>-->
<!--            <version>0.9.0</version>-->
<!--        </dependency>-->
<!--        <dependency>-->
<!--            <groupId>org.slf4j</groupId>-->
<!--            <artifactId>slf4j-api</artifactId>-->
<!--        </dependency>-->
        <dependency>
            <groupId>jakarta.jms</groupId>
            <artifactId>jakarta.jms-api</artifactId>
            <version>3.1.0</version>
        </dependency>
        <dependency>
            <groupId>jakarta.annotation</groupId>
            <artifactId>jakarta.annotation-api</artifactId>
            <version>3.0.0</version>
        </dependency>
        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-jms</artifactId>
            <version>6.1.6</version>
        </dependency>
        <!--增加TongJMS 依赖-->
        <dependency>
            <groupId>com.tongtech</groupId>
            <artifactId>TongJMS</artifactId>
            <version>1.0.1</version>
            <scope>system</scope>
            <systemPath>${pom.basedir}/src/main/resources/lib/TongJMS_jakarta.jar</systemPath>
        </dependency>
        <!-- 示例：若使用 Maven -->
        <dependency>
            <groupId>com.tongtech</groupId>
            <artifactId>tlq-client</artifactId>
            <version>1.0.0</version>
            <scope>system</scope>
            <systemPath>${project.basedir}/src/main/resources/lib/tlclient.jar</systemPath>
        </dependency>
        <dependency>
            <groupId>javax.annotation</groupId>
            <artifactId>javax.annotation-api</artifactId>
            <version>1.3.2</version>
            <scope>compile</scope>
        </dependency>

    </dependencies>

</project>

三、集成中需要的文件

        你可以按照我的结构去新建相关的文件

        3.1、JmsConfig文件

package org.dromara.common.tlq;

import com.tongtech.tmqi.ConnectionFactory;
import lombok.Data;
import lombok.extern.slf4j.Slf4j;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.beans.factory.annotation.Value;
import org.springframework.boot.context.properties.ConfigurationProperties;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.jms.config.DefaultJmsListenerContainerFactory;
import org.springframework.jms.core.JmsTemplate;
import org.springframework.stereotype.Component;

import javax.naming.Context;
import javax.naming.InitialContext;
import javax.naming.NamingException;
import java.util.Properties;

@Data
@Configuration
@Slf4j
@Component
public class JmsConfig {
    private final String tcf;
    private final String remoteUrl;
    private final String remoteFactory;


    @Autowired
    public JmsConfig(JmsConfigProperties jmsConfigProperties) {
        this.tcf = jmsConfigProperties.getTcf();
        this.remoteUrl = jmsConfigProperties.getRemoteUrl();
        this.remoteFactory = jmsConfigProperties.getRemoteFactory();
        log.info("Factory配置: {}", jmsConfigProperties.getRemoteFactory());
        log.info("jmsConfigProperties.getRemoteUrl()=={}",jmsConfigProperties.getRemoteUrl());
        log.info("jmsConfigProperties.getRemoteFactory()=={}",jmsConfigProperties.getRemoteFactory());
        log.info("this.tcf==={}",this.tcf);
    }
    @Bean
    public ConnectionFactory connectionFactory() throws NamingException {
        // 配置 JNDI 属性
        Properties props = new Properties();
        props.put(Context.INITIAL_CONTEXT_FACTORY, tcf);
        props.put(Context.PROVIDER_URL, remoteUrl);

        // 获取东方通的 ConnectionFactory
        Context ctx = new InitialContext(props);
        return (ConnectionFactory) ctx.lookup(remoteFactory);
    }

    @Bean
    public JmsTemplate jmsTemplate(ConnectionFactory connectionFactory) {
        JmsTemplate jmsTemplate = new JmsTemplate(connectionFactory);
        jmsTemplate.setDefaultDestinationName("MyQueue"); // 默认队列
        return jmsTemplate;
    }

    @Bean
    public DefaultJmsListenerContainerFactory jmsListenerContainerFactory(ConnectionFactory connectionFactory) {
        DefaultJmsListenerContainerFactory factory = new DefaultJmsListenerContainerFactory();
        factory.setConnectionFactory(connectionFactory);
        factory.setConcurrency("1-1"); // 并发消费者数量
        return factory;
    }
}

3.2、JmsConfigProperties

package org.dromara.common.tlq;

import lombok.Data;
import lombok.Getter;
import lombok.Setter;
import org.springframework.boot.context.properties.ConfigurationProperties;
import org.springframework.stereotype.Component;

@Data
@Component
@ConfigurationProperties(prefix = "spring.tlq.config")//注意这里需要根据你的nacos中的配置去设置
public class JmsConfigProperties {
    private String tcf;
    private String remoteUrl;
    private String remoteFactory;
}

nacos的消息队列配置如下

里面的remoteURL改成自己部署的消息队列服务的ip和端口号

tlq:
    config:
      tcf: tongtech.jms.jndi.JmsContextFactory
      remoteURL: tlq://localhost:10024	
      remoteFactory: RemoteConnectionFactory

在nacos中可以在application-common.yml下配置，也可以在你那个需要用到消息队列的模块中配置，不过最好是在application-common.yml下配置，因为它是全局的，在system的application文件中也导入了这个配置文件，所以在application-common.yml配置也会生效。

如果没有生效那你就在system.yml中配置一下也可以！！！

spring:
  datasource:
    dynamic:
      # 设置默认的数据源或者数据源组,默认值即为 master
      primary: master
      datasource:
        # 主库数据源
        master:
          type: ${spring.datasource.type}
          driver-class-name: ${datasource.system-master.driver}
          url: ${datasource.system-master.url}
          username: ${datasource.system-master.username}
          password: ${datasource.system-master.password}
#        oracle:
#          type: ${spring.datasource.type}
#          driverClassName: oracle.jdbc.OracleDriver
#          url: ${datasource.system-oracle.url}
#          username: ${datasource.system-oracle.username}
#          password: ${datasource.system-oracle.password}
#        postgres:
#          type: ${spring.datasource.type}
#          driverClassName: org.postgresql.Driver
#          url: ${datasource.system-postgres.url}
#          username: ${datasource.system-postgres.username}
#          password: ${datasource.system-postgres.password}
tlq:
    config:
      tcf: tongtech.jms.jndi.JmsContextFactory
      remoteURL: tlq://localhost:10024	
      remoteFactory: RemoteConnectionFactory

3.3、JmsSender

        这段代码就是主要用来发送消息的，发送消息时调用JmsSender.sendMessage(队列名，msg)，即可把消息发送到指定队列，后续如果有主题相关的，可以自行编码，

package org.dromara.common.tlq;

import lombok.extern.slf4j.Slf4j;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.jms.JmsException;
import org.springframework.jms.core.JmsTemplate;
import org.springframework.stereotype.Component;
import org.springframework.stereotype.Service;

@Service
@Slf4j
public class JmsSender {

    @Autowired
    private JmsTemplate jmsTemplate;
    /**
     * 发送消息到指定队列
     */
    public void sendMessage(String queueName, String message) {
        try {
            jmsTemplate.convertAndSend(queueName, message);
            log.debug("发送成功 [{}] -> {}", queueName, message);
        } catch (Exception e) {
            log.error("发送失败 [{}]", queueName, e);
        }
//        jmsTemplate.convertAndSend(queueName, message);
        System.out.println("消息已发送至队列 [" + queueName + "]: " + message);
    }

    /**
     * 发送消息到默认队列（配置在 JmsTemplate 中）
     */
    public void sendMessageToDefaultQueue(String message) {
        jmsTemplate.convertAndSend(message);
        System.out.println("消息已发送至默认队列: " + message);
    }
}

3.4、org.springframework.boot.autoconfigure.AutoConfiguration.imports

这里也是需要根据自己的文件目录和文件名去配置

org.dromara.common.tlq.JmsConfigProperties
org.dromara.common.tlq.JmsConfig
org.dromara.common.tlq.JmsSender

四、测试

        我在测试的时候把我集成的模块引入了我的system下

之后随便在一个查询操作下加入发送消息的代码，以便测试一下

之后创建一个监听类，在方法上添加@JmsListener注解即可实现监听消息

附加代码

package org.dromara.system.listener;

import com.tongtech.jms.Message;
import jakarta.jms.JMSException;
import jakarta.jms.TextMessage;
import org.springframework.jms.annotation.JmsListener;
import org.springframework.stereotype.Component;

@Component
public class JmsMessageListener {

    /**
     * 监听指定队列的消息
     */
    @JmsListener(destination = "lq")
    public void receiveMessage(String message) {
        System.out.println("收到消息: " + message);
    }
    
}

最后在控制台收到了打印的消息

特别注意！！！

消息队列的名称不能是MyQueue，反正我在使用这个队列名称的时候它报错提示这个消息队列不存在，应该用下面的

你如果没有安装控制台，也可以在安装目录中查看，进入下面的文件