Android Open Source - Scanner-For-Zotero World Cat A P I Client

From Project

Back to project page Scanner-For-Zotero.
License

The source code is released under:
GNU General Public License
If you think the Android project Scanner-For-Zotero listed in this page is inappropriate, such as containing malicious code/tools or violating the copyright, please email info at java2s dot com, thanks.
Java Source Code

/** 
 * Copyright 2011 John M. Schanck/*from w  w  w .  j a  v a2  s  .  c om*/
 * 
 * ScannerForZotero 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.
 * 
 * ScannerForZotero 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 ScannerForZotero.  If not, see <http://www.gnu.org/licenses/>.
 */

package org.ale.scanner.zotero.web.worldcat;

import java.net.URI;

import org.ale.scanner.zotero.data.CreatorType;
import org.ale.scanner.zotero.data.ItemField;
import org.ale.scanner.zotero.data.ItemType;
import org.ale.scanner.zotero.web.APIHandler;
import org.ale.scanner.zotero.web.APIRequest;
import org.ale.scanner.zotero.web.HttpsClient;
import org.ale.scanner.zotero.web.RequestQueue;
import org.apache.http.impl.client.DefaultHttpClient;
import org.json.JSONArray;
import org.json.JSONException;
import org.json.JSONObject;

import android.os.Bundle;

public class WorldCatAPIClient {

    public static final String
            XISBN_SEARCH = "http://xisbn.worldcat.org/webservices/xid/isbn/%s"+
                            "?method=getMetadata&fl=*&format=json&count=1";

    public static final String
            XISSN_SEARCH = "http://xissn.worldcat.org/webservices/xid/issn/%s"+
                            "?method=getMetadata&fl=*&format=json&count=1";

    public static final String EXTRA_ISBN = "ISBN";

    public static final int STATUS_OK = 0;
    public static final int STATUS_NOT_FOUND = 1;
    public static final int STATUS_INVALID = 2;
    public static final int STATUS_OVER_LIMIT = 3;

    private DefaultHttpClient mHttpsClient;

    private RequestQueue mRequestQueue;

    private APIHandler mHandler;

    public WorldCatAPIClient() {
        mHandler = WorldCatHandler.getInstance();
        mHttpsClient = HttpsClient.getInstance();
        mRequestQueue = RequestQueue.getInstance();
    }

    private APIRequest newRequest(){
        return new APIRequest(mHandler, mHttpsClient);
    }

    public void isbnLookup(String isbn) {
        APIRequest r = newRequest();
        r.setHttpMethod(APIRequest.GET);
        r.setURI(URI.create(String.format(XISBN_SEARCH, isbn)));
        Bundle extra = new Bundle();
        extra.putString(WorldCatAPIClient.EXTRA_ISBN, isbn);
        r.setExtra(extra);

        mRequestQueue.enqueue(r);
    }

    public void issnLookup(String issn) {
        APIRequest r = newRequest();
        r.setHttpMethod(APIRequest.GET);
        r.setURI(URI.create(String.format(XISSN_SEARCH, issn)));
        Bundle extra = new Bundle();
        extra.putString(WorldCatAPIClient.EXTRA_ISBN, issn);
        r.setExtra(extra);

        mRequestQueue.enqueue(r);
    }

    public static JSONObject strToJSON(String resp){
        try{
            // Try to create a JSONObject from resp
            return new JSONObject(resp);
        }catch(JSONException e){
            // If that fails, try to indicate that there was an error
            try{
                return new JSONObject().put("stat", "badResponse"); 
            }catch(JSONException e2){
                // Or just return an empty JSONObject
                return new JSONObject();
            }
        }
    }

    public static int getStatus(JSONObject resp){
        try {
            String status = resp.getString("stat");
            if(status.equals("ok")){
                return STATUS_OK;
            }else if(status.equals("unknownId")){
                return STATUS_NOT_FOUND;
            }else if(status.equals("overlimit")){
                return STATUS_OVER_LIMIT;
            }else{
                return STATUS_INVALID;
            }
        } catch (JSONException e) {
            return STATUS_INVALID;
        }
    }

    public static JSONObject translateJsonResponse(String ident, JSONObject resp){
        if(resp.has("list")){
            return translateISBNResponse(ident, resp.optJSONArray("list"));
        }else if(resp.has("group")){
            return translateISSNResponse(ident, resp.optJSONArray("group"));
        }
        return null;
    }

    private static JSONObject translateISBNResponse(String isbn, JSONArray list){
        /* Example ISBN response:
            { "stat":"ok",
             "list":[{
                "url":["http://www.worldcat.org/oclc/177669176?referer=xid"],
                "publisher":"O'Reilly",
                "form":["BA"],
                "lccn":["2004273129"],
                "lang":"eng",
                "city":"Sebastopol, CA",
                "author":"by Mark Lutz and David Ascher.",
                "ed":"2nd ed.",
                "year":"2003",
                "isbn":["0596002815"],
                "title":"Learning Python",
                "oclcnum":["177669176",...,"79871142"]}]}
         */

        JSONObject translation = new JSONObject();
        try {
            JSONObject oItem = list.getJSONObject(0);

            JSONObject creator = new JSONObject()
                .put(CreatorType.type, "author")
                .put(ItemField.Creator.name, oItem.optString("author"));

            JSONObject tItem = new JSONObject()
                .put(ItemType.type, ItemType.book) /* XXX: Always 'book' */
                .put(ItemField.ISBN, isbn)
                .put(ItemField.title, oItem.optString("title"))
                .put(ItemField.language, oItem.optString("lang"))
                .put(ItemField.creators, new JSONArray())
                .accumulate(ItemField.creators, creator)
                .put(ItemField.place, oItem.optString("city"))
                .put(ItemField.date, oItem.optString("year"))
                .put(ItemField.publisher, oItem.optString("publisher"))
                .put(ItemField.edition, oItem.optString("ed"));

            translation.put("items", new JSONArray());
            translation.accumulate("items", tItem);
        } catch (JSONException e) {
            return null;
        }
        return translation;
    }

    private static JSONObject translateISSNResponse(String isbn, JSONArray group){
        /* Example ISSN response:
             {"stat":"ok",
             "group":[{
                "rel":"this",
                "list":[{
                  "rssurl":"http://www.sciencemag.org/rss/current.xml",
                  "publisher":"New York, N.Y. : s.n",
                  "form":"JB",
                  "peerreview":"Y",
                  "rawcoverage":"Vol. 1, no. 1 (July 3, 1880)-v. 3, no. 82 (Mar. 4, 1882); [New ser.] Vol. 1, no. 1 (Feb. 9, 1883)-v. 23, no. 581 (Mar. 23, 1894); [2nd ser.] v. 1, no. 1 (Jan. 4, 1895)-",
                  "title":"Science",
                  "issn":"0036-8075",
                  "oclcnum":["460357554",...,"320472675"],
                  "issnl":"0036-8075"}]}]}
         */
        JSONObject translation = new JSONObject();
        try {
            JSONObject firstGroup = group.getJSONObject(0);
            JSONArray list = firstGroup.getJSONArray("list");
            JSONObject oItem = list.getJSONObject(0);

            JSONObject tItem = new JSONObject()
                .put(ItemType.type, ItemType.journalArticle) /* XXX: Always 'journalArticle' */
                .put(ItemField.ISSN, isbn)
                .put(ItemField.publicationTitle, oItem.optString("title"));

            translation.put("items", new JSONArray());
            translation.accumulate("items", tItem);
        } catch (JSONException e) {
            return null;
        }
        return translation;
    }
}
Java Source Code List
