/android/export-contacts : contents of src/am/ed/exportcontacts/Exporter.java at revision 45

: (revision 45)

To get this branch, use:

bzr branch
http://bzr.ed.am/android/export-contacts

/*
 * Exporter.java
 *
 * Copyright (C) 2011 to 2013 Tim Marston <tim@ed.am>
 *
 * This file is part of the Export Contacts program (hereafter referred
 * to as "this program").  For more information, see
 * http://ed.am/dev/android/export-contacts
 *
 * This program is free software: you can redistribute it and/or modify
 * it under the terms of the GNU General Public License as published by
 * the Free Software Foundation, either version 3 of the License, or
 * (at your option) any later version.
 *
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License
 * along with this program.  If not, see <http://www.gnu.org/licenses/>.
 */

package am.ed.exportcontacts;

import java.util.ArrayList;

import android.content.SharedPreferences;
import android.os.Message;


public class Exporter extends Thread
{
	public final static int ACTION_ABORT = 1;
	public final static int ACTION_ALLDONE = 2;

	public final static int RESPONSE_NEGATIVE = 0;
	public final static int RESPONSE_POSITIVE = 1;

	public final static int RESPONSEEXTRA_NONE = 0;
	public final static int RESPONSEEXTRA_ALWAYS = 1;

	private Doit _doit;
	private int _response;
	private boolean _abort = false;
	private boolean _is_finished = false;

	/**
	 * Data about a contact
	 */
	public class ContactData
	{
		public final static int TYPE_HOME = 0;
		public final static int TYPE_WORK = 1;
		public final static int TYPE_MOBILE = 2;	// only used with phones
		public final static int TYPE_FAX_HOME = 3;	// only used with phones
		public final static int TYPE_FAX_WORK = 4;	// only used with phones
		public final static int TYPE_PAGER = 5;		// only used with phones

		class OrganisationDetail
		{
			protected String _org;
			protected String _title;

			public OrganisationDetail( String org, String title )
			{
				_org = org != null && org.length() > 0? org : null;
				_title = title != null && title.length() > 0? title : null;
			}

			public String getOrganisation()
			{
				return _org;
			}

			public String getTitle()
			{
				return _title;
			}
		}

		class NumberDetail
		{
			protected int _type;
			protected String _num;

			public NumberDetail( int type, String num )
			{
				_type = type;
				_num = num != null && num.length() > 0? num : null;
			}

			public int getType()
			{
				return _type;
			}

			public String getNumber()
			{
				return _num;
			}
		}

		class EmailDetail
		{
			protected int _type;
			protected String _email;

			public EmailDetail( int type, String email )
			{
				_type = type;
				_email = email != null && email.length() > 0? email : null;
			}

			public int getType()
			{
				return _type;
			}

			public String getEmail()
			{
				return _email;
			}
		}

		class AddressDetail
		{
			protected int _type;
			protected String _addr;

			public AddressDetail( int type, String addr )
			{
				_type = type;
				_addr = addr != null && addr.length() > 0? addr : null;
			}

			public int getType()
			{
				return _type;
			}

			public String getAddress()
			{
				return _addr;
			}
		}

		protected String _name = null;
		protected ArrayList< OrganisationDetail > _organisations = null;
		protected ArrayList< NumberDetail > _numbers = null;
		protected ArrayList< EmailDetail > _emails = null;
		protected ArrayList< AddressDetail > _addresses = null;
		protected ArrayList< String > _notes = null;
		protected String _birthday = null;

		public void setName( String name )
		{
			_name = name != null && name.length() > 0? name : null;
		}

		public String getName()
		{
			return _name;
		}

		public void addOrganisation( OrganisationDetail organisation )
		{
			if( organisation.getOrganisation() == null ) return;
			if( _organisations == null )
				_organisations = new ArrayList< OrganisationDetail >();
			_organisations.add( organisation );
		}

		public ArrayList< OrganisationDetail > getOrganisations()
		{
			return _organisations;
		}

