Uma especificação de ativação de JMS está associada a um ou mais beans orientados a mensagens e fornece a configuração necessária a eles para receberem 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 fora Nome, Nome da JNDI, Nome da JNDI de Destino e alias de Autenticação são substituídas pelas propriedades de configuração de ativação nomeadas de forma apropriada no descritor de implementação de um bean acionado por mensagens EJB 2.1 ou posterior associado. 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, você pode especificar detalhes adicionais na configuração para influenciar o processo de conexão; por exemplo, para identificar servidores de auto-inicializaçã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 seqüencial de mensagens recebidas. Para obter informações sobre como e por que fazer isso, consulte Como os Aplicativos JMS se Conectam a um Mecanismo do Sistema de Mensagens em um Barramento (on-line).
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 deste tópico (on-line)
A guia Configuração mostra propriedades de configuração para esse objeto. Esses valores de propriedades são preservados, mesmo se o ambiente de tempo de execução estiver parado, em seguida, reiniciado. 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 poderão utilizar este objeto de recurso.
Necessário | Não |
Tipo de Dados | Texto |
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 fila JMS específica ou destinos de tópicos. Os objetos administrativos do provedor JMS são utilizados para gerenciar recursos JMS para o provedor JMS associado.
Necessário | Não |
Tipo de Dados | Texto |
O nome de JNDI do recurso.
Necessário | Sim |
Tipo de Dados | Texto |
Se o bean orientado por mensagem utiliza um destino de fila ou de tópico.
Necessário | Sim |
Tipo de Dados | lista drop-down |
Intervalo |
|
Nome JNDI de destino
Selecione o tipo de destino na propriedade Tipo de destino.
Necessário | Sim |
Tipo de Dados | Texto |
O seletor de mensagens JMS a ser utilizado para determinar quais mensagens o bean orientado por mensagem recebe. O valor é uma cadeia utilizada para selecionar um subconjunto de 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 referir-se aos 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.
Necessário | Não |
Tipo de Dados | Texto |
Nome do barramento ao qual irá conectar-se.
Necessário | Não |
Tipo de Dados | Customizado |
Como a sessão confirma o recebimento de quaisquer mensagens.
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.
Necessário | Não |
Tipo de Dados | lista drop-down |
Intervalo |
|
O nome de um destino que identifica um grupo de mecanismos de mensagens. Especifique o tipo de destino utilizando a propriedade do tipo Destino.
Necessário | Não |
Tipo de Dados | Texto |
O tipo de destino nomeado na propriedade Destino.
Necessário | Não |
Tipo de Dados | lista drop-down |
Intervalo |
|
Esta propriedade especifica a importância do grupo de destino.
Necessário | Não |
Tipo de Dados | lista drop-down |
Intervalo |
|
O nome da cadeia de transporte de entrada que o aplicativo deve utilizar ao conectar-se com um mecanismo do sistema de mensagens em um processo separado do aplicativo. Se for escolhido um mecanismo de sistema de mensagens em outro processo, uma conexão poderá ser estabelecida apenas se o mecanismo de sistema de mensagens estiver em um servidor que execute a cadeia de entrada de transporte 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.
Necessário | Não |
Tipo de Dados | Texto |
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 autoinicializaçã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.
Necessário | Não |
Tipo de Dados | Área de Texto |
O número máximo de mensagens recebidas do mecanismo do sistema de mensagens em um único lote.
Necessário | Não |
Tipo de Dados | Inteiro |
Intervalo | 1 a 2147483647 |
O número máximo de nós de extremidade nos quais as mensagens são entregues simultaneamente.
Necessário | Não |
Tipo de Dados | Inteiro |
Intervalo | 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.
Ative a parada automática de um terminal com base nos parâmetros a seguir.
Necessário | Não |
Tipo de Dados | Caixa de Opção |
O terminal será parado quando o número de mensagens com falhas seqüenciais atingir o limite configurado. Devido à simultaneidade no MDB, o número real de mensagens processadas pode exceder este valor.
Esta propriedade não é ativada a menos que a propriedade Parar terminais automaticamente nas repetições de falhas de mensagens seja ativada.
Necessário | Não |
Tipo de Dados | Inteiro |
Toda mensagem cujo processamento pelo MDB falhar, mas que não atingiu seu limite máximo de entregas falhas só será tentada novamente depois que esse período de tempo tiver passado. Outras mensagens poderão ser tentadas durante esse período, a não ser que o limite de falhas seqüenciais e a simultaneidade máxima estejam configurados como 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 Parar terminais automaticamente nas repetições de falhas de mensagens seja ativada.
Necessário | Não |
Tipo de Dados | Inteiro |
Intervalo | O tempo em milissegundos. Um valor de 0 indica nenhum atraso entre as novas tentativas. |
Se uma assinatura de tópico do JMS é durável ou não-durável.
Necessário | Não |
Tipo de Dados | lista drop-down |
Intervalo |
|
O nome da assinatura necessário para assinaturas de tópicos duráveis. Campo requerido ao utilizar uma assinatura de tópico durável.
Este nome de assinatura deve ser exclusivo para um determinado identificador de cliente.
Necessário | Não |
Tipo de Dados | Texto |
O identificador do cliente JMS é necessário para assinaturas de tópico duráveis em todas as conexões criadas utilizando esta especificação de ativação.
Necessário | Não |
Tipo de Dados | Texto |
O nome do mecanismo do sistema de mensagens utilizado para armazenar as mensagens entregues às assinaturas duráveis para objetos criados a partir desta especificação de ativação JMS. Este é um campo necessário ao utilizar uma assinatura de tópico durável.
Necessário | Não |
Tipo de Dados | Texto |
Quando ativado, as mensagens de objeto recebidas por esta especificação de ativação só terão os dados da mensagem serializados pelo sistema quando absolutamente necessário. Os dados obtidos dessas mensagens devem ser tratados como readOnly por aplicativos.
Necessário | Não |
Tipo de Dados | Caixa de Opção |
Quando ativado, as Mensagens de Objeto/Bytes redirecionadas através desta especificação de ativação, que têm suas cargas úteis modificadas, não terão os dados copiados quando forem configuradas na mensagem e o sistema só irá serializar os dados da mensagem quando absolutamente necessário. Os aplicativos que enviam tais mensagens não devem modificar os dados quando tiverem sido configurados na mensagem.
Necessário | Não |
Tipo de Dados | Caixa de Opção |
Ler adiante é um otimização que por preempção designa mensagens a consumidores. Isso melhora o tempo gasto para atender a pedidos dos consumidores.
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.
Necessário | Não |
Tipo de Dados | lista drop-down |
Intervalo |
|
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 Como um bean acionado por mensagens se conecta em um cluster (on-line).
Necessário | Não |
Tipo de Dados | Caixa de Opção |
O nome de um alias de autenticação J2C utilizado para autenticação de conexões gerenciadas por componentes para o barramento de integração de serviço.
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.
Necessário | Não |
Tipo de Dados | lista drop-down |