Creating a New Connector Virtual Service (REST)
A connector virtual service will:
Handle the provider's response.
Log the requests/responses.
CloudStreams provides a default connector virtual service for each metadata handler: the service WmCloudStreams.RestVS (for the REST handler) and the service WmCloudStreams.SoapVS (for the SOAP handler). The default services are located in the sample CloudStreams Governance project in the WmCloudStreams package. You cannot modify these default services.
Each default connector virtual service has a default policy (named
Logging Policy), which logs all request/response payloads to a database. You cannot modify the default policy. Alternatively, you can create additional connector virtual services with custom policies. If you create a connector virtual service with a custom policy, you can only include the actions in the "Monitoring" or "Additional" action categories; you cannot include the "WS-SecurityPolicy 1.2" actions. For example, you might want to create a custom policy that monitors run-time performance, customizes how the service invocations are logged, validates response messages against an XML schema, or optimizes server traffic. For complete details, see the chapter
Policies.
To create a new connector virtual service (REST)
1. Open Software AG Designer and display the CloudStreams Development perspective by clicking Window > Open Perspective > Other > CloudStreams Development.
2. In the CloudStreams Governance view, right-click the CloudStreams Governance project and click New > Connector Virtual Service (or expand the project, right-click the Connector Virtual Services folder and click New Connector Virtual Service).
3. In the New Connector Virtual Service wizard, complete the following fields and click Finish.
Option | Description |
Project | Click Browse and select a CloudStreams Governance project in which to create the connector virtual service. |
Name | Assign a name for the service. Unlike native services, the names of virtual services cannot contain spaces or special characters except _ (underscore) and - (hyphen). Consequently, if you adopt a convention that involves using the name of the service as part of the virtual service name, then the names of the services themselves must not contain characters that are invalid in virtual service names. Note: If you want to change the service name after it has been created, right-click the service name in the Connector Virtual Services folder and select Rename. |
Version | The version is always set to 1.0. |
Service Type | (Read-only field.) REST. |
Description | Optional. A description for the service. This description appears when a user displays a list of services in the user interface. |
The new connector virtual service is added to the CloudStreams Governance project, in the Connector Virtual Services folder.