Пример: Hello World (v 1.x)
Давайте напишем наше первое CppCMS-приложение.
Для начала создадим файл hello.cpp и сохраним в нем следующее содержание.
Includes:
Нам необходимо импортировать некоторые определения для первого приложения:
cppcms/application.h- классapplication, из которого наследуется каждое приложение CppCMS.cppcms/applications_pool.h- классapplications_pool, управляющий пользовательскими приложениями - создает новое приложение при каждом HTTP-запросе, кэшируя его для будущего использования.cppcms/service.h- севис - центральный цикл событий сетевого сервиса.cppcms/http_response.h- класс, в котором происходит формирование HTTP-ответа клиенту.
Давайте подключим их все.
#include <cppcms/application.h> #include <cppcms/applications_pool.h> #include <cppcms/service.h> #include <cppcms/http_response.h> #include <iostream>
Теперь определим первый класс приложения наследующий cppcms::application. Он должен получить в своем конструкторе ссылку на основной сервис CppCMS, который запускает наше приложение.
class my_hello_world : public cppcms::application {
public:
my_hello_world(cppcms::service &srv) :
cppcms::application(srv)
{
}
virtual void main(std::string url);
};
На этом этапе, чтобы отвечать на пользовательские запросы переопределим функцию-член класса cppcms::application::main, которая всегда вызывается в каждом запросе.
В этой функции запишем простой HTML в поток вывода.
Доступ к потоку вывода осуществляется с использованием функции-члена response класса application, дающей доступ к потоку вывода out().
void my_hello_world::main(std::string /*url*/)
{
response().out()<<
"<html>\n"
"<body>\n"
" <h1>Hello World</h1>\n"
"</body>\n"
"</html>\n";
}
Теперь подготовим функцию main. Для начала создадим класс сервиса, который парсит параметры командной строки и ищет опции конфигурации.
int main(int argc,char ** argv)
{
try {
cppcms::service srv(argc,argv);
Затем укажем классу applications_pool использовать наше приложение - my_hello_world предоставляя его предопределенной фабрике объектов cppcms::applications_factory<my_hello_world>(). Мы, так сказать, примонтировали наше приложение к пулу, чтобы оно
использовалось для обработки запроса.
srv.applications_pool().mount(cppcms::applications_factory<my_hello_world>());
И теперь запустим цикл событий (event loop). Функция run() завершается, если процесс получает сигналы SIGINT, SIGTERM или SIGUSR1.
srv.run();
}
catch(std::exception const &e) {
std::cerr<<e.what()<<std::endl;
}
}
Вот наше приложение и готово. Теперь можно скомпилировать его также просто как:
c++ hello.cpp -lcppcms -o hello
Теперь нужно подготовить конфигурационный файл config.js, использующий файловый формат JSON для передачи всех опций:
{
"service" : {
"api" : "http",
"port" : 8080
},
"http" : {
"script_names" : [ "/hello" ]
}
}
Мы настроили сервис слушать порт 8080, используя протокол HTTP (что очень полезно для отладки приложения).
Также мы передали параметр script_names, определяющий путь к виртуальным "CGI скриптам" или, проще говоря, путь, по которому должно вызываться наше приложение.
Теперь можно запустить приложение
./hello -c config.js
Наберем в браузере ссылку http://localhost:8080/hello, чтобы увидеть наше первое рабочее CppCMS-приложение.
