Most visited

Recently visited

Results for

Added in API level 14

VpnService

public class VpnService
extends Service

java.lang.Object
↳	android.content.Context
	↳	android.content.ContextWrapper
		↳	android.app.Service
			↳	android.net.VpnService

VpnService is a base class for applications to extend and build their own VPN solutions. In general, it creates a virtual network interface, configures addresses and routing rules, and returns a file descriptor to the application. Each read from the descriptor retrieves an outgoing packet which was routed to the interface. Each write to the descriptor injects an incoming packet just like it was received from the interface. The interface is running on Internet Protocol (IP), so packets are always started with IP headers. The application then completes a VPN connection by processing and exchanging packets with the remote server over a tunnel.

Letting applications intercept packets raises huge security concerns. A VPN application can easily break the network. Besides, two of them may conflict with each other. The system takes several actions to address these issues. Here are some key points:

User action is required the first time an application creates a VPN connection.
There can be only one VPN connection running at the same time. The existing interface is deactivated when a new one is created.
A system-managed notification is shown during the lifetime of a VPN connection.
A system-managed dialog gives the information of the current VPN connection. It also provides a button to disconnect.
The network is restored automatically when the file descriptor is closed. It also covers the cases when a VPN application is crashed or killed by the system.

There are two primary methods in this class: prepare(Context) and establish(). The former deals with user action and stops the VPN connection created by another application. The latter creates a VPN interface using the parameters supplied to the VpnService.Builder. An application must call prepare(Context) to grant the right to use other methods in this class, and the right can be revoked at any time. Here are the general steps to create a VPN connection:

When the user presses the button to connect, call prepare(Context) and launch the returned intent, if non-null.
When the application becomes prepared, start the service.
Create a tunnel to the remote server and negotiate the network parameters for the VPN connection.
Supply those parameters to a VpnService.Builder and create a VPN interface by calling establish().
Process and exchange packets between the tunnel and the returned file descriptor.
When onRevoke() is invoked, close the file descriptor and shut down the tunnel gracefully.

Services extended this class need to be declared with appropriate permission and intent filter. Their access must be secured by BIND_VPN_SERVICE permission, and their intent filter must match SERVICE_INTERFACE action. Here is an example of declaring a VPN service in AndroidManifest.xml:

 <service android:name=".ExampleVpnService"
         android:permission="android.permission.BIND_VPN_SERVICE">
     <intent-filter>
         <action android:name="android.net.VpnService"/>
     </intent-filter>
 </service>

See also:

VpnService.Builder

Summary

Nested classes
`class`	`VpnService.Builder` Helper class to create a VPN interface.

Constants
`String`	`SERVICE_INTERFACE` The action must be matched by the intent filter of this service.

Inherited constants

From class


    android.app.Service

From class


    android.content.Context

From interface


    android.content.ComponentCallbacks2

Public constructors
`VpnService()`

Public methods
`IBinder`	`onBind(Intent intent)` Return the communication interface to the service.
`void`	`onRevoke()` Invoked when the application is revoked.
`static Intent`	`prepare(Context context)` Prepare to establish a VPN connection.
`boolean`	`protect(Socket socket)` Convenience method to protect a `Socket` from VPN connections.
`boolean`	`protect(int socket)` Protect a socket from VPN connections.
`boolean`	`protect(DatagramSocket socket)` Convenience method to protect a `DatagramSocket` from VPN connections.
`boolean`	`setUnderlyingNetworks(Network[] networks)` Sets the underlying networks used by the VPN for its upstream connections.

Inherited methods

From class


  
    android.app.Service

`void`	`dump(FileDescriptor fd, PrintWriter writer, String[] args)` Print the Service's state into the given stream.
`final Application`	`getApplication()` Return the application that owns this service.
`abstract IBinder`	`onBind(Intent intent)` Return the communication channel to the service.
`void`	`onConfigurationChanged(Configuration newConfig)` Called by the system when the device configuration changes while your component is running.
`void`	`onCreate()` Called by the system when the service is first created.
`void`	`onDestroy()` Called by the system to notify a Service that it is no longer used and is being removed.
`void`	`onLowMemory()` This is called when the overall system is running low on memory, and actively running processes should trim their memory usage.
`void`	`onRebind(Intent intent)` Called when new clients have connected to the service, after it had previously been notified that all had disconnected in its `onUnbind(Intent)`.
`void`	`onStart(Intent intent, int startId)` This method was deprecated in API level 5. Implement `onStartCommand(Intent, int, int)` instead.
`int`	`onStartCommand(Intent intent, int flags, int startId)` Called by the system every time a client explicitly starts the service by calling `startService(Intent)`, providing the arguments it supplied and a unique integer token representing the start request.
`void`	`onTaskRemoved(Intent rootIntent)` This is called if the service is currently running and the user has removed a task that comes from the service's application.
`void`	`onTrimMemory(int level)` Called when the operating system has determined that it is a good time for a process to trim unneeded memory from its process.
`boolean`	`onUnbind(Intent intent)` Called when all clients have disconnected from a particular interface published by the service.
`final void`	`startForeground(int id, Notification notification)` Make this service run in the foreground, supplying the ongoing notification to be shown to the user while in this state.
`final void`	`stopForeground(int flags)` Remove this service from foreground state, allowing it to be killed if more memory is needed.
`final void`	`stopForeground(boolean removeNotification)` Synonym for `stopForeground(int)`.
`final void`	`stopSelf()` Stop the service, if it was previously started.
`final void`	`stopSelf(int startId)` Old version of `stopSelfResult(int)` that doesn't return a result.
`final boolean`	`stopSelfResult(int startId)` Stop the service if the most recent time it was started was `startId`.

