OSB - JCA AQ Transport Tutorial

8/12/2019 OSB - JCA AQ Transport Tutorial

1/72

Oracle Service Bus (OSB) 10.3.1 JCATransport with AQ Aapter Tutorial

Oracle Corporation - Proprietary

Use pursuant toHREF="http://lcsun2/release_center/engprocess/CompanyUsageInstructions.htm

!CR#U$$% HtmlRes!nchor Company &ocument Usage Instructions

A!stract"

$his 'ocument 'escri(es the steps )or using the *C! !+ !'apter ,ith -# gR0

Prepared By

Steven Pozarycki

Principal Sales Consultant

#a$e 1

Oracle Corporation - PROPRIETARYUse pursuant to Company Instructions


2/72

1age 2 o) 0

NATO SOA/BPM - Technical Services roup

#a$e %



3/72

1age 0 o) 0

. Intro'uction................................................................................................................................. 3

2. -o)t,are Re4uirements............................................................................................................. 5

0. 1re6re4uisites..............................................................................................................................7

3. High le8el -teps.......................................................................................................................... 9

5. Use Case !+ #usiness -er8ice..........................................................................................

5. -tep ;enerate y -er8ice to 'e4ueue messages )rom !+..............................................7

7.2. Implement pro>y ser8ice?s message )lo,....................................................................73

7.0 $est the o8erall ) lo, En4ueue an' &e4ueue )rom !+ 8ia -#.........................................79

#a$e 3 10&1'&01

Oracle Corporation - PROPRIETARY

Use pursuant to Company Instructions


4/72

1age 3 o) 0

1. ntrouction$his 'ocument pro8i'es step (y step instructions )or creating an racle -er8ice #us @-#Acon)iguration to up'ate an' retrie8e 'ata resi'ing in an racle !'8ance' +ueue @!+A.

In the )irst use case -# #usiness -er8iceB ,ith *C! @!+A transport protocolB 'oes an en4ueueo) a message to racle !'8ance' +ueue @!+A. -# acts as a pro>y (et,een the client thatnee's to per)orm this operation an' the !+. Client in8oes the pro>y ser8iceB ,hich uses RouteB-er8ice CalloutB or 1u(lish to in8oe the *C! (usiness ser8ice.

In the secon' use case -# 1ro>y -er8iceB ,ith *C! @!+A transport protocolB ,hen a messageis put onto a 'e)ine' !+ 4ueue the -# 1ro>y -er8ice ,ill pull that message o)) the 4ueue.HenceB -# acts as a pro>y (et,een !+ an' the (acen' ser8ice that inten's to recei8e themessage )rom the !+.

#a$e


*n+ueue a,essa$e to AQ

(an-) #ro-Service

JCA AQBusinessService

AQ inOracle/ata!ase

Client

OSB

/e+ueuea

,essa$ero, AQ

JCA AQ#ro-Service

(an-)BusinessService

AQ inOracle/ata!ase

BacenService

OSB


5/72

1age 5 o) 0

%. Sotware 2e+uire,ents inimum o) racle &ata(ase E>press E'ition g @racle DEA

-# gR0 1 @.0.A

*&e8eloper ..0.>

#a$e ' 10&1'&01




6/72

1age 7 o) 0

3. #rere+uisites. !ll re4uire' so)t,are installe'

2. -etup the !+ con)iguration ,ithin an oracle &ata(ase. $he )ollo,ing is sample -+

,hich can (e run to achie8e this:

Con)igure an !+ user account. Connect as a user ,ith sys pri8ileges to e>ecute the)ollo,ing -+ statements:

CONNECT sys/change_on_install as sysdba

DROP USER aq_user CASCADE

CREATE USER aq_user !DENT!"!ED #$ aq_user DE"AU%T TA#%ESPACE users TE&PORAR$ TA#%ESPACE te'(

A%TER USER aq_user )UOTA UN%!&!TED ON users

*RANT aq_ad'inistrator_role TO aq_user*RANT connect TO aq_user*RANT create ty(e TO aq_user*RANT create sequence TO aq_user

E+ECUTE db's_aqad',grant_ty(e_access-.aq_user.

Create the content or the payloa' o) the message. $he )ollo,ing steps must (e e>ecute'as the user create' in the )irst step. In this case it ,oul' (e the a4_user user.

$he )ollo,ing type o) message_type is a sample o) ,hat the payloa' coul' (e.

CONNECT aq_user/aq_user

CREATE T$PE 'essage_ty(e AS O#0ECT - 'essage_id NUER-12 3 sub4ect 5ARC6AR7-188 3 te9t 5ARC6AR7-188 3 dollar_value NUMBER(4,2)/

Finally create the +ueue $a(le an' +ueue as the user create' in the )irst step. In thiscase it ,oul' (e the a4_user user.

#a$e 4



7/72

1age o) 0


