Oracle ADF Architecture TV - Design - Task Flow Communication Pattern

Real World ADF Design & Architecture Principles
Task Flow & Region Communication Patterns
ORACLE
PRODUCT
LOGO
15th Feb 2013 v1.0

Learning Objectives
•  At the end of this module you should be able to:
–  Understand different patterns of ADF region interaction
–  Be able to choose the right pattern to implement for a problem
–  Understand the dos and don’ts of task flow communication
Image: imagerymajestic/ FreeDigitalPhotos.net

Program Agenda
•  Task Flow Call Options
•  Region Interaction Recipes
•  Contextual Events
•  Exercises

Task Flow Communication
Bounded Task Flow Call Options
Bounded
Task Flow
Region
Task Flow
Call Activity
displayed in
navigate to
URL GET
Request navigate to

Call Activity
Task Flow
Task Flow
Call Activity navigate to
provision
Input Parameter
Input Parameter
Input Parameter

Call Activity
Task Flow
Task Flow
Call Activity return control to
process
Return Value
Return Value
Return Activity

ADF Region
Shared Data Control
Task Flow
provision
Input Parameter
Input Parameter
Input Parameter
RegionParent
View
Task Flow
Binding
refresh
Parent View
PageDef
get RegionModel

9 Copyright © 2012, Oracle and/or its affiliates. All rights reserved.9 Copyright © 2012, Oracle and/or its affiliates. All rights reserved. Insert Information Protection Policy Classification from Slide 8
But where is the return value in ADF
regions?
Exercise
Image: imagerymajestic/ FreeDigitalPhotos.net

Program Agenda
•  Exercises

Example
Region 1
Region 2

Region Interaction
•  Shared Data Control
•  Input Parameters
–  Parameter changes
–  JavaBean instance references
•  ADF Region events
•  Contextual events
Establishing Communication

Secret of Oracle ADF Rockstar Programmers
Often there is no single solution to a problem.
Use case matters.

Parent-to-Region
•  Master-detail synchronization between parent view and content
shown in region
•  Parent view passing data to child region for further processing
–  Embedded wizard use case
•  Parent view triggering navigation in region
–  Generic CRUD flow
–  Content switcher to display different views for a set of data
Usecase

Region-to-Parent
•  Region to return value to parent view at end of task flow processing
–  Region "exit" use case
•  Region method call to call behavior on parent view
–  Dynamic Tab Shell Template use case
•  Navigate parent view in response to region change
•  Change dynamic task flow configuration from region
Usecase

Region-to-Region
•  Master-Detail behavior
•  Region causing navigation in another
•  Data passing
Usecase

Program Agenda
–  Shared Data Control
–  Input Parameter
–  Region Events
–  Other
•  Exercises

Parent-to-Region
Master-Detail Behavior – Shared DC
Task Flow
af:region
Parent View
View
<file>.jsff
NextPrevious Administration
PPR
1.
4.

Parent-to-Region
Task Flow
af:region
Parent View
View
<file>.jsff
<file>PageDef.xml
dependentEmployees
Iterator
<file>PageDef.xml
allDepartmentsIterator
change row currency
PPR
1.
2.
4.

Parent-to-Region
Task Flow
af:region
Parent View
View
<file>.jsff
<file>PageDef.xml
dependentEmployees
Iterator
<file>PageDef.xml
change row currency
change row
currency
PPR
update
1.
2.
3.
4.

Parent-to-Region
Master-Detail Behavior – Isolated DC
Task Flow
af:region
Parent View
View
<file>.jsff
PPR
1.
4.

Parent-to-Region
Master-Detail Behavior – Isolated DC
Task Flow
af:region
Parent View
View
<file>.jsff
<file>PageDef.xml
dependentEmployees
Iterator
Data Control Layer
<file>PageDef.xml
change row currency
PPR
Data Control Layer
taskFlowBinding
DepartmentName
detect change
parameter
value
Input Parameter
query
1.
2.
3.
4.

Program Agenda
–  Other
•  Exercises

Parent-to-Region
Common Usecase: Navigate to Specific View in Region
Task Flow
af:region
Input Parameter
Parent Flow
control flow case 1
control flow case 2 view1
view2
view3
view3
Show View 3
On Click
PPR

Region-to-Parent
Bean Reference Injection
Bounded Task Flow
af:region
Input Parameter
Insert References to Parent View API
Managed
Bean
Parent Task Flow
(unbounded or bounded)
#{viewScope.ManagedBean}
Managed
Bean
invokes method
on caller
reference saved in

Region-to-Parent: Chaperone in Action
Usecase: Self closing regions in tabs
Bounded Task Flow
af:region
Managed
Bean
Parent View
Dynamic Tab Shell
Managed Bean
View Scope
Input Parameter
View1 View2 Return
Activity
Method
Activity

Bounded Task Flow
af:region
Managed
Bean
Parent View
Dynamic Tab Shell
Managed Bean
View Scope
View1 View2 Return
Activity
Method
Activity
Invoke method on

Bounded Task Flow
af:region
Managed
Bean
Parent View
Dynamic Tab Shell
Managed Bean
View Scope
View1 View2 Return
Activity
Method
Activity
Invoke method on
close tab

Program Agenda
–  Other
•  Exercises

Region-to-Parent
Navigate Parent View : RegionNavigationListener
af:region
Shopping Cart View Checkout View
checkOut
Task Flow
View1 View2 Return
Activity
"view1" "view2" null

