/android/import-contacts : revision 103

1

/*

2

* VCFImporter.java

3

*

4

5

*

6

* This file is part of the Import Contacts program (hereafter referred

7

* to as "this program"). For more information, see

8

* http://www.waxworlds.org/edam/software/android/import-contacts

7

* to as "this program"). For more information, see

8

* http://ed.am/dev/android/import-contacts

9

*

10

* This program is free software: you can redistribute it and/or modify

11

* it under the terms of the GNU General Public License as published by

21

* along with this program. If not, see <http://www.gnu.org/licenses/>.

22

*/

23

24

package org.waxworlds.edam.importcontacts;

24

package am.ed.importcontacts;

25

26

import java.io.BufferedReader;

27

import java.io.File;

38

import java.util.HashSet;

39

import java.util.Iterator;

40

import java.util.List;

41

import java.util.Locale;

41

42

import java.util.NoSuchElementException;

42

43

import java.util.Set;

43

44

import java.util.Vector;

45

46

import java.util.regex.Pattern;

46

47

48

import android.content.SharedPreferences;

48

import android.provider.Contacts;

49

import android.provider.Contacts.PhonesColumns;

49

import android.os.Environment;

50

51

public class VcardImporter extends Importer

52

{

70

File[] files = null;

71

try

72

{

73

// check SD card is mounted

74

String state = Environment.getExternalStorageState();

75

if( !Environment.MEDIA_MOUNTED.equals( state ) &&

76

!Environment.MEDIA_MOUNTED_READ_ONLY.equals( state ) )

77

{

78

showError( R.string.error_nosdcard );

79

}

80

73

81

// open directory

74

String path = "/sdcard" + prefs.getString( "location", "/" );

75

File file = new File( path );

82

File file = new File( Environment.getExternalStorageDirectory(),

83

prefs.getString( "location", "/" ) );

76

84

if( !file.exists() )

77

85

showError( R.string.error_locationnotfound );

78

86

82

90

// get files

83

91

class VCardFilter implements FilenameFilter {

84

92

public boolean accept( File dir, String name ) {

85

return name.toLowerCase().endsWith( ".vcf" );

93

return name.toLowerCase( Locale.US ).endsWith( ".vcf" );

86

94

}

87

95

}

88

96

files = file.listFiles( new VCardFilter() );

132

140

boolean in_vcard = false;

133

141

while( ( line = reader.readLine() ) != null )

134

142

{

135

if( !in_vcard ) {

143

if( !in_vcard )

144

{

136

145

// look for vcard beginning

137

if( line.matches( "^BEGIN:VCARD" ) ) {

146

if( line.matches( "(?i)BEGIN[ \t]*:[ \t]*VCARD.*" ) ) {

138

147

in_vcard = true;

139

148

_vcard_count++;

140

149

}

150

// check for vMsg files

151

else if( line.matches( "(?i)BEGIN[ \t]*:[ \t]*VMSG.*" ) ) {

152

showError( getText( R.string.error_vcf_vmsgfile )

153

+ file.getName() );

154

}

141

155

}

142

else if( line.matches( "^END:VCARD" ) )

156

else if( line.matches( "(?i)END[ \t]*:[ \t]*VCARD.*" ) )

143

157

in_vcard = false;

144

158

}

159

reader.close();

145

160

146

161

}

147

162

catch( FileNotFoundException e ) {

169

184

FileInputStream istream = new FileInputStream( file );

170

185

byte[] content = new byte[ (int)file.length() ];

171

186

istream.read( content );

172

istream = null;

187

istream.close();

173

188

174

189

// import

175

190

importVCardFileContent( content, file.getName() );

176

191

}

192

catch( OutOfMemoryError e ) {

193

showError( R.string.error_outofmemory );

194

}

177

195

catch( FileNotFoundException e ) {

178

196

showError( getText( R.string.error_filenotfound ) +

179

197

file.getName() );

192

210

ContentLineIterator cli = new ContentLineIterator( content );

193

211

while( cli.hasNext() )

194

212

{

195

ByteBuffer buffer = cli.next();

213

ContentLine content_line = cli.next();

196

214

197

// get a US-ASCII version of the line for processing

198

String line;

199

try {

200

line = new String( buffer.array(), buffer.position(),

201

buffer.limit() - buffer.position(), "US-ASCII" );

202

}

203

catch( UnsupportedEncodingException e ) {

204

// we know US-ASCII is supported, so appease the compiler...

205

line = "";

206

}

215

// get a US-ASCII version of the string, for processing

216

String line = content_line.getUsAsciiLine();

207

217

208

218

if( vcard == null ) {

209

219

// look for vcard beginning

210

if( line.matches( "^BEGIN:VCARD" ) ) {

220

if( line.matches( "(?i)BEGIN[ \t]*:[ \t]*VCARD.*" ) ) {

211

221

setProgress( _progress++ );

212

222

vcard = new Vcard();

213

223

vcard_start_line = cli.getLineNumber();

215

225

}

216

226

else {

217

227

// look for vcard content or ending

218

if( line.matches( "^END:VCARD" ) )

228

if( line.matches( "(?i)END[ \t]*:[ \t]*VCARD.*" ) )

219

229

{

220

230

// finalise the vcard/contact

221

231

try {

258

268

{

259

269

// try giving the line to the vcard

260

270

try {

261

vcard.parseLine( buffer, line,

262

cli.doesNextLineLookFolded() );

271

vcard.parseLine( content_line );

263

272

}

264

273

catch( Vcard.ParseException e ) {

265

274

skipContact();

272

281

finish( ACTION_ABORT );

273

282

}

274

283

275

// although we're continuing, we still need to abort

276

// this vCard. Further lines will be ignored until we

284

// Although we're continuing, we still need to abort

285

// this vCard. Further lines will be ignored until we

277

286

// get to another BEGIN:VCARD line.

278

287

vcard = null;

279

288

}

280

289

catch( Vcard.SkipImportException e ) {

281

290

skipContact();

282

// abort this vCard. Further lines will be ignored until

291

// Abort this vCard. Further lines will be ignored until

283

292

// we get to another BEGIN:VCARD line.

284

293

vcard = null;

285

294

}

288

297

}

289

298

}

290

299

291

class ContentLineIterator implements Iterator< ByteBuffer >

300

class ContentLine

301

{

302

private ByteBuffer _buffer;

303

private boolean _folded_next;

304

private String _line;

305

306

public ContentLine( ByteBuffer buffer, boolean folded_next )

307

{

308

_buffer = buffer;

309

_folded_next = folded_next;

310

_line = null;

311

}

312

313

public ByteBuffer getBuffer()

314

{

315

return _buffer;

316

}

317

318

public boolean doesNextLineLookFolded()

319

{

320

return _folded_next;

321

}

322

323

public String getUsAsciiLine()

324

{

325

// generated line and cache it

326

if( _line == null ) {

327

try {

328

_line = new String( _buffer.array(), _buffer.position(),

329

_buffer.limit() - _buffer.position(), "US-ASCII" );

330

}

331

catch( UnsupportedEncodingException e ) {

332

// we know US-ASCII *is* supported, so appease the

333

// compiler...

334

}

335

}

336

337

// return cached line

338

return _line;

339

}

340

}

341

342

class ContentLineIterator implements Iterator< ContentLine >

292

343

{

293

344

protected byte[] _content = null;

294

345

protected int _pos = 0;

306

357

}

307

358

308

359

@Override

309

public ByteBuffer next()

360

public ContentLine next()

310

361

{

311

362

int initial_pos = _pos;

312

363

319

370

_pos > initial_pos )? _pos - 1 : _pos;

320

371

_pos++;

321

372

_line++;

322

return ByteBuffer.wrap( _content, initial_pos,

323

to - initial_pos );

373

return new ContentLine(

374

ByteBuffer.wrap( _content, initial_pos,

375

to - initial_pos ),

376

doesNextLineLookFolded() );

324

377

}

325

378

326

379

// we didn't find one, but were there bytes left?

328

381

int to = _pos;

329

382

_pos++;

330

383

_line++;

331

return ByteBuffer.wrap( _content, initial_pos,

332

to - initial_pos );

384

return new ContentLine(

385

ByteBuffer.wrap( _content, initial_pos,

386

to - initial_pos ),

387

doesNextLineLookFolded() );

333

388

}

334

389

335

390

// no bytes left

347

402

* onto the end of this one?

348

403

* @return

349

404

*/

350

public boolean doesNextLineLookFolded()

405

private boolean doesNextLineLookFolded()

351

406

{

352

407

return _pos > 0 && _pos < _content.length &&

353

_content[ _pos - 1 ] == '\n' && _content[ _pos ] == ' ';

408

_content[ _pos - 1 ] == '\n' &&

409

( _content[ _pos ] == ' ' || _content[ _pos ] == '\t' );

354

410

}

355

411

356

412

public int getLineNumber()

362

418

private class Vcard extends ContactData

363

419

{

364

420

private final static int NAMELEVEL_NONE = 0;

365

private final static int NAMELEVEL_FN = 1;

366

private final static int NAMELEVEL_N = 2;

421

private final static int NAMELEVEL_N = 1;

422

private final static int NAMELEVEL_FN = 2;

367

423

368

424

private final static int MULTILINE_NONE = 0;

369

425

private final static int MULTILINE_ENCODED = 1; // v2.1 quoted-printable

370

426

private final static int MULTILINE_ESCAPED = 2; // v2.1 \\CRLF

371

private final static int MULTILINE_FOLDED = 3; // v3.0 folding

427

private final static int MULTILINE_FOLDED = 3; // MIME-DIR folding

372

428

373

429

private String _version = null;

374

private Vector< ByteBuffer > _buffers = null;

430

private Vector< ContentLine > _content_lines = null;

375

431

private int _name_level = NAMELEVEL_NONE;

376

432

private int _parser_multiline_state = MULTILINE_NONE;

377

433

private String _parser_current_name_and_params = null;

420

476

@SuppressWarnings("serial")

421

477

protected class SkipImportException extends Exception { }

422

478

423

private String extractCollonPartFromLine( ByteBuffer buffer,

424

String line, boolean former )

479

private String extractCollonPartFromLine( ContentLine content_line,

480

boolean former )

425

481

{

426

String ret = null;

427

428

// get a US-ASCII version of the line for processing, unless we were

429

// supplied with one

430

if( line == null ) {

431

try {

432

line = new String( buffer.array(), buffer.position(),

433

buffer.limit() - buffer.position(), "US-ASCII" );

434

}

435

catch( UnsupportedEncodingException e ) {

436

// we know US-ASCII is supported, so appease the compiler...

437

line = "";

438

}

439

}

440

441

482

// split line into name and value parts and check to make sure we

442

483

// only got 2 parts and that the first part is not zero in length

443

String[] parts = line.split( ":", 2 );

484

String[] parts = content_line.getUsAsciiLine().split( ":", 2 );

444

485

if( parts.length == 2 && parts[ 0 ].length() > 0 )

445

ret = parts[ former? 0 : 1 ];

446

447

return ret;

448

}

449

450

private String extractNameAndParamsFromLine( ByteBuffer buffer,

451

String line )

452

{

453

return extractCollonPartFromLine( buffer, line, true );

454

}

455

456

private String extractValueFromLine( ByteBuffer buffer, String line )

457

{

458

return extractCollonPartFromLine( buffer, line, false );

459

}

460

461

public void parseLine( ByteBuffer buffer, String line,

462

boolean next_line_looks_folded )

486

return parts[ former? 0 : 1 ].trim();

487

488

return null;

489

}

490

491

private String extractNameAndParamsFromLine( ContentLine content_line )

492

{

493

return extractCollonPartFromLine( content_line, true );

494

}

495

496

private String extractValueFromLine( ContentLine content_line )

497

{

498

return extractCollonPartFromLine( content_line, false );

499

}

500

501

public void parseLine( ContentLine content_line )

463

502

throws ParseException, SkipImportException,

464

503

AbortImportException

465

504

{

468

507

{

469

508

// tentatively get name and params from line

470

509

String name_and_params =

471

extractNameAndParamsFromLine( buffer, line );

510

extractNameAndParamsFromLine( content_line );

472

511

473

512

// is it a version line?

474

513

if( name_and_params != null &&

475

name_and_params.equals( "VERSION" ) )

514

name_and_params.equalsIgnoreCase( "VERSION" ) )

476

515

{

477

516

// yes, get it!

478

String value = extractValueFromLine( buffer, line );

479

if( !value.equals( "2.1" ) && !value.equals( "3.0" ) )

517

String value = extractValueFromLine( content_line );

518

if( value == null || (

519

!value.equals( "2.1" ) && !value.equals( "3.0" ) ) )

520

{

480

521

throw new ParseException( R.string.error_vcf_version );

522

}

481

523

_version = value;

482

524

483

525

// parse any buffers we've been accumulating while we waited

484

526

// for a version

485

if( _buffers != null )

486

for( int i = 0; i < _buffers.size(); i++ )

487

parseLine( _buffers.get( i ), null,

488

i + 1 < _buffers.size() &&

489

_buffers.get( i + 1 ).hasRemaining() &&

490

_buffers.get( i + 1 ).get(

491

_buffers.get( i + 1 ).position() ) == ' ' );

492

_buffers = null;

527

if( _content_lines != null )

528

for( int i = 0; i < _content_lines.size(); i++ )

529

parseLine( _content_lines.get( i ) );

530

_content_lines = null;

493

531

}

494

532

else

495

533

{

496

534

// no, so stash this line till we get a version

497

if( _buffers == null )

498

_buffers = new Vector< ByteBuffer >();

499

_buffers.add( buffer );

535

if( _content_lines == null )

536

_content_lines = new Vector< ContentLine >();

537

_content_lines.add( content_line );

500

538

}

501

539

}

502

540

else

503

541

{

504

542

// name and params and the position in the buffer where the

505

// "value" part of the line start

543

// "value" part of the line starts

506

544

String name_and_params;

507

545

int pos;

508

546

514

552

515

553

// skip some initial line characters, depending on the type

516

554

// of multi-line we're handling

517

pos = buffer.position();

555

pos = content_line.getBuffer().position();

518

556

switch( _parser_multiline_state )

519

557

{

520

558

case MULTILINE_FOLDED:

521

559

pos++;

522

560

break;

523

561

case MULTILINE_ENCODED:

524

while( pos < buffer.limit() && (

525

buffer.get( pos ) == ' ' ||

526

buffer.get( pos ) == '\t' ) )

562

while( pos < content_line.getBuffer().limit() && (

563

content_line.getBuffer().get( pos ) == ' ' ||

564

content_line.getBuffer().get( pos ) == '\t' ) )

527

565

{

528

566

pos++;

529

567

}

538

576

}

539

577

else

540

578

{

579

// skip empty lines

580

if( content_line.getUsAsciiLine().trim().length() == 0 )

581

return;

582

541

583

// get name and params from line, and since we're not

542

584

// parsing a subsequent line in a multi-line, this should

543

585

// not fail, or it's an error

544

586

name_and_params =

545

extractNameAndParamsFromLine( buffer, line );

587

extractNameAndParamsFromLine( content_line );

546

588

if( name_and_params == null )

547

589

throw new ParseException(

548

590

R.string.error_vcf_malformed );

549

591

550

592

// calculate how many chars to skip from beginning of line

551

593

// so we skip the property "name:" part

552

pos = buffer.position() + name_and_params.length() + 1;

594

pos = content_line.getBuffer().position() +

595

name_and_params.length() + 1;

553

596

554

597

// reset the saved multi-line state

555

598

_parser_current_name_and_params = name_and_params;

558

601

559

602

// get value from buffer, as raw bytes

560

603

ByteBuffer value;

561

value = ByteBuffer.wrap( buffer.array(), pos,

562

buffer.limit() - pos );

604

value = ByteBuffer.wrap( content_line.getBuffer().array(), pos,

605

content_line.getBuffer().limit() - pos );

563

606

564

607

// get parameter parts

565

608

String[] name_param_parts = name_and_params.split( ";", -1 );

568

611

569

612

// determine whether we care about this entry

570

613

final HashSet< String > interesting_fields =

571

new HashSet< String >( Arrays.asList( new String[]

572

{ "N", "FN", "ORG", "TITLE", "TEL", "EMAIL", "ADR" }

614

new HashSet< String >( Arrays.asList( new String[] { "N",

615

"FN", "ORG", "TITLE", "TEL", "EMAIL", "ADR", "LABEL" }

573

616

) );

574

617

boolean is_interesting_field =

575

interesting_fields.contains( name_param_parts[ 0 ] );

618

interesting_fields.contains(

619

name_param_parts[ 0 ].toUpperCase( Locale.US ) );

576

620

577

621

// parse encoding parameter

578

622

String encoding = checkParam( name_param_parts, "ENCODING" );

579

if( encoding != null ) encoding = encoding.toUpperCase();

623

if( encoding != null )

624

encoding = encoding.toUpperCase( Locale.US );

580

625

if( is_interesting_field && encoding != null &&

581

!encoding.equals( "8BIT" ) &&

582

!encoding.equals( "QUOTED-PRINTABLE" ) )

583

//&& !encoding.equals( "BASE64" ) )

626

!encoding.equalsIgnoreCase( "8BIT" ) &&

627

!encoding.equalsIgnoreCase( "QUOTED-PRINTABLE" ) )

628

//&& !encoding.equalsIgnoreCase( "BASE64" ) )

584

629

{

585

630

throw new ParseException( R.string.error_vcf_encoding );

586

631

}

587

632

588

633

// parse charset parameter

589

634

String charset = checkParam( name_param_parts, "CHARSET" );

590

if( charset != null ) charset = charset.toUpperCase();

635

if( charset != null )

636

charset = charset.toUpperCase( Locale.US );

591

637

if( charset != null &&

592

!charset.equals( "US-ASCII" ) &&

593

!charset.equals( "ASCII" ) &&

594

!charset.equals( "UTF-8" ) )

638

!charset.equalsIgnoreCase( "US-ASCII" ) &&

639

!charset.equalsIgnoreCase( "ASCII" ) &&

640

!charset.equalsIgnoreCase( "UTF-8" ) )

595

641

{

596

642

throw new ParseException( R.string.error_vcf_charset );

597

643

}

599

645

// do unencoding (or default to a fake unencoding result with

600

646

// the raw string)

601

647

UnencodeResult unencoding_result = null;

602

if( encoding != null && encoding.equals( "QUOTED-PRINTABLE" ) )

648

if( encoding != null &&

649

encoding.equalsIgnoreCase( "QUOTED-PRINTABLE" ) )

650

{

603

651

unencoding_result = unencodeQuotedPrintable( value );

604

// else if( encoding != null && encoding.equals( "BASE64" ) )

652

}

653

// else if( encoding != null &&

654

// encoding.equalsIgnoreCase( "BASE64" ) )

655

// {

605

656

// unencoding_result = unencodeBase64( props[ 1 ], charset );

657

// }

606

658

if( unencoding_result != null ) {

607

659

value = unencoding_result.getBuffer();

608

660

if( unencoding_result.isAnotherLineRequired() )

609

661

_parser_multiline_state = MULTILINE_ENCODED;

610

662

}

611

663

612

// convert 8-bit ASCII charset to US-ASCII

613

if( charset == null || charset.equals( "ASCII" ) ) {

664

// convert 8-bit US-ASCII charset to UTF-8 (where no charset is

665

// specified for a v2.1 vcard entry, we assume it's US-ASCII)

666

if( ( charset == null && _version.equals( "2.1" ) ) ||

667

( charset != null && (

668

charset.equalsIgnoreCase( "ASCII" ) ||

669

charset.equalsIgnoreCase( "US-ASCII" ) ) ) )

670

{

614

671

value = transcodeAsciiToUtf8( value );

615

charset = "UTF-8";

616

672

}

617

673

618

// process charset

674

// process charset (value is now in UTF-8)

619

675

String string_value;

620

676

try {

621

677

string_value = new String( value.array(), value.position(),

622

value.limit() - value.position(), charset );

678

value.limit() - value.position(), "UTF-8" );

623

679

} catch( UnsupportedEncodingException e ) {

624

680

throw new ParseException( R.string.error_vcf_charset );

625

681

}

627

683

// for some entries that have semicolon-separated value parts,

628

684

// check to see if the value ends in an escape character, which

629

685

// indicates that we have a multi-line value

630

if( ( name_param_parts[ 0 ].equals( "N" ) ||

631

name_param_parts[ 0 ].equals( "ORG" ) ||

632

name_param_parts[ 0 ].equals( "ADR" ) ) &&

686

if( ( name_param_parts[ 0 ].equalsIgnoreCase( "N" ) ||

687

name_param_parts[ 0 ].equalsIgnoreCase( "ORG" ) ||

688

name_param_parts[ 0 ].equalsIgnoreCase( "ADR" ) ) &&

633

689

doesStringEndInAnEscapeChar( string_value ) )

634

690

{

635

691

_parser_multiline_state = MULTILINE_ESCAPED;

637

693

string_value.length() - 1 );

638

694

}

639

695

640

// now we know whether we're in an encoding multi-line,

641

// determine if we're in a v3 folded multi-line or not

696

// if we know we're not in an encoding-based multi-line, check

697

// to see if we're in a folded multi-line

642

698

if( _parser_multiline_state == MULTILINE_NONE &&

643

_version.equals( "3.0" ) && next_line_looks_folded )

699

content_line.doesNextLineLookFolded() )

644

700

{

645

701

_parser_multiline_state = MULTILINE_FOLDED;

646

702

}

658

714

if( complete_value.length() < 1 ) return;

659

715

660

716

// parse some properties

661

if( name_param_parts[ 0 ].equals( "N" ) )

717

if( name_param_parts[ 0 ].equalsIgnoreCase( "N" ) )

662

718

parseN( name_param_parts, complete_value );

663

else if( name_param_parts[ 0 ].equals( "FN" ) )

719

else if( name_param_parts[ 0 ].equalsIgnoreCase( "FN" ) )

664

720

parseFN( name_param_parts, complete_value );

665

else if( name_param_parts[ 0 ].equals( "ORG" ) )

721

else if( name_param_parts[ 0 ].equalsIgnoreCase( "ORG" ) )

666

722

parseORG( name_param_parts, complete_value );

667

else if( name_param_parts[ 0 ].equals( "TITLE" ) )

723

else if( name_param_parts[ 0 ].equalsIgnoreCase( "TITLE" ) )

668

724

parseTITLE( name_param_parts, complete_value );

669

else if( name_param_parts[ 0 ].equals( "TEL" ) )

725

else if( name_param_parts[ 0 ].equalsIgnoreCase( "TEL" ) )

670

726

parseTEL( name_param_parts, complete_value );

671

else if( name_param_parts[ 0 ].equals( "EMAIL" ) )

727

else if( name_param_parts[ 0 ].equalsIgnoreCase( "EMAIL" ) )

672

728

parseEMAIL( name_param_parts, complete_value );

673

else if( name_param_parts[ 0 ].equals( "ADR" ) )

729

else if( name_param_parts[ 0 ].equalsIgnoreCase( "ADR" ) )

674

730

parseADR( name_param_parts, complete_value );

731

else if( name_param_parts[ 0 ].equalsIgnoreCase( "LABEL" ) )

732

parseLABEL( name_param_parts, complete_value );

733

else if( name_param_parts[ 0 ].equalsIgnoreCase( "NOTE" ) )

734

parseNOTE( name_param_parts, complete_value );

735

else if( name_param_parts[ 0 ].equalsIgnoreCase( "BDAY" ) )

736

parseBDAY( name_param_parts, complete_value );

675

737

}

676

738

}

677

739

690

752

return ( count & 1 ) == 1;

691

753

}

692

754

693

private String[] splitValueBySemicolon( String value )

755

private String[] splitValueByCharacter( String value, char character )

694

756

{

695

// split string in to parts by semicolon

757

// split string in to parts by specified character

696

758

ArrayList< String > parts = new ArrayList< String >(

697

Arrays.asList( value.split( ";" ) ) );

759

Arrays.asList( value.split( "" + character ) ) );

698

760

699

761

// go through parts

700

762

for( int a = 0; a < parts.size(); a++ )

701

763

{

702

764

String str = parts.get( a );

703

765

704

// look for parts that end in an escape character, but ignore

705

// the final part. We've already detected escape chars at the

766

// Look for parts that end in an escape character, but ignore

767

// the final part. We've already detected escape chars at the

706

768

// end of the final part in parseLine() and handled multi-lines

707

769

// accordingly.

708

770

if( a < parts.size() - 1 &&

709

771

doesStringEndInAnEscapeChar( str ) )

710

772

{

711

// join the next part to this part and remove the next part

773

// append the escaped character, join the next part to this

774

// part and remove the next part

712

775

parts.set( a, str.substring( 0, str.length() - 1 ) +

713

';' + parts.get( a + 1 ) );

776

character + parts.get( a + 1 ) );

714

777

parts.remove( a + 1 );

715

778

716

779

// re-visit this part

727

790

return parts.toArray( ret );

728

791

}

729

792

793

private String unescapeValue( String value )

794

{

795

StringBuilder ret = new StringBuilder( value.length() );

796

boolean in_escape = false;

797

for( int a = 0; a < value.length(); a++ )

798

{

799

int c = value.codePointAt( a );

800

801

// process a normal character

802

if( !in_escape ) {

803

if( c == '\\' )

804

in_escape = true;

805

else

806

ret.append( Character.toChars( c ) );

807

continue;

808

}

809

810

// process an escape sequence

811

in_escape = false;

812

switch( c )

813

{

814

case 'T':

815

case 't':

816

// add tab (invalid/non-standard, but accepted)

817

ret.append( '\t' );

818

break;

819

case 'N':

820

case 'n':

821

// add newline

822

ret.append( '\n' );

823

break;

824

case '\\':

825

case ',':

826

case ';':

827

// add escaped character

828

ret.append( Character.toChars( c ) );

829

break;

830

default:

831

// unknown escape sequence, so add it unescaped

832

// (invalid/non-standard, but accepted)

833

ret.append( "\\" );

834

ret.append( Character.toChars( c ) );

835

break;

836

}

837

}

838

839

return ret.toString();

840

}

841

730

842

private void parseN( String[] params, String value )

731

843

{

732

844

// already got a better name?

733

845

if( _name_level >= NAMELEVEL_N ) return;

734

846

735

847

// get name parts

736

String[] name_parts = splitValueBySemicolon( value );

848

String[] name_parts = splitValueByCharacter( value, ';' );

737

849

738

850

// build name

739

851

value = "";

740

if( name_parts.length > 1 && name_parts[ 1 ].length() > 0 )

741

value += name_parts[ 1 ];

742

if( name_parts.length > 0 && name_parts[ 0 ].length() > 0 )

743

value += ( value.length() == 0? "" : " " ) + name_parts[ 0 ];

852

final int[] part_order = { 3, 1, 2, 0, 4 };

853

for( int a = 0; a < part_order.length; a++ )

854

if( name_parts.length > part_order[ a ] &&

855

name_parts[ part_order[ a ] ].length() > 0 )

856

{

857

// split this part in to it's comma-separated bits

858

String[] name_part_parts = splitValueByCharacter(

859

name_parts[ part_order[ a ] ], ',' );

860

for( int b = 0; b < name_part_parts.length; b++ )

861

if( name_part_parts[ b ].length() > 0 )

862

{

863

if( value.length() > 0 ) value += " ";

864

value += name_part_parts[ b ];

865

}

866

}

744

867

745

868

// set name

746

setName( value );

869

setName( unescapeValue( value ) );

747

870

_name_level = NAMELEVEL_N;

748

871

}

749

872

753

876

if( _name_level >= NAMELEVEL_FN ) return;

754

877

755

878

// set name

756

setName( value );

879

setName( unescapeValue( value ) );

757

880

_name_level = NAMELEVEL_FN;

758

881

}

759

882

760

883

private void parseORG( String[] params, String value )

761

884

{

762

885

// get org parts

763

String[] org_parts = splitValueBySemicolon( value );

886

String[] org_parts = splitValueByCharacter( value, ';' );

764

887

if( org_parts == null || org_parts.length < 1 ) return;

765

888

766

889

// build organisation name

768

891

String.valueOf( org_parts[ 0 ] ) );

769

892

for( int a = 1; a < org_parts.length; a++ )

770

893

builder.append( ", " ).append( org_parts[ a ] );

771

String organisation = builder.toString();

894

String organisation = unescapeValue( builder.toString() );

772

895

773

896

// set organisation name (using a title we've previously found)

774

897

addOrganisation( organisation, _cached_title, true );

785

908

786

909

private void parseTITLE( String[] params, String value )

787

910

{

911

value = unescapeValue( value );

912

788

913

// if we previously had an organisation, look it up and append this

789

914

// title to it

790

915

if( _cached_organisation != null && hasOrganisations() ) {

816

941

int type;

817

942

if( types.contains( "FAX" ) )

818

943

if( types.contains( "HOME" ) )

819

type = PhonesColumns.TYPE_FAX_HOME;

944

type = TYPE_FAX_HOME;

820

945

else

821

type = PhonesColumns.TYPE_FAX_WORK;

946

type = TYPE_FAX_WORK;

822

947

else if( types.contains( "CELL" ) || types.contains( "VIDEO" ) )

823

type = PhonesColumns.TYPE_MOBILE;

948

type = TYPE_MOBILE;

824

949

else if( types.contains( "PAGER" ) )

825

type = PhonesColumns.TYPE_PAGER;

950

type = TYPE_PAGER;

826

951

else if( types.contains( "WORK" ) )

827

type = PhonesColumns.TYPE_WORK;

952

type = TYPE_WORK;

828

953

else

829

type = PhonesColumns.TYPE_HOME;

954

type = TYPE_HOME;

830

955

831

956

// add phone number

832

957

addNumber( value, type, is_preferred );

843

968

boolean is_preferred = types.contains( "PREF" );

844

969

int type;

845

970

if( types.contains( "WORK" ) )

846

type = Contacts.ContactMethods.TYPE_WORK;

971

type = TYPE_WORK;

847

972

else

848

type = Contacts.ContactMethods.TYPE_HOME;

973

type = TYPE_HOME;

849

974

850

addEmail( value, type, is_preferred );

975

addEmail( unescapeValue( value ), type, is_preferred );

851

976

}

852

977

853

978

private void parseADR( String[] params, String value )

854

979

{

855

980

// get address parts

856

String[] adr_parts = splitValueBySemicolon( value );

981

String[] adr_parts = splitValueByCharacter( value, ';' );

857

982

858

983

// build address

859

984

value = "";

860

for( int a = 0; a < adr_parts.length; a++ ) {

861

if( value.length() > 0 ) value += "\n";

862

value += adr_parts[ a ].trim();

863

}

864

865

Set< String > types = extractTypes( params, Arrays.asList(

866

"PREF", "WORK", "HOME", "INTERNET" ) );

867

868

// add address

869

int type;

870

if( types.contains( "WORK" ) )

871

type = Contacts.ContactMethods.TYPE_WORK;

872

else

873

type = Contacts.ContactMethods.TYPE_HOME;

874

875

addAddress( value, type );

985

for( int a = 0; a < adr_parts.length; a++ )

986

if( adr_parts[ a ].length() > 0 )

987

{

988

// version 3.0 vCards allow further splitting by comma

989

if( _version.equals( "3.0" ) )

990

{

991

// split this part in to it's comma-separated bits and

992

// add them on individual lines

993

String[] adr_part_parts =

994

splitValueByCharacter( adr_parts[ a ], ',' );

995

for( int b = 0; b < adr_part_parts.length; b++ )

996

if( adr_part_parts[ b ].length() > 0 )

997

{

998

if( value.length() > 0 ) value += "\n";

999

value += adr_part_parts[ b ];

1000

}

1001

}

1002

else

1003

{

1004

// add this part on an individual line

1005

if( value.length() > 0 ) value += "\n";

1006

value += adr_parts[ a ];

1007

}

1008

}

1009

1010

Set< String > types = extractTypes( params, Arrays.asList(

1011

"PREF", "WORK", "HOME" ) );

1012

1013

// add address

1014

int type;

1015

if( types.contains( "WORK" ) )

1016

type = TYPE_WORK;

1017

else

1018

type = TYPE_HOME;

1019

1020

addAddress( unescapeValue( value ), type );

1021

}

1022

1023

private void parseLABEL( String[] params, String value )

1024

{

1025

Set< String > types = extractTypes( params, Arrays.asList(

1026

"PREF", "WORK", "HOME" ) );

1027

1028

// add address

1029

int type;

1030

if( types.contains( "WORK" ) )

1031

type = TYPE_WORK;

1032

else

1033

type = TYPE_HOME;

1034

1035

addAddress( unescapeValue( value ), type );

1036

}

1037

1038

private void parseNOTE( String[] params, String value )

1039

{

1040

addNote( unescapeValue( value ) );

1041

}

1042

1043

private void parseBDAY( String[] params, String value )

1044

{

1045

setBirthday( value );

876

1046

}

877

1047

878

1048

public void finaliseVcard()

879

1049

throws ParseException, ContactNotIdentifiableException

880

1050

{

881

1051

// missing version (and data is present)

882

if( _version == null && _buffers != null )

1052

if( _version == null && _content_lines != null )

883

1053

throw new ParseException( R.string.error_vcf_malformed );

884

1054

885

1055

// finalise the parent class

886

1056

finalise();

887

1057

}

888

1058

1059

/**

1060

* Amongst the params, find the value of the first, only, of any with

1061

* the specified name.

1062

*

1063

* @param params

1064

* @param name

1065

* @return a value, or null

1066

*/

889

1067

private String checkParam( String[] params, String name )

890

1068

{

1069

String[] res = checkParams( params, name );

1070

return res.length > 0? res[ 0 ] : null;

1071

}

1072

1073

/**

1074

* Amongst the params, find the values of any with the specified name.

1075

*

1076

* @param params

1077

* @param name

1078

* @return an array of values, or null

1079

*/

1080

private String[] checkParams( String[] params, String name )

1081

{

1082

HashSet< String > ret = new HashSet< String >();

1083

891

1084

Pattern p = Pattern.compile(

892

"^" + name + "[ \\t]*=[ \\t]*(\"?)(.*)\\1$" );

1085

"^" + name + "[ \\t]*=[ \\t]*(\"?)(.*)\\1$",

1086

Pattern.CASE_INSENSITIVE );

893

1087

for( int i = 0; i < params.length; i++ ) {

894

1088

Matcher m = p.matcher( params[ i ] );

895

1089

if( m.matches() )

896

return m.group( 2 );

1090

ret.add( m.group( 2 ) );

897

1091

}

898

return null;

1092

1093

return (String[]) ret.toArray( new String[ ret.size() ] );

899

1094

}

900

1095

1096

/**

1097

* Amongst the params, return any type values present. For v2.1 vCards,

1098

* those types are just parameters. For v3.0, they are prefixed with

1099

* "TYPE=". There may also be multiple type parameters.

1100

*

1101

* @param params an array of params to look for types in

1102

* @param valid_types an list of upper-case type values to look for

1103

* @return a set of present type values

1104

*/

901

1105

private Set< String > extractTypes( String[] params,

902

1106

List< String > valid_types )

903

1107

{

904

1108

HashSet< String > types = new HashSet< String >();

905

1109

906

1110

// get 3.0-style TYPE= param

907

String type_param;

908

if( ( type_param = checkParam( params, "TYPE" ) ) != null ) {

909

String[] parts = type_param.split( "," );

910

for( int i = 0; i < parts.length; i++ )

911

if( valid_types.contains( parts[ i ] ) )

912

types.add( parts[ i ] );

1111

String type_params[] = checkParams( params, "TYPE" );

1112

for( int a = 0; a < type_params.length; a++ )

1113

{

1114

// check for a comma-separated list of types (why? I don't think

1115

// this is in the specs!)

1116

String[] parts = type_params[ a ].split( "," );

1117

for( int i = 0; i < parts.length; i++ ) {

1118

String ucpart = parts[ i ].toUpperCase( Locale.US );

1119

if( valid_types.contains( ucpart ) )

1120

types.add( ucpart );

1121

}

913

1122

}

914

1123

915

1124

// get 2.1-style type param

916

1125

if( _version.equals( "2.1" ) ) {

917

for( int i = 1; i < params.length; i++ )

918

if( valid_types.contains( params[ i ] ) )

919

types.add( params[ i ] );

1126

for( int i = 1; i < params.length; i++ ) {

1127

String ucparam = params[ i ].toUpperCase( Locale.US );

1128

if( valid_types.contains( ucparam ) )

1129

types.add( ucparam );

1130

}

920

1131

}

921

1132

922

1133

return types;

944

1155

else if( ch == '=' && i == in.limit() - 1 )

945

1156

{

946

1157

// we found a '=' at the end of a line signifying a multi-

947

// line string, so we don't add it.

1158

// line string, so we don't add it

948

1159

another = true;

949

1160

continue;

950

1161

}