Modernize primeiro o sistema antigo e construa a escada de compatibilidade

A primeira vez que abri um projeto Java há vinte anos, a primeira coisa que vi não foi o cheiro do código, mas o cheiro do tempo. O build.xml ainda está lá, mas o pom.xml não está; a estrutura de diretórios é antiquada, a entrada de teste também é antiquada e até mesmo “se é possível reconstruir um produto executável” precisa ser reconfirmado. O erro mais comum nesta fase é focar nas classes e métodos e ignorar que o que realmente bloqueia a modernização é o ambiente e a entrada.

A primeira coisa a fazer ao modernizar sistemas antigos é construir uma escada de compatibilidade. A base da escada normalmente tem apenas uma coisa: fazer com que o antigo sistema funcione de forma estável dentro das antigas regras e, de preferência, servir como uma cápsula do tempo. Docker, JDK antigo, ferramentas de construção antigas, comandos de teste antigos, essas coisas parecem grosseiras, mas são muito eficazes. Enquanto essa base não estiver correta, cada mudança subsequente irá misturar novos ruídos: se é o código que está quebrado ou a JVM, a imagem, a arquitetura e os plug-ins que estão quebrados, é impossível dizer.

Depois foi a vez de escolher a ponte. O objetivo da ponte é muito específico: uma extremidade é conectada ao código-fonte antigo e a outra extremidade é conectada à nova máquina. Este projeto finalmente caiu para Java 8 e Gradle 7.6, que apenas ficou preso nas restrições de ambas as extremidades: Java 17 não está mais disposto a compilar o código-fonte do Java 1.5 e Java 6 não pode ser executado no ambiente nativo do ARM64. Se a ponte estiver errada, a modernização ficará presa na cadeia de ferramentas; se a ponte estiver correta, as migrações subsequentes poderão avançar passo a passo.

O mais útil aqui é deixar o modelo grande fazer a organização e a tradução. Ele pode ajudar a traduzir a lógica do Ant para o Gradle, mapear diretórios de volta ao layout antigo e remover essas configurações repetitivas e mecânicas. Por exemplo, aponte explicitamente o diretório do código-fonte para o caminho antigo e adicione uma tarefa personalizada para executar o antigo teste main():

java {
    sourceCompatibility = JavaVersion.VERSION_1_5
    targetCompatibility = JavaVersion.VERSION_1_5
}
sourceSets {
    main {
        java {
            srcDirs = ['java']
        }
    }
}
tasks.register('runLegacyTest', JavaExec) {
    mainClass.set(project.findProperty('mainClass'))
    classpath = sourceSets.main.runtimeClasspath
}

O significado desta configuração é tornar explícitas as regras do velho mundo. A coisa mais problemática em projetos antigos muitas vezes não é a falta de habilidade, mas essa habilidade está escondida nos hábitos. O teste é executado por meio da entrada main(), o código-fonte é colocado no diretório antigo e a construção é escrita assumindo o caminho da era Ant. O Copilot pode economizar tempo aqui, mas economiza tempo de tradução, não de julgamento.

O tempo de julgamento não pode ser terceirizado. Gradle 8 parece mais recente, Java 17 parece mais moderno e saltar diretamente para cima também parece mais limpo, mas essas opções podem não satisfazer as restrições do código-fonte antigo e dos testes antigos ao mesmo tempo. O maior medo na modernização é considerar as atualizações de ferramentas como um progresso e a execução de comandos como uma compreensão do sistema. Enquanto um projeto não atingir a linha de base operacional, o teste verde não é considerado uma vitória, só pode ser considerado como não atingindo a superfície exposta por enquanto.

A abordagem em que mais confio é primeiro dividir o problema em quatro níveis: se pode ser executado, se pode ser editado, se pode ser testado e se pode ser modificado. O primeiro nível é reproduzir a cena, o segundo nível é determinar a ponte, o terceiro nível é determinar o que o teste antigo salvou e o quarto nível é a refatoração real. O Copilot é particularmente útil nos dois primeiros níveis. É adequado para trabalho físico seguindo logs e estruturas de diretórios e para reunir pistas fragmentadas em um mapa legível. No quarto nível, o modelo deve ser responsável apenas pelo transporte e pelas instruções, e as pessoas têm que contar com outras pessoas para tomar decisões.

O resultado mais valioso da modernização do antigo sistema é transformar um monte de coisas que “deveriam funcionar” em “coisas que realmente funcionam e sabemos por que funcionam”. Uma vez estabelecida esta escada de compatibilidade, o desmantelamento posterior terá um ritmo e as mudanças terão limites. O copiloto é como um auxiliar na linha de frente neste momento, segurando uma lanterna para ver idade, ingresso e dependências. O que realmente determina a direção é o julgamento da história do antigo sistema.