Editing OpenSimulator Internals/Connector Architecture/Asset Connector (section)

== Simulator Side ==

=== RegionAssetConnectorModule ===

 OpenSim/Region/CoreModules/ServiceConnectorsOut/Asset/RegionAssetConnectorModule.cs

The single region module replacing LocalAssetServiceConnector, RemoteAssetServiceConnector, and HGAssetBroker as of 0.9.2. Implements ISharedRegionModule.

Acquires the asset cache in RegionLoaded(), not in AddRegion(). This is required because the cache module must be loaded first.

Two worker queues:
* m_localRequestsQueue -- for local (non-HG) asset requests, 2 threads, capacity 2000
* m_remoteRequestsQueue -- for HG asset requests, 2 threads, capacity 2000

Request deduplication via m_AssetHandlers dictionary -- multiple callers requesting the same ID share a single in-flight request.

IsHG(id) check: inspects the first character of the asset ID. If 'h' or 'H', the ID is an HTTP URI and the asset is foreign (HyperGrid). All other IDs are treated as local.

----

=== AssetServicesConnector ===

 OpenSim/Services/Connectors/Asset/AssetServicesConnector.cs

The remote connector used for non-HG asset requests. Makes HTTP calls to the ROBUST asset service.

URI pattern: m_ServerURI + "/assets/" + id

Store() assigns a UUID client-side before sending if the asset has no ID. Routing is determined by the ID, so the UUID must be assigned before the request is dispatched.

MaxAssetRequestConcurrency defaults to 8 -- limits parallel outbound GET requests.

----

=== HGAssetServiceConnector ===

 OpenSim/Services/Connectors/Asset/HGAssetServiceConnector.cs

Wraps multiple AssetServicesConnector instances, one per foreign grid URL. Connectors are pooled and expire after 60 seconds of inactivity.

IsHG(id) -- same first-character check as RegionAssetConnectorModule.

AssetsExistHandler grouping: groups requested IDs by server URL, queries each foreign server separately.

UpdateContent() and Delete() always return false -- foreign assets cannot be modified.

----