Class SOAPClient


  • public class SOAPClient
    extends java.lang.Object
    Implementiert einen SOAP-Client (rpc/encoded). Diese Klasse sollte nicht direkt für die Kommunikation mit der DFN-PKI verwendet werden. Stattdessen sollte die Klasse DFNPKIClient verwendet werden.
    • Constructor Summary

      Constructors 
      Constructor Description
      SOAPClient​(java.lang.String targetNamespace, java.lang.String targetPackage)
      Konstruktor
    • Method Summary

      All Methods Static Methods Instance Methods Concrete Methods 
      Modifier and Type Method Description
      java.lang.Object doRequest​(java.lang.String methodName, java.lang.String[] paramNames, java.lang.Object[] paramValues)
      Führt die SOAP-Kommunikation durch.
      java.lang.String dumpDocument​(org.w3c.dom.Document document, boolean humanReadable)  
      static boolean isDebug()
      Informiert über die Einstellung für Debugging
      static void setDebug​(boolean debug)
      Stellt das globale Debugging ein.
      void setEndpoint​(java.net.URL endpoint)
      Setzt die Endpunkt-URL für die HTTP(S)-Kommunikation.
      void setSSLSocketFactory​(javax.net.ssl.SSLSocketFactory sslFactory)
      Setzt die Fabrik, in der Anschlüsse für die SSL-Verbindung gebaut werden.
      static void setTraceable​(SOAPTraceable traceable)
      Setzt eine Instanz an die Debugging-Informationen während der Kommunikation weitergegeben werden.
      • Methods inherited from class java.lang.Object

        clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
    • Constructor Detail

      • SOAPClient

        public SOAPClient​(java.lang.String targetNamespace,
                          java.lang.String targetPackage)
                   throws java.lang.Exception
        Konstruktor
        Parameters:
        targetNamespace - XML-Namensraum der Parameter-Elemente
        targetPackage - Name des Pakets, in dem sich komplexe Typen befinden
        Throws:
        java.lang.Exception - Fehlerweiterleitung
    • Method Detail

      • setDebug

        public static void setDebug​(boolean debug)
        Stellt das globale Debugging ein. Ist das Debugging aktiviert und kein SOAPTraceable Objekt angegeben, so werden die gesendeten und Empfangenen SOAP-Nachrichten auf STDOUT ausgegeben. Wenn ein SOAPTraceable Objekt angegeben wurde, erfolgt die Ausgabe nur darüber und nicht auf STDOUT.
        Parameters:
        debug - Debugging an/aus
      • isDebug

        public static boolean isDebug()
        Informiert über die Einstellung für Debugging
        Returns:
        Debugging an/aus?
      • setTraceable

        public static void setTraceable​(SOAPTraceable traceable)
        Setzt eine Instanz an die Debugging-Informationen während der Kommunikation weitergegeben werden.
        Parameters:
        traceable - Instanz die Debugging-Informationen empfängt
        See Also:
        setDebug(boolean)
      • setEndpoint

        public void setEndpoint​(java.net.URL endpoint)
        Setzt die Endpunkt-URL für die HTTP(S)-Kommunikation.
        Parameters:
        endpoint - URL des Endpunkts
      • setSSLSocketFactory

        public void setSSLSocketFactory​(javax.net.ssl.SSLSocketFactory sslFactory)
        Setzt die Fabrik, in der Anschlüsse für die SSL-Verbindung gebaut werden.
        Parameters:
        sslFactory - Fabrik für Anschlüsse
      • doRequest

        public java.lang.Object doRequest​(java.lang.String methodName,
                                          java.lang.String[] paramNames,
                                          java.lang.Object[] paramValues)
                                   throws java.lang.Exception
        Führt die SOAP-Kommunikation durch. Diese Methode sollte nicht direkt aufgerufen werden. Stattdessen sollten die Methoden aus den generierten Klassen im Paket Ade.dfncert.soap verwendet werden.
        Parameters:
        methodName - Name der Methode auf dem Server
        paramNames - Namen der Parameter
        paramValues - Werte für die Parameter
        Returns:
        RPC-Antwort als Java-Objekt
        Throws:
        java.lang.Exception - Fehlerweiterleitung
      • dumpDocument

        public java.lang.String dumpDocument​(org.w3c.dom.Document document,
                                             boolean humanReadable)
                                      throws java.lang.ClassNotFoundException,
                                             java.lang.InstantiationException,
                                             java.lang.IllegalAccessException,
                                             java.lang.ClassCastException
        Throws:
        java.lang.ClassNotFoundException
        java.lang.InstantiationException
        java.lang.IllegalAccessException
        java.lang.ClassCastException