Connectors/de
From OpenSimulator
Contents |
Überblick
An der Verbindung von Simulatorcode mit einem Grid-Service sind bis zu 5 Komponenten beteiligt.
Diese sind:
| Component | Location | Description |
|---|---|---|
| Der Simulator Code selbst | OpenSimulator-Core oder ein Modul | Dies verweist zunächst auf den Dienst, um Daten abzurufen oder festzulegen. |
| Der Simulator service connector | OpenSim/Region/CoreModules/ServiceConnectorsOut (für ausgehende Verbindungen) und ServiceConnectorsIn (für eingehende Verbindungen) | Diese Anschlüsse Es gibt zwei Arten, lokal und remote. Die lokalen Anschlüsse direkt an den Service und verwendet werden, wenn Anrufer und Service im gleichen Prozess (wie in der Standalone-Konfiguration) sind. Die Remote-Anschlüsse verwenden, um die Service-Anschlüsse in OpenSim / Dienstleistungen / Connectors, um einen Anruf über das Netzwerk zu einem entfernten Prozess. |
| Der remote service connector | OpenSim/Services/Connectors | Diese machen die Arbeit der die Daten tatsächlich Rangier- und machen Sie den entsprechenden Anruf zu einem Remote-Datendienst. Diese sind nicht für die In-Prozess-Verbindungen verwendet. |
| Der remote service handler | OpenSim/Server/Handlers | Diese sind nicht für die In-Prozess-Verbindungen verwendet. Diese entpacken den Anruf von einem Simulator-Anschluss empfangen und geben sie nicht an den Dienst selbst. |
| Der Service | Jeder Haupt Service hat sein eigenes Paket (e.g. OpenSim/Services/AssetService). | Der Service-Leistungen tatsächlich den Anruf entgegen und gibt die Daten an den Anrufer, falls zutreffend. |
Beispiel
Werfen wir einen Blick auf den Asset-Service. Der Asset-Service-Connector ist als Scene.AssetService-Eigenschaft im Scene-Objekt verfügbar (direkte Verweise sind nicht immer verfügbar – manchmal muss der Connector über den Scene.RequestModuleInterface<Interface>()-Mechanismus angefordert werden).
Ein Aufrufer führt die Methode Scene.AssetService.Get() aus, um ein Asset synchron abzurufen.
Nehmen wir zunächst an, dass wir eine eigenständige Konfiguration ausführen, in der sich Simulator und Dienst im selben Prozess befinden. In diesem Fall geht der Aufruf des Simulators an LocalAssetServiceConnector.Get(). Dadurch wird zuerst der Cache überprüft, und wenn das Asset dort nicht gefunden wird, wird AssetService.Get() aufgerufen. Der AssetService ruft das Asset aus dem dauerhaften Speicher ab und übergibt es an den Simulatorcode zurück.
Nehmen wir nun an, dass wir in einer Grid-Konfiguration arbeiten, in der der Asset-Dienst auf einem anderen Computer ausgeführt wird. Wie zuvor ruft der Simulatorcode Scene.AssetService.Get() auf. Diesmal wird der Aufruf an RemoteAssetServiceConnector.Get() geleitet, das in diesem Fall von OpenSim/Services/Connectors/AssetServiceConnector erbt.
AssetServiceConnector.Get() generiert einen HTTP-Aufruf an http://yourassetserver/assets/assetId , wobei assetId die ID des angeforderten Assets ist.
Dies springt über das Netzwerk und wird von OpenSim/Server/Handlers/Asset/AssetServerConnector gehandhabt. Es verwendet seinen eigenen AssetServerGetHandler, um die HTTP-Anforderung zu entpacken und den AssetService aufzurufen, um die Daten abzurufen. Wenn das Asset gefunden wird, gibt es das Asset als XML zurück, bereit zum Entpacken durch den empfangenden AssetServiceConnector. Wenn das Asset fehlt, wird der HTTP-Statuscode 404 zurückgegeben.
Aufbau
Konnektoren werden in OpenSimulator-Konfigurationsdateien konfiguriert. Für Standalone befindet sich die Konfiguration in bin/config-include/Standalone.ini. Standalone-Benutzer müssen diese Datei nie ändern. Für Grid-Benutzer befindet sich die Konfiguration in bin/config-include/Grid.ini und GridCommon.ini. Im Grid-Fall ist GridCommon.ini (nach dem Kopieren aus GridCommon.ini.example) der Ort, an dem der Benutzer die URLs für jeden Grid-Dienst angibt.
Standalone
Schauen wir uns Standalone.ini an. Sie werden sehen, dass es einen Modulabschnitt mit den Zeilen gibt
[Module]
AssetServices = "LocalAssetServicesConnector" InventoryServices = "LocalInventoryServicesConnector" NeighbourServices = "LocalNeighbourServicesConnector" ...
Hier werden die Konnektoren für jeden Dienst angegeben. Wie Sie sehen können, ist der Asset-Dienst hier so angegeben, dass er LocalAssetServicesConnector verwendet.
Weiter unten sehen Sie den Abschnitt
[AssetService]
LocalServiceModule = "OpenSim.Services.AssetService.dll:AssetService"
Hier teilen wir OpenSimulator mit, welche DLL für den In-Process-Asset-Service geladen werden soll.
Grid
Vergleichen Sie dies mit Grid.ini.
[Module]
AssetServices = "RemoteAssetServicesConnector" InventoryServices = "RemoteXInventoryServicesConnector" GridServices = "RemoteGridServicesConnector" ...
In diesem Fall wird der Asset-Service-Connector als RemoteAssetServicesConnector-Klasse angegeben.
Der Abschnitt [AssetService] befindet sich nicht in dieser Datei, da wir eine Dienstklasse nicht direkt laden (da der Dienst remote gehostet wird). Stattdessen müssen wir die URL angeben, unter der der Asset-Dienst gefunden wird. Da dies für verschiedene Grid-Installationen unterschiedlich sein wird, befindet es sich stattdessen in der vom Benutzer konfigurierbaren GridCommon.ini-Datei.
[AssetService]
... ; ; Aendern Sie dies auf Ihren Grid-weiten Asset-Server ; AssetServerURI = " http://myassetserver.com:8003 "
Referenzen
Eine ausführlichere, aber etwas veraltete Dokumentation zu Diensten und Konnektoren finden Sie unter OpenSim Services and Service Connectors
Eine Zusammenfassung der Dienste finden Sie unter Services
