Especificação de Ativação JMS [Configurações]
Você cria uma especificação de ativação do JMS se desejar usar um bean acionado por mensagens para se comunicar com o provedor de sistema de mensagens padrão por meio do 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 de especificação de ativação, exceto Name, JNDI name, Destination JNDI name ou Destination lookup e Authentication alias são substituídos por propriedades de configuração de ativação denominadas adequadamente no descritor de implementação de um EJB 2.1 associado ou bean acionado por mensagens posteriormente. 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 Destination JNDI name ou Destination lookup pode ser substituída por um valor especificado nas ligações de bean acionado 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.
Guia Configuração
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.
Propriedades Gerais
Escopo
Especifica o nível topológico mais alto no qual os servidores de aplicativos podem utilizar este objeto de recurso.
Informações | Valor |
---|---|
Requerido | Não |
Tipo de dados | Sequência de Caracteres |
Provedor
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 |
---|---|
Requerido | Não |
Tipo de dados | Sequência de Caracteres |
Nome
O nome de exibição necessário para o recurso.
Informações | Valor |
---|---|
Requerido | Sim |
Tipo de dados | Sequência de Caracteres |
Nome JNDI
O nome JNDI para o recurso.
Informações | Valor |
---|---|
Requerido | Sim |
Tipo de dados | Sequência de Caracteres |
Descrição
Uma descrição opcional para o recurso.
Informações | Valor |
---|---|
Requerido | Não |
Tipo de dados | Área de Texto |
Tipo de Destino
Informações | Valor |
---|---|
Requerido | Sim |
Tipo de dados | lista suspensa |
Intervalo |
|
Consulta 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.
É possível configurar um Objeto J2C Administrado para utilizar uma classe ActivationSpec que implementa um método setDestination(javax.jms.Destination). Nesse caso, é possível especificar a consulta Destino (ou seja, o nome JNDI para o objeto J2C Administrado que implementa o javax.jms.Destination).
Informações | Valor |
---|---|
Requerido | Sim |
Tipo de dados | Sequência de Caracteres |
Consulta de connection factory
Nome JNDI do connection factory.
Informações | Valor |
---|---|
Requerido | Sim |
Tipo de dados | Sequência de Caracteres |
Seletor de Mensagens
JMSType='car' AND color='blue' AND weight>2500
A cadeia do seletor pode referir-se aos campos no cabeçalho de mensagens do JMS e aos 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.
Informações | Valor |
---|---|
Requerido | Não |
Tipo de dados | Sequência de Caracteres |
Nome do Barramento
Informações | Valor |
---|---|
Requerido | Não |
Tipo de dados | Customizado |
Modo de Confirmação
A confirmação será enviada quando a mensagem for excluída.
- Se o sistema for configurado para excluir a mensagem quando o bean for concluído, ela será despachada para uma nova instância do bean, para que tenha outra oportunidade de ser processada.
- Se o sistema for configurado para excluir a mensagem quando o bean for iniciado, ela será perdida.
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 |
---|---|
Requerido | Não |
Tipo de dados | lista suspensa |
Intervalo |
|
Destino
Informações | Valor |
---|---|
Requerido | Não |
Tipo de dados | Sequência de Caracteres |
Tipo de destino
Informações | Valor |
---|---|
Requerido | Não |
Tipo de dados | lista suspensa |
Intervalo |
|
Significado do Destino
Informações | Valor |
---|---|
Requerido | Não |
Tipo de dados | lista suspensa |
Intervalo |
|
Cada de transporte de entrada de destino
Se o mecanismo do 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.
- InboundBasicMessaging
- Este é um protocolo orientado para conexão que utiliza uma conexão TCP/IP padrão (JFAP-TCP/IP). Inclui suporte para fluxos transacionais de duas fases (XA remoto), para que um produtor ou consumidor de mensagens, em execução em um sistema cliente ou servidor, possa participar de uma transação global gerenciada nesse sistema cliente ou servidor. O uso específico dos fluxos XA é para suportar o acesso a partir de um aplicativo em execução em um servidor para um mecanismo do sistema de mensagens no segundo servidor, talvez em razão do primeiro servidor não possuir um mecanismo do sistema de mensagens adequado. Se forem utilizados os fluxos de XA remoto, um coordenador de transação deverá estar disponível localmente no aplicativo.
- InboundSecureMessaging
- Este é o protocolo InboundBasicMessaging agrupado no SSL.
Informações | Valor |
---|---|
Requerido | Não |
Tipo de dados | Sequência de Caracteres |
Terminais do Provedor
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 |
---|---|
Requerido | Não |
Tipo de dados | Área de Texto |
Tamanho Máximo do Lote
Informações | Valor |
---|---|
Requerido | Não |
Tipo de dados | Número Inteiro |
Intervalo | 1 a 2147483647 |
Máximo de chamadas MDB simultâneas por terminal
Informações | Valor |
---|---|
Requerido | Não |
Tipo de dados | Número Inteiro |
Intervalo | 1 a 2147483647 |
Parar terminais automaticamente em falhas repetidas de mensagens
Estes parâmetros possibilitam um terminal parar automaticamente quando o número de mensagens com falhas sequenciais 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 sequê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
Informações | Valor |
---|---|
Requerido | Não |
Tipo de dados | Booleano |
Limite de mensagem com falha sequencial
Esta propriedade não é ativada a menos que a propriedade do Parar terminais automaticamente em falhas repetidas de mensagens seja ativada.
Informações | Valor |
---|---|
Requerido | Não |
Tipo de dados | Número Inteiro |
Atraso entre novas tentativas de mensagem com falha
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 |
---|---|
Requerido | Não |
Tipo de dados | Número Inteiro |
Intervalo | O tempo em milissegundos. Um valor de 0 indica nenhum atraso entre as novas tentativas. |
Durabilidade da Assinatura
Informações | Valor |
---|---|
Requerido | Não |
Tipo de dados | lista suspensa |
Intervalo |
|
Nome da assinatura
Este nome de assinatura deve ser exclusivo para um determinado identificador de cliente.
Informações | Valor |
---|---|
Requerido | Não |
Tipo de dados | Sequência de Caracteres |
Identificador de Cliente
Informações | Valor |
---|---|
Requerido | Não |
Tipo de dados | Sequência de Caracteres |
Início da assinatura
Informações | Valor |
---|---|
Requerido | Não |
Tipo de dados | Sequência de Caracteres |
Transmitir Carga Útil da Mensagem por Referência
Aplicativos que utilizam essa especificação de ativação para receber mensagens devem obedecer a seguinte regra:
- O aplicativo não modifica o objeto de dados obtido a partir de uma mensagem de objeto JMS. O objeto de dados é tratado como de leitura.
Informações | Valor |
---|---|
Requerido | Não |
Tipo de dados | Booleano |
Os aplicativos que reenviam mensagens recebidas originalmente utilizando essa especificação de ativação devem obedecer as seguintes regras:
- O aplicativo pode substituir o objeto de dados em uma mensagem do objeto do JMS, contanto que o objeto de dados ainda não tenha sido configurado na mensagem. O aplicativo não modifica nem substitui o objeto de dados após ele estar configurado na mensagem.
- O aplicativo pode substituir a matriz de byte em uma mensagem de bytes de JMS, mas apenas usando uma chamada única para writeBytes(byte[]) e desde que a matriz de bytes ainda não tenha sido configurada na mensagem. O aplicativo não modifica nem substitui a matriz de byte após ela ter sido configurada na mensagem.
Informações | Valor |
---|---|
Requerido | Não |
Tipo de dados | Booleano |
Leitura Antecipada
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 |
---|---|
Requerido | Não |
Tipo de dados | lista suspensa |
Intervalo |
|
Sempre ativar MDBs em todos os servidores
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.
- Todos os servidores do cluster podem receber mensagens do aplicativo MDB, para fazer uso completo da força de processamento do cluster.
- Apenas um servidor por vez pode receber mensagens do aplicativo MDB, para garantir o processamento seqüencial das mensagens.
Para obter informações adicionais, consulte o tópico Como um Bean Acionado por Mensagens se Conecta em um Cluster.
Informações | Valor |
---|---|
Requerido | Não |
Tipo de dados | Booleano |
Intervalo de repetição
Informações | Valor |
---|---|
Requerido | Não |
Tipo de dados | Número Inteiro |
Intervalo | 1 a 2147483647 |
Alias de Autenticaçã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.
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 |
---|---|
Requerido | Não |
Tipo de dados | lista suspensa |