validations

Class TrustedServer2ServerInfoValidation

java.lang.Object

validations.AbstractValidation

validations.TrustedServer2ServerInfoValidation

public class TrustedServer2ServerInfoValidation
extends AbstractValidation

Altera o arquivo de propriedades e o arquivo de repositório do serviço de servidores.

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
TrustedServer2ServerInfoValidation()

Method Summary

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, List<String> errors) Obtém mensagens exibidas quando ocorre algum erro que não é genérico.
protected String	getStartMessage() Obtém o texto exibido no início do processamento da validação.
protected String	getSuccessMessage(AbstractValidation.Status status) Obtém a mensagem exibida quando a conversão é bem sucedida.
protected boolean	init() Inicializa as referências ao: diretório de backup, antigo arquivo de propriedades do serviço, novo arquivo de propriedades do serviço, antigo arquivo de repositório do serviço, novo arquivo de repositório do serviç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

TrustedServer2ServerInfoValidation

public TrustedServer2ServerInfoValidation()

Method Detail

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

init

protected boolean init()

Inicializa as referências ao:

• diretório de backup,
• antigo arquivo de propriedades do serviço,
• novo arquivo de propriedades do serviço,
• antigo arquivo de repositório do serviço,
• novo arquivo de repositório do serviço.

Os dois últimos podem ser nulos caso o serviço não esteja utilizando o repositório. 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)

validate

protected boolean validate()
                    throws validations.ValidationException

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

Specified by:

validate in class AbstractValidation

Returns:

true se o novo arquivo de propriedades existir, indicando que nenhuma alteração precisa ser feita; ou false, caso o contrário.

Throws:

ValidationException - caso o número de arquivos de propriedades do serviço seja diferente de um.

See Also:

Validator, AbstractValidation.applyPatch()

getStartMessage

protected 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.

getSpecificFailureMessage

protected void getSpecificFailureMessage(AbstractValidation.Status status,
                                         List<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()

getSuccessMessage

protected 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

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

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