Definições de Fábricas de Conexão do J2C

Utilize esta página para especificar definições para uma fábrica de conexões.

Para exibir essa página do console administrativo, clique em Recursos > Adaptadores de Recursos > resource_adapter > Fábricas de Conexões J2C > connection_factory.

Guia Configuração

Escopo
Especifique o nível no qual esta definição de recurso é visível -- célula, nó ou nível de servidor.

Recursos como Provedores JDBC, Ligações de espaço de nomes ou bibliotecas compartilhadas podem ser definidos em vários escopos, com os recursos definidos em escopos mais específicos substituindo duplicatas definidas em escopos mais gerais.

Observe que independentemente do escopo de um recurso definido, as propriedades do recurso aplicam-se apenas a um nível de servidor individual. Por exemplo, se o escopo de uma origem de dados for definido no nível Célula, todos os usuários daquela Célula poderão consultar e utilizar a origem de dados, que é exclusiva naquela Célula. Entretanto, as definições de propriedade de recursos são locais para cada servidor na Célula. Por exemplo, se você definir número máximo de conexões para 10, então, cada servidor da Célula poderá ter 10 conexões.

Célula
O escopo mais geral. Os recursos definidos no escopo Célula são visíveis a partir de todos os Nós e servidores, a menos que sejam substituídos. Para exibir recursos definidos no escopo célula, não especifique um nome de servidor ou nó no formulário de seleção de escopo.
O escopo padrão para a maioria dos tipos de recursos. Os recursos definidos no escopo Nó substituem todas as duplicatas definidas no escopo Célula e ficam visíveis para todos os servidores no mesmo nó, a menos que sejam substituídos em um escopo do servidor naquele nó. Para exibir recursos definidos no escopo nó, não especifique um servidor, mas selecione um nome de nó no formulário de seleção de escopo.
Servidor
O escopo mais específico para definir recursos. Os recursos definidos no escopo Servidor substituem todas as definições de recurso em duplicata definidas no escopo Célula ou escopo Nó pai e ficam visíveis somente para um servidor específico. Para exibir recursos definidos em um escopo de servidor, especifique um nome do servidor bem como um nome de nó no formulário de seleção de escopo.

Quando os recursos forem criados, eles serão sempre criados no escopo atual selecionado no painel. Para exibir recursos em outros escopos, especifique um nó ou servidor diferente no formulário de seleção de escopo.

Tipo de Dados String
Nome
Especifica uma lista de nomes de exibição das fábricas de conexões.
Tipo de Dados String
Nome de JNDI
Especifica o nome de JNDI desta fábrica de conexões.

Por exemplo, o nome pode ser eis/myECIConnection.

Depois de definir esse valor, salve-o e inicie novamente o servidor. Essa cadeia poderá ser vista ao executar dumpNameSpace.

Tipo de Dados String
Padrão eis/nome de exibição
Descrição
Especifica uma descrição de texto desta fábrica de conexões.
Tipo de Dados String
Categoria
Especifica uma cadeia que pode ser utilizada para classificar ou agrupar esta fábrica de conexões.
Tipo de Dados String
Preferência de Autenticação
Especifica os mecanimos de autenticação definidos para essa fábrica de conexões.

Essa definição especifica qual dos mecanismos de autenticação definido para o adaptador de recursos correspondente aplica-se a essa fábrica de conexões. Valores comuns, dependendo das capacidades do adaptador de recursos, são: KERBEROS, BASIC_PASSWORD e None.

Se None for escolhido, o componente do aplicativo terá que gerenciar a autenticação (<res-auth>Application</res-auth>). Neste caso, o ID do usuário e a senha são obtidos de um dos seguintes elementos:

  • O alias de autenticação gerenciado por componente
  • Propriedades Personalizadas de Senha, Nome do Usuário
  • Cadeias transmitidas no método getConnection

Por exemplo, se duas entradas do mecanismo de autenticação estiverem definidas para um adaptador de recursos no documento ra.xml:

  • <authentication-mechanism-type>BasicPassword</authentication-mechanism-type>
  • <authentication-mechanism-type>Kerbv5</authentication-mechanism-type>
a preferência de autenticação especifica o mecanismo a ser utilizado para autenticação gerenciada por contêiner. Uma exceção é emitida durante a inicialização do servidor, se um mecanismo que não é suportado pelo adaptador de recursos for selecionado.

Tipo de Dados Lista de seleção
Padrão BASIC_PASSWORD
Alias de Autenticação gerenciado por componentes
Especifica os dados de autenticação para conexão ao recurso gerenciada por componente. Escolha entre os alias definidos em Segurança > Configuração de JAAS > Dados de Autenticação de J2C.

Para definir um novo alias que ainda não esteja exibido na lista de opções:

  • Clique em Aplicar para expor Itens Relacionados.
  • Clique em Entradas de Dados de Autenticação J2C.
  • Defina um alias.
  • Clique no nome da fábrica de conexões na parte superior da página Entradas de Dados de Autenticação J2C para retornar à página da fábrica de conexões.
  • Selecione o alias.

Tipo de Dados Lista de seleção
Alias de Autenticação gerenciado por componentes
Especifica os dados de autenticação (um caminho de cadeia convertido para ID do usuário e senha) para conexão ao recurso gerenciada por contêiner. Escolha entre os alias definidos em Segurança > Configuração de JAAS > Dados de Autenticação de J2C.

Para definir um novo alias que ainda não esteja exibido na lista de opções:

  • Clique em Aplicar para expor Itens Relacionados.
  • Clique em Entradas de Dados de Autenticação J2C.
  • Defina um alias.
  • Clique no nome da fábrica de conexões na parte superior da página Entradas de Dados de Autenticação J2C para retornar à página da fábrica de conexões.
  • Selecione o alias.

Tipo de Dados Lista de seleção
Alias de Configuração do Mapeamento
Permite que os usuários selecionem na lista Segurança > Configuração de JAAS > Configuração de Logins de Aplicativos.

A configuração JAAS de DefaultPrincipalMapping mapeia o alias de autenticação para o ID do usuário e a senha. Você pode definir e utilizar outras configurações de mapeamento.

Tipo de Dados Lista de seleção

Informações relacionadas

Botões do console administrativo
Recursos de páginas do console administrativo