Book Image

Oracle JDeveloper 11gR2 Cookbook

By : Nick Haralabidis
Book Image

Oracle JDeveloper 11gR2 Cookbook

By: Nick Haralabidis

Overview of this book

Oracle's Application Development Framework (ADF) for Fusion Web Applications leverages Java EE best practices and proven design patterns to simplify constructing complex web solutions with JDeveloper, and this hands-on, task-based cookbook enables you to realize those complex, enterprise-scale applications. With the help of real-world implementations, practical recipes cover everything from design and construction, to deployment, testing, debugging and optimization. This practical, task-based cookbook takes you, the ADF developer, on a practical journey for building Fusion Web Applications. By implementing a range of real world use cases, you will gain invaluable and applicable knowledge for utilizing the ADF framework with JDeveloper 11gR2. "Oracle JDeveloper 11gR2 Cookbook"ù is a task-based guide to the complete lifecycle of Fusion Web Application development using Oracle JDeveloper 11gR2 and ADF.You will get quickly up and running with concepts like setting up Application Workspaces and Projects, before delving into specific Business Components such as Entity Objects, View Objects, Application Modules and more. Along the way you will encounter even more practical recipes about ADF Faces UI components and Backing Beans, and the book rounds off by covering security, session timeouts and exceptions.With "Oracle JDeveloper 11gR2 Cookbook"ù in hand you will be equipped with the practical knowledge of a range of ready to use implementation cases which can be applied to your own Fusion Web ADF Applications.

Related Content you might be interested in

Current Title:

Small book image
Oracle JDeveloper 11gR2 Cookbook
Nick Haralabidis
Jan, 2012 | 406 pages
No titles found
Table of Contents (19 chapters)
Oracle JDeveloper 11gR2 Cookbook
Oracle JDeveloper 11gR2 Cookbook
Credits
Credits
Foreword
Foreword
About the Author
About the Author
About the Reviewers
About the Reviewers
www.PacktPub.com
www.PacktPub.com
Preface
Preface
Free Chapter
1
Prerequisites to Success: ADF Project Setup and Foundations
Prerequisites to Success: ADF Project Setup and Foundations
Introduction
Installation of JDeveloper on Linux
Breaking up the application in multiple workspaces
Setting up BC base classes
Setting up logging
Using a custom exception class
Using ADFUtils/JSFUtils
Using page templates
Using a generic backing bean actions framework
2
Dealing with Basics: Entity Objects
Dealing with Basics: Entity Objects
Introduction
Using a custom property to populate a sequence attribute
Overriding doDML() to populate an attribute with a gapless sequence
Creating and applying property sets
Using getPostedAttribute() to determine the posted attribute's value
Overriding remove() to delete associated children entities
Overriding remove() to delete a parent entity in an association
Using a method validator based on a view object accessor
Using Groovy expressions to resolve validation error message tokens
Using doDML() to enforce a detail record for a new master record
3
A Different Point of View: View Object Techniques
A Different Point of View: View Object Techniques
Introduction
Iterating a view object using a secondary rowset iterator
Setting default values for view row attributes
Controlling the updatability of view object attributes programmatically
Setting the Queryable property of a view object attribute programmatically
Using a transient attribute to indicate a new view object row
Conditionally inserting new rows at the end of the rowset
Using findAndSetCurrentRowByKey() to set the view object currency
Restoring the current row after a transaction rollback
Dynamically changing the WHERE clause of the view object query
Removing a row from a rowset without deleting it from the database
4
Important Contributors: List of Values, Bind Variables, View Criteria
Important Contributors: List of Values, Bind Variables, View Criteria
Introduction
Setting up multiple LOVs using a switcher attribute
Setting up cascading LOVs
Creating static LOVs
Overriding bindParametersForCollection() to set a view object bind variable
Creating view criteria programmatically
Clearing the values of bind variables associated with the view criteria
Searching case insensitively using view criteria
5
Putting them all together: Application Modules
Putting them all together: Application Modules
Introduction
Creating and using generic extension interfaces
Exposing a custom method as a web service
Accessing a service interface method from another application module
A passivation/activation framework for custom session-specific data
Displaying application module pool statistics
Using a shared application module for static lookup data
Using a custom database transaction
6
Go with the Flow: Task Flows
Go with the Flow: Task Flows
Introduction
Using an application module function to initialize a page
Using a task flow initializer to initialize a task flow
Calling a task flow as a URL programmatically
Retrieving the task flow definition programmatically using MetadataService
Creating a train
7
Face Value: ADF Faces, JSF Pages, and User Interface Components
Face Value: ADF Faces, JSF Pages, and User Interface Components
Introduction
Using an af:query component to construct a search page
Using an af:pop-up component to edit a table row
Using an af:tree component
Using an af:selectManyShuttle component
Using an af:carousel component
Using an af:poll component to periodically refresh a table
Using page templates for pop-up reuse
Exporting data to a client file
8
Backing not Baking: Bean Recipes
Backing not Baking: Bean Recipes
Introduction
Determining whether the current transaction has pending changes
Using a custom af:table selection listener
Using a custom af:query listener to allow execution of a custom application module operation
Using a custom af:query operation listener to clear both the query criteria and results
Using a session scope bean to preserve session-wide information
Using an af:popup during long running tasks
Using an af:popup to handle pending changes
Using an af:iterator to add pagination support to a collection
9
Handling Security, Session Timeouts, Exceptions, and Errors
Handling Security, Session Timeouts, Exceptions, and Errors
Introduction
Enabling ADF security
Using a custom login page
Accessing the application's security information
Using OPSS to retrieve the authenticated user's profile from the identity store
Detecting and handling session timeouts
Using a custom error handler to customize how exceptions are reported to the ViewController
Customizing the error message details
Overriding attribute validation exceptions
10
Deploying ADF Applications
Deploying ADF Applications
Introduction
Configuring and using the Standalone WebLogic Server
Deploying on the Standalone WebLogic Server
Using ojdeploy to automate the build process
Using Hudson as a continuous integration framework
11
Refactoring, Debugging, Profiling, and Testing
Refactoring, Debugging, Profiling, and Testing
Introduction
Synchronizing business components with database changes
Refactoring ADF components
Configuring and using remote debugging
Logging Groovy expressions
Dynamically configuring logging in WebLogic Server
Performing log analysis
Using CPU profiler for an application running on a standalone WebLogic server
Configuring and using JUnit for unit testing
12
Optimizing, Fine-tuning, and Monitoring
Optimizing, Fine-tuning, and Monitoring
Introduction
Using Update Batching for entity objects
Limiting the rows fetched by a view object
Limiting large view object query result sets
Limiting large view object query result sets by using required view criteria
Using a work manager for processing of long running tasks
Monitoring the application using JRockit Mission Control

