一切随缘的技术博客

开源软件镜像站汇总

2023-11-24T09:49:13.000Z

开源软件镜像站汇总

RocketMQ官方运维管理命令mqadmin使用手册讲解-实操

2023-03-01T13:52:33.000Z

这个地方是写描述的地方

内容有点多，左侧有菜单

进入RocketMQ的bin目录：${PACKAGE}/bin，使用命令bash mqadmin，可以看到以下帮助菜单：

[root@localhost-001 bin]# sh mqadmin
The most commonly used mqadmin commands are:
   updateTopic          Update or create topic
   deleteTopic          Delete topic from broker and NameServer.
   updateSubGroup       Update or create subscription group
   deleteSubGroup       Delete subscription group from broker.
   updateBrokerConfig   Update broker's config
   updateTopicPerm      Update topic perm
   topicRoute           Examine topic route info
   topicStatus          Examine topic Status info
   topicClusterList     get cluster info for topic
   brokerStatus         Fetch broker runtime status data
   queryMsgById         Query Message by Id
   queryMsgByKey        Query Message by Key
   queryMsgByUniqueKey  Query Message by Unique key
   queryMsgByOffset     Query Message by offset
   printMsg             Print Message Detail
   printMsgByQueue      Print Message Detail
   sendMsgStatus        send msg to broker.
   brokerConsumeStats   Fetch broker consume stats data
   producerConnection   Query producer's socket connection and client version
   consumerConnection   Query consumer's socket connection, client version and subscription
   consumerProgress     Query consumers's progress, speed
   consumerStatus       Query consumer's internal data structure
   cloneGroupOffset     clone offset from other group.
   clusterList          List all of clusters
   topicList            Fetch all topic list from name server
   updateKvConfig       Create or update KV config.
   deleteKvConfig       Delete KV config.
   wipeWritePerm        Wipe write perm of broker in all name server
   resetOffsetByTime    Reset consumer offset by timestamp(without client restart).
   updateOrderConf      Create or update or delete order conf
   cleanExpiredCQ       Clean expired ConsumeQueue on broker.
   cleanUnusedTopic     Clean unused topic on broker.
   startMonitoring      Start Monitoring
   statsAll             Topic and Consumer tps stats
   allocateMQ           Allocate MQ
   checkMsgSendRT       check message send response time
   clusterRT            List All clusters Message Send RT
   getNamesrvConfig     Get configs of name server.
   updateNamesrvConfig  Update configs of name server.
   getBrokerConfig      Get broker config by cluster or special broker!
   queryCq              Query cq command.
   sendMessage          Send a message
   consumeMessage       Consume message
   updateAclConfig      Update acl config yaml file in broker
   deleteAccessConfig   Delete Acl Config Account in broker
   clusterAclConfigVersion List all of acl config version information in cluster
   updateGlobalWhiteAddr Update global white address for acl Config File in broker
   getAccessConfigSubCommand List all of acl config information in cluster

See 'mqadmin help <command>' for more information on a specific command.

其中列出了最常用的命令，并附有简短说明。要获取每个命令的详细手册，使用命令**：bash mqadmin help 。例如，命令bash mqadmin help clusterList**将显示以下帮助文本：

[root@localhost-001 bin]# bash mqadmin help clusterList 
usage: mqadmin clusterList [-h] [-i ] [-m] [-n ]
 -h,--help                Print help
 -i,--interval       specify intervals numbers, it is in seconds
 -m,--moreStats           Print more stats
 -n,--namesrvAddr    Name server address list, eg: 192.168.0.1:9876;192.168.0.2:9876
[root@localhost-001 bin]#

Topic相关

updateTopic

作用：修改或创建一个Topic

命令：mqadmin updateTopic -b | -c [-h] [-n ] [-o ] [-p ] [-r ] [-s ] -t [-u ] [-w ]

参数	含义	备注
-b,–brokerAddr	broker 地址，表示topic 建在该broker	如果-c为空，则必填
-c,–clusterName	cluster 名称，表示topic 建在该集群	如果-b为空，则必填
-h,–help	打印help信息
-n,–namesrvAddr	name server地址列表	以分号分割，例如：192.168.0.1:9876;192.168.0.2:9876
-o,–order	设置topic是否为有序的	取值：true、false(默认)
-p,–perm	设置topic的权限	取值：2、4、6；含义：2-W、4-R、6-RW(默认)
-r,–readQueueNums	设置可读队列数	默认为8
-s,–hasUnitSub	设置是否有unit sub	取值：true、false
-t,–topic	设置topic名称	名称只能使用字符 ^[a-zA-Z0-9_-]+$
-u,–unit	设置是否为unit topic	取值：true、false
-w,–writeQueueNums	设置可写队列数	默认为8

注意：

-b 和–brokerAddr 是等价的，-b是缩写，其余同理；(后面的全称都是两个短横线，由于md自动转译了，就不一一改了，太多了)
本文所有配置信息，基于RocketMQ 4.7.1整理；
一般来说[]内的参数为可选参数，但是经过验证，不指定nameserver地址，是会报错的；

示例：

[root@localhost-001 bin]
RocketMQLog:WARN No appenders could be found for logger (io.netty.util.internal.PlatformDependent0).
RocketMQLog:WARN Please initialize the logger system properly.
create topic to 172.24.30.194:10911 success.
create topic to 172.24.30.193:10911 success.
create topic to 172.24.30.192:10911 success.
TopicConfig [topicName=zhurunhua, readQueueNums=8, writeQueueNums=8, perm=RW-, topicFilterType=SINGLE_TAG, topicSysFlag=0, order=false]
[root@localhost-001 bin]

deleteTopic

作用：从broker和nameserver删除topic

命令：mqadmin deleteTopic -c [-h] [-n ] -t

参数	含义	备注
-c,–clusterName	指定cluster名称
-h,–help	打印help信息
-n,–namesrvAddr	name server地址列表	以分号分割，例如：192.168.0.1:9876;192.168.0.2:9876
-t,–topic	设置topic名称

示例：

[root@localhost-001 bin]
RocketMQLog:WARN No appenders could be found for logger (io.netty.util.internal.PlatformDependent0).
RocketMQLog:WARN Please initialize the logger system properly.
delete topic [zhurunhua] from cluster [xdf-test1] success.
delete topic [zhurunhua] from NameServer success.

topicList

作用：从nameserver列出所有topic

命令：mqadmin topicList [-c] [-h] [-n ]

参数	含义	备注
-h,–help	打印help信息
-n,–namesrvAddr	nameserver服务地址列表
-c,–clusterModel	指定cluster模式

示例：

[root@localhost-001 bin]
RocketMQLog:WARN No appenders could be found for logger (io.netty.util.internal.PlatformDependent0).
RocketMQLog:WARN Please initialize the logger system properly.
%DLQ%xxoo
%RETRY%dfub-order
BenchmarkTest
testschedule
...
...

updateTopicPerm

作用：更新topic权限

命令：mqadmin updateTopicPerm [-b ] [-c ] [-h] [-n ] -p -t

参数	含义	备注
-b,–brokerAddr	设置更新哪个broker
-c,–clusterName	设置更新哪个cluster
-h,–help	打印help信息
-n,–namesrvAddr	nameserver服务地址列表
-p,–perm	设置topic的权限	取值：2、4、6；含义：2-W、4-R、6-RW
-t,–topic	设置修改的topic名称

示例：

[root@localhost-001 bin]
RocketMQLog:WARN No appenders could be found for logger (io.netty.util.internal.PlatformDependent0).
RocketMQLog:WARN Please initialize the logger system properly.
update topic perm from 6 to 4 in 172.24.30.192:10911 success.
TopicConfig [topicName=zhurunhua, readQueueNums=8, writeQueueNums=8, perm=R--, topicFilterType=SINGLE_TAG, topicSysFlag=0, order=false].

注意：需要同时指定nameserver和brokerAddr

topicRoute

作用：检查topic路由信息

命令：mqadmin topicRoute [-h] [-n ] -t

参数	含义	备注
-h,–help	打印help信息
-n,–namesrvAddr	nameserver服务地址列表
-t,–topic	topic名称

示例：

[root@localhost-001 bin]
RocketMQLog:WARN No appenders could be found for logger (io.netty.util.internal.PlatformDependent0).
RocketMQLog:WARN Please initialize the logger system properly.
{
        "brokerDatas":[
                {
                        "brokerAddrs":{0:"172.24.30.193:10911",1:"172.24.30.192:11911"
                        },
                        "brokerName":"broker-b",
                        "cluster":"xdf-test1"
                },
                {
                        "brokerAddrs":{0:"172.24.30.194:10911",1:"172.24.30.193:11911"
                        },
                        "brokerName":"broker-c",
                        "cluster":"xdf-test1"
                },
                {
                        "brokerAddrs":{0:"172.24.30.192:10911",1:"172.24.30.194:11911"
                        },
                        "brokerName":"broker-a",
                        "cluster":"xdf-test1"
                }
        ],
        "filterServerTable":{},
        "queueDatas":[
                {
                        "brokerName":"broker-c",
                        "perm":6,
                        "readQueueNums":8,
                        "topicSynFlag":0,
                        "writeQueueNums":8
                },
                {
                        "brokerName":"broker-b",
                        "perm":6,
                        "readQueueNums":8,
                        "topicSynFlag":0,
                        "writeQueueNums":8
                },
                {
                        "brokerName":"broker-a",
                        "perm":4,
                        "readQueueNums":8,
                        "topicSynFlag":0,
                        "writeQueueNums":8
                }
        ]
}

topicStatus

作用：检查topic的状态信息

命令：mqadmin topicStatus [-h] [-n ] -t

参数	含义	备注
-h,–help	打印help信息
-n,–namesrvAddr	nameserver服务地址列表
-t,–topic	topic名称

示例：

[root@localhost-001 bin]
RocketMQLog:WARN No appenders could be found for logger (io.netty.util.internal.PlatformDependent0).
RocketMQLog:WARN Please initialize the logger system properly.

broker-a                          0     0                     0                       
broker-a                          1     0                     0                       
broker-a                          2     0                     0                       
broker-a                          3     0                     0                       
broker-a                          4     0                     0                       
broker-a                          5     0                     0                       
broker-a                          6     0                     0                       
broker-a                          7     0                     0                       
broker-b                          0     0                     0                       
broker-b                          1     0                     0                       
broker-b                          2     0                     0                       
broker-b                          3     0                     0                       
broker-b                          4     0                     0                       
broker-b                          5     0                     0                       
broker-b                          6     0                     0                       
broker-b                          7     0                     0                       
broker-c                          0     0                     0                       
broker-c                          1     0                     0                       
broker-c                          2     0                     0                       
broker-c                          3     0                     0                       
broker-c                          4     0                     0                       
broker-c                          5     0                     0                       
broker-c                          6     0                     0                       
broker-c                          7     0                     0

topicClusterList

作用：获取topic的集群信息

命令：mqadmin topicClusterList [-h] [-n ] -t

参数	含义	备注
-h,–help	打印help信息
-n,–namesrvAddr	nameserver服务地址列表
-t,–topic	topic名称

示例：

[root@localhost-001 bin]
RocketMQLog:WARN No appenders could be found for logger (io.netty.util.internal.PlatformDependent0).
RocketMQLog:WARN Please initialize the logger system properly.
xdf-test1
[root@localhost-001 bin]

cleanUnusedTopic

作用：清理未使用的topic

命令：mqadmin cleanUnusedTopic [-b ] [-c ] [-h] [-n ]

参数	含义	备注
-h,–help	打印help信息
-n,–namesrvAddr	nameserver服务地址列表
-b,–brokerAddr	broker地址
-c,–cluster	集群名称

示例：

[root@localhost-001 bin]
RocketMQLog:WARN No appenders could be found for logger (io.netty.util.internal.PlatformDependent0).
RocketMQLog:WARN Please initialize the logger system properly.
success
[root@localhost-001 bin]

注意：需同时指定nameserver和broker地址，若只指定了nameserver，会报错：wait response on the channel <172.24.30.192:9876> timeout, 4904(ms)

Message相关

sendMessage

作用：发送消息

命令：mqadmin sendMessage [-b ] [-c ] [-h] [-i ] [-k ] [-n ] -p -t

参数	含义	备注
-h,–help	打印help信息
-n,–namesrvAddr	nameserver服务地址列表
-b,–broker	设置发送消息的目标broker
-c,–tags	Message tags
-i,–qid	设置目标queue
-k,–key	消息key
-p,–body	消息体	UTF-8编码，字符串
-t,–topic	topic名称

示例：

[root@localhost-001 bin]
RocketMQLog:WARN No appenders could be found for logger (io.netty.util.internal.PlatformDependent0).
RocketMQLog:WARN Please initialize the logger system properly.

broker-b                          6     SEND_OK                 AC110001DD437EA987AC6F4D48590000

[root@localhost-001 bin]

注意：

这里返回的MsgId，实际上是UniqueKey，通过queryById是查不出来的，但是通过queryMsgByUniqueKey能查到；
Tag的使用：一个应用尽可能用一个Topic，而消息子类型则可以用tags来标识。tags可以由应用自由设置，只有生产者在发送消息设置了tags，消费方在订阅消息时才可以利用tags通过broker做消息过滤：message.setTags(“TagA”)。

sendMsgStatus

作用：发送消息到broker

命令：mqadmin sendMsgStatus -b [-c ] [-h] [-n ] [-s ]

注意：并不是真正发送消息，只是检测消息的发送状态（sendStatus、rt）

参数	含义	备注
-h,–help	打印help信息
-n,–namesrvAddr	nameserver服务地址列表
-b,–brokerName	broker名称
-c,–count	发送消息数量	默认：50
-s,–messageSize	消息大小	默认：128

示例：

[root@localhost-001 bin]
RocketMQLog:WARN No appenders could be found for logger (io.netty.util.internal.PlatformDependent0).
RocketMQLog:WARN Please initialize the logger system properly.
rt:1ms, SendResult=SendResult [sendStatus=SEND_OK, msgId=AC110001F3237EA987AC6F72C5140001, offsetMsgId=AC181EC000002A9F000000014136B4B6, messageQueue=MessageQueue [topic=broker-a, brokerName=broker-a, queueId=0], queueOffset=58]rt:1ms, SendResult=SendResult [sendStatus=SEND_OK, msgId=AC110001F3237EA987AC6F72C5160002, offsetMsgId=AC181EC000002A9F000000014136B597, messageQueue=MessageQueue [topic=broker-a, brokerName=broker-a, queueId=0], queueOffset=59]rt:5ms, SendResult=SendResult [sendStatus=SEND_OK, msgId=AC110001F3237EA987AC6F72C5170003, offsetMsgId=AC181EC000002A9F000000014136B678, messageQueue=MessageQueue [topic=broker-a, brokerName=broker-a, queueId=0], queueOffset=60]
[root@localhost-001 bin]
[root@localhost-001 bin]

queryMsgByKey

作用：根据key查询消息

命令：mqadmin queryMsgByKey [-h] -k [-n ] -t

参数	含义	备注
-h,–help	打印help信息
-n,–namesrvAddr	nameserver服务地址列表
-t,–topic	topic名称
-k,–msgKey	消息key

示例：

[root@localhost-001 bin]
RocketMQLog:WARN No appenders could be found for logger (io.netty.util.internal.PlatformDependent0).
RocketMQLog:WARN Please initialize the logger system properly.

AC110001E0BD7EA987AC6F5319D10000                      5                                        0
AC110001E1347EA987AC6F5353DD0000                      7                                        0
AC110001E1727EA987AC6F537C7E0000                      7                                        1
AC110001E2697EA987AC6F55DD160000                      2                                        0
AC110001E5CC7EA987AC6F5AD1B30000                      1                                        0
AC110001DE177EA987AC6F4F1BE30000                      0                                        0
AC110001DE4D7EA987AC6F4F5A730000                      0                                        1
AC110001DE817EA987AC6F4FA88E0000                      3                                        0
AC110001DF467EA987AC6F509C6C0000                      3                                        1
[root@localhost-001 bin]

queryMsgById

作用：根据消息id查询消息

命令： [-d ] [-g ] [-h] -i [-n ] [-s ] [-u ]

参数	含义	备注
-h,–help	打印help信息
-n,–namesrvAddr	nameserver服务地址列表
-d,–clientId	消费者客户端id
-g,–consumerGroup	订阅组名称
-i,–msgId	消息id
-s,–sendMessage	resend message
-u,–unitName	unit name

示例：

[root@localhost-001 bin]
RocketMQLog:WARN No appenders could be found for logger (io.netty.util.internal.PlatformDependent0).
RocketMQLog:WARN Please initialize the logger system properly.
OffsetID:            AC181EC100002A9F000000018A727660
Topic:               zhurunhua
Tags:                [测试message]
Keys:                [test-key]
Queue ID:            2
Queue Offset:        0
CommitLog Offset:    6617724512
Reconsume Times:     0
Born Timestamp:      2023-03-01 15:08:31,339
Store Timestamp:     2023-03-01 15:08:31,345
Born Host:           172.24.30.192:25687
Store Host:          172.24.30.193:10911
System Flag:         0
Properties:          {KEYS=test-key, UNIQ_KEY=AC110001EBBC7EA987AC6F6552EB0000, CLUSTER=xdf-test1, WAIT=true, TAGS=测试message}
Message Body Path:   /tmp/rocketmq/msgbodys/AC110001EBBC7EA987AC6F6552EB0000`

queryMsgByUniqueKey

作用：根据唯一key查询消息

命令：mqadmin queryMsgByUniqueKey [-d ] [-g ] [-h] -i [-n ] -t

参数	含义	备注
-h,–help	打印help信息
-n,–namesrvAddr	nameserver服务地址列表
-d,–clientId	消费者客户端id
-g,–consumerGroup	订阅组名称
-i,–msgId	消息id
-t,–topic	topic名称

示例：

[root@localhost-001 bin]
RocketMQLog:WARN No appenders could be found for logger (io.netty.util.internal.PlatformDependent0).
RocketMQLog:WARN Please initialize the logger system properly.
Topic:               zhurunhua
Tags:                [测试message]
Keys:                [test-key1]
Queue ID:            1
Queue Offset:        0
CommitLog Offset:    5865661490
Reconsume Times:     0
Born Timestamp:      2023-03-01 14:57:02,899
Store Timestamp:     2023-03-01 14:57:02,904
Born Host:           172.24.30.192:56596
Store Host:          172.24.30.194:10911
System Flag:         0
Properties:          {KEYS=test-key1, UNIQ_KEY=AC110001E5CC7EA987AC6F5AD1B30000, CLUSTER=xdf-test1, WAIT=true, TAGS=测试message}
Message Body Path:   /tmp/rocketmq/msgbodys/AC110001E5CC7EA987AC6F5AD1B30000
[root@localhost-001 bin]`

queryMsgByOffset

作用：根据offset查询消息

命令：mqadmin queryMsgByOffset -b [-h] -i [-n ] -o -t

参数	含义	备注
-h,–help	打印help信息
-n,–namesrvAddr	nameserver服务地址列表
-t,–topic	topic名称
-b,–brokerName	broker名称	这里需要注意填写的是broker 的名称，不是broker 的地址，broker名称可以在clusterList 查到
-i,–queueId	队列id	默认是8个，queue id从0到7
-o,–offset	offset 值

示例：

