package rasj;

import rasj.global.*;

/*
* This file is part of rasdaman community.
*
* Rasdaman community 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 3 of the License, or
* (at your option) any later version.
*
* Rasdaman community 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 rasdaman community.  If not, see <http://www.gnu.org/licenses/>.
*
* Copyright 2003, 2004, 2005, 2006, 2007, 2008, 2009 Peter Baumann /
rasdaman GmbH.
*
* For more information please see <http://www.rasdaman.org>
* or contact Peter Baumann via <baumann@rasdaman.com>.
*/
/** ***********************************************************
 * <pre>
 *
 * PURPOSE:
 * This exception is thrown if a {@link rasj.RasMArrayShort RasMArrayShort} is trying to be sent to the
 * server for ODMG type UShort where one or more cell values exceed 2^16 or are negative. Such cell values are illegal
 * because the ODMG standard restricts unsigned short values (i.e. in the RasDaMan server)
 * to 2 bytes, whereas java integer values have 4 bytes.
 * Although in this case the server would store only the least 2 bytes of the cell value without throwing an
 * exception, the java client interface does not allow sending such illegal short values in order
 * to enforce application integrity.
 * @see rasj.RasMArrayShort
 * @version $Revision: 1.4 $
 *
 *
 * COMMENTS:
 *
 * </pre>
 *********************************************************** */

public class RasIllegalUShortValueException extends RasRuntimeException
{
    static final String rcsid = "@(#)Package rasj, class RasIllegalUShortValueException: $Header: /home/rasdev/CVS-repository/rasdaman/java/rasj/RasIllegalUShortValueException.java,v 1.4 2003/12/19 16:22:27 rasdev Exp $";

    // the base type
    int illegalValue = 0;

    /**
     * Standard constructor getting the illegal short value
     * @param illegalShortValue the cell value that caused the error
     **/
    public RasIllegalUShortValueException(int illegalUShortValue)
    {
	super(RasGlobalDefs.ILLEGAL_USHORT_VALUE);
	illegalValue = illegalUShortValue;
    }

    /**
     * Returns the error message.
     * @return the error message.
     **/
    public String getMessage()
    {
	int i;

	if(super.getMessage() == null)
	    {
		String msg = RasErrorTexts.getErrorMessage(errNo);

		StringBuffer buf = new StringBuffer(msg);
		i = msg.indexOf( RasGlobalDefs.KEYWORD_VAL );
		if(i != -1)
		    buf.replace(i, i+RasGlobalDefs.KEYWORD_VAL.length(), String.valueOf(illegalValue));
		msg = buf.toString();
		return msg;
	    }
        else
	    return super.getMessage();
    }

}