/usr/include/assa-3.5/assa/ServiceHandler.h is in libassa3.5-5-dev 3.5.0-1.1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 | // -*- c++ -*-
//------------------------------------------------------------------------------
// ServiceHandler.h
//------------------------------------------------------------------------------
// Copyright (c) 1999 by Vladislav Grinchenko
//
// This library is free software; you can redistribute it and/or
// modify it under the terms of the GNU Library General Public
// License as published by the Free Software Foundation; either
// version 2 of the License, or (at your option) any later version.
//
//------------------------------------------------------------------------------
// Created: 06/07/99
//------------------------------------------------------------------------------
#ifndef SERVICE_HANDLER_H
#define SERVICE_HANDLER_H
#include "assa/Assure.h"
#include "assa/EventHandler.h"
namespace ASSA {
/** @file ServiceHandler.h
This abstract class provides generic interface for processing services.
Application must customize this class to perform a particular type
of services.
*/
template <class PEER_STREAM>
class ServiceHandler : public EventHandler
{
public:
/** Default constructor.
In case of server-side, ServiceHandler is created by
Acceptor, when new connection is detected.
*/
ServiceHandler ()
: m_peerStream (new PEER_STREAM)
{
trace("ServiceHandler::ServiceHandler");
}
/** Constructor that takes PEER_STREAM as a parameter.
In case of server-side, ServiceHandler is created by
Acceptor, when new connection is detected. Note that PEER_STREAM
is created by PEER_STREAM::accept () method.
*/
ServiceHandler (PEER_STREAM* ps_)
: m_peerStream (ps_)
{
trace("ServiceHandler::ServiceHandler");
}
/// Destructor closes and deletes PEER_STREAM.
virtual ~ServiceHandler () {
trace("ServiceHandler::~ServiceHandler");
if ( m_peerStream ) {
delete m_peerStream;
m_peerStream = (PEER_STREAM*) NULL;
}
}
/** Pure virtual method defined by subclass. The open()
hook is called by the Acceptor or Connector once a
connection is established. The behavior of this method
must be defined by a subclass, which typically performs
any service-specific initialization.
*/
virtual int open (void) = 0;
/** Pure virtual method defined by subclass. The close()
hook closes PEER_STREAM by default
The behavior of this method can be changed by a subclass,
which typically performs any service-specific cleanup.
EventHandler::handle_close() method of base class EventHandler
is called when client closes connection. ServiceHandler
object can destroy itself from there.
*/
virtual void close (void)
{
trace("ServiceHandler::close");
if ( m_peerStream ) m_peerStream->close ();
}
/** Conversion operator to type PEER_STREAM &.
Comes handy when you want to call underlying PEER_STREAM
member functions directly.
@return reference to underlying stream mechanism
*/
operator PEER_STREAM& ()
{
// trace("ServiceHandler::opt PEER_STREAM& ()");
return *m_peerStream;
}
/// Return referenct to underlying PEER_STREAM.
PEER_STREAM& get_stream () { return *m_peerStream; }
protected:
/** Concrete Socket instance. ServiceHandler owns this
object which is delete()-ed in destructor.
*/
PEER_STREAM* m_peerStream;
};
} // end namespace ASSA
#endif /* SERVICE_HANDLER_H */
|