[root@localhost-001 bin]
RocketMQLog:WARN No appenders could be found for logger (io.netty.util.internal.PlatformDependent0).
RocketMQLog:WARN Please initialize the logger system properly.
OffsetID:            AC181EC100002A9F000000018A6399BE
Topic:               zhurunhua
Tags:                [null]
Keys:                [test-key]
Queue ID:            6
Queue Offset:        0
CommitLog Offset:    6616750526
Reconsume Times:     0
Born Timestamp:      2023-03-01 14:42:15,770
Store Timestamp:     2023-03-01 14:42:15,775
Born Host:           172.24.30.192:26838
Store Host:          172.24.30.193:10911
System Flag:         0
Properties:          {MIN_OFFSET=0, MAX_OFFSET=1, KEYS=test-key, UNIQ_KEY=AC110001DD437EA987AC6F4D48590000, CLUSTER=xdf-test1, WAIT=true}
Message Body Path:   /tmp/rocketmq/msgbodys/AC110001DD437EA987AC6F4D48590000`

printMsg

作用：打印消息详情

命令：mqadmin printMsg [-b ] [-c ] [-d ] [-e ] [-h] [-n ] [-s ] -t

参数	含义	备注
-h,–help	打印help信息
-n,–namesrvAddr	nameserver服务地址列表
-t,–topic	topic名称
-b,–beginTimestamp	开始时间戳	时间戳或 yyyy-MM-dd#HH:mm:ss:SSS格式的时间
-c,–charsetName	字符编码名称	例如：UTF-8,GBK
-d,–printBody	是否打印消息体	true 、false
-e,–endTimestamp	结束时间戳
-s,–subExpression	Subscribe Expression

示例：

[root@localhost-001 bin]
RocketMQLog:WARN No appenders could be found for logger (io.netty.util.internal.PlatformDependent0).
RocketMQLog:WARN Please initialize the logger system properly.
minOffset=0, maxOffset=0, MessageQueue [topic=zhurunhua, brokerName=broker-c, queueId=7]minOffset=0, maxOffset=0, MessageQueue [topic=zhurunhua, brokerName=broker-b, queueId=6]minOffset=0, maxOffset=0, MessageQueue [topic=zhurunhua, brokerName=broker-a, queueId=5]minOffset=0, maxOffset=0, MessageQueue [topic=zhurunhua, brokerName=broker-b, queueId=7]minOffset=0, maxOffset=0, MessageQueue [topic=zhurunhua, brokerName=broker-a, queueId=6]minOffset=0, maxOffset=0, MessageQueue [topic=zhurunhua, brokerName=broker-a, queueId=7]minOffset=0, maxOffset=0, MessageQueue [topic=zhurunhua, brokerName=broker-c, queueId=0]minOffset=0, maxOffset=0, MessageQueue [topic=zhurunhua, brokerName=broker-c, queueId=1]minOffset=0, maxOffset=1, MessageQueue [topic=zhurunhua, brokerName=broker-b, queueId=0]MSGID: AC110001DE177EA987AC6F4F1BE30000 MessageExt [brokerName=broker-b, queueId=0, storeSize=195, queueOffset=0, sysFlag=0, bornTimestamp=1600757055459, bornHost=/172.24.30.192:34188, storeTimestamp=1600757055464, storeHost=/172.24.30.193:10911, msgId=AC181EC100002A9F000000018A64C05D, commitLogOffset=6616825949, bodyCRC=1801232349, reconsumeTimes=0, preparedTransactionOffset=0, toString()=Message{topic='zhurunhua', flag=0, properties={MIN_OFFSET=0, MAX_OFFSET=2, KEYS=test-key1, UNIQ_KEY=AC110001DE177EA987AC6F4F1BE30000, CLUSTER=xdf-test1, WAIT=true}, body=[116, 101, 115, 116, 45, 98, 111, 100, 121, 49], transactionId='null'}] BODY: test-body1
MSGID: AC110001DE4D7EA987AC6F4F5A730000 MessageExt [brokerName=broker-b, queueId=0, storeSize=195, queueOffset=1, sysFlag=0, bornTimestamp=1600757071475, bornHost=/172.24.30.192:39631, storeTimestamp=1600757071480, storeHost=/172.24.30.193:10911, msgId=AC181EC100002A9F000000018A6543C4, commitLogOffset=6616859588, bodyCRC=1801232349, reconsumeTimes=0, preparedTransactionOffset=0, toString()=Message{topic='zhurunhua', flag=0, properties={MIN_OFFSET=0, MAX_OFFSET=2, KEYS=test-key1, UNIQ_KEY=AC110001DE4D7EA987AC6F4F5A730000, CLUSTER=xdf-test1, WAIT=true}, body=[116, 101, 115, 116, 45, 98, 111, 100, 121, 49], transactionId='null'}] 
[root@localhost-001 bin]

printMsgByQueue

作用：通过queue id查询消息详情

命令： -a [-b ] [-c ] [-d ] [-e ] [-f ] [-h] -i [-n ] [-p ] [-s ] -t

参数	含义	备注
-h,–help	打印help信息
-n,–namesrvAddr	nameserver服务地址列表
-a,–brokerName	broker名称
-b,–beginTimestamp	开始时间戳	时间戳或 yyyy-MM-dd#HH:mm:ss:SSS
-e,–endTimestamp	结束时间戳
-c,–charsetName	字符编码名称	例如：UTF-8,GBK
-d,–printBody	print body
-f,–calculate	calculate by tag	true｜false(default)
-i,–queueId	队列id
-p,–print msg	是否打印消息	true｜false(default)
-s,–subExpression	Subscribe Expression
-t,–topic	topic名称

示例：

1	./mqadmin printMsgByQueue -n 172.24.30.192:9876 -a broker-b -t zhurunhua -i 0 -c UTF-8

consumeMessage

作用：消费消息

命令：mqadmin consumeMessage [-b ] [-c ] [-e ] [-g ] [-h] [-i ] [-n ] [-o ] [-s ] -t

参数	含义	备注
-h,–help	打印help信息
-n,–namesrvAddr	nameserver服务地址列表
-b,–brokerName	broker名称
-c,–MessageNumber	消费消息数量
-s,–beginTimestamp	开始时间	currentTimeMillis或yyyy-MM-dd#HH:mm:ss:SSS格式表示的时间
-e,–endTimestamp	结束时间
-g,–consumerGroup	消费者组名称
-i,–queueId	queue id
-o,–offset	queue offset
-t,–topic	topic名称

示例：

1	./mqadmin consumeMessage -n 172.24.30.192:9876 -t zhurunhua -b broker-a -c 3 -g zhurunhua

Group相关

updateSubGroup

作用：修改或创建订阅组

命令：mqadmin updateSubGroup [-a ] [-b ] [-c ] [-d ] -g [-h] [-i ] [-m ] [-n ] [-q ] [-r ] [-s ] [-w ]

参数	含义	备注
-a,–notifyConsumerIdsChanged	notify consumerId changed	true(默认)｜false
-b,–brokerAddr	broker 地址，表示订阅组建在该broker
-c,–clusterName	cluster名称，表示订阅组建在该集群
-d,–consumeBroadcastEnable	是否允许广播方式消费	true｜false(默认)
-g,–groupName	设置订阅组名称
-h,–help	打印help信息
-i,–brokerId	设置从哪个broker开始消费	默认0
-m,–consumeFromMinEnable	是否容许从队列的最小位置开始消费	true｜false(默认)
-n,–namesrvAddr	nameserver服务地址列表
-q,–retryQueueNums	消费失败的消息放到一个重试队列，每个订阅组配置几个重试队列	默认1
-r,–retryMaxTimes	重试消费最大次数	超过则投递到死信队列，不再投递，并报警；默认16
-s,–consumeEnable	消费功能是否开启	true(默认)｜false
-w,–whichBrokerWhenConsumeSlowly	发现消息堆积后，将Consumer的消费请求重定向到另外一台Slave机器	配置broker id，默认1

示例：

[root@localhost-001 bin]
RocketMQLog:WARN No appenders could be found for logger (io.netty.util.internal.PlatformDependent0).
RocketMQLog:WARN Please initialize the logger system properly.
create subscription group to 172.24.30.194:10911 success.
create subscription group to 172.24.30.193:10911 success.
create subscription group to 172.24.30.192:10911 success.
SubscriptionGroupConfig [groupName=zhurunhua-consume-group, consumeEnable=true, consumeFromMinEnable=true, consumeBroadcastEnable=true, retryQueueNums=8, retryMaxTimes=3, brokerId=0, whichBrokerWhenConsumeSlowly=1, notifyConsumerIdsChangedEnable=true][root@localhost-001 bin]
[root@localhost-001 bin]

注意：必须指定clusterName

deleteSubGroup

作用：删除订阅组

命令：mqadmin deleteSubGroup [-b ] [-c ] -g [-h] [-n ]

参数	含义	备注
-b,–brokerAddr	broker地址，表示在该broker删除订阅组
-c,–clusterName	cluster 名称，表示在该集群删除订阅组
-g,–groupName	指定删除的订阅组名称
-h,–help	打印help信息
-n,–namesrvAddr	nameserver 服务地址列表

示例：

[root@localhost-001 bin]
RocketMQLog:WARN No appenders could be found for logger (io.netty.util.internal.PlatformDependent0).
RocketMQLog:WARN Please initialize the logger system properly.
delete subscription group [zhurunhua-consume-group] from broker [172.24.30.194:10911] in cluster [xdf-test1] success.
delete subscription group [zhurunhua-consume-group] from broker [172.24.30.193:10911] in cluster [xdf-test1] success.
delete subscription group [zhurunhua-consume-group] from broker [172.24.30.192:10911] in cluster [xdf-test1] success.
delete topic [%RETRY%zhurunhua-consume-group] from cluster [xdf-test1] success.
delete topic [%RETRY%zhurunhua-consume-group] from NameServer success.
delete topic [%DLQ%zhurunhua-consume-group] from cluster [xdf-test1] success.
delete topic [%DLQ%zhurunhua-consume-group] from NameServer success.
[root@localhost-001 bin]

注意：必须指定clusterName

cloneGroupOffset

作用：从其他组克隆offset

命令： mqadmin cloneGroupOffset -d [-h] [-n ] [-o ] -s -t

参数	含义	备注
-h,–help	打印help信息
-n,–namesrvAddr	nameserver服务地址列表
-s,–srcGroup	源消费者组名称
-d,–destGroup	目标消费者组名称
-o,–offline	the group or the topic is offline	true
-t,–topic	topic名称

示例：

1	./mqadmin cloneGroupOffset -n 172.24.30.192:9876 -s zhurunhua-1 -d zhurunhua-2 -t zhurunhua

统计分析

brokerStatus

作用：获取broker运行时的状态数据

命令： mqadmin brokerStatus [-b ] [-c ] [-h] [-n ]

参数	含义	备注
-h,–help	打印help信息
-n,–namesrvAddr	nameserver服务地址列表
-b,–brokerAddr	broker地址
-c,–clusterName	集群名称

示例：

[root@localhost-001 bin]
RocketMQLog:WARN No appenders could be found for logger (io.netty.util.internal.PlatformDependent0).
RocketMQLog:WARN Please initialize the logger system properly.
EndTransactionQueueSize         : 0
EndTransactionThreadPoolQueueCapacity: 100000
bootTimestamp                   : 1600660736545
brokerVersion                   : 355
brokerVersionDesc               : V4_7_1
commitLogDirCapacity            : Total : 40.0 GiB, Free : 23.9 GiB.
commitLogDiskRatio              : 0.40273704594017096
commitLogMaxOffset              : 5389336601
commitLogMinOffset              : 5368709120
consumeQueueDiskRatio           : 0.40273704594017096
dispatchBehindBytes             : 0
dispatchMaxBuffer               : 0
earliestMessageTimeStamp        : 1600310170573
getFoundTps                     : 0.0 0.033330000333300004 0.046661689419795226
getMessageEntireTimeMax         : 8
getMissTps                      : 17.998200179982 27.1639502716395 26.75381292662116
getTotalTps                     : 17.998200179982 27.1972802719728 26.800474616040955
getTransferedTps                : 0.0 0.033330000333300004 0.046661689419795226
msgGetTotalTodayMorning         : 2185
msgGetTotalTodayNow             : 4046
msgGetTotalYesterdayMorning     : 0
msgPutTotalTodayMorning         : 2918
msgPutTotalTodayNow             : 5357
msgPutTotalYesterdayMorning     : 0
pageCacheLockTimeMills          : 0
pullThreadPoolQueueCapacity     : 100000
pullThreadPoolQueueHeadWaitTimeMills: 0
pullThreadPoolQueueSize         : 0
putMessageAverageSize           : 428.9402650737353
putMessageDistributeTime        : [<=0ms]:3 [0~10ms]:1 [10~50ms]:0 [50~100ms]:0 [100~200ms]:0 [200~500ms]:0 [500ms~1s]:0 [1~2s]:0 [2~3s]:0 [3~4s]:0 [4~5s]:0 [5~10s]:0 [10s~]:0 
putMessageEntireTimeMax         : 10
putMessageSizeTotal             : 2297833
putMessageTimesTotal            : 5357
putTps                          : 0.0 0.06666000066660001 0.09498986774744028
queryThreadPoolQueueCapacity    : 20000
queryThreadPoolQueueHeadWaitTimeMills: 0
queryThreadPoolQueueSize        : 0
remainHowManyDataToFlush        : 0 B
remainTransientStoreBufferNumbs : 2147483647
runtime                         : [ 1 days, 5 hours, 32 minutes, 46 seconds ]
...
...
[root@localhost-001 bin]`

注意：使用-c会查处所有broker状态信息，包含所有主、从，使用-b只能指定一个broker查询

brokerConsumeStats

作用：获取消耗统计数据

命令：mqadmin brokerConsumeStats -b [-h] [-l ] [-n ] [-o ] [-t ]

参数	含义	备注
-h,–help	打印help信息
-n,–namesrvAddr	nameserver服务地址列表
-b,–brokerAddr	broker地址
-l,–level	threshold of print diff
-o,–order	order topic
-t,–timeoutMillis	请求超时时间	单位：毫秒

示例：

[root@localhost-001 bin]
RocketMQLog:WARN No appenders could be found for logger (io.netty.util.internal.PlatformDependent0).
RocketMQLog:WARN Please initialize the logger system properly.

%RETRY%dfub-roster-data           dfub-roster-data                  broker-a                          0     13612                 13612                 0                     2023-03-01 17:37:20
dfub-jiaowu-roster-push-data-t    dfub-roster-data                  broker-a                          0     197                   197                   0                     2023-03-01 15:44:00
dfub-jiaowu-roster-push-data-t    dfub-roster-data                  broker-a                          1     203                   203                   0                     2023-03-01 16:21:09
dfub-jiaowu-roster-push-data-t    dfub-roster-data                  broker-a                          2     202                   202                   0                     2023-03-01 11:52:00
dfub-jiaowu-roster-push-data-t    dfub-roster-data                  broker-a                          3     195                   195                   0                     2023-03-01 15:16:21
dfub-jiaowu-roster-push-data-t    dfub-roster-data                  broker-a                          4     196                   196                   0                     2023-03-01 16:07:32
dfub-jiaowu-roster-push-data-t    dfub-roster-data                  broker-a                          5     201                   201                   0                     2023-03-01 17:25:41
dfub-jiaowu-roster-push-data-t    dfub-roster-data                  broker-a                          6     203                   203                   0                     2023-03-01 16:24:30
dfub-jiaowu-roster-push-data-t    dfub-roster-data                  broker-a                          7     207                   207                   0                     2023-03-01 17:33:16
......

producerConnection

作用：查询Producer 的网络连接，该命令只打印当前与cluster 连接的producer 网络连接信息

命令：mqadmin producerConnection -g [-h] [-n ] -t

参数	含义	备注
-h,–help	打印help信息
-n,–namesrvAddr	nameserver服务地址列表
-g,–producerGroup	生产者所属组名
-t,–topic	topic名称

示例：

1
2

consumerConnection

作用：查询Consumer的网络连接，该命令只打印当前与cluster连接的consumer网络连接信息

命令：mqadmin consumerConnection -g [-h] [-n ]

参数	含义	备注
-h,–help	打印help信息
-n,–namesrvAddr	nameserver服务地址列表
-g,–consumerGroup	消费者所属组名

示例：

[root@localhost-001 bin]
RocketMQLog:WARN No appenders could be found for logger (io.netty.util.internal.PlatformDependent0).
RocketMQLog:WARN Please initialize the logger system properly.
001  172.24.202.77@org.apache.rocketmq.spring.support.DefaultRocketMQListenerContainer_1 172.24.202.77:29200    JAVA     V4_5_1
002  10.155.86.170@org.apache.rocketmq.spring.support.DefaultRocketMQListenerContainer_1 10.155.86.170:60246    JAVA     V4_5_1
003  172.24.202.79@org.apache.rocketmq.spring.support.DefaultRocketMQListenerContainer_1 172.24.202.79:28141    JAVA     V4_5_1
004  10.155.87.190@org.apache.rocketmq.spring.support.DefaultRocketMQListenerContainer_1 10.155.87.190:62559    JAVA     V4_5_1

Below is subscription:001  Topic: ${rocketmq.producer.customized-lesson-delay-message-topic} SubExpression: *
002  Topic: %RETRY%dfub-lesson                       SubExpression: *
ConsumeType: CONSUME_PASSIVELY
MessageModel: CLUSTERING
ConsumeFromWhere: CONSUME_FROM_LAST_OFFSET
[root@localhost-001 bin]

consumerProgress

作用：查看订阅组消费状态

命令：mqadmin consumerProgress [-g ] [-h] [-n ] [-s ]

参数	含义	备注
-h,–help	打印help信息
-n,–namesrvAddr	nameserver服务地址列表
-g,–groupName	消费者所属组名
-s,–showClientIP	显示每个queue的客户端IP	true

示例：

[root@localhost-001 bin]
RocketMQLog:WARN No appenders could be found for logger (io.netty.util.internal.PlatformDependent0).
RocketMQLog:WARN Please initialize the logger system properly.

%RETRY%dfub-lvb-student-transfer  broker-a                          0     16                    16                    172.24.202.77        0                     N/A
%RETRY%dfub-lvb-student-transfer  broker-b                          0     0                     0                     172.24.202.77        0                     N/A
%RETRY%dfub-lvb-student-transfer  broker-c                          0     96                    96                    172.24.202.77        0                     N/A
dfub-banke-transfer-lesson-data-  broker-a                          0     1                     1                     172.24.202.77        0                     2023-03-01 15:55:15
dfub-banke-transfer-lesson-data-  broker-a                          1     2                     2                     172.24.202.77        0                     N/A
dfub-banke-transfer-lesson-data-  broker-a                          2     0                     0                     172.24.202.77        0                     N/A
dfub-banke-transfer-lesson-data-  broker-a                          3     1                     1                     172.24.202.77        0                     N/A
dfub-banke-transfer-lesson-data-  broker-a                          4     3                     3                     172.24.202.77        0                     N/A
dfub-banke-transfer-lesson-data-  broker-a                          5     3                     3                     172.24.202.77        0                     2020-09-18 16:02:10
dfub-banke-transfer-lesson-data-  broker-a                          6     7                     7                     172.24.202.77        0                     2020-09-21 10:38:30
dfub-banke-transfer-lesson-data-  broker-a                          7     1                     1                     172.24.202.77        0                     2020-09-17 21:27:31

consumerStatus

作用：查看消费者的内部数据结构

命令：mqadmin consumerStatus -g [-h] [-i ] [-n ] [-s]

参数	含义	备注
-h,–help	打印help信息
-n,–namesrvAddr	nameserver服务地址列表
-i,–clientId	消费者客户端id
-g,–consumerGroup	消费者所属组名
-s,–jstack	在消费者进程中运行jstack命令

示例：

[root@localhost-001 bin]
RocketMQLog:WARN No appenders could be found for logger (io.netty.util.internal.PlatformDependent0).
RocketMQLog:WARN Please initialize the logger system properly.
001  172.24.202.77@org.apache.rocketmq.spring.support.DefaultRocketMQListenerContainer_10 V4_5_1               1600767940334/172.24.202.77@org.apache.rocketmq.spring.support.DefaultRocketMQListenerContainer_10


Same subscription in the same group of consumer

Rebalance OK
[root@localhost-001 bin]

clusterList

作用：查看集群信息

命令：mqadmin clusterList [-h] [-i ] [-m] [-n ]

参数	含义	备注
-h,–help	打印help信息
-n,–namesrvAddr	nameserver服务地址列表
-i,–interval	指定间隔数	单位：秒
-m,–moreStats	打印更多信息

示例：

[root@localhost-001 bin]
RocketMQLog:WARN No appenders could be found for logger (io.netty.util.internal.PlatformDependent0).
RocketMQLog:WARN Please initialize the logger system properly.

xdf-test1         broker-a                                   2918           2185           2519           1909
xdf-test1         broker-a                                   3786              0           2519              0
xdf-test1         broker-b                                 155267         180068         116494          34032
xdf-test1         broker-b                                 180526              0         116494              0
xdf-test1         broker-c                                   7443          14816          92479         102952
xdf-test1         broker-c                                   7463           6598          92479              0

xdf-test1         broker-a                                   2918           2185           2520           1910
xdf-test1         broker-a                                   3786              0           2520              0
xdf-test1         broker-b                                 155267         180068         116602          34040
xdf-test1         broker-b                                 180526              0         116602              0
xdf-test1         broker-c                                   7443          14816          92587         103070
xdf-test1         broker-c                                   7463           6598          92587              0`

注意：若指定了-i，则会每经过指定秒数刷新一次，不指定则只打印一次

statsAll

作用：查看topic和consumer的tps信息

命令：mqadmin statsAll [-a] [-h] [-n ] [-t ]

参数	含义	备注
-h,–help	打印help信息
-n,–namesrvAddr	nameserver服务地址列表
-a,–activeTopic	只打印活跃的topic信息
-t,–topic	只打印指定的topic

示例：

[root@localhost-001 bin]
RocketMQLog:WARN No appenders could be found for logger (io.netty.util.internal.PlatformDependent0).
RocketMQLog:WARN Please initialize the logger system properly.

zhurunhua                                                                     0        0.00                         13    NO_CONSUMER
[root@localhost-001 bin]

checkMsgSendRT

作用：检查消息发送响应时间

命令：mqadmin checkMsgSendRT [-a ] [-h] [-n ] -s -t

参数	含义	备注
-h,–help	打印help信息
-n,–namesrvAddr	nameserver服务地址列表
-a,–amount	消息数量	默认：100
-s,–size	消息大小	默认：128 Byte
-t,–topic	topic名称

示例：

[root@localhost-001 bin]
RocketMQLog:WARN No appenders could be found for logger (io.netty.util.internal.PlatformDependent0).
RocketMQLog:WARN Please initialize the logger system properly.

broker-b                          0     true                    211
broker-b                          1     true                    2
broker-b                          2     true                    7
broker-b                          3     true                    2
broker-b                          4     true                    3
broker-b                          5     true                    3
broker-b                          6     true                    3
broker-b                          7     true                    3
broker-c                          0     true                    6
broker-c                          1     true                    3
Avg RT: 3.56
[root@localhost-001 bin]` 