From class


  
    android.content.ContextWrapper

`void`	`attachBaseContext(Context base)` Set the base context for this ContextWrapper.
`boolean`	`bindService(Intent service, ServiceConnection conn, int flags)` Connect to an application service, creating it if needed.
`int`	`checkCallingOrSelfPermission(String permission)` Determine whether the calling process of an IPC or you have been granted a particular permission.
`int`	`checkCallingOrSelfUriPermission(Uri uri, int modeFlags)` Determine whether the calling process of an IPC or you has been granted permission to access a specific URI.
`int`	`checkCallingPermission(String permission)` Determine whether the calling process of an IPC you are handling has been granted a particular permission.
`int`	`checkCallingUriPermission(Uri uri, int modeFlags)` Determine whether the calling process and user ID has been granted permission to access a specific URI.
`int`	`checkPermission(String permission, int pid, int uid)` Determine whether the given permission is allowed for a particular process and user ID running in the system.
`int`	`checkSelfPermission(String permission)` Determine whether you have been granted a particular permission.
`int`	`checkUriPermission(Uri uri, String readPermission, String writePermission, int pid, int uid, int modeFlags)` Check both a Uri and normal permission.
`int`	`checkUriPermission(Uri uri, int pid, int uid, int modeFlags)` Determine whether a particular process and user ID has been granted permission to access a specific URI.
`void`	`clearWallpaper()` This method was deprecated in API level 23. Use `WallpaperManager.clear()` instead. This method requires the caller to hold the permission `SET_WALLPAPER`.
`Context`	`createConfigurationContext(Configuration overrideConfiguration)` Return a new Context object for the current Context but whose resources are adjusted to match the given Configuration.
`Context`	`createDeviceProtectedStorageContext()` Return a new Context object for the current Context but whose storage APIs are backed by device-protected storage.
`Context`	`createDisplayContext(Display display)` Return a new Context object for the current Context but whose resources are adjusted to match the metrics of the given Display.
`Context`	`createPackageContext(String packageName, int flags)` Return a new Context object for the given application name.
`String[]`	`databaseList()` Returns an array of strings naming the private databases associated with this Context's application package.
`boolean`	`deleteDatabase(String name)` Delete an existing private SQLiteDatabase associated with this Context's application package.
`boolean`	`deleteFile(String name)` Delete the given private file associated with this Context's application package.
`boolean`	`deleteSharedPreferences(String name)` Delete an existing shared preferences file.
`void`	`enforceCallingOrSelfPermission(String permission, String message)` If neither you nor the calling process of an IPC you are handling has been granted a particular permission, throw a `SecurityException`.
`void`	`enforceCallingOrSelfUriPermission(Uri uri, int modeFlags, String message)` If the calling process of an IPC or you has not been granted permission to access a specific URI, throw `SecurityException`.
`void`	`enforceCallingPermission(String permission, String message)` If the calling process of an IPC you are handling has not been granted a particular permission, throw a `SecurityException`.
`void`	`enforceCallingUriPermission(Uri uri, int modeFlags, String message)` If the calling process and user ID has not been granted permission to access a specific URI, throw `SecurityException`.
`void`	`enforcePermission(String permission, int pid, int uid, String message)` If the given permission is not allowed for a particular process and user ID running in the system, throw a `SecurityException`.
`void`	`enforceUriPermission(Uri uri, String readPermission, String writePermission, int pid, int uid, int modeFlags, String message)` Enforce both a Uri and normal permission.
`void`	`enforceUriPermission(Uri uri, int pid, int uid, int modeFlags, String message)` If a particular process and user ID has not been granted permission to access a specific URI, throw `SecurityException`.
`String[]`	`fileList()` Returns an array of strings naming the private files associated with this Context's application package.
`Context`	`getApplicationContext()` Return the context of the single, global Application object of the current process.
`ApplicationInfo`	`getApplicationInfo()` Return the full application info for this context's package.
`AssetManager`	`getAssets()` Returns an AssetManager instance for the application's package.
`Context`	`getBaseContext()`
`File`	`getCacheDir()` Returns the absolute path to the application specific cache directory on the filesystem.
`ClassLoader`	`getClassLoader()` Return a class loader you can use to retrieve classes in this package.
`File`	`getCodeCacheDir()` Returns the absolute path to the application specific cache directory on the filesystem designed for storing cached code.
`ContentResolver`	`getContentResolver()` Return a ContentResolver instance for your application's package.
`File`	`getDataDir()` Returns the absolute path to the directory on the filesystem where all private files belonging to this app are stored.
`File`	`getDatabasePath(String name)` Returns the absolute path on the filesystem where a database created with `openOrCreateDatabase(String, int, SQLiteDatabase.CursorFactory)` is stored.
`File`	`getDir(String name, int mode)` Retrieve, creating if needed, a new directory in which the application can place its own custom data files.
`File`	`getExternalCacheDir()` Returns absolute path to application-specific directory on the primary shared/external storage device where the application can place cache files it owns.
`File[]`	`getExternalCacheDirs()` Returns absolute paths to application-specific directories on all shared/external storage devices where the application can place cache files it owns.
`File`	`getExternalFilesDir(String type)` Returns the absolute path to the directory on the primary shared/external storage device where the application can place persistent files it owns.
`File[]`	`getExternalFilesDirs(String type)` Returns absolute paths to application-specific directories on all shared/external storage devices where the application can place persistent files it owns.
`File[]`	`getExternalMediaDirs()` Returns absolute paths to application-specific directories on all shared/external storage devices where the application can place media files.
`File`	`getFileStreamPath(String name)` Returns the absolute path on the filesystem where a file created with `openFileOutput(String, int)` is stored.
`File`	`getFilesDir()` Returns the absolute path to the directory on the filesystem where files created with `openFileOutput(String, int)` are stored.
`Looper`	`getMainLooper()` Return the Looper for the main thread of the current process.
`File`	`getNoBackupFilesDir()` Returns the absolute path to the directory on the filesystem similar to `getFilesDir()`.
`File`	`getObbDir()` Return the primary shared/external storage directory where this application's OBB files (if there are any) can be found.
`File[]`	`getObbDirs()` Returns absolute paths to application-specific directories on all shared/external storage devices where the application's OBB files (if there are any) can be found.
`String`	`getPackageCodePath()` Return the full path to this context's primary Android package.
`PackageManager`	`getPackageManager()` Return PackageManager instance to find global package information.
`String`	`getPackageName()` Return the name of this application's package.
`String`	`getPackageResourcePath()` Return the full path to this context's primary Android package.
`Resources`	`getResources()` Returns a Resources instance for the application's package.
`SharedPreferences`	`getSharedPreferences(String name, int mode)` Retrieve and hold the contents of the preferences file 'name', returning a SharedPreferences through which you can retrieve and modify its values.
`Object`	`getSystemService(String name)` Return the handle to a system-level service by name.
`String`	`getSystemServiceName(Class<?> serviceClass)` Gets the name of the system-level service that is represented by the specified class.
`Resources.Theme`	`getTheme()` Return the Theme object associated with this Context.
`Drawable`	`getWallpaper()` This method was deprecated in API level 23. Use `WallpaperManager.get()` instead.
`int`	`getWallpaperDesiredMinimumHeight()` This method was deprecated in API level 23. Use `WallpaperManager.getDesiredMinimumHeight()` instead.
`int`	`getWallpaperDesiredMinimumWidth()` This method was deprecated in API level 23. Use `WallpaperManager.getDesiredMinimumWidth()` instead.
`void`	`grantUriPermission(String toPackage, Uri uri, int modeFlags)` Grant permission to access a specific Uri to another package, regardless of whether that package has general permission to access the Uri's content provider.
`boolean`	`isDeviceProtectedStorage()` Indicates if the storage APIs of this Context are backed by device-protected storage.
`boolean`	`isRestricted()` Indicates whether this Context is restricted.
`boolean`	`moveDatabaseFrom(Context sourceContext, String name)` Move an existing database file from the given source storage context to this context.
`boolean`	`moveSharedPreferencesFrom(Context sourceContext, String name)` Move an existing shared preferences file from the given source storage context to this context.
`FileInputStream`	`openFileInput(String name)` Open a private file associated with this Context's application package for reading.
`FileOutputStream`	`openFileOutput(String name, int mode)` Open a private file associated with this Context's application package for writing.
`SQLiteDatabase`	`openOrCreateDatabase(String name, int mode, SQLiteDatabase.CursorFactory factory, DatabaseErrorHandler errorHandler)` Open a new private SQLiteDatabase associated with this Context's application package.
`SQLiteDatabase`	`openOrCreateDatabase(String name, int mode, SQLiteDatabase.CursorFactory factory)` Open a new private SQLiteDatabase associated with this Context's application package.
`Drawable`	`peekWallpaper()` This method was deprecated in API level 23. Use `WallpaperManager.peek()` instead.
`Intent`	`registerReceiver(BroadcastReceiver receiver, IntentFilter filter)` Register a BroadcastReceiver to be run in the main activity thread.
`Intent`	`registerReceiver(BroadcastReceiver receiver, IntentFilter filter, String broadcastPermission, Handler scheduler)` Register to receive intent broadcasts, to run in the context of `scheduler`.
`void`	`removeStickyBroadcast(Intent intent)` This method was deprecated in API level 23. Sticky broadcasts should not be used. They provide no security (anyone can access them), no protection (anyone can modify them), and many other problems. The recommended pattern is to use a non-sticky broadcast to report that something has changed, with another mechanism for apps to retrieve the current value whenever desired.
`void`	`removeStickyBroadcastAsUser(Intent intent, UserHandle user)` This method was deprecated in API level 23. Sticky broadcasts should not be used. They provide no security (anyone can access them), no protection (anyone can modify them), and many other problems. The recommended pattern is to use a non-sticky broadcast to report that something has changed, with another mechanism for apps to retrieve the current value whenever desired.
`void`	`revokeUriPermission(Uri uri, int modeFlags)` Remove all permissions to access a particular content provider Uri that were previously added with `grantUriPermission(String, Uri, int)`.
`void`	`sendBroadcast(Intent intent, String receiverPermission)` Broadcast the given intent to all interested BroadcastReceivers, allowing an optional required permission to be enforced.
`void`	`sendBroadcast(Intent intent)` Broadcast the given intent to all interested BroadcastReceivers.
`void`	`sendBroadcastAsUser(Intent intent, UserHandle user)` Version of `sendBroadcast(Intent)` that allows you to specify the user the broadcast will be sent to.
`void`	`sendBroadcastAsUser(Intent intent, UserHandle user, String receiverPermission)` Version of `sendBroadcast(Intent, String)` that allows you to specify the user the broadcast will be sent to.
`void`	`sendOrderedBroadcast(Intent intent, String receiverPermission, BroadcastReceiver resultReceiver, Handler scheduler, int initialCode, String initialData, Bundle initialExtras)` Version of `sendBroadcast(Intent)` that allows you to receive data back from the broadcast.
`void`	`sendOrderedBroadcast(Intent intent, String receiverPermission)` Broadcast the given intent to all interested BroadcastReceivers, delivering them one at a time to allow more preferred receivers to consume the broadcast before it is delivered to less preferred receivers.
`void`	`sendOrderedBroadcastAsUser(Intent intent, UserHandle user, String receiverPermission, BroadcastReceiver resultReceiver, Handler scheduler, int initialCode, String initialData, Bundle initialExtras)` Version of `sendOrderedBroadcast(Intent, String, BroadcastReceiver, Handler, int, String, Bundle)` that allows you to specify the user the broadcast will be sent to.
`void`	`sendStickyBroadcast(Intent intent)` This method was deprecated in API level 23. Sticky broadcasts should not be used. They provide no security (anyone can access them), no protection (anyone can modify them), and many other problems. The recommended pattern is to use a non-sticky broadcast to report that something has changed, with another mechanism for apps to retrieve the current value whenever desired.
`void`	`sendStickyBroadcastAsUser(Intent intent, UserHandle user)` This method was deprecated in API level 23. Sticky broadcasts should not be used. They provide no security (anyone can access them), no protection (anyone can modify them), and many other problems. The recommended pattern is to use a non-sticky broadcast to report that something has changed, with another mechanism for apps to retrieve the current value whenever desired.
`void`	`sendStickyOrderedBroadcast(Intent intent, BroadcastReceiver resultReceiver, Handler scheduler, int initialCode, String initialData, Bundle initialExtras)` This method was deprecated in API level 23. Sticky broadcasts should not be used. They provide no security (anyone can access them), no protection (anyone can modify them), and many other problems. The recommended pattern is to use a non-sticky broadcast to report that something has changed, with another mechanism for apps to retrieve the current value whenever desired.
`void`	`sendStickyOrderedBroadcastAsUser(Intent intent, UserHandle user, BroadcastReceiver resultReceiver, Handler scheduler, int initialCode, String initialData, Bundle initialExtras)` This method was deprecated in API level 23. Sticky broadcasts should not be used. They provide no security (anyone can access them), no protection (anyone can modify them), and many other problems. The recommended pattern is to use a non-sticky broadcast to report that something has changed, with another mechanism for apps to retrieve the current value whenever desired.
`void`	`setTheme(int resid)` Set the base theme for this context.
`void`	`setWallpaper(Bitmap bitmap)` This method was deprecated in API level 23. Use `WallpaperManager.set()` instead. This method requires the caller to hold the permission `SET_WALLPAPER`.
`void`	`setWallpaper(InputStream data)` This method was deprecated in API level 23. Use `WallpaperManager.set()` instead. This method requires the caller to hold the permission `SET_WALLPAPER`.
`void`	`startActivities(Intent[] intents, Bundle options)` Launch multiple new activities.
`void`	`startActivities(Intent[] intents)` Same as `startActivities(Intent[], Bundle)` with no options specified.
`void`	`startActivity(Intent intent)` Same as `startActivity(Intent, Bundle)` with no options specified.
`void`	`startActivity(Intent intent, Bundle options)` Launch a new activity.
`boolean`	`startInstrumentation(ComponentName className, String profileFile, Bundle arguments)` Start executing an `Instrumentation` class.
`void`	`startIntentSender(IntentSender intent, Intent fillInIntent, int flagsMask, int flagsValues, int extraFlags)` Same as `startIntentSender(IntentSender, Intent, int, int, int, Bundle)` with no options specified.
`void`	`startIntentSender(IntentSender intent, Intent fillInIntent, int flagsMask, int flagsValues, int extraFlags, Bundle options)` Like `startActivity(Intent, Bundle)`, but taking a IntentSender to start.
`ComponentName`	`startService(Intent service)` Request that a given application service be started.
`boolean`	`stopService(Intent name)` Request that a given application service be stopped.
`void`	`unbindService(ServiceConnection conn)` Disconnect from an application service.
`void`	`unregisterReceiver(BroadcastReceiver receiver)` Unregister a previously registered BroadcastReceiver.

