Module:BuildingDataProxy: Difference between revisions
From Against the Storm Official Wiki
(Creating to lazily load and federate queries out to building data models) |
(Updating to new data model!) |
||
Line 8: | Line 8: | ||
-- Just store the strings, and we'll load lazily at runtime as needed. The order of this array controls the load order of data models. | -- Just store the strings, and we'll load lazily at runtime as needed. The order of this array controls the load order of data models. | ||
local DATA_MODELS_NAMES_ARRAY = { | local DATA_MODELS_NAMES_ARRAY = { | ||
"Module: | "Module:WorkshopsData", | ||
"Module: | "Module:InstitutionsData", | ||
"Module: | "Module:FarmsData", | ||
"Module:GatheringData", | "Module:GatheringData", | ||
"Module:FishingData", | "Module:FishingData", | ||
"Module:RainCollectorsData", | "Module:RainCollectorsData", | ||
"Module: | "Module:CampsData", | ||
"Module:HearthsData", | "Module:HearthsData", | ||
"Module:WarehousesData", | "Module:WarehousesData", | ||
Line 32: | Line 32: | ||
local LOOKUP_DATA_MODEL_FUNCTIONAL_TYPES = { | local LOOKUP_DATA_MODEL_FUNCTIONAL_TYPES = { | ||
["Module: | ["Module:CampsData"] = "Gathering Camp", | ||
["Module:FarmFieldsData"] = "Farm", | ["Module:FarmFieldsData"] = "Farm", | ||
["Module: | ["Module:FarmsData"] = "Farm", | ||
["Module:FishingData"] = "Fishing Hut", | ["Module:FishingData"] = "Fishing Hut", | ||
["Module:GatheringData"] = "Gathering Camp", | ["Module:GatheringData"] = "Gathering Camp", | ||
["Module:HearthsData"] = "Hearth", | ["Module:HearthsData"] = "Hearth", | ||
["Module: | ["Module:InstitutionsData"] = "Service Building", | ||
["Module:RainCollectorsData"] = "Extraction Building", | ["Module:RainCollectorsData"] = "Extraction Building", | ||
["Module:WarehousesData"] = "Storage Building", | ["Module:WarehousesData"] = "Storage Building", | ||
["Module: | ["Module:WorkshopsData"] = "Production Building", | ||
} | } | ||
Latest revision as of 01:31, 30 October 2024
Documentation for this module may be created at Module:BuildingDataProxy/doc
---@module BuildingDataProxy local BuildingDataProxy = {} --region Dependencies -- Just store the strings, and we'll load lazily at runtime as needed. The order of this array controls the load order of data models. local DATA_MODELS_NAMES_ARRAY = { "Module:WorkshopsData", "Module:InstitutionsData", "Module:FarmsData", "Module:GatheringData", "Module:FishingData", "Module:RainCollectorsData", "Module:CampsData", "Module:HearthsData", "Module:WarehousesData", "Module:FarmFieldsData", } local DataModelsCache = {} for _, moduleName in pairs(DATA_MODELS_NAMES_ARRAY) do DataModelsCache[moduleName] = nil end --endregion --region Private constants local LOOKUP_DATA_MODEL_FUNCTIONAL_TYPES = { ["Module:CampsData"] = "Gathering Camp", ["Module:FarmFieldsData"] = "Farm", ["Module:FarmsData"] = "Farm", ["Module:FishingData"] = "Fishing Hut", ["Module:GatheringData"] = "Gathering Camp", ["Module:HearthsData"] = "Hearth", ["Module:InstitutionsData"] = "Service Building", ["Module:RainCollectorsData"] = "Extraction Building", ["Module:WarehousesData"] = "Storage Building", ["Module:WorkshopsData"] = "Production Building", } --endregion --region Private member variables --endregion --region Private methods local function cacheModel(modelName) if DataModelsCache[modelName] == nil then DataModelsCache[modelName] = require(modelName) end return DataModelsCache[modelName] end ---fetchFromFunction ---Loops through the data models, calling the provided function on each in turn using the specified parameter (name or ID) until one of them returns a result. Returns nil if no data models found the specified name or ID. --- ---@param functionName string the name of the function to call ---@param parameter string name or ID ---@return ? whatever the function returns local function federateFunction(functionName, parameter) for _, modelName in ipairs(DATA_MODELS_NAMES_ARRAY) do local DataModel = cacheModel(modelName) local result = DataModel[functionName](DataModel, parameter) -- If we found it, return, otherwise keep going if result then return result end end -- nil if not found return nil end --endregion --region Public building interface -- getID(displayName) -- getCategory(id) -- getCityScore(id) -- getConstructionCosts(id) -- returns { [goodName] = stack size } -- getConstructionTime(id) -- getDescription(id) -- getIcon(id) -- isMovable(id) -- getName(id) -- getNumberOfWorkplaces(id) -- getSize(id) -- returns string "X x Y" -- getStorage(id) function BuildingDataProxy.getID(displayName) return federateFunction("getID", displayName) end function BuildingDataProxy.getCategory(id) return federateFunction("getCategory", id) end function BuildingDataProxy.getCityScore(id) return federateFunction("getCityScore", id) end function BuildingDataProxy.getConstructionCosts(id) return federateFunction("getConstructionCosts", id) end function BuildingDataProxy.getConstructionTime(id) return federateFunction("getConstructionTime", id) end function BuildingDataProxy.getDescription(id) return federateFunction("getDescription", id) end function BuildingDataProxy.getIcon(id) return federateFunction("getIcon", id) end function BuildingDataProxy.isMovable(id) return federateFunction("isMovable", id) end function BuildingDataProxy.getName(id) return federateFunction("getName", id) end function BuildingDataProxy.getNumberOfWorkplaces(id) return federateFunction("getNumberOfWorkplaces", id) end function BuildingDataProxy.getSize(id) return federateFunction("getSize", id) end function BuildingDataProxy.getStorage(id) return federateFunction("getStorage", id) end --endregion --region Public methods ---getFunctionalType ---Looks up a descriptive "functional type" for the specified building, based on the data model in which it was found. Used to augment the category with more information. Returns nil if the building is not found. --- ---@param id string the ID of the building ---@return string describing the functional type of the building function BuildingDataProxy.getFunctionalType(id) for _, modelName in ipairs(DATA_MODELS_NAMES_ARRAY) do local DataModel = cacheModel(modelName) local validName = DataModel:getName(id) if validName then return LOOKUP_DATA_MODEL_FUNCTIONAL_TYPES[modelName] end end return nil end --endregion return BuildingDataProxy