![](https://csdnimg.cn/release/blogv2/dist/pc/img/newCodeMoreWhite.png)

clusterRT

作用：列出所有cluster消息发送响应时间

命令：mqadmin clusterRT [-a ] [-c ] [-h] [-i ] [-m ] [-n ] [-p ] -s

参数	含义	备注
-h,–help	打印help信息
-n,–namesrvAddr	nameserver服务地址列表
-a,–amount	消息数量	默认：100
-c,–cluster	指定cluster名称	不指定则打印所有
-i,–interval	打印间隔	默认：10秒
-m,–machine room	机器room name	默认：noname
-p,–print log	以日志形式打印	true
-s,–size	消息大小	默认：128 Byte

示例：

[root@localhost-001 bin]
RocketMQLog:WARN No appenders could be found for logger (io.netty.util.internal.PlatformDependent0).
RocketMQLog:WARN Please initialize the logger system properly.

xdf-test1                 broker-b                  1.82      50                0               
xdf-test1                 broker-c                  1.53      50                0               
xdf-test1                 broker-a                  1.27      50                0               
xdf-test1                 broker-b                  1.78      50                0               
xdf-test1                 broker-c                  1.49      50                0               
xdf-test1                 broker-a                  0.88      50                0               
xdf-test1                 broker-b                  0.90      50                0               
xdf-test1                 broker-c                  1.08      50                0               
xdf-test1                 broker-a                  0.94      50                0               
xdf-test1                 broker-b                  0.86      50                0               
xdf-test1                 broker-c                  0.92      50                0               
xdf-test1                 broker-a                  0.49      50                0   

[root@localhost-001 log]
[root@localhost-001 bin]
RocketMQLog:WARN No appenders could be found for logger (io.netty.util.internal.PlatformDependent0).
RocketMQLog:WARN Please initialize the logger system properly.
2023-03-01 17:56:26|noname|xdf-test1|broker-b|2
2023-03-01 17:56:26|noname|xdf-test1|broker-c|2
2023-03-01 17:56:27|noname|xdf-test1|broker-a|1
2023-03-01 17:56:30|noname|xdf-test1|broker-b|1
2023-03-01 17:56:30|noname|xdf-test1|broker-c|2
2023-03-01 17:56:30|noname|xdf-test1|broker-a|1
2023-03-01 17:56:33|noname|xdf-test1|broker-b|1
2023-03-01 17:56:33|noname|xdf-test1|broker-c|1
2023-03-01 17:56:33|noname|xdf-test1|broker-a|1`

queryCq

作用：查询cq命令

命令： mqadmin queryCq [-b ] [-c ] [-g ] [-h] -i [-n ] -q -t

参数	含义	备注
-h,–help	打印help信息
-n,–namesrvAddr	nameserver服务地址列表
-b,–broker	broker地址
-c,–count	设置数量
-g,–consumer	设置消费者组名称
-i,–index	设置queue开始索引
-q,–queue	设置queue数量
-t,–topic	topic名称

示例：

[root@localhost-001 bin]
RocketMQLog:WARN No appenders could be found for logger (io.netty.util.internal.PlatformDependent0).
RocketMQLog:WARN Please initialize the logger system properly.
Queue data: 
max: 1, min: 0
======================================
idx: 0
ConsumeQueueData{physicOffset=6609928052, physicSize=395, tagsCode=0, extendDataJson='null', bitMap='null', eval=false, msg='null'}
======================================
[root@localhost-001 bin]
[root@localhost-001 bin]

运维管理

wipeWritePerm

作用：清除特定Brokerd的写权限

命令：mqadmin wipeWritePerm -b [-h] [-n ]

参数	含义	备注
-h,–help	打印help信息
-n,–namesrvAddr	nameserver服务地址列表
-b,–brokerName	broker name

示例：

[root@localhost-001 bin]
RocketMQLog:WARN No appenders could be found for logger (io.netty.util.internal.PlatformDependent0).
RocketMQLog:WARN Please initialize the logger system properly.
wipe write perm of broker[broker-a] in name server[172.24.30.192:9876] OK, 187
[root@localhost-001 bin]

resetOffsetByTime

作用：通过时间戳重置消费者offset（不用重启客户端）

命令：mqadmin resetOffsetByTime [-c] [-f ] -g [-h] [-n ] -s -t

参数	含义	备注
-h,–help	打印help信息
-n,–namesrvAddr	nameserver服务地址列表
-c,–cplus	重置客户端offset
-f,–force	通过时间戳强制回滚	true、false，默认为true
-g,–group	消费者所属组名
-s,–timestamp	设置时间戳	选项：now、currentTimeMillis、yyyy-MM-dd#HH:mm:ss:SSS
-t,–topic	topic名称

示例：

1	./mqadmin resetOffsetByTime -n 172.24.30.192:9876 -g zhurunhua-1 -s now -t zhurunhua

cleanExpiredCQ

作用：清理过期的消费者队列

命令：mqadmin cleanExpiredCQ [-b ] [-c ] [-h] [-n ]

参数	含义	备注
-h,–help	打印help信息
-n,–namesrvAddr	nameserver服务地址列表
-b,–brokerAddr	broker地址
-c,–cluster	集群名称

示例：

[root@localhost-001 bin]
RocketMQLog:WARN No appenders could be found for logger (io.netty.util.internal.PlatformDependent0).
RocketMQLog:WARN Please initialize the logger system properly.
success
[root@localhost-001 bin]

startMonitoring

作用：开启监控

命令：mqadmin startMonitoring [-h] [-n ]

参数	含义	备注
-h,–help	打印help信息
-n,–namesrvAddr	nameserver服务地址列表

示例：

1 2	./mqadmin startMonitoring -n 172.24.30.192:9876

allocateMQ

作用：分配MQ

命令：mqadmin allocateMQ [-h] -i [-n ] -t

参数	含义	备注
-h,–help	打印help信息
-n,–namesrvAddr	nameserver服务地址列表
-i,–ipList	ip列表
-t,–topic	topic名称

示例：

1
2

配置相关

getNamesrvConfig

作用：获取name server 配置

命令：mqadmin getNamesrvConfig [-h] [-n ]

参数	含义	备注
-h,–help	打印help信息
-n,–namesrvAddr	nameserver服务地址列表

示例：

[root@localhost-001 bin]
RocketMQLog:WARN No appenders could be found for logger (io.netty.util.internal.PlatformDependent0).
RocketMQLog:WARN Please initialize the logger system properly.
============172.24.30.192:9876============
serverChannelMaxIdleTimeSeconds                   =  120
listenPort                                        =  9876
serverCallbackExecutorThreads                     =  0
serverAsyncSemaphoreValue                         =  64
serverSocketSndBufSize                            =  65535
rocketmqHome                                      =  /neworiental/rocketmq-nameserver/rocketmq-all-4.7.1-bin-release
clusterTest                                       =  false
serverSelectorThreads                             =  3
useEpollNativeSelector                            =  false
orderMessageEnable                                =  false
serverPooledByteBufAllocatorEnable                =  true
kvConfigPath                                      =  /neworiental/rocketmq-nameserver/namesrv/kvConfig.json
serverWorkerThreads                               =  8
serverSocketRcvBufSize                            =  65535
productEnvName                                    =  center
serverOnewaySemaphoreValue                        =  256
configStorePath                                   =  /neworiental/rocketmq-nameserver/rocketmq-all-4.7.1-bin-release/conf/nameserver.conf
[root@localhost-001 bin]

注意：经测试，-n每次只能指定一个nameserver地址

updateNamesrvConfig

作用：修改name server 配置

命令：mqadmin updateNamesrvConfig [-h] -k [-n ] -v

参数	含义	备注
-h,–help	打印help信息
-n,–namesrvAddr	nameserver服务地址列表
-k,–key	config key值
-v,–value	config value值

示例：

[root@localhost-001 bin]
RocketMQLog:WARN No appenders could be found for logger (io.netty.util.internal.PlatformDependent0).
RocketMQLog:WARN Please initialize the logger system properly.
update name server config success![172.24.30.192:9876]
serverSelectorThreads : 5
[root@localhost-001 bin]

注意：每次只能修改一个nameserver

updateKvConfig

作用：创建或修改KV配置信息

命令：mqadmin updateKvConfig [-h] -k [-n ] -s -v

参数	含义	备注
-h,–help	打印help信息
-n,–namesrvAddr	nameserver服务地址列表
-s,–namespace	namespace值
-k,–key	key值
-v,–value	value值

示例：

1
2

deleteKvConfig

作用：删除KV配置信息

命令： mqadmin deleteKvConfig [-h] -k [-n ] -s

参数	含义	备注
-h,–help	打印help信息
-n,–namesrvAddr	nameserver服务地址列表
-k,–key	key值
-s,–namespace	namespace值

示例：

1
2

updateBrokerConfig

作用：更新broker配置文件

命令：mqadmin updateBrokerConfig [-b ] [-c ] [-h] -k [-n ] -v

参数	含义	备注
-b,–brokerAddr	broker地址，如果未指定-c，则必填
-c,–clusterName	cluster名称，如果未指定-b，则必填
-h,–help	打印help信息
-n,–namesrvAddr	nameserver服务地址列表
-k,–key	配置的key值
-v,–value	配置的value值

示例：

[root@localhost-001 bin]
RocketMQLog:WARN No appenders could be found for logger (io.netty.util.internal.PlatformDependent0).
RocketMQLog:WARN Please initialize the logger system properly.
update broker config success, 172.24.30.194:10911
update broker config success, 172.24.30.193:10911
update broker config success, 172.24.30.192:10911
[root@localhost-001 bin]

getBrokerConfig

作用：获取broker配置

命令：mqadmin getBrokerConfig [-b ] [-c ] [-h] [-n ]

参数	含义	备注
-h,–help	打印help信息
-n,–namesrvAddr	nameserver服务地址列表
-b,–brokerAddr	broker地址，如果未指定-c，则必填
-c,–clusterName	cluster名称，如果未指定-b，则必填

示例：

./mqadmin getBrokerConfig -n 172.24.30.192:9876 -c xdf-test1

./mqadmin getBrokerConfig -n 172.24.30.192:9876 -b localhost:10911

由于配置项过多，此处省略

注意：-c会打印出集群内的所有broker配置信息，-b可以打印指定的broker(只能指定一个)

updateAclConfig

作用：修改ACL配置yaml文件

命令：mqadmin updateAclConfig -a -b | -c [-g ] [-h] [-i ] [-m ] [-n ] [-s ] [-t ] [-u ] [-w ]

参数	含义	备注
-h,–help	打印help信息
-n,–namesrvAddr	nameserver服务地址列表
-a,–accessKey	在acl配置文件中配置accessKey
-b,–brokerAddr	指定修改acl配置文件的broker地址
-c,–clusterName	指定修改acl配置文件的cluster名称
-g,–groupPerms	配置组的权限列表	例如: groupD=DENY,groupD=SUB
-i,–defaultTopicPerm	设置默认的topic权限
-m,–admin	设置admin标识
-s,–secretKey	设置secretKey
-t,–topicPerms	设置topic权限列表	例如: topicA=DENY,topicD=SUB
-u,–defaultGroupPerm	设置默认的组权限
-w,–whiteRemoteAddress	设置ip白名单

示例：

1
2

deleteAccessConfig

作用：删除ACL配置

命令：mqadmin deleteAccessConfig -a -b | -c [-h] [-n ]

参数	含义	备注
-h,–help	打印help信息
-n,–namesrvAddr	nameserver服务地址列表
-a,–accessKey	设置accessKey
-b,–brokerAddr	指定broker地址
-c,–clusterName	指定cluster名称

示例：

1
2

clusterAclConfigVersion

作用：列出所有ACL配置版本信息

命令：mqadmin clusterAclConfigVersion -b | -c [-h] [-n ]

参数	含义	备注
-h,–help	打印help信息
-n,–namesrvAddr	nameserver服务地址列表
-b,–brokerAddr	指定broker地址
-c,–clusterName	指定cluster名称

示例：

1	./mqadmin clusterAclConfigVersion -n 172.24.30.192:9876 -b 172.24.30.192:10911

updateGlobalWhiteAddr

作用：修改acl配置的全局白名单

命令：mqadmin updateGlobalWhiteAddr -b | -c -g [-h] [-n ]

参数	含义	备注
-h,–help	打印help信息
-n,–namesrvAddr	nameserver服务地址列表
-b,–brokerAddr	指定broker地址
-c,–clusterName	指定cluster名称
-g,–globalWhiteRemoteAddresses	设置全局白名单列表	例如: 10.10.103.,192.168.0.

示例：

1
2

getAccessConfigSubCommand

作用：列出所有acl配置信息

命令：mqadmin getAccessConfigSubCommand -b | -c [-h] [-n ]

参数	含义	备注
-h,–help	打印help信息
-n,–namesrvAddr	nameserver服务地址列表
-b,–brokerAddr	指定broker地址
-c,–clusterName	指定cluster名称

示例：

1 2	./mqadmin getAccessConfigSubCommand -n 172.24.30.192:9876 -b 172.24.30.192:10911

updateOrderConf

作用：创建、修改或删除order conf

命令：mqadmin updateOrderConf [-h] -m [-n ] -t [-v ]

参数	含义	备注
-h,–help	打印help信息
-n,–namesrvAddr	nameserver服务地址列表
-m,–method	操作类型	例如：put、get、delete
-t,–topic	topic名称
-v,–orderConf	设置order conf

示例：

1
2

官方误笔

已提交PR，并被官方合并至master分支

这儿acl少了个a，to应该是from

这儿做的是查询操作，但是写的是update

参考

https://blog.csdn.net/sinat_14840559/article/details/111934325

使用Coding持续集成结合腾讯云Serverless部署应用

2023-02-26T13:52:41.000Z

说到搭建网站，相信大家第一反应都是会去购买一台云服务器，然后根据网上的教程，自己在云服务器上一顿操作，最终搭建出自己的网站。

这种在云服务上搭建网站的方式，确实相比以前自己买物理服务器来搭建网站的方式节省了很多开销，自己买物理服务器的话，起步价都是好几万的，而且这种大玩意放在家里也占地方。

但是购买云服务器的时候，我们其实是要掏钱向云服务厂商租用云服务器，一般都是以年为单位租用，不管你的网站是几千人访问，还是几个人访问，都是统一的价钱，即使云服务器后面闲置不用了，也已经产生了一年的租用费用。

我就在想，如果有这样”无服务器”搭建网站的方式，让我们可以不租用云服务器搭建网站，而是直接在云服务厂商里创建一个应用的方式搭建网站，再根据实际的流量来计费的话，那么我们就能节省这一笔租用云服务器的费用，而且也能降低搭建网站的门槛。

Serverless 是什么？

Serverless 是指 “无服务器架构”，这里的 “无服务器” 并不是指程序不需要服务器运行，而是指我们的开发工作不需要关注服务器底层的资源，就仿佛服务器不存在一样。

我们在通过租用云服务器搭建网站的时候，需要考虑要用怎样配置的云服务器，比如多大的内存、多大的带宽、多少核心的 CPU 等等。

而出现 Serverless 技术之后，这些东西都不需要我们考虑了，Serverless 会帮我们根据网站流量的大小分配相应的资源，也就是有自动伸缩的能力，同时也无需再对服务器进行运维了，无需不断的打系统补丁、应用补丁、无需进行数据备份、软件配置等工作了。

这么一看，是不是觉得 Serverless 很像一个「保姆」，帮我们打理一切繁琐的事情，让我们只需要关注应用本身。

但是没有服务器，如何来将程序、应用运行起来呢？这里要介绍的是 Serverless 下包含的两个概念：函数即服务（FaaS），后端即服务（BaaS）。

什么是「函数即服务」？

每一个函数就是一个服务，函数之间相互独立。函数（也可说方法）颗粒度更小，可以帮助应用获得极致弹性。让用户抛弃了对服务器的配置和管理，仅需编写和上传核心业务代码，交由平台完成部署、调度、流量分发、弹性伸缩等能力。

我们来看一张基于 FaaS 的架构图：

基于 FaaS 的服务器底层的关系从下到上依次是这样的：物理服务器（IaaS） > 虚拟机（PaaS） > 容器（PaaS） > 函数（FaaS）

什么是「后端即服务」？

其实大家已经使用很久了，这里的后端，指的就是各种云产品和云服务，例如对象存储，云数据库、云缓存等。这些产品或服务，用户直接开通即可使用，无需考虑部署、扩容、备份、优化、安全等各种运维工作，做到了开箱即用，无需自己去进行服务器或应用的维护和管理，因此同样也是 Serverless 的一部分。

“无服务器”搭建网站

腾讯云 Serverless 提供了很多基于无服务器应用框架 Serverless 架构的应用部署，开发者无需关心底层资源，即可快速部署完整可用的 Serverless 应用架构，具有资源编排、自动伸缩、事件驱动等能力，帮助开发者通过联动云资源，迅速构建 Serverless 应用。

基于serverless.yml文件

创建serverless.yml文件

component: website
name: navigation
app: navigation

inputs:
  src:
    src: ./src
    index: index.html
    error: index.html
  region: ap-guangzhou
  bucketName: navigation
  protocol: https

创建.env文件、填写值可从环境变量中获取

TENCENT_APP_ID=
TENCENT_SECRET_ID=
TENCENT_SECRET_KEY=
TENCENT_TOKEN=

静态配置的 Jenkinsfile

静态配置的 Jenkinsfile 将不会保存在代码仓库中。
所有的构建任务将统一使用该静态配置，不再使用代码仓库中的 Jenkinsfile

pipeline {
  agent any
  stages {
    stage('检出') {
      steps {
        checkout([$class: 'GitSCM',
        branches: [[name: GIT_BUILD_REF]],
        userRemoteConfigs: [[
          url: GIT_REPO_URL,
          credentialsId: CREDENTIALS_ID
        ]]])
      }
    }

    stage('初始化 Node.js') {
      steps {
        sh 'env'
        sh 'date'
        sh 'echo TENCENT_SECRET_ID=$TENCENT_TEMP_SECRET_ID >> .env'
        sh 'echo TENCENT_SECRET_KEY=$TENCENT_TEMP_SECRET_KEY >> .env'
        sh 'echo TENCENT_TOKEN=$TENCENT_TEMP_TOKEN >> .env'
        sh 'echo TENCENT_APP_ID=$TENCENT_APP_ID >> .env'
        sh 'echo SERVERLESS_PLATFORM_VENDOR=tencent >> .env'
        sh 'echo SERVERLESS_PLATFORM_STAGE=$SERVERLESS_PLATFORM_STAGE >> .env'
      }
    }

    stage('安装 Severless 环境') {
      steps {
        sh 'pnpm install -g serverless-tencent'
        sh 'slt -v'
      }
    }

    stage('部署应用') {
      steps {
        sh 'slt deploy --debug'
      }
    }

  }
}

基于Jenkinsfile文件

pipeline {
  agent any
  stages  {
    stage("检出") {
      steps {
        checkout(
          [$class: 'GitSCM',
          branches: [[name: GIT_BUILD_REF]],
          userRemoteConfigs: [[
            url: GIT_REPO_URL,
              credentialsId: CREDENTIALS_ID
            ]]]
        )
      }
    }
        
    stage("初始化 Node.js") {
      steps {
        sh 'env'
        sh 'date'
        sh 'echo TENCENT_SECRET_ID=$TENCENT_TEMP_SECRET_ID >> .env'
        sh 'echo TENCENT_SECRET_KEY=$TENCENT_TEMP_SECRET_KEY >> .env'
        sh 'echo TENCENT_TOKEN=$TENCENT_TEMP_TOKEN >> .env'
        sh 'echo TENCENT_APP_ID=$TENCENT_APP_ID >> .env'
        sh 'echo SERVERLESS_PLATFORM_VENDOR=tencent >> .env'
        sh 'echo SERVERLESS_PLATFORM_STAGE=$SERVERLESS_PLATFORM_STAGE >> .env'
        sh '''cat > npm.sh << EOF
#! /bin/bash
rootPath=\\`pwd\\`
function read_dir(){
  for file in \\`ls \\$1\\`
  do
    if [ -d \\$1'/'\\$file ]; then
      if [ \\$file != 'node_modules' ]; then
        read_dir \\$1'/'\\$file
      fi
    else
      if [ \\$file = 'package.json' ]; then
        cd \\$1
        npm install
        cd \\$rootPath
      fi
    fi
  done
}
read_dir \\$1
EOF'''
        sh 'cat npm.sh && ls -la'
      }
    }

    stage("安装 Severless 环境") {
      steps {
        sh 'pnpm install -g serverless-tencent'
        sh 'slt -v'
      }
    }

    stage("安装依赖") {
      steps {
        sh 'rm -rf ./node_modules'
        sh 'chmod +x ./npm.sh && ./npm.sh `pwd` && rm npm.sh'
      }
    }

    stage("生成配置文件") {
      steps {
        sh 'npm install -g @slsplus/cli'
        sh 'slsplus parse --output --auto-create --sls-options=\'{"component":"scf","name":"${env:INSTANCE_NAME}","org":"${env:TENCENT_APP_ID}","app":"${env:APP_NAME}","stage":"${env:STAGE}","inputs":{"region":"${env:REGION}","runtime":"${env:RUNTIME}","src":"./src","handler": "index.main_handler","events":[{"apigw": {"parameters": {"endpoints": [{"function": {"isIntegratedResponse": true},"method": "ANY","path": "/static"}],"environment": "release","protocols": ["http","https"]}}}]}}\' && cat serverless.yml'
      }
    }

    stage('部署应用') {
        steps {
            sh "slt deploy --debug"
        }
    }

  }
}

旧版本的Jenkinsfile文件

pipeline {
    agent any
  
    stages {
      stage("Downloading code") {
        steps {
            checkout(
                [$class: 'GitSCM', branches: [[name: env.GIT_BUILD_REF]],
                userRemoteConfigs: [[url: env.GIT_REPO_URL, credentialsId: env.CREDENTIALS_ID]]]
            )      
          }
      }
  
      stage("Installing plugins") {
       steps {  
          sh 'pnpm install -g serverless-tencent'
          sh 'slt -v' 
         }
      }
      stage("Build environment") {
        steps {
            webSite()      
        }
      }
  
      stage("Deploying serverless project") {
        steps {
          sh 'slt deploy --debug'
        }
      }
  
    }
  }

总结

这次我基于腾讯云 Serverless 带大家展示了网站搭建的过程，这种方式打破了以前搭建网站需要租借云服务器的方式。

无需购买云服务器，只需要在腾讯云 Serverless 里直接创建网站的应用就完成了网站的搭建，再也不用花费精力配置环境和维护云服务器的精力，动动鼠标点击就可以轻松地完成网站的搭建了，更重要的是，它是按量付费的，能确保所有的费用，都是用在了实际的程序运行、数据存储、用户访问中，不必为未使用的计算资源而支付。

资料

部署静态网站

使用Coding持续集成构建流水线自动部署自建静态网站

2023-02-25T12:46:37.000Z

CODING 持续集成便是专门为此工作流而设计的得力功能。通过对每次提交的代码进行自动化的代码检查、单元测试、编译构建、甚至自动部署与发布，能够大大降低开发人员的工作负担，减少许多不必要的重复劳动，持续提升代码质量与开发效率。毫无疑问，持续集成是开发者与研发团队的福音。

背景

静态网站无需购买昂贵的服务器，建议使用先进架构：云存储 + CDN，优点：

成本低：云存储/CDN 比服务器便宜很多（比如「腾讯云对象存储 COS」约 0.15 元/GB/月、腾讯云 CDN 每月赠送 10GB）；
访问快：CDN 能在全国甚至全球快速访问，比服务器更快。

提醒：

如果网站面向中国境内用户，需要进行域名备案，然后才能绑定到境内的云存储/CDN。本文以腾讯云为例，其他云计算厂商的流程也类似。
如果网站面向中国境外用户，可直接使用境外云存储/CDN 搭建静态网站。

静态网站有 2 种：

无内容的单页应用：VUE/React SPA；
有内容的页面：HTML 或「程序生成 HTML」；

警告：VUE/React SPA 不带内容，难以被搜索引擎收录，不适合作为公司官网、个人博客。如果有 SEO 需求，推荐使用 MkDocs、Hexo、VUE Nuxt、React Next。

技术方案

通过「持续集成」把 HTML 自动部署到「云存储」，变成静态网站。

把项目代码推送到「CODING 代码仓库」。
在「腾讯云对象存储 COS」中创建一个「公有读私有写」的「存储桶」，并在设置中开启「静态网站」，即可获得一个访问链接，然后在「腾讯云账号」的「访问管理」中获取「访问密钥」。
在「CODING 持续集成」中创建一个构建任务，把下文的 Jenkinsfile 复制进去，设置环境变量，然后手动「立即构建」，构建成功，访问上面的链接即可看到网站。下次推送代码即可自动部署。
如果你的域名已备案，则可在「腾讯云对象存储」的设置中绑定「自定义加速域名」，会提示开通「内容分发网络 CDN」，小型网站建议选择「按使用流量计费」（每月赠送 10GB，小型网站一般用不完），然后进入「内容分发网络 CDN」——「域名管理」——某个域名——「高级设置」——「HTTPS 配置」中，申请免费的 HTTPS 证书，并开启「HTTPS 回源」、「强制跳转 HTTPS」和「HTTP 2.0」。
在「腾讯云对象存储 COS」中开启「自动刷新 CDN」，参考文档「CDN 缓存刷新」。

Jenkinsfile

浏览完整代码。

pipeline {
  agent any
  stages {
    stage('检出') {
      steps {
        checkout([
          $class: 'GitSCM',
          branches: [[name: env.GIT_BUILD_REF]], 
          userRemoteConfigs: [[url: env.GIT_REPO_URL, credentialsId: env.CREDENTIALS_ID]]
        ])
      }
    }
    stage('部署到腾讯云存储') {
      steps {
        sh "coscmd config -a ${env.COS_SECRET_ID} -s ${env.COS_SECRET_KEY} -b ${env.COS_BUCKET_NAME} -r ${env.COS_BUCKET_REGION}"
        sh 'rm -rf .git'
        sh 'coscmd upload -r ./ /'
      }
    }
  }
}

持续集成环境变量

变量名	含义	参考值
COS_SECRET_ID	腾讯云访问密钥 ID	stringLength36stringLength36string36
COS_SECRET_KEY	腾讯云访问密钥 KEY	stringLength32stringLength323232
COS_BUCKET_NAME	腾讯云对象存储桶	devops-host-1257110097
COS_BUCKET_REGION	腾讯云对象存储区域	ap-nanjing

截图

各种语言生成 HTML

MKDocs

浏览完整代码。

pipeline {
  agent any
  stages {
    stage('检出') {...}
    stage('构建') {
      steps {
        echo 'Markdown 转成 HTML'
        sh 'pip install --upgrade mkdocs six'
        sh 'mkdocs build --clean'
      }
    }
    stage('部署到云存储') {
      steps {
        sh "coscmd config ..."
        sh 'coscmd upload -r site/ /'
      }
    }
  }
}

VUE Nuxt

浏览完整代码。

pipeline {
  agent any
  stages {
    stage('检出') {...}
    stage('构建') {
      steps {
        echo 'VUE Nuxt 生成 HTML'
        sh 'npm install'
        sh 'npm run generate'
      }
    }
    stage('部署到云存储') {
      steps {
        sh "coscmd config ..."
        sh 'coscmd upload -r dist/ /'
      }
    }
  }
}

VUE

浏览完整代码。

pipeline {
  agent any
  stages {
    stage('检出') {...}
    stage('构建') {
      steps {
        echo 'VUE 生成 HTML'
        sh 'npm install'
        sh 'npm run build'
      }
    }
    stage('部署到云存储') {
      steps {
        sh "coscmd config ..."
        sh 'coscmd upload -r dist/ /'
      }
    }
  }
}

React

pipeline {
  agent any
  stages {
    stage('检出') {...}
    stage('构建') {
      steps {
        echo 'React 生成 HTML'
        sh 'npm install'
        sh 'npm run build'
      }
    }
    stage('部署到云存储') {
      steps {
        sh "coscmd config ..."
        sh 'coscmd upload -r build/ /'
      }
    }
  }
}

参考

https://coding.net/help/docs/devops/ci/practice/static-website-paas.html

Spring Cloud Alibaba 简介

2020-09-06T08:37:21.000Z

Spring Cloud Alibaba 致力于提供微服务开发的一站式解决方案。此项目包含开发分布式应用微服务的必需组件，方便开发者通过 Spring Cloud 编程模型轻松使用这些组件来开发分布式应用服务。

Spring Cloud Alibaba

官方 github 地址

主要功能

服务限流降级：默认支持 WebServlet、WebFlux, OpenFeign、RestTemplate、Spring Cloud Gateway, Zuul, Dubbo 和 RocketMQ 限流降级功能的接入，可以在运行时通过控制台实时修改限流降级规则，还支持查看限流降级 Metrics 监控。
服务注册与发现：适配 Spring Cloud 服务注册与发现标准，默认集成了 Ribbon 的支持。
分布式配置管理：支持分布式系统中的外部化配置，配置更改时自动刷新。
消息驱动能力：基于 Spring Cloud Stream 为微服务应用构建消息驱动能力。
分布式事务：使用 @GlobalTransactional 注解，高效并且对业务零侵入地解决分布式事务问题。。
阿里云对象存储：阿里云提供的海量、安全、低成本、高可靠的云存储服务。支持在任何应用、任何时间、任何地点存储和访问任意类型的数据。
分布式任务调度：提供秒级、精准、高可靠、高可用的定时（基于 Cron 表达式）任务调度服务。同时提供分布式的任务执行模型，如网格任务。网格任务支持海量子任务均匀分配到所有 Worker（schedulerx-client）上执行。
阿里云短信服务：覆盖全球的短信服务，友好、高效、智能的互联化通讯能力，帮助企业迅速搭建客户触达通道。

组件

Sentinel：把流量作为切入点，从流量控制、熔断降级、系统负载保护等多个维度保护服务的稳定性。
Nacos：一个更易于构建云原生应用的动态服务发现、配置管理和服务管理平台。
RocketMQ：一款开源的分布式消息系统，基于高可用分布式集群技术，提供低延时的、高可靠的消息发布与订阅服务。
Dubbo：Apache Dubbo™ 是一款高性能 Java RPC 框架。
Seata：阿里巴巴开源产品，一个易于使用的高性能微服务分布式事务解决方案。
Alibaba Cloud ACM：一款在分布式架构环境中对应用配置进行集中管理和推送的应用配置中心产品。
Alibaba Cloud OSS: 阿里云对象存储服务（Object Storage Service，简称 OSS），是阿里云提供的海量、安全、低成本、高可靠的云存储服务。您可以在任何应用、任何时间、任何地点存储和访问任意类型的数据。
Alibaba Cloud SchedulerX: 阿里中间件团队开发的一款分布式任务调度产品，提供秒级、精准、高可靠、高可用的定时（基于 Cron 表达式）任务调度服务。
Alibaba Cloud SMS: 覆盖全球的短信服务，友好、高效、智能的互联化通讯能力，帮助企业迅速搭建客户触达通道。

如何使用

如何引入依赖
如果需要使用已发布的版本，在 dependencyManagement 中添加如下配置。

<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>com.alibaba.cloudgroupId>
            <artifactId>spring-cloud-alibaba-dependenciesartifactId>
            <version>2.1.0.RELEASEversion>
            <type>pomtype>
            <scope>importscope>
        dependency>
    dependencies>
dependencyManagement>

然后在 dependencies 中添加自己所需使用的依赖即可使用。

版本管理规范

项目的版本号格式为 x.x.x 的形式，其中 x 的数值类型为数字，从 0 开始取值，且不限于 0~9 这个范围。项目处于孵化器阶段时，第一位版本号固定使用 0，即版本号为 0.x.x 的格式。
由于 Spring Boot 1 和 Spring Boot 2 在 Actuator 模块的接口和注解有很大的变更，且 spring-cloud-commons 从 1.x.x 版本升级到 2.0.0 版本也有较大的变更，因此我们采取跟 SpringBoot 版本号一致的版本:

1.5.x 版本适用于 Spring Boot 1.5.x
2.0.x 版本适用于 Spring Boot 2.0.x
2.1.x 版本适用于 Spring Boot 2.1.x
Spring Boot Spring Cloud Spring Cloud Alibaba
2.1.x Greenwich 0.9.x
2.0.x Finchley 0.2.x
1.5.x Edgware 0.1.x
1.5.x Dalston 0.1.x

现状

之前 spring cloud alibaba 一直处于一个孵化状态。看名字就可以看出来 Spring Cloud 有着密切的关系。2019 月 7 月 24 日，Spring 官方宣布 Spring Cloud Alibaba 毕业，仓库迁移至 Alibaba Github OSS 下。这意味着 Spring Cloud Alibaba 是国内首个进入 Spring 社区的开源项目。

2018 年 7 月，正式开源，进入孵化器。
2018 年 10 月，发布开源后的第一个版本 0.1.0 & 0.2.0 (适配 Spring Cloud Edgware & Finchley )，包含 Nacos Config, Nacos Discovery、 Sentinel 以及 OSS 4 个组件。
2018 年 12 月，发布第二个版本 0.1.1 & 0.2.1，新增 Spring Cloud Stream RocketMQ Binder 和 Spring Cloud Bus RocketMQ 组件。
2019 年 4 月，发布 Preview Release 版本 0.9.0, 0.1.2 & 0.2.2 (首次适配 Spring Cloud Greenwich )，新增 Dubbo Spring Cloud、Seata 组件。颠覆性地使用 Spring Cloud 客户端调用 Dubbo 服务
2019 年 7 月，Spring Cloud 官方宣布 Spring Cloud Alibaba 毕业。
2019 月 8 月，发布毕业后的第一个版本 1.5.0, 2.0.0 & 2.1.0。新增 spring-cloud-alibaba-sentinel-gateway 模块以完善 Sentinel 对 Spring Cloud 体系 Gateway 的支持。

Spring 社区 spring cloud alibaba 官方地址

我们都知道 Spring Restful Api 的规范性是我们喜欢的，规范代表着通用。而 dubbo 目前看来性能的收益也是让大家能感受到的。而 Spring Cloud Alibaba 的出现兼容这俩种微服务生态的优势。让鱼与熊掌不可兼得的情况提供了一个更好的方案。
个人觉得 Spring Cloud Alibaba 为喜欢 cloud、dubbo 俩种微服务的整合提供了一个较好的方案。但是会让感觉商业气息有点浓烈。毕竟阿里也是主要是为了推自己的产品服务

Spring Cloud Alibaba 使用

2020-09-06T08:31:56.000Z

Spring Cloud Alibaba 致力于提供微服务开发的一站式解决方案。此项目包含开发分布式应用微服务的必需组件，方便开发者通过 Spring Cloud 编程模型轻松使用这些组件来开发分布式应用服务。
依托 Spring Cloud Alibaba，您只需要添加一些注解和少量配置，就可以将 Spring Cloud 应用接入阿里微服务解决方案，通过阿里中间件来迅速搭建分布式应用系统。

一. 为什么使用？

很多人可能会问，有了 spring cloud 这个微服务的框架，为什么又要使用 spring cloud alibaba 这个框架了？最重要的原因在于 spring cloud 中的几乎所有的组件都使用 Netflix 公司的产品，然后在其基础上做了一层封装。然而 Netflix 的服务发现组件 Eureka 已经停止更新，我们公司在使用的时候就发现过其一个细小的 Bug；而其他的众多组件预计会在明年(即 2020 年)停止维护。所以急需其他的一些替代产品，也就是 spring cloud alibaba，目前正处于蓬勃发展的态式。

二. 注册中心 Nacos

nacos 是阿里巴巴研发的一个集注册中心与配置中心于一体的管理平台，使用其他非常的简单。下载地址为：
https://github.com/alibaba/nacos/releases，nacos 的主页如下图所示：

其中默认的登录名和密码是：nacos/nacos

2.1 更改用户名和密码

A. 分别执行 conf 目录下的 nacos-mysql.sql 两个脚本文件，生成的数据表如下：

B. 重新配置密码
新建一个 springboot 的项目，引入如下的依赖：

<dependency>
   <groupId>org.springframework.bootgroupId>
   <artifactId>spring-boot-starter-securityartifactId>
dependency>

生成密码的 Java 代码：
// 密码加密处理

public static void main(String[] args) {
   BCryptPasswordEncoder bCryptPasswordEncoder = new BCryptPasswordEncoder();
   // 生成的密码为：$2a$10$04MGTL.cJNZPpR3rFt/I2.43F.V75NH.5wdK.jngaO9Mc91mfonAO
    System.out.println(bCryptPasswordEncoder.encode("admin"));
}

执行如下sql命令：

1 2	insert into users values('nacos','$2a$10$04MGTL.cJNZPpR3rFt/I2.43F.V75NH.5wdK.jngaO9Mc91mfonAO', 1); insert into roles values('nacos', 'ROLE_ADMIN')

C. 配置数据库的连接
在 conf 目录下的 application.properties 目录下加入如下内容：

spring.datasource.platform=mysql
db.num=1
db.url.0=jdbc:mysql://mysql:3306/cloud-alibaba?useSSL=false&serverTimezone=UTC&serverTimezone=Asia/Shanghai
db.user=root
db.password=

2.2 nacos 集群配置

A. 将 conf 目录下的 cluster.conf.example 拷贝一份重命名为 cluster.conf，在文件中加入所有集群节点的 ip 和端口号，文件内容如下：
127.0.0.1:8848
127.0.0.1:9948
B. 修改 windows 启动文件 startup.cmd 的配置，修改内容如下：
set MODE=”standalone” #默认的配置
set MODE=”cluster” #修改后的内容
注：如果是 Linux 环境不用作任何的修改。
C.启动两个 nacos，界面中出现如下的内容，表示集群配置成功

三. 服务提供方

pom.xml 依赖配置

<dependencies>
   <dependency>
       <groupId>org.springframework.bootgroupId>
       <artifactId>spring-boot-starter-webartifactId>
   dependency>
   <dependency>
       <groupId>org.springframework.cloudgroupId>
       <artifactId>spring-cloud-starter-alibaba-nacos-discoveryartifactId>
   dependency>
dependencies>
<dependencyManagement>
   <dependencies>
       <dependency>
           <groupId>org.springframework.cloudgroupId>
           <artifactId>spring-cloud-alibaba-dependenciesartifactId>
           <version>0.9.0.RELEASEversion>
           <type>pomtype>
           <scope>importscope>
       dependency>
       <dependency>
           <groupId>org.springframework.cloudgroupId>
           <artifactId>spring-cloud-dependenciesartifactId>
           <version>Greenwich.SR2version>
           <type>pomtype>
           <scope>importscope>
       dependency>
   dependencies>
dependencyManagement>

配置

spring:
 application:
   # 服务名
   name: alibaba-provider
 cloud:
   nacos:
     discovery:
       #必须配置 ip 地址
       server-addr: 172.18.96.177:8848,172.18.96.177:9948

启动类

@SpringBootApplication
@EnableDiscoveryClient  //开启 nacos 的服务发现
public class ProviderApplication {
   public static void main(String[] args) {
       SpringApplication.run(ProviderApplication.class, args);
   }
}

服务页面结果

四. 服务消费方

pom.xml 依赖配置

<dependencies>
   <dependency>
       <groupId>org.springframework.bootgroupId>
       <artifactId>spring-boot-starter-webartifactId>
   dependency>
   <dependency>
       <groupId>org.springframework.cloudgroupId>
       <artifactId>spring-cloud-starter-alibaba-nacos-discoveryartifactId>
   dependency>
dependencies>
<dependencyManagement>
   <dependencies>
       <dependency>
           <groupId>org.springframework.cloudgroupId>
           <artifactId>spring-cloud-alibaba-dependenciesartifactId>
           <version>0.9.0.RELEASEversion>
           <type>pomtype>
           <scope>importscope>
       dependency>
       <dependency>
           <groupId>org.springframework.cloudgroupId>
           <artifactId>spring-cloud-dependenciesartifactId>
           <version>Greenwich.SR2version>
           <type>pomtype>
           <scope>importscope>
       dependency>
   dependencies>
dependencyManagement>

配置

server:
 port: 8080
spring:
 application:
   # 服务名
   name: alibaba-consumer
 cloud:
   nacos:
     discovery:
       server-addr: 172.18.96.177:8848,172.18.96.177:9948
       # 不将自己的服务注册到注册中心
       register-enabled: false

启动类配置

@SpringBootApplication
@EnableDiscoveryClient
public class ConsumerApplication {
   public static void main(String[] args) {
       SpringApplication.run(ConsumerApplication.class, args);
   }
}

调用服务提供方

@RequestMapping
   public Object getUsers() {
       List list = discoveryClient.getInstances("alibaba-provider");
       String targetUrl = list.stream().map(si -> si.getUri() + "/user").findFirst().get();
       List resultList = restTemplate.getForObject(targetUrl, List.class);
       return resultList;
   }

五. Ribbon 负载均衡

Spring Cloud Ribbon 是基于 Netflix Ribbon 实现的一套客户端负载均衡的工具。其主要功能是提供客户端的负载均衡算法，并提供了完善的配置项如连接超时，重试等。简单的说，就是配置文件中列出 Load Balancer 后面所有的机器，Ribbon 会自动的基于某种规则(如简单轮询，随机连接等)去连接这些机器，当然我们也可以使用 Ribbon 自定义负载均衡算法。

5.1 实现负载均衡

Ribbon 只是一个客户端的负载均衡器工具，实现起来非常的简单，我们只需要在注入 RestTemplate 的 bean 上加上@LoadBalanced 就可以了。如下：

@Configuration
public class WebConfig {
   @LoadBalanced
   @Bean
   public RestTemplate restTemplate() {
       return new RestTemplate();
   }
}

5.2 服务消费方调用

// 直接写上服务名即可
List resultList = restTemplate.getForObject(“http://alibaba-provider/user“, List.class);

5.3 负载均衡策略

Ribbon 提供了一个很重要的接口叫做 IRule，其中定义了很多的负载均衡策略，默认的是轮询的方式，以下是 Ribbon 的负载均衡策略：

类名	描述
RoundRobbinRule	轮询
RandomRule	随机挑选
RetryRule	按照轮询的方式去调用服务，如果其中某个服务不可用，但是还是会尝试几次，如果尝试过几次都没有成功，那么就不在调用该服务，会轮询调用其他的可用服务。
AvailabilityFilteringRule	会先过滤掉因为多次访问不可达和并发超过阈值的服务，然后轮询调用其他的服务
WeightedResponseTimeRule	根据平均响应时间计算权重，响应越快权重越大，越容易被选中。服务刚重启的时候，还未统计出权重会按照轮询的方式；当统计信息足够的时候，就会按照权重信息访问
ZoneAvoidanceRule	判断 server 所在的区域性能和可用性选择服务器
BestAvailableRule	会过滤掉多次访问都不可达的服务，然后选择并发量最小的服务进行调用，默认方式

改变 Ribbon 的负责均衡策略：

@Bean
public IRule getRule() {
   return new RandomRule();
}

5.4 自定义负载均衡策略

我们自定义的负载均衡策略需要继承 AbstractLoadBalancerRule 这个类，然后重写 choose 方法，然后将其注入到容器中，如下所示：

public class Customize_Rule extends AbstractLoadBalancerRule {
   private static Logger logger = LoggerFactory.getLogger(Customize_Rule.class);
   private int currentIndex = 0; //当前调用的索引
   private int num = 1; //次数
   private int limit = 5;
   /**
    * 初始化工作
    * @param iClientConfig
    */
   @Override
   public void initWithNiwsConfig(IClientConfig iClientConfig) {
   }
   @Override
   public Server choose(Object key) {
       ILoadBalancer balancer = getLoadBalancer();
       return choose(balancer, key);
   }
   private Server choose(ILoadBalancer balancer, Object key) {
       Server server = null;
       while(null == server) {
           //获取所有可用的服务
           List reachableServers = balancer.getReachableServers();
           if (0 == reachableServers.size()) {
               logger.error("没有可用的服务");
               return null;  //退出 while 循环
           }
           int total = reachableServers.size(); //可用服务的数量
           synchronized (this) {
               /**
                * 有种极端情况，当我们在使用最后一个服务的时候，其他的服务都不可用，可能导致索引越界异常
                */
               if (currentIndex + 1 > total) {
                   currentIndex = 0;
                   server = reachableServers.get(currentIndex);  //获取第一个服务
                   num = 0;
                   num++;
               } else {
                   if(limit == num) {
                       currentIndex++;
                       num = 0;
                       if(currentIndex == total) {
                           currentIndex=0;
                           server = reachableServers.get(currentIndex);  //获取第一个服务
                           num++;
                       }else{
                           server = reachableServers.get(currentIndex);
                           num++;
                       }
                   }else {
                       server = reachableServers.get(currentIndex);
                       num++;
                   }
               }
           }
       }
       return server;
   }
}

将其注入到容器中，方式如下：

@Bean
public IRule getRule() {
   return new Customize_Rule();
}

六. Feign 负载均衡

feign 是基于 Ribbon 的另外一个负载均衡的客户端框架，只需要在接口上定义要调用的服务名即可，使用起来非常的简单。
pom.xml 依赖

<dependency>
   <groupId>org.springframework.cloudgroupId>
   <artifactId>spring-cloud-starter-openfeignartifactId>
dependency>

启动类配置
需要在启动类上加上@EnableFeignClients 这个注解

@SpringBootApplication
@EnableDiscoveryClient
@EnableFeignClients
public class ConsumerApplication {
   public static void main(String[] args) {
       SpringApplication.run(ConsumerApplication.class, args);
   }
}

服务接口配置

@FeignClient(name="alibaba-provider")
public interface UserService {
   @RequestMapping("/user")
   public List getUsers();
}

七. 熔断与服务降级

分布式系统中一个微服务需要依赖于很多的其他的服务，那么服务就会不可避免的失败。例如 A 服务依赖于 B、C、D 等很多的服务，当 B 服务不可用的时候，会一直阻塞或者异常，更不会去调用 C 服务和 D 服务。同时假设有其他的服务也依赖于 B 服务，也会碰到同样的问题，这就及有可能导致雪崩效应。
如下案例：一个用户通过通过 web 容器访问应用，他要先后调用 A、H、I、P 四个模块，一切看着都很美好。

由于某些原因，导致 I 服务不可用，与此同时我们没有快速处理，会导致该用户一直处于阻塞状态。

当其他用户做同样的请求，也会面临着同样的问题，tomcat 支持的最大并发数是有限的，资源都是有限的，将整个服务器拖垮都是有可能的。

Sentinel 是一个用于分布式系统的延迟和容错的开源库，在分布式系统中，许多依赖会不可避免的调用失败，例如超时，异常等，Hystrix 能保证在一个依赖出现问题的情况下，不会导致整体服务失败，避免级联故障，以提高分布式系统的弹性。
断路器本身是一种开关装置，当某个服务单元发生故障后，通过断路器的故障监控（类似于保险丝），向调用者返回符合预期的，可处理的备选响应，而不是长时间的等待或者抛出无法处理的异常，这样就保证了服务调用的线程不会被长时间，不必要的占用，从而避免故障在分布式系统中的蔓延，乃至雪崩。
Sentinel 在网络依赖服务出现高延迟或者失败时，为系统提供保护和控制;可以进行快速失败，缩短延迟等待时间；提供失败回退（Fallback）和相对优雅的服务降级机制；提供有效的服务容错监控、报警和运维控制手段。
下载地址：https://github.com/alibaba/Sentinel/releases

7.1 依赖

<dependency>
    <groupId>org.springframework.cloudgroupId>
    <artifactId>spring-cloud-starter-alibaba-sentinelartifactId>
dependency>

7.2 配置

通常情况下我们只需要在服务提供方实现熔断或者服务降级即可，但是如果要相对服务消费方是实现限流，在服务的提供方和消费方都需要加如下配置。

spring:
 cloud:
    sentinel:
     transport:
       # sentinel 控制台的地址
       dashboard: localhost:8080
     # 立即加载
     eager: true

7.3 sentinel 的控制面板

在浏览器输入 localhost:8080，使用 sentinel/sentinel 来访问 sentinel 的控制面板：

接下来对 sentinel 的控制面板一一讲解：
实时监控
用于查看接口调用的 QPS(Query Per Second)以及平均响应时间。
簇点链路
查看当前追踪的所有的访问接口，可以添加流量规则、降级规则、热点规则、授权规则。
流量规则

**资源名：**是需要控制的链路的名字，例如/student/all 等
针对来源: 默认为 default 表示所有，也可以针对特定的服务进行设置。
阈值类型: 是指如何进行限制，可以是 QPS，也可以是线程。
单机阈值: 是控制 QPS 或者线程的数量。
流量模式: 直接表示只是针对指定资源进行限制；关联是指当被关联的资源达到阈值时候，指定资源被限制访问；链路是更加细粒度的控制，控制指定资源对链路的限制。
流控效果: 快速失败是指，当无法访问的时候立即给用户一个错误响应；Warm Up(预热)是指经过指定的时间后才达到指定的阈值(sentinel 内有值为 coldFactor 为 3，即请求 QPS 从 threshold / 3 开始，经预热时长逐渐升至设定的 QPS 阈值，参考地址：https://github.com/alibaba/Sentinel/wiki/%E9%99%90%E6%B5%81---%E5%86%B7%E5%90%AF%E5%8A%A8)；排队等待只是匀速的通过(每秒指定的 QPS)，其他的请求进行排队，但是并不会一直排下去，超过指定的时间就会失败，阈值类型必须设置为 QPS，不能为线程。
降级规则

资源名: 要实现降级的资源。
降级策略:

RT(平均响应时间)

如果在一秒钟之内进入的请求的平均响应时间小于 1ms，那么在未来 5s 钟之内所有的请求都会熔断降级。 2) 异常比例
如果在一秒钟之内的请求数异常比例大于指定的数据，那么在未来的时间窗口内会一直熔断降级。统计单位为 s. 3) 异常数
如果在一分钟之内，异常数量大于指定的值，那么在指定的时间窗口内请求一直会熔断降级，注意时间窗口的值一般设置要大于 60，因为设置如果小于 60，可能会一直处于熔断状态。
热点规则
热点规则是针对具体的请求参数进行设置，例如如下的方法：

@RequestMapping("/edit")
@SentinelResource("edit")   //必须的有
public Object edit(@RequestParam(required = false) String id,
                  @RequestParam(required = false) Integer age) {
   return this.studentService.commons();
}

资源名: 是@SentinelResource 中设置的值
参数索引: 对那个参数进行 QPS 限制，通过索引来指定。
**单机阈值：**指定在统计时长内的阈值。
**统计窗口时长: **统计的 QPS 的时间。
系统规则

LOAD: 仅对 Linux/Unix-like 机器生效，参考值一般是 CPU cores * 2.5
**RT: **当单台机器上所有入口流量的平均 RT 达到阈值即触发系统保护，单位是毫秒。
**线程数: **当单台机器上所有入口流量的并发线程数达到阈值即触发系统保护。
入口 QPS: 当单台机器上所有入口流量的 QPS 达到阈值即触发系统保护。
授权规则
授权规则是指可以将特定的访问应用加入黑名单或者白名单，但是必须在访问的时候携带应用的名称。代码实现部分如下：

@Component
public class SentinelOriginParser implements RequestOriginParser {
   @Override
   public String parseOrigin(HttpServletRequest httpServletRequest) {
       String origin = httpServletRequest.getParameter("origin");
       if(StringUtil.isBlank(origin)) {
           throw new IllegalArgumentException("origin parameter must be specified.");
       }
       return origin;
   }
}

加上了来源解析后，在往后的访问中必须要携带 origin 参数，在 sentinel 的 dashboard 中可以作如下配置：

集群流控

**是否集群: **是否采用集群
均摊阈值: 就是每个集群节点每秒的 QPS.
**集群阈值模式: **单机均摊是集群中每个节点每秒的 QPS, 总体阈值是整个集群每秒的 QPS.
集群流控

7.4 @SentinelResource

@SentinelResource 是 sentinel 中非常重要的注解，提供了简单易用的功能。其中 blockHandler 注解是限流的处理方法，fallback 是服务降级的处理方法。

@SentinelResource(value="edit", blockHandler="editBlock", fallback = "editFallback")
@RequestMapping("/edit")
public Object edit(@RequestParam(required = false) String id,
                  @RequestParam(required = false) Integer age) throws Exception {
   Thread.sleep(20);
   return this.studentService.commons();
}
// 限流的处理
public Object editBlock(String id, Integer age, BlockException ex) {
   Map map = new HashMap<>();
   map.put("msg", "限流了.");
   return map;
}
//服务降级的处理方法
public Object editFallback(String id, Integer age) {
   Map map = new HashMap<>();
   map.put("msg", "fallback 服务降级了.");
   return map;
}

八. Feign 与 Sentinel 的整合

配置

feign:
 sentinel:
   # 默认是没有提示的
   enabled: true

8.1 服务降级后的处理

可以在@FeignClient 中配置 fallback，来指定服务降级后给用户返回的什么样的数据，fallback 的值为 Class 类型的对象，该类必须要实现该对应的接口。

@FeignClient(name="alibaba-provider", fallback = UserServiceFallback.class)
public interface UserService {
   @RequestMapping("/user")
   public List getUsers();
}
UserServiceFallback 的实现如下：
@Component
public class UserServiceFallback implements UserService {
   @Override
   public List getUsers() {
       return Arrays.asList("服务降级了, 这是降级后返回的信息.");
   }
}

8.2 服务降级的异常处理

对于 fallback 来讲，并不能追踪到异常信息，在实际的业务处理过程中，我们往往需要记录异常的信息，那么就要使用 fallbackFactory 属性来实现。

@Component
public class UserServiceFallbackFactory implements FallbackFactory {
   private static Logger logger = LoggerFactory.getLogger(UserServiceFallbackFactory.class);
   @Override
   public UserService create(Throwable cause) {
       return new UserService() {
           @Override
           public List getUsers() {
               logger.info(cause.getMessage());
               return Arrays.asList("服务降级的方法");
           }
       };
   }
}

九. Sentinel 的持久化

通过接入 Sentinel Dashboard 后，在页面上操作来更新规则，都无法避免一个问题，那就是服务重新后，规则就丢失了，因为默认情况下规则是保存在内存中的。sentinel 中持久化的方式有两种，pull 模式和 push 模式。
pull 模式是指站在第三方持久化系统(redis, nacos)的角度，他们去到 sentinel 中定时去拉去配置信息，可能会造成数据的不一致性。
push 模式是站在 sentinel 的角度，将其配置信息主动推送给第三方持久化系统，sentinel 官方也推荐在线上使用该模式。

9.1 sentinel-dashboard 改造

A. 将 sentinel 的源码 clone 到本地
B. 进入到 sentinel-dashboard 目录下，修改 pom.xml 文件

<dependency>
    <groupId>com.alibaba.cspgroupId>
    <artifactId>sentinel-datasource-nacosartifactId>
    <scope>testscope>
dependency>

<dependency>
    <groupId>com.alibaba.cspgroupId>
    <artifactId>sentinel-datasource-nacosartifactId>
dependency>

C. 修改 src\main\webapp\resources\app\scripts\directives\sidebar\sidebar.html 文件
未修改之前的内容





<li ui-sref-active="active" ng-if="!entry.isGateway">
    <a ui-sref="dashboard.flowV1({app: entry.app})">
        <i class="glyphicon glyphicon-filter">i>  流控规则
    a>
li>

修改之后的内容

<li ui-sref-active="active" ng-if="entry.appType==0">
    <a ui-sref="dashboard.flow({app: entry.app})">
        <i class="glyphicon glyphicon-filter">i>  流控规则
    a>
li>

D. 将 src\test\java\com\alibaba\csp\sentinel\dashboard\rule\nacos 目录下的四个Java文件拷贝到src\main\java\com\alibaba\csp\sentinel\dashboard\rule 目录下

E. 修改 src\main\webapp\resources\app\scripts\controllers\identity.js 文件，修改内容如下：

F. 重新打包生成 Jar 包，进入到 sentinel 目录下(注：不是 sentinel-dashboard 目录)，执行如下命令：
mvn clean
mvn install -DskipTests
G. 进入到 sentinel-dashboard/target 目录下，执行如下内容：
java -jar sentinel-dashboard.jar

9.2 配置

spring:
 cloud:
   sentinel:
     datasource:
       # 这个名字随意，但是要有意义
       flow:
         nacos:
           server-addr: 192.168.31.173:8848
           groupId: SENTINEL_GROUP
           rule-type: flow

9.3 测试

在 sentinel-dashboard 控制面板添加一个流量控制规则

Spring Gateway 跨域请求头重复处理过滤器

2020-09-05T16:35:22.000Z

Spring Gateway 跨域请求头重复处理过滤器

@Component
public class CorsResponseHeaderFilter implements GlobalFilter, Ordered {
    @Override
    public int getOrder() {
        // 指定位于 NettyWriteResponseFilter 处理完响应体后移除重复 CORS 响应头
        return NettyWriteResponseFilter.WRITE_RESPONSE_FILTER_ORDER + 1;
    }
    @Override
    @SuppressWarnings("serial")
    public Mono filter(ServerWebExchange exchange, GatewayFilterChain chain) {
        return chain.filter(exchange).then(Mono.defer(() -> {
            exchange.getResponse().getHeaders().entrySet().stream()
                    .filter(kv -> (kv.getValue() != null && kv.getValue().size() > 1))
                    .filter(kv -> (kv.getKey().equals(HttpHeaders.ACCESS_CONTROL_ALLOW_ORIGIN)
                            || kv.getKey().equals(HttpHeaders.ACCESS_CONTROL_ALLOW_CREDENTIALS)))
                    .forEach(kv -> kv.setValue(new ArrayList() {{
                        add(kv.getValue().get(0));
                    }}));
            return chain.filter(exchange);
        }));
    }
}

Spring Cloud升级之路-loadbalancer

2020-09-05T15:47:22.000Z

Spring Cloud升级之路-loadbalancer

Hoxton - 3. 负载均衡从 ribbon 替换成 spring-cloud-loadbalancer

负载均衡 Ribbon 替换成 Spring Cloud Load Balancer

Spring Cloud Load Balancer并不是一个独立的项目，而是spring-cloud-commons其中的一个模块。项目中用了Eureka以及相关的 starter，想完全剔除Ribbon的相关依赖基本是不可能的，Spring 社区的人也是看到了这一点，通过配置去关闭Ribbon启用Spring-Cloud-LoadBalancer。

1	spring.cloud.loadbalancer.ribbon.enabled=false

关闭 ribbon 之后，Spring Cloud LoadBalancer 就会加载成为默认的负载均衡器。
Spring Cloud LoadBalancer 结构如下所示：

其中：

全局只有一个 BlockingLoadBalancerClient，负责执行所有的负载均衡请求。
BlockingLoadBalancerClient从LoadBalancerClientFactory里面加载对应微服务的负载均衡配置。
每个微服务下有独自的LoadBalancer，LoadBalancer里面包含负载均衡的算法，例如RoundRobin.根据算法，从ServiceInstanceListSupplier返回的实例列表中选择一个实例返回。

1. 实现`zone`隔离

要想实现zone隔离，应该从ServiceInstanceListSupplier里面做手脚。默认的实现里面有关于zone隔离的ServiceInstanceListSupplier -> org.springframework.cloud.loadbalancer.core.ZonePreferenceServiceInstanceListSupplier:

private List filteredByZone(List serviceInstances) {
if (zone == null) {
zone = zoneConfig.getZone();
}
//如果zone不为null，并且该zone下有存活实例，则返回这个实例列表
//否则，返回所有的实例
if (zone != null) {
List filteredInstances = new ArrayList<>();
for (ServiceInstance serviceInstance : serviceInstances) {
String instanceZone = getZone(serviceInstance);
if (zone.equalsIgnoreCase(instanceZone)) {
filteredInstances.add(serviceInstance);
}
}
if (filteredInstances.size() > 0) {
return filteredInstances;
}
}
// If the zone is not set or there are no zone-specific instances available,
// we return all instances retrieved for given service id.
return serviceInstances;
}

这里对于没指定zone或者该zone下没有存活实例的情况下，会返回所有查到的实例，不区分zone。这个不符合我们的要求，所以我们修改并实现下我们自己的com.github.hashjang.hoxton.service.consumer.config.SameZoneOnlyServiceInstanceListSupplier:

private List filteredByZone(List serviceInstances) {
    if (zone == null) {
        zone = zoneConfig.getZone();
    }
    if (zone != null) {
        List filteredInstances = new ArrayList<>();
        for (ServiceInstance serviceInstance : serviceInstances) {
            String instanceZone = getZone(serviceInstance);
            if (zone.equalsIgnoreCase(instanceZone)) {
                filteredInstances.add(serviceInstance);
            }
        }
        if (filteredInstances.size() > 0) {
            return filteredInstances;
        }
    }
    //如果没找到就返回空列表，绝不返回其他集群的实例
    return List.of();
}

然后我们来看一下默认的 Spring Cloud LoadBalancer 提供的 LoadBalancer ，它是带缓存的：
org.springframework.cloud.loadbalancer.annotation.LoadBalancerClientConfiguration

@Bean
@ConditionalOnBean(ReactiveDiscoveryClient.class)
@ConditionalOnMissingBean
public ServiceInstanceListSupplier discoveryClientServiceInstanceListSupplier(
ReactiveDiscoveryClient discoveryClient, Environment env,
ApplicationContext context) {
DiscoveryClientServiceInstanceListSupplier delegate = new DiscoveryClientServiceInstanceListSupplier(
discoveryClient, env);
ObjectProvider cacheManagerProvider = context
.getBeanProvider(LoadBalancerCacheManager.class);
if (cacheManagerProvider.getIfAvailable() != null) {
return new CachingServiceInstanceListSupplier(delegate,
cacheManagerProvider.getIfAvailable());
}
return delegate;
}

DiscoveryClientServiceInstanceListSupplier每次从Eureka上面拉取实例列表，CachingServiceInstanceListSupplier提供了缓存，这样不必每次从Eureka上面拉取。可以看出CachingServiceInstanceListSupplier是一种代理模式的实现，和SameZoneOnlyServiceInstanceListSupplier的模式是一样的。
我们来组装我们的ServiceInstanceListSupplier，由于我们是同步的环境，只用实现同步的ServiceInstanceListSupplier就行了。

public class CommonLoadBalancerConfig {
    /**
     * 同步环境下的ServiceInstanceListSupplier
     * SameZoneOnlyServiceInstanceListSupplier限制仅返回同一个zone下的实例（注意）
     * CachingServiceInstanceListSupplier启用缓存，不每次访问eureka请求实例列表
     *
     * @param discoveryClient
     * @param env
     * @param zoneConfig
     * @param context
     * @return
     */
    @Bean
    @Order(Integer.MIN_VALUE)
    public ServiceInstanceListSupplier discoveryClientServiceInstanceListSupplier(
            DiscoveryClient discoveryClient, Environment env,
            LoadBalancerZoneConfig zoneConfig,
            ApplicationContext context) {
        ServiceInstanceListSupplier delegate = new SameZoneOnlyServiceInstanceListSupplier(
                new DiscoveryClientServiceInstanceListSupplier(discoveryClient, env),
                zoneConfig
        );
        ObjectProvider cacheManagerProvider = context
                .getBeanProvider(LoadBalancerCacheManager.class);
        if (cacheManagerProvider.getIfAvailable() != null) {
            return new CachingServiceInstanceListSupplier(
                    delegate,
                    cacheManagerProvider.getIfAvailable()
            );
        }
        return delegate;
    }
}

2. 实现下一次重试的时候，如果存在其他实例，则一定会重试与本次不同的其他实例

默认的RoundRobinLoadBalancer，其中的轮询position，是一个Atomic类型的，在某个微服务的调用请求下，所有线程，所有请求共用（调用其他的每个微服务会创建一个RoundRobinLoadBalancer）。在使用的时候，会有这样的一个问题：

假设某个微服务有两个实例，实例 A 和实例 B
某次请求 X 发往实例 A，position = position + 1
在请求没有返回时，请求 Y 到达，发往实例 B，position = position + 1
请求 A 失败，重试，重试的实例还是实例 A

这样在重试的情况下，某个请求的重试可能会发送到上一次的实例进行重试，这不是我们想要的。针对这个，我提了个 Issue：Enhance RoundRoubinLoadBalancer position。我修改的思路是，我们需要一个单次请求隔离的position，这个position对于实例个数取余得出请求要发往的实例。那么如何进行请求隔离呢？
首先想到的是线程隔离，但是这个是不行的。Spring Cloud LoadBalancer 底层运用了 reactor 框架，导致实际承载选择实例的线程，不是业务线程，而是 reactor 里面的线程池，如图所示：
所以，不能用ThreadLocal的方式实现position。
由于我们用到了sleuth，一般请求的context会传递其中的traceId，我们根据这个traceId区分不同的请求，实现我们的 LoadBalancer：
RoundRobinBaseOnTraceIdLoadBalancer

//这个超时时间，需要设置的比你的请求的 connectTimeout + readTimeout 长
private final LoadingCache positionCache = Caffeine.newBuilder().expireAfterWrite(3, TimeUnit.SECONDS).build(k -> new AtomicInteger(ThreadLocalRandom.current().nextInt(0, 1000)));
private Response getInstanceResponse(List serviceInstances) {
    if (serviceInstances.isEmpty()) {
        log.warn("No servers available for service: " + this.serviceId);
        return new EmptyResponse();
    }
    //如果没有 traceId，就生成一个新的，但是最好检查下为啥会没有
    //是不是 MQ 消费这种没有主动生成 traceId 的情况，最好主动生成下。
    Span currentSpan = tracer.currentSpan();
    if (currentSpan == null) {
        currentSpan = tracer.newTrace();
    }
    long l = currentSpan.context().traceId();
    int seed = positionCache.get(l).getAndIncrement();
    return new DefaultResponse(serviceInstances.get(seed % serviceInstances.size()));
}

3. 替换默认的负载均衡相关 Bean 实现

我们要用上面的两个类替换默认的实现，先编写一个配置类：

public class CommonLoadBalancerConfig {
    private volatile boolean isValid = false;
    /**
     * 同步环境下的ServiceInstanceListSupplier
     * SameZoneOnlyServiceInstanceListSupplier限制仅返回同一个zone下的实例（注意）
     * CachingServiceInstanceListSupplier启用缓存，不每次访问eureka请求实例列表
     *
     * @param discoveryClient
     * @param env
     * @param zoneConfig
     * @param context
     * @return
     */
    @Bean
    @Order(Integer.MIN_VALUE)
    public ServiceInstanceListSupplier discoveryClientServiceInstanceListSupplier(
            DiscoveryClient discoveryClient, Environment env,
            LoadBalancerZoneConfig zoneConfig,
            ApplicationContext context) {
        isValid = true;
        ServiceInstanceListSupplier delegate = new SameZoneOnlyServiceInstanceListSupplier(
                new DiscoveryClientServiceInstanceListSupplier(discoveryClient, env),
                zoneConfig
        );
        ObjectProvider cacheManagerProvider = context
                .getBeanProvider(LoadBalancerCacheManager.class);
        if (cacheManagerProvider.getIfAvailable() != null) {
            return new CachingServiceInstanceListSupplier(
                    delegate,
                    cacheManagerProvider.getIfAvailable()
            );
        }
        return delegate;
    }
    @Bean
    public ReactorLoadBalancer reactorServiceInstanceLoadBalancer(
            Environment environment,
            ServiceInstanceListSupplier serviceInstanceListSupplier,
            Tracer tracer) {
        if (!isValid) {
            throw new IllegalStateException("should use the ServiceInstanceListSupplier in this configuration, please check config");
        }
        String name = environment.getProperty(LoadBalancerClientFactory.PROPERTY_NAME);
        return new RoundRobinBaseOnTraceIdLoadBalancer(
                name,
                serviceInstanceListSupplier,
                tracer
        );
    }
}

然后，指定默认的负载均衡配置采取这个配置, 通过注解：

1	@LoadBalancerClients(defaultConfiguration = {CommonLoadBalancerConfig.class})

若本号内容有做得不到位的地方（比如：涉及版权或其他问题），请及时联系我们进行整改即可，会在第一时间进行处理。

使用Github搭建Hexo技术博客-安装教程

2020-09-05T07:18:36.000Z

使用Github搭建Hexo技术博客-安装教程

部署前介绍

Hexo 是什么

Hexo 的中文官网：http://hexo.io/zh-cn/
作者 Tommy Chen：https://zespia.tw/
在我的理解里面：Hexo 是一个基于 Node.js 快速、简洁且高效的博客框架，可以将 Markdown 文件快速的生成静态网页，托管在GitHub Pages 或者Coding Pages 上。
而官网自己是这样说的：

Hexo 是一个快速、简洁且高效的博客框架。Hexo 使用 Markdown（或其他渲染引擎）解析文章，在几秒内，即可利用靓丽的主题生成静态网页。

为什么要用 Hexo

因为其他博客框架太烂了
想自己管理博客，不受其他品台的约束

适合人群

有开发基础的程序员（或者你是前端开发的前端工程师）
想搭建一个技术博客的人（真心别搞太多，没那么多精力去搞）

文章要求

如果是 Git，Node.js 的新人，则这篇文章不要间断操作，要一气呵成，不然可能会遇到各种问题。

本文环境

本文在 20171027 修改

系统：Windows 10 专业版（64 位）
软件：
- Git：Git-2.14.1-64-bit
- Notepad++：6.9.2
- Node.js：node-v8.7.0-x64
账号和准备：
- Github：https://github.com/
- Coding：https://coding.net/ 如果同时部署到 coding 上需要
- 七牛云：http://www.qiniu.com/ 用来储存图片，当然也有其他方式
- DNSPOD：https://www.dnspod.cn/
- 域名注册：https://wanwang.aliyun.com/ 注册域名绑定博客

搭建所需软件

各个软件官网：
- Git：http://git-scm.com/
- IntelliJ IDEA：https://www.jetbrains.com/idea/ 在编辑博客中的配置文件和写博客可以用到
- Node.js：http://nodejs.org/ 镜像站：https://npm.taobao.org/mirrors/node
- Notepad++：https://notepad-plus-plus.org/
所需软件集合：链接：http://pan.baidu.com/s/1bpyaVRx 密码：tlhl

Windows 用户

由于众所周知的原因，从上面的链接下载 git for windows 最好挂上一个代理，否则下载速度十分缓慢。也可以参考这个页面，收录了存储于百度云的下载地址。

文章前提

如果你对上面要求的软件一个都不了解的话，建议你先看如下内容（只是让你们先了解下，当时别照着文章内容做）：

域名绑定

如果你一开始就打算要绑定域名，则下面教程中所有可以填写域名的地方你都填写上你要绑定的域名，如果你没独立域名，那就使用 Github 默认给你的：XXXXXX.github.io 域名即可。

部署开始

git 安装

双击运行 Git-2.14.1-64-bit.exe，接下来一律下一步，不需要多余的选择，假设你安装的目录位置跟我一样：C:\Program Files\Git
打开 Git Bash（路径：C:\Program Files\Git\git-bash.exe），输入：git --version
如下图，如果出现：git version 2.14.1.windows.1，这表示安装成功

Node.js 安装

双击运行 node-v8.7.0-x64.msi，接下来一律下一步，不需要多余的选择。
安装完之后，打开 Git Bash，输入：npm -v
如下图，如果出现：5.4.2，则表示 Node.js 安装成功

Node.js 源设置

在安装 Hexo 之前，先说一下 Node.js 的源，Node.js 官方源默认是：http://registry.npmjs.org，但是由于在国外，说不定你使用的时候就抽风无法下载任何软件。所以我们决定暂时使用淘宝提供的源，淘宝源官网：http://npm.taobao.org/
在 Git Bash 中我们执行下面这一句（这是一整句的）：

alias cnpm="npm --registry=https://registry.npm.taobao.org \
--cache=$HOME/.npm/.cache/cnpm \
--disturl=https://npm.taobao.org/dist \
--userconfig=$HOME/.cnpmrc"

为 npm 设置代理

如果电脑使用了代理服务器的(有的公司会使用代码服务器)需要如下设置：

1 2	npm config set proxy http://server:port npm config set https-proxy http://server:port

.npmrc 中的内容

1
2
3

proxy=http://10.74.46.23:8080/
registry=https://registry.npm.taobao.org/
https-proxy=http://10.74.46.23:8080

如果代理需要认证的话可以这样来设置。

1 2	npm config set proxy http://username:password@server:port npm config set https-proxy http://username:pawword@server:port

如果代理不支持 https 的话需要修改 npm 存放 package 的网站地址。

1	npm config set registry "http://registry.npmjs.org/"

没有使用代理的忽略这个设置

Mac 下执行：sudo npm install -g cnpm --registry=https://registry.npm.taobao.org
现在验证下是否可以使用淘宝的 cnpm 命令：cnpm info express
- 如果能输出一大堆介绍，则说明成功了，以后每次要使用淘宝的源都需要这样来。现在除了默认的 npm，还多了一个 cnpm 可以使用，我们下面有关安装的讲解内容也都是基于此临时命令。
- 如果输出：bash: cnpm: command not found，则表示没成功，需要你在排查下

安装 Hexo 框架

安装 Hexo（注意，现在是 cnpm 开头了，不是 npm 了）：cnpm install -g hexo-cli
- Mac 下执行：sudo cnpm install -g hexo-cli
- 安装时间不一定很快，有可能需要等 3 ~ 5 分钟。
- 安装完有 WARN 警告也没关系的。

创建 Hexo 项目

现在假设我要创建一个名为 hexo 的项目，项目目录就放在：E:\blog_space 目录下，所以我们在 E:\blog_space 目录下创建一个 hexo 目录。现在这个项目的全路径是：E:\blog_space\hexo
打开 Git Bash：
进入该目录：cd e:/blog_space/hexo
然后执行：hexo init，这个时间也会比较长，也有可能要等几分钟，有显示 WARN 也不用管
最后执行：cnpm install，有显示 WARN 也不用管
安装完成之后，E:\blog_space\hexo 目录结构是这样的：
现在我们启动 hexo 本地服务，看下默认的博客是怎样的，命令：hexo server
现在用浏览器访问：http://localhost:4000/，效果如下图
如果要停止 hexo 服务：在 Git Bash 下按 Ctrl + C 即可

选用其他主题

由于默认主题太大众了，所以现在我们换个主题。
你可以去这里找主题：
- hexo-theme：https://hexo.io/themes/
- hexo-github-theme-list：https://github.com/hexojs/hexo/wiki/Themes
- 有那些好看的 hexo 主题？：http://www.zhihu.com/question/24422335
- 我这里选择的 yelee：GitHub 链接 https://github.com/MOxFIVE/hexo-theme-yelee
- Yelee 主题使用说明: http://moxfive.coding.me/yelee/
- 原因是能最大化衬托出：目录、文章内容、代码块。因为我对这个博客的定位就是用来放技术类内容，所以不会让它太杂或是太花。只是目前这个颜色偏浅，后续还需要调整。
现在假设你跟我要用的模板是一样：
- 还是让 Git Bash 保持在 E:\blog_space\hexo 目录下，然后输入命令：git clone https://github.com/MOxFIVE/hexo-theme-yelee.git themes/yelee
- 这样就在 E:\blog_space\hexo\themes 目录下生成了一个 yelle 文件夹，里面有我们刚刚 clone 下来的主题内容。
- 如果以后你不自己修改这个主题的话，可以考虑经常更新下作者的更新内容：
  - cd e:/blog_space/hexo/themes/yelee
  - git pull origin master
下载好主题文件之后，我们现在要修改 E:\blog_space\hexo 目录下的项目配置文件：_config.yml，把对应的主题目录名改下，编辑如下图。
更改主题目录名后，我们还要重新生成主题静态内容：
继续在 Git Bash 中输入命令：
重新生成静态博客的所有内容：hexo generate
重启 hexo 本地服务：hexo server
重新访问：http://localhost:4000/，效果如下图

创建 Github pages 并 SSH 授权

现在假设你已经有一个 Gtihub 账号，你还需要一个特别的仓库，特别在仓库名就是你的 Github 账号登录名，比如我的用户名是：chenjh0611，那我要创建的仓库名字完整滴填写是：chenjh0611.github.io
创建好仓库之后，要本地生成 SSH 秘钥，方便电脑上的 git 软件好提交内容到 Github 上
在 Git Bash 中，输入：ssh-keygen -t rsa -C "你的邮箱地址"，然后回车，回车，再回车，一共 3 次回车，具体含义自己 Google。
比如我的：ssh-keygen -t rsa -C "chenjh0611@163.com"：
此时，生成密钥后，在你电脑目录：C:\Users\你的计算机用户名.ssh 下，会生成两个文件：
私钥：id_rsa
公钥：id_rsa.pub
如果生成的不是这样的文件，那删除掉这两个生成的，重新执行上面的命令，让它再一次生成。
现在用记事本打开 id_rsa.pub，复制文件中的所有内容。
访问：https://github.com/settings/ssh，添加新秘钥，效果如下图
Title：自己随便取
Key：把刚刚复制的都粘贴进来

把本地的博客内容同步到 Github 上

要把本地的静态博客同步到 Github，我们还需要先安装两个跟部署相关的 hexo 插件：
- 继续在 Git Bash 中输入：
- cnpm install hexo -server --save
- cnpm install hexo-deployer-git --save
编辑全局 hexo 的配置文件：_config.yml
- 官网对此配置的介绍：https://hexo.io/zh-cn/docs/configuration.html
- 我自己的编辑内容初稿（你需要认真看的是含有中文注释的内容）：

# Hexo Configuration
## Docs: https://hexo.io/docs/configuration.html
## Source: https://github.com/hexojs/hexo/

# Site 这一块区域主要是设置博客的主要说明，需要注意的是：每个冒号后面都是有一个空格，然后再书写自己的内容的s
title: Chenjh Code  #网站标题
subtitle: 这里只有代码相关,要了解更多 >> www.skyheng.com #网站副标题
description: 这里是 www.skyheng.com 一部分
author: Chenjh
email: 1225948009@qq.com
language: zh-CN
timezone:   #网站时区。Hexo 默认使用您电脑的时区

# URL 这一块一般可以设置的是 url 这个参数，比如我要设置绑定域名的，这里就需要填写我的域名信息
## If your site is put in a subdirectory, set url as 'http://yoursite.com/child' and root as '/child/'
url: http://code.skyheng.com
root: /
permalink: :year/:month/:day/:title/
permalink_defaults:

# Directory
source_dir: source #源文件夹，这个文件夹用来存放内容。
public_dir: public #公共文件夹，这个文件夹用于存放生成的站点文件
tag_dir: tags #标签文件夹
archive_dir: archives #归档文件夹
category_dir: categories #分类文件夹
code_dir: downloads/code #nclude code 文件夹
i18n_dir: :lang #国际化（i18n）文件夹
skip_render:  #跳过指定文件的渲染，您可使用 glob 表达式来匹配路径

# Writing
new_post_name: :year-:month-:day.:title.md #新建文章默认文件名
default_layout: post # 默认布局
titlecase: false # Transform title into titlecase
external_link: true # 在新标签中打开一个外部链接，默认为true
filename_case: 0
render_drafts: false #是否渲染_drafts目录下的文章，默认为false
post_asset_folder: true #启动 Asset 文件夹
relative_link: false #把链接改为与根目录的相对位址，默认false
future: true #显示未来的文章，默认false
highlight:  #代码块的设置
  enable: true
  line_number: true
  auto_detect: false
  tab_replace:

# Category & Tag #分类和标签的设置
default_category: uncategorized #默认分类
category_map:
tag_map:

# Date / Time format
## Hexo uses Moment.js to parse and display date
## You can customize the date format as defined in
## http://momentjs.com/docs/#/displaying/format/
date_format: YYYY-MM-DD
time_format: HH:mm:ss

# Pagination
## Set per_page to 0 to disable pagination
per_page: 10
pagination_dir: page

# Extensions
## Plugins: https://hexo.io/plugins/
## Themes: https://hexo.io/themes/
theme: next # next  yelee

search:
  path: search.xml
  field: all

# Deployment
## 这里是重点，这里是修改发布地址，因为我们前面已经加了 SSH 密钥信息在 Github 设置里面了，所以只要我们电脑里面持有那两个密钥文件就可以无需密码地跟 Github 做同步。
## 需要注意的是这里的 repo 采用的是 ssh 的地址，而不是 https 的。分支我们默认采用 master 分支，以后你翅膀硬了要换其他也无所谓。
## Docs: https://hexo.io/docs/deployment.html
deploy:
  type: git
  repo:
      github: git@github.com:chenjh0611/chenjh0611.github.io.git,master
      coding: git@git.coding.net:chenjh0719/chenjh0719.git,master

编辑全局配置后我们需要重新部署：
继续在 Git Bash 中输入命令：
先清除掉已经生成的旧文件：hexo clean
再生成一次静态文件：hexo generate
在本地预览下：hexo server
本地没问题之后，Ctrl + C 停掉本地预览，使用部署命令部署到 Github 上：hexo deploy，有弹出下面提示框，请输入：yes
提交成功效果如下：
访问服务器地址进行检查：http://chenjh0611.github.io
通过上面几次流程我们也就可以总结：以后，每次发表新文章要部署都按这样的流程来：
- hexo clean
- hexo generate
- hexo deploy
也因为这几个命令太频繁了，所以又有了精简版的命令：
- hexo clean == hexo clean
- hexo g == hexo generate
- hexo s == hexo server
- hexo d == hexo deploy

绑定域名

绑定域名不排除会遇到很多网络问题或是七七八八，所以这里先提供先官网的一些说明：
首先我们要一个 CNAME 文件（文件名叫 CNAME，没有文件后缀的），把该文件放在 E:\blog_space\hexo\source 目录下，以后一些需要放在根目录的资源文件都可以放这里。如果你找不到这样的文件可以到我的项目上下载：https://github.com/chenjh0611/chenjh0611.github.io
CNAME 上的内容需要写你具体要绑定的域名信息，比如我是：code.skyheng.com：
接着我们需要到阿里云后台上设置域名解析：https://www.aliyun.com/
设置好之后，等过几分钟域名解析好之后，我们访问：http://code.skyheng.com，效果如下：

整合 Notepad++ 提高效率

为了提交写作效率，我个人建议使用 Notepad++ 作为 Markdown 编辑工具
现在我们用 Notepad++ 打开我们本地目录：E:\blog_space\hexo，打开后效果如下图：
hexo 新文章内容的开头需要这样定义：
- categories：表示文章所属分类
- tags：表示文章所属标签

---
title: 这是文章标题
categories:
  - hexo
tags:
  - hexo
  - git
  - github
  - nodejs
date: 2015-05-01 10:46:18
description: 这里可以写描述
---

结束语

我希望从这一篇你也可以为自己搭建一个属于你自己的博客，在博客中畅写。
最后，祝你搭建博客成功，创造属于你的世界！

资料

基于 Hexo+Node.js+github+coding 搭建个人博客——基础篇(从菜鸟到放弃)
基于 Hexo+Node.js+github+coding 搭建个人博客——进阶篇(从入门到入土)
Next 主题的文章：
- Hexo(Pages)—博客搭建同步 GitHub&Coding：https://www.tuicool.com/articles/NfAj2er
- Hexo(Pages)—优化博客「续更」：https://www.tuicool.com/articles/aUbMfyz
- 基于 Hexo + GitHub Pages 搭建个人博客（一）：http://www.cnblogs.com/compassblog/p/8627873.html
- 基于 Hexo + GitHub Pages 搭建个人博客（二）：http://www.cnblogs.com/compassblog/p/8629626.html
- 基于 Hexo + GitHub Pages 搭建个人博客（三）：http://www.cnblogs.com/compassblog/p/8911112.html

Vue开发技巧

2020-09-04T17:03:42.000Z

Vue开发技巧

1.require.context()

1.场景:如页面需要导入多个组件,原始写法:

import titleCom from "@/components/home/titleCom";
import bannerCom from "@/components/home/bannerCom";
import cellCom from "@/components/home/cellCom";
components: {
  titleCom, bannerCom, cellCom;
}

2.这样就写了大量重复的代码,利用 require.context 可以写成

const path = require("path");
const files = require.context("@/components/home", false, /\.vue$/);
const modules = {};
files.keys().forEach((key) => {
  const name = path.basename(key, ".vue");
  modules[name] = files(key).default || files(key);
});
components: modules;

这样不管页面引入多少组件,都可以使用这个方法
3.API 方法

实际上是 webpack 的方法,vue 工程一般基于 webpack,所以可以使用
require.context(directory,useSubdirectories,regExp)
接收三个参数:
directory：说明需要检索的目录
useSubdirectories：是否检索子目录
regExp: 匹配文件的正则表达式,一般是文件名

2.watch

2.1 常用用法

1.场景:表格初始进来需要调查询接口 getList(),然后 input 改变会重新查询

created(){
  this.getList()
},
watch: {
  inpVal(){
    this.getList()
  }
}

2.2 立即执行

2.可以直接利用 watch 的 immediate 和 handler 属性简写

watch: {
  inpVal:{
    handler: 'getList',
      immediate: true
  }
}

2.3 深度监听

3.watch 的 deep 属性,深度监听,也就是监听复杂数据类型

watch:{
  inpValObj:{
    handler(newVal,oldVal){
      console.log(newVal)
      console.log(oldVal)
    },
    deep:true
  }
}

此时发现 oldVal 和 newVal 值一样; 因为它们索引同一个对象/数组,Vue 不会保留修改之前值的副本; 所以深度监听虽然可以监听到对象的变化,但是无法监听到具体对象里面那个属性的变化

3. 14 种组件通讯

3.1 props

这个应该非常属性,就是父传子的属性; props 值可以是一个数组或对象;

// 数组:不建议使用
props:[]
// 对象
props:{
 inpVal:{
  type:Number, //传入值限定类型
  // type 值可为String,Number,Boolean,Array,Object,Date,Function,Symbol
  // type 还可以是一个自定义的构造函数，并且通过 instanceof 来进行检查确认
  required: true, //是否必传
  default:200,  //默认值,对象或数组默认值必须从一个工厂函数获取如 default:()=>[]
  validator:(value)=> {
    // 这个值必须匹配下列字符串中的一个
    return ['success', 'warning', 'danger'].indexOf(value) !== -1
  }
 }
}

3.2 $emit

这个也应该非常常见,触发子组件触发父组件给自己绑定的事件,其实就是子传父的方法

// 父组件

// 子组件
this.$emit('title',[{title:'这是title'}])

3.3 vuex

1.这个也是很常用的,vuex 是一个状态管理器 2.是一个独立的插件,适合数据共享多的项目里面,因为如果只是简单的通讯,使用起来会比较重 3.API

state:定义存贮数据的仓库 ,可通过this.$store.state 或mapState访问
getter:获取 store 值,可认为是 store 的计算属性,可通过this.$store.getter 或 mapGetters访问
mutation:同步改变 store 值,为什么会设计成同步,因为mutation是直接改变 store 值, vue 对操作进行了记录,如果是异步无法追踪改变.可通过mapMutations调用
action:异步调用函数执行mutation,进而改变 store 值,可通过 this.$dispatch或mapActions
modules:模块,如果状态过多,可以拆分成模块,最后在入口通过...解构引入

3.4 listeners

2.4.0 新增这两个是不常用属性,但是高级用法很常见; 1.attrs 获取子传父中未在 props 定义的值

// 父组件

// 子组件 mounted() { console.log(this.$attrs) //{title: "这是标题", width:
"80", height: "80", imgUrl: "imgUrl"} }

相对应的如果子组件定义了 props,打印的值就是剔除定义的属性

props: {
  width: {
    type: String,
    default: ''
  }
},
mounted() {
  console.log(this.$attrs) //{title: "这是标题", height: "80", imgUrl: "imgUrl"}
}

2.listeners” 传入内部组件——在创建更高层次的组件时非常有用

1
2
3

// 父组件

// 子组件 mounted() { console.log(this.$listeners) //即可拿到 change 事件 }

如果是孙组件要访问父组件的属性和调用方法,直接一级一级传下去就可以
3.inheritAttrs

// 父组件

// 子组件 mounted() { console.log(this.$attrs) //{title: "这是标题", width:
"80", height: "80", imgUrl: "imgUrl"} },
inheritAttrs默认值为true，true的意思是将父组件中除了props外的属性添加到子组件的根节点上(说明，即使设置为true，子组件仍然可以通过$attr获取到props意外的属性)
将inheritAttrs:false后,属性就不会显示在根节点上了

3.5 provide 和 inject

2.2.0 新增描述: provide 和 inject 主要为高阶插件/组件库提供用例。并不推荐直接用于应用程序代码中; 并且这对选项需要一起使用; 以允许一个祖先组件向其所有子孙后代注入一个依赖，不论组件层次有多深，并在起上下游关系成立的时间里始终生效。

//父组件:
provide: { //provide 是一个对象,提供一个属性或方法
  foo: '这是 foo',
  fooMethod:()=>{
    console.log('父组件 fooMethod 被调用')
  }
},
// 子或者孙子组件
inject: ['foo','fooMethod'], //数组或者对象,注入到子组件
mounted() {
  this.fooMethod()
  console.log(this.foo)
}
//在父组件下面所有的子组件都可以利用inject

provide 和 inject 绑定并不是可响应的。这是官方刻意为之的。然而，如果你传入了一个可监听的对象，那么其对象的属性还是可响应的,对象是因为是引用类型

//父组件:
provide: {
  foo: '这是 foo'
},
mounted(){
  this.foo='这是新的 foo'
}
// 子或者孙子组件
inject: ['foo'],
mounted() {
  console.log(this.foo) //子组件打印的还是'这是 foo'
}

3.6 children

children:子实例

//父组件
mounted(){
  console.log(this.$children)
  //可以拿到 一级子组件的属性和方法
  //所以就可以直接改变 data,或者调用 methods 方法
}
//子组件
mounted(){
  console.log(this.$parent) //可以拿到 parent 的属性和方法
}

parent 并不保证顺序，也不是响应式的只能拿到一级父组件和子组件

3.7 $refs

// 父组件

mounted(){ console.log(this.$refs.home) //即可拿到子组件的实例,就可以直接操作
data 和 methods }

3.8 $root

// 父组件
mounted(){
  console.log(this.$root) //获取根实例,最后所有组件都是挂载到根实例上
  console.log(this.$root.$children[0]) //获取根实例的一级子组件
  console.log(this.$root.$children[0].$children[0]) //获取根实例的二级子组件
}

3.9 .sync

在 vue@1.x 的时候曾作为双向绑定功能存在，即子组件可以修改父组件中的值; 在 vue@2.0 的由于违背单项数据流的设计被干掉了; 在 vue@2.3.0+ 以上版本又重新引入了这个 .sync 修饰符;

// 父组件

//编译时会被扩展为

// 子组件 // 所以子组件可以通过$emit 触发 update 方法改变 mounted(){
this.$emit("update:title", '这是新的title') }

3.10 v-slot

2.6.0 新增 1.slot,slot-cope,scope 在 2.6.0 中都被废弃,但未被移除 2.作用就是将父组件的 template 传入子组件 3.插槽分类: A.匿名插槽(也叫默认插槽): 没有命名,有且只有一个;

// 父组件
 
    

// 子组件
我是默认值
//v-slot:default写上感觉和具名写法比较统一,容易理解,也可以不用写

B.具名插槽: 相对匿名插槽组件 slot 标签带 name 命名的;

// 父组件
 
    

//子组件
我是默认值

C.作用域插槽: 子组件内数据可以被父页面拿到(解决了数据只能从父页面传递给子组件)

// 父组件

  

//slotProps 可以随意命名 //slotProps
接取的是子组件标签slot上属性数据的集合所有v-bind:user="user" // 子组件

    {{ user.lastName }}
 
data() { return { user:{ lastName:"Zhang", firstName:"yue" }, test:[1,2,3,4] }
}, // {{ user.lastName }}是默认数据 v-slot:todo 当父页面没有(="slotProps")

3.11 EventBus

1.就是声明一个全局 Vue 实例变量 EventBus , 把所有的通信数据，事件监听都存储到这个变量上; 2.类似于 Vuex。但这种方式只适用于极小的项目 3.原理就是利用emit 并实例化一个全局 vue 实现数据共享

// 在 main.js
Vue.prototype.$eventBus = new Vue();
// 传值组件
this.$eventBus.$emit("eventTarget", "这是eventTarget传过来的值");
// 接收组件
this.$eventBus.$on("eventTarget", (v) => {
  console.log("eventTarget", v); //这是eventTarget传过来的值
});

4.可以实现平级,嵌套组件传值,但是对应的事件名 eventTarget 必须是全局唯一的

3.12 broadcast 和 dispatch

vue 1.x 有这两个方法,事件广播和派发,但是 vue 2.x 删除了下面是对两个方法进行的封装

function broadcast(componentName, eventName, params) {
  this.$children.forEach((child) => {
    var name = child.$options.componentName;
    if (name === componentName) {
      child.$emit.apply(child, [eventName].concat(params));
    } else {
      broadcast.apply(child, [componentName, eventName].concat(params));
    }
  });
}
export default {
  methods: {
    dispatch(componentName, eventName, params) {
      var parent = this.$parent;
      var name = parent.$options.componentName;
      while (parent && (!name || name !== componentName)) {
        parent = parent.$parent;
        if (parent) {
          name = parent.$options.componentName;
        }
      }
      if (parent) {
        parent.$emit.apply(parent, [eventName].concat(params));
      }
    },
    broadcast(componentName, eventName, params) {
      broadcast.call(this, componentName, eventName, params);
    },
  },
};

3.13 路由传参

1.方案一

// 路由定义
{
  path: '/describe/:id',
  name: 'Describe',
  component: Describe
}
// 页面传参
this.$router.push({
  path: `/describe/${id}`,
})
// 页面获取
this.$route.params.id

2.方案二

// 路由定义
{
  path: '/describe',
  name: 'Describe',
  component: Describe
}
// 页面传参
this.$router.push({
  name: 'Describe',
  params: {
    id: id
  }
})
// 页面获取
this.$route.params.id

3.方案三

// 路由定义
{
  path: '/describe',
  name: 'Describe',
  component: Describe
}
// 页面传参
this.$router.push({
  path: '/describe',
    query: {
      id: id
  `}
)
// 页面获取
this.$route.query.id