From class


  
    android.content.Context

`abstract boolean`	`bindService(Intent service, ServiceConnection conn, int flags)` Connect to an application service, creating it if needed.
`abstract int`	`checkCallingOrSelfPermission(String permission)` Determine whether the calling process of an IPC or you have been granted a particular permission.
`abstract int`	`checkCallingOrSelfUriPermission(Uri uri, int modeFlags)` Determine whether the calling process of an IPC or you has been granted permission to access a specific URI.
`abstract int`	`checkCallingPermission(String permission)` Determine whether the calling process of an IPC you are handling has been granted a particular permission.
`abstract int`	`checkCallingUriPermission(Uri uri, int modeFlags)` Determine whether the calling process and user ID has been granted permission to access a specific URI.
`abstract int`	`checkPermission(String permission, int pid, int uid)` Determine whether the given permission is allowed for a particular process and user ID running in the system.
`abstract int`	`checkSelfPermission(String permission)` Determine whether you have been granted a particular permission.
`abstract int`	`checkUriPermission(Uri uri, String readPermission, String writePermission, int pid, int uid, int modeFlags)` Check both a Uri and normal permission.
`abstract int`	`checkUriPermission(Uri uri, int pid, int uid, int modeFlags)` Determine whether a particular process and user ID has been granted permission to access a specific URI.
`abstract void`	`clearWallpaper()` This method was deprecated in API level 5. Use `WallpaperManager.clear()` instead. This method requires the caller to hold the permission `SET_WALLPAPER`.
`abstract Context`	`createConfigurationContext(Configuration overrideConfiguration)` Return a new Context object for the current Context but whose resources are adjusted to match the given Configuration.
`abstract Context`	`createDeviceProtectedStorageContext()` Return a new Context object for the current Context but whose storage APIs are backed by device-protected storage.
`abstract Context`	`createDisplayContext(Display display)` Return a new Context object for the current Context but whose resources are adjusted to match the metrics of the given Display.
`abstract Context`	`createPackageContext(String packageName, int flags)` Return a new Context object for the given application name.
`abstract String[]`	`databaseList()` Returns an array of strings naming the private databases associated with this Context's application package.
`abstract boolean`	`deleteDatabase(String name)` Delete an existing private SQLiteDatabase associated with this Context's application package.
`abstract boolean`	`deleteFile(String name)` Delete the given private file associated with this Context's application package.
`abstract boolean`	`deleteSharedPreferences(String name)` Delete an existing shared preferences file.
`abstract void`	`enforceCallingOrSelfPermission(String permission, String message)` If neither you nor the calling process of an IPC you are handling has been granted a particular permission, throw a `SecurityException`.
`abstract void`	`enforceCallingOrSelfUriPermission(Uri uri, int modeFlags, String message)` If the calling process of an IPC or you has not been granted permission to access a specific URI, throw `SecurityException`.
`abstract void`	`enforceCallingPermission(String permission, String message)` If the calling process of an IPC you are handling has not been granted a particular permission, throw a `SecurityException`.
`abstract void`	`enforceCallingUriPermission(Uri uri, int modeFlags, String message)` If the calling process and user ID has not been granted permission to access a specific URI, throw `SecurityException`.
`abstract void`	`enforcePermission(String permission, int pid, int uid, String message)` If the given permission is not allowed for a particular process and user ID running in the system, throw a `SecurityException`.
`abstract void`	`enforceUriPermission(Uri uri, String readPermission, String writePermission, int pid, int uid, int modeFlags, String message)` Enforce both a Uri and normal permission.
`abstract void`	`enforceUriPermission(Uri uri, int pid, int uid, int modeFlags, String message)` If a particular process and user ID has not been granted permission to access a specific URI, throw `SecurityException`.
`abstract String[]`	`fileList()` Returns an array of strings naming the private files associated with this Context's application package.
`abstract Context`	`getApplicationContext()` Return the context of the single, global Application object of the current process.
`abstract ApplicationInfo`	`getApplicationInfo()` Return the full application info for this context's package.
`abstract AssetManager`	`getAssets()` Returns an AssetManager instance for the application's package.
`abstract File`	`getCacheDir()` Returns the absolute path to the application specific cache directory on the filesystem.
`abstract ClassLoader`	`getClassLoader()` Return a class loader you can use to retrieve classes in this package.
`abstract File`	`getCodeCacheDir()` Returns the absolute path to the application specific cache directory on the filesystem designed for storing cached code.
`final int`	`getColor(int id)` Returns a color associated with a particular resource ID and styled for the current theme.
`final ColorStateList`	`getColorStateList(int id)` Returns a color state list associated with a particular resource ID and styled for the current theme.
`abstract ContentResolver`	`getContentResolver()` Return a ContentResolver instance for your application's package.
`abstract File`	`getDataDir()` Returns the absolute path to the directory on the filesystem where all private files belonging to this app are stored.
`abstract File`	`getDatabasePath(String name)` Returns the absolute path on the filesystem where a database created with `openOrCreateDatabase(String, int, SQLiteDatabase.CursorFactory)` is stored.
`abstract File`	`getDir(String name, int mode)` Retrieve, creating if needed, a new directory in which the application can place its own custom data files.
`final Drawable`	`getDrawable(int id)` Returns a drawable object associated with a particular resource ID and styled for the current theme.
`abstract File`	`getExternalCacheDir()` Returns absolute path to application-specific directory on the primary shared/external storage device where the application can place cache files it owns.
`abstract File[]`	`getExternalCacheDirs()` Returns absolute paths to application-specific directories on all shared/external storage devices where the application can place cache files it owns.
`abstract File`	`getExternalFilesDir(String type)` Returns the absolute path to the directory on the primary shared/external storage device where the application can place persistent files it owns.
`abstract File[]`	`getExternalFilesDirs(String type)` Returns absolute paths to application-specific directories on all shared/external storage devices where the application can place persistent files it owns.
`abstract File[]`	`getExternalMediaDirs()` Returns absolute paths to application-specific directories on all shared/external storage devices where the application can place media files.
`abstract File`	`getFileStreamPath(String name)` Returns the absolute path on the filesystem where a file created with `openFileOutput(String, int)` is stored.
`abstract File`	`getFilesDir()` Returns the absolute path to the directory on the filesystem where files created with `openFileOutput(String, int)` are stored.
`abstract Looper`	`getMainLooper()` Return the Looper for the main thread of the current process.
`abstract File`	`getNoBackupFilesDir()` Returns the absolute path to the directory on the filesystem similar to `getFilesDir()`.
`abstract File`	`getObbDir()` Return the primary shared/external storage directory where this application's OBB files (if there are any) can be found.
`abstract File[]`	`getObbDirs()` Returns absolute paths to application-specific directories on all shared/external storage devices where the application's OBB files (if there are any) can be found.
`abstract String`	`getPackageCodePath()` Return the full path to this context's primary Android package.
`abstract PackageManager`	`getPackageManager()` Return PackageManager instance to find global package information.
`abstract String`	`getPackageName()` Return the name of this application's package.
`abstract String`	`getPackageResourcePath()` Return the full path to this context's primary Android package.
`abstract Resources`	`getResources()` Returns a Resources instance for the application's package.
`abstract SharedPreferences`	`getSharedPreferences(String name, int mode)` Retrieve and hold the contents of the preferences file 'name', returning a SharedPreferences through which you can retrieve and modify its values.
`final String`	`getString(int resId, Object... formatArgs)` Returns a localized formatted string from the application's package's default string table, substituting the format arguments as defined in `Formatter` and `format(String, Object...)`.
`final String`	`getString(int resId)` Returns a localized string from the application's package's default string table.
`final <T> T`	`getSystemService(Class<T> serviceClass)` Return the handle to a system-level service by class.
`abstract Object`	`getSystemService(String name)` Return the handle to a system-level service by name.
`abstract String`	`getSystemServiceName(Class<?> serviceClass)` Gets the name of the system-level service that is represented by the specified class.
`final CharSequence`	`getText(int resId)` Return a localized, styled CharSequence from the application's package's default string table.
`abstract Resources.Theme`	`getTheme()` Return the Theme object associated with this Context.
`abstract Drawable`	`getWallpaper()` This method was deprecated in API level 5. Use `WallpaperManager.get()` instead.
`abstract int`	`getWallpaperDesiredMinimumHeight()` This method was deprecated in API level 5. Use `WallpaperManager.getDesiredMinimumHeight()` instead.
`abstract int`	`getWallpaperDesiredMinimumWidth()` This method was deprecated in API level 5. Use `WallpaperManager.getDesiredMinimumWidth()` instead.
`abstract void`	`grantUriPermission(String toPackage, Uri uri, int modeFlags)` Grant permission to access a specific Uri to another package, regardless of whether that package has general permission to access the Uri's content provider.
`abstract boolean`	`isDeviceProtectedStorage()` Indicates if the storage APIs of this Context are backed by device-protected storage.
`boolean`	`isRestricted()` Indicates whether this Context is restricted.
`abstract boolean`	`moveDatabaseFrom(Context sourceContext, String name)` Move an existing database file from the given source storage context to this context.
`abstract boolean`	`moveSharedPreferencesFrom(Context sourceContext, String name)` Move an existing shared preferences file from the given source storage context to this context.
`final TypedArray`	`obtainStyledAttributes(AttributeSet set, int[] attrs)` Retrieve styled attribute information in this Context's theme.
`final TypedArray`	`obtainStyledAttributes(AttributeSet set, int[] attrs, int defStyleAttr, int defStyleRes)` Retrieve styled attribute information in this Context's theme.
`final TypedArray`	`obtainStyledAttributes(int resid, int[] attrs)` Retrieve styled attribute information in this Context's theme.
`final TypedArray`	`obtainStyledAttributes(int[] attrs)` Retrieve styled attribute information in this Context's theme.
`abstract FileInputStream`	`openFileInput(String name)` Open a private file associated with this Context's application package for reading.
`abstract FileOutputStream`	`openFileOutput(String name, int mode)` Open a private file associated with this Context's application package for writing.
`abstract SQLiteDatabase`	`openOrCreateDatabase(String name, int mode, SQLiteDatabase.CursorFactory factory, DatabaseErrorHandler errorHandler)` Open a new private SQLiteDatabase associated with this Context's application package.
`abstract SQLiteDatabase`	`openOrCreateDatabase(String name, int mode, SQLiteDatabase.CursorFactory factory)` Open a new private SQLiteDatabase associated with this Context's application package.
`abstract Drawable`	`peekWallpaper()` This method was deprecated in API level 5. Use `WallpaperManager.peek()` instead.
`void`	`registerComponentCallbacks(ComponentCallbacks callback)` Add a new `ComponentCallbacks` to the base application of the Context, which will be called at the same times as the ComponentCallbacks methods of activities and other components are called.
`abstract Intent`	`registerReceiver(BroadcastReceiver receiver, IntentFilter filter)` Register a BroadcastReceiver to be run in the main activity thread.
`abstract Intent`	`registerReceiver(BroadcastReceiver receiver, IntentFilter filter, String broadcastPermission, Handler scheduler)` Register to receive intent broadcasts, to run in the context of `scheduler`.
`abstract void`	`removeStickyBroadcast(Intent intent)` This method was deprecated in API level 21. Sticky broadcasts should not be used. They provide no security (anyone can access them), no protection (anyone can modify them), and many other problems. The recommended pattern is to use a non-sticky broadcast to report that something has changed, with another mechanism for apps to retrieve the current value whenever desired.
`abstract void`	`removeStickyBroadcastAsUser(Intent intent, UserHandle user)` This method was deprecated in API level 21. Sticky broadcasts should not be used. They provide no security (anyone can access them), no protection (anyone can modify them), and many other problems. The recommended pattern is to use a non-sticky broadcast to report that something has changed, with another mechanism for apps to retrieve the current value whenever desired.
`abstract void`	`revokeUriPermission(Uri uri, int modeFlags)` Remove all permissions to access a particular content provider Uri that were previously added with `grantUriPermission(String, Uri, int)`.
`abstract void`	`sendBroadcast(Intent intent, String receiverPermission)` Broadcast the given intent to all interested BroadcastReceivers, allowing an optional required permission to be enforced.
`abstract void`	`sendBroadcast(Intent intent)` Broadcast the given intent to all interested BroadcastReceivers.
`abstract void`	`sendBroadcastAsUser(Intent intent, UserHandle user)` Version of `sendBroadcast(Intent)` that allows you to specify the user the broadcast will be sent to.
`abstract void`	`sendBroadcastAsUser(Intent intent, UserHandle user, String receiverPermission)` Version of `sendBroadcast(Intent, String)` that allows you to specify the user the broadcast will be sent to.
`abstract void`	`sendOrderedBroadcast(Intent intent, String receiverPermission, BroadcastReceiver resultReceiver, Handler scheduler, int initialCode, String initialData, Bundle initialExtras)` Version of `sendBroadcast(Intent)` that allows you to receive data back from the broadcast.
`abstract void`	`sendOrderedBroadcast(Intent intent, String receiverPermission)` Broadcast the given intent to all interested BroadcastReceivers, delivering them one at a time to allow more preferred receivers to consume the broadcast before it is delivered to less preferred receivers.
`abstract void`	`sendOrderedBroadcastAsUser(Intent intent, UserHandle user, String receiverPermission, BroadcastReceiver resultReceiver, Handler scheduler, int initialCode, String initialData, Bundle initialExtras)` Version of `sendOrderedBroadcast(Intent, String, BroadcastReceiver, Handler, int, String, Bundle)` that allows you to specify the user the broadcast will be sent to.
`abstract void`	`sendStickyBroadcast(Intent intent)` This method was deprecated in API level 21. Sticky broadcasts should not be used. They provide no security (anyone can access them), no protection (anyone can modify them), and many other problems. The recommended pattern is to use a non-sticky broadcast to report that something has changed, with another mechanism for apps to retrieve the current value whenever desired.
`abstract void`	`sendStickyBroadcastAsUser(Intent intent, UserHandle user)` This method was deprecated in API level 21. Sticky broadcasts should not be used. They provide no security (anyone can access them), no protection (anyone can modify them), and many other problems. The recommended pattern is to use a non-sticky broadcast to report that something has changed, with another mechanism for apps to retrieve the current value whenever desired.
`abstract void`	`sendStickyOrderedBroadcast(Intent intent, BroadcastReceiver resultReceiver, Handler scheduler, int initialCode, String initialData, Bundle initialExtras)` This method was deprecated in API level 21. Sticky broadcasts should not be used. They provide no security (anyone can access them), no protection (anyone can modify them), and many other problems. The recommended pattern is to use a non-sticky broadcast to report that something has changed, with another mechanism for apps to retrieve the current value whenever desired.
`abstract void`	`sendStickyOrderedBroadcastAsUser(Intent intent, UserHandle user, BroadcastReceiver resultReceiver, Handler scheduler, int initialCode, String initialData, Bundle initialExtras)` This method was deprecated in API level 21. Sticky broadcasts should not be used. They provide no security (anyone can access them), no protection (anyone can modify them), and many other problems. The recommended pattern is to use a non-sticky broadcast to report that something has changed, with another mechanism for apps to retrieve the current value whenever desired.
`abstract void`	`setTheme(int resid)` Set the base theme for this context.
`abstract void`	`setWallpaper(Bitmap bitmap)` This method was deprecated in API level 5. Use `WallpaperManager.set()` instead. This method requires the caller to hold the permission `SET_WALLPAPER`.
`abstract void`	`setWallpaper(InputStream data)` This method was deprecated in API level 5. Use `WallpaperManager.set()` instead. This method requires the caller to hold the permission `SET_WALLPAPER`.
`abstract void`	`startActivities(Intent[] intents, Bundle options)` Launch multiple new activities.
`abstract void`	`startActivities(Intent[] intents)` Same as `startActivities(Intent[], Bundle)` with no options specified.
`abstract void`	`startActivity(Intent intent)` Same as `startActivity(Intent, Bundle)` with no options specified.
`abstract void`	`startActivity(Intent intent, Bundle options)` Launch a new activity.
`abstract boolean`	`startInstrumentation(ComponentName className, String profileFile, Bundle arguments)` Start executing an `Instrumentation` class.
`abstract void`	`startIntentSender(IntentSender intent, Intent fillInIntent, int flagsMask, int flagsValues, int extraFlags)` Same as `startIntentSender(IntentSender, Intent, int, int, int, Bundle)` with no options specified.
`abstract void`	`startIntentSender(IntentSender intent, Intent fillInIntent, int flagsMask, int flagsValues, int extraFlags, Bundle options)` Like `startActivity(Intent, Bundle)`, but taking a IntentSender to start.
`abstract ComponentName`	`startService(Intent service)` Request that a given application service be started.
`abstract boolean`	`stopService(Intent service)` Request that a given application service be stopped.
`abstract void`	`unbindService(ServiceConnection conn)` Disconnect from an application service.
`void`	`unregisterComponentCallbacks(ComponentCallbacks callback)` Remove a `ComponentCallbacks` object that was previously registered with `registerComponentCallbacks(ComponentCallbacks)`.
`abstract void`	`unregisterReceiver(BroadcastReceiver receiver)` Unregister a previously registered BroadcastReceiver.

