Struct QueriesProvider

pub struct QueriesProvider {
    pub authorities: AttributeList<Semicolon, String>,
    pub name: String,
}

Declares a content provider component used in <queries>.

A content provider is a subclass of ContentProvider that supplies structured access to data managed by the application. All content providers in your application must be defined in a <provider> element in the manifest file; otherwise, the system is unaware of them and doesn’t run them.

You only declare content providers that are part of your application. Content providers in other applications that you use in your application should not be declared.

The Android system stores references to content providers according to an authority string, part of the provider’s content URI. For example, suppose you want to access a content provider that stores information about health care professionals. To do this, you call the method ContentResolver.query(), which among other arguments takes a URI that identifies the provider:

XML Example

content://com.example.project.healthcareprovider/nurses/rn

The content: scheme identifies the URI as a content URI pointing to an Android content provider. The authority com.example.project.healthcareprovider identifies the provider itself; the Android system looks up the authority in its list of known providers and their authorities. The substring nurses/rn is a path, which the content provider can use to identify subsets of the provider data.

In cases where you need to query a content provider but don’t know the specific package names, you can declare that provider authority in a element, as shown in the following snippet:

XML Example

<manifest package="com.example.suite.enterprise">
    <queries>
        <provider android:authorities="com.example.settings.files" />
    </queries>
   ...
</manifest>

Node

If your element includes a element, you might see an editor warning in Android Studio related to the element. As long as you’re using the latest “dot” release of the Android Gradle plugin, your build is unaffected, so you can disregard the warning. Learn more in the blog post about Preparing your Gradle build for package visibility in Android 11.

Contained in

• <queries>

Introduced in

API Level 30

Fields

authorities: AttributeList<Semicolon, String>

A list of one or more URI authorities that identify data offered by the content provider. Multiple authorities are listed by separating their names with a semicolon. To avoid conflicts, authority names should use a Java-style naming convention (such as com.example.provider.cartoonprovider). Typically, it’s the name of the ContentProvider subclass that implements the provider

There is no default. At least one authority must be specified.

name: String

The name of the class that implements the content provider, a subclass of ContentProvider. This should be a fully qualified class name (such as, "com.example.project.TransportationProvider"). However, as a shorthand, if the first character of the name is a period, it is appended to the package name specified in the <manifest> element.

There is no default. The name must be specified.

Implementations

impl QueriesProvider

pub fn check_authorities( &self, value: &AttributeList<Semicolon, String>, ) -> bool

Trait Implementations

impl Clone for QueriesProvider

fn clone(&self) -> QueriesProvider

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for QueriesProvider

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for QueriesProvider

fn default() -> QueriesProvider

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for QueriesProvider

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for QueriesProvider

fn eq(&self, other: &QueriesProvider) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for QueriesProvider

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl YaDeserialize for QueriesProvider

fn deserialize<R: Read>(reader: &mut Deserializer<R>) -> Result<Self, String>

impl YaSerialize for QueriesProvider

fn serialize<W: Write>(&self, writer: &mut Serializer<W>) -> Result<(), String>

fn serialize_attributes( &self, source_attributes: Vec<OwnedAttribute>, source_namespace: Namespace, ) -> Result<(Vec<OwnedAttribute>, Namespace), String>

impl Eq for QueriesProvider

impl StructuralPartialEq for QueriesProvider