Skip to content
palmoni5 edited this page Nov 5, 2026 · 3 revisions

שכבת הנתונים

שכבת הנתונים מאחדת גישה לספרייה הרשמית, לספרים אישיים, למסדים מצורפים ולקובצי מסמכים. מטרתה לספק ל־UI ספר בעל זהות ותוכן בלי לחייב כל מסך לדעת היכן נשמרים הנתונים.

דף זה מתאר את קוד הפיתוח. לתפעול ספרייה ראה מדריך הספרייה.

סוגי אחסון

מקור תפקיד
seforim.db הספרייה הרשמית: קטלוג, שורות, מבנים, קישורים ומטא־נתונים לפי הסכמה שהותקנה
user_books.db רישום ספרים אישיים, תוכן אישי שנשמר במסד, כותרות ומטא־נתונים מיובאים
cache.db מידע שניתן לבנות מחדש, כגון מטמוני תוכן ומבנה של מקורות חיצוניים ונתוני עזר לקישורים
מסד מצורף ספרייה נפרדת עם זהות מקור משלה ויכולות שנבדקות בזמן פתיחה
קובצי ספרים טקסט, PDF ומסמכים הנתמכים במערכת ההמרה
קטלוג חיצוני רישום נפרד של ספרים ממקורות חיצוניים; אינו מעיד שהתוכן הורד
אינדקס החיפוש נתוני חיפוש נגזרים; אינו המקור היחיד לתוכן הספר

המסדים המקומיים משתמשים בתשתית סכמה ו־DAO משותפת, אך תפקידיהם שונים. אין להניח שכל טבלה או יכולת קיימת בכל מסד ובכל גרסת ספרייה. כמו כן, לא כל נתוני המשתמש נשמרים ב־user_books.db; לסימניות, הערות והגדרות יש מסלולי אחסון משלהם.

מבנה הגישה

DataRepository הוא ממשק רחב לטעינת הספרייה, חיפוש ספרים, קריאת תוכן ופתרון זהויות. תחתיו LibraryProviderManager מתאם בין ספקי מסד וספקי קבצים לפי היכולות והעדיפות שלהם.

DatabaseLibraryProvider חושף ספרים ומבנה ממסדי הנתונים. FileSystemLibraryProvider מטפל במקורות קבצים. SqliteDataProvider מרכז גישה למסד הרשמי ולקריאות משולבות, ו־BookDatabaseResolver מאתר את המסד והרשומה המדויקים.

BookTextReader ונתיבי ההמרה מחזירים תוכן לסוג הספר המתאים. ConvertibleDocumentBook מייצג משפחה רחבה של מסמכים; אין להתייחס לכל מסמך שאינו TXT כ־DOCX.

זהות ספר ומקור

BookSource מבחין בין רשמי, אישי ומסד מצורף בעל slug. המקור חייב ללוות את הספר גם אחרי מיזוגו בעץ הספרייה.

BookIdentity מספק מפתחות יציבים לשימושים כגון חיפוש, אינדוקס ומיפוי:

  • id:<id> — ספר רשמי.
  • uid:<id> — ספר אישי.
  • db:<slug>:<id> — ספר במסד מצורף.
  • ext:<externalId> — זהות חיצונית כשקיימת.

ל־PDF רגיל עשוי לשמש הנתיב כמפתח אינדקס. מדיניות זו אינה חלה אוטומטית על PDF ממסד מצורף או בעל זהות חיצונית.

BookCompositeKey משלב שם, קטגוריה, סוג קובץ ומקור לצורכי מיפוי ספקים ומסלולי תאימות. הוא אינו הצדקה לפתור כל ספר לפי כותרת בלבד. קטגוריה מספרית או מזהה ספר מספרי תקפים רק בתוך המקור שלהם.

בפתרון ספר ממסד מצורף, חוסר התאמה צריך להישאר חוסר התאמה; ספר בעל אותו שם במקור אחר אינו תחליף שקוף.

קריאות רקע ומטמונים

קריאות גדולות ופענוח תוכן מועברים ל־DbReadWorker ולעובדים ייעודיים כדי לא לחסום את חוט הממשק. יש להחזיר דרך הגבול נתונים מתאימים להעברה, ולא חיבור SQLite חי.

המטמונים כוללים מידע ספרייה, חיפוש שמות, תוכן עניינים, יכולות מסד ותוצאות המרה. הם דורשים פסילה כאשר קובץ מסד מוחלף, תיקייה משתנה או הספרייה נטענת מחדש.

פעולה שהתחילה לפני החלפת מקור אינה רשאית להחזיר ספר ישן לתוך מצב חדש. מספרי דור, סגירת עובדים ומעקב אחר קריאות פעילות משמשים למניעת מרוצים כאלה. סגירת user_books.db, למשל, ממתינה לקריאות שעדיין מחזיקות בו.

סכמה ויכולות

DbCapabilities בודק טבלאות, עמודות ואינדקסים מוכרים, ומאפשר להתאים שאילתות לסכמות שונות. טבלה רגילה, VIEW וטבלה וירטואלית אינם מתקבלים באותו אופן.

יכולות רבות תלויות בקבוצה של טבלאות. לדוגמה:

  • תוכן עניינים דורש גם שורות וגם את טבלאות המבנה.
  • קישורים דורשים שורות, קישורים וסוגי חיבור.
  • מהדורות דורשות את טבלאות הגרסאות והשורות המתאימות.
  • בסכמות שבהן התוכן פוצל ל־line_content, אין להניח ש־line.content קיים.

עצם האפשרות ליצור DbCapabilities למסד חלקי אינה אומרת שאפשר לצרף אותו כספרייה: בדיקת הצירוף דורשת לפחות את טבלת book, ומצפה למבנה ספרים מתאים. פרטים במסדים מצורפים.

קוד צרכן צריך להשתמש במנגנון היכולות וב־DAO המתאים, ולא להעתיק שאילתת SQL קשיחה שמתאימה רק לספרייה הרשמית העדכנית.

קריאה לעומת כתיבה

המסד הרשמי נפתח בשימוש רגיל לקריאה בלבד. מטמוני זמן ריצה ונתונים אישיים נשמרים במסדים הנפרדים.

עדכון ספרייה הוא חריג מבוקר: הוא סוגר חיבורים ועובדי קריאה, מחליף קובץ או מחיל עדכון, ואז פותח מחדש את המסד ומרענן מטמונים. closeForExternalWrite ו־reopenAfterExternalWrite מסמנים את גבול הפעולה הזה. אין לבצע כתיבה מקבילה דרך חיבור חדש כשהחיבורים הישנים עדיין פעילים.

גם מסד מצורף נקרא בדרך כלל ללא כתיבה, אך פעולת עדכון מורשית יכולה להחליף את קובץ המקור. „קריאה בלבד” מתארת את הגישה הרגילה, ולא הבטחה שקובץ לעולם לא יוחלף.

הקשר לחיפוש ולאיתור

חיפוש שמות משתמש בקטלוג וב־BookSearchWorker. איתור מראי מקום משתמש בשמות ובמבנה הספרים. חיפוש תוכן משתמש באינדקס ולפעמים קורא את הטקסט מהמסד המקורי באמצעות מקור השורות.

הפרדה זו מאפשרת לפתוח ספר עוד לפני אינדוקס, אך מחייבת לדווח למשתמש על ההבדל בין ספר זמין, מבנה זמין ואינדקס מעודכן.

מקורות בקוד

ארכיטקטורה · ספרים אישיים · מסדים מצורפים · אינדוקס

Clone this wiki locally