IsbnToId.java

/*
 * @copyright 2012 Philip Warner
 * @license GNU General Public License
 * 
 * This file is part of Book Catalogue.
 *
 * Book Catalogue is free software: you can redistribute it and/or modify
 * it under the terms of the GNU General Public License as published by
 * the Free Software Foundation, either version 3 of the License, or
 * (at your option) any later version.
 *
 * Book Catalogue is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License
 * along with Book Catalogue.  If not, see <http://www.gnu.org/licenses/>.
 */

package com.eleybourn.bookcatalogue.goodreads.api;

import java.io.IOException;

import oauth.signpost.exception.OAuthCommunicationException;
import oauth.signpost.exception.OAuthExpectationFailedException;
import oauth.signpost.exception.OAuthMessageSignerException;

import org.apache.http.client.methods.HttpGet;

import com.eleybourn.bookcatalogue.goodreads.GoodreadsManager;
import com.eleybourn.bookcatalogue.goodreads.GoodreadsManager.Exceptions.BookNotFoundException;
import com.eleybourn.bookcatalogue.goodreads.GoodreadsManager.Exceptions.NetworkException;
import com.eleybourn.bookcatalogue.goodreads.GoodreadsManager.Exceptions.NotAuthorizedException;

/**
 * API call to get a goodreads ID from an ISBN.
 * 
 * NOTE: THIS API DOES NOT RETURN XML. The text output is the ID.
 * 
 * @author Philip Warner
 */
public class IsbnToId extends ApiHandler {

	public IsbnToId(GoodreadsManager manager) {
		super(manager);
	}

	/*
	 * Get the Goodreads book ID given an ISBN. Response contains the ID without any markup.
	 *	URL: http://www.goodreads.com/book/isbn_to_id    (sample url)
	 *	HTTP method: GET
	 *	Parameters:
	 *	    isbn: The ISBN of the book to lookup.
	 *	    key: Developer key (required).
	 */
	public long isbnToId(String isbn) 
			throws OAuthMessageSignerException, OAuthExpectationFailedException, OAuthCommunicationException, IOException,
					NotAuthorizedException, BookNotFoundException, NetworkException 
	{
		HttpGet get = new HttpGet("http://www.goodreads.com/book/isbn_to_id/" + isbn + "?key=" + mManager.getDeveloperKey());
		String s = mManager.executeRaw(get);        
        return Long.parseLong(s);
	}
	
}