wifi

Class WiFiClient

java.lang.Object

wifi.WiFiClient

All Implemented Interfaces:

java.awt.event.ActionListener, java.lang.Runnable, java.util.EventListener

public class WiFiClient
extends java.lang.Object
implements java.awt.event.ActionListener, java.lang.Runnable

The WiFiClient class provides a GUI for interacting with 802.11~ implementations. It can be used to drive either Java-based or C++-based link layers. (Use a CppGUIAdapter to interface this with C++ code, and a JavaGUIAdapter to drive Java code.) Care is taken to ensure that all GUI-servicing operations occur in the event-dispatching thread while all interactions with 802.11~ code occur in separate threads. Thus the constructor doesn't actually create the GUI — that happens in buildGUI() which is called from the client's run() method. (The run() method also starts up a thread to watch for arriving packets from the 802.11~ layer.) The client's run method is invoked by main via SwingUtilities.invokeAndWait() to ensure it's executed on the event-dispatching thread. A complete Java implementation looks like:

 WiFiClient
 JavaGUIAdapter
 LinkLayer (802.11~ implementation)
 RF
 

A complete C++ implementation is messier, due to the need for additional layers to mediate between the Java and C++ code:

 WiFiClient (Java)
 CppGUIAdapter (Java)
 cppStubs (C++)
 linklayer (802.11~ implementation in C++)
 RF (C++ JNI layer)
 RF (Java implementation of RF layer)
 

See the project documentation for additional information on compiling an 802.11~ project.

Version:

1.2

Author:

Brad Richards

Constructor Summary

Constructors

Constructor and Description
WiFiClient(short MACaddr, GUIClientInterface theLinkLayer) The constructor builds the GUI and prepares it for use.

Method Summary

Modifier and Type	Method and Description
void	actionPerformed(java.awt.event.ActionEvent e) Handler for button-press events.
void	addText(java.lang.String msg) Call this to append text to the scrolling output pane.
static void	main(java.lang.String[] args) The main method selects a MAC address, creates a WiFiClient GUI and associates it with the link layer implementation, then waits in an infinite loop watching for stream output from the link layer and routing into the GUI display.
void	run() The run method should be executed by the event-dispatching thread.

Methods inherited from class java.lang.Object

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

Constructor Detail

WiFiClient

public WiFiClient(short MACaddr,
                  GUIClientInterface theLinkLayer)

The constructor builds the GUI and prepares it for use.

Method Detail

actionPerformed

public void actionPerformed(java.awt.event.ActionEvent e)

Handler for button-press events. Users should never need to call this directly.

Specified by:

actionPerformed in interface java.awt.event.ActionListener

addText

public void addText(java.lang.String msg)

Call this to append text to the scrolling output pane. No newlines are added, so be sure to include a "\n" where desired. Text is collected in a StringBuffer (outputText) as well as the JTextArea (display). This allows us to continue buffering text even when the window output is paused.

Parameters:

msg - Text to add to the scrolling pane

run

public void run()

The run method should be executed by the event-dispatching thread. it creates the GUI and starts a thread to watch for packets arriving for this station.

Specified by:

run in interface java.lang.Runnable

main

public static void main(java.lang.String[] args)

The main method selects a MAC address, creates a WiFiClient GUI and associates it with the link layer implementation, then waits in an infinite loop watching for stream output from the link layer and routing into the GUI display.