IFX Implementation Guide for Web Services

TABLE OF CONTENTS

1    Introduction............................................................................................................ 1-1

1.1     Intended Use.................................................................................................................................................... 1-1

2    Basic Web Services Concepts............................................................................ 2-1

2.1     WS-I........................................................................................................................................................................ 2-1

2.1.1     Documents.................................................................................................................................................... 2-1

2.1.2     Sample Application.................................................................................................................................... 2-2

2.1.3     Testing Tool................................................................................................................................................. 2-2

2.2     SOAP....................................................................................................................................................................... 2-2

2.2.1     Why SOAP?.................................................................................................................................................. 2-3

2.2.2     The SOAP Envelope.................................................................................................................................... 2-3

2.3     WSDL...................................................................................................................................................................... 2-3

2.3.1     What is WSDL?............................................................................................................................................ 2-3

2.3.2     The three parts of WSDL............................................................................................................................ 2-4

2.3.3     Three approaches to packaging.............................................................................................................. 2-4

2.4     Document-Literal........................................................................................................................................ 2-5

2.4.1     The four possibilities.................................................................................................................................. 2-5

2.4.2     Why document literal style?...................................................................................................................... 2-5

2.4.3     Wrapped style.............................................................................................................................................. 2-5

2.5     Namespaces...................................................................................................................................................... 2-6

2.5.1     Used in both schema and WSDL............................................................................................................... 2-6

2.5.2     Used to name independent configuration items.................................................................................... 2-6

2.5.3     The schema inside wsdl:types is required to have its own namespace............................................. 2-6

2.6     Faults.................................................................................................................................................................. 2-6

2.6.1     SOAP 1.1 Fault............................................................................................................................................ 2-6

2.7     WS-Security...................................................................................................................................................... 2-7

3    IFX Web Services Specifics................................................................................... 3-1

3.1     Use Cases............................................................................................................................................................ 3-1

3.1.1     ATM to Acquiring System.......................................................................................................................... 3-1

3.1.2     Business to Bank......................................................................................................................................... 3-1

3.1.3     Enterprise Application Integration......................................................................................................... 3-2

3.2     Scenarios........................................................................................................................................................... 3-3

3.2.1     Document Scenario.................................................................................................................................... 3-3

3.2.2     Message Scenario....................................................................................................................................... 3-3

3.2.3     Other Scenarios........................................................................................................................................... 3-3

3.3     WSDL...................................................................................................................................................................... 3-3

3.3.1     Document/literal......................................................................................................................................... 3-3

3.3.2     Namespaces.................................................................................................................................................. 3-4

3.3.3     wsdl:types..................................................................................................................................................... 3-4

3.3.4     Packaging.................................................................................................................................................... 3-5

3.3.5     Summary of defined namespaces.............................................................................................................. 3-5

3.3.6     WS-I compliant............................................................................................................................................ 3-6

3.4     IFX Schema........................................................................................................................................................ 3-6

3.5     Scenario Details........................................................................................................................................... 3-6

3.5.1     Message Exchange Pattern....................................................................................................................... 3-6

3.5.2     Document...................................................................................................................................................... 3-7

3.5.3     Message........................................................................................................................................................ 3-8

3.6     Faults................................................................................................................................................................ 3-11

4    Reference Implementations.............................................................................. 4-1

4.1     Example WSDL and Schema Packages............................................................................................. 4-1

4.1.1     Document...................................................................................................................................................... 4-1

4.1.2     Message........................................................................................................................................................ 4-1

4.2     Microsoft .NET................................................................................................................................................ 4-2

4.2.1     Introduction................................................................................................................................................. 4-2

4.2.2     Prerequisites................................................................................................................................................ 4-2

4.2.3     Building the Service................................................................................................................................... 4-2

4.2.4     Building the Client..................................................................................................................................... 4-6

4.2.5     Using SOAPscope to see the SOAP messages........................................................................................ 4-7

4.2.6     Adding Validation...................................................................................................................................... 4-8

4.2.7     Using a different serializer / deserializer............................................................................................... 4-9

4.3     Apache Axis – MSG...................................................................................................................................... 4-11

4.3.1     Introduction............................................................................................................................................... 4-11

4.3.2     Prerequisites.............................................................................................................................................. 4-11

4.3.3     Building the JAXB bean from the IFX schema.................................................................................... 4-11

4.3.4     Building the Server.................................................................................................................................. 4-13

4.3.5     Throwing SOAP Faults............................................................................................................................ 4-17

4.3.6     Validation.................................................................................................................................................. 4-18

4.3.7     Building the Client................................................................................................................................... 4-18

4.3.8     IFX SOAP Simulator and Tester............................................................................................................ 4-20

4.4     Apache Axis – RPC........................................................................................................................................ 4-22

4.4.1     Introduction............................................................................................................................................... 4-22

4.4.2     Prerequisites.............................................................................................................................................. 4-22

4.4.3     Building the Service................................................................................................................................. 4-24

4.4.4     Building the Client................................................................................................................................... 4-28

4.4.5     Installing the service to a server............................................................................................................ 4-29

4.5     Sun Java Web Services Development Pack.................................................................................. 4-30

4.5.1     Introduction............................................................................................................................................... 4-30

4.5.2     Prerequisites.............................................................................................................................................. 4-30

4.5.3     Editing the Configuration...................................................................................................................... 4-31

4.5.4     Building the server................................................................................................................................... 4-32

4.5.5     Test the server............................................................................................................................................ 4-32

4.5.6     Building the client.................................................................................................................................... 4-32

4.5.7     Test the client............................................................................................................................................ 4-33

4.5.8     Undeploy the server................................................................................................................................. 4-33

4.5.9     Clean the build directory........................................................................................................................ 4-33

5    References................................................................................................................. 5-1

5.1     WS-I........................................................................................................................................................................ 5-1

5.1.1     Basic Profile 1.1.......................................................................................................................................... 5-1

5.1.2     Simple SOAP Binding Profile 1.0............................................................................................................ 5-1

5.2     SOAP....................................................................................................................................................................... 5-1

5.2.1     SOAP 1.1....................................................................................................................................................... 5-1

5.3     WSDL...................................................................................................................................................................... 5-1

5.3.1     WSDL 1.1...................................................................................................................................................... 5-1

6    Glossary..................................................................................................................... 6-1

7    Useful Tools.............................................................................................................. 7-1

7.1     SOAPScope.......................................................................................................................................................... 7-1

7.2     WS-I Compliance Checker......................................................................................................................... 7-1

7.3     J Meter................................................................................................................................................................. 7-1

7.3.1     Installation................................................................................................................................................... 7-1

7.3.2     Test................................................................................................................................................................. 7-2