REDERNAME Module.java - Revision history

Matt: Reverted edits by Amesycyxa (Talk); changed back to last version by Jmaine

2010-11-26T19:39:57Z

Reverted edits by Amesycyxa (Talk); changed back to last version by Jmaine

Show changes

Amesycyxa at 10:09, 24 November 2010

2010-11-24T10:09:33Z

Show changes

Jmaine: /* Other Notes */

2008-04-17T19:30:03Z

‎Other Notes

Jmaine at 19:25, 17 April 2008

2008-04-17T19:25:20Z

Kyle at 00:35, 12 February 2008

2008-02-12T00:35:27Z

Kyle at 20:08, 11 February 2008

2008-02-11T20:08:31Z

Kyle: /* Reference Implementation */

2008-02-11T20:06:46Z

‎Reference Implementation

Kyle: /* Reference Implementation */

2008-02-11T20:05:14Z

‎Reference Implementation

Kyle: New page: The readerModule is the constructor for the reader. Every reader needs one of these classes. The class needs to extend AbstractPowerModule and implement ReaderModule. =READERNAMEModule=...

2008-02-11T20:01:53Z

New page: The readerModule is the constructor for the reader. Every reader needs one of these classes. The class needs to extend AbstractPowerModule and implement ReaderModule. =READERNAMEModule=...

New page

The readerModule is the constructor for the reader. Every reader needs one of these classes. The class needs to extend AbstractPowerModule and implement ReaderModule.

=READERNAMEModule=
This is the main constructor for the reader There should actually be two constructors. One is an empty constructor that is needed for jaxb to automatically create the reader. It should look like this:

<pre>
public SymbolReaderModule(){
}
</pre>

The readermodule also needs a main constructor with this signature:
<pre>
public SymbolReaderModule(ControlSignal<Boolean> powerControlSignal,GeneralReaderPropertyHolder properties);
</pre>

==Arguments==
# powerControlSignal - The power control signal for the entire reader. It is used to turn the reader on and off as well as to suspend and resume the reader. See information on the power states in the module package for more explanation of this.
# properties - These are the properties that the reader creation wizzard constructed. The GeneralReaderPropertyHolder contains the information required by the [[emulator.xml]].

==Reference Implementation==
This is the constructor for the SymbolReaderModule.

<pre>
public SymbolReaderModule(ControlSignal<Boolean> powerControlSignal,
GeneralReaderPropertyHolder properties) {
</pre>
always start out with a call to the super class
<pre>
super(SymbolReaderModuleOffPowerState.getInstance(),powerControlSignal);
</pre>
write some basic information to the console to let the user know that the reader is starting. Note that we are getting some information from the generalRederProperyHolder
<pre>
consoleLogger = LogFactory.getLog("console."
+ properties.getReaderName());
consoleLogger.info(SymbolReaderModule.startupText
+ "Instantiated Symbol Reader with name: "
+ properties.getReaderName());
consoleLogger.info(SymbolReaderModule.startupText
+ properties.getReaderName() + " IP Address: "
+ properties.getProperty("byte_address"));
consoleLogger.info(SymbolReaderModule.startupText
+ properties.getReaderName() + " has "
+ properties.getNumAntennas() + " antennas");
</pre>
set the name of the reader equal to the name given in the generalReaderPropertyHolder
<pre>
this.name = properties.getReaderName();
</pre>
Initialize the digester and read in the command hander methods supplied in the [[reader.xml]] file
<pre>
digester = new CommandXMLDigester();
digester.parseToCommand(this.getClass().getClassLoader()
.getResourceAsStream(XMLLOCATION + "reader.xml"));
</pre>
Create a new tag memory, create antennas, create a new radio and supply the tagMemory and antennas to the radio
<pre>
SymbolTagMemory tagMemory = new SymbolTagMemory();

HashMap<Integer, Antenna> antennaList = new HashMap<Integer, Antenna>();
for (int i = 0; i < properties.getNumAntennas(); i++) {
logger.debug("creating an antenna: " + i);
antennaList.put(i, new Antenna(i));
}

/* Make a Radio for the reader */
GenericRadio genericRadio = new GenericRadio(antennaList, 25, tagMemory);
</pre>
The symbol reader has two different IP addresses being used. One is for byte commands, and the other is for HTTP commands. parse out the IPs and ports from the GeneralReaderPropertyHolder
<pre>
String byte_address = ((String) properties.getProperty("byte_address"))
.split(":")[0];
int byte_port = Integer.parseInt(((String) properties
.getProperty("byte_address")).split(":")[1]);

String http_address = ((String) properties.getProperty("http_address"))
.split(":")[0];
int http_port = Integer.parseInt(((String) properties
.getProperty("http_address")).split(":")[1]);
</pre>
create the shared resources and supply necessary information to it
<pre>
this.srsr = new SymbolReaderSharedResources(genericRadio, tagMemory,
new ControlSignal<Boolean>(false), name, null, digester,
new ControlSignal<Boolean>(false), new ControlSignal<Boolean>(
false), new ControlSignal<Boolean>(false),
new ControlSignal<Boolean>(false), antennaList.size());
</pre>
Create the communication objects. In this case, we need two communication objects (one for bytes, and one for http), however, most readers will probably only need one. Notice that this is where we supply the reader with the [[READERNAME_Protocol.java|Protocol]], [[READERNAME_StreamReaderFormatter.java|Stream Reader]], and [[READERNAME_LogFormatter.java|Log Formatter]]
this.httpComm = new TCPServerCommunication(new RawProtocol(), this.srsr
.getInteractiveHttpPowerSignal(), this.srsr
.getInteractiveHttpConnectionSignal(), http_address, http_port,
this.name, GenericByteStreamReader.class, new GenericByteLogFormatter());

this.byteComm = new TCPServerCommunication(new RawProtocol(), this.srsr
.getInteractiveBytePowerSignal(), this.srsr
.getInteractiveByteConnectionSignal(), byte_address, byte_port,
this.name, GenericByteStreamReader.class, new GenericByteLogFormatter());

this.interactiveBitAdapter = new ReflectiveCommandAdapter(
"Interactive", new SymbolBitCommandFormatter(), new SymbolBitExceptionHandler(),
this.srsr, new RawCommandSearcher());

this.interactiveHttpAdapter = new ReflectiveCommandAdapter(
"Interactive", null, new SymbolBitExceptionHandler(), this.srsr, new RawCommandSearcher());

this.interactiveBitController = new InteractiveCommandController(
new LoginAuthenticatedCommandControllerOperatingState(
interactiveBitAdapter), this.srsr
.getInteractiveBytePowerSignal(), this.srsr
.getInteractiveByteConnectionSignal(), this.byteComm);

this.interactiveHttpController = new InteractiveCommandController(
new LoginAuthenticatedCommandControllerOperatingState(
interactiveHttpAdapter), this.srsr
.getInteractiveHttpPowerSignal(), this.srsr
.getInteractiveHttpConnectionSignal(), this.httpComm);
}
</pre>

