Server-Sent Events(SSE)是一种在客户端和服务器之间实现单向实时通信的技术。它允许服务器向客户端推送数据,但客户端无法使用 SSE 向服务器发送数据。这使得其适用于需要持续接收服务器数据的应用场景(如实时通知、股票行情、社交媒体更新等)
相比于其他技术如 WebSocket,SSE 更简单和轻量,但仅适用于信息量不大的单向数据流。大多数现代浏览器都支持 SSE,并且其内置的自动重连机制进一步增强了其可靠性。
因为安卓原生对 SSE 的支持非常有限,所以通常会使用第三方库来管理与服务器的连接和事件接收(Okhttp 的 SSE 扩展库)
implementation("com.squareup.okhttp3:okhttp-sse:4.12.0")
object SSEManager {
private val TAG = SSEManager::class.java.simpleName
private var event: RealEventSource? = null
fun connect() {
val sseUrl = "" // SSE 连接域名
val request = Request.Builder()
.url(sseUrl)
.build()
val okHttpClient = OkHttpClient.Builder().also {
it.connectTimeout(1, TimeUnit.DAYS)
it.readTimeout(1, TimeUnit.DAYS)
}.build()
event = RealEventSource(request, object : EventSourceListener() {
override fun onOpen(eventSource: EventSource, response: Response) {
Log.v(TAG, "onOpen: ")
}
override fun onEvent(eventSource: EventSource, id: String?, type: String?, data: String) {
Log.v(TAG, "data: $data")
}
override fun onClosed(eventSource: EventSource) {
Log.e(TAG, "onClosed: ")
}
override fun onFailure(eventSource: EventSource, t: Throwable?, response: Response?) {
Log.e(TAG, "onFailure: $t $response")
}
})
event?.connect(okHttpClient)
}
fun release() {
event?.cancel()
}
}
可以看到使用 Okhttp 的 SSE 功能和普通的网络请求大同小异,可以在 Request 上自行配置请求信息。服务端推送时会把信息回调到 onEvent 方法,然后根据 data 数据去做我们的业务需求即可
需要注意的是,在不使用 SSE 连接的时候要及时释放资源,否则可能会导致内存泄漏、电池消耗增加、网络资源浪费、服务器压力增加以及应用性能问题。因此,务必在适当的生命周期阶段释放连接,确保资源得以正确管理和释放,以保持应用的稳定性和高性能。