?? prov_paramquery.html
字號(hào):
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01//EN">
<html>
<head>
<meta name="Author" content="TF">
<meta name="generator" content="HTML Tidy, see www.w3.org">
<title>數(shù)據(jù)庫應(yīng)用程序開發(fā)者指南: 從一個(gè)數(shù)據(jù)源中獲得數(shù)據(jù)</title>
<link type="text/css" href="jbdocs.css" rel="stylesheet">
</head>
<body>
<br><br>
<a name="_top_"></a>
<h2>使用參數(shù)化查詢從你的數(shù)據(jù)庫中獲得數(shù)據(jù)</h2>
<hr>
譯者名字:cage_yang(JD012)<br>
郵件地址:<a href="mailto:cage_yang@163.com">cage_yang@163.com</a>
<!--BNDX="queries:creating parameterized;providing data:with parameterized queries"-->
<!--BNDX="parameterized queries:;SQL queries:adding parameters;adding parameters to queries"-->
<blockquote class="bsku">數(shù)據(jù)庫應(yīng)用程序開發(fā)是JBuilder專業(yè)版本與企業(yè)版本的一個(gè)特征. 分布式應(yīng)用程序開發(fā)是JBuilder企業(yè)版本的一個(gè)特征.</blockquote>
<p>一個(gè)參數(shù)化的SQL語句包括變量, 也即大家都知道的參數(shù), 其值可以在運(yùn)行期間變化. 一個(gè)參數(shù)化的查詢使用這些變量來更換字面上的數(shù)據(jù)值, 如在SQL語句中出現(xiàn)的在WHERE子句用于比較值. 這些變量叫做<em>參數(shù)(parameters)</em>. 通常, 參數(shù)代表了傳遞給語句的數(shù)據(jù)值. 在執(zhí)行查詢前,你為參數(shù)提供值. 通過提供不同的值并執(zhí)行相應(yīng)的查詢,你可使每個(gè)查詢返回不同的數(shù)據(jù)結(jié)果.</p>
<p>理解數(shù)據(jù)如何提供給一個(gè)<code>DataSet</code> 是進(jìn)一步理解參數(shù)化查詢的實(shí)質(zhì), 如果你還沒有閱讀,可閱讀主題"<a href="dh_javadatabaseapp.html">理解JBuilder數(shù)據(jù)庫應(yīng)用程序</a>" 與 "<a href="prov_query.html">查詢數(shù)據(jù)庫</a>" 該主題主要針對(duì)參數(shù)化查詢.</p>
<p>除 <a href="#tutorial">"指南: 參數(shù)查詢"</a>外, 還討論下面的參數(shù)化查詢:</p>
<ul>
<li><a href="prov_paramquery_disc.html">"使用參數(shù)"</a></li>
<li><a href="prov_paramquery_disc.html">"使用新參數(shù)重新執(zhí)行查詢"</a></li>
<li><a href="prov_paramquery_disc.html">"在主-從關(guān)系中使用參數(shù)化查詢"</a></li>
</ul>
<a name="tutorial"></a>
<h3>指南: 參數(shù)查詢</h3>
<!--BNDX="parameterized queries:tutorial;tutorials:parameterizing queries"-->
<!--BNDX="database tutorials:parameterizing queries;QueryDataSet component:tutorial"-->
<!--BTUTOR="Tutorial: Parameterizing a query"-->
<p>下面的指南說明怎樣用一個(gè)<code>QueryDataSet</code> 組件為一個(gè)應(yīng)用程序提供數(shù)據(jù). 這個(gè)例子程序增加一個(gè)可以在運(yùn)行期間改變的 <code><a href="../ref/dx/com.borland.dx.dataset.ParameterRow.html">ParameterRow</a></code> 值. 當(dāng)<code>ParameterRow</code>的值改變時(shí), 數(shù)據(jù)表會(huì)自動(dòng)刷新它的顯示以反映滿足參數(shù)指定標(biāo)準(zhǔn)的數(shù)據(jù)記錄.</p>
<p><span class="bscan">注意:</span> 我們強(qiáng)烈建議在開始這個(gè)叫<a href="prov_textedittutorial.html">"指南:JBuilder數(shù)據(jù)庫應(yīng)用程序入門"</a>的指南之前,先熟悉使用可視化設(shè)計(jì)工具.</p>
<p>在例子工程中一個(gè)完整的可利用的指南<code>ParameterizedQuery.jpr</code>, 存放位置在<code>/samples/DataExpress/ParameterizedQuery</code> 的JBuilder安裝目錄下. </p>
<a name="createapp"></a>
<h4>創(chuàng)建一個(gè)應(yīng)用程序</h4>
<p>為創(chuàng)建一個(gè)應(yīng)用程序, </p>
<ol>
<li><p>選擇 File|Close All 菜單項(xiàng).</p></li>
<li>
<p>選擇 File|New 并雙擊應(yīng)用程序圖標(biāo)</p>
</li>
<li>接受所有的默認(rèn)的設(shè)置來創(chuàng)建一個(gè)新的應(yīng)用程序.</li>
<li>
<p>選擇 Design 標(biāo)簽來激活用戶界面設(shè)計(jì)器.</p>
</li>
<li>
<p>點(diǎn)擊組件板的DataExpress標(biāo)簽上的 <code>Database</code> 組件,然后在用戶界面設(shè)計(jì)器上點(diǎn)擊任何一個(gè)位置以將組件添加到應(yīng)用程序中.</p>
<p>在檢視器點(diǎn)擊<code>connection</code>屬性值的首略號(hào)來為<code>Database</code>組件打開連接屬性編輯器.</p>
</li>
<li>
<p>將連接屬性設(shè)置為JDataStore 例子 EMPLOYEE 表, 如下:</p>
<table border="2">
<tr>
<th>屬性名稱</th>
<th>屬性值</th>
</tr>
<tr>
<td>Driver</td>
<td>com.borland.datastore.jdbc.DataStoreDriver</td>
</tr>
<tr>
<td>URL</td>
<td>Browse to <code>/jbuilder/samples/JDataStore/datastores/employee.jds</code> in the local URL field.</td>
</tr>
<tr>
<td>Username</td>
<td>Enter your name</td>
</tr>
<tr>
<td>Password</td>
<td>not required</td>
</tr>
</table>
<p>連接對(duì)話框包括一個(gè)測(cè)試連接按鈕. 點(diǎn)擊該按鈕檢察連接屬性設(shè)置的正確性. 連接的結(jié)果在按鈕旁邊顯示. 當(dāng)連接成功時(shí),點(diǎn)擊 OK.</p>
<p>如果你想看生成的代碼, 點(diǎn)擊 Source 標(biāo)簽并查找<code>ConnectionDescriptor</code> 代碼. 點(diǎn)擊 Design 標(biāo)簽繼續(xù).</p>
<p>更多的關(guān)于連接數(shù)據(jù)庫的信息,見 <a href="con_connecting.html">"連接數(shù)據(jù)庫".</a></p>
</li>
</ol>
<a name="parameterrow"></a>
<h4>添加一個(gè)參數(shù)行</h4>
<!--BNDX="ParameterRow"-->
<p>下一步, 增加一個(gè) <code>ParameterRow</code> ,包括兩列: low_no 與 high_no. 你將 <code>ParameterRow</code> 綁定到 <code>QueryDataSet</code>后, 就可以使用<code>JdbTextField</code>
組件來改變 <code>ParameterRow</code> 中的數(shù)據(jù)以便查詢能夠使用這些新值來刷新數(shù)據(jù).</p>
<ol>
<li>從Express標(biāo)簽中增加一個(gè) <code>ParameterRow</code> 組件到你的應(yīng)用程序中去.</li>
<li>在組件樹中點(diǎn)擊<code>parameterRow1</code>左邊的展開圖標(biāo)以顯示<code>ParameterRow</code>包含的列.</li>
<li>選擇 <new column>, 然后在檢視器中為新列設(shè)置如下的屬性:
<table border="2">
<tr>
<th>Property name</th>
<th>Value</th>
</tr>
<tr>
<td>columnName</td>
<td><code>low_no</code></td>
</tr>
<tr>
<td>dataType</td>
<td><code>INT</code></td>
</tr>
<tr>
<td>default</td>
<td><code>15</code></td>
</tr>
</table>
<p>要看在該步驟中由設(shè)計(jì)器產(chǎn)生的代碼, 點(diǎn)擊 Source 標(biāo)簽并注意<code>jbInit()</code> 方法. 點(diǎn)擊 Design 標(biāo)簽繼續(xù)下一步操作.</p>
</li>
<li>再次選擇 <new column> 為<code>ParameterRow</code>增加第二列, 并給它設(shè)置如下屬性:
<table border="2">
<tr>
<th>Property name</th>
<th>Value</th>
</tr>
<tr>
<td>columnName</td>
<td><code>high_no</code></td>
</tr>
<tr>
<td>dataType</td>
<td><code>INT</code></td>
</tr>
<tr>
<td>default</td>
<td><code>50</code></td>
</tr>
</table>
</li>
</ol>
<a name="querydataset"></a>
<h4>增加一個(gè) QueryDataSet組件</h4>
<!--BNDX="QueryDataSet component"-->
<ol>
<li>在該應(yīng)用程序中的Data Express標(biāo)簽中增加一個(gè) <code>QueryDataSet</code> 組件.</li>
<li>點(diǎn)擊<code>query</code>屬性的省略號(hào)按鈕,打開查詢屬性編輯器.</li>
<li>設(shè)置<code>queryDataSet1</code>的 <code>query</code>如下屬性:
<table border="2">
<tr>
<th>Property name</th>
<th>Value</th>
</tr>
<tr>
<td>Database</td>
<td><code>database1</code></td>
</tr>
<tr>
<td>SQL Statement</td>
<td><code>select emp_no, first_name, last_name from employee where emp_no >= :low_no and emp_no <= :high_no</code></td>
</tr>
</table>
</li>
<li>
<p>在查詢屬性編輯器中點(diǎn)擊 Parameters 標(biāo)簽.</p>
</li>
<li>
<p>在下拉列表框中選擇 <code>parameterRow1</code> 將數(shù)據(jù)集綁定至<code>ParameterRow</code>.</p>
</li>
<li>
<p>點(diǎn)擊 Query 標(biāo)簽. 點(diǎn)擊 Test Query 按鈕以確信查詢處于可運(yùn)行狀態(tài). 如果按鈕下方顯示 <code>Success</code>, 說明測(cè)試成功,點(diǎn)擊 OK 按鈕關(guān)閉對(duì)話框.</p>
<p>下面的這些代碼已經(jīng)添加到 <code>jbInit()</code> 方法中:</p>
<pre>
queryDataSet1.setQuery(new com.borland.dx.sql.dataset.QueryDescriptor(database1,
"select emp_no, first_name, last_name from employee where emp_no <= :low_no and emp_no >= :high_no",
parameterRow1, true, Load.ALL));
</pre>
</li>
<li>
<p>從More dbSwing標(biāo)簽中添加一個(gè) <code>DBDisposeMonitor</code> 組件. 當(dāng)窗口被關(guān)閉時(shí)<code>DBDisposeMonitor</code> 會(huì)關(guān)閉 JDataStore .</p>
</li>
<li>
<p>為<code>DBDisposeMonitor</code>設(shè)置 <code>dataAwareComponentContainer</code> 屬性,其屬性設(shè)為 'this'.</p>
</li>
</ol>
<a name="UI"></a>
<h4>添加一個(gè)用戶界面組件</h4>
<p>下面的操作步驟假設(shè)你已經(jīng)熟悉在可視化設(shè)計(jì)器中添加一個(gè)用戶界面. </p>
<p>為了在你的應(yīng)用程序中添加一個(gè)組件用于顯示與管理數(shù)據(jù),</p>
<ol>
<li>在組件面板中dbSwing標(biāo)簽中點(diǎn)擊 <code>TableScrollPane</code> 組件.拖動(dòng)它到用戶界面設(shè)計(jì)器的面板的中心.
<p>確定它的 <code>constraints</code> 屬性已經(jīng)設(shè)置為 CENTER.</p>
</li>
<li>
<p>將dbSwing標(biāo)簽中的一個(gè) <code>JdbTable</code> 組件放至<code>tableScrollPane1</code> 組件的中部. 將它的 <code>dataSet</code> 屬性為 <code>queryDataSet1</code>.</p>
<p>你應(yīng)該注意到用戶界面的表已經(jīng)顯示有數(shù)據(jù).</p>
</li>
<li>選擇 Run|Run Project 運(yùn)行應(yīng)用程序并瀏覽數(shù)據(jù)結(jié)果.</li>
<li>
<p>關(guān)掉應(yīng)用程序.</p>
</li>
</ol>
<p>添加組件,實(shí)現(xiàn)在運(yùn)行期間獲得參數(shù)化查詢變量,</p>
<ol>
<li>在Swing Containers標(biāo)簽中選中 <code>JPanel</code> 組件.</li>
<li>
<p>拖動(dòng)它到組件樹中,直至<code>contentPane(BorderLayout)</code>圖標(biāo)左邊. 該步操作確保存<code>JPanel</code> (<code>jPanel1</code>) 被添加到主用戶界面中, 而不是放到當(dāng)前點(diǎn)據(jù)整個(gè)用戶界面的<code>tableScrollPane1</code> 面板中.</p>
</li>
<li>
<p>確信它的 <code>constraints</code> 屬性已經(jīng)設(shè)置為 <code>NORTH</code>. (如果<code>tableScrollPane1</code> 突然收縮, 檢查它的 <code>constraints</code> 屬性是否仍被設(shè)為 CENTER.)</p>
</li>
<li>
<p>選中 <code>jPanel1</code> 并將它的 <code>preferredSize</code> 屬性設(shè)為<code>200,100</code>. 這將使它足以包含用戶界面的其余部分.</p>
</li>
<li>
<p>從dbSwing標(biāo)簽中選擇一個(gè) <code>JdbTextField</code> 組件放入 <code>jPanel1</code>. 該組件保持最小值.</p>
</li>
<li>
<p>注意到 <code>jdbTextField1</code> 被放到上方面板的中央. 這是因?yàn)?lt;code>JPanel</code>組件的默認(rèn)布局是 <code>FlowLayout</code>. 如果你想把它拖到另外的地方,它卻仍然保持在原位置.</p>
<p>為了在面板中控制用戶界面組件的位置,必須將<code>jPanel1</code> 的<code>layout</code> 屬性設(shè)為 'null'. 然后, 拖動(dòng) <code>jdbTextField1</code> 組件到面板的左邊.</p>
</li>
<li>
<p>為了設(shè)置固定寬度,設(shè)置<code>jdbTextField1</code>的 <code>columns</code> 屬性值為 <code>10</code> . 將 <code>text</code> 屬性設(shè)為 <code>10</code> ,以便和先前輸入的作為默認(rèn)的最小的參數(shù)相匹配.</p>
</li>
<li>
<p>從Swing標(biāo)簽中添加一個(gè) <code>JLabel</code> 組件到 <code>jPanel1</code>中. 該標(biāo)簽將<code>jdbTextField1</code> 標(biāo)識(shí)為一個(gè)最小域.</p>
</li>
<li>
<p>在用戶界面設(shè)計(jì)器中選中 <code>jLabel1</code> 并將它拖動(dòng)到<code>jdbTextField1</code>的正上方.</p>
</li>
<li>
<p>設(shè)置<code>jLabel1</code>的 <code>text</code> 屬性為 <code>Minimum value</code>. 并調(diào)整標(biāo)簽的大小以使標(biāo)簽上的文字全部顯示出來.</p>
</li>
<li>
<p>在<code>jPanel1</code>中添加另外的 <code>JdbTextField</code> 與 <code>JLabel</code>組件. 將這對(duì)組件拖動(dòng)到面板的右面.</p>
</li>
<li>
<p>將<code>jdbTextField2</code>的 <code>columns</code> 屬性設(shè)為 <code>10</code>, 將它的 <code>text</code> 屬性設(shè)為 <code>50</code>.</p>
</li>
<li>
<p>將<code>jLabel2</code>的文本屬性設(shè)為<code>Maximum value</code>, 改變寬度到能夠?qū)⑷课谋撅@示出來.</p>
</li>
<li>
<p>將所有的組件按以下方式對(duì)齊:</p>
<p>按住CTRL鍵不放,點(diǎn)取<code>jLabel1</code>與<code>jdbTextField1</code>. 右擊并選取"Align Left". </p>
<p>左對(duì)齊 <code>jLabel2</code> 與 <code>jdbTextField2</code>. 上對(duì)齊兩個(gè)文本控件與標(biāo)簽控件.</p>
</li>
<li>
<p>從Swing標(biāo)簽中添加一個(gè)<code>JButton</code>組件到<code>jPanel1</code>面板中. 將該按鈕放在兩個(gè)文本輸入域組件之間. 設(shè)置其 <code>text</code> 屬性為<code>Update</code>.</p>
<p>最小與最大輸入域控件的值作為參數(shù)化查詢的參數(shù),點(diǎn)擊更新按鈕以獲得更新結(jié)果.</p>
</li>
<li>
<p>在檢視器中選中Events標(biāo)簽, 選中<code>actionPerformed</code>, 并雙擊在源代碼中產(chǎn)生一個(gè)<code>actionPerformed()</code>事件. 源代碼編輯框顯示出來并將鼠標(biāo)定位在<code>actionPerformed()</code>中的左右括號(hào)之間.</p>
<p>添加代碼如下:</p>
<pre>
void jButton1_actionPerformed(ActionEvent e) {
try {
// change the values in the parameter row
// and refresh the display
parameterRow1.setInt("low_no",
Integer.parseInt(jdbTextField1.getText()));
parameterRow1.setInt("high_no",
Integer.parseInt(jdbTextField2.getText()));
queryDataSet1.refresh();
}
catch (Exception ex) {
ex.printStackTrace();
}
}
}
</pre>
</li>
<li>
<p>保存并運(yùn)行程序. 運(yùn)行后的程序應(yīng)該大致如下所示:</p>
<p><img src="images/paramqueryrun.gif" border="0" alt="Parameterized query tutorial - running application"></p>
<p>為了測(cè)試?yán)映绦? 在最小輸入域中輸入一個(gè)新值, 然后點(diǎn)擊Update按鈕. 表中只顯示大于輸入值的數(shù)據(jù). 在最大值輸入域中輸入一個(gè)新值, 然后按下Update按鈕. 表中只顯示小于剛輸入的值的數(shù)據(jù).</p>
<p>為了將你對(duì)數(shù)據(jù)的修改保存到數(shù)據(jù)源中,你應(yīng)該添加一個(gè)<code>QueryResolver</code>. 怎樣增加一個(gè)帶提交功能按鈕或者增加一個(gè)<code>JdbNavToolbar</code>組件到內(nèi)容面板中,(<code>JdbNavToolbar</code>提供了一個(gè)默認(rèn)的提交功能),詳細(xì)情況見<a href="res_query.html">"從QueryDataSet將數(shù)據(jù)修改保存到數(shù)據(jù)源中"</a>.</p>
</li>
</ol>
</body>
</html>
?? 快捷鍵說明
復(fù)制代碼
Ctrl + C
搜索代碼
Ctrl + F
全屏模式
F11
切換主題
Ctrl + Shift + D
顯示快捷鍵
?
增大字號(hào)
Ctrl + =
減小字號(hào)
Ctrl + -