#E*!N

:: ::::::::::::::::::::::::::::::::::::::::::::::::::::

D#&S_A)AD&,CREATE_)UEUE_TA#%E - queue_table ;< .aq_user,'sg_qt. 3 queue_(ayload_ty(e ;< .aq_user,'essage_ty(e.

:: ::::::::::::::::::::::::::::::::::::::::::::::::::::

D#&S_A)AD&,CREATE_)UEUE - queue_na'e ;< .'sg_queue. 3 queue_table ;< .aq_user,'sg_qt. 3 queue_ty(e ;< D#&S_A)AD&,NOR&A%_)UEUE 3 'a9_retries ;< 8 3 retry_delay ;< 8

3 retention_ti'e ;< 178=>88 3 de(endency_trac?ing ;< "A%SE 3 co''ent ;< .Test Ob4ect Ty(e )ueue. 3 auto_co''it ;< "A%SE

:: ::::::::::::::::::::::::::::::::::::::::::::::::::::

D#&S_A)AD&,START_)UEUE-.'sg_queue.

:: ::::::::::::::::::::::::::::::::::::::::::::::::::::

END

/

5OT*"$he )ollo,ing is the -+ nee'e' to clean up the 'ata(ase ,ith thea(o8e create' !+ arti)acts. $his is %G nee'e' i) you ,ish to clean up.

-top an' 'rop the +ueue an' +ueue $a(le as the user create' in the )irst step.In this case it ,oul' (e the a4_user user.


E+ECUTE db's_aqad',sto(_queue-queue_na'e ;ecute the )ollo,ing -+ statement to'rop the user originally create' in step :

CONNECT sys/change_on_install as sysdba

DROP USER aq_user CASCADE

0. &ocument assumes some le8el o) )amiliarity ,ith:

a. Installing racle DE 'ata(aseB -#B *&e8eloper(. Creating ta(les using racle DE 'ata(ase.c. Using -# pro>y an' (usiness ser8icesB 'eploymentB an' testing'. Using *&e8eloper to create proectsB an' !+ !'apter instances

#a$e 7



9/72

1age 9 o) 0

. 8i$h level Steps9se case 1 !+Business Service enqueueing messages on behal o the client. -peci)icallyBthe !+ #usiness -er8ice ,e implement ,ill insert messages into the !+ 4ueue.

. ;enerate


10/72

1age o) 0

'. 9se Case 1 AQ Business Service

'.1 Step 1 ;enerate


11/72


12/72

1age 2 o) 0

#a$e 1%



13/72

1age 0 o) 0

0. Create !+ !'aptera. -elect 1roect 6JRight Clic 6J%e, 6J#usiness $ier 6J


14/72

1age 3 o) 0

#a$e 1



15/72

1age 5 o) 0

3. -tep o) 0 6 -er8ice %ame:AQEnqee

#a$e 1' 10&1'&01




16/72

1age 7 o) 0

5. -tep 2 o) 0 -er8ice Connection

a. Clic %e, to create a ne, connection @or pic a connection i) one alrea'y e>istsA Create &ata(ase Connection ,iLar' comes up

i. -tep o) 3 @$ypeA

. Connection %ame: DbConnection!

2. Connection $ype: racle *C

#a$e 14



17/72

1age o) 0

ii. -tep 2 o) 3 @!uthenticationA pro8i'e &ata(ase username/pass,'

. Username: aq"#er

2. 1ass,or': aq"#er

#a$e 16 10&1'&01




18/72

1age o) 0

iii. -tep 0 o) 3 @ConnectionA pro8i'e &ata(ase connection in)ormation

. &ri8er: thin

2. Hostname: localhost

0. *C 1ort: 52

3. -I&:$E

#a$e 17



19/72


20/72

1age 2 o) 0

c. *%&I %ame: ei#%AQ%D&Connection!@5OT*" Remem(er this *%&I %ame asyou ,ill re4uire it ,hen con)iguring manage' connection )actory in selection is chece'.

7. -tep 0 o) 3: peration $ype

a. -elect Enqee: an' lea8e the 'e)ault operation name.

#a$e %0



21/72

1age 2 o) 0

. -tep 3 o) 3: +ueue %ame

a. Clic on #ro,se to select the -chema an' the +ueue %ame. ne ,ill select theuser an' +ueue name create' in the -+ scripts at the (eginning o) this tutorial:

