READERNAME TagMemory.java - Revision history

Kyle at 00:36, 12 February 2008

2008-02-12T00:36:21Z

Kyle: /* clear */

2008-02-12T00:32:05Z

‎clear

Kyle: /* clear */

2008-02-12T00:31:38Z

‎clear

Kyle: New page: This class is in charge of remembering tags that the reader has seen. It works in conjunction with the Radio. It should implement TagMemory. In addition, it should use the RifidiTag...

2008-02-12T00:29:44Z

New page: This class is in charge of remembering tags that the reader has seen. It works in conjunction with the Radio. It should implement TagMemory. In addition, it should use the RifidiTag...

New page

This class is in charge of remembering tags that the reader has seen. It works in conjunction with the [[Radio]]. It should implement TagMemory. In addition, it should use the RifidiTagMap to store tags.

=updateMemory=

This method is called after a scan. It contains a list of tags that the reader has seen on its most recent scan. It is up to the reader's tag memory to decide what to do with the tags that have been seen.

<pre>public void updateMemory(Collection<RifidiTag> tagsToAdd);</pre>

==Arguments==
# tagsToAdd - The collection of tags that have been seen in the latest scan.

==Reference Implementation==
This is the implementation of the addProtocol() method in the symbol reader. The symbol reader keeps two lists of tags: those tags that can be currently seen by the reader (visible tags), and those that have been seen by the reader, but have not been purged(invisible). Every time the updateMemory method is called, the symbol reader adds the tags that it has just seen to the list of visible tags. It then generates the set difference between the visible and the tags that have just been seen (those tags that are still in the visible list, but not in the 'just seen list'). These tags must be added to the invisible list and removed from the visible list.

As you can see, every reader will handle this method completely differently, depending on its tag memory model.
<pre>
public void updateMemory(Collection<RifidiTag> tagsSeen) {
if (!suspended) {
//add new tags to visible
tagBufferVisible.addTags(tagsSeen);

//move old tags to invisible tags
Collection<RifidiTag>diff = tagBufferVisible.generateSetDiff(tagsSeen);
tagBufferInvisible.addTags(diff);
tagBufferVisible.removeTags_tag(diff);
}
}
</pre>

=getTagReport=

This method returns a tag list. Most readers will need a method such as this one

<pre>public Collection<RifidiTag> getTagReport();</pre>

==Return Value==
A collection of RifidiTags

==Reference Implementation==
This is the implementation of the getTagReport() method in the symbol reader
<pre>
public Collection<RifidiTag> getTagReport() {
return this.tagBufferVisible.getTagList();
}
</pre>

=clear=

This method purges the tag list

<pre>public void clear();</pre>

==Reference Implementation==
This is the implementation of the clear() method in the symbol reader
<pre>
public void clear() {
this.tagBufferVisible.clear();
this.tagBufferInvisible.clear();
}
</pre>

=clear=

This method purges the tag list

<pre>public void clear();</pre>

==Reference Implementation==
This is the implementation of the clear() method in the symbol reader
<pre>
public void clear() {
this.tagBufferVisible.clear();
this.tagBufferInvisible.clear();
}
</pre>

=clear=

This method purges the tag list

<pre>public void clear();</pre>

==Reference Implementation==
This is the implementation of the clear() method in the symbol reader
<pre>
public void clear() {
this.tagBufferVisible.clear();
this.tagBufferInvisible.clear();
}
</pre>

← Older revision		Revision as of 00:36, 12 February 2008
Line 1:		Line 1:
		+	[[category:developerDoc]][[category:emulatorDoc]]
	This class is in charge of remembering tags that the reader has seen. It works in conjunction with the [[Radio]]. It should implement TagMemory. In addition, it should use the RifidiTagMap to store tags.		This class is in charge of remembering tags that the reader has seen. It works in conjunction with the [[Radio]]. It should implement TagMemory. In addition, it should use the RifidiTagMap to store tags.

@@ Line 74: / Line 74: @@
 </pre>
-=clear=
+=resume=
-This method purges the tag list
+Readers need to be able to suspend and resume their tag memories to make sure that they don't change while the reader is suspended
-<pre>public void clear();</pre>
+<pre>public void resume();</pre>
 ==Reference Implementation==
-This is the implementation of the clear() method in the symbol reader
+Normally readers can just have a boolean in the tagMemory that will not allow anything to happen if the boolean is true.  See the updateTagMemory() method above for an example.
 <pre>
-	public void clear() {
+	public void resume() {
-		this.tagBufferVisible.clear();
+		suspended = false;
-		this.tagBufferInvisible.clear();
+	}
 </pre>