当前页面: 开发资料首页 → Netbeans 专题 → 使用 NetBeans 开发 eBay SDK for Java

使用 NetBeans 开发 eBay SDK for Java

摘要: 使用 NetBeans 开发 eBay SDK for Java 作者及整理人： Brian Leonard '); //--> Brian Leonard Brian Leonard ，2005 年...

使用 NetBeans 开发 eBay SDK for Java

本教程演示如何启动和运行 eBay SDK for Java。使用 NetBeans 开发 eBay 应用程序，会提高代码完成、Javadoc 帮助、代码编译、执行以及从 NetBeans IDE 内部调试所有代码的效率。

我将使用 SDK 附带的 Console View 示例应用程序，所涉及的步骤同样适用于所有 eBay 示例应用程序或从头开始创建自己的应用程序。eBay SDK 附带的示例应用程序已经具有与其相关的 Ant 脚本，因此，我将使用这个选项来用现有的 Ant 脚本创建 NetBeans 项目。我还尽量少更改现有的 Ant 脚本，因此，我将执行一些设置 JAVA_HOME 环境变量之类的操作，以供脚本查找。最后，在 IDE 的内外您都能够运行这个脚本，这是 NetBeans 的强大功能之一。让我们开始吧。

内容

• 设置环境

• 创建 eBay Console View 应用程序项目

• 构建项目

• 运行应用程序

• 调试应用程序

设置环境

安装 Java 和 NetBeans

eBay SDK for Java 最适合 J2SE 1.4.2。如果您既没有安装 J2SE 1.4.2，也没有安装 NetBeans 4.1，则您可以下载 NetBeans IDE + J2SE SDK 包。

如果您只需要 NetBeans，则下载并安装 NetBeans 4.1。

如果您只需要 J2SE 1.4.2，则下载并安装 J2SE 1.4.2 SDK。

获得并准备使用 eBay SDK for Java

1. 加入 eBay 开发人员计划。为了对照 eBay 沙箱测试应用程序，这是非常必要的。

2. 对于本教程，您需要在沙箱中至少注册一个测试用户。要获得更详细的测试，您需要至少两个测试用户，一个用于出售，一个用于购买。

3. 为测试用户创建单个用户开发人员标记。这个标记用于验证和授权自己使用应用程序访问 eBay 服务器。

4. 下载并安装 eBay SDK for Java。对于这个练习，我们假设它已经被解压缩到根文件夹。

5. 将环境变量 JAVA_HOME 设置为安装 J2SE 1.4.2 的位置。例如，C:\j2sdk1.4.2_07。

6. 如果以前您用 J2SE 5.0 安装 NetBeans，则向 NetBeans 添加 –jdkhome 启动参数。例如，我的快捷目标可以是以下形式： "C:\Program Files\netbeans-4.1\bin\netbeans.exe" --jdkhome C:\j2sdk1.4.2_07.

7. 向 NetBeans 中添加 eBay SDK 类库。这将提供对 Javadoc 和视图源的支持。

   1. 从 Tools 菜单中选择 Library Manager。

   2. 单击 New Library... 按钮。为库提供一个名称，如 eBay。使 Type 为 Class Libraries，然后选择 OK。

   3. 选中 eBay 和 Classpath 选项卡，单击 Add JAR/Folder 按钮，然后选择 <eBay SDK 安装位置>/lib/ 目录中的所有 JAR 文件。它们应该是 attributes.jar、ebaycalls.jar、ebaysdkcore.jar、eps.jar 和 helper.jar。

   4. 切换到 Sources 选项卡，再次单击 Add JAR/Folder 按钮，然后添加以下文件夹：

      • source/apiCalls/src

      • source/attributesLib/src
      • source/core/src
      • source/helper/src
        
   5. 切换到 Javadoc 选项卡，再次单击 Add JAR/Folder 按钮，然后选择 docs/LibRef 文件夹。

返回页首

创建 eBay Console View 应用程序项目

创建一个新项目

1. 选择 File > New Project (Ctrl+Shift-N)。

2. 在 General Category 下选择 Java Project with Existing Ant Script。这将在 NetBeans 中创建所谓的“自由形式项目”。有关该项目类型的详细信息，请参阅 Advanced Free-Form Project Configuration。

3. 对于 Location，浏览到安装 eBay SDK 的 samples/consoleViewItem 文件夹。向导将查找构建脚本并推荐一个项目名称。选择 Next。

4. 构建和运行操作。向导找到 Build、Clean 和 Javadoc 目标。遗憾的是，没有运行目标，因此我们稍后必须创建运行目标。选择 Next。

5. 添加应用程序的源包文件夹，该文件夹是 src。如果您已经正确配置了使用 –jdkhome 参数启动 NetBeans，则 Source Level 将为 JDK 1.4。

6. 单击 Finish。

返回页首

构建项目

构建项目

此时，NetBeans 能够构建应用程序。选择 Build | Build Main Project，按 F11 或右键单击项目节点，然后从上下文菜单中选择 Build Project。您将在 IDE 下半部的 Output 中看到 Ant 脚本的输出。

编辑应用程序