4.三种方案对比方案二参数不会拼接在路由后面,页面刷新参数会丢失方案一和三参数拼接在后面,丑,而且暴露了信息

3.14 Vue.observable

2.6.0 新增用法:让一个对象可响应。Vue 内部会用它来处理 data 函数返回的对象; 返回的对象可以直接用于渲染函数和计算属性内，并且会在发生改变时触发相应的更新; 也可以作为最小化的跨组件状态存储器，用于简单的场景。通讯原理实质上是利用 Vue.observable 实现一个简易的 vuex

// 文件路径 - /store/store.js import Vue from 'vue' export const store =
Vue.observable({ count: 0 }) export const mutations = { setCount (count) {
store.count = count } } //使用

4.render 函数

1.场景:有些代码在 template 里面写会重复很多,所以这个时候 render 函数就有作用啦

// 根据 props 生成标签
// 初级

// 优化版,利用 render 函数减小了代码重复率

2.render 和 template 的对比前者适合复杂逻辑,后者适合逻辑简单; 后者属于声明是渲染，前者属于自定 Render 函数; 前者的性能较高，后者性能较低。

5.异步组件

场景:项目过大就会导致加载缓慢,所以异步组件实现按需加载就是必须要做的事啦 1.异步注册组件 3 种方法

// 工厂函数执行 resolve 回调
Vue.component("async-webpack-example", function (resolve) {
  // 这个特殊的 `require` 语法将会告诉 webpack
  // 自动将你的构建代码切割成多个包, 这些包
  // 会通过 Ajax 请求加载
  require(["./my-async-component"], resolve);
});
// 工厂函数返回 Promise
Vue.component(
  "async-webpack-example",
  // 这个 `import` 函数会返回一个 `Promise` 对象。
  () => import("./my-async-component")
);
// 工厂函数返回一个配置化组件对象
const AsyncComponent = () => ({
  // 需要加载的组件 (应该是一个 `Promise` 对象)
  component: import("./MyComponent.vue"),
  // 异步组件加载时使用的组件
  loading: LoadingComponent,
  // 加载失败时使用的组件
  error: ErrorComponent,
  // 展示加载时组件的延时时间。默认值是 200 (毫秒)
  delay: 200,
  // 如果提供了超时时间且组件加载也超时了，
  // 则使用加载失败时使用的组件。默认值是：`Infinity`
  timeout: 3000,
});

