Package com.google.api.server.spi.tools

Class GetClientLibAction

java.lang.Object

com.google.appengine.tools.util.Action

com.google.api.server.spi.tools.EndpointsToolAction

com.google.api.server.spi.tools.GetClientLibAction

public class GetClientLibAction
extends EndpointsToolAction

Command that combines 3 other ones and generates client libraries from service classes.

Nested Class Summary

Nested classes/interfaces inherited from class com.google.api.server.spi.tools.EndpointsToolAction

EndpointsToolAction.EndpointsOption

Field Summary

Fields

Modifier and Type	Field	Description
static String	NAME

Fields inherited from class com.google.api.server.spi.tools.EndpointsToolAction

OPTION_BASE_PATH_LONG, OPTION_BASE_PATH_SHORT, OPTION_BUILD_SYSTEM_LONG, OPTION_BUILD_SYSTEM_SHORT, OPTION_CLASS_PATH_LONG, OPTION_CLASS_PATH_SHORT, OPTION_DEBUG, OPTION_FORMAT_LONG, OPTION_FORMAT_SHORT, OPTION_HOSTNAME_LONG, OPTION_HOSTNAME_SHORT, OPTION_LANGUAGE_LONG, OPTION_LANGUAGE_SHORT, OPTION_OUTPUT_DIR_LONG, OPTION_OUTPUT_DIR_SHORT, OPTION_WAR_LONG, OPTION_WAR_SHORT

Fields inherited from class com.google.appengine.tools.util.Action

extraOptions, shortDescription

Constructor Summary

Constructors

Constructor	Description
GetClientLibAction()

Method Summary

Modifier and Type	Method	Description
boolean	execute()	Executes the command with the given arguments.
Object	getClientLib(URL[] classPath, String language, String outputDirPath, List<String> serviceClassNames, String buildSystem, String hostname, String basePath, boolean debug)	Generates a Java client library for an API.
String	getUsageString()	Returns a usage string for help output.

Methods inherited from class com.google.api.server.spi.tools.EndpointsToolAction

apply, computeClassPath, getBasePath, getBuildSystem, getClassPath, getDebug, getExampleString, getFormat, getHelpLines, getHostname, getLanguage, getOpenApiOutputPath, getOptionOrDefault, getOutputPath, getServiceClassNames, getWarOutputPath, getWarPath, isHelpDisplayNeeded, makeBasePathOption, makeBuildSystemOption, makeClassPathOption, makeDebugOption, makeFormatOption, makeHostnameOption, makeLanguageOption, makeOpenApiOutputOption, makeOutputOption, makeWarOption, makeWarOutputOption, setExampleString, setHelpDisplayNeeded

Methods inherited from class com.google.appengine.tools.util.Action

getArgs, getHelpString, getNames, getNameString, getOptions, getShortDescription, setArgs, setOptions, setShortDescription

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

NAME

public static final String NAME

See Also:

Constant Field Values

Constructor Detail

GetClientLibAction

public GetClientLibAction()

Method Detail

execute

public boolean execute()
                throws ClassNotFoundException,
                       IOException,
                       com.google.api.server.spi.config.ApiConfigException

Description copied from class: EndpointsToolAction

Executes the command with the given arguments.

Specified by:

execute in class EndpointsToolAction

Returns:

whether or not all required arguments were provided

Throws:

ClassNotFoundException

IOException

com.google.api.server.spi.config.ApiConfigException

getClientLib

public Object getClientLib(URL[] classPath,
                           String language,
                           String outputDirPath,
                           List<String> serviceClassNames,
                           String buildSystem,
                           String hostname,
                           String basePath,
                           boolean debug)
                    throws ClassNotFoundException,
                           IOException,
                           com.google.api.server.spi.config.ApiConfigException

Generates a Java client library for an API. Combines the steps of generating API configuration, generating Discovery doc and generating client library into one.

Parameters:

classPath - Class path to load service classes and their dependencies

language - Language of the client library. Only "java" is supported right now

outputDirPath - Directory to write output files into

serviceClassNames - Array of service class names of the API

buildSystem - The build system to use for the client library

hostname - The hostname to use

basePath - The base path to use

debug - Whether or not to output intermediate output files

Throws:

ClassNotFoundException

IOException

com.google.api.server.spi.config.ApiConfigException

getUsageString

public String getUsageString()

Description copied from class: EndpointsToolAction

Returns a usage string for help output.

Specified by:

getUsageString in class EndpointsToolAction