- π Running Database Queries
- π Select Statements
- π Raw Expressions
- π Joins
- π Basic Where Clauses
- π Ordering, Grouping, Limit & Offset
- π Conditional Clauses
- π Insert Statements
- π Update Statements
- π Delete Statements
import io.github.dldash.persistence.contracts.Query;
class UserController {
public void index() {
Query query = Query.builder()
.table("users")
.where("name", "John")
.build();
System.out.println(query.sql());
System.out.println(query.bindings());
}
}
Query query = Query.builder()
.table("users")
.count()
.build();
Query query = Query.builder()
.table("users")
.select("name", "email as user_email")
.build();
The distinct
method allows you to force the query to return distinct results:
Query query = Query.builder()
.table("users")
.distinct()
.build();
Query.raw("NOW()")
Query query = Query.builder()
.table("users")
.join("contacts", "users.id", "=", "contacts.user_id")
.join("orders", "users.id", "=", "orders.user_id'")
.select("users.*", "contacts.phone", "orders.price")
.build();
Query query = Query.builder()
.table("users")
.leftJoin("posts", "users.id", "=", "posts.user_id")
.build();
Query query = Query.builder()
.table("users")
.where("votes", 100)
.where("age", ">", 35)
.build();
Query query = Query.builder()
.table("users")
.where("votes", ">", 100)
.orWhere("name", "John")
.build();
Query query = Query.builder()
.table("users")
.where("votes", ">", 100)
.orWhere(x -> x.where("name", "Abigail").where("votes", ">", 50))
.build();
The example above will produce the following SQL:
select * from users where votes > 100 or (name = 'Abigail' and votes > 50)
Query query = Query.builder()
.table("users")
.whereBetween("votes", 1, 100)
.build();
Query query = Query.builder()
.table("users")
.whereIn("id", Arrays.asList(1, 2, 3))
.build();
Query query = Query.builder()
.table("users")
.whereNotIn("id", Arrays.asList(1, 2, 3))
.build();
Query query = Query.builder()
.table("users")
.whereNull("updated_at")
.whereNotNull("created_at")
.build();
Query query = Query.builder()
.table("users")
.whereDate("created_at", "2016-12-31")
.whereMonth("created_at", "12")
.whereDay("created_at", "31")
.whereYear("created_at", "2016")
.whereTime("created_at", "11:20:45")
.build();
Query query = Query.builder()
.table("users")
.where("name", "=", "John")
.where(x -> x.where("votes", ">", 100).orWhere("title", "=", "Admin"))
.build();
The example above will produce the following SQL:
select * from users where name = 'John' and (votes > 100 or title = 'Admin')
Query query = Query.builder()
.table("users")
.orderBy("name", "desc")
.build();
Query query = Query.builder()
.table("users")
.groupBy("account_id", "status")
.build();
Query query = Query.builder()
.table("users")
.skip(10)
.take(5)
.build();
Alternatively, you may use the limit
and offset
methods.
These methods are functionally equivalent to the take
and skip
methods, respectively:
Query query = Query.builder()
.table("users")
.offset(10)
.limit(5)
.build();
Query query = Query.builder()
.table("users")
.paginate(10, 1)
.build();
Sometimes you may want certain query clauses to apply to a query based on another condition.
For instance, you may only want to apply a where
statement if a given input value is present on the incoming HTTP request.
You may accomplish this using the when
method:
String role = request.get("role");
Query query = Query.builder()
.table("users")
.when(role, (q, value) -> q.where("role_id", value))
.build();
Query query = Query.builder()
.table("users")
.whereIfPresent("A", 1)
.whereIfPresent("B", null)
.build();
import io.github.dldash.persistence.builders.InsertQuery;
Query query = InsertQuery.builder()
.table("users")
.insert("email", "kayla@example.com")
.insert("votes", 0)
.build();
The ignore()
method will ignore duplicate record errors while inserting records into the database:
Query query = InsertQuery.builder()
.table("users")
.ignore()
.insert("id", 1)
.insert("email", "archer@example.com")
.build();
Query query = InsertQuery.builder()
.table("users")
.insert("email", "kayla@example.com")
.insertOrUpdate("votes", 10)
.insertOrUpdate("updated_at", Query.raw("NOW()"))
.build();
import io.github.dldash.persistence.builders.UpdateQuery;
Query query = UpdateQuery.builder()
.table("users")
.update("votes", 1)
.where("id", 1)
.build();
Query query = UpdateQuery.builder()
.table("users")
.update("votes", 1)
.updateIfPresent("name", null)
.where("id", 1)
.build();
import io.github.dldash.persistence.builders.DeleteQuery;
Query query = DeleteQuery.builder()
.table("users")
.where("votes", ">", 100)
.build();