/android/import-contacts : revision 62

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

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

45

import java.util.regex.Matcher;

46

import java.util.regex.Pattern;

47

48

import android.annotation.SuppressLint;

48

49

import android.content.SharedPreferences;

49

import android.os.Environment;

50

51

public class VcardImporter extends Importer

52

{

58

super( doit );

59

}

60

61

@SuppressLint( "SdCardPath" )

61

62

@Override

62

63

protected void onImport() throws AbortImportException

63

64

{

70

71

File[] files = null;

71

72

try

72

73

{

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

81

74

// open directory

82

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

83

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

75

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

76

File file = new File( path );

84

77

if( !file.exists() )

85

78

showError( R.string.error_locationnotfound );

86

79

140

133

boolean in_vcard = false;

141

134

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

142

135

{

143

if( !in_vcard )

144

{

136

if( !in_vcard ) {

145

137

// look for vcard beginning

146

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

138

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

147

139

in_vcard = true;

148

140

_vcard_count++;

149

141

}

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

}

155

142

}

156

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

143

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

157

144

in_vcard = false;

158

145

}

159

reader.close();

160

146

161

147

}

162

148

catch( FileNotFoundException e ) {

184

170

FileInputStream istream = new FileInputStream( file );

185

171

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

186

172

istream.read( content );

187

istream.close();

173

istream = null;

188

174

189

175

// import

190

176

importVCardFileContent( content, file.getName() );

191

177

}

192

catch( OutOfMemoryError e ) {

193

showError( R.string.error_outofmemory );

194

}

195

178

catch( FileNotFoundException e ) {

196

179

showError( getText( R.string.error_filenotfound ) +

197

180

file.getName() );

210

193

ContentLineIterator cli = new ContentLineIterator( content );

211

194

while( cli.hasNext() )

212

195

{

213

ContentLine content_line = cli.next();

196

ByteBuffer buffer = cli.next();

214

197

215

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

216

String line = content_line.getUsAsciiLine();

198

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

199

String line;

200

try {

201

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

202

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

203

}

204

catch( UnsupportedEncodingException e ) {

205

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

206

line = "";

207

}

217

208

218

209

if( vcard == null ) {

219

210

// look for vcard beginning

220

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

211

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

221

212

setProgress( _progress++ );

222

213

vcard = new Vcard();

223

214

vcard_start_line = cli.getLineNumber();

225

216

}

226

217

else {

227

218

// look for vcard content or ending

228

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

219

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

229

220

{

230

221

// finalise the vcard/contact

231

222

try {

268

259

{

269

260

// try giving the line to the vcard

270

261

try {

271

vcard.parseLine( content_line );

262

vcard.parseLine( buffer, line,

263

cli.doesNextLineLookFolded() );

272

264

}

273

265

catch( Vcard.ParseException e ) {

274

266

skipContact();

281

273

finish( ACTION_ABORT );

282

274

}

283

275

284

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

285

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

276

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

277

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

286

278

// get to another BEGIN:VCARD line.

287

279

vcard = null;

288

280

}

289

281

catch( Vcard.SkipImportException e ) {

290

282

skipContact();

291

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

283

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

292

284

// we get to another BEGIN:VCARD line.

293

285

vcard = null;

294

286

}

297

289

}

298

290

}

299

291

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

class ContentLineIterator implements Iterator< ByteBuffer >

343

293

{

344

294

protected byte[] _content = null;

345

295

protected int _pos = 0;

357

307

}

358

308

359

309

@Override

360

public ContentLine next()

310

public ByteBuffer next()

361

311

{

362

312

int initial_pos = _pos;

363

313

370

320

_pos > initial_pos )? _pos - 1 : _pos;

371

321

_pos++;

372

322

_line++;

373

return new ContentLine(

374

ByteBuffer.wrap( _content, initial_pos,

375

to - initial_pos ),

376

doesNextLineLookFolded() );

323

return ByteBuffer.wrap( _content, initial_pos,

324

to - initial_pos );

377

325

}

378

326

379

327

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

381

329

int to = _pos;

382

330

_pos++;

383

331

_line++;

384

return new ContentLine(

385

ByteBuffer.wrap( _content, initial_pos,

386

to - initial_pos ),

387

doesNextLineLookFolded() );

332

return ByteBuffer.wrap( _content, initial_pos,

333

to - initial_pos );

388

334

}

389

335

390

336

// no bytes left

402

348

* onto the end of this one?

403

349

* @return

404

350

*/

405

private boolean doesNextLineLookFolded()

351

public boolean doesNextLineLookFolded()

406

352

{

407

353

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

408

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

409

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

354

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

410

355

}

411

356

412

357

public int getLineNumber()

424

369

private final static int MULTILINE_NONE = 0;

425

370

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

426

371

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

427

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

372

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

428

373

429

374

private String _version = null;

430

private Vector< ContentLine > _content_lines = null;

375

private Vector< ByteBuffer > _buffers = null;

431

376

private int _name_level = NAMELEVEL_NONE;

432

377

private int _parser_multiline_state = MULTILINE_NONE;

433

378

private String _parser_current_name_and_params = null;

476

421

@SuppressWarnings("serial")

477

422

protected class SkipImportException extends Exception { }

478

423

479

private String extractCollonPartFromLine( ContentLine content_line,

480

boolean former )

424

private String extractCollonPartFromLine( ByteBuffer buffer,

425

String line, boolean former )

481

426

{

427

String ret = null;

428

429

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

430

// supplied with one

431

if( line == null ) {

432

try {

433

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

434

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

435

}

436

catch( UnsupportedEncodingException e ) {

437

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

438

line = "";

439

}

440

}

441

482

442

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

483

443

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

484

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

444

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

485

445

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

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 )

446

ret = parts[ former? 0 : 1 ];

447

448

return ret;

449

}

