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

Java tutorial

Introduction

Here is the source code for com.google.code.stackexchange.client.examples.UsersApiExample.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 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.StackExchangeApiClient;
import com.google.code.stackexchange.client.StackExchangeApiClientFactory;
import com.google.code.stackexchange.schema.User;

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

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

    /** The Constant ID_OPTION. */
    private static final String ID_OPTION = "id";

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

    /**
     * The main method.
     * 
     * @param args the arguments
     */
    public static void main(String[] args) {
        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
     */
    private static void processCommandLine(CommandLine line, Options options) {
        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 StackExchangeApiClient client = factory.createStackExchangeApiClient();

            if (line.hasOption(ID_OPTION)) {
                String idValue = line.getOptionValue(ID_OPTION);
                List<User> users = client.getUsers(Long.valueOf(idValue));
                printResult(users.get(0));
            } else {
                List<User> users = client.getUsers();
                for (User user : users) {
                    printResult(user);
                }
            }
        } else {
            printHelp(options);
        }
    }

    /**
     * Prints the result.
     * 
     * @param user the user
     */
    private static void printResult(User user) {
        System.out.println(user.getDisplayName() + ":" + user.getReputation() + ":" + user.getUserType());
    }

    /**
     * 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);

        String idMsg = "ID of the users to whom a message is to be sent (separated by comma).";
        OptionBuilder.withArgName("id");
        OptionBuilder.hasArg();
        OptionBuilder.withDescription(idMsg);
        Option id = OptionBuilder.create(ID_OPTION);
        opts.addOption(id);

        return opts;
    }

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