Added: Add UriScheme and move UriUtils to com.termux.shared.net package

This commit is contained in:
agnostic-apollo
2021-10-26 00:46:54 +05:00
parent 37b9bcf5af
commit 549a772d45
5 changed files with 54 additions and 25 deletions

View File

@@ -0,0 +1,28 @@
package com.termux.shared.models.net;
import android.net.Uri;
/**
* The {@link Uri} schemes.
*
* https://www.iana.org/assignments/uri-schemes/uri-schemes.xhtml
* https://en.wikipedia.org/wiki/List_of_URI_schemes
*/
public class UriScheme {
/** Android app resource. */
public static final String SCHEME_ANDROID_RESOURCE = "android.resource";
/** Android content provider. https://www.iana.org/assignments/uri-schemes/prov/content. */
public static final String SCHEME_CONTENT = "content";
/** Filesystem or android app asset. https://www.rfc-editor.org/rfc/rfc8089.html. */
public static final String SCHEME_FILE = "file";
/* Hypertext Transfer Protocol. */
public static final String SCHEME_HTTP = "http";
/* Hypertext Transfer Protocol Secure. */
public static final String SCHEME_HTTPS = "https";
}

View File

@@ -1,25 +1,26 @@
package com.termux.shared.data;
package com.termux.shared.net;
import android.content.ContentResolver;
import android.net.Uri;
import androidx.annotation.NonNull;
import com.termux.shared.data.DataUtils;
import com.termux.shared.file.FileUtils;
import com.termux.shared.models.net.UriScheme;
public class UriUtils {
/**
* Get the full file path from a {@link Uri}.
*
* If the {@link Uri} was created from file path with {@link Uri#parse(String)}, like "am"
* command "-d" option does, and the path contained a "#", then anything after it would become
* the fragment and {@link Uri#getPath()} will only return the path before it, which would be
* invalid. The fragment must be manually appended to the path to get the full path.
* If the {@link Uri} was created from file path with {@link Uri#parse(String)}, like "am"
* command "-d" option does, and the path contained a "#", then anything after it would become
* the fragment and {@link Uri#getPath()} will only return the path before it, which would be
* invalid. The fragment must be manually appended to the path to get the full path.
*
* If the {@link Uri} was created with {@link Uri.Builder} and path was set
* with {@link Uri.Builder#path(String)}, then "#" will automatically be encoded to "%23"
* and separate fragment will not exist.
* If the {@link Uri} was created with {@link Uri.Builder} and path was set
* with {@link Uri.Builder#path(String)}, then "#" will automatically be encoded to "%23"
* and separate fragment will not exist.
*
* @param uri The {@link Uri} to get basename from.
* @return Returns the file path if found, otherwise {@code null}.
@@ -55,45 +56,45 @@ public class UriUtils {
}
/**
* Get {@link ContentResolver#SCHEME_FILE} {@link Uri} for path.
* Get {@link UriScheme#SCHEME_FILE} {@link Uri} for path.
*
* @param path The path for the {@link Uri}.
* @return Returns the {@link Uri}.
*/
public static Uri getFileUri(@NonNull String path) {
return new Uri.Builder().scheme(ContentResolver.SCHEME_FILE).path(path).build();
return new Uri.Builder().scheme(UriScheme.SCHEME_FILE).path(path).build();
}
/**
* Get {@link ContentResolver#SCHEME_FILE} {@link Uri} for path.
* Get {@link UriScheme#SCHEME_FILE} {@link Uri} for path.
*
* @param authority The authority for the {@link Uri}.
* @param path The path for the {@link Uri}.
* @return Returns the {@link Uri}.
*/
public static Uri getFileUri(@NonNull String authority, @NonNull String path) {
return new Uri.Builder().scheme(ContentResolver.SCHEME_FILE).authority(authority).path(path).build();
return new Uri.Builder().scheme(UriScheme.SCHEME_FILE).authority(authority).path(path).build();
}
/**
* Get {@link ContentResolver#SCHEME_CONTENT} {@link Uri} for path.
* Get {@link UriScheme#SCHEME_CONTENT} {@link Uri} for path.
*
* @param path The path for the {@link Uri}.
* @return Returns the {@link Uri}.
*/
public static Uri getContentUri(@NonNull String path) {
return new Uri.Builder().scheme(ContentResolver.SCHEME_CONTENT).path(path).build();
return new Uri.Builder().scheme(UriScheme.SCHEME_CONTENT).path(path).build();
}
/**
* Get {@link ContentResolver#SCHEME_CONTENT} {@link Uri} for path.
* Get {@link UriScheme#SCHEME_CONTENT} {@link Uri} for path.
*
* @param authority The authority for the {@link Uri}.
* @param path The path for the {@link Uri}.
* @return Returns the {@link Uri}.
*/
public static Uri getContentUri(@NonNull String authority, @NonNull String path) {
return new Uri.Builder().scheme(ContentResolver.SCHEME_CONTENT).authority(authority).path(path).build();
return new Uri.Builder().scheme(UriScheme.SCHEME_CONTENT).authority(authority).path(path).build();
}
}