XML Over HTTP Output Adapter Sample

< Previous

About This Sample

This sample demonstrates the usage of the TIBCO StreamBase® XML-Over-HTTP Output Adapter.

The XML Over HTTP embedded adapter posts tuples to an HTTP post handler. These can be created in a variety of languages and forms. A common form is a Java servlet, an example of which is provided in Example Servlet.

Example Servlet

The following is a simple example of a Java servlet you can use with this sample.

import java.io.BufferedReader;
import java.io.DataOutputStream;
import java.io.IOException;
import java.io.InputStreamReader;

import javax.servlet.ServletException;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import java.net.URLDecoder;

public class TestServlet extends HttpServlet {
    public TestServlet () {
        
    }
    
     protected void doGet(HttpServletRequest req,
             HttpServletResponse resp) throws ServletException, IOException {
         DataOutputStream daos = new DataOutputStream(resp.getOutputStream());
         
         daos.writeBytes("Hello, World");
         daos.flush();
         daos.close();       
     }

     protected void doPost(HttpServletRequest req,
             HttpServletResponse resp) throws ServletException, IOException {

         BufferedReader br = new BufferedReader(new InputStreamReader(req.getInputStream()));
         String line = null;
         while ((line = br.readLine()) != null) {
             line = URLDecoder.decode(line);
             System.out.println("readLine:" + line);
         }
     }
}

Importing This Sample into StreamBase Studio

In StreamBase Studio, import this sample with the following steps:

From the top-level menu, click File → Load StreamBase Sample.
Type xmlo to narrow the list of options.
Select XML-over-HTTP output adapter from the StreamBase Standard Adapters category.
Click OK.

StreamBase Studio creates a project for the sample.

Running XMLOverHTTPTest.sbapp in StreamBase Studio

In the Project Explorer, open the sample you just loaded.
Open the src/main/eventflow folder.
Open the package folder (most samples contain a single package folder. Open the top-level package folder if your sample contains more than one folder).
Open the named application file. In the EventFlow editor, click the XMLOverHTTP adapter icon to open its Properties view.
In the Adapter Settings tab, change URL to point to your HTTP POST handler. If a servlet is handling the HTTP POST request, then point to the fully qualified path of the deployed servlet (for example, http://host:port/path-to-servlet).
Make sure the application is the currently active tab in the EventFlow Editor. Click the Run button. This opens the SB Test/Debug perspective and starts the application.

If you see red marks, wait a moment for the project in Studio to load its features.

If red marks do not resolve themselves in a moment, select the project and right-click Maven → Update Project from the context menu.
Select the Manual Input tab.
Enter valid integers for a, b, and c, and press Send Data.
When done, press F9 or click the Stop Running Application button.
The POST handler for the specified URL should now have received one request for each tuple entered.

Sample Location

When you load the sample into StreamBase Studio, Studio copies the sample project's files to your Studio workspace, which is normally part of your home directory, with full access rights.

Important

Load this sample in StreamBase Studio, and thereafter use the Studio workspace copy of the sample to run and test it, even when running from the command prompt.

Using the workspace copy of the sample avoids permission problems. The default workspace location for this sample is:

studio-workspace/sample_adapter_embedded_xmloverhttp

See Default Installation Directories for the default location of studio-workspace on your system.