如何直接在浏览器内运行SQL命令

　2003-09-06 16:30:21　来源：WEB开发网　　　

核心提示：本文示范了如何用一个java Servlet、一个jsp页面和一个静态Java类构造出一个SQL网关应用，利用这个应用，如何直接在浏览器内运行SQL命令，你可以直接在浏览器内执行SQL命令，浏览器将把SQL命令提交给远程服务器上的数据库系统，请注意这个方法的声明中带有synchronized关键词，这是为了避免两个或

　　本文示范了如何用一个java Servlet、一个jsp页面和一个静态Java类构造出一个SQL网关应用。利用这个应用，你可以直接在浏览器内执行SQL命令，浏览器将把SQL命令提交给远程服务器上的数据库系统，然后返回结果。

　　如果你正在使用ISP（Internet Service PRovider）提供的数据库，可能已经熟悉SQL网关应用的概念了。有的ISP会提供一个操作数据库的HTML页面，就象本文提供的网关应用一样。如果ISP没有提供这样的界面，你可以把本文的程序上载到服务器，以后要访问ISP服务器上的数据库就很方便了。

　　SQL网关应用不仅可以用于开发过程，而且还可以直接提供给比较熟悉系统的最终用户使用。当然，允许最终用户直接在数据库上运行SQL命令会带来一些安全隐患，应当慎重考虑。

　　本文要求读者具备一定的Java、Servlet、JSP和数据库的基础知识，如果要运行本文的程序，还要有一个Servlet/JSP服务器和数据库服务器。在下面的说明中，我们要使用的是Tomcat 4.0和MySQL，但它应该也能在其他JSP/Servlet容器中运行；如果你要改用MySQL之外的其他数据库，只要提供一个适当的驱动程序，然后修改数据库连接字符串就可以了。

　　一、用户界面

　　图1就是本文SQL网关的用户界面。在这个界面中，SQL网关已经执行了一条SQL命令并返回了结果。

图1：SQL网关的用户界面

　　从图1可以看出，页面底部的一条信息显示出最近执行的SQL命令影响的行数。如果SQL命令是一个SELECT语句，当SELECT语句执行成功，页面底部将用HTML表格显示出查询结果，如图二所示。

图2：HTML表格显示出查询结果集

　　当然，如果SQL命令执行失败，SQL网关将返回异常信息。

　　二、设计JSP页面

　　在JSP页面中，我们首先放入一个Scriptlet，它的功能是从session对象提取两个属性：

<!doctype html public "-//W3C//DTD HTML 4.0 Transitional//EN">
<% 
   String sqlStatement=(String)session.getAttribute("sqlStatement");
   if (sqlStatement == null)    sqlStatement = "";
   String message =  (String) session.getAttribute("message");
   if (message == null)  message = "";
%>

　　第一个属性sqlStatement 表示SQL命令字符串，第二个属性message 是包含结果信息的字符串。如果这两个属性的值是null，则表示它们尚未被设置，我们把sqlStatement和message变量设置成空字符串。

　　JSP页面还有一个HTML表单，HTML表单包含一个文本区域（TEXTAREA）和一个“执行”按钮。

<form action="../servlet/test.SQLGatewayServlet" method="post">
<b>SQL命令:</b><br>
<textarea name="sqlStatement" cols=60 rows=8>
<%=sqlStatement%></textarea><br>
<br>
<input type="submit" value="执行">
</form>

　　表单中的文本区域用来输入SQL命令。我们将sqlStatement变量的值作为文本区域的默认内容，文本区域的大小是宽60字符、高8行。当JSP页面第一次运行时，这个文本区域的内容为空。如果用户点击文本区域下面的“执行”按钮，JSP页面把表单内容提交给SQLGatewayServlet（稍后再详细介绍）。

　　JSP页面底部的表格显示出message字符串的内容。如前所述，message的内容是运行SQL命令的结果。

<b>SQL命令执行结果:</b><br>
<table cellpadding="5" border="1">
<%=message%>
</table>

　　三、编写Servlet

　　SQLGatewayServlet首先导入java.sql包以便使用JDBC类。另外，它还要声明一个Connection对象，以便Servlet之内的所有方法都可以使用数据库连接。

package test;

import java.io.*;
import javax.servlet.*;
import javax.servlet.http.*;
import java.sql.*;

public class SQLGatewayServlet extends HttpServlet{

