Configuring REST Bindings

Specify various details after adding the REST binding type to the composite service or reference using TIBCO Business Studio.

1. Import an existing project or create a new project in TIBCO ActiveMatrix Business Studio. See the TIBCO ActiveMatrix documentation set.
2. Add a REST binding from the canvas view or the properties view.

   Option	Description
   Canvas view	Right-click the service or reference and select Add > REST Binding from the popup menu.
   Properties view	Click the service or reference on the canvas. In the Properties view, click the Bindings tab. Click the Add Binding... button.

3. Select the service or reference and display its properties.
4. For a promoted service, specify the following details in the right pane of the Properties View.

   Option	Description
   Name	Name of the REST binding.
   HTTP Connector	HTTP Connector and Context Root together define the URL that is used at runtime. You define and name the HTTP Connector at design time. At runtime, you need to create a resource of type HTTP Connector and assign it the name you used at design time.
   Context Root	HTTP Connector and Context Root together define the URL that is used at runtime.
   Media Type	Select Standard JSON, Badgerfish JSON, or XML from the pull-down menu to specify the media type for the request or the response message.
   Exclude namespaces from response	Excludes namespaces from the response message. This option is displayed only when Media Type is set to Badgerfish JSON.

5. For a promoted reference, specify the following details in the right pane of the Properties View.

   Option	Description
   Name	Name of the REST binding.
   Description	Short description of the REST binding.
   Media Type	(read-only field). The media type can be set from the REST resource configuration file.
   Rest resource configuration file	Location of the REST resource configuration file. A resource configuration file is not set by default. To create a resource configuration file, click the -not set- link or click the picker icon and then click Create New. When you click on Finish in this wizard, a new resource configuration file (.rrc) is created with default media type (JSON) and resource base URI. Note: The .rrc file must be placed in the Service Descriptor folder of the SOA project.
   HTTP Client	Select the HTTP client.
   Enable pass through mode	Enables the pass through mode. In the pass through mode, a fixed WSDL is configured on the REST binding. In the pass through mode, ActiveMatrix Binding Type for REST behaves like the HTTP Binding Type.