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