com.google.api.server.spi.tools

Class GetDiscoveryDocAction

java.lang.Object

com.google.appengine.tools.util.Action

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

com.google.api.server.spi.tools.GetDiscoveryDocAction

public class GetDiscoveryDocAction
extends EndpointsToolAction

Command that combines 2 other ones and generates a discovery doc 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 and Description
static java.lang.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 and Description
GetDiscoveryDocAction()

Method Summary

Modifier and Type	Method and Description
boolean	execute() Executes the command with the given arguments.
java.util.Map<java.lang.String,java.lang.String>	getDiscoveryDoc(java.net.URL[] classPath, java.lang.String outputDirPath, java.util.List<java.lang.String> serviceClassNames, java.lang.String hostname, java.lang.String basePath, boolean outputToDisk) Generates a Java client library for an API.
java.lang.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 java.lang.String NAME

See Also:

Constant Field Values

Constructor Detail

GetDiscoveryDocAction

public GetDiscoveryDocAction()

Method Detail

execute

public boolean execute()
                throws java.lang.ClassNotFoundException,
                       java.io.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:

java.lang.ClassNotFoundException

java.io.IOException

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

getDiscoveryDoc

public java.util.Map<java.lang.String,java.lang.String> getDiscoveryDoc(java.net.URL[] classPath,
                                                                        java.lang.String outputDirPath,
                                                                        java.util.List<java.lang.String> serviceClassNames,
                                                                        java.lang.String hostname,
                                                                        java.lang.String basePath,
                                                                        boolean outputToDisk)
                                                                 throws java.lang.ClassNotFoundException,
                                                                        java.io.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

outputDirPath - Directory to write output files into

serviceClassNames - Array of service class names of the API

hostname - The hostname to use

basePath - The base path to use

outputToDisk - Whether or not to output discovery docs to disk

Throws:

java.lang.ClassNotFoundException

java.io.IOException

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

getUsageString

public java.lang.String getUsageString()

Description copied from class: EndpointsToolAction

Returns a usage string for help output.

Specified by:

getUsageString in class EndpointsToolAction