loan approval portal

Portal Persetujuan Pinjaman

Proyek ini menyediakan portal antarmuka web untuk pengguna akhir untuk bekerja dengan proses persetujuan pinjaman dari Westbank fiktif. Selain itu, untuk tujuan pengujian itu juga mencakup layanan web yang menyediakan fungsi bisnis yang diperlukan yang digunakan oleh proses persetujuan pinjaman.

Teknologi

• Layanan SOAP/WEB (WSDL/XML/SOAP/HTTP) diimplementasikan menggunakan JAX-WS/Apache CXF di atas Kerangka Musim Semi
• Spring MVC
• JPA / Hibernate di atas RDBMS dengan HikariCp untuk pengumpulan koneksi JDBC.
• H2, Apache Derby, HypersQL, MySQL, PostgreSQL telah dimasukkan dan diuji tetapi RDBM apa pun juga dapat digunakan dengan upaya konfigurasi tambahan
• Logback dan fasad logging sederhana untuk java (slf4j) untuk logging yang efisien
• Apache Maven untuk manajemen ketergantungan, bangunan, pengemasan, dan penyebaran

Awal yang cepat

Mengeksekusi menggunakan baris perintah

Portal dapat digunakan sebagai aplikasi ( *.war ) di server aplikasi web seperti Apache Tomcat, Eclipse Jetty, JBoss Wildfly As, dll. Namun demikian, kita dapat langsung menjalankannya di baris perintah.

Buka folder proyek dan lanjutkan dengan perintah berikut.

mvn jetty:run

Kemudian buka browser web ke http: // localhost: 9999/portal untuk halaman utama portal.

Beberapa halaman lain untuk pengembangan/pengujian

• Memverifikasi database yang mendasarinya (lihat com.westbank.web.DevController ): http: // localhost: 9999/portal/dev.html

• Memeriksa daftar Layanan Web yang Menjalankan: http: // localhost: 9999/portal/layanan

• Untuk login sebagai staf (manajer, pengawas, juru tulis, atau broker), buka halaman: http: // localhost: 9999/portal/staf/login.html

• Catatan: ID dan Kata Sandi untuk Staf untuk sementara tercantum di halaman http: // localhost: 9999/portal/dev.html

Mengemas aplikasi web yang dapat digunakan (.WAR)

mvn -DskipTests clean package

Detail teknis

Lapisan web

Saat beralih ke konfigurasi XML-Less dengan Servlet 3.0+, konfigurasi aplikasi web utama adalah PortalWebApplicationInitializer alih-alih WEB-INF/web.xml tradisional.

