Package org.mapfish.print.processor.http.matcher

Class DnsHostMatcher

java.lang.Object

org.mapfish.print.processor.http.matcher.AbstractMatcher

org.mapfish.print.processor.http.matcher.HostMatcher

org.mapfish.print.processor.http.matcher.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]]

Field Summary

Fields inherited from class org.mapfish.print.processor.http.matcher.HostMatcher

pathRegex, port

Constructor Summary

Constructors

Constructor	Description
DnsHostMatcher()

Method Summary

Modifier and Type	Method	Description
boolean	equals(Object obj)
int	hashCode()
final void	setHost(String host)	Set the host.
String	toString()
final Optional<Boolean>	tryOverrideValidation(MatchInfo matchInfo)	Check the given URI to see if it matches.
final void	validate(List<Throwable> validationErrors, Configuration configuration)	validate that the configuration was correct.

Methods inherited from class org.mapfish.print.processor.http.matcher.HostMatcher

matches, setPathRegex, setPort

Methods inherited from class org.mapfish.print.processor.http.matcher.AbstractMatcher

isReject, setReject

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Details

DnsHostMatcher

public DnsHostMatcher()

Method Details

tryOverrideValidation

public final Optional<Boolean> tryOverrideValidation(MatchInfo matchInfo)
                                              throws SocketException,
UnknownHostException,
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:

SocketException

UnknownHostException

MalformedURLException

validate

public final void validate(List<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(String host)
                   throws UnknownHostException

Set the host.

Parameters:

host - the host

Throws:

UnknownHostException

toString

public String toString()

Specified by:

toString in class HostMatcher

hashCode

public int hashCode()

Overrides:

hashCode in class HostMatcher

equals

public boolean equals(Object obj)

Overrides:

equals in class HostMatcher