e2e 105 POProcessing 02 DBAdapter

8/11/2019 e2e 105 POProcessing 02 DBAdapter

http://slidepdf.com/reader/full/e2e-105-poprocessing-02-dbadapter 1/39

End-2-end-105-PO-Processing

2 Creating the Credit CardValidation Service

2 Creating the Credit Card Validation Service ............................................................................ 1

2.1 Introduction ...................................................................................................................... ..... 1

2.2 Designing the flow ............................................................................................................... 2

2.3 Creating a new application ............................................................................................. .... 2

2.4 Adding the database adapter .............................................................................................

2.! Adding the "ediator Co#ponent ............................................................................. ...... 2$

2. Adding a transfor#ation to the "ediator co#ponent ....................................... ...... ..... 32

2.% Deplo&ing the application ................................................................................................ 3

2.' (esting the application ....................................................................................................... 3

2.) *perations and na#ing ...................................................................................................... 3'

2.1 IntroductionNote: (he solution for this chapter can be found in c:\po\solutions\ch2.

(o run this solution+ &ou #ust first co#plete Chapter 1 to set up the

application.

In this section &ou will build a si#ple credit service. (his service will

loo, up the status -valid or not valid of a given credit card fro# a

database. /ou will learn0

(he basic steps involved in building a S*A co#positeproect

ow to epose S5 operations over S*A6 7uic,l& and

easil&

(he i#ple#entation of this service uses a "ediator to route the re7uest

to the database adapter which eecutes the 7uer& on the database and

returns a result. *nce done+ our "ediator flow will loo, li,e 8igure 1.

Figure 1 Credit Service

Section 2.6 Creating the Credit Card Validation Service 2-1




2.2 Designing the flow

/ou will create a new co#posite application that will be invo,ed as aservice fro# &our #ain application to be designed later. (his co#posite

7ueries the database for the credit card nu#ber and returns its status.

2.3 Creating a new application1. Start 9Developer.

2. Create a new application. (here are various wa&s and shortcuts to do

this+ and in this case choose File > New… fro# the #enu.

3. Select All Technologies in the top tab if present -onl& if &ou have

a proect open

4. 8ro# the Categories tree+ clic, on General -not epand it.

. Select Generic Application fro# the Items field.

2-2 Creating the Credit Card Validation Service Section 2.!




Figure 2 Creating a new application

6. Clic, OK.

!. In the subse7uent Create Generic Application dialog set the

following fields+ leaving the others with their default values0

Application Name: CreditCardValidation

Directory: C0:po:CreditCardValidation





Figure 3 Create application dialog

". Clic, Next.

#. ;hen &ou create a new application &ou are pro#pted to create a

new proect. Set the following fields0

ro!ect Name: validation8orCC

Directory:

C0:po:CreditCardValidation:validation8orCC

ro!ect Technologies: S*A

Figure 4 New project dialog





1$. Clic, Next.

11. (he net step allows &ou to choose to start with an e#pt& co#posite+

or with a co#ponent alread& added. In this case+ select "mpty

Composite#

12. Clic, Finish#

Figure 5 New SOA Composite dialog

13. /ou will now have an e#pt& canvas displa&ing three swi# lanes0

services+ co#ponents+ and references.

Figure 6 New composite diagram

Section 2.6 Creating the Credit Card Validation Service 2-




2.4 %dding the data&ase adapter 1. /ou can now start building the application. Drag<and<drop a

database adapter onto the $e%erences swi# lane+ as shown in 8igure

%. If &ou don=t have the Co#ponent 6alette open+ fro# the #enu

select &iew > Component alette. If the Co#ponent 6alette is not

showing the S*A co#ponents+ select 'OA fro# the drop down list.

Figure !ragging a data"ase adapter onto t#e composite

2. (his database adapter call will return a result of valid or invalid

for a given credit card fro# the database. A wi>ard ta,es &ou

through the steps of configuring the database adapter.

(he title bar of the wi>ard dialog shows the step nu#ber. Clic, Next

on step 1.

3. ?nter the following details on step 20

'er(ice Name: getCreditValidation





Figure $ !ata"ase adapter% step 2

4. Clic, Next to go to step 3.

Figure & Creating a new data"ase connection

. (he database adapter will connect to the database+ and in order

to do that it needs a database connection which contains all the

details needed to connect to the database. /ou can pre<create a

database connection or create one on the fl&. Since a database

connection hasn=t been created &et+ &ou will create one fro# here.

Section 2.6 Creating the Credit Card Validation Service 2-!




Clic, the green plus icon to the right of the Connection poplist to

create a new database connection.

6. In the Create Data)ase Connection dialog+ enter the following

details0

Connection Name: soade#oDatabase

Connection Type: *racle -9D@C

*sername: soade#o

asswor+: soade#o

'a(e asswor+: Chec,ed

"nter C,stom -D.C *$/: nchec,ed

Dri(er: thin

0ost Name: localhost

-D.C ort: 1!21 -or the port nu#ber of &our database

'ID: B? -or the SID of &our database

Figure 1' Create !ata"ase Connection dialog

2-" Creating the Credit Card Validation Service Section 2.!




!. Clic, the Test Connection button and verif& that &our connection

wor,s.

". Clic, OK to return to step 3 of the Data)ase A+apter

Con%ig,ration wi>ard.

Figure 11 Adapter Con(iguration wi)ard% Step 3% a(ter creating new connection

#. "a,e sure &our Connection specifies the correct connection. In

addition+ the 9DI a#e #ust #atch the data source connection

pool 9DI a#e &ou entered in Chapter 1.

1$. Clic, Next.

Section 2.6 Creating the Credit Card Validation Service 2-#




11. Set the following fields0

er%orm an Operation on a Ta)le: Selected

'elect: Chec,ed

All other fields should be unchec,ed+ see 8igure 12.

Figure 12 Adapter Con(iguration wi)ard% Step 4

12. Clic, Next.

13. In step !+ clic, the Import Ta)les button to bring up the ImportTa)les dialog.

14. Clic, the 1,ery button to retrieve the list of tables for the

soademo user fro# the database. If &ou do not see an& tables+ go bac,

to Chapter 1 where &ou created the table and review the instructions

to #a,e sure it was created properl& for the soademo user.

1. Select the C$"DITCA$DINFO table and #ove it to the 'electe+

field b& pressing the A++ shuttle button.

2-1$ Creating the Credit Card Validation Service Section 2.!




Figure 13 Adapter Con(iguration wi)ard% importing ta"les

16. Clic, OK.

1!. @ac, in step ! of the Data)ase A+apter Con%ig,ration wi>ard+

clic, the C$"DITCA$DINFO table to select it.





Figure 14 !ata"ase Adapter Con(iguration wi)ard% step 5

1". Clic, Next.

1#. Step of the wi>ard lets &ou override or define the pri#ar& ,e&

for &our table. In this case no pri#ar& ,e& is defined in the database+

so &ou=ll need to specif& it. Chec, CCN*2."$ and leave the rest

unchec,ed.





Figure 15 !e(ining t#e primar* +e*

2$. Clic, Next.

21. Step % lets &ou define relationships if &ou are selecting fro#

#ultiple tables. Since there is onl& a single table there is no

relationship to define.

Clic, Next.

22. nchec, all fields+ in step '+ ecept stat,s. (hat is the onl&

colu#n we want to 7uer& fro# the database.





Figure 16 !ata"ase Adapter Con(iguration wi)ard% step $

23. Clic, Next.

24. Step ) is where &ou can specif& &our selection criteria. In this case

&ou will add a para#eter to the 7uer&. (he para#eter will be set at

runti#e to select the row for the credit card &ou want.

Clic, the Add button to add a new para#eter called ccn). Clic,

OK.





Figure 1 !ata"ase Adapter Con(iguration wi)ard% adding a parameter

2. @ac, in step )+ clic, the "+it button to bring up the "xpression

.,il+er dialog.

26. 6ress the A++ button to add a new condition





Figure 1$ Adding a new condition

2!. 6ress the "+it button in the First Arg,ment section.

2". In the 1,ery Key dialog select ccn,m)er.





Figure 1& Selecting t#e column (or t#e condition

2#. Clic, OK.

3$. In the 'econ+ Arg,ment section+ select arameter.

31. ?nsure ccn) is selected in the poplist.

Section 2.6 Creating the Credit Card Validation Service 2-1!




Figure 2' Speci(*ing t#e parameter

32. Clic, OK.

33. @ac, in step ) &ou see the su##ar& of the 7uer& that &ou

specified+ as shown in. 8igure 21. (he para#eter ccn) will be

populated at runti#e and the 7uer& will select a row based on that

para#eter

2-1" Creating the Credit Card Validation Service Section 2.!




Figure 21 Summar* o( selection criteria

34. Clic, Finish.

(he database adapter will process &our choices and

generate a service that i#ple#ents the operation &ou specified+

which #eans &our proect will now contain a new ;SD5 file to

represent that service0 getCreditValidation.wsdl. (he

co#posite diagra# has been updated with this service as shown in

8igure 22.

Section 2.6 Creating the Credit Card Validation Service 2-1#




Figure 22 Composite updated wit# data"ase adapter service

2. %dding the 'ediator Co(ponent(he "ediator is the co#ponent in charge of routing in the S*A Suite.

/ou will add a "ediator co#ponent to route a re7uest to the service &ou

ust created with the database adapter.

1. Drag a "ediator co#ponent onto the co#posite diagra# in the

Components swi# lane.

Figure 23 Adding a ,ediator component





2. In the Create 2e+iator dialog+ specif& these settings0

Name: outee7uest

Template: Define Interface 5ater

A t&pical co#posite application will have #an& co#ponents+ butonl& so#e of the# will have a publicall& eposed web services

interface. (he co#posite editor in 9Developer gives &ou the fleibilit&

to define the interface now+ choose an eisting interface+ or to define

the interface later.

Figure 24 New ,ediator component settings

3. Clic, OK.

4. /ou will create a ;eb Service interface to epose this service using

S*A6 bindings. Drag a ;eb Service adapter to the "xpose+ 'er(ices

swi# lane.





Figure 25 Adding a -e" Services inter(ace

. In the Create 3e) 'er(ice dialog that appears+ set the following

fields0

Name: getStatus@&CC

Type: Service

6. Clic, the cog icon net to the 3'D/ File field to define the interface.

Figure 26 Creating a new service inter(ace

!. (he Create 3'D/ dialog lets &ou specif& the #essage invocation

t&pes for the service. /ou have been given an eisting B"5 sche#a

definition -BSD that specifies the t&pes of the input and output for

the service which &ou will reuse for this application.





Clic, the flashlight icon to the right of the *$/ field to browse for a

sche#a file.

Figure 2 !e(ining t#e message invocation t*pes

". In the Type Chooser dialog+ clic, the Import 'chema File button.

Figure 2$ .mporting a sc#ema (ile

#.In the Import 'chema File dialog+ clic, the flashlight to browse forthe sche#a file.





Figure 2& .mporting a sc#ema (ile

1$. In the 'CA $eso,rce /oo4,p + #a,e sure File 'ystem is selected.

11. avigate to and select c:\po\schemas\creditcheck.xsd .

Figure 3' Selecting t#e sc#ema (ile

12. Clic, O4.

13. @ac, in the Import 'chema File dialog+ #a,e sure Copy to ro!ect is

selected.





Figure 31 .mport Sc#ema File dialog

14. Clic, OK.

1. /ou #a& get a Copy File dialog as,ing if &ou want to cop& the file to

&our proect. If so+ sa& 5es.

Figure 32 Cop* (ile con(irmation

16. @ac, in the Type Chooser dialog+ epand the ro!ect 'chema Files E

cre+itchec4#xs+ nodes.

1!. Select cre+itcar+'tat,s$e6,est.





Figure 33 Selecting t#e sc#ema t*pe

1". Clic, OK.

1#. (he Create 3'D/ dialog should now loo, li,e 8igure 34. Do not

select OK &etF

Figure 34 Setting t#e /e0uest invocation t*pe





2$. In a si#ilar wa&+ set the #essage t&pes for the repl& and fault to

cre+itcar+'tat,s and error. (he onl& difference is that &ou donGt

need to i#port the sche#a definition again because itGs now part of

&our proect.Clic, the $eply tab.

21. Clic, the flashlight icon to the right of the *$/ field.

22. ?pand the ro!ect 'chema Files > cre+itchec4#xs+ nodes.

23. Select cre+itcar+'tat,s.

Figure 35 C#oosing t#e repl* sc#ema t*pe

24. Clic, OK.

2. (he repl& #essage t&pe should loo, li,e 8igure 3.





Figure 36 #e repl* invocation t*pe

26. Clic, the Fa,lt tab.

2!. sing the sa#e #ethod+ select the error t&pe. (he Fa,lt tab should

loo, li,e 8igure 3%.





Figure 3 #e (ault invocation t*pe

2". Clic, OK to close the Create 3'D/ dialog.

2#. (he Create 3e) 'er(ice dialog should now loo, li,e 8igure 3'.

@e careful here << If &ou clic, the cog icon again &ou will have to set

all three invocation t&pes again -re7uest+ repl&+ and fault.

Section 2.6 Creating the Credit Card Validation Service 2-2#




Figure 3$ #e we" service inter(ace

3$. Clic, OK.

31. ow the co#ponents can be connected << or HwiredH << together. ;ire

the inbound web service binding to the "ediator co#ponent0

Figure 3& -iring t#e we" service inter(ace to t#e ,ediator component





32. ;ire the "ediator co#ponent to the database adapter service0

Figure 4' -iring t#e ,ediator component to t#e data"ase adapter service

33. /ou #a& be pro#pted to choose the operations -onl& if &ou selected

#ore than one database operations when &ou set up the database

adapter service. If so+ use these settings0

2e+iator Operation: eecute

Target Operation: getCreditValidationSelect

Figure 41 C#oosing t#e operations





34. Clic, OK.

3. (he co#posite diagra# now loo,s li,e 8igure 42 and gives an

overview of &our application.

Figure 42 #e composite view

2.6 %dding a transfor(ation to the 'ediatorco(ponent

In this section &ou will #odif& the $o,te$e6,est "ediator co#ponent

to do an BS5( transfor#ation on the #essage pa&load. (hatGs because

the inco#ing #essage to our publicl& eposed service -get'tat,s.yCC

is in a different for#at than the service created b& the database adapter-getCre+it&ali+ation.

ot onl& does the "ediator route re7uests between endpoints -which

&ou did b& wiring the# together but it can also transfor# the data as it

passes through.

1. *ne wa& to drill down into a specific co#ponent is to double<clic, it

fro# the co#posite diagra#. Double<clic, the $o,te$e6,est

"ediator co#ponent to open the "ediator editor.





Figure 43 #e ,ediator editor

2. Clic, the transfor#ation icon to the right of the Trans%orm *sing

field in the re7uest section -thatGs the first Trans%orm *sing field.

Figure 44 Adding a trans(ormation (or t#e re0uest

3. Select Create New 2apper File and accept the default na#e.





Figure 45 Creating a new mapper (ile

4. Clic, OK to open the #apping editor.

. ?pand all the nodes on both sides. /ou can do it #anuall&+ or right<

clic, 7so,rces> and select "xpan+ All. Do the sa#e for 7target> on

the right<hand side.6. "ap CCN,m)er fro# the source side to ccn) on the target side b&

dragging and dropping it. 8igure 4 shows dragging the ele#ent

across+ and 8igure 4% shows what it loo,s li,e when itGs #apped.

Figure 46 !ragging an dropping an element to map it

Figure 4 #e completed mapping

!. Save and close the #apper. /ou #a& need to use the tab bar scroll

buttons to navigate right to get to the close window icon.

Alternativel& &ou can press Ctrl<S to save the #apping+ then Ctrl<;

to close it.

". @ac, in the "ediator editor+ clic, the transfor#ation icon to the right

of the Trans%orm *sing field in the repl& section -thatGs the second

Trans%orm *sing field.





Figure 4$ Adding a trans(ormation (or t#e re0uest

#. In the $eply Trans%ormation 2ap dialog select Create New 2apper

File and accept the default na#e.

1$. Clic, OK to open the #apper.

11. ?pand all the source and target nodes.

12. "ap stat,s fro# the source to cre+itcar+stat,s fro# the target.

Figure 4& ,apping t#e repl* t*pes

13. Save and close the #apper to return to the "ediator editor.

Figure 5' #e ,ediator service wit# mappings de(ined

14. Save and close the "ediator editor to return to the co#posite

diagra#. /ou can use the toolbar buttons or the #enu+ or si#pl&

press Ctrl<S to save and Ctrl<; to close this tab.





2.! Deplo)ing the application(he first design iteration is co#plete and &ou are now read& to deplo&

the co#posite. (he steps to run and test a co#posite application are

eplained in Appen+ix A Deploying an+ $,nning a Composite

Application ead that docu#ent now if this is the first ti#e &ou are

running and testing a co#posite application. Appen+ix A followsChapter 8 in the tutorial.

2." *esting the applicationIf &ou are not sure how to deplo&+ read the steps in Appen+ix A

Deploying an+ $,nning a Composite Application.

1. After &ou have deplo&ed &our co#posite+ open ?nterprise "anager

at the following lin,0 http0localhost0%$$1e#

2. Clic, the (ali+ationForCC lin, in the 'OA section.

3. *pen the (est page b& clic,ing the Test button


http://localhost:7001/em







4. In the CCN,m)er field+ enter a credit nu#ber. In this case+ enter9;<=9;<=9;<=9;< in the CCN,m)er field which is a valid credit

card and returns the status+ JVA5ID.=

. Clic, the Test 3e) 'er(ice button.

6. /ou will get a response fro# the service which will indicate if the

credit card is valid or not. ere is the output for a valid credit card0

!. Select the $e6,est tab+ and this ti#e enter <;9=<;9=<;9=<;9 in the

CCN,m)er field which is an invalid credit card.

". Clic, the Test 3e) 'er(ice button to see the output.

#. In an upco#ing chapter+ &ou will create a new application that calls

this service+ so &ouGll need to ,now the ;SD5 location for it.





Appen+ix A Deploying an+ $,nning a Composite Application

contains instructions on how to get the ;SD5 location in the section

titled Getting the ser(ice +escription 3'D/?.

In this case it will loo, so#ething li,e0

http0localhost0'$$1soa<infraservicesCreditCardValidation

validation8orCCgetStatus@&CCK;SD5

2.# +perations and na(ing(his section gives &ou all of the operations and na#es for obects created

in this chapter. ?perienced users can use this for creating the obects in

this chapter 7uic,l&. An& 7uestions on details for a particular operation

listed here can be found in the preceding sections. (he infor#ation is

divided b& the sections in this docu#ent.

Section 2.3 Creating a new application

Application Name: CreditCardValidation

Directory: C0:po:CreditCardValidation

ro!ect Name: validation8orCC

Directory:

C0:po:CreditCardValidation:validation8orCC

ro!ect Technologies: S*A

"mpty Composite

Section 2.4 Adding the database adapter

D)A+apter 'er(ice Name: getCreditValidation

Create Data)ase Connection details0

- Connection Name0 soade#oDatabase

- Connection Type0 *racle -9D@C

- *sername0 soade#o

- asswor+0 soade#o

- 'a(e asswor+0 Chec,ed

- "nter C,stom -D.C *$/0 nchec,ed

- Dri(er0 thin

- 0ost Name0 localhost

- -D.C ort0 1!21 -or the port nu#ber of &our database

- 'ID0 B? -or the SID of &our database

- -n+i name0 eisD@soade#oDatabase





Operation0 Select

Import C?DI(CADI8* table

rimary 4ey CC"@?

Attri),te Filtering0 status A++ a new parameter0 ccnb

A++ 3here cla,se0 ccnu#ber L Mccnb

Section 2.! Adding the "ediator Co#ponent

Create 2e+iator: outee7uest

Template: Define Interface 5ater

Create 3e) 'er(ice: getStatus@&CC

Type: Service

3'D/ )ase+ on: c0:po:sche#as:creditchec,.sd

$e6,est: creditcardStatuse7uest

$eply: creditcardStatus

Fa,lt: error

3ire: service to #ediator to adapter

Section 2. Adding a transfor#ation to the "ediator co#ponent

2e+iator trans%orm: "ap CCu#ber fro# the source side to

ccnb

2e+iator trans%orm %or reply: "ap status fro# the source to

creditcardstatus fro# the target.

(he application is co#pleted. Continue with Section 2.% above to deplo&

and test &our application.

e2e 105 POProcessing 02 DBAdapter

Documents

Transcript of e2e 105 POProcessing 02 DBAdapter