• PortalWebApplicationInitializer Pertama memuat konteks root dan mendaftarkan dua konfigurasi konfigurasi PersistenceConfiguration (untuk akses data) dan ServiceConfiguration (untuk menerbitkan layanan web/sabun)
• Kemudian mendaftarkan konteks anak dengan AnnotationConfigWebApplicationContext untuk Spring DispatcherServlet
  • AnnotationConfigWebApplicationContext Mendaftarkan Konfigurasi MVC di WebMvcConfiguration
  • DispatcherServlet akan melayani semua *.html dan /portal/*
• PortalWebApplicationInitializer juga akan memuat servlet CXFServlet lain untuk melayani layanan web/sabun di /services/*

Konfigurasi MVC

Konfigurasi untuk Spring MVC ada di WebMvcConfiguration :

• Ini mengimplementasikan WebMvcConfigurer dan dijelaskan dengan @EnableWebMvc (setara dengan <mvc:annotation-driven /> di musim semi xml)

• Ini memungkinkan penanganan servlet default

• Itu menambahkan sumber daya untuk melayani /resources/

• Ini mengkonfigurasi view resolvers untuk melayani JSP/JSTL AT /WEB-INF/view/ dan untuk .jsp

• Ini mengonfigurasi MessageSource untuk melayani beberapa bahasa di i18n/messages-XXX.properties

Beberapa sumber daya yang relevan

• Sumber daya lain seperti CSS, gambar, dan javassripts ada di folder src/main/webapp/[css | images | js ] .

• src/main/resources/i18n/messages.properties untuk informasi yang ditampilkan kepada pelanggan seperti pemberitahuan keberhasilan dan kesalahan.

• src/main/resources/logback.xml untuk logback

Lapisan akses data

• Manipulasi data dan persistensi dilakukan dengan menggunakan JPA / Hibernate pegas yang dikonfigurasi melalui PersistenceConfiguration .

  • Dianotasi dengan @Configuration @EnableJpaRepositories , @EnableTransactionManagement , @ComponentScan
  • Mendefinisikan javax.sql.DataSource dengan implementasi yang mendasar HikariDataSource of HikariCp
  • Mendefinisikan entityManagerFactory dengan LocalContainerEntityManagerFactoryBean
  • Mendefinisikan JPA TransactionManager / Java Transaction API (JTA) dengan JpaTransactionManager
  • Mendefinisikan DataSourceInitializer untuk mengatur beberapa data menggunakan skrip load-user-and-role.sql

• Entitas domain dijelaskan dengan konvensi JPA di com.westbank.domain

• Repositori data ada di com.westbank.repository untuk memanipulasi data/objek yang mendasari menggunakan EntityManager

• Layanan Data (termasuk beberapa logika bisnis) berada di com.westbank.service yang bekerja di atas repositori

• RDBMS yang saat ini digunakan adalah H2 dalam memori untuk jejak memori minimal. Namun demikian, RDBM lain dapat digunakan juga. Untuk menggunakan RDBMS lain sebagai gantinya, harap perhatikan poin -poin berikut:

  • Buat nama database WESTBANKDB
  • Buat pengguna westbank dengan secret kata sandi dan tetapkan pengguna itu ke database atau gunakan nilai pilihan Anda dan perbarui hibernate.properties sesuai dengan itu
  • Tambahkan dependensi Maven yang diperlukan untuk RDBMS baru di pom.xml .
  • Keluarkan perintah mvn jetty:run untuk memeriksa apakah aplikasi web berfungsi.
  • Dalam hal masalah, selarahkan verbositas di logback.xml untuk debugging.

Layanan Web

Proyek ini juga mencakup beberapa layanan web menggunakan JAX-WS / Apache CXF untuk menyediakan fungsi bisnis yang dibutuhkan oleh proses persetujuan pinjaman. Antarmuka layanan web ini ( *.wsdl ) ada di folder WEB-INF/wsdl .

• Layanan Bisnis - Fungsi yang disediakan oleh infrastruktur TI yang mendasarinya.

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

• Layanan Panggilan Kembali - Dipanggil Kembali oleh Proses Persetujuan Pinjaman Saat ingin memberi tahu pelanggan atau selesai

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

Pembuatan kode Java dari WSDLS

cxf-codegen-plugin CXF digunakan untuk menghasilkan kode Java dari layanan yang disebutkan di atas (yaitu pengembangan layanan pertama kontrak ). Sumber Java yang dihasilkan berada di bawah paket dasar com.westbank.ws .

Plugin M2Eclipse yang mendukung Maven di Eclipse akan memohon Apache CXF cxf-codegen-plugin setiap kali Anda mengimpor proyek ini ke dalam gerhana, barang-barang yang dihasilkan yang ada akan ditimpa secara tidak perlu. Dengan demikian, plugin saat ini dinonaktifkan. Setiap kali WSDL dimodifikasi, harap aktifkan plugin ini dan jalankan perintah mvn generate-sources untuk menghasilkan kembali kode Java.

Implementasi dan Penerbitan Layanan Web

Implementasi aktual dari logika bisnis dari setiap layanan web berada di kelas Java yang sesuai bernama com.westbank.ws.impl.XXXImpl di mana ' xxx ' adalah nama layanan web itu. Untuk mengubah layanan ini, lihatlah folder WEB-INF/wsdl . Setelah memodifikasi WSDLS, cukup jalankan mvn clean generate-sources untuk menghasilkan kembali kode Java.

Konfigurasi untuk menerbitkan layanan web menggunakan Apache CXF dan Spring disediakan dalam ServiceConfiguration yang dimuat oleh konteks aplikasi root. Pada gilirannya memuat definisi kacang layanan di ServiceBeans .

Saat aplikasi web berjalan, buka browser web di http: // localhost: 9999/portal/layanan untuk melihat daftar layanan web yang berjalan.

Sidenote

Untuk tujuan pengujian dan demonstrasi lebih lanjut, beberapa nilai khusus dikodekan dalam logika layanan web:

• Jika nama belakang peminjam adalah "kekuatan", hak istimewanya ok, yaitu, jumlah insiden adalah 0, jumlah bank adalah 0 (lihat com.westbank.ws.impl.BankPrivilegeImpl )
• Pembayaran bulanan dihitung sesuai dengan formula yang disediakan (lihat com.westbank.ws.impl.BankInformationImpl )
• Jika memilih estateType sebagai rumah, maka evaluasi risiko pengembalian tinggi (lihat com.westbank.ws.impl.LoanRiskImpl )
• Jika jumlah pinjaman <1 juta, maka perannya akan menjadi pegawai, jika tidak, supervisor (lihat com.westbank.ws.impl.TaskDispatchImpl )
• Jika nama depan peminjam adalah "Alice", CreditWorthinessOK true , jika tidak, false (lihat com.westbank.ws.impl.CreditWorthinessImpl )