001: /*
002: * JBoss, Home of Professional Open Source.
003: * Copyright 2006, Red Hat Middleware LLC, and individual contributors
004: * as indicated by the @author tags. See the copyright.txt file in the
005: * distribution for a full listing of individual contributors.
006: *
007: * This is free software; you can redistribute it and/or modify it
008: * under the terms of the GNU Lesser General Public License as
009: * published by the Free Software Foundation; either version 2.1 of
010: * the License, or (at your option) any later version.
011: *
012: * This software is distributed in the hope that it will be useful,
013: * but WITHOUT ANY WARRANTY; without even the implied warranty of
014: * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
015: * Lesser General Public License for more details.
016: *
017: * You should have received a copy of the GNU Lesser General Public
018: * License along with this software; if not, write to the Free
019: * Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
020: * 02110-1301 USA, or see the FSF site: http://www.fsf.org.
021: */
022: package org.jboss.ha.jndi;
023:
024: import java.net.UnknownHostException;
025: import java.util.Map;
026: import javax.management.ObjectName;
027:
028: import org.jboss.ha.framework.server.ClusterPartitionMBean;
029: import org.jboss.invocation.Invocation;
030: import org.jboss.util.threadpool.BasicThreadPoolMBean;
031:
032: /** The standard mbean management interface for the DetachedHANamingService
033: *
034: * @author Scott.Stark@jboss.org
035: * @version $Revision: 57188 $
036: *
037: * <p><b>Revisions:</b><br>
038: */
039: public interface DetachedHANamingServiceMBean extends
040: org.jboss.system.ServiceMBean {
041: /**
042: * Gets the name of the HAPartition used by this service.
043: *
044: * @return the name of the partition
045: *
046: * @deprecate use {@link #getClusterPartition()}
047: */
048: String getPartitionName();
049:
050: /**
051: * Sets the name of the HAPartition used by this service.
052: *
053: * @param name the name of the partition
054: *
055: * @deprecate use {@link #setClusterPartition()}
056: */
057: void setPartitionName(String name);
058:
059: /**
060: * Get the underlying partition used by this service.
061: *
062: * @return the partition
063: */
064: ClusterPartitionMBean getClusterPartition();
065:
066: /**
067: * Sets the underlying partition used by this service.
068: *
069: * @param clusterPartition the partition
070: */
071: void setClusterPartition(ClusterPartitionMBean clusterPartition);
072:
073: /** Get the proxy factory service name used to create the Naming transport
074: * proxy.
075: */
076: public ObjectName getProxyFactoryObjectName();
077:
078: /** Set the proxy factory service name used to create the Naming transport
079: * proxy.
080: */
081: public void setProxyFactoryObjectName(ObjectName proxyFactory);
082:
083: /** Get the bootstrap port on which the HA-JNDI stub is made available
084: */
085: int getPort();
086:
087: /** Set the bootstrap port on which the HA-JNDI stub is made available
088: */
089: void setPort(int p);
090:
091: /** Get the bootstrap IP address on which the HA-JNDI stub is made available
092: */
093: String getBindAddress();
094:
095: /** Set the bootstrap IP address on which the HA-JNDI stub is made available
096: */
097: void setBindAddress(String host) throws UnknownHostException;
098:
099: /** Get the accept backlog for the bootstrap server socket
100: */
101: int getBacklog();
102:
103: /** Set the accept backlog for the bootstrap server socket
104: */
105: void setBacklog(int backlog);
106:
107: /**
108: * prevent autodiscovery service from starting
109: */
110: void setDiscoveryDisabled(boolean disabled);
111:
112: /**
113: * prevent autodiscovery service from starting
114: */
115: boolean getDiscoveryDisabled();
116:
117: /** Get the Auto-discovery multicast port
118: */
119: int getAutoDiscoveryGroup();
120:
121: /** Set the Auto-discovery multicast port.
122: */
123: void setAutoDiscoveryGroup(int adGroup);
124:
125: /** Get the auto-discovery bootstrap multicast address.
126: */
127: String getAutoDiscoveryAddress();
128:
129: /** Set the auto-discovery bootstrap multicast address. If null or empty, no
130: * auto-discovery bootstrap socket will be created.
131: */
132: void setAutoDiscoveryAddress(String adAddress);
133:
134: /** Get the auto-discovery bootstrap multicast bind address.
135: */
136: String getAutoDiscoveryBindAddress();
137:
138: /** Set the auto-discovery bootstrap multicast bind address. If not specified
139: * and a BindAddress is specified, the BindAddress will be used.
140: */
141: void setAutoDiscoveryBindAddress(String adAddress)
142: throws UnknownHostException;
143:
144: /** Get the TTL (time-to-live) for autodiscovery IP multicast packets */
145: int getAutoDiscoveryTTL();
146:
147: /** Set the TTL (time-to-live) for autodiscovery IP multicast packets */
148: void setAutoDiscoveryTTL(int ttl);
149:
150: /** Set the thread pool used for the bootstrap and autodiscovery lookups
151: *
152: * @param poolMBean
153: */
154: public void setLookupPool(BasicThreadPoolMBean poolMBean);
155:
156: /** Expose the Naming service interface mapping as a read-only attribute
157: *
158: * @jmx:managed-attribute
159: *
160: * @return A Map<Long hash, Method> of the Naming interface
161: */
162: public Map getMethodMap();
163:
164: /** Expose the Naming service via JMX for detached invokers.
165: *
166: * @param invocation A pointer to the invocation object
167: * @return Return value of method invocation.
168: *
169: * @throws Exception Failed to invoke method.
170: */
171: public Object invoke(Invocation invocation) throws Exception;
172: }
|