OSB - JCA AQ Transport Tutorial

Oracle Service Bus (OSB) 10.3.
1 JCA
Transport with AQ Aapter Tutorial
Oracle Corporation - Proprietary
Use pursuant to
HREF="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 - PROPRIETARY
Use pursuant to Company Instructions
1age 2 o) 20
NATO SOA/BPM - Technical Services roup

#a$e %
1age 0 o) 20
.. 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 <-&= )or !+ en4ueue in *&e8eloper................................................../
5.2 -tep 2 6 Create "-# #usiness -er8ice ,ith %on6anage' Connection o'e..................25
5.0 -tep 0 6 $est "-# #usiness -er8ice ,ith %on6anage' connection mo'e......................00
5.3 <=- Console Con)iguration............................................................................................... 07
5.3.. Con)igure &ata -ource................................................................................................ 07
5.3.2 Con)igure !+ !'apter Connection Factory.................................................................3/
5.5 -tep 3 : $est "-# #usiness -er8ice ,ith anage' connection mo'e.............................32
7. Use Case 2 : !+ 1ro>y -er8ice............................................................................................... 53
7.. ;enerate <-&= )or !+ 'e4ueue operation in *&e8eloper................................................53
7.2 Create "-# 1ro>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
1age 3 o) 20
1. (ntrouction
$his 'ocument pro8i'es step (y step instructions )or creating an "racle -er8ice #us @"-#A
con)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 en4ueue
o) a message to "racle !'8ance' +ueue @!+A. "-# acts as a pro>y (et,een the client that
nee's to per)orm this operation an' the !+. Client in8oCes the pro>y ser8iceB ,hich uses RouteB
-er8ice CalloutB or 1u(lish to in8oCe the *C! (usiness ser8ice.
In the secon' use case "-# 1ro>y -er8iceB ,ith *C! @!+A transport protocolB ,hen a message
is 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 (acCen' ser8ice that inten's to recei8e the
message )rom the !+.

#a$e )
*n+ueue a
,essa$e to AQ
(an-) #ro.-
Service
JCA AQ
Business
Service
AQ in
Oracle
/ata!ase
Clie
nt
OSB
/e+ueue
a
,essa$e
0ro, AQ
JCA AQ
#ro.-
Service
(an-)
Business
Service
AQ in
Oracle
/ata!ase
Bac1en
Servic
e
OSB
1age 5 o) 20
%. So0tware 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
1age 7 o) 20
3. #re3re+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) Emessage_typeF 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 NU&#ER-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 this
case it ,oul' (e the a4_user user.

#a$e 4
1age 2 o) 20
#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 the
a(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 ;<
.aq_user,'sg_queue./
E+ECUTE db's_aqad',dro(_queue-queue_na'e ;<
.aq_user,'sg_queue./
E+ECUTE db's_aqad',dro(_queue_table-queue_table ;<
.aq_user,'sg_qt./
DROP T$PE aq_user,'essage_ty(e
#a$e 6 10&1'&01
1age H o) 20
Connect as a user ,ith sys pri8ileges to 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 proIectsB an' !+ !'apter instances

#a$e 7
1age 9 o) 20
). 8i$h level Steps
9se case 1 : !+ Business Service enqueueing messages on behal o the client. -peci)icallyB
the !+ #usiness -er8ice ,e implement ,ill insert messages into the !+ 4ueue.
.. ;enerate <-&= representing the en4ueue operation.
2. Create #usiness -er8ice in "-# to in8oCe the en4ueue operation using
a. -er8ice $ype = WSDL Web Service @using the <-&= )rom step .A
(. $ransport 1rotocol = jca
c. Connection o'e = Non-Managed
0. $est the (usiness ser8ice ,ith Connection o'e as Non-Managed @Connection o'e is
con)igure' in the *C! $ransport speci)ic propertiesA.
3. $est the (usiness ser8ice ,ith Connection o'e as Managed
5. Create 1ro>y ser8ice to e>pose to client. $his step is only )or use6case completenessB as
suchB it is not 'escri(e' in this 'ocument.
9se case % : A! Pro"# Service consuming messages rom the A! an$ propagating changes to
the bac%en$ service. -peci)icallyB the !+ 1ro>y -er8ice ,e implement recei8es the !+
message an' logs the recei8e' message to the ser8er console.
.. ;enerate <-&= representing the 'e4ueue operation
2. Create 1ro>y -er8ice in "-# to consume the !+ message
a. -er8ice $ype = <-&= <e( -er8ice @using the <-&= )rom step .A
(. $ransport 1rotocol = Ica
c. Connection o'e = Managed
'. Implement pro>y ser8ice?s message )lo,
0. &eploy the pro>y ser8ice an' test
#a$e : 10&1'&01
1age ./ o) 20
'. 9se Case 1 AQ Business Service
'.1 Step 1 ;enerate <S/= 0or AQ en+ueue in
J/eveloper
Gou can sCip this section i) you are alrea'y )amiliar ,ith creating the !+ a'apter using
*&e8eloper.
.. Create a ne, application in *&e8eloper
a. File6J%e,6J!pplication

