001/*
002 * This class is an auto-generated source file for a HAPI
003 * HL7 v2.x standard structure class.
004 *
005 * For more information, visit: http://hl7api.sourceforge.net/
006 * 
007 * The contents of this file are subject to the Mozilla Public License Version 1.1 
008 * (the "License"); you may not use this file except in compliance with the License. 
009 * You may obtain a copy of the License at http://www.mozilla.org/MPL/ 
010 * Software distributed under the License is distributed on an "AS IS" basis, 
011 * WITHOUT WARRANTY OF ANY KIND, either express or implied. See the License for the 
012 * specific language governing rights and limitations under the License. 
013 * 
014 * The Original Code is "[file_name]".  Description: 
015 * "[one_line_description]" 
016 * 
017 * The Initial Developer of the Original Code is University Health Network. Copyright (C) 
018 * 2012.  All Rights Reserved. 
019 * 
020 * Contributor(s): ______________________________________. 
021 * 
022 * Alternatively, the contents of this file may be used under the terms of the 
023 * GNU General Public License (the  "GPL"), in which case the provisions of the GPL are 
024 * applicable instead of those above.  If you wish to allow use of your version of this 
025 * file only under the terms of the GPL and not to allow others to use your version 
026 * of this file under the MPL, indicate your decision by deleting  the provisions above 
027 * and replace  them with the notice and other provisions required by the GPL License.  
028 * If you do not delete the provisions above, a recipient may use your version of 
029 * this file under either the MPL or the GPL. 
030 * 
031 */
032
033
034package ca.uhn.hl7v2.model.v25.group;
035
036import ca.uhn.hl7v2.model.v25.segment.*;
037
038import java.util.List;
039
040import ca.uhn.hl7v2.HL7Exception;
041import ca.uhn.hl7v2.parser.ModelClassFactory;
042import ca.uhn.hl7v2.model.*;
043
044/**
045 * <p>Represents a OML_O21_OBSERVATION_REQUEST group structure (a Group object).
046 * A Group is an ordered collection of message segments that can repeat together or be optionally in/excluded together.
047 * This Group contains the following elements:  
048 * </p>
049 * <ul>
050                 * <li>1: OBR (Observation Request) <b> </b></li>
051                 * <li>2: TCD (Test Code Detail) <b>optional </b></li>
052                 * <li>3: NTE (Notes and Comments) <b>optional repeating</b></li>
053                 * <li>4: CTD (Contact Data) <b>optional </b></li>
054                 * <li>5: DG1 (Diagnosis) <b>optional repeating</b></li>
055                 * <li>6: OML_O21_OBSERVATION (a Group object) <b>optional repeating</b></li>
056                 * <li>7: OML_O21_SPECIMEN (a Group object) <b>optional repeating</b></li>
057                 * <li>8: OML_O21_PRIOR_RESULT (a Group object) <b>optional repeating</b></li>
058 * </ul>
059 */
060@SuppressWarnings("unused")
061public class OML_O21_OBSERVATION_REQUEST extends AbstractGroup {
062
063    /** 
064     * Creates a new OML_O21_OBSERVATION_REQUEST group
065     */
066    public OML_O21_OBSERVATION_REQUEST(Group parent, ModelClassFactory factory) {
067       super(parent, factory);
068       init(factory);
069    }
070
071    private void init(ModelClassFactory factory) {
072       try {
073                          this.add(OBR.class, true, false);
074                          this.add(TCD.class, false, false);
075                          this.add(NTE.class, false, true);
076                          this.add(CTD.class, false, false);
077                          this.add(DG1.class, false, true);
078                          this.add(OML_O21_OBSERVATION.class, false, true);
079                          this.add(OML_O21_SPECIMEN.class, false, true);
080                          this.add(OML_O21_PRIOR_RESULT.class, false, true);
081       } catch(HL7Exception e) {
082          log.error("Unexpected error creating OML_O21_OBSERVATION_REQUEST - this is probably a bug in the source code generator.", e);
083       }
084    }
085
086    /** 
087     * Returns "2.5"
088     */
089    public String getVersion() {
090       return "2.5";
091    }
092
093
094
095    /**
096     * Returns
097     * OBR (Observation Request) - creates it if necessary
098     */
099    public OBR getOBR() { 
100       OBR retVal = getTyped("OBR", OBR.class);
101       return retVal;
102    }
103
104
105
106
107    /**
108     * Returns
109     * TCD (Test Code Detail) - creates it if necessary
110     */
111    public TCD getTCD() { 
112       TCD retVal = getTyped("TCD", TCD.class);
113       return retVal;
114    }
115
116
117
118
119    /**
120     * Returns
121     * the first repetition of 
122     * NTE (Notes and Comments) - creates it if necessary
123     */
124    public NTE getNTE() { 
125       NTE retVal = getTyped("NTE", NTE.class);
126       return retVal;
127    }
128
129
130    /**
131     * Returns a specific repetition of
132     * NTE (Notes and Comments) - creates it if necessary
133     *
134     * @param rep The repetition index (0-indexed, i.e. the first repetition is at index 0)
135     * @throws HL7Exception if the repetition requested is more than one 
136     *     greater than the number of existing repetitions.
137     */
138    public NTE getNTE(int rep) { 
139       NTE retVal = getTyped("NTE", rep, NTE.class);
140       return retVal;
141    }
142
143    /** 
144     * Returns the number of existing repetitions of NTE 
145     */ 
146    public int getNTEReps() {  
147        return getReps("NTE");
148    } 
149
150    /** 
151     * <p>
152     * Returns a non-modifiable List containing all current existing repetitions of NTE.
153     * <p>
154     * <p>
155     * Note that unlike {@link #getNTE()}, this method will not create any reps
156     * if none are already present, so an empty list may be returned.
157     * </p>
158     */ 
159    public List<NTE> getNTEAll() throws HL7Exception {
160        return getAllAsList("NTE", NTE.class);
161    } 
162
163    /**
164     * Inserts a specific repetition of NTE (Notes and Comments)
165     * @see AbstractGroup#insertRepetition(Structure, int) 
166     */
167    public void insertNTE(NTE structure, int rep) throws HL7Exception { 
168       super.insertRepetition("NTE", structure, rep);
169    }
170
171
172    /**
173     * Inserts a specific repetition of NTE (Notes and Comments)
174     * @see AbstractGroup#insertRepetition(Structure, int) 
175     */
176    public NTE insertNTE(int rep) throws HL7Exception { 
177       return (NTE)super.insertRepetition("NTE", rep);
178    }
179
180
181    /**
182     * Removes a specific repetition of NTE (Notes and Comments)
183     * @see AbstractGroup#removeRepetition(String, int) 
184     */
185    public NTE removeNTE(int rep) throws HL7Exception { 
186       return (NTE)super.removeRepetition("NTE", rep);
187    }
188
189
190
191    /**
192     * Returns
193     * CTD (Contact Data) - creates it if necessary
194     */
195    public CTD getCTD() { 
196       CTD retVal = getTyped("CTD", CTD.class);
197       return retVal;
198    }
199
200
201
202
203    /**
204     * Returns
205     * the first repetition of 
206     * DG1 (Diagnosis) - creates it if necessary
207     */
208    public DG1 getDG1() { 
209       DG1 retVal = getTyped("DG1", DG1.class);
210       return retVal;
211    }
212
213
214    /**
215     * Returns a specific repetition of
216     * DG1 (Diagnosis) - creates it if necessary
217     *
218     * @param rep The repetition index (0-indexed, i.e. the first repetition is at index 0)
219     * @throws HL7Exception if the repetition requested is more than one 
220     *     greater than the number of existing repetitions.
221     */
222    public DG1 getDG1(int rep) { 
223       DG1 retVal = getTyped("DG1", rep, DG1.class);
224       return retVal;
225    }
226
227    /** 
228     * Returns the number of existing repetitions of DG1 
229     */ 
230    public int getDG1Reps() {  
231        return getReps("DG1");
232    } 
233
234    /** 
235     * <p>
236     * Returns a non-modifiable List containing all current existing repetitions of DG1.
237     * <p>
238     * <p>
239     * Note that unlike {@link #getDG1()}, this method will not create any reps
240     * if none are already present, so an empty list may be returned.
241     * </p>
242     */ 
243    public List<DG1> getDG1All() throws HL7Exception {
244        return getAllAsList("DG1", DG1.class);
245    } 
246
247    /**
248     * Inserts a specific repetition of DG1 (Diagnosis)
249     * @see AbstractGroup#insertRepetition(Structure, int) 
250     */
251    public void insertDG1(DG1 structure, int rep) throws HL7Exception { 
252       super.insertRepetition("DG1", structure, rep);
253    }
254
255
256    /**
257     * Inserts a specific repetition of DG1 (Diagnosis)
258     * @see AbstractGroup#insertRepetition(Structure, int) 
259     */
260    public DG1 insertDG1(int rep) throws HL7Exception { 
261       return (DG1)super.insertRepetition("DG1", rep);
262    }
263
264
265    /**
266     * Removes a specific repetition of DG1 (Diagnosis)
267     * @see AbstractGroup#removeRepetition(String, int) 
268     */
269    public DG1 removeDG1(int rep) throws HL7Exception { 
270       return (DG1)super.removeRepetition("DG1", rep);
271    }
272
273
274
275    /**
276     * Returns
277     * the first repetition of 
278     * OBSERVATION (a Group object) - creates it if necessary
279     */
280    public OML_O21_OBSERVATION getOBSERVATION() { 
281       OML_O21_OBSERVATION retVal = getTyped("OBSERVATION", OML_O21_OBSERVATION.class);
282       return retVal;
283    }
284
285
286    /**
287     * Returns a specific repetition of
288     * OBSERVATION (a Group object) - creates it if necessary
289     *
290     * @param rep The repetition index (0-indexed, i.e. the first repetition is at index 0)
291     * @throws HL7Exception if the repetition requested is more than one 
292     *     greater than the number of existing repetitions.
293     */
294    public OML_O21_OBSERVATION getOBSERVATION(int rep) { 
295       OML_O21_OBSERVATION retVal = getTyped("OBSERVATION", rep, OML_O21_OBSERVATION.class);
296       return retVal;
297    }
298
299    /** 
300     * Returns the number of existing repetitions of OBSERVATION 
301     */ 
302    public int getOBSERVATIONReps() {  
303        return getReps("OBSERVATION");
304    } 
305
306    /** 
307     * <p>
308     * Returns a non-modifiable List containing all current existing repetitions of OBSERVATION.
309     * <p>
310     * <p>
311     * Note that unlike {@link #getOBSERVATION()}, this method will not create any reps
312     * if none are already present, so an empty list may be returned.
313     * </p>
314     */ 
315    public List<OML_O21_OBSERVATION> getOBSERVATIONAll() throws HL7Exception {
316        return getAllAsList("OBSERVATION", OML_O21_OBSERVATION.class);
317    } 
318
319    /**
320     * Inserts a specific repetition of OBSERVATION (a Group object)
321     * @see AbstractGroup#insertRepetition(Structure, int) 
322     */
323    public void insertOBSERVATION(OML_O21_OBSERVATION structure, int rep) throws HL7Exception { 
324       super.insertRepetition("OBSERVATION", structure, rep);
325    }
326
327
328    /**
329     * Inserts a specific repetition of OBSERVATION (a Group object)
330     * @see AbstractGroup#insertRepetition(Structure, int) 
331     */
332    public OML_O21_OBSERVATION insertOBSERVATION(int rep) throws HL7Exception { 
333       return (OML_O21_OBSERVATION)super.insertRepetition("OBSERVATION", rep);
334    }
335
336
337    /**
338     * Removes a specific repetition of OBSERVATION (a Group object)
339     * @see AbstractGroup#removeRepetition(String, int) 
340     */
341    public OML_O21_OBSERVATION removeOBSERVATION(int rep) throws HL7Exception { 
342       return (OML_O21_OBSERVATION)super.removeRepetition("OBSERVATION", rep);
343    }
344
345
346
347    /**
348     * Returns
349     * the first repetition of 
350     * SPECIMEN (a Group object) - creates it if necessary
351     */
352    public OML_O21_SPECIMEN getSPECIMEN() { 
353       OML_O21_SPECIMEN retVal = getTyped("SPECIMEN", OML_O21_SPECIMEN.class);
354       return retVal;
355    }
356
357
358    /**
359     * Returns a specific repetition of
360     * SPECIMEN (a Group object) - creates it if necessary
361     *
362     * @param rep The repetition index (0-indexed, i.e. the first repetition is at index 0)
363     * @throws HL7Exception if the repetition requested is more than one 
364     *     greater than the number of existing repetitions.
365     */
366    public OML_O21_SPECIMEN getSPECIMEN(int rep) { 
367       OML_O21_SPECIMEN retVal = getTyped("SPECIMEN", rep, OML_O21_SPECIMEN.class);
368       return retVal;
369    }
370
371    /** 
372     * Returns the number of existing repetitions of SPECIMEN 
373     */ 
374    public int getSPECIMENReps() {  
375        return getReps("SPECIMEN");
376    } 
377
378    /** 
379     * <p>
380     * Returns a non-modifiable List containing all current existing repetitions of SPECIMEN.
381     * <p>
382     * <p>
383     * Note that unlike {@link #getSPECIMEN()}, this method will not create any reps
384     * if none are already present, so an empty list may be returned.
385     * </p>
386     */ 
387    public List<OML_O21_SPECIMEN> getSPECIMENAll() throws HL7Exception {
388        return getAllAsList("SPECIMEN", OML_O21_SPECIMEN.class);
389    } 
390
391    /**
392     * Inserts a specific repetition of SPECIMEN (a Group object)
393     * @see AbstractGroup#insertRepetition(Structure, int) 
394     */
395    public void insertSPECIMEN(OML_O21_SPECIMEN structure, int rep) throws HL7Exception { 
396       super.insertRepetition("SPECIMEN", structure, rep);
397    }
398
399
400    /**
401     * Inserts a specific repetition of SPECIMEN (a Group object)
402     * @see AbstractGroup#insertRepetition(Structure, int) 
403     */
404    public OML_O21_SPECIMEN insertSPECIMEN(int rep) throws HL7Exception { 
405       return (OML_O21_SPECIMEN)super.insertRepetition("SPECIMEN", rep);
406    }
407
408
409    /**
410     * Removes a specific repetition of SPECIMEN (a Group object)
411     * @see AbstractGroup#removeRepetition(String, int) 
412     */
413    public OML_O21_SPECIMEN removeSPECIMEN(int rep) throws HL7Exception { 
414       return (OML_O21_SPECIMEN)super.removeRepetition("SPECIMEN", rep);
415    }
416
417
418
419    /**
420     * Returns
421     * the first repetition of 
422     * PRIOR_RESULT (a Group object) - creates it if necessary
423     */
424    public OML_O21_PRIOR_RESULT getPRIOR_RESULT() { 
425       OML_O21_PRIOR_RESULT retVal = getTyped("PRIOR_RESULT", OML_O21_PRIOR_RESULT.class);
426       return retVal;
427    }
428
429
430    /**
431     * Returns a specific repetition of
432     * PRIOR_RESULT (a Group object) - creates it if necessary
433     *
434     * @param rep The repetition index (0-indexed, i.e. the first repetition is at index 0)
435     * @throws HL7Exception if the repetition requested is more than one 
436     *     greater than the number of existing repetitions.
437     */
438    public OML_O21_PRIOR_RESULT getPRIOR_RESULT(int rep) { 
439       OML_O21_PRIOR_RESULT retVal = getTyped("PRIOR_RESULT", rep, OML_O21_PRIOR_RESULT.class);
440       return retVal;
441    }
442
443    /** 
444     * Returns the number of existing repetitions of PRIOR_RESULT 
445     */ 
446    public int getPRIOR_RESULTReps() {  
447        return getReps("PRIOR_RESULT");
448    } 
449
450    /** 
451     * <p>
452     * Returns a non-modifiable List containing all current existing repetitions of PRIOR_RESULT.
453     * <p>
454     * <p>
455     * Note that unlike {@link #getPRIOR_RESULT()}, this method will not create any reps
456     * if none are already present, so an empty list may be returned.
457     * </p>
458     */ 
459    public List<OML_O21_PRIOR_RESULT> getPRIOR_RESULTAll() throws HL7Exception {
460        return getAllAsList("PRIOR_RESULT", OML_O21_PRIOR_RESULT.class);
461    } 
462
463    /**
464     * Inserts a specific repetition of PRIOR_RESULT (a Group object)
465     * @see AbstractGroup#insertRepetition(Structure, int) 
466     */
467    public void insertPRIOR_RESULT(OML_O21_PRIOR_RESULT structure, int rep) throws HL7Exception { 
468       super.insertRepetition("PRIOR_RESULT", structure, rep);
469    }
470
471
472    /**
473     * Inserts a specific repetition of PRIOR_RESULT (a Group object)
474     * @see AbstractGroup#insertRepetition(Structure, int) 
475     */
476    public OML_O21_PRIOR_RESULT insertPRIOR_RESULT(int rep) throws HL7Exception { 
477       return (OML_O21_PRIOR_RESULT)super.insertRepetition("PRIOR_RESULT", rep);
478    }
479
480
481    /**
482     * Removes a specific repetition of PRIOR_RESULT (a Group object)
483     * @see AbstractGroup#removeRepetition(String, int) 
484     */
485    public OML_O21_PRIOR_RESULT removePRIOR_RESULT(int rep) throws HL7Exception { 
486       return (OML_O21_PRIOR_RESULT)super.removeRepetition("PRIOR_RESULT", rep);
487    }
488
489
490
491}
492