异步组件的渲染本质上其实就是执行 2 次或者 2 次以上的渲染, 先把当前组件渲染为注释节点, 当组件加载成功后, 通过 forceRender 执行重新渲染。或者是渲染为注释节点, 然后再渲染为 loading 节点, 在渲染为请求完成的组件 2.路由的按需加载

webpack< 2.4 时
{
  path:'/',
  name:'home',
  components:resolve=>require(['@/components/home'],resolve)
}
webpack> 2.4 时
{
  path:'/',
  name:'home',
  components:()=>import('@/components/home')
}
import()方法由es6提出，import()方法是动态加载，返回一个Promise对象，then方法的参数是加载到的模块。类似于Node.js的require方法，主要import()方法是异步加载的。

6.动态组件

场景:做一个 tab 切换时就会涉及到组件动态加载

但是这样每次组件都会重新加载,会消耗大量性能,所以就起到了作用

1
2
3

这样切换效果没有动画效果,这个也不用着急,可以利用内置的

7.递归组件

场景:如果开发一个 tree 组件,里面层级是根据后台数据决定的,这个时候就需要用到动态组件

// 递归组件:
组件在它的模板内可以递归的调用自己，只要给组件设置name组件就可以了。 //
设置那么House在组件模板内就可以递归使用了,不过需要注意的是， //
必须给一个条件来限制数量，否则会抛出错误: max stack size exceeded //
组件递归用来开发一些具体有未知层级关系的独立组件。比如： // 联级选择器和树形控件

