/*----------------------------------------------------------------------------*/ /* Copyright (c) FIRST 2015. All Rights Reserved. */ /* Open Source Software - may be modified and shared by FRC teams. The code */ /* must be accompanied by the FIRST BSD license file in the root directory of */ /* the project. */ /*----------------------------------------------------------------------------*/ #ifndef NT_STORAGE_H_ #define NT_STORAGE_H_ #include #include #include #include #include #include #include "llvm/StringMap.h" #include "support/ConcurrentQueue.h" #include "ntcore_cpp.h" #include "SequenceNumber.h" namespace nt { class StorageTest; class StorageEntry { public: StorageEntry() : m_id(0xffff) { m_flags = 0; } bool IsPersistent() const { return (m_flags & NT_PERSISTENT) != 0; } std::shared_ptr value() { #ifdef HAVE_SHARED_PTR_ATOMIC_LOAD return std::atomic_load(&m_value); #else std::lock_guard lock(m_value_mutex); return m_value; #endif } void set_value(std::shared_ptr value) { #ifdef HAVE_SHARED_PTR_ATOMIC_LOAD std::atomic_store(&m_value, value); #else std::lock_guard lock(m_value_mutex); m_value = value; #endif } unsigned int flags() const { return m_flags; } void set_flags(unsigned int flags) { m_flags = flags; } unsigned int id() const { return m_id; } void set_id(unsigned int id) { m_id = id; } SequenceNumber seq_num() const { return m_seq_num; } void set_seq_num(SequenceNumber seq_num) { m_seq_num = seq_num; } private: // These variables are accessed by both Dispatcher and user, so must use // atomic accesses. Unfortunately, atomic shared_ptr is not yet available // on most compilers, so we need an explicit mutex instead. #ifndef HAVE_SHARED_PTR_ATOMIC_LOAD std::mutex m_value_mutex; #endif std::shared_ptr m_value; std::atomic_uint m_flags; // Only accessed from the Dispatcher, so these are NOT mutex-protected. unsigned int m_id; SequenceNumber m_seq_num; }; class Storage { friend class StorageTest; public: static Storage& GetInstance() { if (!m_instance) m_instance.reset(new Storage); return *m_instance; } ~Storage(); struct Update { std::shared_ptr entry; enum Kind { kAssign, kValueUpdate, kFlagsUpdate, kDelete, kDeleteAll }; Kind kind; }; typedef ConcurrentQueue UpdateQueue; // Finds, but does not create entry. Returns nullptr if not found. std::shared_ptr FindEntry(StringRef name) const; std::shared_ptr GetEntry(StringRef name); // Accessors required by Dispatcher. void EnableUpdates() { m_updates_enabled = true; } void DisableUpdates() { m_updates_enabled = false; } UpdateQueue& updates() { return m_updates; } // User functions std::shared_ptr GetEntryValue(StringRef name) const; bool SetEntryValue(StringRef name, std::shared_ptr value); void SetEntryTypeValue(StringRef name, std::shared_ptr value); void SetEntryFlags(StringRef name, unsigned int flags); unsigned int GetEntryFlags(StringRef name) const; void DeleteEntry(StringRef name); void DeleteAllEntries(); std::vector GetEntryInfo(StringRef prefix, unsigned int types); void SavePersistent(std::ostream& os) const; bool LoadPersistent( std::istream& is, std::function warn); private: Storage(); Storage(const Storage&) = delete; Storage& operator=(const Storage&) = delete; void AddUpdate(std::shared_ptr entry, Update::Kind kind) { if (m_updates_enabled) m_updates.push(Update{entry, kind}); } typedef llvm::StringMap> EntriesMap; mutable std::mutex m_mutex; EntriesMap m_entries; UpdateQueue m_updates; std::atomic_bool m_updates_enabled; static std::unique_ptr m_instance; }; } // namespace nt #endif // NT_STORAGE_H_