Android - An Open Handset Alliance Project

android.telephony.gsm
public class

android.telephony.gsm.SimPhoneBookInterfaceManager

java.lang.Object
	android.os.Binder			IBinder
		android.telephony.gsm.ISimPhoneBook.Stub		ISimPhoneBook
			android.telephony.gsm.SimPhoneBookInterfaceManager

SimPhoneBookInterfaceManager to provide an inter-process communication to access ADN-like SIM records.

Summary

Constants inherited from interface android.os.IBinder

DUMP_TRANSACTION, FIRST_CALL_TRANSACTION, LAST_CALL_TRANSACTION, PING_TRANSACTION

			Value
int	DUMP_TRANSACTION	IBinder protocol transaction code: dump internal state.	1598311760	0x5f444d50
int	FIRST_CALL_TRANSACTION	The first transaction code available for user commands.	1	0x00000001
int	LAST_CALL_TRANSACTION	The last transaction code available for user commands.	16777215	0x00ffffff
int	PING_TRANSACTION	IBinder protocol transaction code: pingBinder().	1599098439	0x5f504e47

Public Constructors

SimPhoneBookInterfaceManager(GSMPhone phone)

Public Methods

				List	getAdnRecordsInEf(int efid)
					Loads the AdnRecords in efid and returns them as a List of AdnRecords
				int[]	getAdnRecordsSize(int efid)
					Get the capacity of records in efid
				boolean	updateAdnRecordsInEfByIndex(int efid, String newTag, String newPhoneNumber, int index, String pin2)
					Update an ADN-like EF record by record index This is useful for iteration the whole ADN file, such as write the whole phone book or erase/format the whole phonebook
				boolean	updateAdnRecordsInEfBySearch(int efid, String oldTag, String oldPhoneNumber, String newTag, String newPhoneNumber, String pin2)
					Replace oldAdn with newAdn in ADN-like record in EF getAdnRecordsInEf must be called at least once before this function, otherwise an error will be returned

Methods inherited from class android.telephony.gsm.ISimPhoneBook.Stub

asBinder, asInterface, onTransact

Methods inherited from class android.os.Binder

attachInterface, clearCallingIdentity, dump, finalize, flushPendingCommands, getCallingPid, getCallingUid, getConstantData, getContextObject, getLastGcTime, joinThreadPool, linkToDeath, onTransact, pingBinder, queryLocalInterface, restoreCallingIdentity, transact, unlinkToDeath

		void	attachInterface(IInterface owner, String descriptor)
			Convenience method for associating a specific interface with the Binder.
final	static	long	clearCallingIdentity()
			Reset the identity of the incoming IPC to the local process.
		void	dump(FileDescriptor fd, PrintWriter fout)
			Print the object's state into the given stream.
		void	finalize()
			Called by the virtual machine when there are no longer any (non-weak) references to the receiver.
final	static	void	flushPendingCommands()
			Flush any Binder commands pending in the current thread to the kernel driver.
final	static	int	getCallingPid()
			Return the ID of the process that sent you the current transaction that is being processed.
final	static	int	getCallingUid()
			Return the ID of the user assigned to the process that sent you the current transaction that is being processed.
		int	getConstantData(Parcel outData)
			Default implementation has no constant data.
