ofxHTTP
A collection of tools for HTTP.
ofx::HTTP::PostRoute Class Reference

A route for handing HTTP POST requests. More...

#include <PostRoute.h>

Inheritance diagram for ofx::HTTP::PostRoute:
ofx::HTTP::BaseRoute_< PostRouteSettings > ofx::HTTP::AbstractRoute ofx::HTTP::AbstractHTTPRequestHandler ofx::HTTP::AbstractHTTPRequestHandlerFactory ofx::HTTP::AbstractServerEventRequestHandler

Public Types

typedef PostRouteSettings Settings
 A typedef for the PostRouteSettings.
 

Public Member Functions

 PostRoute (const Settings &settings=Settings())
 
Poco::Net::HTTPRequestHandler * createRequestHandler (const Poco::Net::HTTPServerRequest &request) override
 Creates a new HTTPRequestHandler for the given request. More...
 
PostRouteEventsgetEvents ()
 
template<class ListenerClass >
void registerPostEvents (ListenerClass *listener, int priority=OF_EVENT_ORDER_AFTER_APP)
 Register event listeners for this route. More...
 
template<class ListenerClass >
void unregisterPostEvents (ListenerClass *listener, int priority=OF_EVENT_ORDER_AFTER_APP)
 Unregister event listeners for this route. More...
 
- Public Member Functions inherited from ofx::HTTP::BaseRoute_< PostRouteSettings >
 BaseRoute_ (const PostRouteSettings &settings=PostRouteSettings())
 Create a BaseRoute. More...
 
virtual ~BaseRoute_ ()
 Destroy a BaseRoute.
 
virtual void setup (const PostRouteSettings &settings)
 Setup the route with settings. More...
 
virtual std::string routePathPattern () const override
 Get the route's regex path pattern. More...
 
virtual bool canHandleRequest (const Poco::Net::HTTPServerRequest &request, bool isSecurePort) const override
 Determine if this route can handle the given request. More...
 
void handleRequest (Poco::Net::HTTPServerRequest &request, Poco::Net::HTTPServerResponse &response) override
 
virtual void handleRequest (ServerEventArgs &evt) override
 Handle the ServerEventArgs. More...
 
virtual void stop () override
 Stop any pending activity and close this route. More...
 
const PostRouteSettingssettings () const
 
AbstractServergetServer () override
 
void setServer (AbstractServer *server) override
 Set the server that owns this route. More...
 
- Public Member Functions inherited from ofx::HTTP::AbstractRoute
virtual ~AbstractRoute ()
 Destroy the AbstractRoute instance.
 
- Public Member Functions inherited from ofx::HTTP::AbstractHTTPRequestHandler
virtual ~AbstractHTTPRequestHandler ()
 Destroy the AbstractHTTPRequestHandler.
 
- Public Member Functions inherited from ofx::HTTP::AbstractServerEventRequestHandler
virtual ~AbstractServerEventRequestHandler ()
 Destroy the AbstractServerEventRequestHandler.
 
- Public Member Functions inherited from ofx::HTTP::AbstractHTTPRequestHandlerFactory
virtual ~AbstractHTTPRequestHandlerFactory ()
 Destroy the AbstractHTTPRequestHandlerFactory.
 

Public Attributes

PostRouteEvents events
 

Additional Inherited Members

- Protected Attributes inherited from ofx::HTTP::BaseRoute_< PostRouteSettings >
PostRouteSettings _settings
 The settings.
 
AbstractServer_server
 A pointer to the server.
 

Detailed Description

A route for handing HTTP POST requests.

Member Function Documentation

◆ createRequestHandler()

Poco::Net::HTTPRequestHandler * ofx::HTTP::PostRoute::createRequestHandler ( const Poco::Net::HTTPServerRequest &  request)
overridevirtual

Creates a new HTTPRequestHandler for the given request.

Before this is called, it is expected that the calling server has confirmed that this route is capable of handling the request by calling canHandleRequest().

Parameters
requestThe HTTPServerRequest to be passed to the handler.
Returns
An HTTPRequestHandler that will handle the request.
Note
Redeclared here for documentation puposes.

Reimplemented from ofx::HTTP::BaseRoute_< PostRouteSettings >.

◆ registerPostEvents()

template<class ListenerClass >
void ofx::HTTP::PostRoute::registerPostEvents ( ListenerClass *  listener,
int  priority = OF_EVENT_ORDER_AFTER_APP 
)

Register event listeners for this route.

The listener class must implement the following callbacks:

onHTTPPostEvent(...), onHTTPFormEvent(...), onHTTPUploadEvent(...)

Template Parameters
ListenerClassThe lister class to register.
Parameters
listenerA pointer to the listener class.
priorityThe listener priority.

◆ unregisterPostEvents()

template<class ListenerClass >
void ofx::HTTP::PostRoute::unregisterPostEvents ( ListenerClass *  listener,
int  priority = OF_EVENT_ORDER_AFTER_APP 
)

Unregister event listeners for this route.

Template Parameters
ListenerClassThe lister class to uregister.
Parameters
listenerA pointer to the listener class.
priorityThe listener priority.

The documentation for this class was generated from the following files: