Softwaredevelopment project

Project for the course 'Softwaredevelopment' at OTH Regensburg.

If you want to use the api, please refer to the section API documentation. The notes of the owner of the repository are stored in the section Notes. In case you are here for testing the software, please refer to the section Testing. All information you need can be found there.

API documentation

• Find customer : GET /api/customers
• Get account value : GET /api/banking/accounts
• Transfer money : POST /api/banking/transfers/transfer
• Mandate money : POST /api/banking/transfers/mandate

Testing

NOTE: In case of starting the application, please take care of the notes in the section Commands for the deployment, especially for the command to export the environment variables!

Predefined employee accounts

Username	Password
max	admin
thomas	admin

NOTE: The registration of new employee accounts was not part of the defined requirements.

Attendant assignment

To assign an employee to a new customer, the employee with the fewest amount of customers is assigned to the new customer.

Subsequent modifications

EmployeeServiceIF

The EmployeeService and its interface was added after the requirements of milestone one.

BankingServiceExternalIF

Also, the interface for the associate project is a specific one, because of other internal needed methods in the BankingServiceIF. So the decision was made to have an extra interface for external needs. Please keep in mind, that the BankingServiceIF implements the methods of the BankingServiceExternalIF.

Notes

The prerequisite for this is the use of vpn access. The password is always the "NDS-Account-Id".

Commands for the deployment

The prerequisite for this is the use of vpn access. The password is always the "NDS-Account-Id".

1. Run Generate JAR in IDE
2. Copy JAR: scp C:\Workspace\sw_project\target\bank-1.0.0.jar sw_stefan_bauer@im-codd:
3. Connect to server: ssh sw_stefan_bauer@im-codd
4. In case of changed environment variables: export $(cat .env | xargs)
5. Check copied file: ls -l
6. Start as daemon process: java -jar bank-1.0.0.jar > server.log 2> error.log &
7. Show running processes: ps -f
8. Kill process:
   1. In case you know the PID: kill <PID>
   2. The mor common case:
      1. Get PID: netstat -an --tcp --program
      2. Then kill it.
9. Exit Secure Shell: exit

Useful commands

Generating jar file for associate projects \

NOTE: Has to be executed in the folder target/classes

jar cf banking_lib.jar de/othr/sw/bank/entity/TransferRequest.class de/othr/sw/bank/service/BankingServiceExternalIF.class de/othr/sw/bank/service/AccountNotFoundException.class de/othr/sw/bank/service/InvalidTransferException.class de/othr/sw/bank/service/NotEnoughMoneyException.class de/othr/sw/bank/utils/DateUtils.class de/othr/sw/bank/utils/StringUtils.class

Useful links

Spring: Guides
Spring: JPA
Baeldung: Spring Guides
Spring and Thymeleaf

HTTP Status Codes
HTTP Methods Explained