Serviço de Conexão de Teste
O WebSphere Application Server fornece um serviço de conexão de teste para validar configurações da origem de dados. A operação testConnection instancia a configuração de origem de dados, obtém uma conexão e, em seguida, fecha imediatamente a conexão.
Se você associar suas origens de dados às variáveis do WebSphere consulte o tópico, Criando, Editando e Excluindo Variáveis WebSphere, para verificar se você as configurou corretamente. Uma exceção não é possível localizar a variável resulta da tentativa de utilização de uma origem de dados chamada por meio de uma variável definida incorretamente.
Ativando o Serviço de Conexão de Teste
Há três maneiras de ativar o serviço de conexão de teste: utilizando o console administrativo, a ferramenta wsadmin ou um programa Java™ independente. Cada processo chama os mesmos métodos no mesmo MBean.
Administrative console
WebSphere Application Server permite testar uma conexão a partir do console administrativo simplesmente apertando um botão: as páginas Coleção de Origem de Dados, Configurações de Origem de Dados, Coleção de Origem de Dados Versão 4 e Configurações da Origem de Dados Versão 4 têm os botões Testar Conexão. Após definir e salvar uma origem de dados, é possível clicar nesse botão para assegurar que os parâmetros na definição de origem de dados estejam corretos. Na página da coleção, é possível selecionar várias origens de dados e testá-las todas de uma vez. Observe que há certas condições que devem ser satisfeitas primeiro. Para obter informações adicionais, consulte o tópico, Testando uma conexão com o console administrativo.
A conexão de teste falhou para a origem de dados isagent no servidor server1 no nó
svtaix24Node01 com a seguinte exceção: java.lang.Exception:
java.sql.SQLException: JZ006: Caught IOException: java.net.ConnectException: Um
host remoto recusou uma operação de conexão tentada.DSRA0010E: SQL State = JZ006,
Código de Erro = 0
Esta exceção ocorre quando o número da porta da origem de dados Sybase
não tem correspondência para a porta configurada no servidor Sybase. O número da porta
padrão é 5000. Verifique o número da porta do seu servidor Sybase no arquivo de interfaces
em /<sybase install directory>.Ferramenta WsAdmin
A ferramenta wsadmin fornece uma interface de script para um intervalo integral das atividades de administração do WebSphere Application Server. Como a funcionalidade Testar Conexão é implementada como um método em um MBean e wsadmin pode chamar métodos MBean, wsadmin pode ser utilizada para testar conexões para origens de dados. Você possui duas opções para testar uma conexão de origem de dados através de wsadmin:
O objeto AdminControl de wsadmin tem uma operação testConnection que testa as propriedades de configuração de um objeto de origem de dados. Para obter informações, consulte o tópico, Testando uma conexão usando o wsadmin.
É possível também testar uma conexão chamando a operação MBean. Use o exemplo no tópico, Exemplo: Testando conexão de origem de dados usando wsadmin, como um guia para esta técnica.
Programa independente Java
Finalmente, é possível testar uma conexão executando o método testConnection no MBean DataSourceCfgHelper. Esse método permite transmitir o ID de configuração da origem de dados configurada. O programa Java conecta-se a um servidor JMX (Java Management Extensions) em execução para acessar o MBean. Em uma instalação base do Application Server, você conecta-se ao servidor JMX em execução no servidor de aplicativos, geralmente na porta 8880.
O valor de retorno dessa chamada é 0, um número positivo ou uma exceção. 0 indica que a operação concluiu com êxito, sem avisos. Um número positivo indica que a operação concluiu com êxito, com o número de avisos. Uma exceção indica que o teste da conexão falhou.
O código de amostra a seguir cria uma instância da origem de dados e uma instância da conexão associada, além de testá-las para assegurar a conectividade do banco de dados.
Este programa utiliza JMX para se conectar a um servidor em execução e chamar o método testConnection no MBean DataSourceCfgHelper. O acrônimo ND em uma linha de comentário indica que o seguinte código se aplica ao WebSphere Application Server WebSphere Application Server, Network Deployment. A palavra Base em uma linha de comentário indica que o seguinte código se aplica ao WebSphere Application Server.
/**
* Descrição
* Programa de teste do adaptador de recurso para certificar-se de que as interfaces de MBean funcionam.
* As seguintes interfaces são testadas
*
* --- testConnection()
*
*
* O seguinte é necessário para executar
* C:\src>java -Djava.ext.dirs=C:\WebSphere\AppServer\lib;C:\WebSphere\AppServer\java\jre\lib\ext testDSGUI
* deve incluir jre para log.jar e mail.jar, exceção da classe else get não localizada
*
*
*/
import java.util.Iterator;
import java.util.Locale;
import java.util.Properties;
import java.util.Set;
import javax.management.InstanceNotFoundException;
import javax.management.MBeanException;
import javax.management.MalformedObjectNameException;
import javax.management.ObjectName;
import javax.management.RuntimeMBeanException;
import javax.management.RuntimeOperationsException;
import com.ibm.websphere.management.AdminClient;
import com.ibm.websphere.management.AdminClientFactory;
import com.ibm.ws.rsadapter.exceptions.DataStoreAdapterException;
public class testDSGUI {
//Utilizar a porta 8880 para uma instalação Base ou a porta 8879 para instalação ND
String port = "8880";
// String port = "8879";
String host = "localhost";
final static boolean verbose = true;
// por exemplo, um ID de configuração para DataSource declarado no nível do nó para Base
private static final String resURI = "cells/cat/nodes/cat|resources.xml#DataSource_1";
// por exemplo, um DataSource 4.0 declarado no nível do nó para Base
// private static final String resURI = "cells/cat/nodes/cat|resources.xml#WAS40DataSource_1";
// por exemplo, DataSource Apache Derby declarado no nível do servidor para Base
//private static final String resURI = "cells/cat/nodes/cat/servers/server1/resources.xml#DataSource_6";
// por exemplo, DataSource no nível do nó para ND
//private static final String resURI = "cells/catNetwork/nodes/cat|resources.xml#DataSource_1";
// por exemplo, DataSource no nível do servidor para ND
//private static final String resURI = "cells/catNetwork/nodes/cat/servers/server1|resources.xml#DataSource_4";
// por exemplo, DataSource no nível da célula para ND
//private static final String resURI = "cells/catNetwork|resources.xml#DataSource_1";
public static void main(String[] args) {
testDSGUI cds = new testDSGUI();
cds.run(args);
}
/**
* Este método testa o ResourceMbean.
*
* @param args
* @exception Exception
*/
public void run(String[] args) {
try {
System.out.println("Connecting to the application server.......");
/*************************************************************************/
/** Inicializar o AdminClient */
/*************************************************************************/
Properties adminProps = new Properties();
adminProps.setProperty(AdminClient.CONNECTOR_TYPE, AdminClient.CONNECTOR_TYPE_SOAP);
adminProps.setProperty(AdminClient.CONNECTOR_HOST, host);
adminProps.setProperty(AdminClient.CONNECTOR_PORT, port);
AdminClient adminClient = null;
try {
adminClient = AdminClientFactory.createAdminClient(adminProps);
} catch (com.ibm.websphere.management.exception.ConnectorException ce) {
System.out.println("NLS: Cannot make a connection to the application server\n");
ce.printStackTrace();
System.exit(1);
}
/*************************************************************************/
/** Localizar o Mbean */
/*************************************************************************/
ObjectName handle = null;
try {
// Enviar uma cadeia localizadora
// por exemplo, para uma instalação Base isto é suficiente
ObjectName queryName = new ObjectName("WebSphere:type=DataSourceCfgHelper,*");
// para ND é preciso especificar de qual nó/processo você deseja testar
// por exemplo, executar no servidor
//ND: ObjectName queryName = new OjectName
("WebSphere:cell=catNetwork,node=cat,process=server1,type=DataSourceCfgHelper,*");
// por exemplo, executar no agente do nó
//ND: ObjectName queryName = new ObjectName
("WebSphere:cell=catNetwork,node=cat,process=nodeagent,type=DataSourceCfgHelper,*");
//ND: eg run in the Manager
//ND: ObjectName queryName = new ObjectName
("WebSphere:cell=catNetwork,node=catManager,process=dmgr,type=DataSourceCfgHelper,*");
Set s = adminClient.queryNames(queryName, null);
Iterator iter = s.iterator();
while (iter.hasNext()) {
// usar o primeiro MBean que for localizado
handle = (ObjectName) iter.next();
System.out.println("Found this ->" + handle);
}
if (handle == null) {
System.out.println("NLS: Did not find this MBean>>" + queryName);
System.exit(1);
}
} catch (MalformedObjectNameException mone) {
System.out.println("Verifique a variável de programa queryName" + mone);
} catch (com.ibm.websphere.management.exception.ConnectorException ce) {
System.out.println("Não é possível conectar-se ao servidor de aplicativos" + ce);
}
/*************************************************************************/
/** Construir parâmetros para transmitir ao Mbean */
/*************************************************************************/
String[] signature = { "java.lang.String" };
Object[] params = { resURI };
Object result = null;
if (verbose) {
System.out.println("\nTesting connection to the database using " + handle);
}
try {
/*************************************************************************/
/** Começar a testar a conexão ao banco de dados */
/*************************************************************************/
result = adminClient.invoke(handle, "testConnection", params, signature);
} catch (MBeanException mbe) {
// ****** todas as exceções do usuário vêm aqui
if (verbose) {
Exception ex = mbe.getTargetException(); // esta é uma exceção real do Mbean
System.out.println("\nNLS:Mbean Exception was received contains " + ex);
ex.printStackTrace();
System.exit(1);
}
} catch (InstanceNotFoundException infe) {
System.out.println("Cannot find " + infe);
} catch (RuntimeMBeanException rme) {
Exception ex = rme.getTargetException();
ex.printStackTrace(System.out);
throw ex;
} catch (Exception ex) {
System.out.println("\nUnexpected Exception occurred: " + ex);
ex.printStackTrace();
}
/*************************************************************************/
/** Processar o resultado. O resultado será o número de avisos */
/** emitidos. Um resultado de 0 indica uma conexão com êxito sem */
/** avisos. */
/*************************************************************************/
//Um resultado de 0 indica uma conexão com êxito sem avisos.
System.out.println("Result= " + result);
} catch (RuntimeOperationsException roe) {
Exception ex = roe.getTargetException();
ex.printStackTrace(System.out);
} catch (Exception ex) {
System.out.println("General exception occurred");
ex.printStackTrace(System.out);
}
}
}
Tópico de Conceito