loan approval portal

대출 승인 포털

이 프로젝트는 최종 사용자가 가상의 웨스트 뱅크의 대출 승인 프로세스와 함께 작업 할 수있는 웹 인터페이스 포털을 제공합니다. 또한 테스트 목적으로 대출 승인 프로세스에서 사용하는 필요한 비즈니스 기능을 제공하는 웹 서비스도 포함됩니다.

기술

• SOAP/웹 서비스 (WSDL/XML/SOAP/HTTP) SPRING FRAMEWORK 위에서 JAX-WS/APACHE CXF를 사용하여 구현
• 봄 MVC
• JDBC 연결 풀링을위한 hikaricp가있는 RDBMS 위에 JPA / Hibernate.
• H2, Apache Derby, Hypersql, MySQL, PostgreSQL이 포함되어 테스트되었지만 모든 RDBMS는 추가 구성 노력과 함께 사용할 수 있습니다.
• 효율적인 로깅을위한 Java (SLF4J)의 로그백 및 간단한 로깅 패케이트
• 의존성 관리, 건물, 포장 및 배포를위한 Apache Maven

빠른 시작

명령 줄을 사용하여 실행

포털은 Apache Tomcat, Eclipse Jetty, Jboss Wildfly와 같은 웹 애플리케이션 서버에서 응용 프로그램 ( *.war )으로 배포 될 수 있습니다. 그럼에도 불구하고, 우리는 명령 줄에서 직접 실행할 수 있습니다.

프로젝트 폴더로 이동하여 다음 명령을 진행하십시오.

mvn jetty:run

그런 다음 포털 메인 페이지의 http : // localhost : 9999/포털로 웹 브라우저를 열십시오.

개발/테스트를위한 다른 페이지

• 기본 데이터베이스 확인 ( com.westbank.web.DevController 참조) : http : // localhost : 9999/portal/dev.html

• 실행중인 웹 서비스 목록 확인 : http : // localhost : 9999/Portal/Services

• 직원으로 로그인하려면 (관리자, 감독관, 서기 또는 중개인) 페이지로 이동하려면 http : // localhost : 9999/Portal/Staff/Login.html

• 참고 : 직원의 ID 및 비밀번호는 일시적으로 페이지 http : // localhost : 9999/portal/dev.html에 나열되어 있습니다.

배포 가능한 웹 애플리케이션 포장 (.war)

mvn -DskipTests clean package

기술적 인 세부 사항

웹 계층

Servlet 3.0+를 사용하여 XML-Less 구성으로 전환함에 따라 기본 웹 응용 프로그램 구성은 기존 WEB-INF/web.xml 대신 PortalWebApplicationInitializer 입니다.

