Referências de recursos de projeto [Configurações]

Os componentes de blueprint podem acessar WebSphere Application Server referências de recursos. Cada referência é declarada em um arquivo XML do Blueprint e pode ser protegida usando-se um alias de autenticação Java™ Platform, Enterprise Edition (Java EE) Connector Architecture (JCA). Cada pacote configurável em um aplicativo OSGi pode conter qualquer número de declarações de referências de recurso em seus vários arquivos XML Blueprint.

Para visualizar esse painel no console administrativo, clique em um dos seguintes caminhos:

Aplicativos > Tipos de Aplicativos > Aplicativos de Nível Comercial > application_name > [Ativos Implementados] Incluir > Incluir Ativo > asset_name > Etapa do assistente: Ligar referências de recurso Blueprint
Aplicativos > Tipos de Aplicativos > Aplicativos de Nível Comercial > application_name > composition_unit_name > [Propriedades Adicionais] Referências de recursos Blueprint

A etapa do assistente Ligar referências do recurso Blueprint e a propriedade Referências do recurso Blueprint estarão visíveis apenas se o pacote configurável incluir declarações de referência do recurso Blueprint.

Quando você assegura as referências de recurso, essas referências de recurso podem ser vinculadas apenas aos aliases de autenticação JCA que existem em todo o servidor ou cluster em que o aplicativo é implementado. Um aplicativo OSGi pode ser implementado para múltiplos servidores e clusters que estão no mesmo domínio de segurança. Assim, cada alias de autenticação JCA deve existir no domínio de segurança dos servidores e clusters de destino ou no domínio de segurança global.

Você deve declarar as referências de recurso no arquivo XML Blueprint. Por exemplo:

<blueprint xmlns="http://www.osgi.org/xmlns/blueprint/v1.0.0" 
  xmlns:rr="http://www.ibm.com/appserver/schemas/8.0/blueprint/resourcereference">
  <!-- Other Blueprint declarations ... -->
  
  <rr:resource-reference id="resourceRef" 
          interface="javax.sql.DataSource"
          filter="(osgi.jndi.service.name=jdbc/Account)">
    <rr:res-auth>Container</rr:res-auth>
    <rr:res-sharing-scope>Shareable</rr:res-sharing-scope>
  </rr:resource-reference>
</blueprint>

Essa declaração inclui o ID de referência de recurso (por exemplo, resourceRef), o filtro de serviço (por exemplo, jdbc/Account), o tipo de autenticação (por exemplo, Container) e a configuração de compartilhamento (por exemplo, Shareable).

As referências de recurso Blueprint para ligações do alias de autenticação para cada pacote configurável estão armazenadas em um arquivo ibm-eba-bnd.xml no diretório META-INF desse pacote configurável. Se um aplicativo OSGi contiver qualquer um desses arquivos quando for implementado como um ativo, esses arquivos fornecem os valores de alias de autenticação padrão que são usados na ligação das referências de recurso. Por exemplo:

<eba-bnd>
  <resource-ref>
    <jndi-name>jdbc/Acount</jndi-name>
    <authentication-alias>Alias1</authentication-alias>
    <interface>javax.sql.DataSource</interface>
    <authentication>Container</authentication>
    <sharing-scope>Shareable</sharing-scope>
    <id>resourceRef</id>
  </resource-ref>
</eba-bnd>

Propriedades Gerais

Identificador do pacote configurável composto

Este identificador é exibido apenas se o ativo EBA usar pacotes configuráveis compostos. Cada pacote configurável composto é identificado por uma sequência no seguinte formato: Composite bundle archive (CBA)'composite.bundle.symbolic.name_composite.bundle.version'. Os pacotes configuráveis que são parte de um pacote configurável composto são listados abaixo do identificador do pacote configurável composto.

Nome simbólico do pacote configurável composto: O nome não localizável para este pacote configurável composto.
Versão do pacote configurável composto: A versão desse pacote configurável composto.

O nome simbólico, juntamente com a versão, identifica exclusivamente um pacote configurável composto.

Identificador de Pacote Configurável

Cada pacote configurável é identificado por uma sequência que contém o nome simbólico do pacote configurável e a versão em pacote configurável. Os pacotes configuráveis que são parte de um pacote configurável composto são listados abaixo do identificador do pacote configurável composto.

Nome Simbólico do Pacote Configurável

O nome não localizável para este pacote configurável.

Versão do Pacote Configurável

A versão deste pacote configurável.

O nome simbólico do pacote configurável, juntamente com a versão do pacote configurável, identifica exclusivamente um pacote configurável.

ID da Referência de Recurso

O ID da referência de recurso conforme declarado no Blueprint.

Interface da Referência de Recurso

A interface para essa referência de recurso.

Seu aplicativo Blueprint pode usar qualquer um dos seguintes tipos de recursos:

Destinos das filas JMS do sistema de mensagens padrão
Destinos do tópico JMS do sistema de mensagens padrão
Origem de Dados
Connection Factory JMS Genérica
Sessão de Correio
Connection Factory J2C
Connection factory de fila JMS para o provedor JMS do WebSphere MQ
Destino de fila JMS para o WebSphere MQ
Connection factory de tópico JMS para o WebSphere MQ
Destino de tópico JMS para o WebSphere MQ
Connection factory JMS unificado para o WebSphere MQ
Configuração de URL

Filtro do Serviço de Referência de Recurso

O nome do filtro de serviço que é o destino de mapeamento da referência de recurso. Por exemplo, jdbc/AccountDS2.

Autenticação da Referência de Recurso

A referência de recurso é autenticada pelo aplicativo ou pelo contêiner.

Compartilhamento da Referência de Recurso

A referência de recurso é compartilhável ou não compartilhável.

Alias de Autenticação

O alias de autenticação, se houver, que é usado para proteger a referência de recurso.

Para cada referência, é possível selecionar opcionalmente um alias de autenticação da lista. Aliases de autenticação padrão (dos arquivos ibm-eba-bnd.xml) são oferecidos somente se existirem em cada servidor ou cluster de destino.

Links marcados (on-line) requerem acesso à Internet. Cada link inicia uma procura para o tópico no centro de informações on-line. Quando os resultados da procura forem listados, selecione o tópico que corresponda melhor à sua configuração.

Verificar Atualizações para Este Tópico (on-line)

Nome de arquivo: OSGi_BLA_BlueprintResourceRefs.html