cmd_http_listener.cc

Go to the documentation of this file.

// Copyright (C) 2021-2024 Internet Systems Consortium, Inc. ("ISC")
//
// This Source Code Form is subject to the terms of the Mozilla Public
// License, v. 2.0. If a copy of the MPL was not distributed with this
// file, You can obtain one at http://mozilla.org/MPL/2.0/.
 
#include <config.h>
#include <asiolink/asio_wrapper.h>
#include <asiolink/io_address.h>
#include <asiolink/io_error.h>
#include <asiolink/io_service.h>
#include <cmd_http_listener.h>
#include <cmd_response_creator_factory.h>
#include <config_log.h>
#include <config/timeouts.h>
#include <util/multi_threading_mgr.h>
 
#include <boost/pointer_cast.hpp>
 
using namespace isc::asiolink;
using namespace isc::config;
using namespace isc::data;
using namespace isc::http;
using namespace isc::util;
 
namespace isc {
namespace config {
 
CmdHttpListener::CmdHttpListener(const IOAddress& address, const uint16_t port,
                                 const uint16_t thread_pool_size /* = 1 */,
                                 TlsContextPtr context /* = () */)
    : address_(address), port_(port), thread_io_service_(), http_listener_(),
      thread_pool_size_(thread_pool_size), thread_pool_(),
      tls_context_(context) {
}
 
CmdHttpListener::~CmdHttpListener() {
    stop();
}
 
void
CmdHttpListener::start() {
    if (MultiThreadingMgr::instance().isTestMode()) {
        return;
    }
    // We must be in multi-threading mode.
    if (!MultiThreadingMgr::instance().getMode()) {
        isc_throw(InvalidOperation, "CmdHttpListener cannot be started"
                  " when multi-threading is disabled");
    }
 
    // Punt if we're already started.
    if (!isStopped()) {
        isc_throw(InvalidOperation, "CmdHttpListener already started!");
    }
 
    try {
        // Create a new IOService.
        thread_io_service_.reset(new IOService());
 
        // Create the response creator factory first. It will be used to
        // generate response creators. Each response creator will be
        // used to generate the answer to specific request.
        HttpResponseCreatorFactoryPtr rcf(new CmdResponseCreatorFactory());
 
        // Create the HTTP listener. It will open up a TCP socket and be
        // prepared to accept incoming connections.
        http_listener_.reset(new HttpListener(thread_io_service_, address_,
                                              port_, tls_context_, rcf,
                                              HttpListener::RequestTimeout(TIMEOUT_AGENT_RECEIVE_COMMAND),
                                              HttpListener::IdleTimeout(TIMEOUT_AGENT_IDLE_CONNECTION_TIMEOUT)));
 
        // Instruct the HTTP listener to actually open socket, install
        // callback and start listening.
        http_listener_->start();
 
        // Create the thread pool with immediate start.
        thread_pool_.reset(new IoServiceThreadPool(thread_io_service_, thread_pool_size_));
 
        // OK, seems like we're good to go.
        LOG_DEBUG(command_logger, DBG_COMMAND, COMMAND_HTTP_LISTENER_STARTED)
            .arg(thread_pool_size_)
            .arg(address_)
            .arg(port_)
            .arg(tls_context_ ? "true" : "false");
    } catch (const std::exception& ex) {
        if (thread_pool_) {
            // Stop the thread pool.
            thread_pool_->stop();
        }
 
        if (http_listener_) {
            // Stop the listener.
            http_listener_->stop();
        }
 
        if (thread_io_service_) {
            thread_io_service_->stopAndPoll();
            thread_io_service_->stop();
        }
 
        // Get rid of the thread pool.
        thread_pool_.reset();
 
        // Get rid of the listener.
        http_listener_.reset();
 
        // Ditch the IOService.
        thread_io_service_.reset();
 
        isc_throw(Unexpected, "CmdHttpListener::run failed: " << ex.what());
    }
}
 
void
CmdHttpListener::checkPermissions() {
    if (thread_pool_) {
        thread_pool_->checkPausePermissions();
    }
}
 
void
CmdHttpListener::pause() {
    if (thread_pool_) {
        thread_pool_->pause();
    }
}
 
void
CmdHttpListener::resume() {
    if (thread_pool_) {
        thread_pool_->run();
    }
}
 
void
CmdHttpListener::stop() {
    // Nothing to do.
    if (!thread_io_service_) {
        return;
    }
 
    LOG_DEBUG(command_logger, DBG_COMMAND, COMMAND_HTTP_LISTENER_STOPPING)
              .arg(address_)
              .arg(port_);
 
    // Stop the thread pool.
    thread_pool_->stop();
 
    // Stop the listener.
    http_listener_->stop();
 
    thread_io_service_->stopAndPoll();
    thread_io_service_->stop();
 
    // Get rid of the thread pool.
    thread_pool_.reset();
 
    // Get rid of the listener.
    http_listener_.reset();
 
    // Ditch the IOService.
    thread_io_service_.reset();
 
    LOG_DEBUG(command_logger, DBG_COMMAND, COMMAND_HTTP_LISTENER_STOPPED)
              .arg(address_)
              .arg(port_);
}
 
bool
CmdHttpListener::isRunning() {
    if (thread_pool_) {
        return (thread_pool_->isRunning());
    }
 
    return (false);
}
 
bool
CmdHttpListener::isStopped() {
    if (thread_pool_) {
        return (thread_pool_->isStopped());
    }
 
    return (true);
}
 
bool
CmdHttpListener::isPaused() {
    if (thread_pool_) {
        return (thread_pool_->isPaused());
    }
 
    return (false);
}
 
}  // namespace config
}  // namespace isc