IMessageProducer

Interfaccia:

DeliveryMode DeliveryMode
{
  get;
  set;
}

Richiamare e impostare il modo di consegna predefinito per i messaggi inviati dal produttore del messaggio.

La modalità di consegna predefinita ha uno dei seguenti valori:

• DeliveryMode.Persistent
• DeliveryMode.NonPersistent

Per una connessione in tempo reale a un broker, il valore deve essere DeliveryMode.NonPersistent.

Il valore predefinito è DeliveryMode.Persistent, tranne per una connessione in tempo reale a un broker per cui il valore predefinito è DeliveryMode.NonPersistent.

Eccezioni:

• Eccezione XMSException

Interfaccia:

IDestination Destination
{
  get;
}

Ottieni la destinazione per il produttore del messaggio.

Parametri:

Nessuna

Restituisce:

L'oggetto Destinazione. Se il produttore del messaggio non dispone di una destinazione, il metodo restituisce un oggetto Destinazione null.

Eccezioni:

• Eccezione XMSException

Interfaccia:

Boolean DisableMessageID
{
  get;
  set;
}

Indica se un'applicazione ricevente richiede che gli identificativi dei messaggi siano inclusi nei messaggi inviati dal produttore del messaggio e se un'applicazione ricevente richiede che gli identificativi dei messaggi siano inclusi nei messaggi inviati dal produttore del messaggio.

In una connessione a un gestore code o in una connessione in tempo reale a un broker, questo indicatore viene ignorato. Su una connessione a un bus di integrazione servizi, l'indicatore viene rispettato.

DisabledMsgID ha i seguenti valori:

• True, se un'applicazione di ricezione non richiede che gli identificativi di messaggio siano inclusi nei messaggi inviati dal produttore del messaggio.
• False, se un'applicazione ricevente richiede che gli identificativi dei messaggi siano inclusi nei messaggi inviati dal produttore del messaggio.

Eccezioni:

• Eccezione XMSException

Interfaccia:

Boolean DisableMessageTimestamp
{
  get;
  set;
}

Indica se un'applicazione di ricezione richiede che le date / ore siano incluse nei messaggi inviati dal produttore del messaggio e indica se un'applicazione di ricezione richiede che le date / ore siano incluse nei messaggi inviati dal produttore del messaggio.

In una connessione in tempo reale a un broker, questo indicatore viene ignorato. Su una connessione a un gestore code o su una connessione a un SIB (Service Integration Bus), l'indicatore viene rispettato.

DisableMsgTS ha i seguenti valori:

• True, se un'applicazione ricevente non richiede che le date / ore siano incluse nei messaggi inviati dal produttore del messaggio.
• False, se un'applicazione ricevente richiede che le date / ore siano incluse nei messaggi inviati dal produttore del messaggio.

Restituisce:

Eccezioni:

• Eccezione XMSException

Interfaccia:

Int32 Priority
{
  get;
  set;
}

Richiamare e impostare la priorità predefinita per i messaggi inviati dal produttore del messaggio.

Il valore della priorità predefinita del messaggio è un numero intero compreso tra 0, la priorità più bassa, e 9, la priorità più elevata.

In una connessione in tempo reale a un broker, la priorità di un messaggio viene ignorata.

Eccezioni:

• Eccezione XMSException

Interfaccia:

Int64 TimeToLive
{
  get;
  set;
}

Richiamare e impostare il periodo di tempo predefinito per cui un messaggio esiste prima che scada.

Il tempo viene misurato dal momento in cui il mittente del messaggio invia il messaggio ed è il tempo di vita predefinito in millisecondi. Un valore 0 indica che un messaggio non scade mai.

Per una connessione in tempo reale a un broker, questo valore è sempre 0.

Eccezioni:

• Eccezione XMSException

Interfaccia:

void  Close(); 

Chiudere il mittente del messaggio.

Se un'applicazione tenta di chiudere un produttore di messaggi che è già chiuso, la chiamata viene ignorata.

Parametri:

Nessuna

Restituisce:

Azzera

Eccezioni:

