validations

Class PersistencyMoveValidation

java.lang.Object

validations.AbstractValidation

validations.PersistencyMoveValidation

public final class PersistencyMoveValidation
extends AbstractValidation

Validação de nova estrutura de diretórios de persistência

Author:

Tecgraf/PUC-Rio

Nested Class Summary

Nested classes/interfaces inherited from class validations.AbstractValidation

AbstractValidation.Status

Field Summary

Fields inherited from class validations.AbstractValidation

logger, RESOURCE_DIR_NAME

Constructor Summary

Constructors

Constructor and Description
PersistencyMoveValidation()

Method Summary

Methods

Modifier and Type	Method and Description
protected boolean	applyPatch() Aplica as correções.
protected boolean	backupData() Faz backup dos dados que serão alterados.
protected void	finish() Finalização do processo.
protected void	getSpecificFailureMessage(AbstractValidation.Status status, java.util.List<java.lang.String> errors) Obtém mensagens exibidas quando ocorre algum erro que não é genérico.
protected java.lang.String	getStartMessage() Obtém o texto exibido no início do processamento da validação.
protected java.lang.String	getSuccessMessage(AbstractValidation.Status status) Obtém a mensagem exibida quando a conversão é bem sucedida.
protected boolean	init() Inicialização.
protected boolean	restoreBackup() Desfaz as alterações, restaurando os backups feitos por AbstractValidation.backupData().
protected boolean	runsOnlyOnce() Indica se a validação só precisa ser executada com sucesso uma única vez.
protected boolean	validate() Valida o sistema, sem efetuar nenhuma alteração.

Methods inherited from class validations.AbstractValidation

getAlgorithmDir, getBackupDirPath, getMandatorySystemProperty, getProjectDir, getStatus, getSystemProperty, getTempDirPath, isValidatingOnly, isVerbose, removeBackupDir, rollback, run

Methods inherited from class java.lang.Object

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

Constructor Detail

PersistencyMoveValidation

public PersistencyMoveValidation()

Method Detail

applyPatch

protected boolean applyPatch()

Aplica as correções. Este método só é executado se tanto AbstractValidation.validate() quanto AbstractValidation.isValidatingOnly() retornaram false.

Specified by:

applyPatch in class AbstractValidation

Returns:

true se as correções foram aplicadas com sucesso, false em caso contrário.

finish

protected void finish()

Finalização do processo. Permite a exibição de mensagens customizadas etc. Este método é executado mesmo em caso de falha, portanto cabe a ele verificar o status da validação.

Specified by:

finish in class AbstractValidation

See Also:

AbstractValidation.status

getSpecificFailureMessage

protected void getSpecificFailureMessage(AbstractValidation.Status status,
                             java.util.List<java.lang.String> errors)

Obtém mensagens exibidas quando ocorre algum erro que não é genérico.

Specified by:

getSpecificFailureMessage in class AbstractValidation

Parameters:

status - status da validação

errors - lista a ser preenchida com as mensagens de erro

See Also:

AbstractValidation.getFailureMessage()

getStartMessage

protected java.lang.String getStartMessage()

Obtém o texto exibido no início do processamento da validação.

Specified by:

getStartMessage in class AbstractValidation

Returns:

texto exibido no início do processamento da validação. Pode ser null.

getSuccessMessage

protected java.lang.String getSuccessMessage(AbstractValidation.Status status)

Obtém a mensagem exibida quando a conversão é bem sucedida.

Specified by:

getSuccessMessage in class AbstractValidation

Parameters:

status - status da validação

Returns:

mensagem exibida quando a validação bem sucedida

init

protected boolean init()

Inicialização. Este método deve fazer as inicializações necessárias à execução da validação, mas não deve implementar nenhum processamento.

Specified by:

init in class AbstractValidation

Returns:

flag indicando se a inicialização foi bem sucedida. Caso não seja, interrompe o processo.

See Also:

AbstractValidation.run(Validator)

backupData

protected boolean backupData()

Faz backup dos dados que serão alterados. É executado pelo validador antes da aplicação do patch.

Specified by:

backupData in class AbstractValidation

Returns:

true se o backup foi realizado com sucesso

See Also:

Validator, AbstractValidation.applyPatch()

restoreBackup

protected boolean restoreBackup()

Desfaz as alterações, restaurando os backups feitos por AbstractValidation.backupData(). É executado pelo validador quando AbstractValidation.applyPatch() retorna false.

IMPORTANTE: este método pode ser executado mesmo que o patch tenha sido bem-sucedido, caso um patch subsequente falhe.

Specified by:

restoreBackup in class AbstractValidation

Returns:

true se a restauração foi bem-sucedida

validate

protected boolean validate()

Valida o sistema, sem efetuar nenhuma alteração.

Specified by:

validate in class AbstractValidation

Returns:

true se a validação foi bem sucedida, i.e. se não é necessário aplicar uma conversão. Este método deve retornar false apenas se a execução transcorreu sem problemas, e foi detectado que é necessário aplicar uma conversão. Exceções e outros erros que impeçam a execução da validação devem ser sinalizados via ValidationException

See Also:

Validator, AbstractValidation.applyPatch()

runsOnlyOnce

protected boolean runsOnlyOnce()

Indica se a validação só precisa ser executada com sucesso uma única vez.

Specified by:

runsOnlyOnce in class AbstractValidation

Returns:

true se a validação só precisa ser executada com sucesso uma única vez