Package org.jgroups.protocols.dns

Class DNS_PING

java.lang.Object

org.jgroups.stack.Protocol

org.jgroups.protocols.Discovery

org.jgroups.protocols.dns.DNS_PING

All Implemented Interfaces:

Lifecycle

public class DNS_PING
extends Discovery

Nested Class Summary

Nested classes/interfaces inherited from class org.jgroups.protocols.Discovery

Discovery.DiscoveryCacheDisseminationTask

Field Summary

Fields

Modifier and Type	Field	Description
protected java.lang.String	dns_address
protected java.lang.String	dns_context_factory
protected java.lang.String	dns_query
protected java.lang.String	dns_record_type
protected DNSResolver	dns_resolver
protected boolean	probe_transport_ports

Fields inherited from class org.jgroups.protocols.Discovery

async_discovery, async_discovery_use_separate_thread_per_request, break_on_coord_rsp, cluster_name, current_coord, discovery_req_futures, discovery_rsp_callback, discovery_rsp_expiry_time, is_coord, is_leaving, is_server, max_members_in_discovery_request, max_rank_to_reply, num_discovery_requests, num_discovery_runs, ping_responses, return_entire_cache, send_cache_on_join, sends_can_block, stagger_timeout, timer, transport, transport_supports_multicasting, use_disk_cache, view, WHITESPACE

Fields inherited from class org.jgroups.stack.Protocol

after_creation_hook, down_prot, ergonomics, id, local_addr, log, policies, stack, stats, up_prot

Constructor Summary

Constructors

Constructor	Description
DNS_PING()

Method Summary

Modifier and Type	Method	Description
void	destroy()	This method is called on a JChannel.close().
java.lang.String	fetchFromDns()
void	findMembers(java.util.List<Address> members, boolean initial_discovery, Responses responses)	Fetches information (e.g.
java.lang.String	getDNSAddress()
java.lang.String	getDNSContextFactory()
void	init()	Called after a protocol has been created and before the protocol is started.
boolean	isDynamic()
protected void	sendDiscoveryRequest(Message req)
DNS_PING	setDNSQuery(java.lang.String query)
DNS_PING	setDNSResolver(DNSResolver resolver)
protected void	validateProperties()

Methods inherited from class org.jgroups.protocols.Discovery

addDiscoveryResponseToCaches, addResponse, addResponse, addressAsString, addToCache, breakOnCoordResponse, breakOnCoordResponse, callFindMembersInAllDiscoveryProtocols, clearRequestFutures, deserialize, discoveryRequestReceived, discoveryRspExpiryTime, disseminateDiscoveryInformation, down, dumpCache, findInitialMembersAsString, findMembers, findTopmostDiscoveryProtocol, getClusterName, getCurrentCoord, getNumberOfDiscoveryRequestsSent, getView, getViewId, handle, handleConnect, handleDisconnect, handleDiscoveryResponse, handleDiscoveryResponse, isCoord, isMergeRunning, marshal, marshal, marshal, print, providedUpServices, read, readPingData, resetStats, returnEntireCache, returnEntireCache, sendCacheInformation, sendCacheOnJoin, sendCacheOnJoin, sendDiscoveryResponse, sendDiscoveryResponse, serializeWithoutView, setClusterName, staggerTimeout, staggerTimeout, start, startCacheDissemination, stop, up, up, up, useDiskCache, useDiskCache, weedOutCompletedDiscoveryResponses, write

Methods inherited from class org.jgroups.stack.Protocol

accept, addPolicy, addr, addr, afterCreationHook, down, down, enableStats, getAddress, getComponents, getDownProtocol, getDownServices, getId, getIdsAbove, getLevel, getLog, getName, getPolicies, getProtocolStack, getSocketFactory, getThreadFactory, getTransport, getUpProtocol, getUpServices, getValue, isErgonomics, level, parse, policies, providedDownServices, removePolicy, requiredDownServices, requiredUpServices, resetStatistics, setAddress, setDownProtocol, setErgonomics, setId, setLevel, setPolicies, setProtocolStack, setSocketFactory, setUpProtocol, setValue, statsEnabled, toString

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

dns_context_factory

protected java.lang.String dns_context_factory

dns_address

protected java.lang.String dns_address

dns_record_type

protected java.lang.String dns_record_type

dns_query

protected java.lang.String dns_query

probe_transport_ports

protected boolean probe_transport_ports

dns_resolver

protected volatile DNSResolver dns_resolver

Constructor Detail

DNS_PING

public DNS_PING()

Method Detail

init

public void init()
          throws java.lang.Exception

Description copied from class: Protocol

Called after a protocol has been created and before the protocol is started. Attributes are already set. Other protocols are not yet connected and events cannot yet be sent.

Specified by:

init in interface Lifecycle

Overrides:

init in class Discovery

Throws:

java.lang.Exception - Thrown if protocol cannot be initialized successfully. This will cause the ProtocolStack to fail, so the the channel constructor will throw an exception

setDNSResolver

public DNS_PING setDNSResolver(DNSResolver resolver)

setDNSQuery

public DNS_PING setDNSQuery(java.lang.String query)

getDNSContextFactory

public java.lang.String getDNSContextFactory()

getDNSAddress

public java.lang.String getDNSAddress()

validateProperties

protected void validateProperties()

destroy

public void destroy()

Description copied from class: Protocol

This method is called on a JChannel.close(). Does some cleanup; after the call, the VM will terminate

Specified by:

destroy in interface Lifecycle

Overrides:

destroy in class Protocol

isDynamic

public boolean isDynamic()

Specified by:

isDynamic in class Discovery

fetchFromDns

public java.lang.String fetchFromDns()

findMembers

public void findMembers(java.util.List<Address> members,
                        boolean initial_discovery,
                        Responses responses)

Description copied from class: Discovery

Fetches information (e.g. physical address, logical name) for the given member addresses. Needs to add responses to the Responses object. If Discovery.async_discovery is true, this method will be called in a separate thread, otherwise the caller's thread will be used.

Specified by:

findMembers in class Discovery

Parameters:

members - A list of logical addresses (typically UUIDs). If null, then information for all members is fetched

initial_discovery - Set to true if this is for the initial membership discovery. Some protocols (e.g. file based ones) may return only the information for the coordinator(s).

responses - The list to which responses should be added

sendDiscoveryRequest

protected void sendDiscoveryRequest(Message req)