com.ibm.broker.config.proxy

Class TopologyProxy


  • Deprecated. 
    Use the BrokerProxy class to access brokers, and use WebSphere MQ to manage publish/subscribe networks.

    public class TopologyProxy
    extends AdministeredObject
    This class is no longer used and has been deprecated.

    The TopologyProxy class was used to access the list of brokers within a Configuration Manager, and also to manipulate the publish/subscribe topology. In Websphere Message Broker V7 the Configuration Manager was removed and as such this class is no longer required. Applications should use WebSphere MQ to manage publish/subscribe networks, and should use the BrokerProxy class to connect directly with brokers.

    For compatibility with older applications, it is possible (though not recommended) to connect to V7 brokers through the ConfigManagerProxy.getInstance() method. In this case, the returned ConfigManagerProxy object can access a dummy TopologyProxy instance using the getTopology() method. This TopologyProxy object will contain a reference to a single broker to which the application is actually connected.

     
     Change Activity:
     --------- ----------- ------------- ------------------------------------
     Reason:   Date:       Originator:   Comments:
     --------- ----------- ------------- ------------------------------------
     f25103.7  2004-03-18  HDMPL         v6 Release
     f44739.7  2007-07-30  HDMPL         v6.1 release:
                                             Methods now return genericized types where relevant
                                             Added adoptBroker(String, String, String)
     d50079    2008-04-18  HDMPL         v6.1.0.2 release:
                                             Deprecated removeDeletedBroker()
     f51619    2008-07-14  HDMPL         v7 release:
                                             Deprecated the TopologyProxy class
     
     
    • Method Detail

      • createBroker

        public BrokerProxy createBroker(java.lang.String name,
                                        java.lang.String qmgr)
                                 throws ConfigManagerProxyLoggedException
        Deprecated. This method is not used as of WebSphere Message Broker V7. To create a broker use the mqsicreatebroker command instead.
        This method returns null. From WebSphere Message Broker V7 there is no longer a concept of a domain (or Configuration Manager) to which brokers belong, so it is no longer necessary to add a broker to a domain using this method. Brokers are created using the mqsicreatebroker command and can then be administered directly.
        Throws:
        ConfigManagerProxyLoggedException
      • removeDeletedBroker

        public void removeDeletedBroker(java.lang.String nameOrUUID)
                                 throws ConfigManagerProxyLoggedException
        Deprecated. This method is not used as of WebSphere Message Broker V7. To delete a broker use the mqsideletebroker command instead.
        This method does nothing. From WebSphere Message Broker V7 there is no longer a concept of a domain (or Configuration Manager) to which brokers belong, so it is no longer relevant to remove brokers from one. Brokers are deleted using the mqsideletebroker command.
        Throws:
        ConfigManagerProxyLoggedException
      • deploy

        public void deploy()
                    throws ConfigManagerProxyLoggedException
        Deprecated. This method is not used as of WebSphere Message Broker V7. Use WebSphere MQ to manage the publish/subscribe topology.
        This method does nothing. From WebSphere Message Broker V7 there is no longer a concept of a publish/subscribe topology, so it is no longer relevant to deploy to one.
        Throws:
        ConfigManagerProxyLoggedException
      • deploy

        public void deploy(boolean isDelta)
                    throws ConfigManagerProxyLoggedException
        Deprecated. This method is not used as of WebSphere Message Broker V7. Use WebSphere MQ to manage the publish/subscribe topology.
        This method does nothing. From WebSphere Message Broker V7 there is no longer a concept of a publish/subscribe topology, so it is no longer relevant to deploy to one.
        Parameters:
        isDelta - Ignored
        Throws:
        ConfigManagerProxyLoggedException
      • deploy

        public DeployResult deploy(boolean isDelta,
                                   long timeToWaitMs)
                            throws ConfigManagerProxyLoggedException
        Deprecated. This method is not used as of WebSphere Message Broker V7. Use WebSphere MQ to manage the publish/subscribe topology.
        This method does nothing. From WebSphere Message Broker V7 there is no longer a concept of a publish/subscribe topology, so it is no longer relevant to deploy to one.
        Throws:
        ConfigManagerProxyLoggedException
      • getBrokers

        public java.util.Enumeration<BrokerProxy> getBrokers(java.util.Properties props)
                                                      throws ConfigManagerProxyPropertyNotInitializedException
        Deprecated. Use BrokerProxy.getInstance() to access the broker directly.
        Returns an Enumeration that contains the connected broker's BrokerProxy instance, if it matches the filter specified by the Properties argument.
        Parameters:
        props - Filter to select the broker. Each key is an attribute name of the required object and each value is the required value of the attribute. A null or empty Properties object is guaranteed to match the broker.
        Returns:
        Enumeration containing one BrokerProxy object, if it matched the supplied filter. If the BrokerProxy object did not match the filter, the returned Enumeration will be empty.
        Throws:
        ConfigManagerProxyPropertyNotInitializedException
      • getBroker

        public BrokerProxy getBroker(java.util.Properties props)
                              throws ConfigManagerProxyPropertyNotInitializedException
        Deprecated. Use BrokerProxy.getInstance() to access the broker directly.
        Returns the connected broker's BrokerProxy instance, if it matches the filter specified by the Properties argument.
        Parameters:
        props - Filter to select the broker. Each key is an attribute name of the required object and each value is the required value of the attribute. A null or empty Properties object is guaranteed to match the broker.
        Returns:
        BrokerProxy The connected BrokerProxy object, if it matched the supplied filter. If the BrokerProxy object did not match the filter, the returned value will be null.
        Throws:
        ConfigManagerProxyPropertyNotInitializedException
      • createConnectionByUUID

        public void createConnectionByUUID(java.lang.String sourceUUID,
                                           java.lang.String targetUUID)
                                    throws ConfigManagerProxyLoggedException
        Deprecated. This method is not used as of WebSphere Message Broker V7. Use WebSphere MQ to manage the publish/subscribe topology.
        This method does nothing. From WebSphere Message Broker V7 there is no longer a concept of a publish/subscribe topology, so it is no longer relevant to create connections to one.
        Throws:
        ConfigManagerProxyLoggedException
      • deleteConnectionByUUID

        public void deleteConnectionByUUID(java.lang.String sourceUUID,
                                           java.lang.String targetUUID)
                                    throws ConfigManagerProxyLoggedException
        Deprecated. This method is not used as of WebSphere Message Broker V7. Use WebSphere MQ to manage the publish/subscribe topology.
        This method does nothing. From WebSphere Message Broker V7 there is no longer a concept of a publish/subscribe topology, so it is no longer relevant to delete connections from one.
        Throws:
        ConfigManagerProxyLoggedException
      • createCollective

        public CollectiveProxy createCollective(java.lang.String name)
                                         throws ConfigManagerProxyLoggedException
        Deprecated. This method is not used as of WebSphere Message Broker V7. Use WebSphere MQ to manage the publish/subscribe topology.
        This method returns null. From WebSphere Message Broker V7 there is no longer a concept of a publish/subscribe topology, so it is no longer relevant to create collectives in one.
        Throws:
        ConfigManagerProxyLoggedException
      • getNumberOfConnections

        public int getNumberOfConnections(java.lang.String brokerUUID)
                                   throws ConfigManagerProxyPropertyNotInitializedException
        Deprecated. This method is not used as of WebSphere Message Broker V7. Use WebSphere MQ to manage the publish/subscribe topology.
        This method returns 0. From WebSphere Message Broker V7 there is no longer a concept of a publish/subscribe topology, so it is no longer relevant to report the number of connections to one.
        Throws:
        ConfigManagerProxyPropertyNotInitializedException
      • getNumberOfConnections

        public int getNumberOfConnections()
                                   throws ConfigManagerProxyPropertyNotInitializedException
        Deprecated. This method is not used as of WebSphere Message Broker V7. Use WebSphere MQ to manage the publish/subscribe topology.
        This method returns 0. From WebSphere Message Broker V7 there is no longer a concept of a publish/subscribe topology, so it is no longer relevant to report the number of connections to one.
        Throws:
        ConfigManagerProxyPropertyNotInitializedException
      • getConfigurationObjectTypeOfParent

        public ConfigurationObjectType getConfigurationObjectTypeOfParent()
        Deprecated. 
        Returns the ConfigurationObjectType associated with the logical parent of this AdministeredObject type.
        Specified by:
        getConfigurationObjectTypeOfParent in class AdministeredObject
        Returns:
        ConfigurationObjectType associated with the logical parent of this class.
      • toString

        public java.lang.String toString()
        Deprecated. 
        Displays the name of the object
        Overrides:
        toString in class AdministeredObject
        Returns:
        String Representation of the current object
      • getAccessControlEntries

        public AccessControlEntry[] getAccessControlEntries()
        Deprecated. This method is unique to Configuration Manager connections, and as such is no longer used as of WebSphere Message Broker V7.
        This method returns an array with no elements.