(. %ame: AQContent

#a$e 10
1age .. o) 20
2. Create 1roIect
a. %ame: AQProject
#a$e 11 10&1'&01
1age .2 o) 20

#a$e 1%
1age .0 o) 20
0. Create !+ !'apter
a. -elect 1roIect 6JRight ClicC 6J%e, 6J#usiness $ier 6J<e( -er8ices 6J!+
!'apter6JclicC "K @!+ a'apter ,iLar' comes upA
#a$e 13 10&1'&01
1age .3 o) 20

#a$e 1)
1age .5 o) 20
3. -tep . o) 0 6 -er8ice %ame: AQEnqee
#a$e 1' 10&1'&01
1age .7 o) 20
5. -tep 2 o) 0 : -er8ice Connection
a. ClicC %e, to create a ne, connection @or picC 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
1age .2 o) 20
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
1age .H o) 20
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
1age .9 o) 20
i8. -tep 3 o) 3 @$estingA 6 ClicC $est connection
(. %o, select the &# connection Iust create'
#a$e 1: 10&1'&01
1age 2/ o) 20
c. *%&I %ame: ei#%AQ%D&Connection! @5OT*" Remem(er this *%&I %ame as
you ,ill re4uire it ,hen con)iguring manage' connection )actory in <=- Console
)or anage' connection mo'eA . !lso maCe sure that the ED! &ata -ourceF
checC(o> selection is checCe'.
7. -tep 0 o) 3: "peration $ype
a. -elect Enqee: an' lea8e the 'e)ault operation name.

#a$e %0
1age 2. o) 20
2. -tep 3 o) 3: +ueue %ame
a. ClicC on #ro,se to select the -chema an' the +ueue %ame. "ne ,ill select the
user an' +ueue name create' in the -+= scripts at the (eginning o) this tutorial:
#a$e %1 10&1'&01
1age 22 o) 20
H. -tep 5 o) 7: +ueue 1arameters
=ea8e this selection as (lanC )or no,.

#a$e %%
1age 20 o) 20
9. -tep 7 o) 7: "(Iect 1ayloa'
-elect E<hole "(Iect E--!;E_$G1EF an' clicC EFinishF
#a$e %3 10&1'&01
1age 23 o) 20
./. <hat is create' no, are the <-&=s an' D-&s re4uire' )or "racle -er8ice #us. !ll o)
these )iles ,ill (e importe' into "racle -er8ice #us:
AQEnqee'(#dl
A!&'SER&(ESSA)E&TYPE*"s$
aqA$apterOutboun$+ea$er*,s$l
aqA$apterOutboun$+ea$er*"s$
5OT*: Remem(er the )ile system location )or these )iles. "ne ,ill ha8e to (ro,se to the <-&=
an' -chema )iles ,hen creating *C! (usiness ser8ice in "-#.

