Schematic

Automatically generate ContentProviders

License	The Apache Software License, Version 2.0
Categories	Net
GroupId	net.simonvt.schematic
ArtifactId	schematic
Last Version	0.7.0
Release Date	Dec 3, 2016
Type	aar
Description	Schematic Automatically generate ContentProviders
Project URL	https://github.com/simonvt/schematic
Source Code Management	https://github.com/simonvt/schematic

Download schematic

Filename	Size
schematic-0.7.0.pom
schematic-0.7.0.aar	3 KB
schematic-0.7.0-sources.jar	2 KB
schematic-0.7.0-javadoc.jar	32 KB

How to add to project

Apache Maven

<!-- https://jarcasting.com/artifacts/net.simonvt.schematic/schematic/ -->
<dependency>
    <groupId>net.simonvt.schematic</groupId>
    <artifactId>schematic</artifactId>
    <version>0.7.0</version>
    <type>aar</type>
</dependency>

Gradle Groovy

// https://jarcasting.com/artifacts/net.simonvt.schematic/schematic/
implementation 'net.simonvt.schematic:schematic:0.7.0'

Gradle Kotlin

// https://jarcasting.com/artifacts/net.simonvt.schematic/schematic/
implementation ("net.simonvt.schematic:schematic:0.7.0")

Apache Buildr

'net.simonvt.schematic:schematic:aar:0.7.0'

Apache Ivy

<dependency org="net.simonvt.schematic" name="schematic" rev="0.7.0">
  <artifact name="schematic" type="aar" />
</dependency>

Groovy Grape

@Grapes(
@Grab(group='net.simonvt.schematic', module='schematic', version='0.7.0')
)

Scala SBT

libraryDependencies += "net.simonvt.schematic" % "schematic" % "0.7.0"

Leiningen

[net.simonvt.schematic/schematic "0.7.0"]

Dependencies

compile (1)

Group / Artifact	Type	Version
net.simonvt.schematic : schematic-annotations	jar	0.7.0

Project Modules

There are no modules declared in this project.

Schematic

Automatically generate a ContentProvider backed by an SQLite database.

Usage

First create a class that contains the columns of a database table.

public interface ListColumns {

  @DataType(INTEGER) @PrimaryKey @AutoIncrement String _ID = "_id";

  @DataType(TEXT) @NotNull String TITLE = "title";
}

Then create a database that uses this column

@Database(version = NotesDatabase.VERSION)
public final class NotesDatabase {

  public static final int VERSION = 1;

  @Table(ListColumns.class) public static final String LISTS = "lists";
}

And finally define a ContentProvider

@ContentProvider(authority = NotesProvider.AUTHORITY, database = NotesDatabase.class)
public final class NotesProvider {

  public static final String AUTHORITY = "net.simonvt.schematic.sample.NotesProvider";

  @TableEndpoint(table = NotesDatabase.LISTS) public static class Lists {

    @ContentUri(
        path = "lists",
        type = "vnd.android.cursor.dir/list",
        defaultSort = ListColumns.TITLE + " ASC")
    public static final Uri LISTS = Uri.parse("content://" + AUTHORITY + "/lists");
  }

Table column annotations

@AutoIncrement
@DataType
@DefaultValue
@NotNull
@PrimaryKey
@References
@Unique

Defining an Uri

The @ContentUri annotation is used when the Uri does not change.

@ContentUri(
  path = "lists",
  type = "vnd.android.cursor.dir/list",
  defaultSort = ListColumns.TITLE + " ASC")
public static final Uri LISTS = Uri.parse("content://" + AUTHORITY + "/lists");

If the Uri is created based on some value, e.g. an id, @InexactContentUri is used.

@InexactContentUri(
  path = Path.LISTS + "/#",
  name = "LIST_ID",
  type = "vnd.android.cursor.item/list",
  whereColumn = ListColumns._ID,
  pathSegment = 1)
public static Uri withId(long id) {
  return Uri.parse("content://" + AUTHORITY + "/lists/" + id);
}

Including in your project

dependencies {
  annotationProcessor 'net.simonvt.schematic:schematic-compiler:{latest-version}'
  compile 'net.simonvt.schematic:schematic:{latest-version}'
}

License

Copyright 2014 Simon Vig Therkildsen

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

   http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.

Versions

Version
0.7.0 Dec 3, 2016
0.6.8 Oct 19, 2016
0.6.7 Apr 11, 2016
0.6.6 Apr 9, 2016
0.6.5 Apr 9, 2016
0.6.4 Nov 22, 2015
0.6.3 Jul 31, 2015
0.6.2 Jul 12, 2015
0.6.1 Mar 23, 2015
0.6.0 Jan 17, 2015
0.5.3 Aug 31, 2014
0.5.1 May 21, 2014
0.5.0 May 20, 2014