Metterei l' API fluente nella propria classe "costruttore" separata dall'oggetto che sta creando. In questo modo, se il client non desidera utilizzare l'API fluente, è comunque possibile utilizzarlo manualmente e non inquina l'oggetto di dominio (aderendo al principio di responsabilità singola). In questo caso verrebbe creato:
Car
che è l'oggetto dominio
CarBuilder
che detiene l'API fluente
L'utilizzo sarebbe così:
var car = CarBuilder.BuildCar()
.OfBrand(Brand.Ford)
.OfModel(12345)
.PaintedIn(Color.Silver)
.Build();
La CarBuilder
classe sarebbe simile a questa (sto usando la convenzione di denominazione C # qui):
public class CarBuilder {
private Car _car;
/// Constructor
public CarBuilder() {
_car = new Car();
SetDefaults();
}
private void SetDefaults() {
this.OfBrand(Brand.Ford);
// you can continue the chaining for
// other default values
}
/// Starts an instance of the car builder to
/// build a new car with default values.
public static CarBuilder BuildCar() {
return new CarBuilder();
}
/// Sets the brand
public CarBuilder OfBrand(Brand brand) {
_car.SetBrand(brand);
return this;
}
// continue with OfModel(...), PaintedIn(...), and so on...
// that returns "this" to allow method chaining
/// Returns the built car
public Car Build() {
return _car;
}
}
Nota che questa classe non sarà thread-safe (ogni thread avrà bisogno della propria istanza di CarBuilder). Inoltre, anche se l'API fluente è un concetto davvero interessante, probabilmente è eccessivo allo scopo di creare semplici oggetti di dominio.
Questo accordo è più utile se stai creando un'API per qualcosa di molto più astratto e ha un'impostazione e un'esecuzione più complesse, motivo per cui funziona alla grande in unit test e framework DI. Puoi vedere alcuni altri esempi nella sezione Java dell'articolo di Wikipedia Fluent Interface con persistenza, gestione della data e oggetti finti.
MODIFICARE:
Come notato dai commenti; potresti rendere la classe Builder una classe interna statica (all'interno di Car) e Car rendere immutabile. Questo esempio di lasciare immutabile Car sembra un po 'sciocco; ma in un sistema più complesso, in cui non vuoi assolutamente cambiare il contenuto dell'oggetto che è stato creato, potresti volerlo fare.
Di seguito è riportato un esempio di come eseguire sia la classe statica interna sia come gestire una creazione di oggetti immutabile che viene costruita:
// the class that represents the immutable object
public class ImmutableWriter {
// immutable variables
private int _times; private string _write;
// the "complex" constructor
public ImmutableWriter(int times, string write) {
_times = times;
_write = write;
}
public void Perform() {
for (int i = 0; i < _times; i++) Console.Write(_write + " ");
}
// static inner builder of the immutable object
protected static class ImmutableWriterBuilder {
// the variables needed to construct the immutable object
private int _ii = 0; private string _is = String.Empty;
public void Times(int i) { _ii = i; }
public void Write(string s) { _is = s; }
// The stuff is all built here
public ImmutableWriter Build() {
return new ImmutableWriter(_ii, _is);
}
}
// factory method to get the builder
public static ImmutableWriterBuilder GetBuilder() {
return new ImmutableWriterBuilder();
}
}
L'utilizzo sarebbe il seguente:
var writer = ImmutableWriter
.GetBuilder()
.Write("peanut butter jelly time")
.Times(2)
.Build();
writer.Perform();
// console writes: peanut butter jelly time peanut butter jelly time
Modifica 2: Pete nei commenti ha pubblicato un post sul blog sull'uso dei costruttori con funzioni lambda nel contesto della scrittura di unit test con oggetti di dominio complessi. È un'alternativa interessante per rendere il costruttore un po 'più espressivo.
Nel caso CarBuilder
tu abbia invece bisogno di questo metodo:
public static Car Build(Action<CarBuilder> buildAction = null) {
var carBuilder = new CarBuilder();
if (buildAction != null) buildAction(carBuilder);
return carBuilder._car;
}
Quale può essere usato come questo:
Car c = CarBuilder
.Build(car =>
car.OfBrand(Brand.Ford)
.OfModel(12345)
.PaintedIn(Color.Silver);
var car = new Car(Brand.Ford, 12345, Color.Silver);
?