A codificação UTF-8 estabeleceu-se como o padrão predominante para aplicações web, assegurando a correta exibição de caracteres diversos.
Este artigo detalha como implementar o UTF-8 em servidores de aplicação como IBM WAS, Oracle WebLogic, Tomcat, TC Server e JBoss.
Configuração em Servidores WebSphere
- Aceda à Consola Administrativa do WebSphere.
- Navegue até Servidores >> Servidores de Aplicação.
- Selecione o servidor de aplicação (JVM) que necessita de suporte UTF-8.
- Na secção de Infraestrutura do Servidor, expanda Java e Gestão de Processos.
- Clique em Definição de Processo.
- Aceda à máquina virtual Java.
- Adicione o seguinte parâmetro nos argumentos Java genéricos:
-Dclient.encoding.override=UTF-8
- Confirme as alterações clicando em “OK” e sincronize o nó, se necessário.
- Reinicie o servidor de aplicação (JVM) para que as modificações entrem em vigor.
Configuração no Servidor Oracle WebLogic
- Navegue para o diretório do domínio do WebLogic.
- Entre na pasta “bin”.
- No ficheiro “setDomainEnv.sh”, adicione o seguinte parâmetro à variável JAVA_OPTS:
-Dfile.encoding=utf8
- Reinicie o servidor WebLogic para que as alterações sejam aplicadas.
Configuração no Servidor Tomcat
- Aceda ao diretório de instalação do Tomcat.
- Entre na pasta “conf”.
- No ficheiro “server.xml”, adicione o seguinte parâmetro à porta do conector:
URIEncoding="UTF-8"
Nota: Se tiver múltiplas portas de conector, aplique esta configuração a todas elas.
- Aceda novamente ao diretório de instalação do Tomcat.
- Entre na pasta “bin”.
- No ficheiro “catalina.sh”, adicione os seguintes parâmetros à variável JAVA_OPTS:
-Djavax.servlet.request.encoding=UTF-8 -Dfile.encoding=UTF-8
Exemplo:
JAVA_OPTS=”-Djavax.servlet.request.encoding=UTF-8 -Dfile.encoding=UTF-8”
- Reinicie o servidor Tomcat para que as alterações tenham efeito.
Configuração no Servidor TC
- Navegue até à pasta da instância do TC Server.
- Aceda à pasta “conf”.
- Adicione o seguinte parâmetro à porta do conector no ficheiro “server.xml”:
URIEncoding="UTF-8"
- Navegue para a pasta da instância do TC Server.
- Entre na pasta “bin”.
- No ficheiro “setenv.sh”, adicione o seguinte à variável CATALINA_OPTS:
-Djavax.servlet.request.encoding=UTF-8 -Dfile.encoding=UTF-8
Exemplo:
CATALINA_OPTS="-Djavax.servlet.request.encoding=UTF-8 -Dfile.encoding=UTF-8"
- Reinicie o servidor TC para que as alterações tenham efeito.
Configuração no Servidor de Aplicação JBoss
- Navegue para o diretório de instalação do JBoss.
- Aceda à pasta “bin”.
- No ficheiro “standalone.conf”, adicione o seguinte parâmetro à variável JAVA_OPTS:
-Dfile.encoding=UTF-8
- Reinicie o servidor JBoss para que as modificações entrem em vigor.
Ferramentas para Validação UTF-8
Pode utilizar estas ferramentas online para verificar se a sua aplicação web suporta UTF-8:
http://coderstoolbox.net/string/
Espera-se que as instruções acima auxiliem na configuração do UTF-8 em diversos servidores de aplicações.
Se pretender aprofundar os seus conhecimentos na administração do Oracle WebLogic, considere este curso de Chris Parent.
Se apreciou este artigo, partilhe-o com outros!