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