SocialGraph.h

浏览该文件的文档.

#pragma once
#include "common/Export.h"
 
 
#include <cstdint>
#include <map>
#include <optional>
#include <string>
#include <tuple>
#include <vector>
 
namespace eve::social {
 
using EntityId = std::string;
 
struct SocialChangeEvent {
    std::uint64_t sequence = 0;
    std::string   action;
    EntityId      source;
    EntityId      target;
    std::string   type;
    double        oldValue = 0.0;
    double        newValue = 0.0;
};
 
class EVENGINE_API_FOUNDATION SocialGraph {
public:
    static EntityId integerId(std::int64_t id);
 
    bool setOwner(const EntityId& entity, const EntityId& owner);
    EntityId ownerOf(const EntityId& entity) const;
    std::vector<EntityId> ownedBy(const EntityId& owner) const;
 
    bool setController(const EntityId& entity, const EntityId& controller);
    EntityId controllerOf(const EntityId& entity) const;
    std::vector<EntityId> controlledBy(const EntityId& controller) const;
 
    bool assign(const EntityId& source, const std::string& role, const EntityId& target);
    bool unassign(const EntityId& source, const std::string& role, const EntityId& target);
    bool isAssigned(const EntityId& source, const std::string& role, const EntityId& target) const;
    std::vector<EntityId> targetsOf(const EntityId& source, const std::string& role) const;
    std::vector<EntityId> assigneesOf(const EntityId& target, const std::string& role) const;
 
    bool setRelation(const EntityId& source, const EntityId& target, const std::string& type, double value);
    double addRelation(const EntityId& source, const EntityId& target, const std::string& type, double delta);
    bool link(const EntityId& source, const EntityId& target, const std::string& type);
    bool removeRelation(const EntityId& source, const EntityId& target, const std::string& type);
    bool hasRelation(const EntityId& source, const EntityId& target, const std::string& type) const;
    double relation(const EntityId& source, const EntityId& target, const std::string& type,
                    double fallback = 0.0) const;
    std::vector<EntityId> relationTargets(const EntityId& source, const std::string& type, double minimum = 0.0) const;
    std::vector<EntityId> relationSources(const EntityId& target, const std::string& type, double minimum = 0.0) const;
 
    bool removeEntity(const EntityId& entity);
    void clear();
 
    const std::vector<SocialChangeEvent>& events() const { return events_; }
    void clearEvents() { events_.clear(); }
 
private:
    using EntitySet = std::map<EntityId, bool>;
    using PairKey   = std::pair<EntityId, std::string>;
    using EdgeKey   = std::tuple<EntityId, EntityId, std::string>;
 
    void emit(std::string action, EntityId source = {}, EntityId target = {}, std::string type = {},
              double oldValue = 0.0, double newValue = 0.0);
    static std::vector<EntityId> values(const EntitySet* set);
 
    std::map<EntityId, EntityId>   owners_;
    std::map<EntityId, EntitySet>  owned_;
    std::map<EntityId, EntityId>   controllers_;
    std::map<EntityId, EntitySet>  controlled_;
    std::map<PairKey, EntitySet>   assignmentTargets_;
    std::map<PairKey, EntitySet>   assignmentSources_;
    std::map<EdgeKey, double>      relations_;
    std::map<PairKey, EntitySet>   relationTargets_;
    std::map<PairKey, EntitySet>   relationSources_;
    std::vector<SocialChangeEvent> events_;
    std::uint64_t                  nextSequence_ = 1;
};
 
}  // namespace eve::social