se.entra.phantom.client.dde

Class DDEServer

java.lang.Object

se.entra.phantom.client.dde.DDEServer

All Implemented Interfaces:

Runnable, DdeInterface

public class DDEServer
extends Object
implements Runnable, DdeInterface

DDE SERVER main class.

This class interacts between server object calls and the native C++ DDE server (NPDDE and DDESRV DLLs).

This class starts a thread that is the owner of the native DDE window procedure, see constructor and run method.

This class also implements the DdeInterface interface that is accessible from the client classes.

The client loads this class dynamically and set a callback object through the setOwner method. Then new messages are sent from the client through the serverTransaction method. The DDECallServer class passes the message to the message thread and returns. When the message is processed, the DDECallServer message thread will send a reply to the owner (to the server).

If the native DLL want to send a callback message to the server, it is sent through the sendMessage method. This method takes a DDEEvent object as parameter and will use that to send an event to the server. Then is waits (through Object.wait() method) for a reply (through the DdeInterface's serverReply method).

Constructor Summary

Constructors

Constructor and Description
DDEServer()

Method Summary

Modifier and Type	Method and Description
protected int	DDEServerWinProc(DDEEvent event, String serverName) Native function for the DDE window procedure that handles DDE messages from other applications and the DDESRV.DLL.
void	finalize() Stop all threads and (?) unload the DLL.
void	initiate(SessionManager sessionManager, String serverName) Start a new thread that dispatches the native WinProc for DDE.
static boolean	printWindow(Component c) Prints a window from the physical location on the screen.
protected static int	printWindow1(Component c, int xWindow, int yWindow, int x, int y, int cx, int cy) The print window from point.
void	run() Native WinProc thread.
int	sendMessage(DDEEvent event) This is the callback method for NPDDE.
void	serverReply(String retString) Reply from the Server - Java/REXX object.
int	serverTransaction(Transaction trans) New command from server (REXX/Java object).
void	setWindowReady(int hwndDDE) If windowproc not ready, set it ready.

Methods inherited from class java.lang.Object

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

Constructor Detail

DDEServer

public DDEServer()

Method Detail

DDEServerWinProc

protected int DDEServerWinProc(DDEEvent event,
                               String serverName)

Native function for the DDE window procedure that handles DDE messages from other applications and the DDESRV.DLL.

printWindow1

protected static int printWindow1(Component c,
                                  int xWindow,
                                  int yWindow,
                                  int x,
                                  int y,
                                  int cx,
                                  int cy)

The print window from point.

Returns:

1 for success, 0 for failure.

printWindow

public static boolean printWindow(Component c)

Prints a window from the physical location on the screen.

Returns:

false for failure, true for success.

initiate

public void initiate(SessionManager sessionManager,
                     String serverName)

Start a new thread that dispatches the native WinProc for DDE.

Specified by:

initiate in interface DdeInterface

serverTransaction

public int serverTransaction(Transaction trans)

New command from server (REXX/Java object).

Specified by:

serverTransaction in interface DdeInterface

serverReply

public void serverReply(String retString)

Reply from the Server - Java/REXX object. Notify waiting message thread.

Specified by:

serverReply in interface DdeInterface

run

public void run()

Native WinProc thread.

Specified by:

run in interface Runnable

sendMessage

public int sendMessage(DDEEvent event)

This is the callback method for NPDDE. This method is always called from the WindowProc thread.

setWindowReady

public void setWindowReady(int hwndDDE)

If windowproc not ready, set it ready.

finalize

public void finalize()

Stop all threads and (?) unload the DLL.

Overrides:

finalize in class Object