Added attach/detach interface proposal.
This commit is contained in:
1 parent
a0bf0e93f4
commit
8dcf41e9cf
3 files changed
+109
-29
No files matched your search
@@ -68,6 +68,7 @@ message OrderDefinition {
|
||||
CTICode cti_code = 9;
|
||||
CustomerOrFirm customer_or_firm = 10;
|
||||
OrderSubType sub_type = 12;
|
||||
repeated uint32 attach_order = 15;
|
||||
|
||||
CustomOrderDefinition custom_def = 11;
|
||||
}
|
||||
|
||||
@@ -1,66 +1,113 @@
|
||||
#pragma once
|
||||
|
||||
#include <functional>
|
||||
#include "lib/api/services/OrderService.pb.h"
|
||||
#include "lib/domain_model/common.h"
|
||||
#include "lib/orderman/actors/order_manager/ChildOrder.h"
|
||||
#include "lib/orderman/orders/OrderOpResult.h"
|
||||
#include <functional>
|
||||
|
||||
// fwds
|
||||
namespace bts {
|
||||
namespace api {namespace orderman {
|
||||
namespace api {
|
||||
namespace orderman {
|
||||
class OrderDefinition;
|
||||
class CustomOrderDefinition;
|
||||
class OrderState;
|
||||
class Update;
|
||||
}}
|
||||
namespace mercury {class TimerEvent;}
|
||||
class OrderRecord;
|
||||
} // namespace orderman
|
||||
} // namespace api
|
||||
namespace mercury {
|
||||
class TimerEvent;
|
||||
}
|
||||
namespace orderman {
|
||||
class ChildOrder;
|
||||
class OrderOpResult;
|
||||
class ISecurityDB;
|
||||
class IAlgoServices;
|
||||
class IOrderFactory;
|
||||
class BookUpdateEvent;
|
||||
class TickerUpdateEvent;
|
||||
class SettlementUpdateEvent;
|
||||
class OrderStateUpdateEvent;
|
||||
}}
|
||||
|
||||
} // namespace orderman
|
||||
} // namespace bts
|
||||
|
||||
namespace bts {
|
||||
namespace orderman {
|
||||
|
||||
template <class EventType>
|
||||
using Callback = std::function<void(EventType const&)>;
|
||||
using Callback = std::function<void(EventType const &)>;
|
||||
using OrderOpCB = Callback<OrderOpResult>;
|
||||
OrderOpCB ignore() {
|
||||
return [](auto &) {};
|
||||
};
|
||||
|
||||
struct AttachOpResult {
|
||||
OrderOpResult result;
|
||||
ChildOrder child;
|
||||
};
|
||||
|
||||
class AlgoOrder {
|
||||
public:
|
||||
virtual void on_init_new(api::orderman::OrderDefinition const &,
|
||||
ISecurityDB &, IOrderFactory &) = 0;
|
||||
|
||||
virtual void on_activate(Price, Quantity, IAlgoServices &,
|
||||
OrderOpCB const &) = 0;
|
||||
|
||||
virtual void on_update(Price, Quantity, OrderOpCB const &) = 0;
|
||||
virtual void on_update(api::orderman::Update const &,
|
||||
OrderOpCB const &on_result) {
|
||||
on_result(OrderOpResult{api::orderman::ORDER_ERROR_INVALID_OP,
|
||||
"Operation not supported"});
|
||||
}
|
||||
|
||||
virtual void on_cancel(OrderOpCB const &) = 0;
|
||||
virtual void on_detach(OrderOpCB const &) = 0;
|
||||
virtual void on_attached(OrderKey /*new_parent*/) {};
|
||||
virtual void on_detached() {}
|
||||
};
|
||||
|
||||
class IOrderServices {
|
||||
public:
|
||||
public:
|
||||
// reporting state and definition changes
|
||||
virtual void report_definition(const api::orderman::CustomOrderDefinition &) = 0;
|
||||
virtual void
|
||||
report_definition(const api::orderman::CustomOrderDefinition &) = 0;
|
||||
virtual void report_state(const api::orderman::OrderState &) = 0;
|
||||
|
||||
// Child order creation/control
|
||||
virtual void make_child_orders(api::orderman::OrderDefinition const&, size_t how_many,
|
||||
Callback<std::vector<ChildOrder> const&>) = 0;
|
||||
virtual std::vector<ChildOrder> make_child_orders(api::orderman::OrderDefinition const&, size_t how_many) = 0;
|
||||
virtual void activate(ChildOrder&, Price, Quantity,Callback<OrderOpResult> const&) = 0;
|
||||
virtual void activate(ChildOrder&, Price, Quantity) = 0;
|
||||
virtual void update(ChildOrder&,Price, Quantity) = 0;
|
||||
virtual void update(ChildOrder&,Price, Quantity,Callback<OrderOpResult> const&) = 0;
|
||||
virtual void update(api::orderman::Update const &) = 0;
|
||||
virtual void update(api::orderman::Update const &,Callback<OrderOpResult> const&) = 0;
|
||||
virtual void crack(ChildOrder&, Callback<OrderOpResult> const&) = 0;
|
||||
virtual void crack(ChildOrder&) = 0;
|
||||
virtual void cancel(ChildOrder&, Callback<OrderOpResult> const&) = 0;
|
||||
virtual void cancel(ChildOrder&) = 0;
|
||||
virtual void
|
||||
make_child_orders(api::orderman::OrderDefinition const &, size_t how_many,
|
||||
Callback<std::vector<ChildOrder> const &>) = 0;
|
||||
virtual void activate(ChildOrder &, Price, Quantity,
|
||||
OrderOpCB const & = ignore()) = 0;
|
||||
virtual void update(ChildOrder &, Price, Quantity,
|
||||
OrderOpCB const & = ignore()) = 0;
|
||||
virtual void update(ChildOrder &, api::orderman::Update const &,
|
||||
OrderOpCB const & = ignore()) = 0;
|
||||
virtual void cancel(ChildOrder &, OrderOpCB const & = ignore()) = 0;
|
||||
virtual void attach(OrderKey, Callback<AttachOpResult> const &) = 0;
|
||||
virtual void detach(ChildOrder const &, OrderOpCB const & = ignore());
|
||||
// End child control
|
||||
|
||||
// Events
|
||||
virtual void subscribe_to_book(SecurityKey,Callback<BookUpdateEvent> const&) = 0;
|
||||
virtual void subscribe_to_book(SecurityKey,
|
||||
Callback<BookUpdateEvent> const &) = 0;
|
||||
virtual void unsubscribe_from_book(SecurityKey) = 0;
|
||||
virtual void subscribe_to_ticker(SecurityKey,Callback<TickerUpdateEvent> const&) = 0;
|
||||
virtual void subscribe_to_ticker(SecurityKey,
|
||||
Callback<TickerUpdateEvent> const &) = 0;
|
||||
virtual void unsubscribe_from_ticker(SecurityKey) = 0;
|
||||
virtual void subscribe_to_settlement(SecurityKey, Callback<SettlementUpdateEvent> const&) = 0;
|
||||
virtual void
|
||||
subscribe_to_settlement(SecurityKey,
|
||||
Callback<SettlementUpdateEvent> const &) = 0;
|
||||
virtual void unsubscribe_from_settlement(SecurityKey) = 0;
|
||||
virtual void subscribe_to_time(Callback<bts::mercury::TimerEvent> const&) = 0;
|
||||
virtual void
|
||||
subscribe_to_time(Callback<bts::mercury::TimerEvent> const &) = 0;
|
||||
virtual void unsubscribe_from_time() = 0;
|
||||
virtual void subscribe_to_child_updates(Callback<OrderStateUpdateEvent> const&) = 0;
|
||||
virtual void
|
||||
subscribe_to_child_updates(Callback<OrderStateUpdateEvent> const &) = 0;
|
||||
virtual void unsubscribe_from_child_updates() = 0;
|
||||
// End events
|
||||
};
|
||||
}}
|
||||
} // namespace orderman
|
||||
} // namespace bts
|
||||
@@ -0,0 +1,32 @@
|
||||
** Attach/Detach semantics
|
||||
*** Semantics
|
||||
- An order base definition can include a list of running orders to attach
|
||||
to
|
||||
- Each custom definition can have parameters that allow configuration
|
||||
of the specific order type with respect to the attachment
|
||||
list. Obvious configuration alternatives are:
|
||||
- Attach to each of the listed orders directly or
|
||||
- Forward attachment list to children
|
||||
- Only orders with no parent or parents in a terminal state can be
|
||||
attached to
|
||||
- a detach(order_key) message can be sent to any order, even if that
|
||||
order was not started through attachment to an existing order. the
|
||||
expected semantics is for the order in question to stop managing the
|
||||
child order and transition to completed.
|
||||
|
||||
*** API
|
||||
- IOrderServices:
|
||||
- attach_to_order(ok, std::function<void(Result,ChildOrder)>
|
||||
on_attach_complete);
|
||||
- detach(ChildOrder)
|
||||
- Order
|
||||
- on_detach(order_key)
|
||||
- on_attached();
|
||||
- on_detached();
|
||||
message OrderDefinition {
|
||||
CTICode cti_code = 9;
|
||||
CustomerOrFirm customer_or_firm = 10;
|
||||
OrderSubType sub_type = 12;
|
||||
+ repeated uint32 attach_to_order = 13;
|
||||
CustomOrderDefinition custom_def = 11;
|
||||
}
|
||||
Reference in new issue
Block a user