servers/http/utils/router.rs
1// Copyright 2023 Greptime Team
2//
3// Licensed under the Apache License, Version 2.0 (the "License");
4// you may not use this file except in compliance with the License.
5// You may obtain a copy of the License at
6//
7// http://www.apache.org/licenses/LICENSE-2.0
8//
9// Unless required by applicable law or agreed to in writing, software
10// distributed under the License is distributed on an "AS IS" BASIS,
11// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12// See the License for the specific language governing permissions and
13// limitations under the License.
14
15use std::sync::{Arc, Mutex};
16
17use axum::Router;
18
19/// A thread-safe wrapper for an Axum [`Router`] that allows for dynamic configuration.
20#[derive(Default, Clone)]
21pub struct RouterConfigurator(Arc<Mutex<Router>>);
22
23impl RouterConfigurator {
24 /// Returns a clone of the current [`Router`].
25 pub fn router(&self) -> Router {
26 self.0.lock().unwrap().clone()
27 }
28
29 /// Applies a configuration function to the current [`Router`].
30 ///
31 /// The provided closure receives the current router (cloned) and should return a new [`Router`].
32 /// The internal router is then replaced with the result.
33 pub fn configure(&self, f: impl FnOnce(Router) -> Router) {
34 let mut router = self.0.lock().unwrap();
35 *router = f(router.clone());
36 }
37}