spring配置websocket的完整流程
在 Spring Boot 中使用 Kotlin 配置 WebSocket 的完整流程如下(包含基礎(chǔ)配置、安全增強(qiáng)和性能優(yōu)化):
一、添加依賴 (build.gradle.kts 或 pom.xml)
// build.gradle.kts
dependencies {
implementation("org.springframework.boot:spring-boot-starter-websocket")
implementation("com.fasterxml.jackson.module:jackson-module-kotlin") // JSON 支持
}
二、基礎(chǔ) WebSocket 配置
1. 啟用 WebSocket 支持
@Configuration
@EnableWebSocket
class WebSocketConfig : WebSocketConfigurer {
@Autowired
lateinit var myWebSocketHandler: MyWebSocketHandler
@Autowired
lateinit var handshakeInterceptor: AuthHandshakeInterceptor
override fun registerWebSocketHandlers(registry: WebSocketHandlerRegistry) {
registry.addHandler(myWebSocketHandler, "/ws")
.addInterceptors(handshakeInterceptor)
.setAllowedOrigins("*") // 生產(chǎn)環(huán)境應(yīng)限制域名
}
}
三、核心組件實(shí)現(xiàn)
1. WebSocket 消息處理器
@Component
class MyWebSocketHandler : TextWebSocketHandler() {
private val sessions = ConcurrentHashMap<String, WebSocketSession>()
private val logger = LoggerFactory.getLogger(this::class.java)
// 連接建立
override fun afterConnectionEstablished(session: WebSocketSession) {
val userId = session.attributes["userId"] as? String
userId?.let {
sessions[it] = session
logger.info("User $it connected, total: ${sessions.size}")
} ?: run {
session.close(CloseStatus.BAD_DATA)
}
}
// 處理文本消息
override fun handleTextMessage(session: WebSocketSession, message: TextMessage) {
val payload = message.payload
logger.debug("Received message: $payload")
// 示例:廣播消息
sessions.values.forEach {
it.sendMessage(TextMessage("Broadcast: $payload"))
}
}
// 連接關(guān)閉
override fun afterConnectionClosed(session: WebSocketSession, status: CloseStatus) {
sessions.values.remove(session)
logger.info("Connection closed: ${status.reason}")
}
// 主動(dòng)推送方法
fun sendToUser(userId: String, message: String) {
sessions[userId]?.sendMessage(TextMessage(message))
}
}
2. 握手?jǐn)r截器(安全校驗(yàn))
@Component
class AuthHandshakeInterceptor : HandshakeInterceptor {
override fun beforeHandshake(
request: ServerHttpRequest,
response: ServerHttpResponse,
wsHandler: WebSocketHandler,
attributes: MutableMap<String, Any>
): Boolean {
// 1. 校驗(yàn) Token
val token = request.uri.query?.split("token=")?.get(1)
if (!validateToken(token)) {
response.statusCode = HttpStatus.UNAUTHORIZED
return false
}
// 2. 獲取用戶信息
val userId = parseUserIdFromToken(token)
attributes["userId"] = userId
// 3. 記錄握手日志
logHandshake(request.remoteAddress?.hostName)
return true
}
private fun validateToken(token: String?): Boolean {
// 實(shí)現(xiàn) JWT 校驗(yàn)邏輯
return token?.startsWith("valid_") == true
}
}
四、客戶端連接示例(JavaScript + Kotlin)
1. Web 前端連接
const socket = new WebSocket(`ws://${location.host}/ws?token=valid_123`);
socket.onmessage = (event) => {
console.log('Received:', event.data);
};
// 發(fā)送心跳包保持連接
setInterval(() => {
socket.send(JSON.stringify({ type: "heartbeat" }));
}, 30000);
2. Android 客戶端(Kotlin)
class WebSocketClient(url: String) : WebSocketListener() {
private val client = OkHttpClient()
private var ws: WebSocket? = null
init {
val request = Request.Builder().url(url).build()
ws = client.newWebSocket(request, this)
}
override fun onMessage(webSocket: WebSocket, text: String) {
println("Received: $text")
}
fun sendMessage(msg: String) {
ws?.send(msg)
}
}
五、高級(jí)配置
1. 消息壓縮配置
@Bean
fun webSocketContainer(): ServletServerContainerFactoryBean {
return ServletServerContainerFactoryBean().apply {
setMaxTextMessageBufferSize(8192)
setMaxBinaryMessageBufferSize(8192)
setAsyncSendTimeout(30000L) // 30秒異步發(fā)送超時(shí)
}
}
2. 集群支持(Redis 廣播)
@Configuration
@EnableRedisRepositories
class RedisPubSubConfig {
@Bean
fun redisTemplate(connectionFactory: RedisConnectionFactory): RedisTemplate<String, String> {
return RedisTemplate<String, String>().apply {
setConnectionFactory(connectionFactory)
}
}
@Bean
fun topicListenerAdapter(handler: MessageListener): ChannelTopic {
return ChannelTopic("websocket-messages")
}
}
六、監(jiān)控與調(diào)試
1. 端點(diǎn)監(jiān)控
@RestController
class WebSocketMetricsController(
private val handler: MyWebSocketHandler
) {
@GetMapping("/metrics/websocket")
fun getMetrics(): Map<String, Any> {
return mapOf(
"activeConnections" to handler.getSessionCount(),
"lastMessageTime" to handler.getLastActivity()
)
}
}
2. 日志配置 (logback-spring.xml)
<logger name="org.springframework.web.socket" level="DEBUG"/> <logger name="com.example.websocket" level="TRACE"/>
七、常見(jiàn)問(wèn)題解決方案
| 問(wèn)題現(xiàn)象 | 解決方案 |
|---|---|
| 連接頻繁斷開(kāi) | 添加心跳機(jī)制,調(diào)整 setAsyncSendTimeout |
| 跨域失敗 | 精確配置 .setAllowedOrigins("https://your-domain.com") |
| 消息順序錯(cuò)亂 | 使用 @SendToUser(destination = "/queue", broadcast = false) 點(diǎn)對(duì)點(diǎn)發(fā)送 |
| 內(nèi)存泄漏 | 定期檢查 sessions Map,添加連接超時(shí)清理邏輯 |
| 高并發(fā)時(shí)性能下降 | 啟用異步消息處理,使用 Redis Pub/Sub 分流消息 |
八、安全增強(qiáng)建議
啟用 WSS 協(xié)議:
# Nginx 配置示例 location /ws { proxy_pass http://backend; proxy_http_version 1.1; proxy_set_header Upgrade $http_upgrade; proxy_set_header Connection "upgrade"; proxy_set_header X-Real-IP $remote_addr; proxy_ssl_protocols TLSv1.2 TLSv1.3; }限流防護(hù):
@Bean fun webSocketRateLimiter(): WebSocketHandlerDecoratorFactory { return object : WebSocketHandlerDecoratorFactory { override fun decorate(handler: WebSocketHandler): WebSocketHandler { val rateLimiter = RateLimiter.create(100) // 100次/秒 return object : WebSocketHandlerDecorator(handler) { override fun handleMessage(session: WebSocketSession, message: WebSocketMessage<*>) { if (!rateLimiter.tryAcquire()) { session.close(CloseStatus.POLICY_VIOLATION) return } super.handleMessage(session, message) } } } } }
九、性能測(cè)試建議
使用 JMeter 壓測(cè):
<!-- WebSocket 壓測(cè)計(jì)劃示例 --> <WebSocketSampler> <connectTime>5000</connectTime> <responseTimeout>10000</responseTimeout> <payload>{ "type": "stress", "data": "test" }</payload> </WebSocketSampler>監(jiān)控指標(biāo):
• 單節(jié)點(diǎn)最大連接數(shù)
• 消息往返延遲 (RTT)
• 內(nèi)存占用增長(zhǎng)率
通過(guò)以上配置,可以實(shí)現(xiàn)一個(gè)高性能、安全可靠的企業(yè)級(jí) WebSocket 服務(wù),支持從開(kāi)發(fā)到生產(chǎn)的全生命周期管理。
總結(jié)
到此這篇關(guān)于spring配置websocket的文章就介紹到這了,更多相關(guān)spring配置websocket內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家!
相關(guān)文章
Java深入了解數(shù)據(jù)結(jié)構(gòu)之棧與隊(duì)列的詳解
這篇文章主要介紹了Java數(shù)據(jù)結(jié)構(gòu)中的棧與隊(duì)列,在Java的時(shí)候,對(duì)于棧與隊(duì)列的應(yīng)用需要熟練的掌握,這樣才能夠確保Java學(xué)習(xí)時(shí)候能夠有扎實(shí)的基礎(chǔ)能力。本文小編就來(lái)詳細(xì)說(shuō)說(shuō)Java中的棧與隊(duì)列,需要的朋友可以參考一下2022-01-01
java服務(wù)器的簡(jiǎn)單實(shí)現(xiàn)過(guò)程記錄
在線瀏覽網(wǎng)頁(yè)離不開(kāi)服務(wù)器,用戶發(fā)出請(qǐng)求request,服務(wù)器做出響應(yīng)response,提供給用戶需要的頁(yè)面,這篇文章主要給大家介紹了關(guān)于java服務(wù)器簡(jiǎn)單實(shí)現(xiàn)的相關(guān)資料,需要的朋友可以參考下2021-11-11
Java工程mybatis實(shí)現(xiàn)多表查詢過(guò)程詳解
這篇文章主要介紹了Java工程mybatis實(shí)現(xiàn)多表查詢過(guò)程詳解,文中通過(guò)示例代碼介紹的非常詳細(xì),對(duì)大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價(jià)值,需要的朋友可以參考下2020-06-06