Installation of JDeveloper on Linux

Installation of JDeveloper is, in general, a straightforward task. So, "why have a recipe for this?" you might ask. Did you notice the title? It says "on Linux". You will be amazed at the number of questions asked about this topic on a regular basis on the JDeveloper and ADF OTN Forum. Besides, in this recipe, we will also talk about configuration options and the usage of 64-bit JDK along with JDeveloper.

Getting ready

You will need a Linux installation of JDeveloper to use this recipe. For the 64-bit configuration, you will need a 64-bit Linux distribution and a 64-bit version of the Java SDK. We will install the latest version of JDeveloper, which is version 11.1.2.1.0 at the time of this writing.

How to do it...

  1. 1. Download JDeveloper from the Oracle JDeveloper Software download page: http://www.oracle.com/technetwork/developer-tools/jdev/downloads/index.html.

  2. 2. Accept the license agreement, select Linux Install, and click on Download File to begin with the download.

  3. 3. Once the file is downloaded, open a console window and start the installation, by typing the following commands:

    $ chmod u+x ./jdevstudio11121install.bin
$ ./jdevstudio11121install.bin

  4. 4. On the Choose Middleware Home Directory page, select Create a new Middleware Home and enter the Middleware home directory.

  5. 5. On the Choose Install Type page, select Complete to ensure that JDeveloper, ADF and WebLogic Server are installed.

  6. 6. Once you confirm your selections, proceed with the installation.

  7. 7. Upon a successful installation, you will see the Installation Complete page. Uncheck the Run Quickstart checkbox and click Done.

  8. 8. To start JDeveloper, go to the /jdeveloper/jdev/bin directory under the Middleware home directory you specified during the installation and type the following: 

    $ ./jdev

  9. 9. To make things easier, create an application launcher on your Linux desktop for the specific path indicated in the previous step.

