Package org.esa.snap.core.gpf.descriptor
Class DefaultOperatorDescriptor
- java.lang.Object
-
- org.esa.snap.core.gpf.descriptor.DefaultOperatorDescriptor
-
- All Implemented Interfaces:
ElementDescriptor
,OperatorDescriptor
public class DefaultOperatorDescriptor extends Object implements OperatorDescriptor
Default implementation of theOperatorDescriptor
interface.- Since:
- BEAM 5
-
-
Constructor Summary
Constructors Constructor Description DefaultOperatorDescriptor(String name, Class<? extends Operator> operatorClass)
-
Method Summary
All Methods Static Methods Instance Methods Concrete Methods Modifier and Type Method Description static DefaultOperatorDescriptor
fromXml(File file, ClassLoader classLoader)
Loads an operator descriptor from an XML document.static DefaultOperatorDescriptor
fromXml(Reader reader, String resourceName, ClassLoader classLoader)
Loads an operator descriptor from an XML document.static DefaultOperatorDescriptor
fromXml(URL url, ClassLoader classLoader)
Loads an operator descriptor from an XML document.String
getAlias()
String
getAuthors()
String
getCopyright()
String
getDescription()
String
getLabel()
String
getName()
Class<? extends Operator>
getOperatorClass()
ParameterDescriptor[]
getParameterDescriptors()
SourceProductDescriptor[]
getSourceProductDescriptors()
SourceProductsDescriptor
getSourceProductsDescriptor()
TargetProductDescriptor
getTargetProductDescriptor()
TargetPropertyDescriptor[]
getTargetPropertyDescriptors()
String
getVersion()
boolean
isAutoWriteDisabled()
The GPF framework usually writes the target product of either single operators or processing graphs to the file system when executed from the GPT command-line interface or the operator GUI.boolean
isInternal()
String
toXml(ClassLoader classLoader)
Converts an operator descriptor to XML.
-
-
-
Method Detail
-
getVersion
public String getVersion()
- Specified by:
getVersion
in interfaceOperatorDescriptor
- Returns:
- The version of the operator, or
null
if not declared.
-
getAuthors
public String getAuthors()
- Specified by:
getAuthors
in interfaceOperatorDescriptor
- Returns:
- The author(s) of the operator, or
null
if not declared.
-
getCopyright
public String getCopyright()
- Specified by:
getCopyright
in interfaceOperatorDescriptor
- Returns:
- The copyright notice for the operator code, or
null
if not declared.
-
isInternal
public boolean isInternal()
- Specified by:
isInternal
in interfaceOperatorDescriptor
- Returns:
- If
true
, this operator is considered for internal use only and thus may not be exposed in user interfaces. The default isfalse
.
-
isAutoWriteDisabled
public boolean isAutoWriteDisabled()
Description copied from interface:OperatorDescriptor
The GPF framework usually writes the target product of either single operators or processing graphs to the file system when executed from the GPT command-line interface or the operator GUI.If the
autoWriteDisabled
property is set, this default behaviour is switched off and hence, the operator or graph is responsible for outputting any computed results.Setting this property on an operator will only be useful, if it either does not generate a new target
Product
and/or if it does its own outputting of non-Product
targets to external files.- Specified by:
isAutoWriteDisabled
in interfaceOperatorDescriptor
- Returns:
- If
true
, the framework will prevent automatic writing of the target product to the file system.
-
getName
public String getName()
- Specified by:
getName
in interfaceElementDescriptor
- Returns:
- The symbolic name used to unambiguously identify this element. E.g. the fully qualified name of a Java class.
-
getAlias
public String getAlias()
- Specified by:
getAlias
in interfaceElementDescriptor
- Returns:
- A short form of the symbolic name, or
null
if not declared.
-
getLabel
public String getLabel()
- Specified by:
getLabel
in interfaceElementDescriptor
- Returns:
- A human-readable version of the symbolic name to be used in user interfaces, or
null
if not declared.
-
getDescription
public String getDescription()
- Specified by:
getDescription
in interfaceElementDescriptor
- Returns:
- A short description, or
null
if not declared.
-
getOperatorClass
public Class<? extends Operator> getOperatorClass()
- Specified by:
getOperatorClass
in interfaceOperatorDescriptor
- Returns:
- The operator implementation class.
-
getSourceProductDescriptors
public SourceProductDescriptor[] getSourceProductDescriptors()
- Specified by:
getSourceProductDescriptors
in interfaceOperatorDescriptor
- Returns:
- The source product descriptors. The array will be empty if the operator does not have any source products.
-
getSourceProductsDescriptor
public SourceProductsDescriptor getSourceProductsDescriptor()
- Specified by:
getSourceProductsDescriptor
in interfaceOperatorDescriptor
- Returns:
- The source products descriptor, or
null
if none is declared.
-
getParameterDescriptors
public ParameterDescriptor[] getParameterDescriptors()
- Specified by:
getParameterDescriptors
in interfaceOperatorDescriptor
- Returns:
- The parameter descriptors. The array will be empty if the operator does not have any parameters.
-
getTargetPropertyDescriptors
public TargetPropertyDescriptor[] getTargetPropertyDescriptors()
- Specified by:
getTargetPropertyDescriptors
in interfaceOperatorDescriptor
- Returns:
- The target property descriptors. The array will be empty if the operator does not produce any target properties.
-
getTargetProductDescriptor
public TargetProductDescriptor getTargetProductDescriptor()
- Specified by:
getTargetProductDescriptor
in interfaceOperatorDescriptor
- Returns:
- The target product descriptor, or
null
if none is declared.
-
fromXml
public static DefaultOperatorDescriptor fromXml(URL url, ClassLoader classLoader)
Loads an operator descriptor from an XML document.- Parameters:
url
- The URL pointing to a valid operator descriptor XML document.classLoader
- The class loader is used to load classed specified in the xml. For example the class defined by theoperatorClass
tag.- Returns:
- A new operator descriptor.
-
fromXml
public static DefaultOperatorDescriptor fromXml(File file, ClassLoader classLoader) throws OperatorException
Loads an operator descriptor from an XML document.- Parameters:
file
- The file containing a valid operator descriptor XML document.classLoader
- The class loader is used to load classed specified in the xml. For example the class defined by theoperatorClass
tag.- Returns:
- A new operator descriptor.
- Throws:
OperatorException
-
fromXml
public static DefaultOperatorDescriptor fromXml(Reader reader, String resourceName, ClassLoader classLoader) throws OperatorException
Loads an operator descriptor from an XML document.- Parameters:
reader
- The reader providing a valid operator descriptor XML document.resourceName
- Used in error messagesclassLoader
- The class loader is used to load classed specified in the xml. For example the class defined by theoperatorClass
tag.- Returns:
- A new operator descriptor.
- Throws:
OperatorException
-
toXml
public String toXml(ClassLoader classLoader)
Converts an operator descriptor to XML.- Parameters:
classLoader
- The class loader is used to load classed specified in the xml. For example the class defined by theoperatorClass
tag.- Returns:
- A string containing valid operator descriptor XML.
-
-