From class


  
    java.lang.Object

`Object`	`clone()` Creates and returns a copy of this object.
`boolean`	`equals(Object obj)` Indicates whether some other object is "equal to" this one.
`void`	`finalize()` Called by the garbage collector on an object when garbage collection determines that there are no more references to the object.
`final Class<?>`	`getClass()` Returns the runtime class of this `Object`.
`int`	`hashCode()` Returns a hash code value for the object.
`final void`	`notify()` Wakes up a single thread that is waiting on this object's monitor.
`final void`	`notifyAll()` Wakes up all threads that are waiting on this object's monitor.
`String`	`toString()` Returns a string representation of the object.
`final void`	`wait(long millis, int nanos)` Causes the current thread to wait until another thread invokes the `notify()` method or the `notifyAll()` method for this object, or some other thread interrupts the current thread, or a certain amount of real time has elapsed.
`final void`	`wait(long millis)` Causes the current thread to wait until either another thread invokes the `notify()` method or the `notifyAll()` method for this object, or a specified amount of time has elapsed.
`final void`	`wait()` Causes the current thread to wait until another thread invokes the `notify()` method or the `notifyAll()` method for this object.

From interface


  
    android.content.ComponentCallbacks2

From interface


  
    android.content.ComponentCallbacks

Constants

