بلاگ

آخرین خبر ها و آپدیت ها

نحوه ساخت و استفاده از ADF Library

royal vision July 20, 2019

فریم‌ورک ADF به منظور بالا بردن قابلیت استفاده مجدد (Reuseability ) امکاناتی را فراهم کرده است. استفاده مجدد از صفات یک فیلد در viewObject گرفته تا کل یک پروژه قابل گسترش می‌باشد. من در این مقاله سعی دارم تا نحوه استفاده از یک BC Model را به صورت یک library در برنامه‌های ADF نشان دهم تا شما یاد بگیرید که چگونه می‌توانید مدل آماده نمایید و آن‌را در برنامه‌های مختلف مورد استفاده قراردهید. برای نشان دادن این موضوع از مثال لیست دپارتمان‌ها در HR استفاده می‌کنم. برای این مثال دو برنامه کاملا جدا ایجاد می‌نمایم. در یکی از آن‌ها پروژه مدل را ایجاد می‌کنم و دریکی دیگر viewController را ایجاد می‌نمایم. در نهایت پس از آماده کردن مدل، آن را به صورت یک library در‌ آورده و به viewOntroller اضافه می‌نمایم و با استفاده از آن صفحه لیست دپارتمان‌ها را ایجاد می‌نمایم. در این مثال مشاهده خواهید کرد که یک مدل را کاملا جدا ایجاد خواهیم کرد و سپس می‌توانیم آن را در هر برنامه‌ای که نیازمان بود استفاده نماییم.

شرح:
ابتدا یک برنامه با نام GeneralModel ایجاد نمایید. دقت کنید نوع برنامه را برابر Generic Application قرار دهید. همانند تصویر زیر

سپس دکمه Next راکلیک نموده و اسم پروژه را برابر myModel قرار دهید و از قسمت Project Technologies تکنولوژی ADF Business Components را انتخاب و به سمت راست انتقال دهید(همانند تصویر زیر). دقت نمایید که با انتقال آن جاوا نیز به صورت خودکار انتقال می‌یابد. تغییری ایجاد نکنید و آن را به همین صورت رها نمایید.

در پایان دکمه Next را کلیک کرده و در صفحه بعد فقط Default Package را تعیین و دکمه Finish را کلیک نمایید. تا اینجا برنامه مربوط به مدل را ایجاد کردیم همین فرایند را برای ساخت برنامه مربوط به viewController تکرار می‌نماییم با این تفاوت که برای Project Technologies باید تکنولوژی‌های ADF Faces, ADF Page Flow, HTML, Java , JSF, JSP and Servlet و XML را انتخاب نمایید. همانند تصویر

به منظور جلوگیری از طولانی شدن این مقاله نحوه آماده سازی مدل دپارتمان از قبیل Entity Object , View Object و Application Module تشریح نخواهد شد و فرض بر این است که این مراحل را خودتان انجام خواهید داد.

پس از آماده‌سازی مدل حال نوبت به این میرسد که این مدل را به صورت یک ADF Library آماده نماییم تا بتوانیم از آن در ViewCOntroller استفاده نماییم. برای این کار بر روی پروژه myModel راست کلیک نموده و Project Properties را انتخاب نمایید. از لیست سمت چپ Deployment را انتخاب نمایید و سپس دکمه New را از سمت راست کلیک نمایید. در کادر به نمایش در‌ آمده از لیست انتخابی ADF Library JAR File را انتخاب کنید و نام آن را نیز به myModelLib تغییر دهید(همانند تصویر زیر). سپس تمام مراحل را Ok نمایید و تغییری ایجاد نکنید.

حال تنظیمات مربوط به ایجادADF Library شما آماده شده است. JAR فایل مربوط به مدل در پوشه‌ای به نام Deploy در درون پروژه قرار می‌گیزد. می‌توانید در سیستم فایل به آن دسترسی داشته باشید البته پس از اینکه پروژه را Deploy کردید.
برای Deploy پروژه بر روی myModel در پلت Projects راست کلیک نمایید در منوی Deploy بر روی myModelLib کلیک نمایید. سپس دکمه Next و پس از آن Finish را کلیک نمایید.
حال JAR فایل در سیستم فایل شما ایجاد شده است و شما می‌توانید در خارج از JDeveloper به آن دسترسی داشته باشید.

