annotate foosdk/sdk/foobar2000/SDK/service_by_guid.h @ 1:20d02a178406 default tip

*: check in everything else yay
author Paper <paper@tflc.us>
date Mon, 05 Jan 2026 02:15:46 -0500
parents
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
1
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
1 #pragma once
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
2 #include <pfc/map.h>
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
3
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
4
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
5
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
6 template<typename what>
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
7 static bool service_by_guid_fallback(service_ptr_t<what> & out, const GUID & id) {
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
8 for (auto ptr : what::enumerate()) {
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
9 if (ptr->get_guid() == id) { out = ptr; return true; }
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
10 }
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
11 return false;
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
12 }
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
13
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
14 template<typename what>
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
15 class service_by_guid_data {
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
16 public:
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
17 service_by_guid_data() : m_inited(), m_servClass() {}
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
18
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
19 bool ready() const {return m_inited;}
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
20
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
21 // Caller must ensure initialize call before create() as well as thread safety of initialize() calls. The rest of this class is thread safe (only reads member data).
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
22 void initialize() {
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
23 if (m_inited) return;
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
24 pfc::assert_same_type< what, typename what::t_interface_entrypoint >();
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
25 m_servClass = service_factory_base::enum_find_class(what::class_guid);
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
26 const t_size servCount = service_factory_base::enum_get_count(m_servClass);
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
27 for(t_size walk = 0; walk < servCount; ++walk) {
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
28 service_ptr_t<what> temp;
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
29 if (_service_instantiate_helper(temp, m_servClass, walk)) {
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
30 m_order.set(temp->get_guid(), walk);
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
31 }
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
32 }
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
33 m_inited = true;
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
34 }
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
35
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
36 bool create(service_ptr_t<what> & out, const GUID & theID) const {
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
37 PFC_ASSERT(m_inited);
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
38 t_size index;
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
39 if (!m_order.query(theID,index)) return false;
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
40 return _service_instantiate_helper(out, m_servClass, index);
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
41 }
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
42 service_ptr_t<what> create(const GUID & theID) const {
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
43 service_ptr_t<what> temp; if (!crete(temp,theID)) throw exception_service_not_found(); return temp;
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
44 }
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
45
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
46 private:
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
47 volatile bool m_inited;
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
48 pfc::map_t<GUID,t_size> m_order;
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
49 service_class_ref m_servClass;
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
50 };
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
51
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
52 template<typename what>
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
53 class _service_by_guid_data_container {
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
54 public:
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
55 static service_by_guid_data<what> data;
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
56 };
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
57 template<typename what> service_by_guid_data<what> _service_by_guid_data_container<what>::data;
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
58
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
59
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
60 template<typename what>
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
61 static void service_by_guid_init() {
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
62 service_by_guid_data<what> & data = _service_by_guid_data_container<what>::data;
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
63 data.initialize();
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
64 }
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
65 template<typename what>
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
66 static bool service_by_guid(service_ptr_t<what> & out, const GUID & theID) {
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
67 pfc::assert_same_type< what, typename what::t_interface_entrypoint >();
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
68 service_by_guid_data<what> & data = _service_by_guid_data_container<what>::data;
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
69 if (data.ready()) {
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
70 //fall-thru
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
71 } else if (core_api::is_main_thread()) {
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
72 data.initialize();
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
73 } else {
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
74 #if PFC_DEBUG
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
75 FB2K_DebugLog() << "Warning: service_by_guid() used in non-main thread without initialization, using fallback";
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
76 #endif
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
77 return service_by_guid_fallback(out,theID);
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
78 }
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
79 return data.create(out,theID);
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
80 }
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
81 template<typename what>
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
82 static service_ptr_t<what> service_by_guid(const GUID & theID) {
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
83 service_ptr_t<what> temp;
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
84 if (!service_by_guid(temp, theID)) {
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
85 #if PFC_DEBUG
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
86 FB2K_DebugLog() << "service_by_guid failure: " << what::debugServiceName() << " : " << pfc::print_guid( theID );
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
87 #endif
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
88 throw exception_service_not_found();
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
89 }
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
90 return temp;
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
91 }
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
92
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
93
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
94
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
95
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
96 class comparator_service_guid {
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
97 public:
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
98 template<typename what> static int compare(const what & v1, const what & v2) { return pfc::compare_t(v1->get_guid(), v2->get_guid()); }
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
99 };
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
100