org.zaproxy.zap.extension.api

Class AbstractAPIGenerator

java.lang.Object

org.zaproxy.zap.extension.api.AbstractAPIGenerator

Direct Known Subclasses:

DotNetAPIGenerator, GoAPIGenerator, JavaAPIGenerator, NodeJSAPIGenerator, PhpAPIGenerator, PythonAPIGenerator, RustAPIGenerator, WikiAPIGenerator

public abstract class AbstractAPIGenerator
extends Object

The base class for ZAP API client generators.

Since:

2.6.0

Field Summary

Fields

Modifier and Type	Field and Description
protected static String	ACTION_ENDPOINT
protected static String	OPTIONAL_MESSAGE
protected static String	OTHER_ENDPOINT
protected static String	VIEW_ENDPOINT

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	AbstractAPIGenerator(String directory) Constructs an AbstractAPIGenerator with the given directory.
protected	AbstractAPIGenerator(String directory, boolean optional) Constructs an AbstractAPIGenerator with the given directory and optional state.
protected	AbstractAPIGenerator(String directory, boolean optional, ResourceBundle resourceBundle) Constructs an AbstractAPIGenerator with the given directory, optional state, and ResourceBundle.

Method Summary

Modifier and Type	Method and Description
protected abstract void	generateAPIFiles(ApiImplementor implementor) Generates the API client files of the given API implementor.
void	generateAPIFiles(List<ApiImplementor> implementors) Generates the API client files of the given API implementors.
void	generateCoreAPIFiles() Generates the API client files for the core API implementors.
protected Path	getDirectory() Gets the directory where the API client files should be generated.
protected ResourceBundle	getMessages() Gets the messages for doc of the generated classes.
protected boolean	isOptional() If the API client files being generated are optional, that is, belong to an add-on.

Methods inherited from class java.lang.Object

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

Field Detail

OPTIONAL_MESSAGE

protected static final String OPTIONAL_MESSAGE

See Also:

Constant Field Values

VIEW_ENDPOINT

protected static final String VIEW_ENDPOINT

See Also:

Constant Field Values

ACTION_ENDPOINT

protected static final String ACTION_ENDPOINT

See Also:

Constant Field Values

OTHER_ENDPOINT

protected static final String OTHER_ENDPOINT

See Also:

Constant Field Values

Constructor Detail

AbstractAPIGenerator

protected AbstractAPIGenerator(String directory)

Constructs an AbstractAPIGenerator with the given directory.

Parameters:

directory - the directory where the API client files should be generated

AbstractAPIGenerator

protected AbstractAPIGenerator(String directory,
                               boolean optional)

Constructs an AbstractAPIGenerator with the given directory and optional state.

Parameters:

directory - the directory where the API client files should be generated

optional - true if the API client files are optional, false otherwise

AbstractAPIGenerator

protected AbstractAPIGenerator(String directory,
                               boolean optional,
                               ResourceBundle resourceBundle)

Constructs an AbstractAPIGenerator with the given directory, optional state, and ResourceBundle.

Parameters:

directory - the directory where the API client files should be generated

optional - true if the API client files are optional, false otherwise

resourceBundle - the ResourceBundle used for doc of the generated classes.

Since:

2.8.0

Method Detail

getDirectory

protected Path getDirectory()

Gets the directory where the API client files should be generated.

Returns:

the directory where the API client files should be generated

isOptional

protected boolean isOptional()

If the API client files being generated are optional, that is, belong to an add-on.

Returns:

true if the API client files are optional, false otherwise

getMessages

protected ResourceBundle getMessages()

Gets the messages for doc of the generated classes.

Returns:

the ResourceBundle with the messages for doc

generateCoreAPIFiles

public void generateCoreAPIFiles()
                          throws IOException

Generates the API client files for the core API implementors.

Throws:

IOException - if an error occurred while writing the API files

generateAPIFiles

public void generateAPIFiles(List<ApiImplementor> implementors)
                      throws IOException

Generates the API client files of the given API implementors.

Parameters:

implementors - the API implementors, must not be null

Throws:

IOException - if an error occurred while writing the API files

generateAPIFiles

protected abstract void generateAPIFiles(ApiImplementor implementor)
                                  throws IOException

Generates the API client files of the given API implementor.

Parameters:

implementor - the API implementor, must not be null

Throws:

IOException - if an error occurred while writing the API files