		public void addNumber( NumberDetail number )
		{
			if( number.getNumber() == null ) return;
			if( _numbers == null )
				_numbers = new ArrayList< NumberDetail >();
			_numbers.add( number );
		}

		public ArrayList< NumberDetail > getNumbers()
		{
			return _numbers;
		}

		public void addEmail( EmailDetail email )
		{
			if( email.getEmail() == null ) return;
			if( _emails == null )
				_emails = new ArrayList< EmailDetail >();
			_emails.add( email );
		}

		public ArrayList< EmailDetail > getEmails()
		{
			return _emails;
		}

		public void addAddress( AddressDetail address )
		{
			if( address.getAddress() == null ) return;
			if( _addresses == null )
				_addresses = new ArrayList< AddressDetail >();
			_addresses.add( address );
		}

		public ArrayList< AddressDetail > getAddresses()
		{
			return _addresses;
		}

		public void addNote( String note )
		{
			if( _notes == null )
				_notes = new ArrayList< String >();
			_notes.add( note );
		}

		public ArrayList< String > getNotes()
		{
			return _notes;
		}

		public void setBirthday( String birthday )
		{
			_birthday = birthday;
		}

		public String getBirthday()
		{
			return _birthday;
		}

		public String getPrimaryIdentifier()
		{
			if( _name != null )
				return _name;

			if( _organisations != null &&
				_organisations.get( 0 ).getOrganisation() != null )
				return _organisations.get( 0 ).getOrganisation();

			if( _numbers!= null &&
				_numbers.get( 0 ).getNumber() != null )
				return _numbers.get( 0 ).getNumber();

			if( _emails!= null &&
				_emails.get( 0 ).getEmail() != null )
				return _emails.get( 0 ).getEmail();

			// no primary identifier
			return null;
		}
	}

	@SuppressWarnings( "serial" )
	protected class AbortExportException extends Exception { };

	public Exporter( Doit doit )
	{
		_doit = doit;
	}

	@Override
	public void run()
	{
		try
		{
			// update UI
			setProgressMessage( R.string.doit_scanning );

			// do the export
			exportContacts();

			// done!
			finish( ACTION_ALLDONE );
		}
		catch( AbortExportException e )
		{}

		// flag as finished to prevent interrupts
		setIsFinished();
	}

	synchronized private void setIsFinished()
	{
		_is_finished = true;
	}

	protected void exportContacts() throws AbortExportException
	{
		// set up a contact reader
		Backend backend = null;
		if( Integer.parseInt( android.os.Build.VERSION.SDK ) >= 5 )
			backend = new ContactsContractBackend( _doit, this );
		else
			backend = new ContactsBackend( _doit, this );

		// check we have contacts
		int num_contacts = backend.getNumContacts();
		if( num_contacts == 0 )
			showError( R.string.error_nothingtodo );

		// count the number of contacts and set the progress bar max
		setProgress( 0 );
		setProgressMax( num_contacts );

		checkAbort();
		preExport();

		// loop through contacts
		int count = 0;
		while( true ) {
			checkAbort();
			ContactData contact = new ContactData();
			if( !backend.getNextContact( contact ) )
				break;

			// export this one
			checkAbort();
			if( exportContact( contact ) )
				_doit._handler.sendEmptyMessage( Doit.MESSAGE_CONTACTWRITTEN );
			else
				_doit._handler.sendEmptyMessage( Doit.MESSAGE_CONTACTSKIPPED );
			setProgress( count++ );
		}
		setProgress( num_contacts );

		postExport();
	}

	public void wake()
	{
		wake( 0 );
	}

	synchronized public void wake( int response )
	{
		_response = response;
		notify();
	}

	synchronized public boolean setAbort()
	{
		if( !_is_finished && !_abort ) {
			_abort = true;
			notify();
			return true;
		}
		return false;
	}

	protected SharedPreferences getSharedPreferences()
	{
		return _doit.getSharedPreferences();
	}

	protected void showError( int res ) throws AbortExportException
	{
		showError( _doit.getText( res ).toString() );
	}

