loan approval portal

พอร์ทัลอนุมัติสินเชื่อ

โครงการนี้มีพอร์ทัลเว็บอินเตอร์เฟสสำหรับผู้ใช้ปลายทางในการทำงานกับกระบวนการอนุมัติสินเชื่อของ Westbank สมมติ นอกจากนี้เพื่อวัตถุประสงค์ในการทดสอบยังมีบริการเว็บที่ให้ฟังก์ชั่นทางธุรกิจที่จำเป็นที่ใช้โดยกระบวนการอนุมัติสินเชื่อ

เทคโนโลยี

• SOAP/Web Services (WSDL/XML/SOAP/HTTP) ใช้งานโดยใช้ JAX-WS/APACHE CXF ที่ด้านบนของ Framework Spring Framework
• ฤดูใบไม้ผลิ MVC
• JPA / Hibernate อยู่ด้านบนของ RDBMS พร้อม Hikaricp สำหรับการเชื่อมต่อการเชื่อมต่อ JDBC
• H2, Apache Derby, HyperSQL, MySQL, PostgreSQL ได้รับการรวมและทดสอบแล้ว แต่ RDBMs ใด ๆ ก็สามารถใช้กับความพยายามในการกำหนดค่าเพิ่มเติม
• เข้าสู่ระบบและเข้าสู่ระบบการบันทึกอย่างง่ายสำหรับ Java (SLF4J) สำหรับการบันทึกที่มีประสิทธิภาพ
• Apache Maven สำหรับการจัดการการพึ่งพาอาคารบรรจุภัณฑ์และการปรับใช้

เริ่มต้นอย่างรวดเร็ว

การดำเนินการโดยใช้บรรทัดคำสั่ง

พอร์ทัลสามารถปรับใช้เป็นแอปพลิเคชัน ( *.war ) ในเว็บแอปพลิเคชันเซิร์ฟเวอร์เช่น Apache Tomcat, Eclipse Jetty, JBoss Wildfly เป็น ฯลฯ อย่างไรก็ตามเราสามารถเรียกใช้โดยตรงที่บรรทัดคำสั่ง

ไปที่โฟลเดอร์โครงการและดำเนินการตามคำสั่งต่อไปนี้

mvn jetty:run

จากนั้นเปิดเว็บเบราว์เซอร์ไปที่ http: // localhost: 9999/พอร์ทัลสำหรับหน้าหลักพอร์ทัล

หน้าอื่น ๆ สำหรับการพัฒนา/ทดสอบ

• การตรวจสอบฐานข้อมูลพื้นฐาน (ดู com.westbank.web.DevController ): http: // localhost: 9999/พอร์ทัล/dev.html

• การตรวจสอบรายการบริการเว็บที่รัน: http: // localhost: 9999/พอร์ทัล/บริการ

• หากต้องการเข้าสู่ระบบในฐานะพนักงาน (ผู้จัดการ, หัวหน้างานเสมียนหรือนายหน้า) ไปที่หน้า: http: // localhost: 9999/พอร์ทัล/พนักงาน/login.html

• หมายเหตุ: ID และรหัสผ่านสำหรับพนักงานมีการระบุไว้ชั่วคราวในหน้า http: // localhost: 9999/พอร์ทัล/dev.html

บรรจุเว็บแอปพลิเคชันที่ปรับใช้ได้ (.war)

mvn -DskipTests clean package

รายละเอียดทางเทคนิค

ชั้นเว็บ

เนื่องจากการเปลี่ยนไปใช้การกำหนดค่า XML-Less ด้วย Servlet 3.0+ การกำหนดค่าเว็บแอปพลิเคชันหลักคือ PortalWebApplicationInitializer แทนที่จะเป็น WEB-INF/web.xml แบบดั้งเดิม

