Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Rovi API Client Library for Java
Java
branch: master

MIT License file added

License referenced in README, now being added to repo.
latest commit 75546753ed
@mansilladev mansilladev authored
Failed to load latest commit information.
src/main/java/com/google/api/services Initial code commit.
LICENSE.txt MIT License file added
README.md Update master
pom.xml Initial code commit.

README.md

Rovi Cloud Services API Client Library for Java

Java client libraries created with Mashery I/O Wraps, a semi-automated native language SDK generator.

What is the Rovi Cloud Services API?

Rovi is a global leader in digital entertainment technology for some of the largest CE manufacturers, service providers and online, mobile and application developers in the world. We now have a range of APIs that can help you to create and deliver an even more enhanced entertainment experience to your customers.

Head over to developer.rovicorp.com to learn more. You can register for instant access to their API, view their documentation, and even make live API calls with their interactive docs.

Summary

An API client library (also known as an SDK or language wrapper) is an efficiency tool for programmer that helps bind external resources to your native programming language. Traditionally, to integrate an API into your project without a client library, you would need to do the following:

  1. Construct a network request using a transport library (e.g. HTTP)

  2. Integrate authentication flow and signatures (e.g. OAuth, MD5/SHA-256, etc.)

  3. Construct and execute API calls manually, often a trial and error process while reading documentation

  4. Parse through results

  5. Lather. Rinse. Repeat.

How does the client library help?

Client libraries make life easier by bringing the API into your native language environment. So, rather than making curl calls, piping the output into a variable, and parsing through the variable -- the client library handles the network connectivity, authorization and API call execution with syntax you're familiar with. Below is a pseudo-Java-code example of how this library works:

// Instantiate the client library
Roviapi roviapi = new Roviapi.Builder(new NetHttpTransport(), jsonFactory....

// Initialize the request object
RoviApiRequest apiRequest = (RoviApiRequest)request;

// Set your API key
apiRequest.set("apikey","YOUR_KEY_HERE");

// Make an API call and store the response in a string
String responseStr = roviapi.MusicMethods().Search("gaga");

Requirements

  1. Java
  2. Maven
  3. Rovi API key -- head over to http://developer.rovicorp.com

IDE is optional, but nice

At Mashery, we love vim just as much as the next guy, but when it comes to tool-tips, code-completion and general object-oriented goodness, IDEs can be really useful. Eclipse, Netbeans, etc. They're all very mature and useful tools.

Installation / Quick Start Guide

Follow the steps below for a quick start to using this client library:

  1. Grab the latest source with git.

    git clone git://github.com/mashery/io-wraps-rovi-java.git
  2. From the root of the unpack repo above, build with Maven:

    maven install
  3. Head over to Rovi Cloud Services to fetch an API key

  4. Open up your IDE and import the Maven project.

This client library was built using Mashery I/O Wraps, which incorporates the Google Client Library Generator and other Google native language libraries. This is why the package layout looks like com.google.api...

About / License

Something went wrong with that request. Please try again.