Repository navigation
Data Layer
שכבת הנתונים מאחדת גישה לספרייה הרשמית, לספרים אישיים, למסדים מצורפים ולקובצי מסמכים. מטרתה לספק ל־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. איתור מראי מקום משתמש בשמות ובמבנה הספרים. חיפוש תוכן משתמש באינדקס ולפעמים קורא את הטקסט מהמסד המקורי באמצעות מקור השורות.
הפרדה זו מאפשרת לפתוח ספר עוד לפני אינדוקס, אך מחייבת לדווח למשתמש על ההבדל בין ספר זמין, מבנה זמין ואינדקס מעודכן.
דף הבית · התחלת העבודה · שאלות נפוצות · פתרון תקלות
מדריך המשתמש נבדק מול גרסה 0.9.98.3+809; פרטי גרסאות ומועד הבדיקה בדף הבית.
התחלה מהירה
קריאה וחיפוש
אישי ותחזוקה
- כרטיסיות ושולחנות
- סימניות והערות
- ספרים אישיים
- מסדים אישיים
- גיבוי ושחזור
- הגדרות
- עדכונים
- תוספים
- כלים
- קישורים ישירים
תיעוד למפתחים
יסודות
נתונים
קריאה
חיפוש
מערכת
ממשק