org.jasig.portal.utils
Class BlockingStack

java.lang.Object
  org.jasig.portal.utils.BlockingStack

public class BlockingStack
extends Object

A simple FILO stack that has MIN/MAX capacity and that blocks if either push/pop would result in violation of these limits. Default values for min/max are 0/infinite

Author:

Peter Kharchenko

Method Summary

boolean	empty()
int	getMaxSize()
int	getMinSize()
Object	nonBlockingPop() Regular, non-blocking pop
boolean	nonBlockingPush(Object o) Regular, non-blocking push.
Object	pop() Remove object from the top of the stack
void	push(Object o) Add new object to the top of the stack
boolean	remove(Object o) Find and remove a specific object from the stack
void	setLimits(int max, int min) Set the stack limits.
void	setMaxSize(int max)
void	setMinSize(int min)
int	size()

Methods inherited from class java.lang.Object

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

Method Detail

empty

public boolean empty()

push

public void push(Object o)
          throws InterruptedException

Add new object to the top of the stack

Parameters:

o - object to be placed on the stack

Throws:

InterruptedException

pop

public Object pop()
           throws InterruptedException

Remove object from the top of the stack

Throws:

InterruptedException - if the wait was interrupted

nonBlockingPop

public Object nonBlockingPop()
                      throws EmptyStackException

Regular, non-blocking pop

Throws:

EmptyStackException

nonBlockingPush

public boolean nonBlockingPush(Object o)

Regular, non-blocking push.

setLimits

public void setLimits(int max,
                      int min)

Set the stack limits. To specify a stack without an upper bound (that is max=inifinity) use max value of -1

remove

public boolean remove(Object o)

Find and remove a specific object from the stack

getMaxSize

public int getMaxSize()

getMinSize

public int getMinSize()

setMaxSize

public void setMaxSize(int max)

setMinSize

public void setMinSize(int min)

size

public int size()