Webservices-Lernprogramm über das Schreiben von Clientanwendungen › Schreiben von DSM-Webserviceclients › Erstellen und Verwalten von Verbindungen

Erstellen und Verwalten von Verbindungen

Um eine Webserviceverbindung zu erstellen und sich beim DSM-Webservice anzumelden, initialisieren Sie einen Webservice-Locator sowie, mithilfe von SOAP, eine Bindung zum Webservice. Sie müssen die URL des Webservice kennen. Bei einer standardmäßigen DSM-Installation lautet das URL-Format http://<Rechnername>/udsm_r11_webservice/mod_gsoap.dll unter Windows bzw. http://<Rechnername>/UDSM_R11_WebService unter Linux.

Verwenden Sie für Versionen nach R12.5 zusätzlich zur vorherigen URL den folgenden Webservice-Endpunkt:

Windows

http://<computername>/DSM_Webservice/mod_gsoap.dll

Linux

http://<computername>/DSM_WebService

Sie müssen den Webdienst-Locator initialisieren (a) und dann mit der Standort-URL des Webservices eine Verbindung zur Webdienst-API herstellen (b).

Beispiel 1: Einrichten der erforderlichen Verbindungsvariablen

//Diese Sitzungs-ID wird für alle Webdienst-Aufrufe verwendet.
//Sie wird bei der Webdienst-Anmeldung eingerichtet.
private String sessionId = "";	
//Diese UDSM-Webdienst-Objekte müssen erstellt werden.
//Webdienst-Aufrufe
//(a)
private DSMWebServiceAPIService wsAPIservice = null;
//(b)
public DSMWebServiceAPISoapBindingStub wsAPIconnector = null;
private String serviceLocation="";
private java.net.URL endpoint = new java.net.URL(serviceLocation);

Hinweis: Dieses Beispiel wird mit Version 1.2 von Apache Axis und JDK 1.5 generiert.

Beispiel 2: Erstellen der Webservice-Verbindung

//Erstellen des Dienst-Locator-Objekts. Dies ist obligatorisch.
wsAPIservice = new WebServiceAPIServiceLocator();
//Fortfahren, wenn das Dienst-Locator-Objekt erstellt wurde.
if (wsAPIservice != null)
{
	try
	{
		//Versuchen, das bindende Objekt zu erstellen, um 
		//die Bindung zum Webdienst mit der URI des Webdienst-Speicherorts herzustellen.
	     	wsAPIconnector= (WebServiceAPISoapBindingStub)
		wsAPIservice.getWebServiceAPIService(endpoint);
	}
	catch (Exception e)
	{
	     	throw e;
	}
}
else
{
	sessionId = "";
	return WEB_SERVICE_COULD_NOT_BE_INITIALISED;
}

Beachten Sie, dass Java-Webservice-Methoden Webservice-Ausnahmen ausgeben können, die erfasst und verarbeitet werden sollten.

Nachdem eine Verbindung hergestellt wurde, müssen Sie sich beim DSM-Webservice genauso wie beim DSM-Explorer anmelden. Die Methode "Login" sollte mit den Anmeldeinformationen eines gültigen DSM-Benutzers aufgerufen werden.

Beispiel 3: Anmelden beim DSM-Webservice

//Jetzt wird versucht, sich bei der neuen Webdienst-Verbindung anzumelden.
//Hierzu werden die Anmeldeinformationen eines Konfigurationsobjekts (hier nicht beschrieben) verwendet.
	try
	{
sessionId = wsAPIconnector.Login(    cfg.getUserName(),cfg.getPassword(),cfg.getManager() );
	}
	catch (Exception e)
	{
	     sessionId = "";
	     throw e;
	}
     	
	//Ist die Sitzungs-ID leer, konnte keine Sitzung gestartet werden.
	if(sessionId.equals(""))
	{
		return SESSION_COULD_NOT_BE_ESTABLISHED;
	}
	else
	{
		return RESULT_OK;
	}