Region-to-Parent
af:region
checkOut
Task Flow
View1 View2 Return
Activity
?

Region-to-Parent
af:region
checkOut
Task Flow
View1 View2 Return
Activity
RegionNavigation
Listener
If(viewId == null){
//navigate to
//checkout
}
Managed
Bean

Secret of Oracle ADF Rockstar Programmers
The Region Navigation Listener listens for what
happens in a region not for what happens to a
region

Parent-to-Region
•  Method of the af:region component
–  RichRegion
•  Invokes an ActionEvent as if it was queued from a command
component inside a region
–  Does not require the ADF region to refresh
–  Used for navigating between activities
•  Control flow cases are discoverable
Navigate Region: queueActionEventInRegion

Parent-to-Region
•  Region capabilities are used by a page to identify the available
navigation cases for a view displayed in a region
Determine Region Capabilities in EL
#{bindings.[regionId].regionModel.capabilities['outcome']}

Parent-to-Region
•  Determine Region Capabilities in Java
//backing bean with region component binding
RichRegion region = this.getEmpRegion();
RegionModel model = region.getRegionModel();
Set<String> capabilities = model.getCapabilities();
...

Parent-to-Region
Navigate Region: QueueActionEventInRegion
af:region
Parent View
Task Flow
View2
View3
View4 View5
toView2
toView5
View1
Managed Bean
Handle Navigation
RichRegion region = ...
region.queueActionEventInRegion(...)
Press to Navigate
toView1

Program Agenda
–  Other
•  Exercises

Region-to-Parent
Navigate Parent View : Parent Activity
af:region
Shopping Cart View
CheckoutView
checkout
Task Flow
View1 View2 FailView
Task Flow
checkoutCallFailed

Region-to-Parent
af:region
Shopping Cart View
CheckoutView
checkout
Task Flow
Task Flow
checkoutCallFailed

Program Agenda
–  Other
•  Exercises

About Contextual Events
•  Mechanism on the ADF binding layer for creating loosely coupled
publish and subscribe event models
•  Events may carry a data payload
–  Payload does not have to be a single simple scalar type but can be a
complex object
•  Require fragment based task flows embedded within page regions
•  Task flows with event producer and consumers can be saved in ADF
libraries

Contextual Events #1
Parent View
ParentViewPageDef
View Port View Port
Region 1 Region 2
ViewPageDef ViewPageDef
1
2
Event Map
Raise Event

Parent View
ParentViewPageDef
View Port View Port
Region 1 Region 2
2
1
Event Map
Raise Event

Parent View
ParentViewPageDef
View Port View Port
Region 1 Region 2
Region 3
View
Port
1
23
Event Map
Raise Event

Contextual Events
•  Discoverability
–  Event producer and event receiver
•  Documentation
•  Event payload
–  What type of object is it?
–  What is in a payload?
•  Developer "skill-up"
Challenges

Program Agenda
–  Other
•  Exercises

Exercise #1
•  The corporate architecture board is asked to suggest a solution for
implementing master-detail behavior between two regions
•  The application requirement is to coodinate the content displayed in
the region such that one shows customer information and the other
the selected customer's orders
•  Further the requirement is that the view shows the master-detail
behavior upon its initial rendering
•  Changing the customer displayed in the parent (customer) region
should immediately show the associated orders is response
Parent-Child Relationship Between Regions

Exercise #1
Parent-Child Relationship Between Regions
Parent View
Customer View Customer - Orders View

Exercise #2
•  The requirement is for a task flow in a region to be able to hide /
show components in the parent view
•  The use case that needs to be implemented is to conditionally hide /
show (default) a panel accordion
Help the Team

Exercise #2
Hide/Show Components From a Region
Parent View
RegionCustomer
Orders
Pending Shipments
Payments
Conditionally
Hide&Show
Accordion
Questions?

Conclusion
•  Keep it simple! Contextual events is powerful but not
needed in many cases
•  Don't make any assumption in a task flow about the environment the
task flow executes in and how it is called
•  Document task flow requirements for input parameters and return
values
•  Use task flow templates

Further Reading
•  ADF Region Interaction Functional Pattern
–  http://www.oracle.com/technetwork/developer-tools/adf/adfregioninteraction-155145.html
•  Contextual Events Introduction
–  http://www.oracle.com/technetwork/issue-archive/2011/11-may/o31adf-352561.html
•  Contextual Events: Callback pattern
–  http://www.oracle.com/technetwork/developer-tools/adf/learnmore/
regionpayloadcallbackpattern-1865094.pdf
•  Master- commander: reusable contextual event solution
–  http://www.oracle.com/technetwork/issue-archive/2012/12-nov/o62adf-1867716.html
•  Parent view initializing region navigation
–  http://www.oracle.com/technetwork/developer-tools/adf/learnmore/
externaltrainnavigationpattern-1845645.pdf

Oracle ADF Architecture TV - Design - Task Flow Communication Pattern

Empfohlen

Empfohlen

Weitere ähnliche Inhalte

Was ist angesagt?

Was ist angesagt? (20)

Andere mochten auch

Andere mochten auch (8)

Ähnlich wie Oracle ADF Architecture TV - Design - Task Flow Communication Pattern

Ähnlich wie Oracle ADF Architecture TV - Design - Task Flow Communication Pattern (20)

Kürzlich hochgeladen

Kürzlich hochgeladen (20)

Oracle ADF Architecture TV - Design - Task Flow Communication Pattern