递归组件必须设置 name 和结束的阀值

8.函数式组件

定义:无状态,无法实例化，内部没有任何生命周期处理方法规则:在 2.3.0 之前的版本中，如果一个函数式组件想要接收 prop，则 props 选项是必须的。在 2.3.0 或以上的版本中，你可以省略 props 选项，所有组件上的特性都会被自动隐式解析为 prop 在 2.5.0 及以上版本中，如果你使用了单文件组件(就是普通的.vue 文件),可以直接在 template 上声明 functional 组件需要的一切都是通过 context 参数传递
context 属性有: 1.props：提供所有 prop 的对象 2.children: VNode 子节点的数组 3.slots: 一个函数，返回了包含所有插槽的对象 4.scopedSlots: (2.6.0+) 一个暴露传入的作用域插槽的对象。也以函数形式暴露普通插槽。 5.data：传递给组件的整个数据对象，作为 createElement 的第二个参数传入组件 6.parent：对父组件的引用 7.listeners: (2.3.0+) 一个包含了所有父组件为当前组件注册的事件监听器的对象。这是 data.on 的一个别名。 8.injections: (2.3.0+) 如果使用了 inject 选项，则该对象包含了应当被注入的属性

1
2
3

9.components 和 Vue.component

components:局部注册组件

1
2
3

export default {
  components: { home },
};

Vue.component:全局注册组件

1	Vue.component("home", home);

10.Vue.extend

场景:vue 组件中有些需要将一些元素挂载到元素上,这个时候 extend 就起到作用了是构造一个组件的语法器写法:

// 创建构造器
var Profile = Vue.extend({
  template: "{{extendData}}
实例传入的数据为:{{propsExtend}}
", //template对应的标签最外层必须只有一个标签
  data: function () {
    return {
      extendData: "这是extend扩展的数据",
    };
  },
  props: ["propsExtend"],
});
// 创建的构造器可以挂载到元素上,也可以通过 components 或 Vue.component()注册使用
// 挂载到一个元素上。可以通过propsData传参.
new Profile({ propsData: { propsExtend: "我是实例传入的数据" } }).$mount(
  "#app-extend"
);
// 通过 components 或 Vue.component()注册
Vue.component("Profile", Profile);

11.mixins

场景:有些组件有些重复的 js 逻辑,如校验手机验证码,解析时间等,mixins 就可以实现这种混入 mixins 值是一个数组

const mixin = {
  created() {
    this.dealTime();
  },
  methods: {
    dealTime() {
      console.log("这是mixin的dealTime里面的方法");
    },
  },
};
export default {
  mixins: [mixin],
};

12.extends

extends 用法和 mixins 很相似,只不过接收的参数是简单的选项对象或构造函数,所以 extends 只能单次扩展一个组件

const extend = {
  created() {
    this.dealTime();
  },
  methods: {
    dealTime() {
      console.log("这是mixin的dealTime里面的方法");
    },
  },
};
export default {
  extends: extend,
};

13.Vue.use()

场景:我们使用 element 时会先 import,再 Vue.use()一下,实际上就是注册组件,触发 install 方法; 这个在组件调用会经常使用到; 会自动组织多次注册相同的插件.

14.install

场景:在 Vue.use()说到,执行该方法会触发 install 是开发 vue 的插件,这个方法的第一个参数是 Vue 构造器，第二个参数是一个可选的选项对象(可选)

var MyPlugin = {};
MyPlugin.install = function (Vue, options) {
  // 2. 添加全局资源,第二个参数传一个值默认是update对应的值
  Vue.directive("click", {
    bind(el, binding, vnode, oldVnode) {
      //做绑定的准备工作,添加时间监听
      console.log("指令my-directive的bind执行啦");
    },
    inserted: function (el) {
      //获取绑定的元素
      console.log("指令my-directive的inserted执行啦");
    },
    update: function () {
      //根据获得的新值执行对应的更新
      //对于初始值也会调用一次
      console.log("指令my-directive的update执行啦");
    },
    componentUpdated: function () {
      console.log("指令my-directive的componentUpdated执行啦");
    },
    unbind: function () {
      //做清理操作
      //比如移除bind时绑定的事件监听器
      console.log("指令my-directive的unbind执行啦");
    },
  });
  // 3. 注入组件
  Vue.mixin({
    created: function () {
      console.log("注入组件的created被调用啦");
      console.log("options的值为", options);
    },
  });
  // 4. 添加实例方法
  Vue.prototype.$myMethod = function (methodOptions) {
    console.log("实例方法myMethod被调用啦");
  };
};
//调用MyPlugin
Vue.use(MyPlugin, { someOption: true });
//3.挂载
new Vue({
  el: "#app",
});

更多请戳 vue 中 extend，mixins，extends，components,install 的几个操作

15. Vue.nextTick

2.1.0 新增场景:页面加载时需要让文本框获取焦点用法:在下次 DOM 更新循环结束之后执行延迟回调。在修改数据之后立即使用这个方法，获取更新后的 DOM

mounted(){
//因为 mounted 阶段 dom 并未渲染完毕,所以需要$nextTick
  this.$nextTick(() => {
    this.$refs.inputs.focus() //通过 $refs 获取dom 并绑定 focus 方法
  })
}

16.Vue.directive

16.1 使用

场景:官方给我们提供了很多指令,但是我们如果想将文字变成指定的颜色定义成指令使用,这个时候就需要用到 Vue.directive

// 全局定义 Vue.directive("change-color",function(el,binding,vnode){
el.style["color"]= binding.value; }) // 使用

16.2 生命周期

1.bind 只调用一次，指令第一次绑定到元素时候调用，用这个钩子可以定义一个绑定时执行一次的初始化动作。 2.inserted:被绑定的元素插入父节点的时候调用(父节点存在即可调用，不必存在 document 中) 3.update: 被绑定与元素所在模板更新时调用，而且无论绑定值是否有变化，通过比较更新前后的绑定值，忽略不必要的模板更新 4.componentUpdate :被绑定的元素所在模板完成一次更新更新周期的时候调用 5.unbind: 只调用一次，指令月元素解绑的时候调用

17. Vue.filter

场景:时间戳转化成年月日这是一个公共方法,所以可以抽离成过滤器使用

// 使用
// 在双花括号中
{
  {
    message | capitalize;
  }
}
// 在 `v-bind` 中
bind:id="rawId | formatId">
;
// 全局注册
Vue.filter("stampToYYMMDD", (value) => {
  // 处理逻辑
});
// 局部注册
filters: {
  stampToYYMMDD: (value) => {
    // 处理逻辑
  };
}
// 多个过滤器全局注册
// /src/common/filters.js
let dateServer = (value) => value.replace(/(\d{4})(\d{2})(\d{2})/g, "$1-$2-$3");
export { dateServer };
// /src/main.js
import * as custom from "./common/filters/custom";
Object.keys(custom).forEach((key) => Vue.filter(key, custom[key]));

18.Vue.compile

场景:在 render 函数中编译模板字符串。只在独立构建时有效