SERVICE_INTERFACE

Added in API level 14

String SERVICE_INTERFACE

The action must be matched by the intent filter of this service. It also needs to require BIND_VPN_SERVICE permission so that other applications cannot abuse it.

Constant Value: "android.net.VpnService"

Public constructors

VpnService

Added in API level 14

VpnService ()

Public methods

onBind

Added in API level 14

IBinder onBind (Intent intent)

Return the communication interface to the service. This method returns null on Intents other than SERVICE_INTERFACE action. Applications overriding this method must identify the intent and return the corresponding interface accordingly.

Parameters
`intent`	`Intent`: The Intent that was used to bind to this service, as given to `Context.bindService`. Note that any extras that were included with the Intent at that point will not be seen here.

Returns
`IBinder`	Return an IBinder through which clients can call on to the service.

See also:

onBind(Intent)

onRevoke

Added in API level 14

void onRevoke ()

Invoked when the application is revoked. At this moment, the VPN interface is already deactivated by the system. The application should close the file descriptor and shut down gracefully. The default implementation of this method is calling stopSelf().

Calls to this method may not happen on the main thread of the process.

See also:

prepare(Context)

prepare

Added in API level 14

Intent prepare (Context context)

Prepare to establish a VPN connection. This method returns null if the VPN application is already prepared or if the user has previously consented to the VPN application. Otherwise, it returns an Intent to a system activity. The application should launch the activity using startActivityForResult(Intent, int) to get itself prepared. The activity may pop up a dialog to require user action, and the result will come back via its onActivityResult(int, int, Intent). If the result is RESULT_OK, the application becomes prepared and is granted to use other methods in this class.