    private Connection connection;

　　当Servlet引擎开始运行这个Servlet，Servlet的init方法就打开一个数据库连接：

public void init() throws ServletException{
    try{
        Class.forName("org.gjt.mm.mysql.Driver");
        String dbURL = "jdbc:mysql://localhost/murach";
        String username = "root";
        String passWord = "";
        connection = DriverManager.getConnection
	(dbURL, username, password);
    }
    catch(ClassNotFoundException e){
        System.out.println("找不到数据库驱动程序.");
    }
    catch(SQLException e){
        System.out.println("不能打开数据库连接: "
                           + e.getMessage());
    }
}

　　在这个例子中，Servlet利用一个MysQL数据库的驱动程序打开murach数据库的连接，数据库和Servlet运行在同一个服务器上。此外，Servlet使用MySQL的默认用户名字root，密码为空。不过，你可以修改这里的代码，只要有适当的驱动程序，就可以让Servlet连接到任何服务器上的任何数据库（有关MySQL数据库的更多信息，请参见www.mysql.com）。

　　Servlet引擎关闭Servlet之前，调用destroy方法关闭数据库连接，释放连接资源：

public void destroy() {
    try{
        connection.close();
    }
    catch(SQLException e){
        System.out.println("不能关闭数据库连接: " + e.getMessage());
    }
}

　　前面介绍的JSP页面要调用Servlet的doPost方法，doPost方法调用doGet方法：

public void doPost(HttpServletRequest request,
                   HttpServletResponse response)
                   throws IOException, ServletException{
     doGet(request, response);
 }

　　在doGet方法之中，第一个语句首先获取用户在JSP页面中输入的SQL命令，第二个语句声明message变量：

public void doGet(HttpServletRequest request,
                   HttpServletResponse response)
                   throws IOException, ServletException{

     String sqlStatement = request.getParameter("sqlStatement");
     String message = "";

　　然后，在try块之内，第一个语句利用Connection对象创建Statement对象，接下来的两个语句利用String对象的trim方法和substring方法返回用户输入的SQL命令的前六个字符。

try{
     Statement statement = connection.createStatement();
     sqlStatement = sqlStatement.trim();
     String sqlType = sqlStatement.substring(0, 6);

　　如果SQL命令的前六个字符是“select”，则利用Statement的executeQuery方法执行SQL语句，获得一个ResultSet对象，把这个对象传递给SQLUtil类（稍后详细说明）的getHtmlRows方法，getHtmlRows方法将把记录集中的记录格式化成HTML表格并返回。

if  (sqlType.equalsIgnoreCase("select")){
     ResultSet resultSet = statement.executeQuery(sqlStatement);
     // 构造一个String，其中包含HTML表格形式的结果集数据
     message = SQLUtil.getHtmlRows(resultSet);
 }

　　如果SQL语句的前六个字符不是“select”，则我们调用Statement对象的executeUpdate方法，executeUpdate方法返回当前操作影响的行数——如果这个数字是0，则该SQL命令是一个DDL命令，例如DROP TABLE或CREATE TABLE等；否则，则表明SQL命令可能是DML命令，如INSERT、UPDATE或DELETE命令。无论是哪一种SQL命令，我们都把message变量设置成相应的消息。

else
     {
         int i = statement.executeUpdate(sqlStatement);
         if (i == 0) // 这是一个DDL命令
           message =
             "<tr><td>" +
               "命令执行成功." +
             "</td></tr>";
         else // 这是一个INSERT、UPDATE或DELETE命令
             message =
               "<tr><td>" +
                 "SQL命令执行成功。<br>" +
                 "已更改" + i + " 行。" +
                "</td></tr>";
     }
     statement.close();
 }

　　如果try块里面的任何一个语句抛出一个SQLException，catch块就设置message变量，使其包含有关该SQLException的信息。例如，如果在表单中输入的SQL命令语法错误，下面设置的message变量值将帮助你排解错误。

catch(SQLException e){
    message = "<tr><td>执行SQL命令时遇到错误：<br>"
            + e.getMessage() + "</tr></td>";
}

　　在catch块之后，接下来的三个语句获得session对象，把sqlStatement和message变量设置为session的属性：

HttpSession session = request.getSession();
 session.setAttribute("message", message);
 session.setAttribute("sqlStatement", sqlStatement);

　　接下来，最后两个语句创建一个RequestDispatcher，并转发request和response对象给前文介绍的JSP页面：

RequestDispatcher dispatcher =
     getServletContext().getRequestDispatcher(
         "/sql/sql_gateway.jsp");
 dispatcher.forward(request, response);

　　四、编写工具类

　　下面来看看工具类SQLUtil的代码：

package test;
import java.sql.*;
public class SQLUtil{

　　SQLUtil类包含一个getHtmlRows静态方法，前面的Servlet正是通过调用该方法将结果集格式化成HTML表格。getHtmlRows的输入参数是一个ResultSet对象，其返回值是一个String对象，这个String对象的内容是记录集的所有列表题和行的HTML代码。为了构造出这样一个String对象，getHtmlRows声明了一个名为htmlRows的StringBuffer对象，然后在方法执行过程中向这个StringBuffer对象追加数据。在getHtmlRows方法的末尾，我们用toString方法将StringBuffer的内容转换成String，最后将这个String返回给Servlet：

public static synchronized String getHtmlRows(ResultSet results)
throws SQLException{
    StringBuffer htmlRows = new StringBuffer();
    ResultSetMetaData metaData = results.getMetaData();
    int columnCount = metaData.getColumnCount();
    // 将记录集中列的名称作为HTML表格列的标题
    htmlRows.append("<tr>");
    for (int i = 1; i <= columnCount; i++)
        htmlRows.append("<td><b>" + metaData.getColumnName(i) + "</td>");
    htmlRows.append("</tr>");
    // 对于结果集中的每一行...
    while (results.next()){
        htmlRows.append("<tr>");
        // 将该行中的每一个列转换成一个表格单元
        for (int i = 1; i <= columnCount; i++)
            htmlRows.append("<td>" + results.getString(i) + "</td>");
    }
    htmlRows.append("</tr>");
    return htmlRows.toString();
}

　　为了获得记录集对象的列标题，getHtmlRows方法利用ResultSet的getMetaData方法来创建一个ResultSetMetaData对象，ResultSetMetaData对象包含了有关记录集的描述信息，例如列的数量、列的名称可以分别调用ResultSetMetaData的getColumnCount和getColumnName方法获得。

　　为了提取记录集的数据，getHtmlRows方法利用一个嵌套的循环，即while循环里面嵌套的for循环，来提取每一个行里面每一个列的值。在循环之内，我们用记录集的getString方法来获取各个字段的值，不管字段值原来的类型是什么，getString方法都会将它转换成String。

　　请注意这个方法的声明中带有synchronized关键词，这是为了避免两个或两个以上的Servlet线程同时执行该方法。

　　下载本文的代码：SqlGateway_code.zip。