src-main.org.awakefw.sql.jdbc.http.JdbcHttpSavepointTransfer Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of awake-sql Show documentation
Awake SQL is an open source framework that allows remote and secure JDBC access through HTTP.
There is a newer version: 2.0.2
/*
 * This file is part of Awake SQL. 
 * Awake SQL: Remote JDBC access over HTTP.                                    
 * Copyright (C) 2013,  KawanSoft SAS
 * (http://www.kawansoft.com). All rights reserved.                    
 *                                                                         
 * Awake SQL 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.         
 *              
 * Awake SQL 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          
 * Lesser General Public License for more details.       
 *                                  
 * You should have received a copy of the GNU General Public License
 * along with this program; if not, see .
 *
 * If you develop commercial activities using Awake SQL, you must: 
 * a) disclose and distribute all source code of your own product,
 * b) license your own product under the GNU General Public License.
 * 
 * You can be released from the requirements of the license by
 * purchasing a commercial license. Buying such a license will allow you 
 * to ship Awake SQL with your closed source products without disclosing 
 * the source code.
 *
 * For more information, please contact KawanSoft SAS at this
 * address: [email protected]
 * 
 * Any modifications to this file must keep this entire header
 * intact.
 */
package org.awakefw.sql.jdbc.http;

import java.sql.SQLException;
import java.sql.Savepoint;
import java.util.List;
import java.util.Vector;

import org.apache.http.message.BasicNameValuePair;
import org.awakefw.commons.api.client.InvalidLoginException;
import org.awakefw.file.api.util.AwakeDebug;
import org.awakefw.file.api.util.HtmlConverter;
import org.awakefw.file.http.HttpTransfer;
import org.awakefw.file.http.HttpTransferOne;
import org.awakefw.file.util.AwakeClientLogger;
import org.awakefw.file.util.parms.Parameter;
import org.awakefw.file.util.parms.ReturnCode;
import org.awakefw.sql.api.client.InvalidatedSessionException;
import org.awakefw.sql.jdbc.ConnectionHttp;
import org.awakefw.sql.transport.SavepointHttp;
import org.awakefw.sql.util.ConnectionParms;
import org.awakefw.sql.util.SqlActionTransaction;
import org.awakefw.sql.util.SqlReturnCode;

/**
 * 
 * For all Savepoint actions get/set transfers...
 * 
 */
public class JdbcHttpSavepointTransfer {
    
    /** Set to true to display/log debug info */
    private static boolean DEBUG = AwakeDebug
	    .isSet(JdbcHttpSavepointTransfer.class);

    /** The Http Connection */
    private ConnectionHttp connectionHttp = null;

    /** The Authentication Token */
    private String authenticationToken = null;

    /**
     * Protected constructor, not callable
     */
    protected JdbcHttpSavepointTransfer() {
    }

    /**
     * Constructor
     * 
     * @param connectionHttp
     *            the http Connection
     * @param authenticationToken
     *            the Http Connection Authentication Token
     */

    public JdbcHttpSavepointTransfer(ConnectionHttp connectionHttp,
	    String authenticationToken) {
	this.connectionHttp = connectionHttp;
	this.authenticationToken = authenticationToken;
    }

    /*
    setSavepoint
    setSavepoint(name)
    rollback(Savepoint savepoint) 
    releaseSavepoint(Savepoint savepoint)
    */
    
    /**
     * Sends a setSavepoint() to server
     * 
     * @return the Savepoint get from server
     */
    public Savepoint setSavepoint() throws SQLException {
	
	String savepointStr = null;
	
	savepointStr = setSavepointAction(SqlActionTransaction.ACTION_SQL_SET_SAVEPOINT,
		ConnectionParms.NO_PARM, "NO_PARM");
	
	savepointStr = HtmlConverter.fromHtml(savepointStr);
	
	Savepoint savepointHttp = SavepointHttp.buildFromString(savepointStr);
	return savepointHttp;	
    }
    
    /**
     * Sends a setSavepoint(String name) to server
     * 
     * @return the Savepoint get from server
     */
    public Savepoint setSavepoint(String name) throws SQLException {
	
	String savepointStr = null;
	
	savepointStr = setSavepointAction(SqlActionTransaction.ACTION_SQL_SET_SAVEPOINT_NAME,
		ConnectionParms.NAME , HtmlConverter.toHtml(name));
	
	savepointStr = HtmlConverter.fromHtml(savepointStr);
	
	Savepoint savepointHttp = SavepointHttp.buildFromString(savepointStr);
	return savepointHttp;	
    }
    
    /**
     * Sends a rollback(Savepoint savepoint) to server
     * 
     */
    public void rollback(Savepoint savepoint) throws SQLException {
	
	String savepointStr = savepoint.toString();
	savepointStr = HtmlConverter.toHtml(savepointStr);
	
	setSavepointAction(SqlActionTransaction.ACTION_SQL_SET_ROLLBACK_SAVEPOINT,
		ConnectionParms.SAVEPOINT, savepointStr);
	
    }
    
    /**
     * Sends a releaseSavepoin(tSavepoint savepoint) to server
     * 
     * @return the Savepoint get from server
     */
    public void releaseSavepoint(Savepoint savepoint) throws SQLException {
	
	String savepointStr = savepoint.toString();
	savepointStr = HtmlConverter.toHtml(savepointStr);
	
	setSavepointAction(SqlActionTransaction.ACTION_SQL_SET_RELEASE_SAVEPOINT,
		ConnectionParms.SAVEPOINT, savepointStr);
    }
    
        
    
    /**
     * Sets a Savepoint action 
     * 
     * @param savepointAction
     *            the action
     * @param savepointParmName
     *            the parm name
     * @param savepointParmValue
     *            the parm value
     *            
     * @throws SQLException
     */
    private String setSavepointAction(String savepointAction,
	    String savepointParmName, String savepointParmValue)
	    throws SQLException {

	// Launch the Servlet
	HttpTransfer httpTransfer = new HttpTransferOne(
		connectionHttp.getUrl(), connectionHttp.getHttpProxy(),
		connectionHttp.getHttpProtocolParameters(),
		connectionHttp.getAwakeProgressManager());

	List requestParams = new Vector();
	requestParams.add(new BasicNameValuePair(Parameter.ACTION,
		savepointAction));
	requestParams.add(new BasicNameValuePair(Parameter.USERNAME,
		connectionHttp.getUsername()));
	requestParams.add(new BasicNameValuePair(Parameter.TOKEN,
		this.authenticationToken));

	requestParams.add(new BasicNameValuePair(
		ConnectionParms.CONNECTION_ID, connectionHttp
			.getConnectionId()));
	requestParams.add(new BasicNameValuePair(savepointParmName,
		savepointParmValue));

	try {
	    httpTransfer.send(requestParams);
	} catch (Exception e) {
	    JdbcHttpTransferUtil.wrapExceptionAsSQLException(e);
	}

	String receive = httpTransfer.recv();
	receive = receive.trim();

	debug("httpTransfer.recv(): " + receive + ":");

	if (receive.startsWith(ReturnCode.INVALID_LOGIN_OR_PASSWORD)) {
	    throw new SQLException(new InvalidLoginException());
	}

	if (receive.startsWith(SqlReturnCode.SESSION_INVALIDATED)) {
	    throw new SQLException(new InvalidatedSessionException());
	}

	return receive;
    }

    /**
     * Debug tool
     * 
     * @param s
     */

    // @SuppressWarnings("unused")
    private void debug(String s) {
	if (DEBUG) {
	    AwakeClientLogger.log(s);
	}
    }
}