Example showing how to create a X12 transaction from scratch.

Context c = new Context('˜', '*', ':');
X12 x12 = new X12(c);
Loop loop_isa = x12.addChild("ISA");

// Add ISA segment to the loop
loop_isa.addSegment("ISA*00*          00          ZZ*SENDERID       *"
        + "ZZ*RECEIVERID    *030409*0701*U*00401*0000000001*0*T:");

// Add GS child loop to ISA loop
Loop loop_gs = loop_isa.addChild("GS");
// Add GS segment directly as a string
loop_gs.addSegment("GS*1212*SENDERID*RECEIVERID*0701*000000001*X*00401");

Loop loop_st = loop_gs.addChild("ST");
loop_st.addSegment("ST*835*000000001");
loop_st.addSegment("BPR*DATA*NOT*VALID*RANDOM*TEXT");
loop_st.addSegment("TRN*1*0000000000*1999999999");
loop_st.addSegment("DTM*111*20090915");

Loop loop_1000A = loop_st.addChild("1000A");
loop_1000A.addSegment("N1*PR*ALWAYS INSURANCE COMPANY");
loop_1000A.addSegment("N7*AROUND THE CORNER");
loop_1000A.addSegment("N4*SHINE CITY*GREEN STATE*ZIP");
loop_1000A.addSegment("REF*DT*435864864");

Loop loop_1000B = loop_st.addChild("1000B");
loop_1000B
        .addSegment("N1*PE*FI*888888888*P.O.BOX 456*SHINE CITY*GREEN STATE*ZIP*EARTH");

Loop loop_2000 = loop_st.addChild("2000");
loop_2000.addSegment("LX*1");

Loop loop_2010_1 = loop_2000.addChild("2010");
loop_2010_1.addSegment("CLP*PCN123456789**5555.55**CCN987654321");
loop_2010_1.addSegment("CAS*PR*909099*100.00");
loop_2010_1.addSegment("NM1*QC*1*PATIENT*TREATED*ONE***34*333333333");
loop_2010_1.addSegment("DTM*273*20020824");
loop_2010_1.addSegment("AMT*A1*10.10");
loop_2010_1.addSegment("AMT*A2*20.20");

Loop loop_2010_2 = loop_2000.addChild("2010");
loop_2010_2.addSegment("LX*2");
loop_2010_2.addSegment("CLP*PCN123456789**4444.44**CCN987654321");
loop_2010_2.addSegment("CAS*PR*909099*200.00");
loop_2010_2.addSegment("NM1*QC*1*PATIENT*TREATED*TWO***34*444444444");
loop_2010_2.addSegment("DTM*273*20020824");
loop_2010_2.addSegment("AMT*A1*30.30");
loop_2010_2.addSegment("AMT*A2*40.40");

Loop loop_se = loop_gs.addChild("SE");
loop_se.addSegment("SE*XX*000000001");

Loop loop_ge = loop_isa.addChild("GE");
loop_ge.addSegment("GE*1*000000001");

Loop loop_iea = x12.addChild("IEA");
loop_iea.addSegment("IEA*1*000000001");

// Since the SE loop has the incorrect segment count let us fix that.
Integer count = loop_st.size();
count += 1; // In the loop hierarchy SE is not a child loop of ST. So
// when we get the rows in ST loop it does not have the count of SE.
// so add 1.

// We can set the count directly, like
// loop_se.getSegment(0).setElement(1, count.toString());
// this is just to show how to use the findLoop()
List<Loop> trailer = x12.findLoop("SE");
trailer.get(0).getSegment(0).setElement(1, count.toString());

//another way
List<Segment> se = x12.findSegment("SE");
se.get(0).setElement(1, count.toString());

//another way
loop_se.getSegment(0).setElement(1, count.toString());

System.out.println(loop_st.size());
System.out.println(x12.toString());
System.out.println(x12.toXML());

Example showing how to create a X12 transaction from scratch.

Example of creating a X12 transaction

//Create a X12 context. Set the segment, element and sub-element separator
Context c = new Context('~','*',':');

//Create a X12 passing the context
X12Simple x = new X12Simple(c);

//Add a segment to the X12
Segment s = x.addSegment();

//Add elements to the segment
s.addElement("ISA");
s.addElement("00");
...
//Continue to add segments and then add elements
s = x.addSegment();
s.addElement("GS");
s.addElement("121");
...

//Convert X12Simple object to X12 string representation
String x12 = x.toString();

