loan approval portal

Portail d'approbation des prêts

Ce projet fournit un portail d'interface Web aux utilisateurs finaux pour travailler avec le processus d'approbation des prêts de la fictive Westbank. En outre, à des fins de test, il comprend également les services Web qui fournissent les fonctions commerciales nécessaires utilisées par le processus d'approbation du prêt.

Technologies

• SOAP / Web Services (WSDL / XML / SOAP / HTTP) implémenté à l'aide de JAX-WS / Apache CXF en haut du cadre du printemps
• MVC de printemps
• JPA / Hibernate au-dessus d'un SGBDR avec HikaricP pour la mise en commun de la connexion JDBC.
• H2, Apache Derby, Hypersql, MySQL, PostgreSQL ont été inclus et testés, mais tout SGBDR peut également être utilisé avec un effort de configuration supplémentaire
• Logback et façade de journalisation simple pour Java (SLF4J) pour une journalisation efficace
• Apache Maven pour la gestion des dépendances, la construction, l'emballage et le déploiement

Démarrage rapide

Exécution à l'aide de la ligne de commande

Le portail peut être déployé sous forme d'application ( *.war ) dans un serveur d'applications Web tels qu'Apache Tomcat, Eclipse Jetty, JBoss Wildfly As, etc. Néanmoins, nous pouvons dire directement l'exécuter sur la ligne de commande.

Accédez au dossier du projet et continuez avec la commande suivante.

mvn jetty:run

Ouvrez ensuite un navigateur Web à http: // localhost: 9999 / portail pour la page principale du portail.

Quelques autres pages pour le développement / tests

• Vérification de la base de données sous-jacente (voir com.westbank.web.DevController ): http: // localhost: 9999 / portal / dev.html

• Vérification de la liste des services Web en cours d'exécution: http: // localhost: 9999 / portail / services

• Pour vous connecter en tant que personnel (directeur, superviseur, greffier ou courtier), accédez à la page: http: // localhost: 9999 / portail / personnel / login.html

• Remarque: l'identification et le mot de passe du personnel sont temporairement répertoriés dans la page http: // localhost: 9999 / portail / dev.html

Emballage d'une application Web déployable (.WAR)

mvn -DskipTests clean package

Détails techniques

Couche Web

En passant à des configurations sans XML avec Servlet 3.0+, la configuration principale de l'application Web est PortalWebApplicationInitializer au lieu du WEB-INF/web.xml traditionnel.