var res = Vue.compile("{{ msg }}
");
new Vue({
  data: {
    msg: "hello",
  },
  render: res.render,
  staticRenderFns: res.staticRenderFns,
});

19.Vue.version

场景:有些开发插件需要针对不同 vue 版本做兼容,所以就会用到 Vue.version 用法:Vue.version()可以获取 vue 版本

var version = Number(Vue.version.split(".")[0]);
if (version === 2) {
  // Vue v2.x.x
} else if (version === 1) {
  // Vue v1.x.x
} else {
  // Unsupported versions of Vue
}

20.Vue.set()

场景:当你利用索引直接设置一个数组项时或你修改数组的长度时,由于 Object.defineprototype()方法限制,数据不响应式更新不过 vue.3.x 将利用 proxy 这个问题将得到解决解决方案:

1
2
3

// 利用 set
this.$set(arr,index,item)
// 利用数组 push(),splice()

21.Vue.config.keyCodes

场景:自定义按键修饰符别名

1 2	// 将键码为 113 定义为 f2 Vue.config.keyCodes.f2 = 113;

22.Vue.config.performance

场景:监听性能

1	Vue.config.performance = true;

只适用于开发模式和支持 performance.mark API 的浏览器上

23.Vue.config.errorHandler

1.场景:指定组件的渲染和观察期间未捕获错误的处理函数 2.规则: 从 2.2.0 起，这个钩子也会捕获组件生命周期钩子里的错误。同样的，当这个钩子是 undefined 时，被捕获的错误会通过 console.error 输出而避免应用崩溃从 2.4.0 起，这个钩子也会捕获 Vue 自定义事件处理函数内部的错误了从 2.6.0 起，这个钩子也会捕获 v-on DOM 监听器内部抛出的错误。另外，如果任何被覆盖的钩子或处理函数返回一个 Promise 链 (例如 async 函数)，则来自其 Promise 链的错误也会被处理 3.使用

Vue.config.errorHandler = function (err, vm, info) {
  // handle error
  // `info` 是 Vue 特定的错误信息，比如错误所在的生命周期钩子
  // 只在 2.2.0+ 可用
};

24.Vue.config.warnHandler

2.4.0 新增 1.场景:为 Vue 的运行时警告赋予一个自定义处理函数,只会在开发者环境下生效 2.用法:

1
2
3

Vue.config.warnHandler = function (msg, vm, trace) {
  // `trace` 是组件的继承关系追踪
};

25.v-pre

场景:vue 是响应式系统,但是有些静态的标签不需要多次编译,这样可以节省性能

{{ this will not be compiled }}
显示的是{{ this will not be compiled }}
{{msg}}
即使data里面定义了msg这里仍然是显示的{{ msg }}

26.v-cloak

场景:在网速慢的情况下,在使用 vue 绑定数据的时候，渲染页面时会出现变量闪烁用法:这个指令保持在元素上直到关联实例结束编译。和 CSS 规则如 [v-cloak] { display: none } 一起用时，这个指令可以隐藏未编译的 Mustache 标签直到实例准备完毕

// template 中

    {{value.name}}

// css 中 [v-cloak] { display: none; }

这样就可以解决闪烁,但是会出现白屏,这样可以结合骨架屏使用

27.v-once

场景:有些 template 中的静态 dom 没有改变,这时就只需要渲染一次,可以降低性能开销

1	这时只需要加载一次的标签

v-once 和 v-pre 的区别: v-once 只渲染一次；v-pre 不编译,原样输出

28.事件修饰符

.stop:阻止冒泡
.prevent:阻止默认行为
.self:仅绑定元素自身触发
.once: 2.1.4 新增,只触发一次
.passive: 2.3.0 新增,滚动事件的默认行为 (即滚动行为) 将会立即触发,不能和.prevent 一起使用

29.按键修饰符和按键码

场景:有的时候需要监听键盘的行为,如按下 enter 去查询接口等

// 对应键盘上的关键字
.enter
.tab
.delete (捕获“删除”和“退格”键)
.esc
.space
.up
.down
.left
.right

30.Vue-router

场景:Vue-router 是官方提供的路由插件

30.1 缓存和动画

1.路由是使用官方组件 vue-router,使用方法相信大家非常熟悉; 2.这里我就叙述下路由的缓存和动画; 3.可以用 exclude(除了)或者 include(包括),2.1.0 新增来坐判断


  
  //或include="a,b" :include="/a|b/",a 和 b 表示组件的 name
  //因为有些页面,如试试数据统计,要实时刷新,所以就不需要缓存
     //路由标签
  
   
  // c 表示组件的 name值

注:匹配首先检查组件自身的 name 选项，如果 name 选项不可用，则匹配它的局部注册名称 (父组件 components 选项的键值)。匿名组件不能被匹配 4.用 v-if 做判断,组件会重新渲染,但是不用一一列举组件 name

30.2 全局路由钩子

1.router.beforeEach

router.beforeEach((to, from, next) => {
  console.log("全局前置守卫：beforeEach -- next需要调用"); //一般登录拦截用这个,也叫导航钩子守卫
  if (path === "/login") {
    next();
    return;
  }
  if (token) {
    next();
  }
});

2.router.beforeResolve (v 2.5.0+) 和 beforeEach 类似，区别是在导航被确认之前，同时在所有组件内守卫和异步路由组件被解析之后，解析守卫就被调用即在 beforeEach 之后调用
3.router.afterEach 全局后置钩子在所有路由跳转结束的时候调用这些钩子不会接受 next 函数也不会改变导航本身

30.3 组件路由钩子

1.beforeRouteEnter 在渲染该组件的对应路由被确认前调用，用法和参数与 router.beforeEach 类似，next 需要被主动调用此时组件实例还未被创建，不能访问 this 可以通过传一个回调给 next 来访问组件实例。在导航被确认的时候执行回调，并且把组件实例作为回调方法的参数

beforeRouteEnter (to, from, next) {
  // 这里还无法访问到组件实例，this === undefined
  next( vm => {
    // 通过 `vm` 访问组件实例
  })
}

2.beforeRouteUpdate (v 2.2+) 在当前路由改变，并且该组件被复用时调用，可以通过 this 访问实例， next 需要被主动调用，不能传回调
3.beforeRouteLeave 导航离开该组件的对应路由时调用，可以访问组件实例 this，next 需要被主动调用，不能传回调

30.4 路由模式

设置 mode 属性:hash 或 history

30.5 Vue.$router

1
2
3

this.$router.push():跳转到不同的url，但这个方法回向history栈添加一个记录，点击后退会返回到上一个页面
this.$router.replace():不会有记录
this.$router.go(n):n可为正数可为负数。正数返回上一个页面,类似 window.history.go(n)

30.6 Vue.$route

表示当前跳转的路由对象,属性有: name:路由名称 path:路径 query:传参接收值 params:传参接收值 fullPath:完成解析后的 URL，包含查询参数和 hash 的完整路径 matched:路由记录副本 redirectedFrom:如果存在重定向，即为重定向来源的路由的名字

1 2	this.$route.params.id:获取通过 params 或/:id传参的参数 this.$route.query.id:获取通过 query 传参的参数

30.7 router-view 的 key

场景:由于 Vue 会复用相同组件, 即 /page/1 => /page/2 或者 /page?id=1 => /page?id=2 这类链接跳转时, 将不在执行 created, mounted 之类的钩子

这样组件的 created 和 mounted 就都会执行

31.Object.freeze

场景:一个长列表数据,一般不会更改,但是 vue 会做 getter 和 setter 的转换用法:是 ES5 新增的特性，可以冻结一个对象，防止对象被修改支持:vue 1.0.18+对其提供了支持，对于 data 或 vuex 里使用 freeze 冻结了的对象，vue 不会做 getter 和 setter 的转换注意:冻结只是冻结里面的单个属性,引用地址还是可以更改

new Vue({
  data: {
    // vue不会对list里的object做getter、setter绑定
    list: Object.freeze([{ value: 1 }, { value: 2 }]),
  },
  mounted() {
    // 界面不会有响应,因为单个属性被冻结
    this.list[0].value = 100;
    // 下面两种做法，界面都会响应
    this.list = [{ value: 100 }, { value: 200 }];
    this.list = Object.freeze([{ value: 100 }, { value: 200 }]);
  },
});

32.调试 template

场景:在 Vue 开发过程中, 经常会遇到 template 模板渲染时 JavaScript 变量出错的问题, 此时也许你会通过 console.log 来进行调试这时可以在开发环境挂载一个 log 函数

1 2	// main.js Vue.prototype.$log = window.console.log; // 组件内部 {{$log(info)}}

33.vue-loader 小技巧

33.1 preserveWhitespace

场景:开发 vue 代码一般会有空格,这个时候打包压缩如果不去掉空格会加大包的体积配置 preserveWhitespace 可以减小包的体积

{
  "vue": {
    "preserveWhitespace": false
  }
}

33.2 transformToRequire

场景:以前在写 Vue 的时候经常会写到这样的代码：把图片提前 require 传给一个变量再传给组件

// page 代码

现在:通过配置 transformToRequire 后，就可以直接配置，这样 vue-loader 会把对应的属性自动 require 之后传给组件

// vue-cli 2.x在vue-loader.conf.js 默认配置是
transformToRequire: {
    video: ['src', 'poster'],
    source: 'src',
    img: 'src',
    image: 'xlink:href'
}
// 配置文件,如果是vue-cli2.x 在vue-loader.conf.js里面修改
  avatar: ['default-src']
// vue-cli 3.x 在vue.config.js
// vue-cli 3.x 将transformToRequire属性换为了transformAssetUrls
module.exports = {
  pages,
  chainWebpack: config => {
    config
      .module
        .rule('vue')
        .use('vue-loader')
        .loader('vue-loader')
        .tap(options => {
      options.transformAssetUrls = {
        avatar: 'img-src',
      }
      return options;
      });
  }
}
// page 代码可以简化为

34.为路径设置别名

1.场景:在开发过程中，我们经常需要引入各种文件，如图片、CSS、JS 等，为了避免写很长的相对路径（../），我们可以为不同的目录配置一个别名
2.vue-cli 2.x 配置

// 在 webpack.base.config.js中的 resolve 配置项，在其 alias 中增加别名
resolve: {
    extensions: ['.js', '.vue', '.json'],
    alias: {
      'vue$': 'vue/dist/vue.esm.js',
      '@': resolve('src'),
    }
  }

3.vue-cli 3.x 配置

// 在根目录下创建vue.config.js
var path = require("path");
function resolve(dir) {
  console.log(__dirname);
  return path.join(__dirname, dir);
}
module.exports = {
  chainWebpack: (config) => {
    config.resolve.alias.set(key, value); // key,value自行定义，比如.set('@@', resolve('src/components'))
  },
};

35.img 加载失败

场景:有些时候后台返回图片地址不一定能打开,所以这个时候应该加一张默认图片

// page 代码

36.css

36.1 局部样式

1.Vue 中 style 标签的 scoped 属性表示它的样式只作用于当前模块，是样式私有化. 2.渲染的规则/原理：给 HTML 的 DOM 节点添加一个不重复的 data 属性来表示唯一性在对应的 CSS 选择器末尾添加一个当前组件的 data 属性选择器来私有化样式，如：.demo[data-v-2311c06a]{} 如果引入 less 或 sass 只会在最后一个元素上设置

// 原始代码


// 浏览器渲染效果

  Vue.js scoped

36.2 deep 属性

// 上面样式加一个 /deep/

// 浏览器编译后

Spring-Cloud之注册中心Eureka

2020-06-04T01:52:54.000Z

Eureka是Netflix开源的一款提供服务注册和发现的产品，它提供了完整的Service Registry和Service Discovery实现。也是springcloud体系中最重要最核心的组件之一。

介绍

原理

案例实践

配置

集群

Oracle数据库开发使用记录

2020-06-04T01:40:43.000Z

Oracle 数据库使用很久了，但是使用过程中出现的一些问题从来在也没有记录、每次出现同样的问题使用时又忘记了，又要搜索资料查询、浪费时间、so! 还是写个笔记记录下吧

oracle修改字段精度

我们在设计数据库时难免会因为最初的需求导致数据库字段的设置不能满足实际的需求，如果我们是在新建之初表内无数据时我们可以直接重新建，但是如果有数据时就难免会遇到一些其他问题，例如我们修改数值型的精度时，如果我们是想将精度调小，可以直接实现，如果把精度调大会弹出请清空字段内容后重试的提示。

有一个表名为 tb_test，字段段名为n_max_prpt，数据类型nchar(20)。

1、假设字段数据为空，则不管改为什么字段类型，可以直接执行：
alter table tb_test modify (name nvarchar2(20));

2、假设字段有数据，则改为nvarchar2(20)可以直接执行：
alter table tb_test modify (name nvarchar2(20));

3、假设字段有数据，则改为varchar2(40)执行时会弹出：“ORA-01439:要更改数据类型,则要修改的列必须为空”，这时要用下面方法来解决这个问题：

--修改原字段名n_max_prpt为n_max_prpt_tmp
alter table tb_test rename column n_max_prpt to n_max_prpt_tmp;
--增加一个和原字段名同名的字段n_max_prpt
alter table tb_test add n_max_prpt NUMBER(20,6);
comment on column tb_test.n_max_prpt is '中介协议手续费率';
--将原字段n_max_prpt_tmp数据更新到增加的字段n_max_prpt
update tb_test set n_max_prpt = trim(n_max_prpt_tmp);
--更新完，删除原字段n_max_prpt_tmp
alter table tb_test drop column n_max_prpt_tmp;

总结：
1、当字段没有数据或者要修改的新类型和原类型兼容时，可以直接modify修改。
2、当字段有数据并用要修改的新类型和原类型不兼容时，要间接新建字段来转移。

有哪些好看的 Hexo 主题

2020-05-29T03:12:15.000Z

这个地方是写描述的地方

有哪些好看的 Hexo 主题? - 知乎

Hexo 好看的主题推荐 https://blog.csdn.net/zgd826237710/article/details/99671027

五款Hexo****主题推荐

1.Sakura 非常炫，缺点加载慢 https://github.com/honjun/hexo-theme-sakura

2.Matery 预加载，强推 https://github.com/blinkfox/hexo-theme-matery

3.3-hexo 三段式，适合博文多的 https://github.com/yelog/hexo-theme-3-hexo

4.Butterfly 也是个好看的

5.Next 功能集成多，简洁

Hexo 好看的主题推荐 https://blog.csdn.net/zgd826237710/article/details/99671027

https://blog.wangriyu.wang/2017/08-Hexo.html

butterfly

具体可以看我链接:

https://xingjiahui.top

https://blinkfox.github.io/

https://axh2018.gitee.io/categories/

推荐网站：

教程：Easy Hexo（非常详细，而且还有比较实用的进阶操作）
官网：Hexo
百度：不解释
Google：不解释（打个广告需要。。。。的：链接）

推荐主题：

我推荐的主题 Easy Hexo 上都有，可以自己去看看。

资料

注

本文转载自http://xxxxx

Spring Boot 2 实战：集成 MapStruct 类型转换神器

2020-05-27T01:36:03.000Z

MapStruct 官网：https://mapstruct.org/

1. 痛点

一种框架的出现都要解决个痛点，我想下面这这种不方便的操作经常有人写吧。
假如Car类是数据库映射类:

package cn.felord.mapstruct.entity;

import lombok.Data;

/**
 * Car
 *
 * @author Felordcn
 * @since 13:35 2019/10/12
 **/
@Data
public class Car {
    private String make;
    private int numberOfSeats;
    private CarType type;

}

CarType 类：

package cn.felord.mapstruct.entity;

import lombok.Data;

/**
 * CarType
 *
 * @author Felordcn
 * @since 13:36 2019/10/12
 **/
@Data
public class CarType {
    private String type;
}

CarDTO是DTO类:

package cn.felord.mapstruct.entity;

import lombok.Data;

/**
 * CarDTO
 *
 * @author Felordcn
 * @since 13:37 2019/10/12
 **/
@Data
public class CarDTO {
    private String make;
    private int seatCount;
    private String type;
}

我们从数据库查询Car 然后需要转换为CarDTO，通常我们会这么写一个方法进行转换：

public CarDTO carToCarDTO(Car car) {
    CarDTO carDTO = new CarDTO();

    carDTO.setMake(car.getMake());
    carDTO.setSeatCount(car.getNumberOfSeats());
    carDTO.setType(car.getCarType().getType());
    // 有可能更长 
    return carDTO;
}

这种写法非常繁琐无味，而且没有技术含量。甚至中间还牵涉了很多类型转换，嵌套之类的繁琐操作，而我们想要的只是建立它们之间的映射关系而已。有没有一种通用的映射工具来帮我们搞定这一切。当然有而且还不少。有人说apache的BeanUtil.copyProperties可以实现，但是性能差而且容易出异常，很多规范严禁使用这种途径。以下是对几种对象映射框架的对比，大多数情况下 MapStruct 性能最高。原理类似于lombok ，MapStruct都是在编译期进行实现，而且基于Getter、Setter,没有使用反射所以一般不存在运行时性能问题。

今天就搞一搞MapStruct, 并跟Spring Boot 2.x 集成以下。无论是idea 还是eclipse 都建议安装 MapStruct Plugin 插件,当然不安装也是可以的。

2. Spring Boot 2.1.9 集成 MapStruct

在 Spring Boot 的 pom.xml 下引入 MapStruct 的 maven 依赖坐标:

<dependencies>
    <dependency>
        <groupId>org.mapstructgroupId>
        <artifactId>mapstructartifactId>
        <version>${mapstruct.version}version>
        <scope>compilescope>
    dependency>
    <dependency>
        <groupId>org.mapstructgroupId>
        <artifactId>mapstruct-processorartifactId>
        <version>${mapstruct.version}version>
        <scope>compilescope>
    dependency>
    
dependencies>

3. 使用MapStruct

我们把开始的痛点解决一下。看看 MapStruct 如何降低你的编程成本。

3.1 编写转换源到目标的映射

编写Car到CarDTO的映射:

package cn.felord.mapstruct.mapping;

import cn.felord.mapstruct.entity.Car;
import cn.felord.mapstruct.entity.CarDTO;
import org.mapstruct.Mapper;
import org.mapstruct.Mapping;
import org.mapstruct.factory.Mappers;

/**
 * CarMapping
 *
 * @author Felordcn
 * @since 14 :02 2019/10/12
 */
@Mapper
public interface CarMapping {
    
    /**
     * 用来调用实例 实际开发中可使用注入Spring  不写
     */
    CarMapping CAR_MAPPING = Mappers.getMapper(CarMapping.class);

    /**
     *  源类型 目标类型 成员变量相同类型 相同变量名 不用写{@link org.mapstruct.Mapping}来映射
     *
     * @param car the car
     * @return the car dto
     */
    @Mapping(target = "type", source = "carType.type")
    @Mapping(target = "seatCount", source = "numberOfSeats")
    CarDTO carToCarDTO(Car car);
}

3.2 MapStruct映射方法讲解

上面短短几行代码就可以了十分简单！解释一下操作步骤：

首先声明一个映射接口用@org.mapstruct.Mapper （不要跟mybatis注解混淆）标记，说明这是一个实体类型转换接口。这里我们声明了一个 CAR_MAPPING 来方便我们调用，CarDTO toCarDTO(Car car)是不是很熟悉，像mybatis一样抽象出我们的转换方法。@org.mapstruct.Mapping注解用来声明成员属性的映射。该注解有两个重要的属性：

source 代表转换的源。这里就是Car 。
target 代表转换的目标。这里是CarDTO 。

这里以成员变量的参数名为依据，如果有嵌套比如 Car 里面有个 CarType 类型的成员变量 carType，其 type 属性来映射 CarDTO 中的 type 字符串，我们使用 type.type 来获取属性值。如果有多层以此类推。MapStruct 最终调用的是 setter 和 getter 方法，而非反射。这也是其性能比较好的原因之一。numberOfSeats 映射到 seatCount 就比较好理解了。我们是不是忘记了一个属性 make，因为他们的位置且名称完全一致，所以可以省略。而且对于包装类是自动拆箱封箱操作的，并且是线程安全的。MapStruct不单单有这些功能，还有其他一些复杂的功能：

设置转换默认值和常量。当目标值是 null 时我们可以设置其默认值，注意这些都是基本类型以及对应都 boxing 类型，如下

1	@Mapping(target = "stringProperty", source = "stringProp", defaultValue = "undefined")

需要注意的是常量不能对源进行引用（不能指定 source 属性），下面是正确的操作:

1	@Mapping(target = "stringConstant", constant = "Constant Value")

3.2 Mapper 编译

当你的应用编译后。你会在编译后的目录比如 maven是 target\generated-sources\annotations 下的子目录发现生成了一个实现类比如我们上面的CarMapping 会生成CarMappingImpl 如下:

package cn.felord.mapstruct.mapping;
 
import cn.felord.mapstruct.entity.Car;
import cn.felord.mapstruct.entity.CarDTO;
import org.mapstruct.Mapper;
import org.mapstruct.Mapping;
import org.mapstruct.factory.Mappers;
import javax.annotation.Generated;
import org.springframework.stereotype.Component;

@Generated(
    value = "org.mapstruct.ap.MappingProcessor",
    date = "2019-10-12T15:05:36+0800",
    comments = "version: 1.3.0.Final, compiler: javac, environment: Java 1.8.0_222 (Amazon.com Inc.)"
)
@Component
public class CarMappingImpl implements CarMapping {

    @Override
    public CarDTO carToCarDTO(Car car) {
        if ( car == null ) {
            return null;
        }

        CarDTO carDTO = new CarDTO();

        carDTO.setType( carCarTypeType( car ) );
        carDTO.setSeatCount( car.getNumberOfSeats() );
        carDTO.setMake( car.getMake() );

        return carDTO;
    }

    private String carCarTypeType(Car car) {
        if ( car == null ) {
            return null;
        }
        CarType carType = car.getCarType();
        if ( carType == null ) {
            return null;
        }
        String type = carType.getType();
        if ( type == null ) {
            return null;
        }
        return type;
    }
}

4. MapStruct 进阶操作

下面介绍几种 MapStruct 的进阶操作：

4.1 格式化操作

格式化也是我们经常使用的操作，比如数字格式化，日期格式化。
这是处理数字格式化的操作，遵循java.text.DecimalFormat的规范:

1	@Mapping(source = "price", numberFormat = "$#.00")

下面展示了将一个日期集合映射到日期字符串集合的格式化操作上:

1 2	@IterableMapping(dateFormat = "dd.MM.yyyy") List stringListToDateList(List dates);

4.2 使用 java 表达式

下面演示如何使用LocalDateTime 作为当前的时间值注入 addTime 属性中。

首先在@org.mapstruct.Mapper 的 imports 属性中导入 LocalDateTime，该属性是数组意味着你可以根据需要导入更多的处理类：

1	@Mapper(imports = {LocalDateTime.class})

接下来只需要在对应的方法上添加注解@org.mapstruct.Mapping ，其属性expression 接收一个 java() 包括的表达式：

无入参版本：

1	@Mapping(target = "addTime", expression = "java(LocalDateTime.now())")

携带入参的版本, 我们将 Car 的出厂日期字符串manufactureDateStr 注入到 CarDTO 的 LocalDateTime 类型属性addTime 中去：
1
2
@Mapping(target = "addTime", expression = "java(LocalDateTime.parse(car.manufactureDateStr))")
CarDTO carToCarDTO(Car car);

4.3 MapStruct 转换 Mapper 注入Spring IoC 容器

如果使用要把Mapper 注入Spring IoC 容器我们只需要这么声明，不用再构建一个单例，就可以像其他 spring bean一样对CarMapping 进行引用了：

 package cn.felord.mapstruct.mapping;
 
 import cn.felord.mapstruct.entity.Car;
 import cn.felord.mapstruct.entity.CarDTO;
 import org.mapstruct.Mapper;
 import org.mapstruct.Mapping;
 import org.mapstruct.factory.Mappers;

/**
 * CarMapping 注入spring 写法
 *
 * @author Felordcn
 * @since 14 :02 2019/10/12
 */
@Mapper(componentModel = "spring")
public interface CarMapping {
    
    /**
     * 用来调用实例 实际开发中可使用注入Spring  不写
     */
  // CarMapping CAR_MAPPING = Mappers.getMapper(CarMapping.class);

    /**
     * 源类型 目标类型 成员变量相同类型 相同变量名 不用写{@link Mapping}来映射
     *
     * @param car the car
     * @return the car dto
     */
    @Mapping(target = "type", source = "carType.type")
    @Mapping(target = "seatCount", source = "numberOfSeats")
    CarDTO carToCarDTO(Car car);
}

5.总结

其实MapStruct 还有很多的功能。但是从可读性来说，我建议使用以上几种容易理解的功能即可。如果你感兴趣可以去mapstruct.org进一步学习。配合lombok和我介绍的jsr303，让你更加专注于业务，而且代码更加清晰。

6.资料

极致简洁的markdown编辑器Typora的使用记录与修改

2020-05-20T07:00:52.000Z

有一种爱情是一触即发。看到Typora的第一眼，我就爱上了它。它没有专业软件那么复杂而难以上手的功能，却也没有为了简洁而妥协到难以使用，它的每一寸肌肤都恰到好处，与它相处的每一刻都十分愉悦。

Typora安装

在typora官网下载相对应电脑系统版本的软件，比如windows，Mac。
正常安装即可

Typora的设置

找到：文件–偏好设置
1. 设置字体大小：可以使用自定义
2. 图片插入：复制到${filename}.asset文件夹；打钩优先使用相对路径(默认从C盘的某个路径，当移动md文档时，图片不好粘贴出来，这个最好设置一下)！！！
3. 设置插入代码时显示行号：代码块–打钩显示行号
4. 保存&恢复：打钩自动保存（防止电脑死机，断电等）！！！
5. 关闭自动检查更新！！！
设置视图
1. 视图–大纲视图！！！
设置首行缩进：或者按tab键就可以
1. 编辑–空格与换行–首行缩进

备注：！！！为我自己设置的内容

Markdown语法

Typora软件遵循markdown语法的编辑语法

Markdown语法记忆起来较简单，之所以要学一个语法来用一款编辑文本的软件，那是因为Markdown编辑方便，简单上手，编辑后的内容看起来不会像普通txt文本那样丑陋~，同时插入代码等表格也方便和耐看。

Typora写作内容保存到简书

注册一个简书，进入写文章，左下角点击设置，设置编辑器为markdown编辑器

复制Typora的内容到简书即可！！

Typora的其他技巧和注意事项

插入目录：使用**[toc]或[TOC]在Typora里就会自动识别为目录；或者点击段落–内容目录**，也可以插入目录；目录即为你用#号生成的标题的汇总
md文档设置为txt文本：点击另存为选择txt或者把.md后缀改为.md.txt，.md.ttx是来提醒自己这是一个md的txt文档
通常Typora的自动md语法还是比较方便的，建议在本地用typora写完，然后复制到简书来发布。比如typora插入代码的时候，不需要输入结束的三个反引号，插入表格的时候可以用鼠标点击左上角来更改插入几列几行，插入有序/无序列表时按enter键自动识别，tab键自动下一级或快捷键加粗等等；所以建议大家记录学习笔记的时候用typora记录
简书会自动保存，typora默认不自动保存，这个需要设置一下！！！
Typora的图片是默认存在本地文件夹，因此复制内容到简书的时候，图片需要额外插入，这点有点麻烦，有写公众号推文的人都有这个经历，插图片能让你每次怀疑人生！
Typora可以在文件–导出，导出成其他格式的文本，这点也很方便，比如PDF
如果设置过“图片插入”，md文档也插入了图片，需要给别人发送该md文档的时候，需要一并打包该文档+同目录下的图片文件夹然后发送出去。
快速放大：windows电脑是ctrl+shift+加号
快速缩小：windows电脑是ctrl+shift+减号
快速栏找到“主题”：选择Night
最重要的是，各大博客和论坛都可以识别md语法
ctrl+3(或1/2/4/5)快速调节3级标题

个人修改

修改主题编辑区域宽度

在偏好设置>外观>主题打开主题文件夹、找到对应的主题css、这里已vue.css 为例、编辑器区域宽度是由#write 控制的

原css代码片段

#write {
    max-width: 860px;
    margin: 0 auto;
    padding: 20px 30px 100px;
}

修改后的css代码片段

#write {
    max-width: 98%;
    margin: 0 auto;
    padding: 20px 30px 100px;
}

修改图片展示

原本大多主题的图片展示都是居中的，看起来非常的不舒服、我把图片调成了靠右展示

添加css

1
2
3

p>.md-image:only-child:not(.md-img-error) img,p>img:only-child {
    margin: inherit;
}

修改源代码模式编辑区域

打开Typora所在的安装目录、例C:\Software\Typora\resources\app\style

base-control.css

原css代码片段

.CodeMirror-lines {
padding-top: 30px;
padding-bottom: 60px;
padding-left: 60px;
padding-right: 30px;
}

修改后的css代码片段

.CodeMirror-lines {
padding-top: 30px;
padding-bottom: 60px;
padding-left: 60px;
padding-right: 30px;
max-width: 98%;
margin: 0 auto;
border: solid 1px #5cb85c;
}

/**压缩后为*/
// max-width: 98%;margin: 0 auto;border: solid 1px #5cb85c;

优秀文章

