Editing OpenSimulator Internals/Asset Connector (section)

== Simulator-Side Call Paths ==

=== Synchronous Get -- local asset ===

# Scene.AssetService.Get(id)
# IsHG(id) = false
# Check m_Cache.Get() -- return asset if hit, return null if negatively cached
# GetFromLocal(id) -- calls m_localConnector.Get(id) directly (inlined)
# On miss: m_Cache.CacheNegative(id)
# On hit: m_Cache.Cache(asset), return asset

=== Synchronous Get -- HyperGrid asset ===

# Scene.AssetService.Get(id)
# IsHG(id) = true
# GetForeign(id):
#* Util.ParseForeignAssetID(id) -- extracts URI and UUID string
#* Check m_Cache.GetCached(uuidstr)
#* GetFromLocal(uuidstr) -- check local store first
#* If not found locally: GetFromForeign(uuidstr, uri) via m_HGConnector
# Check m_AssetPerms.AllowedImport() -- return null if not permitted
# Store(asset) -- persist to local grid if permitted
# Return asset

=== Synchronous Get -- with known foreign service URI ===

# Get(id, ForeignAssetService, StoreOnLocalGrid)
# Check m_Cache.GetCached(id)
# GetFromLocal(id)
# On local miss: GetFromForeign(id, ForeignAssetService)
#* Check AssetPerms.AllowedImport() -- CacheNegative and return null if denied
#* StoreLocal(asset) if StoreOnLocalGrid=true
#* Cache(asset)
# On foreign miss: CacheNegative(id)

=== Asynchronous Get -- local ===

# Get(id, sender, callBack)
# Check m_Cache.GetFromMemory() -- invoke callback immediately if found or negatively cached
# UUID.Zero check -- invoke callback with null and return false
# Lock m_AssetHandlers:
#* If request already in-flight for this id: append callback to handler list, return
#* Otherwise: create handler list, add to m_AssetHandlers, enqueue id to m_localRequestsQueue
# AssetRequestProcessor dequeues, calls Get(id), notifies all handlers via FireAndForget

=== Asynchronous Get -- HyperGrid ===

# Get(id, ForeignAssetService, StoreOnLocalGrid, callBack)
# Same cache and deduplication logic as async local
# If ForeignAssetService is empty: enqueue to m_localRequestsQueue
# Otherwise: enqueue ForeignAssetServiceGetData struct to m_remoteRequestsQueue
# AssetRequestProcessor calls Get(id, ForeignAssetService, StoreOnLocalGrid)

----