Service.hpp

/*
 * (c) Copyright, Real-Time Innovations, 2021.
 * All rights reserved.
 *
 * No duplications, whole or partial, manual or electronic, may be made
 * without express written permission.  Any such copies, or
 * revisions thereof, must display this notice unaltered.
 * This code contains trade secrets of Real-Time Innovations, Inc.
 */
 
#ifndef WEBINTEGRATIONSERVICE_H
#define WEBINTEGRATIONSERVICE_H
 
#include <dds/core/Reference.hpp>
#include <rti/config/Logger.hpp>
 
#include <rti/webdds/ServiceProperty.hpp>
#include <rti/webdds/Dll.hpp>
#include <rti/webdds/detail/WebIntegrationServiceImpl.hpp>
 
namespace rti { namespace webdds {
 
/*e \defgroup RTI_WebIntegrationServiceLibModule RTI Web Integration Library API
 *
 * @brief @product  can be deployed as a native library linked into your
 * application in select architectures.
 *
 * This API allows you to create, configure and start @product instances from
 * your application.
 *
 * The following code shows the typical use of the API:
 *
 * \code
 *
 * int main ()
 * {
 *     rti::webdds::Service service(
 *             rti::webdds::ServiceProperty()
 *             .cfg_file("MyWebint.xml")
 *             .cfg_name("MyWebint"));
 *     ...
 *
 *     service.start();
 *
 *     while(keep_running) {
 *         sleep();
 *         ...
 *     }
 *
 *     return 0;
 * }
 *
 * \endcode
 *
 * Instead of a file, you can use XML strings to configure @product.
 * See ServiceProperty for more information.
 * <p>
 * To build your application you need to link with the @product native library
 * in <b> &lt;@ndds home&gt;/bin/&lt;architecture&gt;/ </b>.
 *
 * ### Development Requirements
 *
 * |                 | Unix-based Systems                      | Windows Systems             |
 * | --------------: | :----------------:                      | :-------------:             |
 * | Shared Libraries| librtiwebintegrationservice.so          | rtiwebintegrationservice.dll|
 * | ^               | libnddscpp.so                           | nddscpp.dll                 |
 * | ^               | libnddsc.so                             | nddsc.dll                   |
 * | ^               | libnddscore.so                          | nddscore.dll                |
 * | ^               | librtiapputilsc.so                      | rtiapputilsc.dll            |
 * | ^               | librtisqlite.so                         | rtisqlite.dll               |
 * | ^               | libcivetweb-cpp.so.1.15.0               | civetweb-cpp.dll            |
 * | ^               | libcivetweb.so.1.15.0                   | civetweb.dll                |
 * | Headers         | rti/webdds/Service.hpp                  | rti/webdds/Service.hpp      |
 *
 */
 
        
class Service : public dds::core::Reference<WebIntegrationServiceImpl> {
public:
    typedef dds::core::Reference<WebIntegrationServiceImpl> Base;
    OMG_DDS_REF_TYPE_NOTYPENAME(
           Service,
            dds::core::Reference,
           WebIntegrationServiceImpl);
 
   Service(ServiceProperty&& property)
            : Base(new WebIntegrationServiceImpl(std::move(property)))
    {
        this->delegate()->remember_reference(this->delegate());
    }
 
    explicit Service(Base::DELEGATE_REF_T reference) : Base(reference)
    {
        if (this->delegate()) {
            this->delegate()->remember_reference(this->delegate());
        }
    }
 
    void start()
    {
        this->delegate()->start();
    }
 
    void stop()
    {
        this->delegate()->stop();
    }
 
};
 
}}
 
#endif // WEBINTEGRATIONSERVICE_H