Tutorial 04 02 Add Traditional Bridge Project
This tutorial assumes that you have already followed the Building a Service From Scratch tutorial, and have an existing and working Harmony Core service that does not include a Traditional Bridge environment.
Adding Traditional Bridge to an existing solution typically involves adding a new traditional Synergy project to the solution, as well as adding code into several of the existing .NET projects in the solution, specifically the Services and Services.Controllers projects, and maybe also the Services.Models project.
On the traditional Synergy side, a Traditional Bridge environment is usually implemented within a simple console application (DBR) that we refer to as the Traditional Bridge host program. But you might also choose to organize and deploy some of the code via additional ELB projects, it really depends on how complex your environment is.
The Traditional Bridge host program will:
- Listen for request messages from Harmony Core, sent via
standard in(TT:). - Decode requests to determine which routine is to be called, and to determine values for any inbound parameters.
- Execute subroutines and functions as directed, passing all appropriate parameters.
- Based on the return values and.or the value of any out parameters, construct an appropriate response message.
- Send the response back to Harmony Core via
standard out(TT:).
The format of the request and response messages is defined by a standard protocol called JSON RPC 2.0, and this mechanism is described in more detail in the Dynamic Call Protocol topic.
Next topic: Add Traditional Bridge Library Code