How it works...

As noted earlier, installing JDeveloper on Linux is a straightforward task. You simply have to download the binary executable archive and run it. Ensure that you give execute permissions to the installation archive file and run it as noted. If you are having trouble seeing the Welcome page in graphical mode, ensure that the $DISPLAY environment variable is set correctly. The important thing to know here is the name of the file to execute in order to start JDeveloper. As mentioned, it is called jdev and it is located in the /jdeveloper/jdev/bin directory under the Middleware home directory.

There's more...

Now that you have successfully installed JDeveloper, let's spend some time configuring it for optimal performance. Configuration parameters are added to any of the jdev.conf or ide.conf files located in the /jdeveloper/jdev/bin and /jdeveloper/ide/bin directories respectively, under the Middleware home directory.

The following is a list of the important tuning configuration parameters with some recommendations for their values:

Parameter

Description

AddVMOption -Xmx

This parameter is defined in the ide.conf file and indicates the maximum limit that you will allow the JVM heap size to grow to. In plain words, it is the maximum memory that JDeveloper will consume on your system. When setting this parameter, consider the available memory on your system, the memory needed by the OS, the memory needed by other applications running concurrently with JDeveloper, and so on. On a machine used exclusively for development with JDeveloper, as a general rule of thumb consider setting it to around 50 percent of the available memory.

AddVMOption -Xms

This parameter is also defined in the ide.conf and indicates the initial JVM heap size. This is the amount that will be allocated initially by JDeveloper and it can grow up to the amount specified by the previous -Xmx parameter. When setting this parameter, consider whether you want to give JDeveloper a larger amount in order to minimize frequent adjustments to the JVM heap. Setting this parameter to the same value as the one indicated by the -Xmx parameter will supply a fixed amount of memory to JDeveloper.

AddVMOption -XX:MaxPermSize

This parameter indicates the size of the JVM permanent generation used to store class definitions and associated metadata. Increase this value if needed in order to avoid java.lang.OutOfMemoryError: PermGen space errors. A 256MB setting should suffice.

AddVMOption -DVFS_ENABLE

Set it to true in jdev.conf if your JDeveloper projects consist of a large number of files, especially if you will be enabling a version control system from within JDeveloper.

Configuring JDeveloper with a 64-bit JDK

The JDeveloper installation is bundled by default with a 32-bit version of the Java JDK, which is installed along with JDeveloper. On a 64-bit system, consider running JDeveloper with a 64-bit version of the JDK. First download and install the 64-bit JDK. Then configure JDeveloper via the SetJavaHome configuration parameter in the jdev.conf. This parameter should be changed to point to the location of the 64-bit JDK. Note that the 64-bit JDK is supported by JDeveloper versions 11.1.1.4.0 and higher.

Configuring the JDeveloper user directory

This is the directory used by JDeveloper to identify a default location where files will be stored. JDeveloper also uses this location to create the integrated WebLogic domain and to deploy your web applications when running them or debugging them inside JDeveloper. It is configured via the SetUserHomeVariable parameter in the jdev.conf file. It can be set to a specific directory or to an environment variable usually named JDEV_USER_DIR. Note that when JDeveloper is started with the singleuser command-line argument, the user directory is created inside the /jdeveloper directory under the Middleware home directory.

Note

Before starting your development in JDeveloper, consider setting the XML file encoding for the XML files that you will be creating in JDeveloper. These files among others include, the JSF pages, the business component metadata files, application configuration files, and so on. You set the encoding via the Tools | Preferences… menu. Select the Environment node on the left of the Preferences dialog and the encoding from the Encoding drop-down. The recommended setting is UTF-8 to support multi-lingual applications.

Note

The minimum recommended open file descriptors limit for JDeveloper on a Linux system is 4096. Use the command ulimit n to determine the open file descriptors limit for your installation and change it if needed in the limits.conf file located in /etc/security/ directory.

Previous Section
End of Section 3
Next Section