اوراکل ای پکس چیست؟
info@apexrad.info

 

learn-oracleapex-webservices

آموزش وب سرویس در Oracle APEX اوراکل اپکس(ای‌پکس)

خیلی از دوستان آموزش وب سرویس در Oracle APEX اوراکل اپکس(ای‌پکس) را درخواست کرده بودند و سعی کردم مجموعه ای رو آماده کنم که به شما در این زمینه کمک کند.

پیش نیاز های آموزش وب سرویس در Oracle APEX اوراکل اپکس(ای‌پکس)

  • یک لپ تاپ و یا کامپیوتر با مرورگر گوگل کروم یا فایرفاکس یا مرورگر مایکروسافت
  • دسترسی به اینترنت با سرعت مناسب و اینکه شاید برای مشاهده یکسری از مطالب نیاز به VPN داشته باشید.
  • خبر خوب این هست که شما نیاز به نصب وراه اندازی هیچ دیتابیس یا ابزاری ندارید. همه به‌صورت صفحات وب از طریق مرورگر در اختیار شما می باشد.
  • دوره آموزش Oracle APEX اوراکل اپکس(ای‌پکس). شما بصورت رایگان و قدم به قدم می توانید از طریق این لینک این آموزش را بگذرانید. دوستانی که دانش Oracle APEX اوراکل اپکس(ای‌پکس) دارند، می توانند این قسمت رو نادیده بگیرند.

شروع آموزش وب سرویس در Oracle APEX اوراکل اپکس(ای‌پکس)

مرحله اول ایجاد یوزر و محیط کاری رایگان در سایت اوراکل می باشد: apex.oracle.com
دوستانی که این فضای کاری را دارند، می توانند این قسمت رو نادیده بگیرند.

ثبت نام در apex.oracle.com صرفاً ارائه جزئیات در مورد فضای کاری است که می خواهید ایجاد کنید و سپس منتظر ایمیل تأیید باشید.

  • در قسمت Free APEX Workspace، روی ثبت نام رایگان کلیک کنید.

  • در صفحه درخواست فضای کاری، جزئیات شناسایی خود را وارد کنید – نام، نام خانوادگی، ایمیل، فضای کاری.
توجه: برای فضای کاری، یک نام منحصر به فرد، مانند نام اول و نام خانوادگی وارد کنید.
  • روی درخواست فضای کاری کلیک کنید.

  • مراحل باقی مانده ویزارد را کامل کنید.
  • ایمیلتان را چک کنید. شما باید در عرض چند دقیقه یک ایمیل از Oracle APEX دریافت کنید.

توجه: اگر ایمیلی دریافت نکردید، به مرحله 3 برگردید و مطمئن شوید که ایمیل خود را به درستی وارد کرده اید.

  • در متن ایمیل، روی Create Workspace کلیک کنید.
  • برای ورود به صفحه روی «ادامه» کلیک کنید.

  • گذرواژه خود را وارد کنید و روی Change Password کلیک کنید.

  • اکنون باید در Oracle APEX Builder باشید.

چگونه نسخه انتشار ORDS خود را پیدا کنم؟

برای تعیین اینکه در حال حاضر کدام نسخه از ORDS را اجرا می کنید، یکی از موارد زیر را انجام دهید:
شماره انتشار را در صفحه SQL Command مشاهده کنید:
  • به Oracle APEX وارد شوید.
–1
select owa_util.get_cgi_env(‘APEX_LISTENER_VERSION’) from dual;
–2
select ords.installed_version from dual

  • مشاهده صفحه درباره APEX:
  1. به Oracle APEX وارد شوید. صفحه اصلی Workspace ظاهر میشود.
  2. روی منوی Help در بالای صفحه کلیک کرده و About را انتخاب کنید. صفحه درباره APEX ظاهر می شود.

