Function GetMapper

internal/mapper/mapper.go:1097–1153

Get the mapper if it exists, otherwises generates a new map from the roomId

(roomId int, forceRefresh ...bool)

// Get the mapper if it exists, otherwises generates a new map from the roomId
func GetMapper(roomId int, forceRefresh ...bool) *mapper {

	var cachedMap *mapper = nil
	// Check the room-to-cache lookup

	if zoneName, ok := roomIdToMapperCache[roomId]; ok {
		cachedMap = mapperZoneCache[zoneName]
		if len(forceRefresh) == 0 || !forceRefresh[0] {
			return cachedMap
		}
	}

	// We are force rebuilding (or building if not exists) at this point

	// Since we will be regenerating the whole map,
	// lets clear out any roomId's tracked for this room.
	// That way if something has changed, such as a room moving to a different map,
	// It won't point to here.
	if cachedMap != nil {
		for crawledRoomId, _ := range cachedMap.crawledRooms {
			delete(roomIdToMapperCache, crawledRoomId)
		}
	}

	room := rooms.LoadRoom(roomId)
	if room == nil {
		return nil
	}

	// Track the time it takes
	tStart := time.Now()

	// multiple maps MIGHT exist within a zone, so use the zone+maps root to track it uniquely.
	// We could just use the roomId, but this makes debugging easier.
	zoneName := room.Zone + `-` + strconv.Itoa(roomId)

	m := NewMapper(roomId)
	if m == nil {
		mudlog.Error("GetMapper", "error", "Could not generate a mapper for RoomId", "RoomId", roomId)
		return nil
	}
	m.Start()

	mudlog.Info("New Mapper", "zone", zoneName, "size", len(m.crawledRooms), "time taken", time.Since(tStart))

	roomIdToMapperCache[roomId] = zoneName

	for _, crawledRoomId := range m.CrawledRoomIds() {
		if _, ok := roomIdToMapperCache[crawledRoomId]; !ok {
			roomIdToMapperCache[crawledRoomId] = zoneName
		}
	}

	mapperZoneCache[zoneName] = m

	return m
}