• Eccezione XMSException

Interfaccia:

void Send(IMessage msg) ;

Inviare un messaggio alla destinazione specificata quando è stato creato il produttore del messaggio. Inviare il messaggio utilizzando la modalità di distribuzione predefinita del produttore del messaggio, la priorità e il time to live.

Parametri:

msg (input)

L'oggetto Messaggio.

Restituisce:

Azzera

Eccezioni:

• Eccezione XMSException
• MessageFormatException
• InvalidDestinationException

Interfaccia:

void Send(IMessage msg, 
          DeliveryMode deliveryMode, 
          Int32 priority, 
          Int64 timeToLive);

Inviare un messaggio alla destinazione specificata quando è stato creato il produttore del messaggio. Inviare il messaggio utilizzando la modalità di consegna, la priorità e la durata specificate.

Parametri:

msg (input)

L'oggetto Messaggio.

deliveryMode (input)

La modalità di consegna per il messaggio, che deve essere uno dei seguenti valori:

• DeliveryMode.Persistent
• DeliveryMode.NonPersistent

Per una connessione in tempo reale a un broker, il valore deve essere DeliveryMode.NonPersistent.

priorità (input)

La priorità del messaggio. Il valore può essere un numero intero compreso tra 0, per la priorità più bassa, e 9, per la priorità più elevata. In una connessione in tempo reale a un broker, il valore viene ignorato.

timeToLive (input)

La durata del messaggio in millisecondi. Il valore 0 indica che il messaggio non scade mai. Per una connessione in tempo reale a un broker, il valore deve essere 0.

Restituisce:

Azzera

Eccezioni:

• Eccezione XMSException
• MessageFormatException
• InvalidDestinationException
• IllegalStateException

Interfaccia:

void Send(IDestination dest, IMessage msg) ;

Inviare un messaggio a una destinazione specificata se si sta utilizzando un produttore di messaggi per cui non è stata specificata alcuna destinazione quando è stato creato il produttore di messaggi. Inviare il messaggio utilizzando la modalità di distribuzione predefinita del produttore del messaggio, la priorità e il time to live.

Generalmente, si specifica una destinazione quando si crea un produttore di messaggi ma, in caso contrario, è necessario specificare una destinazione ogni volta che si invia un messaggio.

Parametri:

dest (input)

L'oggetto Destinazione.

msg (input)

L'oggetto Messaggio.

Restituisce:

Azzera

Eccezioni:

• Eccezione XMSException
• MessageFormatException
• InvalidDestinationException

Interfaccia:

void Send(IDestination dest, 
          IMessage msg, 
          DeliveryMode deliveryMode, 
          Int32 priority, 
          Int64 timeToLive) ;

Inviare un messaggio a una destinazione specificata se si sta utilizzando un produttore di messaggi per cui non è stata specificata alcuna destinazione quando è stato creato il produttore di messaggi. Inviare il messaggio utilizzando la modalità di consegna, la priorità e la durata specificate.

Generalmente, si specifica una destinazione quando si crea un produttore di messaggi ma, in caso contrario, è necessario specificare una destinazione ogni volta che si invia un messaggio.

Parametri:

dest (input)

L'oggetto Destinazione.

msg (input)

L'oggetto Messaggio.

deliveryMode (input)

La modalità di consegna per il messaggio, che deve essere uno dei seguenti valori:

• DeliveryMode.Persistent
• DeliveryMode.NonPersistent

Per una connessione in tempo reale a un broker, il valore deve essere DeliveryMode.NonPersistent.

priorità (input)

La priorità del messaggio. Il valore può essere un numero intero compreso tra 0, per la priorità più bassa, e 9, per la priorità più elevata. In una connessione in tempo reale a un broker, il valore viene ignorato.

timeToLive (input)

La durata del messaggio in millisecondi. Il valore 0 indica che il messaggio non scade mai. Per una connessione in tempo reale a un broker, il valore deve essere 0.

Restituisce:

Azzera

Eccezioni:

• Eccezione XMSException
• MessageFormatException
• InvalidDestinationException
• IllegalStateException