Segment #10 Java Embedding

Size: px

Start display at page:

Download "Segment #10 Java Embedding"

Barrie Sutton
6 years ago
Views:

1 Segment #10 Java Embedding

Problem/Use Case I have a Customer Entity Bean that allows me to retrieve a SSN based on an email id.

2 Problem/Use Case I have a Customer Entity Bean that allows me to retrieve a SSN based on an id. How can I invoke that bean from within my BPEL process? BPEL call A BPEL process Customer Entity Bean BPEL PM Training - Slide 109

3 BPEL Concepts BPEL/Java Integration There are 3 solutions to this problem: Wrapping the Java component into a full blown web service using JDeveloper or Axis Using the WSIF Java Binding Using the Java BPEL exec extension (<bpelx:exec>) BPEL PM Training - Slide 110

4 BPEL Concepts <bpelx:exec> <bpelx:exec> 1. BPEL Extension which allows developers to embed a snippet of Java code within a BPEL process 2. When the <bpelx:exec> is reached, the server executes the snippet of Java code (within its JTA transaction context) 3. A set of built-in methods allow developers to read and update scope variables, instance metadata and audit trail 4. XML Façade can be used to simplify DOM manipulation 5. Java exceptions are converted into BPEL faults and bubbled into BPEL process 6. The snippet can propagate its JTA transaction to session and entity beans that it calls BPEL PM Training - Slide 111

5 BPEL Concepts <bpelx:exec> Source Code <bpelx:exec allows you to embed a Java snippet within a BPEL process Use getvariabledata built-in method to access scope variables. Use XML Façade to simplify DOM manipulation. Look up entity bean. Log SSN to audit trail of this instance Catch and log any potential exceptions BPEL PM Training - Slide 112

6 BPEL Concepts <bpelx:exec> Built-in Methods Object lookup( String name ) // JNDI access Locator getlocator( ) // BPEL PM Locator long getinstanceid( ) // Unique id associated with each instance String settitle( String title ) / String gettitle() // Title of this instance String setstatus( String status ) / String getstatus() // Status of this instance void setindex( int i, String value ) / String getindex( int i ) // 6 indexes can be used for search void setpriority( int priority ) / int getpriority() // Priority void setcreator( String creator ) / String getcreator() // Who initiated this instance? void setcustomkey( String customkey ) / String getcustomkey() // Second primary key void setmetadata( String metadata ) / String getmetadata () // Metadata for generating lists String getpreference( String key ) // Access preference defined in bpel.xml void addaudittrailentry(string message, Object detail) // Add entry to audit trail void addaudittrailentry(throwable t) // Add exception to audit trail File getcontentfile( String rpath ) // Access file stored in suitcase Object getvariabledata(string name) throws BPELFault // Access and update variables stored in scope Object getvariabledata(string name, String partorquery) throws BPELFault Object getvariabledata(string name, String part, String query) void setvariabledata(string name, Object value) void setvariabledata(string name, String part, Object value) void setvariabledata(string name, String part, String query, Object value) BPEL PM Training - Slide 113

7 BPEL Designer Adding a Java <exec> Activity Drag and drop from palette. Use BPEL source view to edit BPEL PM Training - Slide 114

8 BPEL Console Deploy And Test BPEL PM Training - Slide 115

9 Lab Exercise Lab 10: Java Embedding 1. Add a Java <bpelx:exec> activity to your process to use Java to do some basic validation on the address in the loan application document. Extra Credit: Embed your functionality within a Java class and compile that Java class and include it in a BPEL-INF\classes directory in your BPEL project BPEL PM Training - Slide 116

10 What Did We Learn? There are 3 ways to integrate an existing Java component into a BPEL process: 1) wrapping that component in a SOAP service, 2) using a binding framework such as WSIF or 3) inline a code snippet using <bpelx:exec> The <bpelx:exec> snippet is executed within the transaction context of the BPEL server. You can propagate that transaction to your own session and entity beans A set of built-in methods allow the <bpelx:exec> snippet to read and update variables, change instance metadata and throw faults XML Façade can be used within a snippet to simplify DOM manipulation BPEL PM Training - Slide 117

11 Related Material WSIF Java Binding Transaction propagation and crash testing Using the BPEL-INF/lib and classes to package your Java library dependencies into the BPEL suitcase deployment unit BPEL PM Training - Slide 118

Segment #7 User Task

Segment #7 User Task Problem/Use Case How do I integrate a user review step within a BPEL process? I would like that step to be implemented by a custom web application that displays the StockReviewSheet