mirror of
https://github.com/eclipse-openvehicle-api/openvehicle-api.git
synced 2026-04-21 11:38:16 +00:00
88 lines
3.4 KiB
C++
88 lines
3.4 KiB
C++
/********************************************************************************
|
|
* Copyright (c) 2025-2026 ZF Friedrichshafen AG
|
|
*
|
|
* This program and the accompanying materials are made available under the
|
|
* terms of the Apache License Version 2.0 which is available at
|
|
* https://www.apache.org/licenses/LICENSE-2.0
|
|
*
|
|
* SPDX-License-Identifier: Apache-2.0
|
|
*
|
|
* Contributors:
|
|
* Erik Verhoeven - initial API and implementation
|
|
********************************************************************************/
|
|
|
|
#ifndef ISOLATION_OBJECT_MONITOR_H
|
|
#define ISOLATION_OBJECT_MONITOR_H
|
|
|
|
#include <support/component_impl.h>
|
|
|
|
/**
|
|
* @brief Isolation object monitor. If shutdown is called, the application leaves the running loop.
|
|
* @remarks Only valid when running in an isolated application.
|
|
*/
|
|
class CIsoMonitor : public sdv::IInterfaceAccess, public sdv::IObjectControl
|
|
{
|
|
public:
|
|
/**
|
|
* @brief Constructor
|
|
* @param[in] pObject Pointer to the object to monitor
|
|
*/
|
|
CIsoMonitor(sdv::IInterfaceAccess* pObject);
|
|
|
|
/**
|
|
* @brief Destructor
|
|
*/
|
|
~CIsoMonitor();
|
|
|
|
// Interface map
|
|
BEGIN_SDV_INTERFACE_MAP()
|
|
SDV_INTERFACE_ENTRY(sdv::IObjectControl)
|
|
SDV_INTERFACE_CHAIN_MEMBER(m_ptrObject)
|
|
END_SDV_INTERFACE_MAP()
|
|
|
|
/**
|
|
* @brief Initialize the object. Overload of sdv::IObjectControl::Initialize.
|
|
* @param[in] ssObjectConfig Optional configuration string.
|
|
*/
|
|
virtual void Initialize(/*in*/ const sdv::u8string& ssObjectConfig) override;
|
|
|
|
/**
|
|
* @brief Get the current state of the object. Overload of sdv::IObjectControl::GetObjectState.
|
|
* @return Return the current state of the object.
|
|
*/
|
|
virtual sdv::EObjectState GetObjectState() const override;
|
|
|
|
/**
|
|
* @brief Set the component operation mode. Overload of sdv::IObjectControl::SetOperationMode.
|
|
* @param[in] eMode The operation mode, the component should run in.
|
|
*/
|
|
virtual void SetOperationMode(/*in*/ sdv::EOperationMode eMode) override;
|
|
|
|
/**
|
|
* @brief Get the object configuration for persistence.
|
|
* @return The object configuration as TOML string.
|
|
*/
|
|
virtual sdv::u8string GetObjectConfig() const override;
|
|
|
|
/**
|
|
* @brief Shutdown called before the object is destroyed. Overload of sdv::IObjectControl::Shutdown.
|
|
* @attention Implement calls to other SDV objects here as this is no longer considered safe during the destructor of the object!
|
|
* After a call to shutdown any threads/callbacks/etc that could call other SDV objects need to have been stopped.
|
|
* The SDV object itself is to remain in a state where it can respond to calls to its interfaces as other objects may still call it during the shutdown sequence!
|
|
* Any subsequent call to GetObjectState should return EObjectState::destruction_pending
|
|
*/
|
|
virtual void Shutdown() override;
|
|
|
|
/**
|
|
* @brief Get the contained object from the isolation monitor.
|
|
* @return The contained object.
|
|
*/
|
|
sdv::IInterfaceAccess* GetContainedObject();
|
|
|
|
private:
|
|
sdv::TInterfaceAccessPtr m_ptrObject; ///< Smart pointer to the object.
|
|
sdv::IObjectControl* m_pObjectControl = nullptr; ///< Pointer to the object control of the application
|
|
sdv::EObjectState m_eObjectState = sdv::EObjectState::initialization_pending; ///< Object state (in case there is no object control).
|
|
};
|
|
|
|
#endif // !defined ISOLATION_OBJECT_MONITOR_H
|