Raditss / toco-soap

Web-Based Development - A SOAP protocol web service (JAX-WS).

Soap Service for Toco

Introduction

Toco-soap is a soap service for Toco. It is a simple service that allows toco to communicate with other systems using soap. It is built using the Jax-ws library and build using maven. This service is built to complete IF3110 assignment.

Features Overview

• manage user gems
• manage user transaction
• voucher usage logging
• request logging

Installation

there are 2 ways that you can run this server

1. using maven

• make sure you have maven installed
• run mvn clean install
• run mvn exec:java
• the server will run on port 8080

2. using docker

• make sure you have docker installed
• run docker compose build
• run docker compose up
• the server will run on port 8080

Database Schema

Toco soap service uses 5 tables in the database, the tables are userGems, transaction, voucher_record, api, and logging . The schema for the tables are as follows

Endpoints

all of the endpoints are in /service

• addGems -> add gems to user
• getGems -> get user gems
• createTransaction -> create a transaction from a user
• getTransactions -> get all transactions from a user
• useVoucher -> use a voucher
• getSpecifiedVouchers -> get the specified voucher usage
• getAllVouchers -> get all voucher usage

for more information about the endpoints, you can check the wsdl file in /service?wsdl

Contributors

1. initial setup
   • 13521022
2. authentication
   • 13521021
   • 13521022
3. gems management
   • 13521022
4. transaction management
   • 13521022
5. voucher logging
   • 13521022
6. request logging
   • 13521022
7. integration
   • 13521019
   • 13521021
8. mail support
   • 13521022