com.google.code.stackexchange.client.examples.AsyncApiExample.java Source code

Introduction

Here is the source code for com.google.code.stackexchange.client.examples.AsyncApiExample.java

Source

/*
 * Copyright 2010 Nabeel Mukhtar 
 * 
 * Licensed under the Apache License, Version 2.0 (the "License"); 
 * you may not use this file except in compliance with the License. 
 * You may obtain a copy of the License at 
 * 
 *  http://www.apache.org/licenses/LICENSE-2.0
 * 
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 
 * See the License for the specific language governing permissions and
 * limitations under the License. 
 * 
 */
package com.google.code.stackexchange.client.examples;

import java.text.MessageFormat;
import java.util.List;
import java.util.concurrent.Future;

import org.apache.commons.cli.BasicParser;
import org.apache.commons.cli.CommandLine;
import org.apache.commons.cli.HelpFormatter;
import org.apache.commons.cli.Option;
import org.apache.commons.cli.OptionBuilder;
import org.apache.commons.cli.Options;
import org.apache.commons.cli.ParseException;

import com.google.code.stackexchange.client.AsyncStackExchangeApiClient;
import com.google.code.stackexchange.client.StackExchangeApiClientFactory;
import com.google.code.stackexchange.schema.Badge;
import com.google.code.stackexchange.schema.Tag;

/**
 * The Class AsyncApiExample.
 */
public class AsyncApiExample {

    /** The Constant APPLICATION_KEY_OPTION. */
    private static final String APPLICATION_KEY_OPTION = "key";

    /** The Constant HELP_OPTION. */
    private static final String HELP_OPTION = "help";

    /**
     * The main method.
     * 
     * @param args the arguments
     * 
     * @throws Exception the exception
     */
    public static void main(String[] args) throws Exception {
        Options options = buildOptions();
        try {
            CommandLine line = new BasicParser().parse(options, args);
            processCommandLine(line, options);
        } catch (ParseException exp) {
            System.err.println(exp.getMessage());
            printHelp(options);
        }
    }

    /**
     * Process command line.
     * 
     * @param line the line
     * @param options the options
     * 
     * @throws Exception the exception
     */
    private static void processCommandLine(CommandLine line, Options options) throws Exception {
        if (line.hasOption(HELP_OPTION)) {
            printHelp(options);
        } else if (line.hasOption(APPLICATION_KEY_OPTION)) {
            final String keyValue = line.getOptionValue(APPLICATION_KEY_OPTION);

            final StackExchangeApiClientFactory factory = StackExchangeApiClientFactory.newInstance(keyValue);
            final AsyncStackExchangeApiClient client = factory.createAsyncStackExchangeApiClient();
            System.out.println("Fetching badges and tags asynchronously.");
            Future<List<Badge>> badgesFuture = client.getBadges();
            Future<List<Tag>> tagsFuture = client.getTags();
            System.out.println("Done fetching badges and tags asynchronously. Now blocking for result.");
            List<Badge> badges = badgesFuture.get();
            System.out.println("============ Badges ============");
            for (Badge badge : badges) {
                printResult(badge);
            }
            List<Tag> tags = tagsFuture.get();
            System.out.println("============ Tags ============");
            for (Tag tag : tags) {
                printResult(tag);
            }

        } else {
            printHelp(options);
        }
    }

    /**
     * Prints the result.
     * 
     * @param tag the tag
     */
    private static void printResult(Tag tag) {
        System.out.println(tag.getName() + ":" + tag.getCount());
    }

    /**
     * Prints the result.
     * 
     * @param badge the badge
     */
    private static void printResult(Badge badge) {
        System.out.println(badge.getName() + ":" + badge.getRank() + ":" + badge.getAwardCount());
    }

    /**
     * Builds the options.
     * 
     * @return the options
     */
    private static Options buildOptions() {

        Options opts = new Options();

        String helpMsg = "Print this message.";
        Option help = new Option(HELP_OPTION, helpMsg);
        opts.addOption(help);

        String consumerKeyMsg = "You API Key.";
        OptionBuilder.withArgName("key");
        OptionBuilder.hasArg();
        OptionBuilder.withDescription(consumerKeyMsg);
        Option consumerKey = OptionBuilder.create(APPLICATION_KEY_OPTION);
        opts.addOption(consumerKey);

        return opts;
    }

    /**
     * Prints the help.
     * 
     * @param options the options
     */
    private static void printHelp(Options options) {
        int width = 80;
        String syntax = AsyncApiExample.class.getName() + " <options>";
        String header = MessageFormat.format("\nThe -{0} option is required.", APPLICATION_KEY_OPTION);
        String footer = "";
        new HelpFormatter().printHelp(width, syntax, header, options, footer, false);
    }
}