使用 NetBeans IDE 5.0 开发 Web 服务客户端快速入门指南

安装软件

开始之前，需要在计算机上安装如下软件：

• NetBeans IDE 5.0（下载）。
• Java Standard Development Kit (JDK^TM) version 1.4.2（下载）或 5.0（下载）

创建客户端

1. 选择 File > New Project (Ctrl-Shift-N)。在 Categories 下选择 Samples，然后选择 General。在 Projects下，选择 Anagram Game。单击 Next，然后单击 Finish。

   在 IDE 中打开 AnagramGame 样例。

2. 右键单击 AnagramGame 项目节点，选择 New > Web Service Client。Web服务客户端向导出现。此向导用于获得客户端所基于的 WSDL 文件并用于生成使客户端能够连接到 Web 服务的文件和代码片段。

3. 3. 在 Web 服务客户端向导中指定要使用的 WSDL 文件。在此例中，使用恢复变位词的 Web 服务。在 WSDL URL 字段中输入如下 URL：

   http://services.aonaware.com/CountCheatService/CountCheatService.asmx

   单击 Retrieve WSDL 下载。如果您位于防火墙后面，可能需要设置代理，否则无法下载 WSDL。在这种情况下，请单击 Proxy Settings 并设置代理主机和端口号。

4. 输入 com.toy.anagrams.cheat 作为包的名称。包名称指定将在其中生成客户端文件的包。

5. 单击 Finish。单击 Upgrade Project。

   在 Projects 窗口的 Web Service References 节点中，您应看到如下内容：

   

   Projects 窗口显示名为“CountCheatService”的 Web 服务使您的应用程序可使用操作“letterSolutions”和“letterSolutionsMin”。在 Files 窗口中，可在项目的 build 文件夹中看到由 Web 服务客户端向导所生成的文件。

测试 Web 服务

1. 在 Projects 窗口的 Web Service References 节点中，双击“letterSolutionsMin”操作。出现 Test Web Service Operation 对话框。

2. 键入“batsartcoin”作为 anagram 参数，键入“11”作为“minLetters”参数。

3. 单击 Submit 按钮。执行此步骤时，将联系 Web 服务并调用操作。

4. 等待获得引用（这不会占用太长的时间），单击对话框底部的 Value，随后看到的结果应与下图类似：

   

注意： 如果您看到的结果与上图相似，说明测试已经成功。Web 服务已启动并运行，且返回了引用。若未返回引用，且您位于防火墙后，请参见故障排除的第二部分以获得帮助。

开发客户端

1. 在 Projects 窗口中展开 Source Packages，然后展开 com.toy.anagrams.ui。双击 Anagrams.java 在 Source Editor 中打开它。

2. 双击 Guess 按钮将文本更改为 Cheat。

3. 右键单击 Cheat 按钮，选择 Events > Action > actionPerformed[guessedWordActionPerformed]。

   Source Editor中将显示 guessedWordActionPerformed 源代码。

4. 在 guessedWordActionPerformed 方法的开头处添加一些空行，右键单击并选择 Web service Client Resources > Call Web Service Operation。

5. 在 Invoke 对话框的 Select Operation 中选择 letterSolutionsMin，单击 OK。

   在方法的顶部可看到调用 Web 服务的代码片段。添加一些代码，将 anagram 从 game 传递到 Web 服务，然后重新排列方法中生成的代码，整个代码的形式如下（红色的代码是新添加到此方法中的）：

    private void guessedWordActionPerformed(java.awt.event.ActionEvent evt) {
   
     String anagram = scrambledWord.getText();
     int no_of_letters = anagram.length();
   
     try {
         com.toy.anagrams.cheat.CountCheatService countCheatService = new com.toy.anagrams.cheat.CountCheatService_Impl();
         com.toy.anagrams.cheat.CountCheatServiceSoap countCheatServiceSoap = countCheatService.getCountCheatServiceSoap();
         String[] s = countCheatServiceSoap.letterSolutionsMin(anagram,no_of_letters).getString();
   
         if (s.length > 0) {
   	 for (int i = 0; i < s.length; i++) {
                 guessedWord.setText(s[i]);
   	 }
            if (WordLibrary.isCorrect(wordIdx, guessedWord.getText())){
               feedbackLabel.setText("Correct! Try a new word!");
               getRootPane().setDefaultButton(nextTrial);
            } else {
               feedbackLabel.setText("Incorrect! Try again!");
               guessedWord.setText("");
            }
         } else {
            feedbackLabel.setText("Sorry... word not recognized!");
         }
   
     } catch(javax.xml.rpc.ServiceException ex) {
          // TODO handle ServiceException
     } catch(java.rmi.RemoteException ex) {
          // TODO handle remote exception
     }      
     guessedWord.requestFocusInWindow();
    }

部署客户端

1. 右键单击 Project 节点，然后选择 Run Project。

2. 项目运行。您将看到带有 Cheat 按钮而不是 Guess 按钮的 Anagram Game。您将看到带有 Cheat 按钮而不是 Guess 按钮的 Anagram Game。

3. 单击 Cheat。变位词被发送给 Web 服务、复原、返回并显示在文本框中，Anagram Game 进行检查：

   

注意： 如果您位于防火墙后，并且未为项目设置代理主机和端口号，Anagram Game 中将不会显示由 Web 服务返回的复原后的变位词，而是不显示任何内容。参见故障排除以获得帮助。

就是这些。我们已经完成了任务。您使用了变位词复原 Web 服务，且并未编写太多的代码。