• PortalWebApplicationInitializer 먼저 루트 컨텍스트를로드하고 두 개의 구성 ServiceConfiguration PersistenceConfiguration 웹/비누 서비스 게시)
• 그런 다음 Spring DispatcherServlet 대한 AnnotationConfigWebApplicationContext 와 함께 하위 컨텍스트를 등록합니다.
  • AnnotationConfigWebApplicationContext WebMvcConfiguration 에서 MVC 구성을 등록합니다
  • DispatcherServlet 모두 *.html 및 /portal/* 제공합니다.
• PortalWebApplicationInitializer 또한 다른 서블릿 CXFServlet 로드하여 /services/* 웹/비누 서비스를 제공합니다.

MVC 구성

Spring MVC의 구성은 WebMvcConfiguration 에 있습니다.

• WebMvcConfigurer 구현하고 @EnableWebMvc (스프링 XML에서 <mvc:annotation-driven /> 에 해당)로 주석이 달성됩니다.

• 기본 서블릿 처리를 가능하게합니다

• Serving /resources/

• view resolver가 /WEB-INF/view/ 및 .jsp 용 JSP/JSTL을 제공하도록 구성됩니다.

• i18n/messages-XXX.properties 에서 여러 언어를 제공하도록 MessageSource 구성합니다

일부 관련 리소스

• CSS, 이미지 및 JavassRipts와 같은 다른 리소스는 폴더 src/main/webapp/[css | images | js ] .

• src/main/resources/i18n/messages.properties 성공 및 오류 알림과 같은 고객에게 표시된 정보에 대한 기능.

• 로그백 용 src/main/resources/logback.xml

데이터 액세스 계층

• 데이터 조작 및 지속성은 PersistenceConfiguration 통해 구성된 스프링 JPA / Hibernate를 사용하여 수행됩니다.

  • @Configuration @EnableJpaRepositories , @EnableTransactionManagement , @ComponentScan 으로 주석이 달린다
  • Hikaricp의 기본 구현 HikariDataSource 사용하여 javax.sql.DataSource 정의합니다
  • LocalContainerEntityManagerFactoryBean 으로 entityManagerFactory 정의합니다
  • JPA TransactionManager / Java Transaction API (JTA)가 JpaTransactionManager 정의합니다.
  • 스크립트 load-user-and-role.sql 사용하여 일부 데이터를 설정하려면 DataSourceInitializer 정의합니다.

• 도메인 엔티티는 com.westbank.domain 의 JPA 컨벤션과 주석이 달성됩니다

• 데이터 리포지토리는 com.westbank.repository 에 있습니다. EntityManager 사용하여 기본 데이터/객체를 조작하기위한 재구성.

• 데이터 서비스 (일부 비즈니스 논리 포함)는 com.westbank.service 에 있습니다.

• 현재 사용되는 RDBMS는 최소한의 메모리 풋 프린트를 위해 메모리 H2입니다. 그럼에도 불구하고 다른 RDBM도 사용할 수 있습니다. 대신 다른 RDBMS를 사용하려면 다음 사항에 주목하십시오.

  • 데이터베이스 이름 WESTBANKDB 만듭니다
  • 비밀리에 secret 에있는 사용자 westbank 만들고 해당 사용자를 데이터베이스에 할당하거나 선호하는 값을 사용하고 hibernate.properties 업데이트하십시오.
  • pom.xml 의 새로운 RDBM에 필요한 Maven 의존성을 추가하십시오.
  • mvn jetty:run 웹 애플리케이션이 작동하는지 확인하십시오.
  • 문제의 경우 디버깅을 위해 logback.xml 의 Verbosity를 조정하십시오.

웹 서비스

이 프로젝트에는 Jax-WS / Apache CXF를 사용하는 일부 웹 서비스가 포함되어있어 대출 승인 프로세스에 필요한 비즈니스 기능을 제공합니다. 이 웹 서비스 인터페이스 ( *.wsdl )는 WEB-INF/wsdl 폴더에 있습니다.

• 비즈니스 서비스 - 기본 IT 인프라에서 제공하는 기능.

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

• Call Back Services- 고객에게 알리거나 마무리를 원할 때 대출 승인 절차에 의해 다시 호출됩니다.

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

WSDLS의 Java 코드 생성

Apache CXF의 cxf-codegen-plugin Maven 플러그인은 위에서 언급 한 서비스 (즉, 계약 우선 서비스 개발 )에서 Java 코드를 생성하는 데 사용됩니다. 생성 된 Java 소스는 ​​기본 패키지 com.westbank.ws 아래에 있습니다.

Eclipse에서 Maven을 지원하는 M2Eclipse 플러그인은이 프로젝트를 Eclipse로 가져올 때마다 Apache CXF cxf-codegen-plugin 호출합니다. 따라서 플러그인은 현재 비활성화되어 있습니다. WSDL이 수정 될 때 마다이 플러그인을 활성화하고 mvn generate-sources 명령을 실행하여 Java 코드를 다시 생성하도록하십시오.

웹 서비스 구현 및 게시

각 웹 서비스의 비즈니스 로직의 실제 구현은 com.westbank.ws.impl.XXXImpl 이라는 해당 Java 클래스에 있습니다. ' xxx '는 해당 웹 서비스의 이름입니다. 이러한 서비스를 변경하려면 WEB-INF/wsdl 폴더를 살펴보십시오. WSDL을 수정 한 후 mvn clean generate-sources 실행하여 Java 코드를 다시 생성하십시오.

Apache CXF 및 Spring을 사용하여 웹 서비스 게시를위한 구성은 루트 애플리케이션 컨텍스트에 의해로드 된 ServiceConfiguration 에 제공됩니다. ServiceBeans 에 서비스 Bean 정의를로드합니다.

웹 애플리케이션이 실행되면 http : // localhost : 9999/Portal/Services에서 웹 브라우저를 열면 실행중인 웹 서비스 목록을 확인하십시오.

사이드노테스

추가 테스트 및 데모 목적으로 웹 서비스 논리에서 일부 특별 값이 하드 코딩됩니다.

• 차용자의 성이 "파워"인 경우, 특권은 괜찮습니다. 즉, 사건 수는 0이고 은행 수는 0입니다 ( com.westbank.ws.impl.BankPrivilegeImpl 참조).
• 월별 지불은 제공된 공식에 따라 계산됩니다 ( com.westbank.ws.impl.BankInformationImpl 참조)
• EstateType을 집으로 선택하면 반품 위험 평가가 높습니다 ( com.westbank.ws.impl.LoanRiskImpl 참조)
• 대출 금액이 1 백만이면 역할은 서기, 그렇지 않으면 감독자가됩니다 ( com.westbank.ws.impl.TaskDispatchImpl 참조).
• 차용자의 이름이 "Alice"인 경우 CreditWorthinessok com.westbank.ws.impl.CreditWorthinessImpl true 입니다 false