//serverSemaphore.java 
//------------------------
//part of YaCy
//(C) by Michael Peter Christen; mc@anomic.de
//first published on http://www.anomic.de
//Frankfurt, Germany, 2005
//
//this file is contributed by Martin Thelian
//last major change: 24.04.2005
//
//This program is free software; you can redistribute it and/or modify
//it under the terms of the GNU General Public License as published by
//the Free Software Foundation; either version 2 of the License, or
//(at your option) any later version.
//
//This program is distributed in the hope that it will be useful,
//but WITHOUT ANY WARRANTY; without even the implied warranty of
//MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
//GNU General Public License for more details.
//
//You should have received a copy of the GNU General Public License
//along with this program; if not, write to the Free Software
//Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
//
//Using this software in any meaning (reading, learning, copying, compiling,
//running) means that you agree that the Author(s) is (are) not responsible
//for cost, loss of data or any harm that may be caused directly or indirectly
//by usage of this softare or this documentation. The usage of this software
//is on your own risk. The installation and usage (starting/running) of this
//software may allow other people or application to access your computer and
//any attached devices and is highly dependent on the configuration of the
//software which must be done by the user of the software; the author(s) is
//(are) also not responsible for proper configuration and usage of the
//software, even if provoked by documentation provided together with
//the software.
//
//Any changes to this file according to the GPL as documented in the file
//gpl.txt aside this file in the shipment you received can be done to the
//lines that follows this copyright notice here, but changes must not be
//done inside the copyright notive above. A re-distribution must contain
//the intact and unchanged copyright notice.
//Contributions and changes to the program code must be marked as such.

package de.anomic.server;

public final class serverSemaphore  {
    private long currentValue = 0;    
    private long maximumValue = Long.MAX_VALUE;
     
    protected serverSemaphore()  {
        this(0,Long.MAX_VALUE);
    }
    
    public serverSemaphore(long initialValue)  {
        this(initialValue,Long.MAX_VALUE);
    }    

    protected serverSemaphore(long initialValue, long maxValue) {
        /* some errorhandling */
        if (maxValue < initialValue) {
            throw new IllegalArgumentException("The semaphore maximum value must not be " +
                                               "greater than the semaphore init value.");
        }
        
        if (maxValue < 1)  {
             throw new IllegalArgumentException("The semaphore maximum value must be greater or equal 1.");          
        }
        
        if (initialValue < 0) {
             throw new IllegalArgumentException("The semaphore initial value must be greater or equal 0.");          
        }
        
        
        // setting the initial Sempahore Values
        this.currentValue = initialValue;
        this.maximumValue = maxValue;        
    }
    
    public synchronized void P() throws InterruptedException
    {   
         this.currentValue-- ;           
        
         if (this.currentValue < 0) {    
             try  { 
                 wait();
             } catch(InterruptedException e) { 
                 this.currentValue++;
                 throw e;
             }
         }
    }

    public synchronized void V() {
        if (this.currentValue+1 == this.maximumValue) {
              throw new IndexOutOfBoundsException("The maximum value of the semaphore was reached");
        }        
        
        this.currentValue++;        
         
        if (this.currentValue <= 0) {
            notify();
        }   
     }
 }