#a$e %)
1age 25 o) 20
'.% Step % 3 Create OSB Business Service with 5on3
>ana$e Connection >oe
It is assume' at this point that one alrea'y has an "-# &omain con)igure' an' running. I) notB
this can (e create' ,ith the Con)iguration <iLar' at "R!C=E_H"EM
os(./gr0M,lser8er_./.0McommonM(inMcon)ig.cm'@shA )ile.
"-# can (e con)igure' either 8ia a <e( #ro,ser or 8ia Eclipse. For this e>ercise ,e ,ill
con)igure this 8ia the <e( #ro,ser.
.. =ogin to the "-# Console at: http://localhost:2//./s(console ,ith the cre'entials
speci)ie' ,hen creating this 'omain.
2. ClicC on the E1roIect E>plorerF on the le)t6han' si'e an' clicC on the ECreateF (utton to
create an e'it session:
a. -elect 1roIect6JRight clicC6J%e,6J#usiness -er8ice
#a$e %' 10&1'&01
1age 27 o) 20
0. Create a ne, 1roIect name' E!+ 1roIectFB clicC the E!'' 1roIectF (utton an' then clicC
on the 1roIect name ,hen it is create'. "ne is no, in the E!+ 1roIectF )ol'er ,here ,e
,ill a'' the arti)acts @<-&=sB -chemasB 1ro>y -er8icesB an' #usiness -er8icesA.
3. -elect the ECreate ResourceF 'rop6'o,n menu an' -elect <-&= to import the
!+En4ueue.<-&= )ile ,e create' earlier in *&e8eloper. Repeat this step )or the
a4!'apter"ut(oun'Hea'er.,s'l )ile as ,ell. %"$E: Ignore any 8ali'ation errors )or no,
as they ,ill (e resol8e' a)ter importing the -chema )iles an' mapping the re)erences.

#a$e %4
1age 22 o) 20
5. -elect the ECreate ResourceF 'rop6'o,n menu an' -elect D= -chema to import the
!+_U-ER_E--!;E_$G1E.>s' )ile ,e create' earlier in *&e8eloper. Repeat this
step )or the a4!'apter"ut(oun'Hea'er.>s' )ile as ,ell. %"$E: Ignore any 8ali'ation
errors )or no, as they ,ill (e resol8e' a)ter importing the -chema )iles an' mapping the
re)erences
7. ap the re)erences )or each <-&= (y selecting the <-&= resourceB clicC on the EE'it
Re)erencesF (utton an' then select the )iles importe' to resol8e all re)erences.
#a$e %6 10&1'&01
1age 2H o) 20

#a$e %7
1age 29 o) 20
#a$e %: 10&1'&01
1age 0/ o) 20
2. "nce that is 'oneB one shoul' see the )ollo,ing ,ith green icons:
H. %e>t ,e ,ill con)igure the (usiness ser8ice to use the !+ En4ueue <-&= ,e?8e Iust
importe'.
a. -elect the ECreate ResourceF 'rop6'o,n menu an' -elect E#usiness -er8iceF
(. ;i8e this #usiness -er8ice a name
c. ClicC on the E<-&= <e( -er8iceFB clicC (ro,se an' select the E!+ En4ueue
<-&=F ,hich ,e?8e Iust create'.
'. -elect the 1ort o) EEn4ueue_ptF an' clicC su(mit.

#a$e 30
1age 0. o) 20
e. ClicC E%e>tF an' maCe sure the URI is the *%&I name create' earlier ,ithin
*&e8eloper @Ica://eis/!+/&#Connection2A.
). ClicC %e>t an' maCe sure E%on anage'F is selecte' as the Connection o'e.
$his ,ill ena(le one to test the setup 4uicCly. =ater on ,e ,ill change this to
Eanage'F an' con)igure the settings ,ithin <e(=ogic -er8er itsel).
#a$e 31 10&1'&01
1age 02 o) 20
g. ClicC %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' to
e>ternal users o) "-# @either 8ia H$$1 or some other protocol o) one?s choiceA
an' ,ill route to the #usiness -er8ice ,e?8e Iust create'.
i. ClicC on the green E!cti8ateF (utton an' su(mit (utton to sa8e all changes.

#a$e 3%
1age 00 o) 20
'.3 Step 3 3 Test OSB Business Service with 5on3
>ana$e connection ,oe
.. I) "-# is not alrea'y starte'B start <e(logic ser8er )or "-#
2. =ogin to the "-# Console at: http://localhost:2//./s(console ,ith the cre'entials
0. ClicC on the green E'e(uggerF icon to the right o) the E!+ #usiness -er8iceF.
3. Up'ate the automatically generate' payloa' )or the N&"==!R_O!=UEJ )iel' an' enter
E.9.99F @,ithout the 'ou(le 4uotesA an' clicC on the E>ecute (utton.
#a$e 33 10&1'&01
1age 03 o) 20
?i$ure 3" Test console 3 2e+uest