#a$e %1 10&1'&01




22/72

1age 22 o) 0

. -tep 5 o) 7: +ueue 1arameters

ea8e this selection as (lan )or no,.

#a$e %%



23/72

1age 20 o) 0

9. -tep 7 o) 7: (ect 1ayloa'

-elect


24/72

1age 23 o) 0

.


25/72


26/72

1age 27 o) 0

0. Create a ne, 1roect name' !+ 1roectB clic the !'' 1roect (utton an' then clicon the 1roect name ,hen it is create'. ne is no, in the !+ 1roect )ol'er ,here ,e,ill a'' the arti)acts @y -er8icesB an' #usiness -er8icesA.

3. -elect the Create Resource 'rop6'o,n menu an' -elect


27/72


28/72

1age 2 o) 0

#a$e %7



29/72


30/72

1age 0 o) 0

. nce that is 'oneB one shoul' see the )ollo,ing ,ith green icons:

. %e>t ,e ,ill con)igure the (usiness ser8ice to use the !+ En4ueue


31/72

1age 0 o) 0

e. Clic %e>t an' mae sure the URI is the *%&I name create' earlier ,ithin*&e8eloper @ca://eis/!+/Connection2A.

). Clic %e>t an' mae sure %on anage' is selecte' as the Connection o'e.$his ,ill ena(le one to test the setup 4uicly. ater on ,e ,ill change this toanage' an' con)igure the settings ,ithin


32/72

1age 02 o) 0

g. Clic %e>t an' then -a8e.

h. 1$I%!G: ne can optionally create a 1ro>y -er8ice (ase' on this#usiness -er8ice. $he 1ro>y -er8ice ,oul' (e the en'point e>pose' toe>ternal users o) -# @either 8ia H$$1 or some other protocol o) one?s choiceAan' ,ill route to the #usiness -er8ice ,e?8e ust create'.

i. Clic on the green !cti8ate (utton an' su(mit (utton to sa8e all changes.

#a$e 3%



33/72

1age 00 o) 0

'.3 Step 3 Test OSB Business Service with 5on>ana$e connection ,oe

. I) -# is not alrea'y starte'B start


34/72

1age 03 o) 0

?i$ure 3" Test console 2e+uest

#a$e 3



35/72


36/72

1age 07 o) 0

?i$ure '" 2ow inserte in the Queue Ta!le

#e)ore ,e mo8e to the ne>t step to test the (usiness ser8ice in anage' mo'e ,e must createthe &ata -ource an' the Connection Factory using


37/72

1age 0 o) 0

?i$ure '"


38/72

1age 0 o) 0

3. $ransaction ptionsB clic %e>t

5. &e)ine connection properties6JClic %e>t

#a$e 37



39/72

1age 09 o) 0

7. Clic test con)iguration

. Gou U-$ see connection test succee'e'. Clic %e>t

#a$e 3: 10&1'&01




40/72


41/72

1age 3 o) 0

2. Clic CustomiLe this ta(leB then on the right set the num(er o) ro,s 'isplaye' to .Clic !pply.

0. -croll 'o,n to !+!'apter. Clic on !+!'apter

3. Create %e, Connection Factory

a. Clic on Con)iguration ta(B )ollo,e' (y ut(oun' Connection 1ools ta(

(. -elect a8a>.resource.cci.ConnectionFactory an' Clic %e,

#a$e 1 10&1'&01




42/72

1age 32 o) 0

5. -elect a8a>.resource.cci.ConnectionFactory an' clic %e>t

7. -peci)y the *%&I %ame )or out(oun' connection instance. %e>tB clic Finish

5OT*: $he *ND+ Na,ehere >9STmatch the *%&I %ame speci)ie' in *&e8eloper. $he

*%&I %ame speci)ie' in *&e8eloper also (ecomes the *npoint 92o) the (usiness ser8ice@eis/!+/Connection2A. -ee -tep 5c in QCon)iguring !+ !'apter in *&e8eloper? an' -tepe in QCreating (usiness ser8ice in -#?.

#a$e %



43/72

1age 30 o) 0

. Gou see the )ollo,ing messages.

5OT*: $,o important steps: oneB up'ate the 'eployment plan ,ith the changes an' t,o up'atethe 'eployment ,ith the 'eployment plan @-ee -tep 9 )or up'ating 'eployment ,ith the'eployment planA.

I) you ha8en?t yet create' a 'eployment plan )or the !+ Resource !'apter you ,ill (e ase' to

