版权声明：本文是作者在学习与工作中的总结与笔记，如有内容是您的原创，请评论留下链接地址，我会在文章开头声明。 https://blog.csdn.net/usagoole/article/details/82832036
文章目录
RabbitMQ-java-client版本
com.rabbitmq:amqp-client:4.3.0RabbitMQ版本声明: 3.6.15
API介绍
-
Connection Factory、Connection、Channel都是RabbitMQ对外提供的API中最基本的对象。Connection是RabbitMQ的socket连接，它封装了socket协议相关部分逻辑。Connection Factory则是Connection的制造工厂,Connection是用来开启Channel的,AMQP协议层面的操作是通过Channel进行的。 -
代码示例
private Logger logger = LoggerFactory.getLogger("rabbitmq-producer"); @Test public void testDirectExchange(){ ConnectionFactory factory = new ConnectionFactory(); String userName = "jannal"; String password = "jannal"; String virtualHost = "jannal-vhost"; String queueName = "jannal.direct.queue"; String exchange = "jannal.direct.exchange"; String routingKey = "SMS"; String bindingKey = "SMS"; String hostName = "jannal.mac.com"; int portNumber = 5672; factory.setUsername(userName); factory.setPassword(password); factory.setVirtualHost(virtualHost); factory.setHost(hostName); factory.setPort(portNumber); //以上等价下面 //factory.setUri("amqp://jannal:[email protected]:5672/jannal-vhost"); factory.setAutomaticRecoveryEnabled(false); Connection conn = null; try { //创建连接 conn = factory.newConnection(); //通过连接创建通道 Channel channel = conn.createChannel(); //持久化 boolean durable = true; //独占 boolean exclusive = false; //是否自动删除 boolean autoDelete = false; //声明队列 channel.queueDeclare(queueName, durable, exclusive, autoDelete, null); //声明交换器,direct交换器类型下，RoutingKey与BindingKey需要完全匹配 channel.exchangeDeclare(exchange, "direct", true); //绑定 channel.queueBind(queueName, exchange, bindingKey); //无法路由时，消息处理方式。true返回给Producer，false则直接丢弃消息 boolean mandatory = false; //queue没有Consumer，消息返回给Producer，不加入queue。有Consumer，则加入queue投递给Consumer，RabbitMQ3.0后已经废弃，默认false boolean immediate = false; String msg = "Hello, world "; //deliveryMode为2，表示消息会持久化到磁盘 channel.basicPublish(exchange, routingKey, mandatory, immediate, MessageProperties.PERSISTENT_TEXT_PLAIN, msg.getBytes("UTF-8")); //发送带headers的消息 HashMap<String, Object> headers = new HashMap<>(); headers.put("jannal", "jannal"); channel.basicPublish(exchange, routingKey, mandatory, immediate, new AMQP.BasicProperties() .builder() .headers(headers) .deliveryMode(2).build(), msg.getBytes("UTF-8")); //发送带有过期时间的消息 channel.basicPublish(exchange, routingKey, mandatory, immediate, new AMQP.BasicProperties() .builder() .expiration("1000") .deliveryMode(2).build(), msg.getBytes("UTF-8")); } catch (IOException e) { logger.error(e.getMessage(), e); } catch (TimeoutException e) { logger.error(e.getMessage(), e); } finally { if (conn != null) { try { conn.close(); } catch (IOException e) { e.printStackTrace(); } } } } -
查看
Exchange
-
查看队列
queueDeclare
-
方法声明
Queue.DeclareOk queueDeclare( String queue, //队列名称 boolean durable, //是否持久化 boolean exclusive,// 独占 boolean autoDelete,//是否自动删除 Map<String, Object> arguments) //队列的其他参数 throws IOException -
方法参数说明
durable:是否持久化,true表示一个持久的Queue(队列)(持久化到磁盘)，在服务器重启之后不会丢失Queue(队列)的相关信息(注意这里仅仅Queue(队列)的信息的持久化，而不是队列中消息的持久化)exclusive: 是否是独占(排他)队列- 基于
Connection可见，通过一个Connection的不同Channel是可以同时访问的 - 如果一个
Connection已经建立一个exclusive(独占)的Queue(队列)，其他Connection是不允许建立同名的独占Queue(队列)的 - 即使
Queue(队列)是持久化的，一旦Connection关闭或者客户端退出，该独占Queue(队列)都会被自动删除。这种队列适用于一个客户端同时发送和读取消息的应用场景
- 基于
autoDelete: 是否自动删除,true表示设置队列自动删除。自动删除的前提是:至少有一个Consumer连接到这个队列，之后所有与这个队列连接的Consumer都断开时，才会自动删除arguments:设置队列的其他参数,如x-message-ttl、x-expires、x-max-length等
exchangeDeclare
-
方法声明
public Exchange.DeclareOk exchangeDeclare( String exchange, //交换器名称 String type,//交换器类型fanout、direct、topic boolean durable, //是否持久化 boolean autoDelete,//是否自动删除 boolean internal, //是否内置 Map<String, Object> arguments){ return (Exchange.DeclareOk) exnWrappingRpc(new Exchange.Declare.Builder() .exchange(exchange) .type(type) .durable(durable) .autoDelete(autoDelete) .internal(internal) .arguments(arguments) .build()) .getMethod(); } void exchangeDeclareNoWait( String exchange, String type, boolean durable, boolean autoDelete, boolean internal, Map<String, Object> arguments) throws IOException{ transmit(new AMQCommand(new Exchange.Declare.Builder() .exchange(exchange) .type(type) .durable(durable) .autoDelete(autoDelete) .internal(internal) .arguments(arguments) .passive(false) .nowait(true)//多了一个nowait .build())); } } -
方法参数详解
type:交换器类型，fanout、topic、directdurable:设置是否持久化，true表示将Exchange持久化到磁盘，在服务器重启时不会丢失相关信息autoDelete:是否自动删除，自动删除的前提是至少有一个Queue(队列)或者Exchange(交换器)与当前设定的Exchange(交换器)绑定，之后所有与当前设定的Exchange(交换器)绑定的Queue(队列)或者Exchange(交换器)都与此解绑internal:是否内置。true表示是内置的Exchange,客户端程序无法直接发送消息到这个Exchange中，只能通过Exchange路由到另一个Exchange这种方式argument: 结构化参数
-
返回值
Exchange.DeclareOk:使用exchangeDeclare客户端声明一个Exchange之后，需要同步等待服务端返回.而使用exchangeDeclareNoWait不需要服务端同步返回结果
queueBind
-
方法
public Queue.BindOk queueBind( String queue, //队列名 String exchange,//交换器名称 String routingKey, //绑定Queue和Exchange的bindingKey Map<String, Object> arguments ) throws IOException { validateQueueNameLength(queue); return (Queue.BindOk) exnWrappingRpc(new Queue.Bind.Builder() .queue(queue) .exchange(exchange) .routingKey(routingKey) .arguments(arguments) .build()) .getMethod(); } -
BindingKey其实也属于RoutingKey的一种，官方解析为在绑定的时候使用的路由键。为了避免混淆，可以通过如下方式区分- 在使用绑定的时候，其中需要的路由键是
BindingKey.涉及的客户端方法一般有bind字样，如channel.exchangeBind、channel.queueBind - 在发送消息的时候，其中的路由键是
RoutingKey,设计的客户端方法有channel.basicPublish
- 在使用绑定的时候，其中需要的路由键是
exchangeBind
-
方法
public Exchange.BindOk exchangeBind( String destination, String source, String routingKey, Map<String, Object> arguments )throws IOException -
不仅可以将
Exchange与Queue绑定，也可以将Exchange与Exchange绑定。绑定后消息从source Exchange转发到destination Exchange，进而存储在destination Exchange绑定的Queue中
basicPublish
-
方法
public void basicPublish(String exchange, //交换器名称 String routingKey,//路由键 boolean mandatory,// boolean immediate, BasicProperties props,//消息的基本属性 byte[] body) -
参数详解
-
mandatory:当mandatory设置为true，Exchange无法根据自身的类型和RoutingKey找到一个匹配的Queue，那么RabbitMQ会调用Basic.Return命令将消息返回给生产者。Producer可以通过channel.addReturnListener来获取返回的消息。如果mandatory设置为false，则RabbitMQ会直接丢弃消息.channel.exchangeDeclare(exchange, "direct", true); boolean mandatory = true; boolean immediate = false; String msg = "no match queue "; channel.basicPublish(exchange, routingKey, mandatory, immediate, MessageProperties.PERSISTENT_TEXT_PLAIN, msg.getBytes("UTF-8")); channel.addReturnListener(new ReturnListener() { @Override public void handleReturn(int replyCode, String replyText, String exchange, String routingKey, AMQP.BasicProperties properties, byte[] body) throws IOException { logger.info("Basic.Return 返回的消息:{}", new String(body, "utf-8")); } }); -
immediate:如果设置为true，交换器在将消息路由到队列时发现队列上并不存在任何Consumer(消费者)，那么这条消息将不会存入队列中。当与RoutingKey匹配的所有Queue都没有Consumer(消费者)，该消息会通过Basic.Return返回给Producer(生产者).从RabbitMQ3.0版本开始不支持immediate(所以客户端最好设为false，否则会抛出异常),因为immediate会影响镜像队列的性能，增加了代码的复杂性，建议采用TTL和DLX(Dead-Letter-Exchange死信队列)代替
-
持久化
RabbitMQ的持久化分为三个部分:Exchange的持久化,声明时将durable设置为trueQueue的持久化，声明时将durable设置为true，这里仅仅是Queue相关信息的持久化，并不代表Queue中消息的持久化。Queue中消息的持久化，设置BasicProperties中的deliveryMode属性为2,Queue中消息持久化的前提是Queue本身要持久化
- 将所有消息都设置为持久化，会严重影响
RabbitMQ的性能(随机写入磁盘)，对于可靠性不是很高的消息可以不采用持久化以提高整体的吞吐量 - 即使将
Exchange、Queue、消息都设置了持久化后也不能保证数据不丢失- 在持久化的消息正确存入
RabbitMQ之后，还有一段时间才能存入磁盘之后。RabbitMQ并不会为每条消息都进行同步存盘，可能保存在操作系统缓存之中而不是物理磁盘之中。如果在此期间RabbitMQ服务节点宕机、重启或者发生异常等，消息保存还没从缓存同步到磁盘中，那么这些消息将丢失 publish confirm(发送方确认)模式，一旦Channel进入Confirm模式，所有在该Channel上面发布的消息都会被指派一个唯一的ID，一旦消息被投递到所有匹配的队列之后，RabbitMQ就会发送一个Basic.Ack(确认)给Producer，如果消息和Queue是可持久化的，那么确认消息会在消息写入磁盘后发出。RabbitMQ回传给生产者的确认消息中的deliveryTag包含了确认消息的序号，此外RabbitMQ也可以设置Channel.basicAck方法中的multiple参数，表示到这个序号之前的所有消息都已经得到了处理(类似批量确认)。
- 在持久化的消息正确存入