Package ghidra.app.script

Class JavaScriptProvider

java.lang.Object

ghidra.app.script.GhidraScriptProvider

ghidra.app.script.JavaScriptProvider

All Implemented Interfaces:

ExtensionPoint, java.lang.Comparable<GhidraScriptProvider>

public class JavaScriptProvider
extends GhidraScriptProvider

Constructor Summary

Constructors

Constructor	Description
JavaScriptProvider()	Create a new JavaScriptProvider associated with the current bundle host used by scripting.

Method Summary

Modifier and Type	Method	Description
void	createNewScript(ResourceFile newScript, java.lang.String category)	Creates a new script using the specified file.
boolean	deleteScript(ResourceFile sourceFile)	Deletes the script file and unloads the script from the script manager.
ghidra.app.plugin.core.osgi.GhidraSourceBundle	getBundleForSource(ResourceFile sourceFile)	Get the GhidraSourceBundle containing the given source file, assuming it already exists.
java.lang.String	getCommentCharacter()	Returns the comment character.
java.lang.String	getDescription()	Returns a description for this type of script.
java.lang.String	getExtension()	Returns the file extension for this type of script.
GhidraScript	getScriptInstance(ResourceFile sourceFile, java.io.PrintWriter writer)	Returns a GhidraScript instance for the specified source file.
java.lang.Class<?>	loadClass(ResourceFile sourceFile, java.io.PrintWriter writer)	Activate and build the GhidraSourceBundle containing sourceFile then load the script's class from its class loader.

Methods inherited from class ghidra.app.script.GhidraScriptProvider

compareTo, equals, hashCode, toString, writeBody, writeHeader

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

JavaScriptProvider

public JavaScriptProvider()

Create a new JavaScriptProvider associated with the current bundle host used by scripting.

Method Detail

getBundleForSource

public ghidra.app.plugin.core.osgi.GhidraSourceBundle getBundleForSource(ResourceFile sourceFile)

Get the GhidraSourceBundle containing the given source file, assuming it already exists.

Parameters:

sourceFile - the source file

Returns:

the bundle

getDescription

public java.lang.String getDescription()

Description copied from class: GhidraScriptProvider

Returns a description for this type of script.

Specified by:

getDescription in class GhidraScriptProvider

Returns:

a description for this type of script

getExtension

public java.lang.String getExtension()

Description copied from class: GhidraScriptProvider

Returns the file extension for this type of script. For example, ".java" or ".py".

Specified by:

getExtension in class GhidraScriptProvider

Returns:

the file extension for this type of script

deleteScript

public boolean deleteScript(ResourceFile sourceFile)

Description copied from class: GhidraScriptProvider

Deletes the script file and unloads the script from the script manager.

Overrides:

deleteScript in class GhidraScriptProvider

Parameters:

sourceFile - the script source file

Returns:

true if the script was completely deleted and cleaned up

getScriptInstance

public GhidraScript getScriptInstance(ResourceFile sourceFile,
                                      java.io.PrintWriter writer)
                               throws java.lang.ClassNotFoundException,
                                      java.lang.InstantiationException,
                                      java.lang.IllegalAccessException

Description copied from class: GhidraScriptProvider

Returns a GhidraScript instance for the specified source file.

Specified by:

getScriptInstance in class GhidraScriptProvider

Parameters:

sourceFile - the source file

writer - the print writer to write warning/error messages

Returns:

a GhidraScript instance for the specified source file

Throws:

java.lang.ClassNotFoundException

java.lang.InstantiationException

java.lang.IllegalAccessException

loadClass

public java.lang.Class<?> loadClass(ResourceFile sourceFile,
                                    java.io.PrintWriter writer)
                             throws java.lang.Exception

Activate and build the GhidraSourceBundle containing sourceFile then load the script's class from its class loader.

Parameters:

sourceFile - the source file

writer - the target for build messages

Returns:

the loaded Class object

Throws:

java.lang.Exception - if build, activation, or class loading fail

createNewScript

public void createNewScript(ResourceFile newScript,
                            java.lang.String category)
                     throws java.io.IOException

Description copied from class: GhidraScriptProvider

Creates a new script using the specified file.

Specified by:

createNewScript in class GhidraScriptProvider

Parameters:

newScript - the new script file

category - the script category

Throws:

java.io.IOException - if an error occurs writing the file

getCommentCharacter

public java.lang.String getCommentCharacter()

Description copied from class: GhidraScriptProvider

Returns the comment character. For example, "//" or "#".

Specified by:

getCommentCharacter in class GhidraScriptProvider

Returns:

the comment character