Skip to Content.
Sympa Menu

notify-dpml - svn commit: r2528 - in development/laboratory/users/niclas/iso8583: . channels/src/main/net/dpml/iso8583/channels docs/src/docs docs/src/docs/reference docs/src/docs/userguide guide-src guide-src/src guide-src/src/main packaging/src/main/net/dpml/iso8583/packaging

notify-dpml AT lists.ibiblio.org

Subject: DPML Notify

List archive

Chronological Thread  
  • From: niclas AT hedhman.org
  • To: notify-dpml AT lists.ibiblio.org
  • Subject: svn commit: r2528 - in development/laboratory/users/niclas/iso8583: . channels/src/main/net/dpml/iso8583/channels docs/src/docs docs/src/docs/reference docs/src/docs/userguide guide-src guide-src/src guide-src/src/main packaging/src/main/net/dpml/iso8583/packaging
  • Date: Fri, 13 May 2005 09:22:02 +0000

Author: niclas AT hedhman.org
Date: Fri May 13 09:22:00 2005
New Revision: 2528

Added:

development/laboratory/users/niclas/iso8583/docs/src/docs/reference/channels.xml
(contents, props changed)

development/laboratory/users/niclas/iso8583/docs/src/docs/reference/dataelements.xml
(contents, props changed)

development/laboratory/users/niclas/iso8583/docs/src/docs/reference/mti.xml
(contents, props changed)

development/laboratory/users/niclas/iso8583/docs/src/docs/reference/packaging.xml
(contents, props changed)
development/laboratory/users/niclas/iso8583/guide-src/
development/laboratory/users/niclas/iso8583/guide-src/src/
development/laboratory/users/niclas/iso8583/guide-src/src/main/
Modified:

development/laboratory/users/niclas/iso8583/channels/src/main/net/dpml/iso8583/channels/XmlChannel.java
development/laboratory/users/niclas/iso8583/docs/src/docs/index.xml
development/laboratory/users/niclas/iso8583/docs/src/docs/navigation.xml

development/laboratory/users/niclas/iso8583/docs/src/docs/reference/definitions.xml

development/laboratory/users/niclas/iso8583/docs/src/docs/reference/index.xml

development/laboratory/users/niclas/iso8583/docs/src/docs/reference/navigation.xml

development/laboratory/users/niclas/iso8583/docs/src/docs/userguide/creating-client.xml

development/laboratory/users/niclas/iso8583/docs/src/docs/userguide/creating-server.xml

development/laboratory/users/niclas/iso8583/docs/src/docs/userguide/index.xml

development/laboratory/users/niclas/iso8583/docs/src/docs/userguide/navigation.xml
development/laboratory/users/niclas/iso8583/iso8583.iws

development/laboratory/users/niclas/iso8583/packaging/src/main/net/dpml/iso8583/packaging/Visa1Packager.java
Log:
More documentation work.

Modified:
development/laboratory/users/niclas/iso8583/channels/src/main/net/dpml/iso8583/channels/XmlChannel.java
==============================================================================
---
development/laboratory/users/niclas/iso8583/channels/src/main/net/dpml/iso8583/channels/XmlChannel.java
(original)
+++
development/laboratory/users/niclas/iso8583/channels/src/main/net/dpml/iso8583/channels/XmlChannel.java
Fri May 13 09:22:00 2005
@@ -18,17 +18,15 @@

package net.dpml.iso8583.channels;

-import java.io.IOException;
-
+import net.dpml.iso8583.comm.Packager;
+import net.dpml.iso8583.data.ISOException;
import net.dpml.logging.Logger;
-
import net.dpml.parameters.ParameterException;
import net.dpml.parameters.Parameters;
-
import net.dpml.service.ServiceException;
import net.dpml.service.ServiceManager;
-import net.dpml.iso8583.data.ISOException;
-import net.dpml.iso8583.comm.Packager;
+
+import java.io.IOException;

