org.ws4d.java.communication

Interface CommunicationManagerInternal

All Superinterfaces:

CommunicationManager

All Known Implementing Classes:

DPWSCommunicationManager

public interface CommunicationManagerInternal
extends CommunicationManager

This interface must not be used by anyone but JMEDS itself. The methods are for internal use only!

Field Summary

Fields inherited from interface org.ws4d.java.communication.CommunicationManager

ID_NULL

Method Summary

Modifier and Type	Method and Description
void	kill() Important: This method may only be called from the CommunicationManagerRegistry! Stops this communication manager immediately, closes all connections and frees any used resources without waiting for.
void	start() Important: This method may only be called from the CommunicationManagerRegistry! Starts this communication manager instance.
void	stop() Important: This method may only be called from the CommunicationManagerRegistry! Stops this communication manager as soon as possible, closes all connections and frees any used resources.

Methods inherited from interface org.ws4d.java.communication.CommunicationManager

adaptDeviceTypes, adaptServiceTypes, checkIfAddressIsAnyLocalThenInterface, containsAllDeviceTypes, containsAllSearchScopes, containsAllServiceTypes, createActionNotSupportedFault, createAuthorizationFault, createDynamicEndpointReference, createEndpointUnavailableFault, createEventingException, createInvalidAddressingHeaderFault, createInvocationException, createInvocationExceptionSOAPFault, createInvocationFault, createMessageAddressingHeaderRequiredFault, createProtocolInfo, createProtocolInfo, createSubscriptionFault, getAddressFilter, getAllAvailableDiscoveryDomains, getAllAvailableDiscoveryDomainsSize, getAutoBindingFactory, getAvailableOutgoingDiscoveryInfos, getChildren, getCommunicationBinding, getCommunicationManagerId, getDeviceType, getDeviceTypes, getDiscoveryBinding, getDiscoveryBinding, getDiscoveryBindings, getMetadataValidator, getMulticastAddressAndPortForDiscoveryBinding, getMulticastAddressAndPortForOutgoingDiscoveryInfo, getOutgoingDiscoveryInfo, getOutgoingDiscoveryInfo, getOutgoingDiscoveryInfos, getRandomApplicationDelay, getResourceAsStream, getSupportedVersions, init, isTransportAddress, newDescriptionParser, newDescriptionSerializer, registerDevice, registerDiscovery, registerResource, registerService, send, send, send, setAddressFilter, supportsAddressingNamespace, supportsEventingFilterDialect, unregisterDevice, unregisterDiscovery, unregisterResource, unregisterService, validateMessage

Method Detail

start

void start()
    throws java.io.IOException

Important: This method may only be called from the CommunicationManagerRegistry! Starts this communication manager instance. This method executes any needed initialization steps so that further calls to other methods such as #registerDevice(CommunicationBinding, IncomingMessageListener) , CommunicationManager.send(Message, ProtocolInfo, DataStructure, ResponseCallback), etc. can operate correctly.

If this communication manager has already been started, this method must not do anything else other than quickly return.

Throws:

java.io.IOException - in case initializing communication failed for some reason; the caller should assume that this communication manager instance is not usable

stop

void stop()

Important: This method may only be called from the CommunicationManagerRegistry! Stops this communication manager as soon as possible, closes all connections and frees any used resources. Any further interactions with this instance like #registerDevice(CommunicationBinding, IncomingMessageListener) registering listeners or CommunicationManager.send(Message, ProtocolInfo, DataStructure, ResponseCallback) sending messages will result in WS4DIllegalStateException illegal state exceptions.

If it is necessary to stop the communication manager immediately the kill() method should be used.

WARNING! This method causes the communication manager to loose all of its current state! That is, reactivating the communication manager again after this method has been called will result in having no #registerDevice(CommunicationBinding, IncomingMessageListener), CommunicationManager.registerService(int[], CommunicationBinding, IncomingMessageListener, LocalService) or #registerDiscovery(int[], DiscoveryBinding, IncomingMessageListener) registrations for incoming messages.

If this communication manager has already been stopped, this method must not do anything else other than quickly return.

kill

void kill()

Important: This method may only be called from the CommunicationManagerRegistry! Stops this communication manager immediately, closes all connections and frees any used resources without waiting for. Any further interactions with this instance like #registerDevice(CommunicationBinding, IncomingMessageListener) registering listeners or CommunicationManager.send(Message, ProtocolInfo, DataStructure, ResponseCallback) sending messages will result in WS4DIllegalStateException illegal state exceptions.

WARNING! This method causes the communication manager to loose all of its current state! That is, reactivating the communication manager again after this method has been called will result in having no #registerDevice(CommunicationBinding, IncomingMessageListener), CommunicationManager.registerService(int[], CommunicationBinding, IncomingMessageListener, LocalService) or #registerDiscovery(int[], DiscoveryBinding, IncomingMessageListener) registrations for incoming messages.

If this communication manager has already been stopped, this method must not do anything else other than quickly return