Working with Business Processes and Enterprise Service Bus

The final goal of this assignment is to develop and deploy a travel agent business process that interacts with an air ticket reservation service, hotel reservaion service, and payment service for making travel arrangements. We intend to de-emphasize the specifics of the travel (city, dates, passengers etc.). Instead, the emphasis is on the concepts of ESB. Specifically, the travel agent process is started by receiving a travel request though a JMS gateway. The arrival of the request triggers the start of a business process. The process then interacts with the air reservation and the hotel reservation services. These services are internal to the bus. Further, the process should be capable of handling faults (failed reservations) returned by the air and hotel services. If only one of the reservation succeeds, then it must be rolled back via compensation (simply by sending appropriate messages to the air or hotel service for cancellation). Once both, air and hotel, reservations succeed the process moves on to accept payment. If the payment fails the entire process is aborted by sending cancellation to both air and hotel.

The picture below shows the overall ESB configuration for this assignment. You will develop the light blue boxes (some start code may be provided for some of the components). 

Notes / Updates:

Updates will be posted here.

• Test Cases are updated.

The environment

CSC_750/450_P2

Running the Project

1. You should be in the "Java EE" perspective in eclipse which has a server's tab on the bottom section of the UI. To start the ESB server that you created simply right click on the server and select start. The console tab should pop-up and show the output from the server. (screenshot (not exact))
2. After the server is started go to http://localhost:8080/jbpm-console/ and login as manager. There should not be any process in the process manager yet.
3. To add your process open the processdefinition.xml file in Eclipse. At the bottom of the editor click on the deployment tab. Click test connection to make sure everything is working and then click "Deploy Process Archive" to install the process on the server. (screenshot)
4. Go back to the console in step 2 and refresh. The process that you just uploaded should now appear in the UI.
5. To deploy your services to the ESB simply right click on your project name go to Run As --> Run on Server (screenshot)
6. Then select the server (the same one you started in step 1) from the list. (screenshot)
7. To test the ESB services and business process you need to execute the SendJMSMessage.java class by right clicking on the class name and going to Run As --> Java Application. (screenshot)
8. The program in the previous step sends a JMS message to the server, which triggers the business process. The process in turn calls various services on the ESB who print their results to the ESB console. If you see their output on the console tab then you know you have completed the steps properly.

Modifying the Project

ESB

You are responsible for adding 3 additional services to the ESB. The services can either be implemented in java or groovy but must have the following interfaces

• Payment Service
  • Name: PaymentService
  • Input Message Components
    1. makePayment (Integer) -- Payment amount
    2. paySucceed (boolean)
  • Output Message Components
    1. paySucceeded (boolean)

• AirService
  • Name: AirService
  • Input Message Components
    1. bookAirTickets (Integer) -- Number of air tickets to book
    2. cancelAirTickets (boolean)
    3. airBookingSucceed (boolean)
    4. airlines (String)
    5. customerName (String)
  • Output Message Components
    1. airTicketsBooked (boolean)
    2. airTicketsRefunded (boolean)
    3. airBookingRefNum (String) -- A reference number generated by Air Service
       
       
• Hotel Service
  • Name: HotelService
  • Input Message Components
    1. reserveHotel (Integer) -- Number of hotel rooms to book
    2. cancelHotelReservation (boolean)
    3. hotelReservationSucceed (boolean)
    4. customerName (String)
  • Output Message Components
    1. hotelReserved (boolean)
    2. hotelReservationRefunded (boolean)
    3. hotelReservationRef (String) -- A reference number generated by Hotel Service

• if bookAirTickets > 0 AND airBookingSucceed == true then print "$airlines AIR BOOKING SUCCEEDED FOR $bookAirTickets; CUSTOMER: $customerName; BOOKING REF # $airBookingRefNum;" AND set airTicketsBooked = true.
• if reserveHotel > 0 AND hotelReservationSucceed == true then print "HOTEL BOOKING SUCCEEDED FOR $reserveHotel; CUSTOMER: $customerName; RESERVATION REF # $hotelReservationRef" AND set hotelReserved = true.
• if bookAirTickets > 0 AND airBookingSucceed == false then print "$airlines AIR BOOKING FAILED FOR $bookAirTickets; BOOKING REF # $airBookingRefNum;" AND set airTicketsBooked = false.
• if reserveHotel > 0 AND hotelReservationSucceed == false then print "HOTEL BOOKING FAILED FOR $reserveHotel; RESERVATION REF # $hotelReservationRef" AND set hotelReserved = false.
• if cancelAirTickets == true then print "$airlines AIR BOOKING CANCELLED FOR $bookAirTickets; BOOKING REF # airBookingRefNum" AND set airTicketsRefunded = true.
• if cancelHotelReservation == true then print "HOTEL RESERVATION CANCELLED FOR $reserveHotel; RESERVATION REF # hotelReservationRef" AND set hotelReservationRefunded = true.
• if makePayment > 0 AND paySucceed == true then print "PAYMENT PROCESSED FOR AMOUNT $makePayment" AND set paySucceeded = true.
• if makePayment > 0 AND paySucceed == false then print "PAYMENT FAILED" AND set paySucceeded, airTicketsBooked = false, hotelReserved = false.

• bookAirTickets and cancelAirTickets will never be set to true at the same time.
• reserveHotel and cancelHotelReservation will never be set to true at the same time.
• the boolean values should be stored as case-sensitive strings, which are "true" and "false".
• if a boolean value isn't explicitly referenced in the above if/then statements then it should either be set to false or omitted from the input/output.

Business Process

The business process you have been provided only extracts the variables from the XML and prints them to the console. You are responsible for expanding that process to concurrently execute the air and hotel booking services (fork operation) and combining their results (join operation). After receiving their results you must cancel the air booking if the hotel failed and vice versa (decision operation). If both succeed, you proceed to payment. If payment fails, you cancel air and hotel.

The easiest way to modify the process is by using the visual editor within eclipse in conjunction with the jBPM console (http://localhost:8080/jbpm-console/). In addition to modifying the process you must rename the process to "[unity_id]_TravelProcess".

Deliverables