450

451

private String extractNameAndParamsFromLine( ByteBuffer buffer,

452

String line )

453

{

454

return extractCollonPartFromLine( buffer, line, true );

455

}

456

457

private String extractValueFromLine( ByteBuffer buffer, String line )

458

{

459

return extractCollonPartFromLine( buffer, line, false );

460

}

461

462

public void parseLine( ByteBuffer buffer, String line,

463

boolean next_line_looks_folded )

502

464

throws ParseException, SkipImportException,

503

465

AbortImportException

504

466

{

507

469

{

508

470

// tentatively get name and params from line

509

471

String name_and_params =

510

extractNameAndParamsFromLine( content_line );

472

extractNameAndParamsFromLine( buffer, line );

511

473

512

474

// is it a version line?

513

475

if( name_and_params != null &&

514

name_and_params.equalsIgnoreCase( "VERSION" ) )

476

name_and_params.equals( "VERSION" ) )

515

477

{

516

478

// yes, get it!

517

String value = extractValueFromLine( content_line );

518

if( value == null || (

519

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

520

{

479

String value = extractValueFromLine( buffer, line );

480

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

521

481

throw new ParseException( R.string.error_vcf_version );

522

}

523

482

_version = value;

524

483

525

484

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

526

485

// for a version

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;

486

if( _buffers != null )

487

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

488

parseLine( _buffers.get( i ), null,

489

i + 1 < _buffers.size() &&

490

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

491

_buffers.get( i + 1 ).get(

492

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

493

_buffers = null;

531

494

}

532

495

else

533

496

{

534

497

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

535

if( _content_lines == null )

536

_content_lines = new Vector< ContentLine >();

537

_content_lines.add( content_line );

498

if( _buffers == null )

499

_buffers = new Vector< ByteBuffer >();

500

_buffers.add( buffer );

538

501

}

539

502

}

540

503

else

541

504

{

542

505

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

543

// "value" part of the line starts

506

// "value" part of the line start

544

507

String name_and_params;

545

508

int pos;

546

509

552

515

553

516

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

554

517

// of multi-line we're handling

555

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

518

pos = buffer.position();

556

519

switch( _parser_multiline_state )

557

520

{

558

521

case MULTILINE_FOLDED:

559

522

pos++;

560

523

break;

561

524

case MULTILINE_ENCODED:

562

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

563

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

564

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

525

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

526

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

527

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

565

528

{

566

529

pos++;

567

530

}

576

539

}

577

540

else

578

541

{

579

// skip empty lines

580

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

581

return;

582

583

542

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

584

543

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

585

544

// not fail, or it's an error

586

545

name_and_params =

587

extractNameAndParamsFromLine( content_line );

546

extractNameAndParamsFromLine( buffer, line );

588

547

if( name_and_params == null )

589

548

throw new ParseException(

590

549

R.string.error_vcf_malformed );

591

550

592

551

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

593

552

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

594

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

595

name_and_params.length() + 1;

553

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

596

554

597

555

// reset the saved multi-line state

598

556

_parser_current_name_and_params = name_and_params;

601

559

602

560

// get value from buffer, as raw bytes

603

561

ByteBuffer value;

604

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

605

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

562

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

563

buffer.limit() - pos );

606

564

607

565

// get parameter parts

608

566

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

615

573

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

616

574

) );

617

575

boolean is_interesting_field =

618

interesting_fields.contains(

619

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

576

interesting_fields.contains( name_param_parts[ 0 ] );

620

577

621

578

// parse encoding parameter

622

579

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

623

580

if( encoding != null )

624

581

encoding = encoding.toUpperCase( Locale.US );

625

582

if( is_interesting_field && encoding != null &&

626

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

627

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

628

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

583

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

584

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

585

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

629

586

{

630

587

throw new ParseException( R.string.error_vcf_encoding );

631

588

}

635

592

if( charset != null )

636

593

charset = charset.toUpperCase( Locale.US );

637

594

if( charset != null &&

638

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

639

!charset.equalsIgnoreCase( "ASCII" ) &&

640

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

595

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

596

!charset.equals( "ASCII" ) &&

597

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

641

598

{

642

599

throw new ParseException( R.string.error_vcf_charset );

643

600

}

645

602

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

646

603

// the raw string)

647

604

UnencodeResult unencoding_result = null;

648

if( encoding != null &&

649

encoding.equalsIgnoreCase( "QUOTED-PRINTABLE" ) )

650

{

605

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

651

606

unencoding_result = unencodeQuotedPrintable( value );

652

}

653

// else if( encoding != null &&

654

// encoding.equalsIgnoreCase( "BASE64" ) )

655

// {

607

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

656

608

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

657

// }

658

609

if( unencoding_result != null ) {

659

610

value = unencoding_result.getBuffer();

660

611

if( unencoding_result.isAnotherLineRequired() )

665

616

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

666

617

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

667

618

( charset != null && (

668

charset.equalsIgnoreCase( "ASCII" ) ||

669

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

619

charset.equals( "ASCII" ) ||

620

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

670

621

{

671

622

value = transcodeAsciiToUtf8( value );

672

623

}

683

634

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

684

635

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

685

636

// indicates that we have a multi-line value

686

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

687

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

688

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

637

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

638

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

639

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

689

640

doesStringEndInAnEscapeChar( string_value ) )

690

641

{

691

642

_parser_multiline_state = MULTILINE_ESCAPED;

693

644

string_value.length() - 1 );

694

645

}

695

646

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

647

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

648

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

698

649

if( _parser_multiline_state == MULTILINE_NONE &&

699

content_line.doesNextLineLookFolded() )

650

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

700

651

{

701

652

_parser_multiline_state = MULTILINE_FOLDED;

702

653

}

714

665

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

715

666

716

667

// parse some properties

717

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

668

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

718

669

parseN( name_param_parts, complete_value );

719

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

670

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

720

671

parseFN( name_param_parts, complete_value );

721

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

672

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

722

673

parseORG( name_param_parts, complete_value );

723

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

674

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

724

675

parseTITLE( name_param_parts, complete_value );

725

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

676

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

726

677

parseTEL( name_param_parts, complete_value );

727

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

678

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

728

679

parseEMAIL( name_param_parts, complete_value );

729

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

680

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

730

681

parseADR( name_param_parts, complete_value );

731

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

682

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

732

683

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 );

737

684

}

738

685

}

739

686

763

710

{

764

711

String str = parts.get( a );

765

712

766

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

767

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

713

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

714

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

768

715

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

769

716

// accordingly.

770

717

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

811

758

in_escape = false;

812

759

switch( c )

813

760

{

814

case 'T':

815

case 't':

816

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

817

ret.append( '\t' );

818

break;

819

761

case 'N':

820

762

case 'n':

821

763

// add newline

829

771

break;

830

772

default:

831

773

// unknown escape sequence, so add it unescaped

832

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

833

774

ret.append( "\\" );

834

775

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

835

776

break;

860

801

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

861

802

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

862

803

{

863

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

804

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

864

805

value += name_part_parts[ b ];

865

806

}

866

807

}

985

926

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

986

927

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

987

928

{

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

}

929

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

930

String[] adr_part_parts =

931

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

932

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

933

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

934

{

935

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

936

value += adr_part_parts[ b ];

937

}

1008

938

}

1009

939

1010

940

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

1035

965

addAddress( unescapeValue( value ), type );

1036

966

}

1037

967

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 );

1046

}

1047

1048

968

public void finaliseVcard()

1049

969

throws ParseException, ContactNotIdentifiableException

1050

970

{

1051

971

// missing version (and data is present)

1052

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

972

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

1053

973

throw new ParseException( R.string.error_vcf_malformed );

1054

974

1055

975

// finalise the parent class

1058

978

1059

979

/**

1060

980

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

1061

* the specified name.

1062

*

981

* the specified name

1063

982

* @param params

1064

983

* @param name

1065

984

* @return a value, or null

1071

990

}

1072

991

1073

992

/**

1074

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

1075

*

993

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

1076

994

* @param params

1077

995

* @param name

1078

996

* @return an array of values, or null

1082

1000

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

1083

1001

1084

1002

Pattern p = Pattern.compile(

1085

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

1086

Pattern.CASE_INSENSITIVE );

1003

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

1087

1004

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

1088

1005

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

1089

1006

if( m.matches() )

1094

1011

}

1095

1012

1096

1013

/**

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

1014

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

1015

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

1016

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

1017

* @param params

1018

* @param a list of type values to look for

1103

1019

* @return a set of present type values

1104

1020

*/

1105

1021

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

1111

1027

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

1112

1028

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

1113

1029

{

1114

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

1115

// this is in the specs!)

1030

// check for a comma-separated list of types (why? this isn't in

1031

// the specs!)

1116

1032

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

}

1033

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

1034

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

1035

types.add( parts[ i ] );

1122

1036

}

1123

1037

1124

1038

// get 2.1-style type param

1125

1039

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

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

}

1040

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

1041

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

1042

types.add( params[ i ] );

1131

1043

}

1132

1044

1133

1045

return types;

1155

1067

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

1156

1068

{

1157

1069

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

1158

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

1070

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

1159

1071

another = true;

1160

1072

continue;

1161

1073

}