Учебники

Веб-службы RESTful — настройка среды

Из этого туториала Вы узнаете, как подготовить среду разработки к работе с Jersey Framework для создания веб-служб RESTful. В инфраструктуре Jersey реализован API -интерфейс JAX-RS 2.0 , который является стандартной спецификацией для создания веб-служб RESTful. Этот учебник также научит вас, как настроить JDK, Tomcat и Eclipse на вашем компьютере перед настройкой Jersey Framework.

Настройка Java Development Kit (JDK)

Вы можете скачать последнюю версию SDK с сайта Oracle на Java — Java SE Downloads . Инструкции по установке 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 и нажмете кнопку ОК.

В Unix (Solaris, Linux и т. Д.), Если SDK установлен в /usr/local/jdk1.7.0_75 и вы используете оболочку C, вы должны поместить в файл .cshrc следующее.

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

В качестве альтернативы, если вы используете интегрированную среду разработки (IDE), такую ​​как Borland JBuilder, Eclipse, IntelliJ IDEA или Sun ONE Studio, скомпилируйте и запустите простую программу, чтобы подтвердить, что IDE знает, где вы установили Java, в противном случае выполните правильную настройку в соответствии с данным документом. из IDE.

Настройка Eclipse IDE

Все примеры в этом руководстве были написаны с использованием Eclipse IDE. Итак, я бы посоветовал вам установить последнюю версию Eclipse на ваш компьютер.

Чтобы установить Eclipse IDE, загрузите последние двоичные файлы Eclipse со страницы https://www.eclipse.org/downloads/ . После загрузки установки распакуйте бинарный дистрибутив в удобное место. Например, в C: \ eclipse для Windows или / usr / local / eclipse в Linux / Unix и, наконец, установите переменную PATH соответствующим образом.

Eclipse можно запустить, выполнив следующие команды на компьютере с Windows, или вы можете просто дважды щелкнуть файл eclipse.exe.

%C:\eclipse\eclipse.exe

Eclipse можно запустить, выполнив следующие команды на компьютере Unix (Solaris, Linux и т. Д.):

$/usr/local/eclipse/eclipse 

После успешного запуска, если все в порядке, на вашем экране должен появиться следующий результат —

Eclipse Home Page

Установка библиотек Jersey Framework

Теперь, если все в порядке, вы можете приступить к настройке фреймворка на Джерси. Ниже приведены несколько простых шагов для загрузки и установки фреймворка на ваш компьютер.

  • Выберите, хотите ли вы установить Jersey в Windows или Unix, а затем перейдите к следующему шагу, чтобы загрузить файл .zip для Windows, а затем файл .tz для Unix.

  • Загрузите последнюю версию бинарных файлов платформы Jersey по следующей ссылке — https://jersey.java.net/download.html .

  • На момент написания этого руководства я скачал jaxrs-ri-2.17.zip на свой компьютер с Windows, и когда вы распакуете загруженный файл, он даст вам структуру каталогов внутри E: \ jaxrs-ri-2.17 \ jaxrs-ri, как показано на следующем скриншоте.

Выберите, хотите ли вы установить Jersey в Windows или Unix, а затем перейдите к следующему шагу, чтобы загрузить файл .zip для Windows, а затем файл .tz для Unix.

Загрузите последнюю версию бинарных файлов платформы Jersey по следующей ссылке — https://jersey.java.net/download.html .

На момент написания этого руководства я скачал jaxrs-ri-2.17.zip на свой компьютер с Windows, и когда вы распакуете загруженный файл, он даст вам структуру каталогов внутри E: \ jaxrs-ri-2.17 \ jaxrs-ri, как показано на следующем скриншоте.

Справочник Jaxrs

Вы найдете все библиотеки Джерси в каталогах C: \ jaxrs-ri-2.17 \ jaxrs-ri \ lib и зависимости в C: \ jaxrs-ri-2.17 \ jaxrs-ri \ ext . Убедитесь, что вы правильно установили переменную CLASSPATH в этом каталоге, иначе вы столкнетесь с проблемой при запуске приложения. Если вы используете Eclipse, то не нужно устанавливать CLASSPATH, потому что все настройки будут выполнены через Eclipse.

Настройка Apache Tomcat

Вы можете загрузить последнюю версию Tomcat с https://tomcat.apache.org/ . После загрузки установки распакуйте бинарный дистрибутив в удобное место. Например, в C: \ apache-tomcat-7.0.59 в Windows или /usr/local/apache-tomcat-7.0.59 в Linux / Unix и установите переменную среды CATALINA_HOME, указывающую на места установки.

Tomcat можно запустить, выполнив следующие команды на компьютере с Windows, или вы можете просто дважды щелкнуть на файле startup.bat.

%CATALINA_HOME%\bin\startup.bat

или же

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

Tomcat можно запустить, выполнив следующие команды на компьютере с Unix (Solaris, Linux и т. Д.):

$CATALINA_HOME/bin/startup.sh

или же

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

После успешного запуска веб-приложения по умолчанию, включенные в Tomcat, будут доступны по адресу http: // localhost: 8080 / . Если все хорошо, то должен отобразиться следующий результат —

Кот

Дополнительную информацию о настройке и запуске Tomcat можно найти в документации, представленной на этой странице. Эту информацию также можно найти на веб-сайте Tomcat — https://tomcat.apache.org.

Tomcat можно остановить, выполнив следующие команды на компьютере с Windows —

%CATALINA_HOME%\bin\shutdown 

или же

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

Tomcat можно остановить, выполнив следующие команды на компьютере с Unix (Solaris, Linux и т. Д.):

$CATALINA_HOME/bin/shutdown.sh 

или же

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

Как только вы закончите с этим последним шагом, вы готовы приступить к первому примеру на Джерси, который вы увидите в следующей главе.