public final class SimpleAlgorithmConfigurator extends AlgorithmConfigurator
Configurador de algoritmos simples.
AlgorithmConfigurator.ConfiguratorTypeFILE_LIST_SEPARATOR| Constructor and Description |
|---|
SimpleAlgorithmConfigurator(AlgorithmVersionInfo algorithmVersion,
String description,
ExecutionType executionType,
ExecutionLocation executionLocation,
String abbreviation,
boolean provideId,
String command,
String shell,
String defaultInputFileParameterName,
boolean showOutput,
String commandLinePattern)
Cria um configurador de algoritmos simples.
|
SimpleAlgorithmConfigurator(AlgorithmVersionInfo algorithmVersion,
String description,
ExecutionType executionType,
ExecutionLocation executionLocation,
String abbreviation,
boolean provideId,
String command,
String shell,
String defaultInputFileParameterName,
boolean showOutput,
String commandLinePattern,
boolean loadParameters)
Cria um configurador de algoritmos simples.
|
| Modifier and Type | Method and Description |
|---|---|
boolean |
addExpression(ValidationExpression expression)
Adiciona uma expressão de validação a este configurador.
|
boolean |
addGroup(ParameterGroup group)
Adiciona um grupo a este configurador.
|
boolean |
addHiddenParameter(HiddenParameter hiddenParameter)
Adiciona um parâmetro oculto a este configurador.
|
boolean |
addTrigger(Trigger<?> trigger)
Adiciona um gatilho a este configurador.
|
Boolean |
allowParametersLoad()
Indica se o algoritmo suporta carga e armazenamento de valores de parâmetros em arquivos de projeto.
|
Map<Object,Object> |
exportValues()
Exporta os valores dos parâmetros para um
Map que contém apenas
objetos que são tipos envelopes para tipos primitivos ou coleções padrão do
API do Java. |
Set<String> |
getBinaryDirectories(String platformId,
char fileSeparator)
Obtém uma relação de caminhos para os diretórios dos binários deste
algoritmo para um determinado
SGAInfo. |
Set<String[]> |
getBinaryDirectoriesAsArray(String platformId)
Obtém uma relação de caminhos em forma de array para os diretórios dos
binários deste algoritmo para um determinado
SGAInfo. |
String |
getCommandBinaryName()
Obtém o nome do executável.
|
protected String |
getCurrentParameterFileVersion()
Obtém a versão atual do arquivo de parâmetros.
|
String |
getDefaultInputFileParameterName()
Obtém o nome do arquivo de entrada padrão.
|
Set<ValidationExpression> |
getExpressions()
Obtém o conjunto de expressões de validação associadas a este configurador.
|
List<ParameterGroup> |
getGroups()
Obtém a lista de grupos associadas a este configurador.
|
Set<HiddenParameter> |
getHiddenParameters()
Obtém o conjunto de parâmetros ocultos associados a este configurador.
|
Set<FileURLValue> |
getInputDirectories()
Obtém o conjunto de diretórios de entrada.
|
List<InputFileListParameter> |
getInputFileListParameters()
Obtém a lista com os parâmetros que aceitam um conjunto de arquivos e/ou
diretórios para entrada de dados.
|
List<InputFileParameter> |
getInputFileParameters()
Obtém a lista com os parâmetros que aceitam arquivos e/ou diretórios para
entrada de dados.
|
Set<FileURLValue> |
getInputFiles()
Obtém o conjunto de arquivos de entrada.
|
List<InputURLListParameter> |
getInputURLListParameters()
Obtém a lista com os parâmetros que aceitam um conjunto de arquivos e/ou
diretórios (URLs) para entrada de dados.
|
List<InputURLParameter> |
getInputURLParameters()
Obtém a lista com os parâmetros do tipo URL que aceitam arquivos e/ou
diretórios para entrada de dados.
|
Set<FileURLValue> |
getInputURLs()
Obtém o conjunto de arquivos (URLs) de entrada.
|
Set<FileURLValue> |
getOutputDirectories()
Obtém o conjunto de diretórios de saída.
|
List<OutputFileListParameter> |
getOutputFileListParameters()
Obtém a lista com os parâmetros que aceitam um conjunto de arquivos e/ou
diretórios para saída de dados.
|
List<OutputFileParameter> |
getOutputFileParameters()
Obtém a lista com os parâmetros que aceitam arquivos e/ou diretórios para
saída de dados.
|
Set<FileURLValue> |
getOutputFiles()
Obtém o conjunto de arquivos de saída.
|
List<OutputURLListParameter> |
getOutputURLListParameters()
Obtém a lista com os parâmetros que aceitam um conjunto de arquivos e/ou
diretórios (URLs) para saída de dados.
|
List<OutputURLParameter> |
getOutputURLParameters()
Obtém a lista com os parâmetros que aceitam arquivos e/ou diretórios (URLs)
para saída de dados.
|
Set<FileURLValue> |
getOutputURLs()
Obtém o conjunto de arquivos (URLs) de saída.
|
String |
getParameterLabel(String parameterName)
Obtém o rótulo de um parâmetro dado o seu nome.
|
Set<String> |
getParameterNames()
Obtém a relação de nomes dos parâmetros.
|
String |
getParameterType(String parameterName)
Obtém o tipo de um parâmetro dado o seu nome.
|
String |
getParameterValue(String parameterName)
Obtém o valor de um parâmetro dado o seu nome.
|
Set<String> |
getPlatforms()
Obtém uma relação de todas as plataformas suportadas por este configurador
de algoritmos.
|
String |
getShell()
Obtém o shell que irá executar o comando deste configurador.
|
SimpleParameter<?> |
getSimpleParameter(String parameterName)
Obtém um parâmetro simples dado o seu nome.
|
List<SimpleParameter<?>> |
getSimpleParameters()
Obtém a lista de todos parâmetros simples associados a este configurador de
algoritmos.
|
Set<Trigger<?>> |
getTriggers()
Obtém o conjunto de gatilhos associados a este configurador.
|
void |
importValues(Map<Object,Object> parameterValues)
Importa os valores dos parâmetros de um
Map. |
boolean |
isEnabled()
Indica se o configurador está habilitado.
|
boolean |
isSetDefaultValues()
Verifica se os valores deste configurador são iguais aos valores-padrão.
|
String |
makeCommandLine(CommandLineContext context)
Cria a linha de comando.
|
protected String |
makeEnvironmentVariablesDeclaration(CommandLineContext context)
Cria a parte da linha de comando que declara as variáveis de ambiente
utilizadas e disponibilizadas pelo comando.
|
void |
resetValues()
Restaura os valores dos parâmetros para os valores-padrão.
|
boolean |
setDefaultInputFile(FileURLValue inputFile)
Atribui um arquivo para ser utilizado com o arquivo de entrada padrão do
configurador.
|
boolean |
setEnabled(boolean isEnabled)
Modifica o estado habilitado/desabilitado do configurador de algoritmos.
|
void |
setParameterValue(String parameterName,
String parameterValue)
Atribui o valor a um parâmetro.
|
void |
updateTriggers()
Atualiza os gatilhos cujas condições sejam aceitas.
|
Validation |
validate(ValidationContext context)
Verifica se os valores armazenados no parâmetro são válidos.
|
addAlgorithmConfiguratorListener, equals, fireParameterLabelWasChanged, fireParameterValueWasChanged, fireParameterWasSetEnabled, fireParameterWasSetVisible, fireWasSetEnabled, getAbbreviation, getAlgorithmId, getAlgorithmName, getAlgorithmVersion, getAlgorithmVersionId, getCommandDescription, getCommandLinePattern, getConfiguratorType, getCpuAmount, getDescription, getExecutionLocation, getExecutionType, getExitCodeCaptureCommand, getExitCodeLogFile, getExitCodeLogFiles, getFileParameters, getFilePath, getLogFile, getLogFileParameter, getLogFiles, getMemoryAmount, getParameterValuesByName, getRequirements, getStandardOutputFile, getStandardOutputFiles, getWarningsFile, getWarningsFiles, hasExitCode, hashCode, hasParameterThatRequiresPipe, isMultipleExecution, isSimpleExecution, makeCommandLineAsScript, provideId, setCommandDescription, setExecutionLocation, setExecutionType, setExitCodeLogFile, setHasExitCode, setLogFileParameterVisible, setParameterValuesByName, setStandardOutputFile, setWarningsFile, toString, updateAlgorithmVersionpublic SimpleAlgorithmConfigurator(AlgorithmVersionInfo algorithmVersion, String description, ExecutionType executionType, ExecutionLocation executionLocation, String abbreviation, boolean provideId, String command, String shell, String defaultInputFileParameterName, boolean showOutput, String commandLinePattern)
algorithmVersion - A versão do algoritmo (Não aceita null).description - A descrição (Aceita null).executionType - O tipo de execução (Não aceita null).executionLocation - O local de execução do comando.abbreviation - A abreviatura (Aceita null).provideId - Sinal que indica se é necessário fornecer o identificador
do comando na linha de comando.command - O nome do executável (Não aceita null).shell - O shell que irá executar o comando (Aceita null).defaultInputFileParameterName - O arquivo de entrada padrão (Aceita
null).showOutput - Um flag que indica se as saídas padrão e de erro devem
ser exibidas.commandLinePattern - pattern de linha de comando.public SimpleAlgorithmConfigurator(AlgorithmVersionInfo algorithmVersion, String description, ExecutionType executionType, ExecutionLocation executionLocation, String abbreviation, boolean provideId, String command, String shell, String defaultInputFileParameterName, boolean showOutput, String commandLinePattern, boolean loadParameters)
algorithmVersion - A versão do algoritmo (Não aceita null).description - A descrição (Aceita null).executionType - O tipo de execução (Não aceita null).executionLocation - O local de execução do comando.abbreviation - A abreviatura (Aceita null).provideId - Sinal que indica se é necessário fornecer o identificador
do comando na linha de comando.command - O nome do executável (Não aceita null).shell - O shell que irá executar o comando (Aceita null).defaultInputFileParameterName - O arquivo de entrada padrão (Aceita
null).showOutput - Um flag que indica se as saídas padrão e de erro devem
ser exibidas.commandLinePattern - pattern de linha de comando.public boolean addExpression(ValidationExpression expression)
expression - A expressão (Não aceita null).true sucesso ou false se não puder adicionar a
expressão, porque existe uma expressão igual a esta já cadastrada.public boolean addGroup(ParameterGroup group)
Adiciona um grupo a este configurador.
Mantém a ordem de inserção.
group - O grupo (Não aceita null).true sucesso ou false se não puder adicionar o
grupo, porque existe um grupo igual a este já cadastrado.public boolean addHiddenParameter(HiddenParameter hiddenParameter)
hiddenParameter - O parâmetro oculto (Não aceita null).true sucesso ou false se não puder adicionar o
parâmetro oculto, porque existe um parâmetro oculto igual a este já
cadastrado.public boolean addTrigger(Trigger<?> trigger)
Adiciona um gatilho a este configurador.
Quando o gatilho é adicionado ele é atualizado, para que haja uma sincronia entre o estado do configurador e o funcionamento do gatilho.
trigger - O gatilho (Não aceita null).true sucesso ou false se não puder adicionar o
gatilho, porque existe um gatilho igual a este já cadastrado.public Map<Object,Object> exportValues()
Exporta os valores dos parâmetros para um Map que contém apenas
objetos que são tipos envelopes para tipos primitivos ou coleções padrão do
API do Java.
Este método cria um Map que pode ser serializado para um arquivo.
O mapa retornado neste método pode ser utilizado pelo método
AlgorithmConfigurator.importValues(Map).
exportValues in class AlgorithmConfiguratorMap ou uma mapa vazio se não houver valores ou
parâmetros.public Set<String[]> getBinaryDirectoriesAsArray(String platformId)
SGAInfo.getBinaryDirectoriesAsArray in class AlgorithmConfiguratorplatformId - O nome da plataforma (Não aceita null).
Obs.: o conjunto de caminhos retornável deve ser imutável (veja
Collections.unmodifiableSet(Set)).
public Set<String> getBinaryDirectories(String platformId, char fileSeparator)
SGAInfo.getBinaryDirectories in class AlgorithmConfiguratorplatformId - O nome da plataforma (Não aceita null).fileSeparator - O separador de arquivo (Não aceita null).
Obs.: o conjunto de caminhos retornável deve ser imutável (veja
Collections.unmodifiableSet(Set)).
public String getCommandBinaryName()
public String getDefaultInputFileParameterName()
null se não houver
um.public Set<FileURLValue> getInputDirectories()
Obtém o conjunto de diretórios de entrada.
Obs.: o conjunto é imutável (veja Collections.unmodifiableSet(Set)
).
getInputDirectories in class AlgorithmConfiguratorpublic Set<FileURLValue> getOutputDirectories()
Obtém o conjunto de diretórios de saída.
Obs.: o conjunto é imutável (veja Collections.unmodifiableSet(Set)
).
getOutputDirectories in class AlgorithmConfiguratorpublic Set<ValidationExpression> getExpressions()
Obtém o conjunto de expressões de validação associadas a este configurador.
O conjunto retornado é imutável (veja
Collections.unmodifiableSet(Set)).
public List<ParameterGroup> getGroups()
Obtém a lista de grupos associadas a este configurador.
A lista retornada é imutável (veja
Collections.unmodifiableList(List)).
public Set<HiddenParameter> getHiddenParameters()
Obtém o conjunto de parâmetros ocultos associados a este configurador.
O conjunto retornado é imutável (veja
Collections.unmodifiableSet(Set)).
public List<InputFileListParameter> getInputFileListParameters()
Obtém a lista com os parâmetros que aceitam um conjunto de arquivos e/ou diretórios para entrada de dados.
Obs.: a relação é imutável (@see Collections.unmodifiableList(List)
).
public List<OutputFileListParameter> getOutputFileListParameters()
Obtém a lista com os parâmetros que aceitam um conjunto de arquivos e/ou diretórios para saída de dados.
Obs.: a relação é imutável (@see Collections.unmodifiableList(List)
).
public List<InputURLListParameter> getInputURLListParameters()
Obtém a lista com os parâmetros que aceitam um conjunto de arquivos e/ou diretórios (URLs) para entrada de dados.
Obs.: a relação é imutável (@see Collections.unmodifiableList(List)
).
public List<OutputURLListParameter> getOutputURLListParameters()
Obtém a lista com os parâmetros que aceitam um conjunto de arquivos e/ou diretórios (URLs) para saída de dados.
Obs.: a relação é imutável (@see Collections.unmodifiableList(List)
).
public List<InputFileParameter> getInputFileParameters()
Obtém a lista com os parâmetros que aceitam arquivos e/ou diretórios para entrada de dados.
Obs.: a relação é imutável (veja Collections.unmodifiableList(List)
).
getInputFileParameters in class AlgorithmConfiguratorpublic Set<FileURLValue> getInputFiles()
Obtém o conjunto de arquivos de entrada.
Obs.: o conjunto é imutável (veja Collections.unmodifiableSet(Set)
).
getInputFiles in class AlgorithmConfiguratorpublic List<OutputFileParameter> getOutputFileParameters()
Obtém a lista com os parâmetros que aceitam arquivos e/ou diretórios para saída de dados.
Obs.: a relação é imutável (veja Collections.unmodifiableList(List)
).
getOutputFileParameters in class AlgorithmConfiguratorpublic Set<FileURLValue> getOutputFiles()
Obtém o conjunto de arquivos de saída.
Obs.: o conjunto é imutável (veja Collections.unmodifiableSet(Set)
).
getOutputFiles in class AlgorithmConfiguratorpublic List<InputURLParameter> getInputURLParameters()
Obtém a lista com os parâmetros do tipo URL que aceitam arquivos e/ou diretórios para entrada de dados.
Obs.: a relação é imutável (veja Collections.unmodifiableList(List)
).
getInputURLParameters in class AlgorithmConfiguratorpublic Set<FileURLValue> getInputURLs()
Obtém o conjunto de arquivos (URLs) de entrada.
Obs.: o conjunto é imutável (veja Collections.unmodifiableSet(Set)
).
getInputURLs in class AlgorithmConfiguratorpublic List<OutputURLParameter> getOutputURLParameters()
Obtém a lista com os parâmetros que aceitam arquivos e/ou diretórios (URLs) para saída de dados.
Obs.: a relação é imutável (veja Collections.unmodifiableList(List)
).
getOutputURLParameters in class AlgorithmConfiguratorpublic Set<FileURLValue> getOutputURLs()
Obtém o conjunto de arquivos (URLs) de saída.
Obs.: o conjunto é imutável (veja Collections.unmodifiableSet(Set)
).
getOutputURLs in class AlgorithmConfiguratorpublic String getParameterLabel(String parameterName) throws ParameterNotFoundException
getParameterLabel in class AlgorithmConfiguratorparameterName - O nome do parâmetro (Não aceita null).ParameterNotFoundException - Se não existir um parâmetro com o nome
fornecido.public Set<String> getParameterNames()
Obtém a relação de nomes dos parâmetros.
A relação é imutável (veja Collections.unmodifiableSet(Set)).
getParameterNames in class AlgorithmConfiguratorpublic String getParameterType(String parameterName) throws ParameterNotFoundException
getParameterType in class AlgorithmConfiguratorparameterName - O nome do parâmetro (Não aceita null).ParameterNotFoundException - Se não existir um parâmetro com o nome
fornecido.public String getParameterValue(String parameterName) throws ParameterNotFoundException
getParameterValue in class AlgorithmConfiguratorparameterName - O nome do parâmetro (Não aceita null).null caso não haja um valor para o parâmetro.ParameterNotFoundException - Se não existir um parâmetro com o nome
fornecido.public Set<String> getPlatforms()
Obtém uma relação de todas as plataformas suportadas por este configurador de algoritmos.
A relação é imutável (veja Collections.unmodifiableSet(Set)).
getPlatforms in class AlgorithmConfiguratorpublic String getShell()
null se ele não for informado.public SimpleParameter<?> getSimpleParameter(String parameterName)
parameterName - O nome do parâmetro (Não aceita null).null se o parâmetro não for encontrado.public List<SimpleParameter<?>> getSimpleParameters()
Obtém a lista de todos parâmetros simples associados a este configurador de algoritmos.
A lista retornada é imutável (veja
Collections.unmodifiableList(List)).
public Set<Trigger<?>> getTriggers()
Obtém o conjunto de gatilhos associados a este configurador.
O conjunto retornado é imutável (veja
Collections.unmodifiableSet(Set)).
public boolean isEnabled()
isEnabled in class AlgorithmConfiguratortrue se estiver habilitado ou false caso contrário.public boolean isSetDefaultValues()
isSetDefaultValues in class AlgorithmConfiguratortrue se todos os valores são iguais aos valores-padrão ou
false caso contrário.public void importValues(Map<Object,Object> parameterValues)
Importa os valores dos parâmetros de um Map.
importValues in class AlgorithmConfiguratorparameterValues - O mapa de valores de parâmetros (Não aceita null).public String makeCommandLine(CommandLineContext context)
makeCommandLine in class AlgorithmConfiguratorcontext - contexto para criação da linha de comando.protected String makeEnvironmentVariablesDeclaration(CommandLineContext context)
context - Contexto de execução do comando.public void resetValues()
Restaura os valores dos parâmetros para os valores-padrão.
resetValues in class AlgorithmConfiguratorpublic boolean setDefaultInputFile(FileURLValue inputFile)
Atribui um arquivo para ser utilizado com o arquivo de entrada padrão do configurador.
O arquivo de entrada padrão é o arquivo que é atribuido a um dos parâmetros
do tipo arquivo de entrada (veja InputFileParameter) tipicamente
uma operação de duplo-clique na árvore de projetos.
Por exemplo: em um algoritmo para descomprimir dados, o arquivo de entrada padrão poderia ser o arquivo a ser expandido.
setDefaultInputFile in class AlgorithmConfiguratorinputFile - O arquivo de entrada (Aceita null).true se a operação foi realizada com sucesso ou
false se o configurador não aceita arquivo de entrada
padrão ou este tipo de arquivo de entrada padrão.public boolean setEnabled(boolean isEnabled)
Modifica o estado habilitado/desabilitado do configurador de algoritmos.
Dispara o evento
AlgorithmConfiguratorListener.wasSetEnabled(AlgorithmConfigurator).
setEnabled in class AlgorithmConfiguratorisEnabled - Indica se o configurador se tornará habilitado ou
desabilitado.true em caso de sucesso ou false se não houver
mudança de estado.public void setParameterValue(String parameterName, String parameterValue) throws ParseException, ParameterNotFoundException
setParameterValue in class AlgorithmConfiguratorparameterName - O nome do parâmetro (Não aceita null).parameterValue - O valor do parâmetro (Aceita null)ParseException - Se pelo menos um dos valores não estiver em um
formato que não pode ser aceito pelo seu parâmetro.ParameterNotFoundException - Caso não exista um parâmetro com o nome
fornecido.public void updateTriggers()
protected String getCurrentParameterFileVersion()
getCurrentParameterFileVersion in class AlgorithmConfiguratorpublic Validation validate(ValidationContext context) throws RemoteException
validate in class AlgorithmConfiguratorcontext - contexto da validação.RemoteException - em caso de erro na comunicação com servidor.public Boolean allowParametersLoad()
true se o usuário pode selecionar um arquivo para recuperar e salvar valores dos parâmetros
exibidos na interface.Copyright © 2018. All rights reserved.