com.aspc.remote.rest

Class ReST

java.lang.Object

com.aspc.remote.rest.ReST

public final class ReST
extends java.lang.Object

ReST client which will cache requests for a given period.

Optimizations

• Requests that are for data that we have an existing result less than the cache period will return immediately.
• Requests that are for data that are half the age of the cache period will result in a "pre-fetch" request being made in the background.
• Multiple requests for the same URL will result in only one request to the web server. All requests will get the same result when returned.

THREAD MODE: MULTI-THREADED

Since:

Jan 9, 2014

Author:

Lei Gao

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	ReST.Builder

Constructor Summary

Constructors

Constructor and Description
ReST()

Method Summary

Modifier and Type	Method and Description
static ReST.Builder	builder(java.lang.String url) Build a new ReST call for the past URL.
static ReST.Builder	builder(java.net.URL url) Build a new ReST call for the past URL.

Methods inherited from class java.lang.Object

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

Constructor Detail

ReST

public ReST()

Method Detail

builder

@CheckReturnValue
 @Nonnull
public static ReST.Builder builder(@Nonnull
                                                               java.lang.String url)
                                                        throws java.net.MalformedURLException,
                                                               InvalidDataException

Build a new ReST call for the past URL.

Parameters:

url - the URL to call

Returns:

the builder for this URL

Throws:

java.net.MalformedURLException - the URL is not valid

InvalidDataException - the URL is not valid

builder

@CheckReturnValue
 @Nonnull
public static ReST.Builder builder(@Nonnull
                                                               java.net.URL url)
                                                        throws InvalidDataException

Build a new ReST call for the past URL.

Parameters:

url - the URL to call

Returns:

the builder for this URL

Throws:

InvalidDataException - the URL is not valid