Gestione dei domini broker mediante Proxy di Gestione configurazione

Prima di iniziare

Prima di eseguire questo passo, è necessario aver completato Connessione a Gestione configurazione mediante il Proxy di Gestione configurazione.

Utilizzando CMP è possibile modificare lo stato degli oggetti nel dominio; ciò significa che è possibile creare, eliminare, modificare e distribuire gli oggetti memorizzati all'interno di Gestione configurazione. L'esempio riportato di seguito prova ad impostare il campo relativo alla descrizione completa di un broker denominato B1:
import com.ibm.broker.config.proxy.*;

public class SetLongDescription {

  public static void main(String[] args) {
        
    ConfigManagerProxy cmp = null;
    try {
      ConfigManagerConnectionParameters cmcp =
         new MQConfigManagerConnectionParameters(
           "localhost",
           1414,
           "");
      cmp = ConfigManagerProxy.getInstance(cmcp);   
    } catch (ConfigManagerProxyException cmpex) {
      System.out.println("Error connecting: "+cmpex);
    }
        
    if (cmp != null) {
      System.out.println("Connected to Config Manager!");
      describeBroker(cmp, "B1", "this is my broker");
      cmp.disconnect();
    }
  }

  private static void describeBroker(ConfigManagerProxy cmp,
                                     String brokerName,
                                     String newDesc)
  {
  	BrokerProxy b = null;
    try {
      TopologyProxy topology = cmp.getTopology();
      if (topology != null) {
        b = topology.getBrokerByName(brokerName);
      }
    } catch(ConfigManagerProxyPropertyNotInitializedException
                                                      ex) {
        System.err.println("Comms problem! "+ex);
    }
    
    if (b != null) {
      try {
      	 b.setLongDescription(newDesc);
      } catch (ConfigManagerProxyException ex) {
      	System.err.println("Could not send request to CM: "+ex);
      }
    } else {
      System.err.println("Broker "+brokerName+" not found");
    }  
  }
}
Il metodo setLongDescription() richiede a Gestione configurazione di modificare una proprietà (chiave, valore) del broker B1, dove il nome della chiave rappresenta la tag relativa alla descrizione completa ed il valore è la nuova descrizione completa. Quindi, un'alternativa alla chiamata di setLongDescription() è:
Properties p = new Properties();

p.setProperty(AttributeConstants.LONG_DESCRIPTION_PROPERTY,
              newDesc);

b.setProperties(p);
Quando la richiesta di modifica delle proprietà viene inviata a Gestione configurazione, le tabelle delle proprietà interne di CMP non vengono aggiornate fino a quando Gestione configurazione non indica che la propria copia degli attributi è stata modificata con esito positivo. Questa operazione viene eseguita per conservare la congruenza di tutte le copie delle informazioni. Tale processo è visualizzato di seguito.


Notare che se l'utente corrente non dispone delle autorizzazioni necessarie, durante il funzionamento di SetLongDescription.java non è possibile determinare se la richiesta viene rifiutata da Gestione configurazione. Il metodo CMP per impostare il campo relativo alla descrizione completa genera un'eccezione ConfigManagerProxyException se e solo se il messaggio per eseguire l'operazione non può essere inviato a Gestione configurazione. Ciò significa che l'output del programma è identico, anche se Gestione configurazione non può modificare la proprietà richiesta.

Il motivo è che Gestione configurazione elabora le richieste da CMP in modo asincrono e quindi potrebbe trascorrere un intervallo di tempo considerevole fino a quando l'azione viene eseguita in Gestione configurazione. Se i metodi come quello descritto in questa sezione non restituiscono il controllo al programma fino a quando i codici di completamento non diventano disponibili, le prestazioni dell'applicazione CMP sono totalmente dipendenti dalle prestazioni di Gestione configurazione.

Successivamente:

La progettazione della maggior parte dei metodi CMP per la modifica dello stato è quella di restituire immediatamente senza informare l'applicazione chiamate del risultato della richiesta. Per rilevare tali informazioni, fare riferimento a Verifica dei risultati della gestione del dominio broker mediante Proxy di Gestione configurazione

Attività correlate
Configurazione di un ambiente per lo sviluppo e l'esecuzione di applicazioni Proxy di Gestione configurazione
Connessione a Gestione configurazione mediante il Proxy di Gestione configurazione
Informazioni particolari | Marchi | Download | Libreria | Supporto | Commenti
Copyright IBM Corporation 1999, 2006 Ultimo aggiornamento: ago 17, 2006
ae33050_