Only one application can be granted at the same time. The right is revoked when another application is granted. The application losing the right will be notified via its onRevoke(). Unless it becomes prepared again, subsequent calls to other methods in this class will fail.

The user may disable the VPN at any time while it is activated, in which case this method will return an intent the next time it is executed to obtain the user's consent again.

Parameters
`context`	`Context`

Returns
`Intent`

See also:

onRevoke()

protect

Added in API level 14

boolean protect (Socket socket)

Convenience method to protect a Socket from VPN connections.

Parameters
`socket`	`Socket`

Returns
`boolean`	`true` on success.

See also:

protect(int)

protect

Added in API level 14

boolean protect (int socket)

Protect a socket from VPN connections. After protecting, data sent through this socket will go directly to the underlying network, so its traffic will not be forwarded through the VPN. This method is useful if some connections need to be kept outside of VPN. For example, a VPN tunnel should protect itself if its destination is covered by VPN routes. Otherwise its outgoing packets will be sent back to the VPN interface and cause an infinite loop. This method will fail if the application is not prepared or is revoked.

The socket is NOT closed by this method.

Parameters
`socket`	`int`

Returns
`boolean`	`true` on success.

protect

Added in API level 14

boolean protect (DatagramSocket socket)

Convenience method to protect a DatagramSocket from VPN connections.