خوب تا اینجا با موفقیت تمام، ADF Library را ایجاد کردیم . نوبت به آن رسیده تا آن را در ViewController که در ابتدای مقاله ایجاد کرده ایم وارد نماییم و صفحه لیست دپارتمان‌ها را بسازیم. در پلت Resources همانند تصویر زیر عمل نمایید. اگر پلت Resources را ملاحظه نمی‌نمایید از منوی View به آن دسترسی خواهید داشت.

در دیالوگ باز شده نامی دلخواه وارد نمایید و در قسمت Directory Path آدرس مربوط به پوشه Deploy مربوط به پروژه myModel را مشخص نمایید و Ok کنید.

حال مدل ما به عنوان یک Resource جدید به JDeveloper اضافه گردیده است و ما می‌توانیم در هر پروژه ای نیاز داشتیم از آن استفاده نماییم.
پروژه ViewController را باز نمایید در JDeveloper و سپس در پلت Resources فایل myModelLib.jar را انتخاب نمایید و بر روی آن راست کلیک نموده و add to project را انتخاب نمایید و دردیالوگ باز شده add Library را کلیک نمایید تا به پروژه مذکور اضافه گردد.

پس از اتمام مراحل بالا شما دیگر به مدل در قسمت Data Controles دسترسی دارید و می‌توانید صفحه لیست دپارتمان‌ها را ایجاد کنید.
نکته: قبل از اجرا برنامه باید رمز عبور Database Connection را در پلت application Resources وارد نمایید. چرا که این Connection از مدل وارد برنامه شده و رمزعبور آن خالی می‌باشد و باید مجددا وارد گردد.

تبریک می‌گویم شما تمام مراحل را با موفقیت پست سر گذاشتید. برنامه را تست کنید.

امیدوارم این مطلب براتون مفید باشه

فایل PDF

فایل مثال

فایل پیوست:
config maven 06 - نحوه ساخت و استفاده از ADF Library
bd9e5db58c7f88cb6cef5685c35d2e42f6336b58 702x336 - نحوه ساخت و استفاده از ADF Library
122359 - نحوه ساخت و استفاده از ADF Library
GUID 05E7CE77 EAEB 4562 950C DB123C8C4416 default - نحوه ساخت و استفاده از ADF Library
GUID 3EDB7803 64B6 4F75 B04C F41F416E40B2 default - نحوه ساخت و استفاده از ADF Library
gs install modellibs - نحوه ساخت و استفاده از ADF Library
خواندن بیشتر
, , , No comments
royal visionنحوه ساخت و استفاده از ADF Library

چگونه مقدار را در Session ذخیره کنم و در Groovey..

royal vision July 20, 2019

برای ذخیره یک مقدار در داخل Session در لایه مدل از کد زیر استفاده میکنیم.

getSession().getUserData().put("loc", locCode);<br />

کد بالا در داخل کلاس ApplicationModuleImpl وجود دارد پس از ذخیره سازی هر جا که بخواهید از آن استفاده کنید در زبان Groovey میتوانید از کد زیر استفاده کنید.

adf.userSession.userData.loc

%D9%84%DB%8C%D8%B3%D8%AA %D8%B3%D9%88%D8%A7%D9%84%D8%A7%D8%AA - چگونه مقدار را در Session ذخیره کنم و در Groovey..

خواندن بیشتر
, , No comments
royal visionچگونه مقدار را در Session ذخیره کنم و در Groovey..

نحوه ایجادEntity بر پایه وب سرویس

royal vision July 20, 2019

