1use std::path::{Path, PathBuf};
5use std::sync::Arc;
6
7use base::threadpool::ThreadPool;
8use log::{error, info, warn};
9use malloc_size_of::{MallocSizeOf, MallocSizeOfOps};
10use rusqlite::{Connection, Error, OptionalExtension, params};
11use sea_query::{Condition, Expr, ExprTrait, IntoCondition, SqliteQueryBuilder};
12use sea_query_rusqlite::RusqliteBinder;
13use storage_traits::indexeddb::{
14 AsyncOperation, AsyncReadOnlyOperation, AsyncReadWriteOperation, BackendError,
15 CreateObjectResult, IndexedDBIndex, IndexedDBKeyRange, IndexedDBKeyType, IndexedDBRecord,
16 IndexedDBTxnMode, KeyPath, PutItemResult,
17};
18
19use crate::indexeddb::IndexedDBDescription;
20use crate::indexeddb::engines::{KvsEngine, KvsTransaction};
21use crate::shared::{DB_INIT_PRAGMAS, DB_PRAGMAS};
22
23mod create;
24mod database_model;
25mod object_data_model;
26mod object_store_index_model;
27mod object_store_model;
28
29fn range_to_query(range: IndexedDBKeyRange) -> Condition {
30 if let Some(singleton) = range.as_singleton() {
32 let encoded = postcard::to_stdvec(singleton).unwrap();
33 return Expr::column(object_data_model::Column::Key)
34 .eq(encoded)
35 .into_condition();
36 }
37 let mut parts = vec![];
38 if let Some(upper) = range.upper.as_ref() {
39 let upper_bytes = postcard::to_stdvec(upper).unwrap();
40 let query = if range.upper_open {
41 Expr::column(object_data_model::Column::Key).lt(upper_bytes)
42 } else {
43 Expr::column(object_data_model::Column::Key).lte(upper_bytes)
44 };
45 parts.push(query);
46 }
47 if let Some(lower) = range.lower.as_ref() {
48 let lower_bytes = postcard::to_stdvec(lower).unwrap();
49 let query = if range.lower_open {
50 Expr::column(object_data_model::Column::Key).gt(lower_bytes)
51 } else {
52 Expr::column(object_data_model::Column::Key).gte(lower_bytes)
53 };
54 parts.push(query);
55 }
56 let mut condition = Condition::all();
57 for part in parts {
58 condition = condition.add(part);
59 }
60 condition
61}
62
63pub struct SqliteEngine {
64 db_path: PathBuf,
65 connection: Connection,
66 read_pool: Arc<ThreadPool>,
67 write_pool: Arc<ThreadPool>,
68 created_db_path: bool,
69}
70
71impl SqliteEngine {
72 pub fn new(
74 base_dir: &Path,
75 db_info: &IndexedDBDescription,
76 pool: Arc<ThreadPool>,
77 ) -> Result<Self, Error> {
78 let mut db_path = PathBuf::new();
79 db_path.push(base_dir);
80 db_path.push(db_info.as_path());
81 let db_parent = db_path.clone();
82 db_path.push("db.sqlite");
83
84 let created_db_path = if !db_path.exists() {
85 std::fs::create_dir_all(db_parent).unwrap();
86 std::fs::File::create(&db_path).unwrap();
87 true
88 } else {
89 false
90 };
91
92 let connection = Self::init_db(&db_path, db_info)?;
93
94 for stmt in DB_PRAGMAS {
95 let _ = connection.execute(stmt, ());
97 }
98
99 Ok(Self {
100 connection,
101 db_path,
102 read_pool: pool.clone(),
103 write_pool: pool,
104 created_db_path,
105 })
106 }
107
108 pub(crate) fn created_db_path(&self) -> bool {
110 self.created_db_path
111 }
112
113 fn init_db(path: &Path, db_info: &IndexedDBDescription) -> Result<Connection, Error> {
114 let connection = Connection::open(path)?;
115 if connection.table_exists(None, "database")? {
116 return Ok(connection);
118 }
119 info!("Initializing indexeddb database at {:?}", path);
120 for stmt in DB_INIT_PRAGMAS {
121 let _ = connection.execute(stmt, ());
123 }
124 create::create_tables(&connection)?;
125 connection.execute(
128 "INSERT INTO database (name, origin, version) VALUES (?, ?, ?)",
129 params![
130 db_info.name.to_owned(),
131 db_info.origin.to_owned().ascii_serialization(),
132 i64::from_ne_bytes(0_u64.to_ne_bytes())
133 ],
134 )?;
135 Ok(connection)
136 }
137
138 fn get(
139 connection: &Connection,
140 store: object_store_model::Model,
141 key_range: IndexedDBKeyRange,
142 ) -> Result<Option<object_data_model::Model>, Error> {
143 let query = range_to_query(key_range);
144 let (sql, values) = sea_query::Query::select()
145 .from(object_data_model::Column::Table)
146 .columns(vec![
147 object_data_model::Column::ObjectStoreId,
148 object_data_model::Column::Key,
149 object_data_model::Column::Data,
150 ])
151 .and_where(query.and(Expr::col(object_data_model::Column::ObjectStoreId).is(store.id)))
152 .limit(1)
153 .build_rusqlite(SqliteQueryBuilder);
154 connection
155 .prepare(&sql)?
156 .query_one(&*values.as_params(), |row| {
157 object_data_model::Model::try_from(row)
158 })
159 .optional()
160 }
161
162 fn get_key(
163 connection: &Connection,
164 store: object_store_model::Model,
165 key_range: IndexedDBKeyRange,
166 ) -> Result<Option<Vec<u8>>, Error> {
167 Self::get(connection, store, key_range).map(|opt| opt.map(|model| model.key))
168 }
169
170 fn get_item(
171 connection: &Connection,
172 store: object_store_model::Model,
173 key_range: IndexedDBKeyRange,
174 ) -> Result<Option<Vec<u8>>, Error> {
175 Self::get(connection, store, key_range).map(|opt| opt.map(|model| model.data))
176 }
177
178 fn get_all(
179 connection: &Connection,
180 store: object_store_model::Model,
181 key_range: IndexedDBKeyRange,
182 count: Option<u32>,
183 ) -> Result<Vec<object_data_model::Model>, Error> {
184 let query = range_to_query(key_range);
185 let mut sql_query = sea_query::Query::select();
186 sql_query
187 .from(object_data_model::Column::Table)
188 .columns(vec![
189 object_data_model::Column::ObjectStoreId,
190 object_data_model::Column::Key,
191 object_data_model::Column::Data,
192 ])
193 .and_where(query.and(Expr::col(object_data_model::Column::ObjectStoreId).is(store.id)));
194 if let Some(count) = count {
195 sql_query.limit(count as u64);
196 }
197 let (sql, values) = sql_query.build_rusqlite(SqliteQueryBuilder);
198 let mut stmt = connection.prepare(&sql)?;
199 let models = stmt
200 .query_and_then(&*values.as_params(), |row| {
201 object_data_model::Model::try_from(row)
202 })?
203 .collect::<Result<Vec<_>, _>>()?;
204 Ok(models)
205 }
206
207 fn get_all_keys(
208 connection: &Connection,
209 store: object_store_model::Model,
210 key_range: IndexedDBKeyRange,
211 count: Option<u32>,
212 ) -> Result<Vec<Vec<u8>>, Error> {
213 Self::get_all(connection, store, key_range, count)
214 .map(|models| models.into_iter().map(|m| m.key).collect())
215 }
216
217 fn get_all_items(
218 connection: &Connection,
219 store: object_store_model::Model,
220 key_range: IndexedDBKeyRange,
221 count: Option<u32>,
222 ) -> Result<Vec<Vec<u8>>, Error> {
223 Self::get_all(connection, store, key_range, count)
224 .map(|models| models.into_iter().map(|m| m.data).collect())
225 }
226
227 #[expect(clippy::type_complexity)]
228 fn get_all_records(
229 connection: &Connection,
230 store: object_store_model::Model,
231 key_range: IndexedDBKeyRange,
232 ) -> Result<Vec<(Vec<u8>, Vec<u8>)>, Error> {
233 Self::get_all(connection, store, key_range, None)
234 .map(|models| models.into_iter().map(|m| (m.key, m.data)).collect())
235 }
236
237 fn put_item(
238 connection: &Connection,
239 store: object_store_model::Model,
240 key: IndexedDBKeyType,
241 value: Vec<u8>,
242 should_overwrite: bool,
243 key_generator_current_number: Option<i32>,
244 ) -> Result<PutItemResult, Error> {
245 let serialized_key: Vec<u8> = postcard::to_stdvec(&key).unwrap();
246 let existing_item = connection
247 .prepare("SELECT * FROM object_data WHERE key = ? AND object_store_id = ?")
248 .and_then(|mut stmt| {
249 stmt.query_row(params![serialized_key, store.id], |row| {
250 object_data_model::Model::try_from(row)
251 })
252 .optional()
253 })?;
254 if should_overwrite || existing_item.is_none() {
255 connection.execute(
256 "INSERT INTO object_data (object_store_id, key, data) VALUES (?, ?, ?)",
257 params![store.id, serialized_key, value],
258 )?;
259 if let Some(next_key_generator_current_number) = key_generator_current_number {
260 connection.execute(
261 "UPDATE object_store SET auto_increment = ? WHERE id = ?",
262 params![next_key_generator_current_number, store.id],
263 )?;
264 }
265 Ok(PutItemResult::Key(key))
266 } else {
267 Ok(PutItemResult::CannotOverwrite)
268 }
269 }
270
271 fn delete_item(
272 connection: &Connection,
273 store: object_store_model::Model,
274 key_range: IndexedDBKeyRange,
275 ) -> Result<(), Error> {
276 let query = range_to_query(key_range);
277 let (sql, values) = sea_query::Query::delete()
278 .from_table(object_data_model::Column::Table)
279 .and_where(query.and(Expr::col(object_data_model::Column::ObjectStoreId).is(store.id)))
280 .build_rusqlite(SqliteQueryBuilder);
281 connection.prepare(&sql)?.execute(&*values.as_params())?;
282 Ok(())
283 }
284
285 fn clear(connection: &Connection, store: object_store_model::Model) -> Result<(), Error> {
286 connection.execute(
287 "DELETE FROM object_data WHERE object_store_id = ?",
288 params![store.id],
289 )?;
290 Ok(())
291 }
292
293 fn count(
294 connection: &Connection,
295 store: object_store_model::Model,
296 key_range: IndexedDBKeyRange,
297 ) -> Result<usize, Error> {
298 let query = range_to_query(key_range);
299 let (sql, values) = sea_query::Query::select()
300 .expr(Expr::col(object_data_model::Column::Key).count())
301 .from(object_data_model::Column::Table)
302 .and_where(query.and(Expr::col(object_data_model::Column::ObjectStoreId).is(store.id)))
303 .build_rusqlite(SqliteQueryBuilder);
304 connection
305 .prepare(&sql)?
306 .query_row(&*values.as_params(), |row| row.get(0))
307 .map(|count: i64| count as usize)
308 }
309}
310
311impl KvsEngine for SqliteEngine {
312 type Error = Error;
313
314 fn create_store(
315 &self,
316 store_name: &str,
317 key_path: Option<KeyPath>,
318 auto_increment: bool,
319 ) -> Result<CreateObjectResult, Self::Error> {
320 let mut stmt = self
321 .connection
322 .prepare("SELECT * FROM object_store WHERE name = ?")?;
323 if stmt.exists(params![store_name.to_string()])? {
324 return Ok(CreateObjectResult::AlreadyExists);
326 }
327 self.connection.execute(
328 "INSERT INTO object_store (name, key_path, auto_increment) VALUES (?, ?, ?)",
329 params![
330 store_name.to_string(),
331 key_path.map(|v| postcard::to_stdvec(&v).unwrap()),
332 auto_increment as i32
333 ],
334 )?;
335
336 Ok(CreateObjectResult::Created)
337 }
338
339 fn delete_store(&self, store_name: &str) -> Result<(), Self::Error> {
340 let result = self.connection.execute(
341 "DELETE FROM object_store WHERE name = ?",
342 params![store_name.to_string()],
343 )?;
344 if result == 0 {
345 Err(Error::QueryReturnedNoRows)
346 } else if result > 1 {
347 Err(Error::QueryReturnedMoreThanOneRow)
348 } else {
349 Ok(())
350 }
351 }
352
353 fn close_store(&self, _store_name: &str) -> Result<(), Self::Error> {
354 Ok(())
356 }
357
358 fn delete_database(self) -> Result<(), Self::Error> {
359 let _ = self.connection.close();
361 if self.db_path.exists() {
362 if let Err(e) = std::fs::remove_dir_all(self.db_path.parent().unwrap()) {
363 error!("Failed to delete database: {:?}", e);
364 }
365 }
366 Ok(())
367 }
368
369 fn process_transaction(
370 &self,
371 transaction: KvsTransaction,
372 on_complete: Box<dyn FnOnce() + Send + 'static>,
373 ) {
374 let spawning_pool = if transaction.mode == IndexedDBTxnMode::Readonly {
375 self.read_pool.clone()
376 } else {
377 self.write_pool.clone()
378 };
379 let path = self.db_path.clone();
380 spawning_pool.spawn(move || {
381 let connection = match Connection::open(path) {
382 Ok(connection) => connection,
383 Err(error) => {
384 for request in transaction.requests {
385 request
386 .operation
387 .notify_error(BackendError::DbErr(format!("{error:?}")));
388 }
389 on_complete();
390 return;
391 },
392 };
393 for request in transaction.requests {
394 let object_store = connection
395 .prepare("SELECT * FROM object_store WHERE name = ?")
396 .and_then(|mut stmt| {
397 stmt.query_row(params![request.store_name.to_string()], |row| {
398 object_store_model::Model::try_from(row)
399 })
400 .optional()
401 });
402 let object_store = match object_store {
403 Ok(Some(store)) => store,
404 Ok(None) => {
405 request.operation.notify_error(BackendError::StoreNotFound);
406 continue;
407 },
408 Err(error) => {
409 request
410 .operation
411 .notify_error(BackendError::DbErr(format!("{error:?}")));
412 continue;
413 },
414 };
415
416 match request.operation {
417 AsyncOperation::ReadWrite(AsyncReadWriteOperation::PutItem {
418 callback,
419 key,
420 value,
421 should_overwrite,
422 key_generator_current_number,
423 }) => {
424 let (key, key_generator_current_number) = match key {
425 Some(key) => (key, key_generator_current_number),
426 None => {
427 if object_store.auto_increment == 0 {
428 if let Err(error) = callback.send(Err(BackendError::DbErr(
429 "Missing key for PutItem request".to_string(),
430 ))) {
431 warn!("Failed to send PutItem missing key error: {error:?}");
432 }
433 continue;
434 }
435 let Some(next_key_generator_current_number) =
436 object_store.auto_increment.checked_add(1)
437 else {
438 if let Err(error) = callback.send(Err(BackendError::DbErr(
439 "Key generator overflow".to_string(),
440 ))) {
441 warn!(
442 "Failed to send PutItem key generator overflow error: {error:?}"
443 );
444 }
445 continue;
446 };
447 (
448 IndexedDBKeyType::Number(object_store.auto_increment as f64),
449 Some(next_key_generator_current_number),
450 )
451 },
452 };
453 let _ = callback.send(
454 Self::put_item(
455 &connection,
456 object_store,
457 key,
458 value,
459 should_overwrite,
460 key_generator_current_number,
461 )
462 .map_err(|e| BackendError::DbErr(format!("{:?}", e))),
463 );
464 },
465 AsyncOperation::ReadOnly(AsyncReadOnlyOperation::GetItem {
466 callback,
467 key_range,
468 }) => {
469 let _ = callback.send(
470 Self::get_item(&connection, object_store, key_range)
471 .map_err(|e| BackendError::DbErr(format!("{:?}", e))),
472 );
473 },
474 AsyncOperation::ReadOnly(AsyncReadOnlyOperation::GetAllKeys {
475 callback,
476 key_range,
477 count,
478 }) => {
479 let _ = callback.send(
480 Self::get_all_keys(&connection, object_store, key_range, count)
481 .map(|keys| {
482 keys.into_iter()
483 .map(|k| postcard::from_bytes(&k).unwrap())
484 .collect()
485 })
486 .map_err(|e| BackendError::DbErr(format!("{:?}", e))),
487 );
488 },
489 AsyncOperation::ReadOnly(AsyncReadOnlyOperation::GetAllItems {
490 callback,
491 key_range,
492 count,
493 }) => {
494 let _ = callback.send(
495 Self::get_all_items(&connection, object_store, key_range, count)
496 .map_err(|e| BackendError::DbErr(format!("{:?}", e))),
497 );
498 },
499 AsyncOperation::ReadWrite(AsyncReadWriteOperation::RemoveItem {
500 callback,
501 key_range,
502 }) => {
503 let _ = callback.send(
504 Self::delete_item(&connection, object_store, key_range)
505 .map_err(|e| BackendError::DbErr(format!("{:?}", e))),
506 );
507 },
508 AsyncOperation::ReadOnly(AsyncReadOnlyOperation::Count {
509 callback,
510 key_range,
511 }) => {
512 let _ = callback.send(
513 Self::count(&connection, object_store, key_range)
514 .map(|r| r as u64)
515 .map_err(|e| BackendError::DbErr(format!("{:?}", e))),
516 );
517 },
518 AsyncOperation::ReadOnly(AsyncReadOnlyOperation::Iterate {
519 callback,
520 key_range,
521 }) => {
522 let _ = callback.send(
523 Self::get_all_records(&connection, object_store, key_range)
524 .map(|records| {
525 records
526 .into_iter()
527 .map(|(key, data)| IndexedDBRecord {
528 key: postcard::from_bytes(&key).unwrap(),
529 primary_key: postcard::from_bytes(&key).unwrap(),
530 value: data,
531 })
532 .collect()
533 })
534 .map_err(|e| BackendError::DbErr(format!("{:?}", e))),
535 );
536 },
537 AsyncOperation::ReadWrite(AsyncReadWriteOperation::Clear(sender)) => {
538 let _ = sender.send(
539 Self::clear(&connection, object_store)
540 .map_err(|e| BackendError::DbErr(format!("{:?}", e))),
541 );
542 },
543 AsyncOperation::ReadOnly(AsyncReadOnlyOperation::GetKey {
544 callback,
545 key_range,
546 }) => {
547 let _ = callback.send(
548 Self::get_key(&connection, object_store, key_range)
549 .map(|key| key.map(|k| postcard::from_bytes(&k).unwrap()))
550 .map_err(|e| BackendError::DbErr(format!("{:?}", e))),
551 );
552 },
553 }
554 }
555 on_complete();
556 });
557 }
558
559 fn key_generator_current_number(&self, store_name: &str) -> Option<i32> {
560 self.connection
561 .prepare("SELECT * FROM object_store WHERE name = ?")
562 .and_then(|mut stmt| {
563 stmt.query_row(params![store_name.to_string()], |r| {
564 let object_store = object_store_model::Model::try_from(r).unwrap();
565 Ok(object_store.auto_increment)
566 })
567 })
568 .optional()
569 .unwrap()
570 .and_then(|current_number| (current_number != 0).then_some(current_number))
571 }
572
573 fn key_path(&self, store_name: &str) -> Option<KeyPath> {
574 self.connection
575 .prepare("SELECT * FROM object_store WHERE name = ?")
576 .and_then(|mut stmt| {
577 stmt.query_row(params![store_name.to_string()], |r| {
578 let object_store = object_store_model::Model::try_from(r).unwrap();
579 Ok(object_store
580 .key_path
581 .map(|key_path| postcard::from_bytes(&key_path).unwrap()))
582 })
583 })
584 .optional()
585 .unwrap()
586 .unwrap_or_default()
588 }
589
590 fn object_store_names(&self) -> Result<Vec<String>, Self::Error> {
591 let mut stmt = self.connection.prepare("SELECT name FROM object_store")?;
592 stmt.query_map([], |row| row.get(0))?
593 .collect::<Result<Vec<_>, _>>()
594 }
595
596 fn indexes(&self, store_name: &str) -> Result<Vec<IndexedDBIndex>, Self::Error> {
597 let object_store = self.connection.query_row(
598 "SELECT * FROM object_store WHERE name = ?",
599 params![store_name.to_string()],
600 |row| object_store_model::Model::try_from(row),
601 )?;
602
603 let mut stmt = self
604 .connection
605 .prepare("SELECT * FROM object_store_index WHERE object_store_id = ?")?;
606 let indexes = stmt
607 .query_map(params![object_store.id], |row| {
608 let model = object_store_index_model::Model::try_from(row)?;
609 Ok(IndexedDBIndex {
610 name: model.name,
611 key_path: postcard::from_bytes(&model.key_path).unwrap(),
612 unique: model.unique_index,
613 multi_entry: model.multi_entry_index,
614 })
615 })?
616 .collect::<Result<Vec<_>, _>>()?;
617 Ok(indexes)
618 }
619
620 fn create_index(
621 &self,
622 store_name: &str,
623 index_name: String,
624 key_path: KeyPath,
625 unique: bool,
626 multi_entry: bool,
627 ) -> Result<CreateObjectResult, Self::Error> {
628 let object_store = self.connection.query_row(
629 "SELECT * FROM object_store WHERE name = ?",
630 params![store_name.to_string()],
631 |row| object_store_model::Model::try_from(row),
632 )?;
633
634 let index_exists: bool = self.connection.query_row(
635 "SELECT EXISTS(SELECT * FROM object_store_index WHERE name = ? AND object_store_id = ?)",
636 params![index_name.to_string(), object_store.id],
637 |row| row.get(0),
638 )?;
639 if index_exists {
640 return Ok(CreateObjectResult::AlreadyExists);
641 }
642
643 self.connection.execute(
644 "INSERT INTO object_store_index (object_store_id, name, key_path, unique_index, multi_entry_index)\
645 VALUES (?, ?, ?, ?, ?)",
646 params![
647 object_store.id,
648 index_name.to_string(),
649 postcard::to_stdvec(&key_path).unwrap(),
650 unique,
651 multi_entry,
652 ],
653 )?;
654 Ok(CreateObjectResult::Created)
655 }
656
657 fn delete_index(&self, store_name: &str, index_name: String) -> Result<(), Self::Error> {
658 let object_store = self.connection.query_row(
659 "SELECT * FROM object_store WHERE name = ?",
660 params![store_name.to_string()],
661 |r| Ok(object_store_model::Model::try_from(r).unwrap()),
662 )?;
663
664 let _ = self.connection.execute(
666 "DELETE FROM object_store_index WHERE name = ? AND object_store_id = ?",
667 params![index_name.to_string(), object_store.id],
668 )?;
669 Ok(())
670 }
671
672 fn version(&self) -> Result<u64, Self::Error> {
673 let version: i64 =
674 self.connection
675 .query_row("SELECT version FROM database LIMIT 1", [], |row| row.get(0))?;
676 Ok(u64::from_ne_bytes(version.to_ne_bytes()))
677 }
678
679 fn set_version(&self, version: u64) -> Result<(), Self::Error> {
680 let rows_affected = self.connection.execute(
681 "UPDATE database SET version = ?",
682 params![i64::from_ne_bytes(version.to_ne_bytes())],
683 )?;
684 if rows_affected == 0 {
685 return Err(Error::QueryReturnedNoRows);
686 }
687 Ok(())
688 }
689}
690
691fn get_db_status(connection: &Connection, op: i32) -> Result<i32, i32> {
692 let mut p_curr = 0;
693 let mut p_hiwater = 0;
694 let res = unsafe {
695 rusqlite::ffi::sqlite3_db_status(connection.handle(), op, &mut p_curr, &mut p_hiwater, 0)
696 };
697 if res != 0 { Err(res) } else { Ok(p_curr) }
698}
699
700impl MallocSizeOf for SqliteEngine {
701 fn size_of(&self, ops: &mut MallocSizeOfOps) -> usize {
702 const DEFAULT_LOOKASIDE_SIZE: usize = 48 * 1024;
704 self.created_db_path.size_of(ops) +
705 DEFAULT_LOOKASIDE_SIZE +
706 get_db_status(
707 &self.connection,
708 rusqlite::ffi::SQLITE_DBSTATUS_CACHE_USED_SHARED,
709 )
710 .unwrap_or_default() as usize +
711 get_db_status(&self.connection, rusqlite::ffi::SQLITE_DBSTATUS_SCHEMA_USED)
712 .unwrap_or_default() as usize +
713 get_db_status(&self.connection, rusqlite::ffi::SQLITE_DBSTATUS_STMT_USED)
714 .unwrap_or_default() as usize
715 }
716}
717
718#[cfg(test)]
719mod tests {
720 use std::collections::VecDeque;
721 use std::sync::Arc;
722
723 use base::generic_channel::{self, GenericReceiver, GenericSender};
724 use base::threadpool::ThreadPool;
725 use profile_traits::generic_callback::GenericCallback;
726 use profile_traits::time::ProfilerChan;
727 use serde::{Deserialize, Serialize};
728 use servo_url::ImmutableOrigin;
729 use storage_traits::indexeddb::{
730 AsyncOperation, AsyncReadOnlyOperation, AsyncReadWriteOperation, CreateObjectResult,
731 IndexedDBKeyRange, IndexedDBKeyType, IndexedDBTxnMode, KeyPath, PutItemResult,
732 };
733 use url::Host;
734
735 use crate::indexeddb::IndexedDBDescription;
736 use crate::indexeddb::engines::{KvsEngine, KvsOperation, KvsTransaction, SqliteEngine};
737
738 fn test_origin() -> ImmutableOrigin {
739 ImmutableOrigin::Tuple(
740 "test_origin".to_string(),
741 Host::Domain("localhost".to_string()),
742 80,
743 )
744 }
745
746 fn get_pool() -> Arc<ThreadPool> {
747 Arc::new(ThreadPool::new(1, "test".to_string()))
748 }
749
750 #[test]
751 fn test_cycle() {
752 let base_dir = tempfile::tempdir().expect("Failed to create temp dir");
753 let thread_pool = get_pool();
754 let _ = SqliteEngine::new(
756 base_dir.path(),
757 &IndexedDBDescription {
758 name: "test_db".to_string(),
759 origin: test_origin(),
760 },
761 thread_pool.clone(),
762 )
763 .unwrap();
764 let db = SqliteEngine::new(
766 base_dir.path(),
767 &IndexedDBDescription {
768 name: "test_db".to_string(),
769 origin: test_origin(),
770 },
771 thread_pool.clone(),
772 )
773 .unwrap();
774 let version = db.version().expect("Failed to get version");
775 assert_eq!(version, 0);
776 db.set_version(5).unwrap();
777 let new_version = db.version().expect("Failed to get new version");
778 assert_eq!(new_version, 5);
779 db.delete_database().expect("Failed to delete database");
780 }
781
782 #[test]
783 fn test_create_store() {
784 let base_dir = tempfile::tempdir().expect("Failed to create temp dir");
785 let thread_pool = get_pool();
786 let db = SqliteEngine::new(
787 base_dir.path(),
788 &IndexedDBDescription {
789 name: "test_db".to_string(),
790 origin: test_origin(),
791 },
792 thread_pool,
793 )
794 .unwrap();
795 let store_name = "test_store";
796 let result = db.create_store(store_name, None, true);
797 assert!(result.is_ok());
798 let create_result = result.unwrap();
799 assert_eq!(create_result, CreateObjectResult::Created);
800 let result = db.create_store(store_name, None, false);
802 assert!(result.is_ok());
803 let create_result = result.unwrap();
804 assert_eq!(create_result, CreateObjectResult::AlreadyExists);
805 assert!(db.key_generator_current_number(store_name).is_some());
807 }
808
809 #[test]
810 fn test_create_store_empty_name() {
811 let base_dir = tempfile::tempdir().expect("Failed to create temp dir");
812 let thread_pool = get_pool();
813 let db = SqliteEngine::new(
814 base_dir.path(),
815 &IndexedDBDescription {
816 name: "test_db".to_string(),
817 origin: test_origin(),
818 },
819 thread_pool,
820 )
821 .unwrap();
822 let store_name = "";
823 let result = db.create_store(store_name, None, true);
824 assert!(result.is_ok());
825 let create_result = result.unwrap();
826 assert_eq!(create_result, CreateObjectResult::Created);
827 }
828
829 #[test]
830 fn test_injection() {
831 let base_dir = tempfile::tempdir().expect("Failed to create temp dir");
832 let thread_pool = get_pool();
833 let db = SqliteEngine::new(
834 base_dir.path(),
835 &IndexedDBDescription {
836 name: "test_db".to_string(),
837 origin: test_origin(),
838 },
839 thread_pool,
840 )
841 .unwrap();
842 let store_name1 = "test_store";
844 let result = db.create_store(store_name1, None, true);
845 assert!(result.is_ok());
846 let create_result = result.unwrap();
847 assert_eq!(create_result, CreateObjectResult::Created);
848 let store_name2 = "' OR 1=1 -- -";
850 let result = db.create_store(store_name2, None, false);
851 assert!(result.is_ok());
852 let create_result = result.unwrap();
853 assert_eq!(create_result, CreateObjectResult::Created);
854 }
855
856 #[test]
857 fn test_key_path() {
858 let base_dir = tempfile::tempdir().expect("Failed to create temp dir");
859 let thread_pool = get_pool();
860 let db = SqliteEngine::new(
861 base_dir.path(),
862 &IndexedDBDescription {
863 name: "test_db".to_string(),
864 origin: test_origin(),
865 },
866 thread_pool,
867 )
868 .unwrap();
869 let store_name = "test_store";
870 let result = db.create_store(store_name, Some(KeyPath::String("test".to_string())), true);
871 assert!(result.is_ok());
872 assert_eq!(
873 db.key_path(store_name),
874 Some(KeyPath::String("test".to_string()))
875 );
876 }
877
878 #[test]
879 fn test_delete_store() {
880 let base_dir = tempfile::tempdir().expect("Failed to create temp dir");
881 let thread_pool = get_pool();
882 let db = SqliteEngine::new(
883 base_dir.path(),
884 &IndexedDBDescription {
885 name: "test_db".to_string(),
886 origin: test_origin(),
887 },
888 thread_pool,
889 )
890 .unwrap();
891 db.create_store("test_store", None, false)
892 .expect("Failed to create store");
893 db.delete_store("test_store")
895 .expect("Failed to delete store");
896 let result = db.delete_store("test_store");
898 assert!(result.is_err());
899 let result = db.delete_store("test_store");
901 assert!(result.is_err());
903 }
904
905 #[test]
906 fn test_async_operations() {
907 fn get_channel<T>() -> (GenericSender<T>, GenericReceiver<T>)
908 where
909 T: for<'de> Deserialize<'de> + Serialize,
910 {
911 generic_channel::channel().unwrap()
912 }
913
914 fn get_callback<T>(chan: GenericSender<T>) -> GenericCallback<T>
915 where
916 T: for<'de> Deserialize<'de> + Serialize + Send + Sync,
917 {
918 GenericCallback::new(ProfilerChan(None), move |r| {
919 assert!(chan.send(r.unwrap()).is_ok());
920 })
921 .expect("Could not construct callback")
922 }
923
924 let base_dir = tempfile::tempdir().expect("Failed to create temp dir");
925 let thread_pool = get_pool();
926 let db = SqliteEngine::new(
927 base_dir.path(),
928 &IndexedDBDescription {
929 name: "test_db".to_string(),
930 origin: test_origin(),
931 },
932 thread_pool,
933 )
934 .unwrap();
935 let store_name = "test_store";
936 db.create_store(store_name, None, false)
937 .expect("Failed to create store");
938 let put = get_channel();
939 let put2 = get_channel();
940 let put3 = get_channel();
941 let put_dup = get_channel();
942 let get_item_some = get_channel();
943 let get_item_none = get_channel();
944 let get_all_items = get_channel();
945 let count = get_channel();
946 let remove = get_channel();
947 let clear = get_channel();
948 let (done_tx, done_rx) = std::sync::mpsc::channel();
949 db.process_transaction(
950 KvsTransaction {
951 mode: IndexedDBTxnMode::Readwrite,
952 requests: VecDeque::from(vec![
953 KvsOperation {
954 store_name: store_name.to_owned(),
955 operation: AsyncOperation::ReadWrite(AsyncReadWriteOperation::PutItem {
956 callback: get_callback(put.0),
957 key: Some(IndexedDBKeyType::Number(1.0)),
958 value: vec![1, 2, 3],
959 should_overwrite: false,
960 key_generator_current_number: None,
961 }),
962 },
963 KvsOperation {
964 store_name: store_name.to_owned(),
965 operation: AsyncOperation::ReadWrite(AsyncReadWriteOperation::PutItem {
966 callback: get_callback(put2.0),
967 key: Some(IndexedDBKeyType::String("2.0".to_string())),
968 value: vec![4, 5, 6],
969 should_overwrite: false,
970 key_generator_current_number: None,
971 }),
972 },
973 KvsOperation {
974 store_name: store_name.to_owned(),
975 operation: AsyncOperation::ReadWrite(AsyncReadWriteOperation::PutItem {
976 callback: get_callback(put3.0),
977 key: Some(IndexedDBKeyType::Array(vec![
978 IndexedDBKeyType::String("3".to_string()),
979 IndexedDBKeyType::Number(0.0),
980 ])),
981 value: vec![7, 8, 9],
982 should_overwrite: false,
983 key_generator_current_number: None,
984 }),
985 },
986 KvsOperation {
988 store_name: store_name.to_owned(),
989 operation: AsyncOperation::ReadWrite(AsyncReadWriteOperation::PutItem {
990 callback: get_callback(put_dup.0),
991 key: Some(IndexedDBKeyType::Number(1.0)),
992 value: vec![10, 11, 12],
993 should_overwrite: false,
994 key_generator_current_number: None,
995 }),
996 },
997 KvsOperation {
998 store_name: store_name.to_owned(),
999 operation: AsyncOperation::ReadOnly(AsyncReadOnlyOperation::GetItem {
1000 callback: get_callback(get_item_some.0),
1001 key_range: IndexedDBKeyRange::only(IndexedDBKeyType::Number(1.0)),
1002 }),
1003 },
1004 KvsOperation {
1005 store_name: store_name.to_owned(),
1006 operation: AsyncOperation::ReadOnly(AsyncReadOnlyOperation::GetItem {
1007 callback: get_callback(get_item_none.0),
1008 key_range: IndexedDBKeyRange::only(IndexedDBKeyType::Number(5.0)),
1009 }),
1010 },
1011 KvsOperation {
1012 store_name: store_name.to_owned(),
1013 operation: AsyncOperation::ReadOnly(AsyncReadOnlyOperation::GetAllItems {
1014 callback: get_callback(get_all_items.0),
1015 key_range: IndexedDBKeyRange::lower_bound(
1016 IndexedDBKeyType::Number(0.0),
1017 false,
1018 ),
1019 count: None,
1020 }),
1021 },
1022 KvsOperation {
1023 store_name: store_name.to_owned(),
1024 operation: AsyncOperation::ReadOnly(AsyncReadOnlyOperation::Count {
1025 callback: get_callback(count.0),
1026 key_range: IndexedDBKeyRange::only(IndexedDBKeyType::Number(1.0)),
1027 }),
1028 },
1029 KvsOperation {
1030 store_name: store_name.to_owned(),
1031 operation: AsyncOperation::ReadWrite(AsyncReadWriteOperation::RemoveItem {
1032 callback: get_callback(remove.0),
1033 key_range: IndexedDBKeyRange::only(IndexedDBKeyType::Number(1.0)),
1034 }),
1035 },
1036 KvsOperation {
1037 store_name: store_name.to_owned(),
1038 operation: AsyncOperation::ReadWrite(AsyncReadWriteOperation::Clear(
1039 get_callback(clear.0),
1040 )),
1041 },
1042 ]),
1043 },
1044 Box::new(move || {
1045 let _ = done_tx.send(());
1046 }),
1047 );
1048 let _ = done_rx.recv().unwrap();
1049 put.1.recv().unwrap().unwrap();
1050 put2.1.recv().unwrap().unwrap();
1051 put3.1.recv().unwrap().unwrap();
1052 let err = put_dup.1.recv().unwrap().unwrap();
1053 assert_eq!(err, PutItemResult::CannotOverwrite);
1054 let get_result = get_item_some.1.recv().unwrap();
1055 let value = get_result.unwrap();
1056 assert_eq!(value, Some(vec![1, 2, 3]));
1057 let get_result = get_item_none.1.recv().unwrap();
1058 let value = get_result.unwrap();
1059 assert_eq!(value, None);
1060 let all_items = get_all_items.1.recv().unwrap().unwrap();
1061 assert_eq!(all_items.len(), 3);
1062 assert!(all_items.contains(&vec![1, 2, 3]));
1064 assert!(all_items.contains(&vec![4, 5, 6]));
1065 assert!(all_items.contains(&vec![7, 8, 9]));
1066 let amount = count.1.recv().unwrap().unwrap();
1067 assert_eq!(amount, 1);
1068 remove.1.recv().unwrap().unwrap();
1069 clear.1.recv().unwrap().unwrap();
1070 }
1071}