create one. In this caseB you U-$ create the 'eployment plan an' then sa8e the changes tothe 'eployment plan. ne ,ill ha8e to create a )ile calle' 1lan.>ml )or this to sho, up in the


44/72

1age 33 o) 0

. %a8igate to the !+ !'apterCon)igurationut(oun' Connection 1ools to see thene,ly create' Connection Factory.

9. Up'ate connection )actory?s &ata -ource property

a. -elect the connection you ust create' (y clicing it @eis/!+/Connection2A.Gou ,ill see the )ollo,ing page

#a$e



45/72

1age 35 o) 0

(. Clic in the 1roperty Oalue cell )oraDataSorceNa,eB type the *%&I %ame o)the &ata -ource @(#/BA in the te>t )iel' that appearsB an' then press E%$ER.

5OT*: Hitting E%$ER a)ter typing the 'ata source name is critical. ther,iseB the 8alue ,ill%$ (e sa8e'. $a( ,ill %$ ,or either. !)ter hitting enterB also clic -!OE as this iscriticalas ,ell.

5OT*: $he *%&I %ame o) the &ata -ource is the *%&I %ame speci)ie' in -tep 0 o) the sectionon Creating a &ata -ource.

c. -electaDataSorceNa,e @(y clicing on the Chec (o> on the le)tA an' clic-a8e. Gou ,ill again see the messages to up'ate the 'eployment ,ith thecontent sa8e' in the 'eployment plan.

5OT*: In some casesB sa8ing changes to the 'eployment plan might generate errors. *ustignore the errorsS

. Up'ating 'eployment ,ith the 'eployment plan

a. Clic on &eployments @on the le)t si'eA un'er &omain -tructure

(. -elect the !+!'apter (y clicing on the chec (o> on the )irst column )or the!+#!'apter ro,

c. Clic Up'ate.

#a$e ' 10&1'&01




46/72

1age 37 o) 0

'. Gou ,ill see the )ollo,ing page. ea8e the 'e)ault @Re'eploy application using)ollo,ing 'eployment plansA. Clic %e>t an' then Clic FI%I-H

#a$e 4



47/72

1age 3 o) 0

5OT*: I) you encounter an error (y choosing the secon' option. 1lease select the )irst option@Up'ate this application in placeTA an' then clic %e>t.

e. Gou ,ill see the )ollo,ing message. Gou are no, 'one ,ith con)iguring an'up'ating the !+!'apter connection )actory along ,ith the &ata -ource

. ogout o) ana$econnection ,oe

. Complete steps in -ection 5.3to con)igure &ata -ource an' !+ !'apter ConnectionFactory.

2. In the -#


48/72

1age 3 o) 0

0. -et the Connection o'e *C! $ransport speci)ic property to anage'B clic on theast #utton an' then clic on the su(se4uent -a8e (utton.

#a$e 7



49/72

1age 39 o) 0

3. Clic on the green !cti8ate (utton in the upper le)t an' then clic on the -u(mit(utton.

7. Clic on the green 'e(ugger icon to the right o) the !+ #usiness -er8ice.

#a$e : 10&1'&01




50/72

1age 5 o) 0

. Up'ate the automatically generate' payloa' )or the N&!R_O!UEJ )iel' an' enter9.99 @,ithout the 'ou(le 4uotesA an' clic on the E>ecute (utton.

#a$e '0



51/72

1age 5 o) 0


#a$e '1 10&1'&01




52/72

1age 52 o) 0

?i$ure 6" Test console 2esponse

. oo at the 'ata(ase to see the message inserte' into the +ueue $a(le create' earlier@In the 'iagram (elo, there happens to (e t,o messages en4ueue' )rom t,o separateen4ueue operationsA. %$E: I) there is an e>ception ,hen running the testB mae sure

the 1lan.>ml ,as up'ate' ,ith the 8alue o) the 'atasource y )or the>a&ata-ource%ame in the !+ Connection Factory.

#a$e '%



53/72


54/72

1age 53 o) 0

4. 9se Case % AQ #ro- Service

4.1 ;enerate


55/72

1age 55 o) 0

3. -tep o) 2 6 -er8ice %ame:AQDeqee

5. -tep 2 o) 0 -er8ice Connection. I) ser8ice connection alrea'y e>ists @see -ection 5.Asimply select the ser8ice connection @DbConnection!AB mae a note o) the *%&I %ame

@,hich is the same as (e)ore an' this is )ine )or this con)igurationei#%AQ%D&Connection!.an' clic %e>t.

#a$e '' 10&1'&01




56/72

1age 57 o) 0

