/* This Source Code Form is subject to the terms of the Mozilla Public *License,v.2.0.IfacopyoftheMPLwasnotdistributedwiththis
* file, You can obtain one at http://mozilla.org/MPL/2.0/. */
usecrate::schema; usecrate::storage::{ClientRemoteTabs, RemoteTab, TABS_CLIENT_TTL}; usecrate::store::TabsStore; usecrate::sync::record::{TabsRecord, TabsRecordTab}; use anyhow::Result; use std::collections::HashMap; use std::sync::{Arc, Mutex, RwLock, Weak}; use sync15::bso::{IncomingBso, OutgoingBso, OutgoingEnvelope}; use sync15::engine::{
CollSyncIds, CollectionRequest, EngineSyncAssociation, SyncEngine, SyncEngineId,
}; use sync15::{telemetry, ClientData, CollectionName, DeviceType, RemoteClient, ServerTimestamp}; use sync_guid::Guid;
// Our "sync manager" will use whatever is stashed here.
lazy_static::lazy_static! { // Mutex: just taken long enough to update the inner stuff staticref STORE_FOR_MANAGER: Mutex<Weak<TabsStore>> = Mutex::new(Weak::new());
}
/// Called by the sync manager to get a sync engine via the store previously /// registered with the sync manager. pubfn get_registered_sync_engine(
engine_id: &SyncEngineId,
) -> Option<Box<dyn sync15::engine::SyncEngine>> { let weak = STORE_FOR_MANAGER.lock().unwrap(); match weak.upgrade() {
None => None,
Some(store) => match engine_id {
SyncEngineId::Tabs => Some(Box::new(TabsEngine::new(Arc::clone(&store)))), // panicking here seems reasonable - it's a static error if this // it hit, not something that runtime conditions can influence.
_ => unreachable!("can't provide unknown engine: {}", engine_id),
},
}
}
// Note that this should die as part of https://github.com/mozilla/application-services/issues/5199 // If we don't have a `RemoteClient` record, then we don't know whether the ID passed here is // the fxa_device_id (which is must be) or the client_id (which it will be if this ends up being // called for desktop records, where client_id != fxa_device_id) pub(crate) fn from_record(
client_id: String,
last_modified: ServerTimestamp,
record: TabsRecord,
) -> Self { Self {
client_id,
client_name: record.client_name,
device_type: DeviceType::Unknown,
last_modified: last_modified.as_millis(),
remote_tabs: record.tabs.iter().map(RemoteTab::from_record_tab).collect(),
}
} fn to_record(&self) -> TabsRecord {
TabsRecord {
id: self.client_id.clone(),
client_name: self.client_name.clone(),
tabs: self
.remote_tabs
.iter()
.map(RemoteTab::to_record_tab)
.collect(),
}
}
}
// This is the implementation of syncing, which is used by the 2 different "sync engines" // (We hope to get these 2 engines even closer in the future, but for now, we suck this up) pubstruct TabsEngine { pub(super) store: Arc<TabsStore>, // local_id is made public for use in examples/tabs-sync pub local_id: RwLock<String>,
}
fn prepare_for_sync(&self, get_client_data: &dynFn() -> ClientData) -> Result<()> { letmut storage = self.store.storage.lock().unwrap(); // We only know the client list at sync time, but need to return tabs potentially // at any time -- so we store the clients in the meta table to be able to properly // return a ClientRemoteTab struct let client_data = get_client_data();
storage.put_meta(
schema::REMOTE_CLIENTS_KEY,
&serde_json::to_string(&client_data.recent_clients)?,
)?;
*self.local_id.write().unwrap() = client_data.local_client_id;
Ok(())
}
fn stage_incoming(
&self,
inbound: Vec<IncomingBso>,
telem: &mut telemetry::Engine,
) -> Result<()> { // We don't really "stage" records, we just apply them. let local_id = &*self.local_id.read().unwrap(); letmut remote_tabs = Vec::with_capacity(inbound.len());
letmut incoming_telemetry = telemetry::EngineIncoming::new(); for incoming in inbound { if incoming.envelope.id == *local_id { // That's our own record, ignore it. continue;
} let modified = incoming.envelope.modified; let record = match incoming.into_content::<TabsRecord>().content() {
Some(record) => record,
None => { // Invalid record or a "tombstone" which tabs don't have.
log::warn!("Ignoring incoming invalid tab");
incoming_telemetry.failed(1); continue;
}
};
incoming_telemetry.applied(1);
remote_tabs.push((record, modified));
}
telem.incoming(incoming_telemetry); letmut storage = self.store.storage.lock().unwrap(); // In desktop we might end up here with zero records when doing a quick-write, in // which case we don't want to wipe the DB. if !remote_tabs.is_empty() {
storage.replace_remote_tabs(&remote_tabs)?;
}
storage.remove_stale_clients()?;
storage.remove_old_pending_closures(&remote_tabs)?;
Ok(())
}
fn apply(
&self,
timestamp: ServerTimestamp,
_telem: &mut telemetry::Engine,
) -> Result<Vec<OutgoingBso>> { // We've already applied them - really we just need to fetch outgoing. let (local_tabs, remote_clients) = { letmut storage = self.store.storage.lock().unwrap(); let local_tabs = storage.prepare_local_tabs_for_upload(); let remote_clients: HashMap<String, RemoteClient> = { match storage.get_meta::<String>(schema::REMOTE_CLIENTS_KEY)? {
None => HashMap::default(),
Some(json) => serde_json::from_str(&json).unwrap(),
}
};
(local_tabs, remote_clients)
};
let local_id = &*self.local_id.read().unwrap(); // Timestamp will be zero when used as a "bridged" engine. if timestamp.0 != 0 { self.set_last_sync(timestamp)?;
} // XXX - outgoing telem? let outgoing = iflet Some(local_tabs) = local_tabs { let (client_name, device_type) = remote_clients
.get(local_id)
.map(|client| (client.device_name.clone(), client.device_type))
.unwrap_or_else(|| (String::new(), DeviceType::Unknown)); let local_record = ClientRemoteTabs {
client_id: local_id.clone(),
client_name,
device_type,
last_modified: 0, // ignored for outgoing records.
remote_tabs: local_tabs.to_vec(),
};
log::trace!("outgoing {:?}", local_record); let envelope = OutgoingEnvelope {
id: local_id.as_str().into(),
ttl: Some(TABS_CLIENT_TTL),
..Default::default()
};
vec![OutgoingBso::from_content(
envelope,
local_record.to_record(),
)?]
} else {
vec![]
};
Ok(outgoing)
}
fn wipe(&self) -> Result<()> { self.reset(&EngineSyncAssociation::Disconnected)?; // not clear why we need to wipe the local tabs - the app is just going // to re-add them? self.store.storage.lock().unwrap().wipe_local_tabs();
Ok(())
}
implcrate::TabsStore { // This allows the embedding app to say "make this instance available to // the sync manager". The implementation is more like "offer to sync mgr" // (thereby avoiding us needing to link with the sync manager) but // `register_with_sync_manager()` is logically what's happening so that's // the name it gets. pubfn register_with_sync_manager(self: Arc<Self>) { letmut state = STORE_FOR_MANAGER.lock().unwrap();
*state = Arc::downgrade(&self);
}
}
#[cfg(test)] pubmod test { usesuper::*; use serde_json::json; use sync15::bso::IncomingBso;
let engine = TabsEngine::new(Arc::new(TabsStore::new_with_mem_path("test-incoming")));
let records = vec![
json!({ "id": "device-no-tabs", "clientName": "device with no tabs", "tabs": [],
}),
json!({ "id": "device-with-a-tab", "clientName": "device with a tab", "tabs": [{ "title": "the title", "urlHistory": [ "https://mozilla.org/"
], "icon": "https://mozilla.org/icon", "lastUsed": 1643764207
}]
}), // test an updated payload will replace the previous record
json!({ "id": "device-with-a-tab", "clientName": "device with an updated tab", "tabs": [{ "title": "the new title", "urlHistory": [ "https://mozilla.org/"
], "icon": "https://mozilla.org/icon", "lastUsed": 1643764208
}]
}), // This has the main payload as OK but the tabs part invalid.
json!({ "id": "device-with-invalid-tab", "clientName": "device with a tab", "tabs": [{ "foo": "bar",
}]
}), // We want this to be a valid payload but an invalid tab - so it needs an ID.
json!({ "id": "invalid-tab", "foo": "bar"
}),
];
letmut telem = telemetry::Engine::new("tabs"); let incoming = records
.into_iter()
.map(IncomingBso::from_test_content)
.collect();
engine
.stage_incoming(incoming, &mut telem)
.expect("Should apply incoming and stage outgoing records"); let outgoing = engine
.apply(ServerTimestamp(0), &mut telem)
.expect("should apply");
assert!(outgoing.is_empty());
// now check the store has what we think it has. letmut storage = engine.store.storage.lock().unwrap(); letmut crts = storage.get_remote_tabs().expect("should work");
crts.sort_by(|a, b| a.client_name.partial_cmp(&b.client_name).unwrap());
assert_eq!(crts.len(), 2, "we currently include devices with no tabs"); let crt = &crts[0];
assert_eq!(crt.client_name, "device with an updated tab");
assert_eq!(crt.device_type, DeviceType::Unknown);
assert_eq!(crt.remote_tabs.len(), 1);
assert_eq!(crt.remote_tabs[0].title, "the new title");
let crt = &crts[1];
assert_eq!(crt.client_name, "device with no tabs");
assert_eq!(crt.device_type, DeviceType::Unknown);
assert_eq!(crt.remote_tabs.len(), 0);
}
let engine = TabsEngine::new(Arc::new(TabsStore::new_with_mem_path( "test_no_incoming_doesnt_write",
)));
let records = vec![json!({ "id": "device-with-a-tab", "clientName": "device with a tab", "tabs": [{ "title": "the title", "urlHistory": [ "https://mozilla.org/"
], "icon": "https://mozilla.org/icon", "lastUsed": 1643764207
}]
})];
letmut telem = telemetry::Engine::new("tabs"); let incoming = records
.into_iter()
.map(IncomingBso::from_test_content)
.collect();
engine
.stage_incoming(incoming, &mut telem)
.expect("Should apply incoming and stage outgoing records");
engine
.apply(ServerTimestamp(0), &mut telem)
.expect("should apply");
// now check the store has what we think it has.
{ letmut storage = engine.store.storage.lock().unwrap();
assert_eq!(storage.get_remote_tabs().expect("should work").len(), 1);
}
// Now another sync with zero incoming records, should still be able to get back // our one client.
engine
.stage_incoming(vec![], &mut telemetry::Engine::new("tabs"))
.expect("Should succeed applying zero records");
#[test] fn test_sync_manager_registration() { let store = Arc::new(TabsStore::new_with_mem_path("test-registration"));
assert_eq!(Arc::strong_count(&store), 1);
assert_eq!(Arc::weak_count(&store), 0);
Arc::clone(&store).register_with_sync_manager();
assert_eq!(Arc::strong_count(&store), 1);
assert_eq!(Arc::weak_count(&store), 1); let registered = STORE_FOR_MANAGER
.lock()
.unwrap()
.upgrade()
.expect("should upgrade");
assert!(Arc::ptr_eq(&store, ®istered));
drop(registered); // should be no new references
assert_eq!(Arc::strong_count(&store), 1);
assert_eq!(Arc::weak_count(&store), 1); // dropping the registered object should drop the registration.
drop(store);
assert!(STORE_FOR_MANAGER.lock().unwrap().upgrade().is_none());
}
assert_eq!(
engine
.get_last_sync()
.expect("should work")
.expect("should have a value"),
ServerTimestamp::from_millis(123), "didn't set a zero timestamp"
)
}
}
Messung V0.5 in Prozent
¤ Dauer der Verarbeitung: 0.11 Sekunden
(vorverarbeitet am 2026-06-18)
¤
Die Informationen auf dieser Webseite wurden
nach bestem Wissen sorgfältig zusammengestellt. Es wird jedoch weder Vollständigkeit, noch Richtigkeit,
noch Qualität der bereit gestellten Informationen zugesichert.
Bemerkung:
Die farbliche Syntaxdarstellung und die Messung sind noch experimentell.