com.liulishuo.filedownloader.util

Class FileDownloadUtils

java.lang.Object

com.liulishuo.filedownloader.util.FileDownloadUtils

public class FileDownloadUtils
extends Object

The utils for FileDownloader.

Constructor Summary

Constructors

Constructor and Description
FileDownloadUtils()

Method Summary

Modifier and Type	Method and Description
static boolean	checkPermission(String permission)
static long	convertContentLengthString(String s)
static String[]	convertHeaderString(String nameAndValuesString)
static FileDownloadOutputStream	createOutputStream(String path)
static String	defaultUserAgent()
static void	deleteTargetFile(String targetFilePath)
static void	deleteTaskFiles(String targetFilepath, String tempFilePath)
static void	deleteTempFile(String tempFilePath)
static long	findContentLength(int id, FileDownloadConnection connection)
static long	findContentLengthFromContentRange(FileDownloadConnection connection)
static String	findEtag(int id, FileDownloadConnection connection)
static String	findFilename(FileDownloadConnection connection, String url)
static long	findInstanceLengthForTrial(FileDownloadConnection connection)
static long	findInstanceLengthFromContentRange(FileDownloadConnection connection)
static String	formatString(String msg, Object... args)
static String	generateFileName(String url)
static String	generateFilePath(String directory, String filename)
static int	generateId(String url, String path)
static int	generateId(String url, String path, boolean pathAsDirectory)
static File	getConvertedMarkedFile(Context context)
static String	getDefaultSaveFilePath(String url)
static String	getDefaultSaveRootPath()
static long	getFreeSpaceBytes(String path)
static int	getMinProgressStep()
static long	getMinProgressTime()
static String	getParent(String path) The same to File.getParent(), for non-creating a file object.
static String	getStack()
static String	getStack(boolean printLine)
static String	getStack(StackTraceElement[] stackTrace, boolean printLine)
static String	getTargetFilePath(String path, boolean pathAsDirectory, String filename)
static String	getTempPath(String targetPath)
static String	getThreadPoolName(String name)
static boolean	isAcceptRange(int responseCode, FileDownloadConnection connection)
static boolean	isBreakpointAvailable(int id, FileDownloadModel model)
static boolean	isBreakpointAvailable(int id, FileDownloadModel model, Boolean outputStreamSupportSeek)
static boolean	isBreakpointAvailable(int id, FileDownloadModel model, String path, Boolean outputStreamSupportSeek)
static boolean	isDownloaderProcess(Context context)
static boolean	isFilenameConverted(Context context)
static boolean	isFilenameValid(String filename) Checks whether the filename looks legitimate.
static boolean	isNeedSync(long bytesDelta, long timestampDelta)
static boolean	isNetworkNotOnWifiType()
static void	markConverted(Context context)
static String	md5(String string)
static boolean	needMakeServiceForeground(Context context)
static String	parseContentDisposition(String contentDisposition) The same to com.android.providers.downloads.Helpers#parseContentDisposition.
static long	parseContentLengthFromContentRange(String contentRange)
static long	parseContentRangeFoInstanceLength(String contentRange)
static void	setDefaultSaveRootPath(String path) The path is used as the default directory in the case of the task without set path.
static void	setMinProgressStep(int minProgressStep)
static void	setMinProgressTime(long minProgressTime)

Methods inherited from class java.lang.Object

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

Constructor Detail

FileDownloadUtils

public FileDownloadUtils()

Method Detail

setMinProgressStep

public static void setMinProgressStep(int minProgressStep)
                               throws IllegalAccessException

Parameters:

minProgressStep - The minimum bytes interval in per step to sync to the file and the database.

Used for adjudging whether is time to sync the downloaded so far bytes to database and make sure sync the downloaded buffer to local file.

More smaller more frequently, then download more slowly, but will more safer in scene of the process is killed unexpected.

Default 65536, which follow the value in com.android.providers.downloads.Constants.

Throws:

IllegalAccessException

See Also:

DownloadStatusCallback.onProgress(long), setMinProgressTime(long)

setMinProgressTime

public static void setMinProgressTime(long minProgressTime)
                               throws IllegalAccessException

Parameters:

minProgressTime - The minimum millisecond interval in per time to sync to the file and the database.

Used for adjudging whether is time to sync the downloaded so far bytes to database and make sure sync the downloaded buffer to local file.

More smaller more frequently, then download more slowly, but will more safer in scene of the process is killed unexpected.

Default 2000, which follow the value in com.android.providers.downloads.Constants.

Throws:

IllegalAccessException

See Also:

DownloadStatusCallback.onProgress(long), setMinProgressStep(int)

getMinProgressStep

public static int getMinProgressStep()

getMinProgressTime

public static long getMinProgressTime()

isFilenameValid

public static boolean isFilenameValid(String filename)

Checks whether the filename looks legitimate.

getDefaultSaveRootPath

public static String getDefaultSaveRootPath()

getDefaultSaveFilePath

public static String getDefaultSaveFilePath(String url)

generateFileName

public static String generateFileName(String url)

generateFilePath

public static String generateFilePath(String directory,
                                      String filename)

See Also:

getTargetFilePath(String, boolean, String)

setDefaultSaveRootPath

