Service.h
1/*
2 * Copyright (C) 2012 by Marc Boris Duerner
3 *
4 * This library is free software; you can redistribute it and/or
5 * modify it under the terms of the GNU Lesser General Public
6 * License as published by the Free Software Foundation; either
7 * version 2.1 of the License, or (at your option) any later version.
8 *
9 * As a special exception, you may use this file as part of a free
10 * software library without restriction. Specifically, if other files
11 * instantiate templates or use macros or inline functions from this
12 * file, or you compile this file and link it with other files to
13 * produce an executable, this file does not by itself cause the
14 * resulting executable to be covered by the GNU General Public
15 * License. This exception does not however invalidate any other
16 * reasons why the executable file might be covered by the GNU Library
17 * General Public License.
18 *
19 * This library is distributed in the hope that it will be useful,
20 * but WITHOUT ANY WARRANTY; without even the implied warranty of
21 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
22 * Lesser General Public License for more details.
23 *
24 * You should have received a copy of the GNU Lesser General Public
25 * License along with this library; if not, write to the Free Software
26 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
27 */
28
29#ifndef Pt_Http_Service_h
30#define Pt_Http_Service_h
31
32#include <Pt/Http/Api.h>
33#include <Pt/Http/Responder.h>
34#include <Pt/Http/Stream.h>
35#include <Pt/Types.h>
36#include <Pt/Allocator.h>
37#include <Pt/NonCopyable.h>
38
39namespace Pt {
40
41namespace Http {
42
43class Request;
44class Reply;
45
82class PT_HTTP_API Service : private NonCopyable
83{
84 friend class ServerImpl;
85
86 public:
90
93 virtual ~Service();
94
98
102
103 protected:
106 virtual Responder* onGetResponder(const Request&) = 0;
107
110 virtual void onReleaseResponder(Responder*) = 0;
111
121 virtual void onUpgrade(Stream& stream,
122 const Request& request,
123 const Reply& reply);
124
125 private:
126 // service specific options need to be set in Service ctor so it can
127 // be used concurrently by server threads without locking
128 Pt::varint_t _r0;
129 Pt::varint_t _r1;
130 Pt::varint_t _r2;
131};
132
137template <typename R, typename Alloc = Allocator>
138class BasicService : public Service
139{
140 public:
144 { }
145
149 { }
150
151 protected:
153 {
154 void* r = _alloc.allocate( sizeof(R) );
155 return new(r) R(*this);
156 }
157
159 {
160 r->~Responder();
161 _alloc.deallocate( r, sizeof(R) );
162 }
163
164 private:
165 Alloc _alloc;
166};
167
168} // namespace Http
169
170} // namespace Pt
171
172#endif // Pt_Http_Service_h
virtual Responder * onGetResponder(const Request &)
Creates a responder to handle request received by a server.
Definition Service.h:152
~BasicService()
Destructor.
Definition Service.h:148
virtual void onReleaseResponder(Responder *r)
Destroys a responder created by a server.
Definition Service.h:158
BasicService()
Default Constructor.
Definition Service.h:143
HTTP reply message.
Definition Reply.h:64
HTTP request message.
Definition Request.h:65
Handles one HTTP request and writes the reply.
Definition Responder.h:109
virtual ~Responder()
Destructor.
void releaseResponder(Responder *)
Destroys a responder created by a server.
Service()
Default Constructor.
Responder * getResponder(const Request &)
Creates a responder to handle request received by a server.
virtual ~Service()
Destructor.
virtual void onReleaseResponder(Responder *)=0
Destroys a responder created by a server.
virtual Responder * onGetResponder(const Request &)=0
Creates a responder to handle request received by a server.
virtual void onUpgrade(Stream &stream, const Request &request, const Reply &reply)
Called when a 101 reply has upgraded a connection.
One HTTP stream on a connection.
Definition Stream.h:92
NonCopyable()
Default constructor.
Definition NonCopyable.h:63
HTTP clients and servers.
Core module.
Definition Allocator.h:33