Reputation: 17272
I would like to see how is Builder pattern used in real world applications/APIs. The examples I found are all pizzas, cakes, cars et cetera (plus the parser example from the GoF book).
Could you please tell me about some usages of this patten in real-world applications/APIs, preferably from the world of C++, .NET or PHP (as those are the languages I'm familiar with).
Thanks.
Upvotes: 17
Views: 14162
Reputation: 1369
Actually a very good real-life example is Active Record QueryBuilder example.
You can dig into the Laravel Eloquent module and check those Query builder classes...
A quick example of how it could look:
interface SqlQueryBuilder
{
public function select(string $table, array $fields): SqlQueryBuilder;
public function where(string $field, string $value, string $operator = '='): SqlQueryBuilder;
public function limit(int $start, int $offset): SqlQueryBuilder;
// ... other methods
public function getSQL(): string;
}
class MysqlQueryBuilder implements SqlQueryBuilder
{
// ...
}
class PostgresQueryBuilder extends MysqlQueryBuilder
{
// ...
}
Upvotes: 3
Reputation: 5720
Builder pattern is used in javax.json.Json
and javax.json.JsonBuilder
classes while building Json objects.
Good explanation is at http://www.programcreek.com/java-api-examples/index.php?api=javax.json.JsonObjectBuilder and also check out its official documentation.
JsonObjectBuilder b = Json.createObjectBuilder().
add( "report", Json.createObjectBuilder().
add( "reportId", reportId ).
add( "title", title ).
add( "subtitle", subTitle == null ? "" : subTitle ).
add( "created", created.toString() ).
add( "description", description == null ? "" : description ).
add( "data", report )
);
return b.build();
Upvotes: 4
Reputation: 13056
Update: I recently came across an even better example (imo). Checkout the JobBuilder and TriggerBuilder implementations in the Quartz scheduler package: http://quartz-scheduler.org/api/2.1.5/
Also, when I have time, just for fun/practice, I try to write examples of all GoF patterns in java. Just recently, I used the Builder pattern to make it easy to generate different types of Sitemaps (google site map vs, html site map, etc). The code is in java, but you might be useful: https://github.com/dparoulek/java-koans/tree/master/src/main/java/com/upgradingdave/koans/builder
Good question, I'd be interested in seeing more modern examples too.
Upvotes: 9