#a$e 3)
1age 05 o) 20
?i$ure )" Test console 3 2esponse
5. =ooC 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 separate
en4ueue operationsA:
#a$e 3' 10&1'&01
1age 07 o) 20
?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 create
the &ata -ource an' the Connection Factory using <=- Console.
'.) <=S Console Con0i$uration
In the pre8ious sectionB you use' the Connection o'e as %on6anage' to 4uicCly test the
(usiness ser8ice. In the %on6anage' mo'eB connection in)ormation in the <-&= is use'.
In pro'uctionB it is recommen'e' to use the anage' Connection o'e. In the anage' mo'eB
connection in)ormation )rom the connection )actory 'e)ine' in <=- is use'. En'point URI o) the
(usiness ser8ice is the *%&I %ame o) the connection )actory 'e)ine' in <=-.
$his section pro8i'es step (y step in)ormation on con)iguring the Data Sorce an' the
Connection )actory using <=- Console.
5.3.. Con)igure &ata -ource
.. In <=- Console Home 1ageB clicC on *&#C 6J &ata -ources

#a$e 34
1age 02 o) 20
?i$ure '" <=S Console 8o,e #a$e
2. ClicC %e, to create a ne, &ata -ource
?i$ure 4" J/BC /ata Source Creation
0. Con)igure *&#C properties )or the 'ata source
a. %ame: y&#
(. *%&I %ame: y&#
c. &ata(ase $ype: "racle
'. &ata(ase &ri8er: "racle?s &ri8er @$hin D!A 8ersions: 9./..B 9.2./B ./B ..
e. ClicC %e>t
5OT*: Remem(er the *ND+ na,e )or the 'ata source. $his is re+uire ,hen you create
Connection ?actor- )or the !+ a'apter.
#a$e 36 10&1'&01
1age 0H o) 20

3. $ransaction "ptionsB clicC %e>t
5. &e)ine connection properties6JClicC %e>t

#a$e 37
1age 09 o) 20
7. ClicC test con)iguration
2. Gou U-$ see connection test succee'e'. ClicC %e>t
#a$e 3: 10&1'&01
1age 3/ o) 20
H. -elect !'min ser8er to target to @single ser8er mo'eA
9. Gou ,ill see the )ollo,ing message. Gou are 'one ,ith con)iguring the &ata -ource.
./. !lso maCe sure the -Test Connections on Reserve. is set )or this &ata -ource ,hich the
!+ !'apter ,ill (e using. -ee:
http://'o,nloa'.oracle.com/'ocs/c'/E.0.59_/./os(/'ocs./gr0/Icatransport/transport.ht
mlP,p...3.25
5.3.2 Con)igure !+ !'apter Connection Factory
.. ClicC on &eployments on the le)t si'e o) the <=- Console Home 1age.

#a$e )0
1age 3. o) 20
2. ClicC CustomiLe this ta(leB then on the right set the num(er o) ro,s 'isplaye' to .//.
ClicC !pply.
0. -croll 'o,n to !+!'apter. ClicC on !+!'apter
3. Create %e, Connection Factory
a. ClicC on Con)iguration ta(B )ollo,e' (y "ut(oun' Connection 1ools ta(
(. -elect Ia8a>.resource.cci.ConnectionFactory an' ClicC %e,
#a$e )1 10&1'&01
1age 32 o) 20
5. -elect Ia8a>.resource.cci.ConnectionFactory an' clicC %e>t
7. -peci)y the *%&I %ame )or out(oun' connection instance. %e>tB clicC Finish
5OT*: $he *ND+ Na,e here >9ST match the *%&I %ame speci)ie' in *&e8eloper. $he
*%&I %ame speci)ie' in *&e8eloper also (ecomes the *npoint 92( o) the (usiness ser8ice
@eis/!+/&#Connection2A. -ee -tep 5c in QCon)iguring !+ !'apter in *&e8eloper? an' -tep
He in QCreating (usiness ser8ice in "-#?.

#a$e )%
1age 30 o) 20
2. Gou see the )ollo,ing messages.
5OT*: $,o important steps: oneB up'ate the 'eployment plan ,ith the changes an' t,oR up'ate
the '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 asCe' to
create one. In this caseB you U-$ create the 'eployment plan an' then sa8e the changes to
the 'eployment plan. "ne ,ill ha8e to create a )ile calle' E1lan.>mlF )or this to sho, up in the
<=- Console screen (elo,. I) you alrea'y create' a 'eployment planB it is up'ate' ,ith the
changes.
"ne may recei8e an e>ception a)ter clicCing E"KF. $his is oC as the E1lan.>mlF )ile ,ill (e
create' ,ith the in)ormation @one can 8eri)y this (y 8ie,ing the contents o) the )ileA. I) this
happensB clicC on the E&eploymentsF linC on the le)t an' na8igate to the E!+!'apterF as (e)ore.
#a$e )3 10&1'&01
1age 33 o) 20
H. %a8igate to the !+ !'apter Con)iguration "ut(oun' Connection 1ools to see the
ne,ly create' Connection Factory.
9. Up'ate connection )actory?s &ata -ource property
a. -elect the connection you Iust create' (y clicCing it @eis/!+/&#Connection2A.
Gou ,ill see the )ollo,ing page

