forked from GitHub-Mirror/riotX-android
138 lines
4.2 KiB
Kotlin
138 lines
4.2 KiB
Kotlin
/*
|
|
* Copyright 2019 New Vector Ltd
|
|
*
|
|
* Licensed under the Apache License, Version 2.0 (the "License");
|
|
* you may not use this file except in compliance with the License.
|
|
* You may obtain a copy of the License at
|
|
*
|
|
* http://www.apache.org/licenses/LICENSE-2.0
|
|
*
|
|
* Unless required by applicable law or agreed to in writing, software
|
|
* distributed under the License is distributed on an "AS IS" BASIS,
|
|
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
* See the License for the specific language governing permissions and
|
|
* limitations under the License.
|
|
*/
|
|
|
|
package im.vector.matrix.android.api.session
|
|
|
|
import androidx.annotation.MainThread
|
|
import androidx.lifecycle.LiveData
|
|
import im.vector.matrix.android.api.auth.data.SessionParams
|
|
import im.vector.matrix.android.api.pushrules.PushRuleService
|
|
import im.vector.matrix.android.api.session.cache.CacheService
|
|
import im.vector.matrix.android.api.session.content.ContentUploadStateTracker
|
|
import im.vector.matrix.android.api.session.content.ContentUrlResolver
|
|
import im.vector.matrix.android.api.session.crypto.CryptoService
|
|
import im.vector.matrix.android.api.session.group.GroupService
|
|
import im.vector.matrix.android.api.session.pushers.PushersService
|
|
import im.vector.matrix.android.api.session.room.RoomDirectoryService
|
|
import im.vector.matrix.android.api.session.room.RoomService
|
|
import im.vector.matrix.android.api.session.signout.SignOutService
|
|
import im.vector.matrix.android.api.session.sync.FilterService
|
|
import im.vector.matrix.android.api.session.sync.SyncState
|
|
import im.vector.matrix.android.api.session.user.UserService
|
|
|
|
/**
|
|
* This interface defines interactions with a session.
|
|
* An instance of a session will be provided by the SDK.
|
|
*/
|
|
interface Session :
|
|
RoomService,
|
|
RoomDirectoryService,
|
|
GroupService,
|
|
UserService,
|
|
CryptoService,
|
|
CacheService,
|
|
SignOutService,
|
|
FilterService,
|
|
PushRuleService,
|
|
PushersService {
|
|
|
|
/**
|
|
* The params associated to the session
|
|
*/
|
|
val sessionParams: SessionParams
|
|
|
|
/**
|
|
* This method allow to open a session. It does start some service on the background.
|
|
*/
|
|
@MainThread
|
|
fun open()
|
|
|
|
// /**
|
|
// * This method start the sync thread.
|
|
// */
|
|
// @MainThread
|
|
// fun startSync()
|
|
//
|
|
//
|
|
// fun isSyncThreadAlice() : Boolean
|
|
// fun syncThreadState() : String
|
|
//
|
|
//// fun pauseSync()
|
|
//// fun resumeSync()
|
|
//
|
|
// fun shoudPauseOnBackground(shouldPause: Boolean)
|
|
|
|
/**
|
|
* Configures the sync long pooling options
|
|
* @param timoutMS The maximum time to wait, in milliseconds, before returning the sync request.
|
|
* If no events (or other data) become available before this time elapses, the server will return a response with empty fields.
|
|
* If set to 0 the server will return immediately even if the response is empty.
|
|
* @param delayMs When the server responds to a sync request, the client waits for `longPoolDelay` before calling a new sync.
|
|
*/
|
|
// fun configureSyncLongPooling(timoutMS : Long, delayMs : Long )
|
|
|
|
// /**
|
|
// * This method stop the sync thread.
|
|
// */
|
|
// @MainThread
|
|
// fun stopSync()
|
|
|
|
/**
|
|
* This method allows to listen the sync state.
|
|
* @return a [LiveData] of [SyncState].
|
|
*/
|
|
fun syncState(): LiveData<SyncState>
|
|
|
|
/**
|
|
* This method allow to close a session. It does stop some services.
|
|
*/
|
|
@MainThread
|
|
fun close()
|
|
|
|
/**
|
|
* Returns the ContentUrlResolver associated to the session.
|
|
*/
|
|
fun contentUrlResolver(): ContentUrlResolver
|
|
|
|
/**
|
|
* Returns the ContentUploadProgressTracker associated with the session
|
|
*/
|
|
fun contentUploadProgressTracker(): ContentUploadStateTracker
|
|
|
|
/**
|
|
* Add a listener to the session.
|
|
* @param listener the listener to add.
|
|
*/
|
|
fun addListener(listener: Listener)
|
|
|
|
/**
|
|
* Remove a listener from the session.
|
|
* @param listener the listener to remove.
|
|
*/
|
|
fun removeListener(listener: Listener)
|
|
|
|
/**
|
|
* A global session listener to get notified for some events.
|
|
*/
|
|
interface Listener {
|
|
/**
|
|
* The access token is not valid anymore
|
|
*/
|
|
fun onInvalidToken()
|
|
|
|
}
|
|
|
|
} |