Skip to content

The Portal for Loan Approval Business Process

License

Notifications You must be signed in to change notification settings

htr3n/loan-approval-portal

Repository files navigation

Loan Approval Portal

This project provides a Web interface portal for end-users to work with the loan approval process of the fictitious WestBank. Besides, for testing purpose it also includes the Web services that provide necessary business functions used by the loan approval process.

Technologies

Quick Start

Executing using command line

The portal can be deployed as an application (*.war) in a Web application server such as Apache Tomcat, Eclipse Jetty, JBoss Wildfly AS, etc. Nevertheless, we can directly run it at the command line.

Go to the project folder and proceed with the following command.

mvn jetty:run

Then open a Web browser to http://localhost:9999/portal for the portal main page.

Some other pages for development/testing

Packaging a deployable Web application (.war)
mvn -DskipTests clean package

Technical Details

Web Layer

As switching to XML-less configurations with Servlet 3.0+, the main web application configuration is PortalWebApplicationInitializer instead of the traditional WEB-INF/web.xml.

  • PortalWebApplicationInitializer first loads the root context and registers two configurations PersistenceConfiguration (for data access) and ServiceConfiguration (for publishing Web/SOAP services)
  • Then it registers a child context with AnnotationConfigWebApplicationContext for the Spring DispatcherServlet
    • AnnotationConfigWebApplicationContext registers the MVC configuration in WebMvcConfiguration
    • DispatcherServlet will serve all *.html and /portal/*
  • PortalWebApplicationInitializer will also load another servlet CXFServlet to serve the Web/SOAP services at /services/*

MVC Configuration

The configuration for Spring MVC is in WebMvcConfiguration:

  • It implements WebMvcConfigurer and is annotated with @EnableWebMvc (equivalent to <mvc:annotation-driven /> in Spring XML)

  • It enables default servlet handling

  • It adds ResourceHandlers to serve /resources/

  • It configures view resolvers to serve JSP/JSTL at /WEB-INF/view/ and for .jsp

  • It configures MessageSource to serve multiple languages at i18n/messages-XXX.properties

Some Relevant Resources
  • Other resources like CSSs, images, and JavasSripts are in the folders src/main/webapp/[css | images | js ].

  • src/main/resources/i18n/messages.properties for the information displayed to the customers such as success and error notifications.

  • src/main/resources/logback.xml for Logback

Data Access Layer

Web Services

This project also includes some Web services using JAX-WS / Apache CXF to provide the business functions needed by the loan approval process. These Web service interfaces (*.wsdl) are in the folder WEB-INF/wsdl.

  • Business services -- functions provided by the underlying IT infrastructure.
    |
    +-- BankInformation.wsdl
    +-- BankPrivilege.wsdl
    +-- CreditWorthiness.wsdl
    +-- LoanApprovalClosing.wsdl
    +-- LoanFile.wsdl
    +-- LoanContract.wsdl
    +-- LoanContractSigning.wsdl
    +-- LoanRisk.wsdl
    +-- LoanSettlement.wsdl
    +-- TaskDispatch.wsdl
    
  • Call back services -- called back by the loan approval process when it wants to notifies the customers or finishes
 |
 +-- CallbackLoanContract.wsdl
 +-- CallbackLoanApproval.wsdl
Java Code Generation from WSDLs

Apache CXF's cxf-codegen-plugin Maven plugin is used to generate Java code from the aforementioned services (i.e. contract-first service development). The generated Java sources are under the base package com.westbank.ws.

The m2eclipse plugin that supports Maven in Eclipse will invoke the Apache CXF cxf-codegen-plugin whenever you import this project into Eclipse,the existing generated stuffs will be unnecessarily overwritten. Thus, the plugin is currently disabled. Whenever any WSDL is modified, please enable this plugin and execute the command mvn generate-sources to re-generate the Java code.

Web Services Implementation and Publishing

The actual implementation of the business logic of each Web service is in the corresponding Java class named com.westbank.ws.impl.XXXImpl in which 'XXX' is the name of that Web service. In order to alter these services, have a look into the folder WEB-INF/wsdl. After modifying the WSDLs, just run mvn clean generate-sources to re-generate Java code.

The configuration for publishing Web services using Apache CXF and Spring is provided in ServiceConfiguration loaded by the root application context. It in turn loads the service bean definitions in ServiceBeans.

As the Web application is running, open a Web browser at http://localhost:9999/portal/services to see a list of running Web services.

Sidenotes

For further testing and demonstration purposes, some special values are hard-coded in the Web services logics:

  • If the borrower's last name is "Power", the privilege is ok, i.e., the number of incidents is 0, the number of banks is 0 (see com.westbank.ws.impl.BankPrivilegeImpl)
  • The monthly payment is calculated according to a provided formula (see com.westbank.ws.impl.BankInformationImpl)
  • If choosing the EstateType as HOUSE, then the return risk evaluation is HIGH (see com.westbank.ws.impl.LoanRiskImpl)
  • If the loan amount < 1 million, then the role will be CLERK, otherwise, SUPERVISOR (see com.westbank.ws.impl.TaskDispatchImpl)
  • If the borrower's first name is "Alice", the CreditWorthinessOK is true, otherwise, false (see com.westbank.ws.impl.CreditWorthinessImpl)