#a$e ))
1age 35 o) 20
(. ClicC in the 1roperty Oalue cell )or -aDataSorceNa,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 %"$ ,orC either. !)ter hitting EenterFB also clicC E-!OEF as this is
critical as ,ell.
5OT*: $he *%&I %ame o) the &ata -ource is the *%&I %ame speci)ie' in -tep 0 o) the section
on Creating a &ata -ource.
c. -elect -aDataSorceNa,e @(y clicCing on the ChecC (o> on the le)tA an' clicC
-a8e. Gou ,ill again see the messages to up'ate the 'eployment ,ith the
content sa8e' in the 'eployment plan.
5OT*: In some casesB sa8ing changes to the 'eployment plan might generate errors. *ust
ignore the errorsS
./. Up'ating 'eployment ,ith the 'eployment plan
a. ClicC on &eployments @on the le)t si'eA un'er &omain -tructure
(. -elect the !+!'apter (y clicCing on the checC (o> on the )irst column )or the
!+#!'apter ro,
c. ClicC Up'ate.
#a$e )' 10&1'&01
1age 37 o) 20
'. Gou ,ill see the )ollo,ing page. =ea8e the 'e)ault @Re'eploy application using
)ollo,ing 'eployment plansA. ClicC %e>t an' then ClicC FI%I-H

#a$e )4
1age 32 o) 20
5OT*: I) you encounter an error (y choosing the secon' option. 1lease select the )irst option
@Up'ate this application in placeTA an' then clicC %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) <=- Console
'.' Step ) Test OSB Business Service with >ana$e
connection ,oe
.. Complete steps in -ection 5.3 to con)igure &ata -ource an' !+ !'apter Connection
Factory.
2. In the "-# <e( Console @http://localhost:2//./s(consoleA clicC on the hyperlinC o) the
E!+ En4ueue #usiness -er8iceF 'e)initionB clicC on the ECreateF (utton in the upper le)tB
an' select the 1encil Icon to the right o) the E*C! $ransport Con)igurationF.
#a$e )6 10&1'&01
1age 3H o) 20
0. -et the Connection o'e *C! $ransport speci)ic property to anage'B clicC on the
E=astF #utton an' then clicC on the su(se4uent E-a8eF (utton.

#a$e )7
1age 39 o) 20
3. ClicC on the green E!cti8ateF (utton in the upper le)t an' then clicC on the E-u(mitF
(utton.
#a$e ): 10&1'&01
1age 5/ o) 20

#a$e '0
1age 5. o) 20
#a$e '1 10&1'&01
1age 52 o) 20
?i$ure 6" Test console 3 2esponse
H. =ooC 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 separate
en4ueue operationsA. %"$E: I) there is an e>ception ,hen running the testB maCe sure
the 1lan.>ml ,as up'ate' ,ith the 8alue o) the 'atasource Ey&#F )or the
>a&ata-ource%ame in the !+ Connection Factory.

#a$e '%
1age 50 o) 20
?i$ure 7" 2ow inserte in the ata!ase
#a$e '3 10&1'&01
1age 53 o) 20
4. 9se Case % AQ #ro.- Service
4.1 ;enerate <S/= 0or AQ e+ueue operation in
J/eveloper
Gou can sCip this section i) you are alrea'y )amiliar ,ith creating the !+ a'apter )or the 'e4ueue
operation using *&e8eloper.
$he <-&= )or !+ 'e4ueue operation is generate' as a result o) the !+ a'apter creation using
the !+ a'apter ,iLar' in *&e8eloper.
.. I) *&e8eloper application an' proIect e>ist @)rom section 5..A Iump to -tep 0. "ther,iseB
create a ne, application in *&e8eloper
a. File6J%e,6J!pplication
(. %ame: AQContent
2. Create 1roIect
a. %ame: AQProject
0. Create !+ !'apter
a. -elect 1roIect 6JRight ClicC 6J%e, 6J#usiness $ier 6J<e( -er8ices 6J!+
!'apter6JclicC "K @!+ a'apter ,iLar' comes upA

#a$e ')
1age 55 o) 20
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..A
simply select the ser8ice connection @DbConnection!AB maCe a note o) the *%&I %ame
@,hich is the same as (e)ore an' this is )ine )or this con)iguration
ei#%AQ%D&Connection!. an' clicC %e>t.
#a$e '' 10&1'&01
1age 57 o) 20
7. -tep 0 o) 3: "peration:
a. -elect Deqee an' clicC %e>t

