Package nl.vpro.util

Class URLResource<T>

java.lang.Object

nl.vpro.util.URLResource<T>

All Implemented Interfaces:

Supplier<T>, URLResourceMXBean

public class URLResource<T>
extends Object
implements URLResourceMXBean, Supplier<T>

A simple http client wrapping exactly one external resource, keeping track of cache headers.

Since:

0.37

Author:

Michiel Meeuwissen

Field Summary

Fields

Modifier and Type	Field	Description
static Function<InputStream,Map<String,String>>	MAP
static Function<InputStream,Properties>	PROPERTIES

Constructor Summary

Constructors

Constructor	Description
URLResource(URI url, Function<InputStream,T> reader, Consumer<T>... callbacks)
URLResource(URI url, Function<InputStream,T> reader, T empty, Consumer<T>... callbacks)

Method Summary

Modifier and Type	Method	Description
static <S> Function<InputStream,List<S>>	beansFromProperties(Function<String,S> constructor)
static <S> URLResource<List<S>>	beansFromProperties(Function<String,S> constructor, URI url, Consumer<List<S>>... callbacks)
void	callBack()
void	expire()
T	get()	Returns the supplied value backed by the getUrl().
String	getAccept()
long	getChangesCount()
long	getCheckedCount()
@MonotonicNonNull Integer	getCode()	The HTTP status code on the last invocation of get()
Duration	getConnectTimeout()
Duration	getErrorCache()
long	getErrorCount()
Instant	getExpires()
Instant	getLastLoad()
Instant	getLastModified()
Instant	getLastTry()
Duration	getMaxAge()
Duration	getMinAge()
long	getNotCheckedCount()
long	getNotModifiedCount()
long	getOkCount()
Duration	getReadTimeout()
URI	getUrl()
boolean	isAsync()
static URLResource<Map<String,String>>	map(URI url, Consumer<Map<String,String>>... callbacks)
static URLResource<Properties>	properties(URI url, Consumer<Properties>... callbacks)
void	setAccept(String accept)
URLResource<T>	setAsync(boolean async)
URLResource<T>	setCallbacks(Consumer<T>... callbacks)
void	setConnectTimeout(Duration connectTimeout)
URLResource<T>	setErrorCache(Duration errorCache)
URLResource<T>	setMaxAge(Duration maxAge)
URLResource<T>	setMinAge(Duration minAge)
void	setReadTimeout(Duration readTimeout)
String	toString()

Methods inherited from class java.lang.Object

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

Field Detail

PROPERTIES

public static final Function<InputStream,Properties> PROPERTIES

MAP

public static final Function<InputStream,Map<String,String>> MAP

Constructor Detail

URLResource

@SafeVarargs
public URLResource(URI url,
                   Function<InputStream,T> reader,
                   T empty,
                   Consumer<T>... callbacks)

URLResource

@SafeVarargs
public URLResource(URI url,
                   Function<InputStream,T> reader,
                   Consumer<T>... callbacks)

Method Detail

properties

@SafeVarargs
public static URLResource<Properties> properties(URI url,
                                                 Consumer<Properties>... callbacks)

map

@SafeVarargs
public static URLResource<Map<String,String>> map(URI url,
                                                        Consumer<Map<String,String>>... callbacks)

beansFromProperties

@SafeVarargs
public static <S> URLResource<List<S>> beansFromProperties(Function<String,S> constructor,
                                                           URI url,
                                                           Consumer<List<S>>... callbacks)

get

public T get()

Returns the supplied value backed by the getUrl(). In case this is isAsync() then this may (temporary) return the specified empty value.

Specified by:

get in interface Supplier<T>

callBack

public void callBack()

expire

public void expire()

Specified by:

expire in interface URLResourceMXBean

setMaxAge

public URLResource<T> setMaxAge(Duration maxAge)

setMinAge

public URLResource<T> setMinAge(Duration minAge)

setErrorCache

public URLResource<T> setErrorCache(Duration errorCache)

setCallbacks

@SafeVarargs
public final URLResource<T> setCallbacks(Consumer<T>... callbacks)

setAsync

public URLResource<T> setAsync(boolean async)

toString

public String toString()

Overrides:

toString in class Object

beansFromProperties

public static <S> Function<InputStream,List<S>> beansFromProperties(Function<String,S> constructor)

getLastLoad

public Instant getLastLoad()

getLastTry

public Instant getLastTry()

getCode

public @MonotonicNonNull Integer getCode()

The HTTP status code on the last invocation of get()

Returns:

null if never called, -1 if no status code could be obtained e.g. because of socket exceptions.

getUrl

public URI getUrl()

getLastModified

public Instant getLastModified()

getExpires

public Instant getExpires()

getMaxAge

public Duration getMaxAge()

getMinAge

public Duration getMinAge()

getErrorCache

public Duration getErrorCache()

getOkCount

public long getOkCount()

getNotModifiedCount

public long getNotModifiedCount()

getNotCheckedCount

public long getNotCheckedCount()

getCheckedCount

public long getCheckedCount()

getChangesCount

public long getChangesCount()

getErrorCount

public long getErrorCount()

isAsync

public boolean isAsync()

setConnectTimeout

public void setConnectTimeout(Duration connectTimeout)

getConnectTimeout

public Duration getConnectTimeout()

setReadTimeout

public void setReadTimeout(Duration readTimeout)

getReadTimeout

public Duration getReadTimeout()

setAccept

public void setAccept(String accept)

getAccept

public String getAccept()