	synchronized protected void showError( String message )
			throws AbortExportException
	{
		checkAbort();
		_doit._handler.sendMessage( Message.obtain(
			_doit._handler, Doit.MESSAGE_ERROR, message ) );
		try {
			wait();
		}
		catch( InterruptedException e ) { }

		// no need to check if an abortion happened during the wait, we are
		// about to finish anyway!
		finish( ACTION_ABORT );
	}

	protected void showContinueOrAbort( int res ) throws AbortExportException
	{
		showContinueOrAbort( _doit.getText( res ).toString() );
	}

	synchronized protected void showContinueOrAbort( String message )
			throws AbortExportException
	{
		checkAbort();
		_doit._handler.sendMessage( Message.obtain(
			_doit._handler, Doit.MESSAGE_CONTINUEORABORT, message ) );
		try {
			wait();
		}
		catch( InterruptedException e ) { }

		// if we're aborting, there's no need to check if an abortion happened
		// during the wait
		if( _response == RESPONSE_NEGATIVE )
			finish( ACTION_ABORT );
		else
			checkAbort();
	}

	protected void setProgressMessage( int res ) throws AbortExportException
	{
		checkAbort();
		_doit._handler.sendMessage( Message.obtain( _doit._handler,
			Doit.MESSAGE_SETPROGRESSMESSAGE, getText( res ) ) );
	}

	protected void setProgressMax( int max_progress )
			throws AbortExportException
	{
		checkAbort();
		_doit._handler.sendMessage( Message.obtain(
			_doit._handler, Doit.MESSAGE_SETMAXPROGRESS,
			Integer.valueOf( max_progress ) ) );
	}

	protected void setTmpProgress( int tmp_progress )
		throws AbortExportException
	{
		checkAbort();
		_doit._handler.sendMessage( Message.obtain(
			_doit._handler, Doit.MESSAGE_SETTMPPROGRESS,
			Integer.valueOf( tmp_progress ) ) );
	}

	protected void setProgress( int progress ) throws AbortExportException
	{
		checkAbort();
		_doit._handler.sendMessage( Message.obtain(
			_doit._handler, Doit.MESSAGE_SETPROGRESS,
			Integer.valueOf( progress ) ) );
	}

	protected void finish( int action ) throws AbortExportException
	{
		// update UI to reflect action
		int message;
		switch( action )
		{
		case ACTION_ALLDONE:	message = Doit.MESSAGE_ALLDONE; break;
		default:	// fall through
		case ACTION_ABORT:		message = Doit.MESSAGE_ABORT; break;
		}
		_doit._handler.sendEmptyMessage( message );

		// stop
		throw new AbortExportException();
	}

	protected CharSequence getText( int res )
	{
		return _doit.getText( res );
	}

	protected void skipContact() throws AbortExportException
	{
		checkAbort();
		_doit._handler.sendEmptyMessage( Doit.MESSAGE_CONTACTSKIPPED );
	}

	synchronized protected void checkAbort() throws AbortExportException
	{
		if( _abort ) {
			// stop
			throw new AbortExportException();
		}
	}

	protected void preExport() throws AbortExportException
	{
	}

	protected boolean exportContact( ContactData contact )
		throws AbortExportException
	{
		throw new UnsupportedOperationException();
	}

	protected void postExport() throws AbortExportException
	{
	}

}

5 by edam - added ContactReader interface	1	/*
	2	* Exporter.java
	3	*
32 by Tim Marston added support for birthdays	4	* Copyright (C) 2011 to 2013 Tim Marston <tim@ed.am>
5 by edam - added ContactReader interface	5	*
5 by edam - added ContactReader interface	6	* This file is part of the Export Contacts program (hereafter referred
30 by Tim Marston minor style tweaks	7	* to as "this program"). For more information, see
12 by edam changed all the URLs to ed.am, including copyrights, package names and project	8	* http://ed.am/dev/android/export-contacts
5 by edam - added ContactReader interface	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
	12	* the Free Software Foundation, either version 3 of the License, or
	13	* (at your option) any later version.
	14	*
	15	* This program is distributed in the hope that it will be useful,
	16	* but WITHOUT ANY WARRANTY; without even the implied warranty of
	17	* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
	18	* GNU General Public License for more details.
	19	*
	20	* You should have received a copy of the GNU General Public License
	21	* along with this program. If not, see <http://www.gnu.org/licenses/>.
	22	*/
	23
