wonderly.jeaprs.aprs.clients
Class APRSObjectItemManager

java.lang.Object
  |
  +--wonderly.jeaprs.ClientImpl
        |
        +--wonderly.jeaprs.aprs.clients.APRSObjectItemManager

All Implemented Interfaces:

Client, java.util.EventListener, java.beans.PropertyChangeListener

public class APRSObjectItemManager

extends ClientImpl

implements java.beans.PropertyChangeListener

This is a JeAPRS module that provides packet logging facilities.

Version:

1.0

Author:

Gregg Wonderly - The information contained in this document is Copyright 2001-2003, Gregg Wonderly, all rights reserved.

Field Summary

Fields inherited from class wonderly.jeaprs.ClientImpl

actions, APRS, dirty, evLis, ins, me, name, outs, stopped, strmLis

Constructor Summary

APRSObjectItemManager()

Method Summary

void	addObject(wonderly.jeaprs.aprs.packet.APRSPacket pkt, wonderly.jeaprs.aprs.packet.APRSObject obj)
void	buildActions() Put code in here to register all of the actions that you want to use.
javax.swing.JPanel	buildPanel(javax.swing.JFrame f) Builds the applications user interface.
wonderly.jeaprs.aprs.packet.APRSEventListener	createEventListener() This method needs to be implemented by subclasses and should return an APRSEventListener implementation that is applicable for their client.
java.io.OutputStream	createStreamListener() This method needs to be implemented by subclasses and should return an OutputStream implementation that is applicable for their client.
void	propertyChange(java.beans.PropertyChangeEvent ev)

Methods inherited from class wonderly.jeaprs.ClientImpl

addAPRSEventGenerator, addAPRSOutputStream, buildMenu, getAction, getAPRSEventGenerators, getAPRSOutputStreams, getName, getUIFactory, isDirty, isInputUser, isOutputUser, removeAPRSEventGenerator, removeAPRSOutputStream, setDirty, setName, start, stop, toString, write, write, write, write

Methods inherited from class java.lang.Object

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

Constructor Detail

APRSObjectItemManager

public APRSObjectItemManager()

Method Detail

propertyChange

public void propertyChange(java.beans.PropertyChangeEvent ev)

Specified by:

propertyChange in interface java.beans.PropertyChangeListener

createEventListener

public wonderly.jeaprs.aprs.packet.APRSEventListener createEventListener()

Description copied from class: ClientImpl

This method needs to be implemented by subclasses and should return an APRSEventListener implementation that is applicable for their client. Many times, a simple inner class is all that is needed as in.

  return new APRSEventAdapter() {
		public void message( APRSPacket pkt, APRSMessage msg ) {
			// Do something with message
		}
	};
	

This will create a new object that is an instance of the APRSEventAdapter class. That class implements the APRSEventListener interface with empty methods so that you can just override the methods that you want APRS packets for, and not have to deal with implementing all methods. Just return null here if you don't need an event listener.

Specified by:

createEventListener in class ClientImpl

See Also:

APRSEventAdapter, APRSEventListener

addObject

public void addObject(wonderly.jeaprs.aprs.packet.APRSPacket pkt,
                      wonderly.jeaprs.aprs.packet.APRSObject obj)

createStreamListener

public java.io.OutputStream createStreamListener()

Description copied from class: ClientImpl

This method needs to be implemented by subclasses and should return an OutputStream implementation that is applicable for their client. This stream will be written to as data comes through a TNC implementatation, receiving copies of the text lines received by the TNC implementation. A simple mechanism is typically to use a thread and a PipedInputStream and PipedOutputStream pair to receive the data and process it. Just return null if you don't need raw stream events.

	public OutputStream createStreamListener() throws IOException {
		final PipedOutputStream pipe = new PipedOutputStream();
		final PipedInputStream is = new PipedInputStream(pipe);
		new Thread("TNC Stream listener") {
			public void run() {
				try {
					BufferedReader rd = new BufferedReader( new InputStreamReader(is) );
					String str;
					while( (str = rd.readLine()) != null ) {
						System.out.println( "Got TNC line: "+str );
					}
					System.out.println("End of TNC Stream, exiting");
				} finally {
					try {
						is.close();
						pipe.close();
					} catch( Exception ex ) {
						JeAPRS.getUI().reportException(ex);
					}
				}
			}
		}.start();
		return pipe;
	}
	

Specified by:

createStreamListener in class ClientImpl

buildPanel

public javax.swing.JPanel buildPanel(javax.swing.JFrame f)

Description copied from class: ClientImpl

Builds the applications user interface. The returned panel should contain all of the controls needed to provide the user with convienent access to the features of this client/module, except for a menu bar. The buildMenu() method can be used to create a menu bar if neededed.

Specified by:

buildPanel in class ClientImpl

See Also:

ClientImpl.buildMenu()

buildActions

public void buildActions()

Description copied from class: ClientImpl

Put code in here to register all of the actions that you want to use.

                actions.put(  "MyAction", act = new AbstractAction( "MyAction" ) {
                        public void actionPerformed( ActionEvent ev ) {
                                //...do something here
                        }
                });
                act.putValue( Action.NAME, "MyAction" );
 

Specified by:

buildActions in class ClientImpl

See Also:

ClientImpl.getAction(String)