در این مقاله قصد توضیح این مورد را دارم که چگونه Entityهایی از وب سرویس بسازیم که بتوانیم به راحتی از آنها در مدل خود استفاده نماییم. در این مقاله مراحل کامل ایجاد یک وب سرویس و یک مدل مبتنی بر وب سرویس را آموزش خواهم داد.

شرح
در این آموزش ما نیاز به ایجاد دو Application داریم. یک Application که همان وب سرویس ما می باشد وظیفه ارايه عملیات‌های CRUD کارمندان را بر عهده دارد. Application دوم در واقع مصرف کننده وب سرویس می باشد که Entityهای مبتنی بر وب سرویس ما درون آن قرار دارد. ما برای این مثال از پایگاه داده HR موجود در Oracle XE استفاده می نمایم و در برنامه مصرف کننده وب سرویس ترکیبی از مدل مبتنی بر جداول پایگاه داده و وب سرویس استفاده می نماییم و صفحه ای طراحی می نماییم که لیست دپارتمان‌ها و کارمندان هر دپارتمان را نمایش می دهد که لیست کارمندان از طریق وب سرویس دریافت شده است.

برنامه اول: ایجاد وب سرویس با استفاده از ADF BC
ابتدا یک برنامه که شامل یک پروژه مدل می باشد ایجاد میکنیم. سپس به صورت معمول Entity و View جدول کارمندان را ایجاد می نماییم و آنرا به Application Module اضافه می نماییم و آنرا تست می نماییم تا از صحت کارکرد آن مطمئن شویم. ( به منظور جلوگیری از طولانی شدن این مقاله از توضیح این مراحل خودداری شده است)
حال باید آن را به صورت یک وب سرویس آماده نماییم تا در سرور Deploy نماییم. برای این کار بر روی Application Module کلیک نمایید و آنرا باز نمایید. سپس به بخش مربوط به Service Interface رفته و بر روی دکمه بعلاوه سبز رنگ کلیک نمایید تا ویزارد مربوط به ایجاد وب سرویس آغاز گردد.

برای نام Web Service مقدار EmployeeWS را وارد نمایید و دکمه Next را کلیک نمایید. در مرحله بعد نیز دکمه Next را کلیک نمایید. در مرحله سوم View کارمندان که ساخته شده است را ملاحظه خواهید نمود آنرا انتخاب نمایید و آن را با استفاده از دکمه ای که در کنار آن ملاحظه می نمایید به سمت راست منتقل نمایید. پس از این کار در زیر آن لیستی از عملیات هایی که می توان بر روی کارمندان انجام داد را مشاهده می نمایید که همه آنها را انتخاب نمایید.

پس از انجام مراحل بالا دکمه Next را کلیک نماید. آخرین مرحله به شما خلاصه ای از مراحل گذشته نمایش داده می شود و با کلیک بر روی دکمه Finish تنظیمات و فایل های مربوط به وب سرویس ایجاد می شود.
پس از ایجاد در زیر Application Module پوشه ای با نام service Interface ایجاد می شود که درون آن فایل‌های مربوط به وب سرویس قرار دارد. بر روی فایل EmployeeWSImpl.java کلیک نمایید و Run را انتخاب نمایید تا وب سرویس بر روی weblogic قرار گیرد و آماده اجرا گردد. در صورتی که مشکلی پیش نیاید و وب سرویس به درستی اجرا گردد در کنسول لاگ یک لینک در اختیار شما قرار خواهد گرفت که با کلیک بر روی آن صفحه ای برای شما باز می شود که این امکان را به شما خواهد داد تا سرویس خود را تست نمایید و از صحت کارکرد آن خیالتان آسوده گردد. (همانند تصویر زیر)

آدرس دسترسی به فایل WSDL سرویس شما برابر خواهد بود

[left]http://localhost:7101/webservice-employeeasws-context-root/employeews?wsdl[/left]

می توانید برای اطمینان از صحت آدرس خود آنرا در browser تست نمایید.
تا اینجا برنامه ای که قرار است لیست کارمندان را به صورت وب سرویس در اختیارتان قرار دهد آماده شده است و نوبت آن رسیده است تا برنامه ی اصلی که قرار است وب سرویس را مصرف نماید آماده نمایید.

