Interface IDVDV2ServerConnectionParamsBuilderIntern

Mittels des DVDV2ServerConnectionParamsBuilder werden die Verbindungsparameter zum DVDV2-Server festgelegt und eine Instanz des von DVDV2ServerConnectionParams erstellt.

Namespace: Dvdv.Api.Manager

Assembly: Dvdv.dll

Syntax

public interface IDVDV2ServerConnectionParamsBuilderIntern

Methods

Build()

Erstellen der Instanz mit den Verbindungsparametern

Declaration

IDVDV2ServerConnectionParams Build()

Returns

Type	Description
IDVDV2ServerConnectionParams	die erzeugte Instanz mit den Verbindungsparametern

Exceptions

Type	Condition
DVDVConfigurationException	wird geworfen wenn Parameter fehlen

SetBaseUrl(Uri)

Setzen der Backend-URL. TODO: Failover Doku umziehen!! Da ein Failover umgesetzt ist, können hier mehrere Backend URLs angegeben werden. Es wird zunächst versucht, die erste URL zu erreichen. Ist dies nicht möglich, dann werden die weiterhin angegebenen URLs in der angegebenen Reihenfolge als Backup für den Failover verwendet. In regelmäßigen Abständen werden dann versucht, aif die derzeit nicht erreichbaren URLs zurück zu schwenken.

Declaration

IDVDV2ServerConnectionParamsBuilderIntern SetBaseUrl(Uri baseUrl)

Parameters

Type	Name	Description
Uri	baseUrl	die Backend-URL

Returns

Type	Description
IDVDV2ServerConnectionParamsBuilderIntern	den Builder

Exceptions

Type	Condition
ArgumentException	wird geworfen, wenn der übermittelte Wert ungültig ist
ArgumentNullException	wird geworfen, wenn der übermittelte Wert null ist

SetProxy(IWebProxy)

Optionales Setzen eines Web-Proxies

Declaration

IDVDV2ServerConnectionParamsBuilderIntern SetProxy(IWebProxy webProxy)

Parameters

Type	Name	Description
IWebProxy	webProxy	den Proxy

Returns

Type	Description
IDVDV2ServerConnectionParamsBuilderIntern	den Builder

SetRemoteCertificateValidationCallback(RemoteCertificateValidationCallback)

Setzt eine Methode ein, die bei einer Zertifikatprüfung des SSL-Serverzertifikates bei einem Schnittstellenzugriff aufgerufen wird und ermöglicht die Einflussnahme auf das Prüfergebnis.

Diese Methode ist vom Typ RemoteCertificateValidationCallback und bietet die folgenden Parameter: "sender" Ermitteln des Senders des HTTP-Requests / "certificate" Ermitteln des SSL-Serverzertifikates des angefragten HTTP-Endpunktes / "chain" Ermitteln der Zertifikatkette des SSL-Serverzertifikates des angefragten HTTP-Endpunktes / "sslPolicyErrors" Ermitteln der Prüffehler bei der standardmäßigen Prüfung des SSL-Serverzertifikates, bei (sslPolicyErrors == SslPolicyErrors.None) würde ohne die Registrierung einer Callback-Methode "true" zurückgegeben. / Der Rückgabewert ist das Ergebnis der Zertifikatprüfung. Das Ergebnis der Callback-Methode überschreibt dabei das Ergebnis der Standardprüfung. Damit ist es z.B. möglich selbstsignierte Zertifikate zu akzeptieren, ohne sie in den Zertifikat-Store des Computers zu übernehmen.

Declaration

IDVDV2ServerConnectionParamsBuilderIntern SetRemoteCertificateValidationCallback(RemoteCertificateValidationCallback remoteCertificateValidationCallback)

Parameters

Type	Name	Description
RemoteCertificateValidationCallback	remoteCertificateValidationCallback	die Methode zur Zertifikatprüfung

Returns

Type	Description
IDVDV2ServerConnectionParamsBuilderIntern

SetRequestTimeout(TimeSpan)

Setzen des Timeouts bei der Durchführung der DVDV-Anfrage

Declaration

IDVDV2ServerConnectionParamsBuilderIntern SetRequestTimeout(TimeSpan requestTimeout)

Parameters

Type	Name	Description
TimeSpan	requestTimeout	den zu verwendenen Timeout

Returns

Type	Description
IDVDV2ServerConnectionParamsBuilderIntern	den Builder