Transmitindo Informações sobre o Cliente para um Banco de Dados
Usando uma função de API ou de rastreio do WebSphere Application Server, é possível passar informações exclusivas do cliente sobre cada conexão originada da mesma origem de dados.
Sobre Esta Tarefa
- O gerenciador de conexões não pode alterar dinamicamente as informações do cliente sobre a origem de dados ou as conexões obtidas dessa origem de dados.
- O gerenciador de conexões deve configurar as mesmas informações do cliente sobre todas as conexões obtidas dessa origem de dados. Por exemplo, se você configurar ApplicationName como parte da propriedade clientInformation da origem de dados, todas as conexões nessa origem de dados terão o mesmo nome de aplicativo.
O Application Server oferece dois métodos de transmitir as informações do cliente que fornecem a flexibilidade de gerenciamento de conexão necessária. O método é usado para configurar as informações do cliente sobre algumas conexões e não sobre outras, bem como configurar informações de clientes diferentes sobre diferentes conexões com o banco de dados a partir da mesma origem de dados.
Procedimento
Exemplo: Configurando Informações do Cliente com a API setClientInformation(Properties)
É possível configurar as informações do cliente do WebSphere Application Server nas conexões para passar essas informações para o seu banco de dados com essa API.
O código de exemplo a seguir chama setClientInformation(Properties) no objeto com.ibm.websphere.rsadapter.WSConnection.
import com.ibm.websphere.rsadapter.WSConnection;
.....
try {
InitialContext ctx = new InitialContext();
// Executar uma pesquisa no serviço de nomes para obter o objeto DataSource.
DataSource ds = (javax.sql.DataSource)ctx.lookup("java:comp/jdbc/myDS");
}catch (Exception e) {System.out.println("got an exception during lookup: " + e);}
WSConnection conn=(WSConnection)ds.getConnection();
Properties props = new properties();
props.setProperty(WSConnection.CLIENT_ID, "user123");
props.setProperty(WSConnection.CLIENT_LOCATION, "127.0.0.1");
props.setProperty(WSConnection.CLIENT_ACCOUNTING_INFO, "accounting");
props.setProperty(WSConnection.CLIENT_APPLICATION_NAME, "appname");
props.setProperty(WSConnection.CLIENT_OTHER_INFO, "cool stuff");
conn.setClientInformation(props);
conn.close()
Parâmetros
- WSConnection.CLIENT_ACCOUNTING_INFO
- WSConnection.CLIENT_LOCATION
- WSConnection.CLIENT_ID
- WSConnection.CLIENT_APPLICATION_NAME
- WSConnection.CLIENT_OTHER_INFO
- WSConnection.OTHER_CLIENT_TYPE
Exceções
Essa API cria uma exceção SQL se o banco de dados emitir uma exceção ao configurar os dados.