איך להפסיק לעשות את אותו הדבר

האם אתה אוהב לחזור על פעולות שגרתיות שוב ושוב? אז אני לא. אבל בכל פעם בלקוח SQL כשעבדתי עם האחסון של Rostelecom, הייתי צריך לרשום את כל החיבורים בין הטבלאות באופן ידני. וזאת למרות שב-90% מהמקרים השדות ותנאי ההצטרפות לשולחנות עולים בקנה אחד בין בקשה לבקשה! נראה שלכל לקוח SQL יש פונקציות של השלמה אוטומטית, אבל עבור אחסון זה לא תמיד עובד: לעתים נדירות הם כוללים אילוץ ייחודי ומפתח זר על מנת לשפר את הביצועים, ובלעדיו התוכנית לא תדע כיצד ישויות קשורות לכל אחד מהם. אחר ומה זה יכול לעשות בשבילך להציע.

לאחר שעברתי הכחשה, כעס, מיקוח, דיכאון והתקרבות לקבלה, החלטתי – למה לא לנסות ליישם מילוי אוטומטי עם בלאק ג'ק בעצמי ולעשות זאת בצורה הנכונה? אני משתמש בלקוח dbeaver, שנכתב ב-java, יש לו גרסת קהילת קוד פתוח. תוכנית פשוטה הבשילה:

1. מצא מחלקות בקוד המקור שאחראיות להשלמה אוטומטית
2. הפנה אותם מחדש לעבודה עם מטא נתונים חיצוניים ומשם מידע על הצטרפות
3. ??
4. רווח

הבנתי את הנקודה הראשונה די מהר - מצאתי בקשה במעקב אחר באגים להתאים את המילוי האוטומטי ובקטע הקשור לְבַצֵעַ גילה את המחלקה SQLCompletionAnalyzer. הסתכלתי על הקוד וזה מה שאני צריך. כל מה שנותר הוא לשכתב אותו כך שהכל יעבוד. חיכיתי לערב פנוי והתחלתי לחשוב על היישום. החלטתי לכתוב חוקי קישור לטבלה (מטא נתונים) ב-json. לא היה לי ניסיון מעשי בעבודה עם הפורמט הזה והמשימה הנוכחית נתפסה כהזדמנות לתקן את המחדל הזה.

כדי לעבוד עם json החלטתי להשתמש בספרייה json-פשוט מגוגל. כאן התחילו ההפתעות. כפי שהתברר, dbeaver, כאפליקציה אמיתית, נכתבה על פלטפורמת Eclipse באמצעות מסגרת OSGi. עבור מפתחים מנוסים, הדבר הזה עושה את זה נוח לנהל תלות, אבל בשבילי זה היה יותר כמו קסם אפל, שברור שלא הייתי מוכן אליו: כרגיל, אני מייבא את המחלקות שאני צריך מהספרייה json-simple בכותרת של המחלקה הערוכה, ציין אותה ב-pom.xml, ולאחר מכן הפרויקט מסרב באופן מוחלט להרכיב כרגיל וקרוס עם שגיאות.

בסופו של דבר, הצלחתי לתקן את שגיאות הבנייה: רשמתי את הספרייה לא ב-pom.xml, אלא ב-manifes.mf, כפי שנדרש על-ידי OSGI, תוך ציון זה כ-import-package. לא הפתרון הכי יפה, אבל זה עובד. ואז הופיעה ההפתעה הבאה. אם אתה מפתח ב-Intellij Idea, אתה לא יכול פשוט ללכת ולהתחיל לנפות באגים בפרויקט שלך על בסיס פלטפורמת eclipse: מפתח חסר ניסיון אמור לסבול לא פחות מאשר אנליסט ללא השלמת שאילתה. מפתחי הבונה עצמם נחלצו להצלה, ציינו בוויקי את כל הריקודים עם טמבורין שצריך לעשות. הדבר הכי מעצבן הוא שגם אחרי כל הסקוואטים האלה, הפרוייקט לא רצה להיות מושק ב-debug עם ספריית json מחוברת דרך חבילת import (למרות העובדה שהיא עדיין הורכבה בהצלחה למוצר המוגמר).

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

דוגמה למטא נתונים

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<tableRelations>
    <tableRelation>
        <leftTable>dim_account</leftTable>
        <rightTable>dim_partner</rightTable>
        <joinColumnPair leftColumn="partner_key" rightColumn="partner_key"/>
        <joinColumnPair leftColumn="src_id" rightColumn="src_id"/>
    </tableRelation>
    <tableRelation>
        <leftTable>dim_account</leftTable>
        <rightTable>dim_branch</rightTable>
        <joinColumnPair leftColumn="src_id" rightColumn="src_id"/>
        <joinColumnPair leftColumn="branch_key" rightColumn="branch_key"/>
    </tableRelation>
</tableRelations>

כתוצאה מכך אני ביצעו שינויים למחלקות SQLUtils ו- SQLCompletionAnalyzer. הרעיון הוא זה: אם התוכנה לא הצליחה למצוא הצעות השלמה אוטומטית מתאימות באמצעות ההיגיון הבסיסי, אז היא בודקת קיומם של הצטרפות אפשריות באמצעות קובץ xml חיצוני. הקובץ עצמו מאחסן זוגות של טבלאות המציינים את השדות שבאמצעותם יש לקשר את הטבלאות הללו. הגבלות על תאריכי התוקף הטכני של הרשומות eff_dttm ו-exp_dttm ודגל המחיקה הלוגית deleted_ind מוגדרות כברירת מחדל.

כאשר בוצעו שינויים בקוד, עלתה השאלה - מי ימלא את הקובץ במטא נתונים? יש הרבה ישויות במאגר, זה יקר לרשום את כל החיבורים בעצמך. כתוצאה מכך, החלטתי להטיל את המשימה הזו על חברי האנליטיקאים. פרסמתי את קובץ המטא נתונים ב-svn, משם מתבצעת התשלום לספרייה המקומית עם התוכנית. העיקרון הוא זה: האם הופיעה ישות חדשה במאגר? אנליסט אחד מכניס הצטרפות אפשריות לקובץ, מבצע שינויים, השאר בודקים לעצמם ונהנים מההשלמה האוטומטית העובדת: קהילה, צבירת ידע וכל זה. העביר סדנה לשימוש בתוכנית לעמיתים, כתב מאמר ב-Confluence - כעת לחברה יש עוד כלי נוח אחד.

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

מקור: www.habr.com