Tivoli Directory Integrator, Version 7.1.1

Old HTTP Server Connector

Note:
This Connector is kept for legacy purposes only. If you are creating a new Connector, please use HTTP Server Connector instead. It is also deprecated, and will be removed in a future version of Tivoli® Directory Integrator.

The Old HTTP Server Connector listens for incoming HTTP connections and returns the get parameters as an entry. If a Parser is specified then the Connectors process post requests and parse the contents using the specified Parser. get requests do not use the Parser. If a post request is received and no Parser is specified, the contents of the post data are returned as an attribute (postdata) in the returned entry.

The Connector parses URL requests and populates an entry in the following manner:

http://host/path?p1=v1&p2=v2

entry.path = "/path" 
entry.p1="v1" 
entry.p2="v2"
http://host?p1=v1&p2=v2

entry.path="/" 
entry.p1="v1"
entry.p2="v2"

If a POST request is used then it is expected that the requestor is sending data on the connection as well. Depending on the value for the Parser parameter the Connector performs the following actions:

Parser present
Instantiates the Parser with the HTTP input stream. Connector delegates getNext to the Parser's getEntry and returns whatever the Parser returns.
Parser not present
Puts contents of post data in an attribute called postdata.
entry.postdata = "postdata"

The session with the HTTP client is closed when the Connector receives a getNext request from the AssemblyLine and there is no more data to retrieve. For example, if the Parser has returned a null value, or on the second call to getNext no Parser is present. If you call getNext (for example, iterate) after having received a null from the Connector.

Configuration

The Connector needs the following parameters:

TCP Port
The TCP port to listen to (the default port is 80).
Detailed Log
If this parameter is checked, more detailed log messages are generated.
Parser
The name of a Parser to handle the contents of post requests.

See also

URL Connector,
HTTP Server Connector.
[ Top of Page | Previous Page | Next Page | Contents | Terms of use | Feedback ]
(C) Copyright IBM Corporation, 2003, 2012. All Rights Reserved.
IBM Tivoli Directory Integrator 7.1.1