#a$e '4
1age 52 o) 20
... -tep 3 o) 3: +ueue %ame
a. ClicC on #ro,se to select the -chema an' the +ueue %ame. "ne ,ill select the
user an' +ueue name create' in the -+= scripts at the (eginning o) this tutorial:
#a$e '6 10&1'&01
1age 5H o) 20
.2. -tep 5 o) 7: +ueue 1arameters
=ea8e this selection as (lanC )or no,.

#a$e '7
1age 59 o) 20
.0. -tep 7 o) 7: "(Iect 1ayloa'
-elect E<hole "(Iect E--!;E_$G1EFB clicC %e>t an' then licC EFinishF
#a$e ': 10&1'&01
1age 7/ o) 20
.3. <hat is create' no, are the <-&=s an' D-&s re4uire' )or "racle -er8ice #us. !ll o)
these )iles ,ill (e importe' into "racle -er8ice #us:
AQDeqee'(#dl
aqA$apterInboun$+ea$er*,s$l
aqA$apterInboun$+ea$er*"s$
5OT*: Remem(er the )ile system location )or these )iles. "ne ,ill ha8e to (ro,se to the <-&=
an' -chema )iles ,hen creating *C! (usiness ser8ice in "-#.

#a$e 40
1age 7. o) 20
4.% Create OSB #ro.- Service to e+ueue ,essa$es
0ro, AQ
.. =ogin to the "-# Console at: http://localhost:2//./s(console ,ith the cre'entials
2. ClicC on the E1roIect E>plorerF on the le)t6han' si'e an' select the 1roIect create'
earlier.
0. "ne is no, in the E!+ 1roIectF )ol'er an' optionally in the E&e4ueueF )ol'er ,here ,e
,ill a'' the arti)acts @<-&=sB -chemasB an' 1ro>y -er8icesA as ,as 'one earlier.
3. ClicC on the EE'itF (utton in the upper le)t corner to start a sessionB then select the
ECreate ResourceF 'rop6'o,n menu an' -elect <-&= to import the !+&e4ueue.<-&=
)ile ,e create' earlier in *&e8eloper. Repeat this step )or the
a4!'apterIn(oun'Hea'er.,s'l )ile as ,ell. %"$E: Ignore any 8ali'ation errors )or no,
as they ,ill (e resol8e' a)ter importing the -chema )iles an' mapping the re)erences.
5. -elect the ECreate ResourceF 'rop6'o,n menu an' -elect D= -chema to import the
a4!'apterIn(oun'Hea'er.>s' )ile ,e create' earlier in *&e8eloper. %"$E: Ignore any
8ali'ation errors )or no, as they ,ill (e resol8e' a)ter importing the -chema )iles an'
mapping the re)erences
7. ap the re)erences )or each <-&= (y selecting the <-&= resource.
2. ClicC on the EE'it Re)erencesF (utton an' then select the )iles importe' to resol8e all
re)erences.
H. $he screen shoul' looC liCe the )ollo,ing ,hen complete' ,ithout any 8ali'ation errors:
#a$e 41 10&1'&01
1age 72 o) 20
9. Con)igure pro>y ser8ice
a. From the Create Resource 'rop 'o,nB select E1ro>y -er8iceF
(. Fill in the -er8ice %ame ,ith a name o) one?s choosing.
c. -elect the E<-&= <e( -er8iceFB clicC #ro,seB select the !+ &e4ueueB select
the E&e4ueue_ptF an' clicC -u(mit.

#a$e 4%
1age 70 o) 20
'. ClicC E%e>tF t,ice an' on the )ollo,ing screen notice that Connection o'e is
Eanage'F. -ince this has alrea'y (een con)igure' in the <=- Console )or the
Connection Factory ,e ,ill use this setting.
e. ClicC E=astF an' the screen shoul' looC liCe this:
#a$e 43 10&1'&01
1age 73 o) 20
). ClicC E-a8eF.
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 this
caseB the recor's picCe' (y the !+ In(oun' pro>y ser8ice ,ill (e logge' to the ser8er console.
.. ClicC on the essage Flo, icon ne>t to the 1ro>y -er8ice Iust create'.

#a$e 4)
1age 75 o) 20
2. "n the ne>t screenB =e)t clicC on the 1ro>y -er8ice name an' select E!'' 1ipeline 1airF
#a$e 4' 10&1'&01
1age 77 o) 20
0. =e)t clicC on the Re4uest pipeline an' a'' a -tage no'e.
3. =e)t clicC on Estage.F an' select EE'it -tageF
5. =e)t clicC on E!'' an !ctionFB EReportingF an' then clicC on E=ogF action.
7. In the log action logB clicC on the EE>pressionF hyperlinC an' enter EU(o'yF @,ithout the
'ou(le 4uotesFA. =ea8e the se8erity le8el as E&e(ugF an' clicC E-a8e !llF.

