How-To-Tips.net

How to Build Ontologies from Existing Ontologies exist on how to build an ontology In Gruninger s method. an ontology contains enough …

Oracle Forms Community my first bean Feb-2006

Oracle Forms / Java tutorial How to build a new JavaBean

1 Purpose
The purpose of this tutorial is to demonstrate how to build and integrate a new JavaBean in an Oracle Forms application

2 The goal
In this tutorial we are going to develop a JavaBean that retrieved the background color of a Forms canvas But, why not simply use the Get_Canvas_Property canvas_name, BACKGROUND_COLOR built-in ? The reason why we cannot use the Forms GET_Canvas_Property built-in is that it returns null if the background color is not explicitly set The trick to solve this problem is thus to use a Forms bean area item and locate in on the Forms canvas The background color property is then read from JavaBean containers parent container

3 Build the bean
Open Jdeveloper Create a new application Right click on the Applications node then click the New Application option

Enter the name of the new application

http://formspjcbeanover-blogcom/

Oracle Forms Community my first bean Feb-2006

Enter the name of the new project

Add a new class to the project Right click on the OracleFormsBean node and click the New Java Class
option

http://formspjcbeanover-blogcom/

Oracle Forms Community my first bean Feb-2006

Set the name of the class and the name of the package In this sample, the class name is GetCanvasProp and the package name is oracleformsfd

A Javabean source code s skeleton bean_templatetxt is provided with the samples to help you to quickly start a new PJC/Javabean class Open the bean_templatetxt file provided with the samples, then copy the content in the new GetCanvasPropjava window

http://formspjcbeanover-blogcom/

Oracle Forms Community my first bean Feb-2006

Some of he imported classes are Forms specific and are not available in JDeveloper by default You need to add these classes by creating a custom library in JDeveloper that points to the f90allfar file located in the ORACLE_HOME/forms90/java/ directory versions 902 and 904 or in the ORACLE_HOME/forms/java/ directory version 1012, where It is named to frmalljar Copy this file and paste it in the /lib sub-directory of your Jdeveloper installation path Right-click on the OracleFormsBean project node then click the Project Properties option

http://formspjcbeanover-blogcom/

Oracle Forms Community my first bean Feb-2006

In
the Libraries tab, click the Add Jar/Directory button

Select the f90alljar file version 902, 904 or the frmalljar file version 1012

http://formspjcbeanover-blogcom/

Oracle Forms Community my first bean Feb-2006

Ok, so this is the java code, now:
package oracleformsdemo; import import import import oracleformshandlerIHandler; oracleformsuiCustomEvent; oracleformspropertiesID; oracleformsuiVBean;

