XML Over HTTP Output Adapter 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.

Running This Sample in StreamBase Studio

  1. In the Package Explorer, double-click to open the XMLOverHTTPTest.sbapp application. Make sure the application is the currently active tab in the EventFlow Editor.

  2. In the EventFlow editor click the XMLOverHTTP adapter icon to open its Properties view.

  3. 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).

  4. 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.

  5. Select the Manual Input tab.

  6. Enter valid integers for a, b, and c, and press Send Data.

  7. When done, press F9 or click the Stop Running Application button.

  8. The POST handler for the specified URL should now have received one request for each tuple entered.

Running This Sample in Terminal Windows

This section describes how to run the sample in UNIX terminal windows or Windows command prompt windows. On Windows, be sure to use the StreamBase Command Prompt from the Start menu as described in the Test/Debug Guide, not the default command prompt.

  1. Open two terminal windows on UNIX, or two StreamBase Command Prompts on Windows. In each window, navigate to the directory where the sample is installed, or to your workspace copy of the sample, as described above.

  2. In window 1, type sbd XMLOverHTTPTest.sbapp.

  3. In window2 , type sbc enqueue InputStream < inputstream.dat.

  4. In window 2, run sbadmin shutdown to exit the server.

  5. The POST handler for the specified URL should now have received one request for each tuple entered.

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 menu, click FileLoad StreamBase Sample.

  • Select this sample from the Embedded Output Adapters list.

  • Click OK.

StreamBase Studio creates a single project containing the sample files.

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 the permission problems that can occur when trying to work with the initially installed location of the sample. The default workspace location for this sample is:

studio-workspace/sample_adapter_embedded_xmloverhttp

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

In the default TIBCO StreamBase installation, this sample's files are initially installed in:

streambase-install-dir/sample/adapter/embedded/xmloverhttp

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