MojangAPI.h

Go to the documentation of this file.

 
// MojangAPI.h
 
// Declares the cMojangAPI class representing the various API points provided by Mojang's webservices, and a cache for their results
 
 
 
 
 
#pragma once
 
#include <time.h>
 
#include "UUID.h"
 
 
 
 
 
// fwd: ../RankManager.h"
class cRankManager;
 
namespace Json
{
    class Value;
}
 
 
 
class cSettingsRepositoryInterface;
 
// tolua_begin
class cMojangAPI
{
public:
    // tolua_end
 
    cMojangAPI(void);
    ~cMojangAPI();
 
    void Start(cSettingsRepositoryInterface & a_Settings, bool a_ShouldAuth);
 
    cUUID GetUUIDFromPlayerName(const AString & a_PlayerName, bool a_UseOnlyCached = false);
 
    AString GetPlayerNameFromUUID(const cUUID & a_UUID, bool a_UseOnlyCached = false);
 
    std::vector<cUUID> GetUUIDsFromPlayerNames(const AStringVector & a_PlayerName, bool a_UseOnlyCached = false);
 
    void AddPlayerNameToUUIDMapping(const AString & a_PlayerName, const cUUID & a_UUID);
 
    void AddPlayerProfile(const AString & a_PlayerName, const cUUID & a_UUID, const Json::Value & a_Properties);
 
    void SetRankManager(cRankManager * a_RankManager) { m_RankMgr = a_RankManager; }
 
protected:
    class cUpdateThread;
 
 
    struct sProfile
    {
        AString m_PlayerName;         // Case-correct playername
        cUUID   m_UUID;               // Player UUID
        AString m_Textures;           // The Textures field of the profile properties
        AString m_TexturesSignature;  // The signature of the Textures field of the profile properties
        Int64   m_DateTime;           // UNIXtime of the profile lookup
 
        sProfile(void) :
            m_PlayerName(),
            m_UUID(),
            m_Textures(),
            m_TexturesSignature(),
            m_DateTime(time(nullptr))
        {
        }
 
        sProfile(
            const AString & a_PlayerName,
            const cUUID & a_UUID,
            const AString & a_Textures,
            const AString & a_TexturesSignature,
            Int64 a_DateTime
        ) :
            m_PlayerName(a_PlayerName),
            m_UUID(a_UUID),
            m_Textures(a_Textures),
            m_TexturesSignature(a_TexturesSignature),
            m_DateTime(a_DateTime)
        {
        }
 
        sProfile(
            const AString & a_PlayerName,
            const cUUID & a_UUID,
            const Json::Value & a_Properties,
            Int64 a_DateTime
        );
    };
    using cProfileMap = std::map<AString, sProfile>;
    using cUUIDProfileMap = std::map<cUUID, sProfile>;
 
 
    AString m_NameToUUIDUrl;
 
    AString m_UUIDToProfileUrl;
 
    cProfileMap m_NameToUUID;
 
    cCriticalSection m_CSNameToUUID;
 
    cUUIDProfileMap m_UUIDToName;
 
    cCriticalSection m_CSUUIDToName;
 
    cUUIDProfileMap m_UUIDToProfile;
 
    cCriticalSection m_CSUUIDToProfile;
 
    cRankManager * m_RankMgr;
 
    cCriticalSection m_CSRankMgr;
 
    std::shared_ptr<cUpdateThread> m_UpdateThread;
 
 
    void LoadCachesFromDisk(void);
 
    void SaveCachesToDisk(void);
 
    void CacheNamesToUUIDs(const AStringVector & a_PlayerNames);
 
    void QueryNamesToUUIDs(AStringVector & a_PlayerNames);
 
    void CacheUUIDToProfile(const cUUID & a_UUID);
 
    void QueryUUIDToProfile(const cUUID & a_UUID);
 
    void NotifyNameUUID(const AString & a_PlayerName, const cUUID & a_PlayerUUID);
 
    void Update(void);
} ;  // tolua_export