383
301
@SuppressWarnings("serial")
384
302
protected class SkipContactException extends Exception { }
386
private String extractCollonPartFromLine( ByteBuffer buffer,
387
String line, boolean former )
391
// get a US-ASCII version of the line for processing, unless we were
395
line = new String( buffer.array(), buffer.position(),
396
buffer.limit() - buffer.position(), "US-ASCII" );
398
catch( UnsupportedEncodingException e ) {
399
// we know US-ASCII is supported, so appease the compiler...
404
// split line into name and value parts and check to make sure we
405
// only got 2 parts and that the first part is not zero in length
406
String[] parts = line.split( ":", 2 );
407
if( parts.length == 2 && parts[ 0 ].length() > 0 )
408
ret = parts[ former? 0 : 1 ];
413
private String extractNameAndParamsFromLine( ByteBuffer buffer,
416
return extractCollonPartFromLine( buffer, line, true );
419
private String extractValueFromLine( ByteBuffer buffer, String line )
421
return extractCollonPartFromLine( buffer, line, false );
424
public void parseLine( ByteBuffer buffer, String line,
425
boolean next_line_looks_folded )
426
throws ParseException, SkipContactException,
429
// do we have a version yet?
304
public void parseLine( String line )
305
throws ParseException, SkipContactException,
308
// ignore empty lines
309
if( line.trim() == "" ) return;
311
// split line into name and value parts (this may turn out to be
312
// unwanted if the line is a subsequent line in a multi-line
313
// value, but we have to do this now to check for and handle VCF
315
String[] props = line.split( ":", 2 );
316
for( int i = 0; i < props.length; i++ )
317
props[ i ] = props[ i ].trim();
319
// if we haven't yet got a version, we won't be paring anything!
430
320
if( _version == null )
432
// tentatively get name and params from line
433
String name_and_params =
434
extractNameAndParamsFromLine( buffer, line );
436
// is it a version line?
437
if( name_and_params != null &&
438
name_and_params.equals( "VERSION" ) )
322
// is this a version?
323
if( props.length == 2 && props[ 0 ].equals( "VERSION" ) )
441
String value = extractValueFromLine( buffer, line );
442
if( !value.equals( "2.1" ) && !value.equals( "3.0" ) )
325
// yes, check/store it
326
if( !props[ 1 ].equals( "2.1" ) &&
327
!props[ 1 ].equals( "3.0" ) )
443
328
throw new ParseException( R.string.error_vcf_version );
329
_version = props[ 1 ];
446
// parse any buffers we've been accumulating while we waited
448
if( _buffers != null )
449
for( int i = 0; i < _buffers.size(); i++ )
450
parseLine( _buffers.get( i ), null,
451
i + 1 < _buffers.size() &&
452
_buffers.get( i + 1 ).hasRemaining() &&
453
_buffers.get( i + 1 ).get(
454
_buffers.get( i + 1 ).position() ) == ' ' );
331
// parse any other lines we've accumulated so far
333
for( int i = 0; i < _lines.size(); i++ )
334
parseLine( _lines.get( i ) );
459
// no, so stash this line till we get a version
460
if( _buffers == null )
461
_buffers = new Vector< ByteBuffer >();
462
_buffers.add( buffer );
339
// no, so stash this line till we have a version
341
_lines = new Vector< String >();
467
// name and params and the position in the buffer where the
468
// "value" part of the line start
469
String name_and_params;
472
if( _parser_in_encoded_multiline ||
473
_parser_in_folded_multiline )
347
if( _parser_in_multiline )
475
349
// if we're currently in a multi-line value, use the stored
476
350
// property name and parameters
477
name_and_params = _parser_current_name_and_params;
479
pos = buffer.position();
481
// for folded multi-lines, skip the single space at the
482
// start of the next line
483
if( _parser_in_folded_multiline )
486
// else, this must be an encoded multi-line, so skip any
487
// whitespace we find at the start of the next line
489
while( pos < buffer.limit() && (
490
buffer.get( pos ) == ' ' ||
491
buffer.get( pos ) == '\t' ) )
351
props = new String[ 2 ];
352
props[ 0 ] = _parser_current_name_and_params;
353
props[ 1 ] = line.trim();
498
// get name and params from line, and since we're not
499
// parsing a subsequent line in a multi-line, this should
500
// not fail, or it's an error
502
extractNameAndParamsFromLine( buffer, line );
503
if( name_and_params == null )
357
// for normal lines, check the property name/value bits
358
if( props.length < 2 || props[ 0 ].length() == 0 )
504
359
throw new ParseException(
505
360
R.string.error_vcf_malformed );
507
// calculate how many chars to skip from beginning of line
508
// so we skip the property "name:" part
509
pos = buffer.position() + name_and_params.length() + 1;
362
// ignore empty properties
363
if( props[ 1 ].length() < 1 )
511
366
// reset the saved multi-line state
512
_parser_current_name_and_params = name_and_params;
367
_parser_current_name_and_params = props[ 0 ];
513
368
_parser_buffered_value_so_far = "";
516
// get value from buffer, as raw bytes
518
value = ByteBuffer.wrap( buffer.array(), pos,
519
buffer.limit() - pos );
521
371
// get parameter parts
522
String[] name_param_parts = name_and_params.split( ";", -1 );
523
for( int i = 0; i < name_param_parts.length; i++ )
524
name_param_parts[ i ] = name_param_parts[ i ].trim();
372
String[] params = props[ 0 ].split( ";" );
373
for( int i = 0; i < params.length; i++ )
374
params[ i ] = params[ i ].trim();
526
// parse encoding parameter
527
String encoding = checkParam( name_param_parts, "ENCODING" );
528
if( encoding != null ) encoding = encoding.toUpperCase();
529
if( encoding != null && !encoding.equals( "8BIT" ) &&
530
!encoding.equals( "QUOTED-PRINTABLE" ) )
376
// parse charset and encoding parameters
377
String charset, encoding;
378
if( ( charset = checkParam( params, "CHARSET" ) ) != null &&
379
!charset.equals( "UTF-8" ) && !charset.equals( "UTF-16" ) )
381
throw new ParseException( R.string.error_vcf_charset );
383
if( ( encoding = checkParam( params, "ENCODING" ) ) != null &&
384
!encoding.equals( "QUOTED-PRINTABLE" ) &&
385
!encoding.equals( "8BIT" ) )
531
386
//&& !encoding.equals( "BASE64" ) )
533
388
throw new ParseException( R.string.error_vcf_encoding );
536
// parse charset parameter
537
String charset = checkParam( name_param_parts, "CHARSET" );
538
if( charset != null ) charset = charset.toUpperCase();
539
if( charset != null && !charset.equals( "US-ASCII" ) &&
540
!charset.equals( "ASCII" ) &&
541
!charset.equals( "UTF-8" ) )
543
throw new ParseException( R.string.error_vcf_charset );
546
391
// do unencoding (or default to a fake unencoding result with
547
392
// the raw string)
548
UnencodeResult unencoding_result = null;
393
UnencodeResult result;
549
394
if( encoding != null && encoding.equals( "QUOTED-PRINTABLE" ) )
550
unencoding_result = unencodeQuotedPrintable( value );
395
result = unencodeQuotedPrintable( props[ 1 ], charset );
551
396
// else if( encoding != null && encoding.equals( "BASE64" ) )
552
// unencoding_result = unencodeBase64( props[ 1 ], charset );
553
if( unencoding_result != null ) {
554
value = unencoding_result.getBuffer();
555
_parser_in_encoded_multiline =
556
unencoding_result.isAnotherLineRequired();
559
// convert 8-bit ASCII charset to US-ASCII
560
if( charset == null || charset.equals( "ASCII" ) ) {
561
value = transcodeAsciiToUtf8( value );
397
// result = unencodeBase64( props[ 1 ], charset );
399
result = new UnencodeResult( false, props[ 1 ].getBytes(),
400
props[ 1 ].getBytes().length );
565
402
// process charset
568
string_value = new String( value.array(), value.position(),
569
value.limit() - value.position(), charset );
404
props[ 1 ] = new String( result.getBytes(), 0,
405
result.getNumBytes(),
406
charset == null? "UTF-8" : charset );
570
407
} catch( UnsupportedEncodingException e ) {
571
408
throw new ParseException( R.string.error_vcf_charset );
574
// now we know whether we're in an encoding multi-line,
575
// determine if we're in a v3 folded multi-line or not
576
_parser_in_folded_multiline = !_parser_in_encoded_multiline &&
577
_version.equals( "3.0" ) && next_line_looks_folded;
579
411
// handle multi-line requests
580
if( _parser_in_encoded_multiline ||
581
_parser_in_folded_multiline )
583
_parser_buffered_value_so_far += string_value;
412
_parser_in_multiline = result.isAnotherLineRequired();
413
if( _parser_in_multiline ) {
414
_parser_buffered_value_so_far += props[ 1 ];
587
418
// add on buffered multi-line content
588
String complete_value =
589
_parser_buffered_value_so_far + string_value;
591
// ignore empty values
592
if( complete_value.length() < 1 ) return;
419
String value = _parser_buffered_value_so_far + props[ 1 ];
594
421
// parse some properties
595
if( name_param_parts[ 0 ].equals( "N" ) )
596
parseN( name_param_parts, complete_value );
597
else if( name_param_parts[ 0 ].equals( "FN" ) )
598
parseFN( name_param_parts, complete_value );
599
else if( name_param_parts[ 0 ].equals( "ORG" ) )
600
parseORG( name_param_parts, complete_value );
601
else if( name_param_parts[ 0 ].equals( "TEL" ) )
602
parseTEL( name_param_parts, complete_value );
603
else if( name_param_parts[ 0 ].equals( "EMAIL" ) )
604
parseEMAIL( name_param_parts, complete_value );
422
if( params[ 0 ].equals( "N" ) )
423
parseN( params, value );
424
else if( params[ 0 ].equals( "FN" ) )
425
parseFN( params, value );
426
else if( params[ 0 ].equals( "ORG" ) )
427
parseORG( params, value );
428
else if( params[ 0 ].equals( "TEL" ) )
429
parseTEL( params, value );
430
else if( params[ 0 ].equals( "EMAIL" ) )
431
parseEMAIL( params, value );
608
435
private void parseN( String[] params, String value )
609
throws ParseException, SkipContactException,
436
throws ParseException, SkipContactException,
612
439
// already got a better name?
613
440
if( _name_level >= NAMELEVEL_N ) return;
615
442
// get name parts
616
String[] name_parts = value.split( ";" );
617
for( int i = 0; i < name_parts.length; i++ )
618
name_parts[ i ] = name_parts[ i ].trim();
443
String[] nameparts = value.split( ";" );
444
for( int i = 0; i < nameparts.length; i++ )
445
nameparts[ i ] = nameparts[ i ].trim();
622
if( name_parts.length > 1 && name_parts[ 1 ].length() > 0 )
623
value += name_parts[ 1 ];
624
if( name_parts.length > 0 && name_parts[ 0 ].length() > 0 )
625
value += ( value.length() == 0? "" : " " ) + name_parts[ 0 ];
449
if( nameparts.length > 1 && nameparts[ 1 ].length() > 0 )
450
value += nameparts[ 1 ];
451
if( nameparts[ 0 ].length() > 0 )
452
value += ( value.length() == 0? "" : " " ) + nameparts[ 0 ];
628
455
setName( value );
670
497
private void parseTEL( String[] params, String value )
671
throws ParseException
498
throws ParseException
673
500
if( value.length() == 0 ) return;
675
502
Set< String > types = extractTypes( params, Arrays.asList(
676
"PREF", "HOME", "WORK", "VOICE", "FAX", "MSG", "CELL",
677
"PAGER", "BBS", "MODEM", "CAR", "ISDN", "VIDEO" ) );
503
"PREF", "HOME", "WORK", "VOICE", "FAX", "MSG", "CELL",
504
"PAGER", "BBS", "MODEM", "CAR", "ISDN", "VIDEO" ) );
679
506
// here's the logic...
680
507
boolean preferred = types.contains( "PREF" );
681
int type = PhonesColumns.TYPE_MOBILE;
682
508
if( types.contains( "VOICE" ) )
683
509
if( types.contains( "WORK" ) )
684
type = PhonesColumns.TYPE_WORK;
510
addPhone( value, PhonesColumns.TYPE_WORK, preferred );
686
type = PhonesColumns.TYPE_HOME;
512
addPhone( value, PhonesColumns.TYPE_HOME, preferred );
687
513
else if( types.contains( "CELL" ) || types.contains( "VIDEO" ) )
688
type = PhonesColumns.TYPE_MOBILE;
514
addPhone( value, PhonesColumns.TYPE_MOBILE, preferred );
689
515
if( types.contains( "FAX" ) )
690
516
if( types.contains( "HOME" ) )
691
type = PhonesColumns.TYPE_FAX_HOME;
517
addPhone( value, PhonesColumns.TYPE_FAX_HOME, preferred );
693
type = PhonesColumns.TYPE_FAX_WORK;
519
addPhone( value, PhonesColumns.TYPE_FAX_WORK, preferred );
694
520
if( types.contains( "PAGER" ) )
695
type = PhonesColumns.TYPE_PAGER;
698
addPhone( value, type, preferred );
521
addPhone( value, PhonesColumns.TYPE_PAGER, preferred );
701
524
public void parseEMAIL( String[] params, String value )
702
throws ParseException
525
throws ParseException
704
527
if( value.length() == 0 ) return;
706
529
Set< String > types = extractTypes( params, Arrays.asList(
707
"PREF", "WORK", "HOME", "INTERNET" ) );
530
"PREF", "WORK", "HOME", "INTERNET" ) );
709
532
// here's the logic...
710
533
boolean preferred = types.contains( "PREF" );
736
559
private String checkParam( String[] params, String name )
738
Pattern p = Pattern.compile(
739
"^" + name + "[ \\t]*=[ \\t]*(\"?)(.*)\\1$" );
561
Pattern p = Pattern.compile( "^" + name + "[ \\t]*=[ \\t]*(.*)$" );
740
562
for( int i = 0; i < params.length; i++ ) {
741
563
Matcher m = p.matcher( params[ i ] );
742
564
if( m.matches() )
748
570
private Set< String > extractTypes( String[] params,
749
List< String > valid_types )
571
List< String > validTypes )
751
573
HashSet< String > types = new HashSet< String >();
753
575
// get 3.0-style TYPE= param
755
if( ( type_param = checkParam( params, "TYPE" ) ) != null ) {
756
String[] parts = type_param.split( "," );
757
for( int i = 0; i < parts.length; i++ )
758
if( valid_types.contains( parts[ i ] ) )
759
types.add( parts[ i ] );
577
if( ( typeParam = checkParam( params, "TYPE" ) ) != null ) {
578
String[] bits = typeParam.split( "," );
579
for( int i = 0; i < bits.length; i++ )
580
if( validTypes.contains( bits[ i ] ) )
581
types.add( bits[ i ] );
762
584
// get 2.1-style type param
763
585
if( _version.equals( "2.1" ) ) {
764
586
for( int i = 1; i < params.length; i++ )
765
if( valid_types.contains( params[ i ] ) )
587
if( validTypes.contains( params[ i ] ) )
766
588
types.add( params[ i ] );
772
private UnencodeResult unencodeQuotedPrintable( ByteBuffer in )
594
private UnencodeResult unencodeQuotedPrintable( String str, String charset )
774
596
boolean another = false;
776
// unencode quoted-printable encoding, as per RFC1521 section 5.1
777
byte[] out = new byte[ in.limit() - in.position() ];
598
// default encoding scheme
599
if( charset == null ) charset = "UTF-8";
601
// unencode quoted-pritable encoding, as per RFC1521 section 5.1
602
byte[] bytes = new byte[ str.length() ];
779
for( int i = in.position(); i < in.limit(); i++ )
604
for( int i = 0; i < str.length(); i++ )
781
606
// get next char and process...
782
byte ch = in.array()[ i ];
783
if( ch == '=' && i < in.limit() - 2 )
607
char ch = str.charAt( i );
608
if( ch == '=' && i < str.length() - 2 )
785
610
// we found a =XX format byte, add it
787
Character.digit( in.array()[ i + 1 ], 16 ) * 16 +
788
Character.digit( in.array()[ i + 2 ], 16 ) );
612
Character.digit( str.charAt( i + 1 ), 16 ) * 16 +
613
Character.digit( str.charAt( i + 2 ), 16 ) );
791
else if( ch == '=' && i == in.limit() - 1 )
616
else if( ch == '=' && i == str.length() - 1 )
793
618
// we found a '=' at the end of a line signifying a multi-
794
619
// line string, so we don't add it.