Package aQute.bnd.url

Class DefaultURLConnectionHandler

    • Method Summary

      All Methods Instance Methods Concrete Methods Deprecated Methods 
      Modifier and Type Method Description
      Reporter.SetLocation error​(java.lang.String format, java.lang.Object... args)
      Create an error.
      Reporter.SetLocation exception​(java.lang.Throwable t, java.lang.String format, java.lang.Object... args)
      Dedicated message for an exception.
      java.util.List<java.lang.String> getErrors()
      Return the errors.
      Report.Location getLocation​(java.lang.String msg)
      Return the errors for the given error or warning.
      java.util.List<java.lang.String> getWarnings()
      Return the warnings.
      void handle​(java.net.URLConnection connection)
      Not doing anything is perfect ok
      boolean isOk()
      Check if this report has any relevant errors that should make the run associated with this report invalid.
      boolean isPedantic()
      The provider of the reporter wants pedantic reporting, meaning every possible warning should be reported.
      boolean matches​(java.net.URL url)
      Verify if the URL matches one of our globs.
      protected boolean matches​(java.net.URLConnection connection)
      Convenience method to make it easier to verify connections
      void progress​(float progress, java.lang.String format, java.lang.Object... args)
      Deprecated.
      Use SLF4J Logger.info(aQute.libg.slf4j.GradleLogging.LIFECYCLE) instead.
      void setProperties​(java.util.Map<java.lang.String,​java.lang.String> map)
      Set the properties for this plugin.
      void setRegistry​(Registry registry)
      We are a @link RegistryPlugin for convenience to our subclasses.
      void setReporter​(Reporter processor)
      Set the current reporter.
      void trace​(java.lang.String format, java.lang.Object... args)
      Deprecated.
      Use SLF4J Logger.debug instead.
      Reporter.SetLocation warning​(java.lang.String format, java.lang.Object... args)
      Create a warning.
      • Methods inherited from class java.lang.Object

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

      • logger

        private static final org.slf4j.Logger logger
      • matchers

        private final java.util.Set<Glob> matchers
    • Constructor Detail

      • DefaultURLConnectionHandler

        public DefaultURLConnectionHandler()
    • Method Detail

      • handle

        public void handle​(java.net.URLConnection connection)
                    throws java.lang.Exception
        Not doing anything is perfect ok
        Specified by:
        handle in interface URLConnectionHandler
        Parameters:
        connection - The connection to modify
        Throws:
        java.lang.Exception
      • matches

        public boolean matches​(java.net.URL url)
        Verify if the URL matches one of our globs. If there are no globs, we always return true.
        Specified by:
        matches in interface URLConnectionHandler
        Parameters:
        url - the url to match
        Returns:
        true if matched, false if not.
      • matches

        protected boolean matches​(java.net.URLConnection connection)
        Convenience method to make it easier to verify connections
        Parameters:
        connection - The connection to match
        Returns:
        true if this connection should be handled.
      • setProperties

        public void setProperties​(java.util.Map<java.lang.String,​java.lang.String> map)
                           throws java.lang.Exception
        Set the properties for this plugin. Subclasses should call this method before they handle their own properties.
        Specified by:
        setProperties in interface Plugin
        Parameters:
        map - attributes and directives for this plugin's clause
        Throws:
        java.lang.Exception
      • setReporter

        public void setReporter​(Reporter processor)
        Description copied from interface: Plugin
        Set the current reporter. This is called at init time. This plugin should report all errors and warnings to this reporter.
        Specified by:
        setReporter in interface Plugin
      • getWarnings

        public java.util.List<java.lang.String> getWarnings()
        Description copied from interface: Report
        Return the warnings. This list must not be changed and may be immutable.
        Specified by:
        getWarnings in interface Report
        Returns:
        the warnings
      • getErrors

        public java.util.List<java.lang.String> getErrors()
        Description copied from interface: Report
        Return the errors. This list must not be changed and may be immutable.
        Specified by:
        getErrors in interface Report
        Returns:
        the errors
      • getLocation

        public Report.Location getLocation​(java.lang.String msg)
        Description copied from interface: Report
        Return the errors for the given error or warning. Can return null.
        Specified by:
        getLocation in interface Report
        Parameters:
        msg - The message
        Returns:
        null or the location of the message
      • isOk

        public boolean isOk()
        Description copied from interface: Report
        Check if this report has any relevant errors that should make the run associated with this report invalid. I.e. if this returns false then the run should be disregarded.
        Specified by:
        isOk in interface Report
        Returns:
        true if this run should be disregarded due to errors
      • error

        public Reporter.SetLocation error​(java.lang.String format,
                                          java.lang.Object... args)
        Description copied from interface: Reporter
        Create an error. Implementations must ensure that the given args are not prevented from garbage collecting. The args must have a proper toString method.
        Specified by:
        error in interface Reporter
        Parameters:
        format - The format of the error
        args - The arguments of the error
        Returns:
        a SetLocation to set the location
      • warning

        public Reporter.SetLocation warning​(java.lang.String format,
                                            java.lang.Object... args)
        Description copied from interface: Reporter
        Create a warning. Implementations must ensure that the given args are not prevented from garbage collecting. The args must have a proper toString method.
        Specified by:
        warning in interface Reporter
        Parameters:
        format - The format of the error
        args - The arguments of the error
        Returns:
        a SetLocation to set the location
      • trace

        @Deprecated
        public void trace​(java.lang.String format,
                          java.lang.Object... args)
        Deprecated.
        Use SLF4J Logger.debug instead.
        Description copied from interface: Reporter
        Create a warning. Implementations must ensure that the given args are not prevented from garbage collecting. The args must have a proper toString method.
        Specified by:
        trace in interface Reporter
        Parameters:
        format - The format of the error
        args - The arguments of the error
      • progress

        @Deprecated
        public void progress​(float progress,
                             java.lang.String format,
                             java.lang.Object... args)
        Deprecated.
        Use SLF4J Logger.info(aQute.libg.slf4j.GradleLogging.LIFECYCLE) instead.
        Description copied from interface: Reporter
        Create a warning. Implementations must ensure that the given args are not prevented from garbage collecting. The args must have a proper toString method.
        Specified by:
        progress in interface Reporter
        Parameters:
        progress - A value between 0 and 1 indicating the progress. 0 is starting and >=1 is done.
        format - The format of the error
        args - The arguments of the error
      • exception

        public Reporter.SetLocation exception​(java.lang.Throwable t,
                                              java.lang.String format,
                                              java.lang.Object... args)
        Description copied from interface: Reporter
        Dedicated message for an exception.
        Specified by:
        exception in interface Reporter
        Parameters:
        t - The exception
        format - The format of the message
        args - The arguments
      • isPedantic

        public boolean isPedantic()
        Description copied from interface: Reporter
        The provider of the reporter wants pedantic reporting, meaning every possible warning should be reported.
        Specified by:
        isPedantic in interface Reporter
        Returns:
        if this is a pedantic reporter.