//Convert X12 object to XML string representation if that is what you need
String xml = x.toXML();

Example showing how to create a X12 transaction from scratch.

Example of creating a X12 transaction

//Create a X12 context. Set the segment, element and sub-element separator
Context c = new Context('˜','*',':');

//Create a X12 transaction passing the context
X12Simple x = new X12Simple(c);

//Add a segments to the X12 transaction
Segment s = x.addSegment("ISA*00*          00      .... T*:");
s = x.addSegment("GS*1212*SENDERID* ... X*00401");
s = x.addSegment("ST*835*000000000");

//Modify one of the elements in ST segment just added
s.setElement(2,"000000001");

//Add an empty segment and then add elements
s = x.addSegment();
s.addElement('BPR');
s.addElement('DATA');
s.addElement('NOT');
...
...
//Convert X12 object to string representation
String x12 = x.toString();

//Convert X12 object to XML string representation if that is what you need
String xml = x.toXML();

Example showing X12 Parser reading a X12 file and looping over the segments.

Example of parsing a X12 file

This is the loop hierarchy of a 835 transaction used here.

+--X12
|  +--ISA - ISA
|  |  +--GS - GS
|  |  |  +--ST - ST - 835, - 1
|  |  |  |  +--1000A - N1 - PR, - 1
|  |  |  |  +--1000B - N1 - PE, - 1
|  |  |  |  +--2000 - LX
|  |  |  |  |  +--2100 - CLP
|  |  |  |  |  |  +--2110 - SVC
|  |  |  +--SE - SE
|  |  +--GE - GE
|  +--IEA - IEA

Cf cf835 = loadCf();
Parser parser = new X12Parser(cf835);
// The configuration Cf can be loaded using DI framework.
// Check the sample spring application context file provided.

Double totalChargeAmount = 0.0;
X12 x12 = (X12) parser.parse(new File("C:\test\835.txt"));
List<Segment> segments = x12.findSegment("CLP");
for (Segment s : segments) {
    totalChargeAmount = totalChargeAmount + Double.parseDouble(s.getElement(3));
}
System.out.println("Total Change Amount " + s.getElement(3));

Example of how to create a configuration object for the above hierarchy

private static Cf loadCf() {
    Cf cfX12 = new Cf("X12");
    Cf cfISA = cfX12.addChild("ISA", "ISA");
    Cf cfGS = cfISA.addChild("GS", "GS");
    Cf cfST = cfGS.addChild("ST", "ST", "835", 1);
    cfST.addChild("1000A", "N1", "PR", 1);
    cfST.addChild("1000B", "N1", "PE", 1);
    Cf cf2000 = cfST.addChild("2000", "LX");
    Cf cf2100 = cf2000.addChild("2100", "CLP");
    cf2100.addChild("2110", "SVC");
    cfISA.addChild("GE", "GE");
    cfX12.addChild("IEA", "IEA");
    //System.out.println(cfX12);
    return cfX12;
}

Example showing X12 Parser reading a X12 file and looping over the segments.

Example of parsing a X12 InputStream.

This is the modified loop hierarchy of a 835 transaction used in this example.
The original/actual hierarchy is in example exampleParseX12FileTwo.
This just illustrates different ways you can setup the hierarchy to achieve
the desired results.
Note: Such a hierarchy change will work only when there is not more than
one Loop with the same identifiers. For e.g. in an 837 transaction both
Loop 2010BA (Subscriber) and 2330A (Other Subscriber) have the same identifiers,
which are segment id NM1 and IL at position NM102 (or index 1). This might
cause the parser to identify both elements as the same loop. In such cases
it is advisable to maintain the hierarchy.

 +--X12
 |  +--ISA - ISA
 |  +--GS - GS
 |  +--ST - ST - 835, - 1
 |  +--1000A - N1 - PR, - 1
 |  +--1000B - N1 - PE, - 1
 |  +--2000 - LX
 |  +--2100 - CLP
 |  +--2110 - SVC
 |  +--SE - SE
 |  +--GE - GE
 |  +--IEA - IEA

Cf cf835 = loadCf();
Parser parser = new X12Parser(cf835);
// The configuration Cf can be loaded using DI framework.
// Check the sample spring application context file provided.

Double totalChargeAmount = 0.0;
X12 x12 = (X12) parser.parse(new File("C:\test\835.txt"));
List<Segment> segments = x12.findSegment("CLP");
for (Segment s : segments) {
    totalChargeAmount = totalChargeAmount + Double.parseDouble(s.getElement(3));
}
System.out.println("Total Change Amount " + s.getElement(3));

