Contributors Coding Exercise

Solution for the New Relic coding exercise, implemented as a standalone JAX-RS API running on an embedded Grizzly Jersey container. It features:

• Validation of API parameters
• Caching of GitHub search API results
• Retry and rate limit GitHub calls

The strategy to request GitHub API is always retrieve the maximum number of top contributors (150), and use the cached values to limit the results of equal or smaller top number requests.

Configuration

The file configuration.properties contains configuration properties for the application:

• github.timeout.millis: GitHub connection and read timeout.
• github.search.url: The GitHub search endpoint.
• github.search.requestsPerMinute: Requests per minute.
• github.retry.maxAttempts: Max attempts on retry.
• github.retry.waitDuration.millis: Duration between retries.
• github.cache.expiry.seconds: GitHub results cache expiry duration.

Requirements

• Java 8
• Maven 3

Building

With Maven 3 in your PATH, run the command:

$ mvn clean package

Running

With Maven 3 in your PATH, run the commands:

$ cd api

$ mvn exec:java