7. -tep 0 o) 3: peration:

a. -elect Deqeean' clic %e>t

#a$e '4



57/72


58/72

1age 5 o) 0

2. -tep 5 o) 7: +ueue 1arameters

ea8e this selection as (lan )or no,.

#a$e '7



59/72

1age 59 o) 0

0. -tep 7 o) 7: (ect 1ayloa'

-elect t an' then lic Finish

#a$e ': 10&1'&01




60/72

1age 7 o) 0

3.


61/72

1age 7 o) 0

4.% Create OSB #ro- Service to e+ueue ,essa$esro, AQ

. ogin to the -# Console at: http://localhost:/s(console,ith the cre'entialsspeci)ie' ,hen creating this 'omain.

2. Clic on the 1roect E>plorer on the le)t6han' si'e an' select the 1roect create'earlier.

0. ne is no, in the !+ 1roect )ol'er an' optionally in the &e4ueue )ol'er ,here ,e,ill a'' the arti)acts @


62/72

1age 72 o) 0

9. Con)igure pro>y ser8ice

a. From the Create Resource 'rop 'o,nB select 1ro>y -er8ice

(. Fill in the -er8ice %ame ,ith a name o) one?s choosing.

c. -elect the


63/72

1age 70 o) 0

'. Clic %e>t t,ice an' on the )ollo,ing screen notice that Connection o'e isanage'. -ince this has alrea'y (een con)igure' in the


64/72

1age 73 o) 0

). Clic -a8e.

7.2. Implement pro>y ser8ice?s message )lo,

et?s create a 8ery simple message )lo, to log the re4uest recei8e' (y the pro>y ser8ice. In thiscaseB the recor's pice' (y the !+ In(oun' pro>y ser8ice ,ill (e logge' to the ser8er console.

. Clic on the essage Flo, icon ne>t to the 1ro>y -er8ice ust create'.

#a$e 4



65/72

1age 75 o) 0

2. n the ne>t screenB e)t clic on the 1ro>y -er8ice name an' select !'' 1ipeline 1air

#a$e 4' 10&1'&01




66/72

1age 77 o) 0

0. e)t clic on the Re4uest pipeline an' a'' a -tage no'e.

3. e)t clic on stage an' select E'it -tage

5. e)t clic on !'' an !ctionB Reporting an' then clic on og action.

7. In the log action logB clic on the E>pression hyperlin an' enter (o'y @,ithout the

'ou(le 4uotesA. ea8e the se8erity le8el as &e(ug an' clic -a8e !ll.

#a$e 44



67/72

1age 7 o) 0

. Clic on the green !cti8ate (utton an' su(mit (utton to sa8e all changes.

5OT*: ae sure logging is turne' on at /e!u$le8el )rom the t section @7.2..A.

4.%.1.1 Settin$ =o$ level to /e!u$ ro,


68/72


69/72

1age 79 o) 0

4.3 Test the overall low *n+ueue an /e+ueue ro,AQ via OSB

$he )ollo,ing tests the o8erall )lo, o) the -# #usiness -er8ice en4ueueing a message to!+B the -# 1ro>y -er8ice 'e4ueueing a message )rom !+ an' logging a message to thest'out o) the running


70/72

1age o) 0


#a$e 60



71/72

1age o) 0

?i$ure " Test console 2esponse

5. oo at the log )ile or the st'out in)ormation logge' to the screen ,here -# ,asstarte'. ne ,ill see the payloa' printe' out )rom the -# &e4ueue 1ro>y -er8ice righta)ter the -# En4ueue -er8ice ,as e>ecute':

NFe( 3B 2 0:2:2 1 E-$J N&e(ugJ N!-# oggingJ N#E!6J NV1ipeline1air%o'eB 1ipeline1air%o'e_re4uestB stageB RE+UE-$W Nsoapen8:#o'y>mlns:soapen8="http://schemas.>mlsoap.org/soap/en8elope/"J

@a+">*SSA;*T#* ,lns"a+Dhttp"&&,lns.oracle.co,&!&AQ9S*2DE

#a$e 61 10&1'&01




72/72

1age 2 o) 0

@>*SSA;*/E10@&>*SSA;*/E

@S9BJ*CTEstrin$@&S9BJ*CTE

@T*FTEstrin$@&T*FTE

@/O==A2GA=9*E1:.::@&/O==A2GA=9*E

@&a+">*SSA;*T#*E

@&soapenv"Bo-EE

NFe( 3B 2 0:2:2 1 E-$J NIn)oJ N*C!_FR!E

OSB - JCA AQ Transport Tutorial

Documents