Console View 示例应用程序原本使用不推荐使用的用户名和密码认证机制。需要更新该代码以使用新的 Token 方法。应用程序还要求很多用户输入。我们将用硬编码值替换这些调用，从而使应用程序更容易测试。

1. 展开源文件夹并打开 ApplicationViewItem.java。您首先可能注意到的是左侧空白处的红色标记，表示编译程序错误。如果 Ant 脚本了解所有项目的依赖关系，上述步骤中项目就可以被正确编译。现在我们将让 IDE 了解项目的依赖关系。

2. 向项目的类路径中添加 eBay SDK JAR：

   1. 右键单击 consoleViewItem 项目节点，然后选择 Properties。

   2. 选择 Classpath，然后选择 Add JAR/Folder

   3. 选择 <eBay SDK 安装位置>/lib/ 目录中的所有 JAR 文件。它们应该是 attributes.jar、ebaycalls.jar、ebaysdkcore.jar、eps.jar 和 helper.jar。

   4. 选择 OK。NetBeans 将分析 JAR 文件，您将看到编译程序标记从 ApplicationViewItem.java 中消失。

3. 向视图中添加认证和授权令牌、eBay SOAP 服务器 URL 和条目 ID：

   String token = "<enter your token>";
   String eBaySOAPURL = "https://api.sandbox.ebay.com/wsapi";
   String itemIDStr = "<enter id of item to view>";
   
   

   可以从 http://sandbox.ebay.com 获得条目 ID。写下此文时，我使用的是 4503947968.

4. 使用以下代码替换提示行并设置 devID、appID、certID、userID 和密码：

   cred.seteBayToken(token);
   apiContext.setRouting("New");
   

   当您使用 IDE 的编辑器时，注意为您提供的代码完成 (code completion) 和 Javadoc：

3. 用上面的 String 替换 eBay SOAP 服务器 URL 和条目 ID 输入，并注释掉原始 itemIDStr。整个代码块应该如下所示：

   apiContext.setApiServerUrl(eBaySOAPURL);
   cred.seteBayToken(token);
   apiContext.setRouting("New");
   
   // [2] Ask for itemID.
   System.out.println("===== [2] Call GetItemCall ====");
   //String itemIDStr = ConsoleUtil.readString("Enter ID of the item that you want to get: ");
   

4. 按 F11 可编译项目。

返回页首

运行应用程序

向 build.xml 中添加运行目标

1. 打开 build.xml

2. 滚动到文件的底部，然后添加以下目标：

   <target name="run" description="Run Sample">
       <echo message="Running"/>
       <java classname="consoleviewitem.ApplicationViewItem" fork="yes" failonerror="false" dir="./">
   
           <classpath refid="project.class.path"/>
           <classpath>
               <pathelement location="${dest}"/>
           </classpath>
       </java>
   
   </target>
   

映射目标

打开 Project Properties，然后选择 Build and Run。将 Run Project 设置为我们刚刚添加的新 run 目标。

运行应用程序

右键单击 consoleViewItem 项目，然后选择 Run Project。如果所有项目都正常运行，则在输出窗口中将看到选定的拍卖 ID 的项目信息。以我的经验，eBay 返回的错误都很清楚，因此调试应该不成问题。

注意，如果您在公司代理后面并且获得一个 ConnectException，则您可以向 ApplicationViewItem 的 main 方法顶部添加以下两行代码：

System.setProperty("http.proxyHost", "<your proxy host>");
System.setProperty("http.proxyPort", "<your proxy port>");

返回页首

调试应用程序

使用 NetBeans IDE 创建 eBay 应用程序的另一个优点是 NetBeans 应用程序调试器。随着应用程序的扩大，您可以使用调试器来帮助解决逻辑问题。

向 build.xml 中添加调试目标

1. 打开 build.xml

2. 滚动到文件的底部，然后添加以下目标：

   <target name="debug" depends="compile" description="Debug Project">
       <fail unless="netbeans.home">This target can only run inside the NetBeans IDE.</fail>
       <nbjpdastart name="Sample App" addressproperty="jpda.address" transport="dt_socket">
           <classpath refid="project.class.path"/>
           <sourcepath path="${src}"/>
       </nbjpdastart>
   
       <java fork="true" classname="consoleviewitem.ApplicationViewItem">
           <jvmarg value="-Xdebug"/>
           <jvmarg value="-Xnoagent"/>
           <jvmarg value="-Djava.compiler=none"/>
           <jvmarg value="-Xrunjdwp:transport=dt_socket,address=${jpda.address}"/>
           <classpath refid="project.class.path"/>
   
       </java>
   </target>
   

映射目标

打开 Project Properties，然后选择 Build and Run。将 Debug Project 设置为我们刚刚添加的新调试目标。

设置断点并调试应用程序。

1. 单击 ApplicationViewItem.java 上的左边空白处可设置断点。

2. 右键单击 consoleViewItem 项目节点下的 build.xml，然后运行调试目标。

3. 从此处您可以一步步查看应用程序、查看局部变量、设置监视等等。

返回页首

---

↑返回目录
前一篇: 使用 NetBeans IDE 远程控制 Sony Ericsson 设备
后一篇: 在 NetBeans 中为 TiVo 开发应用程序