12 by edam changed all the URLs to ed.am, including copyrights, package names and project	24	package am.ed.exportcontacts;
5 by edam - added ContactReader interface	25
	26	import java.util.ArrayList;
	27
	28	import android.content.SharedPreferences;
	29	import android.os.Message;
	30
	31
	32	public class Exporter extends Thread
	33	{
	34	public final static int ACTION_ABORT = 1;
	35	public final static int ACTION_ALLDONE = 2;
	36
	37	public final static int RESPONSE_NEGATIVE = 0;
	38	public final static int RESPONSE_POSITIVE = 1;
	39
	40	public final static int RESPONSEEXTRA_NONE = 0;
	41	public final static int RESPONSEEXTRA_ALWAYS = 1;
	42
	43	private Doit _doit;
	44	private int _response;
	45	private boolean _abort = false;
	46	private boolean _is_finished = false;
	47
	48	/**
	49	* Data about a contact
	50	*/
	51	public class ContactData
	52	{
18 by edam added ContactsContract backend; removed references to Contacts types (conversion to/from backend types now done in backends); added support for exporting NOTEs	53	public final static int TYPE_HOME = 0;
	54	public final static int TYPE_WORK = 1;
	55	public final static int TYPE_MOBILE = 2; // only used with phones
	56	public final static int TYPE_FAX_HOME = 3; // only used with phones
	57	public final static int TYPE_FAX_WORK = 4; // only used with phones
	58	public final static int TYPE_PAGER = 5; // only used with phones
	59
5 by edam - added ContactReader interface	60	class OrganisationDetail
	61	{
	62	protected String _org;
	63	protected String _title;
	64
	65	public OrganisationDetail( String org, String title )
	66	{
	67	_org = org != null && org.length() > 0? org : null;
	68	_title = title != null && title.length() > 0? title : null;
	69	}
	70
	71	public String getOrganisation()
	72	{
	73	return _org;
	74	}
	75
	76	public String getTitle()
	77	{
	78	return _title;
	79	}
	80	}
	81
	82	class NumberDetail
	83	{
	84	protected int _type;
	85	protected String _num;
	86
	87	public NumberDetail( int type, String num )
	88	{
	89	_type = type;
	90	_num = num != null && num.length() > 0? num : null;
	91	}
	92
	93	public int getType()
	94	{
	95	return _type;
	96	}
	97
	98	public String getNumber()
	99	{
	100	return _num;
	101	}
	102	}
	103
	104	class EmailDetail
	105	{
	106	protected int _type;
	107	protected String _email;
	108
	109	public EmailDetail( int type, String email )
	110	{
	111	_type = type;
	112	_email = email != null && email.length() > 0? email : null;
	113	}
	114
	115	public int getType()
	116	{
	117	return _type;
	118	}
	119
	120	public String getEmail()
	121	{
	122	return _email;
	123	}
124	}
125
126	class AddressDetail
127	{
128	protected int _type;
129	protected String _addr;
130
131	public AddressDetail( int type, String addr )
132	{
133	_type = type;
134	_addr = addr != null && addr.length() > 0? addr : null;
135	}
136
137	public int getType()
138	{
139	return _type;
140	}
141
142	public String getAddress()
143	{
144	return _addr;
145	}
146	}
147
148	protected String _name = null;
149	protected ArrayList< OrganisationDetail > _organisations = null;
150	protected ArrayList< NumberDetail > _numbers = null;
151	protected ArrayList< EmailDetail > _emails = null;
152	protected ArrayList< AddressDetail > _addresses = null;
18 by edam added ContactsContract backend; removed references to Contacts types (conversion to/from backend types now done in backends); added support for exporting NOTEs	153	protected ArrayList< String > _notes = null;
32 by Tim Marston added support for birthdays	154	protected String _birthday = null;
5 by edam - added ContactReader interface	155
	156	public void setName( String name )
	157	{
	158	_name = name != null && name.length() > 0? name : null;
	159	}
	160
	161	public String getName()
	162	{
	163	return _name;
	164	}
	165
	166	public void addOrganisation( OrganisationDetail organisation )
	167	{
	168	if( organisation.getOrganisation() == null ) return;
	169	if( _organisations == null )
	170	_organisations = new ArrayList< OrganisationDetail >();
	171	_organisations.add( organisation );
	172	}
	173
	174	public ArrayList< OrganisationDetail > getOrganisations()
	175	{
	176	return _organisations;
	177	}
	178
	179	public void addNumber( NumberDetail number )
	180	{
	181	if( number.getNumber() == null ) return;
	182	if( _numbers == null )
	183	_numbers = new ArrayList< NumberDetail >();
	184	_numbers.add( number );
	185	}
	186
	187	public ArrayList< NumberDetail > getNumbers()
	188	{
	189	return _numbers;
	190	}
	191
	192	public void addEmail( EmailDetail email )
	193	{
	194	if( email.getEmail() == null ) return;
	195	if( _emails == null )
	196	_emails = new ArrayList< EmailDetail >();
	197	_emails.add( email );
	198	}
	199
	200	public ArrayList< EmailDetail > getEmails()
	201	{
	202	return _emails;
	203	}
	204
	205	public void addAddress( AddressDetail address )
	206	{
	207	if( address.getAddress() == null ) return;
	208	if( _addresses == null )
	209	_addresses = new ArrayList< AddressDetail >();
	210	_addresses.add( address );
	211	}
	212
	213	public ArrayList< AddressDetail > getAddresses()
	214	{
	215	return _addresses;
	216	}
	217
18 by edam added ContactsContract backend; removed references to Contacts types (conversion to/from backend types now done in backends); added support for exporting NOTEs	218	public void addNote( String note )
	219	{
	220	if( _notes == null )
	221	_notes = new ArrayList< String >();
	222	_notes.add( note );
	223	}
	224
	225	public ArrayList< String > getNotes()
	226	{
	227	return _notes;
	228	}
	229
32 by Tim Marston added support for birthdays	230	public void setBirthday( String birthday )
	231	{
	232	_birthday = birthday;
	233	}
	234
	235	public String getBirthday()
	236	{
	237	return _birthday;
	238	}
	239
5 by edam - added ContactReader interface	240	public String getPrimaryIdentifier()
	241	{
	242	if( _name != null )
	243	return _name;
	244
	245	if( _organisations != null &&
	246	_organisations.get( 0 ).getOrganisation() != null )
	247	return _organisations.get( 0 ).getOrganisation();
	248
	249	if( _numbers!= null &&
	250	_numbers.get( 0 ).getNumber() != null )
	251	return _numbers.get( 0 ).getNumber();
	252
	253	if( _emails!= null &&
	254	_emails.get( 0 ).getEmail() != null )
	255	return _emails.get( 0 ).getEmail();
	256
	257	// no primary identifier
	258	return null;
	259	}
	260	}
	261
	262	@SuppressWarnings( "serial" )
	263	protected class AbortExportException extends Exception { };
	264
	265	public Exporter( Doit doit )
	266	{
	267	_doit = doit;
	268	}
	269
	270	@Override
	271	public void run()
	272	{
	273	try
	274	{
	275	// update UI
	276	setProgressMessage( R.string.doit_scanning );
	277
	278	// do the export
	279	exportContacts();
	280
	281	// done!
	282	finish( ACTION_ALLDONE );
	283	}
	284	catch( AbortExportException e )
	285	{}
	286
	287	// flag as finished to prevent interrupts
	288	setIsFinished();
	289	}
	290
	291	synchronized private void setIsFinished()
	292	{
	293	_is_finished = true;
	294	}
	295
	296	protected void exportContacts() throws AbortExportException
	297	{
	298	// set up a contact reader
21 by edam fixed column values in Contacts backend; don't write-out empty notes; remember to close my queries; switched from wrappers to static valueOf() functions; fix line-endings (should be \r\n)	299	Backend backend = null;
18 by edam added ContactsContract backend; removed references to Contacts types (conversion to/from backend types now done in backends); added support for exporting NOTEs	300	if( Integer.parseInt( android.os.Build.VERSION.SDK ) >= 5 )
21 by edam fixed column values in Contacts backend; don't write-out empty notes; remember to close my queries; switched from wrappers to static valueOf() functions; fix line-endings (should be \r\n)	301	backend = new ContactsContractBackend( _doit, this );
18 by edam added ContactsContract backend; removed references to Contacts types (conversion to/from backend types now done in backends); added support for exporting NOTEs	302	else
21 by edam fixed column values in Contacts backend; don't write-out empty notes; remember to close my queries; switched from wrappers to static valueOf() functions; fix line-endings (should be \r\n)	303	backend = new ContactsBackend( _doit, this );
18 by edam added ContactsContract backend; removed references to Contacts types (conversion to/from backend types now done in backends); added support for exporting NOTEs	304
	305	// check we have contacts
21 by edam fixed column values in Contacts backend; don't write-out empty notes; remember to close my queries; switched from wrappers to static valueOf() functions; fix line-endings (should be \r\n)	306	int num_contacts = backend.getNumContacts();
5 by edam - added ContactReader interface	307	if( num_contacts == 0 )
	308	showError( R.string.error_nothingtodo );
	309
	310	// count the number of contacts and set the progress bar max
	311	setProgress( 0 );
	312	setProgressMax( num_contacts );
	313
	314	checkAbort();
	315	preExport();
	316
	317	// loop through contacts
	318	int count = 0;
	319	while( true ) {
	320	checkAbort();
	321	ContactData contact = new ContactData();
21 by edam fixed column values in Contacts backend; don't write-out empty notes; remember to close my queries; switched from wrappers to static valueOf() functions; fix line-endings (should be \r\n)	322	if( !backend.getNextContact( contact ) )
5 by edam - added ContactReader interface	323	break;
	324
	325	// export this one
	326	checkAbort();
	327	if( exportContact( contact ) )
	328	_doit._handler.sendEmptyMessage( Doit.MESSAGE_CONTACTWRITTEN );
	329	else
	330	_doit._handler.sendEmptyMessage( Doit.MESSAGE_CONTACTSKIPPED );
	331	setProgress( count++ );
	332	}
	333	setProgress( num_contacts );
	334
	335	postExport();
	336	}
	337
	338	public void wake()
	339	{
	340	wake( 0 );
	341	}
	342
	343	synchronized public void wake( int response )
	344	{
	345	_response = response;
	346	notify();
	347	}
	348
	349	synchronized public boolean setAbort()
	350	{
	351	if( !_is_finished && !_abort ) {
	352	_abort = true;
	353	notify();
	354	return true;
	355	}
	356	return false;
	357	}
	358
	359	protected SharedPreferences getSharedPreferences()
	360	{
	361	return _doit.getSharedPreferences();
	362	}
	363
	364	protected void showError( int res ) throws AbortExportException
	365	{
	366	showError( _doit.getText( res ).toString() );
	367	}
	368
	369	synchronized protected void showError( String message )
	370	throws AbortExportException
	371	{
	372	checkAbort();
	373	_doit._handler.sendMessage( Message.obtain(
	374	_doit._handler, Doit.MESSAGE_ERROR, message ) );
	375	try {
	376	wait();
	377	}
	378	catch( InterruptedException e ) { }
	379
	380	// no need to check if an abortion happened during the wait, we are
	381	// about to finish anyway!
	382	finish( ACTION_ABORT );
	383	}
	384
43 by Tim Marston removed some unused code, fixed locale warnings and made showContinueOrAbort()	385	protected void showContinueOrAbort( int res ) throws AbortExportException
	386	{
	387	showContinueOrAbort( _doit.getText( res ).toString() );
	388	}
	389
	390	synchronized protected void showContinueOrAbort( String message )
5 by edam - added ContactReader interface	391	throws AbortExportException
	392	{
	393	checkAbort();
	394	_doit._handler.sendMessage( Message.obtain(
	395	_doit._handler, Doit.MESSAGE_CONTINUEORABORT, message ) );
	396	try {
	397	wait();
	398	}
	399	catch( InterruptedException e ) { }
	400
43 by Tim Marston removed some unused code, fixed locale warnings and made showContinueOrAbort()	401	// if we're aborting, there's no need to check if an abortion happened
	402	// during the wait
	403	if( _response == RESPONSE_NEGATIVE )
	404	finish( ACTION_ABORT );
	405	else
	406	checkAbort();
5 by edam - added ContactReader interface	407	}
	408
	409	protected void setProgressMessage( int res ) throws AbortExportException
	410	{
	411	checkAbort();
	412	_doit._handler.sendMessage( Message.obtain( _doit._handler,
	413	Doit.MESSAGE_SETPROGRESSMESSAGE, getText( res ) ) );
	414	}
	415
	416	protected void setProgressMax( int max_progress )
	417	throws AbortExportException
	418	{
	419	checkAbort();
	420	_doit._handler.sendMessage( Message.obtain(
	421	_doit._handler, Doit.MESSAGE_SETMAXPROGRESS,
21 by edam fixed column values in Contacts backend; don't write-out empty notes; remember to close my queries; switched from wrappers to static valueOf() functions; fix line-endings (should be \r\n)	422	Integer.valueOf( max_progress ) ) );
5 by edam - added ContactReader interface	423	}
	424
	425	protected void setTmpProgress( int tmp_progress )
	426	throws AbortExportException
	427	{
	428	checkAbort();
	429	_doit._handler.sendMessage( Message.obtain(
	430	_doit._handler, Doit.MESSAGE_SETTMPPROGRESS,
21 by edam fixed column values in Contacts backend; don't write-out empty notes; remember to close my queries; switched from wrappers to static valueOf() functions; fix line-endings (should be \r\n)	431	Integer.valueOf( tmp_progress ) ) );
5 by edam - added ContactReader interface	432	}
	433
	434	protected void setProgress( int progress ) throws AbortExportException
	435	{
	436	checkAbort();
	437	_doit._handler.sendMessage( Message.obtain(
	438	_doit._handler, Doit.MESSAGE_SETPROGRESS,
21 by edam fixed column values in Contacts backend; don't write-out empty notes; remember to close my queries; switched from wrappers to static valueOf() functions; fix line-endings (should be \r\n)	439	Integer.valueOf( progress ) ) );
5 by edam - added ContactReader interface	440	}
	441
	442	protected void finish( int action ) throws AbortExportException
	443	{
	444	// update UI to reflect action
	445	int message;
	446	switch( action )
	447	{
	448	case ACTION_ALLDONE: message = Doit.MESSAGE_ALLDONE; break;
	449	default: // fall through
	450	case ACTION_ABORT: message = Doit.MESSAGE_ABORT; break;
	451	}
	452	_doit._handler.sendEmptyMessage( message );
	453
	454	// stop
	455	throw new AbortExportException();
	456	}
	457
	458	protected CharSequence getText( int res )
	459	{
	460	return _doit.getText( res );
	461	}
	462
	463	protected void skipContact() throws AbortExportException
	464	{
	465	checkAbort();
	466	_doit._handler.sendEmptyMessage( Doit.MESSAGE_CONTACTSKIPPED );
	467	}
	468
	469	synchronized protected void checkAbort() throws AbortExportException
	470	{
	471	if( _abort ) {
	472	// stop
	473	throw new AbortExportException();
	474	}
	475	}
	476
	477	protected void preExport() throws AbortExportException
	478	{
	479	}
	480
	481	protected boolean exportContact( ContactData contact )
	482	throws AbortExportException
	483	{
	484	throw new UnsupportedOperationException();
	485	}
	486
	487	protected void postExport() throws AbortExportException
	488	{
	489	}
	490
	491	}