خوب حالا شما یک فضای کاری برای تمرین و ایجاد وب سرویس با Oracle APEX را دارید. در مر حله بعدی آموزش قدم به قدم بهمراه نکته ها و ترفندها شروع می شود و شما باید بعد از هر آموزش موضو ع های دوره را در فضای کاری تمرین کنید.
در ابتدا لطفا فایل های مورد نیاز برای مثال ها (APEX_WEB_SERVICES_Samples) را از این قسمت دانلود کنید.

توجه: آموزش در خصوص نسخه های قدیمی می باشد. ولی شما نگران نباشید ساختار کلی در همه نسخه ها مشابه می باشد و فقط یکسری امکانات جدید اضافه یا اینکه بعضی از آنها تغییر یا بهبود پیدا می کند. شما پس از مشاهده همه موارد گفته شده، می توانید مطالب بسیار زیادی در خصوص وب سرویس حتی در نسخه های جدید اوراکل اي پکس(اپکس) نیز بدست بیاورید.

اهداف دوره

  • وب سرويس چيست؟ Web Services
  • What is ORDS
  • Security
  • سبك معاري REST بر روي وب
  • خصوصيات Oracle REST Data Services
  • نتايج خدمات JSON با داده هاي رابطه اي
  • دسترسي Restful براي بدست آوردن جواب با فرمت JSON
  • ارتباط HTTP(s) با جداول رابطه اي در ديتابيس اوراكل
  •  روش فراخوانی وب سرویس Call REST با زبان هاي مختلف
  • HTTP Methods
  • ايجاد Web Services
  • تست Web Services
  • ايجاد وب سرويس REST با Method POST در Oracle APEX
  • معرفي دو روش CSV Parse كردن اطلاعات دريافتي REST – Method POST
  • Parse JSON
  • فراخوانی Web Service REST در Oracle APEX
  • فراخوانی Web Service SOAP در Oracle APEX
  • ايجاد Form & Report بر روي Web Service
  • فراخوانی Web Service در Database
  • استفاده از وب سرویس REST به جای DBLINK برای انتقال اطلاعات بین چند دیتابیس

موارد آموزش

شما می توانید برای مشاهده هر قسمت آموزش بر روی آن کلیک کرده و در صفحه دیگر مشاهده نمایید. در ضمن شما می توانید فایلهای مورد نیاز برای مثال ها را از این لینک دانلود کنید.
APEX_WEB_SERVICES_PART1
APEX_WEB_SERVICES_PART2
APEX_WEB_SERVICES_PART3

امکانات جدید در خصوص وب سرویس ها در Oracle APEX اوراکل اپکس(ای‌پکس)

Oracle APEX از انواع منابع داده داخلی REST زیر پشتیبانی می کند:
  • HTTP ساده – این گزینه را برای فید داده HTTP ساده انتخاب کنید. Oracle APEX فرض می‌کند که تمام داده‌ها با اولین درخواست بازگردانده می‌شوند و سرور از فیلتر کردن سمت سرور، سفارش‌دهی یا دیگر ویژگی‌های سرویس پیشرفته REST پشتیبانی نمی‌کند. تمام جزئیات فراخوانی و پارامترها باید به صورت دستی پیکربندی شوند.
  • Oracle REST Data Services – نشان دهنده Oracle REST Data Services (ORDS) است. این سرویس های REST از استاندارد Oracle REST پیروی می کنند، به این معنی که عملیات GET، POST، PUT یا DELETE استاندارد شده است. فیلتر سمت سرور و سفارش پشتیبانی می شود. Oracle APEX می تواند با تفویض اختیارات و فیلترهای گزارش به سرویس REST از این ویژگی ها استفاده کند.
  • REST Enabled SQL Query – نشان دهنده یک منبع REST در بالای یک پرس و جوی SQL است که روی مرجع SQL با قابلیت REST اجرا شده است. Oracle APEX از فیلتر و صفحه بندی پشتیبانی می کند، اما DML در این نقاط پایانی وجود ندارد.
