笙亿网络策划

RESTful API 环境怎么搭建？

约 7 分钟读完 0 阅
文章导读
Previous Quiz Next 本教程将指导您如何准备开发环境，以使用 Jersey Framework 开始创建 RESTful Web Services 的工作。Jersey framework 实现了 JAX-RS 2.0 API，这是一个创建 RESTful
📋 目录
  1. 壹 设置 Java Development Kit (JDK)
  2. 贰 设置 Eclipse IDE
  3. 叁 设置 Jersey Framework 库
  4. 肆 设置 Apache Tomcat
A A

RESTful Web Services - 环境设置

Previous
Quiz
Next

本教程将指导您如何准备开发环境，以使用 Jersey Framework 开始创建 RESTful Web Services 的工作。Jersey framework 实现了 JAX-RS 2.0 API，这是一个创建 RESTful Web Services 的标准规范。本教程还将教您在设置 Jersey Framework 之前，在您的机器上设置 JDK、Tomcat 和 Eclipse。

设置 Java Development Kit (JDK)

您可以从 Oracle 的 Java 网站 − Java SE Downloads 下载最新版本的 SDK。下载的文件中包含安装 JDK 的说明。请按照给定的说明进行安装和配置。最后设置 PATH 和 JAVA_HOME 环境变量，指向包含 Java 和 Javac 的目录，通常是 java_install_dir/bin 和 java_install_dir。

如果您在 Windows 上运行并将 JDK 安装在 C:\jdk1.7.0_75，则需要在 C:\autoexec.bat 文件中添加以下行。

set PATH = C:\jdk1.7.0_75\bin;%PATH% 
set JAVA_HOME = C:\jdk1.7.0_75

或者，在 Windows NT/2000/XP 上，您也可以右键单击“我的电脑”→ 选择“属性”→ 然后“高级”→ 然后“环境变量”。然后，更新 PATH 值并按 OK 按钮。

在 Unix (Solaris、Linux 等) 上，如果 SDK 安装在 /usr/local/jdk1.7.0_75 并使用 C Shell，则将以下内容放入您的 .cshrc 文件中。

setenv PATH /usr/local/jdk1.7.0_75/bin:$PATH 
setenv JAVA_HOME /usr/local/jdk1.7.0_75

或者，如果您使用像 Borland JBuilder、Eclipse、IntelliJ IDEA 或 Sun ONE Studio 这样的集成开发环境 (IDE)，请编译并运行一个简单程序以确认 IDE 知道您安装 Java 的位置，否则按照 IDE 的文档进行适当设置。

设置 Eclipse IDE

本教程中的所有示例均使用 Eclipse IDE 编写。因此，我建议您在机器上安装最新版本的 Eclipse。

要安装 Eclipse IDE，请从 https://www.eclipse.org/downloads/ 下载最新的 Eclipse 二进制文件。下载安装文件后，将二进制分发包解压到一个方便的位置。例如，在 Windows 上为 C:\eclipse，或在 Linux/Unix 上为 /usr/local/eclipse，并最终适当设置 PATH 变量。

在 Windows 机器上可以通过执行以下命令启动 Eclipse，或者只需双击 eclipse.exe。

%C:\eclipse\eclipse.exe

在 Unix (Solaris、Linux 等) 机器上可以通过执行以下命令启动 Eclipse −

$/usr/local/eclipse/eclipse

成功启动后，如果一切正常，您的屏幕应显示以下结果 −

Eclipse Home Page

设置 Jersey Framework 库

现在，如果一切正常，您可以继续设置 Jersey framework。以下是下载并在您的机器上安装 framework 的几个简单步骤。

  • 选择您要在 Windows 或 Unix 上安装 Jersey，然后进行下一步，下载 Windows 的 .zip 文件和 Unix 的 .tz 文件。

  • 从以下链接下载最新版本的 Jersey framework 二进制文件 https://eclipse-ee4j.github.io/jersey/。

  • 在编写本教程时，我在 Windows 机器上下载了 jaxrs-ri-2.17.zip，解压下载的文件后，会在 E:\jaxrs-ri-2.17\jaxrs-ri 内得到如以下截图所示的目录结构。

Jaxrs Directory

您将在目录 C:\jaxrs-ri-2.17\jaxrs-ri\lib 中找到所有 Jersey 库，以及在 C:\jaxrs-ri-2.17\jaxrs-ri\ext 中的依赖项。请确保正确设置此目录的 CLASSPATH 变量，否则在运行应用程序时会遇到问题。如果您使用 Eclipse，则无需设置 CLASSPATH，因为所有设置都将通过 Eclipse 完成。

设置 Apache Tomcat

您可以从 https://tomcat.apache.org/ 下载最新版本的 Tomcat。下载安装包后，将二进制分发包解压到一个方便的位置。例如，在 Windows 上为 C:\apache-tomcat-7.0.59，在 Linux/Unix 上为 /usr/local/apache-tomcat-7.0.59，并设置指向安装位置的 CATALINA_HOME 环境变量。

在 Windows 机器上，可以通过执行以下命令启动 Tomcat，或者直接双击 startup.bat。

%CATALINA_HOME%\bin\startup.bat

或者

C:\apache-tomcat-7.0.59\bin\startup.bat

在 Unix（Solaris、Linux 等）机器上，可以通过执行以下命令启动 Tomcat −

$CATALINA_HOME/bin/startup.sh

或者

/usr/local/apache-tomcat-7.0.59/bin/startup.sh

成功启动后，通过访问 http://localhost:8080/ 可以访问 Tomcat 自带的默认 web 应用程序。如果一切正常，将显示以下结果 −

Tomcat

有关配置和运行 Tomcat 的更多信息，请参阅此页面包含的文档。这些信息也可以在 Tomcat 网站上找到 − https://tomcat.apache.org。

在 Windows 机器上，可以通过执行以下命令停止 Tomcat −

%CATALINA_HOME%\bin\shutdown

或者

C:\apache-tomcat-7.0.59\bin\shutdown

在 Unix（Solaris、Linux 等）机器上，可以通过执行以下命令停止 Tomcat −

$CATALINA_HOME/bin/shutdown.sh

或者

/usr/local/apache-tomcat-7.0.59/bin/shutdown.sh

完成最后这一步后，您就可以继续进行第一个 Jersey 示例了，该示例将在下一章中介绍。