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

== ROBUST Side ==

=== AssetServiceConnector ===

 OpenSim/Server/Handlers/Asset/AssetServerConnector.cs

The connector loaded by ROBUST from [ServiceList]. Instantiates the asset service implementation and registers all HTTP handlers.

Config section defaults to "AssetService"; overridden by the configName argument from the connector string.

Required config:
* LocalServiceModule -- DLL:class of the IAssetService implementation; throws if missing

Optional config:

{| class="wikitable"
! Key !! Default !! Notes
|-
| AllowRemoteDelete || false || If false, remote DELETE requests always return false
|-
| AllowRemoteDeleteAllTypes || false || If true (and AllowRemoteDelete = true), all asset types can be deleted remotely. If false, only Maptile assets
|-
| RedirectURL || (none) || If set, 404 GET responses redirect to this URL instead
|}

Handlers registered:

{| class="wikitable"
! Handler !! Method !! Path
|-
| AssetServerGetHandler || GET || /assets
|-
| AssetServerPostHandler || POST || /assets
|-
| AssetServerDeleteHandler || DELETE || /assets
|-
| AssetsExistHandler || POST || /get_assets_exist
|}

All handlers except AssetsExistHandler receive an IServiceAuth instance. AssetsExistHandler has no auth.

Console commands registered:
* show asset <ID> -- displays metadata and first 80 bytes as hex
* delete asset <ID> -- deletes asset via IAssetService.Delete()
* dump asset <ID> -- writes raw asset data to a file named after the ID; refuses to overwrite existing files

----

=== AssetServerGetHandler ===

 OpenSim/Server/Handlers/Asset/AssetServerGetHandler.cs

Handles: GET /assets

URL patterns:

{| class="wikitable"
! Path !! Calls !! Response
|-
| /assets/{id} || IAssetService.Get(id) || XML-serialized AssetBase; Content-Type: text/xml
|-
| /assets/{id}/data || IAssetService.GetData(id) || Raw binary data; Content-Type: application/octet-stream
|-
| /assets/{id}/metadata || IAssetService.GetMetadata(id) || XML-serialized AssetMetadata; Content-Type: SLUtil.SLAssetTypeToContentType(type)
|}

404 handling: if RedirectURL is configured and the asset is not found, the response is an HTTP redirect to RedirectURL + original path rather than a 404. This allows chaining to a fallback asset server.

Unknown path segments (anything other than "data" or "metadata" as the second segment) return 400 Bad Request.

Note: the commented-out Content-Type line for the full asset GET shows the original intent was to use SLAssetTypeToContentType, but it was changed to always return "text/xml".

----

=== AssetServerPostHandler ===

 OpenSim/Server/Handlers/Asset/AssetServerPostHandler.cs

Handles: POST /assets

Two behaviors depending on whether an ID is present in the path:

{| class="wikitable"
! Path !! Behavior !! Calls !! Returns
|-
| POST /assets || Store new asset || IAssetService.Store(asset) || XML-serialized string (the assigned ID)
|-
| POST /assets/{id} || Update existing asset data || IAssetService.UpdateContent(id, asset.Data) || XML-serialized bool
|}

Request body: XML-serialized AssetBase in both cases. Returns 400 Bad Request if deserialization fails.

The update path (with ID) only uses asset.Data from the deserialized body -- the rest of the AssetBase fields are ignored.

----

=== AssetServerDeleteHandler ===

 OpenSim/Server/Handlers/Asset/AssetServerDeleteHandler.cs

Handles: DELETE /assets

AllowedRemoteDeleteTypes enum controls what can be deleted:

{| class="wikitable"
! Value !! Behavior
|-
| None || Always returns false; no delete attempted
|-
| MapTile || Fetches asset first; deletes only if AssetFlags.Maptile is set
|-
| All || Deletes any asset type
|}

Sequence:
# If allowedTypes == None: skip, return false
# Fetch asset via IAssetService.Get(id) -- if not found, return false
# If allowedTypes == All OR asset has Maptile flag: call IAssetService.Delete(id)
# Otherwise: log debug message and return false

Always returns XML-serialized bool.

----

=== AssetsExistHandler ===

 OpenSim/Server/Handlers/Asset/AssetsExistHandler.cs

Handles: POST /get_assets_exist

Request body: XML-serialized string[] of asset IDs.
Response: XML-serialized bool[] -- one entry per ID, true if the asset exists.

Calls IAssetService.AssetsExist(ids) directly. Returns 400 Bad Request if deserialization fails.

No auth -- AssetsExistHandler is constructed without an IServiceAuth argument.

----