مزایای نوع REST Enabled SQL Query عبارتند از:
  • یک منبع REST برای یک پرس و جو اختصاصی SQL به همه اجزای برنامه APEX ارائه می دهد.
  • کامپوننت ها می توانند به سادگی از منبع REST استفاده کنند و نیازی به تکرار پرس و جو از راه دور SQL ندارند.
  • REST Source Synchronization به شما امکان می دهد داده ها را از یک منبع SQL فعال شده REST در یک جدول محلی بارگیری کنید.
  • Oracle Cloud Applications (SaaS) REST Service – به خدمات وب RESTful ارائه شده توسط Oracle Cloud SaaS Applications اشاره می کند. از این نوع وب سرویس برای ادغام Oracle SaaS REST Services در برنامه Oracle APEX خود استفاده کنید. صفحه بندی Oracle APEX برای این خدمات.
  • Oracle Cloud Infrastructure (OCI) REST Service – به خدمات وب RESTful ارائه شده توسط Oracle Cloud Infrastructure اشاره می کند. از این نوع وب سرویس برای ادغام خدمات OCI REST (به عنوان مثال، دسترسی به Object Store) در برنامه Oracle APEX خود استفاده کنید. Oracle APEX از صفحه بندی برای این سرویس ها پشتیبانی می کند.
In Workspace Utilities

a) Rest Enable SQL Query

b) REST Source Catalogs : Manage catalogs of REST Sources for integration into applications
c) Remote Servers : Manage catalogs of REST Sources for integration into applications
d) Web Credentials : Manage catalogs of REST Sources for integration into applications
In Application / Shared Components
REST Data Sources : A REST Data Source can contain one or many Operations which are the references to a concrete external web service.

برای اینکه موارد ذکر شده در قسمت بالا برای شما کاملا واضح گردد، می توانید مثال زیر را قدم به قدم انجام دهید.(ایجاد یک اپلیکیشن فهرست تماشای فیلم ها با استفاده از منابع داده REST)
  1. ایجاد یک یوزر در سایت themoviedb.org برای استفاده از API و فراخوانی آن. میتوانید فایل (tmdb_catalog.sql) TMDB REST Source Catalog را در بین فایل های مثال پیدا کنید و شما باید فایلهای مورد نیاز برای مثال ها را از این لینک دانلود کنید.
a) Register

b) Create API

c) Get API KEY
d) Build a Movies Watchlist Application – Create REST Data Sources
e) Build a Movies Watchlist Application – Create the Movie Search Page
شما می توانید نتیجه اپلیکیشن ایجاد شده رو از طریق این لینک مشاهده نمایید.

چگونه با ORDS API بتوانیم client_id، client_secret ایجاد کنیم؟

۱- ایجاد client_id، client_secret
BEGIN
OAUTH.create_client(
p_name => ‘test_apexrad’,
p_grant_type => ‘client_credentials’,
p_owner => ‘APEXRAD’,
p_description => ‘A client for apexrad’,
p_support_email => ‘info@apexrad.info’,
p_privilege_names => ‘test_priv’
);
COMMIT;
END;
/
۲- نمایش client_id، client_secret
SELECT id, name, client_id, client_secret
FROM user_ords_clients;
۳- حذف client_id، client_secret
BEGIN
OAUTH.delete_client(‘test_apexrad’);
COMMIT;
END;
/
در ادامه برای شما یکسری لینک های مفیدی قرار می دهم که می توانید برای ادامه یادگیری بیشتر به آنها مراجعه کنید:
برای مشاهده نکته ها و ترفند ها و همچنین اخبارهای جدید و مهم در خصوص Oracle APEX می توانید کانال تلگرام را دنبال کنید.
امیدوار هستم که مورد توجه دوستان قرار گرفته باشد. لطفا نظرات خود را در خصوص مطالب بیان کنید.

 

5/5 - (1 امتیاز)

دیدگاهتان را بنویسید

نشانی ایمیل شما منتشر نخواهد شد. بخش‌های موردنیاز علامت‌گذاری شده‌اند *

این قسمت نباید خالی باشد
این قسمت نباید خالی باشد
لطفاً یک نشانی ایمیل معتبر بنویسید.

keyboard_arrow_up
Oracle APEX Capabilities (OAC)