mirror of
https://github.com/rustfs/rustfs.git
synced 2026-08-05 21:07:43 +00:00
25512e2635
Co-authored-by: 安正超 <anzhengchao@gmail.com>
84 lines
2.7 KiB
Rust
84 lines
2.7 KiB
Rust
// Copyright 2024 RustFS Team
|
|
//
|
|
// 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.
|
|
|
|
pub mod local;
|
|
// pub mod remote;
|
|
|
|
use crate::{LockId, LockInfo, LockRequest, LockResponse, LockStats, Result};
|
|
use async_trait::async_trait;
|
|
use futures::future::join_all;
|
|
use std::sync::Arc;
|
|
|
|
/// Lock client trait
|
|
#[async_trait]
|
|
pub trait LockClient: Send + Sync + std::fmt::Debug {
|
|
/// Acquire lock (generic method)
|
|
async fn acquire_lock(&self, request: &LockRequest) -> Result<LockResponse>;
|
|
|
|
/// Acquire multiple locks. Default implementation fans out to single-lock requests.
|
|
async fn acquire_locks_batch(&self, requests: &[LockRequest]) -> Result<Vec<LockResponse>> {
|
|
Ok(join_all(requests.iter().map(|request| self.acquire_lock(request)))
|
|
.await
|
|
.into_iter()
|
|
.collect::<Result<Vec<_>>>()?)
|
|
}
|
|
|
|
/// Release lock
|
|
async fn release(&self, lock_id: &LockId) -> Result<bool>;
|
|
|
|
/// Release multiple locks. Default implementation fans out to single-lock releases.
|
|
async fn release_locks_batch(&self, lock_ids: &[LockId]) -> Result<Vec<bool>> {
|
|
Ok(join_all(lock_ids.iter().map(|lock_id| self.release(lock_id)))
|
|
.await
|
|
.into_iter()
|
|
.collect::<Result<Vec<_>>>()?)
|
|
}
|
|
|
|
/// Refresh lock
|
|
async fn refresh(&self, lock_id: &LockId) -> Result<bool>;
|
|
|
|
/// Force release lock
|
|
async fn force_release(&self, lock_id: &LockId) -> Result<bool>;
|
|
|
|
/// Check lock status
|
|
async fn check_status(&self, lock_id: &LockId) -> Result<Option<LockInfo>>;
|
|
|
|
/// Get statistics
|
|
async fn get_stats(&self) -> Result<LockStats>;
|
|
|
|
/// Close client
|
|
async fn close(&self) -> Result<()>;
|
|
|
|
/// Check if client is online
|
|
async fn is_online(&self) -> bool;
|
|
|
|
/// Check if client is local
|
|
async fn is_local(&self) -> bool;
|
|
}
|
|
|
|
/// Client factory
|
|
pub struct ClientFactory;
|
|
|
|
impl ClientFactory {
|
|
/// Create local client
|
|
pub fn create_local() -> Arc<dyn LockClient> {
|
|
Arc::new(local::LocalClient::new())
|
|
}
|
|
|
|
// /// Create remote client
|
|
// pub fn create_remote(endpoint: String) -> Arc<dyn LockClient> {
|
|
// Arc::new(remote::RemoteClient::new(endpoint))
|
|
// }
|
|
}
|