Oracle JDeveloper 11gR2 Cookbook

Oracle JDeveloper 11gR2 Cookbook

By : Nick Haralabidis

Buy this Book

Oracle JDeveloper 11gR2 Cookbook

By: Nick Haralabidis

Buy this Book

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.

Oracle JDeveloper 11gR2 Cookbook

Credits

Foreword

About the Author

About the Reviewers

www.PacktPub.com

Preface

Free Chapter

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

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

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

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

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

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

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

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

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

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

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

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

Customer Reviews

5 star

4 star

3 star

2 star

1 star

Using ADFUtils/JSFUtils

In this recipe, we will talk about how to incorporate and use the ADFUtils and JSFUtils utility classes in your ADF application. These are utility classes used at the ViewController level that encapsulate a number of lower level ADF and JSF calls into higher level methods. Integrating these classes in your ADF application early in the development process, and subsequently using them, will be of great help to you as a developer and contribute to the overall project's clarity and consistency. The ADFUtils and JSFUtils utility classes, at the time of writing, are not part of any official JDeveloper release. You will have to locate them, configure them, and expand them as needed in your project.

Getting ready

We will be adding the ADFUtils and JSFUtils classes to the SharedComponents ViewController project that we developed in the Breaking up the application in multiple workspaces recipe in this chapter.

How to do it…

1. To get the latest version of these classes, download and extract the latest version of the Fusion Order Demo application in your PC. This sample application can be found currently in the Fusion Order Demo (FOD) - Sample ADF Application page at the following address: http://www.oracle.com/technetwork/developer-tools/jdev/index-095536.html.
2. The latest version of the Fusion Order Demo application is 11.1.2.1 R2 at the time of this writing and is bundled in a zipped file. So go ahead download and extract the Fusion Order Demo application in your PC.
3. You should be able to locate the ADFUtils and JSFUtils classes in the location where you have extracted the Fusion Order Demo application. If multiple versions of the same class are found, compare them and use the ones that are most up-to-date. For this recipe, we have included in the source code the ADFUtils and JSFUtils found in the SupplierModule\ViewController\src\oracle\fodemo\supplier\view\utils directory.
4. Copy these classes to a specific location in your shared ViewController components project. For this recipe, we have copied them into the SharedComponents\SharedViewController\src\com\packt\jdeveloper\cookbook\shared\view\util directory.
5. Once copied, open both files with JDeveloper and change their package to reflect their new location, in this case to com.packt.jdeveloper.cookbook.shared.view.util.

How it works…

The public interfaces of both ADFUtils and JSFUtils define static methods, so you can call them directly without any class instantiations. The following are some of the methods that are commonly used.

Locating an iterator binding

To locate an iterator in the bindings, use the ADFUtils.findIterator() method. The method accepts the bound iterator's identifier and returns an oracle.adf.model.binding.DCIteratorBinding. The following is an example:

DCIteratorBinding it = ADFUtils.findIterator("IteratorID");

Locating an operation binding

To locate an operation in the bindings, use the ADFUtils.findOperation() method. This method accepts the bound operation's identifier and returns an oracle.binding.OperationBinding.

OperationBinding oper = ADFUtils.findOperation("OperationID");

Locating an attribute binding

Use ADFUtils.findControlBinding() to retrieve an attribute from the bindings. This method accepts the bound attribute's identifier and returns an oracle.binding.AttributeBinding.

AttributeBinding attrib = ADFUtils.findControlBinding("AttributeId");

Getting and setting an attribute binding value

To get or set a bound attribute's value, use the ADFUtils.getBoundAttributeValue() and ADFUtils.setBoundAttributeValue() methods respectively. Both of these methods accept the identifier of the attribute binding as an argument. The getBoundAttributeValue() method returns the bound attribute's data value as a java.lang.Object. The setBoundAttributeValue() method accepts a java.lang.Object and uses it to set the bound attribute's value.

// get some bound attribute data
String someData = (String)ADFUtils.getBoundAttributeValue("AttributeId");
// set some bound attribute data
ADFUtils.setBoundAttributeValue("AttributeId", someData);

Getting the binding container

You can get the oracle.adf.model.binding.DCBindingContainer binding container by calling the ADFUtils.getDCBindingContainer() method.

DCBindingContainer bindings = ADFUtils.getDCBindingContainer();

Adding Faces messages

Use the JSFUtils.addFacesInformationMessage() and JSFUtils.addFacesErrorMessage() methods to display Faces information and error messages respectively. These methods accept the message to display as a String argument.

JSFUtils.addFacesInformationMessage("Information message");
JSFUtils.addFacesErrorMessage ("Error message");

Finding a component in the root view

To locate a UI component in the root view based on the component's identifier, use the JSFUtils.findComponentInRoot() method. This method returns a javax.faces.component.UIComponent matching the specified component identifier.

UIComponent component = JSFUtils.findComponentInRoot("ComponentID");

Getting and setting managed bean values

Use the JSFUtils.getManagedBeanValue() and JSFUtils.setManagedBeanValue() methods to get and set a managed bean value respectively. These methods both accept the managed bean name. The JSFUtils.getManagedBeanValue() method returns the managed bean value as a java.lang.Object. The JSFUtils.setManagedBeanValue() method accepts a java.lang.Object and uses it to set the managed bean value.

Object filePath = JSFUtils.getManagedBeanValue ("bindings.FilePath.inputValue");
JSFUtils.setManagedBeanValue("bindings.FilePath.inputValue", null);

Oracle JDeveloper 11gR2 Cookbook

By : Nick Haralabidis

Oracle JDeveloper 11gR2 Cookbook

By: Nick Haralabidis

Overview of this book

Related Content you might be interested in

Current Title:

Oracle JDeveloper 11gR2 Cookbook

Using ADFUtils/JSFUtils

Getting ready

How to do it…

How it works…

Locating an iterator binding

Locating an operation binding

Locating an attribute binding

Getting and setting an attribute binding value

Getting the binding container

Adding Faces messages

Finding a component in the root view

Getting and setting managed bean values