Typora+PicGo，最好用的Markdown+最好用的图床工具 https://blog.csdn.net/bruce_6/article/details/104821531
Typora[MarkDown编辑器]+(PicGo+Github+JsDelivr）https://blog.csdn.net/c1ata/article/details/104744457
美化Typora的中文字体，让编辑简书成为一种享受
Typora添加主题

图片测试

打造个人专属Sublime Text 3

2019-11-26T09:39:41.000Z

目前使用的版本是sublime text3。选择sublime的理由
1、sublime Text是一个跨平台代码编辑器，可以在linux/windows/OS X下使用；
2、sublime Text可以根据用户的需求添加插件进行扩展（使用javascript，html等有相应的插件，写代码方便快捷）
3、sublime Text的界面简单易操作（个人很喜欢sublime根据代码不同而显示不同颜色的功能，用户也可以根据自己的喜好配置颜色）

一、前言

1. 下载与破解

当前可用的破解码如下：

—– BEGIN LICENSE —–
Andrew Weber
Single User License
EA7E-855605
813A03DD 5E4AD9E6 6C0EEB94 BC99798F
942194A6 02396E98 E62C9979 4BB979FE
91424C9D A45400BF F6747D88 2FB88078
90F5CC94 1CDC92DC 8457107A F151657B
1D22E383 A997F016 42397640 33F41CFC
E1D0AE85 A0BBD039 0E9C8D55 E1B89D5D
5CDB7036 E56DE1C0 EFCC0840 650CD3A6
B98FC99C 8FAC73EE D2B95564 DF450523
—— END LICENSE ——

分享Sublime Text 3序列号一枚：

—– BEGIN LICENSE —–
Andrew Weber
Single User License
EA7E-855605
813A03DD 5E4AD9E6 6C0EEB94 BC99798F
942194A6 02396E98 E62C9979 4BB979FE
91424C9D A45400BF F6747D88 2FB88078
90F5CC94 1CDC92DC 8457107A F151657B
1D22E383 A997F016 42397640 33F41CFC
E1D0AE85 A0BBD039 0E9C8D55 E1B89D5D
5CDB7036 E56DE1C0 EFCC0840 650CD3A6
B98FC99C 8FAC73EE D2B95564 DF450523
—— END LICENSE ——

参见：

2. Sublime Text 2与Sublime Text 3区别

简单的说：

ST3支持在项目目录里面寻找变量提供了
对标签页更好地支持（更多的命令和快捷键）
加快了程序运行的速度
更新了API，使用Python3.3

参见：

二、配置

1. 我的配置

{
"ignored_packages":
[
"Vintage"
],

// 字体
"font_size": 12,

// 高亮当前行
"highlight_line": true,

// 新标签页打开文件
"preview_on_click": false,

//滚动能否超过结尾
"scroll_past_end": false,

// TAB缩进宽度
"tab_size": 4,

// 自动转换TAB为空格
"translate_tabs_to_spaces": false,

// 皮肤
"theme": "Soda Dark 3.sublime-theme",

// 关闭自动更新
"update_check": false,

// 自动换行
"word_wrap": "true"
}

2. 关闭自动更新

SublimeText的升级挺快的，每次升级完之后都要重新破解一次主文件，不用重新注册，如果嫌更新太麻烦可以在用户配置中加入如下配置禁用自动更新：

1	"update_check": false

3. soda主题

参见：https://github.com/buymeasoda/soda-theme/

通过package controller安装Theme - Soda。

4. 记住打开的文件

1	"remember_open_files": false

5. Sublime Text 2 使用 Eclipse 快捷键

Sublime Text User Preferences – Eclipse shortcuts for Sublime Text
打造属于自己的前端开发神器 – 给Sublime Text加上Eclipse的光环

[
    /**
     * 常用快捷键(Sublime默认)
     * --------------
     * 
     * 光标一个单词一个单词的移动
     * { "keys": ["super+left"], "command": "move", "args": {"by": "words", "forward": false} },
     * 按住shift来选文字时, 一个个单词的选而不是一个个字母
     * { "keys": ["super+shift+left"], "command": "move", "args": {"by": "words", "forward": false, "extend": true} },
     *
     * 类似光标一个个单词的移动
     * { "keys": ["alt+left"], "command": "move", "args": {"by": "subwords", "forward": false} },
     * { "keys": ["alt+shift+right"], "command": "move", "args": {"by": "subword_ends", "forward": true, "extend": true} },
     *
     * 缩进
     * { "keys": ["super+]"], "command": "indent" },
     * { "keys": ["super+["], "command": "unindent" },
     *
     * 删除整个单词
     * { "keys": ["super+backspace"], "command": "delete_word", "args": { "forward": false } },
     * { "keys": ["super+delete"], "command": "delete_word", "args": { "forward": true } },
     *
     * 行排序(例如选中几个JSON字段, 让这些字段名按字母顺序排序)
     * { "keys": ["f9"], "command": "sort_lines", "args": {"case_sensitive": false} },
     *
     * 参考
     * ----------------------
     * Using Sublime Text as your IDE
     * http://www.chromium.org/developers/sublime-text
     *
     * Web Development With Sublime Text 2
     * http://www.paulund.co.uk/web-development-with-sublime-text-2
     */

    // editor配置
    { "keys": ["super+v"], "command": "paste_and_indent" },
    { "keys": ["super+shift+v"], "command": "paste" },

    /**
     * 适配eclipse快捷键
     *
     * 下面这位仁兄早就有了这个想法
     * Eclipse shortcuts for Sublime Text 2
     * http://icoloma.blogspot.com/2011/10/eclipse-shortcuts-for-sublime-text-2.html
     */
    { "keys": ["alt+/"], "command": "auto_complete" },
    { "keys": ["super+i"], "command": "reindent" },
    // 当前行和下面一行交互位置
    { "keys": ["alt+up"], "command": "swap_line_up" },
    { "keys": ["alt+down"], "command": "swap_line_down" },
    // 复制当前行到上一行
    { "keys": ["super+alt+up"], "command": "duplicate_line" },
    // 复制当前行到下一行
    { "keys": ["super+alt+down"], "command": "duplicate_line" },
    // 删除整行
    { "keys": ["super+d"], "command": "run_macro_file", "args": {"file": "Packages/Default/Delete Line.sublime-macro"} },
    // 光标移动到指定行
    { "keys": ["super+l"], "command": "show_overlay", "args": {"overlay": "goto", "text": ":"} },
    // 快速定位到选中的文字
    { "keys": ["super+k"], "command": "find_under_expand_skip" },
    // { "keys": ["super+shift+x"], "command": "swap_case" },
    { "keys": ["super+shift+x"], "command": "upper_case" },
    { "keys": ["super+shift+y"], "command": "lower_case" },
    // 在当前行的下一行插入空行(这时鼠标可以在当前行的任一位置, 不一定是最后)
    { "keys": ["shift+enter"], "command": "run_macro_file", "args": {"file": "Packages/Default/Add Line.sublime-macro"} },
    // 定位到对于的匹配符(譬如{})(从前面定位后面时,光标要在匹配符里面,后面到前面,则反之)
    { "keys": ["super+shift+p"], "command": "move_to", "args": {"to": "brackets"} },
    // 这个命令默认使用的是super+shift+p
    { "keys": ["super+p"], "command": "show_overlay", "args": {"overlay": "command_palette"} },
    // outline
    { "keys": ["super+o"], "command": "show_overlay", "args": {"overlay": "goto", "text": "@"} },
    // 当前文件中的关键字(方便快速查找内容)
    { "keys": ["super+alt+o"], "command": "show_overlay", "args": {"overlay": "goto", "text": "#"} },
    // open resource
    { "keys": ["super+shift+r"], "command": "show_overlay", "args": {"overlay": "goto", "show_files": true} },
    // 文件内查找/替换
    { "keys": ["super+f"], "command": "show_panel", "args": {"panel": "replace"} },
    // 全局查找/替换, 在查询结果中双击跳转到匹配位置
    {"keys": ["super+h"], "command": "show_panel", "args": {"panel": "find_in_files"} },

    // plugin配置
    { "keys": ["alt+a"], "command": "alignment" },
    {"keys": ["super+shift+f"], "command": "js_format"}
]

三、插件

1. Package Control

最简单的方式是通过 ctrl+`快捷键打开控制台，粘贴以下代码到控制台执行。
参见：Package Control INSTALLATION

Sublime Text 3

import urllib.request,os,hashlib; h = '2915d1851351e5ee549c20394736b442' + '8bc59f460fa1548d1514676163dafc88'; pf = 'Package Control.sublime-package'; ipp = sublime.installed_packages_path(); urllib.request.install_opener( urllib.request.build_opener( urllib.request.ProxyHandler()) ); by = urllib.request.urlopen( 'http://packagecontrol.io/' + pf.replace(' ', '%20')).read(); dh = hashlib.sha256(by).hexdigest(); print('Error validating download (got %s instead of %s), please try manual install' % (dh, h)) if dh != h else open(os.path.join( ipp, pf), 'wb' ).write(by)

Sublime Text 2

import urllib2,os,hashlib; h = '2915d1851351e5ee549c20394736b442' + '8bc59f460fa1548d1514676163dafc88'; pf = 'Package Control.sublime-package'; ipp = sublime.installed_packages_path(); os.makedirs( ipp ) if not os.path.exists(ipp) else None; urllib2.install_opener( urllib2.build_opener( urllib2.ProxyHandler()) ); by = urllib2.urlopen( 'http://packagecontrol.io/' + pf.replace(' ', '%20')).read(); dh = hashlib.sha256(by).hexdigest(); open( os.path.join( ipp, pf), 'wb' ).write(by) if dh == h else None; print('Error validating download (got %s instead of %s), please try manual install' % (dh, h) if dh != h else 'Please restart Sublime Text to finish installation')

2. 实用插件

SideBarEnhancements 左侧菜单栏增强
ConvertToUTF8
AutoFileName 自动补全文件(目录)名
BracketHighlighter 突出显示括号/引号
ColorHighlighter背景显示16进制颜色
DocBlockr 生成注释模板
Sublime CodeIntel – 智能代码提示
FreeMarker:Freemarker模板语言辅助
SublimeCodeIntel 代码提示
JSHint、JsFormart、jQuery
Color Highlighter
Indent XML
sublimeLinter
pretty json

我的插件

参见：

office 2016选择性安装

2019-06-22T15:01:51.000Z

office2016在安装的时候并不像之前的版本有选择性的安装，安装器会安装一个office全家桶。那么如何自主选择安装自己需要的工具呢？

方法一

步骤

下载Office2016部署工具，点此下载。
双击打开工具，该工具会释放两个我们需要的文件（setup.exe和configuration.xml）
用虚拟光驱加载你下载的Office2016 ISO镜像。

用记事本打开第2步解压得到的configuration文件，将其中的内容改为如下所示的样子：

<Configuration>
  <Add SourcePath="G:\" OfficeClientEdition="64" >
    <Product ID="ProPlusRetail">
        <Language ID="zh-CN" />
        <ExcludeApp ID="Access" />
        <ExcludeApp ID="Groove" />
        <ExcludeApp ID="InfoPath" />
        <ExcludeApp ID="Lync" />
        <ExcludeApp ID="OneNote" />
        <ExcludeApp ID="Outlook" />
        <ExcludeApp ID="Publisher" />
        <ExcludeApp ID="SharePointDesigner" />
    Product>
  Add>  
Configuration>

OfficeClientEdition：表示架构，如果你想安装32位则改为32
SourcePath：表示Office2016 ISO镜像加载位置（一般是G盘）

Language：表示语言，zh-CN表示中文，如果你安装的是英文，则为en-us
ExcludeApp：表示不被安装的组件，你可以看到这里面不包括Word、PowerPoint和Excel，我们的目的就是只安装这三个组件。你可以根据自己的需要删除或增加ExcludeApp。

以管理员身份CMD，运行下面的命令即可：

1 2	# cd到setup.exe文件夹下 setup.exe /configure configuration.xml

方法参考：Office 部署工具的配置选项

方法二

步骤

https://www.52pojie.cn/thread-738504-1-1.html
https://www.jb51.net/office/400628.html
https://www.jb51.net/softs/400621.html#downintro2

资料

office2016选择性安装：https://www.cnblogs.com/xxoome/p/7113412.html

OpenWrt 编译 LuCI -> Applications 添加插件应用说明

2019-06-09T14:05:00.000Z

这个地方是写描述的地方

make menuconfig 进入定制界面
进入编译选项配置界面,.按照需要配置.( ‘*’ 代表编入固件，‘M’ 表示编译成模块或者IPK包， ‘空’不编译 )

选择LuCI –> Applications配置：常用

—————————————————————————————–
LuCI —> Applications —> luci-app-adbyby-plus #去广告
LuCI —> Applications —> luci-app-arpbind #IP/MAC绑定
LuCI —> Applications —> luci-app-autoreboot #支持计划重启
LuCI —> Applications —> luci-app-ddns #动态域名
LuCI —> Applications —> luci-app-filetransfer #文件传输
LuCI —> Applications —> luci-app-firewall #添加防火墙
LuCI —> Applications —> luci-app-frpc #FRP内网穿透
LuCI —> Applications —> luci-app-hd-idle #硬盘休眠
LuCI —> Applications —> luci-app-ipsec-virtuald #IPSec virtual服务
LuCI —> Applications —> luci-app-mwan3 #负载均衡
LuCI —> Applications —> luci-app-nlbwmon #网络带宽监视器
LuCI —> Applications —> luci-app-p p t p-server #p p t p virtual**服务
LuCI —> Applications —> luci-app-qos #流量服务质量(QoS)
LuCI —> Applications —> luci-app-ramfree #释放内存
LuCI —> Applications —> luci-app-samba #网络共享(samba)
LuCI —> Applications —> luci-app-sfe #Turbo ACC网络加速
LuCI —> Applications —> luci-app-sqm #流量智能队列管理
LuCI —> Applications —> luci-app-S-S R-plus #S-S R兲朝上网
LuCI —> Applications —> luci-app-syncdial #多拨虚拟网卡(原macvlan)
LuCI —> Applications —> luci-app-upnp #通用即插即用(UPnP)
LuCI —> Applications —> luci-app-v2ray-pro #V2Ray透明代理
LuCI —> Applications —> luci-app-vlmcsd #KMS服务器设置
LuCI —> Applications —> luci-app-vsftpd #FTP服务器
LuCI —> Applications —> luci-app-webadmin #Web管理页面设置
LuCI —> Applications —> luci-app-wifischedule #WiFi 计划
LuCI —> Applications —> luci-app-wireless-regdb #WiFi无线
LuCI —> Applications —> luci-app-wol #网络唤醒
LuCI —> Applications —> luci-app-wrtbwmon #客户端实时流量监测
LuCI —> Applications —> luci-app-xlnetacc #迅雷快鸟
LuCI —> Applications —> luci-app-zerotier #ZeroTier内网穿透
Utilities —> open-vm-tools #打开适用于VMware的VM Tools

—————————————————————————————–
LuCI —> Applications —> luci-app-adblock #ADB广告过滤
LuCI —> Applications —> luci-app-adbyby #广告过滤大师
LuCI —> Applications —> luci-app-advanced-reboot #Linksys高级重启
LuCI —> Applications —> luci-app-ahcp #支持AHCPd
LuCI —> Applications —> luci-app-aliddns #阿里DDNS客户端
LuCI —> Applications —> luci-app-aria2 # Aria2下载
LuCI —> Applications —> luci-app-asterisk #支持Asterisk
LuCI —> Applications —> luci-app-attendedsysupgrade #固件相关
LuCI —> Applications —> luci-app-bcp38 #BCP38网络入口过滤(不确定)
LuCI —> Applications —> luci-app-bird4 #Bird 4(未知)
LuCI —> Applications —> luci-app-bird6 #Bird 6(未知)
LuCI —> Applications —> luci-app-bmx6 #协议相关(未知)
LuCI —> Applications —> luci-app-bmx7 #协议相关(未知)
LuCI —> Applications —> luci-app-cjdns #CJDNS(未知)
LuCI —> Applications —> luci-app-clamav #ClamAV杀毒软件
LuCI —> Applications —> luci-app-commands #Shell命令模块
LuCI —> Applications —> luci-app-cshark #CloudShark捕获工具
LuCI —> Applications —> luci-app-diag-core #core诊断工具
LuCI —> Applications —> luci-app-dnscrypt-proxy #DNSCrypt解决DNS污染
LuCI —> Applications —> luci-app-dump1090 #民航无线频率(不确定)
LuCI —> Applications —> luci-app-dynapoint #DynaPoint(未知)
LuCI —> Applications —> luci-app-e2guardian #Web内容过滤器
LuCI —> Applications —> luci-app-freifunk-diagnostics #诊断(未知)
LuCI —> Applications —> luci-app-freifunk-policyrouting #策略(未知)
LuCI —> Applications —> luci-app-freifunk-widgets #索引(未知)
LuCI —> Applications —> luci-app-fwknopd #Fwknop服务器
LuCI —> Applications —> luci-app-hnet #HNCP家庭网络控制协议(不确定)
LuCI —> Applications —> luci-app-lxc #LXC容器管理
LuCI —> Applications —> luci-app-meshwizard #网络设置向导
LuCI —> Applications —> luci-app-minidlna #miniDLNA共享
LuCI —> Applications —> luci-app-mjpg-streamer #添加视频监控
LuCI —> Applications —> luci-app-mmc-over-gpio #添加SD卡操作界面
LuCI —> Applications —> luci-app-multiwan #多拨虚拟网卡
LuCI —> Applications —> luci-app-n2n_v2 #N2N穿透内网
LuCI —> Applications —> luci-app-noddos #阻止DDoS攻击
LuCI —> Applications —> luci-app-ntpc #NTP时间同步服务器
LuCI —> Applications —> luci-app-ocserv #OpenConnect virtual**
LuCI —> Applications —> luci-app-olsr #OLSR配置和状态模块
LuCI —> Applications —> luci-app-olsr-services #OLSR服务器
LuCI —> Applications —> luci-app-olsr-viz #OLSR可视化
LuCI —> Applications —> luci-app-ocserv #OpenConnect virtual服务
LuCI —> Applications —> luci-app-openvirtual #Openvirtual客户端
LuCI —> Applications —> luci-app-openvirtual-server #Openvirtual服务器
LuCI —> Applications —> luci-app-oscam #OSCAM服务器
LuCI —> Applications —> luci-app-p910nd #打印服务器模块
LuCI —> Applications —> luci-app-pagekitec #Pagekite内网穿透客户端
LuCI —> Applications —> luci-app-polipo #Polipo代理
LuCI —> Applications —> luci-app-privoxy #Privoxy带过滤功能代理
LuCI —> Applications —> luci-app-radicale #CalDAV/CardDAV同步工具
LuCI —> Applications —> luci-app-rp-pppoe-server #PPPoE 服务器
LuCI —> Applications —> luci-app-s-s-libes #SS-libev服务端
LuCI —> Applications —> luci-app-shairplay #支持AirPlay功能
LuCI —> Applications —> luci-app-siitwizard #SIIT配置向导
LuCI —> Applications —> luci-app-simple-adblock #简单的广告拦截
LuCI —> Applications —> luci-app-splash #DHCP客户端应用
LuCI —> Applications —> luci-app-squid #Squid代理服务器
LuCI —> Applications —> luci-app-s-s #兲朝上网
LuCI —> Applications —> luci-app-S-S Rserver-python #S-S R服务器-Python
LuCI —> Applications —> luci-app-statistics #流量监控工具
LuCI —> Applications —> luci-app-tinyproxy #TinyProxy 代理服务器
LuCI —> Applications —> luci-app-travelmate #wlan连接管理器
LuCI —> Applications —> luci-app-transmission #BT下载
LuCI —> Applications —> luci-app-udpxy #udpxy做组播服务器
LuCI —> Applications —> luci-app-uhttpd #uHTTPd Web服务器
LuCI —> Applications —> luci-app-unbound #Unbound DNS解析器
LuCI —> Applications —> luci-app-usb-printer #打印机TCP/IP共享服务
LuCI —> Applications —> luci-app-vnstat #vnStat流量查看/监测工具
LuCI —> Applications —> luci-app-virtualbypass #virtual** Bypass Web UI
LuCI —> Applications —> luci-app-watchcat #断网检测功能
LuCI —> Applications —> luci-app-webshell #网页命令行终端
LuCI —> Applications —> luci-app-wireguard #WireGuard virtual**服务器
LuCI —> Collections —> luci #添加luci (web界面管理)
LuCI —> Modules —> Translations —> Simplified Chinese (zh-cn) #新版本中文语言包位置
LuCI —> Themes —> luci-theme-bootstrap #默认主题
LuCI —> Translations —> luci-i18n-chinese #添加luci的中文语言包
—————————————————————————————–

资料

openwrt-luci-app编译方式 http://www.mm126.cc/314.html

MySql免安装版安装方法与配置调整

2019-05-30T01:50:56.000Z

需要使用MySQL，想起免安装版，遂再安装一遍MySQL，但是我好像没有记录怎么在win版下怎么安装的，之前安装都是需要安装的使用又去百度，今天我就记录下我的安装过程。以便以后进行查阅。

第1步：下载如下图安装包

第2步：解压mysql压缩包，然后进入解压后的安装包

将my-default.ini复制一份，并改名为my.ini(我已经完成）

把下面内容复制到my.ini,并保存

[client]
port=3306
default-character-set=utf8

#客户端字符类型，与服务端一致就行，建议utf8

[mysqld]

port=3306
character_set_server=utf8

#服务端字符类型，建议utf8

basedir=C:\mysql-5.6.44-winx64
#解压根目录(skip-grant-tables,更改密码，加skip-grant-tables，停服务,起服务，update ,停服务,注skip-grant-tables，起服务)

datadir=C:\mysql-5.6.44-winx64\data
#skip-grant-tables
#解压根目录\data

performance_schema_max_table_instances=200
table_definition_cache=200
table_open_cache=128

sql_mode=NO_ENGINE_SUBSTITUTION,STRICT_TRANS_TABLES

[WinMySQLAdmin]

C:\mysql-5.6.44-winx64\bin\mysqld.exe

#解压根目录\bin\mysqld.exe

优化

资料

MySql免安装版配置方法

Spring Boot之版本更新的配置变动

2019-05-23T07:52:15.000Z

Spring Boot的版本升级带来的配置及特性都有发生改变，搭建框架时碰到，特此记录

打印RequestMapping信息配置

2.1之前的版本

Spring Boot 2.1 之前使用INFO 级别记录的信息很多，所以只需要配置为INFO程序启动的时候就可以打印 RequestMapping 的信息，示例如下：

1
2
3

logging:
  level:
    root: info

打印出来的格式如下：

2019-05-23 16:51:45.824  INFO 13218 --- [           main] s.w.s.m.m.a.RequestMappingHandlerMapping : Mapped "{[/board/add]}" onto public com.ztd.question.util.ResultVo com.ztd.question.web.controller.BoardController.add(com.ztd.question.web.entity.Board)
2019-05-23 16:51:45.826  INFO 13218 --- [           main] s.w.s.m.m.a.RequestMappingHandlerMapping : Mapped "{[/board/update]}" onto public com.ztd.question.util.ResultVo com.ztd.question.web.controller.BoardController.update(com.ztd.question.web.entity.Board)
2019-05-23 16:51:45.827  INFO 13218 --- [           main] s.w.s.m.m.a.RequestMappingHandlerMapping : Mapped "{[/board/saveList]}" onto public com.ztd.question.util.ResultVo com.ztd.question.web.controller.BoardController.update(com.ztd.question.web.entity.Board[])
2019-05-23 16:51:45.827  INFO 13218 --- [           main] s.w.s.m.m.a.RequestMappingHandlerMapping : Mapped "{[/board/delete/{id}]}" onto public com.ztd.question.util.ResultVo com.ztd.question.web.controller.BoardController.delete(java.lang.Integer)
2019-05-23 16:51:45.828  INFO 13218 --- [           main] s.w.s.m.m.a.RequestMappingHandlerMapping : Mapped "{[/board/list]}" onto public com.ztd.question.util.ResultVo> com.ztd.question.web.controller.BoardController.list(java.lang.String)
2019-05-23 16:51:45.830  INFO 13218 --- [           main] s.w.s.m.m.a.RequestMappingHandlerMapping : Mapped "{[/index],methods=[GET]}" onto public java.lang.String com.ztd.question.web.controller.IndexController.homePage()
2019-05-23 16:51:45.831  INFO 13218 --- [           main] s.w.s.m.m.a.RequestMappingHandlerMapping : Mapped "{[/order/create]}" onto public com.ztd.question.util.ResultVo com.ztd.question.web.controller.RetryController.list(java.lang.Integer) throws java.lang.Exception
2019-05-23 16:51:45.834  INFO 13218 --- [           main] s.w.s.m.m.a.RequestMappingHandlerMapping : Mapped "{[/error]}" onto public org.springframework.http.ResponseEntity> org.springframework.boot.autoconfigure.web.servlet.error.BasicErrorController.error(javax.servlet.http.HttpServletRequest)

2.1之后的版本

Spring Boot 2.1 以后使用了 Spring Framework 5.1, 而 Spring Framework 5.1 对日志做了较大的改动。现在使用 INFO 级别记录的信息非常少，DEBUG 级别提供了更多信息，但不详细。只有 TRACE 级别才会提供详细信息。这时候为了要打印Controller里面的 RequestMapping信息需要把org.springframework.web打印日志的格式设置为trace，示例如下：

logging:
  level:
    root: info
    org.mybatis: debug
    java.sql: debug
    org.springframework.web: trace

日志输出格式如下：把每个Controller下面的所有RequestMapping全部列到一个Controller下面，打印格式比之前的格式可读性和区分性更好一些

2019-05-23 16:55:22.241 TRACE 13313 --- [           main] s.w.s.m.m.a.RequestMappingHandlerMapping : 
c.z.q.w.c.BoardController:
{ /board/add}: add(Board)
{ /board/update}: update(Board)
{ /board/saveList}: update(Board[])
{ /board/delete/{id}}: delete(Integer)
{ /board/list}: list(String)
2019-05-23 16:55:22.247 TRACE 13313 --- [           main] s.w.s.m.m.a.RequestMappingHandlerMapping : 
c.z.q.w.c.IndexController:
{GET /index}: homePage()
2019-05-23 16:55:22.248 TRACE 13313 --- [           main] s.w.s.m.m.a.RequestMappingHandlerMapping : 
c.z.q.w.c.RetryController:
{ /order/create}: list(Integer)
2019-05-23 16:55:22.253 TRACE 13313 --- [           main] s.w.s.m.m.a.RequestMappingHandlerMapping : 
o.s.b.a.w.s.e.BasicErrorController:
{ /error}: error(HttpServletRequest)
{ /error, produces [text/html]}: errorHtml(HttpServletRequest,HttpServletResponse)

Spring Boot	Spring Cloud	Spring Cloud Alibaba
2.1.x	Greenwich	0.9.x
2.0.x	Finchley	0.2.x
1.5.x	Edgware	0.1.x
1.5.x	Dalston	0.1.x

一切随缘的技术博客

开源软件镜像站汇总

RocketMQ官方运维管理命令mqadmin使用手册 讲解-实操

Topic相关

updateTopic

deleteTopic

topicList

updateTopicPerm

topicRoute

topicStatus

topicClusterList

cleanUnusedTopic

Message相关

sendMessage

sendMsgStatus

queryMsgByKey

queryMsgById

queryMsgByUniqueKey

queryMsgByOffset

printMsg

printMsgByQueue

consumeMessage

Group相关

updateSubGroup

deleteSubGroup

cloneGroupOffset

统计分析

brokerStatus

brokerConsumeStats

producerConnection

consumerConnection

consumerProgress

consumerStatus

clusterList

statsAll

checkMsgSendRT

clusterRT

queryCq

运维管理

wipeWritePerm

resetOffsetByTime

cleanExpiredCQ

startMonitoring

allocateMQ

配置相关

getNamesrvConfig

updateNamesrvConfig

updateKvConfig

deleteKvConfig

updateBrokerConfig

getBrokerConfig

updateAclConfig

deleteAccessConfig

clusterAclConfigVersion

updateGlobalWhiteAddr

getAccessConfigSubCommand

updateOrderConf

官方误笔

参考

使用Coding持续集成结合腾讯云Serverless部署应用

Serverless 是什么？

“无服务器”搭建网站

基于serverless.yml文件

基于Jenkinsfile文件

旧版本的Jenkinsfile文件

总结

资料

使用Coding持续集成构建流水线自动部署自建静态网站

背景

技术方案

Jenkinsfile

持续集成环境变量

截图

各种语言生成 HTML

MKDocs

VUE Nuxt

VUE

React

参考

Spring Cloud Alibaba 简介

RocketMQ官方运维管理命令mqadmin使用手册讲解-实操

1. 实现`zone`隔离