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 "XCN.java".  Description:
015 * "Composite class XCN"
016 * 
017 * The Initial Developer of the Original Code is University Health Network. Copyright (C) 
018 * 2013.  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
033package ca.uhn.hl7v2.model.v24.datatype;
034
035import ca.uhn.hl7v2.model.DataTypeException;
036import ca.uhn.hl7v2.model.Message;
037import ca.uhn.hl7v2.model.Type;
038import ca.uhn.hl7v2.model.AbstractComposite;
039
040
041/**
042 * <p>Represents an HL7 XCN (extended composite ID number and name for persons) data type. 
043 * This type consists of the following components:</p>
044 * <ul>
045 * <li>ID number (ST) (ST)
046 * <li>family name (FN)
047 * <li>given name (ST)
048 * <li>second and further given names or initials thereof (ST)
049 * <li>suffix (e.g., JR or III) (ST)
050 * <li>prefix (e.g., DR) (ST)
051 * <li>degree (e.g., MD) (IS)
052 * <li>source table (IS)
053 * <li>assigning authority (HD)
054 * <li>name type code (ID)
055 * <li>identifier check digit (ST)
056 * <li>code identifying the check digit scheme employed (ID)
057 * <li>identifier type code (IS) (IS)
058 * <li>assigning facility (HD)
059 * <li>Name Representation code (ID)
060 * <li>name context (CE)
061 * <li>name validity range (DR)
062 * <li>name assembly order (ID)
063 * </ul>
064 */
065@SuppressWarnings("unused")
066public class XCN extends AbstractComposite {
067
068    private Type[] data;
069
070    /** 
071     * Creates a new XCN type
072     */
073    public XCN(Message message) {
074        super(message);
075        init();
076    }
077
078    private void init() {
079        data = new Type[18];    
080        data[0] = new ST(getMessage());
081        data[1] = new FN(getMessage());
082        data[2] = new ST(getMessage());
083        data[3] = new ST(getMessage());
084        data[4] = new ST(getMessage());
085        data[5] = new ST(getMessage());
086        data[6] = new IS(getMessage(), 0);
087        data[7] = new IS(getMessage(), 0);
088        data[8] = new HD(getMessage());
089        data[9] = new ID(getMessage(), 0);
090        data[10] = new ST(getMessage());
091        data[11] = new ID(getMessage(), 0);
092        data[12] = new IS(getMessage(), 0);
093        data[13] = new HD(getMessage());
094        data[14] = new ID(getMessage(), 0);
095        data[15] = new CE(getMessage());
096        data[16] = new DR(getMessage());
097        data[17] = new ID(getMessage(), 0);
098    }
099
100
101    /**
102     * Returns an array containing the data elements.
103     */
104    public Type[] getComponents() { 
105        return this.data; 
106    }
107
108    /**
109     * Returns an individual data component.
110     *
111     * @param number The component number (0-indexed)
112     * @throws DataTypeException if the given element number is out of range.
113     */
114    public Type getComponent(int number) throws DataTypeException { 
115
116        try { 
117            return this.data[number]; 
118        } catch (ArrayIndexOutOfBoundsException e) { 
119            throw new DataTypeException("Element " + number + " doesn't exist (Type " + getClass().getName() + " has only " + this.data.length + " components)"); 
120        } 
121    } 
122
123
124    /**
125     * Returns ID number (ST) (component 1).  This is a convenience method that saves you from 
126     * casting and handling an exception.
127     */
128    public ST getIDNumber() {
129       return getTyped(0, ST.class);
130    }
131
132    
133    /**
134     * Returns ID number (ST) (component 1).  This is a convenience method that saves you from 
135     * casting and handling an exception.
136     */
137    public ST getXcn1_IDNumber() {
138       return getTyped(0, ST.class);
139    }
140
141
142    /**
143     * Returns family name (component 2).  This is a convenience method that saves you from 
144     * casting and handling an exception.
145     */
146    public FN getFamilyName() {
147       return getTyped(1, FN.class);
148    }
149
150    
151    /**
152     * Returns family name (component 2).  This is a convenience method that saves you from 
153     * casting and handling an exception.
154     */
155    public FN getXcn2_FamilyName() {
156       return getTyped(1, FN.class);
157    }
158
159
160    /**
161     * Returns given name (component 3).  This is a convenience method that saves you from 
162     * casting and handling an exception.
163     */
164    public ST getGivenName() {
165       return getTyped(2, ST.class);
166    }
167
168    
169    /**
170     * Returns given name (component 3).  This is a convenience method that saves you from 
171     * casting and handling an exception.
172     */
173    public ST getXcn3_GivenName() {
174       return getTyped(2, ST.class);
175    }
176
177
178    /**
179     * Returns second and further given names or initials thereof (component 4).  This is a convenience method that saves you from 
180     * casting and handling an exception.
181     */
182    public ST getSecondAndFurtherGivenNamesOrInitialsThereof() {
183       return getTyped(3, ST.class);
184    }
185
186    
187    /**
188     * Returns second and further given names or initials thereof (component 4).  This is a convenience method that saves you from 
189     * casting and handling an exception.
190     */
191    public ST getXcn4_SecondAndFurtherGivenNamesOrInitialsThereof() {
192       return getTyped(3, ST.class);
193    }
194
195
196    /**
197     * Returns suffix (e.g., JR or III) (component 5).  This is a convenience method that saves you from 
198     * casting and handling an exception.
199     */
200    public ST getSuffixEgJRorIII() {
201       return getTyped(4, ST.class);
202    }
203
204    
205    /**
206     * Returns suffix (e.g., JR or III) (component 5).  This is a convenience method that saves you from 
207     * casting and handling an exception.
208     */
209    public ST getXcn5_SuffixEgJRorIII() {
210       return getTyped(4, ST.class);
211    }
212
213
214    /**
215     * Returns prefix (e.g., DR) (component 6).  This is a convenience method that saves you from 
216     * casting and handling an exception.
217     */
218    public ST getPrefixEgDR() {
219       return getTyped(5, ST.class);
220    }
221
222    
223    /**
224     * Returns prefix (e.g., DR) (component 6).  This is a convenience method that saves you from 
225     * casting and handling an exception.
226     */
227    public ST getXcn6_PrefixEgDR() {
228       return getTyped(5, ST.class);
229    }
230
231
232    /**
233     * Returns degree (e.g., MD) (component 7).  This is a convenience method that saves you from 
234     * casting and handling an exception.
235     */
236    public IS getDegreeEgMD() {
237       return getTyped(6, IS.class);
238    }
239
240    
241    /**
242     * Returns degree (e.g., MD) (component 7).  This is a convenience method that saves you from 
243     * casting and handling an exception.
244     */
245    public IS getXcn7_DegreeEgMD() {
246       return getTyped(6, IS.class);
247    }
248
249
250    /**
251     * Returns source table (component 8).  This is a convenience method that saves you from 
252     * casting and handling an exception.
253     */
254    public IS getSourceTable() {
255       return getTyped(7, IS.class);
256    }
257
258    
259    /**
260     * Returns source table (component 8).  This is a convenience method that saves you from 
261     * casting and handling an exception.
262     */
263    public IS getXcn8_SourceTable() {
264       return getTyped(7, IS.class);
265    }
266
267
268    /**
269     * Returns assigning authority (component 9).  This is a convenience method that saves you from 
270     * casting and handling an exception.
271     */
272    public HD getAssigningAuthority() {
273       return getTyped(8, HD.class);
274    }
275
276    
277    /**
278     * Returns assigning authority (component 9).  This is a convenience method that saves you from 
279     * casting and handling an exception.
280     */
281    public HD getXcn9_AssigningAuthority() {
282       return getTyped(8, HD.class);
283    }
284
285
286    /**
287     * Returns name type code (component 10).  This is a convenience method that saves you from 
288     * casting and handling an exception.
289     */
290    public ID getNameTypeCode() {
291       return getTyped(9, ID.class);
292    }
293
294    
295    /**
296     * Returns name type code (component 10).  This is a convenience method that saves you from 
297     * casting and handling an exception.
298     */
299    public ID getXcn10_NameTypeCode() {
300       return getTyped(9, ID.class);
301    }
302
303
304    /**
305     * Returns identifier check digit (component 11).  This is a convenience method that saves you from 
306     * casting and handling an exception.
307     */
308    public ST getIdentifierCheckDigit() {
309       return getTyped(10, ST.class);
310    }
311
312    
313    /**
314     * Returns identifier check digit (component 11).  This is a convenience method that saves you from 
315     * casting and handling an exception.
316     */
317    public ST getXcn11_IdentifierCheckDigit() {
318       return getTyped(10, ST.class);
319    }
320
321
322    /**
323     * Returns code identifying the check digit scheme employed (component 12).  This is a convenience method that saves you from 
324     * casting and handling an exception.
325     */
326    public ID getCodeIdentifyingTheCheckDigitSchemeEmployed() {
327       return getTyped(11, ID.class);
328    }
329
330    
331    /**
332     * Returns code identifying the check digit scheme employed (component 12).  This is a convenience method that saves you from 
333     * casting and handling an exception.
334     */
335    public ID getXcn12_CodeIdentifyingTheCheckDigitSchemeEmployed() {
336       return getTyped(11, ID.class);
337    }
338
339
340    /**
341     * Returns identifier type code (IS) (component 13).  This is a convenience method that saves you from 
342     * casting and handling an exception.
343     */
344    public IS getIdentifierTypeCode() {
345       return getTyped(12, IS.class);
346    }
347
348    
349    /**
350     * Returns identifier type code (IS) (component 13).  This is a convenience method that saves you from 
351     * casting and handling an exception.
352     */
353    public IS getXcn13_IdentifierTypeCode() {
354       return getTyped(12, IS.class);
355    }
356
357
358    /**
359     * Returns assigning facility (component 14).  This is a convenience method that saves you from 
360     * casting and handling an exception.
361     */
362    public HD getAssigningFacility() {
363       return getTyped(13, HD.class);
364    }
365
366    
367    /**
368     * Returns assigning facility (component 14).  This is a convenience method that saves you from 
369     * casting and handling an exception.
370     */
371    public HD getXcn14_AssigningFacility() {
372       return getTyped(13, HD.class);
373    }
374
375
376    /**
377     * Returns Name Representation code (component 15).  This is a convenience method that saves you from 
378     * casting and handling an exception.
379     */
380    public ID getNameRepresentationCode() {
381       return getTyped(14, ID.class);
382    }
383
384    
385    /**
386     * Returns Name Representation code (component 15).  This is a convenience method that saves you from 
387     * casting and handling an exception.
388     */
389    public ID getXcn15_NameRepresentationCode() {
390       return getTyped(14, ID.class);
391    }
392
393
394    /**
395     * Returns name context (component 16).  This is a convenience method that saves you from 
396     * casting and handling an exception.
397     */
398    public CE getNameContext() {
399       return getTyped(15, CE.class);
400    }
401
402    
403    /**
404     * Returns name context (component 16).  This is a convenience method that saves you from 
405     * casting and handling an exception.
406     */
407    public CE getXcn16_NameContext() {
408       return getTyped(15, CE.class);
409    }
410
411
412    /**
413     * Returns name validity range (component 17).  This is a convenience method that saves you from 
414     * casting and handling an exception.
415     */
416    public DR getNameValidityRange() {
417       return getTyped(16, DR.class);
418    }
419
420    
421    /**
422     * Returns name validity range (component 17).  This is a convenience method that saves you from 
423     * casting and handling an exception.
424     */
425    public DR getXcn17_NameValidityRange() {
426       return getTyped(16, DR.class);
427    }
428
429
430    /**
431     * Returns name assembly order (component 18).  This is a convenience method that saves you from 
432     * casting and handling an exception.
433     */
434    public ID getNameAssemblyOrder() {
435       return getTyped(17, ID.class);
436    }
437
438    
439    /**
440     * Returns name assembly order (component 18).  This is a convenience method that saves you from 
441     * casting and handling an exception.
442     */
443    public ID getXcn18_NameAssemblyOrder() {
444       return getTyped(17, ID.class);
445    }
446
447
448
449}
450