Uma especificação de ativação JMS está associada a um ou mais beans acionados por mensagens e fornece a configuração necessária para o recebimento de mensagens.
Você criará uma especificação de ativação JMS se quiser utilizar um bean acionado por mensagens para se comunicar com o provedor de sistemas de mensagens padrão utilizando o Java EE Connector Architecture (JCA) 1.5. O JCA fornece conectividade Java entre servidores de aplicativos, como o WebSphere Application Server, e sistemas de informações corporativas. Ele fornece uma forma padronizada de integrar provedores JMS aos servidores de aplicativos Java EE e fornece uma estrutura para troca de dados com sistemas corporativos, em que os dados são transferidos na forma de mensagens.
Todas as propriedades de configuração da especificação de ativação, com exceção de Name, JNDI name, Destination JNDI name e Authentication alias, são substituídas pelas propriedades de configuração de ativação nomeadas apropriadamente no descritor de implementação de bean acionado por mensagens EJB 2.1 associado ou posterior. Para um bean acionado por mensagens do EJB 2.0, as propriedades Tipo de Destino, Durabilidade da Assinatura, Modo de Reconhecimento e Seletor de Mensagens são substituídas pelos elementos correspondentes no descritor de implementação. Para qualquer tipo de bean, a propriedade Nome JNDI de Destino pode ser substituída por um valor especificado nas ligações de beans acionados por mensagens.
As propriedades da especificação de ativação influenciam como o provedor do sistema de mensagens padrão escolhe o mecanismo do sistema de mensagens ao qual o aplicativo do bean acionado por mensagens se conecta. Por padrão, o ambiente conecta automaticamente aplicativos a um mecanismo do sistema de mensagens disponível no barramento. No entanto, é possível especificar detalhes adicionais na configuração para influenciar o processo de conexão; por exemplo, para identificar servidores de autoinicialização especiais ou para limitar a conexão a um subgrupo de mecanismos do sistema de mensagens disponível, ou para aprimorar a disponibilidade ou o desempenho, ou para garantir processamento sequencial de mensagens recebidas. Para obter informações sobre por que e como fazer isso, consulte o tópico Como os Aplicativos JMS se Conectam a um Mecanismo do Sistema de Mensagens em um Barramento.
A guia Configuração mostra propriedades de configuração para esse objeto. Estes valores da propriedade são preservados mesmo que o ambiente de tempo de execução seja parado e reiniciado em seguida. Consulte as descrições de tarefas do centro de informações para obter informações sobre como aplicar alterações na configuração no ambiente de tempo de execução.
Especifica o nível topológico mais alto no qual os servidores de aplicativos podem utilizar este objeto de recurso.
| Informações | Valor |
|---|---|
| Obrigatório | NÃO |
| Tipo de dado | Seqüência de Caracteres |
Especifica um provedor JMS, que ativa o sistema de mensagens assíncronas com base no JMS (Java Message Service). Ele fornece connection factories J2EE para criar conexões para destinos de fila ou tópico JMS específicos. Os objetos administrativos do provedor JMS são utilizados para gerenciar recursos de JMS do provedor JMS associado.
| Informações | Valor |
|---|---|
| Obrigatório | NÃO |
| Tipo de dado | Seqüência de Caracteres |
O nome de exibição necessário para o recurso.
| Informações | Valor |
|---|---|
| Obrigatório | Sim |
| Tipo de dado | Seqüência de Caracteres |
O nome de JNDI para o recurso.
| Informações | Valor |
|---|---|
| Obrigatório | Sim |
| Tipo de dado | Seqüência de Caracteres |
Uma descrição opcional para o recurso.
| Informações | Valor |
|---|---|
| Obrigatório | NÃO |
| Tipo de dado | Área de Texto |
Se o bean orientado a mensagens utilizar um destino de fila ou de tópico.
| Informações | Valor |
|---|---|
| Obrigatório | Sim |
| Tipo de dado | lista drop-down |
| Range |
|
Nome JNDI de destino
Selecione o tipo de destino na propriedade Tipo de Destino.
Para adaptadores de recursos que suportam JMS, é necessário associar o javax.jms.Destinations a uma especificação de ativação, assim como o adaptador de recursos pode atender mensagens do destino JMS. Nesse caso, o administrador configurará o Objeto J2C Administrado que implementa a interface javax.jms.Destination e a ligará ao JNDI.
Você pode configurar um Objeto J2C Administrado para utilizar uma classe ActivationSpec que implementa um método setDestination(javax.jms.Destination). Nesse caso, você poderá especificar o nome de JNDI de destino (ou seja, o nome de JNDI para o objeto J2C Administrado que implementa javax.jms.Destination).
Durante a inicialização do aplicativo, quando a especificação de ativação estiver sendo inicializada como parte da ativação do nó de extremidade, o servidor utilizará o nome de JNDI de destino para consultar o objeto de destino administrado e, em seguida, o definirá na instância de especificação de ativação.
| Informações | Valor |
|---|---|
| Obrigatório | Sim |
| Tipo de dado | Seqüência de Caracteres |
O seletor de mensagem JMS utilizado para determinar quais mensagens são recebidas pelo bean acionado por mensagens. O valor é uma cadeia utilizada para selecionar um subconjunto das mensagens disponíveis. A sintaxe é baseada em um subconjunto da sintaxe de expressão condicional SQL 92, conforme descrito na especificação JMS. Consulte o centro de informações para obter informações adicionais.
JMSType='car' AND color='blue' AND weight>2500
A cadeia do seletor pode referir-se a campos no cabeçalho da mensagem JMS e a campos nas propriedades da mensagem. Os seletores de mensagens não podem fazer referência a valores do corpo da mensagem.
Um valor nulo (uma cadeia vazia) indica que não existe nenhum seletor de mensagem para o consumidor de mensagem.
| Informações | Valor |
|---|---|
| Obrigatório | NÃO |
| Tipo de dado | Seqüência de Caracteres |
O nome do barramento para conexão.
| Informações | Valor |
|---|---|
| Obrigatório | NÃO |
| Tipo de dado | Personalizada |
Como a sessão confirma quaisquer mensagens recebidas.
Uma confirmação será enviada quando a mensagem for excluída.
A mensagem será excluída quando o bean for iniciado, se a qualidade de serviço for configurada como Melhor esforço não persistente. Para todas as outras qualidades de serviço, a mensagem será excluída quando o bean for concluído.
| Informações | Valor |
|---|---|
| Obrigatório | NÃO |
| Tipo de dado | lista drop-down |
| Range |
|
O nome de um destino que identifica um grupo de mecanismos dos sistemas de mensagens. Especifique o tipo de destino utilizando a propriedade Tipo de Destino.
| Informações | Valor |
|---|---|
| Obrigatório | NÃO |
| Tipo de dado | Seqüência de Caracteres |
O tipo de destino denominado na propriedade Destino.
| Informações | Valor |
|---|---|
| Obrigatório | NÃO |
| Tipo de dado | lista drop-down |
| Range |
|
Esta propriedade especifica a importância do grupo de destino.
| Informações | Valor |
|---|---|
| Obrigatório | NÃO |
| Tipo de dado | lista drop-down |
| Range |
|
O nome da cadeia de transporte de entrada que o aplicativo deve destinar ao conectar-se a um mecanismo do sistema de mensagens em um processo separado para o aplicativo. Se for escolhido um mecanismo do sistema de mensagens em outro processo, uma conexão poderá ser estabelecida apenas se o mecanismo do sistema de mensagens estiver em um servidor que execute a cadeia de transporte de entrada especificada. Consulte o centro de informações para obter informações adicionais.
Se o mecanismo de sistema de mensagens estiver no mesmo servidor que o aplicativo, será estabelecida uma conexão direta do processo interno e essa propriedade da cadeia de transporte será ignorada.
| Informações | Valor |
|---|---|
| Obrigatório | NÃO |
| Tipo de dado | Seqüência de Caracteres |
Uma lista separada por vírgula de grupos de três terminais, com a sintaxe hostName:portNumber:chainName, utilizada para a conexão com um servidor de auto-inicialização. Por exemplo, Merlin:7276:BootstrapBasicMessaging,Gandalf:5557:BootstrapSecureMessaging.
Se o nome do host não for especificado, localhost será utilizado como um valor padrão.
Se o número da porta não for especificado, 7276 será utilizado como o valor padrão.
Se o protocolo não for especificado, uma cadeia predefinida como BootstrapBasicMessaging será utilizada como o valor padrão.
| Informações | Valor |
|---|---|
| Obrigatório | NÃO |
| Tipo de dado | Área de Texto |
O número máximo de mensagens recebidas do mecanismo do sistema de mensagens em um único batch.
| Informações | Valor |
|---|---|
| Obrigatório | NÃO |
| Tipo de dado | Número inteiro |
| Range | 1 a 2147483647 |
O número máximo de nós de extremidade nos quais as mensagens são entregues simultaneamente.
| Informações | Valor |
|---|---|
| Obrigatório | NÃO |
| Tipo de dado | Número inteiro |
| Range | 1 a 2147483647 |
Estes parâmetros possibilitam um terminal parar automaticamente quando o número de mensagens com falhas seqüenciais atingir um limite que especificar. Isso ajuda a distinguir entre uma ou duas mensagens que falham devido a problemas com as próprias mensagens e um problema de recurso do sistema que resulta em várias mensagens de falha em seqüência.
Quando um terminal é interrompido automaticamente, seu Status no painel do console administrativo fica vermelho. Ele deve ser reiniciado manualmente clicando em Continuar.
Depois que um terminal é reiniciado, qualquer mensagem com falha que tenha feito com que o terminal fosse interrompido é tentada novamente. Se elas continuarem a falhar elas são movidas para um destino de exceção, se configurado.
Ativar parada automática de um terminal com base nos parâmetros abaixo.
| Informações | Valor |
|---|---|
| Obrigatório | NÃO |
| Tipo de dado | Booleana |
O terminal será parado quando o número de mensagens com falha sequenciais atingir o limite configurado. Devido às dependências de processamento no MDB, o número real de mensagens processadas pode exceder esse valor.
Esta propriedade não é ativada a menos que a propriedade do Parar terminais automaticamente em falhas repetidas de mensagens seja ativada.
| Informações | Valor |
|---|---|
| Obrigatório | NÃO |
| Tipo de dado | Número inteiro |
Qualquer mensagem que falhar ao ser processada pelo MDB, mas não atingir o limite máximo de entrega com falha, será tentada novamente após o período de tempo (em milissegundos) transmitido. Outras mensagens podem ser tentadas durante esse período, a menos que o limite de falhas sequenciais e a simultaneidade máxima sejam configurados para 1.
Configurar um atraso entre repetições falhas da mensagem reduz o número de mensagens movidas, desnecessariamente, para a exceção antes de o MDB ser parado. Para minimizar o número de mensagens que são movidas, torne esse atraso maior que o intervalo de tempo esperado entre mensagens que chegam ao destino.
Esta propriedade não é ativada a menos que a propriedade do Parar terminais automaticamente em falhas repetidas de mensagens seja ativada.
| Informações | Valor |
|---|---|
| Obrigatório | NÃO |
| Tipo de dado | Número inteiro |
| Range | O tempo em milissegundos. Um valor de 0 indica nenhum atraso entre as novas tentativas. |
Especifica se uma assinatura de tópico JMS é durável ou não durável
| Informações | Valor |
|---|---|
| Obrigatório | NÃO |
| Tipo de dado | lista drop-down |
| Range |
|
O nome da assinatura necessário para assinaturas de tópicos duráveis. Campo necessário ao utilizar uma assinatura de tópico durável.
Este nome de assinatura deve ser exclusivo para um determinado identificador de cliente.
| Informações | Valor |
|---|---|
| Obrigatório | NÃO |
| Tipo de dado | Seqüência de Caracteres |
O identificador de cliente JMS necessário para assinaturas de tópicos duráveis em todas as conexões criadas utilizando esta especificação de ativação.
| Informações | Valor |
|---|---|
| Obrigatório | NÃO |
| Tipo de dado | Seqüência de Caracteres |
O nome do mecanismo do sistema de mensagens utilizado para armazenar as mensagens entregues a assinaturas duráveis para objetos criados a partir dessa especificação de ativação JMS. Esse campo é necessário ao utilizar uma assinatura de tópico durável.
| Informações | Valor |
|---|---|
| Obrigatório | NÃO |
| Tipo de dado | Seqüência de Caracteres |
Quando ativadas, as Mensagens de Objeto recebidas por meio dessa especificação de ativação terão apenas os dados da mensagem serializados pelo sistema quando for realmente necessário. Os dados obtidos a partir dessas mensagens devem ser tratados como readOnly pelos aplicativos.
| Informações | Valor |
|---|---|
| Obrigatório | NÃO |
| Tipo de dado | Booleana |
Quando ativadas, as mensagens de Objeto/Bytes redirecionadas por meio dessa especificação de ativação que tenham sua carga útil modificada não terão os dados copiados quando eles estiverem definidos na mensagem e o sistema serializará apenas os dados da mensagem quando for realmente necessário. Os aplicativos que enviam tais mensagens não devem modificar os dados, uma vez que foram definidos na mensagem.
| Informações | Valor |
|---|---|
| Obrigatório | NÃO |
| Tipo de dado | Booleana |
A leitura antecipada é uma otimização que, preemptivamente, designa mensagens aos consumidores. Isto melhora o tempo gasto para atender a pedidos do consumidor.
As mensagens que são designadas a um consumidor são bloqueadas no servidor e não podem ser consumidas por outros consumidores para esse destino. As mensagens que são designadas a um consumidor, mas não são consumidas antes do fechamento desse consumidor, são subseqüentemente desbloqueadas no servidor e, em seguida, disponibilizadas para recebimento por outros consumidores.
É possível substituir esta propriedade para destinos JMS individuais, definindo a propriedade Leitura Antecipada no destino JMS.
| Informações | Valor |
|---|---|
| Obrigatório | NÃO |
| Tipo de dado | lista drop-down |
| Range |
|
Essa propriedade é utilizada apenas quando o aplicativo MDB estiver em execução em um servidor que seja membro do barramento ao qual o aplicativo se destina. Ele não terá efeito quando o MDB estiver em execução em um servidor que não seja um membro do barramento de destino.
Se o aplicativo MDB estiver em execução em um servidor que seja membro do barramento de destino, ativar esta opção permite que o aplicativo MDB processe mensagens quer ou não o servidor também hospede um mecanismo do sistema de mensagens em execução. Se essa opção não estiver ativada, então os aplicativos MDB em servidores que não tenham um ME local em execução não processarão mensagens.
Para obter informações adicionais, consulte o tópico Como um Bean Acionado por Mensagens se Conecta em um Cluster.
| Informações | Valor |
|---|---|
| Obrigatório | NÃO |
| Tipo de dado | Booleana |
O atraso (em segundos) entre as tentativas de conexão a um mecanismo do sistema de mensagens, ambos para a conexão inicial e quaisquer tentativas subsequentes de estabelecer uma melhor conexão.
| Informações | Valor |
|---|---|
| Obrigatório | NÃO |
| Tipo de dado | Número inteiro |
| Range | 1 a 2147483647 |
O nome de um alias de autenticação J2C utilizado para autenticação gerenciada por componente de conexões com o barramento de integração de serviços.
Um alias de autenticação Java Platform, Enterprise Edition (Java EE) Connector Architecture (JCA) especifica o ID do usuário e a senha utilizados para autenticar a criação de uma nova conexão com o provedor JMS.
Os campos de propriedades customizadas nome de usuário e senha deverão ser deixados não especificados se o campo de alias de autenticação for usado. As propriedades do alias de autenticação configuradas como parte da implementação do aplicativo têm prioridade sobre as propriedades configuradas em um objeto administrativo de especificação de ativação.
Apenas o alias de autenticação é gravado no arquivo em um formulário não criptografado, mesmo para os objetivos do registro em log da recuperação da transação. O serviço de segurança é utilizado para proteger o nome do usuário e senha reais.
Durante a inicialização do aplicativo, quando a especificação de ativação estiver sendo inicializada como parte da ativação do nó de extremidade, o servidor utilizará o alias de autenticação para recuperar o nome do usuário e a senha reais da segurança e, em seguida, defini-los na instância de especificação de ativação.
| Informações | Valor |
|---|---|
| Obrigatório | NÃO |
| Tipo de dado | lista drop-down |