برنامه دوم: ایجاد یک مصرف کننده وب سرویس 
همانند تمام برنامه های Fusion Web Application که تا به امروز ایجاد کردیده اید یک برنامه جدید در Jdeveloper ایجاد نمایید. پس از آن Entity و view مربوط به دپارتمان‌ها را از روی جدول Department بسازید. سپس مجدد بر روی پروژه مدل خود راست کلیک نمایید و گزینه New Entity Object را انتخاب نمایید. در ویزاردی که برای ایجاد Entity باز میشود در پایین آن گزینه Service Interface را انتخاب نمایید و آدرس زیر را که مربوط به وب سرویس کارمندان می باشد درون آن قرار دهید.

[left]http://localhost:7101/webservice-employeeasws-context-root/employeews?wsdl[/left]
* دقت نمایید که آدرس را با توجه به سیستم خود تغییر دهید.

همانطور که در تصویر بالا ملاحظه می نمایید در صورت درست بودن آدرس و صحت اجرای وب سرویس نام EmployeeVO1 از وب سرویس استخراج شده و در قسمت Service View Instance نمایش داده می شود.
تا رسیدن به مرحله ۵ ویزارد، دکمه Next را کلیک نمایید و همه چیز را به صورت پیش فرض رها کنید. در مرحله ۵ گزینه Generate Default View Object را انتخاب نمایید تا View Object آن نیز ساخته شود. سپس دکمه Next را تا پایان ویزارد کلیک نمایید و در نهایت نیز Finish را کلیک کرده و منتظر باشید تا Jdeveloper بقیه کارها را برای شما انجام دهد.
حال یک View Link بین دپارتمان و کارمندان به صورت کاملا معمولی که تا به حال در سایر مدل ها می ساختید، ایجاد نمایید تا بتوانید حالت Master-Detail را برای دپارتمان و کارمندان داشته باشید. سپس یک Application Module با نام ConsumerModel ایجاد نماید و View Objectهای خود را به آن اضافه نمایید.
در ViewController یک صفحه ایجاد نمایید و دپارتمان و کارمندان مربوط به آن را به صفحه اضافه نمایید. به دلیل آن که این مراحل همانند همه برنامه های عادی که تا به حال ساخته اید، می باشد از توضیح آنها خودداری می نمایم.

در پایان قبل از اینکه بخواهید برنامه را اجرا نمایید باید تنظیمات زیر را در فایل connection.xml پروژه اضافه نمایید. این فایل در قسمت Application Resources در زیر Descriptors و ADF META-INF قابل دسترسی می باشد.

EmployeeWSBean#com.my.common.serviceinterface.EmployeeWS</p>
<p>weblogic.jndi.WLInitialContextFactory</p>
<p>t3://localhost:7101</p>
<p>admin</p>
<p>admin123</p>
<p>EmployeeWS.xsd</p>
<p>com/my/common/serviceinterface/</p>

فقط اطلاعات مربوط به قسمتهای jndiProviderURL ، jndiSecurityPrincipal و jndiSecurityCredentials اطلاعات مربوط به سیستم خودتان را وارد نماید. JndiSecurityPrincipal و jndiSecurityCredentials منظور همان username و password مربوط به weblogic می باشد. در ضمن اگر شما از packaging خود را نیز تغییر داده اید و همانند com.my که من استفاده کرده ام نمی باشد باید تغییرات لازم را در کدهای بالا بدهید تا با خطا روبرو نگردید.