#a$e 44
1age 72 o) 20
2. ClicC on the green E!cti8ateF (utton an' su(mit (utton to sa8e all changes.
5OT*: aCe sure logging is turne' on at /e!u$ le8el )rom the <=- Console. Follo,
instructions in the ne>t section @7.2....A.
4.%.1.1 Settin$ =o$ level to /e!u$ 0ro, <=S Console
From <=- Console
.. ClicC on En8ironment6J-er8ers
2. ClicC on !'min -er8er
0. -elect =ogging ta(
#a$e 46 10&1'&01
1age 7H o) 20
3. ClicC !'8ance'
5. -et the Einimum se8erity to =ogFB E=og File : -e8erity =e8elFB an' E=og File 6 -tan'ar'
"ut 6 -e8erity =e8elF all to &e(ug @%"$E $his is a total o) three locations on this
screen.A
7. ClicC -a8e an' log out o) <=- Console

#a$e 47
1age 79 o) 20
4.3 Test the overall 0low *n+ueue an /e+ueue 0ro,
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 the
st'out o) the running <e(=ogic -er8er instance.
.. I) "-# is not alrea'y starte'B start <e(logic ser8er )or "-#
2. =ogin to the "-# Console at: http://localhost:2//./s(console ,ith the cre'entials
#a$e 4: 10&1'&01
1age 2/ o) 20

#a$e 60
1age 2. o) 20
?i$ure )" Test console 3 2esponse
5. =ooC at the log )ile or the st'out in)ormation logge' to the screen ,here "-# ,as
starte'. "ne ,ill see the payloa' printe' out )rom the "-# &e4ueue 1ro>y -er8ice right
a)ter the "-# En4ueue -er8ice ,as e>ecute':
NFe( 3B 2/./ 0:2H:2. 1 E-$J N&e(ugJ N!=-# =oggingJ N#E!6//////J N
V1ipeline1air%o'e.B 1ipeline1air%o'e._re4uestB stage.B RE+UE-$W Nsoapen8:#o'y
>mlns:soapen8="http://schemas.>mlsoap.org/soap/en8elope/"J
@a+">*SSA;*ATB#* .,lns"a+CDhttp"&&.,lns.oracle.co,&.!&AQA9S*2DE
#a$e 61 10&1'&01
1age 22 o) 20
@>*SSA;*A(/E10@&>*SSA;*A(/E
@S9BJ*CTEstrin$@&S9BJ*CTE
@T*FTEstrin$@&T*FTE
@/O==A2AGA=9*E1:.::@&/O==A2AGA=9*E
@&a+">*SSA;*ATB#*E
@&soapenv"Bo-EE
NFe( 3B 2/./ 0:2H:2. 1 E-$J NIn)oJ N*C!_FR!E<"RK_!%&_!&!1$ERJ N#E!6
//////J N-ent message..J

#a$e 6%

OSB - JCA AQ Transport Tutorial

Uploaded by

Document Information

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

OSB - JCA AQ Transport Tutorial

Uploaded by

Copyright:

Available Formats

Oracle Service Bus (OSB) 10.3.

You might also like