public class my_new_class extends VBean { static IHandler mHandler; // properties you can set protected static final ID SET_01 protected static final ID SET_02 // properties you can be get protected static final ID GET_01 // events you can raise protected static final ID EVT_01 // default constructor public my_new_class { super; } public void initIHandler handler { superinithandler; mHandler handler; // put your initialisation instructions here } / Set the properties to the bean / public boolean setPropertyID property, Object value { ifproperty SET_01 { SystemoutprintlnSet property 01 Stringvalue ; // add your code here return true;

IDregisterPropertySET_01; IDregisterPropertySET_02; IDregisterPropertyGET_01;
IDregisterPropertyEVT_01;

http://formspjcbeanover-blogcom/

Oracle Forms Community my first bean Feb-2006
} else if property SET_01 { // add your code here return true; } else // default behaviour { return supersetPropertyproperty, value; } } / Get the properties of the bean / public Object getPropertyID property { if property GET_01 { // return the corresponding value return the property needed ; } else // default behaviour { return supergetPropertyproperty; } } / Send a message to the Forms module / public void dispatch_event ID id { CustomEvent ce new CustomEventmHandler, id; dispatchCustomEventce; } }

The parts displayed with a bold red font are those you have to adapt Adapt the correct name of the bean replace the my_new_class occurences with the name of your real class Adapt the properties IDs to give them a more comprehensive sense

Get a particular property
In our sample we want to get the background color of the canvas, so a good name for the corresponding property ID could be : GETBGCOLOR You get the bean property from the Forms module through the getProperty method wich is part of the Vbean class All what we need is to get the background color of the parents
component This is the code of the getProperty function:
if property GETBGCOLOR { // get the color of the parent container String sColor ; Color color thisgetParentgetBackground ; sColor r colorgetRed gcolorgetGreenb colorgetBlue // return the value return sColor ; }

;

http://formspjcbeanover-blogcom/

Oracle Forms Community my first bean Feb-2006

Set a particular property
We also want to hide/show the Java Bean component, so we need to set its visible property This is done in the setProperty method, trough the SETHIDDEN property ID The setProperty method takes 2 arguments : The property ID and an object that contains the value this value comes from the 4th argument of the Forms builtin Set_Custom_Property This is the code of the setProperty function:
ifproperty SETHIDDEN // Hide/Show the Java Bean component { // get the parameter string String sParam Stringvalue ; if sParamequalstrue setVisiblefalse; else setVisib letrue; return true; }

Then, the java code should, now, look like this: modified parts appear in a bold font
package oracleformsdemo; import javaawtColor; import import import import oracleformshandlerIHandler; oracleformsuiCustomEvent; oracleformspropertiesID;
oracleformsuiVBean;

public class GetCanvasProp extends VBean { static IHandler mHandler; // properties you can set protected static final ID SETHIDDEN IDregisterPropertySETHIDDEN; // properties you can be get protected static final ID GETBGCOLOR IDregisterPropertyGETBGCOLOR; // events you can raise protected static final ID EVT_01 IDregisterPropertyEVT_01; // default constructor public GetCanvasProp { super; } public void initIHandler handler { superinithandler; mHandler handler; // put your initialisation instructions here } / Set the properties to the bean / public boolean setPropertyID property, Object value { ifproperty SETHIDDEN // Hide/Show the Java Bean component { // get the parameter string String sParam Stringvalue ;

http://formspjcbeanover-blogcom/

Oracle Forms Community my first bean Feb-2006
if sParamequalstrue setVisiblefalse; else setVisibletrue; return true; } else // default behaviour { return supersetPropertyproperty, value; } } / Get the properties of the bean / public Object getPropertyID property { if property GETBGCOLOR { // get the color of the parent container String sColor ; Color color thisgetParentgetBackground ; sColor r colorgetRed
gcolorgetGreenb colorgetBlue // return the value return sColor ; } else // default behaviour { return supergetPropertyproperty; } } / Send a message to the Forms module / public void dispatch_event ID id { CustomEvent ce new CustomEventmHandler, id; dispatchCustomEventce; } }

;

So, at this moment we need to deploy the jar file to integrate it with the Forms application Add a new Deployement Profile to the project that allows to generate and deploy the corresponding jar file of the new javabean Right-click the OracleFormsBean project node then click the New option

Select the Deployment Profiles tab then the JAR File option

http://formspjcbeanover-blogcom/

Oracle Forms Community my first bean Feb-2006

Choose a name for this Deployment profile

Set the path where the jar file will be copied at each deployment I use to indicate the /forms/java directory

http://formspjcbeanover-blogcom/

Oracle Forms Community my first bean Feb-2006

Then deploy the jar file Right-click the FormsPropertiesdeploy node then click the Deploy to JAR file option

Be sure the jar file is well deployed in the /forms/java directory If not, copy manually the jar file into the forms/java
directory

4 Setup the Forms configuration file : formswebcfg
This file is located in your ORACLE_HOME/forms/server directory Open this file and search for the archive_jini tag Add your jar file to this tag archive_jinifrmall_jinitjar,,FormsPropertiesjar save the formswebcfg file

http://formspjcbeanover-blogcom/

Oracle Forms Community my first bean Feb-2006

5 Build the Forms test dialog
Open the Forms Builder Create a new canvas Add a javabean item on the new canvas Set its Implementation Class property to : oracleformsdemoGetCanvasProp remember the package and class name of your bean

From now on you are able to set and get the properties of your javabean

Set a property To set a property of your javabean, use the Set_Custom_Property built-in Set_Custom_Property item_name, record_number, property_name, property_value ; On the When-Button-Pressed trigger, we set this property with the following code: Set_Custom_Property BLBEAN_AREA, 1, SETHIDDEN, true ; or Set_Custom_Property BLBEAN_AREA, 1, SETHIDDEN, false ;

Get a property To get a property from your javabean, use the Get_Custom_Property built-in Varchar2 : Get_Custom_Property item_name, record_number,
property_name ; item_name is the name of the bean area item that support the Java Implementation Class In our sample, we want to get the background color through the GETBGCOLOR property ID, so the call to the built-in is the following: BColor : Get_Custom_Property BL1BEAN_AREA, 1, GETBGCOLOR ;

6 The sample dialog
Download the first_beanzip file Unzip the file Copy the FormsPropertiesjar file in your /forms/java/ directory Edit the /forms/server/formswebcfg file to add the jar file to the archive_jini variable archive_jinif90all_jinitjar,,FormsPropertiesjar Save the formswebcfg file Open the BEANfmb dialog provided with the zip file Compile and run it

http://formspjcbeanover-blogcom/

Oracle Forms Community my first bean Feb-2006

This is the code executed in the When-New-Form-Instance trigger: Declare FColor BColor Begin

Varchar230 ; Varchar230 ;

– Get the Forms property -FColor : Get_Canvas_Property CV1, BACKGROUND_COLOR ; :BLEL1 : [ || FColor || ] ; — Get the Javabean property -BColor : Get_Custom_Property BLBEAN_AREA, 1, GETBGCOLOR ; :BLEL2 : [ || BColor || ] ; If BColor is not null Then Set_Item_Property BLPUSH_BUTTON2, BACKGROUND_COLOR, BColor ; End if ;
End; As you can see, the Get_Canvas_Property built-in returns a NULL value, whereas the Get_Custom_Property returns the correct value my current colorscheme is BLAF at this very moment The Hide bean push button allows to hide/show the bean item You may get, of course, another value if you use a different colorscheme

7 Forms and Java version
In order to run your javabean in the Forms application, you have to verify that the Compiler option of the Jdeveloper product is setted to 13

http://formspjcbeanover-blogcom/

Source:wilder.org