• PortalWebApplicationInitializer โหลดบริบทรูทและลงทะเบียนสองการกำหนดค่า PersistenceConfiguration (สำหรับการเข้าถึงข้อมูล) และ ServiceConfiguration (สำหรับการเผยแพร่บริการเว็บ/SOAP)
• จากนั้นจะลงทะเบียนบริบทของเด็กด้วย AnnotationConfigWebApplicationContext สำหรับ Spring DispatcherServlet
  • AnnotationConfigWebApplicationContext ลงทะเบียนการกำหนดค่า MVC ใน WebMvcConfiguration
  • DispatcherServlet จะให้บริการทั้งหมด *.html และ /portal/*
• PortalWebApplicationInitializer จะโหลด Servlet CXFServlet อื่นเพื่อให้บริการบริการเว็บ/SOAP AT /services/*

การกำหนดค่า MVC

การกำหนดค่าสำหรับ Spring MVC อยู่ใน WebMvcConfiguration :

• มันใช้ WebMvcConfigurer และมีคำอธิบายประกอบด้วย @EnableWebMvc (เทียบเท่ากับ <mvc:annotation-driven /> ในฤดูใบไม้ผลิ XML)

• เปิดใช้งานการจัดการ servlet เริ่มต้น

• มันเพิ่ม ResourceHandlers ให้บริการ /resources/

• มันกำหนดค่า View Resolver เพื่อให้บริการ JSP/JSTL AT /WEB-INF/view/ และสำหรับ .jsp

• มันกำหนดค่า MessageSource เพื่อให้บริการหลายภาษาที่ i18n/messages-XXX.properties

ทรัพยากรที่เกี่ยวข้องบางอย่าง

• ทรัพยากรอื่น ๆ เช่น CSSS รูปภาพและ Javassripts อยู่ในโฟลเดอร์ src/main/webapp/[css | images | js ] .

• src/main/resources/i18n/messages.properties สำหรับข้อมูลที่แสดงต่อลูกค้าเช่นความสำเร็จและการแจ้งเตือนข้อผิดพลาด

• src/main/resources/logback.xml สำหรับ logback

เลเยอร์การเข้าถึงข้อมูล

• การจัดการข้อมูลและการคงอยู่จะทำโดยใช้ Spring JPA / Hibernate ที่กำหนดค่าผ่านการ PersistenceConfiguration

  • คำอธิบายประกอบด้วย @Configuration @EnableJpaRepositories , @EnableTransactionManagement , @ComponentScan
  • กำหนด javax.sql.DataSource ด้วยการดำเนินการพื้นฐาน HikariDataSource ของ Hikaricp
  • กำหนด entityManagerFactory ด้วย LocalContainerEntityManagerFactoryBean
  • กำหนด JPA TransactionManager / Java Transaction API (JTA) กับ JpaTransactionManager
  • กำหนด DataSourceInitializer เพื่อตั้งค่าข้อมูลบางส่วนโดยใช้สคริปต์ load-user-and-role.sql

• หน่วยงานโดเมนมีคำอธิบายประกอบกับการประชุม JPA ใน com.westbank.domain

• ข้อมูลที่เก็บข้อมูลอยู่ใน com.westbank.repository สำหรับการจัดการข้อมูล/วัตถุพื้นฐานโดยใช้ EntityManager

• บริการข้อมูล (รวมถึงตรรกะทางธุรกิจบางอย่าง) อยู่ใน com.westbank.service ทำงานอยู่ด้านบนของที่เก็บ

• RDBMS ที่ใช้ในปัจจุบันคือ H2 ในหน่วยความจำสำหรับรอยเท้าหน่วยความจำขั้นต่ำ อย่างไรก็ตามสามารถใช้ RDBM อื่น ๆ ได้เช่นกัน ในการใช้ RDBMS อื่น ๆ แทนโปรดทราบจุดต่อไปนี้:

  • สร้างชื่อฐานข้อมูล WESTBANKDB
  • สร้างผู้ใช้ westbank ด้วยรหัส secret และกำหนดผู้ใช้นั้นให้กับฐานข้อมูลหรือใช้ค่าที่คุณต้องการและอัปเดต hibernate.properties ตามลำดับ
  • เพิ่มการพึ่งพา maven ที่จำเป็นสำหรับ RDBMS ใหม่ใน pom.xml
  • ออกคำสั่ง mvn jetty:run เพื่อตรวจสอบว่าเว็บแอปพลิเคชันทำงานได้หรือไม่
  • ในกรณีที่มีปัญหาให้ปรับคำสั่งใน logback.xml สำหรับการดีบัก

บริการเว็บ

โครงการนี้ยังรวมถึงบริการเว็บบางแห่งโดยใช้ JAX-WS / Apache CXF เพื่อให้ฟังก์ชั่นทางธุรกิจที่จำเป็นโดยกระบวนการอนุมัติสินเชื่อ อินเทอร์เฟซบริการเว็บเหล่านี้ ( *.wsdl ) อยู่ในโฟลเดอร์ WEB-INF/wsdl

• บริการธุรกิจ - ฟังก์ชั่นที่จัดทำโดยโครงสร้างพื้นฐานด้านไอทีพื้นฐาน

   |
  +-- BankInformation.wsdl
  +-- BankPrivilege.wsdl
  +-- CreditWorthiness.wsdl
  +-- LoanApprovalClosing.wsdl
  +-- LoanFile.wsdl
  +-- LoanContract.wsdl
  +-- LoanContractSigning.wsdl
  +-- LoanRisk.wsdl
  +-- LoanSettlement.wsdl
  +-- TaskDispatch.wsdl
  

• โทรกลับบริการ - เรียกกลับโดยกระบวนการอนุมัติเงินกู้เมื่อต้องการแจ้งให้ลูกค้าทราบหรือเสร็จสิ้น

 |
 +-- CallbackLoanContract.wsdl
 +-- CallbackLoanApproval.wsdl

การสร้างรหัส Java จาก WSDLS

ปลั๊กอิน Maven cxf-codegen-plugin ของ Apache CXF ใช้เพื่อสร้างรหัส Java จากบริการดังกล่าว (เช่น การพัฒนาบริการฉบับแรก ) แหล่ง Java ที่สร้างขึ้นอยู่ภายใต้แพ็คเกจพื้นฐาน com.westbank.ws

ปลั๊กอิน M2EClipse ที่รองรับ Maven ใน Eclipse จะเรียกใช้ Apache CXF cxf-codegen-plugin เมื่อใดก็ตามที่คุณนำเข้าโครงการนี้ไปยัง Eclipse สิ่งที่สร้างขึ้นจะถูกเขียนทับโดยไม่จำเป็น ดังนั้นปลั๊กอินจึงถูกปิดใช้งานในขณะนี้ เมื่อใดก็ตามที่ WSDL ได้รับการแก้ไขโปรดเปิดใช้งานปลั๊กอินนี้และเรียกใช้งานคำสั่ง mvn generate-sources เพื่อสร้างรหัส Java อีกครั้ง

การใช้งานบริการเว็บและการเผยแพร่

การใช้งานจริงของตรรกะทางธุรกิจของแต่ละบริการเว็บอยู่ในคลาส Java ที่สอดคล้องกันชื่อ com.westbank.ws.impl.XXXImpl ซึ่ง ' xxx ' เป็นชื่อของบริการเว็บนั้น ในการเปลี่ยนบริการเหล่านี้ให้ดูที่โฟลเดอร์ WEB-INF/wsdl หลังจากแก้ไข WSDLs เพียงเรียกใช้ mvn clean generate-sources เพื่อสร้างรหัส Java อีกครั้ง

การกำหนดค่าสำหรับการเผยแพร่บริการเว็บโดยใช้ Apache CXF และ Spring มีให้ใน ServiceConfiguration ที่โหลดโดยบริบทของแอปพลิเคชันรูท มันโหลดคำจำกัดความของบริการถั่วใน ServiceBeans

เมื่อเว็บแอปพลิเคชันกำลังทำงานให้เปิดเว็บเบราว์เซอร์ที่ http: // localhost: 9999/พอร์ทัล/บริการเพื่อดูรายการบริการเว็บที่กำลังทำงาน

sidenotes

เพื่อวัตถุประสงค์ในการทดสอบและการสาธิตเพิ่มเติมค่าพิเศษบางอย่างเป็นรหัสยากใน Logics บริการเว็บ:

• หากนามสกุลของผู้กู้คือ "อำนาจ" สิทธิพิเศษก็โอเคเช่นจำนวนเหตุการณ์คือ 0 จำนวนธนาคารคือ 0 (ดู com.westbank.ws.impl.BankPrivilegeImpl )
• การชำระเงินรายเดือนคำนวณตามสูตรที่ให้ไว้ (ดู com.westbank.ws.impl.BankInformationImpl )
• หากเลือก Estatetype เป็นบ้านการประเมินความเสี่ยงผลตอบแทนจะสูง (ดู com.westbank.ws.impl.LoanRiskImpl )
• หากจำนวนเงินกู้ <1 ล้านบทบาทจะเป็นเสมียนมิฉะนั้นหัวหน้างาน (ดู com.westbank.ws.impl.TaskDispatchImpl )
• หากชื่อแรกของผู้กู้คือ "อลิซ" Creditworthinessok เป็น true มิฉะนั้น false (ดู com.westbank.ws.impl.CreditWorthinessImpl )