سپس به پروژه وب سرویس خود بروید و بر روی مدل آن راست کلیک نمایید و Project Properties را انتخاب نمایید. در منوی سمت چپ به قسمت Deployment بروید و از قسمت سمت راست این منو گزینه New را انتخاب نمایید. در پنجره باز شده Archive Type را برابر با Business Components Service Interface انتخاب نمایید و مقدار bcEmployeeWI را برای نام آن وارد نمایید و در نهایت همه پنجره ها را ok نمایید. مجدد بر روی مدل راست کلیک نمایید و در منوی Deploy بر روی bcEmployeeWI کلیک نمایید تا فایل‌های مربوط ایجاد گردد. این عمل شما باعث شد تا دو Jar فایل با نام های bcEmployeeWI_Common.jar و bcEmployeeWI_MiddleTier.jar در پوشهDeploy در مسیر مدل پروژه WebService ایجاد گردد.

حال شما بایدapplication مربوط به مصرف کننده وب سرویس (WSConsumer)را مجددا باز نمایید و فایل bcEmployeeWI_Common.jar را که در مرحله قبل در پروژه WebService ساخته اید را به عنوان یک library به آن اضافه نماید. برای این کار بر روی پروژه مدل برنامه WSConsumer راست کلیک نمایید منوی project properties را انتخاب نمایید. در منوی سمت چپ Libraries and Classpath را انتخاب نمایید و دکمه Add jar/Directory را کلیک نمایید سپس در مسیر پروژه WebService وارد پوشه پروژه مدل و سپس Deploy شوید و فایل bcEmployeeWI_Common.jar را انتخاب نمایید و همه پنجره ها را OK نمایید.

نکته آخر اینکه این پروژه ها را باید در سرور SOA-Enabled اجرا نمایید تا با خطایی روبرو نگردید. برای نحوه راه اندازی اینگونه سرورها می توانید به مستندات مربوط به Oracle SOA Suite 11g مراجعه نمایید.

تبریک می گویم شما تمام مراحل مورد نیاز را با موفقیت پشت سر گذاشتید و کافیست برنامه خود را تست نمایید

این مثال با استفاده از JDeveloper 11.1.1.5 و SOA Suite 11.1.1.5 نوشته و تست شده است.

امیدوارم که این مطلب برایتان مفید بوده باشد.

فایل PDF

فایل مثال

فایل پیوست:
13 1 - نحوه ایجادEntity بر پایه وب سرویس
t020104 - نحوه ایجادEntity بر پایه وب سرویس
webservices calling db - نحوه ایجادEntity بر پایه وب سرویس
ws editservinterface - نحوه ایجادEntity بر پایه وب سرویس
1 - نحوه ایجادEntity بر پایه وب سرویس
2e126 adfentityobject - نحوه ایجادEntity بر پایه وب سرویس
WebServiceEnabl
ServiceEnabledE
خواندن بیشتر
, , No comments
royal visionنحوه ایجادEntity بر پایه وب سرویس

نحوه خواندن مقدار یک LOV در زمان Runtime

royal vision July 20, 2019

اگر روی یک فیلد LOV داشته باشید و در لایه View Controller بخواهید به رکورد متناظر دسترسی داشته باشید مثلاً بخواهید بدانید رکوردی که کاربر انتخاب کرده است چه مقداری دارد باید از کد یر استاده کنید در کد زیر مقدار CmemSetupPost برابر نام binding فیلدی است که LOV میباشد.
مقدار ValueField برابر نام فیلدی از ViewObject مربوط به LOV است که میخواهیم مقدار آن را بدست آوریم.
بر روی فیلدی که LOV دارد یک ValueChangeListener بنویسید با شرایط زیر:

public void post_changed(ValueChangeEvent valueChangeEvent) {</p>
<p>BindingContainer bindings =<br />
BindingContext.getCurrent().getCurrentBindingsEntry();<br />
JUCtrlListBinding listBinding =<br />
(JUCtrlListBinding)bindings.get("CmemSetupPost");<br />
int index=(Integer)valueChangeEvent.getNewValue();</p>
<p>Number newValue=(Number)((ViewRowImpl)listBinding.getValueFromList(index)).getAttribute("ValueField");<br />
}
خواندن بیشتر
, , , No comments
royal visionنحوه خواندن مقدار یک LOV در زمان Runtime