basic

Class Buffer<T>

java.lang.Object

basic.Buffer<T>

Type Parameters:

T -

public class Buffer<T>
extends java.lang.Object

This class represents a Buffer and will be used to send the data from scanner to parser.

Author:

HFW410

Field Summary

Fields

Modifier and Type	Field and Description
private java.lang.Integer	capacity This is the capacity for the buffer.
private java.util.List<T>	data This attribute is the list of data.
private Semaphor	freeSpace queue if the buffer is full.
private Semaphor	mutex lock and unlock the semaphore.
private Semaphor	usedSpace queue if the buffer is empty.

Constructor Summary

Constructors

Constructor and Description
Buffer(java.lang.Integer capacity) This is the constructor.

Method Summary

Modifier and Type	Method and Description
T	peek()
void	put(T object) This method put a new object @param object into the buffer.
T	remove() removes the first element of the buffer.
java.lang.String	toString()

Methods inherited from class java.lang.Object

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

Field Detail

data

private final java.util.List<T> data

This attribute is the list of data.

usedSpace

private final Semaphor usedSpace

queue if the buffer is empty.

freeSpace

private final Semaphor freeSpace

queue if the buffer is full.

mutex

private final Semaphor mutex

lock and unlock the semaphore.

capacity

private final java.lang.Integer capacity

This is the capacity for the buffer.

Constructor Detail

Buffer

public Buffer(java.lang.Integer capacity)

This is the constructor. It initialize a new buffer with the capacity @param capacity No side-effects.

Parameters:

capacity - The capacity of the buffer.

Method Detail

put

public void put(T object)
         throws java.lang.InterruptedException

This method put a new object @param object into the buffer.

Parameters:

object - The object to put into the buffer.

Throws:

java.lang.InterruptedException - if mutex.down does not work

remove

public T remove()
         throws java.lang.InterruptedException

removes the first element of the buffer.

Returns:

the removed data

Throws:

java.lang.InterruptedException - if mutex.down() did not work

peek

public T peek()
       throws java.lang.InterruptedException

Returns:

the first element

Throws:

java.lang.InterruptedException - if mutex.down did not work

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object