بخش های اصلی

وب سرویس RESTful

وب سرویس های RESTful – تنظیمات محیط

در این بخش، نحوه ی آماده سازی محیط طراحی را برای شروع کار با فریم ورکِ Jersy، جهت ایجاد و ب سرویس های RESTful، به شما یاد میدیم. فریم ورکِ Jersy، JAX-RS 2.0 API را که مشخصات استانداردی برای ایجاد وب سرویس های RESTful است، پیاده سازی می کنه. در این بخش، قبل از تنظیم فریم ورکِ Jerst، نحوه ی تنظیمِ JDK، Tomcat و Eclipse، روی ماشینتان، آموزش داده میشه:

مرحله ی 1 – تنظیم Java Development Kit (JDK)

می توانید آخرین ورژنِ SDK را از سایت Oracel’s Java، دانلود کنین: Java SE Downloads. در فایل های دانلودشده، با دستورالعمل هایی برای نصب JDK مواجه خواهید شد، برای نصب و پیکربندی تنظیمات از دستورالعمل ها پیروی کنین. در پایان، برای اشاره به پوشه ای که حاوی java و javadoc (معمولاً : java_install_dir / bin and java_install_dir) است، متغیرهای محیطیِ PATH و JAVA_HOME را تنظیم کنین.

اگه سیستم عامل تان ویندوزِه و JDK را در C:jdk1.7.0_75 نصب می کنین، باید خطِ زیر را در فایلِ C:autoexec.bat قرار بدین.

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

در ویندوزهای NT/2000/XP، می توانید روی MY Computer، کلیک راست کرده، Propertise را انتخاب کنین و بعد متغیرهای محیطی (Environment Variables) را انتخاب کنین. سپس، مقدارِ PATH را بروز رسانی کنین و روی دکمه ی OK کلیک کنین.

در یونیکس (Solarise، لینوکس و ...)، اگه 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، می داند جاوا را کجا نصب کرده اید، اجرا کنین، در غیر این صورت بر اساس راهنمای ارائه شده در IDE، تنظیمات مناسبی انجام بدین.

مرحله ی 2 – تنظیم Eclipse IDE

تمام مثال های این آموزش با استفاده از Eclipse IDE، نوشته شده ان. بنابراین توصیه می کنم، آخرین ورژنِ Eclipse را روی سیستم تان نصب کنین.

برای نصب Eclipse IDE، آخرین Eclipse binaries را از http://www.eclipse.org/downloads/، دانلود کنین. وقتی دانلود ، تمام شد، فایل را در مکانی مناسب، از حالت فشرده خارج کنین. برای مثال در ویندوز در C:eclipse یا در لینوکس یا یونیکس در /usr/local/eclipse و در پایان، متغیر PATH را بدرستی مقداردهی کنین.

در سیستم عامل ویندوز، Eclipse، با اجرای دستورات زیر یا به سادگی با دابِل کلیک روی eclipse.exe، اجرا میشه.

%C:eclipseeclipse.exe

در سیستم عامل یونیکس (Solarise، لینوکس و ...)، Eclipse، با اجرای دستورات زیر، اجرا میشه.

$/usr/local/eclipse/eclipse

بعد از راه اندازی موفقیت آمیز، اگه همه چیز به درستی انجام شده باشه، باید نتیجه ی کارتان بصورت زیر باشه:

eclipse home page

مرحله ی 4 – تنظیم کتابخانه های فریم ورکِ Jersey

اکنون، اگه تمام کارهای گفته شده را بدرستی انجام داده این، می توانید، تنظیم فریم ورکِ Jersey را شروع کنین. برای دانلود و نصب فریم ورک روی سیستم تان، از مراحل ساده ی زیر پیروی کنین.

  • تصمیم بگیرین که می خواین Jersey را روی ویندوز نصب کنین یا روی لینوکس، سپس به مرحله ی بعدی برین تا فایلِ .ZIP را برای ویندوز و فایلِ .tz را برای یونیکس، دانلود کنین.
  • آخرین ورژن فرم ورکِ Jersey را از https://jersey.java.net/download.html، دانلود کنین.
  • در زمان نوشتن این آموزش، من نسخه ی jaxrs-ri-2.17.zip را برای ویندوز دانلود کرده ام. وقتی فایل ها را از حالت فشرده خارج کنین، ساختارِ دایرکتوری مانندی بصورت زیر در مسیر E:jaxrs-ri-2.17jaxrs-ri، خواهید دید.

