Class Http

  • All Implemented Interfaces:
    java.lang.Cloneable, Condition

    public class Http
    extends ProjectComponent
    implements Condition
    Condition to wait for a HTTP request to succeed. Its attribute(s) are: url - the URL of the request. errorsBeginAt - number at which errors begin at; default=400. requestMethod - HTTP request method to use; GET, HEAD, etc. default=GET readTimeout - The read timeout in ms. default=0
    Since:
    Ant 1.5
    • Constructor Detail

      • Http

        public Http()
    • Method Detail

      • setUrl

        public void setUrl​(java.lang.String url)
        Set the url attribute
        Parameters:
        url - the url of the request
      • setErrorsBeginAt

        public void setErrorsBeginAt​(int errorsBeginAt)
        Set the errorsBeginAt attribute
        Parameters:
        errorsBeginAt - number at which errors begin at, default is 400
      • setRequestMethod

        public void setRequestMethod​(java.lang.String method)
        Sets the method to be used when issuing the HTTP request.
        Parameters:
        method - The HTTP request method to use. Valid values are the same as those accepted by the HttpURLConnection.setRequestMethod() method, such as "GET", "HEAD", "TRACE", etc. The default if not specified is "GET".
        Since:
        Ant 1.8.0
        See Also:
        HttpURLConnection.setRequestMethod(java.lang.String)
      • setFollowRedirects

        public void setFollowRedirects​(boolean f)
        Whether redirects sent by the server should be followed, defaults to true.
        Parameters:
        f - boolean
        Since:
        Ant 1.9.7
      • setReadTimeout

        public void setReadTimeout​(int t)
        Sets the read timeout. Any value < 0 will be ignored
        Parameters:
        t - the timeout value in milli seconds
        Since:
        Ant 1.10.6
        See Also:
        URLConnection.setReadTimeout(int)
      • eval

        public boolean eval()
                     throws BuildException
        Description copied from interface: Condition
        Is this condition true?
        Specified by:
        eval in interface Condition
        Returns:
        true if the HTTP request succeeds
        Throws:
        BuildException - if an error occurs