public static void setDefaultSaveRootPath(String path)

The path is used as the default directory in the case of the task without set path.

Parameters:

path - default root path for save download file.

See Also:

BaseDownloadTask.setPath(String, boolean)

getTempPath

public static String getTempPath(String targetPath)

Parameters:

targetPath - The target path for the download task.

Returns:

The temp path is targetPath in downloading status; The temp path is used for storing the file not completed downloaded yet.

generateId

public static int generateId(String url,
                             String path)

Parameters:

url - The downloading URL.

path - The absolute file path.

Returns:

The download id.

generateId

public static int generateId(String url,
                             String path,
                             boolean pathAsDirectory)

Parameters:

url - The downloading URL.

path - If pathAsDirectory is true, path would be the absolute directory to place the file; If pathAsDirectory is false, path would be the absolute file path.

Returns:

The download id.

md5

public static String md5(String string)

getStack

public static String getStack()

getStack

public static String getStack(boolean printLine)

getStack

public static String getStack(StackTraceElement[] stackTrace,
                              boolean printLine)

isDownloaderProcess

public static boolean isDownloaderProcess(Context context)

Parameters:

context - the context

Returns:

true if the FileDownloadService is allowed to run on the current process, false otherwise.

convertHeaderString

public static String[] convertHeaderString(String nameAndValuesString)

getFreeSpaceBytes

public static long getFreeSpaceBytes(String path)

formatString

public static String formatString(String msg,
                                  Object... args)

markConverted

public static void markConverted(Context context)

isFilenameConverted

public static boolean isFilenameConverted(Context context)

Returns:

Whether has converted all files' name from 'filename'(in old architecture) to 'filename.temp', if it's in downloading state.

If true, You can check whether the file has completed downloading with File.exists() directly.

when FileDownloadService.onCreate() is invoked, This value will be assigned to true only once since you upgrade the filedownloader version to 0.3.3 or higher.

getConvertedMarkedFile

public static File getConvertedMarkedFile(Context context)

parseContentRangeFoInstanceLength

public static long parseContentRangeFoInstanceLength(String contentRange)

parseContentDisposition

public static String parseContentDisposition(String contentDisposition)

The same to com.android.providers.downloads.Helpers#parseContentDisposition.

Parse the Content-Disposition HTTP Header. The format of the header is defined here: http://www.w3.org/Protocols/rfc2616/rfc2616-sec19.html This header provides a filename for content that is going to be downloaded to the file system. We only support the attachment type.

getTargetFilePath

public static String getTargetFilePath(String path,
                                       boolean pathAsDirectory,
                                       String filename)

Parameters:

path - If pathAsDirectory is true, the path would be the absolute directory to settle down the file; If pathAsDirectory is false, the path would be the absolute file path.

pathAsDirectory - whether the path is a directory.

filename - the file's name.

Returns:

the absolute path of the file. If can't find by params, will return null.

getParent

public static String getParent(String path)

The same to File.getParent(), for non-creating a file object.

Returns:

this file's parent pathname or null.

getThreadPoolName

public static String getThreadPoolName(String name)

isNetworkNotOnWifiType

public static boolean isNetworkNotOnWifiType()

checkPermission

public static boolean checkPermission(String permission)

convertContentLengthString

public static long convertContentLengthString(String s)

findEtag

public static String findEtag(int id,
                              FileDownloadConnection connection)

isAcceptRange

public static boolean isAcceptRange(int responseCode,
                                    FileDownloadConnection connection)

findInstanceLengthForTrial

public static long findInstanceLengthForTrial(FileDownloadConnection connection)

findInstanceLengthFromContentRange

public static long findInstanceLengthFromContentRange(FileDownloadConnection connection)

findContentLength

public static long findContentLength(int id,
                                     FileDownloadConnection connection)

findContentLengthFromContentRange

public static long findContentLengthFromContentRange(FileDownloadConnection connection)

parseContentLengthFromContentRange

public static long parseContentLengthFromContentRange(String contentRange)

findFilename

public static String findFilename(FileDownloadConnection connection,
                                  String url)
                           throws FileDownloadSecurityException

Throws:

FileDownloadSecurityException

createOutputStream

public static FileDownloadOutputStream createOutputStream(String path)
                                                   throws IOException

Throws:

IOException

isBreakpointAvailable

public static boolean isBreakpointAvailable(int id,
                                            FileDownloadModel model)

isBreakpointAvailable

public static boolean isBreakpointAvailable(int id,
                                            FileDownloadModel model,
                                            Boolean outputStreamSupportSeek)

Returns:

can resume by break point

isBreakpointAvailable

public static boolean isBreakpointAvailable(int id,
                                            FileDownloadModel model,
                                            String path,
                                            Boolean outputStreamSupportSeek)

deleteTaskFiles

public static void deleteTaskFiles(String targetFilepath,
                                   String tempFilePath)

deleteTempFile

public static void deleteTempFile(String tempFilePath)

deleteTargetFile

public static void deleteTargetFile(String targetFilePath)

isNeedSync

public static boolean isNeedSync(long bytesDelta,
                                 long timestampDelta)

defaultUserAgent

public static String defaultUserAgent()

needMakeServiceForeground

public static boolean needMakeServiceForeground(Context context)