/** Metro Wrapper for the x.25 Channel in JPos.
*

Modified: development/laboratory/users/niclas/iso8583/docs/src/docs/index.xml
==============================================================================
--- development/laboratory/users/niclas/iso8583/docs/src/docs/index.xml
(original)
+++ development/laboratory/users/niclas/iso8583/docs/src/docs/index.xml Fri
May 13 09:22:00 2005
@@ -1,8 +1,25 @@
<?xml version="1.0" encoding="UTF-8" ?>
+<!--
+ Copyright 2005 Niclas Hedhman
+
+ Licensed under the Apache License, Version 2.0 (the "License");
+ you may not use this file except in compliance with the License.
+ You may obtain a copy of the License at
+
+ http://www.dpml.net/central/about/legal/
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+ implied.
+
+ See the License for the specific language governing permissions and
+ limitations under the License.
+-->
<document>
<properties>
- <author email="niclas AT hedhman.org">Stephen McConnell</author>
- <title>ISO8583 networking</title>
+ <author email="niclas AT hedhman.org">Niclas Hedhman</author>
+ <title>ISO8583 Networking Toolkit</title>
</properties>
<body>
<section name="Overview">
@@ -27,6 +44,6 @@
the DPML Metro runtime platform.
</p>
</section>
-
+
</body>
</document>
\ No newline at end of file

Modified:
development/laboratory/users/niclas/iso8583/docs/src/docs/navigation.xml
==============================================================================
--- development/laboratory/users/niclas/iso8583/docs/src/docs/navigation.xml
(original)
+++ development/laboratory/users/niclas/iso8583/docs/src/docs/navigation.xml
Fri May 13 09:22:00 2005
@@ -19,7 +19,7 @@

<project>

- <title>ISO8583 networking</title>
+ <title>ISO8583 Networking Toolkit</title>

<body>


Added:
development/laboratory/users/niclas/iso8583/docs/src/docs/reference/channels.xml
==============================================================================
--- (empty file)
+++
development/laboratory/users/niclas/iso8583/docs/src/docs/reference/channels.xml
Fri May 13 09:22:00 2005
@@ -0,0 +1,30 @@
+<?xml version="1.0" encoding="UTF-8" ?>
+<!--
+ Copyright 2005 Niclas Hedhman
+
+ Licensed under the Apache License, Version 2.0 (the "License");
+ you may not use this file except in compliance with the License.
+ You may obtain a copy of the License at
+
+ http://www.dpml.net/central/about/legal/
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+ implied.
+
+ See the License for the specific language governing permissions and
+ limitations under the License.
+-->
+<document>
+ <properties>
+ <author email="niclas AT hedhman.org">Niclas Hedhman</author>
+ <title>ISO8583 Networking Toolkit</title>
+ </properties>
+ <body>
+ <section name="Creating a Client">
+ <p>
+ </p>
+ </section>
+ </body>
+</document>
\ No newline at end of file

Added:
development/laboratory/users/niclas/iso8583/docs/src/docs/reference/dataelements.xml
==============================================================================
--- (empty file)
+++
development/laboratory/users/niclas/iso8583/docs/src/docs/reference/dataelements.xml
Fri May 13 09:22:00 2005
@@ -0,0 +1,30 @@
+<?xml version="1.0" encoding="UTF-8" ?>
+<!--
+ Copyright 2005 Niclas Hedhman
+
+ Licensed under the Apache License, Version 2.0 (the "License");
+ you may not use this file except in compliance with the License.
+ You may obtain a copy of the License at
+
+ http://www.dpml.net/central/about/legal/
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+ implied.
+
+ See the License for the specific language governing permissions and
+ limitations under the License.
+-->
+<document>
+ <properties>
+ <author email="niclas AT hedhman.org">Niclas Hedhman</author>
+ <title>ISO8583 Networking Toolkit</title>
+ </properties>
+ <body>
+ <section name="Creating a Client">
+ <p>
+ </p>
+ </section>
+ </body>
+</document>
\ No newline at end of file

Modified:
development/laboratory/users/niclas/iso8583/docs/src/docs/reference/definitions.xml
==============================================================================
---
development/laboratory/users/niclas/iso8583/docs/src/docs/reference/definitions.xml
(original)
+++
development/laboratory/users/niclas/iso8583/docs/src/docs/reference/definitions.xml
Fri May 13 09:22:00 2005
@@ -25,8 +25,8 @@
-->
<document>
<properties>
- <author email="niclas AT hedhman.org">Stephen McConnell</author>
- <title>ISO8583 networking</title>
+ <author email="niclas AT hedhman.org">Niclas Hedhman</author>
+ <title>ISO8583 Networking Toolkit</title>
</properties>
<body>
<section name="Definitions">

Modified:
development/laboratory/users/niclas/iso8583/docs/src/docs/reference/index.xml
==============================================================================
---
development/laboratory/users/niclas/iso8583/docs/src/docs/reference/index.xml
(original)
+++
development/laboratory/users/niclas/iso8583/docs/src/docs/reference/index.xml
Fri May 13 09:22:00 2005
@@ -1,32 +1,116 @@
<?xml version="1.0" encoding="UTF-8" ?>
+<!--
+ Copyright 2005 Niclas Hedhman
+
+ Licensed under the Apache License, Version 2.0 (the "License");
+ you may not use this file except in compliance with the License.
+ You may obtain a copy of the License at
+
+ http://www.dpml.net/central/about/legal/
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+ implied.
+
+ See the License for the specific language governing permissions and
+ limitations under the License.
+-->
<document>
<properties>
- <author email="niclas AT hedhman.org">Stephen McConnell</author>
- <title>ISO8583 networking</title>
+ <author email="niclas AT hedhman.org">Niclas Hedhman</author>
+ <title>ISO8583 Networking Toolkit</title>
</properties>
<body>
<section name="Overview">
<p>
- This set of components is a toolkit for implementation of
- ISO8583 communication systems, such as from POS terminals,
- ATMs or cash deposit machines to the backend systems of banks
- or Visa. The ISO8583 specification is available from ISO at
- a fee and may not be redistributed, and we strongly encourage
- you to get it if you intend to implement this in a real-world
- system. It can be purchased directly from
+ First of all, the ultimate reference is the ISO8583
+ specification and you <strong>will</strong> need it.
+ It can be purchased directly from
<a
href="http://www.iso.org/iso/en/CatalogueDetailPage.CatalogueDetail?CSNUMBER=31628&ICS1=35&ICS2=240&ICS3=15";>
iso.org here.
</a>
</p>
<p>
- This work also build on top of the great work of the
- <a href="http://jpos.org";>jPos.org</a> project, which has
done
- the painstaking job of bit-level handling. This toolkit is
- mostly an adaption to introduce as much type-safety as
possible
- and make it easier to create higher level services, all under
- the DPML Metro runtime platform.
+ The first thing that you need to do is to understand the
+ basic operations, a.k.a message classes, that exists in
+ ISO8583. There is a compiled defintion available
+ <a href="definitions.html">here</a>.
</p>
+ <subsection name="Abbreviations" >
+ <p>
+ Here is a list of commonly used abbreviations, used both
in
+ the the ISO spec as well as in the documentation of this
+ toolkit;
+ </p>
+ <dl>
+ <dt>ATM</dt>
+ <dd>automatic teller machine</dd>
+
+ <dt>CAD</dt>
+ <dd>card acceptor device (also known as a terminal)</dd>
+ <dt>CAT</dt>
+ <dd>cardholder activated terminal</dd>
+ <dt>GMT</dt>
+ <dd>greenwich mean time</dd>
+ <dt>MAC</dt>
+ <dd>message authentication code</dd>
+ <dt>MTI</dt>
+ <dd>message type identifier</dd>
+ <dt>PAN</dt>
+ <dd>primary account number</dd>
+ <dt>PIN</dt>
+ <dd>personal identification number</dd>
+ <dt>RFID</dt>
+ <dd>radio frequency input device</dd>
+ <dt>RMMG</dt>
+ <dd>registration and maintenance management group</dd>
+ <dt>URL</dt>
+ <dd>universal resource locator</dd>
+ <dt>UTC</dt>
+ <dd>universal co-ordinated time</dd>
+ </dl>
+ </subsection>
+ <subsection name="Channels" >
+ <p>
+ <a href="channels.html">Channels</a> are the
communication
+ links between the server and client over a network or
other
+ form of medium.
+ </p>
+ </subsection>
+ <subsection name="Packaging" >
+ <p>
+ <a href="packaging.html">Packaging</a> is all about the
+ transport format/encoding of the data itself. The ISO8583
+ specification does not define the transport level
encoding,
+ and it is up to the client and server to agree on a
+ particular encoding format, existing or new. This toolkit
+ utilizes any of the many packagers available in the
+ <a href="http://www.jpos.org";>jpos.org</a> project.
+ </p>
+ </subsection>
+ <subsection name="Data Elements" >
+ <p>
+ The <a href="dataelements.html">Data Elements</a> are the
+ <strong>fields</strong>, a.k.a. <strong>bits</strong>(!),
+ within a single message. This toolkit provides simplicity
+ when it comes to assign or retrieving the values of the
+ fields through the dataelements package. Constructed
+ data elements is supported, but initially the composite
+ data elements (only Bit 104 and custom ones) are not
+ supported and must be crafted manually.
+ </p>
+ </subsection>
+ <subsection name="Message Type Identifiers (MTI)" >
+ <p>
+ The <a href="mti.html">MTI</a> package handles the
+ arrangement of the dataelements within a single message.
+ The rules of which data elements must be included and
which
+ data elements that are optional, are known to each of the
+ MTIs. There is one MTI class for each possible standard
+ message.
+ </p>
+ </subsection>
</section>
-
</body>
</document>
\ No newline at end of file

Added:
development/laboratory/users/niclas/iso8583/docs/src/docs/reference/mti.xml
==============================================================================
--- (empty file)
+++
development/laboratory/users/niclas/iso8583/docs/src/docs/reference/mti.xml
Fri May 13 09:22:00 2005
@@ -0,0 +1,30 @@
+<?xml version="1.0" encoding="UTF-8" ?>
+<!--
+ Copyright 2005 Niclas Hedhman
+
+ Licensed under the Apache License, Version 2.0 (the "License");
+ you may not use this file except in compliance with the License.
+ You may obtain a copy of the License at
+
+ http://www.dpml.net/central/about/legal/
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+ implied.
+
+ See the License for the specific language governing permissions and
+ limitations under the License.
+-->
+<document>
+ <properties>
+ <author email="niclas AT hedhman.org">Niclas Hedhman</author>
+ <title>ISO8583 Networking Toolkit</title>
+ </properties>
+ <body>
+ <section name="Creating a Client">
+ <p>
+ </p>
+ </section>
+ </body>
+</document>
\ No newline at end of file

Modified:
development/laboratory/users/niclas/iso8583/docs/src/docs/reference/navigation.xml
==============================================================================
---
development/laboratory/users/niclas/iso8583/docs/src/docs/reference/navigation.xml
(original)
+++
development/laboratory/users/niclas/iso8583/docs/src/docs/reference/navigation.xml
Fri May 13 09:22:00 2005
@@ -19,14 +19,16 @@

<project>

- <title>ISO8583 networking</title>
+ <title>ISO8583 Networking Toolkit</title>

<body>
<menu>
<item name="Overview" href="index.html"/>
- <item name="MTIs" href="mtis/index.html"/>
- <item name="Channels" href="channels/index.html"/>
- <item name="Packaging" href="packaging/index.html"/>
+ <item name="Definitions" href="definitions.html"/>
+ <item name="MTIs" href="mti.html"/>
+ <item name="Channels" href="channels.html"/>
+ <item name="Packaging" href="packaging.html"/>
+ <item name="Data Elements" href="dataelements.html"/>
</menu>
</body>


Added:
development/laboratory/users/niclas/iso8583/docs/src/docs/reference/packaging.xml
==============================================================================
--- (empty file)
+++
development/laboratory/users/niclas/iso8583/docs/src/docs/reference/packaging.xml
Fri May 13 09:22:00 2005
@@ -0,0 +1,30 @@
+<?xml version="1.0" encoding="UTF-8" ?>
+<!--
+ Copyright 2005 Niclas Hedhman
+
+ Licensed under the Apache License, Version 2.0 (the "License");
+ you may not use this file except in compliance with the License.
+ You may obtain a copy of the License at
+
+ http://www.dpml.net/central/about/legal/
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+ implied.
+
+ See the License for the specific language governing permissions and
+ limitations under the License.
+-->
+<document>
+ <properties>
+ <author email="niclas AT hedhman.org">Niclas Hedhman</author>
+ <title>ISO8583 Networking Toolkit</title>
+ </properties>
+ <body>
+ <section name="Packaging">
+ <p>
+ </p>
+ </section>
+ </body>
+</document>
\ No newline at end of file

Modified:
development/laboratory/users/niclas/iso8583/docs/src/docs/userguide/creating-client.xml
==============================================================================
---
development/laboratory/users/niclas/iso8583/docs/src/docs/userguide/creating-client.xml
(original)
+++
development/laboratory/users/niclas/iso8583/docs/src/docs/userguide/creating-client.xml
Fri May 13 09:22:00 2005
@@ -1,13 +1,41 @@
<?xml version="1.0" encoding="UTF-8" ?>
+<!--
+ Copyright 2005 Niclas Hedhman
+
+ Licensed under the Apache License, Version 2.0 (the "License");
+ you may not use this file except in compliance with the License.
+ You may obtain a copy of the License at
+
+ http://www.dpml.net/central/about/legal/
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+ implied.
+
+ See the License for the specific language governing permissions and
+ limitations under the License.
+-->
<document>
<properties>
- <author email="niclas AT hedhman.org">Stephen McConnell</author>
- <title>ISO8583 networking</title>
+ <author email="niclas AT hedhman.org">Niclas Hedhman</author>
+ <title>ISO8583 Networking Toolkit</title>
</properties>
<body>
<section name="Creating a Client">
<p>
+ In this guide, we will guide you through the creation of a
+ simple ISO8583 client that does an authorization request and
a
+ presentment request. From that we are confident that you will
+ be able to extend this to the circumstance in your project.
</p>
+ <subsection name="Build system.">
+ <p>
+ It is outside the scope of this guide to explain how DPML
+ Magic works, and you are expected to understand the Magic
+ concepts of projects, resources, tasks and so forth.
+ </p>
+ </subsection>
</section>
</body>
</document>
\ No newline at end of file

Modified:
development/laboratory/users/niclas/iso8583/docs/src/docs/userguide/creating-server.xml
==============================================================================
---
development/laboratory/users/niclas/iso8583/docs/src/docs/userguide/creating-server.xml
(original)
+++
development/laboratory/users/niclas/iso8583/docs/src/docs/userguide/creating-server.xml
Fri May 13 09:22:00 2005
@@ -16,32 +16,86 @@
See the License for the specific language governing permissions and
limitations under the License.
-->
-<!--
- For the sake of accuracy, fragments of text has been copied
- from the ISO8583-1:2003(E) specification, which defines the
- message classes. That material is;
-
- Copyright 2003 ISO. All rights reserved.
--->
<document>
<properties>
- <author email="niclas AT hedhman.org">Stephen McConnell</author>
- <title>ISO8583 networking</title>
+ <author email="niclas AT hedhman.org">Niclas Hedhman</author>
+ <title>ISO8583 Networking Toolkit</title>
</properties>
<body>
- <section name="Definitions">
+ <section name="Creating a Server">
<p>
- In this chapter we are going to create a simple ISO8583
server,
- able to respond to incoming requests. We will show how to
wrap
- up the complexities of the protocol into Metro service
- implementations, which simplifies the interaction between a
- higher level application and the protocol, for instance if
- you are into developing banking applications that must
- integrate into existing ISO8583 networks and implementations.
- As mentioned before, ISO8583 is not a rigid standard and
- allows for immense customization which leads application
- developers into a nightmare of support.
+ This chapter will guide through the steps to create a simple
+ ISO8583 server. The server will be configured with an XML
+ encoder over TCP/IP, and it will do dispatching of incoming
+ requests to services that needs to handle them.
</p>
+ <subsection name="Build system.">
+ <p>
+ It is outside the scope of this guide to explain how DPML
+ Magic works, and you are expected to understand the Magic
+ concepts of projects, resources, tasks and so forth.
+ </p>
+ <p>
+ ALL the artifacts built in this guide will belong to
group
+ 'dpml/iso8583/guide', and you need to use a different
group
+ for your own projects to avoid collisions.
+ </p>
+ </subsection>
+ <subsection name="Metro components">
+ <p>
+ We will build the entire thing as a standalone system
+ running DPML Metro, and it is expected that you have a
+ basic understanding of how Metro components are made and
+ how they are assembled in runtime.
+ </p>
+ </subsection>
+ <subsection name="Setting up a Channel with Packager" >
+ <p>
+ Let's start with the low-level handling. That means the
+ <a href="../reference/channels.html">Channels</a> and an
+ associated <a
href="../reference/packager.html">Packager</a>
+ and put that into a re-usable block.
+ </p>
+ <p>
+ Create a block project and let's call it xml-transport.
We
+ choose the XmlPackager and the XmlChannel for it, and
will
+ end up with the following in the build.xml;
+ </p>
+<source><![CDATA[
+ <target name="build" depends="standard.build" >
+ <x:block name="xml-transport" >
+ <x:component name="packager"
class="net.dpml.iso8583.packaging.XmlPackager" />
+ <x:component name="channel"
class="net.dpml.iso8583.packaging.XmlChannel" >
+ <x:parameters>
+ <x:parameter name="port" value="2828" />
+ <x:parameters>
+ </x:component>
+ </x:block>
+ </target>
+]]>
+</source>
+ <p>
+ </p>
+ </subsection>
+ <subsection name="Setting up the application level block." >
+ <p>
+ Since we will need a block that aggregates the entire
+ application, we need a block that does exactly that. We
do
+ that by utilizing the &lt;include&gt; task. At this
point,
+ we only put in the 'xml-transport' block. We call this
+ top level block project for 'guide-demo'.
+ </p>
+<source><![CDATA[
+ <target name="build" depends="standard.build" >
+ <!-- Translate the 'xml-transport' project key into an artifact URI.
-->
+ <x:property name="xml-transport-uri" feature="uri"
key="xml-transport" />
+
+ <!-- include the xml-transport block into the application. -->
+ <x:include name="transport" uri="${xml-transport-uri}" />
+ </target>
+]]>
+</source>
+ </subsection>
</section>
</body>
</document>

Modified:
development/laboratory/users/niclas/iso8583/docs/src/docs/userguide/index.xml
==============================================================================
---
development/laboratory/users/niclas/iso8583/docs/src/docs/userguide/index.xml
(original)
+++
development/laboratory/users/niclas/iso8583/docs/src/docs/userguide/index.xml
Fri May 13 09:22:00 2005
@@ -1,30 +1,40 @@
<?xml version="1.0" encoding="UTF-8" ?>
+<!--
+ Copyright 2005 Niclas Hedhman
+
+ Licensed under the Apache License, Version 2.0 (the "License");
+ you may not use this file except in compliance with the License.
+ You may obtain a copy of the License at
+
+ http://www.dpml.net/central/about/legal/
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+ implied.
+
+ See the License for the specific language governing permissions and
+ limitations under the License.
+-->
<document>
<properties>
- <author email="niclas AT hedhman.org">Stephen McConnell</author>
- <title>ISO8583 networking</title>
+ <author email="niclas AT hedhman.org">Niclas Hedhman</author>
+ <title>ISO8583 Networking Toolkit</title>
</properties>
<body>
<section name="Overview">
<p>
- This set of components is a toolkit for implementation of
- ISO8583 communication systems, such as from POS terminals,
- ATMs or cash deposit machines to the backend systems of banks
- or Visa. The ISO8583 specification is available from ISO at
- a fee and may not be redistributed, and we strongly encourage
- you to get it if you intend to implement this in a real-world
- system. It can be purchased directly from
- <a
href="http://www.iso.org/iso/en/CatalogueDetailPage.CatalogueDetail?CSNUMBER=31628&ICS1=35&ICS2=240&ICS3=15";>
- iso.org here.
- </a>
+ This guide is under construction, and in no way complete and
+ may be inaccurate at times. Please contact the
+ <a href="mailto:niclas AT hedhman.org";>author</a> if you are
+ planning any real deployment of this toolkit.
</p>
<p>
- This work also build on top of the great work of the
- <a href="http://jpos.org";>jPos.org</a> project, which has
done
- the painstaking job of bit-level handling. This toolkit is
- mostly an adaption to introduce as much type-safety as
possible
- and make it easier to create higher level services, all under
- the DPML Metro runtime platform.
+ This User Guide will try to provide you an simplified
+ step-by-step introduction to the various aspect of this
+ toolkit. We will create a simple server and a simple client
+ and see how various principles of the toolkit can be applied
+ in real-world projects.
</p>
</section>


Modified:
development/laboratory/users/niclas/iso8583/docs/src/docs/userguide/navigation.xml
==============================================================================
---
development/laboratory/users/niclas/iso8583/docs/src/docs/userguide/navigation.xml
(original)
+++
development/laboratory/users/niclas/iso8583/docs/src/docs/userguide/navigation.xml
Fri May 13 09:22:00 2005
@@ -19,7 +19,7 @@

<project>

- <title>ISO8583 networking</title>
+ <title>ISO8583 Networking Toolkit</title>

<body>
<menu>

Modified: development/laboratory/users/niclas/iso8583/iso8583.iws
==============================================================================
--- development/laboratory/users/niclas/iso8583/iso8583.iws (original)
+++ development/laboratory/users/niclas/iso8583/iso8583.iws Fri May 13
09:22:00 2005
@@ -146,76 +146,74 @@
<option name="HIDE_WARNINGS" value="false" />
</component>
<component name="FileEditorManager" split-orientation="vertical"
split-proportion="0.5">
- <first-group
selected-file="file://$PROJECT_DIR$/docs/src/docs/reference/definitions.xml">
- <entry file="file://$PROJECT_DIR$/docs/src/docs/index.xml"
pinned="false">
+ <first-group
selected-file="file://$PROJECT_DIR$/docs/src/docs/userguide/creating-server.xml">
+ <entry file="file://$PROJECT_DIR$/docs/src/docs/reference/mti.xml"
pinned="false">
<provider selected="true" editor-type-id="text-editor">
- <state line="5" column="0" selection-start="138"
selection-end="180" vertical-scroll-proportion="0.097911224">
+ <state line="22" column="0" selection-start="770"
selection-end="770" vertical-scroll-proportion="0.4225352">
<folding />
</state>
</provider>
</entry>
- <entry file="file://$PROJECT_DIR$/docs/src/docs/reference/index.xml"
pinned="false">
+ <entry
file="file://$PROJECT_DIR$/docs/src/docs/reference/navigation.xml"
pinned="false">
<provider selected="true" editor-type-id="text-editor">
- <state line="0" column="0" selection-start="0" selection-end="0"
vertical-scroll-proportion="0.0">
+ <state line="32" column="54" selection-start="1083"
selection-end="1083" vertical-scroll-proportion="0.61459666">
<folding />
</state>
</provider>
</entry>
- <entry file="file://$PROJECT_DIR$/docs/src/docs/userguide/index.xml"
pinned="false">
+ <entry file="file://$PROJECT_DIR$/docs/src/docs/reference/index.xml"
pinned="false">
<provider selected="true" editor-type-id="text-editor">
- <state line="0" column="0" selection-start="0" selection-end="0"
vertical-scroll-proportion="0.0">
+ <state line="22" column="0" selection-start="770"
selection-end="770" vertical-scroll-proportion="0.4308094">
<folding />
</state>
</provider>
</entry>
- <entry
file="file://$PROJECT_DIR$/docs/src/docs/userguide/creating-client.xml"
pinned="false">
+ <entry
file="file://$PROJECT_DIR$/docs/src/docs/userguide/creating-server.xml"
pinned="false">
<provider selected="true" editor-type-id="text-editor">
- <state line="11" column="0" selection-start="304"
selection-end="304" vertical-scroll-proportion="0.2112676">
+ <state line="96" column="49" selection-start="4230"
selection-end="4230" vertical-scroll-proportion="0.86555696">
<folding />
</state>
</provider>
</entry>
- <entry
file="file://$PROJECT_DIR$/docs/src/docs/userguide/creating-server.xml"
pinned="false">
+ <entry
file="file://$PROJECT_DIR$/packaging/src/main/net/dpml/iso8583/packaging/XmlPackager.java"
pinned="false">
<provider selected="true" editor-type-id="text-editor">
- <state line="46" column="11" selection-start="1860"
selection-end="1860" vertical-scroll-proportion="0.8834827">
+ <state line="39" column="34" selection-start="1173"
selection-end="1173" vertical-scroll-proportion="0.36491677">
<folding />
</state>
</provider>
</entry>
- <entry
file="file://$PROJECT_DIR$/docs/src/docs/reference/definitions.xml"
pinned="false">
+ <entry
file="file://$PROJECT_DIR$/packaging/src/main/net/dpml/iso8583/packaging/Visa1Packager.java"
pinned="false">
<provider selected="true" editor-type-id="text-editor">
- <state line="613" column="30" selection-start="31834"
selection-end="31834" vertical-scroll-proportion="0.3277849">
+ <state line="34" column="13" selection-start="1116"
selection-end="1116" vertical-scroll-proportion="0.2112676">
<folding />
</state>
</provider>
</entry>
- <entry file="file://$PROJECT_DIR$/docs/src/docs/navigation.xml"
pinned="false">
+ <entry
file="file://$PROJECT_DIR$/channels/src/main/net/dpml/iso8583/channels/XmlChannel.java"
pinned="false">
<provider selected="true" editor-type-id="text-editor">
- <state line="35" column="0" selection-start="1120"
selection-end="1120" vertical-scroll-proportion="0.6722151">
+ <state line="35" column="13" selection-start="1153"
selection-end="1153" vertical-scroll-proportion="0.2112676">
<folding />
</state>
</provider>
</entry>
- <entry
file="file://$PROJECT_DIR$/docs/src/docs/reference/navigation.xml"
pinned="false">
+ <entry
file="file://$PROJECT_DIR$/docs/src/docs/userguide/creating-client.xml"
pinned="false">
<provider selected="true" editor-type-id="text-editor">
- <state line="18" column="0" selection-start="39"
selection-end="624" vertical-scroll-proportion="0.34571064">
+ <state line="38" column="75" selection-start="1543"
selection-end="1543" vertical-scroll-proportion="0.72983354">
<folding />
</state>
</provider>
</entry>
- <entry
file="file://$PROJECT_DIR$/docs/src/docs/userguide/navigation.xml"
pinned="false">
+ <entry file="file://$PROJECT_DIR$/docs/src/docs/userguide/index.xml"
pinned="false">
<provider selected="true" editor-type-id="text-editor">
- <state line="27" column="64" selection-start="892"
selection-end="892" vertical-scroll-proportion="0.51856595">
+ <state line="22" column="0" selection-start="770"
selection-end="770" vertical-scroll-proportion="0.4225352">
<folding />
</state>
</provider>
</entry>
- <entry
file="file://$PROJECT_DIR$/network/src/main/net/dpml/iso8583/network/impl/DefaultNetworkService.java"
pinned="false">
+ <entry
file="file://$PROJECT_DIR$/docs/src/docs/userguide/navigation.xml"
pinned="false">
<provider selected="true" editor-type-id="text-editor">
- <state line="25" column="13" selection-start="958"
selection-end="958" vertical-scroll-proportion="0.48015365">
- <folding>
- <element signature="imports" expanded="true" />
- </folding>
+ <state line="22" column="0" selection-start="682"
selection-end="682" vertical-scroll-proportion="0.4225352">
+ <folding />
</state>
</provider>
</entry>
@@ -240,26 +238,14 @@
</component>
<component name="NamedScopeManager" />
<component name="PackagesPane" />
- <component name="ProjectPane">
- <expanded_node
url="file://$PROJECT_DIR$/packaging/src/main/net/dpml/iso8583/packaging"
module="packaging" type="directory" />
- <expanded_node url="file://$PROJECT_DIR$/docs/src/docs/reference"
module="docs" type="directory" />
- <expanded_node url="file://$PROJECT_DIR$/packaging/src/main"
module="packaging" type="directory" />
- <expanded_node url="file://$PROJECT_DIR$/packaging" module="packaging"
type="directory" />
- <expanded_node url="file://$PROJECT_DIR$/docs/src/docs/userguide"
module="docs" type="directory" />
- <expanded_node url="file://$PROJECT_DIR$/docs/src" module="docs"
type="directory" />
- <expanded_node url="" module="packaging" type="module" />
- <expanded_node url="" module="docs" type="module" />
- <expanded_node url="file://$PROJECT_DIR$/docs" module="docs"
type="directory" />
- <expanded_node url="file://$PROJECT_DIR$/packaging/src"
module="packaging" type="directory" />
- <expanded_node url="file://$PROJECT_DIR$/docs/src/docs" module="docs"
type="directory" />
- </component>
+ <component name="ProjectPane" />
<component name="ProjectView">
<navigator currentView="ProjectPane" splitterProportion="0.5">
<flattenPackages PackagesPane="false" ProjectPane="true" />
<showMembers PackagesPane="false" />
<showModules PackagesPane="true" />
<showLibraryContents PackagesPane="false" />
- <hideEmptyPackages PackagesPane="true" />
+ <hideEmptyPackages PackagesPane="true" ProjectPane="true" />
<showStructure PackagesPane="false" ProjectPane="false" />
<autoscrollToSource />
<autoscrollFromSource />
@@ -472,109 +458,107 @@
<option name="FILTER_TARGETS" value="false" />
</component>
<component name="editorHistoryManager">
- <entry
file="file://$PROJECT_DIR$/api/src/main/net/dpml/iso8583/network/NetworkService.java">
+ <entry file="file://$PROJECT_DIR$/docs/src/docs/index.xml">
<provider selected="true" editor-type-id="text-editor">
- <state line="38" column="0" selection-start="1125"
selection-end="1125" vertical-scroll-proportion="0.6363636">
+ <state line="22" column="0" selection-start="770"
selection-end="770" vertical-scroll-proportion="0.4308094">
<folding />
</state>
</provider>
</entry>
- <entry file="file://$PROJECT_DIR$/index.xml">
+ <entry file="file://$PROJECT_DIR$/docs/src/docs/navigation.xml">
<provider selected="true" editor-type-id="text-editor">
- <state line="196" column="55" selection-start="6178"
selection-end="6178" vertical-scroll-proportion="1.1414142">
+ <state line="22" column="0" selection-start="682"
selection-end="682" vertical-scroll-proportion="0.4225352">
<folding />
</state>
</provider>
</entry>
- <entry
file="file://$PROJECT_DIR$/elements/src/main/net/dpml/iso8583/data/elements/ActionCode.java">
+ <entry file="file://$PROJECT_DIR$/docs/src/docs/reference/channels.xml">
<provider selected="true" editor-type-id="text-editor">
- <state line="254" column="128" selection-start="14006"
selection-end="14006" vertical-scroll-proportion="4.543081">
+ <state line="22" column="0" selection-start="770"
selection-end="770" vertical-scroll-proportion="0.4225352">
<folding />
</state>
</provider>
</entry>
- <entry
file="file:///home/niclas/dev/dpml/development/central/site/src/docs/index.xml">
+ <entry
file="file://$PROJECT_DIR$/docs/src/docs/reference/dataelements.xml">
<provider selected="true" editor-type-id="text-editor">
- <state line="13" column="0" selection-start="267"
selection-end="307" vertical-scroll-proportion="0.24253732">
+ <state line="22" column="0" selection-start="770"
selection-end="770" vertical-scroll-proportion="0.4225352">
<folding />
</state>
</provider>
</entry>
- <entry
file="file:///home/niclas/dev/dpml/development/central/site/src/docs/navigation.xml">
+ <entry
file="file://$PROJECT_DIR$/docs/src/docs/reference/definitions.xml">
<provider selected="true" editor-type-id="text-editor">
- <state line="50" column="0" selection-start="0" selection-end="1534"
vertical-scroll-proportion="0.9328358">
+ <state line="29" column="0" selection-start="992"
selection-end="992" vertical-scroll-proportion="0.5569782">
<folding />
</state>
</provider>
</entry>
- <entry file="file://$PROJECT_DIR$/docs/src/docs/navigation.xml">
+ <entry file="file://$PROJECT_DIR$/docs/src/docs/reference/index.xml">
<provider selected="true" editor-type-id="text-editor">
- <state line="35" column="0" selection-start="1120"
selection-end="1120" vertical-scroll-proportion="0.6722151">
+ <state line="22" column="0" selection-start="770"
selection-end="770" vertical-scroll-proportion="0.4308094">
<folding />
</state>
</provider>
</entry>
- <entry file="file://$PROJECT_DIR$/docs/src/docs/index.xml">
+ <entry file="file://$PROJECT_DIR$/docs/src/docs/reference/mti.xml">
<provider selected="true" editor-type-id="text-editor">
- <state line="5" column="0" selection-start="138" selection-end="180"
vertical-scroll-proportion="0.097911224">
+ <state line="22" column="0" selection-start="770"
selection-end="770" vertical-scroll-proportion="0.4225352">
<folding />
</state>
</provider>
</entry>
- <entry
file="file://$PROJECT_DIR$/network/src/main/net/dpml/iso8583/network/impl/DefaultNetworkService.java">
+ <entry
file="file://$PROJECT_DIR$/docs/src/docs/reference/navigation.xml">
<provider selected="true" editor-type-id="text-editor">
- <state line="25" column="13" selection-start="958"
selection-end="958" vertical-scroll-proportion="0.48015365">
- <folding>
- <element signature="imports" expanded="true" />
- </folding>
+ <state line="32" column="54" selection-start="1083"
selection-end="1083" vertical-scroll-proportion="0.61459666">
+ <folding />
</state>
</provider>
</entry>
<entry
file="file://$PROJECT_DIR$/docs/src/docs/userguide/navigation.xml">
<provider selected="true" editor-type-id="text-editor">
- <state line="27" column="64" selection-start="892"
selection-end="892" vertical-scroll-proportion="0.51856595">
+ <state line="22" column="0" selection-start="682"
selection-end="682" vertical-scroll-proportion="0.4225352">
<folding />
</state>
</provider>
</entry>
- <entry file="file://$PROJECT_DIR$/docs/src/docs/reference/index.xml">
+ <entry file="file://$PROJECT_DIR$/docs/src/docs/userguide/index.xml">
<provider selected="true" editor-type-id="text-editor">
- <state line="0" column="0" selection-start="0" selection-end="0"
vertical-scroll-proportion="0.0">
+ <state line="22" column="0" selection-start="770"
selection-end="770" vertical-scroll-proportion="0.4225352">
<folding />
</state>
</provider>
</entry>
- <entry file="file://$PROJECT_DIR$/docs/src/docs/userguide/index.xml">
+ <entry
file="file://$PROJECT_DIR$/docs/src/docs/userguide/creating-client.xml">
<provider selected="true" editor-type-id="text-editor">
- <state line="0" column="0" selection-start="0" selection-end="0"
vertical-scroll-proportion="0.0">
+ <state line="38" column="75" selection-start="1543"
selection-end="1543" vertical-scroll-proportion="0.72983354">
<folding />
</state>
</provider>
</entry>
- <entry
file="file://$PROJECT_DIR$/docs/src/docs/userguide/creating-client.xml">
+ <entry
file="file://$PROJECT_DIR$/channels/src/main/net/dpml/iso8583/channels/XmlChannel.java">
<provider selected="true" editor-type-id="text-editor">
- <state line="11" column="0" selection-start="304"
selection-end="304" vertical-scroll-proportion="0.2112676">
+ <state line="35" column="13" selection-start="1153"
selection-end="1153" vertical-scroll-proportion="0.2112676">
<folding />
</state>
</provider>
</entry>
- <entry
file="file://$PROJECT_DIR$/docs/src/docs/reference/navigation.xml">
+ <entry
file="file://$PROJECT_DIR$/packaging/src/main/net/dpml/iso8583/packaging/Visa1Packager.java">
<provider selected="true" editor-type-id="text-editor">
- <state line="18" column="0" selection-start="39" selection-end="624"
vertical-scroll-proportion="0.34571064">
+ <state line="34" column="13" selection-start="1116"
selection-end="1116" vertical-scroll-proportion="0.2112676">
<folding />
</state>
</provider>
</entry>
- <entry
file="file://$PROJECT_DIR$/docs/src/docs/userguide/creating-server.xml">
+ <entry
file="file://$PROJECT_DIR$/packaging/src/main/net/dpml/iso8583/packaging/XmlPackager.java">
<provider selected="true" editor-type-id="text-editor">
- <state line="46" column="11" selection-start="1860"
selection-end="1860" vertical-scroll-proportion="0.8834827">
+ <state line="39" column="34" selection-start="1173"
selection-end="1173" vertical-scroll-proportion="0.36491677">
<folding />
</state>
</provider>
</entry>
- <entry
file="file://$PROJECT_DIR$/docs/src/docs/reference/definitions.xml">
+ <entry
file="file://$PROJECT_DIR$/docs/src/docs/userguide/creating-server.xml">
<provider selected="true" editor-type-id="text-editor">
- <state line="613" column="30" selection-start="31834"
selection-end="31834" vertical-scroll-proportion="0.3277849">
+ <state line="96" column="49" selection-start="4230"
selection-end="4230" vertical-scroll-proportion="0.86555696">
<folding />
</state>
</provider>

Modified:
development/laboratory/users/niclas/iso8583/packaging/src/main/net/dpml/iso8583/packaging/Visa1Packager.java
==============================================================================
---
development/laboratory/users/niclas/iso8583/packaging/src/main/net/dpml/iso8583/packaging/Visa1Packager.java
(original)
+++
development/laboratory/users/niclas/iso8583/packaging/src/main/net/dpml/iso8583/packaging/Visa1Packager.java
Fri May 13 09:22:00 2005
@@ -18,19 +18,15 @@

package net.dpml.iso8583.packaging;

-import java.util.StringTokenizer;
-
+import net.dpml.iso8583.comm.Packager;
import net.dpml.logging.Logger;
-
import net.dpml.parameters.ParameterException;
import net.dpml.parameters.Parameters;
-
import net.dpml.service.ServiceException;
-import net.dpml.service.ServiceManager;
-import net.dpml.iso8583.comm.Packager;
-
import org.jpos.iso.ISOPackager;

+import java.util.StringTokenizer;
+
/** Metro Wrapper for the VISA1 Packager in JPos.
*
* @metro.component name="visa1-packager" lifestyle="singleton"



  • svn commit: r2528 - in development/laboratory/users/niclas/iso8583: . channels/src/main/net/dpml/iso8583/channels docs/src/docs docs/src/docs/reference docs/src/docs/userguide guide-src guide-src/src guide-src/src/main packaging/src/main/net/dpml/iso8583/packaging, niclas, 05/13/2005

Archive powered by MHonArc 2.6.24.

Top of Page