jaxrs directories

تمام فایل های کتاب خانه ی Jersey را در دایرکتوری های C:jaxrs-ri-2.17jaxrs-rilib و تمام متعلقات را در دایرکتوری های C:jaxrs-ri-2.17jaxrs-riext، خواهید یافت. مطمئن شوید متغیرِ CLASSPATH را به درستی روی این دایرکتوری تنظیم کرده باشین، در غیر این صورت هنگام اجرای برنامه با مشکل مواجه میشین. اگه از Eclipse استفاده می کنین، لازم نیست متغیرِ CLASSPATH را تنظیم کنین، چون تمام تنظیمات از طریقِ Eclipse، انجام خواهند شد.

مرحله ی 5: تنظیمِ Apache Tomcat:

می توانید آخرین ورژنِ Tomcat را از http://tomcat.apache.org/، دانلود کنین. وقتی دانلود به پایان رسید، فایل دانلود شده را در مکانی مناسب، از حالت فشرده خارج کنین. برای مثال در ویندوز در مسیرِ C:apache-tomcat-7.0.59 و در لینوکس/یونیکس در مسیرِ /usr/local/apache-tomcat-7.0.59، و سپس متغیرِ CATALINA_HOME را طوری تنظیم کنین که به مکانِ نصب، اشاره کنه.

در سیستم عامل ویندوز، Tomcat ، با اجرای دستورات زیر یا به سادگی با دابِل کلیک روی startup.bat، اجرا میشه.

%CATALINA_HOME%binstartup.bat
 
 or
 
 C:apache-tomcat-7.0.59binstartup.bat

در سیستم عامل یونیکس (Solarise، لینوکس و ...)، Eclipse، با اجرای دستورات زیر، اجرا میشه.

$CATALINA_HOME/bin/startup.sh
 
or
 
/usr/local/apache-tomcat-7.0.59/bin/startup.sh

بعد از راه اندازی موفقیت آمیزِ Tomcat، برنامه های وبِ پیش فرضِ include شده با Tomcat، با بازدید از http://localhost:8080/، در دسترس خواهند بود. اگه تمام کارها را بدرستی انجام داده باشین، باید نتیجه ی کارتان بصورت زیر باشه:

tomcat

برای اطلاعات بیش تر راجع به پیکربندی و اجرایِ Tomcat، به این سندِ راهنما http://tomcat.apache.org، مراجعه کنین.

در ویندوز، Tomcat، با استفاده از دستورات پایین، متوقف میشه:

%CATALINA_HOME%binshutdown

or

C:apache-tomcat-7.0.59binshutdown

در یونیکس (Solarise، لینوکس و ...)، Tomcat، با استفاده از دستورات پایین، متوقف میشه:

$CATALINA_HOME/bin/shutdown.sh

or

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

وقتی آخرین مرحله را به پایان رساندین، آماده هستین تا اولین مثالِ Jersey را که در بخش بعدی آمده، شروع کنین.

در صورتی که سوال و یا نظری دارید، از بخش نظرات با ما در میان بگذارید.

خبـرنــامه

Newsletters

در خبــرنـامه سافت اسکیل عضو شویــد تا جدیدترین هـای سایت را بلافاصله در ایمیل خـود دریافت کنیـد

شما چه نظر و یا سوالی درباره این نوشته دارید؟

مبحث آموزشی

وب سرویس RESTful

RESTful Web Services

پرســیدن سؤال جدید

سؤال های تخصصی خود را از ما بپرسید

تبلیغات

دنبال کردن تلگرام کانال سافت اسکیل

https://telegram.me/softskill_ir

عملیات کاربران

خبـرنــامه

Newsletters

در خبــرنـامه سافت اسکیل عضو شویــد تا جدیدترین هـای سایت را بلافاصله در ایمیل خـود دریافت کنیـد