Uploaded image for project: 'Maven Javadoc Plugin'
  1. Maven Javadoc Plugin
  2. MJAVADOC-565

Make proxy configuration properly work for both HTTP and HTTPS

    XMLWordPrintableJSON

    Details

    • Type: Improvement
    • Status: Closed
    • Priority: Major
    • Resolution: Fixed
    • Affects Version/s: 3.0.1
    • Fix Version/s: 3.1.0
    • Component/s: None
    • Labels:
      None

      Description

      There seems to be some disagreement about how to configure web proxy servers.

      Maven seems to think that the "protocol" element specifies the protocol to use when talking to the web proxy server, and thus allows only one proxy to be configured in settings.xml.  (Or rather, only the first configured proxy is used.)  That's not the way proxy servers work.

      The JDK configures web proxy servers based on the protocol that's being proxied.

      For example, when using a <link> to access the JDK javadocs, https is needed.  The maven-javadoc-plugin invokes the external javadoc command with these arguments:

      -J-Dhttp.proxySet=true -J-Dhttp.proxyHost=<proxy-host> -J-Dhttp.proxyPort=<proxy-port>

      That only configures the proxy for the http protocol, not the https protocol, and thus the linked resource can not be accessed.  To configure the proxy to be used for the https protocol, the following arguments are needed:

      -J-Dhttps.proxySet=true -J-Dhttps.proxyHost=<proxy-host> -J-Dhttps.proxyPort=<proxy-port>

       

        Attachments

          Issue Links

            Activity

              People

              • Assignee:
                michael-o Michael Osipov
                Reporter:
                bshannon Bill Shannon
              • Votes:
                0 Vote for this issue
                Watchers:
                5 Start watching this issue

                Dates

                • Created:
                  Updated:
                  Resolved: