Как написать идиоматический шаблон построения с цепными вызовами метода в Rust?

Question

На основе следующих примеров, его можно написать накопление шаблон с цепью, методом вызывает в Русте, который либо проходит по значению или по ссылке (с пожизненным спецификатором)

• Is it possible to create a macro to implement builder pattern methods?
• How to overload the 'new' method? (верхний ответом)
• https://github.com/rust-unofficial/patterns/blob/master/patterns/builder.md

шаблон строитель в Rust может выглядеть примерно так:

ui::Button::new() 
    .label("Test") 
    .align(Align::Center) 
    .build(); 

При написании идиоматической ржавчины существует сильное предпочтение одному другому.

Есть ли хороший пример того, как писать это в Rust?

Answer 1

Я видел шаблон строителя, который в основном реализовывался путем принятия права собственности на Builder при его изменении и по ссылке для build(). Например,

#[derive(Debug, Eq, PartialEq)] 
struct Foo { 
    value: usize, 
} 

struct FooBuilder { 
    foos: usize, 
    bars: usize, 
} 

impl FooBuilder { 
    fn new() -> FooBuilder { 
     FooBuilder { 
      foos: 0, 
      bars: 0, 
     } 
    } 
    fn set_foos(mut self, foos: usize) -> FooBuilder { 
     self.foos = foos; 
     self 
    } 
    fn set_bars(mut self, bars: usize) -> FooBuilder { 
     self.bars = bars; 
     self 
    } 
    fn build(&self) -> Foo { 
     Foo { 
      value: self.foos + self.bars, 
     } 
    } 
} 

fn main() { 
    let foo = FooBuilder::new() 
     .set_foos(2) 
     .set_bars(3) 
     .build(); 
    assert_eq!(foo, Foo { value: 5 }); 
} 

Try on Rust Playground

Это делает сцепление простым, позволяя при этом повторное использование строителя.

Answer 2

Есть на самом деле два компромиссные:

• должен именованный сеттер принимать self по значению или по ссылке?
• следует принять окончательный метод buildself по значению или ссылке?

Моя рекомендация:

• изменяемые ссылки для сеттеров
• значения для метода build

Это немного отличается от Builder Pattern, представленных в Rust книге, которая использует ссылку в build.

---

Зачем передавать изменчивую ссылку для сеттеров?

Хотя компилятор может оптимизировать на ходы, вызванные вызовом fn label(self, &str) -> ButtonBuilder, не гарантируется.

С другой стороны, изменяемый ссылочный путь уже оптимален, поэтому вам не нужно полагаться на оптимизатор.

---

Почему проходя по значению для окончательного build?

Для строителей только состоящих из Copy полеев, нет никакой разницы между build с self или &self.

Однако, как только застройщик содержит не Copy полей, прохождение &self по build требует глубокого клонирования этих полей.

С другой стороны, минуя self по значению позволяет build перемещать поля, избегая ненужных копий.

Если вы хотите повторно использовать строитель, тогда строитель должен реализовать Clone.