מדריך לזרימת רשת האביב
1. סקירה כללית
Spring Web Flow מתבסס על Spring MVC ומאפשר הטמעת זרימות בתוך יישום אינטרנט. הוא משמש ליצירת רצפי שלבים המנחים משתמשים בתהליך או בהיגיון עסקי כלשהו.
במדריך מהיר זה נעבור דוגמה פשוטה לזרימת הפעלת משתמשים. בפני המשתמש מוצג דף ולחץ על ה- לְהַפְעִיל כדי להמשיך או על הלחצן לְבַטֵל כפתור לביטול ההפעלה.
לא שההנחה כאן היא שיש לנו כבר יישום רשת אביב MVC שהוגדר.
2. התקנה
נתחיל בהוספה של תלות זרימת האינטרנט באביב pom.xml:
org.springframework.webflow spring-webflow 2.5.0.RELEASE הגרסה האחרונה של Spring Web Flow נמצאת במאגר Central Maven.
3. יצירת זרימה
בואו ניצור זרימה פשוטה. כאמור קודם, זרימה היא רצף שלבים המנחים את המשתמש בתהליך. נכון לעכשיו, ניתן לעשות זאת רק באמצעות תצורה מבוססת XML.
כל שלב בזרימה נקרא a מדינה.
לדוגמא פשוטה זו נשתמש ב- נוף-מצב. א נוף-מצב הוא שלב בזרימה שמביא תצוגה תואמת. ה נוף-מצב מתייחס לדף באפליקציה (WEB-INF / תצוגה), עם הזהות של נוף-מצב בהיותו שם הדף אליו הוא מתייחס.
אנו נשתמש גם ב- מַעֲבָר אֵלֵמֶנט. א מַעֲבָר אלמנט משמש לטיפול באירועים המתרחשים בתוך מסוים מדינה.
עבור זרימת דוגמה זו, נקבע שלוש תצוגות-מצבים - ה הַפעָלָה, הַצלָחָה, ו כישלון.
התהליך לזרימה זו די פשוט. נקודת המוצא היא הַפעָלָה נוף. אם לְהַפְעִיל האירוע מופעל, עליו לעבור למערכת הַצלָחָה נוף. אם ה לְבַטֵל האירוע מופעל, עליו לעבור למערכת כישלון נוף. ה מַעֲבָר אלמנט מטפל באירוע לחיצת הכפתור שקורה ב- תצוגת מצב:
דף ההפעלה הראשוני, אליו מתייחס המזהה הַפעָלָה וממוקם ב WEB-INF / תצוגה / ההפעלה.jsp, הוא דף פשוט שיש בו שני כפתורים, לְהַפְעִיל ו לְבַטֵל. לחיצה על הכפתורים עם ההדק מעברים שלנו כדי לשלוח את המשתמש להצלחה נוף-מצב (WEB-INF / view / success.jsp) או הכישלון נוף-מצב (WEB-INF / view / failure.jsp):
לחץ להפעלת חשבון
אנו משתמשים ב- flowExecutionUrl כדי לגשת ל- URI יחסית להקשר לביצוע הזרימה הנוכחי נוף-מצב.
4. קביעת תצורה של הזרימה
לאחר מכן, נגדיר את Spring Web Flow בסביבת האינטרנט שלנו. אנו נעשה זאת על ידי הגדרת שירות רישום זרימה ובניית זרימה.
רישום הזרימה מאפשר לנו לציין את מיקום הזרימות שלנו וגם לציין שירות בניית זרימה אם משתמשים בו.
שירות Builder Flow עוזר לנו להתאים אישית שירותים והגדרות המשמשים לבניית זרימות.
אחד השירותים שאנחנו יכולים להתאים אישית הוא מבט-מפעל-יוצר. ה מבט-מפעל-יוצר מאפשר לנו להתאים אישית את ViewFactoryCreator משמש את זרימת האינטרנט של אביב. מכיוון שאנו משתמשים ב- MVC של Spring, אנו יכולים להגדיר את זרימת האינטרנט של Spring כך שתשתמש במפתן התצוגה בתצורות ה- MVC של Spring.
כך נקבע את התצורה של Spring Web Flow לדוגמא שלנו:
@Configuration מחלקה ציבורית WebFlowConfig מרחיב את AbstractFlowConfiguration {@Autowired פרטי WebMvcConfig webMvcConfig; @Bean FlowDefinitionRegistry ציבורי flowRegistry () {להחזיר getFlowDefinitionRegistryBuilder (flowBuilderServices ()) .addFlowLocation ("/ WEB-INF / flows / activation-flow.xml", "ActivationFlow"). } @Bean FlowExecutor ציבורי flowExecutor () {להחזיר getFlowExecutorBuilder (flowRegistry ()). Build (); } @Bean FlowBuilderServices ציבורי flowBuilderServices () {return getFlowBuilderServicesBuilder () .setViewFactoryCreator (mvcViewFactoryCreator ()) .setDevelopmentMode (true) .build (); } @Bean MvcViewFactoryCreator הציבור mvcViewFactoryCreator () {MvcViewFactoryCreator factoryCreator = MvcViewFactoryCreator חדש (); factoryCreator.setViewResolvers (Collections.singletonList (this.webMvcConfig.viewResolver ())); factoryCreator.setUseSpringBeanBinding (נכון); מפעל החזרה יוצר; }}אנו יכולים גם להשתמש ב- XML עבור תצורה זו:
5. ניווט בזרימות
כדי לנווט בין הזרמים, הפעל את אפליקציית האינטרנט ועבור אל // localhost: 8080 / {context-path} / activationFlow. כדי להפעיל את האפליקציה, פרוס אותה בשרת יישומים, כגון Tomcat או Jetty.
זה שולח אותנו לדף הראשוני של הזרימה, שהוא ה- הַפעָלָה הדף שצוין בתצורת הזרימה שלנו:
אתה יכול ללחוץ על ה- לְהַפְעִיל כפתור לעבור לדף ההצלחה:
או ה לְבַטֵל כפתור למעבר לדף הכישלון:
6. מסקנה
במאמר זה השתמשנו בדוגמה פשוטה כמדריך לשימוש ב- Spring Web Flow.
תוכל למצוא את קוד המקור השלם ואת כל קטעי הקוד עבור מאמר זה ב- GitHub.
