Package it.unimi.di.law.warc.filters

Class Filters

java.lang.Object

it.unimi.di.law.warc.filters.Filters

public class Filters
extends java.lang.Object

A collection of static methods to deal with filters.

Field Summary

Fields

Modifier and Type	Field	Description
static Filter<?>[]	EMPTY_ARRAY
static Filter	FALSE
static Filter	TRUE	The constantly true filter.

Constructor Summary

Constructors

Constructor	Description
Filters()

Method Summary

Modifier and Type	Method	Description
static Filter<FetchData>	adaptFilterHttpResponse2FetchData(Filter<org.apache.http.HttpResponse> original)	Adapts a filter with HttpResponse base type to a filter with FetchData base type.
static Filter<URIResponse>	adaptFilterHttpResponse2URIResponse(Filter<org.apache.http.HttpResponse> original)	Adapts a filter with HttpResponse base type to a filter with URIResponse base type.
static Filter<WarcRecord>	adaptFilterHttpResponse2WarcRecord(Filter<org.apache.http.HttpResponse> original)	Adapts a filter with HttpResponse base type to a filter with WarcRecord base type.
static Filter<java.net.URI>	adaptFilterString2URI(Filter<java.lang.String> original)	Adapts a filter with String base type to a filter with URI base type.
static Filter<FetchData>	adaptFilterURI2FetchData(Filter<java.net.URI> original)	Adapts a filter with URI base type to a filter with FetchData base type.
static Filter<HttpResponseWarcRecord>	adaptFilterURI2HttpResponseWarcRecord(Filter<java.net.URI> original)	Adapts a filter with URI base type to a filter with HttpResponseWarcRecord base type.
static Filter<Link>	adaptFilterURI2Link(Filter<java.net.URI> original)	Adapts a filter with URI base type to a filter with Link base type, applying the original filter to the target URI.
static AbstractFilter<URIResponse>	adaptFilterURI2URIResponse(Filter<java.net.URI> original)	Adapts a filter with URI base type to a filter with URIResponse base type.
static Filter<WarcRecord>	adaptFilterURI2WarcRecord(Filter<java.net.URI> original)	Adapts a filter with URI base type to a filter with WarcRecord base type.
static <T> Filter<T>	and(Filter<T>... f)	Produces the conjunction of the given filters.
static <T> Filter<T>[]	copy(Filter<T>... f)
static <T> Filter<T>	getFilterFromSpec(java.lang.String className, java.lang.String spec, java.lang.Class<T> tClass)	Creates a filter from a filter class name and an external form.
static <T> Filter<T>	not(Filter<T> filter)	Produces the negation of the given filter.
static <T> Filter<T>	or(Filter<T>... f)	Produces the disjunction of the given filters.
static java.lang.Class<? extends Filter<?>>[]	standardFilters()	Returns a list of the standard filter classes.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

EMPTY_ARRAY

public static final Filter<?>[] EMPTY_ARRAY

TRUE

public static Filter TRUE

The constantly true filter.

FALSE

public static Filter FALSE

Constructor Detail

Filters

public Filters()

Method Detail

and

@SafeVarargs
public static <T> Filter<T> and(Filter<T>... f)

Produces the conjunction of the given filters.

Type Parameters:

T - the type of objects that the filters deal with.

Parameters:

f - the filters.

Returns:

the conjunction.

or

@SafeVarargs
public static <T> Filter<T> or(Filter<T>... f)

Produces the disjunction of the given filters.

Type Parameters:

T - the type of objects that the filters deal with.

Parameters:

f - the filters.

Returns:

the disjunction.

not

public static <T> Filter<T> not(Filter<T> filter)

Produces the negation of the given filter.

Type Parameters:

T - the type of objects that the filter deal with.

Parameters:

filter - the filter.

Returns:

the negation of the given filter.

getFilterFromSpec

public static <T> Filter<T> getFilterFromSpec(java.lang.String className,
                                              java.lang.String spec,
                                              java.lang.Class<T> tClass)
                                       throws ParseException

Creates a filter from a filter class name and an external form.

Parameters:

className - the name of a filter class; it may either be a single class name (in which case it will be qualified with Filter.FILTER_PACKAGE_NAME) or a fully qualified classname.

spec - the specification from which the filter will be created, using the valueOf(String) method (see Filter).

tClass - the base class of the filter that is desired: it should coincide with T; if the base type D of the filter is wrong, it will try to adapt it by using a static method in the Filters class whose signature is

public static Filter<T> adaptD2T(Filter<D>)

.

Returns:

the filter.

Throws:

ParseException

adaptFilterString2URI

public static Filter<java.net.URI> adaptFilterString2URI(Filter<java.lang.String> original)

Adapts a filter with String base type to a filter with URI base type. For testing purposes only.

Parameters:

original - the original filter.

Returns:

the adapted filter.

adaptFilterURI2HttpResponseWarcRecord

public static Filter<HttpResponseWarcRecord> adaptFilterURI2HttpResponseWarcRecord(Filter<java.net.URI> original)

Adapts a filter with URI base type to a filter with HttpResponseWarcRecord base type.

Parameters:

original - the original filter.

Returns:

the adapted filter.

adaptFilterURI2Link

public static Filter<Link> adaptFilterURI2Link(Filter<java.net.URI> original)

Adapts a filter with URI base type to a filter with Link base type, applying the original filter to the target URI.

Parameters:

original - the original filter.

Returns:

the adapted filter.

adaptFilterURI2WarcRecord

public static Filter<WarcRecord> adaptFilterURI2WarcRecord(Filter<java.net.URI> original)

Adapts a filter with URI base type to a filter with WarcRecord base type.

Parameters:

original - the original filter.

Returns:

the adapted filter.

adaptFilterHttpResponse2WarcRecord

public static Filter<WarcRecord> adaptFilterHttpResponse2WarcRecord(Filter<org.apache.http.HttpResponse> original)

Adapts a filter with HttpResponse base type to a filter with WarcRecord base type.

Parameters:

original - the original filter.

Returns:

the adapted filter.

adaptFilterHttpResponse2FetchData

public static Filter<FetchData> adaptFilterHttpResponse2FetchData(Filter<org.apache.http.HttpResponse> original)

Adapts a filter with HttpResponse base type to a filter with FetchData base type.

Parameters:

original - the original filter.

Returns:

the adapted filter.

adaptFilterURI2FetchData

public static Filter<FetchData> adaptFilterURI2FetchData(Filter<java.net.URI> original)

Adapts a filter with URI base type to a filter with FetchData base type.

Parameters:

original - the original filter.

Returns:

the adapted filter.

adaptFilterHttpResponse2URIResponse

public static Filter<URIResponse> adaptFilterHttpResponse2URIResponse(Filter<org.apache.http.HttpResponse> original)

Adapts a filter with HttpResponse base type to a filter with URIResponse base type.

Parameters:

original - the original filter.

Returns:

the adapted filter.

adaptFilterURI2URIResponse

public static AbstractFilter<URIResponse> adaptFilterURI2URIResponse(Filter<java.net.URI> original)

Adapts a filter with URI base type to a filter with URIResponse base type.

Parameters:

original - the original filter.

Returns:

the adapted filter.

standardFilters

public static java.lang.Class<? extends Filter<?>>[] standardFilters()

Returns a list of the standard filter classes.

Returns:

a list of standard filter classes.

copy

@SafeVarargs
public static <T> Filter<T>[] copy(Filter<T>... f)