@@ Line 134: / Line 134: @@
 In addition, if you need to override the default command searcher, RawCommandSearcher, then replace this class with a different implementation and pass it to ReflectiveCommandAdapter instead of the default one.
 =Other Methods=
 The ReaderModule will also need to implement some other methods required by the interface that it implements, however, these methods should be nearly identical to similar methods in the other readers.  Please see the other readers and follow examples there for more information.

@@ Line 123: / Line 123: @@
+	}
 </pre>
 =Other Methods=
 The ReaderModule will also need to implement some other methods required by the interface that it implements, however, these methods should be nearly identical to similar methods in the other readers.  Please see the other readers and follow examples there for more information.

← Older revision		Revision as of 00:35, 12 February 2008
Line 1:		Line 1:
		+	[[category:developerDoc]][[category:emulatorDoc]]
	The readerModule is the constructor for the reader. Every reader needs one of these classes. The class needs to extend AbstractPowerModule and implement ReaderModule.		The readerModule is the constructor for the reader. Every reader needs one of these classes. The class needs to extend AbstractPowerModule and implement ReaderModule.

← Older revision		Revision as of 20:08, 11 February 2008
Line 122:		Line 122:
	}		}
	</pre>		</pre>
		+
		+	=Other Methods=
		+	The ReaderModule will also need to implement some other methods required by the interface that it implements, however, these methods should be nearly identical to similar methods in the other readers. Please see the other readers and follow examples there for more information.

@@ Line 98: / Line 98: @@
 				this.name, GenericByteStreamReader.class, new GenericByteLogFormatter());
 </pre>
-Build the adapters for this reader.  Again, because the Symbol reader has two ways of communicating, we need two adapters.  See [[CommandFlow]] for more information about the adapter.  This is where we supply the reader with the [[READERNAME_CommandFormatter.java|CommandFormatter]] and the [[READERNAME_ExceptionHanlder.java|ExceptionHandler]]
+Build the adapters for this reader.  Again, because the Symbol reader has two ways of communicating, we need two adapters.  See [[Command Flow]] for more information about the adapter.  This is where we supply the reader with the [[READERNAME_CommandFormatter.java|CommandFormatter]] and the [[READERNAME_ExceptionHanlder.java|ExceptionHandler]]
 		this.interactiveBitAdapter = new ReflectiveCommandAdapter(
 				"Interactive", new SymbolBitCommandFormatter(), new SymbolBitExceptionHandler(),

@@ Line 87: / Line 87: @@
 </pre>
 Create the communication objects.  In this case, we need two communication objects (one for bytes, and one for http), however, most readers will probably only need one.  Notice that this is where we supply the reader with the [[READERNAME_Protocol.java|Protocol]], [[READERNAME_StreamReaderFormatter.java|Stream Reader]], and [[READERNAME_LogFormatter.java|Log Formatter]]
 		this.httpComm = new TCPServerCommunication(new RawProtocol(), this.srsr
 				.getInteractiveHttpPowerSignal(), this.srsr
@@ Line 96: / Line 97: @@
 				.getInteractiveByteConnectionSignal(), byte_address, byte_port,
 				this.name, GenericByteStreamReader.class, new GenericByteLogFormatter());
+</pre>
 		this.interactiveBitAdapter = new ReflectiveCommandAdapter(
 				"Interactive", new SymbolBitCommandFormatter(), new SymbolBitExceptionHandler(),
@@ Line 103: / Line 105: @@
 		this.interactiveHttpAdapter = new ReflectiveCommandAdapter(
 				"Interactive", null, new SymbolBitExceptionHandler(), this.srsr, new RawCommandSearcher());
+</pre>
 		this.interactiveBitController = new InteractiveCommandController(
 				new LoginAuthenticatedCommandControllerOperatingState(