Class DnsHostMatcher

  • All Implemented Interfaces:
    ConfigurationObject, URIMatcher

    public class DnsHostMatcher
    extends HostMatcher
    Allows to check that a given URL matches a DNS address (textual format). The actual comparison is performed on numerical IP addresses. The configured DNS host address is transformed into numerical IP addresses during application startup. The urls to be compared are transformed during the print processing.

    Example 1: Accept any www.camptocamp.com url

    
         - !dnsMatch
           host: www.camptocamp.com
     

    Example 2: Accept any www.camptocamp.com url (port == -1 accepts any port)

    
         - !dnsMatch
           host: www.camptocamp.com
           port: -1
     

    Example 3: Accept any www.camptocamp.com url on port 80 only

    
         - !dnsMatch
           host: www.camptocamp.com
           port: 80
     
    Example 4: Accept www.camptocamp.com urls with paths that start with /print/.

    If the regular expression give does not start with / then it will be added because all paths start with /

    
         - !dnsMatch
           host: www.camptocamp.com
           pathRegex: /print/.+
     
    [[examples=http_processors]]
    • Constructor Detail

      • DnsHostMatcher

        public DnsHostMatcher()
    • Method Detail

      • tryOverrideValidation

        public final java.util.Optional<java.lang.Boolean> tryOverrideValidation​(MatchInfo matchInfo)
                                                                          throws java.net.SocketException,
                                                                                 java.net.UnknownHostException,
                                                                                 java.net.MalformedURLException
        Check the given URI to see if it matches.
        Specified by:
        tryOverrideValidation in class HostMatcher
        Parameters:
        matchInfo - the matchInfo to validate.
        Returns:
        True if it matches.
        Throws:
        java.net.SocketException
        java.net.UnknownHostException
        java.net.MalformedURLException
      • validate

        public final void validate​(java.util.List<java.lang.Throwable> validationErrors,
                                   Configuration configuration)
        Description copied from interface: ConfigurationObject
        validate that the configuration was correct.
        Parameters:
        validationErrors - a list to add any detected errors to.
        configuration - the containing configuration
      • setHost

        public final void setHost​(java.lang.String host)
                           throws java.net.UnknownHostException
        Set the host.
        Parameters:
        host - the host
        Throws:
        java.net.UnknownHostException
      • equals

        public boolean equals​(java.lang.Object obj)
        Overrides:
        equals in class HostMatcher