Parameters
`socket`	`DatagramSocket`

Returns
`boolean`	`true` on success.

See also:

protect(int)

setUnderlyingNetworks

Added in API level 22

boolean setUnderlyingNetworks (Network[] networks)

Sets the underlying networks used by the VPN for its upstream connections.

Used by the system to know the actual networks that carry traffic for apps affected by this VPN in order to present this information to the user (e.g., via status bar icons).

This method only needs to be called if the VPN has explicitly bound its underlying communications channels — such as the socket(s) passed to protect(int) — to a Network using APIs such as bindSocket(Socket) or bindSocket(DatagramSocket). The VPN should call this method every time the set of Networks it is using changes.

networks is one of the following:

a non-empty array: an array of one or more Networks, in decreasing preference order. For example, if this VPN uses both wifi and mobile (cellular) networks to carry app traffic, but prefers or uses wifi more than mobile, wifi should appear first in the array.
an empty array: a zero-element array, meaning that the VPN has no underlying network connection, and thus, app traffic will not be sent or received.
null: (default) signifies that the VPN uses whatever is the system's default network. I.e., it doesn't use the bindSocket or bindDatagramSocket APIs mentioned above to send traffic over specific channels.

This call will succeed only if the VPN is currently established. For setting this value when the VPN has not yet been established, see setUnderlyingNetworks(Network[]).

Parameters
`networks`	`Network`: An array of networks the VPN uses to tunnel traffic to/from its servers.

Returns
`boolean`	`true` on success.

Interfaces

Classes

Enums

Exceptions

Most visited

Recently visited

Results for

VpnService

Summary

Nested classes

Constants

Inherited constants

Public constructors

Public methods

Inherited methods

Constants

SERVICE_INTERFACE

Public constructors

VpnService

Public methods

onBind

onRevoke

prepare

protect

protect

protect

setUnderlyingNetworks