SAP-archive / yaas_java_jersey_wishlist

Due to the retirement of YaaS, this repository is archived and will no longer be maintained. --- This is an example implementation of the YaaS "Wishlist" service based on Java. It uses the RAML definition generated by the SDK without modifications. It shows how to implement a basic service and how to integrate with other services on YaaS.
Apache License 2.0
16 stars 19 forks source link
open-source

Important Notice

We have decided to stop the maintenance of this public GitHub repository.

yaas_java_jersey_wishlist

This is an example implementation of the YaaS Wishlist service based on Java. It shows how to implement a basic service and how to integrate with other services on YaaS.

License

This project is licensed under the Apache Software License, v. 2 except as noted otherwise in the LICENSE file.

API Console

You can open the API Console in a separate window by using the following link:

API Overview

This service provides REST endpoints for interacting with several YaaS services.

Document Service

The endpoint /wishlists enables you to:

The endpoint /wishlists/{wishlistId}/wishlistItems enables you to:

See also WishlistService.java.

Email Service

An email is sent to the wishlist owner when a wishlist is created. For more details, see the sendMail method in WishlistService.java.

Media Service

The endpoint /wishlists/{wishlistId}/media enables you to:

See also WishlistMediaService.java

Customer Service

When a wishlist is being created, the implementation checks if its owner exists as a customer. You can find the details at the beginning of the POST method in WishlistService.java.

Purpose and Benefits

Showcase how a service can be written using Java. Demonstrate the integration with other services in YaaS, including authentication. Topics covered:

Dependencies

Build, Test, and Run the Service

See the Setup Guide for instructions on how to configure this service.

  1. Use mvn clean install to build the service and run the tests.

  2. Run the service locally by calling mvn jetty:run, and navigate to the local API Console.

FAQ / Troubleshooting

If you get failed tests while building with mvn clean install, such as response code expected:201 but was:500, then it might mean that the service can't connect to other YaaS services. This could be related to missing proxy settings.

Hint: In that case, you might want to try it out with:

mvn clean install -Dhttp.proxyPort=<proxyPort> -Dhttp.proxyHost=<proxyHost> -Dhttps.proxyPort=<proxyPort> -Dhttps.proxyHost=<proxyHost>