• PortalWebApplicationInitializer charge d'abord le contexte racine et enregistre deux configurations PersistenceConfiguration (pour l'accès aux données) et ServiceConfiguration (pour la publication des services Web / SOAP)
• Ensuite, il enregistre un contexte enfant avec AnnotationConfigWebApplicationContext pour le Spring DispatcherServlet
  • AnnotationConfigWebApplicationContext enregistre la configuration MVC dans WebMvcConfiguration
  • DispatcherServlet servira tous *.html et /portal/*
• PortalWebApplicationInitializer également un autre servlet CXFServlet pour servir les services Web / SOAP à /services/*

Configuration MVC

La configuration de Spring MVC est dans WebMvcConfiguration :

• Il implémente WebMvcConfigurer et est annoté avec @EnableWebMvc (équivalent à <mvc:annotation-driven /> in printemps xml)

• Il permet la manipulation des servlets par défaut

• Il ajoute des Gees de ressources pour servir /resources/

• Il configure des résolveurs Affichage pour servir JSP / JSTL à /WEB-INF/view/ et pour .jsp

• Il configure MessageSource pour servir plusieurs langues sur i18n/messages-XXX.properties

Quelques ressources pertinentes

• D'autres ressources comme CSSS, Images et Javassripts sont dans les dossiers src/main/webapp/[css | images | js ] .

• src/main/resources/i18n/messages.properties pour les informations affichées aux clients tels que les notifications de succès et d'erreur.

• src/main/resources/logback.xml pour la connexion

Couche d'accès aux données

• La manipulation et la persistance des données sont effectuées à l'aide de Spring JPA / Hibernate configurée via PersistenceConfiguration .

  • Annoté avec @Configuration @EnableJpaRepositories , @EnableTransactionManagement , @ComponentScan
  • Définit javax.sql.DataSource avec l'implémentation sous-jacente HikariDataSource de Hikaricp
  • Définit entityManagerFactory avec LocalContainerEntityManagerFactoryBean
  • Définit JPA TransactionManager / Java Transaction API (JTA) avec JpaTransactionManager
  • Définit un DataSourceInitializer pour configurer certaines données à l'aide du script load-user-and-role.sql

• Les entités de domaine sont annotées avec des conventions JPA dans com.westbank.domain

• Les référentiels de données sont dans com.westbank.repository pour manipuler les données / objets sous-jacents à l'aide EntityManager

• Les services de données (y compris une logique métier) sont dans com.westbank.service travaillant au-dessus des référentiels

• Le RDBM actuellement utilisé est en mémoire H2 pour une empreinte de mémoire minimale. Néanmoins, tout autre SGBDR peut également être utilisé. Afin d'utiliser à la place d'autres SGBDR, veuillez noter les points suivants:

  • Créer un nom de base de données WESTBANKDB
  • Créez un utilisateur westbank avec secret de mot de passe et affectez cet utilisateur à la base de données ou utilisez vos valeurs préférées et mettez à jour hibernate.properties en conséquence
  • Ajouter les dépendances Maven nécessaires pour les nouveaux SGBDR dans pom.xml .
  • Émettez la commande mvn jetty:run pour vérifier si l'application Web fonctionne.
  • En cas de problèmes, réglez la verbosité dans logback.xml pour le débogage.

Services Web

Ce projet comprend également certains services Web utilisant JAX-WS / Apache CXF pour fournir les fonctions commerciales nécessaires au processus d'approbation du prêt. Ces interfaces de service Web ( *.wsdl ) sont dans le dossier WEB-INF/wsdl .

• Services commerciaux - fonctions fournies par l'infrastructure informatique sous-jacente.

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

• Services de rappel - rappelé par le processus d'approbation des prêts lorsqu'il souhaite avertir les clients ou les termes

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

Génération de code Java à partir de WSDLS

Le plugin Maven cxf-codegen-plugin d'Apache CXF est utilisé pour générer du code Java à partir des services susmentionnés (c'est-à -dire le développement de services contractuels ). Les sources Java générées sont sous le package de base com.westbank.ws .

Le plugin M2ECLIPSE qui prend en charge Maven dans Eclipse invoquera l'Apache CXF cxf-codegen-plugin chaque fois que vous importez ce projet dans Eclipse, les éléments générés existants seront inutilement écrasés. Ainsi, le plugin est actuellement désactivé. Chaque fois qu'un WSDL est modifié, veuillez activer ce plugin et exécuter la commande mvn generate-sources pour générer le code Java.

Implémentation et publication des services Web

L'implémentation réelle de la logique métier de chaque service Web se trouve dans la classe Java correspondante nommée com.westbank.ws.impl.XXXImpl dans laquelle « xxx » est le nom de ce service Web. Afin de modifier ces services, consultez le dossier WEB-INF/wsdl . Après avoir modifié les WSDL, il suffit d'exécuter mvn clean generate-sources pour générer le code Java.

La configuration de la publication des services Web à l'aide d'Apache CXF et Spring est fournie dans ServiceConfiguration chargée par le contexte de l'application racine. Il charge à son tour les définitions de bean de service dans ServiceBeans .

Pendant que l'application Web s'exécute, ouvrez un navigateur Web sur http: // localhost: 9999 / portail / services pour voir une liste des services Web en cours d'exécution.

Sidénotes

À des fins de test et de démonstration supplémentaires, certaines valeurs spéciales sont codées en dur dans les logiques des services Web:

• Si le nom de famille de l'emprunteur est "Power", le privilège est OK, c'est-à-dire que le nombre d'incidents est de 0, le nombre de banques est 0 (voir com.westbank.ws.impl.BankPrivilegeImpl )
• Le paiement mensuel est calculé selon une formule fournie (voir com.westbank.ws.impl.BankInformationImpl )
• Si vous choisissez l'estateType comme maison, alors l'évaluation des risques de retour est élevée (voir com.westbank.ws.impl.LoanRiskImpl )
• Si le montant du prêt <1 million, le rôle sera le greffier, autrement, le superviseur (voir com.westbank.ws.impl.TaskDispatchImpl )
• Si le prénom de l'emprunteur est "Alice", le CreditWortanssok est true , sinon, false (voir com.westbank.ws.impl.CreditWorthinessImpl )