final	static	IBinder	getContextObject()
			Return the global "context object" of the system.
	static	long	getLastGcTime()
			Return the system time (as reported by {@link SystemClock#uptimeMillis SystemClock.uptimeMillis()) that the last garbage collection occurred in this process.
final	static	void	joinThreadPool()
			Add the calling thread to the IPC thread pool.
		void	linkToDeath(DeathRecipient recipient, int flags)
			Local implementation is a no-op.
		boolean	onTransact(int code, Parcel data, Parcel reply, int flags)
			Default implementation is a stub that returns false.
		boolean	pingBinder()
			Default implementation always returns true -- if you got here, the object is alive.
		IInterface	queryLocalInterface(String descriptor)
			Use information supplied to attachInterface() to return the associated IInterface if it matches the requested descriptor.
final	static	void	restoreCallingIdentity(long token)
			Restore the identity of the incoming IPC back to a previously identity that was returned by clearCallingIdentity().
final		boolean	transact(int code, Parcel data, Parcel reply, int flags)
			Default implementation rewinds the parcels and calls onTransact.
		boolean	unlinkToDeath(DeathRecipient recipient, int flags)
			Local implementation is a no-op.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

	Object	clone()
		Answers a new instance of the same class as the receiver, whose slots have been filled in with the values in the slots of the receiver.
	boolean	equals(Object o)
		Compares the argument to the receiver, and answers true if they represent the same object using a class specific comparison.
	void	finalize()
		Called by the virtual machine when there are no longer any (non-weak) references to the receiver.
final	Class	getClass()
		Answers the unique instance of java.lang.Class which represents the class of the receiver.
	int	hashCode()
		Answers an integer hash code for the receiver.
final	void	notify()
		Causes one thread which is `wait` ing on the receiver to be made ready to run.
final	void	notifyAll()
		Causes all threads which are `wait` ing on the receiver to be made ready to run.
	String	toString()
		Answers a string containing a concise, human-readable description of the receiver.
final	void	wait(long time, int frac)
		Causes the thread which sent this message to be made not ready to run either pending some change in the receiver (as indicated by `notify` or `notifyAll`) or the expiration of the timeout.
final	void	wait(long time)
		Causes the thread which sent this message to be made not ready to run either pending some change in the receiver (as indicated by `notify` or `notifyAll`) or the expiration of the timeout.
final	void	wait()
		Causes the thread which sent this message to be made not ready to run pending some change in the receiver (as indicated by `notify` or `notifyAll`).

Details

Public Constructors

public SimPhoneBookInterfaceManager(GSMPhone phone)

Public Methods

public List getAdnRecordsInEf(int efid)

Loads the AdnRecords in efid and returns them as a List of AdnRecords

Parameters

efid	the EF id of a ADN-like SIM

Returns

List of AdnRecord

public int[] getAdnRecordsSize(int efid)

Get the capacity of records in efid

Parameters

efid	the EF id of a ADN-like SIM

Returns

int[3] array recordSizes[0] is the single record length recordSizes[1] is the total length of the EF file recordSizes[2] is the number of records in the EF file

public boolean updateAdnRecordsInEfByIndex(int efid, String newTag, String newPhoneNumber, int index, String pin2)

Update an ADN-like EF record by record index This is useful for iteration the whole ADN file, such as write the whole phone book or erase/format the whole phonebook

Parameters

efid	must be one among EF_ADN, EF_FDN, and EF_SDN
newTag	adn tag to be stored
newPhoneNumber	adn number to be stored Set both newTag and newPhoneNubmer to "" means to replace the old record with empty one, aka, delete old record
index	is 1-based adn record index to be updated
pin2	required to update EF_FDN, otherwise must be null

Returns

true for success

public boolean updateAdnRecordsInEfBySearch(int efid, String oldTag, String oldPhoneNumber, String newTag, String newPhoneNumber, String pin2)

Replace oldAdn with newAdn in ADN-like record in EF getAdnRecordsInEf must be called at least once before this function, otherwise an error will be returned

Parameters

efid	must be one among EF_ADN, EF_FDN, and EF_SDN
oldTag	adn tag to be replaced
oldPhoneNumber	adn number to be replaced Set both oldTag and oldPhoneNubmer to "" means to replace an empty record, aka, insert new record
newTag	adn tag to be stored
newPhoneNumber	adn number ot be stored Set both newTag and newPhoneNubmer to "" means to replace the old record with empty one, aka, delete old record
pin2	required to update EF_FDN, otherwise must be null

Returns

true for success

Android - An Open Handset Alliance Project

Documentation

Goodies

android.telephony.gsm.SimPhoneBookInterfaceManager

Summary

Constants inherited from interface android.os.IBinder

Public Constructors

Public Methods

Methods inherited from class android.telephony.gsm.ISimPhoneBook.Stub

Methods inherited from class android.os.Binder

Methods inherited from class java.lang.Object

Methods inherited from interface android.telephony.gsm.ISimPhoneBook

Methods inherited from interface android.os.IInterface

Methods inherited from interface android.os.IBinder

Details

Public Constructors

public SimPhoneBookInterfaceManager(GSMPhone phone)

Public Methods

public List getAdnRecordsInEf(int efid)

Parameters

Returns

public int[] getAdnRecordsSize(int efid)

Parameters

Returns

public boolean updateAdnRecordsInEfByIndex(int efid, String newTag, String newPhoneNumber, int index, String pin2)

Parameters

Returns

public boolean updateAdnRecordsInEfBySearch(int efid, String oldTag, String oldPhoneNumber, String newTag, String newPhoneNumber, String pin2)

Parameters

Returns

	IBinder	asBinder()
		Retrieve the Binder object associated with this interface.
static	ISimPhoneBook	asInterface(IBinder obj)
		Cast an IBinder object into an ISimPhoneBook interface, generating a proxy if needed.
	boolean	onTransact(int code, Parcel data, Parcel reply, int flags)
		Default implementation is a stub that returns false.

				int	getConstantData(Parcel outData)
					This method allows you to add data that is transported through IPC along with your IBinder pointer.
				void	linkToDeath(DeathRecipient recipient, int flags)
					Register the recipient for a notification if this binder goes away.
				boolean	pingBinder()
					Check to see if the object still exists.
				IInterface	queryLocalInterface(String descriptor)
					Attempt to retrieve a local implementation of an interface for this Binder object.
				boolean	transact(int code, Parcel data, Parcel reply, int flags)
					Perform a generic operation with the object.
				boolean	unlinkToDeath(DeathRecipient recipient, int flags)
					Remove a previously registered death notification.


e.g. "intent" or "activity"