IWebProtocolFactory Interface

This factory interface is implemented by the HTTP or UDP cob and registered in the current namespace upon COB loading. It provides facilities for the construction and destruction of server instances, and should eventually evolve to provide a memory management interface as well. To access it, lookup COB/http.cob in the system namespace and query.

The Main method starts a server that listens to the URL specified.

C type for interface pointer:

Extends IProgram

Implemented by HttpFactory

Methods: CreateServer CreateConnector

Methods

CreateServer
CreateConnector: Create an instance of SoapConnector that does HTTP. This is useful for HTTP/UDP clients.

IWebProtocolFactory.CreateServer Method

SCODE CreateServer( 
    /*in,this*/ PIWEBPROTOCOLFACTORY iThis,
    /*in*/ PINAMESPACE NameSpace,
    /*in*/ UINT Flags,
    /*out*/ PILISTENER* pServer)

Returns S_OK if the method is successful, otherwise an error code.

NameSpace: The namespace that will be presented as the HTTP root (/).
Flags: PARSE_URL_FLAGS
pServer: The newly created server is returned here.

C++

SCODE IWebProtocolFactory::CreateServer( 
    /*in*/ PINAMESPACE NameSpace,
    /*in*/ UINT Flags,
    /*out*/ PILISTENER* pServer)

IWebProtocolFactory.CreateConnector Method

Create an instance of SoapConnector that does HTTP. This is useful for HTTP/UDP clients.

SCODE CreateConnector( 
    /*in,this*/ PIWEBPROTOCOLFACTORY iThis,
    /*in*/ const _TCHAR * ServerURL,
    /*in*/ PARSE_URL_FLAGS ExtraFlags,
    /*out*/ PIHTTPCONNECTOR* pISoapConnector)

Returns S_OK if the method is successful, otherwise an error code.

ServerURL: The address of the host (e.g. IP address 123.45.67.89 or name eg. foo.bar.com) where to send the message.
ExtraFlags: Flags that are not uniquely determinable based on URL alone. Often PARSE_URL_FLAGS_SOAP with "http://"
pISoapConnector: The newly created connector is returned here.

C++

SCODE IWebProtocolFactory::CreateConnector( 
    /*in*/ const _TCHAR * ServerURL,
    /*in*/ PARSE_URL_FLAGS ExtraFlags,
    /*out*/ PIHTTPCONNECTOR* pISoapConnector)