com.jniwrapper.win32.dde

Interface DdeServiceEventHandler

All Known Implementing Classes:

DdeServiceEventAdapter

public interface DdeServiceEventHandler

The interface for processing DDE service events.

Method Summary

Modifier and Type	Method and Description
byte[]	adviseRequest(java.lang.String topic, DdeItem item) Occurs when the value of the item has been changed and it is necessary to notify clients.
boolean	adviseStart(java.lang.String topic, DdeItem item) Occurs when a client begins an advise loop.
void	adviseStop(java.lang.String topic, DdeItem item) Occurs when a client stops an advise loop.
boolean	beforeConnect(java.lang.String topic, boolean sameApplication) Occurs when a client attempts to establish connection with the service.
void	disconnect(boolean sameApplication) Occurs on disconnect.
DdeResponse	execute(java.lang.String topic, java.lang.String command) Occurs when a client makes a command execution request.
DdeResponse	pokeData(java.lang.String topic, DdeItem item, byte[] data) Occurs when a client sends data to the service.
byte[]	requestData(java.lang.String topic, DdeItem item) Occurs when a client makes a request for data.
void	serviceRegister(java.lang.String service, java.lang.String instanceName) Occurs when a service is registered.
void	serviceUnregister(java.lang.String service, java.lang.String instanceName) Occurs when a service is unregistered.

Method Detail

adviseRequest

byte[] adviseRequest(java.lang.String topic,
                     DdeItem item)

Occurs when the value of the item has been changed and it is necessary to notify clients.

Parameters:

topic - is the name of the topic.

item - specifies the item name and data format.

Returns:

a new value of the item data or null if the service is unable to process the request.

adviseStart

boolean adviseStart(java.lang.String topic,
                    DdeItem item)

Occurs when a client begins an advise loop.

Parameters:

topic - is the name of the topic.

item - specifies the item name and data format.

Returns:

true to allow the client to start the advise loop, or false otherwise.

adviseStop

void adviseStop(java.lang.String topic,
                DdeItem item)

Occurs when a client stops an advise loop.

Parameters:

topic - is the name of the topic.

item - specifies the item name.

execute

DdeResponse execute(java.lang.String topic,
                    java.lang.String command)

Occurs when a client makes a command execution request.

Parameters:

topic - is the name of the topic.

command - is the command to be executed.

Returns:

the result of the request processing.

beforeConnect

boolean beforeConnect(java.lang.String topic,
                      boolean sameApplication)

Occurs when a client attempts to establish connection with the service.

Parameters:

topic - is the name of the topic.

sameApplication - specifies if the client and the service are the same application.

Returns:

true to allow the client to connect, or false otherwise.

pokeData

DdeResponse pokeData(java.lang.String topic,
                     DdeItem item,
                     byte[] data)

Occurs when a client sends data to the service.

Parameters:

topic - is the name of the topic.

item - specifies the item name and data format.

data - is the sent data.

Returns:

the result of the event processing.

requestData

byte[] requestData(java.lang.String topic,
                   DdeItem item)

Occurs when a client makes a request for data.

Parameters:

topic - is the name of the topic.

item - specifies the item name and data format.

Returns:

a new value of the item data or null if the service is unable to process the request.

disconnect

void disconnect(boolean sameApplication)

Occurs on disconnect.

Parameters:

sameApplication - specifies if the client and the service are the same application.

serviceRegister

void serviceRegister(java.lang.String service,
                     java.lang.String instanceName)

Occurs when a service is registered.

Parameters:

service - is the basic name of the service.

instanceName - is an instance-specific service name.

serviceUnregister

void serviceUnregister(java.lang.String service,
                       java.lang.String instanceName)

Occurs when a service is unregistered.

Parameters:

service - is the basic name of the service.

instanceName - is an instance-specific service name.