// Simple configuration, single level hierarchy
// Alternately can be loaded using Spring/DI
private static Cf loadCf() {
        Cf cfX12 = new Cf("X12");
        cfX12.addChild("ISA", "ISA");
        cfX12.addChild("GS", "GS");
        cfX12.addChild("ST", "ST", "835", 1);
        cfX12.addChild("1000A", "N1", "PR", 1);
        cfX12.addChild("1000B", "N1", "PE", 1);
        cfX12.addChild("2000", "LX");
        cfX12.addChild("2100", "CLP");
        cfX12.addChild("2110", "SVC");
        cfX12.addChild("GE", "GE");
        cfX12.addChild("IEA", "IEA");

        //System.out.println(cfX12);
        return cfX12;
}

Example showing X12 Parser reading a X12 file and looping over the segments.

Example of parsing a X12 file

This is the modified loop hierarchy of a 835 transaction used in this example.
The original/actual hierarchy is in example exampleParseX12FileTwo.
This just illustrates different ways you can setup the hierarchy to achieve
the desired results.
Note: Such a hierarchy change will work only when there is not more than
one Loop with the same identifiers. For e.g. in an 837 transaction both
Loop 2010BA (Subscriber) and 2330A (Other Subscriber) have the same identifiers,
which are segment id NM1 and IL at position NM102 (or index 1). This might
cause the parser to identify both elements as the same loop. In such cases
it is advisable to maintain the hierarchy.

 +--X12
 |  +--ISA - ISA
 |  +--GS - GS
 |  +--ST - ST - 835, - 1
 |  +--1000A - N1 - PR, - 1
 |  +--1000B - N1 - PE, - 1
 |  +--2000 - LX
 |  +--2100 - CLP
 |  +--2110 - SVC
 |  +--SE - SE
 |  +--GE - GE
 |  +--IEA - IEA

Cf cf835 = loadCf();
Parser parser = new X12Parser(cf835);
// The configuration Cf can be loaded using DI framework.
// Check the sample spring application context file provided.

Double totalChargeAmount = 0.0;
X12 x12 = (X12) parser.parse(new File("C:\test\835.txt"));
List segments = x12.findSegment("CLP");
for (Segment s : segments) {
    totalChargeAmount = totalChargeAmount + Double.parseDouble(s.getElement(3));
}
System.out.println("Total Change Amount " + s.getElement(3));

Example showing X12Simple Parser reading a X12 file and looping over the segments.

Example of parsing a X12 file

X12Simple x12 = (X12Simple) new X12SimpleParser().parse(new File("C:\test\835.txt"));
for (Segment s : x12) {
    if (s.getElement(0).equals("CLP")) {
        System.out.println("Total Change Amount " + s.getElement(3));
    }
}

Example showing X12Simple Parser reading a X12 String and looping over the segments.

Example of parsing a X12 String

X12Simple x12 = new X12SimpleParser().parse("ISA*00*          00          *ZZ*SENDERID ......... "));
for (Segment s : x12) {
    if (s.getElement(0).equals("CLP")) {
        System.out.println("Total Change Amount " + s.getElement(3));
    }
}

Example showing X12 Parser reading a X12 file and looping over the segments.

Example of using Spring to load the configuration

This is the loop hierarchy of a 835 transaction used here.

+--X12
|  +--ISA - ISA
|  |  +--GS - GS
|  |  |  +--ST - ST - 835, - 1
|  |  |  |  +--1000A - N1 - PR, - 1
|  |  |  |  +--1000B - N1 - PE, - 1
|  |  |  |  +--2000 - LX
|  |  |  |  |  +--2100 - CLP
|  |  |  |  |  |  +--2110 - SVC
|  |  |  +--SE - SE
|  |  +--GE - GE
|  +--IEA - IEA

Cf cf835 = loadCf();
Parser parser = new X12Parser(cf835);
// The configuration Cf can be loaded using DI framework.
// Check this example to see how to load configuration using Spring.

Double totalChargeAmount = 0.0;
X12 x12 = (X12) parser.parse(new File("C:\test\835.txt"));
List segments = x12.findSegment("CLP");
for (Segment s : segments) {
    totalChargeAmount = totalChargeAmount + Double.parseDouble(s.getElement(3));
}
System.out.println("Total Change Amount " + s.getElement(3));