Initial commit.
This commit is contained in:
220
include/Private/TaskFSMPrivate.h
Normal file
220
include/Private/TaskFSMPrivate.h
Normal file
@@ -0,0 +1,220 @@
|
||||
// WARNING: This is an internal implementation header, which must be included from a specific location/namespace
|
||||
// That is the reason that this header does not contain a #pragma once, nor namespace guards
|
||||
|
||||
// Helper struct representing a transition event to a new FSM state
|
||||
struct TransitionEvent
|
||||
{
|
||||
Task<> newTask;
|
||||
StateId newStateId;
|
||||
};
|
||||
|
||||
// Base class for defining links between states
|
||||
class LinkBase
|
||||
{
|
||||
public:
|
||||
virtual ~LinkBase() = default;
|
||||
virtual TOptional<TransitionEvent> EvaluateLink(const tOnStateTransitionFn& in_onTransitionFn) const = 0;
|
||||
};
|
||||
|
||||
// Type-safe link handle
|
||||
class LinkHandle
|
||||
{
|
||||
bool IsOnCompleteLink() const
|
||||
{
|
||||
return m_linkType == eType::OnComplete;
|
||||
}
|
||||
bool HasCondition() const
|
||||
{
|
||||
return m_isConditionalLink;
|
||||
}
|
||||
|
||||
protected:
|
||||
// Link-type enum
|
||||
enum class eType
|
||||
{
|
||||
Normal,
|
||||
OnComplete,
|
||||
};
|
||||
|
||||
// Friends
|
||||
template<class, class> friend class StateHandle;
|
||||
friend class ::TaskFSM;
|
||||
|
||||
// Constructors (friend-only)
|
||||
LinkHandle() = delete;
|
||||
LinkHandle(TSharedPtr<LinkBase> in_link, eType in_linkType, bool in_isConditional)
|
||||
: m_link(MoveTemp(in_link))
|
||||
, m_linkType(in_linkType)
|
||||
, m_isConditionalLink(in_isConditional)
|
||||
{
|
||||
}
|
||||
TOptional<TransitionEvent> EvaluateLink(const tOnStateTransitionFn& in_onTransitionFn) const
|
||||
{
|
||||
return m_link->EvaluateLink(in_onTransitionFn);
|
||||
}
|
||||
|
||||
private:
|
||||
TSharedPtr<LinkBase> m_link; // The underlying link
|
||||
eType m_linkType; // Whether the link is normal or OnComplete
|
||||
bool m_isConditionalLink; // Whether the link has an associated condition predicate
|
||||
};
|
||||
|
||||
// Internal FSM state object
|
||||
template<class tStateInput, class tStateConstructorFn>
|
||||
struct State
|
||||
{
|
||||
State(tStateConstructorFn in_stateCtorFn, StateId in_stateId, FString in_debugName)
|
||||
: stateCtorFn(in_stateCtorFn)
|
||||
, stateId(in_stateId)
|
||||
, debugName(in_debugName)
|
||||
{
|
||||
}
|
||||
|
||||
tStateConstructorFn stateCtorFn;
|
||||
StateId stateId;
|
||||
FString debugName;
|
||||
};
|
||||
|
||||
// Internal FSM state object (exit state specialization)
|
||||
template<>
|
||||
struct State<void, void>
|
||||
{
|
||||
State(StateId in_stateId, FString in_debugName)
|
||||
: stateId(in_stateId)
|
||||
, debugName(in_debugName)
|
||||
{
|
||||
}
|
||||
|
||||
StateId stateId;
|
||||
FString debugName;
|
||||
};
|
||||
|
||||
// Internal link definition object
|
||||
template<class ReturnT, class tStateConstructorFn, class tPredicateFn>
|
||||
class Link : public LinkBase
|
||||
{
|
||||
public:
|
||||
Link(TSharedPtr<State<ReturnT, tStateConstructorFn>> in_targetState, tPredicateFn in_predicate)
|
||||
: m_targetState(MoveTemp(in_targetState))
|
||||
, m_predicate(in_predicate)
|
||||
{
|
||||
}
|
||||
|
||||
private:
|
||||
virtual TOptional<TransitionEvent> EvaluateLink(const tOnStateTransitionFn& in_onTransitionFn) const final
|
||||
{
|
||||
TOptional<TransitionEvent> result;
|
||||
if(TOptional<ReturnT> payload = m_predicate())
|
||||
{
|
||||
if(in_onTransitionFn)
|
||||
{
|
||||
in_onTransitionFn();
|
||||
}
|
||||
result = TransitionEvent{ m_targetState->stateCtorFn(payload.GetValue()), m_targetState->stateId };
|
||||
}
|
||||
return result;
|
||||
}
|
||||
|
||||
TSharedPtr<State<ReturnT, tStateConstructorFn>> m_targetState;
|
||||
tPredicateFn m_predicate;
|
||||
};
|
||||
|
||||
// Internal link definition object (no-payload specialization)
|
||||
template<class tStateConstructorFn, class tPredicateFn>
|
||||
class Link<void, tStateConstructorFn, tPredicateFn> : public LinkBase
|
||||
{
|
||||
public:
|
||||
Link(TSharedPtr<State<void, tStateConstructorFn>> in_targetState, tPredicateFn in_predicate)
|
||||
: m_targetState(MoveTemp(in_targetState))
|
||||
, m_predicate(in_predicate)
|
||||
{
|
||||
}
|
||||
|
||||
private:
|
||||
virtual TOptional<TransitionEvent> EvaluateLink(const tOnStateTransitionFn& in_onTransitionFn) const final
|
||||
{
|
||||
TOptional<TransitionEvent> result;
|
||||
if(m_predicate())
|
||||
{
|
||||
if(in_onTransitionFn)
|
||||
{
|
||||
in_onTransitionFn();
|
||||
}
|
||||
result = TransitionEvent{ m_targetState->stateCtorFn(), m_targetState->stateId };
|
||||
}
|
||||
return result;
|
||||
}
|
||||
|
||||
TSharedPtr<State<void, tStateConstructorFn>> m_targetState;
|
||||
tPredicateFn m_predicate;
|
||||
};
|
||||
|
||||
// Internal link definition object (exit-state specialization)
|
||||
template<class tPredicateFn>
|
||||
class Link<void, void, tPredicateFn> : public LinkBase
|
||||
{
|
||||
public:
|
||||
Link(TSharedPtr<State<void, void>> in_targetState, tPredicateFn in_predicate)
|
||||
: m_targetState(MoveTemp(in_targetState))
|
||||
, m_predicate(in_predicate)
|
||||
{
|
||||
}
|
||||
|
||||
private:
|
||||
virtual TOptional<TransitionEvent> EvaluateLink(const tOnStateTransitionFn& in_onTransitionFn) const final
|
||||
{
|
||||
TOptional<TransitionEvent> result;
|
||||
if(m_predicate())
|
||||
{
|
||||
if(in_onTransitionFn)
|
||||
{
|
||||
in_onTransitionFn();
|
||||
}
|
||||
result = TransitionEvent{ Task<>(), m_targetState->stateId };
|
||||
}
|
||||
return result;
|
||||
}
|
||||
|
||||
TSharedPtr<State<void, void>> m_targetState;
|
||||
tPredicateFn m_predicate;
|
||||
};
|
||||
|
||||
// Specialized type traits that deduce the first argument type of an arbitrary callable type
|
||||
template <typename tRet, typename tArg>
|
||||
static tArg get_first_arg_type(TFunction<tRet(tArg)> f); // Return type is first argument type
|
||||
|
||||
template <typename tRet>
|
||||
static void get_first_arg_type(TFunction<tRet()> f); // Return type is void (function has no arguments)
|
||||
|
||||
template <typename T>
|
||||
struct function_traits : public function_traits<decltype(&T::operator())> // Generic callable objects (use operator())
|
||||
{
|
||||
};
|
||||
|
||||
template <typename tRet, typename... tArgs> // Function
|
||||
struct function_traits<tRet(tArgs...)>
|
||||
{
|
||||
using tFunction = TFunction<tRet(tArgs...)>;
|
||||
using tArg = decltype(get_first_arg_type(tFunction()));
|
||||
};
|
||||
|
||||
template <typename tRet, typename... tArgs> // Function ptr
|
||||
struct function_traits<tRet(*)(tArgs...)>
|
||||
{
|
||||
using tFunction = TFunction<tRet(tArgs...)>;
|
||||
using tArg = decltype(get_first_arg_type(tFunction()));
|
||||
};
|
||||
|
||||
template <typename tClass, typename tRet, typename... tArgs> // Member function ptr (const)
|
||||
struct function_traits<tRet(tClass::*)(tArgs...) const>
|
||||
{
|
||||
using tFunction = TFunction<tRet(tArgs...)>;
|
||||
using tArg = decltype(get_first_arg_type(tFunction()));
|
||||
};
|
||||
|
||||
template <typename tClass, typename tRet, typename... tArgs> // Member function ptr
|
||||
struct function_traits<tRet(tClass::*)(tArgs...)>
|
||||
{
|
||||
using tFunction = TFunction<tRet(tArgs...)>;
|
||||
using tArg = decltype(get_first_arg_type(tFunction()));
|
||||
};
|
||||
Reference in New Issue
Block a user